Seven Things to Know about Exercise Monitoring with Inertial Sensing Wearables

Overview

This repository presents the implementation of our collaborative project between UPenn/Orthopaedics, UDel/Physical Therapy, and CMU/Engineering on exercise prediction. The manuscript reporting outcomes of this project is currently under revision at the IEEE Journal of Biomedical and Health Informatics (JBHI).

The preprint version is now available on TechRxiv.

Data

Data were collected from 19 participants performing 37 exercises while wearing 10 inertial measurement units (IMUs) on chest, pelvis, wrists, thighs, shanks, and feet (see the figure below).

You may use data samples in the data to run the code, or download the full dataset on SimTK.

Directory

You may preserve the following directory tree to run the code on your local machine without further modifications.

$ Directory tree
.
├── data\
│   ├── parsed_h5_csv
│   │   └── (IMU data here)
│   └── parsed_joint_angles_all
│       └── (joint angles data here)
├── model\
│   ├── Type1.py
│   ├── Type2.py
│   └── Type3.py
├── utils
│   ├── eval.py 
│   ├── network.py
│   ├── clustering_utils.py
│   ├── preprocessing.py
│   └── visualizer.py
├── constants.py
├── data_processing.py
├── clustering.py
├── main.py
└── tuning.py

Implementation

The implementation was tested with Python 3.8.10 and the following packages:

• numpy 1.22.4
• scipy 1.7.3
• pandas 1.5.3
• scikit-learn 1.2.0
• torch 1.13.1+cu116
• tqdm 4.64.1

In addition, matplotlib 3.6.3 and seaborn 0.12.2 were used for plots.

Guideline

Note: This repository is under active cleaning and update.

Data processing

python data_processing.py

(to be updated with more detailed instruction)

Clustering analysis

python clustering.py

(to be updated with more detailed instruction)

Hyper-parameter tuning

(to be updated with more detailed instruction)

Model evaluation

python main.py

(to be updated with more detailed instruction)

Sample size estimation

(to be updated with more detailed instruction)

Citation

If your find the code helpful for your work, please consider citing our paper

Phan, Vu; Song, Ke; Silva, Rodrigo Scattone; Silbernagel, Karin G.; Baxter, Josh R.; Halilaj, Eni (2023). Seven Things to Know about Exercise Monitoring with Inertial Sensing Wearables. TechRxiv. Preprint. https://doi.org/10.36227/techrxiv.23296487.v1