VDEMINGEST

Description

VDEMINGEST ingests multiple vector files containing points, break lines, contours, valleys, ridges, and cliffs, and merges them into vector segments in a PCIDSK (.pix) format file. The vector segments are formatted specifically for VDEMINT, which uses them to create a raster digital elevation model (DEM).

Parameters

Name	Type	Length	Value range
InputPnt: Points	Vector port	0 - 1024
InputCnt: Contours	Vector port	0 - 1024
InputBln: Break lines	Vector port	0 - 1024
Input3Ds: 3-D structures	Vector port	0 - 1024
InputRdg: Ridges	Vector port	0 - 1024
InputVal: Valleys	Vector port	0 - 1024
InputClf: Cliffs	Vector port	0 - 1024
Output: Merged vector layers *	Vector port	1 - 1024
Elevation Options	String	0 -
Elevation range	Float	0 - 2
Map units	String	0 -
Output elevation units	String	0 - 1	METER | FEET | US_FEET
Elevation conversion (offset, scale)	Float	0 - 2
Report	String	0 - 192	See parameter description

* Required parameter

Parameter descriptions

InputPnt: Points

The name or names of the input vector segment or segments that contain elevation points.

Elevation points are individual x and y points with an associated elevation. The points from all input files are collected and written to a POINTS vector segment.

InputCnt: Contours

The vector segment or segments that contain contours.

Contours are three-dimensional lines that have a single elevation for the entire line. Break lines, in contrast, have a different elevation at each vertex. The contours from all input files are collected and written to a CONTOURS vector segment.

InputBln: Break lines

The vector segment or segments that contain break lines.

Break lines are three-dimensional lines in which each vertex can have a different elevation. The break lines from all input files are collected and written to a BREAKLIN vector segment.

Input3Ds: 3-D structures

The vector segment or segments that contain break lines.

These are typically man-made structures, such as bridges or buildings, represented by three-dimensional polygons. The polygons from all input files are collected and written to a STRUCT3D vector segment. Break lines representing features, such as roof ridges, can also be included.

InputRdg: Ridges

The vector segment or segments that contains ridges.

Ridges are two-dimensional lines that have no associated elevation, but represent lines where elevation falls off on either side. The ridges from all input files are collected and written to a RIDGES vector segment.

InputVal: Valleys

The vector segment or segments that contain valleys.

Valleys are two-dimensional lines that have no associated elevation, but represent lines where elevation rises on either side. The valleys from all input files are collected and written to a VALLEYS vector segment.

InputClf: Cliffs

The vector segment or segments that contain cliffs.

Cliffs are two-dimensional lines that have no associated elevation, but represent discontinuities where elevations on either side are interpolated independently of surrounding information. The cliffs from all input files are collected and written to a CLIFFS vector segment.

Output: Merged vector layers

The merged vector segments. This output is used most commonly with VDEMINT or RVDEMINT.

Elevation Options

The names of attribute fields that contain elevation data or special-processing flags.

If point or contour data has the elevation value specified as a numeric attribute, you specify the name of the field here. You can specify multiple names, separated by blank spaces or commas. If you provide multiple names, the first name matching a field will be used.

You can also use the string to specify which return to use in a LIDAR-point (.las / .laz) file. The value RETURN1 specifies the first return, RETURNALL specifies all returns, and RETURNLAST specifies the last return. Do not use RETURN1, RETURNALL, and RETURNLAST at the same time. By default, RETURN1 is selected.

