DBREPRO

Description

DBREPRO sets the projection parameters and bounds to reproject an existing image database. A report may be generated, describing the output image database.

Parameters

Name	Type	Caption	Length	Value range
FILE *	String	Input file name	1 - 192
PROJECT	String	Projection	0 - 16
ZONE	Integer	Output projection zone number	0 - 1
ROW	String	Projection row	0 - 1
ELLIPS	String	Earth ellipsoid	0 - 64
OUTGEO	Integer	Output georeference segment	0 - 1
BXPXSZ	String	Horizontal pixel size	0 - 32
BYPXSZ	String	Vertical pixel size	0 - 32
LLBOUND	OString	Boundary coordinates are longitude/latitude	0 - 1	Y, N Default: Y
ULX	OString	Upper-left X coordinate of output image	0 - 16
ULY	OString	Upper-left coordinate of output image	0 - 16
LRX	OString	Lower-right coordinate of output image	0 - 16
LRY	OString	Lower-right coordinate of output image	0 - 16
PROLONG	OString	Projection reference longitude	0 - 16
PROLAT	OString	Projection reference longitude	0 - 16
STPAR1	OString	First standard parallel	0 - 16
STPAR2	OString	Second standard parallel	0 - 16
EFALSE	OString	False easting	0 - 16
NFALSE	OString	False northing	0 - 16
SCALE	OString	Projection scale factor	0 - 16
PHEIGHT	OString	Height of perspective	0 - 16
LONG1	OString	Longitude for first point	0 - 16
LAT1	OString	Latitude for first point	0 - 16
LONG2	OString	Longitude for second point	0 - 16
LAT2	OString	Latitude for second point	0 - 16
AZIMUTH	OString	Azimuth east of north (degrees)	0 - 16
LSATNUM	Integer	LANDSAT Number: 1/2/3/4/5	0 - 1
PATHNUM	Integer	LANDSAT path number	0 - 1
REPORT	String	Report mode	0 - 192	Quick links
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILE

Specifies the name of the input PCIDSK file to reproject.

PROJECT

Specifies the projection for the new image file.

For a detailed list of supported projections, see Map Projections in the Technical Reference help section.

ZONE

If the projection is equal to UTM (Universal Transverse Mercator) or State Plane (SPAF, SPCS, or SPIF), specifies the zone number of the output projection; otherwise, this parameter is not used.

For UTM, utm_zone is 1 to 60. For State Plane, sp_zone is 101 to 5400.

Upon completion of DBREPRO, ZONE is cleared. If it was defined and relevant to the projection on input, it is incorporated into the PROJECT string.

ROW

If the projection is equal to UTM (Universal Transverse Mercator) or UPS (Universal Polar Stereographic), specifies the row number for the projection; otherwise, this parameter is not used.

For UTM, utm_row is C to X (but not I or O). For UPS, ups_row is A, B, Y or Z.

Upon completion of DBREPRO, ROW is cleared. If it was defined and relevant to the projection on input, it is incorporated into the PROJECT string.

ELLIPS

Specifies the output ellipsoid or datum code to use to define the shape of the Earth.

For a detailed list of supported datums and ellipsoids, see Earth Models in the Technical Reference section.

OUTGEO

Specifies the georeference segment in the input file (FILE) that describes the output projection definition.

If this parameter is specified, it overrides the PROJECT, ZONE, ROW, and ELLIPS parameters.

BXPXSZ

Specifies the horizontal pixel size of the output image.

If the PROJECT parameter is specified as "LONG/LAT", this size is in degrees, minutes, and/or seconds; otherwise, this size is in meters.

Upon completion of DBREPRO, the horizontal pixel size, in projection units, is saved in this parameter.

BYPXSZ

Specifies the vertical pixel size of the output image.

If the PROJECT parameter is specified as "LONG/LAT", this size is in degrees, minutes, and/or seconds; otherwise, this size is in meters.

Upon completion of DBREPRO, the vertical pixel size, in projection units, is saved in this parameter.

LLBOUND

Specifies whether the reprojected image bounds are longitude and latitude coordinates.

If yes (Y), the output bounds (values of ULX, ULY, LRX, and LRY) are longitude and latitude values. This is the default value.

If no (N), the output bounds are easting and northing values.

ULX

Upon completion of DBREPRO, this parameter contains the reprojected X (horizontal) coordinate for the upper-left corner of the output image, using the coordinate system defined by LLBOUND.

ULY

Upon completion of DBREPRO, this parameter contains the reprojected Y (vertical) coordinate for the upper-left corner of the output image, using the coordinate system defined by LLBOUND.

LRX

Upon completion of DBREPRO, this parameter contains the reprojected X (horizontal) coordinate for the lower-right image corner, using the coordinate system defined by LLBOUND.

LRY

Upon completion of DBREPRO, this parameter contains the reprojected Y (vertical) coordinate for the lower-right image corner, using the coordinate system defined by LLBOUND.

PROLONG

If the reference longitude for the projection (PROLONG) was read from the georeference segment (OUTGEO) and is relevant to the output projection, upon completion of DBREPRO this parameter is updated with the new value. If it is not relevant to the output projection, it is cleared.

PROLAT

If the reference latitude for the projection (PROLAT) was read from the georeference segment (OUTGEO) and is relevant to the output projection, upon completion of DBREPRO this parameter is updated with the new value. If it is not relevant to the output projection, it is cleared.

STPAR1

If the value of the first standard parallel (STPAR1) was read from the georeference segment (OUTGEO) and is relevant to the output projection, upon completion of DBREPRO this parameter is updated with the new value. If it is not relevant to the output projection, it is cleared.

