EffectsArmswingGaitAsymmetryStability.jl: Supporting code and data from the project "The effects of arm swing amplitude and lower-limb asymmetry on gait stability"

EffectsArmswingGaitAsymmetryStability.jl

This repository contains the Julia code, Jupyter notebook, and dataset used in the study “The effects of arm swing amplitude and lower-limb asymmetry on gait stability” by Allen Hill and Julie Nantel.

Instructions

To run this analysis on your computer, both Julia and Jupyter Notebook must be available. A version of Julia appropriate for your OS can be downloaded from the Julia website, and Jupyter can be installed from within Julia (in the REPL) with

] add IJulia

Alternate instructions for installing Jupyter can be found on the IJulia github or the Jupyter homepage (not recommended).

From within the main repository directory, start Julia and then start Jupyter in the Julia REPL

using IJulia
notebook(;dir=pwd())

or if using a system Jupyter installation, start Jupyter from your favorite available shell (e.g. Powershell on Windows, bash on any *nix variant, etc.). In Jupyter, open the Analysis.ipynb notebook. Running all cells will reproduce the results and sole figure of the above mentioned paper.

Description of data

The data directory contains the demographics and raw data. Each .mat file contains gait events, including*:

• LFO/RFO (Left/right foot lift-off)
• LFC/RFC (Left/right foot contact)

Data signals found in each .mat file are as follows:

• FP1/FP2 (left and right force plates, respectively)
• LFootPos/RFootPos (Left/right foot COM position)
• LFootLinVel/RFootLinVel (Left/right foot linear velocity)
• LFootVelwrtPelvis/RFootVelwrtPelvis (Left/right foot linear velocity, relative to the pelvis)
• LFootAngle/RFootAngle (Left/right foot angle, relative to the lab reference frame)
• LFootAngVel/RFootAngVel (Left/right foot angular velocity, relative to the lab reference frame)
• LShoulder/RShoulder (Left/right shoulder angle, extracted in the order SAGITTAL-FRONTAL-CORONAL)
• LHip/RHip (Left/right hip angle, extracted in the order SAGITTAL-FRONTAL-CORONAL)
• TrunkPos (Trunk position)
• TrunkAngle (Trunk angle, relative to the lab reference frame)
• TrunkLinVel/TrunkAngVel (Trunk linear/angular velocity, relative to the lab reference frame)
• COG (Whole-body COM/COG)
• COG_Velocity (Whole-body COM/COG linear velocity)
• ModelAngMmntm (Whole-body angular momentum)

Units for all data are standard Visual3D units.

Output variables in the results.csv file:

• lambdaS (Local dynamic stability of the Trunk)
• left_steplavg/right_steplavg (Left/right average step length)
• left_steplstd/right_steplstd (Left/right step length standard deviation)
• stepwavg/stepwstd (Average step width and step width standard deviation)
• lsho_avgrom/rsho_avgrom (Left/right average shoulder range of motion, in the sagittal plane)
• lsho_stdrom/rsho_stdrom (Left/right shoulder range of motion standard deviation, in the sagittal plane)
• swingasym (Arm swing range of motion asymmetry)
• stepasym_spatial/stepasym_temporal (Spatial/temporal step asymmetry)
• msdcrp_lsho_rhip/msdcrp_rsho_lhip
  • The mean of the ensemble standard deviation of continuous relative phase (MSDCRP) for both contralateral arm-leg pairs (left shoulder and right hip, right shoulder and left hip)

*Variables named TRST, TREN, SLST, SLEN are present, but empty, and should be ignored.