Tutorial: Stereo Camera Configurations for Isaac Perceptor#

Isaac Perceptor supports various stereo camera configurations. They configure how the different camera images are processed in the Isaac Perceptor algorithms.

Configuration Description#

The following table lists all stereo camera configurations and specifies the corresponding downstream pipeline:

Configuration Name

ESS + Nvblox

cuVSLAM

People

front_configuration

Front: Full at 30 Hz

Front

front_people_configuration

Front: Full at 30 Hz

Front

Front

front_left_right_configuration

Front: Full at 30 Hz

Left/Right: Light at 15 Hz

Front/Left/Right

Additional information:

  • Front/Left/Right denote the stereo cameras mounted on either Nova Orin Developer Kit or Nova Carter.

  • The terms Full and Light correspond to different versions of the ESS DNN model.

  • The Light ESS DNN model is expected to perform worse than the Full ESS DNN model, example including flickering detection of 10cm high pallet at 3 meters away.

  • The People column refers to the people reconstruction mode of nvblox.

Note

When enabling wheel odometry with the enable_wheel_odometry on Nova Carter, visual SLAM is automatically disabled on all cameras.

Selecting a Configuration for Isaac Perceptor#

When running Isaac Perceptor, the stereo camera configuration can be specified using the stereo_camera_configuration argument:

ros2 launch <"platform name">_bringup perceptor.launch.py \
    stereo_camera_configuration:=<"configuration name">

where “platform name” is either nova_developer_kit or nova_carter, depending on the platform you are running Isaac Perceptor on:

To access all available sensor configurations, use the --show-args argument, for example:

ros2 launch <"platform name">_bringup perceptor.launch.py --show-args

The following table lists the stereo camera configuration compatibility for the Isaac Perceptor tutorials on Nova Carter and Nova Orin Developer Kit platforms:

Configuration Name

Nova Carter

Nova Orin Developer Kit

front_configuration

front_people_configuration

front_left_right_configuration

Selecting a Configuration for Autonomous Navigation#

The stereo_camera_configuration argument can be used similarly in the navigation tutorials:

ros2 launch <"platform name">_bringup navigation.launch.py \
    stereo_camera_configuration:=<"configuration name">

Tutorials for autonomous navigation are available for Nova Carter, Nova Orin Developer Kit and Isaac Sim:

The following table lists the stereo camera configuration compatibility for the Autonomous Navigation tutorials with Nova Carter, Nova Orin Developer Kit and Isaac Sim:

Configuration Name

Nova Carter

Nova Orin Developer Kit

Isaac Sim

front_configuration

front_people_configuration

front_left_right_configuration

no_camera (see note below)

Note

If you want to run Autonomous Navigation with lidar perception only, you can disable Isaac Perceptor by setting the configuration to no_camera. This will also require that you set enable_wheel_odometry:=True. Ensure you have access to lidar and wheel odometry while running with no_camera, and topic names are configured correctly.