If you specify the option NONAME, each vector segment will be named NONAME rather than POINTS, CONTOURS, and so on. This is sometimes useful in complex situations (for more information on complex situations, see NONAME.

With POINT data, each point is considered as a separate shape. By specifying PACKPOINTS, 10,000 points are packed into each shape. This reduces the size on disk by half and allows VDEMINGEST to run faster. However, the points are in a nonstandard representation; therefore, if you intend to use the points to run an algorithm other than VDEMINT, do not specify PACKPOINTS.

Typically, with STRUCT3D, data lines, points and polygons are ingested. However, if you want only true polygons, you can use the POLYGONONLY option to discard lines and points. A true polygon is a single line in which the start and end point are the same. Therefore, ensure that you have true polygons, and not a number of separate line structures that appear to be a true polygons; these will be eliminated.

This parameter is optional.

Elevation range

The range of elevation values accepted for points, contours, and break lines.

When you specify a single value, it is considered to be a maximum.

Points, contours, or break lines containing values outside the range are not ingested. If any vertex of a break line is outside the range, the entire break line is ignored.

This parameter is optional.

Map units

The output projection of the ingested vectors. All input will be reprojected automatically to that of the output.

If no value is specified for this parameter, the output projection will use the projection of the first input vector segment found, by default.

This parameter is optional.

Output elevation units

The units of the elevation values.

FEET are defined as 0.3048 meters (corresponding to International Feet); US_FEET are defined as 1,200/3,937 meters (corresponding to U.S. Survey Feet).

Elevation conversion (offset, scale)

Converts the elevation values provided with the vector information to the units specified for Output elevation units (ELEVUNIT), such as feet to meters.

If no value is specified for this parameter (typical usage), the elevation values supplied with the vector data are assumed to already be in compatible units and no conversion is applied.

You specify two numbers as the value of this parameter: the first defines the offset, and the second defines the scale.

The conversion formula is as follows:

                    scale × (vector_elevation_value + offset) = elevation_value
                    

Report

Specifies where to direct the generated report.

Available options are:

• LOG: generates a report on the terminal (default)
• <modulename.RPT>: appends a report to the module's RPT file
• DISK: generates a report on file "IMPRPT.LST"

Details

At times, projects do not have raster digital elevation models (DEM); instead, they have hundreds—perhaps thousands—of small files that contain points and vector representations of contours, break lines, and features, such as ridges, valleys, and cliffs.

By using VDEMINGEST, you can merge all of the information in these point and vector files into a single PCIDSK (.pix) file, which you can then use as input to VDEMSETUP and VDEMINT to create a high-quality raster DEM.

Specifying input files and folders

You specify the locations of the input files with the Points, Contours, Breaklines, 3-D structures, Ridges, Valleys, and Cliffs parameters.

It is recommended that you specify the full path to the folder, (for example, "d:\\lines"); otherwise, VDEMINGEST uses the current working folder, which may not be readily apparent.

You can specify up to 32 exclusions by using -xxx separated by commas; for example: "-abc, -ignore, -x". You cannot use the asterisk (*) wildcard in an exclusion. When any portion of the name of a file or folder matches the exclusion definition, it is excluded.

Input vector and point files

Point and vector data representing elevation varies greatly in file formats, how it is organized on disk, and internal representations. While VDEMINGEST can interpret many varieties of data, organizational structure, and so on, in some cases you may need to reorganize files into folders, reformat data using third-party utilities, or both before using VDEMINGEST.

Supported formats of the input files are as described in the following table.

Output results

The vertices in each vector segment created are three-dimensional and have do not have attribute fields. Any attribute fields in the original input file are not copied. The VALLEYS, RIDGES, and CLIFFS segments are also three-dimensional by default, and may contain elevations, but VDEMINT ignores any elevation information in such segments.

Vector segments greater than 1 GB in size are divided into multiple segments, each with the same name, to limit memory consumption.

VDEMINT uses the POINTS, CONTOURS, BREAKLIN, STRUCT3D, VALLEYS, RIDGES, and CLIFFS segments to interpolate a raster digital elevation model (DEM). VDEMINT can use the OUTLINE segment to constrain the interpolated DEM to prevent it from bleeding into the background.

The EXTENTS segment contains a polygon outline and information, such as the file name, for each file ingested. Although VDEMINT does not use this segment, it can be useful for QA. For example, if you open the raster DEM generated by VDEMINT in CATALYST Professional Focus, you can open this segment as a vector overlay. If the DEM contains anomalies, you can identify and open the input vector file associated with the data in that area in the Attribute Manager window.

The SUMMARY segment contains a copy of the text report. This is useful if the original report was not generated or was lost. The report can be written to a separate text file by using TEXWRIT, or viewed in Focus.

The output file has extents bounding all of the input data. The file and each vector segment will have the same projection. Although no raster data channel is created with the file, the image x and y dimensions of the file are set automatically; therefore, if a raster data channel is added to the file (using CRCHN32R, for example), it will have square pixels and approximately 4 million data points. You can then use VDEMINT with the data file as both input and output to provide a 'preview' of the DEM that you can keep with the vector data.