DATUM

Description

DATUM updates the earth model portion of the segment units with the specified Earth Datum.

Parameters

Name	Type	Caption	Length	Value range
FILE *	String	Input file name	1 - 192
DBSL	Integer	Input segment(s)	0 -
EARTHD *	String	Earth datum	1 - 4	See description Default: D000
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 PCIDSK file containing the segments to modify.

DBSL

Specifies the segment(s) to update with the specified earth datum. DATUM will update the units for georeferencing, GCP, or vector segments.

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.

EARTHD

Specifies the earth datum to use to update the segment units string. The default value is "D000" (WGS 1984).

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

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

DATUM is a utility function used to update the earth model in the units for specified database segments from an ellipsoid to the specified earth datum. No datum shifting of the segment data is done.

DATUM supports only horizontal datums; vertical datums are not supported within this context.

The FILE parameter specifies the PCISDK image file that contains the segments to update. DATUM can process georeference, vector, and GCP segments that have unit types. DBSL specifies the list of segments to process; if DBSL is not specified, DATUM updates all supported segments.

For detailed information about datum codes, see Datums in the Technical References help section.

For a list of ellipsoid codes, see Ellipsoids in the Technical References help section.

Example

Update the earth model in the vector units for vector segment 25 in the file "irvine.pix".

EASI>FILE    = "irvine.pix"  ! file to update
EASI>DBSL    = 25            ! process segment 25
EASI>EARTHD  = "D-1"         ! update units to use "D-01"
EASI>REPORT=
EASI>MONITOR=

EASI>RUN DATUM