HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » visual3d » tutorials » knowledge_discovery » Typical Processing Session Overview Tutorial
visual3d:tutorials:knowledge_discovery:typical_processing_session

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:knowledge_discovery:typical_processing_session [2025/02/07 19:44] – [Applying a model template] wikisysopvisual3d:tutorials:knowledge_discovery:typical_processing_session [2025/02/07 20:50] (current) – [Creating model based items] wikisysop
Line 16: Line 16:
  
  
-==== Creating A Model ====+===== Creating a Model =====
 Open the Visual3D application to an empty Workspace. The first step will be to create the model, following these steps: Open the Visual3D application to an empty Workspace. The first step will be to create the model, following these steps:
  
Line 23: Line 23:
 {{:visual3d:tutorials:knowledge_discovery:addstatic_model.png?300|}} {{:visual3d:tutorials:knowledge_discovery:addstatic_model.png?300|}}
  
-2. Select **LowerBodyStaticTrial01.c3d.** Click **Open.** from the Select Files dialog.+2. Select **LowerBodyStaticTrial01.c3d.** Click **Open** from the Select Files dialog.
  
 Visual3D will then switch to Model Building mode automatically. The 3D viewer will display the average value of the marker locations from the standing file. The dialog bar to the left of the screen will contain a list of segments, which by default will contain only a segment representing the Laboratory (e.g. Motion Capture Volume).\\   {{:TPS_StaticTrial.png?600}} Visual3D will then switch to Model Building mode automatically. The 3D viewer will display the average value of the marker locations from the standing file. The dialog bar to the left of the screen will contain a list of segments, which by default will contain only a segment representing the Laboratory (e.g. Motion Capture Volume).\\   {{:TPS_StaticTrial.png?600}}
Line 29: Line 29:
  
  
-==== Applying a Model Template ====+===== Applying a Model Template =====
  
-In this section, you will apply a previously constructed model template. If you don't have a [[Visual3D:Documentation:Modeling:Model_Templates|model template]] (.mdh file) for this standing trial, please complete the [[Visual3D:Tutorials:Modeling:Building_a_6_DOF_Model_|Model Building Tutorial]] which describes the process for building a model and creating a template.+In the next section, you will apply a previously constructed model template. If you don't have a [[Visual3D:Documentation:Modeling:Model_Templates|Model Template]] (.mdh file) for this standing trial, please complete the [[Visual3D:Tutorials:Modeling:Building_a_6_DOF_Model_|Model Building Tutorial]] which describes the process for building a model and creating a template.
  
-If you have a model template, then:+If you have a model template, then follow these steps: 
 + 
 +**1. Apply Model Template:** Go to Model menu dropdown -> select Apply Model Template, a dialog box will open prompting you to select your template file.  
 +\\ 
 +{{:visual3d:tutorials:knowledge_discovery:apply_model_template.png?300|}}
  
-|**1. Apply the model template:**\\ \\ 1a. Go to Model -> Apply Model Template\\ \\ 1a. In the dialog, select the model template ""\\ \\ **2. Set the subject height/weight:**\\ \\ 2a. In the models tab, go to **Subject Data/Metrics**\\ \\ 2b. Double click on the value next to Mass listed under Expression\\ \\ 2c. Double click on the value next to Height listed under Expression  |  | 
  
 +**2. Set Subject Height/Weight:** In the models tab, go to the **Subject Data/Metrics** section.
 \\ \\
 +{{:visual3d:tutorials:knowledge_discovery:subject_data_metrics_tab.png?300|}}
 +
 +
 +To edit the values of the mass and height, double click on the value next to each listed under the column header "Expression" and edit to your choosing in each dialog box.
 +\\
 +{{:visual3d:tutorials:knowledge_discovery:model_metrics_dialog.png?400|}}
 +
  
  
Line 44: Line 55:
 Pipeline commands can be used to apply the model template and set the subject height/weight. These commands can be edited to look for specific files, or if parameters are left blank, they will prompt the user for relevant information. Pipeline commands can be used to apply the model template and set the subject height/weight. These commands can be edited to look for specific files, or if parameters are left blank, they will prompt the user for relevant information.
  
