SETPRO2

Description

Specifies the projection information for an existing image database. The parameters defining the projection and the image boundaries in projection coordinates are stored in a new or existing segment on the file.

Parameters

setpro2(file, project, zone, row, ellips, llbound, ulx, uly, lrx, lry, extrainf, prolong, prolat, stpar1, stpar2, efalse, nfalse, scale, pheight, long1, lat1, long2, lat2, azimuth, lsatnum, pathnum)

Name	Type	Caption	Length	Value range
FILE *	str	Input file	1 -
PROJECT *	str	Projection	1 - 16
ZONE	List[int]	Projection zone	0 - 1	1 - 5400
ROW	str	Projection Row: UTM, UPS	0 - 1	UTM | UPS
ELLIPS	str	Ellipsoid for the Earth	0 - 64
LLBOUND	str	Image bounds are Long/Lat	0 - 1	Y | N Default: Y
ULX *	str	Upper-left: longitude or easting	1 - 32
ULY *	str	Upper-left: latitude or northing	1 - 32
LRX *	str	Lower-right: longitude or easting	1 - 32
LRY *	str	Lower-right: latitude or northing	1 - 32
EXTRAINF	str	Extra projection information	0 - 8	DEFAULT | ASK | EXPLICIT Default: DEFAULT
PROLONG	str	Projection reference longitude	0 - 32
PROLAT	str	Projection reference latitude	0 - 32
STPAR1	str	First standard parallel	0 - 32
STPAR2	str	Second standard parallel	0 - 32
EFALSE	str	False easting	0 - 32	Default: 0.0
NFALSE	str	False northing	0 - 32	Default: 0.0
SCALE	str	Scale factor for projection	0 - 32	Default: 1.0
PHEIGHT	str	Height of perspective	0 - 32	Default: 0.0
LONG1	str	Longitude for first point	0 - 32
LAT1	str	Latitude for first point	0 - 32
LONG2	str	Longitude for second point	0 - 32
LAT2	str	Latitude for second point	0 - 32
AZIMUTH	str	Azimuth East of North (degrees)	0 - 32	Default: 0.0
LSATNUM	List[int]	LANDSAT number	0 - 1	1 - 5
PATHNUM	List[int]	LANDSAT path number	0 - 1	1 - 251

* Required parameter

Parameter descriptions

FILE

Specifies the name of the PCIDSK file on which to set the georeferencing.

PROJECT

Specifies the projection. For a list of supported projections, see Supported projections.

ZONE

Specifies the projection zone.

If the projection is not UTM or State Plane, this parameter is not used.

For more information about projection zones, see Introduction to projections and Earth models.

ROW

Specifies the zone rows.

If the projection is not UTM or UPS, this parameter is not used.

ELLIPS

Specifies the model to use to define the shape of the Earth.

ELLIPS can be set directly with an ellipsoid code or a datum code.

For a list of supported ellipsoids, see Ellipsoid codes; for supported datums, see Datum codes.

LLBOUND

Specifies whether the image boundaries (ULX, ULY, LRX, and LRY) are Longitude and Latitude values.

ULX

Specifies the horizontal (X) coordinate for the upper-left corner of the image.

ULY

Specifies the vertical (Y) coordinate for the upper-left corner of the image.

LRX

Specifies the horizontal (X) coordinate for the lower-right corner of the image.

LRY

Specifies the vertical (Y) coordinate for the lower-right corner of the image.

EXTRAINF

Optionally specifies whether to prompt for the information that defines the projection.

PROLONG

Specifies the reference longitude for the projection:

("-180" (or "180W") to "+180" (or "180E")).

PROLAT

Specifies the reference latitude for the projection.

("-90" (or "90S") to "+90" (or "90N"))

STPAR1

Specifies the first standard parallel for conic projections

("-90" (or "90S") to "+90" (or "90N"))

STPAR2

Specifies the second standard parallel for conic projections.

("-90" (or "90S") to "+90" (or "90N"))

EFALSE

Specifies a false easting value for the projection coordinates.

NFALSE

