FOOT

Description

Parameters

Parameter descriptions

FILE

Specifies the name of the PCIDSK file that contains the georeferencing or GCP segments to convert.

DBSL

Specifies the input segments (georeferencing (type 150) or ground control point (type 213 or 214)) to convert.

The output segment name and description are retained from the input segment being processed. The input segment and the transformation performed are recorded in the output segment history.

If this parameter is not specified, FOOT converts all georeferencing or GCP segments in the input image.

Segments flagged as deleted will not be processed; the warning E023 ("Segment does not exist.") appears, and FOOT goes on to process the next segment.

Ranges of channels or segments can be specified with negative values. For example, {1,-4,10} is internally expanded to {1,2,3,4,10}. When you are not specifying a range in this way, only 48 numbers can be specified explicitly.

NEWSEG

Specifies whether to create new segments (YES) or to overwrite the existing segments (NO).

IFUNITS

Specifies the units of the input segments. If specified, this overrides the units stored in each segment.

OFUNITS

Specifies the units of the output segments.

Details

Most functions in CATALYST Professional assume sizes and distances are measured in meters. (For "LONG/LAT", it is assumed that the units are in decimal degrees of Longitude and Latitude.) FOOT is a utility program that would normally be run on segment data imported to CATALYST Professional to convert "FOOT" values to equivalent "METRE" values for processing. It can also be used to convert "METRE" values to equivalent 'FOOT' values for processing outside CATALYST Professional.

FOOT transforms coordinates in georeferencing or GCP segments in a PCIDSK file. New segments can be created (NEWSEG="YES") or the existing segments can be overwritten (NEWSEG="NO").

If the input units (IFUNITS) are specified, the specified units override the units stored in the segment; otherwise, the units from the input segment are used, in which case the segment units must be METRE, FOOT, US FOOT, or INTL FOOT.

The output units (OFUNITS) must be METRE, FOOT, US FOOT, or INTL FOOT.

1.0 inch of the "International Foot" equals 25.4 millimetres exactly

1.0 metre equals 39.37 inches for "U.S. Survey Feet" exactly

 U.S. survey feet   / metre                  3.2808333333333330
 International feet / metre                  3.2808398950131240

 metres / U.S. survey foot                   0.3048006096012192
 metres / International foot                 0.3048000000000000

 U.S. survey feet   / International foot     0.9999980000000000
 International feet / U.S. survey foot       1.0000020000040000

Example

For processing within CATALYST Professional, the georeference bounds must be converted to State Plane coordinates in meters.

EASI>file	=	"spcs406.pix"	! input file
EASI>dbsl	=	1	! input segment
EASI>newseg	=	"no"	! overwrite input segment
EASI>ifunits	=		! input segment units are FOOT
EASI>ofunits	=	"metre"	! convert units to METRE

EASI>run FOOT

References

Robinson, A.H., Sale, R.D., Morrison, J.L., and Muehrcke, P.C. (1984). Elements of Cartography (5th Ed.). New York: John Wiley and Sons

U.S. Geological Survey. National Mapping Division. (1990). Software documentation for GCTP, general cartographic transformation package. Reston, Virginia.