This tutorial shows how to obtain calibration parameters for monocular camera.
1- Install Camera Calibration Parser, Camera Info Manager and Launch Testing Ament Cmake using operating system’s package manager:
sudo apt install ros-<ros2-distro>-camera-calibration-parsers
sudo apt install ros-<ros2-distro>-camera-info-manager
sudo apt install ros-<ros2-distro>-launch-testing-ament-cmake
2- Image Pipeline need to be built from source in your workspace with:
git clone – b <ros2-distro> email@example.com:ros-perception/image_pipeline.git
Also, make sure you have the following:
- A large checkerboard with known dimensions. This tutorial uses a 7x9 checkerboard with 200mm squares. Calibration uses the interior vertex points of the checkerboard, so an “8x10” board uses the interior vertex parameter “7x9” as in the example below. The checkerboard with set dimensions can be downloaded from here.
- A well lit 5m x 5m area clear of obstructions and check board patterns
- A monocular camera publishing images over ROS
1- Start a terminal in your GUI
2- Launch the ROS driver for your specific camera.
3- Make sure camera is publishing images over ROS. This can be tested by running:
ros2 topic list
4- This will show you all the topics published make sure that there is an image_raw topic /camera/image_raw. To confirm that its a real topic and actually publishing check topic hz:
ros2 topic hz /camera/image_raw
5- Start the camera calibration node
ros2 run camera_calibration cameracalibrator --size 7x9 --square 0.20 image:=/my_camera/image_raw camera:=/my_camera
Camera Name: -c, --camera_name name of the camera to appear in the calibration file Chessboard Options: You must specify one or more chessboards as pairs of --size and--square options. -p PATTERN, --pattern=PATTERN calibration pattern to detect - 'chessboard','circles', 'acircles','charuco' -s SIZE, --size=SIZE chessboard size as NxM, counting interior corners (e.g. a standard chessboard is 7x7) -q SQUARE, --square=SQUARE chessboard square size in meters ROS Communication Options: --approximate=APPROXIMATE allow specified slop (in seconds) when pairing images from unsynchronized stereo cameras --no-service-check disable check for set_camera_info services at startup Calibration Optimizer Options: --fix-principal-point fix the principal point at the image center --fix-aspect-ratio enforce focal lengths (fx, fy) are equal --zero-tangent-dist set tangential distortion coefficients (p1, p2) to zero -k NUM_COEFFS, --k-coefficients=NUM_COEFFS number of radial distortion coefficients to use (up to 6, default 2) --disable_calib_cb_fast_check uses the CALIB_CB_FAST_CHECK flag for findChessboardCorners This will open a calibration window which highlight the checkerboard.
6- In order to get a good calibration you will need to move the checkerboard around in the camera frame such that:
- checkerboard on the camera’s left, right, top and bottom of field of view
◦ X bar - left/right in field of view
◦ Y bar - top/bottom in field of view
◦ Size bar - toward/away and tilt from the camera
checkerboard filling the whole field of view
checkerboard tilted to the left, right, top and bottom (Skew)
7- As the checkerboard is moved around the 4 bars on the calibration sidebar increases in length. When all then the 4 bars are green and enough data is available for calibration the CALIBRATE button will light up. Click it to see the results. It takes around the minute for calibration to take place.
8- After the calibration is completed the save and commit buttons light up. And you can also see the result in terminal.
9-Press the save button to see the result. Data is saved to “/tmp/calibrationdata.tar.gz”
- 10-To use the the calibration file unzip the calibration.tar.gz
tar -xvf calibration.tar.gz
11-In the folder images used for calibration are available and also “ost.yaml” and “ost.txt”. You can use the yaml file which contains the calibration parameters as directed by the camera driver.