Differences

This shows you the differences between two versions of the page.

--- visual3d:documentation:third-party:theia [2025/09/03 17:19] – wikisysop
+++ visual3d:documentation:third-party:theia [2025/09/18 14:44] (current) – wikisysop
@@ Line 1: / Line 1: @@
 ====== Theia ======
+[[https://www.theiamarkerless.com/|Theia's markerless motion capture technology]] integrates with Visual3D and Sift by exporting C3D files, allowing users to process, analyze, and visualize their data. Visual3D recognizes these C3D files as Theia3D output and automatically creates a model and assigns the associated motion file during import.
-[[https://www.theiamarkerless.com/|Theia's markerless motion capture technology]] can integrate with Visual3D and Sift since it exports c3d files. Various versions of Theia's software integrate with Visual3D and can be easily imported to further process, analyze, and visualize your data.
+A standing (static) trial is generated virtually based on the parameters found within the movement trial, rather than requiring a separate static capture. Model segments and landmarks are created automatically based on the Theia data. It’s important to note that Theia3D stores [[visual3d:documentation:c3d_signal_types:rotation_data_type| ROTATION signals]], not traditional TARGET signals. These ROTATION signals include the full six degrees of freedom (6 DOF) for each segment, as a 4×4 transformation matrix. When a ROTATION signal is selected for a segment location, only the position component is used unless further configuration is specified. Unless there is a specific need to modify the coordinate system, the ROTATION signal is directly assigned to the pose of the model segment without further processing. The ROTATION folder in **Signals and Events** displays all the ROTATION signals exported by Theia3D.
+Each ROTATION signal consists of 17 float values per frame: sixteen values represent the 4×4 transformation matrix, and the seventeenth is a reliability metric. These signals are stored sequentially in the C3D file. This data type is used in practice because if a segment’s origin is defined at the proximal end, the ROTATION matrix provides a description of both the position and orientation of that segment. This eliminates the need for additional calculations to estimate pose and makes data management easier, since the pose is a single signal.
+This integration supports all Theia3D software versions including [[https://docs.theiamarkerless.com/|Theia Axiom v2025]], [[https://docs.theiamarkerless.com/version-2024.1.0|Theia Apollo v2024]], [[https://www.theiamarkerless.com/blog/theia-2023-patch-3| Theia 2023]], Theia 2022, and Theia 2021.
-Key features of our integration with Theia include being able to import C3D files from:
-  -  [[https://docs.theiamarkerless.com/|Theia Axiom v2025]]
-  -  [[https://docs.theiamarkerless.com/version-2024.1.0|Theia Apollo v2024]]
-  - [[https://www.theiamarkerless.com/blog/theia-2023-patch-3| Theia 2023]]
-  - Theia 2022
-  - Theia 2021
 === Merging Theia3D Files===
-Typically, users want to merge Theia3D's motion capture output and analog signals such as force platform recordings.//
+Typically, users want to merge Theia3D's motion capture output and analog signals such as force platform recordings.\\
+\\
 The [[visual3d:documentation:pipeline:pipeline_commands:manage_file_merge|Manage_File_Merge]] command is designed to merge multiple files that recorded data from the same motion capture trial. This command merges data types from each .c3d file into one trial in the Visual3D workspace. This command was originally called **Manage_Theia3D_Merge**, but since has been updated to be used for file types other than from Theia3D.
-This pipeline command makes it simple to merge markerless motion capture files from Theia with marker-based motion capture files from [[https://www.qualisys.com/software/qualisys-track-manager/|Qualisys QTM]].//
+This pipeline command makes it simple to merge markerless motion capture files from Theia with marker-based motion capture files from [[https://www.qualisys.com/software/qualisys-track-manager/|Qualisys QTM]].\\
 The following [[https://drive.google.com/file/d/1KwwDEz4jKxVoACnUY1MpGajpZMsHozvH/view|sample data]] can be used to follow along with the outlined steps in [[visual3d:documentation:pipeline:pipeline_commands:manage_file_merge#Merge Theia with QTM Analog Data
 |Merge Theia with QTM Analog Data]]
+===Loading Theia C3D Files into Sift===
+If wanting to import Theia C3D files into Sift the Theia Builder will be needed to build CMZ files from the Theia3D outputs. Reference the tutorial here on how to use the Theia Builder: [[sift:build_cmz:load_c3ds_dialog#Build CMZ Dialog - Theia Builder|Theia Builder]]
-[[https://www.theiamarkerless.com/|Theia's markerless motion capture technology]] integrates with Visual3D and Sift by exporting C3D files, allowing users to process, analyze, and visualize their data. Visual3D recognizes these C3D files as Theia3D output and automatically creates a model and assigns the associated motion file during import.
-A standing (static) trial is generated virtually based on the parameters found within the movement trial, rather than requiring a separate static capture. Model segments and landmarks are created automatically based on the Theia data. It’s important to note that Theia3D stores ROTATION signals, not traditional TARGET signals. These ROTATION signals include the full six degrees of freedom (6 DOF) for each segment, as a 4×4 transformation matrix. When a ROTATION signal is selected for a segment location, only the position component is used unless further configuration is specified. Unless there is a specific need to modify the coordinate system, the ROTATION signal is directly assigned to the pose of the model segment without further processing. The ROTATION folder in **Signals and Events** displays all the ROTATION signals exported by Theia3D.
-Each ROTATION signal consists of 17 float values per frame: sixteen values represent the 4×4 transformation matrix, and the seventeenth is a reliability metric. These signals are stored sequentially in the C3D file. This data type is used in practice because if a segment’s origin is defined at the proximal end, the ROTATION matrix provides a description of both the position and orientation of that segment. This eliminates the need for additional calculations to estimate pose and makes data management easier, since the pose is a single signal.
-This integration supports all Theia3D software versions including Theia Axiom v2025, Theia Apollo v2024, Theia 2023, Theia 2022, and Theia 2021.