Qualisys - Revision history

E.vandenberge at 15:56, 14 April 2026

2026-04-14T15:56:06Z

← Older revision		Revision as of 15:56, 14 April 2026
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 ~~(August 2025)~~ 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==

E.vandenberge: /* Usage */

2026-03-11T10:34:14Z

Usage

← Older revision		Revision as of 10:34, 11 March 2026
Line 87:		Line 87:
	===New Project===		===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.		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.		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)

	~~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~~.		===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.

	~~Choose 'Base the project on: "Settings Imported from another project"'~~ and ~~select the Settings~~.~~qtmproj~~ file from the ~~base project~~.		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.

	~~<!--~~===~~Rigid Body Tracking~~=== ~~TODO~~-->		===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 [https://github.com/qualisys/qualisys_lsl_app 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===

E.vandenberge at 17:08, 10 March 2026

2026-03-10T17:08:21Z

@@ Line 84: / Line 84: @@
 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.
 ===LSL===

E.vandenberge: /* Usage */

2025-09-17T09:06:59Z

Usage

← Older revision		Revision as of 09:06, 17 September 2025
Line 86:		Line 86:

	===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.

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

E.vandenberge at 09:06, 17 September 2025

2025-09-17T09:06:08Z

← Older revision		Revision as of 09:06, 17 September 2025
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 (August 2025) testing Qualisys' "Traqr" active marker systems; they will likely be available for use in the labs in the near future.

	==Usage==		==Usage==

E.vandenberge: /* LSL */

2025-04-29T12:04:48Z

LSL

← Older revision		Revision as of 12:04, 29 April 2025
Line 86:		Line 86:

	===LSL===		===LSL===
	Data from QTM can be streamed in real-time 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 Qualisys LSL App. Only labeled markers (3D) and rigid bodies (6DOF) can be streamed over LSL.

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

E.vandenberge at 11:54, 16 April 2025

2025-04-16T11:54:50Z

← Older revision		Revision as of 11:54, 16 April 2025
Line 48:		Line 48:
	\|-		\|-
	! Marker Mode		! Marker Mode
	! colspan="2"\| <!-- set to number of item-columns -->		! colspan="3"\| <!-- set to number of item-columns -->
	\|-		\|-
	\| Max. Range <ref group="fn"> Maximum capture distance with 16mm passive marker and standard lens.</ref> \|\| 25m \|\| 13m \|\| 15m		\| Max. Range <ref group="fn"> Maximum capture distance with 16mm passive marker and standard lens.</ref> \|\| 25m \|\| 13m \|\| 15m
Line 55:		Line 55:
	\|-		\|-
	! Video Mode		! Video Mode
	! colspan="2"\| <!-- set to number of item-columns -->		! colspan="3"\| <!-- set to number of item-columns -->
	\|-		\|-
	\| Color \|\| Infrared (b&w) \|\| Full color \|\|		\| Color \|\| Infrared (b&w) \|\| Full color \|\|

E.vandenberge at 11:54, 16 April 2025

2025-04-16T11:54:03Z

← Older revision		Revision as of 11:54, 16 April 2025
Line 33:		Line 33:
	! style="width:200px;"\|		! style="width:200px;"\|
	! style="width:200px;"\| [[File:Oqus-7-square.jpg ‎\|200px\|Image: 200 pixels]]		! style="width:200px;"\| [[File:Oqus-7-square.jpg ‎\|200px\|Image: 200 pixels]]
			! style="width:200px;"\| [[File:Miqus-video-square.jpg ‎\|200px\|Image: 200 pixels]]
	! style="width:200px;"\| [[File:Miqus-square.jpg ‎\|200px\|Image: 200 pixels]]		! style="width:200px;"\| [[File:Miqus-square.jpg ‎\|200px\|Image: 200 pixels]]
	\|-		\|-
Line 38:		Line 39:
	! Oqus 5		! Oqus 5
	! Miqus Hybrid		! Miqus Hybrid
			! Miqus M3
	\|-		\|-
	\| Resolution \|\| 2048 x 2048 (4MP) \|\| 1920 x 1088 (2 MP)		\| Resolution \|\| 2048 x 2048 (4MP) \|\| 1920 x 1088 (2 MP) \|\| 1824 x 1088 (2MP)
	\|-		\|-
	\| Field of View <ref group="fn">Field of view of standard lenses. Wide angle lenses may be available.</ref> \|\| 49° \|\| ~~61°~~ x 37°		\| Field of View <ref group="fn">Field of view of standard lenses. Wide and narrow angle lenses may be available.</ref> \|\| 49° \|\| 61 x 37° \|\| 64 x 41°
	\|-		\|-
	\| Connector \|\| Lemo \|\| PoE		\| Connector \|\| Lemo \|\| PoE \|\| PoE
	\|-		\|-
	! Marker Mode		! Marker Mode
	! colspan="2"\| <!-- set to number of item-columns -->		! colspan="2"\| <!-- set to number of item-columns -->
	\|-		\|-
	\| Max. Range <ref group="fn"> Maximum capture distance with 16mm passive marker and standard lens.</ref> \|\| 25m \|\| 13m		\| Max. Range <ref group="fn"> Maximum capture distance with 16mm passive marker and standard lens.</ref> \|\| 25m \|\| 13m \|\| 15m
	\|-		\|-
	\| Max. Frame Rate <ref group="fn" name="max"/> \|\| 180-10.000 fps \|\| 340 fps		\| Max. Frame Rate <ref group="fn" name="max"/> \|\| 180-10.000 fps \|\| 340 fps \|\| 340 fps
	\|-		\|-
	! Video Mode		! Video Mode
	! colspan="2"\| <!-- set to number of item-columns -->		! colspan="2"\| <!-- set to number of item-columns -->
	\|-		\|-
	\| Color \|\| Infrared (b&w) \|\| Full color		\| Color \|\| Infrared (b&w) \|\| Full color \|\|
	\|-		\|-
	\| Max. Frame Rate <ref group="fn" name="max"/> \|\| 25 fps \|\| 85-550 fps		\| Max. Frame Rate <ref group="fn" name="max"/> \|\| 25 fps \|\| 85-550 fps \|\|
	\|-		\|-
	\|}		\|}

