visual3d:tutorials:pipeline:generic_pipeline_to_create_cmz
Table of Contents
Generic Pipeline to Create CMZ
Almost every step that can be accomplished using the user interface can also be accomplished using a pipeline command - the pipeline is essentially a set of commands/functions that allow you to streamline your data processing and reproducible for other subjects.
It's always recommended to learn the manual steps PRIOR to writing a pipeline command - learning the interface will help you build your pipeline.
When writing a pipeline to build a CMZ file, your script should follow the general procedure outlined below.
Load Static Trial
- Create_Hybrid_Model: Load static C3D file
- Apply_Model_Template: Apply model template (MDH file)
- Tutorial to build a model template can be found here.
- Set necessary model metrics (most metrics should be calculated based on markers, but height and weight always need to be entered manually):
Load Dynamic Trials
- File_Open: Load dynamic C3D files
- Assign_Model_File: Associated static trial with appropriate dynamic trials
- Note: If a marker falls off during data collection, you should re-take a static trial and associate the appropriate dynamic trials
Process Target and Analog Signals
- Select_Active_File: Set active file to ALL_FILES
-
- Set_Use_Processed_Targets: Set to TRUE
- Set_Use_Processed_Analog: Set to TRUE
- Set_Force_Platform_Threshold: Common minimum values are:
- Overground plates: 20 N
- Treadmill: 50 N
- Gap fill & Filter Target Data:
- Filter Analog data:
- If using treadmill data ONLY use FP_Auto_Baseline
Gait Events
Gait Events with Force Platforms
-
-
- Plot vertical component of KINETIC_KINEMATIC::LFT::FORCE_1
-
- Plot vertical component of KINETIC_KINEMATIC::RFT::FORCE_1
- Open_Force_Dialogs: Open force assignment dialog
- Switch_Between_Tabs: Switch to Signals and Events tag
- Pipeline_Breakpoint: Pause pipeline to manually check force assignments
- Remove any force assignment that is not clean
- Remove any partial force assignments (this includes force assignments at the start/end of the trial)
-
- Select_Active_File: Set active file to ALL_FILES
- Automatic_Gait_Events: Create gait events
Gait Events WITHOUT Force Platforms
Report and Data Review
- Open_Report_Template: Load report template (RGT file)
- Stop pipeline to review data prior to export:
Notes:
- Many users are skipping report templates - but it's highly recommended to even create a simple report template to review data prior to export. No data collection is perfect, and reviewing the data prior to exporting ensures the data is a quality assurance step.
- Instructions to create a report template can be found here
- The report template contains any signals defined using the Compute Model Based Function
Signal Definitions and Processing
Export
Save
visual3d/tutorials/pipeline/generic_pipeline_to_create_cmz.txt · Last modified: 2024/07/17 11:47 by sgranger