[Documentation] [TitleIndex] [WordIndex


The ZED Stereo Camera is a lightweight depth camera based on passive stereo vision. It outputs up to 2208x1242 high-resolution stereo video on USB 3.0, and can work in high-speed mode in VGA at 100 FPS. The ZED SDK computes a depth map of the environment on the GPU of the host machine at the frame rate of the camera. It also gives you access to a strong odometry that learn its environment, making it able to relocate itself at any moments.


Getting Started

Get the package

This package is a wrapper for the ZED SDK in order to use the ZED stereo Camera with ROS. It provides access to the ZED camera stereo images, depth map, 3D point cloud and 6-DOF tracking.

This package is designed to work with the ZED stereo camera and requires the installation of the ZED SDK. For more information: https://www.stereolabs.com

You can download the zed-ros-wrapper on Github: https://github.com/stereolabs/zed-ros-wrapper

Published topics


  1. Get the necessary Point Cloud Library dependencies:
    • sudo apt-get install libpcl1

    • sudo apt-get install ros-kinetic-pcl-ros (where you might want to change "kinetic" to the distro you use)

  2. Get the package from Github and put it in your catkin src folder

  3. Build the package from your catkin root folder
    • cd ~/catkin

    • catkin_make zed-ros-wrapper

    • source ./devel/setup.bash

Test the package

Open a terminal and enter the following command :

It will launch the zed-ros-wrapper, so make sure that your ZED camera is connected to your computer. Note that the ZED camera needs to be connected through an USB3.0 port to work at full speed.

To see the rectified image from the ZED camera, just enter the following command in an other terminal :

The easiest way to visualize ZED's topics is to use rviz http://wiki.ros.org/rviz:

You can also see the point could fused with the odometry by subscribing to the 'odom' topic (even in an other rviz or an other node).

To change your referential, use the 'Fixed Frame' parameter at the top-left of rviz.

Launch with a recorded SVO video

With the ZED you can record and play back a stereo video using the .svo file format. To record a video, just use the ZED Explorer as explained in the ZED documentation. https://www.stereolabs.com/developers/documentation/API/page2.html

To launch the zed-ros-wrapper with an SVO file, use the svo_file parameter in the command line at the launch of the package.

An SSD drive is recommended for real-time video capture and playback.

"svo_file" is just one of the parameters available in the package. For the full list of available parameters, please check the readme file on Github: https://github.com/stereolabs/zed-ros-wrapper/blob/master/README.md

Using the URDF file

The zed-ros-wraper provide the URDF model of the ZED to help you visualize and integrate the ZED in your robot. The topic name of the URDF description is zed_description.

Report an Issue

If you encounter an issue with the zed-ros-wrapper, please refer to the dedicated issue list on Github at https://github.com/stereolabs/zed-ros-wrapper/issues

2018-07-14 13:30