Description
The FilterFeatures process copies features that pass the criteria in a rule file from the input to the output.
Inputs
Features in a supported format. HOB and 000 (S-57 specification) are supported.
Outputs
Features in HOB format.
If the output directory already contains a file with the specified file name, the existing file will be overwritten by the new output file. |
Command Line Syntax
carisbatch --run FilterFeatures --feature-catalogue <value> --rule-file <value> [options] <input> <output>
User Interface Command
Options
The following table describes the parameters available for this process.
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 | This must be specified for HOB input. |
--rule-file | U | The path to the CRFX file containing rules for the selection filter. The CRFX file must be one created for selection. Other CRFX files, such as ones to perform deconfliction in CombineToRaster process, cannot be used for this purpose. Rules that are not valid for the input are skipped without error. | FALSE | This must be specified explicitly. |
Example
To use this command refer to the following example.
Example | ||
|---|---|---|
Objective | You want to create a filtered selection of features. | |
Description | Command Line Syntax | |
The input has features and attributes defined in the S-57 ENC 3.1 feature catalogue. | --feature-catalogue "S-57 ENC 3.1" | |
The rule file is named Filter.crfx and located at D:\BatchSample. | --rule-file D:\BatchSample\Filter.crfx | |
The input file is named Surface10.hob and located at D:\BatchSample. | D:\BatchSample\Surface10.hob | |
The output file will be named FilterFeatures.hob and located at D:\BatchSample. | D:\BatchSample\FilterFeatures.hob | |
Command Line |
| |
Outcome | A new HOB file is created from a filtered subset of the input HOB. | |
Extra Notes | N/A | |