| Environments | PYTHON :: EASI |
| Quick links | Description :: Parameters :: Parameter descriptions :: Return Value :: Details :: Example :: References :: Related |
| Back to top |
| Back to top |
foot(file, dbsl, newseg, ifunits, ofunits)
| Name | Type | Caption | Length | Value range |
|---|---|---|---|---|
| FILE * | str | Input file name | 1 - | |
| DBSL | List[int] | Input segment(s) | 0 - | |
| NEWSEG | str | Create new segment | 0 - 3 | YES | NO Default: YES |
| IFUNITS | str | Input units | 0 - 9 | |
| OFUNITS * | str | Output units | 1 - 9 |
| Back to top |
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.
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.
| Back to top |
Returns:
Type: PCI_INT
| Back to top |
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.
Conversions
The conversions between the supported units are based on the following conversion factors documented in Appendix A from Robinson [1].
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
The following conversion factors were derived from and are compatible with the GCTP software produced by the U.S. Geological Survey [2]:
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
| Back to top |
For processing within CATALYST Professional, the georeference bounds must be converted to State Plane coordinates in meters.
from pci.foot import foot file = "spcs406.pix" # input file dbsl = [1] # input segment newseg = "no" # overwrite input segment ifunits = "" # input segment units are FOOT ofunits = "metre" # convert units to METRE foot( file, dbsl, newseg, ifunits, ofunits )
| Back to top |
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.
© PCI Geomatics Enterprises, Inc.®, 2026. All rights reserved.