Introduction

The qmt toolbox (Quaternion-based Inertial Motion Tracking Toolbox) is a collection of functions, algorithms, visualization tools, and other utilities with a focus on IMU-based motion tracking.

The main goal is to provide high-level access to various algorithms in a consistent way that makes it possible to analyze new experimental data with just a few lines of code.

Installation

The qmt Python package can easily be installed from PyPI via pip, e.g.:

pip install qmt

Depending on your Python installation, it might be necessary to use pip3 instead of pip and/or to add the --user option. To run webapps, install either PySide6 or PySide2. If neither PySide6 nor PySide2 work on your system, webapps can still be displayed with a Chromium browser window fallback.

To install the toolbox from the source code hosted on GitHub, the JavaScript library for the webapps needs to be built first. It is also recommended to install the optional dev dependencies. In the directory of the git repository, run the following commands:

./build_webapp_lib.sh
pip3 install --user -e ".[dev]"

To build the documentation locally, run ./build_docs.sh. To view the documentation, open documentation.html in a browser.