thor_devkit_realsense_rig_description#
Source code available on GitHub.
Overview#
The thor_devkit_realsense_rig_description package provides the URDF description and mesh for the rig that mounts three Intel RealSense cameras (D435/D455) on the Jetson Thor Developer Kit at known nominal positions.
Quickstart#
Set Up Development Environment#
Set up your development environment by following the instructions in getting started.
(Optional) Install dependencies for any sensors you want to use by following the sensor-specific guides.
Note
We strongly recommend installing all sensor dependencies before starting any quickstarts. Some sensor dependencies require restarting the development environment during installation, which will interrupt the quickstart process.
Build thor_devkit_realsense_rig_description#
Activate the Isaac ROS environment:
isaac-ros activateInstall the prebuilt Debian package:
sudo apt-get update
sudo apt-get install -y ros-lyrical-thor-devkit-realsense-rig-description
Clone the
sensor_mounting_rigrepository under${ISAAC_ROS_WS}/src:cd ${ISAAC_ROS_WS}/src && \ git clone -b release-5.1 https://github.com/NVIDIA-ISAAC-ROS/sensor_mounting_rig.git sensor_mounting_rig
Activate the Isaac ROS environment:
isaac-ros activateUse
rosdepto install the package’s dependencies:sudo apt-get update
rosdep update && rosdep install --from-paths ${ISAAC_ROS_WS}/src/sensor_mounting_rig/thor_devkit_realsense_rig_description --ignore-src -y
Build the package from source:
cd ${ISAAC_ROS_WS}/ && \ colcon build --symlink-install --packages-up-to thor_devkit_realsense_rig_description
Source the ROS workspace:
Note
Make sure to repeat this step in every terminal created inside the Isaac ROS environment. Because this package was built from source, the enclosing workspace must be sourced for ROS to be able to find the package’s contents.
source install/setup.bash
Run Launch File#
The nominal camera positions on the rig are described by these xacro files:
Continuing inside the Isaac ROS environment, load one of them and publish the camera relative positions and orientations by running the thor_devkit_realsense_rig_description.launch.py launch file:
ros2 launch thor_devkit_realsense_rig_description thor_devkit_realsense_rig_description.launch.py camera_model:=d455
Launch Arguments#
Launch Argument |
Type |
Default |
Description |
|---|---|---|---|
|
|
|
RealSense model that selects the nominal rig description. One of |
|
|
|
Path to a URDF file that replaces the nominal rig description. |
|
|
|
Path to a calibrated URDF file that overrides the nominal camera poses. |
For instructions on building the rig itself, refer to the assembly guide.