| Environments | PYTHON :: EASI :: MODELER |
| Batch Mode | Yes |
| Quick links | Description :: Parameters :: Parameter descriptions :: Details :: Related |
| Back to top |
| Back to top |
| Name | Type | Length | Value range |
|---|---|---|---|
| Input: Input vector segment * | Vector port | 1 - 1 | |
| InputArea: Input bounding area | GEO port | 0 - 1 | |
| Output: Encoded raster channel | Raster port | 0 - 1 | |
| Field Name | String | 0 - 1 | SHAPEID | ZCOORD | Field Name |
| Value to burn | Float | 0 - 1 | Default: |
| Connectedness of Lines | Integer | 0 - 1 | 4 | 8 Default: 8 |
| Pixel X Size | Real | 0 - 2 | |
| Pixel Y Size | Real | 0 - 2 |
| Back to top |
Input: Input vector segment
Specifies the vector segment from the input file to be encoded. The input vector segment contains lines (such as elevation contours), where each line has an attribute value. All specified vector segments must use the same coordinate system (PIXEL, UTM, etc.).
InputArea: Input bounding area
Optionally specifies the georeferencing segment used to set the projection, geographic extents, and the size (pixels/lines) of the output raster channel.
If this parameter is not specified, the projection of the raster channel will be the same as that of the input vector segment. The geographic extents of the raster channel are determined according to the extents of the vector segment and the pixel size parameters (Pixel X Size and Pixel Y Size).
Output: Encoded raster channel
Specifies the output raster channel to receive the encoded vector data.
If the specified output file FILE exists, this parameter must be specified and the channel must exist. If the output file does not exist, this parameter should be left unspecified.
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.
Value to burn
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.
Connectedness of Lines
Specifies the connectedness for line segments encoded into the output image channel. Points are always encoded as a single dot.
Pixel X Size
Specifies the horizontal (X) pixel resolution, in meters, for the output raster layer.
If the georeferencing is specified by the InputArea parameter, this parameter is ignored.
Pixel Y Size
Specifies the vertical (Y) pixel resolution, in meters, for the output raster layer.
If the georeferencing is specified by the InputArea parameter, this parameter is ignored.
| Back to top |
LINE2RAS encodes the vector segment data from the input file to an output image channel. Attribute values for each vector segment are either specified by the user (parameter BURNVAL), or by actual attribute values stored for each line and point structure in the vector segment (a field or the Z coordinate using parameter FLDNME).
LINE2RAS is used in gridding vector data. Gridding is the process of creating a raster image grid, given vector (line and point) data. For example, LINE2RAS can encode elevation contour lines into an image channel after which an interpolation function such as PYRINT can be used.
If the units for storing vector data are not PIXEL, but are UTM or any other type, the database must be georeferenced (using GEOSET) prior to running LINE2RAS. The units for georeferencing must be the same as those used to collect the vector data. The current georeferencing information for the database may be obtained by running GEOREP.
If the output file FILO already exists the CLR function can be used to clear all pixels in the output channel to a background value (usually zero) before encoding vector data with LINE2RAS. If the output file is created then a background value and data type for the channel are automatically determined. Typically the background value is 0 unless this conflicts with the burned in vector data values.
Only one vector layer (or segment) may be encoded at a time. LINE2RAS can be run multiple times, using the same output channel, if more than one vector layer needs to be encoded. Vector data must all be in the same projection as the output file. Function VECPRO can be used to reproject vector layers.
Each vector may contain more than one attribute field. The FLDNME (Field Name) parameter specifies the attribute field to use or whether the actual Z values associated with each vertex or point should be used.
Function GRDVEC performs a similar function to LINE2RAS but can only write into an existing file while LINE2RAS can automatically create an output file or write to an existing file.
© PCI Geomatics Enterprises, Inc.®, 2026. All rights reserved.