Remove Redundant Feature Vertices

The RemoveRedundantFeatureVertices process removes redundant vertices in the input and saves the results to the output.

Redundant vertices are vertices that do not contribute to the geometry of a feature.

Features in a supported format. HOB, H20, 000 (S-57 or S-101 specification) and HPD URIs are supported.

Features in HOB or H20 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.

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 that contains rules for identifying objects. The filter file (*.filter) is created by CARIS software in CQL (common query language) format.	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 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

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 that contains rules for identifying objects.

The filter file (*.filter) is created by CARIS software in CQL (common query language) format.

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

HOB
Objective	Remove redundant vertices from a data file and save the results to the output file.
Description		Command Line Syntax
Feature catalogue for the output file.		`--feature-catalogue “S-57 ENC 3.1”`
Path of the input file in a supported format.		`D:\inputs\gb4x0000_in.hob`
Path of the output file in a supported format.		`D:\outputs\gb4x0000_out.hob`
Filter file for selecting redundant vertices.		`--filter-file bathymetry.filter`
Command Line	`carisbatch -run RemoveRedundantFeatureVertices --feature-catalogue "S-57 ENC 3.1" --filter-file bathymetry.filter D:\inputs\gb4x0000_in.hob D:\outputs\gb4x0000_out.hob`
Outcome	A new file is created in the specified location without redundant vertices from the filtered data from the input file.

HPD URI
Objective	Remove redundant vertices from an HPD product and save the results.
Description		Command Line Syntax
Extents of the edit boundary.		`--extent -130.0 20.5 -129.0 20.75`
HPD Product URI.		`hpd://username:password@database?ProductVersionId=10003;ProjectId=12`
Command Line	`carisbatch --run RemoveRedundantFeatureVertices --extent -130.0 20.5 -129.0 20.75 hpd://username:password@database?ProductVersionId=10003;ProjectId=12 hpd://username:password@database?ProductVersionId=10003;ProjectId=12`
Outcome	The HPD product is updated with the removal of the redundant vertices.