CIMPRO2

Description

CIMPRO2 creates a new PCIDSK image file from projection information. The image dimensions are derived from the specified bounds and pixel size. The projection bounds and information are stored in the georeferencing segment created as the first segment of the new file. PCIDSK files can store 8-bit unsigned, 16-bit signed, 16-bit unsigned, 32-bit real, complex 16-bit signed, and complex 32-bit real image channels.

Note: You can add or remove image channels from an existing PCIDSK file by running the PCIMOD algorithm.

Parameters

Name	Type	Caption	Length	Value range
FILE	String	PCIDSK file name	0 - 192
TEX1	String	Descriptive text 1	0 - 64
DBNC *	Integer	Number of channels (8U,16S,16U,32R,C16S,C32R)	1 - 6	0 -
DBLAYOUT	String	Data Layout	0 - 192	See parameter description Default: BAND
PROJECT *	String	Projection	1 - 16	See description
ZONE	Integer	Output projection zone number	0 - 1
ROW	String	Projection row	0 - 1
ELLIPS	String	Earth ellipsoid	0 - 64
LLBOUND	String	Boundary coordinates are longitude/latitude	0 - 1	Y, N Default: Y
ULX *	String	Upper-left x-coordinate of output image	1 - 32
ULY *	String	Upper-left coordinate of output image	1 - 32
LRX *	String	Lower-right coordinate of output image	1 - 32
LRY *	String	Lower-right coordinate of output image	1 - 32
BXPXSZ *	String	Horizontal pixel size	1 - 32
BYPXSZ	String	Vertical pixel size	0 - 32
EXTRAINF	String	Extra projection information	0 - 8	DEFAULT \| ASK \| EXPLICIT Default: DEFAULT
PROLONG	String	Projection reference longitude	0 - 32
PROLAT	String	Projection reference latitude	0 - 32
STPAR1	String	First standard parallel	0 - 32
STPAR2	String	Second standard parallel	0 - 32
EFALSE	String	False easting	0 - 32	Default: 0.0
NFALSE	String	False northing	0 - 32	Default: 0.0
SCALE	String	Projection scale factor	0 - 32	Default: 1.0
PHEIGHT	String	Height of perspective	0 - 32	Default: 0.0
LONG1	String	Longitude for first point	0 - 32
LAT1	String	Latitude for first point	0 - 32
LONG2	String	Longitude for second point	0 - 32
LAT2	String	Latitude for second point	0 - 32
AZIMUTH	String	Azimuth east of north (degrees)	0 - 32	Default: 0.0
LSATNUM	Integer	LANDSAT number	0 - 1	1 - 5
PATHNUM	Integer	LANDSAT path number	0 - 1	1 -
REPORT	String	Report mode	0 - 192	Quick links
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILE

The name of the new PCIDSK file to create.

The file name you specify must not exist already. If no value is specified for this parameter, an output file is not created.

TEX1

A description, up to 64 characters, of the contents or origins of the PCIDSK file to create.

DBNC

The number of image channels of each type to create in the new PCIDSK file. If this value is set to zero only, the file can contain only segment data.

Supported image types include:

8bit: Number of 8-bit unsigned channels
16bitsigned: Number of 16-bit signed channels
16bitunsigned: Number of 16-bit unsigned channels
32bitreal: Number of 32-bit real channels
16bitsignedcomplex: Number of 16-bit signed complex channels
32bitrealcomplex: Number of 32-bit real complex channels

For example:

DBNC = 6, 0, 0, 3, 0, 1

The preceding example specifies that CIMPRO2 will create:

Six 8-bit channels
No (zero) 16-bit signed channels
No (zero) 16-bit unsigned channels
Three 32-bit real channels
No (zero) 16-bit signed complex channels
One 32-bit real complex channel

DBLAYOUT

The layout of the image data in the new PCIDSK file.

Supported values include:

PIXEL: Pixel interleaved
BAND: Band interleaved; this is the default value
FILE: File interleaved
TILED: Tiled with a default tile size
TILEDN: Tiled with n x n pixel tiles
TILED JPEG: Tiled with JPEG compression
TILED QUADTREE: Tiled with QUADTREE compression
TILEDN RLE: Tiled with RLE compression and n x n pixel tiles

