This is an old revision of the document!
Table of Contents
Manage_File_Merge
Overview
The 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 command can be found in the Pipeline Workshop Dialog under Pipeline Control.
Manage_File_Merge can be used to combine motion capture files from the same recording session. A popular use case for this command would be to merge force plate recordings from a QTM file with a Theia3D motion capture file. The analog signals from the QTM .c3d file would be merge into the Theia3D .c3d file.
This command requires data files to be stored in a particular folder structure to match .c3d files appropriately. Please carefully review the Notes section of this page for more details.
Pipeline Command
Below is the full pipeline command and parameters for Manage_File_Merge
Manage_File_Merge ! /ROOT_FOLDER= ! /HMX_INDEX_MASK= ! /USE_HMX_INDEX=FALSE ! /ACTION= ! /TAGS=ACTION ! /IMPORT_ANALOG_FILES=FALSE ! /MERGE_THEIA3D_FILES=FALSE ! /MERGE_THEIA3D_AND_OTHER_FILES=FALSE ! /MERGE_EVENT_LABELS=FALSE ! /THEIA3D_SESSION_FOLDER= ! /THEIA3D_FILE_MASK=*.c3d ! /THEIA3D_FILE_MASK_FOR_MODEL= ! /THEIA3D_PREFIX= ! /THEIA3D_SUBJECT_TAG= ! /THEIA3D_COLOR= ! /THEIA3D_SEX=UNKNOWN ! /CREATE_MODEL_FOR_EACH_C3D_FILE=FALSE ! /OTHER3D_SESSION_FOLDER= ! /OTHER3D_FILE_MASK= ! /OTHER3D_MODEL_MASK= ! /OTHER3D_MODEL_TEMPLATE_MASK= ! /OTHER3D_PREFIX= ! /OTHER3D_SUBJECT_TAG= ! /OTHER3D_COLOR= ! /NUMBER_OF_SESSION_FILES_ALLOWED= ! /SAVE_DEFAULT_CMZ_FILES=TRUE ! /DEFAULT_CMZ_NAME=<SESSION> ! /OPEN_CMZ_LIBRARY=FALSE ! /VIRTUAL_LAB= ! /INPUT_DATA_FOLDER_PRIMARY=DEFAULT ! /INPUT_DATA_FOLDER_SECONDARY=DEFAULT ! /INPUT_STATIC_DATA_FOLDER=DEFAULT ! /KINETIC_THORAX=RTA ! /ANALOG_FILTER_CUTOFF=12 ! /TARGET_FILTER_CUTOFF=12 ! /FP_AUTO_BASELINE=DO_NOT_COMPUTE ! /VISUAL3D_PIPELINE_POST_MERGE= ! /VISUAL3D_PIPELINE_PREMERGE= ;
Command Parameters
The following table shows the command parameters and descriptions:
Parameter | Description |
! /ROOT_FOLDER= | |
! /HMX_INDEX_MASK= | … |
! /USE_HMX_INDEX=FALSE | … |
! /ACTION= | … |
! /TAGS=ACTION | … |
! /IMPORT_ANALOG_FILES=FALSE | … |
! /MERGE_THEIA3D_FILES=FALSE | … |
! /MERGE_THEIA3D_AND_OTHER_FILES=FALSE | … |
! /MERGE_EVENT_LABELS=FALSE | … |
! /THEIA3D_SESSION_FOLDER= | … |
! /THEIA3D_FILE_MASK=*.c3d | … |
! /THEIA3D_FILE_MASK_FOR_MODEL= | … |
! /THEIA3D_PREFIX= | … |
! /THEIA3D_SUBJECT_TAG= | … |
! /THEIA3D_COLOR= | … |
! /THEIA3D_SEX=UNKNOWN | … |
! /CREATE_MODEL_FOR_EACH_C3D_FILE=FALSE | … |
! /OTHER3D_SESSION_FOLDER= | … |
! /OTHER3D_FILE_MASK= | … |
! /OTHER3D_MODEL_MASK= | … |
! /OTHER3D_MODEL_TEMPLATE_MASK= | … |
! /OTHER3D_PREFIX= | … |
! /OTHER3D_SUBJECT_TAG= | … |
! /OTHER3D_COLOR= | … |
! /NUMBER_OF_SESSION_FILES_ALLOWED= | … |
! /SAVE_DEFAULT_CMZ_FILES=TRUE | … |
! /DEFAULT_CMZ_NAME=<SESSION> | … |
! /OPEN_CMZ_LIBRARY=FALSE | … |
! /VIRTUAL_LAB= | … |
! /INPUT_DATA_FOLDER_PRIMARY=DEFAULT | … |
! /INPUT_DATA_FOLDER_SECONDARY=DEFAULT | … |
! /INPUT_STATIC_DATA_FOLDER=DEFAULT | … |
! /KINETIC_THORAX=RTA | … |
! /ANALOG_FILTER_CUTOFF=12 | … |
! /TARGET_FILTER_CUTOFF=12 | … |
! /FP_AUTO_BASELINE=DO_NOT_COMPUTE | … |
! /VISUAL3D_PIPELINE_POST_MERGE= | … |
! /VISUAL3D_PIPELINE_PREMERGE= | … |
Dialog
The command can be edited in a text editor or in a dialog form. To edit in the dialog pop up form either click on the Edit button in the pipeline workshop or double-click on the pipeline command. The dialog is shown below.
- Brief description of components (Combo boxes, acronyms, etc.)
Examples
Merge QTM and Theia
Merge Multiple QTM Files
Notes
- Important considerations (anything included in the page before the reformat)