Welcome to IMUGaitPy’s documentation!

IMUGaitPy provides python functions to read accelerometry and orientation data from a single lumbar-mounted sensor and estimate clinical characteristics of gait.

This modified source code is available on Gitlab (private repo): gitlab.com/lsy3/IMUGaitPy and is a fork from github.com/matt002/GaitPy. The difference between IMUGaitPy and GaitPy is that IMUGaitPy adds additional parameters obtained from orientation. The gait parameters from acceleration used GaitPy’s library.

• Device location: lower back/lumbar

• Sensing modality: Inertial Measurement Unit (IMU) which containts accelerometer, gyroscope, and magnetometer

• Sensor data: Vertical acceleration, Orientation

• Minimum sampling rate: 50Hz

Basic usage

python run_script.py [-h] [-i INPUT_DIR] [-o OUTPUT_DIR] [--askmissinginfo] [--overwrite] [--saveplot] [--savec3d]

Calculate gait parameters using measurements from a single IMU. This script calculates the gait parameters for each
recording found in the target directory. Subject height and sensor ratio is obtained from the file name.

optional arguments:
  -h, --help        show this help message and exit
  -i INPUT_DIR      target input directory (default: current directory)
  -o OUTPUT_DIR     target output directory (default: same as input directory)
  --askmissinginfo  Ask missing information if the said information is not found in the filename (default: skip)
  --overwrite       Overwrite calculated gait parameters of measurements already processed. (default: false)
  --saveplot        Save plot as html file. (default: false)
  --savec3d         Save data as c3d file for visualization. (default: false)

Sample command line below. See for how to use with accompanying mobile app.

python run_script.py  -i "imugaitpy\demo" --saveplot --savec3d --overwrite

Modules

Setup:

• Sample usage (IGR App)
  • Sample output
  • Visualisation
• Sample usage (MMC app)
• Setup Development Env.

Usage:

• Data Capture
  • Using RGM Mobile App
  • Using IGR Mobile App
  • Using MMC Mobile App
• Data Processing
  • Usage
  • Sample Output
  • Setup Development Environment
• Visualisation

Gait Parameters:

• Gait Parameters
  • Basics
  • Wobble Related
• Script Outputs
• GaitPy Library

Modules:

• Modules
  • IMUGaitPy
    • IMUGaitpy
    • IMUGaitpy.extract_features
    • util
      • exportc3d
      • mbientimu_r_fix
      • extract_body_info
  • GaitPy
    • classify_bouts
    • extract_features
    • plot_contacts

Acknowledgements

The Neuro Spine Clinic supported the development of this project. The Digital Medicine & Translational Imaging group at Pfizer, Inc supported the development of GaitPy.

License

IMUGaitpy is under the MIT license