Description
The AddFeatures process copies features from the input to the output. The coordinate reference systems and the X/Y resolutions of the input and output must match. If using HOB files, the CRS must be EPSG:4326.
Inputs
Features in a supported format. Shapefiles, GML, HOB, and 000 (S-57 specification) are supported.
Outputs
Features in HOB format. If a HOB file does not exist, a new one is created.
Command Line Syntax
carisbatch --run AddFeatures [options] <inputs> <output>
Options
The following table describes the parameters available for this process.
Parameter |
| |||
Long | Short | Description | Can Repeat | Notes
|
--keep-foid | k | If set, the feature object identifiers (FOIDS) of the input are used for the output features when they are unique in the output. New FOIDs are always assigned when new features are generated from composite features such as sounding groups. When not set, new FOIDs are assigned. | FALSE | This option is ignored if the input is in GML or Shapefile format. |
--require-all | q | If set, the process is cancelled if any of the features cannot be added. | FALSE | |
--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 specifically. |
Example
To use this command refer to the following example.
Example | ||
Objective | You want to add features to an existing map. | |
Description | Command Line Syntax | |
Existing FOIDs in the inputs are applied to the output, when possible. | --keep-foid | |
The process will be cancelled if any of the features cannot be added. | --require-all | |
The S-57 ENC 3.1 feature catalogue will be used to add the features to the output file. | --feature-catalogue "S-57 ENC 3.1" | |
The input file is named Surface10.hob and located at D:\BatchSample. | D:\BatchSample\Surface10.hob | |
The output file is named AddFeatures.hob and located at D:\BatchSample. | D:\BatchSample\AddFeatures.hob | |
Command Line |
| |
Outcome | The features in the source file are added to the existing content of the output file. | |
Extra Notes | N/A | |