Author: Luigi Freda
PLVS is a real-time system that leverages sparse SLAM, volumetric mapping, and 3D unsupervised incremental segmentation. PLVS stands for Points, Lines, Volumetric mapping, and Segmentation.
PLVS is available in two different versions.
- PLVS I: hosted in the branch
plvs1. It is based on ORB-SLAM2, and supports mono, stereo, and RGB-D cameras. - PLVS II: hosted in the
masterbranch. It is based on ORB-SLAM3, and also supports camera systems provided with IMUs.
Here you can find a list of the new features provided by PLVS. You can find further information and videos on this page and in the following document:
PLVS: A SLAM System with Points, Lines, Volumetric Mapping, and 3D Incremental Segmentation
Luigi Freda
Note: PLVS is an active project. This README is under construction and will be updated with further information and details as new improvements are released. Stay tuned!
The following procedures were tested under Ubuntu 20. If you don't have it, check rosdocker and use the noetic or noetic_cuda containers.
- Install basic dependencies:
$ ./install_dependencies.sh - Install OpenCV in a local folder:
$ ./install_local_opencv.sh - Build the PLVS framework:
$ ./build.sh
Under ROS noetic you can run:
$ ./build_ros_catkin.sh
to build the PLVS ROS workspace and deploy it into the ros_ws subfolder.
It should be easy to adapt the above procedures if you have a different OS or ROS version.
If you want to skip step 2, you can set the variables OpenCV_DIR and OPENCV_VERSION in config.sh with your local OpenCV path and version, respectively. However, this is not recommended.
Once everything is built, you can enter in the Scripts folder and test the different examples. For instance you can configure and run:
$ ./run_tum_rgbd.shfor TUM RGB-D datasets$ ./run_kitti_stereo.shfor KITTI datasets$ ./run_euroc_stereo_inertial.shfor Euroc datasets, stereo + inertial$ ./run_euroc_stereo.shfor Euroc datasets, only stereo$ ./run_tum_vi_stereo.shfor TUM VI datasets, only stereo$ ./run_tum_vi_stereo_inertial.shfor TUM VI datasets, stereo + inertial
In each of the above scripts, you have to configure (1) the DATASET_BASE_FOLDER, (2) the specific DATASET of interest, and (3) the used YAML configuration file. In particular, each YAML configuration file shows different sections with commented options. For a quick overview of the new features and their corresponding YAML options refer to new_features.md.
If you built the ROS workspace, you can use the scripts ros_xterm* to launch the PLVS ROS nodes. For instance, with the TUM datasets, run ros_xterm_tum_rgbd.sh.
You are welcome to contribute to the code base by using pull requests, reporting bugs, leaving comments, and proposing new features through issues. Feel free to get in touch: luigifreda(at)gmail(dot)com. Thank you!
We release PLVS under GPLv3 license. PLVS contains some modified libraries, each one coming with its license. Where nothing is specified, a GPLv3 license applies to the software.
Please cite our work if you use PLVS in your projects.