Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wh200720041/ssl_slam
SSL_SLAM: Lightweight 3-D Localization and Mapping for Solid-State LiDAR IEEE RA-L 2021
https://github.com/wh200720041/ssl_slam
robotics slam
Last synced: 4 days ago
JSON representation
SSL_SLAM: Lightweight 3-D Localization and Mapping for Solid-State LiDAR IEEE RA-L 2021
- Host: GitHub
- URL: https://github.com/wh200720041/ssl_slam
- Owner: wh200720041
- License: gpl-3.0
- Created: 2020-07-23T13:25:36.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-03-24T07:48:18.000Z (10 months ago)
- Last Synced: 2025-01-11T06:07:17.800Z (11 days ago)
- Topics: robotics, slam
- Language: C++
- Homepage:
- Size: 50.2 MB
- Stars: 506
- Watchers: 19
- Forks: 90
- Open Issues: 28
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SSL_SLAM
## Lightweight 3-D Localization and Mapping for Solid-State LiDAR (Intel Realsense L515 as an example)
### UPDATE: If you would like to enable save map and test localization separately, you can check this repo: [SSL_SLAM2](https://github.com/wh200720041/ssl_slam2)
This code is an implementation of paper "Lightweight 3-D Localization and Mapping for Solid-State LiDAR", accepted in IEEE Robotics and Automation Letters, 2021
A summary video demo can be found at [Video](https://youtu.be/Uy_2MKwUDN8)
**Modifier:** [Wang Han](http://wanghan.pro), Nanyang Technological University, Singapore
## 1. Solid-State Lidar Sensor Example
### 1.1 Scene reconstruction
### 1.2 SFM building example
### 1.3 Localization and Mapping with L515
## 2. Prerequisites
### 2.1 **Ubuntu** and **ROS**
Ubuntu 64-bit 20.04.
ROS Noetic. [ROS Installation](http://wiki.ros.org/ROS/Installation)
### 2.2. **Ceres Solver**
Follow [Ceres Installation](http://ceres-solver.org/installation.html).
### 2.3. **PCL**
Follow [PCL Installation](http://www.pointclouds.org/downloads/linux.html).
Tested with 1.8.1
### 2.4 **OctoMap**
Follow [OctoMap Installation](http://wiki.ros.org/octomap).
```
sudo apt-get install ros-noetic-octomap*
```
### 2.5. **Trajectory visualization**
For visualization purpose, this package uses hector trajectory sever, you may install the package by
```
sudo apt-get install ros-noetic-hector-trajectory-server
```
Alternatively, you may remove the hector trajectory server node if trajectory visualization is not needed
## 3. Build
### 3.1 Clone repository:
```
cd ~/catkin_ws/src
git clone https://github.com/wh200720041/ssl_slam.git
cd ..
catkin_make
source ~/catkin_ws/devel/setup.bash
```
### 3.2 Download test rosbag
You may download our [recorded data](https://drive.google.com/file/d/1wtsTLBo_hk1uh4V_LsyKbIkeyMXptVJp/view?usp=sharing) (5GB) if you dont have realsense L515, and by defult the file should be under home/user/Downloads
unzip the file
```
cd ~/Downloads
unzip ~/Downloads/L515_test.zip
```
### 3.3 Launch ROS
if you would like to create the map at the same time, you can run
```
roslaunch ssl_slam ssl_slam_mapping.launch
```
or create probability map
```
roslaunch ssl_slam ssl_slam_octo_mapping.launch
```
if only localization is required, you may refer to run
```
roslaunch ssl_slam ssl_slam.launch
```
## 4. Sensor Setup
If you have new Realsense L515 sensor, you may follow the below setup instructions
### 4.1 L515
### 4.2 Librealsense
Follow [Librealsense Installation](https://github.com/IntelRealSense/librealsense/blob/master/doc/installation.md)
### 4.3 Realsense_ros
Copy [realsense_ros](https://github.com/IntelRealSense/realsense-ros) package to your catkin folder
```
cd ~/catkin_ws/src
git clone https://github.com/IntelRealSense/realsense-ros.git
cd ..
catkin_make
```
### 4.4 Launch ROS
```
roslaunch ssl_slam ssl_slam_L515.launch
```
This runs `ssl_slam_mapping.launch` with live L515 data.
## 5. Citation
If you use this work for your research, you may want to cite the paper below, your citation will be appreciated
```
@article{wang2021lightweight,
author={H. {Wang} and C. {Wang} and L. {Xie}},
journal={IEEE Robotics and Automation Letters},
title={Lightweight 3-D Localization and Mapping for Solid-State LiDAR},
year={2021},
volume={6},
number={2},
pages={1801-1807},
doi={10.1109/LRA.2021.3060392}}
```