Differences

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

--- visual3d:tutorials:knowledge_discovery:marker_markerless_comparison [2025/09/24 15:58] – wikisysop
+++ visual3d:tutorials:knowledge_discovery:marker_markerless_comparison [2026/06/25 17:43] (current) – [Merge Theia3D Files and Marker based files] wikisysop
@@ Line 1: / Line 1: @@
-====== Marker Markerless Comparison ======
+======Visual3D Tutorial: Marker-Markerless Comparison ======
+** This tutorial has been updated to use the [[visual3d:documentation:pipeline:pipeline_commands:manage_file_merge]] command. Previous versions used Manage_Theia3D_Processing, however this command is no longer recommended since [[visual3d:documentation:pipeline:pipeline_commands:manage_file_merge]] was updated to be used for file types other than just from Theia3D. This command can merge Theia3D output along with other C3D marker based data files.**
-This tutorial demonstrates the merging of Theia3D output c3d files and synchronized c3d files with marker based data.
+This tutorial demonstrates the merging of Theia3D output c3d files and synchronized c3d files with marker based data. This method can be used to simultaneously build and compare models for data collected using synchronized markerless and marker based motion capture.
 ==== Demo Files ====
-Download the [[https://drive.google.com/file/d/1Xj_NC_a1cCNTdjTpZ34SMh9mGNkek6DI/view?usp=sharing|zip file]] containing folder paths and files for this tutorial.
+To begin, download the [[https://drive.google.com/file/d/1Xj_NC_a1cCNTdjTpZ34SMh9mGNkek6DI/view?usp=sharing|zip file]] containing folder paths and files for this tutorial. This folder contains separate CMZs for both the markerless and marker based captures that will be merged.
 ==== Merge Theia3D Files and Marker based files ====
+Once merged, the Theia3D signals will be assigned a prefix ML: and a subject tag ML while the marker based signals will be assigned a prefix M: and a subject tag M. The pair of synchronized files will be merged into one file.
+The ground reaction force will be assigned to both models (there is a little inside trick here)and difference signals and metrics will be generated and reported.\\
+{{.:pasted:20260625-173548.png?650}}
-The Theia3D signals will be assigned a prefix ML: and a subject tag ML
+The following Visual3D command can be used to merge the two CMZs together:
-The markers will be assigned a prefix M: and a subject tag M
-The pair of synchronized files will be merged into one file.
-The ground reaction force will be assigned to both models (there is a little inside trick here)
-Difference signals and metrics will be generated and reported.\\
-{{:Theia3D_Tutorial2_1.jpg?650}}
 <code>
-Manage_Theia3D_Processing
+Manage_File_Merge
 /ROOT_FOLDER=...\Visual3D_Theia_Tutorial2\
+! /HMX_INDEX_MASK=
+! /USE_HMX_INDEX=FALSE
 ! /ACTION=
-/TAGS=GROUP+SESSION+TASK
+! /TAGS=ACTION
-/PROJECT=THEIA3D_MB_ML
 ! /IMPORT_ANALOG_FILES=FALSE
-/MERGE_THEIA3D_FILES=TRUE
+! /MERGE_PRIMARY_FILES=FALSE
-/THEIA3D_SESSION_FOLDER=*_THEIA
+/MERGE_PRIMARY_AND_OTHER_FILES=TRUE
-/THEIA3D_FILE_MASK=*pose_filt_0.c3d
+! /MERGE_EVENT_LABELS=FALSE
+/PRIMARY_SESSION_FOLDER=*001_THEIA
+! /PRIMARY_FILE_MASK=*.c3d
+! /PRIMARY_FILE_MAS_FOR_MODEL=
 /THEIA3D_PREFIX=ML:
 /THEIA3D_SUBJECT_TAG=ML
-/OTHER3D_SESSION_FOLDER=*_QTM
+/PRIMARY_COLOR=Black
-/OTHER3D_FILE_MASK=*walk*.c3d
+! /PRIMARY_SEX=UNKNOWN
-/OTHER3D_MODEL_MASK=*static*.c3d
+! /CREATE_MODEL_FOR_EACH_C3D_FILE=FALSE
-/OTHER3D_MODEL_TEMPLATE_MASK=*.mdh
+/OTHER_SESSION_FOLDER=*001_QTM
-/OTHER3D_PREFIX=M:
+/OTHER_FILE_MASK=*.c3d
-/OTHER3D_SUBJECT_TAG=M
+/OTHER_MODEL_MASK=*.c3d
-/NUMBER_OF_SESSION_FILES_ALLOWED=3
+/OTHER_MODEL_TEMPLATE_MASK=*.mdh
-/GCVSPL_VARIANCE=0.00001
+/OTHER_PREFIX=M:
-! /RECREATE_EVENTS=TRUE
+/OTHER_SUBJECT_TAG=M
-! /QA_FORCE_ASSIGNMENTS=TRUE
+/OTHER_COLOR=Black
+! /NUMBER_OF_SESSION_FILES_ALLOWED=
+! /SAVE_DEFAULT_CMZ_FILES=TRUE
+! /DEFAULT_CMZ_NAME=<SESSION>
 ! /OPEN_CMZ_LIBRARY=FALSE
-! /REPORT_COMMAND=FALSE
+! /VIRTUAL_LAB=
-! /REPORT_INFO=FALSE
+/INPUT_DATA_FOLDER_PRIMARY=TRIAL
-! /REPORT_ERROR=FALSE
+/INPUT_DATA_FOLDER_SECONDARY=ACTION
-! /REPORT_WARNING=FALSE
+/INPUT_STATIC_DATA_FOLDER=SESSION
-! /INPUT_FOLDER_STRUCTURE=DEFAULT
+! /KINETIC_THORAX=RTA
+! /ANALOG_FILTER_CUTOFF=12
+! /TARGET_FILTER_CUTOFF=12
+/FP_AUTO_BASELINE=Treadmill_Foreaft
+! /VISUAL3D_PIPELINE_POST_MERGE=
+! /VISUAL3D_PIPELINE_PREMERGE=
 ;
 </code>\\
-{{:Theia3D_Tutorial2_2.jpg?650}}\\
+{{:Theia3D_Tutorial2_2.jpg?650}}
-The resulting file contains 3 merged c3d files and 2 models\\
-{{:Theia3D_Tutorial2_3.jpg?650}}\\
-A collection of report graphs
+The resulting file contains 3 merged c3d files and 2 models. The corresponding signals for each model can be found in the data tree with their respective prefixes added:
+\\
+{{.:pasted:20260625-173842.png?450}}
+\\
+Once the files have been merged, the differences in signals can be viewed using Visual3D's graphing and/or reporting functions:\\
+{{.:pasted:20260625-174310.png}}