Attention

As of June 30, 2025, the Isaac ROS Buildfarm for Isaac ROS 2.1 on Ubuntu 20.04 Focal is no longer supported.

Due to an isolated infrastructure event, all ROS 2 Humble Debian packages that were previously built for Ubuntu 20.04 are no longer available in the Isaac Apt Repository. All artifacts for Isaac ROS 3.0 and later are built and maintained with a more robust pipeline.

Users are encouraged to migrate to the latest version of Isaac ROS. The source code for Isaac ROS 2.1 continues to be available on the release-2.1 branches of the Isaac ROS GitHub repositories.

The original documentation for Isaac ROS 2.1 is preserved below.

Tutorial With Zed

https://media.githubusercontent.com/media/NVIDIA-ISAAC-ROS/.github/main/resources/isaac_ros_docs/repositories_and_packages/isaac_ros_image_pipeline/zed_sgm.png/

Overview

This tutorial demonstrates how to perform stereo-camera-based reconstruction using a Zed camera and disparity_node.

Note

This tutorial requires a compatible ZED camera from the list of available cameras.

Tutorial Walkthrough

  1. Complete the Zed Setup Tutorial.

  2. Open a new terminal and launch the Docker container using the run_dev.sh script:

    cd ${ISAAC_ROS_WS}/src/isaac_ros_common && \
      ./scripts/run_dev.sh
    
  3. Build and source the workspace:

    cd /workspaces/isaac_ros-dev && \
      colcon build --symlink-install && \
      source install/setup.bash
    

    Note

    If you are not using the ZED2i camera, modify the camera_model variable in the launch file to zed, zed2, zed2i, zedm, zedx or zedxm. Also change the Fixed Frame in RViz to camera_model + _left_camera_optical_frame.

  4. Run the launch file, which launches the example, and wait for 10 seconds:

    ros2 launch isaac_ros_stereo_image_proc isaac_ros_stereo_image_pipeline_zed.launch.py