GEOCODEDEM

Name	Type	Length	Value range
Input: Input epipolar DEM channel	Raster port	0 - 1
InputMMLeft: Input left math model segment *	BIN port	1 - 1024
InputMMRight: Input right math model segment *	BIN port	1 - 1024
InputEpipolarHeader: Input epipolar header *	BIN port	1 - 1024
Input window	Integer	0 - 4	Xoffset, Yoffset, Xsize, Ysize
Elevation failure value	Float	0 - 1	Default: -100
Background elevation value	Float	0 - 1
Fill holes	String	0 - 1	YES \| NO Default: YES
Epipolar DEM clipping	String	0 - 1
Epipolar DEM clipping units	String	0 - 1	Pixels \| Percent Default: Pixels
OutputGeocodedDEM: Output geocoded DEM file *	Raster port	1 -
Elevation reference	String	0 -	MSL \| ELLIPS
Elevation units	String	0 - 1	METER \| FEET \| US_FEET Default: METER
Map projection	String	0 -	Default: None
Upper left coordinate	Float	0 - 2
Lower right coordinate	Float	0 - 2
Output pixel ground size (X,Y)	Double	0 - 2
Merge geocoded DEM option	String	0 - 1	LAST \| AVERAGE \| SCORE \| BLEND Default: BLEND
Working Memory Size (MB)	Integer	0 - 1	Default: 2000
Report	String	0 - 192	See parameter description

Parameter descriptions

Input: Input epipolar DEM channel

Optionally specifies the input channel that contains the digital elevation model (DEM) to be extracted.

If this parameter is not specified, the function automatically searches the image, DEM, and, optionally, the correlation score (DBSCORE) channels from the input file. By default, the function will geocode the second channel in the input file.

InputMMLeft: Input left math model segment

Specifies the left math model segment for the epipolar digital elevation model (DEM) layer.

InputMMRight: Input right math model segment

Specifies the right math model segment for the epipolar digital elevation model (DEM) layer.

InputEpipolarHeader: Input epipolar header

Specifies the header for the epipolar DEM layers.

Input window

Specifies the raster window, in pixel and line coordinates, that is read from the input epipolar images. If this parameter is not specified, the entire layer is used by default.

Xoffset, Yoffset define the upper-left starting pixel coordinates of the window. Xsize is the number of pixels that define the window width. Ysize is the number of lines that define the window height.

If UPLEFT (Upper Left Coordinate) and LORIGHT (Lower Right Coordinate) are specified, this parameter is ignored.

Elevation failure value

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.

Background elevation value

Optionally specifies the background elevation value of the input and output DEM.

When the empty DEM file is first created, the function fills the entire DEM channel with the specified background elevation value. In the final DEM file, this value indicates areas that have no stereo images from which to extract elevation values.

Select a value that is different from the Elevation Failure Value (FAILVALU) and that is not a valid extracted elevation value for the area. For example, setting this parameter to 0 in a coastal area is a poor choice because a valid extracted elevation can match this value. If the FAILVALU and the NO_DATA_VALUE/BACKELEV value are the same then the algorithm will exit with an error.

If this parameter is not specified, the function checks for ELEVATION_BACKGROUND or NO_DATA_VALUE metadata tags, first at the channel level, then at the file level. If this value is not specified or found in the metadata, the function uses the default value of -32768.

If this parameter is specified and the NO_DATA_VALUE metadata tag is found in the input file then the algorithm will exit with an error. Overridding the NO_DATA_VALUE with this parameter can cause errors that are hard to diagnose. To fix the error do one of the following:

Modify the NO_DATA_VALUE value in the input file. If the NO_DATA_VALUE is wrong then choose this option.
Leave the BACKELEV parameter blank. If the NO_DATA_VALUE is correct then choose this option.
Set the BACKELEV to the same value as the NO_DATA_VALUE. This is an alternative to solution 2.

Fill holes

Specifies whether to automatically edit the DEM.

Supported options are:

YES (selected): small failed areas (holes) are interpolated. The interpolation process is based on an algorithm named Distance Transform. This is the default value.
NO (cleared): the DEM is not modified and the cells for which the elevation value generation fails are assigned the value specified in FAILVALU (Elevation Failure Value).

Epipolar DEM clipping

Specifies the amount of data to be clipped from the epipolar DEMs before merging and geocoding them. This functionality is possible only when OutputGeocodedDEM is specified.

This parameter specifies the amount of the actual image data that is clipped, in pixels or percentage, as specified by the Epipolar DEM Clipping Units parameter.

Two values can be entered:

the first value defines the number of pixels in the left-right direction
the second value defines the number of lines in the up-down direction

The default is blank, which means no clipping occurs. The maximum percentage value is 49%.

Epipolar DEM clipping units

Specifies the units for Epipolar DEM Clipping.

This parameter specifies the amount of the actual image data that is clipped, in the pixels or percentage as specified by the Epipolar DEM Clipping Units parameter.

Available options are:

pixels: if pixel units are specified and Epipolar DEM Clipping is defined as 5,10, five pixels are clipped from the left and right edge of the epipolar DEM, while ten pixels are clipped from the top and bottom edges. If a single value is specified, clipping is applied to all edges of the image; for example, if the specified value is 5, five pixels are clipped from all four edges.
percent: if percentage is specified and Epipolar DEM Clipping is defined as 5,10, five percent is clipped from the left and right edges and ten percent from the top and bottom edges.

OutputGeocodedDEM: Output geocoded DEM file

Specifies the name of the generated geocoded digital elevation model (DEM) file.

Elevation reference

Elevation units

