https://github.com/ethz-asl/rovio

https://github.com/ethz-asl/rovio

Last synced: 10 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/ethz-asl/rovio
• Owner: ethz-asl
• License: other
• Created: 2015-08-06T07:43:05.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-01-10T10:39:22.000Z (10 months ago)
• Last Synced: 2024-10-21T12:08:26.137Z (18 days ago)
• Language: C++
• Size: 1.17 MB
• Stars: 1,136
• Watchers: 118
• Forks: 508
• Open Issues: 79
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• Awesome-SLAM - ROVIO
• my-awesome-list - rovio - the ROVIO (Robust Visual Inertial Odometry) framework. (Projects / Computer Vision & Robotics)
• awesome-robotic-tooling - rovio - Robust Visual Inertial Odometry Framework. (Simultaneous Localization and Mapping / Visual)
• awesome-robotic-tooling - rovio - Robust Visual Inertial Odometry Framework (Localization / SLAM)

README

        
# README #

This repository contains the ROVIO (Robust Visual Inertial Odometry) framework. The code is open-source (BSD License). Please remember that it is strongly coupled to on-going research and thus some parts are not fully mature yet. Furthermore, the code will also be subject to changes in the future which could include greater re-factoring of some parts.

Video: https://youtu.be/ZMAISVy-6ao

Papers:

* http://dx.doi.org/10.3929/ethz-a-010566547 (IROS 2015)

* http://dx.doi.org/10.1177/0278364917728574 (IJRR 2017)

Please also have a look at the wiki: https://github.com/ethz-asl/rovio/wiki

### Install without opengl scene ###

Dependencies:

* ros

* kindr (https://github.com/ethz-asl/kindr)

* lightweight_filtering (as submodule, use "git submodule update --init --recursive")

```

#!command

catkin build rovio --cmake-args -DCMAKE_BUILD_TYPE=Release

```

### Install with opengl scene ###

Additional dependencies: opengl, glut, glew (sudo apt-get install freeglut3-dev, sudo apt-get install libglew-dev)

```

#!command

catkin build rovio --cmake-args -DCMAKE_BUILD_TYPE=Release -DMAKE_SCENE=ON

```

### Euroc Datasets ###

The rovio_node.launch file loads parameters such that ROVIO runs properly on the Euroc datasets. The datasets are available under:

http://projects.asl.ethz.ch/datasets/doku.php?id=kmavvisualinertialdatasets

### Further notes ###

* Camera matrix and distortion parameters should be provided by a yaml file or loaded through rosparam

* The cfg/rovio.info provides most parameters for rovio. The camera extrinsics qCM (quaternion from IMU to camera frame, Hamilton-convention) and MrMC (Translation between IMU and Camera expressed in the IMU frame) should also be set there. They are being estimated during runtime so only a rough guess should be sufficient.

* Especially for application with little motion fixing the IMU-camera extrinsics can be beneficial. This can be done by setting the parameter doVECalibration to false. Please be carefull that the overall robustness and accuracy can be very sensitive to bad extrinsic calibrations.