Hand-Eye Calibration for Truss/Gantry Robots

You are currently viewing the documentation for version 1.8.2. To access documentation for other versions, click the "Switch Version" button located in the upper-right corner of the page.

■ To use the latest version, visit the Mech-Mind Download Center to download it.

■ If you're unsure about the version of the product you are using, please contact Mech-Mind Technical Support for assistance.

This how-to guide introduces how to complete the hand-eye calibration for truss robots (also called gantry robots).

For the concepts related to the hand-eye calibration for truss robots and the usage of the extrinsic parameter file, please refer to the section Explanation of the Calibration for Truss Robots.

Preparation before Calibration

Before hand-eye calibration, you need to finish the following preparations:

  • Construct the Mech-Mind Vision System.

  • Prepare the materials required for calibration.

  • Adjust the effect of calibration board’s point cloud.

Construct the Vision System

Construct the Mech-Mind Vision System by referring to the section Vision System Hardware Setup.

You need to use Mech-Eye Viewer, Mech-Vision and Mech-Viz during hand-eye calibration. Please ensure that they have been installed and are running the latest versions.

Prepare the Materials Required for Calibration

The hand-eye calibration for truss robots needs to use the following materials:

  • Calibration board

  • Sharp tip

  • Tape measure

Please prepare the calibration board according to the following requirements:

  • Ensure that the circles of the calibration board are clearly visible and without obvious scratches, and the board does not suffer from deformations.

  • In the calibration for truss robot scenario, please place the calibration board in the center of the object plane, where target objects are to be placed.

The sharp tip should be mounted on the center of the truss robot’s gripper. The tape measure is used to measure the deviation from the sharp point to the center of the robot flange in X, Y, and Z directions.

truss calib install tip

Adjust the Effect of Calibration Board’s Point Cloud

  1. Open Mech-Eye Viewer to adjust camera parameters.

  2. Adjust the 2D parameters to make sure that the 2D image of the calibration board is clear and neither overexposed nor underexposed.

  3. Adjust 3D parameters to make sure that the point clouds of the circles on the calibration board are complete and have clear contours. It is recommended to set Surface Smoothing and Outlier Removal to Normal in the Point Cloud Processing section to reduce the point cloud fluctuation range.

    If the on-site ambient lights are not ideal and affect the quality of 2D images and point clouds, you can use shading or supplemental light to improve the lighting conditions.

  4. Make sure that the images and point cloud of the calibration board are up to standard after completing preceding steps.

    Normal Overexposed Underexposed

    2D image

    normal-2d

    overexposure-2d

    underexposure-2d

    Point cloud

    normal-3d

    overexposure-3d

    underexposure-3d

Pre-calibration Configuration

  1. Open Mech-Vision, and click the Camera Calibration (Standard) button in the toolbar. The Configuration before Calibration window will be prompted.

  2. In the Select how to calibrate window, select the New calibration radio button, and then click the Next button.

    truss calib preset new
  3. In the Select calibration task window, select Hand-eye calibration for custom robot from the drop-down list box, specify the Robot Euler angle convention parameter, select the robot coordinate system type, and then click the Next button.

    truss calib preset select robot other
    • You can determine robot coordinate system type according to the section Left- and Right-handed Coordinate Systems. If the truss robot uses the left-handed coordinate system, you just need to select Left-handed here.

    • When the vision system communicates with the robot, the communication module will automatically transform the coordinate system for the sent and received poses. When the communication module receives the robot pose from the robot side, it transforms the robot pose in the left-handed coordinate system to the one in the right-handed coordinate system; when it sends the pose output by the software to the robot side, it transforms the robot pose in the right-handed coordinate system to the one in the left-handed coordinate system.

    • When the robot flange pose is required to be input during the calibration procedure, you need to take the inverse of the Y-axis value first.

  4. In the Select a robot type for calibration window, select the Truss (up to 6 DOF, XYZABC), and then click the Next button.

    truss calib preset select robot type
  5. In the Select axes affecting camera window, select the axes as required (such as X-axis, Y-axis, Z-axis, and Rz), and then click the Calibrate button.

    truss calib select affected axes

Till now, you have completed the pre-calibration configuration and can start the calibration procedure.

Calibration Procedure

Connect to the Camera

  1. In the Connect to camera step, select the camera to connect in the Camera ID list, and then click the connect camera icon button or double-click the camera entry to connect to it.

    truss calib connect camera tcp touch
  2. After the camera is connected, click the Capture once or Capture live button.

    truss calib camera capture tcp touch
  3. In the Image viewer panel, ensure that the camera can capture images normally and click the Next button on the bottom bar.

Mount Calibration Board & Check Intrinsic Parameters

  1. In the Mount calibration board & check intrinsic parameters step, select the calibration board model for the Standard calibration board model parameter according to its model nameplate in the 1 Select calibration board area.

    truss calib select calib board tcp touch
  2. In the 2 Check calibration board position and point cloud quality area, read carefully the requirements on the calibration board position and point cloud quality, and then click the Capture live button. The Capture live button will turn into Stop capturing and detect position.

  3. Manually move the calibration board to the proper position (in the red rectangle), and ensure that the 2D image and depth map of the calibration board meet the requirements, and then click the Stop capturing and detect position button.

    truss calib install calib board tcp touch

    If the captured images do not meet the requirements, click the Open Mech-Eye Viewer button to open the Mech-Eye Viewer software, adjust the 2D and 3D exposure parameters and re-capture images. Please note that you need to change the Parameter group parameter to “calib” first.

  4. In the 3 Check intrinsic parameters area, click the Check intrinsic parameters button.

  5. Confirm the results of the camera intrinsic parameter check.

    • If the camera intrinsic parameter check passes, click the OK button in the prompted window, and then click the Next button on the bottom bar.

      truss calib check intri pass
    • If the camera intrinsic parameter check fails, adjust detection parameters by drawing aid circles or manually adjusting the calibration circle detection parameters, and then click the Recheck intrinsic parameters button.

