Differences

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

--- inspect3d:tutorials:treadmill_walking_in_healthy_individuals [2024/06/19 12:45] – sgranger
+++ inspect3d:tutorials:treadmill_walking_in_healthy_individuals [2024/07/12 13:26] (current) – removed sgranger
@@ Line 1: / Line 1: @@
-{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{===== abstract =====
-visual3d and inspect3d can be used to automate the processing of large batches of clinical data. this tutorial provides an example of how to do so using a publicly available data set.
-fukuchi et al.[[https://peerj.com/articles/4640/|[1]]] published a gold standard public data set [[https://figshare.com/articles/dataset/a_public_data_set_of_overground_and_treadmill_walking_kinematics_and_kinetics_of_healthy_individuals/5722711|[2]]] of marker-based motion capture to describe healthy individuals walking overground and on a treadmill. although the authors present a number of descriptive analyses, the effect of using handrail support on gait biomechanics during treadmill walking in this data set has yet to be addressed.
-this tutorial is designed to demonstrate how to use inspect3d to compare joint angles between two groups of older adults: those who used a handrail and those who did not.
-===== data =====
-intro1.jpg
-the fukuchi et al. data set includes 3d kinematic data for 26 lower limb and pelvic markers and ground reaction force plate data for 42 subjects walking at 8 different speeds. motion capture data was sampled at 150 hz and force plate data was sampled at 300 hz. metadata in these trials included anthropometric measurements such as mass, height, leg length, leg dominance, gender, handrail support, and walking speed. for this tutorial only a subset of the data was used, which included the trials with older adults (subjects 25-42) walking at a single comfortable control speed (t05).
-  * **fukuchi et. al. subject data:** from the publicly available data files, download wbdsc3d.zip for subject .c3d files, and wbdsinfo.xlsx for the metadata [[https://figshare.com/articles/dataset/a_public_data_set_of_overground_and_treadmill_walking_kinematics_and_kinetics_of_healthy_individuals/5722711|[3]]]
-to simplify this tutorial, the following premade files are available to download as a starting point. they are contained in the zip folder labelled **"i3d_tutorial_treadmill_walking.zip"**, which can be downloaded [[https://www.has-motion.com/download/examples/inspect3d/i3d_tutorial_treadmill_walking.zip|here]]. the file types and contents are briefly described below:
-  * **visual3d workspaces (processed_workspaces):** pre-processed .cmz and .c3d files for the elderly subject group (subjects 25-42). contains pre-made tags (see table 1).
-  * **visual3d pipeline (pipeline.v3s):** compiles the static and motion .c3d files, associates them with a model file, and sets premade tags for all of the participants in this dataset. the pipeline produces separate .cmx and .cmz files for each participant.
-  * **model template (wbdsmodel.mdh):** provided by fukuchi et. al. includes lower body and pelvis segments generated using the 26 anatomical markers, and is applied to the subject .c3d files. if you wish to build your own model, follow the [[https://www.c-motion.com/v3dwiki/index.php?title=youtube_tutorial:_model_building|model building tutorial]].
-  * **query definitions (group_definitions.q3d):** query definitions for inspect 3d loading x, y, and z components of lower body joint angles, with signals not combined across sides of the body.
-  * **inspect3d workspace (workspace.i3d):** copy of working inspect3d workspace.
-  * **inspect3d color palette (fukuchipalette.xml):** premade color template used for generating images in this tutorial.
-table 1 below shows the tags used in this tutorial. these will be used in later steps.
-table 1: tag definitions
-|tag                        |definition                                               |
-|slow, control, fast        |walking speeds.                                          |
-|young, old                 |subject age.                                             |
-|male, female               |subject sex.                                             |
-|leftdominant, rightdominant|subject leg dominance.                                   |
-|heldrail                   |subject held rail during treadmill walking trial.        |
-|didnotholdrail             |subject did not hold rail during treadmill walking trial.|
-===== visual3d processing =====
-if you want to skip to the inspect3d analysis portion of this tutorial, ensure you have downloaded the **"i3d_tutorial_treadmill_walking.zip"** folder and then skip to the header called **loading data into inspect3d**. if you want to use or modify the pre-made pipeline, continue with the steps below. you also need to have downloaded the original data from fukuchi et al.[[https://peerj.com/articles/4640/|[4]]]
-this tutorial uses the pipeline feature of visual3d to process the raw data provided by fukuchi et al. the benefit of the pipeline feature is that it can be used to automate repeated steps and reduces the amount of time it takes to work with large data sets. if you are unfamiliar with using the visual3d workspace, take some time to review the [[https://www.c-motion.com/v3dwiki/index.php?title=tutorial_typical_processing_session|typical processing session tutorial]] and the [[https://www.c-motion.com/v3dwiki/index.php?title=tutorial:_command_pipeline|command pipeline tutorial]].
-processing1.png
-**1. download .c3d files:** fukuchi et al. has a folder labelled **wbdsc3dwithgaitevents**, ensure that you are using the .c3d files contained in this folder.
-**2. subject by subject pipeline edits:** if you haven't yet, download **"pipeline.v3s"** from **"i3d_tutorial_treadmill_walking.zip"**. this pipeline compiles all the static and dynamic .c3d files, associates them with a model file, and sets tags for all of the subjects, then generates separate .cmx and .cmz files for each subject. you can open the pipeline in a text editor and search and edit these functions manually, or open the pipeline workshop and edit them in the visual3d interface. this pipeline must be run once for each subject, with the following changes being made before each run:
-  * **subject index:** under pipeline function set_pipeline_parameter, change parameter_value to the value associated with each subject (01, 02, 03...).
-  * **subject height:** under pipeline function set_subject_height, change the height parameter to match the subject. height is in cm.
-  * **subject mass:** under pipeline function set_subject_mass, change the weight parameter to match the subject. weight is in kg.
-  * **subject age:** under pipeline function explicit_metric, there should be a parameter called result_metric_name set to isold. set to 1 if subject is older than 50 and 0 if subject is under 50.
-  * **subject gender:** under pipeline function explicit_metric, there should be a parameter called result_metric_name set to ismale. set to 1 if subject is male and 0 if subject is female.
-  * **subject foot dominance:** under pipeline function explicit_metric, there should be a parameter called result_metric_name set to isleftdominant. set to 1 if subject is left footed and 0 if subject is right footed.
-  * **subject rail use:** under pipeline function explicit_metric, there should be a parameter called result_metric_name set to heldrail. set to 1 if subject used the rail and 0 if the subject did not use the rail.
-this information is contained in the metadata file mentioned previously.
-**3. load and execute pipeline:** open visual3d and click on the **"pipeline"** button on the toolbar at the top of the interface. select **"open pipeline"** and navigate to the directory where you saved the subject specific version of **pipeline.v3s**. click **"open"** and **"execute pipeline"**. the pipeline script will prompt you to select a folder path. choose the location of the .c3d files referenced in instruction 1. the pipeline loads the static trial and treadmill dynamic trails for a subject. ensure that your model template file is in the same folder as your static and motion files, or you will be prompted to select the model for each subject that is processed in the pipeline. the script will apply the model to the motion files, add tags to the appropriate files, modify force plate parameters, clean force assignments and compute gait events, and compute signals for link model based measures of interest. a .cmz file is produced for each participant at the end of the pipeline.
-**4. verify execution:** check that .cmz and .cmx files were created for each subject.
-**5. repeat for all desired subjects.**
-===== loading data into inspect3d =====
-loadingdata2.png
-within the **"i3d_tutorial_treadmill_walking.zip"** folder there is a subfolder labelled **"processed_workspaces"**. this contains the visual3d workspaces that must be loaded into inspect3d for further analysis.
-  - select i3dloadlibrary.png **load library** and set **cmo library path** to the folder where your .cmz and .c3d files are located. ensure you are using the files from the **wbdsc3dwithgaitevents** folder. then select **load** and exit the window.
-  - open the i3dgroups.png**group definitions** tab and select i3dopengroupdef.png**load group definitions**. once prompted, open the **group_definitions.q3d** query file.
-  - select **calculate all groups**. groups will be divided up based on right and left pelvis, hip, knee and ankle joint angles in x, y, and z axis.
-a detailed tutorial on creating groups can be found [[inspect3d:tutorials:load_and_view_data|here]]. an example of creating a group manually is as follows.
-  - open the i3dgroups.png**group definitions** dialog.
-  - add a actionadd48x48.png **group** and name it “rail_hip_angle_x_right”
-  - add a actionadd48x48.png **sub-group** and name it “rail_hip_angle_x_right”
-    - **signals**: type - “link_model_based”, folder - “original”, signal name - “l hip angle”, component - “x”
-    - **events**: event sequence - lhs,lhs
-    - **refinement**: select **refine using tag**, and **use and logic**, highlight **heldrail** and **control**
-for our investigation, we are interested in comparing railing holding to non railing holding while walking on the treadmill. for each signal in our analysis, we specified which railing condition we wanted, and used the control speed (trial t05 of treadmill data in raw data files). for our investigation we specifically looked at the effect of holding rails, however, if you wish to investigate something new, different tags can be selected.
-\\
-\\
-\\
-===== cleaning data =====
-if you haven't had much experience cleaning data in inspect3d, take some time to review the [[inspect3d:tutorials:clean_your_data|clean your data tutorial]].
-to begin cleaning your data, start by selecting a group to graph, then clicking **select all workspaces** and then **plot all sequences**. on the plotted graph, select any traces you wish to inspect. right click on the graph and hover over **exclude**, then click **exclude trace (raw data)**. in the toolbar select i3dupdatecmoswithbadevents.png**update cmzs** to update the files with the excluded traces.
-depending on how you clean your data, results may vary.
-cleaningdata1.jpg cleaningdata2.jpg
-===== inspect3d visualization and pca analysis =====
-pca2.png
-if you haven't had much experience visualizing signals in inspect3d, take some time to review the [[inspect3d:tutorials:load_and_view_data|load and view data tutorial]].
-to start a pca analysis, start by selecting the two groups you want to compare in the **groups** menu (ctrl + click). example: ctrl + click on **rail_pelvis_angle_y** and **nrail_pelvis_angle_y**.
-navigate to the toolbar at the top of the interface and select the i3d_pcaoptions2.png button. a dropdown menu will appear. select the number of pcas you want for your analysis and ensure **use workspace mean** is checked. then click **run pca** and **show pca graphs**. the pca graph should appear on the right side of the user interface
-once the pca has been run, at the bottom right corner of the inspect3d interface there are six options for visualising results of the analysis (variance explained, loading vector, workspace scores, group scores, extreme plot and pc reconstruction). see the [[inspect3d:tutorials:perform_principal_component_analysis|perform principal component analysis]] for more information on using these tools and interpreting results.
-\\
-\\
-\\
-\\
-\\
-\\
-\\
-\\
-\\
-===== results =====
-interpretation of joint angle signals can be made through visual comparison of the two study groups: hand railing support and non-hand railing support during control speed treadmill walking. additionally, waveform-based pca can help us find differences in the waveform data between the two study groups. the goal of this analysis is to determine if the joint angles of the lower body are affected by the use of hand-rails during treadmill walking. visual comparison can be used to depict outliers and pattern behaviour, whereas pca can provide statistical verification of whether two groups can be distinctly identified from the signals of interest.
-examples of interpreting pca results are shown below in the knee, hip, and pelvis, and through the following tutorial [[inspect3d:tutorials:perform_principal_component_analysis|here]].
-==== ankle ====
-for this study, to look specifically at one joint 6 figures can be laid out in a 3x2 grid. to do so go to the i3dshowoptions.png **[[inspect3d:documentation:dialogs:load_library_dialogue#plotting_options|options]]** tab and change the number of rows and columns. this allows for easy comparison between the different angle changes in different directions. we plotted the left and right ankle angles in abduction-adduction, internal-external rotation, and flexion-extension to compare signals between railing and non-railing walking conditions. visual analysis showed very similar trajectories over a gait cycle, however holding the railing (dark red) appeared to have greater variability during stance for left angle in abduction-adduction and internal-external rotation. for the right leg they overall show similar trajectories. ankleresult.png
-==== knee ====
-we plotted the left knee angle signals over a gait cycle, including the mean and standard deviations for both railing and non-railing groups. for the coordinate system used in the fukuchi et. al. data set, the z-axis is aligned in the medial/lateral direction, and so the knee angle about the z-axis describes the flexion/extension rotation. in this analysis, we can see that there is some amount of distinction in the mean values between those holding a railing, and those not holding a railing, particularly during stance (0-45%) and late-swing phase (90%+). it appears that those holding the rail had a higher mean joint angle in both those instances.
-knee1.jpg
-we then performed a pca analysis on the knee data. through this we can see that the underlying gait cycle signal is structured, and 95% variance can be explained by the first four principal components.
-knee3.jpg
-returning to our visualisation analysis on the knee, we know that there are potential differences between the knee angles of those who used the railing, and those who did not. if possible, we want to be able to classify subjects as having used the railing, and not having used it. by looking at the **group scores** tab, that is the average values of each principal component on each group, we see that the standard errors of pc1 and pc2 do not overlap, suggesting pc1 and pc2 can best discriminate between groups. pc4 for example, has standard errors that do overlap, signifying that it could not be used to discriminate the groups. we can graph both pc1 and pc2 through the **workspace scores** tab, and see that we have a nearly linearly separable dataset.
-\\
-knee4.jpgknee6.jpg
-we can then look more closely at pc1 and pc2, and see why this may make sense. looking back at the mean signal trace graph, we see that there is a notable difference in the joint angle between the 2 groups at the beginning and end of the gait cycle, and pc1 in particular may represent this. we can see by plotting the vector of pc1 that in general, the value of pc4 is smaller in the middle, while it is a large value at both the beginning and end of the gait cycle. since we can visually see that the subjects who held the rail generally had higher angles at these points in the cycle, we would expect, and in fact do see, large values of pc1. while this is not a perfect separation of the two groups, the addition of pc2 explains the variance, again at the very start where we see the most difference, and around 60-75% where there is slight variance.
-knee7.jpgknee8.jpg
-==== hip ====
-we plotted the left hip internal and external rotation over a gait cycle, including the mean and standard deviations for both railing and non-railing groups. for the coordinate system used in the fukuchi et. al. data set, the y-axis is aligned in the vertical direction, and so the hip angle about the y-axis describes internal-external rotation behaviour. using inspect3d’s pca analysis, we plotted the **group scores** tab for the first 4 principal components that described >95% of the hip joint signals, with the mean and standard error. we found that the second principal component has identifiable differences in the scores between groups, as the standard errors do not cross the x-axis. further investigation into this principal component using the **workspace scores** we can see a reasonable separation between groups when comparing pc2 to pc1. in this specific example, pc1 describes more of the dataset variability for each group (64.1%), however, pc2 can best discriminate between the compared groups when analysing the hip internal-external rotation.
-hip1.jpghip2.jpghip3.jpg
-==== pelvis ====
-when comparing pelvis angles during the gait cycle, we noticed variations in the z-axis behaviour. for the coordinate system used in the fukuchi et. al. data set, the z-axis is aligned in the medial/lateral direction, and so rotation about this axis defines the anterior-posterior rotation of the pelvis. we can see directly from plotting mean and standard deviation of the group signals, the non-railing condition appears to have much greater variability across those subjects. the mean signal trajectory shows that the subjects who did not hold the railing were walking with a more upright pelvis position, and those who did hold the railing walked with a greater forward tilt in the lower trunk/pelvis. moving to our pca analysis, we can see that almost 100% of the variability between group signals can be described by pc1, and pc1 can also be used to discriminate between signals when analysing anterior/posterior pelvis angle.
-pelvis1.jpgpelvis2.jpg
-pelvis3.jpgpelvis4.jpg
-===== conclusions =====
-the quantitative results for the lower limb joint pca analyses are summarized below in **table 2**. the ankle analysis had unreliable data and was therefore excluded from the results table.
-table 2: pca results
-|joint                         |pc of significance|% of variance explained by significant pc|% of variance explained by 4 pcs|
-|knee flexion-extension        |pc1               |64.1%                                    |95%                             |
-|hip internal-external rotation|pc2               |16.4%                                    |98%                             |
-|anterior-posterior pelvic tilt|pc1               |99.99%                                   |99%                             |
-from these results we can conclude that holding a hand rail does have the statistical potential to influence lower limb joint angles (particularly the pelvic angle) and should be a variable that is controlled for in future studies.
-however, there are limitations on the conclusions that can be drawn from this analysis. firstly, eliminating the younger subjects from the analysis pool reduced the subject pool from 42 to 17. this number of subjects is typically acceptable for pilot studies but is not large enough to be statistically valid for the general population. secondly, to further quantify the relationship between rail use and lower limb joint angles it would be more effective to have the same subjects walk with and without a handrail (which was not the case in this data set). this would better control for variations in individual gait patterns.
-===== references =====
-**data set:** fukuchi et al. a public dataset of overground and treadmill walking kinematics and kinetics in healthy individuals: [[https://figshare.com/articles/dataset/a_public_data_set_of_overground_and_treadmill_walking_kinematics_and_kinetics_of_healthy_individuals/5722711|[5]]]
-**paper:** fukuchi et al. a public dataset of overground and treadmill walking kinematics and kinetics in healthy individuals: [[https://peerj.com/articles/4640/|[6]]]
-**license:** original dataset is licensed under cc by 4.0 [[https://creativecommons.org/licenses/by/4.0/|[7]]]
-}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}