README for using the bumblebee_xb3 ros package
0. If you don't have camera calibration files, you can use the ones in
./calibration_files/ These need to be copied to the default directory
where ros stores camera calibration files, usually ~/.ros/camera_info/
1. Start ros:
----------------------------------------------------------------------
$ roscore
----------------------------------------------------------------------
2. In another terminal tab, launch the camera1394 driver node
(Ctrl+Shift+Tab to launch a new terminal tab and Alt+tab_number to move to a tab quickly)
-------------------------------------------------------------------------------------------------------------------
$ roslaunch ~/catkin_ws/src/bumblebee_xb3/launch/camera1394_24bit.launch
-------------------------------------------------------------------------------------------------------------------
For reference, the contents of the above launch file. It starts a camera1394 node with some parameters.
<!-- -*- mode: XML -*- -->
<launch>
<node pkg="camera1394" type="camera1394_node" name="camera1394_node" output="screen">
<param name="video_mode" value="format7_mode3" />
<param name="format7_color_coding" value="rgb8" />
<param name="bayer_pattern" value="gbrg" />
<param name="bayer_method" value="" />
<param name="frame_id" value="camera_frame" />
<param name="frame_rate" value="15.0" />
<param name="iso_speed" value="800" />
</node>
</launch>
once this node is launched, it will publish a interlaced (combined) bayered image which you can view by:
-----------------------------------------------------------------------------------------------------
$ rosrun rqt_image_view rqt_image_view image:=/camera/image_raw
-----------------------------------------------------------------------------------------------------
3. Next run the deinterlacer (& debayering) node (this package's node):
Note that this node only does deinterlacing. debayering is handled by
stereo_image_proc.
----------------------------------------------------------------------
$ rosrun bumblebee_xb3 bumblebee_xb3_node
----------------------------------------------------------------------
Now running
----------------------------------------------------------------------
$ rostopic list
----------------------------------------------------------------------
should show you a lot more image streams, which you can again view with rqt_image_view
4. Now start the stereo_image_proc node in any of the THREE stereo_camera namespaces, say:
-------------------------------------------------------------------------------------
$ ROS_NAMESPACE=/camera/stereo_camera_LC/ rosrun stereo_image_proc stereo_image_proc
-------------------------------------------------------------------------------------
You should see that the point cloud topic is now published
/camera/stereo_camera_LC/points2
5. To view the point cloud, start rviz:
----------------------------------------------------------------------
$ rosrun rviz rviz
----------------------------------------------------------------------
COMMENTS:
stereo_image_proc uses a lot of cpu resources. consider using stereo_image_proc_gpu
when it becomes available.
Steps 1-4 can be combined into a single launch file for convenience.