GCPELEV

Description

Reads elevations from a digital elevation channel and updates the elevation field for the GCPs in an existing ground control point segment.

Parameters

Name	Type	Length	Value range
InputGCP: Input Ground Control Points segment  *	GCP port	1 - 1
InputDEM: Input digital elevation model channel *	Raster port	1 - 1
OutputGCP: Output GCP channel	GCP port	0 - 1
BackElev	Float	0 - 1
Scale	Real	0 - 2	Default: 1,0
Offset	Real	0 - 2

* Required parameter

Parameter descriptions

InputGCP: Input Ground Control Points segment

Specifies the input ground control points segment to update.

InputDEM: Input digital elevation model channel

Specifies the input image channel that contains the digital elevation model (DEM) data to use.

OutputGCP: Output GCP channel

Specifies the output image channel that will receive the updated data.

BackElev

Optionally specifies the background elevation (NoData) value in the input elevation channel. If specified, GCPs in the elevation channel with this value are ignored.

Typically, background elevation is used when the data in the elevation channel is incomplete (for example, elevation only in an area of interest or the edges of the DEM are clipped). In such cases, the pixels with no known elevation are filled with an arbitrary value (such as -9999). Set the background elevation parameter to this value to ensure that the GCP elevation is skipped rather than having GCPELEV attempt to use it as a valid value.

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.

Scale

Optionally specifies the scale to apply to the elevation values in the elevation channel ("InputDEM") to convert values to meters.

Offset

Optionally specifies the offset to apply to the elevation values in the elevation channel ("InputDEM") to convert values to meters.

Details

GCPELEV converts a GCP segment which has no elevation values into a GCP segment with elevation values, by reading the elevation values from a user-defined digital elevation channel. This is useful for cases where the user has collected the X and Y ground control points for an area without collecting the elevation values using programs like GEOIMG or GCP tie down to vectors in OrthoEngine. Elevation values are bilinearly interpolated from the digital elevation model (DEM) channel.

The user can specify a background elevation value to identify areas which should be ignored. A scale and offset can be specified, allowing the user to convert the elevation unit to meters.