Skip to content

Commit 342cba6

Browse files
PeiliangLiqintonguav
authored andcommitted
Add code; Modify README.md
1 parent 7e15ff4 commit 342cba6

File tree

1,109 files changed

+490574
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

1,109 files changed

+490574
-0
lines changed

.gitignore

+28
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
VINS_ThirdPartyLib/opencv2.framework
2+
3+
.DS_Store
4+
*.swp
5+
# Xcode
6+
#
7+
# gitignore contributors: remember to update Global/Xcode.gitignore, Objective-C.gitignore & Swift.gitignore
8+
9+
## Build generated
10+
build/
11+
DerivedData/
12+
13+
## Various settings
14+
*.pbxuser
15+
!default.pbxuser
16+
*.mode1v3
17+
!default.mode1v3
18+
*.mode2v3
19+
!default.mode2v3
20+
*.perspectivev3
21+
!default.perspectivev3
22+
xcuserdata/
23+
24+
## Other
25+
*.moved-aside
26+
*.xccheckout
27+
*.xcscmblueprint
28+
>>>>>>> [Unity] Add Unity project

LICENSE

+674
Large diffs are not rendered by default.

README.md

+51
Original file line numberDiff line numberDiff line change
@@ -1 +1,52 @@
11
# VINS-Mobile
2+
## Monocular Visual-Inertial State Estimator on Mobile Phones
3+
4+
VINS-Mobile is a real-time monocular visual-inertial state estimator developed by members of the [HKUST Aerial Robotics Group](http://uav.ust.hk/). It runs on compatible iOS devices, and provides localization services for augmented reality (AR) applications. It is also tested for state estimation and feedback control for autonomous drones. VINS-Mobile uses sliding window optimization-based formulation for providing high-accuracy visual-inertial odometry with automatic initialization and failure recovery. The accumulated odometry errors are corrected in real-time using global pose graph SLAM. An AR demonstration is provided to showcase its capability.
5+
6+
**Authors:** Peiliang LI, Tong QIN, Zhenfei YANG, Kejie QIU, and [Shaojie SHEN](http://www.ece.ust.hk/ece.php/profile/facultydetail/eeshaojie) from the [HKUST Aerial Robotics Group](http://uav.ust.hk/)
7+
8+
**Videos:** https://www.youtube.com/watch?v=qazzGT84Scc&feature=youtu.be
9+
10+
**Related Papers:**
11+
* [**Monocular Visual-Inertial State Estimation for Mobile Augmented Reality**](http://www.ece.ust.hk/~eeshaojie/ismar2017peiliang.pdf), *P.Li et al (submitted to ISMAR 2017)*
12+
* [**Robust Initialization of Monocular Visual-Inertial Estimation on Aerial Robots**](http://www.ece.ust.hk/~eeshaojie/iros2017tong.pdf), *T.Qin et al (submitted to IROS 2017)*
13+
* [**Monocular Visual-Inertial State Estimation With Online Initialization and Camera-IMU Extrinsic Calibration**](http://ieeexplore.ieee.org/document/7463059/), *Z.Yang et al (T-ASE 2017)*
14+
15+
*If you use VINS-Mobile for your academic research, please cite at least one of our related papers.*
16+
17+
## 1. Build
18+
19+
The code has been compiled on macOS Sierra with Xcode 8.3.1 and tested with iOS 10.2.1 on iPhone7 Plus.
20+
21+
1.1 Install boost for macOS
22+
```
23+
$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
24+
$ brew install boost
25+
```
26+
1.2 Download specific **opencv2.framework** from [here](https://www.dropbox.com/sh/r28gjnue98ro1fa/AACiEH-HUdZxU4852_AytAPPa?dl=0)
27+
28+
1.3 Copy the **opencv2.framework** to **VINS_ThirdPartyLib/opencv2.framework**
29+
30+
1.4 In your Xcode, select **Product**-> **Scheme**-> **Edit Scheme**-> **Run**-> **Info**, set **Build Configuration** to **Release**
31+
32+
1.5 Build and Run
33+
34+
1.6 Compatible Devices
35+
36+
iPhone7 Plus, iPhone7, iPhone6s Plus, iPhone6s
37+
38+
If you use it with non-plus devices, you may need to modify the UI size at Main.storyboard for adapting with your screen.
39+
40+
## 2. Acknowledgements
41+
42+
We use [ceres solver](http://ceres-solver.org/) for non-linear optimization and [DBow](https://github.com/dorian3d/DBoW2) for loop detection.
43+
44+
Thanks [Yang Liu](https://github.com/wandermyz) to contribute to this code.
45+
46+
## 3. Licence
47+
48+
The source code is released under [GPLv3](http://www.gnu.org/licenses/) licence.
49+
50+
We are still working for improving the code readability. Welcome to contribute to VINS-Mobile or ask any issues via Github or contacting Peiliang LI <[email protected]> or Tong QIN <[email protected]>.
51+
52+
For commercial inqueries, please contact Shaojie SHEN <[email protected]>

Resources/boost.a

77.3 MB
Binary file not shown.

Resources/brief_k10L6.bin

57.2 MB
Binary file not shown.

0 commit comments

Comments
 (0)