Draw an Aid Circle

  1. To draw an aid circle, click the Draw an aid circle button.

  2. In the right Image viewer panel, right-click the calibration board image and clear the Fit to window checkbox, and press the Ctrl key and drag the roller to adjust the image to a suitable size.

  3. Move the mouse pointer to the cross center point of the calibration circle, press the left mouse button and make the aid circle completely include the calibration circle and then release it.

    truss calib adjust blob
  4. Click the Recheck intrinsic parameters button, and confirm that the camera intrinsic parameter check passes.

Manually Adjust Detection Parameters

To manually adjust detection parameters, click Calibration circle detection parameters (advanced), adjust parameter settings and click the Recheck intrinsic parameters button to confirm whether the camera intrinsic parameter check passes.

If the calibration circles are still not detected, please adjust the camera settings according to the on-site operating conditions.

Set TCP in Flange Frame

Before this step, use the tape measure to measure the deviation (in mm) from the sharp point to the center of the flange in X, Y, and Z directions.

In the Set TCP in flange frame step, enter the deviation values in X, Y, and Z directions in the X, Y and Z text boxes, click the Confirm TCP values button and then click the Next button on the bottom bar.

truss calib set tcp tcp touch

If the truss robot uses the left-handed coordinate system, you need to take the inverse of the deviation value in the Y direction before entering it.

Collect Images and Flange Poses

  1. Control the truss robot to let its end tip touch the cross center point of the calibration circle “point 1” on the calibration board, and record the robot flange pose in the teach pendant.

    truss calib tcp touch three points
  2. In the Collect images and flange poses step, click the add_button button of point 1, and enter the robot flange pose in the prompted Input Flange Pose of Robot dialog box, and then click the OK button.

    If the truss robot uses the left-handed coordinate system, you need to take the inverse of the Y-axis value before entering the robot flange pose.

    truss calib add pose tcp touch
  3. Repeat the preceding steps, and let the end tip touch the cross center points of point 2 and point 3, and enter robot flange poses.

  4. Click the add_button button of the current calibration board to capture the images of it.

  5. Click the Update data button and then click the Next button on the bottom bar.

    truss calib update data tcp touch
    • The calibration program requires that at least three points not in a line should be touched for calculating extrinsic parameters.

    • If the truss robot lacks a degree of freedom in a certain direction (for example, in the Y direction), you can add the poses of multiple calibration boards. First, adjust the direction of the calibration board so that the sharp point can touch two points on the calibration board, and at the same time input the pose of the robot flange and collect the image of the calibration board. Then raise (or lower) the calibration board in the Z direction, and again touch the points on the calibration board along the X direction, and at the same time input the robot flange pose and collect the image of the calibration board. Make sure that the new position of the calibration board is significantly different from the previous one.

Calculate Extrinsic Parameters

  1. In the Calculate extrinsic parameters step, click the Calculate extrinsic parameters button.

    truss calib calculate extri tcp touch
  2. In the prompted window indicating calibration success, click the OK button.

    truss calib confirm calib result
    If you want to enhance the calibration accuracy, please refer to the section Calibration Result Check and Analysis.
  3. Click the Save button on the bottom bar. In the prompted Save Calibration Files dialog box, click the OK button. The camera calibration result will be automatically saved in the “calibration” directory of the project.

Till now, the calibration process is completed.

Change the Extrinsic Parameter File

If the camera’s extrinsic parameter file has been used by a Mech-Vision project, you need to change the extrinsic parameter file used by the Mech-Vision project to a new one after you finish the hand-eye calibration.

  1. Select the Capture Images from Camera Step.

    change calibration parameter group
  2. In the Step Parameters panel, click change calibration parameter group icon of the Camera Calibration Parameters parameter, and select the newly calibrated extrinsic parameter file.

Calibration-Related Status Codes

If the robot uses the Standard Interface to communicate with the Vision System during hand-eye calibration, the Vision System will return status codes in response data to indicate the execution status of the commands. The status codes indicate both the normal execution results and execution failures. You can perform further troubleshooting according to the status codes.

Calibration Error Codes

Error code Description

7001

Calibration: Parameter error

7002

Calibration: Calibration flange pose not provided by Mech-Vision

7003

Calibration: Calibration joint positions not provided by Mech-Vision

7004

Calibration: Robot failed to reach calibration point

Calibration Normal Status Codes

Normal Status Code Description

7100

Calibration: Robot reaches calibration point successfully

7101

Calibration: Pose received from Mech-Vision successfully

We Value Your Privacy

We use cookies to provide you with the best possible experience on our website. By continuing to use the site, you acknowledge that you agree to the use of cookies. If you decline, a single cookie will be used to ensure you're not tracked or remembered when you visit this website.