--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".

FALSE

This must be specified for HOB input.

--tolerance

-T

A number and unit specifying the distance that individual vertices can be moved when simplifying features.

Trend lines are used between different vertices along each feature. If any vertices in the input are farther than the tolerance from the trend line, more trend lines are applied over smaller portions of the feature. This process is repeated until no input vertices are farther than the tolerance from the set of trend lines. The trend lines are then used as the output feature.

A tolerance of 0 m results in only collinear vertices being removed. Any larger tolerance value may change the geometry of the input features.

FALSE

This must be specified explicitly.

--extent

-E

The extents that define the window. This option represents an edit boundary. This boundary is used to restrict the edges that may be processed to a specified area.

<LowerX> - A number specifying the lower left X origin in the coordinate reference system of the output.

<LowerY> - A number specifying the lower left Y origin in the coordinate reference system of the output.

<UpperX> - A number specifying the upper right X origin in the coordinate reference system of the output.

<UpperY> - A number specifying the upper right Y origin in the coordinate reference system of the output.

The unit is assumed to be that of the output's coordinate reference system, unless otherwise specified. When specifying units for unprojected data, an angle type unit is required. The order for unprojected coordinates is longitude followed by latitude.

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

When this option and the FilterFile option is not used, all edges in the dataset are processed. When this option and a FilterFile are specified, all edges in the dataset belonging to features that pass the filter are processed.

FALSE

Optional

--scale

-s

A number specifying the scaling to apply to the tolerance (1:scale).

The default scale value is 1, such that the tolerance represents a distance on the ground; the tolerance would then be a value like 0.5m.

A scale of 1000 would mean that the tolerance represents a distance on a map at 1:1000 scale; the tolerance would then be a value like 1 mm.

FALSE

Objective

You want to reduce the number of vertices in a line feature.

Description

Command Line Syntax

The S-57 ENC 3.1 catalogue is to be used.

--feature-catalogue "S-57 ENC 3.1"

Vertices can be no more than 5m from a trend line.

--tolerance 5m

The data source is named LineFeatures.hob and is located in the BatchSample directory, on the D drive.

D:\BatchSample\LineFeatures.hob

The simplified line will be saved to SimpliedFeatures.hob in the source data location.

D:\BatchSample\SimplifiedFeatures.hob

Command Line

carisbatch --run SimplifyFeatures --feature-catalogue "S-57 ENC 3.1" --tolerance 5m D:\BatchSample\LineFeatures.hob D:\BatchSample\SimplifiedFeatures.hob

Outcome

A new HOB file is created containing the simplified line feature.