CARIS HIPS and SIPS : CARIS Batch Utility : BASE Editor Processes : Warp Points
 

Warp Points

Description

The WarpPoints process transforms points to a specified coordinate reference system.

Inputs

A point cloud in a supported format.

Outputs

A point cloud in CSAR format.

Command Line Syntax

carisbatch --run WarpPoints --output-crs <value> --primary-band <value> [options] <input> <output>

User Interface Command

Warp Coverage

Options

The following table describes the parameters available for this process.

Parameter

 

Long

Short

Description

Can Repeat

Notes

 

--output-crs

c

A string specifying the horizontal coordinate reference system key of the output.

For time-dependent coordinate reference systems, the epoch can be specified, typically using the year, as <crs_id>@1997. A fractional year can also be specified, such as <crs_id>@1997.3, if needed. If no epoch is specified, the reference epoch of the coordinate reference system is used.

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 is applied even if a value is specified. This value is only used as metadata on the output dataset.

FALSE

--primary-band

m

A string specifying the name of the primary elevation band of the output.

This must be the name of an elevation band in the input.

The default value is the name of primary elevation band in the input.

FALSE

--include-band

b

A string specifying the name of a band to include in the output.

The ALL keyword is used to include all bands in the output.

TRUE

--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 transform a point cloud to a specific coordinate system.

Description

Command Line Syntax

The coordinate reference system of the output is UTM 29N NAD 83.

--output-crs UTM-29N-Nad83

The primary elevation band of the output is the Depth band.

--primary-band Depth

The source raster surface is Cloud1.csar located in the D:\BatchSample directory.

D:\BatchSample\Cloud1.csar

The resulting file will be named WarpPoints.csar located in the D:\BatchSample directory.

D:\BatchSample\WarpPoints.csar

Command Line

carisbatch --run WarpPoints --output-crs UTM-29N-Nad83 --primary-band Depth D:\BatchSample\Cloud1.csar D:\BatchSample\WarpPoints.csar

Outcome

A CSAR point cloud with the desired coordinate reference system is created in the specified location.

Extra Notes

N/A