HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » visual3d » tutorials » pipeline » Generic Pipeline to Create CMZ
visual3d:tutorials:pipeline:generic_pipeline_to_create_cmz

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
visual3d:tutorials:pipeline:generic_pipeline_to_create_cmz [2024/07/17 15:24] – sgrangervisual3d:tutorials:pipeline:generic_pipeline_to_create_cmz [2025/02/12 16:56] (current) – [Export & Save] sgranger
Line 1: Line 1:
 ====== Generic Pipeline to Create CMZ ====== ====== 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.+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.+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: [[visual3d:tutorials:pipeline:command_pipeline| Command Pipeline tutorial]].
  
-[[https://www.has-motion.com/download/examples/Pipelines/Building_CMZ.zip|Download sample script]]+Download the [[https://www.has-motion.com/download/examples/Pipelines/Building_CMZ.zip|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.+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 ===== ===== Load Static Trial =====
 +|**Command**|**Description**|
 +|[[Visual3D:Documentation:Pipeline:Model_Commands:Create_Hybrid_Model|Create_Hybrid_Model]]|Load static C3D file|
 +|[[Visual3D:Documentation:Pipeline:Model_Commands:Apply_Model_Template|Apply_Model_Template]]|Apply model template (MDH File). \\ - Tutorial to build a model template can be found here: [[Visual3D:Tutorials:Modeling:Building_a_6_DOF_Model_|Building a 6 DOF Model]].|
 +|[[Visual3D:Documentation:Pipeline:Model_Commands:Set_Subject_Height|Set_Subject_Height]] \\ [[Visual3D:Documentation:Pipeline:Model_Commands:Set_Subject_Weight|Set_Subject_Weight]]|Set necessary model metrics (most metrics should be calculated based on markers, but height and weight always need to be entered manually).|
  
-  - [[Visual3D:Documentation:Pipeline:Model_Commands:Create_Hybrid_Model|Create_Hybrid_Model]]: Load static C3D file 
-  - [[Visual3D:Documentation:Pipeline:Model_Commands:Apply_Model_Template|Apply_Model_Template]]: Apply model template (MDH file) 
-    - Tutorial to build a model template can be found [[Visual3D:Tutorials:Modeling:Building_a_6_DOF_Model_|here]]. 
-  - Set necessary model metrics (most metrics should be calculated based on markers, but height and weight always need to be entered manually): 
-    - [[Visual3D:Documentation:Pipeline:Model_Commands:Set_Subject_Height|Set_Subject_Height]] 
-    - [[Visual3D:Documentation:Pipeline:Model_Commands:Set_Subject_Weight|Set_Subject_Weight]] 
  
 ===== Load Dynamic Trials ===== ===== Load Dynamic Trials =====
- +|**Command**|**Description**| 
-  - [[Visual3D:Documentation:Pipeline:File_Commands:File_Open|File_Open]]: Load dynamic C3D files +|[[Visual3D:Documentation:Pipeline:File_Commands:File_Open|File_Open]]|Load dynamic C3D Files.| 
-  - [[Visual3D:Documentation:Pipeline:Model_Commands:Assign_Model_File|Assign_Model_File]]: Associated static trial with appropriate dynamic trials +|[[Visual3D:Documentation:Pipeline:Model_Commands:Assign_Model_File|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.|
-    - 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 ===== ===== Process Target and Analog Signals =====
- +|**Command**|**Description**| 
-  - [[Visual3D:Documentation:Pipeline:File_Commands:Select_Active_File|Select_Active_File]]: Set active file to ALL_FILES +|[[Visual3D:Documentation:Pipeline:File_Commands:Select_Active_File|Select_Active_File]]|Set active file to ALL_FILES.| 
-  - [[Visual3D:Documentation:Visual3D_Signal_Types:Used_Process|Set Use Processed:]] +|[[Visual3D:Documentation:Pipeline:Other_Commands:Set_Use_Processed_Targets|Set_Use_Processed_Targets]]: Set to TRUE \\ [[Visual3D:Documentation:Pipeline:Other_Commands:Set_Use_Processed_Analog|Set_Use_Processed_Analog]]: Set to TRUE| [[Visual3D:Documentation:Visual3D_Signal_Types:Used_Process|Set Use Processed]]: The PROCESSED folder should contain your interpolated or filtered data. If you tell Visual3D to use the PROCESSED folders, Visual3D will use the processed signals for kinetic/kinematic calculations.| 
-    - [[Visual3D:Documentation:Pipeline:Other_Commands:Set_Use_Processed_Targets|Set_Use_Processed_Targets]]: Set to TRUE +|[[Visual3D:Documentation:Pipeline:Force_Commands:Set_Force_Platform_Threshold|Set_Force_Platform_Threshold]]| Common minimum values are: \\ - Overground plates: 20N \\ - Treadmill: 50N| 
-    - [[Visual3D:Documentation:Pipeline:Other_Commands:Set_Use_Processed_Analog|Set_Use_Processed_Analog]]: Set to TRUE +|[[Visual3D:Documentation:Pipeline:Signal_Commands:Interpolate|Interpolate]] \\ [[Visual3D:Documentation:Pipeline:Signal_Commands:Lowpass_Filter|Lowpass_Filter]]| Gap fill and Filter Target Data, Low Pass Filter can be used to filter Analog data| 
-  - [[Visual3D:Documentation:Pipeline:Force_Commands:Set_Force_Platform_Threshold|Set_Force_Platform_Threshold]]: Common minimum values are: +|[[Visual3D:Documentation:Pipeline:Force_Commands:FP_Auto_Baseline|FP_Auto_Baseline]] \\ [[Visual3D:Documentation:Pipeline:File_Commands:Recalc|Recalc]]| If using treadmill data, ONLY use FP_Auto_Baseline.|
-    - Overground plates: 20 N +
-    - Treadmill: 50 N +
-  - Gap fill & Filter Target Data: +
-    - [[Visual3D:Documentation:Pipeline:Signal_Commands:Interpolate|Interpolate]] +
-    - [[Visual3D:Documentation:Pipeline:Signal_Commands:Lowpass_Filter|Lowpass_Filter]] +
-  - Filter Analog data: +
-    - [[Visual3D:Documentation:Pipeline:Signal_Commands:Lowpass_Filter|Lowpass_Filter]] +
-  - If using treadmill data ONLY use [[Visual3D:Documentation:Pipeline:Force_Commands:FP_Auto_Baseline|FP_Auto_Baseline]] +
-  - [[Visual3D:Documentation:Pipeline:File_Commands:Recalc|Recalc]]+
  
 ===== Gait Events ===== ===== Gait Events =====
Line 45: Line 33:
 ==== Gait Events with Force Platforms ==== ==== Gait Events with Force Platforms ====
  
-  - [[Visual3D:Documentation:Definitions:Clean_Foot_Strike|Check for clean force assignments]] +The following commands are involved in **checking for clean force assignments**. For example, refer to the [[Visual3D:Documentation:Definitions:Clean_Foot_Strike|Clean Foot Strike]] documentation. A "clean" foot strike indicates that measurements from the force platform are able to be used for analysis, and will not cause incorrect events to be created or produce "bad" kinetic calculations (GRF, Joint Moments, etc.). 
-    - [[Visual3D:Documentation:Pipeline:Report_Commands:Interactive_Graph_Signals|Interactive_Graph_Signals]]: + 
-      - Plot vertical component of KINETIC_KINEMATIC::LFT::FORCE_1 +|**Command**|**Description**| 
-    - [[Visual3D:Documentation:Pipeline:Report_Commands:Interactive_Graph_Signals|Interactive_Graph_Signals]]: +|[[Visual3D:Documentation:Pipeline:Report_Commands:Interactive_Graph_Signals|Interactive_Graph_Signals]]|Plot vertical component of **KINETIC_KINEMATIC::LFT::FORCE_1** and **KINETIC_KINEMATIC::RFT::FORCE_1 signals.**| 
-      - Plot vertical component of KINETIC_KINEMATIC::RFT::FORCE_1 +|[[Visual3D:Documentation:Pipeline:Other_Commands:Open_Force_Dialogs|Open_Force_Dialogs]]| Open force assignment dialog.| 
-    - [[Visual3D:Documentation:Pipeline:Other_Commands:Open_Force_Dialogs|Open_Force_Dialogs]]: Open force assignment dialog +|[[Visual3D:Documentation:Pipeline:Other_Commands:Switch_Between_Tabs|Switch_Between_Tabs]]|Switch to Signals and Events tab.| 
-    - [[Visual3D:Documentation:Pipeline:Other_Commands:Switch_Between_Tabs|Switch_Between_Tabs]]: Switch to Signals and Events tag +|[[Visual3D:Documentation:Pipeline:Pipeline_Commands:Pipeline_Breakpoint|Pipeline_Breakpoint]]|Pause pipeline to manually check force assignments: \\ a. Remove any force assignment that is not __clean.__ \\ b. Remove any partial force assignments (this includes force assignments at the start/end of the trial.)| 
-    - [[Visual3D:Documentation:Pipeline:Pipeline_Commands:Pipeline_Breakpoint|Pipeline_Breakpoint]]: Pause pipeline to manually check force assignments +|[[Visual3D:Documentation:Pipeline:File_Commands:Select_Active_File|Select_Active_File]]| Set active file to ALL_FILES.| 
-      - Remove any force assignment that is not [[Visual3D:Documentation:Definitions:Clean_Foot_Strike|clean]] +|[[Visual3D:Documentation:Pipeline:Event_Commands:Automatic_Gait_Events|Automatic_Gait_Events]]|Create gait events.|
-      - Remove any partial force assignments (this includes force assignments at the start/end of the trial) +
-  - [[Visual3D:Documentation:Pipeline:File_Commands:Select_Active_File|Select_Active_File]]: Set active file to ALL_FILES +
-  - [[Visual3D:Documentation:Pipeline:Event_Commands:Automatic_Gait_Events|Automatic_Gait_Events]]: Create gait events+
  
 ==== Gait Events WITHOUT Force Platforms ==== ==== Gait Events WITHOUT Force Platforms ====
 +When force data is not available, there are several methods for computing gait events using kinematic data, an overview of this process can be seen in [[Visual3D:Documentation:Pipeline:Event_Commands:Example_-_Gait_Events_using_Kinematic_Data|Example - Kinematic Gait Events.]]
  
-  - [[Visual3D:Documentation:Pipeline:Event_Commands:Example_-_Gait_Events_using_Kinematic_Data|Kinematic Gait Events]] 
  
 ===== Report and Data Review ===== ===== Report and Data Review =====
 +|**Command**|**Description**|
 +|[[Visual3D:Documentation:Pipeline:Report_Commands:Open_Report_Template|Open_Report_Template]]|Load report template (RGT File).|
 +|[[Visual3D:Documentation:Pipeline:Other_Commands:Switch_Between_Tabs|Switch_Between_Tabs]] \\ [[Visual3D:Documentation:Pipeline:Pipeline_Commands:Pipeline_Breakpoint|Pipeline_Breakpoint]]|Stop pipeline to review data prior to export.|
  
-  - [[Visual3D:Documentation:Pipeline:Report_Commands:Open_Report_Template|Open_Report_Template]]: Load report template (RGT file) +**NOTE**:
-  - Stop pipeline to review data prior to export: +
-    - [[Visual3D:Documentation:Pipeline:Other_Commands:Switch_Between_Tabs|Switch_Between_Tabs]] +
-    - [[Visual3D:Documentation:Pipeline:Pipeline_Commands:Pipeline_Breakpoint|Pipeline_Breakpoint]] +
- +
-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.   * 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 [[Visual3D:Tutorials:Reports:Creating_a_Report|here]] +  * Instructions to create a report template can be found [[Visual3D:Tutorials:Reports:Creating_a_Report|here.]] 
-  * The report template contains any signals defined using the [[Visual3D:Documentation:Visual3D_Signal_Types:LINK_MODEL_BASED_Data_Type#Link_Model_Based_Items|Compute Model Based Function]]+  * The report template contains any signals defined using the [[Visual3D:Documentation:Visual3D_Signal_Types:LINK_MODEL_BASED_Data_Type#Link_Model_Based_Items|Compute Model Based Function.]]
  
 ===== Signal Definitions and Processing ===== ===== Signal Definitions and Processing =====
 +|**Command**|**Description**|
 +|[[Visual3D:Documentation:Pipeline:Signal_Commands:Signal_Commands_Overview|Calculate Additional Signals]]| Signal math commands, allow you to create custom mathematical expressions.|
 +|[[Visual3D:Documentation:Pipeline:Metric_Commands:Metric_Commands_Overview|Calculate Metrics]]| Calculate Metrics, discrete quantitative values of signals such as maximum value, median value, value at a specified frame.|
  
-  - [[Visual3D:Documentation:Pipeline:Signal_Commands:Signal_Commands_Overview|Calculate Additional Signals]] +===== Export & Save ===== 
-  - [[Visual3D:Documentation:Pipeline:Metric_Commands:Metric_Commands_Overview|Calculate Metrics]] +|**Command**|**Description**| 
- +|[[Visual3D:Documentation:Pipeline:File_Commands:Export_Data_To_ASCII_File|Export data to a text file]]|Converts data from the Data Tree into ASCII (plain text) data.| 
-===== Export ===== +|[[Visual3D:Documentation:Pipeline:File_Commands:File_Save|Save CMZ]]|Saves Workspace file as CMZ.|
- +
-  - [[Visual3D:Documentation:Pipeline:File_Commands:Export_Data_To_ASCII_File|Export data to a text file]] +
- +
-===== Save =====+
  
-  - [[Visual3D:Documentation:Pipeline:File_Commands:File_Save|Save CMZ]] 
  
  
  
visual3d/tutorials/pipeline/generic_pipeline_to_create_cmz.1721229846.txt.gz · Last modified: 2024/07/17 15:24 by sgranger