You're reading the documentation for a development version. For the latest released version, please have a look at master.

Overview

Modes

  • Accumulate : In this mode, the calibration node accumulates (loads) the needed data and calibration settings to be used in the final mode for calibration computation.

  • Final : In this mode, the calibration node uses the data from the accumulation mode and perform the actual robot calibration.

  • Load : In this mode, the calibration node loads the ouput from the final for future use. This can help to load previous calibration results without a need to run previous modes.

Accumulate mode inputs

  • Hand Eye Confg (type:Int) : Robot camera configuration. Either eye-to-hand (calibration tool mounted on robot) or eye-in-hand (camera mounted on robot).

  • Pose (type:Pose) : Pose collected from robot read node.

  • Image (type:Image) : Image captured from the calibration tool.

  • Grid Type (type:Int) : The used type of calibration tool. It can be either chessboard or grid circles.

  • Number of rows (type:Int) : The number of rows in the grid board.

  • Number of columns (type:Int) : The number of columns in the grid board.

  • Row spacing (type:Double) : The distance (mm) between every two square corners in a row in the chessboard or the distance between every two circles in a row in the circle grid.

  • Column spacing (type:Double) : The distance (mm) between every two square corners in a column in the chessboard or the distance between every two circles in a column in the circle grid.

Accumulate mode outputs

  • milCalibrationID (type:MIL_ID) : This output includes the information about the calibration settings alongside with the data needed for performing calibration computation in the final mode.

  • calibrationStatus (type:Int) : This output indicates if there were any errors during the node execution. If the value is 0, no error has occurred. However, if the value is non-zero, an error has occurred during execution and an error message will be printed in the console.

Final mode inputs

  • Hand Eye Confg (type:Int) : Robot camera configuration. Either eye-to-hand (calibration tool mounted on robot) or eye-in-hand (camera mounted on robot).

  • Reference node (type:String) : The reference calibration node in accumulation mode which its output will be used to perform calibration.

  • File name (type:String) : The filename used to save the outputs of the node in. This file is saved in the folder ‘da_calibrations’ in the workspace folder.

Final mode outputs

  • cam_in_gripper (type:Pose) : The 3D transformation from the camera to the gripper (TCP). Only has value in eye-in-hand situations.

  • base_in_world (type:Pose) : The 3D transformation from robot base to the world (calibration board). Only has value in eye-in-hand situations.

  • cam_in_base (type:Pose) : The 3D transformation from camera to robot base. Only has value in eye-to-hand situations.

  • gripper_in_world (type:Pose) : The 3D transformation from gripper (TCP) to world (calibration board). Only has value in eye-to-hand situations.

  • milCalibrationID (type:MIL_ID) : This output includes the information about the calibration settings alongside with the data needed for performing calibration computation in the final mode.

  • calibrationStatus (type:Int) : This output indicates if there were any errors during the node execution. If the value is 0, no error has occurred. However, if the value is non-zero, an error has occurred during execution and an error message will be printed in the console.

Load mode inputs

  • Hand Eye Confg (type:Int) : Robot camera configuration. Either eye-to-hand (calibration tool mounted on robot) or eye-in-hand (camera mounted on robot).

  • File name (type:String) : The filename to load the outputs from the final mode.

Load mode outputs

Same as the final mode.