droneposelib

A Python package for Visual-Inertial Odometry


Keywords
computer, vision, visual-inertial, odometry, IMU, UAV
License
MIT
Install
pip install droneposelib==0.0.0a4

Documentation

droneposelib

Build Status PyPI GitHub Language grade: Python codecov

Python library for Visual-Inertial Odometry (VIO). Wrapps the C++/Eigen library DronePoseLib.

Solvers available

The current list of solvers are the following:

Solver Approx. runtime* Max. solutions Comment
fEf 2.5 us 4 Valtonen Örnhag et al. (ArXiV 2021)
frEfr 23** us 11 Valtonen Örnhag et al. (ArXiV 2021)
rEr 2.2 us 4 Valtonen Örnhag et al. (ArXiV 2021)***

* Measured on a laptop with an Intel(R) Core(TM) i5-6200U CPU @ 2.30GHz

** If using the use_fast_solver option

*** Undocumented

Note that all solvers assume that all three degrees of freedom for the rotation matrices are available, i.e. potential IMU drift is ignored. By using e.g. magnetometer data one can often get good estimates, if fused with accelerometer data and gyroscope data. This approach is e.g. used in the Madgwick filter. Futhermore, we have succesfully used pre-integration techniques to achieve robust and accurate performance for shorter time frames without the need of magnetometer data.

Installation

A pre-alpha release is available at PyPi, and can be installed using

    $ pip install droneposelib

You may also compile the source code, see "Development".

Examples

See the example directory for examples on how to use the solvers.

Development

You are more than welcome to contribute your our other relevant solvers. More info soon.

References

The code is related to the ArXiV paper [link]:

@misc{valtonenornhag-etal-2021-arxiv,
      title={Trust Your IMU: Consequences of Ignoring the IMU Drift},
      author={Marcus {Valtonen~Örnhag} and Patrik Persson and Mårten Wadenbäck and Kalle Åström and Anders Heyden},
      year={2021},
      eprint={2103.08286},
      archivePrefix={arXiv},
      primaryClass={cs.CV}
}

Please cite the paper if you are using the code for (academic) publications.