LR APDIS Activate MCM Calibration

Sets the specified MCM calibration as the active calibration on the instrument.

 

Input Arguments

 

0

Collection Instrument ID

Instrument ID

The ID of the LR to adjust.

1

String

Calibration Name (Optional)

Name of the desired calibration

2

Integer

Calibration ID (Optional)

ID of the desired calibration

 

Return Arguments

 

1

String

Active MCM Name

Name of the newly set MCM calibration

 

Returned Status

 

SUCCESS

The command successfully executed.

FAILURE

The specified instrument or calibration was not found.

 

Remarks

On APDIS models, and internal accelerometer is present, capable for reading the laser radar’s orientation with respect to gravity. If both optional input arguments (name is empty and id = -1) are not specified, then the function triggers AOC-based MCM lookup by reading the accelerometer of the Laser Radar. If MCM Database record that matches the accelerometer reading within a fixed tolerance is found, then this record will be activated; otherwise, the factory calibration will be activated.

If both optional input arguments (name and id) are specified, then the MCM calibration is set by id. The function checks if the record active MCM name and requested MCM name match. If name doesn’t match the id’s record, the function returns partial success;

If MCM record name (case-sensitive) is specified and record’s id is not, then this record will be activated if found in the database. If multiple MCMs exist in the database with the specified name, the most recently inserted (highest id) will be selected for activation. If record is not found, then the function will return error and no changes will be made.

If MCM record id is specified (and no name), then if found the MCM with the specified id will be activated. If input record id set to 0, it indicates no MCM (use factory calibration defaults).