Description
The Optimize CZMIL Reflectance process runs the processed CZMIL data through an algorithm to radiometrically balance all the Shallow channels and to get an optimized version of the reflectance.
Input
A survey folder that contains a Lidar folder with at least 2 processed CZMIL CPF file(s).
Update
The lidar_parameters.dat file stored with the input CZMIL CPF file(s).
Command Line Syntax
carisbatch --run OptimizeCZMILReflectance --ground-control-points-file <value> [options] <input>
User Interface Command
Optimize Reflectance Data and Apply
Options
The following table describes the parameters available for this process.
Parameter |
| |||
|---|---|---|---|---|
Long | Short | Description | Can Repeat | Notes
|
--ground-control-points-file | A CSV file containing 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 measurements are used to optimize CZMIL reflectance. The ground control points file contains 4 columns of reflectance measurements and their geographical positions in the following format: ID, Latitude, Longitude, Reflectance | FALSE | ||
--relative-difference-threshold | A number specifying the minimum required relative difference percentage between the ground control points and CZMIL measured reflectance. The default value is 25. | FALSE | ||
--relative-difference-percentage | A number specifying the total minimum required relative difference percentage between the ground control points and CZMIL measured reflectance. The default value is 95% | FALSE | ||
--search-radius-shallow | A number specifying the maximum spatial distance between Shallow channel points and ground control points. The default value is 1m. Supported units: cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd, yd. | FALSE | ||
--search-radius-deep | A number specifying the maximum spatial distance between Deep channel points and ground control points. The default value is 1m. Supported units: cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd, yd. | FALSE | ||
--min-control-points-shallow | A number specifying the minimum number of qualified Control/Check points required for the processing of the Shallow channel. The default value is 25. | FALSE | ||
-min-control-points-deep | A number specifying the minimum number of qualified Control/Check points required for the processing of the Deep channel. The default value is 25. | FALSE | ||
Example
To use this command refer to the following example.
Example | ||
|---|---|---|
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. |
| |
The reflectance values to be applied are in the groundcontrolpoints.csv file located in the same Survey folder as the input data. |
| |
Command Line |
| |
Outcome | The CZMIL data is updated according to the reflectance values in the specified file. | |
Extra Notes | N/A | |