Description
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.
• 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 check 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. Note that:
• 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.
Inputs
Features in a supported format. HOB, H2O, 000 (S-57 or S-101 specification) and HPD URIs are supported.
Outputs
Features in HOB or H2O format.
If the output HOB file already exists, it will be overwritten.
Command Line Syntax
carisbatch --run ConflateFeatureGeometry --feature-catalogue <value> [options] <input> <output>
Options
Parameter |
| |||
|---|---|---|---|---|
Long | Short | Description | Can Repeat | Notes
|
--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 | Required. |
--extent | -E | The extents that define 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 | Optional. |
--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. | FALSE | Optional. |
Example
Example | ||
|---|---|---|
Objective | Conflate the feature geometry in a dataset. | |
Description | Command Line Syntax | |
The process is using the S-57 ENC 3.1 catalogue. | --feature-catalogue "S-57 ENC 3.1" | |
The edges to be conflated are restricted to the specified extent. | --extent | |
The maximum distance between the edges of features that can be conflated is 10 cm. | --tolerance 10cm | |
The input file is named Geometry.hob and is in the BatchSample folder on the D: drive. | D:\BatchSample\Geometry.hob | |
The output file will be named ConflatedFeatures.hob and will be created in the source directory. | D:\BatchSample\ConflatedFeatures.hob | |
Command Line | carisbatch --run ConflateFeatureGeometry --feature-catalogue "S-57 ENC 3.1" --extent | |
Outcome | The features in the input file are conflated and saved to the new HOB file in the specified location. | |