search

shiftlab-nanodrone / sparse-gslam

Code for paper Efficient 2D Graph SLAM for Sparse Sensing
MIT License
17 stars 4 forks source link

readme

Efficient 2D Graph SLAM for Sparse Sensing

This repository contains code for Efficient 2D Graph SLAM for Sparse Sensing. The paper can be accessed here.

Installation

We recommend Ubuntu 20.04 with ROS noetic, but it should also work on Ubuntu 18.04 with ROS melodic. Our code requires a C++14 capable compiler.

Prereqs

  1. Install dependencies using package manager:
sudo apt install ros-noetic-jsk-rviz-plugins ros-noetic-navigation ros-noetic-joy

  1. Follow the instruction on https://google-cartographer.readthedocs.io/en/latest/ to build and install google cartographer

  2. Clone the libg2o-release repository (https://github.com/ros-gbp/libg2o-release) and

    We use this repo rather than the latest g2o because g2o comes with its own version of ceres-solver, which may conflict with the version used by cartographer. This makes sure that they will not conflict.

    • checkout release/{your-ros-distro}/libg2o branch
    • in config.h.in, make sure that the macro #define G2O_DELETE_IMPLICITLY_OWNED_OBJECTS 0 is enabled we manage memories for edges and vertices ourselves. You will get segfault if you miss this step.
    • in CMakeLists.txt, search for BUILD_WITH_MARCH_NATIVE and make sure it is ON You may get segfault if you miss this step
    • follow the readme to build and install it
    • run sudo ldconfig command to update links

  3. Clone this repository and build

catkin_make -DCMAKE_BUILD_TYPE=Release
  1. Download datasets and evaluation scripts by running
cd src/sparse_gslam/datasets
./download.sh

Running our code

roslaunch sparse_gslam log_runner.launch dataset:={dataset_name}

where {dataset_name} is one of the directory names under src/sparse_gslam/datasets (e.g. intel-lab).

Compute SLAM Metrics

For aces, intel-lab and mit-killian, ground truths are available and SLAM metrics can be calculated. After running our code with the command above and waiting for it to finish, you can use our evaluation script to compute the metrics

cd src/sparse_gslam/datasets
./eval.sh {dataset_name}