--size

A number and unit specifying the height of sounding digits to be enclosed.

The default value is 1.5mm.

FALSE

--scale

-s

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

The default scale value is 10,000, such that the Size value represents the height of a sounding on a map at 1:10,000 scale.

FALSE

--limiting-features

A path to a set of features that limit how isolations can be expanded, in addition to the update features.

If an isolation would be expanded to touch or intersect any of the limiting features, the isolation is not expanded and is reported for manual inspection.

The current state of the update features (original or expanded) is always used as a source of additional limiting features. If the update features are also included in the limiting features, the duplication is ignored.

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

The default value is Bathy DataBASE.

FALSE

--elevation-lookup

A string specifying the path to a file with mappings between feature attributes and Z values.

If set, this value supersedes the Tools > Options setting for Selection Classification Lookup.

FALSE

--sounding-rounding

-S

A string specifying the name of the sounding rounding rule to be used.

This rule defines how soundings are created, and therefore how much the isolations need to be expanded.

The default value is Default Truncated.

FALSE

--sounding-rounding-file

A string specifying the path to a file with rules for how soundings are displayed.

If set, this value supersedes the Tools > Options setting for the Sounding Rounding file.

FALSE

--critical-points

A coverage with critical points to be considered when expanding isolations.

For each isolation, expansion happens around any critical points, and if no critical points are present, around a representative point.

FALSE

--critical-points-band

The name of the input band with depth values for critical points.

If no band is specified, the primary band of the coverage is used.

FALSE

Objective

Expand any contours that are too small to encompass a sounding at a map scale of 1:10,000.

Description

Command Line Syntax

Expanding will be limited by the features found in the LimitingContours.hob file located in the D:\SampleData\Features directory.

--limiting-features D:\SampleData\Features\LimitingContours.hob

The 10m_thinned_points.csar coverage, located in the D:\SampleData\Coverages\ directory, contains critical points that need to be considered when expanding isolations.

--critical-points D:\SampleData\Coverages\10m_thinned_points.csar

The S-57 ENC 3.1 catalogue will be used.

--feature-catalogue “S-57 ENC 3.1”

The contour features to be expanded are in the Contours.hob file located in the D:\SampleData\Features directory.

D:\SampleData\Features\Contours.hob

Command Line

carisbatch --run ExpandIsolationsForCartography --limiting-features D:\SampleData\Features\LimitingContours.hob --critical-points D:\SampleData\Coverages\10m_thinned_points.csar --feature-catalogue "S-57 ENC 3.1" D:\SampleData\Features\Contours.hob

Outcome

Any tiny contours are expanded to the necessary size and the changes saved to the input file.

Notes

N/A