Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/baidu/ICE-BA


https://github.com/baidu/ICE-BA

Last synced: 1 day ago
JSON representation

Awesome Lists containing this project

README 

        
# ICE-BA

## ICE-BA: Incremental, Consistent and Efficient Bundle Adjustment for Visual-Inertial SLAM  

We present ICE-BA, an incremental, consistent and efficient bundle adjustment for visual-inertial SLAM, which takes feature tracks, IMU measurements and optionally the loop constraints as input, performs in parallel both local BA over the sliding window and global BA over all keyframes, and outputs camera pose and updated map points for each frame in real-time. The main contributions include:  

- a new BA solver that leverages the incremental nature of SLAM measurements to achieve more than 10x efficiency compared to the state-of-the-arts.  

- a new relative marginalization algorithm that resolves the conflicts between sliding window marginalization bias and global loop closure constraints.  



Beside the backend solver, the library also provides an optic flow based frontend, which can be easily replaced by other more complicated frontends like ORB-SLAM2.  



The original implementation of our ICE-BA is at https://github.com/ZJUCVG/EIBA, which only performs global BA and does not support IMU input.  



**Authors:** Haomin Liu, Mingyu Chen, Yingze Bao, Zhihao Wang  

**Related Publications:**  

Haomin Liu, Mingyu Chen, Guofeng Zhang, Hujun Bao and Yingze Bao. ICE-BA: Incremental, Consistent and Efficient Bundle Adjustment for

Visual-Inertial SLAM. (Accepted by CVPR 2018).**[PDF](http://openaccess.thecvf.com/content_cvpr_2018/papers/Liu_ICE-BA_Incremental_Consistent_CVPR_2018_paper.pdf)**.  

Haomin Liu, Chen Li, Guojun Chen, Guofeng Zhang, Michael Kaess and Hujun Bao. Robust Keyframe-based Dense SLAM with an RGB-D Camera [J]. arXiv preprint arXiv:1711.05166, 2017. [arXiv report].**[PDF](https://arxiv.org/abs/1711.05166)**.  



## 1. License

Licensed under the Apache License, Version 2.0.  

Refer to LISENCE for more details.



## 2. Prerequisites

We have tested the library in **Ubuntu 14.04** and **Ubuntu 16.04**.  

The following dependencies are needed:

### boost

sudo apt-get install libboost-dev libboost-thread-dev libboost-filesystem-dev 



### Eigen

sudo apt-get install libeigen3-dev



### Glog

https://github.com/google/glog



### Gflags

https://github.com/gflags/gflags



### OpenCV

We use OpenCV 3.0.0.  

https://opencv.org/



### Yaml

https://github.com/jbeder/yaml-cpp



### brisk

https://github.com/gwli/brisk



## 3. Build

cd ice-ba  

chmod +x build.sh  

./build.sh



## 4. Run

We provide examples to run ice-ba with [EuRoC dataset](https://projects.asl.ethz.ch/datasets/doku.php?id=kmavvisualinertialdatasets#downloads).  



### run ICE-BA stereo

Run ICE-BA in stereo mode. Please refer to scripts/run_ice_ba_stereo.sh for more details about how to run the example.  



### run ICE-BA monocular

Run ICE-BA in monocular mode. Please refer to scripts/run_ice_ba_mono.sh for more details about how to run the example.  



### run back-end only

Front-end results can be saved into files. Back-end only mode loads these files and runs backend only.  

Please refer to scripts/run_backend_only.sh for more details about how to run the example.  



## 5. Contribution

You are very welcome to contribute to ICE-BA.

Baidu requires the contributors to e-sign [CLA (Contributor License Agreement)](https://gist.github.com/tanzhongyibidu/6605bdef5f7bb03b9084dd8fed027037) before making a Pull Request.  We have the CLA binding to Github so it will pop up before creating a PR.