For Visual3D Users

Documentation Reference GuideFor Visual3D Users

This page contains useful information for users who are outputting motion capture data from Motive into Visual3D.

For more information on Visual3D: C-Motion wiki

Visual3D biomechanics analysis software provided by C-Motion

Data Export: C3D[edit]


C3D export setting for applications using z-up right-handed coordinate systems.

Since Motive uses a different coordinate system than the system used in common biomechanics applications, it is necessary to modify the coordinate axis to a compatible convention in the C3D exporter settings. For biomechanics applications using z-up right-handed convention (e.g. Visual3D), the following changes must be made under the custom axis.

  • X axis in Motive should be configured to positive X
  • Y axis in Motive should be configured to negative Z
  • Z axis in Motive should be configured to positive Y.

This will convert the coordinate axis of the exported data so that the x-axis represents the anteroposterior axis (left/right), the y-axis represents the mediolateral axis (front/back), and the z-axis represents the longitudinal axis (up/down).


Streaming to Visual3D[edit]


Streaming tracking data into the Visual3D requires 2-step pipelines. Motive streams tracking data first into the Visual3D Server, and then from this application the data is streamed into Visual3D.

Data streaming settings of Motive for outputting data into Visual3D

On Motive[edit]

When streaming into Visual3D Server, set the stream Visual3D Compatible to true in the Data Streaming Pane. This will modify the axis of the streamed data. This setting is configured as the advanced setting by default. Click Show Advanced to bring up this setting.

Info2.png

Advanced Settings

Newly redesigned panes, including For Visual3D Users, contains advanced settings that are hidden by default. Access these settings by going to the menu on the top-right corner of the pane and clicking Show Advanced and all of the settings, including the advanced settings, will be listed under the pane.

The list of advanced settings can also be customized to show only the settings that are needed specifically for your capture application. To do so, go the pane menu and click Edit Advanced, and uncheck the settings that you wish to be listed in the pane by default. One all desired settings are unchecked, click Done Editing to apply the customized configurations.

ShowAdvancedSettings.png EditAdvancedSettings.png EditAdvancedSettings Done.png

On Visual3D Server/Visual3D[edit]

Please refer to Visua3D docmentation for more information about the receiving streamed data in visual 3D. For more info: Visual3D Server to Visual3D.

V3S: Correcting Sync Offset[edit]


The following pipeline commands can be used in Visual3D to accommodate systematic synchronization offset frames between recorded mocap tracking data and another data. Save and import these commands into the Visual3D pipeline dialogue to execute the commands. For more information on Visual3D pipeline commands, refer to the c-motion wiki (https://www.c-motion.com/v3dwiki/index.php/Visual3D_Pipeline).


For a Single C3D[edit]

Prompt_For_Pipeline_Parameter_Value
/PIPELINE_PARAMETER_NAME=FRAME_OFFSET
/PROMPT=Please enter the frame offset, at POINT rate.
! /DATA_TYPE=
! /DEFAULT_VALUE=
! /USE_POSSIBLE_VALUES=FALSE
! /POSSIBLE_VALUES=
! /USE_UNITS=FALSE
! /DEFAULT_UNITS=
! /USE_POSSIBLE_UNITS=FALSE
! /POSSIBLE_UNITS=
! /CONVERSIONS=
;

Set_Use_Processed_Analog
 /USE_PROCESSED=TRUE
;

Shift_Frames
/SIGNAL_TYPES=ANALOG
! /SIGNAL_FOLDER=ORIGINAL
! /SIGNAL_NAMES=
! /RESULT_FOLDER=PROCESSED
! /RESULT_SUFFIX=
 /FRAME_SHIFT=-&::FRAME_OFFSET
 /REPLACEMENT_VALUE=0
;
Recalc
;

For Multiple C3D Trials[edit]

File_New

;

File_Open
! /FILE_NAME=
! /SUFFIX=
 /SET_PROMPT=File .C3D files with data offsets
 /FILTER=c3d
;

Set_Pipeline_Parameter_To_List_Of_Tagged_Files
/PARAMETER_NAME=FILE_LIST
/TAG_NAME=ALL_FILES
! /GET_CURRENT_SELECTED_FILES=false
! /USE_SHORT_FILENAMES=false
;

Set_Use_Processed_Analog
 /USE_PROCESSED=TRUE
;

Switch_to_Event_Processing_Mode

;

For_Each
/ITERATION_PARAMETER_NAME=FRAME_OFFSET_CYCLE
! /ITERATION_PARAMETER_COUNT_NAME=
 /ITEMS=::FILE_LIST
;

Select_Active_File
/FILE_NAME=::FRAME_OFFSET_CYCLE
! /QUERY=
;

Pipeline_Breakpoint
/PAUSE_MESSAGE=Confirm the exact number frame count offset between the POINT and ANALOG data for the current file.
Click "Resume Pipeline" when ready.
;

Prompt_For_Pipeline_Parameter_Value
/PIPELINE_PARAMETER_NAME=FRAME_OFFSET
/PROMPT=Please enter the frame offset, at POINT rate. NEGATIVE offset = Late ANALOG data
! /DATA_TYPE=
! /DEFAULT_VALUE=
! /USE_POSSIBLE_VALUES=FALSE
! /POSSIBLE_VALUES=
! /USE_UNITS=FALSE
! /DEFAULT_UNITS=
! /USE_POSSIBLE_UNITS=FALSE
! /POSSIBLE_UNITS=
! /CONVERSIONS=
;

Evaluate_Expression
/EXPRESSION=(PARAMETERS::ANALOG::RATE/PARAMETERS::POINT::RATE)
! /SIGNAL_TYPES=
! /SIGNAL_FOLDER=ORIGINAL
! /SIGNAL_NAMES=
! /RESULT_TYPES=DERIVED
! /RESULT_FOLDERS=PROCESSED
 /RESULT_NAME=RATE_RATIO
! /APPLY_AS_SUFFIX_TO_SIGNAL_NAME=FALSE
;

Shift_Frames
/SIGNAL_TYPES=ANALOG
! /SIGNAL_FOLDER=ORIGINAL
! /SIGNAL_NAMES=
! /RESULT_FOLDER=PROCESSED
! /RESULT_SUFFIX=
 /FRAME_SHIFT=::FRAME_OFFSET&*&DERIVED::PROCESSED::RATE_RATIO
 /REPLACEMENT_VALUE=0
;

Recalc

;