--maximum-segment

A number and unit specifying a maximum length for a segment of an edge for output features.

Segments in the input shorter than this maximum are copied to the output without change. Segments longer than this in the input features are subdivided into multiple segments.

Supported units: cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd, yd

FALSE

This must be specified explicitly.

--scale

s

A number specifying the scaling applied to distance values (1:scale).

This is applied to the Maximum Segment values. The default scale of 1 requires those values to be entered as distances on the ground. A scale of 1000 means these values are distances on a 1:1000 scale map.

If specified, this must be a value greater than 0.

FALSE

--working-crs

A string specifying the key to a horizontal coordinate reference system in which geometric calculations will be done.

If a projected CRS is specified, interpolation is linear in that CRS. If no system is specified, and the CRS of the input is geodetic, then Vincenty methods are used to interpolate along arcs between input latitudes and longitudes.

For time-dependent coordinate reference systems, the epoch can be specified, typically using the year as <crs_id>@1997. A fractional year can also be specified, such as <crs_id>@1997.3, if needed. If no epoch is specified, the reference epoch of the coordinate reference system is used.

FALSE

--point-distribution

A string specifying the method used to distribute new points on long edges.

• FORWARD: Add a new point at every multiple of Maximum Segment length, starting from the start point of the original segment. The new segment closest to the end of the original segment is likely to be shorter than the Maximum Segment length.

• BACKWARD: Add a new point at every multiple of Maximum Segment length, starting from the end point of the original segment. The new segment closest to the start of the original segment is likely to be shorter than the Maximum Segment length.

• EQUAL_SPACING: Add new points to create new segments of equal length, where this length is no greater than the Maximum Segment length. The new segments are all likely to be shorter than Maximum Segment length, but all the new segments for a given original segment are all the same length.

The default is EQUAL_SPACING.

FALSE

--feature-catalogue

F

A string specifying the name of the catalogue that defines the features and attributes in a vector dataset. One of { list dynamically populated from the catalogue control file }.

The names of the available catalogues can be accessed through application via the Object Catalogue environment variable in Tools > Options. The available catalogues are controlled by the Catalogue Control file. An example of a catalogue name is "S-57 ENC 3.1".

A catalogue must be specified if the input is a HOB file.

FALSE

Example

Objective

You want to make the edges of line and area features more uniform prior to generating a TIN from the dataset.

Description

Command Line Syntax

Edge segments should be no longer than 25 metres.

--maximum-segment 25m

The new points for the segments will be added starting from the start point of the original segment.

--point-distribution FORWARD

The input features are in the Features.hob file in the D:\SampleData directory.

D:\SampleData\Features.hob

The updated features will be saved to the UpdatedFeatures.hob files in the input directory.

D:\SampleData\UpdatedFeatures.hob

Command Line

carisbatch --run DensifyFeatures --maximum-segment 25m --point-distribution FORWARD D:\SampleData\Features.hob D:\SampleData\UpdatedFeatures.hob

Result

Points are added to the edges of the input features to create more uniform feature edges and saved to the specified output file.