KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

isaac_ros_map_localization

★ 80 Open GitHub ↗

NVIDIA-accelerated global localization

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Isaac ROS Map Localization

NVIDIA-accelerated Map localization.

## Overview

The Isaac ROS Map Localization module contains ROS 2 packages for lidar
processing to estimate poses relative to a map. The Occupancy Grid
Localizer processes a planar range scan to estimate pose in an occupancy
grid map; this occurs in less than 1 second for most maps. This initial
pose can be used to bootstrap navigation for mobile robots and has been
integrated and tested with Nav2. This can remove the need for upwards of
30 seconds to [manually estimate the position and
direction](https://youtu.be/IrJmuow1r7g?t=1029) of a robot with RViz,
for example.

The Occupancy Grid Localizer is designed to work with planar and 3D
LIDARs. It uses
[Flatscan](https://github.com/NVIDIA-ISAAC-ROS/isaac_ros_common/blob/main/isaac_ros_pointcloud_interfaces/msg/FlatScan.msg)
for input to the GPU-accelerated computation estimating pose.
[Flatscan](https://github.com/NVIDIA-ISAAC-ROS/isaac_ros_common/blob/main/isaac_ros_pointcloud_interfaces/msg/FlatScan.msg)
allows for representation of 3D LIDARs, which have variable angular
increments between multiple beams.

LaserScan to Flatscan provides conversion from
[LaserScan](https://github.com/ros2/common_interfaces/blob/humble/sensor_msgs/msg/LaserScan.msg),
which by definition has [equal angle
increment](https://github.com/ros2/common_interfaces/blob/humble/sensor_msgs/msg/LaserScan.msg#L16)
between beams, to
[Flatscan](https://github.com/NVIDIA-ISAAC-ROS/isaac_ros_common/blob/main/isaac_ros_pointcloud_interfaces/msg/FlatScan.msg).

PointCloud to FlatScan provides conversion from
[pointcloud](https://github.com/ros2/common_interfaces/blob/humble/sensor_msgs/msg/PointCloud2.msg)
output from 3D LIDARs to
[Flatscan](https://github.com/NVIDIA-ISAAC-ROS/isaac_ros_common/blob/main/isaac_ros_pointcloud_interfaces/msg/FlatScan.msg).

> [!Note]
> Localization can be performed multiple times during
> navigation.

> [!Note]
> The input FlatScan Message header/frame_id is
> used to get the transform of the lidar with respect to the robot
> base_link frame.

> [!Note]
> The output `localization_result` is the
> transform of `base_link` with respect to the frame specified in the
> `loc_result_frame` (map) ROS parameter.

> [!Note]
> Localization can
> be triggered in one of two ways:

> 1. Buffer FlatScan messages received on a topic and trigger the
>    localization using an `std_srvs/Empty` service call.
> 2. Trigger localization every time a FlatScan message is sent to a
>    topic.

Refer to the [Isaac ROS Occupancy Grid Localizer/Usage section](https://nvidia-isaac-ros.github.io/repositories_and_packages/isaac_ros_map_localization/isaac_ros_occupancy_grid_localizer/index.html) for more details.

## Isaac ROS NITROS Acceleration

This package is powered by [NVIDIA Isaac Transport for ROS (NITROS)](https://developer.nvidia.com/blog/improve-perception-performance-for-ros-2-applications-with-nvidia-isaac-transport-for-ros/), which leverages type adaptation and negotiation to optimize message formats and dramatically accelerate communication between participating nodes.

## Performance

| Sample Graph | Input Size | AGX Orin | Orin NX | Orin Nano Super 8GB | x86_64 w/ RTX 4090 |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Occupancy Grid Localizer Node](https://github.com/NVIDIA-ISAAC-ROS/isaac_ros_benchmark/blob/main/benchmarks/isaac_ros_occupancy_grid_localizer_benchmark/scripts/isaac_ros_grid_localizer_node.py) | ~50 sq. m | [19.6 fps](https://github.com/NVIDIA-ISAAC-ROS/isaac_ros_benchmark/blob/main/results/isaac_ros_grid_localizer_node-agx_orin.json) 57 ms @ 30Hz | [8.36 fps](https://github.com/NVIDIA-ISAAC-ROS/isaac_ros_benchmark/blob/main/results/isaac_ros_grid_localizer_node-orin_nx.json) 130 ms @ 30Hz | [9.02 fps](https://github.com/NVIDIA-ISAAC-ROS/isaac_ros_benchmark/blob/main/results/isaac_ros_grid_localizer_node-orin_nano.json) 120 ms @ 30Hz | [50.1 fps](https://github.com/NVIDIA-ISAAC-ROS/isaac_ros_benchmark/blob/main/results/isaac_ros_grid_localizer_node-x86-4090.json) 8.5 ms @ 30Hz |

---

## Documentation

Please visit the [Isaac ROS Documentation](https://nvidia-isaac-ros.github.io/repositories_and_packages/isaac_ros_map_localization/index.html) to learn how to use this repository.

---

## Packages

* [`isaac_ros_occupancy_grid_localizer`](https://nvidia-isaac-ros.github.io/repositories_and_packages/isaac_ros_map_localization/isaac_ros_occupancy_grid_localizer/index.html)
  * [Quickstart](https://nvidia-isaac-ros.github.io/repositories_and_packages/isaac_ros_map_localization/isaac_ros_occupancy_grid_localizer/index.html#quickstart)
  * [Try More Examples](https://nvidia-isaac-ros.github.io/repositories_and_packages/isaac_ros_map_localization/isaac_ros_occupancy_grid_localizer/index.html#try-more-examples)
  * [Troubleshooting](https://nvidia-isaac-ros.github.io/repositories_and_packages/isaac_ros_map_localization/isaac_ros_occupancy_grid_localizer/index.html#troubleshooting)
  * [API](https://nvidia-isaac-ros.github.io/repositories_and_packages/isaac_ros_map_localization/isaac_ros_occupancy_grid_localizer/index.html#api)
* [`isaac_ros_pointcloud_utils`](https://nvidia-isaac-ros.github.io/repositories_and_packages/isaac_ros_map_localization/isaac_ros_pointcloud_utils/index.html)
  * [Overview](https://nvidia-isaac-ros.github.io/repositories_and_packages/isaac_ros_map_localization/isaac_ros_pointcloud_utils/index.html#overview)
  * [API](https://nvidia-isaac-ros.github.io/repositories_and_packages/isaac_ros_map_localization/isaac_ros_pointcloud_utils/index.html#api)

## Latest

Update 2024-12-10: Update to be compatible with JetPack 6.1

isaac_ros_map_localization

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README