The units of the elevation values that are stored as pixel values in the generated geocoded DEM.

Acceptable values are as follows:

METER (default value)
FEET
US_FEET

If you specify the elevation values as FEET, the conversion factor to meters is 0.3048 (corresponding to International Feet); if you specify US_FEET, the conversion factor is 1200/3937 (corresponding to U.S. Survey Feet).

If you do not specify a value for this parameter, the value of the ELEVATION_UNITS metadata tag of the DEM channel specified by DBEC is used. If the tag does not exist in the DEM, the default value is used.

Map projection

Specifies the projection string for the output DEM. If not specified, the map units are determined automatically.

The standard definitions are as follows:

UTM: Universal Transverse Mercator
SPCS: State Plane Coordinate System
LONG/LAT: longitude and latitude
METER: image along-row and along-column meters
FEET: image along-row and along-column feet

If METER or FEET is specified, the math model and DEM must be METER or FEET.

If a regular, Earth-referenced projection is specified, the math model and DEM must also use a regular projection (not necessarily the same one); METER and FEET are not allowed.

The label of a user-defined projection may also be specified, if the projection exists in the userproj.txt file. Otherwise the projection parameter information must be provided as a string separated by the vetical bar ('|'). The projection parameter string defines 18 parameters delimited by spaces, including Dearth, RefLong, RefLat, StdParallel1, StdParallel2, FalseEasting, FalseNorthing, Scale, Height, Long1, Lat1, Long2, Lat2, Azimuth, LandsatNum, LandsatPath and UnitsCode. For instance, the projection named 'France93' may be specified as:

LCC D350 | 0 0 3.0 46.5 44.0 49.0 700000 6600000 0 0 0 0 0 0 0 0 0 -1

This parameter can specify the UTM grid zone number and row, and Earth model, as follows:

UTM [mm] [r] [Ennn]

where:

[mm] is the two-digit zone number between 1 and 60.
[r] is the zone row: a single letter between N and X for north of the equator and between C and M for south of the equator. Zone rows A, B, Y, and Z are not supported; rows I and O do not exist.
[Ennn] specifies the Earth model, where the model number is between 0 and 19. If the Earth model is not specified, it is assumed to be E000 (Clarke 1866).

The Earth model can be specified for LONG/LAT (and other units except METER or FEET), as follows:

LONG/LAT [Ennn]

This parameter can specify the SPCS zone number and Earth model as follows:

SPCS [mmmm] [Ennn]

where [mmmm] is is the four-digit zone number.

If the Earth model is not specified, it is assumed to be E000 (Clarke 1866).

If MAPUNITS is not specified, the logic for determining a default ortho coordinate system is as follows:

If the source raster has a coordinate reference system (CRS) that is projectable (not PIXEL, METER or FEET), it will be used for the output ortho.
Otherwise, the CRS from the MMSEG math model is analyzed. If the MMSEG math model is METER or FEET, a 2-D coordinate system of type METER or FEET will be chosen to match.
If the MMSEG math model is based on a projected coordinate system, the same projected coordinate system is chosen.
If the MMSEG math model is based on a geographic longitude/latitude coordinate system, a default projection based on the WGS84 datum will be selected, depending on the image position. If the image falls between 84 degrees North and 80 degrees South, a UTM projection with the appropriate zone number will be used. If the image falls in the polar regions, a Universal Polar Stereographic projection will be used.

Upper left coordinate

Optionally specifies the upper-left ground X and Y coordinates, in map units, for the output geocoded DEMs.

If this parameter is not specified, GEOCODEDEM calculates and uses the upper-left corner coordinate from the input DEM file.

Lower right coordinate

Optionally specifies the lower-right ground X and Y coordinate, in map units, for the output geocoded DEMs.

If this parameter is not specified, GEOCODEDEM calculates and uses the lower-right corner coordinate from the input DEM file.

Output pixel ground size (X,Y)

Optionally specifies the resolution of the generated pixels. If this parameter is not specified, the resolution is automatically determined from the input epipolar DEM files.

The units of this parameter must be the same as the units of the math models used to generate the epipolar DEM. For images using the RPC math model, this is generally LONG/LAT; for most other math models, it is a projected coordinate system in meters or feet.

If multiple epipolar DEMs are provided, the first DEM processed is used to determine the units and resolution.

Merge geocoded DEM option

Optionally specifies the DEM merging option to use when multiple epipolar DEMs are geocoded and added to the output DEM file.

When a new geocoded DEM is added to the file and it overlaps an existing geocoded DEM, you must specify the method by which to determine the pixel value to use.

Valid methods are:

LAST (Use last value): uses the last value to replace the pixel values in the overlapped area in the existing geocoded DEM by the pixel values of the geocoded DEM that is added to the file.
AVERAGE: replaces the pixel values in the overlapped area by the average pixel values between the existing geocoded DEM and the one that is added to the file.
SCORE (Highest score): uses the highest score to replace the pixel values in the overlapped area by the pixel value with the highest correlation score between the existing geocoded DEM and the one that is added to the file.

This option is used only if you create the score channel (SCORCHAN) during the epipolar DEM creation.
BLEND (Blending): uses the mosaicking method to mosaic the DEMs together with blending between DEMs. This is the default value.

Note: This option is used only if you create the score channel (SCORCHAN) during the epipolar DEM creation.

Environments	PYTHON :: EASI :: MODELER
Batch Mode	Yes
Quick links	Description :: Parameters :: Parameter descriptions :: Details :: References :: Related

GEOCODEDEM

Geocode DEM from epipolar DEM

Description

Parameters

Parameter descriptions

Details

References