On GitHub, PRBonn/semantic_suma has picked up 1.0k stars, C++. SuMa++: Efficient LiDAR-based Semantic SLAM (Chen et al IROS 2019)
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
This repository contains the implementation of SuMa++, which generates semantic maps only using three-dimensional laser range scans.
Developed by Xieyuanli Chen and Jens Behley.
SuMa++ is built upon SuMa and RangeNet++. For more details, we refer to the original project websites SuMa and RangeNet++.
An example of using SuMa++:
Table of Contents
Introduction
Publication
Docker
Dependencies
Build
How to run
More Related Work
Frequently Asked Questions
License
Publication
If you use our implementation in your academic work, please cite the corresponding paper:
@inproceedings{chen2019iros,
author = {X. Chen and A. Milioto and E. Palazzolo and P. Giguère and J. Behley and C. Stachniss},
title = {{SuMa++: Efficient LiDAR-based Semantic SLAM}},
booktitle = {Proceedings of the IEEE/RSJ Int. Conf. on Intelligent Robots and Systems (IROS)},
pages = {4530--4537},
year = {2019},
url = {https://www.ipb.uni-bonn.de/wp-content/papercite-data/pdf/chen2019iros.pdf}
}
Docker
Thanks to the efforts of Hyunggi Chang, we have now a dockerized version of semantic_suma, which takes care of the proper setup.
You can build the Docker image with the provided Dockerfile, i.e.,
Note that it makes a volume located at kitti that should point to the KITTI files or another directory containing scans in the KITTI format. Follow the How to run instructions below to execute the binary.
The GUI is visualized via X11, so prior to starting a docker container, xhost +local:docker command should be used to provide access to the xhost from docker.
Dependencies
catkin
Qt5 >= 5.2.1
OpenGL >= 4.0
libEigen >= 3.2
gtsam >= 4.0 (tested with 4.0.0-alpha2)
In Ubuntu 16.04: Installing all dependencies should be accomplished by
To use SuMa++, you need to first build the rangenet_lib with the TensorRT and C++ interface.
For more details about building and using rangenet_lib you could find in rangenet_lib.
SuMa++
Clone the repository in the src directory of the same catkin workspace where you built the rangenet_lib:
Where you have to set OPENGL_VERSION to the supported OpenGL core profile version of your system, which you can query as follows:
$ glxinfo | grep "version"
server glx version string: 1.4
client glx version string: 1.4
GLX version: 1.4
OpenGL core profile version string: 4.3.0 NVIDIA 367.44
OpenGL core profile shading language version string: 4.30 NVIDIA [...]
OpenGL version string: 4.5.0 NVIDIA 367.44
OpenGL shading language version string: 4.50 NVIDIA
Here the line OpenGL core profile version string: 4.3.0 NVIDIA 367.44 is important and therefore you should use -DOPENGL_VERSION = 430. If you are unsure you can also leave it on the default version 330, which should be supported by all OpenGL-capable devices.
If you have a NVIDIA device, like a Geforce or Quadro graphics card, you should also activate the NVIDIA extensions using -DENABLE_NVIDIA_EXT=YES for info about the current GPU memory usage of the program.
After this setup steps, you can build with catkin build, since the configuration has been saved to your current Catkin profile (therefore, --save-config was needed).
Now the project root directory (e.g. ~/catkin_ws/src/semantic_suma) should contain a bin directory containing the visualizer.
How to run
Important Notice
Before running SuMa++, you need to first build the rangenet_lib and download the pretrained model.
You need to specify the model path in the configuration file in the config/ folder.
For the first time using, rangenet_lib will take several minutes to build a .trt model for SuMa++.
SuMa++ now can only work with KITTI dataset, since the semantic segmentation may not generalize well in other environments.
To use SuMa++ with your own dataset, you may finetune or retrain the semantic segmentation network.
All binaries are copied to the bin directory of the source folder of the project. Thus,
run visualizer in the bin directory by ./visualizer,
open a Velodyne directory from the KITTI Visual Odometry Benchmark and select a ".bin" file,
start the processing of the scans via the "play button" in the GUI.
More Related Work
OverlapNet - Loop Closing for 3D LiDAR-based SLAM
This repo contains the code for our RSS2020 paper: OverlapNet - Loop Closing for 3D LiDAR-based SLAM.
OverlapNet is a modified Siamese Network that predicts the overlap and relative yaw angle of a pair of range images generated by 3D LiDAR scans, which can be used for place recognition and loop closing.
Overlap-based LiDAR Global Localization
This repo contains the code for our IROS2020 paper: Learning an Overlap-based Observation Model for 3D LiDAR Localization.
It uses the OverlapNet to train an observation model for Monte Carlo Localization and achieves global localization with 3D LiDAR scans.
Frequently Asked Questions
visualizer segmentation fault
Different semantic results of suma++
How do I save the global map?
License
Copyright 2019, Xieyuanli Chen, Jens Behley, Cyrill Stachniss, Photogrammetry and Robotics Lab, University of Bonn.
This project is free software made available under the MIT License. For details see the LICENSE file.
No homepage URL was recorded for PRBonn/semantic_suma in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
How active is development on PRBonn/semantic_suma?
The most recent commit recorded on PRBonn/semantic_suma was 2.7 years ago, based on the GitHub push timestamp. The repository has 206 forks — one of the better signals of community interest.
Is PRBonn/semantic_suma open source?
Yes — PRBonn/semantic_suma ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/PRBonn/semantic_suma.
What license does PRBonn/semantic_suma use?
PRBonn/semantic_suma is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
What topics is PRBonn/semantic_suma associated with?
GitHub's repository topics for PRBonn/semantic_suma: "3d-lidar", "lidar", "rangenet-lib", "semantic", "slam", "suma", "suma-plus-plus". TopGit's editorial category is open-source.
Where do I read more about PRBonn/semantic_suma?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/PRBonn/semantic_suma is the definitive source.
Read full README in the tab above.
Curious whether semantic_suma is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about semantic_suma.