Specifies a false northing value for the projection coordinates.

SCALE

Specifies the scale factor to be used for the projection.

PHEIGHT

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

LONG1

For the Oblique Mercator projection, Format A (OM), specifies the longitude of the first point defining the central line for the projection ("-180" (or "180W") to "+180" (or "180E")).

LAT1

For the Oblique Mercator projection, Format A (OM), specifies the latitude of the first point defining the central line for the projection ("-90" (or "90S") to "+90" (or "90N")).

LONG2

For the Oblique Mercator projection, Format A (OM), specifies the longitude of the second point defining the central line for the projection ("-180" (or "180W") to "+180" (or "180E")).

LAT2

For the Oblique Mercator projection, Format A (OM), specifies the latitude of the second point defining the central line for the projection ("-90" (or "90S") to "+90" (or "90N")).

AZIMUTH

Specifies, in degrees, the azimuth East of North for the central line for the projection ("0.0" to "360.0").

LSATNUM

For the Space Oblique Mercator projection (SOM), specifies the number of the Landsat satellite.

This is required to properly access the defined Landsat path number (PATHNUM), as the Landsat 4 and 5 have a different orbit than Landsat 1, 2, and 3.

PATHNUM

For the Space Oblique Mercator projection (SOM), specifies the Landsat path number.

Landsat 1, 2, and 3 may have path numbers in the range of 1 to 251. Landsat 4 and 5 may have path numbers in the range of 1 to 233.

Details

SETPRO2 updates the georeference segment on an existing PCIDSK image file.

The georeference boundaries of the image are specified with the upper-left corner (ULX, ULY) and lower-right (LRX, LRY) corners. If the specified projection (PROJECT) is 'LONG/LAT', the boundary values are longitude and latitude values. If PROJECT is a non-projection (for example, 'METRES), the boundaries are in coordinates specified by the projection. If PROJECT is a non-LONG/LAT projection (for example, 'UTM' with a zone number), the LLBOUND parameter specifies whether the boundaries are in easting and northings or in LONG/LAT values.

The EXTRAINF parameter defines how the information required for the projection is input to SETPRO2. If set to 'DEFAULT', the projection parameters are defaulted using the image bounds (ULX, ULY, LRX, LRY). If set to 'ASK', projection parameters are input from the terminal. If set to 'EXPLICIT', projection information will have been input to SETPRO2 explicitly by the required parameters, with no prompting or defaults provided.

Example

Set the projection information for the existing file demo.pix.

from pci.setpro2 import setpro2

file     = 'irvine.pix' # file to georeference
project  = 'utm'        # Universal Transverse Mercator (UTM)
zone     = [11]         # UTM zone 11
row      = 's'          # UTM row S
ellips   = 'd-1'        # "D-01", (NAD27 (USA, NADCON))
llbound  = 'n'          # bounds are not LONG/LAT
ulx      = ' 428720'    # upper-left X
uly      = '3734400'    # upper-left Y
lrx      = ' 444080'    # lower-right X
lry      = '3719040'    # lower-right Y
extrainf = ''           # default, "DEFAULT"
prolong  = ''           # not used for "UTM"
prolat   = ''           # not used for "UTM"
stpar1   = ''           # not used for "UTM"
stpar2   = ''           # not used for "UTM"
efalse   = ''           # not used for "UTM"
nfalse   = ''           # not used for "UTM"
scale    = ''           # not used for "UTM"
pheight  = ''           # not used for "UTM"
long1    = ''           # not used for "UTM"
lat1     = ''           # not used for "UTM"
long2    = ''           # not used for "UTM"
lat2     = ''           # not used for "UTM"
azimuth  = ''           # not used for "UTM"
lsatnum  = []           # not used for "UTM"
pathnum  = []           # not used for "UTM"

setpro2( file, project, zone, row, ellips, llbound, ulx, uly, lrx, lry, extrainf,
prolong, prolat, stpar1, stpar2, efalse, nfalse, scale, pheight,
long1, lat1, long2, lat2, azimuth, lsatnum, pathnum )