HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » sift » tutorials » Visualizing Healthy Human Walking
sift:tutorials:visualizing_healthy_human_walking

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
sift:tutorials:visualizing_healthy_human_walking [2024/11/29 15:50] – [Creating CMZ files in Visual3D] wikisysopsift:tutorials:visualizing_healthy_human_walking [2024/11/29 18:26] (current) – [Data] wikisysop
Line 3: Line 3:
 Sift can be used to explore publicly available data sets such as the [[https://www.nature.com/articles/s41597-022-01817-1|Healthy Human Walking]] data set, This tutorial will show you how to use [[Visual3D:Visual3D_Overview|Visual3D]] to process the [[Visual3D:Documentation:C3D_Signal_Types:C3D_Format|.c3d]] files from this data set, and then how to clean and visualize the data using Sift. Sift can be used to explore publicly available data sets such as the [[https://www.nature.com/articles/s41597-022-01817-1|Healthy Human Walking]] data set, This tutorial will show you how to use [[Visual3D:Visual3D_Overview|Visual3D]] to process the [[Visual3D:Documentation:C3D_Signal_Types:C3D_Format|.c3d]] files from this data set, and then how to clean and visualize the data using Sift.
  
-==== Data ====+===== Data =====
  
 This tutorial uses publicly available data from the paper [[https://www.nature.com/articles/s41597-022-01817-1|A biomechanics dataset of healthy human walking at various speeds, step lengths and step widths]], which provides an overview of how the data was collected, processed, and stored. Briefly, force plate data and marker-based motion capture data were collected for 10 different participants over 33 walking trials each, with various step lengths, step widths, step frequencies, and speeds. Ground reaction force data were sampled at 1200 Hz and motion capture data were sampled at 120 Hz. This tutorial uses publicly available data from the paper [[https://www.nature.com/articles/s41597-022-01817-1|A biomechanics dataset of healthy human walking at various speeds, step lengths and step widths]], which provides an overview of how the data was collected, processed, and stored. Briefly, force plate data and marker-based motion capture data were collected for 10 different participants over 33 walking trials each, with various step lengths, step widths, step frequencies, and speeds. Ground reaction force data were sampled at 1200 Hz and motion capture data were sampled at 120 Hz.
Line 11: Line 11:
 We are interested in the .c3d files that can be downloaded [[https://doi.org/10.6084/m9.figshare.c.5897423.v1|here]]. We are interested in the .c3d files that can be downloaded [[https://doi.org/10.6084/m9.figshare.c.5897423.v1|here]].
  
-Also necessary are the Visual3D pipeline scripts, model templates, and Sift query definitions that can be downloaded [[https://www.has-motion.com/download/examples/Inspect3D/I3D_Tutorial_Healthy_Human_Walking.zip|here]].+Also necessary are the Visual3D pipeline scripts, model templates, and Sift query definitions that can be downloaded [[https://www.has-motion.com/download/examples/Sift_Tutorial_Healthy_Human_Walking.zip|here]].
  
   * **Create_CMO.v3s**: Script for creating a participant's CMZ file from the data set's C3D files.   * **Create_CMO.v3s**: Script for creating a participant's CMZ file from the data set's C3D files.
   * **CleanForceAssignments**: Folder of scripts called by **Create_CMO.v3s** to clean force assignments.   * **CleanForceAssignments**: Folder of scripts called by **Create_CMO.v3s** to clean force assignments.
   * **HealthyHumanWalking_ModelTemplate.mdh**: [[Visual3D:Documentation:Modeling:Modeling_Overview|Visual3D model]] for the C3D files.   * **HealthyHumanWalking_ModelTemplate.mdh**: [[Visual3D:Documentation:Modeling:Modeling_Overview|Visual3D model]] for the C3D files.
-  * **HealthyHumanWalking-ReportTemplate.rgt**: [[Visual3D:Documentation:Reports:Reports_Overview#Report_Template|Report template]] for the CMZ file.+  * **HealthyHumanWalking_ReportTemplate.rgt**: [[Visual3D:Documentation:Reports:Reports_Overview#Report_Template|Report template]] for the CMZ file.
   * **HealthyHumanWalking-GRF.q3d**: Query definitions for the three components of both the left and right ground reaction forces.   * **HealthyHumanWalking-GRF.q3d**: Query definitions for the three components of both the left and right ground reaction forces.
   * **HealthyHumanWalking-XComponent.q3d**: Query definitions for the X component of all signals of interest, with signals not combined across sides of the body.   * **HealthyHumanWalking-XComponent.q3d**: Query definitions for the X component of all signals of interest, with signals not combined across sides of the body.
   * **HealthyHumanWalking-LeftRight.xml**: Color palette matching the colours used in Figure 3 to denote the left and right sides of the body.   * **HealthyHumanWalking-LeftRight.xml**: Color palette matching the colours used in Figure 3 to denote the left and right sides of the body.
 +  * **Participant_1.cmz/cmz**: The .cmz and .cmz files built in the next section (in case you would like to skip it)
  
 ===== Creating CMZ files in Visual3D ===== ===== Creating CMZ files in Visual3D =====
Line 26: Line 27:
  
 Our first step is to process each participant's .c3d files into a [[Visual3D:Documentation:Definitions:File_Formats:CMZ_Format_|CMZ]] file with the necessary signals and events. Our first step is to process each participant's .c3d files into a [[Visual3D:Documentation:Definitions:File_Formats:CMZ_Format_|CMZ]] file with the necessary signals and events.
-1. Open Visual3D and click on the **Pipeline** toolbar option. 
  
-2. **Open Pipeline**, select the Create_CMOs.v3s pipeline script associated with this tutorial, and then **Execute Pipeline**.+  - Open Visual3D and click on the **Pipeline** toolbar option. 
 +  - **Open Pipeline**, select the Create_CMOs.v3s pipeline script associated with this tutorial, and then **Execute Pipeline**. 
  
 +The Create_CMOs script loads a static trial and a model template for a set of dynamic trials, modifies force platform parameters in line with Visual3D's recommendations, cleans force assignments, computes gait events, and produces a report for the signals of interest. For this data set we want one CMZ per participant, so the following steps would need to be performed for each Participant separately. 
  
-The Create_CMOs script loads a static trial and a model template for a set of dynamic trials, modifies force platform parameters in line with Visual3D's recommendations, cleans force assignments, computes gait events, and produces a report for the signals of interest. For this data set we want one CMZ per participant, so the following steps would need to be performed for each Participant separately. +  - To create Participant 1's CMZ file, choose p1_c3dfiles/p1_standing_1.c3d file as the static calibration file. 
- +  - Choose HealthyHumanWalking_ModelTemplate.mdh as the model file. 
-1. To create Participant 1's CMZ file, choose p1_c3dfiles/p1_standing_1.c3d file as the static calibration file. +  - Set Participant 1's weight, height, and foot width according to the [[https://www.nature.com/articles/s41597-022-01817-1/tables/2|anthropometric information]] included in the paper. 
- +  - Choose the remaining 33 .c3d files in the p1_c3dfiles folder as the dynamic trials. 
-2. Choose Model_Template_CMotion_v2.mdh as the model file. +  - Choose Sample_Report_Template.rgt as the report template. 
- +  - Save the results as Participant_1.cmz.
-3. Set Participant 1's weight, height, and foot width according to the [[https://www.nature.com/articles/s41597-022-01817-1/tables/2|anthropometric information]] included in the paper. +
- +
-4. Choose the remaining 33 .c3d files in the p1_c3dfiles folder as the dynamic trials. +
- +
-5. Choose Sample_Report_Template.rgt as the report template. +
- +
-[[File:Tutorial-HHW-V3DReports.PNG|{{/images/thumb/a/ac/Tutorial-HHW-V3DReports.PNG/1000px-Tutorial-HHW-V3DReports.PNG?1000x651}}]] +
- +
-6. Save the results as Participant_1.cmz.+
  
 Only Participant 1's CMZ file is needed for this tutorial, so you can close Visual3D and continue on to the next section once these steps are complete. Only Participant 1's CMZ file is needed for this tutorial, so you can close Visual3D and continue on to the next section once these steps are complete.
  
  
-==== Cleaning the data set in Sift ====+===== Cleaning the data set in Sift =====
  
-[[File:Tutorial-HHW-I3DCleanGRFZ.PNG|{{/images/thumb/c/c2/Tutorial-HHW-I3DCleanGRFZ.PNG/400px-Tutorial-HHW-I3DCleanGRFZ.PNG?400x335}}]]+{{ :Tutorial-HHW-I3DCleanGRFZ.PNG?400x335}}
  
 The processing done in Visual3D allows us to extract signal traces from all of our desired gait sequences from the .c3d files, but not all of these are suitable for further analysis. The number of traces involved makes it impractical to clean this data set in Visual3D, there are more than 3000 traces for Participant 1 alone, but Sift gives us the ability to visualize the ground reaction forces and make inclusion/exclusion decisions for each trace. A detailed explanation of this process can be found in the [[Sift:Tutorials:Clean_your_Data|Clean your data]] tutorial. The processing done in Visual3D allows us to extract signal traces from all of our desired gait sequences from the .c3d files, but not all of these are suitable for further analysis. The number of traces involved makes it impractical to clean this data set in Visual3D, there are more than 3000 traces for Participant 1 alone, but Sift gives us the ability to visualize the ground reaction forces and make inclusion/exclusion decisions for each trace. A detailed explanation of this process can be found in the [[Sift:Tutorials:Clean_your_Data|Clean your data]] tutorial.
  
 +
 +  - Open color prefs dialog via the [[Sift:Application:Data_Options_Dialog|Data Options Dialog]] and load the palette "HealthyHumanWalking-LeftRight.xml"
   - Load **Participant_1.cmz** into the library.   - Load **Participant_1.cmz** into the library.
-  - Open the {{:sift_query_builder.png}} **Query Builder** dialog and apply the GRF.q3d query definitions to compute three groups, one for each component of the ground reaction force.+  - Open the {{:sift_query_builder.png?20}} **Query Builder** dialog, load and compute the HealthyHumanWalking-GRF.q3d query definitions to compute three groups, one for each component of the ground reaction force.
   - Navigate to the [[Sift:Application:Explore_Page|Explore Page]].   - Navigate to the [[Sift:Application:Explore_Page|Explore Page]].
-  - Select the GRF_Z group and **Plot all sequences**.+  - Select the GRF_Z group and **Plot all Traces**.
   - In the plot, iteratively select traces that look anomalous and exclude them. The end result should look like the figure on the right.   - In the plot, iteratively select traces that look anomalous and exclude them. The end result should look like the figure on the right.
-  - Open the {{:sift_update_cmz.png}} **Update CMZs** dialog from the toolbar, select **Update Force Assignments...**, and then **Update CMOs**. +  - Plot all sequences for each GRF component in turn, verifying that there are no included traces that should be excluded. If there are any erroneous traces left, repeat steps 4 and 5 as necessary until you are satisfied with the remaining traces.
-  - Plot all sequences for each GRF component in turn, verifying that there are no included traces that should be excluded. If there are any bad traces left, repeat steps 4 and 5 as necessary until you are satisfied with the remaining traces.+
  
- +===== Visualizing the data =====
-==== Visualizing the data ====+
  
 Now that Participant 1's CMZ file has been cleaned of any unwanted traces, we are ready to perform some preliminary analysis and visualize the data set. Our goal in this section is to reproduce [[https://www.nature.com/articles/s41597-022-01817-1/figures/3|Figure 3]] in the paper. Now that Participant 1's CMZ file has been cleaned of any unwanted traces, we are ready to perform some preliminary analysis and visualize the data set. Our goal in this section is to reproduce [[https://www.nature.com/articles/s41597-022-01817-1/figures/3|Figure 3]] in the paper.
  
-  - Open the {{:sift_general_options.png}} **Show Options** dialog, and set both **Graph Rows** and **Graph Columns** to 3. This will create a 3x3 layout of grids in the plot area.\\ +  - Open the {{:sift_general_options.png?20}} **Show Options** dialog, and set both **Graph Rows** and **Graph Columns** to 3. This will create a 3x3 layout of grids in the plot area \\ {{:sift_row_col_count.png?500}} \\  
-{{:sift_row_col_count.png}}\\ +  - Open the {{:sift_plot_options.png?20}} Plot Options dialog, and deselect auto-scaling for the X and Y axis \\ {{:sift_auto_scale.png?500}} \\ 
- +  - Open the {{:sift_query_builder.png?20}} **Query Builder** dialog and load the HealthyHumanWalking-XComponent.q3d query definitions. This extracts the X-component for all signals in the library without combining signals across the left and right sides of the body.
-  - Open the {{:sift_plot_options.png}} Plot Options dialog, and deselect auto-scaling for the X and Y axis\\ +
-{{:sift_auto_scale.png}}\\ +
- +
-  - Open color prefs dialog via the [[Sift:Application:Data_Options_Dialog|Data Options Dialog]] and load the palette "HealthyHumanWalking-LeftRight.xml" +
-  - Open the {{:sift_query_builder.png}} **Query Builder** dialog and apply the HealthyHumanWalking-X.q3d query definitions. This extracts the X-component for all signals in the library without combining signals across the left and right sides of the body.+
   - Make sure that the top left graph (1,1) is active, indicated by the grey border. Select the RAnkleAngle_X LAnkleAngle_X groups and plot the Group Means.   - Make sure that the top left graph (1,1) is active, indicated by the grey border. Select the RAnkleAngle_X LAnkleAngle_X groups and plot the Group Means.
   - Repeat Step 3 for the remaining graphs with the following groups:   - Repeat Step 3 for the remaining graphs with the following groups:
Line 87: Line 75:
     * Bottom centre (3,2) - RKneePower_X and LKneePower_X     * Bottom centre (3,2) - RKneePower_X and LKneePower_X
     * Bottom right (3,3) - RHipPower_X and LHipPower_X     * Bottom right (3,3) - RHipPower_X and LHipPower_X
-  - With the group means plotted for each of our signals, all that remains is to assign the appropriate graph and axis titles. To do this, open the {{:sift_plot_options.png}} **Plot Styles** dialog and for the top left graph (1,1), provide the following input:+  - With the group means plotted for each of our signals, all that remains is to assign the appropriate graph and axis titles. To do this, open the {{:sift_plot_options.png?20}} **Plot Styles** dialog and for the top left graph (1,1), provide the following input:
     * Deselect **Display Group Name as Title**     * Deselect **Display Group Name as Title**
     * Use the title "Ankle", set the Title Font to Bold and Size 24.     * Use the title "Ankle", set the Title Font to Bold and Size 24.
Line 95: Line 83:
   - Repeat Step 5 for the remaining graphs using the titles from Figure 3.   - Repeat Step 5 for the remaining graphs using the titles from Figure 3.
  
-{{:27_132546.png}}+{{:healthy_human_all.png}}
  
  
-==== Recap ====+===== Recap =====
  
 In this tutorial you learned how Sift, along with Visual3D, can be used to explore and analyse public data sets. You learned how to take the raw data found in the Healthy Human Walking data set's .c3d files and reproduce Figure 3 from the associated paper. In this tutorial you learned how Sift, along with Visual3D, can be used to explore and analyse public data sets. You learned how to take the raw data found in the Healthy Human Walking data set's .c3d files and reproduce Figure 3 from the associated paper.
  
-==== References ====+===== References =====
  
 **Paper** van der Zee, T.J., Mundinger, E.M. & Kuo, A.D. A biomechanics dataset of healthy human walking at various speeds, step lengths and step widths. Sci Data 9, 704 (2022). [[https://doi.org/10.1038/s41597-022-01817-1|DOI]] **Paper** van der Zee, T.J., Mundinger, E.M. & Kuo, A.D. A biomechanics dataset of healthy human walking at various speeds, step lengths and step widths. Sci Data 9, 704 (2022). [[https://doi.org/10.1038/s41597-022-01817-1|DOI]]
sift/tutorials/visualizing_healthy_human_walking.1732895457.txt.gz · Last modified: 2024/11/29 15:50 by wikisysop