--compute-and-apply

If set, computes the calibration parameters in the survey_reflectance_stats.csv file stored in the Lidar folder and applies the new values to the CPF files.

If not set, the survey_reflectance_stats.csv file is applied to the CPF files using the existing calibration.

FALSE

--ground-control-points

If set, reflectance measurements in a CSV file are used for the reflectance calibration. The CSV file contains ground control points, which are reflectance measurements of targets like road, grass, bare earth, tarmac, etc. normally collected using a hand-held spectrometer at Green wavelength and the corresponding geographical locations.

The ground control points file contains 4 columns of reflectance measurements and their geographical positions in the following format:

ID, Latitude, Longitude, Reflectance

Specified as:

<File> - The file that contains the ground control points.

<SearchRadius> - The maximum horizontal distance from a control point coordinate that will be considered for calibration. The default is 2.0 metres.

If not set, a relative calibration among the shallow channels is computed.

FALSE

--minimum-depth

If set, the minimum depth considered for bathymetric calibration. This is used to ignore the breakwater zone, which would be survey specific.

Supported units: cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd, yd.

If not set, a default of -100.0 metres is used.

FALSE

--maximum-depth

If set, the maximum depth considered for bathymetric calibration. This is used to ignore the extinction depth zone, which would be survey specific.

Supported units: cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd, yd.

If not set, a default of 100.0 metres is used.

FALSE

--maximum-standard-deviation-depth

If set, the maximum standard deviation of channel returns for a bathymetric shot to be considered for calibration. System vertical accuracy (bathymetric) is recommended.

Supported units: cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd, yd.

If not set, a default of 100.0 metres is used.

FALSE

--minimum-height

If set, the minimum height from bare earth considered for topographic calibration.

Supported units: cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd, yd.

If not set, a default of -100.0 metres is used.

FALSE

--maximum-height

If set, the maximum height from bare earth considered for topographic calibration. This is used to ignore trees and buildings, which would be survey specific.

Supported units: cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd, yd.

If not set, a default of 100.0 metres is used.

FALSE

--maximum-standard-deviation-height

If set, the maximum standard deviation of channel returns for a topographic shot to be considered for calibration. System vertical accuracy (topographic) recommended.

Supported units: cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd, yd.

If not set, a default of 100.0 metres is used.

FALSE

Objective

You want to calibrate a CZMIL dataset to optimize the reflectance values in the data.

Description

Command Line Syntax

The CZMIL data is located in the Survey folder at D:\SampleData.

D:\SampleData\Survey

The reflectance values will be calibrated prior to being applied.

--compute-and-apply

A groundcontrolpoints.csv file will be used for the calibration and can be found in the same Survey folder as the input data. A search radius of 2 metres will be used.

--ground-control-points D:\SampleData\Survey\groundcontrolpoints.csv 2.0m

Command Line

carisbatch -r CalibrateReflectance --compute-and-apply --ground-control-points D:\SampleData\Survey\groundcontrolpoints.csv 2.0m D:\SampleData\Survey\

Outcome

The CZMIL data is updated according to the reflectance values in the ground control points file.

Extra Notes

N/A