GRDVEC

Vector encoding


EnvironmentsPYTHON :: EASI :: MODELER
Batch ModeYes
Quick linksDescription :: Parameters :: Parameter descriptions :: Details :: Related

Back to top

Description


GRDVEC encodes (or burns) vector data into an raster image channel, in an existing file, using the attribute or Z value associated with each line and/or point in a vector segment. PYRINT is used afterwards to grid (interpolate) raster values between encoded vectors yielding a complete surface, for example, a complete Digital Elevation Model (DEM). Note: LINE2RAS is a newer replacement version of GRDVEC.
Back to top

Parameters


Name Type Length Value range
Input: Raster: Input raster layer * Raster port 1 - 1024  
Input: Vector Layer(s): Input vector segments or layers * Vector port 1 - 16  
Gray Level Value List Float 0 - 16  
Output: Encoded Raster Layer: Encoded output channel or layer Raster port 0 - 1  
Pixel X Size Real 0 - 1024 0.0 -
Default: 30.0
Pixel Y Size Real 0 - 1024 0.0 -
Default: 30.0
Connectedness of Lines Integer 0 - 1 4 | 8
Default: 4
Vector Type String 0 - 1 LINE | POINT | BOTH
Default: BOTH
Field Name String 0 - 1 SHAPEID | ZCOORD | Field Name
Default: SHAPEID

* Required parameter
Back to top

Parameter descriptions

Input: Raster: Input raster layer

Specifies the image channel containing raster or elevation (DEM) data. This channel may be empty.

Input: Vector Layer(s): Input vector segments or layers

Specifies up to 16 vector, non duplicate, segments to be encoded. Each segment contains lines and points (for example, elevation contours and markers), where each line or point has an attribute or Z value. All specified vector segments must use the same coordinate system (for example, PIXEL, UTM, etc.).

Gray Level Value List

Optionally specifies a value to use during encoding for ALL lines and points in the input vector segment. Use of this parameter will mean that the FLDNME parameter is ignored.

The range for this value depends on the data type of the output channel.

Output: Encoded Raster Layer: Encoded output channel or layer

Specifies one output raster channel to receive the encoded vector line and point data.

Existing data not underneath encoded vector data is NOT changed. The output channel may be of any data type.

If this parameter is not specified, a new 32 bit real output channel is created in FILE and initialized to 0.

Pixel X Size

Specifies the X (horizontal) pixel size, in meters, of the output image.

Pixel Y Size

Specifies the Y (vertical) pixel size, in meters, of the output image.

Connectedness of Lines

Specifies the connectedness for line segments encoded into the output image channel. Points are always encoded as a single dot.

Supported values are:

Vector Type

Specifies the type of vector data to be encoded. Supported values are:

Field Name

Specifies the field containing the elevation (or Z) values. The field name must exist in the attribute table of the vector layer. The acceptable range of elevation values depends on the data type of the output channel.

Values include:
Note: Field names are not case-sensitive. If values are specified in parameter VALU then FLDNME is ignored.
Back to top

Details

GRDVEC is used to grid vector data. Gridding is the process of creating a raster image grid, given vector (line and point) data. For example, GRDVEC can encode elevation contour lines into an image channel and then an interpolation program such as GRDVEC or PYRINT completes the griding process by interpolating between lines and points. An alternative interpolation method is to used programs VDEMINGEST and vDEMINT.

GRDVEC encodes the input vector segment data to an output image channel, where attribute values for each vector segment are: specified by the user (in VALU); by actual attribute values stored for each line and point structure in each vector segment (FLDNME specifies the specific field name); the Z value for each vertex (FLDNME="ZCOORD"); or the shape id (FLDNME="SHAPID"). If the Z value for each vertex is requested then the Z values along a line segment are interpolated between vertices. The user must specify either 4-connectedness or 8-connectedness for line segments encoded on the image. The user has the option of encoding only line structures, only point structures, or both types of structures.

If the vector coordinates are not stored in PIXEL coordinates, the input file must be georeferenced (using GEOSET) prior to running GRDVEC. The georeferencing units must be the same those used in collecting the vector data.

Use the CLR program to clear all pixels in the output channel to a background value (usually zero) before encoding vector data with GRDVEC. If more than 16 vector segments must be encoded, GRDVEC can be run again, using the same output channel.

© PCI Geomatics Enterprises, Inc.®, 2026. All rights reserved.