https://github.com/qualisys/paf-python-example
Example for using Python with the QTM Project Automation Framework
https://github.com/qualisys/paf-python-example
automation motion-capture motion-tracking position-tracking project-automation-framework python qtm qualisys
Last synced: 3 months ago
JSON representation
Example for using Python with the QTM Project Automation Framework
- Host: GitHub
- URL: https://github.com/qualisys/paf-python-example
- Owner: qualisys
- License: mit
- Created: 2022-03-09T10:51:36.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-06-30T07:22:50.000Z (3 months ago)
- Last Synced: 2025-06-30T08:28:37.524Z (3 months ago)
- Topics: automation, motion-capture, motion-tracking, position-tracking, project-automation-framework, python, qtm, qualisys
- Language: Python
- Homepage: https://www.qualisys.com/software/project-automation-framework/
- Size: 8 MB
- Stars: 1
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Qualisys PAF – Python example
## Getting started
To download this example project to your computer, you can either:
* [Click here](https://github.com/qualisys/paf-python-example/archive/refs/heads/main.zip) to download it as a zip file.
_— or —_
* Clone this repository to your computer.
## Preparing Qualisys data for Python processing
1. Install Miniconda for Windows https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe
2. Run the installer and when prompted add Conda to your PATH environment variable.
3. Check that conda is discovered. Open command line prompt and type 'conda --version'. If conda is not found, environment path might not be set correctly. If you do not know where conda is installed, open Anaconda prompt and type 'where conda' and add that path to PATH manually. Sometimes it helps to put path to conda at the top of the list.
4. Open a command line prompt and enter the following:
1. `conda create -n python-example python=3.13`
2. `conda activate python-example`
3. `conda install -c conda-forge ezc3d` (c3d parsing library, see https://github.com/pyomeca/ezc3d)
4. `conda install -c anaconda lxml` (xml parsing library)
5. Open QTM and make sure that the path to `Command Prompt` is set in Project Options\Miscellaneous\Folder Options (the path is usually C:\Windows\System32\cmd.exe)
6. Click on `Start Processing` to automatically export c3d files, read the c3d files content and export some data into `output.xml` file.
## 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)](http://www.qualisys.com/software/qualisys-track-manager/), and how QTM can be connected to a processing engine.
### PAF Documentation
The full documentation for PAF development is available here: [PAF Documentation](https://github.com/qualisys/paf-documentation).
### PAF Examples
Our official examples for various processing engines:
- [AnyBody](https://github.com/qualisys/paf-anybody-example)
- [Cleanse](https://github.com/qualisys/paf-cleanse-example)
- [Excel](https://github.com/qualisys/paf-excel-example)
- [Matlab](https://github.com/qualisys/paf-matlab-example)
- [OpenSim](https://github.com/qualisys/paf-opensim-example)
- [Python](https://github.com/qualisys/paf-python-example)
- [Theia Markerless](https://github.com/qualisys/paf-theia-markerless-example)
- [Theia Markerless Comparison](https://github.com/qualisys/paf-theia-markerless-comparison-example)
- [Theia Markerless True Hybrid](https://github.com/qualisys/paf-theia-markerless-true-hybrid-example)
- [Visual3D](https://github.com/qualisys/paf-visual3d-example)
_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)._