Tutorial for Bi3D with RealSense Camera
=======================================

Overview
------------

This tutorial walks through setting up a graph to
:ir_repo:`segment stereo image pairs <isaac_ros_depth_segmentation>`
from a `RealSense <https://www.intel.com/content/www/us/en/architecture-and-technology/realsense-overview.html>`_ camera.

.. note::

   This tutorial requires a compatible RealSense camera from
   the list of available
   :ref:`cameras <getting_started/hardware_setup/sensors/realsense_setup:Camera Compatibility>`.

Tutorial Walkthrough
--------------------

1. Complete the :doc:`RealSense setup tutorial </getting_started/hardware_setup/sensors/realsense_setup>`.
2. Complete the :doc:`Quickstart section </repositories_and_packages/isaac_ros_depth_segmentation/isaac_ros_bi3d/index>` for the ``isaac_ros_bi3d`` package.
3. Launch the Docker container using the ``run_dev.sh`` script:

   .. code:: bash

      cd ${ISAAC_ROS_WS}/src/isaac_ros_common && \
      ./scripts/run_dev.sh

4. Inside the container, build and source the workspace:

   .. code:: bash

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

5. Launch the pre-composed graph launch file and wait for 10 seconds:

   .. code:: bash

      ros2 launch isaac_ros_bi3d isaac_ros_bi3d_realsense.launch.py \
      featnet_engine_file_path:=/tmp/models/bi3d/bi3dnet_featnet.plan \
      segnet_engine_file_path:=/tmp/models/bi3d/bi3dnet_segnet.plan \
      max_disparity_values:=10 \
      image_height:=1080 \
      image_width:=1920

.. note::

   Modify ``image_height`` and ``image_width`` with the appropriate values if using other image sizes.