ktyl
/
basalt
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
2 Commits 1 Branch 0 Tags 19 MiB
C++ 85.1%
Python 9.3%
CMake 3.8%
Shell 1.3%
C 0.3%
Other 0.2%
Go to file
Vladyslav Usenko 19f8f32642 Update README.md 2019-04-15 09:34:45 +00:00
cmake_modules Initial commit 2019-04-14 21:08:32 +02:00
data Initial commit 2019-04-14 21:08:32 +02:00
doc Initial commit 2019-04-14 21:08:32 +02:00
docker Initial commit 2019-04-14 21:08:32 +02:00
include/basalt Initial commit 2019-04-14 21:08:32 +02:00
scripts Initial commit 2019-04-14 21:08:32 +02:00
src Initial commit 2019-04-14 21:08:32 +02:00
test Initial commit 2019-04-14 21:08:32 +02:00
thirdparty Initial commit 2019-04-14 21:08:32 +02:00
.clang-format Initial commit 2019-04-14 21:08:32 +02:00
.gitignore Initial commit 2019-04-14 21:08:32 +02:00
.gitlab-ci.yml Initial commit 2019-04-14 21:08:32 +02:00
.gitmodules Initial commit 2019-04-14 21:08:32 +02:00
CMakeLists.txt Initial commit 2019-04-14 21:08:32 +02:00
LICENSE Initial commit 2019-04-14 21:08:32 +02:00
README.md Update README.md 2019-04-15 09:34:45 +00:00

README.md

Basalt

For more information see https://vision.in.tum.de/research/vslam/basalt

teaser

This project contains tools for:

  • Camera, IMU and motion capture calibration.
  • Visual-inertial odometry and mapping.
  • Simulated environment to test different components of the system.

Some reusable components of the system are availble as a separate header-only library.

Related Publications

Visual-Inertial Odometry and Mapping:

  • Visual-Inertial Mapping with Non-Linear Factor Recovery, V. Usenko, N. Demmel, D. Schubert, J. Stückler, D. Cremers, In [arXiv:].

Calibration (explains implemented camera models):

Calibration (demonstrates how these tools can be used for dataset calibration):

  • The TUM VI Benchmark for Evaluating Visual-Inertial Odometry, D. Schubert, T. Goll, N. Demmel, V. Usenko, J. Stückler, D. Cremers, In 2018 International Conference on Intelligent Robots and Systems (IROS), [DOI:10.1109/IROS.2018.8593419], [arXiv:1804.06120].

Installation

APT installation for Ubuntu 16.04 and 18.04 (Fast)

Set up keys

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 0D97B6C9

Add the repository to the sources list. On Ubuntu 18.04 run:

sudo sh -c 'echo "deb [arch=amd64] http://packages.usenko.eu/ubuntu bionic main" > /etc/apt/sources.list.d/basalt.list'

On Ubuntu 16.04 run:

sudo sh -c 'echo "deb [arch=amd64] http://packages.usenko.eu/ubuntu xenial main" > /etc/apt/sources.list.d/basalt.list'

Update the Ubuntu package index and install Basalt:

sudo apt-get update
sudo apt-get install basalt

Source installation for Ubuntu 18.04 and MacOS 10.14 Mojave

Clone the source code for the project and build it. For MacOS you should have Homebrew installed.

git clone --recursive https://gitlab.com/VladyslavUsenko/basalt.git
cd basalt
./scripts/install_deps.sh
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=RelWithDebInfo
make -j8

NOTE: It is possible to compile the code on Ubuntu 16.04, but you need to install cmake-3.10 or higher and gcc-7. See corresponding Dockerfile as an example.

Usage

Licence

The code for this practical course is provided under a BSD 3-clause license. See the LICENSE file for details. Note also the different licenses of thirdparty submodules.