User Tools

Site Tools


visual3d:tutorials:pipeline:generic_pipeline_to_create_cmz

This is an old revision of the document!


Generic Pipeline to Create CMZ

The Visual3D Command Pipeline can accomplish nearly every step used in the application's user interface. 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. A full command pipeline tutorial is available as part of the Visual3D typical processing session: Command Pipeline tutorial.

Download the Create CMZ ZIP File which contains a sample pipeline script used to make CMZs.

When writing a pipeline to build a CMZ file, your script should follow the general procedure outlined below. Although not in order, the commands used in this sample pipeline are listed.

Load Static Trial

  1. Create_Hybrid_Model: Load static C3D file
  2. Apply_Model_Template: Apply model template (MDH file)
    1. Tutorial to build a model template can be found here.
  3. 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

  1. File_Open: Load dynamic C3D files
  2. Assign_Model_File: Associated static trial with appropriate dynamic trials
    1. 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

  1. Select_Active_File: Set active file to ALL_FILES
  2. Set_Force_Platform_Threshold: Common minimum values are:
    1. Overground plates: 20 N
    2. Treadmill: 50 N
  3. Gap fill & Filter Target Data:
  4. Filter Analog data:
  5. If using treadmill data ONLY use FP_Auto_Baseline

Gait Events

Gait Events with Force Platforms

      1. Plot vertical component of KINETIC_KINEMATIC::LFT::FORCE_1
      1. Plot vertical component of KINETIC_KINEMATIC::RFT::FORCE_1
    1. Open_Force_Dialogs: Open force assignment dialog
    2. Switch_Between_Tabs: Switch to Signals and Events tag
    3. Pipeline_Breakpoint: Pause pipeline to manually check force assignments
      1. Remove any force assignment that is not clean
      2. Remove any partial force assignments (this includes force assignments at the start/end of the trial)
  1. Select_Active_File: Set active file to ALL_FILES
  2. Automatic_Gait_Events: Create gait events

Gait Events WITHOUT Force Platforms

Report and Data Review

  1. Open_Report_Template: Load report template (RGT file)
  2. 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.1738860203.txt.gz · Last modified: 2025/02/06 16:43 by wikisysop