Description
The CreateFeaturesFromFeatures process creates a new feature of the specified type from each input feature.
Input
Features in a supported format. HPD Database URI, HOB, and 000 (S-57 specification) are supported.
Output
Features in HOB format.
Syntax
carisbatch --run CreateFeaturesFromFeatures --feature-catalogue <value> --feature-code <value> [options] <input> <output>
User Interface Command
N/A
Options
The following table describes the parameters available for this process.
Long | Short | Description | Can Repeat | Notes |
|---|---|---|---|---|
--feature-code | A string specifying the feature code of the objects to be created. For S-57 data, this is the feature acronym. The feature definition must exist in the catalogue. All attribute values from the input features that match the new feature definition are be added. Any other attributes on the input features are ignored. All other attributes for the new features are left unset. Any features from the input that have a geometry type that is not supported based on this feature definition are ignored. | FALSE | This must be specified explicitly. | |
--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". A catalogue must be specified only when the input is a HOB file. | FALSE | This must be specified explicitly. |
Example
Below is an example of the process.
Objective | You want to create depth area features using a file of existing area feature objects. | |
Description | Command Line Syntax | |
The new features will be created as depth areas. | --feature-code DEPARE | |
The S-57 ENC 3.1 feature catalogue will be used. | --feature-catalogue "S-57 ENC 3.1" | |
The source features are in the Input.hob files in the D:\SampleData\Features directory. |
| |
The new features will be saved as DepareFeatures.hob in the input directory. |
| |
Command Line | carisbatch --run CreateFeaturesFromFeatures --feature-code DEPARE --feature-catalogue "S-57 ENC 3.1" | |