Qualisys: Difference between revisions

Jump to navigation Jump to search
mNo edit summary
 
(4 intermediate revisions by the same user not shown)
Line 79: Line 79:
Active markers are markers that emit infrared light themselves. They require an active power source (meaning they're attached to cables), but they can potentially work over longer distances, and most of all they can be individually identified.  
Active markers are markers that emit infrared light themselves. They require an active power source (meaning they're attached to cables), but they can potentially work over longer distances, and most of all they can be individually identified.  


The TSG is currently testing Qualisys' "Traqr" active marker systems; they will likely be available for use in the labs in the near future.  
🚧 The TSG is currently testing Qualisys' "Traqr" active marker systems; they will likely be available for use in the labs in the near future.  


==Usage==
==Usage==
If you wish to capture motion with a Qualisys system, please contact the TSG. They will assist you in determining which system is best suited for your needs and, when available, will set it up for you in one of our research labs.
If you wish to capture motion with a Qualisys system, please contact the TSG. They will assist you in determining which system is best suited for your needs and, when available, will set it up for you in one of our research labs.
A training session with [[Erik van den Berge]] is required before you can use the system.  
A training session with [[Erik van den Berge]] is required before you can use the system.  
===New Project===
At the start of your experiment, or whenever you have made significant changes to the setup/configuration, you should create a new QTM project. You can do this when launching QTM -> New Project, or File -> New Project if you already have a project open.
Give your project a distinct name (preferably includes your personal and/or research-project name) and select the project folder path. The folder is best located inside your own user folder on the D:/ drive. Create one if you haven't already.
We often recommend basing the new project on an existing project, which is an option in the New Project window. This will copy all settings, 6DOF bodies, AIM models and scripts from a previous project; saving you some time setting things up.
Choose 'Base the project on: "Settings Imported from another project"' and select the Settings.qtmproj file from the base project. There's usually a TSG-created project matching the current camera-setup, that you can use as base.
Don't forget to periodically back-up your project folder! (even if you only use QTM for streaming)
===Rigid Body Tracking===
In QTM, you can define rigid bodies; objects with multiple (>3) markers in a fixed configuration that can be tracked in 6 degrees of freedom (position X,Y,Z + pitch, yaw, roll).
Consult the QTM manual or the TSG for creating a rigid ("6DOF") body.
Rigid bodies can be saved and loaded via Project Options -> Processing -> 6DOF Tracking. This is handy when using common objects between multiple projects.
Be careful when loading a rigid bodies XML file: this will clear any existing bodies from the list! If you wish to add multiple sets of rigid body files, it is best to manually combine the XML files.
===Automatic Identification of Markers (AIM)===
For cases where it isn't possible to create a rigid body, but where marker relations ''are'' constrained in some way (e.g. as part of an arm where the distance between each joint doesn't change but their rotations may), QTM's unique AIM system offers a potential solution to aid in labeling markers. This can save time in post-processing, and allow real-time streaming of individual markers.
Consult the QTM manual or the TSG for creating an AIM model.
Like rigid bodies, AIM models are transferable between projects.


===LSL===
===LSL===
Data from QTM can be streamed in real-time, as well as in playback-mode, via LSL using the Qualisys LSL App. Only labeled markers (3D) and rigid bodies (6DOF) can be streamed over LSL.
Data from QTM can be streamed in real-time, as well as in playback-mode, via LSL using the [https://github.com/qualisys/qualisys_lsl_app Qualisys LSL App]. Only labeled markers (3D) and rigid bodies (6DOF) can be streamed over LSL.
 
The TSG has developed a GUI script that lets you launch the LSL app from within QTM. It is usually included when copying a TSG project (see [[#New Project]]).


===Data Processing===
===Data Processing===