Calibration Functions

Axis calibration corrects the position of an axis based on the position of one or two reference axes and the values that you specify in a calibration table. You can configure calibration in Automation1 Studio in the Configure workspace on the Calibration tab. In this process, you must upload the axis calibration files from your computer's file system. And, you must reset the controller to make calibration active. For more information, refer to Axis Calibration.

As an alternative, you can load and unload axis calibration files with the CalibrationLoad() and CalibrationUnload() functions. Unlike when you load calibration in the Configure workspace, the CalibrationLoad() function can load files only from the controller file system. Also, it is not necessary to reset the controller when you issue these functions, but calibration changes do not stay after you reset the controller. For more information on calibration, see Axis Calibration and Galvo Power Correction.

Use the CalibrationLoad() function to load and activate the axis calibration file or galvo power correction file on the controller file system that you specify with the $controllerFileName argument. Axis calibration files and galvo power correction files must use the UTF-8 encoding. To upload a calibration file to the controller, use the procedure that follows:

To Upload a Calibration File to the controller

In Automation1 Studio, go to the Configure workspace.
In the Controller section, select Controller Files.
Drag and drop your calibration file on the pane, or click Upload Files/Folders.
A dialog shows and asks if you want to upload a calibration file. Click Yes.

The CalibrationLoad() and CalibrationUnload() functions do not operate in real time. The time it takes them to execute depends on the controller type and configuration.

function CalibrationLoad($calibrationType as CalibrationType, $controllerFileName as string)

Loads and activates the specified axis calibration file or galvo power correction file.

Arguments

$calibrationType The type of calibration that the specified file represents.

$controllerFileName The path to the file to be loaded as a calibration file.

function CalibrationUnload($calibrationType as CalibrationType)

Deactivates and unloads the calibration for the specified calibration type.

Arguments

$calibrationType The type of calibration to be unloaded.