PROCONV

Description

Converts between image, geographic, and projection coordinates.

Parameters

Name	Type	Caption	Length	Value range
FILE	String	Input file name	0 - 192
DBGEO	Integer	Input georeferencing segment	0 - 2
IUNITS	String	Input map units	0 - 192	LON \| UTM \| SPAF \| SPCS \| SPIF \| PIX
OUNITS	String	Output map units	0 - 192	LON \| UTM \| SPAF \| SPCS \| SPIF \| PIX
TFILE	String	Text file name	0 - 192
IXYSTR	String	Input X,Y string coordinates	0 - 192
IXYNUM	Float	Input X,Y numeric coordinates	0 - 2
LTYP	String	Listing type	0 - 5	BRIEF \| SHORT \| FULL Default: SHORT
DMSFORM	String	Deg/min/sec format	0 - 3	ON \| OFF Default: OFF
OXYSTR	OString	Output X,Y string coordinates	0 - 48
OXYNUM	Float	Output X,Y numeric coordinates	0 - 2	Default: 0,0
REPORT	String	Report mode	0 - 192	Quick links

Parameter descriptions

FILE

Specifies the PCIDSK file that contains the georeferencing segment(s).

Note: If this parameter is not specified, the projection characteristics are defined by the IUNITS and OUNITS parameters.

DBGEO

Specifies the georeferenced projection segment(s) in which PROCONV looks for a projection system.

The input coordinates can be converted from or to the specified georeferenced projection system(s).

This parameter can be defaulted or specified as 1 or 2 values, depending on whether the IUNITS and OUNITS parameters are specified. See the Details section for more information.

IUNITS

Specifies the input coordinate system (image, geographic, or projection coordinates).

Supported units are:

LON: longitude/latitude
UTM zone #: Universal Transverse Mercator; zone must be specified
SPAF zone #: State Plane; zone must be specified
SPCS zone #: State Plane; zone must be specified
SPIF zone #: State Plane; zone must be specified
PIX: pixel/line

OUNITS

Specifies the output coordinate system (image, geographic, or projection coordinates).

Supported units are:

LON: longitude/latitude
UTM zone #: Universal Transverse Mercator; zone must be specified
SPAF zone #: State Plane; zone must be specified
SPCS zone #: State Plane; zone must be specified
SPIF zone #: State Plane; zone must be specified
PIX: pixel/line

TFILE

Optionally specifies the name of a text file that contains data to use for conversion instead of input from the terminal.

See the Details section for information about the format of the text file.

IXYSTR

Specifies the input X (horizontal), Y (vertical) coordinates to convert, in a character string.

For example:

non-longitude,non-latitude (if not "LONG/LAT")
longitude,latitude (if "LONG/LAT")

Note: If TFILE, IXYSTR, and IXYNUM are unspecified, the coordinates to convert are prompted from the terminal. See the Details section for information about the format of the text file.

IXYNUM

Specifies the input X (horizontal), Y (vertical) coordinates to convert from numeric values.

For example:

non-longitude,non-latitude (if not "LONG/LAT")
longitude,latitude (if "LONG/LAT")

Note: If TFILE, IXYSTR, and IXYNUM are unspecified, the coordinates to convert are prompted from the terminal. See the Details section for information about the format of the text file.

LTYP

Optionally specifies the listing type for the report.

Available options are:

BRIEF: produces a summary of each segment including the segment number, its type, and the segment name.
SHORT: produces a summary of each segment including the segment number, its name, the time and date the segment was last written to, a description of the segment, its type, and a description of the segment type.
FULL: produces a summary of each segment all available information for that segment.

DMSFORM

Specifies whether LONG/LAT coordinates should be output using real numbers or degrees/minutes/seconds/hemisphere strings. If set to OFF, degrees are output as signed real numbers. If set to ON, d ' and " symbols are used as separators between degrees, minutes, seconds, and hemisphere. If units are not LONG/LAT, this parameter is ignored.

OXYSTR

Upon completion of PROCONV, this parameter receives the last set of coordinates produced.

OXYSTR(1) to OXYSTR(32) contains the horizontal output coordinate and OXYSTR(33) to OXYSTR(64) contains the vertical output coordinate.

OXYNUM

Upon completion of PROCONV, this parameter receives the last set of coordinates produced.

OXYNUM(1) and OXYNUM(2) contain the horizontal and vertical output coordinates, respectively.

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

Details

PROCONV converts between image (pixel, line), geographic (longitude, latitude), and projection (easting, northing) coordinates and reports the result.

The last pair of output coordinates converted are stored in the output parameters OXYNUM and OXYSTR.

The input coordinate system is specified by Input Map Units (IUNITS) parameter. If this parameter is not specified or if it is specified as "PIX", an input georeferenced segment (DBGEO) must be supplied to specify the input coordinate system.

Similarly, the Output Map Units (OUNITS) parameter specifies the output coordinate system. If this parameter is not specified or if it is specified as "PIX", a second (first if there is no input georeferenced segment) georeferenced segment must be supplied for the output coordinate system.

If a text file (TFILE) or input character string (IXYSTR) is used as input, the specified file or string must contain pairs of coordinates to be converted. Each set of coordinates should contain the longitude/latitude, the easting/northing, or the X/Y pair. Each pair of coordinates must be separated by a comma or the second coordinate must begin at character 33. The maximum width of each coordinate cannot exceed 32 characters.

Longitude and latitude can be expressed in one of the following formats:

-DDD.DDDD: decimal degrees
DD MM SS.SS H: blank-separated deg, min, sec, hemisphere
DDdMM'SS" H: d, ', and " as separators

Note: A comma is not allowed as a separator for degrees, minutes, seconds, because it indicates the beginning of the second coordinate.

Projection or image coordinates must be expressed as integers or decimal numbers.

If one or more parameters are specified for input of coordinates, the following priority is followed and only one means of data input is processed:

TFILE is specified
IXYSTR is specified (TFILE must not be defined)
IXYNUM is specified (TFILE and IXYSTR must not be defined)
Input is read from the terminal (TFILE, IXYSTR, and IXYNUM must not be defined)

Example

In this example, the user wants to find the longitude/latitude of a pixel in the demo file "irvine.pix". The X/Y coordinates have already been entered into the text file "coord.txt". Note that the underlying projection is Universal Transverse Mercator.

Coordinate input by IXYSTR character parameter.

EASI>file	=	
EASI>dbgeo	=	
EASI>iunits	=	"LON E0"
EASI>ounits	=	"UTM11S E0"
EASI>tfile	=	
EASI>ixystr	=	"117d 46' 9.32 W,  33d 44' 55.48 N"
EASI>ixynum	=		! unnecessary, IXYNUM has lower priority
EASI>ltyp	=	"SHORT"
EASI>dmsform	=	"ON"
EASI>oxystr	=	
EASI>oxynum	=	

EASI>run PROCONV

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