Skip to content

Commit 19de7b5

Browse files
improve stereo calibration tutorial (backport #1065) (#1067)
* make topic names consistent by removing the `my_` prefix on some topics * show the output of `ros2 service list` so that service names are more clear * explain what left/right/left_camera/right_camera actually mean<hr>This is an automatic backport of pull request #1065 done by [Mergify](https://mergify.com). Co-authored-by: Michael Ferguson <mfergs7@gmail.com>
1 parent c3baf0d commit 19de7b5

File tree

1 file changed

+15
-2
lines changed

1 file changed

+15
-2
lines changed

camera_calibration/doc/tutorial_stereo.rst

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,21 +34,34 @@ Finally make sure your camera is publishing images. For instance:
3434
If you have multiple cameras or are running the driver in its own
3535
namespace, your topic names may differ.
3636

37+
Most cameras will also support a `set_camera_info` service:
38+
39+
.. code-block:: bash
40+
41+
$ ros2 service list | grep stereo
42+
43+
/stereo/left/set_camera_info
44+
/stereo/right/set_camera_info
45+
3746
Start the Calibration
3847
---------------------
39-
To start the calibration you will need to load the image topics
48+
To start the calibration you will need to remap the image topics
4049
that will be calibrated:
4150

4251
.. code-block:: bash
4352
44-
$ ros2 run camera_calibration cameracalibrator --approximate 0.1 --size 8x6 --square 0.108 right:=/stereo/right/image_raw left:=/my_stereo/left/image_raw right_camera:=/my_stereo/right left_camera:=/my_stereo/left
53+
$ ros2 run camera_calibration cameracalibrator --approximate 0.1 --size 8x6 --square 0.108 right:=/stereo/right/image_raw left:=/stereo/left/image_raw right_camera:=/stereo/right left_camera:=/stereo/left
4554
4655
The ``--approximate`` option allows the camera calibrator to work
4756
with images that do not have the exact same timestamp. Currently
4857
it is set to 0.1 seconds. In this case, as long as the timestamp
4958
difference is less than 0.1 seconds, the calibrator will run with
5059
no problem.
5160

61+
The `left` and `right` namespaces are used to remap the `image_raw`
62+
and `camera_info` topics, while the `left_camera` and `right_camera`
63+
namespaces are used for the optional `set_camera_info` service.
64+
5265
This will open up the calibration window which will highlight the
5366
checkerboard, you will not see any images in the calibration
5467
window until a checkerboard is present:

0 commit comments

Comments
 (0)