Description
The CombineToRaster process creates a new raster by computing the value in each raster cell using a logical operation executed over the points falling within each raster cell. The output raster is generated with user-specified geographic extents and resolution.
Inputs
Two or more raster surfaces, point clouds and/or variable resolution surfaces. The locations can be specified by file paths or URIs.
Outputs
A raster surface in CSAR format. The location can be specified by a file path or a URI.
Command Line Syntax
carisbatch --run CombineToRaster --extent <value> --resolution <value> --output-crs <value> --contributor-attribute <value> [options] <inputs> <output>
Options
The following table describes the parameters available for this process.
Parameter |
| |||
Long | Short | Description | Can Repeat | Notes
|
--recompute-stats | s | If set, values in statistical bands present in the output are recomputed. The bands that are recomputed are Density, Mean, Standard Deviation, Shoal and Deep. | FALSE | |
--rule-file | U | The path to the CRFX file containing rules for conflict resolution. The CRFX file must be one created for deconfliction in the combine dialog box. Other CRFX files, such as ones to perform queries on a database, cannot be used for this purpose. | FALSE | |
--override-ambiguity | a | If set, the first input point that meets all criteria in the rules is selected to populate the output cell, even if there are unresolved conflicts. | FALSE | |
--confine-metadata-rules | f | A string specifying how to consider holes as valid data when applying metadata rules. One of: • POLYGON: Based on bounding polygon • HOLIDAY: Based on holiday band If not specified, holes are not considered as valid data when applying metadata rules. | FALSE | |
--recurse | u | If set, files that match the input description in any subfolders are also included. | FALSE | |
--use-cell-centres | n | If set, the input raster cell centre is used as the position for the input raster cell. If this option is specified, true position information in the input raster surfaces is ignored. | FALSE | |
--contributor-attribute | C | A string specifying an attribute value to be included in the Contributor layer. The Contributor for each node is populated with a list of the local CSAR metadata values from the source that is selected to be copied to the output raster surface. The default value is uri. | TRUE | |
--resolution | R | A number and unit specifying the resolution of the output raster. Supported units: cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd, yd, deg and rad. | FALSE | This must be specified explicitly. |
--extent | E | The extents that define the window. <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. | FALSE | This must be specified explicitly. |
--polygon-type | Y | A string specifying the type of bounding polygon to generate. One of: • CONVEX: The convex hull of the data is used for the polygon. • BUFFERED: A simplified buffered boundary is used for the polygon. The default value is BUFFERED. | FALSE | |
--primary-band | m | A string specifying the name of the primary elevation band of the output. The default value is Depth. | FALSE | |
--output-crs | c | A string specifying the horizontal coordinate reference system key of the output. | FALSE | This must be specified explicitly. |
--comments | General comments to be added to the coverage metadata The default value is an empty string. | FALSE | ||
Example
To use this command refer to the following example.
Example | ||
Objective | You want to combine two raster surfaces into a single raster surface. | |
Description | Command Line Syntax | |
The output coordinate system is UTM-30N. | --output-crs UTM-30N | |
The resolution of the output surface will be 10 metres. | --resolution 10m | |
The primary elevation band will be labelled Depth. | --primary-band Depth | |
Statistical layers will be recomputed. | --recompute-stats | |
The extents to be included are: • lower-left X: 416379.84 • lower-left Y: 5576029.18 • upper-right X: 420200.16 • upper-right Y: 5580327.82 | --extent 416379.84 5576029.18 420200.16 5580327.82 | |
The file, combine_rules.crfx, located at D:\BatchSample, will be used for conflict resolution. | --rule-file D:\BatchSample\combine_rules.crfx | |
The source surfaces to be combined are Surface1.csar and Surface2.csar located at D:\BatchSample. | D:\BatchSample\Surface1.csar D:\BatchSample\Surface2.csar | |
The output surface will be named Combined.csar, and saved to the same location as the source files. | D:\BatchSample\Combined.csar | |
Command Line |
| |
Outcome | A new, combined raster surface is created. | |
Extra Notes | N/A | |