Remove Redundant Feature Spatials

The RemoveRedundantFeatureSpatials process removes redundant spatials from features in the input and saves the results to the output.

Redundant spatials are edges, points or soundings that are unnecessarily duplicated. Removing redundant spatials causes features to share spatials. Spatials will be removed if they have the same geometry and spatial attributes.

This process uses the same rules to identify redundant spatials as the Validation tool that removes redundant edges, points and soundings. The Validation tool has Repair links to interactively choose the spatials to keep when spatials have the same geometry but do not have matching attributes. The Validation tool may be used after running this process, if required.

When features are updated in an HPD dataset, the existing certification status is kept.

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

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.

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 CQL FILTER file that contains rules for selecting the features to be processed. A filter file is only supported when the input matches the output. 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 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. An extent is only supported when the input matches the output.	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 CQL FILTER file that contains rules for selecting the features to be processed.

A filter file is only supported when the input matches the output.

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

An extent is only supported when the input matches the output.

FALSE

Optional

H2O
Objective	Remove redundant spatials from features using an H2O input file, apply the filter file, and save results to the output file.
Description		Command Line Syntax
Filter file for selecting redundant spatials.		`--filter-file bathymetry.filter`
Path of the input file in a supported format.		`gb4x0000_in.h2o`
Path of the output file in a supported format.		`gb4x0000_out.h2o`
Command Line	`carisbatch --run RemoveRedundantFeatureSpatials --filter-file bathymetry.filter gb4x0000_in.h2o gb4x0000_out.h2o`
Outcome	A new file is created in the specified location without redundant edges, points or soundings from the filtered data from the input file.

HPD URI
Objective	Remove redundant spatials from features within a specific edit boundary in an HPD product.
Description		Command Line Syntax
Extents of the edit boundary window.		`--extent -130.0 20.5 -129.0 20.75`
HPD Product URI.		`h`pd://username:password@`database`?ProductVersionId=10003;Projec`tId=12`
Command Line	`carisbatch --run RemoveRedundantFeatureSpatials --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 by removing redundant edges, points or soundings within the specified edit boundary.