SETELEV

Description

SETELEV sets the elevation value using bilinear interpolation for georeferenced coordinates. The new elevation value will overwrite the previous elevation value for every vertex from the specified vector layer.

Parameters

Name	Type	Caption	Length	Value range
FILI*	String	Input file name	1 - 192
FILO*	String	Output file name	1 - 192
DBIC*	Integer	Input elevation channel	1 - 1
DBOV*	Integer	Output vector segment	1 - 1
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILI

Specifies the name of the PCIDSK file that contains the DEM image data.

FILO

Specifies the name of the PCIDSK file to receive the vector segment.

DBIC

Specifies the image channel that contains the DEM information.

DBOV

Specifies the vector segment that contains the input vertices.

For every input vertex, SETELEV calculates the elevation value using bilinear interpolation for georeferenced coordinates, and overwrites the previous elevation value.

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

SETELEV sets the z-coordinates of vectors in an output vector layer from the values in the DEM channel of an image file.

Bilinear interpolation determines the gray level from the weighted average of the four closest pixels to the specified vertex x- and y- coordinates, and assigns that value to the z-coordinate of the vertex.

The input and output file names can be equal. The vector layer specified by DBOV contains input vertices. The new elevation value will overwrite the previous elevation value for every vertex from this layer.

To verify the results of SETELEV, you can run VECREP.

Example

Calculate the elevation coordinates of vector layer 1, from the elevation values of channel 2. The file "irvine.pix" is used in both cases.

EASI>FILI="irvine.pix"
EASI>FILO="irvine.pix"
EASI>DBIC=10
EASI>DBOV=25
EASI>RUN SETELEV