STPAR2

If the value of the second standard parallel (STPAR2) was read from the georeference segment (OUTGEO) and is relevant to the output projection, upon completion of DBREPRO this parameter is updated with the new value. If it is not relevant to the output projection, it is cleared.

EFALSE

If the false easting value (EFALSE) was read from the georeference segment (OUTGEO) and is relevant to the output projection, upon completion of DBREPRO this parameter is updated with the new value. If it is not relevant to the output projection, it is cleared.

NFALSE

If the false norting value (NFALSE) was read from the georeference segment (OUTGEO) and is relevant to the output projection, upon completion of DBREPRO this parameter is updated with the new value. If it is not relevant to the output projection, it is cleared.

SCALE

If the projection scale factor (SCALE) was read from the georeference segment (OUTGEO) and is relevant to the output projection, upon completion of DBREPRO this parameter is updated with the new value. If it is not relevant to the output projection, it is cleared.

PHEIGHT

If the perspective height (PHEIGHT) value was read from the georeference segment (OUTGEO) and is relevant to the output projection, upon completion of DBREPRO this parameter is updated with the new value. If it is not relevant to the output projection, it is cleared.

LONG1

For an Oblique Mercator projection, Format A (OM), if the longitude of the first point defining the central line for the projection (LONG1) was read from the georeference segment (OUTGEO) and is relevant to the output projection, upon completion of DBREPRO this parameter is updated with the new value. If it is not relevant to the output projection, it is cleared.

LAT1

For an Oblique Mercator projection, Format A (OM), if the latitude of the first point defining the central line for the projection (LAT1) was read from the georeference segment (OUTGEO) and is relevant to the output projection, upon completion of DBREPRO this parameter is updated with the new value. If it is not relevant to the output projection, it is cleared.

LONG2

For an Oblique Mercator projection, Format A (OM), if the longitude of the second point defining the central line for the projection (LONG2) was read from the georeference segment (OUTGEO) and is relevant to the output projection, upon completion of DBREPRO this parameter is updated with the new value. If it is not relevant to the output projection, it is cleared.

LAT2

For an Oblique Mercator projection, Format A (OM), if the latitude of the second point defining the central line for the projection (LAT2) was read from the georeference segment (OUTGEO) and is relevant to the output projection, upon completion of DBREPRO this parameter is updated with the new value. If it is not relevant to the output projection, it is cleared.

AZIMUTH

If the azimuth east of north for the central line for the projection (AZIMUTH) was read from the georeference segment (OUTGEO) and is relevant to the output projection, upon completion of DBREPRO this parameter is updated with the new value. If it is not relevant to the output projection, it is cleared.

LSATNUM

For a Space Oblique Mercator projection (SOM), if the number of the Landsat satellite (LSATNUM) was read from the georeference segment (OUTGEO) and is relevant to the output projection, upon completion of DBREPRO this parameter is updated with the new value. If it is not relevant tot he output projection, it is cleared.

PATHNUM

For a Space Oblique Mercator projection (SOM), if the Landsat satellite path number (PATHNUM) was read from the georeference segment (OUTGEO) and is relevant to the output projection, upon completion of DBREPRO this parameter is updated with the new value. If it is not relevant tot he output projection, it is cleared.

REPORT

Specifies where to direct the generated report.

Available options are:

• TERM: generates a report on the terminal (default)
• DISK: generates a report on file "IMPRPT.LST"
• OFF: turns off report generation
• <filename>: appends a report to the specified file

MONITOR

The program progress can be monitored by printing the percentage of processing completed. A system parameter, MONITOR, controls this activity.

Available options are:

• ON: Turns the monitor ON (default)
• OFF: Turns the monitor OFF (recommended if running in batch or background mode)

Details

DBREPRO sets the parameters for reprojecting an existing database. After DBREPRO has been run, CIMPRO2 can be used to create the new image database from the projection parameters and bounds set by DBREPRO.

FILE is the existing image database from which to project. Special cases (LONG/LAT, UTM, SPAF, SPCS, SPIF, UPS) of the output projection may be defined by a combination of the PROJECT, ZONE, ROW, ELLIPS parameters or by specifying a georeference segment (OUTGEO). Other projections must be defined in a georeference segment (OUTGEO) that exists in the input file (FILE). The output georeference segment must not be segment 1, as that segment is assumed to contain the projection information from which to convert.

The output pixel size may be specified using BXPXSZ and BYPXSZ. If the output units are LONG/LAT, these values are in degrees, minutes, and/or seconds; otherwise, these values are in meters.

The reported file size in KB and MB applies only to the image channels from FILE and a master georeference segment; it does not take into account the size of any other segments from FILE.

Example

The following example shows how to convert a projection from "UTM" to "LONG/LAT". The output projection is a special case that can be defined using only the PROJECT parameter. The output pixel size is defined because the input pixel size of 30 meters is not transformed to "LONG/LAT".

EASI>file    = "irvine.pix"    ! File to project from
EASI>project = "long"          ! Project to  "LONG/LAT"
EASI>zone    =                 ! No zone for "LONG/LAT" 
EASI>row     =                 ! No row  for "LONG/LAT" 
EASI>ellips  =                 ! Default, "E000" from input
EASI>outgeo  =                 ! No output projection segment
EASI>bxpxsz  = " 0' 1"         ! Output pixel is 1 second wide
EASI>bypxsz  =                 ! Default, same size as BXPXSZ
EASI>report  =                 ! Default, output to terminal

EASI>run dbrepro