Description
The VectorizeRaster process produces polygons from raster pixels.
Inputs
A raster in a supported format. A BDB Server URI can be specified as input.
Outputs
Area features in HOB format.
Command Line Syntax
carisbatch --run VectorizeRaster --input-band <value> --polygon-feature <value> [options] <input> <output>
Options
The following table describes the parameter available for this process.
Parameter |
| |||
Long | Short | Description | Can Repeat | Notes
|
--input-band | i | A string specifying the name of the input band. | 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". The units and z-axis direction of the output are controlled by the pool of the feature catalogue of the output. If the input cannot be converted to those units and z-axis convention, then the values are simply copied from the input data. | FALSE | This must be specified explicitly. |
--polygon-feature | P | A string specifying the feature acronym of the area object to be used for the polygons. | FALSE | This must be specified explicitly. |
--mode | m | A string specifying the mode. One of: • COVERAGE: Coverage - A polygon is generated around each set of joined pixels. • VALUE: Value - A polygon is generated around pixels with the same value. Only valid for integer scaler type or string table type bands. The default value is COVERAGE. | FALSE | |
--value-attribute | a | A string specifying the attribute acronym for the value of the polygons. This is only used when the Mode is set to VALUE. | FALSE | |
Example
To use this command refer to the following example.
Example | ||
Objective | You want to vectorize seabed areas to represent the data sources in a contributor band. | |
Description | Command Line Syntax | |
The band to be vectorized is Contributor. | --input-band Contributor | |
The feature catalogue name is S-57 ENC 3.1. | --feature-catalogue "S-57 ENC 3.1" | |
The resulting polygons will be assigned the SBDARE (Seabed Area) object acronym. | --polygon-feature SBDARE | |
The polygons will be created based on the values in the band. | --mode VALUE | |
The attribute acronym to use for the value of the polygons will be TXTDSC (Textual Description). | --value-attribute TXTDSC | |
The source surface, CombinedSurface.csar, is located at D:\BatchSample. | D:\BatchSample\CombinedSurface.csar | |
The resulting features will be saved to the VectorizeRaster.hob file, which will be created in the same location as the source surface. | D:\BatchSample\VectorizeRaster.hob | |
Command Line |
| |
Outcome | A HOB file is created containing newly-created SBDARE objects representing the data sources that contributed to the surface. The TXTDSC attribute of each object will be populated with the name and location of the data source that contributed to the area of the surface that is represented by each respective feature object. | |
Extra Notes | N/A | |