-1. [[Visual3D:Documentation:Pipeline:Model_Commands:Apply_Model_Template|Apply Model Template]] command +|[[Visual3D:Documentation:Pipeline:Model_Commands:Apply_Model_Template|Apply Model Template]]| 
-2. [[Visual3D:Documentation:Pipeline:Model_Commands:Set_Subject_Height|Set Subject Height]] command +|[[Visual3D:Documentation:Pipeline:Model_Commands:Set_Subject_Height|Set Subject Height]]| 
-3. [[Visual3D:Documentation:Pipeline:Model_Commands:Set_Subject_Weight|Set Subject Weight]] command+|[[Visual3D:Documentation:Pipeline:Model_Commands:Set_Subject_Weight|Set Subject Weight]]| 
 A great example of applying a model template can be found on the following pages [[Visual3D:Documentation:Pipeline:Pipeline_Commands:Pipeline_Example_Adding_Files_to_Workspace|Pipeline Processing Example 1]] and [[|Pipeline Processing Example 2]]. A great example of applying a model template can be found on the following pages [[Visual3D:Documentation:Pipeline:Pipeline_Commands:Pipeline_Example_Adding_Files_to_Workspace|Pipeline Processing Example 1]] and [[|Pipeline Processing Example 2]].
  
-==== Opening movement files ====+ 
 + 
 +===== Opening movement files =====
  
 This section will open/add the movement files to the model that was created in the previous sections on this page. This section will open/add the movement files to the model that was created in the previous sections on this page.
  
 +If you were able to successfully load the static trial and apply the model template by following the steps above, the static trial should appear in the Workspace tab. This means you are ready to continue onto the next step.
 \\ \\
 +{{:TPS_Workspace_Static.png?500}}
  
  
-|If you were able to successfully load the static trial and apply the model template by following the steps above, the static trial should appear in the Workspace tab.\\ \\ This means you are ready to continue onto the next step.  |  {{:TPS_Workspace_Static.png}}|+**1. Load the dynamic trials:** 
 +\\ 
 +a. File -> Open/Add 
 +\\ 
 +b. Select **Insert new files into your currently open workspace** option 
 +\\ 
 +c. Select **WalkingTrial_01.c3d**
  
-|**1. Load the dynamic trials**\\ \\ a. File -> Open/Add...\\ \\ b. Select **Insert new files into your currently open workspace**\\ \\ c. Select "WalkingTrial_01.c3d"\\ \\ \\   |  {{:TPS_InsertNewFiles.png}}\\ |+{{:TPS_InsertNewFiles.png}}\\ 
  
-|**Verify -** Verify the model file named //WalkingTrial_01.c3d// appears in the column labeled **Motion Files.** Visual3D displays the [[Visual3D:Documentation:Definitions:Active_Files|active file]] in the Motion Files column, but not directly beside the static trial file.\\   |  {{:TPS_Workspace_Dynamic.png}}\\ |+**Verify: ** Verify the model file named **WalkingTrial_01.c3d** appears in the column labeled **Motion Files.** Visual3D displays the [[Visual3D:Documentation:Definitions:Active_Files|active file]] in the Motion Files column, but not directly beside the static trial file. 
 +\\ 
 + {{:TPS_Workspace_Dynamic.png}}
  
-|**Verify -** Click on the **Signal and Event Processing** Tab. The viewing area will open. At this point, the movement trial has not been associated (or mapped) to the model trial. In the viewing area, only the markers will be animated.\\ \\ **Note:** If no image appears, verify that there is a single active file in the file name box.\\ \\ To activate the animation, click on the arrowhead PLAY {{:play.jpg}} button at the bottom of the screen. The marker figure should walk across the screen. However, no bones will appear.  |  {{:TPS_SignalsAndEvents_NotAssigned.png}}| 
  
 +**Verify: ** Click on the **Signal and Event Processing** Tab. The viewing area will open. At this point, the movement trial has not been associated (or mapped) to the model trial. In the viewing area, only the markers will be animated.
 \\ \\
  
 +**Note:** If no image appears, verify that there is a single active file in the file name box.
 +\\
  
 +To activate the animation, click on the arrowhead PLAY {{:play.jpg}} button at the bottom of the screen. The marker figure should walk across the screen. However, no bones will appear.
 +\\
 +{{:TPS_SignalsAndEvents_NotAssigned.png?500}}|
 +
 +\\
 === Using a Pipeline Command === === Using a Pipeline Command ===
  
