Tutorial Theia3D Merge

(work in progress as Manage_Theia3D_Merge is a hidden command in Visual3D that is still be tested before release)

This tutorial demonstrates the merging of Theia3D output c3d files and other c3d files.

The typical scenario is Theia3D output and analog signals with force platform parameters

Merging C3D files interactively

Demo Files

Download the [zip file] containing folder paths and files for this tutorial.

Open Theia3D C3D File

If you use TMBATCH, select the default folder paths, which should be in the form.

STUDY : GROUP : SESSION : ACTION : TRIAL : pose_filt_0.c3d

The relative path for this example data is:

...\Visual3D_Tutorial\001_THEIA\WALK\001\pose_filt_0.c3d

Open this file:

Visual3D recognizes this as a Theia3D output file and will automatically create a model and assign the motion file.

The workspace status TAB will display the model and movement trial.

Note that the standing trial was created virtually based on the c3d parameters in the movement trial

The name of the static file is the name of the first movement file loaded with _Static applied to the name.

Switch to Model Builder mode.

The segments and landmarks have been created automatically.

Edit the Right Thigh segment

Note that Theia3D stores ROTATION signals, not TARGETS.

If a ROTATION signal is selected for a location, only the position information is used from the signal

The "Ignore Calibaration" button is selected as Theia3D exports the 6 DOF pose of the segment.

Unless there is a reason to modify the coordinate system, the default is to assign the ROTATION signal to the pose of the segment.

Switch to the Signals and Events TAB and animate the motion file.

Note the ROTATION folder is open in this image displaying the ROTATION signals exported by Theia3D.

Import Analog signals and Force Platform parameters from QTM C3D File

The QTM files should be stored in the following

STUDY : GROUP : SESSION_QTM : ACTION : Trial#.c3d

The QTM filenames should be similar to the Theia3D TRIAL path name. For example,

The relative path for this example data is:

\Visual3D_Tutorial\001_QTM\WALK\MoCapNwalk_001.c3d

Use the following command to import analog signals and force platform parameters from the QTM generated c3d file.

Import_Signals_From_C3D_File

For this example, we only need to specify a few of the possible parameters for this command and leave the remaining parameters to their default values

Import_Signals_From_C3D_File

/ANALOG_RATIO=5

/IMPORT_FORCE_PLATFORM_PARAMETERS=TRUE

;

After executing this command the analog signals and force platform parameters have been added to the Theia3D file.

Exporting the merged C3D file (Optional)

The resulting C3D file is still named pose_filt_0.c3d, which is a bit of a nuisance in Visual3D as the short filename for all files would be the same.

From the File menu, open the Export subfolder and select Export C3D File. The Export C3D File dialog box will open.

From the File to Export drop down Select pose_filt_0.c3d.

Click Browse.

From the Save As dialog box browse to the location where you store your files and enter New_Filename.c3d in the File name field.
Note:

Click Save.

From the Export C3D File dialog box Click Export.
Note: Leave all other options at the default values. Many of these options are available to handle irregularities in the c3d file format, and should only be used when necessary.

Given the merged c3d file, you can save the file as a cmz file

or you can export the c3d file

Pipeline command Manage_Theia3D_Merge

Import Analog Signals

Visual3D has a pipeline command dedicated to merging theia3D output files with other output files containing analog signals and force platform parameters

In order to automate the merge, it was necessary to make some assumptions about filenames and folder paths.

If you use Theia's TMBATCH, select the default folder paths. This should be in the form.

STUDY : GROUP : SESSION_THEIA : ACTION : TRIAL : pose_filt_0.c3d

The Qualisys files should be stored in the following

STUDY : GROUP : SESSION_QTM : ACTION : Trial#.c3d

The QTM filenames should be similar to the Theia3D TRIAL path name. For this tutorial the file paths begin at the session level,

001_THEIA : WALK : TRIAL1 : pose_filt_0.c3d

001_QTM : WALK : Trial1.c3d

​

having all files named pose_filt_0.c3d is a bit of a nuisance for Visual3D and the files are renamed by the command.

The new name is a concatenation of the name and TRIAL name. For this example

​::WALK_TRIAL1.c3d

​:Having the sessions in parallel was implemented because Theia3D keeps evolving and there may be multiple versions of the Theia3D Session. 

For example: SESSION_V2 and SESSION_V3

Getting the Theia3D files into this folder structure is straightforward as it is the default from Theia.

Note that the command requires the specification of the full root folder.

For this documentation I have represented all but the last folder in the hierarchy

Caption

Manage_Theia3D_Merge

/ROOT_FOLDER=...\Visual3D_Theia_Tutorial\

! /ACTION=

! /TAGS=ACTION

/IMPORT_ANALOG_FILES=TRUE

! /MERGE_THEIA3D_FILES=FALSE

/THEIA3D_SESSION_FOLDER=001_THEIA

/THEIA3D_FILE_MASK=*pose_filt_0.c3d

! /THEIA3D_PREFIX=

! /THEIA3D_SUBJECT_TAG=

/OTHER3D_SESSION_FOLDER=001_QTM

/OTHER3D_FILE_MASK=*walk*.c3d

! /OTHER3D_MODEL_MASK=

! /OTHER3D_MODEL_TEMPLATE_MASK=

! /OTHER3D_PREFIX=

! /OTHER3D_SUBJECT_TAG=

! /NUMBER_OF_SESSION_FILES_ALLOWED=

! /OPEN_CMZ_LIBRARY=FALSE

! /INPUT_FOLDER_STRUCTURE=DEFAULT

;

Merge Targets and Analog Signals

The following command options merge Theia3D files with QTM files that have markers, a standing trial, and a model template. To distinguis the marker and markerless data, subject prefixes can be added. The result will have two model associated with the movement trials.

Manage_Theia3D_Merge

/ROOT_FOLDER=\\vmware-host\Shared Folders\Desktop\Visual3D Stuff\Test Files\_Markerless\2022_0826_Qualisys_golf\

! /ACTION=

! /TAGS=ACTION

! /IMPORT_ANALOG_FILES=FALSE

/MERGE_THEIA3D_FILES=TRUE

/THEIA3D_SESSION_FOLDER=Session

/THEIA3D_FILE_MASK=*pose_filt_0.c3d

/THEIA3D_PREFIX=ML:

/THEIA3D_SUBJECT_TAG=ML

/OTHER3D_SESSION_FOLDER=Session_QTM

/OTHER3D_FILE_MASK=*dynamic*.c3d

/OTHER3D_MODEL_MASK=*static*.c3d

! /OTHER3D_MODEL_TEMPLATE_MASK=

/OTHER3D_PREFIX=M:

/OTHER3D_SUBJECT_TAG=M

! /NUMBER_OF_SESSION_FILES_ALLOWED=

! /OPEN_CMZ_LIBRARY=FALSE

! /INPUT_FOLDER_STRUCTURE=DEFAULT

;