CARIS HIPS and SIPS Help : CARIS Batch Utility : CZMIL Processes : Georeference CZMIL Points
 

Georeference CZMIL Points

Description

The GeoreferenceCZMILPoints process converts CZMIL CWF waveform and SBET trajectory data into a georeferenced point cloud. During this conversion, roll, pitch, and heading corrections are applied to generate point cloud data referenced to ellipsoid height.

Every point in the point cloud is also assigned a land/water confidence value during processing. This value is used to identify points as either land or water, which is needed when determining the seafloor. A Land-Water Confidence band is included the output point cloud and can be used to access the confidence values assigned to each point. The land/water classification is controlled by the settings for various lidar parameters; see Edit Lidar Parameters for information on the parameters.

Note: In order for the land/water classification to be processed, the CWF files must have the same file name as the other files (.cif, .cpf, etc) in the folder.

Input

CZMIL Waveform Files (CWF).

Output

CZMIL Processed Files (CPF), automatically named the same as the input CWF.

Command Line Syntax

carisbatch --run GeoreferenceCZMILPoints --sbet-file <value> [options] <input>

User Interface Command

Georeference CZMIL Data

Options

The following table describes the parameters available for this process.

Parameter

 

Long

Short

Description

Can Repeat

Notes

 

--sbet-file

The full path to the SBET file.

FALSE

--sbet-file-coordinate-reference-system

The Geographic Coordinate Reference System used to store the Applanix SBET file. NAD 83 and WGS 84 are currently supported, with WGS 84 being the default.

One of {WGS84, NAD83}.

FALSE

--water-surface-control

A representation of the water surface. This is used to help determine the depth of the seafloor when water shots have missing or unreliable surface returns. Specified as:

RASTER: The raster representing the water surface. Only GeoTIFF raster surfaces are supported at this time.

ELEVATION: The name of a band containing elevation values to be used as the water surface. The default is the primary elevation band of the raster.

RANGE_BAND: The name of a band containing distances above and below the water surface to be considered within the margin of error of being the water surface. The default is the second band of a GeoTIFF, or CARIS:NONE otherwise. If CARIS:NONE, range estimates are automatically calculated for each point. Regardless, the range is always clipped to the water surface window size specified in the lidar parameters for the dataset.

FALSE

Example

To use this command refer to the following example.

Example

Objective

You want to create a georeferenced point cloud using CZMIL CWF data.

Description

Command Line Syntax

The SBET file containing the location information for the data is called SBET.000 and is located in the D:\SampleData\Survey directory.

--sbet-file D:\SampleData\Survey\sbet.000

The ControlRaster.tiff file will be applied. The file can be found in the D:\SampleData\Raster directory. The elevation values are stored in Band 1 and the range values are stored in Band 2.

--water-surface-control RASTER D:\SampleData\Raster\ControlRaster.tiff ELEVATION “Band 1” RANGE_BAND “Band 2”

The CWF file containing the source data is called Flightline.cwf and is located in the D:\SampleData\Survey directory.

D:\SampleData\Survey\flightline.cwf

Command Line

carisbatch -r GeoreferenceCZMILPoints --sbet-file D:\SampleData\LIDAR\sbet.000 --water-surface-control RASTER D:\SampleData\Raster\ControlRaster.tiff ELEVATION “Band 1” RANGE_BAND “Band 2” D:\SampleData\Survey\flightline.cwf

Outcome

The Survey directory is populated with a flightline.cpf point cloud file, created from the data in the CWF file and the raster control surface.

Extra Notes

N/A