Line 73: Line 104:
 A great example of assigning models to motion files can be found on the following pages [[Visual3D:Documentation:Pipeline:File_Commands:File_Open|File Open]]. A great example of assigning models to motion files can be found on the following pages [[Visual3D:Documentation:Pipeline:File_Commands:File_Open|File Open]].
  
-==== Assigning movement files to a model ====+===== Assigning movement files to a model =====
  
 In the previous sections, the movement files were added and the model template was applied to the static standing trial. These movement files need to be associated or assigned with static standing model file. When movement files are assigned to a model, the pose (position and orientation) of each segment and landmarks in the model are computed for the motion file. To assign the movement files to a model, follow these steps: In the previous sections, the movement files were added and the model template was applied to the static standing trial. These movement files need to be associated or assigned with static standing model file. When movement files are assigned to a model, the pose (position and orientation) of each segment and landmarks in the model are computed for the motion file. To assign the movement files to a model, follow these steps:
  
-|**1. Assign model to motion trial**\\ \\ a. Model -> Assign Model to Motion Files\\ \\ b. Select the checkbox next to WalkingTrial_01.c3d\\ \\ c. Click OK  |  {{:TPS_AssignMotionTrials.png}}\\ |+**1. Assign model to motion trial** 
 +\\ 
 +a. Model -> Assign Model to Motion Files 
 +\\ 
 +b. Select the checkbox next to **WalkingTrial_01.c3d** 
 +\\ 
 +c. Click OK   
 +\\ 
 + 
 +{{:TPS_AssignMotionTrials.png}}\\  
 + 
  
 **Verify -** The 3D Animation Viewer should now display a skeleton of the lower body that has been associated with your movement data. You can animate the skeleton by clicking the PLAY {{:play.jpg}} button in the VCR controls at the bottom of your screen. **Verify -** The 3D Animation Viewer should now display a skeleton of the lower body that has been associated with your movement data. You can animate the skeleton by clicking the PLAY {{:play.jpg}} button in the VCR controls at the bottom of your screen.
Line 87: Line 129:
 A great example of assigning models to motion files can be found on the following page [[Visual3D:Documentation:Pipeline:Model_Commands:Assign_Model_File|Assign_Model_File]]. A great example of assigning models to motion files can be found on the following page [[Visual3D:Documentation:Pipeline:Model_Commands:Assign_Model_File|Assign_Model_File]].
  
-==== Basic Signal Processing ====+===== Basic Signal Processing ===== 
 +For this section, switch to the **Signal and Events** tab.
  
 Signal Processing is accomplished typically through [[Visual3D:Documentation:Pipeline:Pipeline_Overview|pipeline commands]]. For more detail, a tutorial describing [[Visual3D:Tutorials:Knowledge_Discovery:Signal_Processing|Signal Processing]] is available. Signal Processing is accomplished typically through [[Visual3D:Documentation:Pipeline:Pipeline_Overview|pipeline commands]]. For more detail, a tutorial describing [[Visual3D:Tutorials:Knowledge_Discovery:Signal_Processing|Signal Processing]] is available.
  
-This section assumes that you have worked through the previous sections on this page. The following are steps for Interpolating and Filtering the TARGET data.+This section assumes that you have worked through the previous sections on this page. The following are steps for Interpolating and Filtering the TARGET data. 
  
-**Make sure you are in the Signals and Events tab for the Processing section**+**1. Interpolate TARGET signals:** 
 +\\ 
 +a. Signals and Events tab 
 +\\ 
 +b. Expand the TARGET folder 
 +\\ 
 +c. Right click on the ORIGINAL folder 
 +\\ 
 +d. Click Processing 
 +\\ 
 +e. Click Interpolate  
 +\\ 
 +f. Click Done
  
