Tutorial for Freespace Segmentation with Isaac Sim

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

Overview

This tutorial demonstrates how to use a Isaac Sim and isaac_ros_bi3d_freespace to create a local occupancy grid.

Tutorial Walkthrough

  1. Complete the Isaac ROS Freespace Segmentation quickstart.

  2. Install and launch Isaac Sim following the steps in the Isaac ROS Isaac Sim Setup Guide

  3. Press Play to start publishing data from Isaac Sim.

    https://media.githubusercontent.com/media/NVIDIA-ISAAC-ROS/.github/main/resources/isaac_ros_docs/getting_started/isaac_sim_sample_scene.png/
  4. Open a second terminal and attach to the container:

    cd ${ISAAC_ROS_WS}/src/isaac_ros_common && \
    ./scripts/run_dev.sh
    
  5. In the second terminal, start the isaac_ros_bi3d node using the launch files:

    ros2 launch isaac_ros_bi3d_freespace isaac_ros_bi3d_freespace_isaac_sim.launch.py \
    featnet_engine_file_path:=${ISAAC_ROS_WS}/isaac_ros_assets/models/bi3d_proximity_segmentation/featnet.plan \
    segnet_engine_file_path:=${ISAAC_ROS_WS}/isaac_ros_assets/models/bi3d_proximity_segmentation/segnet.plan \
    max_disparity_values:=32
    

    You should see a RViz window, as shown below:

    https://media.githubusercontent.com/media/NVIDIA-ISAAC-ROS/.github/main/resources/isaac_ros_docs/repositories_and_packages/isaac_ros_freespace_segmentation/Isaac_sim_rviz.png/
  6. Optionally, you can run the visualizer script to visualize the disparity image:

    ros2 run isaac_ros_bi3d isaac_ros_bi3d_visualizer.py --disparity_topic bi3d_mask
    
    https://media.githubusercontent.com/media/NVIDIA-ISAAC-ROS/.github/main/resources/isaac_ros_docs/repositories_and_packages/isaac_ros_freespace_segmentation/Visualizer_isaac_sim.png/