Differences

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

--- visual3d:documentation:pipeline:pipeline_commands:manage_file_merge [2025/07/25 15:29] – wikisysop
+++ visual3d:documentation:pipeline:pipeline_commands:manage_file_merge [2025/09/10 17:00] (current) – wikisysop
@@ Line 150: / Line 150: @@
 This following is an example of using the Manage_File_Merge command to merge markerless motion capture files from Theia with force plate analog signals from QTM.
+If using a version of Visual3D v2025.07.2 or newer, the Virtual Lab will not be automatically configured. In Manage_File_Merge the VIRTUAL_LAB parameter needs to be assigned a segment. In order to create a Virtual Laboratory segment see here, [[visual3d:documentation:modeling:virtual_lab:creating_a_virtual_laboratory|Virtual Laboratory]].
 ===Folder Structure===
-The [[visual3d:documentation:pipeline:pipeline_commands:manage_file_merge|folder structure]] of the QTM and Theia files that were capture in this sample data is:
+The [[visual3d:documentation:pipeline:pipeline_commands:manage_file_merge#folder_structure1|folder structure]] of the QTM and Theia files that were capture in this sample data is:
 {{:visual3d:documentation:pipeline:pipeline_commands:mergeexample1folder.png?800}}
@@ Line 206: / Line 208: @@
 A Visual3D CMZ Workspace is created containing the model from the Theia3D rotation signals, and analog channels from the QTM force platforms.
 {{:visual3d:documentation:pipeline:pipeline_commands:mergeexample1result.png?700}}
-===Merge Multiple QTM Files===
+====Merge Markerless and Marker-based Files====
+This following is an example of using the Manage_File_Merge command to merge markerless motion capture files from Theia with marker-based motion capture files from QTM.
+===Folder Structure===
+The [[visual3d:documentation:pipeline:pipeline_commands:manage_file_merge#folder_structure1|folder structure]] of the QTM and Theia files that were capture in this sample data is:
+{{:visual3d:documentation:pipeline:pipeline_commands:mergeexample1folder.png?800}}
+===Pipeline Command===
+{{ :visual3d:documentation:pipeline:pipeline_commands:mergeexample2dlg.png?700}}
+The following pipeline was run to merge QTM markerbased and Theia markerless files:
+<code>
+Manage_File_Merge
+/ROOT_FOLDER=C:\Users\sydne\OneDrive\Documents\Merge_Tutorial_Study\ML_Players\
+! /HMX_INDEX_MASK=
+! /USE_HMX_INDEX=FALSE
+! /ACTION=
+! /TAGS=ACTION
+! /IMPORT_ANALOG_FILES=FALSE
+! /MERGE_PRIMARY_FILES=FALSE
+/MERGE_PRIMARY_AND_OTHER_FILES=TRUE
+! /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
+/PRIMARY_COLOR=Black
+! /PRIMARY_SEX=UNKNOWN
+! /CREATE_MODEL_FOR_EACH_C3D_FILE=FALSE
+/OTHER_SESSION_FOLDER=*001_QTM
+/OTHER_FILE_MASK=*.c3d
+/OTHER_MODEL_MASK=*.c3d
+/OTHER_MODEL_TEMPLATE_MASK=*.mdh
+/OTHER_PREFIX=M:
+/OTHER_SUBJECT_TAG=M
+/OTHER_COLOR=Black
+! /NUMBER_OF_SESSION_FILES_ALLOWED=
+! /SAVE_DEFAULT_CMZ_FILES=TRUE
+! /DEFAULT_CMZ_NAME=<SESSION>
+! /OPEN_CMZ_LIBRARY=FALSE
+! /VIRTUAL_LAB=
+/INPUT_DATA_FOLDER_PRIMARY=TRIAL
+/INPUT_DATA_FOLDER_SECONDARY=ACTION
+/INPUT_STATIC_DATA_FOLDER=SESSION
+! /KINETIC_THORAX=RTA
+! /ANALOG_FILTER_CUTOFF=12
+! /TARGET_FILTER_CUTOFF=12
+/FP_AUTO_BASELINE=Treadmill_Foreaft
+! /VISUAL3D_PIPELINE_POST_MERGE=
+! /VISUAL3D_PIPELINE_PREMERGE=
+;
+</code>
+**NOTE:** It is necessary to include M: and ML: for the marker-based and markerless prefixes, or the merge will not work!
+===Output===
+A Visual3D CMZ Workspace is created containing both the markerless and marker-based solutions.
+{{:visual3d:documentation:pipeline:pipeline_commands:mergeexample2result.png?700}}