Description
The JoinPoints process creates a new point cloud from the points in the inputs.
Inputs
Two or more point clouds. The locations can be specified by file paths or URIs.
Outputs
A point cloud in CSAR format. The location can be specified by a file path or a URI.
Command Line Syntax
carisbatch --run JoinPoints --output-crs <value> [options] <inputs> <output>
Options
The following table describes the parameters available for this process.
Parameter |
| |||
Long | Short | Description | Can Repeat | Notes
|
--primary-band | m | A string specifying the name of the primary elevation band of the output. The default value is Depth. | FALSE | |
--contributor-attribute | C | A string specifying an attribute value to be included in the Contributor layer. The Contributor for each point is populated with a list of the local CSAR metadata values from the source that is copied to the output point cloud. The default value is uri. | TRUE | |
--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 | |
--output-crs | c | A string specifying the horizontal coordinate reference system key of the output. | FALSE | This must be specified explicitly. |
--output-vertical-crs | o | A string specifying the vertical coordinate reference system key of the output. No vertical transformation will be applied even if a value is specified. This value is only used as metadata on the output dataset. | FALSE | |
--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 need to join the data in three point clouds into one new point cloud. | |
Description | Command Line Syntax | |
The primary elevation band will be Depth. | --primary-band Depth | |
The output coordinate reference system will be UTM 30N. | --output-crs UTM-30N | |
The input files are: D:\BatchSample\Cloud1.csar D:\BatchSample\Cloud2.csar D:\BatchSample\Cloud3.csar | D:\BatchSample\Cloud1.csar D:\BatchSample\Cloud2.csar D:\BatchSample\Cloud3.csar | |
A new file, with the name Joined.csar, will be created in the BatchSample folder. | D:\BatchSample\Joined.csar | |
Command Line |
| |
Outcome | The three input point clouds are joined into a single new point cloud in the location specified. | |
Extra Notes | The resulting point cloud will contain the points and their attributes from the input sources and a new automatically generated boundary polygon. | |