• Stars
    star
    288
  • Rank 139,621 (Top 3 %)
  • Language
    Shell
  • Created over 1 year ago
  • Updated about 2 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Index repo for Kimera-Multi system

Kimera-Multi

Kimera-Multi is a multi-robot system that (i) is robust and capable of identifying and rejecting incorrect inter and intra-robot loop closures resulting from perceptual aliasing, (ii) is fully distributed and only relies on local (peer-to-peer) communication to achieve distributed localization and mapping, and (iii) builds a globally consistent metric-semantic 3D mesh model of the environment in real-time, where faces of the mesh are annotated with semantic labels. Kimera-Multi is implemented by a team of robots equipped with visual-inertial sensors. Each robot builds a local trajectory estimate and a local mesh using Kimera. When communication is available, robots initiate a distributed place recognition and robust pose graph optimization protocol based on a novel distributed graduated non-convexity algorithm. The proposed protocol allows the robots to improve their local trajectory estimates by leveraging inter-robot loop closures while being robust to outliers. Finally, each robot uses its improved trajectory estimate to correct the local mesh using mesh deformation techniques.

Kimera-Multi

Installation

Note The experiments described by the authors in the paper were done on Ubuntu 18.04 and ROS Melodic. System has also been tested on Ubuntu 20.04 and ROS Noetic.

# Create workspace
mkdir -p catkin_ws/src
cd catkin_ws/src/
git clone [email protected]:MIT-SPARK/Kimera-Multi.git kimera_multi

# If you do not have these dependencies already
sudo bash kimera_multi/install/dependencies.sh

# For full install
vcs import . --input kimera_multi/kimera_multi.repos --recursive

cd ..
# Configure build options and build!
catkin config -a --cmake-args -DCMAKE_BUILD_TYPE=RelWithDebInfo -DGTSAM_TANGENT_PREINTEGRATION=OFF -DGTSAM_BUILD_WITH_MARCH_NATIVE=OFF -DOPENGV_BUILD_WITH_MARCH_NATIVE=OFF
catkin build --continue -s

System Architecture & Breakdown

Kimera-Multi System

For more in depth details about the system, we point the reader to our paper. Each robot runs an onboard system using the Robot Operating System (ROS). Inter-robot communication is performed in a fully peer-to-peer manner using a lightweight communication layer on top of the UDP protocol using the Remote Topic Manager. Kimera-VIO and Kimera-Semantics provide the odometric pose estimates and a reconstructed 3D mesh. The distributed front-end detects inter-robot loop closures by communicating visual Bag-of-Words (BoW) vectors and selected keyframes that contain keypoints and descriptors for geometric verification. The front-end is also responsible for incorporating the odometry and loop closures into a coarsened pose graph. The distributed back-end periodically optimizes the coarse pose graph using robust distributed optimization. Lastly, the optimized trajectory is used by each robot to correct its local 3D mesh.

Module-to-Repository Directory

Examples & Usage

To test Kimera-Multi on a single machine, we provided an example in the examples folder. First, install tmuxp, then, download the Campus-Outdoor data. Lastly, run the following to launch all the processes for all 6 robots:

CATKIN_WS=<path-to-catkin-ws> DATA_PATH=<path-to-campus-outdoor-data-folder> LOG_DIR=<path-to-log-folder> tmuxp load 1014-example.yaml

Note that this example only uses a single ROS master, and will most likely not work with intermittent communication. To run with separate ROS masters on separate machines, we will need to use the Remote Topic Manager, which is currently under-going the approval process for release. We will provide an additional example once the module is public.

Citation

If you found Kimera-Multi to be useful, we would really appreciate if you could cite our work:

  • [1] Y. Chang, Y. Tian, J. P. How and L. Carlone, "Kimera-Multi: a System for Distributed Multi-Robot Metric-Semantic Simultaneous Localization and Mapping," 2021 IEEE International Conference on Robotics and Automation (ICRA), Xi'an, China, 2021, pp. 11210-11218, doi: 10.1109/ICRA48506.2021.9561090.
@INPROCEEDINGS{chang21icra_kimeramulti,
  author={Chang, Yun and Tian, Yulun and How, Jonathan P. and Carlone, Luca},
  booktitle={2021 IEEE International Conference on Robotics and Automation (ICRA)}, 
  title={Kimera-Multi: a System for Distributed Multi-Robot Metric-Semantic Simultaneous Localization and Mapping}, 
  year={2021},
  volume={},
  number={},
  pages={11210-11218},
  doi={10.1109/ICRA48506.2021.9561090}
}
  • [2] Y. Tian, Y. Chang, F. Herrera Arias, C. Nieto-Granda, J. P. How and L. Carlone, "Kimera-Multi: Robust, Distributed, Dense Metric-Semantic SLAM for Multi-Robot Systems," in IEEE Transactions on Robotics, vol. 38, no. 4, pp. 2022-2038, Aug. 2022, doi: 10.1109/TRO.2021.3137751.
