Hand-Eye Re-Calibration for Truss/Gantry Robots

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

Preparation before Calibration

Prepare the Materials Required for Calibration

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

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

  • Place the calibration board flat at the center of the working plane, and ensure that the board remains fixed in position throughout the calibration process.

  • 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.

  4. Make sure that the images and point cloud of the calibration board are up to standard after completing the 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, select a project in the project list, and then click the Camera Calibration (Standard) button in the toolbar. The Configuration before Calibration window will be prompted.

  2. In the Configuration before Calibration window, select the Load calibration parameters radio button, select the parameters that were calibrated for the project, and then click the Next button.

  3. In the Select parameter usage window, select Continue working on the calibrated camera radio button, and then click the Next button.

    Camera status should be displayed as connected.
  4. In the Select calibration task window, select Recalibrate from the start radio button, and then click the Calibration button. The Calibration (Eye to Hand) window will be prompted.

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

Calibration Procedure

Connect to Camera

By default, the camera used in the project is set to be connected. Please click the Next button to continue the calibration procedure.

If the camera is not connected, please complete the camera connection by referring to the following instructions:

  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 live or Capture once 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 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. If the intrinsic parameter check still fails, please contact Technical Support.

Draw 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, clear the Fit to window checkbox, 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.

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
  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.

Verify Calibration Results

After calculating the extrinsic parameters, you can use the “Analyze extrinsic parameter error in ETH setup” tool to evaluate whether the calibration results are valid.

The detailed instructions are as follows:

  1. In the Calculate extrinsic parameters step, click Extrinsic parameter accuracy in the Supplementary tools area, and then select Analyze extrinsic parameter error in EIH setup in the pop-up Error Analysis window.

  2. Learn the instructions on evaluating the extrinsic parameter error in EIH setup, and then click the Next button.

  3. Click + to add multiple sets of calibration board poses.

    analyze eih extri errors
  4. Click the Analyze error button to view the result.

If the error meets the requirements of the picking accuracy, the calibration result is valid.

Change the Extrinsic Parameter File

After hand-eye calibration, it is necessary to change the extrinsic parameter file used in the current Mech-Vision project to a new one.

  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 moved to the 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.