The specified layout is based primarily on performance. Band interleaved stores the data together for one band and provides a better performance when bands are not all being accessed at all times. Pixel interleaved stores the data for all bands together at a particular pixel and may provide improved performance when all bands are used at once. File interleaved is similar to band interleaved, but the image-channel data is stored in external files (one file for each band).

Tiled files organize the image in several square sub-images; these may be much faster to access when only a sub-area is being extracted, as in file viewing. Tiling is also the only format that supports compression formats, with a default of no compression.

JPEG compression is a lossy compression and is typically suitable for continuous images, such as airphotos.

Quadtree compression is another lossy compression, and provides good compression when images contain large blocks of pixels with the same value.

Run Length Encoding (RLE) compression is lossless, but only provides good compression for images in which long sequences of pixels have the same value, which is typical in pseudocolored or thematic images.

PROJECT

The projection of the new image file.

For a complete list of supported projections, see Map projections.

Note: Some projections require the Earth to be defined as a sphere. Only Earth model E019 listed in the ELLIPS parameter is supported. If another Earth model (E000 to E018) is specified for these projections, or if the Earth model is defaulted, E019 is used.

Supported nonprojection units include:

PIXEL: Image coordinates
METRE: Meters

ZONE

The zone number of the output projection when the projection is equal to UTM (Universal Transverse Mercator) or State Plane (SPAF, SPCS, or SPIF); otherwise, this parameter is not used.

With UTM, utm_zone is 1 to 60. For State Plane, sp_zone is 101 to 5400.

Note: If a value is specified for this parameter, it takes precedence over any zone defined for the PROJECT parameter.

ROW

The row number for the projection when the projection is equal to UTM (Universal Transverse Mercator) or UPS (Universal Polar Stereographic); otherwise, this parameter is not used.

With UTM, utm_row is C to X (but not I or O). For UPS, ups_row is A, B, Y or Z.

Note: If a value is specified for this parameter, it takes precedence over any row defined in the PROJECT parameter.

ELLIPS

The output ellipsoid or datum code to use to define the shape of the Earth.

For a complete list of supported datums and ellipsoids, see Earth models.

You can specify the value of ELLIPS by using an ellipsoid code or a datum code. For example, you can use any of the following for WGS84:

ellips = "12"
ellips = "E12"
ellips = "E012"
ellips = "D000"
ellips = "D0"

Note: If no value is specified for ELLIPS, it takes precedence over any ellipsoid specified for the PROJECT parameter.

If the ellipsoid is not supported as one of the above Earth models, you can define it explicitly, in meters, as follows:

The equatorial radius (or semi-major axis or A) and the polar radius (or semi-minor axis or B) for the ellipsoid.

For example, for Clarke 1866, ELLIPS = "6378206.4 6356583.8"
The equatorial radius (or semi-major axis or A) and the eccentricity squared for the ellipsoid.

For example, for Clarke 1866, ELLIPS = "6378206.4, 0.006768658"

Note: If the "flattening" (F) is known for the Earth model, you can use it to determine the eccentricity squared (E**2) by using the following formula: E**2 = (2 * F) - (F * F) [which is the same as F = 1.0 - sqrt(1.0 - E**2)].
The radius of the sphere.

For example, the usual radius of the Earth as a sphere would be ELLIPS = "6370997".

LLBOUND

Whether the bounds are longitude and latitude coordinates.

If yes (Y), the output bounds (the values of the ULX, ULY, LRX, and LRY parameters) are longitude and latitude values. This is the default value.

If no (N), the output bounds are easting and northing values.

ULX

The x-coordinate (horizontal) of the upper-left corner of the output image, using the coordinate system specified for the LLBOUND parameter.

For example:

