Certifiably Correct Range-Aided SLAM (CORA)

This is the official repository for the paper "Certifiably Correct Range-Aided SLAM" by Alan Papalia, Andrew Fishberg, Brendan O'Neill, Jonathan P. How, David M. Rosen and John J. Leonard.

If you prefer to work in MATLAB, you can look at our (deprecated) implementation in cora-matlab.

Quick Demo

Here you can see CORA solving the Plaza 2 data set from a random initialization! You can recreate this with our example in examples/cora_vis_tests.cpp by uncommenting line 12 and switching the filepath to "./bin/example_data/factor_graph.pyfg");

Plaza 2

Building

Install dependencies

sudo apt-get install build-essential cmake-gui libeigen3-dev liblapack-dev libblas-dev libsuitesparse-dev -y

Install submodules and build with CMake

git clone git@github.com:MarineRoboticsGroup/cora-plus-plus.git
cd cora-plus-plus
git submodule update --init
mkdir build
cd build
cmake ..
make -j

Usage

For now look in our examples/ directory for how to use this library.

If you want to inspect the data we have, you can use the PyFactorGraph library. We have set up a small python script examples/data_viz.py to help you visualize the date, but you will need to install the PyFactorGraph library to use it.

pip install git+https://github.com/MarineRoboticsGroup/PyFactorGraph
cd examples
python data_viz.py

Below is our visualization of the "Single Drone" data set we use in our paper. We visualize both the odometry train and the ground truth position of the drone. Range measurements are shown with the dashed grey lines between the drone and the ground station.

https://github.com/MarineRoboticsGroup/cora/assets/17442843/05fdf949-3e23-4f3a-83a3-8eb1e706c2e5

Contributing

Any contributions should pass all checks in our .pre-commit-config.yaml file. To install the pre-commit hooks, run pre-commit install in the root directory of this repository.

You may need to install some dependencies to get the pre-commit hooks to work.

pip install pre-commit
sudo apt-get install cppcheck
cd /path/to/cora
pre-commit install

Let there be Viz

To build with visualization there is a bit more set up needed. The following terminal commands should get you up and running with visualization.

# install Pangolin
git clone git@github.com:stevenlovegrove/Pangolin.git
cd Pangolin
sudo git submodule update --init
git checkout d484494 # this is the most recent commit that worked for everything
mkdir build
cd build
cmake ..
make -j
sudo make install

# install GTSAM 4.2
sudo add-apt-repository ppa:borglab/gtsam-release-4.2
sudo apt-get update
sudo apt-get install libgtsam-dev libgtsam-unstable-dev

Code Profiling

Additionally, if you want to run profiling you will need to install the Google Performance Tools

sudo apt-get install libgoogle-perftools-dev google-perftools graphviz

With some help from our friends

This implementation relies heavily on this highly performant optimization library by David M. Rosen!

Contributors

References

If you use this code in your research, please cite the following paper:

@article{papalia2023certifiably,
  title={Certifiably Correct Range-Aided SLAM},
  author={Papalia, Alan and Fishberg, Andrew and O'Neill, Brendan W. and How, Jonathan P. and Rosen, David M. and Leonard, John J.},
  journal={arXiv preprint arXiv:2302.11614},
  year={2023}
}

Troubleshooting

Error error while loading shared libraries: libpango_windowing.so: cannot open shared object file: No such file or directory

Solution: run sudo ldconfig

MarineRoboticsGroup / cora

readme