Skip to content

A universal LiDAR and radar driver for ROS 2, supporting Hesai, Velodyne, Robosense and Continental sensors.

License

Notifications You must be signed in to change notification settings

tier4/nebula

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date
Nov 12, 2024
Nov 11, 2024
Nov 25, 2024
Nov 8, 2024
Nov 8, 2024
Nov 30, 2024
Sep 24, 2024
Dec 2, 2024
Oct 2, 2024
Nov 8, 2024
Jun 26, 2024
Jun 26, 2024
Nov 20, 2024
Sep 26, 2024
Sep 18, 2024
Dec 17, 2021
Oct 1, 2024
May 25, 2023
Jun 26, 2024
Mar 7, 2023
Jun 15, 2023
Oct 3, 2024
Jun 26, 2024
Mar 7, 2023
Jun 26, 2024
Mar 7, 2023
Dec 17, 2021
Nov 11, 2024
Sep 6, 2024
Nov 12, 2024
Nov 11, 2024
Mar 7, 2023

Repository files navigation

Nebula

build-and-test documentation codecov

Welcome to Nebula, the universal sensor driver

Nebula is a sensor driver platform that is designed to provide a unified framework for as wide a variety of devices as possible. While it primarily targets Ethernet-based LiDAR sensors, it aims to be easily extendable to support new sensors and interfaces. Nebula works with ROS 2 and is the recommended sensor driver for the Autoware project.

Documentation

We recommend you get started with the Nebula Documention. Here you will find information about the background of the project, how to install and use with ROS 2, and also how to add new sensors to the Nebula driver.

To build and serve the documentation locally, see the build steps further below.

Quick start

Nebula builds with ROS 2 Galactic and Humble.

Note

Boost version 1.74.0 or later is required. A manual install may be required in Ubuntu versions earlier than 22.04.

To build Nebula run the following commands in your workspace:

# In workspace
git clone https://github.com/tier4/nebula.git
cd nebula
# Import dependencies
vcs import < build_depends.repos
rosdep install --from-paths . --ignore-src -y -r
# Build Nebula
colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=Release -DCMAKE_EXPORT_COMPILE_COMMANDS=1

(optional) To build and serve the documentation, run the following commands in your workspace:

cd src
pip3 install -r docs/requirements.txt
mkdocs serve

To launch Nebula as a ROS 2 node with default parameters for your sensor model:

ros2 launch nebula_ros *sensor_vendor_name*_launch_all_hw.xml sensor_model:=*sensor_model_name*

For example, for a Hesai Pandar40P sensor:

ros2 launch nebula_ros hesai_launch_all_hw.xml sensor_model:=Pandar40P