PROCONV

Description

Converts between image, geographic, and projection coordinates.

Parameters

Name	Type	Length	Value range
InputGEO: Input georeferencing segment	GEO port	0 - 2
Input Map Units	String	0 -	LON | UTM | SPAF | SPCS | SPIF | PIX
Output Map Units	String	0 -	LON | UTM | SPAF | SPCS | SPIF | PIX
Input X and Y String Coordinates	String	0 -
Input X and Y Numeric Coordinates	Float	0 - 2
Listing Type	String	0 - 1	BRIEF | SHORT | FULL Default: SHORT
Output X, Y String Coordinates	OString	0 - 1024
Output Horizontal numeric coordinate	Float	0 - 1
Output Vertical numeric coordinate	Float	0 - 1
Report	String	0 - 192	See parameter description

Parameter descriptions

InputGEO: Input georeferencing segment

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).

Input Map Units

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

Output Map Units

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

Input X and Y String Coordinates

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

Input X and Y Numeric Coordinates

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

Listing Type

Optionally specifies the listing type for the report.

Output X, Y String Coordinates

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.

Output Horizontal numeric coordinate

Upon completion of PROCONV, this parameter receives the last horizontal coordinate produced.

Output Vertical numeric coordinate

Upon completion of PROCONV, this parameter receives the last vertical coordinate produced.

Report

Specifies where to direct the generated report.

Available options are:

• LOG: generates a report on the terminal (default)
• <modulename.RPT>: appends a report to the module's RPT file
• DISK: generates a report on file "IMPRPT.LST"

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 X, Y String Coordinates, Horizontal Number Coordinates, and Vertical Number Coordinates.

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.

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