User Tools

Site Tools


visual3d:documentation:pipeline:pipeline_commands:manage_file_merge

This is an old revision of the document!


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

- Table with parameters and descriptions (include link to parameter wiki pages if they are available)

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)

visual3d/documentation/pipeline/pipeline_commands/manage_file_merge.1748446891.txt.gz · Last modified: 2025/05/28 15:41 by wikisysop