Getting started

To download the latest version (not tested) of the example project to your computer, you can either:

• Click here to download it as a zip file.
  — or —
• Clone this repository to your computer.

To download a release version (tested), please Click here

Preparing Qualisys data for ENABLE processing

ENABLE is a markerless engine developed by the Southwest Research Institute (https://www.swri.org/industry/biomechanics-human-performance/markerless-motion-capture-laboratory).

1. Contact enable@swri.org to get the ENABLE installer, license file and installation information.
2. Run the installer and follow the instructions.
3. In QTM, set Project Options > Miscellaneous > Folder Options for "ENABLE" to C:\Program Files (x86)\ENABLE\enable.exe (adapt if installed at different location).
4. Download data from Qualisys File Library (https://qfl.qualisys.com/#!/project/theiaexample)
5. Extract Jack Doe from the downloaded .zip file into the projects data folder "ENABLE Markerless Example\Data".
6. To process the data, click on Start Processing.
7. When the processing is done:
   • skeleton data are exported into c3d and tsv files and can be used for further analysis with the software of your choice (for example Python or Matlab)
   • mot and osim files are exported to be used in OpenSim. Note that Edit > Preferences > Geometry Search Path will have to point to C:\Program Files (x86)\ENABLE\utils\opensim_files\Geometry

Note: You can automatically create an Overlays folder containing video overlays. However, it is significantly slowing down the processing performance. To do so, modify the following line in Settings.paf to add the --overlays option:
Arguments: [--input-dir, $WorkingDirectory$, --calib, qualisys_ex, --overlays]

Resources for using the Qualisys Project Automation Framework (PAF)

The purpose of the Project Automation Framework (PAF) is to streamline the motion capture process from data collection to the final report. This repository contains an example project that illustrate how PAF can be used to implement custom automated data collection in Qualisys Track Manager (QTM), and how QTM can be connected to a processing engine.

PAF Documentation

The full documentation for PAF development is available here: PAF Documentation.

PAF Examples

Our official examples for various processing engines:

• AnyBody
• ENABLE
• Excel
• Matlab
• OpenSim
• Python
• Theia Markerless
• Theia Markerless Comparison
• Theia Markerless True Hybrid
• Visual3D

As of QTM version 2.17, the official Qualisys PAF examples can be used without any additional license. Note that some more advanced analysis types require a license for the "PAF Framework Developer kit" (Article number 150300).