Conflate Feature Geometry

The ConflateFeatureGeometry process conflates the edges and points of input features and saves them to the output.

This process repairs area and line features with overlapping edges (including redundant edges) as well as point and sounding features using redundant point spatials. Overlapping edges are replaced with single edges where they overlap. Redundant point spatials are replaced by single point spatials. In addition, edges are merged to remove pseudo nodes.

Note that if overlapping edges or redundant point spatials have different attributes they will not be conflated. The "Redundant Edges, Points and Soundings" Validation test in the desktop application may be used to identify and repair these spatials after conflating geometry.

This process can also remove small gaps and overlaps between area and line features by specifying a tolerance. The geometry of areas will be affected, but not the geometry of lines. Duplicate edges used by area and line features will be removed when a tolerance is specified.

Conflated edges will keep the spatial attributes of the line feature's edges.

Features in a supported format. HOB, and 000 (S-57 specification) are supported.

carisbatch --run ConflateFeatureGeometry --feature-catalogue <value> [options] <input> <output>

Long	Short	Description	Can Repeat
--extent	E	The extents that defines the window. <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. This option represents an edit boundary. It is used to restrict the edges that may be merged to a specified area. When this option is not used, all edges in the dataset are merged.	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.	FALSE
--tolerance	T	A number and unit specifying the maximum distance between edges for gap and overlap removal. The unit is an abbreviation for a distance unit (cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd, or yd). When this option is not used, the tolerance is set to 0 by default.	FALSE

Long

Short

Description

Can Repeat

Notes

--extent

The extents that defines the window.

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

This option represents an edit boundary. It is used to restrict the edges that may be merged to a specified area.

When this option is not used, all edges in the dataset are merged.

FALSE

--feature-catalogue

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.

FALSE

--tolerance

A number and unit specifying the maximum distance between edges for gap and overlap removal.

The unit is an abbreviation for a distance unit (cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd, or yd).

When this option is not used, the tolerance is set to 0 by default.

FALSE

Objective	You want to repair area and line features with overlapping edges in a HOB file.
Description		Command Line Syntax
The input features are in the FeatureData.hob file in the D:\SampleData folder.		D:\SampleData\FeatureData.hob
The S-57 ENC 3.1 catalogue will be used.		--feature-catalogue "S-57 ENC 3.1"
The maximum distance between edges is 0.5m.		--tolerance 0.05m
The repaired features will be saved back to the input file.		D:\SampleData\FeatureData.hob
Command Line	carisbatch -r ConflateFeatureGeometry --tolerance 0.05m --feature-catalogue "S-57 ENC 3.1" D:\SampleData\FeatureData.hob D:\SampleData\FeatureData.hob