MAKEPRO2

Name	Type	Caption	Length	Value range
FILE *	str	Output file name	1 -
DBGEO	List[int]	Output georeference segment	0 - 1
PROJECT *	str	Projection	1 - 16
ZONE	List[int]	Projection zone (UTM, State Plane)	0 - 1
ROW	str	Projection zone row (UTM, UPS)	0 - 1
ELLIPS	str	Ellipsoid for the Earth	0 - 64
EXTRAINF	str	Extra Projection Info: DEFAULT/ASK	0 - 8	ASK \| DEFAULT \| 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.000
NFALSE	str	False Northing	0 - 32	Default: 0.000
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

Parameter descriptions

FILE

Specifies the name of the PCIDSK file to receive the georeference segment containing the projection parameters.

DBGEO

Specifies the georeference segment to receive the projection data. If this parameter is not specified, a new segment is created.

Note: Because MAKEPRO2 is used to define a projection (but no image bounds), it is recommended that you create a new segment, or use an existing georeference segment other than segment 1.

PROJECT

Specifies the projection.

Other supported units include:

PIXEL: image coordinates
METER: meters

ZONE

Specifies the projection zone, for UTM or State Plane projections.

If the projection is:

UTM: (Universal Transverse Mercator), ZONE is in the range of 1 to 60
State Plane (SPAF, SPCS, or SPIF): ZONE is in the range of 101 to 5400

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

Note: If ZONE is defined, its value takes precedence over any zone defined in the PROJECT parameter.

ROW

Specifies the projection zone rows, for UTM or UPS projections.

If the projection is:

UTM: (Universal Transverse Mercator), ROW is a letter in the range of C to X (but not I or O)
UPS: (Universal Polar Stereographic), ROW is one of A, B, Y, or Z.

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

Note: If ROW is defined, its value takes precedence over any ROW defined in the PROJECT parameter.

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 example any of the following can be used for WGS84:

ellips = "12"
ellips = "E12"
ellips = "E012"
ellips = "D000"
ellips = "D0"

Note: If ELLIPS is defined, its value takes precedence over any ellipsoid defined in the PROJECT parameter.

If the ellipsoid is not supported one of the supported earth models, it may be defined explicitly, in meters, as follows:

the equatorial radius (or semi-major axis or A) and the polar radius (or semi-minor axis or B) for the ellipsoid; for example, for Clarke 1866, ELLIPS= "6378206.4 6356583.8"
the equatorial radius (or semi-major axis or A) and the eccentricity squared for the ellipsoid; for example, for Clarke 1866, ELLIPS = "6378206.4, 0.006768658"
Note:
If the "flattening" (F) is known for the earth model, it may be used to derive the eccentricity squared (E**2) by the following formula:
```
E**2 = (2 * F) - (F * F)
```
which is the same as:
```
F = 1.0 - sqrt(1.0 - E**2)]
```
the radius of the sphere; for example, the usual radius of the earth as a sphere would be ELLIPS = "6370997"

EXTRAINF

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

Supported values are:

ASK: projection parameters are input from the terminal
DEFAULT: projection parameters are defaulted using the image bounds (ULX, ULY, LRX, LRY). This is the default value.
EXPLICIT: projection information must be explicitly input to MAKEPRO2 using the required parameters, with no prompting or defaults

Note: When this parameter is set to "DEFAULT", for projections where the parameters cannot be specified using the PROJECT, ZONE, ROW, and ELLIPS parameters, MAKEPRO2 will exit.

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

This parameter may be used for the following conic projections:

AECA: Albers Conical Equal-Area
EC: Equidistant Conic, with one standard parallel
EC: Equidistant Conic, with two standard parallels
LCC: Lambert Conformal Conic

STPAR2

Specifies the second standard parallel for conic projections:

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

This parameter may be used for the following conic projections:

AECA: Albers Conical Equal-Area
EC: Equidistant Conic, with two standard parallels
LCC: Lambert Conformal Conic

EFALSE

Specifies a false easting for the projection coordinates.

NFALSE

Specifies a false northing for the projection coordinates.

SCALE

Specifies the scale factor to be used for the projection.

This parameter may be used for the following projections:

OM: Oblique Mercator
RSO: Rectified Skew Orthomorphic
TM: Transverse Mercator

PHEIGHT

For the General Vertical Near-Side Perspective projection (GVNP), this parameter 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), this parameter 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), this parameter 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), this parameter 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), this parameter 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").

AZIMUTH may be used for the following projections:

OM: Oblique Mercator, Format B
RSO: Rectified Skew Orthomorphic

Note: This parameter may be entered as an integer or as decimal degrees, NOT as degrees, minutes, seconds.

LSATNUM

For the Space Oblique Mercator projection (SOM), this parameter specifies the number of the Landsat satellite. This value is required to properly access the defined 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), this parameter 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

Example

Define projection parameters (but no image bounds) for the file "irvine.pix".

from pci.makepro2 import makepro2

file     = 'irvine.pix' # file from which to project
dbgeo    = []           # append a new georeference segment
project  = 'utm'        # Universal Transverse Mercator (UTM)
zone     = [11]         # UTM zone 11
row      = 's'          # UTM row S
ellips   = 'd-1'        # "D-01", (NAD27 (USA, NADCON))
extrainf = ''           # Default, "DEF"
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"

makepro2( file, dbgeo, project, zone, row, ellips, extrainf, prolong, prolat,
stpar1, stpar2, efalse, nfalse, scale, pheight,
long1, lat1, long2, lat2, azimuth, lsatnum, pathnum )

Running PROREP on the new georeference segment recorded in the LASC parameter will produce the following report on the terminal.

 irvine.pix                              [S   14PIC     512P     512L]

  34:          Type:150 [Georeferencing        ]
 
Contents:

Georeference Units     : UTM    11 S D-01
Projection             : Universal Transverse Mercator
Datum - Ellipsoid      : NAD27 (USA, NADCON) (Continental U.S.) - Clarke 1866
Grid units             : METER

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

MAKEPRO2

Make Projection Segment

Description

Parameters

Parameter descriptions

Details

Example