Intrinsic Parameter Tool
This tool is used to check if the camera intrinsic parameters are accurate, to correct the intrinsic parameters, and to reset to factory intrinsic parameters. The coordinates of points are accurate only if the intrinsic parameters are accurate.
| For projects with high accuracy requirements, you can enable the high-accuracy mode, in which stricter standards are used to check the intrinsic parameters. High-accuracy mode is available in the Administrator account. If needed, please contact Technical Support. |
Preparation
Before checking the intrinsic parameters, please prepare the calibration board that came with the camera.
Place the calibration board within the camera FOV and obtain the 2D image and depth map of the calibration board. Make sure the obtained 2D image and depth map satisfy the following requirements:
-
The region containing the circles on the calibration board is completely captured.
-
The 2D image is not too bright or too dark, and the circles on the calibration board are clear and complete.
-
The circles on the calibration board in the depth map are complete.
Examples of 2D images of the calibration board:
| Image too dark, the circles on the calibration board cannot be easily discerned. | Circles on the calibration board are complete, and circle boundaries are clearly visible. | Image too bright, the circles on the calibration board cannot be easily discerned. | |
|---|---|---|---|
|
|
|
|
If the obtained 2D image does not satisfy the requirements, please adjust the parameters for the 2D image.
Examples of depth maps of the calibration board:
| Exposure time too short, the circles on the calibration board are incomplete. | Circles on the calibration board / the entire calibration board are complete. | Exposure time too long, some or all the circles on the calibration board are lost. | |
|---|---|---|---|
|
|
|
|
If the obtained depth map does not satisfy the requirements, please adjust the parameters for the depth map.
Check Intrinsic Parameters
Click the Tool menu in the menu bar and select Intrinsic Parameter Tool to open the Intrinsic Parameter Tool window.
To use Intrinsic Parameter Tool to check the camera intrinsic parameters, please follow these steps.
-
In 1. Place calibration board and check image quality , click Acquire images to obtain the 2D image and depth map of the calibration board. Check if the images satisfy the requirements.
-
In 2. Select model of placed calibration board, set the specifications of the calibration board:
-
If using a standard calibration board, select the model from the drop-down menu.
-
If using a customized calibration board, select Customized first, and then set the model, rows, columns and spacing according to the information provided by the engineer.
-
-
In 3. Check intrinsic parameters, click Check intrinsic parameters to start checking the camera intrinsic parameters. When the check is completed, a window of the check results will pop up.
-
If the check results are displayed in green, then the check is passed, and the camera functions properly.
-
If the check results are displayed in red, or an error message is displayed, then the errors in the intrinsic parameters are large, or the check has failed. Please troubleshoot according to the instructions in the window.
-
| For projects with high accuracy requirements, you can use the high-accuracy mode: switch to the Administrator account, in Intrinsic Parameter Tool, check High-accuracy mode in 3. Check intrinsic parameters, and place the calibration board according to the displayed distance. If the calibration board is not placed at the designated distance, the intrinsic parameter check may fail. |
Troubleshoot Common Issues
The following issues may be encountered while checking the intrinsic parameters.
Errors in the Intrinsic Parameters Are Large
Symptom:
The intrinsic parameter check results are displayed in red, indicating that the errors in the intrinsic parameters are large.
Solution:
Please try the following solutions:
-
Check if the calibration board specifications are correct.
-
If incorrect, enter the correct specifications. Then, check the intrinsic parameters again.
-
If correct, proceed to the next step.
-
-
Check if the 2D image and depth map meet the image requirements. Please refer to the image requirements.
-
If the 2D image does not satisfy the requirements, please adjust the parameters for the 2D image. If the depth map does not satisfy the requirements, please adjust the parameters for the depth map. Then, check the intrinsic parameters again.
-
If the images satisfy the requirements, proceed to the next step.
-
-
Take the measure corresponding to your situation:
-
If this is the first intrinsic parameter check of the project, the camera intrinsic parameters may be problematic. Please contact Technical Support.
-
If this is an intrinsic parameter check after a period of use, proceed to the next step.
-
-
Use the Correct Intrinsic Parameters function to correct the intrinsic parameters. For detailed instructions, please refer to Correct Intrinsic Parameters.
-
If the correction succeeded, click Check intrinsic parameters in the pop-up window to check the intrinsic parameters again.
Hand-eye calibration must be performed again after the intrinsic parameters have been corrected. -
If the correction failed, click Confirm in the pop-up window, and retry the correction or contact Technical Support.
-
Circles on the Calibration Board not Detected
Symptom:
The intrinsic parameter check result window displays this message: Circles on the calibration board not detected.
Solution:
Please try the following solutions:
-
Check if the calibration board specifications are correct.
-
If incorrect, enter the correct specifications. Then, check the intrinsic parameters again.
-
If correct, proceed to the next step.
-
-
Check if the 2D image and depth map meet the image requirements. Please refer to the image requirements.
-
If the 2D image does not satisfy the requirements, please adjust the parameters for the 2D image. If the depth map does not satisfy the requirements, please adjust the parameters for the depth map. Then, check the intrinsic parameters again.
-
If the images satisfy the requirements, proceed to the next step.
-
-
Use the Draw aid circle to facilitate the detection. For detailed instructions, please refer to Draw Aid Circle.
-
In 3. Check Intrinsic Parameters, click Check intrinsic parameters to check the intrinsic parameters again.
-
If the check succeeded, the troubleshooting has been completed.
-
If the intrinsic parameter check result window still displays Circles on the calibration board not detected, proceed to the next step.
-
-
Use the Edit Feature Detection Parameters function to facilitate the detection. For detailed instructions, please refer to Edit Feature Detection Parameters.
-
In 3. Check Intrinsic Parameters, click Check intrinsic parameters to check the intrinsic parameters again.
-
If the check succeeded, the troubleshooting has been completed.
-
If the intrinsic parameter check result window still displays Circles on the calibration board not detected, please contact Technical Support.
-
Valid Feature Points Not Found in Depth Map
Symptom:
The intrinsic parameter check result window displays this message: Valid feature points not found in depth map.
Solution:
Check if the depth map satisfies the requirements. Please refer to the image requirements.
-
If the depth map does not satisfy the requirements, please adjust the parameters for the depth map. Then, check the intrinsic parameters again.
-
If the depth map satisfies the requirements, please contact Technical Support.
Supplementary Functions
Intrinsic Parameter Tool provides the following functions that assist you in resolving the common issues.
Correct Intrinsic Parameters
This function can assist you in resolving the issue of large errors in the intrinsic parameters.
When using the Correct Intrinsic Parameters function, place the calibration board according to the following requirements:
-
Place the calibration board at the height of the orange line in the figure below:
-
Acquire at least 5 sets of data where the calibration board is located at the center and the four corners of the FOV.
|
|
|
|
|
Follow these steps to use the Correct Intrinsic Parameters function:
-
Place the calibration board according to the above requirements.
-
Check the Correct Intrinsic Parameters option, and then click Acquire data.
-
Move the calibration board, and click Acquire data again.
-
After adding the data, click Correct intrinsic parameters. When the correction is completed, a window of the correction results will pop up.
Draw Aid Circle
This function can assist you in resolving the issue of circles on the calibration board not detected.
Follow these steps to use the Draw aid circle function:
-
In 3. Check Intrinsic Parameters, click Draw aid circle.
-
Find a complete circle on the calibration board in the 2D image. Click while holding the Ctrl key and then move diagonally up or down to adjust the size of the aid circle. Click again to finish drawing the aid circle.
-
Only one aid circle can be drawn. The aid circle should be as close possible to the boundary of the circle on the calibration board.
-
If you need to re-draw the aid circle, click Draw aid circle again.
-
To zoom the 2D image, move the cursor onto the 2D image and scroll the mouse wheel.
-
Edit Feature Detection Parameters (Advanced)
This function can assist you in resolving the issue of circles on the calibration board not detected.
Follow these steps to use the Edit Feature Detection Parameters function:
-
In 3. Check Intrinsic Parameters, click Edit Feature Detection Parameters (Advanced).
-
Adjust the displayed feature detection parameters according to the actual situation.
-
If not all the circles on the calibration board can be captured, check Allow absence of some circles, and adjust the newly displayed feature detection parameters.
-
In 3. Check Intrinsic Parameters, click Check intrinsic parameters to check the intrinsic parameters again.