E.vandenberge at 11:03, 6 March 2025

2025-03-06T11:03:33Z

← Older revision		Revision as of 11:03, 6 March 2025
Line 5:		Line 5:
	\| caption = Screenshot of Qualisys QTM version 2024.2		\| caption = Screenshot of Qualisys QTM version 2024.2
	\| website = [https://www.qualisys.com www.qualisys.com]		\| website = [https://www.qualisys.com www.qualisys.com]
	\| resources =		\| resources =
			{{Infobox tsg
			\| child = yes
			\| downloads = {{bulleted list
			\| [https://github.com/qualisys/qualisys_lsl_app Qualisys LSL app]
			}}
			\| manuals = {{bulleted list
			\| [https://docs.qualisys.com/qtm/ QTM Online Manual]
			}}
			}}
	}}		}}

Line 13:		Line 22:

	<!-- Table of Contents will be generated here -->		<!-- Table of Contents will be generated here -->
	=Cameras=		==Cameras==
	A Qualisys system is an optical motion capture system, meaning it uses cameras to record motion of your subject. This is traditionally done with markers, which emit or reflect infrared light that can be captured by the cameras. By placing multiple cameras in different locations, the system can triangulate the position of a marker.		A Qualisys system is an optical motion capture system, meaning it uses cameras to record motion of your subject. This is traditionally done with markers, which emit or reflect infrared light that can be captured by the cameras. By placing multiple cameras in different locations, the system can triangulate the position of a marker.

Line 55:		Line 64:
	</references>		</references>

	=Markers=		==Markers==
	[[File:Passive markers.jpg\|thumb\|240px\|A selection of passive markers]]		[[File:Passive markers.jpg\|thumb\|240px\|A selection of passive markers]]

