VECZREF

Description

Calculates and applies geoid undulation to convert the vector z-values between ellipsoid heights and mean sea level elevation using a global model.

Parameters

veczref(filv, dbiv, filo, dbov, elevref, elevunit)

Name	Type	Caption	Length	Value range
FILV *	str	Input vector file name	1 -
DBIV *	List[int]	Input vector segment	1 - 1
FILO	str	Output file name	-
DBOV	List[int]	Output vector segment	0 - 1
ELEVREF	str	Original elevation reference	0 - 6	MSL | ELLIPS
ELEVUNIT	str	Elevation unit	0 - 5	METER | FEET

* Required parameter

Parameter descriptions

FILV

Specifies the name of the vector file that contains the data to process.

DBIV

Specifies the input vector segment to process.

FILO

Specifies the name of the PCIDSK file to receive the converted segments.

DBOV

Specifies the output vector segment to receive the converted data.

If the input and ouptut files (FILV and FILO) are the same, and the output vector segment (DBOV) is identical to the input vector segment (DBIV), the specified segment is overwritten with the new output. If DBOV exists, it is overwritten with the converted segment. If DBOV is not specified or is specified but does not already exist, a new output segment is created.

ELEVREF

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

ELEVUNIT

Specifies the units of the elevation values.

If the ELEVATION_UNITS metadata tag for the input file exists, this is used by default; otherwise, the default unit is METER.

Details

Calculates and applies geoid undulation to convert the vector z-values between ellipsoid heights and mean sea level elevation using a global model.

Example

Convert z-values for vector segment 25 from mean sea level to ellipsoid using meters as the elevation units.

from pci.veczref import veczref

filv	=	"irvine.pix"
dbiv	=	[25]
filo	=	"irvine.pix"
dbov	=	[30]
elevref	=	""
elevunit	=	""

veczref( filv, dbiv, filo, dbov, elevref, elevunit )