If the value of LLBOUND is yes (longitude):
```
ULX = "117d46'10.50W"
```
Note: The symbol for seconds (") is omitted, because CIMPRO2 would otherwise interpret it as the end of the string.
If the value of LLBOUND is no (easting):
```
ULX = "428720"
```

ULY

The y-coordinate (vertical) for the upper-left image corner, using the coordinate system specified for the LLBOUND parameter.

For example:

If LLBOUND is yes (latitude):
```
ULY = "33d44'56.45N"
```
Note: The symbol for seconds (") is omitted, because CIMPRO2 would otherwise interpret it as the end of the string.
If LLBOUND is no (northing):
```
ULY = "37374400"
```

LRX

Specifies the x-coordinate (horizontal) for the lower-right image corner, using the coordinate system specified for the LLBOUND parameter.

For example:

If LLBOUND is yes (longitude):
```
LRX = "117d36'10.04W"
```
Note: The symbol for seconds (") is omitted, because CIMPRO2 would otherwise interpret it as the end of the string.
If LLBOUND is no (easting):
```
LRX = "444070"
```

LRY

Specifies the y-coordinate (vertical) for the lower-right image corner, using the coordinate system specified for the LLBOUND parameter.

For example:

If LLBOUND is yes (latitude):
```
LRY = "33d36'41.05N"
```
Note: The symbol for seconds (") is omitted, because CIMPRO2 would otherwise interpret it as the end of the string.
If LLBOUND is no (northing):
```
LRY = "3719050"
```

BXPXSZ

The horizontal pixel size of the output image.

If the value of the PROJECT parameter is specified as "LONG/LAT", the size of the horizontal pixel size is in degrees, minutes, and/or seconds; otherwise, the size is in meters.

BYPXSZ

The vetical pixel size of the output image.

If the value of the PROJECT parameter is specified as "LONG/LAT", the size of the horizontal pixel size is in degrees, minutes, and/or seconds; otherwise, the size is in meters.

Note: If no value is specified for the BYPXSZ parameter, the value of the BXPXSZ parameter is used.

EXTRAINF

Whether to prompt for the information that defines the projection.

Supoorted values are:

DEFAULT: Determine defaults from image bounds; this is the default value.
ASK: Prompt for projection parameters
EXPLICIT: Use projection parameters as is

Note: With projections in which the projection-parameter defaults cannot be determined from the specified image bounds (ULX, ULY, LRX, LRY), CIMPRO2 may stop when the value of the EXTRAINF parameter is specified as "EXPLICIT" or "DEFAULT".

PROLONG

The reference longitude for the projection.

Acceptable values are -180 (180W) to +180 (180E).

PROLAT

The reference latitude for the projection.

Acceptable values are -90 (90S) to +90 (90N).

STPAR1

The first standard parallel for the following conic projections:

ACEA: Albers Conical Equal-Area
EC: Equidistant Conic, with one standard parallel
EC: Equidistant Conic, with two standard parallels
LCC: Lambert Conformal Conic

Acceptable values are -90 (90S) to +90 (90N).

STPAR2

The second standard parallel for the following conic projections:

ACEA: Albers Conical Equal-Area
EC: Equidistant Conic, with two standard parallels
LCC: Lambert Conformal Conic

Acceptable values are -90 (90S) to +90 (90N).

EFALSE

A false easting for the projection coordinates.

The value you specify must be an integer or decimal number; the default value is 0.0.

NFALSE

A false northing for the projection coordinates.

The value you specify must be an integer or decimal number; the default value is 0.0.

SCALE

The scale factor to use for the projection.

The value you specify must be an integer or decimal number; the default value is 1.0.

You use the SCALE parameter for the following projections:

OM: Oblique Mercator
RSO: Rectified Skew Orthomorphic
TM: Transverse Mercator

PHEIGHT

For the General Vertical Near-Side Perspective projection (GVNP), the height of the perspective point above the surface of the Earth as a sphere.

The value you specify must be an integer or decimal number; the default value is 0.0.

LONG1

For the Oblique Mercator projection, Format A (OM), the longitude of the first point defining the central line for the projection.

Acceptable values are -180 (180W) to +180 (180E).

LAT1

For the Oblique Mercator projection, Format A (OM), the latitude of the first point defining the central line for the projection.

Acceptable values are -90 (90S) to +90 (90N).

LONG2

For the Oblique Mercator projection, Format A (OM), the longitude of the second point defining the central line for the projection.

Acceptable values are -180 (180W) to +180 (180E).

LAT2

For the Oblique Mercator projection, Format A (OM), the latitude of the second point defining the central line for the projection.

Acceptable values are -90 (90S) to +90 (90N).

AZIMUTH

The azimuth east of north for the central line for the projection.

You use the AZIMUTH parameter for the following projections:

OM: Oblique Mercator, Format B
RSO: Rectified Skew Orthomorphic

Note: You can specify the value of the AZIMUTH parameter as an integer or decimal degrees. Do not specify the value as degrees, minutes, seconds.

LSATNUM

For the Space Oblique Mercator projection (SOM), the number of the Landsat satellite. This number is required to provide proper access to the defined Landsat path number (PATHNUM), because Landsat 4 and 5 have a different orbit than Landsat 1, 2, and 3.

PATHNUM

For the Space Oblique Mercator projection (SOM), the Landsat path number. Landsat 1, 2, and 3 can have path numbers ranging from 1 to 251. Landsat 4 and 5 can have path numbers ranging from 1 to 233.

REPORT

Specifies where to direct the generated report.

Available options are:

TERM: generates a report on the terminal (default)
DISK: generates a report on file "IMPRPT.LST"
OFF: turns off report generation
<filename>: appends a report to the specified file

MONITOR

The program progress can be monitored by printing the percentage of processing completed. A system parameter, MONITOR, controls this activity.

Available options are:

ON: Turns the monitor ON (default)
OFF: Turns the monitor OFF (recommended if running in batch or background mode)

Details

CIMPRO2 creates a new PCIDSK image file and sets the Master Georeference segment for the file.

If a new file is created, disk space is allocated for the specified number of 8-bit unsigned, 16-bit signed, 16-bit unsigned, 32-bit real, complex 16-bit signed, and complex 32-bit real image channels (DBNC) in either pixel-interleaved, band-interleaved, or file-interleaved mode (DBLAYOUT). The total number of image channels cannot exceed 4,096. Creating a database file with no (zero) channels (DBNC=0) implies that the file will be used only for storing segment data.

A database file can store a maximum of 1,024 segments (any type). The first segment in the file is always a georeferencing segment (type 150), containing the projection definition and projection bounds transform.

CIMPRO2 does not write (or clear) data to the database channels. To clear image channels, run the CLR algorithm.

Descriptive text (TEX1) that applies to the image is written to the database file.

The layout of image information (DBLAYOUT) on disk can be pixel interleaving (PIXEL), band interleaving (BAND), or file interleaving (FILE).

The selected layout is based primarily on performance. Band interleaved stores the data together for one band and gives a better performance when bands are not all being accessed at all times. Pixel interleaved stores the data for all bands together at a particular pixel and can provide an improved performance when all bands are used at once. File interleaved is similar to band interleaved, but the image-channel data is stored in external files (one file for each band).

The georeference bounds of the image are defined by specifying the upper-left (ULX, ULY) and lower-right (LRX, LRY) corners, based on the projection defined in the PROJECT parameter.

For example, if the value of PROJECT is:

LONG/LAT, then ULX, ULY, LRX, LRY are LONG/LAT values
A non-projection (meters, for example), then ULX, ULY, LRX, LRY are in PROJECT coordinates
A non-LONG/LAT projection (for example, UTM with a zone number), then the coordinates are defined by the LLBOUND parameter. If the value of LLBOUND is yes (Y), then LX, ULY, LRX, LRY are LONG/LAT values. If the value of LLBOUND is no (N), then the coordinates are in easting and northing values.

You can enter geographic coordinates (LONG/LAT) in a relatively free format, as shown in the following examples. Each example produces the same value of 110.258333 degrees longitude).

ULX = "110d 15' 30.0 W" (The symbol for seconds (") is omitted, because CIMPRO2 would otherwise interpret it as the end of the string.)
ULX = "110d15'30.0W"
ULX = "110 15.5' W"
ULX = "110.258333 W"
ULX = "-110.258333"
ULX = " 110 15 30 w"
ULX = " w 15 ' 30 110 d "

The horizontal and vertical dimensions of a single pixel are defined by using the BXPXSZ and BYPXSZ parameters, respectively.

If the value of the PROJECT parameter is:

"LONG/LAT", then the pixel size is in degrees, minutes, and/or seconds; otherwise, the pixel size is in meters.
not "LONG/LAT", then the pixel size in meters is saved as the pixel size in the file header used by other algorithms for calculating the area covered by a specified part of the image.

Note: You can modify the database pixel size in the file header by running the APS algorithm. Doing so does not change the projection pixel size stored in georeference segment 1.

With the EXTRAINF parameter, you specify how the information required for the projection is defined as input to CIMPRO2. If you specify:

"DEFAULT", then the projection parameters are the default image bounds (ULX, ULY, LRX, LRY).
"ASK", then the projection parameters are input from the terminal.
"EXPLICIT", then the projection information is used as input to CIMPRO2 explicitly by the required parameters, with no prompting or defaults provided.

Examples

Create a PCIDSK file named demo.pix with six 8-bit channels and three 32-bit real channels (no 16-bit signed, 16-bit unsigned, complex 16-bit signed, or complex 32-bit real channels).

First run CIMPRO2 with no output file defined, to get a report of the expected file size. (The file size is large enough to hold the image channels and a master georeference segment.)

EASI>FILE    =                  ! Do not create a file
EASI>TEX1    ="Demo Image"      ! Descriptive text
EASI>DBNC    =6,0,0,3           ! Six 8-bit and three 32-bit channels
EASI>DBLAYOUT=                  ! Defaults to "PIXEL"
EASI>PROJECT ="utm"
EASI>ZONE    = 11
EASI>ROW     ="s"
EASI>ELLIPS  ="e0"
EASI>LLBOUND ="n"               ! ULX,ULY,LRX,LRY are not LONG/LAT values
EASI>ULX     =" 428720"
EASI>ULY     ="3734400"
EASI>LRX     =" 444070"
EASI>LRY     ="3719050"
EASI>BXPXSZ  ="     30"         ! 30 meters
EASI>BYPXSZ  =                  ! Defaults to BXPXSZ
EASI>REPORT  =                  ! Defaults to terminal output
EASI>EXTRAINF=                  ! Defaults to "DEFAULT"

EASI>RUN CIMPRO2

Changing lower-right coordinates to accommodate the specified size.
LRX changed from:      444070.0  to:      444080.0
LRY changed from:     3719050.0  to:     3719040.0

Expected file dimensions:   512 pixels x 512 lines
         file size      :   4653.500000 Kbytes
                        :   4.544434 Mbytes

Now create the image by specifying a value for the FILE parameter, and then rerun CIMPRO2

EASI>FILE    ="demo.pix"        ! Create the file

EASI>RUN CIMPRO2

Changing lower-right coordinates to accommodate the specified size.
LRX changed from:      444070.0  to:      444080.0
LRY changed from:     3719050.0  to:     3719040.0

Creating     512P     512L    9C file: demo.pix
Creating segment:  1  [ 150: Georeferencing  ]    8 Blocks long

To produce the report on the terminal, run the PROREP algorithm.

EASI>FILE  ="demo.pix"
EASI>REPORT=                    ! Defaults to terminal output

EASI>RUN PROREP


  demo.pix                                [S    9PIC     512P     512L]

  1:GEOref    Type:150 [Georeferencing        ]   
  Contents: Master Georeferencing Segment for File 
                  
 Output Georeferenced Units: UTM    11 S E000
 Projection                : Universal Transverse Mercator Zone 11S  
 Earth Ellipsoid           : Clarke 1866 (NAD 27)  
 Upper Left  Corner        :       428720.000 E        3734400.000 N  
 Upper Right Corner        :       444080.000 E        3734400.000 N  
 Image Center              :       436400.000 E        3726720.000 N  
 Lower Left  Corner        :       428720.000 E        3719040.000 N  
 Lower Right Corner        :       444080.000 E        3719040.000 N  
 Pixel Size                :           30.000 E             30.000 N  

 Upper Left  Corner        : 117d46'10.50" W  Lon  33d44'56.45" N  Lat
 Upper Right Corner        : 117d36'13.52" W  Lon  33d44'59.77" N  Lat
 Image Center              : 117d41'10.03" W  Lon  33d40'48.85" N  Lat
 Lower Left  Corner        : 117d46'06.06" W  Lon  33d36'37.74" N  Lat
 Lower Right Corner        : 117d36'10.04" W  Lon  33d36'41.05" N  Lat

Environments	PYTHON :: EASI
Quick links	Description :: Parameters :: Parameter descriptions :: Details :: Examples :: Related

CIMPRO2

Create image-projected database

Description

Parameters

Parameter descriptions

Details

Examples