Line 61:		Line 70:
	Choice of marker size depends on the subject and the distance between the subject and the cameras. The smaller the subject (e.g. baby's fingers), the smaller the marker needs to be. But the smaller the marker, the higher the resolution or the closer the camera should be to capture it.		Choice of marker size depends on the subject and the distance between the subject and the cameras. The smaller the subject (e.g. baby's fingers), the smaller the marker needs to be. But the smaller the marker, the higher the resolution or the closer the camera should be to capture it.

	The benefit of using passive markers is that they are (relatively) cheap, and they need no cables for power or anything. The downside is that passive markers are not inherently identifiable, meaning they need to be manually labeled afterwards and cannot be streamed in real-time unless they are part of a rigid body.		The benefit of using passive markers is that they are (relatively) cheap, and they need no cables for power or anything. The downside is that passive markers are not inherently identifiable, meaning they need to be manually labeled afterwards and cannot be streamed in real-time unless they are part of a rigid body. A rigid body is an object with 3 or more markers

	==Active Markers==		All optical markers (both active and passive) have the disadvantage of being easily obscured (something blocking the view from the cameras to the marker, making it impossible to track). Therefore, marker placement has to be considered carefully, and often it is wise to place additional markers for redundancy. Standard marker placement templates exist for full/partial body tracking.

			===Active Markers===
	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.

	~~All optical markers have the disadvantage of being easily obscured (something blocking~~ the ~~view from~~ the ~~cameras~~ to the ~~marker)~~, ~~so marker placement has to be considered carefully~~.		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==
			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.

	=~~Usage~~=		===LSL===
	~~UNDER CONSTRUCTION~~		Data from QTM can be streamed in real-time via LSL using the Qualisys LSL App. Only labeled markers (3D) and rigid bodies (6DOF) can be streamed over LSL.

	You can request access to ~~manuals, tutorials and~~ QTM from [[Erik van den Berge]]		===Data Processing===
			When you have captured marker data, you can process it in QTM to label the markers and fill any gaps. Some analysis tools are available within QTM; otherwise you can export the data in a suitable format (c3d, matlab, tsv, fbx).
			You can request access to QTM on your own PC from [[Erik van den Berge]].

	<!--==References== Optional -->		<!--==References== Optional -->
	<references /> <!-- Automatically generates list of references using the <ref></ref> tags. -->		<references /> <!-- Automatically generates list of references using the <ref></ref> tags. -->

	=External Links=		==External Links==
	*{{Official website\|http://www.qualisys.com}}		*{{Official website\|http://www.qualisys.com}}

E.vandenberge at 17:02, 5 March 2025

2025-03-05T17:02:19Z

← Older revision		Revision as of 17:02, 5 March 2025
Line 1:		Line 1:
	{{Infobox ~~tsg~~		{{Infobox software
	\| name = Qualisys		\| name = Qualisys QTM
	\| ~~image~~ = Qtm_screenshot.jpg		\| logo = Qualisys-QTM.png
	\| caption = Screenshot of Qualisys QTM ~~software~~		\| screenshot = Qtm_screenshot.jpg
			\| caption = Screenshot of Qualisys QTM version 2024.2
			\| website = [https://www.qualisys.com www.qualisys.com]
			\| resources =
	}}		}}

Line 10:		Line 13:

	<!-- Table of Contents will be generated here -->		<!-- Table of Contents will be generated here -->
			=Cameras=
			A Qualisys system is an optical motion capture system, meaning it uses cameras to record motion of your subject. This is traditionally done with markers, which emit or reflect infrared light that can be captured by the cameras. By placing multiple cameras in different locations, the system can triangulate the position of a marker.

	==Cameras==		A typical capture setup (in our labs) consists of 8-10 cameras, placed in a circle around the capture area. Usually, all cameras in a system are the same type, but Qualisys cameras can be mixed and matched to some extent. Cameras with the same connector can be daisy-chained together, and otherwise separate "loops" can be joined via a network switch. When combining different cameras, the maximum frame rate of the entire system is limited to the maximum frame rate of the "worst" camera.

			Every Qualisys camera can be used in either "Marker mode" or "Video mode". In Marker mode, they contribute to calculating the 3D position of each marker. In Video mode, the camera captures a regular video (avi), to either aid in labeling markers and movements, or to process for markerless motion capture. Cameras in Video mode do not contribute to marker tracking.

	{\| class="wikitable"		{\| class="wikitable"
Line 26:		Line 33:
	\|-		\|-
	\| Field of View <ref group="fn">Field of view of standard lenses. Wide angle lenses may be available.</ref> \|\| 49° \|\| 61° x 37°		\| Field of View <ref group="fn">Field of view of standard lenses. Wide angle lenses may be available.</ref> \|\| 49° \|\| 61° x 37°
			\|-
			\| Connector \|\| Lemo \|\| PoE
	\|-		\|-
	! Marker Mode		! Marker Mode
Line 46:		Line 55:
	</references>		</references>

	==Markers==		=Markers=
			[[File:Passive markers.jpg\|thumb\|240px\|A selection of passive markers]]

			Passive markers are little (hemi)spheres covered in retro-reflective material. They reflect the light emitted by the cameras, so that they show up on the camera's sensor. Markers come in all sizes from 2 - 50mm, and with different atachment methods (glue-on, velcro or screw).
			Choice of marker size depends on the subject and the distance between the subject and the cameras. The smaller the subject (e.g. baby's fingers), the smaller the marker needs to be. But the smaller the marker, the higher the resolution or the closer the camera should be to capture it.

			The benefit of using passive markers is that they are (relatively) cheap, and they need no cables for power or anything. The downside is that passive markers are not inherently identifiable, meaning they need to be manually labeled afterwards and cannot be streamed in real-time unless they are part of a rigid body.

			==Active Markers==
			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.

	~~==Usage==~~		All optical markers have the disadvantage of being easily obscured (something blocking the view from the cameras to the marker), so marker placement has to be considered carefully.
	~~Templates and how-~~to~~'s go here~~.

			=Usage=
			UNDER CONSTRUCTION

	~~==See Also== <!-- Optional -->~~		You can request access to manuals, tutorials and QTM from [[Erik van den Berge]]
	*[[~~Project:Samples/Software\|Samples/Software~~]]
	*{{tl\|Infobox_tsg}}

	<!--==References== Optional -->		<!--==References== Optional -->
	<references /> <!-- Automatically generates list of references using the <ref></ref> tags. -->		<references /> <!-- Automatically generates list of references using the <ref></ref> tags. -->

	==External Links==		=External Links=
	*{{Official website\|http://www.qualisys.com}}		*{{Official website\|http://www.qualisys.com}}