Description
The MergeFeatureEdges process merges edges in the input and saves the results to the output.
This process uses the same rules to merge edges as the Edit> Edges> Merge command when performing a shared edit.
When features are updated in an HPD dataset, the existing certification status is kept.
Input
Features in a supported format. HOB, H2O, 000 (S-57 or S-101 specification) and HPD URIs are supported.
Output
Features in HOB or H2O format. An HPD URI may be specified along with an identical input HPD URI to update an HPD dataset.
Different URIs are not supported. An error will occur if HPD URIs are specified for input and output and the URIs do not match.
Command Line Syntax
carisbatch --run MergeFeatureEdges [options] <input> <output>
User Interface Command
Edit > Edges > Merge
Options
Long | Short | Description | Can Repeat | Notes |
|---|---|---|---|---|
--feature-catalogue | -F | A string specifying the name of the catalogue that defines 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". | FALSE | Required if the input is a HOB file. |
--filter-file | -L | Path to a FILTER file containing rules for identifying objects. The filter file (*.filter) is created by CARIS software in CQL (common query language) format. This process does a shared edit to update all features using each modified edge to prevent duplicate geometry from being created. This means that features specified by a FilterFile are updated as well as any other features that use the edges that were merged. | FALSE | Optional |
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 are 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 |
Examples
HOB | ||
Objective | Merge feature edges from a HOB input file, apply the feature catalogue, and save results to the output file. | |
Description | Command Line Syntax | |
Feature catalogue for the output file. |
| |
Path of the input file in a supported format. |
| |
Path of the output file in a supported format. |
| |
Command Line |
| |
Outcome | A new file is created in the specified location with merged feature edges, according to the specified feature catalogue. | |
HPD URI | ||
Objective | Merge feature edges within a specific edit boundary in an HPD product. | |
Description | Command Line Syntax | |
Extents of the edit boundary window. |
| |
HPD Product URI. |
| |
Command Line |
| |
Outcome | The HPD product is updated by merging feature edges within the specified edit boundary. | |