Awesome
Isaac ROS DNN Inference
NVIDIA-accelerated DNN model inference ROS 2 packages using NVIDIA Triton/TensorRT for both Jetson and x86_64 with CUDA-capable GPU.
<div align="center"><img alt="bounding box for people detection" src="https://media.githubusercontent.com/media/NVIDIA-ISAAC-ROS/.github/main/resources/isaac_ros_docs/repositories_and_packages/isaac_ros_dnn_inference/isaac_ros_dnn_peoplenet.jpg/" width="300px"/> <img alt="segementation mask for people detection" src="https://media.githubusercontent.com/media/NVIDIA-ISAAC-ROS/.github/main/resources/isaac_ros_docs/repositories_and_packages/isaac_ros_dnn_inference/isaac_ros_dnn_inference_peoplesemsegnet.jpg/" width="300px"/></div>Webinar Available
Learn how to use this package by watching our on-demand webinar: Accelerate YOLOv5 and Custom AI Models in ROS with NVIDIA Isaac
Overview
Isaac ROS DNN Inference contains ROS 2 packages for performing DNN inference, providing AI-based perception for robotics applications. DNN inference uses a pre-trained DNN model to ingest an input Tensor and output a prediction to an output Tensor.
<div align="center"><a class="reference internal image-reference" href="https://media.githubusercontent.com/media/NVIDIA-ISAAC-ROS/.github/main/resources/isaac_ros_docs/repositories_and_packages/isaac_ros_dnn_inference/isaac_ros_dnn_inference_nodegraph.png/"><img alt="image" src="https://media.githubusercontent.com/media/NVIDIA-ISAAC-ROS/.github/main/resources/isaac_ros_docs/repositories_and_packages/isaac_ros_dnn_inference/isaac_ros_dnn_inference_nodegraph.png/" width="800px"/></a></div>Above is a typical graph of nodes for DNN inference on image data. The input image is resized to match the input resolution of the DNN; the image resolution may be reduced to improve DNN inference performance ,which typically scales directly with the number of pixels in the image. DNN inference requires input Tensors, so a DNN encoder node is used to convert from an input image to Tensors, including any data pre-processing that is required for the DNN model. Once DNN inference is performed, the DNN decoder node is used to convert the output Tensors to results that can be used by the application.
TensorRT and Triton are two separate ROS nodes to perform DNN inference. The TensorRT node uses TensorRT to provide high-performance deep learning inference. TensorRT optimizes the DNN model for inference on the target hardware, including Jetson and discrete GPUs. It also supports specific operations that are commonly used by DNN models. For newer or bespoke DNN models, TensorRT may not support inference on the model. For these models, use the Triton node.
The Triton node uses the Triton Inference Server, which provides a compatible frontend supporting a combination of different inference backends (e.g. ONNX Runtime, TensorRT Engine Plan, TensorFlow, PyTorch). In-house benchmark results measure little difference between using TensorRT directly or configuring Triton to use TensorRT as a backend.
Some DNN models may require custom DNN encoders to convert the input data to the Tensor format needed for the model, and custom DNN decoders to convert from output Tensors into results that can be used in the application. Leverage the DNN encoder and DNN decoder node(s) for image bounding box detection and image segmentation, or your own custom node(s).
[!Note] DNN inference can be performed on different types of input data, including audio, video, text, and various sensor data, such as LIDAR, camera, and RADAR. This package provides implementations for DNN encode and DNN decode functions for images, which are commonly used for perception in robotics. The DNNs operate on Tensors for their input, output, and internal transformations, so the input image needs to be converted to a Tensor for DNN inferencing.
Isaac ROS NITROS Acceleration
This package is powered by NVIDIA Isaac Transport for ROS (NITROS), which leverages type adaptation and negotiation to optimize message formats and dramatically accelerate communication between participating nodes.
Performance
Sample Graph<br/><br/> | Input Size<br/><br/> | AGX Orin<br/><br/> | Orin NX<br/><br/> | Orin Nano 8GB<br/><br/> | x86_64 w/ RTX 4060 Ti<br/><br/> | x86_64 w/ RTX 4090<br/><br/> |
---|---|---|---|---|---|---|
TensorRT Node<br/><br/><br/>DOPE<br/><br/> | VGA<br/><br/><br/><br/> | 48.1 fps<br/><br/><br/>24 ms @ 30Hz<br/><br/> | 17.9 fps<br/><br/><br/>56 ms @ 30Hz<br/><br/> | 13.1 fps<br/><br/><br/>82 ms @ 30Hz<br/><br/> | 98.3 fps<br/><br/><br/>13 ms @ 30Hz<br/><br/> | 296 fps<br/><br/><br/>5.1 ms @ 30Hz<br/><br/> |
Triton Node<br/><br/><br/>DOPE<br/><br/> | VGA<br/><br/><br/><br/> | 47.2 fps<br/><br/><br/>23 ms @ 30Hz<br/><br/> | 20.4 fps<br/><br/><br/>540 ms @ 30Hz<br/><br/> | 14.4 fps<br/><br/><br/>790 ms @ 30Hz<br/><br/> | 94.2 fps<br/><br/><br/>12 ms @ 30Hz<br/><br/> | 254 fps<br/><br/><br/>4.6 ms @ 30Hz<br/><br/> |
TensorRT Node<br/><br/><br/>PeopleSemSegNet<br/><br/> | 544p<br/><br/><br/><br/> | 460 fps<br/><br/><br/>4.1 ms @ 30Hz<br/><br/> | 348 fps<br/><br/><br/>6.1 ms @ 30Hz<br/><br/> | 238 fps<br/><br/><br/>7.0 ms @ 30Hz<br/><br/> | 685 fps<br/><br/><br/>2.9 ms @ 30Hz<br/><br/> | 675 fps<br/><br/><br/>3.0 ms @ 30Hz<br/><br/> |
Triton Node<br/><br/><br/>PeopleSemSegNet<br/><br/> | 544p<br/><br/><br/><br/> | 304 fps<br/><br/><br/>4.8 ms @ 30Hz<br/><br/> | 206 fps<br/><br/><br/>6.5 ms @ 30Hz<br/><br/> | –<br/><br/><br/><br/> | 677 fps<br/><br/><br/>2.2 ms @ 30Hz<br/><br/> | 619 fps<br/><br/><br/>1.9 ms @ 30Hz<br/><br/> |
DNN Image Encoder Node<br/><br/><br/><br/> | VGA<br/><br/><br/><br/> | 522 fps<br/><br/><br/>12 ms @ 30Hz<br/><br/> | 330 fps<br/><br/><br/>12 ms @ 30Hz<br/><br/> | –<br/><br/><br/><br/> | 811 fps<br/><br/><br/>6.6 ms @ 30Hz<br/><br/> | 822 fps<br/><br/><br/>6.4 ms @ 30Hz<br/><br/> |
Documentation
Please visit the Isaac ROS Documentation to learn how to use this repository.
Packages
Latest
Update 2024-09-26: Update for Isaac ROS 3.1