-|1. Interpolate TARGET signals:\\ \\ a. Signals and Events tab\\ \\ b. Expand the TARGET folder\\ \\ c. Right click on the ORIGINAL folder\\ \\ d. Click Processing >\\ \\ e. Click Interpolate\\ \\ f. Click Done\\ \\ See [[https://www.c-motion.com/support/Visual3D.php?topic=FAQ_Signals#topic-828|Signal Processing]] for an explanation of the default command parameters.\\ \\ \\ Note that a **PROCESSED** folder has appeared under the **TARGET** folder in the data tree.\\   |  {{:TPS_InterpolateData.png}}\\ |+See [[https://www.c-motion.com/support/Visual3D.php?topic=FAQ_Signals#topic-828|Signal Processing]] for an explanation of the default command parameters. 
 +\\ 
 +**NOTE:** a **PROCESSED** folder has appeared under the **TARGET** folder in the data tree. 
 +\\ 
 +{{:TPS_InterpolateData.png?500}}
  
-|2. Filter TARGET signals:\\ \\ a. Expand the TARGET folder\\ \\ b. Right click on the PROCESSED folder\\ \\ c. Click Processing >\\ \\ d. Click Filter\\ \\ e. Click Done\\ \\ See [[https://www.c-motion.com/support/Visual3D.php?topic=FAQ_Signals#topic-830%7CSignal|Processing]] for an explanation of the default command parameters.\\ \\ Note that only a **PROCESSED** folder exists under the **TARGET** folder in the data tree (e.g. a new PROCESSED folder wasn't created). By default Visual3D uses only one PROCESSED folder, which contains the most recent processing done to a signal.  |  {{:TPS_FilterData.png}}\\ | 
  
-|3. Review Processing History:\\ \\ a. Expand the TARGET folder\\ \\ d. Expand the PROCESSED folder\\ \\ c. Left click on signal "CTRHID"\\ \\ d. In the Data View Dialog, select Signal Processing History tab  |  \\ {{:TPS_ProcessingHistory.png}}\\ |+**2. Filter TARGET signals:** 
 +\\ 
 +a. Expand the TARGET folder 
 +\\ 
 +b. Right click on the PROCESSED folder 
 +\\ 
 +c. Click Processing  
 +\\ 
 +d. Click Filter 
 +\\ 
 +e. Click Done 
 + 
 + 
 +See [[https://www.c-motion.com/support/Visual3D.php?topic=FAQ_Signals#topic-830%7CSignal|Processing]] for an explanation of the default command parameters. 
 +\\ 
 +**NOTE:** Only a **PROCESSED** folder exists under the **TARGET** folder in the data tree (e.g. a new PROCESSED folder wasn't created). By default Visual3D uses only one PROCESSED folder, which contains the most recent processing done to a signal.  
 +\\ 
 + {{:TPS_FilterData.png?500}} 
 + 
 + 
 +**3. Review Processing History:** 
 +\\ 
 +a. Expand the TARGET folder 
 +\\ 
 +b. Expand PROCESSED folder 
 +\\ 
 +c. Left click on signal "CTRHID" 
 +\\ 
 +d. In the Data View Dialog, select Signal Processing History tab  
 +\\ 
 +{{:TPS_ProcessingHistory.png?500}} 
  
 === Pipeline commands for Basic Signal Processing === === Pipeline commands for Basic Signal Processing ===
Line 107: Line 196:
 Refer to [[Visual3D:Tutorials:Pipeline:Command_Pipeline_#Pipeline_SIGNAL_PROCESSING|Tutorial:_Command_Pipeline#Pipeline_SIGNAL_PROCESSING]] for an example. Refer to [[Visual3D:Tutorials:Pipeline:Command_Pipeline_#Pipeline_SIGNAL_PROCESSING|Tutorial:_Command_Pipeline#Pipeline_SIGNAL_PROCESSING]] for an example.
  
-==== Check Force Assignments ==== 
  
-==== Creating Event Labels ====+ 
 +===== Creating Event Labels =====
  
 An Event is simply an occurrence of interest that correlates to a motion capture frame, i.e. to a particular time point within a movement. The key events for gait studies (e.g., heel strike, toe-off) are now so well standardized that Visual3D can detect and mark them automatically . For other applications, you can define your own events, either manually (using the mouse to double-click on significant points on any graph) or computationally. After you have worked through the steps in this section, refer to [[Visual3D:Tutorials:Events:Event_Processing_|Tutorial:_Event_Processing]] for more information about creating event labels. In addition, go to [[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type|Event Labels]] for more examples. An Event is simply an occurrence of interest that correlates to a motion capture frame, i.e. to a particular time point within a movement. The key events for gait studies (e.g., heel strike, toe-off) are now so well standardized that Visual3D can detect and mark them automatically . For other applications, you can define your own events, either manually (using the mouse to double-click on significant points on any graph) or computationally. After you have worked through the steps in this section, refer to [[Visual3D:Tutorials:Events:Event_Processing_|Tutorial:_Event_Processing]] for more information about creating event labels. In addition, go to [[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type|Event Labels]] for more examples.
  
-=== Entering an Event manually ===+==== Entering an Event manually ====
  
 Events can be added to the data file manually by selecting a frame in a graph in **SIGNAL AND EVENT PROCESSING** mode. Follow these steps: Events can be added to the data file manually by selecting a frame in a graph in **SIGNAL AND EVENT PROCESSING** mode. Follow these steps:
  
-|1. Plot the signal as an Interactive Graph:\\ \\ a. In the Signal and Events tab\\ \\ b. Expand the TARGET folder\\ \\ c. Expand the PROCESSED folder\\ \\ d. Right click on the LFCC target\\ \\ e. Select "Graph X, Y and Z" >\\ \\ f. Click New Graph  |  {{:TPS_Createinteractivegraph.png}}|+**1. Plot the signal as an Interactive Graph:** 
 +\\ 
 +a. In the Signal and Events tab 
 +\\ 
 +b. Expand the TARGET folder 
 +\\ 
 +c. Expand the PROCESSED folder 
 +\\ 
 +d. Right click on the LFCC target 
 +\\ 
 +e. Select "Graph X, Y and Z" 
 +\\ 
 +f. Click New Graph 
 +\\ 
 +{{:TPS_Createinteractivegraph.png?500}}
  
-|Select the graph by clicking with the Left Mouse Button on the graph. When the graph is selected you will see the handles (little rectangles) on the graph.\\ \\ When the graph is selected you can change the scale for the X and Y axes.\\ \\ You can also view a vertical line which is associated with the current frame.  |  {{:TPS_LFCC_graph.png}}| 
  
 +Select the graph by clicking with the Left Mouse Button on the graph. When the graph is selected you will see the handles (little rectangles) on the graph.
 +\\
 +When the graph is selected you can change the scale for the X and Y axes. You can also view a vertical line which is associated with the current frame.  
 +\\
 +{{:TPS_LFCC_graph.png}}
 +
 +\\
 +**2. Manually create a new Event Label**
 +\\
 +a. Double click with the Left Mouse button at the location you want the event to be added
 +\\
 +b. In the dialog, specify the event label name
 +\\
 +Note that the name of the Event Label can be the same as an existing label in the data tree because more than one occurrence of an Event is allowed. The buttons **<<** and **>>** allow you to move the Event forward or backward through the frames.
 \\ \\
  
 +{{:TPS_LFCC_graph_newEvent.png}}
  
-|2. Manually create a new Event Lable\\ \\ a. Double click with the Left Mouse button at the location you want the event to be added\\ \\ b. In the dialog, specify the event label name\\ \\ Note that the name of the Event Label can be the same as an existing label in the data tree because more than one occurrence of an Event is allowed.\\ \\ \\ The buttons **<<** and **>>** allow you to move the Event forward or backward through the frames.  |  {{:TPS_LFCC_graph_newEvent.png}}| 
  
 After an Event has been created it can be edited using the Edit Events Dialog. The process of Editing an Event is explained elsewhere. After an Event has been created it can be edited using the Edit Events Dialog. The process of Editing an Event is explained elsewhere.
Line 136: Line 252:
 Users can create events specific to their task (different types of motion, EMG processing, etc.) by using any combination of signal processing in conjunction with the many [[Visual3D:Documentation:Pipeline:Event_Commands:Event_Commands_Overview|Event commands]]. Users can create events specific to their task (different types of motion, EMG processing, etc.) by using any combination of signal processing in conjunction with the many [[Visual3D:Documentation:Pipeline:Event_Commands:Event_Commands_Overview|Event commands]].
  
-==== Creating model based items ====+===== Creating model based items =====
  
 Model Based Items refers to Kinematic and Kinetic calculations based on rigid body modeling. Model Based Items refers to Kinematic and Kinetic calculations based on rigid body modeling.
Line 146: Line 262:
 To create the right knee joint angle, follow these steps: To create the right knee joint angle, follow these steps:
  
-|1. Under **MODEL** in the main menu bar, select **Compute Model Based Data**  |  {{:tutorial8_1.jpg}}|+1. Under **MODEL** in the main menu bar, select **Compute Model Based Data** 
 +\\ 
 +{{:tutorial8_1.jpg}}|
  
-|2. Define the Right Knee Angle as follows\\ \\ 1. **Data Name:** RKneeAngle\\ \\ 2. **Model Based Item Properties:** JOINT_ANGLE\\ \\ 3. **Segment:** RSK (Right Shank)\\ \\ 4. **Reference Segment:** RTH (Right Thigh)\\ \\ 5. **Cardan Sequence:** XYZ\\ \\ 6. Click **Create**  |  {{:tutorial8_2.jpg}}\\ |+2. Define the Right Knee Angle as follows: 
 +\\ 
 +**Data Name:** RKneeAngle 
 +\\ 
 +**Model Based Item Properties:** JOINT_ANGLE 
 +\\ 
 +**Segment:** RSK (Right Shank) 
 +\\ 
 +**Reference Segment:** RTH (Right Thigh) 
 +\\ 
 +**Cardan Sequence:** XYZ 
 +\\ 
 +Click **Create** 
 +\\ 
 +{{:tutorial8_2.jpg}}
  
-|**Processing Results**\\ \\ - The joint angle is created and a processing dialog shows if any errors were encountered. Note that the dialog also contains which files were processed. It is important to note this because signals are only created for the active files.  |  {{:tutorial8_3.gif}}\\ | 
  
-|3. Define the Left Knee Angle as follows\\ \\ 1. **Data Name:** LKneeAngle\\ \\ 2. **Model Based Item Properties:** JOINT_ANGLE\\ \\ 3. **Segment:** LSK (Left Shank)\\ \\ 4. **Reference Segment:** LTH (Left Thigh)\\ \\ 5. **Cardan Sequence:** XYZ\\ \\ 6. Click **Create**  |  \\ {{:tutorial8_4.jpg}}\\ | 
  
-|Notice that a new folder is created in the Data Tree for LINK_MODEL_BASED calculations. This folder now contains the Left Knee Angle and Right Knee Angle Signals.\\   |  {{:tutorial8_5.jpg}}\\ |+**Processing Results** 
 +\\ 
 +The joint angle is created and a processing dialog shows if any errors were encountered. Note that the dialog also contains which files were processed. It is important to note this because signals are only created for the active files. 
 +\\ 
 +{{:tutorial8_3.gif?400}} 
 + 
 +**3. Define the Left Knee Angle as follows** 
 +\\ 
 +**Data Name:** LKneeAngle 
 +\\ 
 +**Model Based Item Properties:** JOINT_ANGLE 
 +\\ 
 +**Segment:** LSK (Left Shank) 
 +\\ 
 +**Reference Segment:** LTH (Left Thigh) 
 +\\ 
 +**Cardan Sequence:** XYZ 
 +\\ 
 +Click **Create** 
 +\\ 
 +{{:tutorial8_4.jpg}} 
 + 
 + 
 +Notice that a new folder is created in the Data Tree for LINK_MODEL_BASED calculations. This folder now contains the Left Knee Angle and Right Knee Angle Signals.   
 +\\ 
 +{{:tutorial8_5.jpg}}
  
 === Using Pipeline Commands === === Using Pipeline Commands ===
visual3d/tutorials/knowledge_discovery/typical_processing_session.1738957480.txt.gz · Last modified: 2025/02/07 19:44 by wikisysop