@ARTICLE{tian22tro_kimeramulti,
  author={Tian, Yulun and Chang, Yun and Herrera Arias, Fernando and Nieto-Granda, Carlos and How, Jonathan P. and Carlone, Luca},
  journal={IEEE Transactions on Robotics}, 
  title={Kimera-Multi: Robust, Distributed, Dense Metric-Semantic SLAM for Multi-Robot Systems}, 
  year={2022},
  volume={38},
  number={4},
  pages={2022-2038},
  doi={10.1109/TRO.2021.3137751}
}
  • [3] Y. Tian, Y. Chang, L. Quang, A. Schang, C. Nieto-Granda, J. P. How, and L. Carlone, "Resilient and Distributed Multi-Robot Visual SLAM: Datasets, Experiments, and Lessons Learned," arXiv preprint arXiv:2304.04362, 2023.
@ARTICLE{tian23arxiv_kimeramultiexperiments,
  author={Yulun Tian and Yun Chang and Long Quang and Arthur Schang and Carlos Nieto-Granda and Jonathan P. How and Luca Carlone},
  title={Resilient and Distributed Multi-Robot Visual SLAM: Datasets, Experiments, and Lessons Learned},
  year={2023},
  eprint={2304.04362},
  archivePrefix={arXiv},
  primaryClass={cs.RO}
}

Datasets

We have also released some real-life datasets collected on 8 robots on the MIT campus.

Acknowledgements

Kimera-Multi was supported in part by ARL DCIST, ONR, and MathWorks.

More Repositories

1

Kimera

Index repo for Kimera code
1,707
star
2

TEASER-plusplus

A fast and robust point cloud registration library
C++
1,607
star
3

Kimera-VIO

Visual Inertial Odometry with SLAM capabilities and 3D Mesh generation.
C++
1,459
star
4

Kimera-Semantics

Real-Time 3D Semantic Reconstruction from 2D data
C++
610
star
5

Hydra

C++
485
star
6

Kimera-RPGO

Robust Pose Graph Optimization
C++
428
star
7

Kimera-VIO-ROS

ROS wrapper for Kimera-VIO
C++
356
star
8

Loc-NeRF

Monte Carlo Localization using Neural Radiance Fields
Python
250
star
9

Khronos

Spatio-Temporal Metric-Semantic SLAM
129
star
10

Kimera-Multi-Data

A large-scale multi-robot dataset for multi-robot SLAM
115
star
11

CertifiablyRobustPerception

Certifiable Outlier-Robust Geometric Perception
MATLAB
104
star
12

PD-MeshNet

Primal-Dual Mesh Convolutional Neural Networks
Python
103
star
13

GlobalOptimizationTutorial

Hands-on Tutorial for Global Optimization in Matlab
MATLAB
103
star
14

GNC-and-ADAPT

Graduated Non-Convexity (GNC) and Adaptive Trimming (ADAPT) algorithms for outlier robust estimation
MATLAB
92
star
15

llm_scene_understanding

HTML
65
star
16

STRIDE

Solver for Large-Scale Rank-One Semidefinite Relaxations
MATLAB
63
star
17

VNAV-labs

Labs for MIT 16.485
C++
56
star
18

Kimera-VIO-ROS2

C++
35
star
19

Spark-DSG

Scene Graph API (C++ and Python)
C++
32
star
20

Kimera-VIO-Evaluation

Code to automatically evaluate and tune parameters for Kimera-VIO pipeline.
Python
31
star
21

Hydra-ROS

Hydra ROS Interface
C++
31
star
22

Kimera-Multi-LCD

C++
29
star
23

Kimera-PGMO

C++
29
star
24

estimation-contracts

MATLAB
25
star
25

pose-baselines

Jupyter Notebook
24
star
26

pose_graph_tools

C++
23
star
27

config_utilities

Automatic C++ config structs and tools.
C++
21
star
28

ROBIN

C++
21
star
29

C-3PO

Python
19
star
30

Kimera-Distributed

C++
19
star
31

neural_tree

Python
19
star
32

GlobalOptimization-ICCV2019

ICCV 2019 Tutorial: Global Optimization for Geometric Understanding with Provable Guarantees
TeX
14
star
33

FUSES

C++
11
star
34

robotRepresentations-RSS2023

Robot Representations Workshop @ RSS 2023
SCSS
7
star
35

ensemble_pose

Self-training for an ensemble of object pose estimators
Python
6
star
36

PACE

Index repo for the PACE project
6
star
37

CertifiablePerception-RSS2020

Workshop website on Certifiable Robot Perception for RSS2020
TeX
5
star
38

Longterm-Perception-WS

Workshop on Long-term Perception for Autonomy in Dynamic Human-shared Environments
HTML
4
star
39

PerceptionMonitoring

Python
3
star
40

ford-paper-params

Parameters for competitor pipelines for the Kimera Multicamera project
2
star
41

PAL-ICRA2020

Ruby
2
star
42

dbow2_catkin

CMake
1
star