Automatic Re-Calibration in the Eye-in-Hand Setup (Four-Axis Robots)

You are viewing an old version of the documentation. You can switch to the documentation of the latest version by clicking the top-right corner of the page.

This how-to guide introduces how to complete the automatic calibration for four-axis robots in the eye-in-hand (EIH) setup.

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.

  • Please place the calibration board in the center of the working plane, where target objects are to be placed.

  • Move the robot to the start position for calibration. The starting point is the camera’s image-capturing position (the robot will move the camera upwards during calibration).

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 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 Select how to calibrate 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.

    • If the program uses Standard Interface communication mode, please select and run the automatic calibration program on the robot teach pendant.

    • After completing the above settings,Robot status should display 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 in Hand) window will be prompted.

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

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

    eih calib auto connect camera
  2. After the camera is connected, click the Capture once or Capture live button.

    eih calib auto image capture
  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.

    eih calib auto select calib board
  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, 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.

    eih calib auto install calib board

    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.

      eih calib auto 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.

    eih calib auto 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 Motion Path

  1. In the Set motion path step, set the Height span parameter in the 1 Set height span of calibration poses area.

    eih calib auto set robot path

    The Height span parameter should be set according to the recommended working distance range of the camera and the size of the robot’s working space.

  2. Click the Generate path parameters button, and then click the Generate motion path based on path parameters button.

  3. When the Generate motion path based on path parameters turns into Completed, click the Next button on the bottom bar.

Collect Images and Flange Poses

  1. Click the Auto move robot along path and capture images button, read the safety window carefully, and then click the OK button.

    eih calib auto safety tips
  2. Wait until the robot finishes moving along the preset path and the camera finishes capturing images on all waypoints. In the right Image viewer panel, all the captured images are displayed.

    • Please stay away from the robot working area to keep safe.

    • Clicking the Stop Robot button can exit the calibration process. But the robot will not stop until it finishes the current waypoint. In case of emergency, please tap the emergency stop button on the robot teach pendant to stop the robot immediately (the robot needs to be reconnected after tapping the emergency stop button).

  3. After all images are captured, click the OK button in the prompted window.

    eih calib auto capture finished
  4. Confirm that the collected calibration data meets the data requirements, and then click the Next button on the bottom bar.

    eih calib auto data requirements

Calculate Extrinsic Parameters

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

    eih calib auto calculate extri 4 axis
  1. In the prompted window indicating calibration success, click the OK button.

    eih calib auto confirm calib result
  2. Calculate the Z-axis translation of the extrinsic parameters.

    Due to the lack of degrees of freedom in rotation in four-axis robots, the captured images during calibration may lack the images for calibration board rotation. After calibration, you need to manually adjust the Z-axis value of the extrinsic parameters.
    1. Mount a tip on the proper position of the robot gripper, and set the tool center point (TCP).

    2. Control the robot to let its end tip touch the cross center point of a calibration circle on the calibration board, and record the tool pose (X0, Y0, Z0) in the teach pendant.

      eih calib auto four axis read tcp
    3. Move the robot to the image-capturing position to capture the image of the calibration board, click the Apply parameters and preview point cloud button in the Adjust parameters area to send the point cloud of the calibration board to Mech-Viz.

    4. In Mech-Viz, add a “Fixed-Point Move” Step, and enter the tool pose (X0, Y0, Z0) in the previous step as the target waypoint. Adjust the Z-axis value of the tool pose to make sure that the target waypoint has moved to the surface of the calibration board’s point cloud, and record the new Z-axis value (Z1). You can get the Z-axis value error ΔZ by subtracting Z1 from Z0.

      eih calib auto four axis z differenece
    5. Back to the Adjust parameters area of the Calculate extrinsic parameters steps, manually change the Z-axis translation parameter to the error ΔZ, and then click the Apply parameters and preview point cloud button.

    6. In the 3D Simulation Area of Mech-Viz, confirm that the pose (X0, Y0, Z0) is on the surface of the calibration board’s point cloud.

      eih calib auto four axis check board point cloud
  3. After calculating the extrinsic parameters, click Point cloud viewer on the right to view the error point cloud.

    The error point cloud shows the deviation between the calculated value and the actual value of the circles on the calibration board.
    calibration reference error point cloud tcp touch
  4. Verify whether the accuracy of the calibrated extrinsic parameters meets the project’s requirements. The error value with the 100% percentage can be roughly considered as the calibration accuracy.

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

    eih calib auto save calib result

Till now, the calibration process is completed.

Verify Calibration Results

After calculating the extrinsic parameters, you can use any of the following methods to verify if the calibration results are valid.

View the Extrinsic Parameter Calibration Report

After calculating the extrinsic parameters, you can click View extrinsic parameter calibration report button. The extrinsic parameter calibration report will be automatically displayed after it is generated.

If the calibration results of the Euler angle convention check, camera accuracy check, and robot absolute accuracy check are all “Pass” (or there is no significant error), then the extrinsic parameters are calibrated successfully and can be used.

If any of the checks fails, please follow the recommendations provided in the report and re-calibrate the extrinsic parameters until the check passes.

Use the “Analyze Extrinsic Parameter Error in EIH Setup” Tool to Evaluate Extrinsic Parameters

After calculating the extrinsic parameters, you can use the “Analyze extrinsic parameter error in EIH 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.