DEMZREF

Description

Convert DEM elevation reference (Mean Sea Level <-> Ellipsoid)

Parameters

Name	Type	Caption	Length	Value range
FILEDEM *	String	Input DEM file name	1 - 192
DBEC *	Integer	Input DEM channel	1 - 1	1 -
FILO *	String	Output file name	1 - 192
DBOC	Integer	Output converted image channel	0 - 1	1 -
BACKELEV	Float	Background elevation value	0 - 1
FAILVALUE	Float	Failure value	0 - 1
ELEVREF	String	Elevation reference	0 - 6	MSL | ELLIPS
ELEVUNIT	String	Input elevation units	0 - 5	METER | FEET
REPORT	String	Report mode	0 - 192	Quick links

* Required parameter

Parameter descriptions

FILEDEM

Specifies the name of the GDB-supported image file that contains data to process.

DBEC

Specifies the channel number of the input elevation data to use.

FILO

Specifies the name of the output image file.

FILO is the name of the output file that will be generated. It will have the same dimensions and projection as the input file, FILEDEM. An error occurs if the specified FILO already exists unless it is the input file in which case the input file is modified.

DBOC

Specifies the output channel to receive the converted image.

If the input (FILEDEM) and output (FILO) files are the same, and the output channel (DBOC) is identical to the input channel (DBEC) or if the specified output channel already exists, the new output overwrites the specified channel.

If FILO does not exist, a new file is created. In this case, DBOC should be defaulted.

If FILO points to a valid writable file and DBOC is defaulted, a new output channel is created.

BACKELEV

Specifies the background elevation value of the input and output digital elevation model (DEM). When the empty DEM file is first created, it fills the entire DEM channel with the BACKELEV value. In the final DEM file, this value indicates areas that have no stereo images from which to extract elevation values. It is recommended that this value be set as the NO_DATA_VALUE metadata tag in the output file.

Select a value that is different from FAILVALU (Failed Elevation Value) and that is not a valid extracted elevation value for the area. For example, setting BACKELEV to 0 in a coastal area is a poor choice because a valid extracted elevation can match this value.

FAILVALUE

Specifies the value given to pixels for which the generation of elevation values failed. This value should be outside the range of valid elevation values. The failure value identifies the areas that can be interpolated and filled.

ELEVREF

Specifies the original (input source) vertical reference for elevation values in the DEM.

If FILEDEM is specified but no ELEVATION_DATUM metadata tag exists, MSL is used by default. The ELEVATION_DATUM metadata tag is created or updated after the conversion is complete.

ELEVUNIT

Specifies the units of the elevation values stored as pixel values in the input DEM.

ELEVUNIT defaults to ELEVATION_UNITS metadata tag if it exists; otherwise, it defaults to METER. The ELEVATION_UNITS metadata tag is created or updated after the conversion is complete.

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

Details

The module DEMZREF converts a raster DEM from Ellipsoid to Mean Sea Level, or vice-versa, using a global geoid model.

Example

Convert channel 10 from mean sea level to ellipsoid, creating oirvine.pix with the default output channel 10, using METER as the elevation unit.

EASI>FILEDEM	=	"irvine.pix"
EASI>DBEC	=	10			! Specifies the elevation channel
EASI>FILO	=	"irvine.pix"
EASI>DBOC	=				! Output channel; default, a new channel is created
EASI>BACKVALU	=                      
EASI>FAILVALU	=                      
EASI>ELEVREF	=	"MSL"		! Elevation values are referenced to Mean Sea Level (geoid)
EASI>ELEVUNIT	=	"METRE"                     
EASI>REPORT	=	"TERM"
        
EASI>RUN DEMZREF