Stream Qualisys Track Manager (QTM) 3D and 6DOF data as Lab Streaming Layer (LSL) Motion Capture (MoCap) data.
- Python 3.10 or above
- Python tkinter (GUI, see google)
- Qualisys SDK for Python
- Python interface to LSL pylsl
- Upgrade to latest pip
python -m pip install pip --upgrade
- Install dependencies
python -m pip install -r requirements.txt
If this is unsuccessful, consult the links in the dependencies section for instructions on how to manually install them. Also note that some Python installations include tkinter by default and some require you to install it separately.
- (Optional) Install dev dependencies to be able to run the tests
python -m pip install -r requirements-dev.txt
- Ensure QTM is running either locally or on an external host that you are able to ping
- Start LSL App
python -m qlsl.gui
- Enter address, port, and start
Once started and connected, the app is either in a Waiting or Streaming state. In the Waiting state there is no LSL stream outlet open, as the app is waiting for QTM to start streaming. When QTM is streaming, the app is in the Streaming state and QTM data is passed through an LSL stream outlet. The app toggles between these states as QTM starts/stops streaming.
- Streaming data from QTM via QTM LSL App
- Recording the data stream with LSL recorder on the same computer
- Opening the file with xdf reader in Matlab
- Open a CMD window
- Type:
python -m qlsl.gui
Use default settings:
- QTM Server Address: 127.0.0.1
- QTM Server Port: 22223
- Open QTM and start streaming (RT or from file)
- Press the Start button in the QTM LSL App
Download and unzip LSL recorder (release for windows) from https://github.com/labstreaminglayer/App-LabRecorder/releases
- Start LSL recorder (LabRecorder.exe) -> Qualisys stream shows up in interface (no need to change the port number).
- Select stream and start recording
- Stop recording -> The recording is stored in an xdf file in the Study Root folder specified in Lab Recorder
Download and unxip xdf reader for Matlab from https://github.com/xdf-modules/xdf-Matlab
In Matlab:
- Add the xdf reader folder to the Matlab path.
- Read the recorded file (replace with actual file name):
streams = load_xdf('<recorded_file>.xdf');