README.md

biomechanical_analysis

A Python Package For Biomechanical Analysis

This is a collection of modules that are helpful for biomechanical analysis. The python package contains three modules.

1. time_distance.py
   implements gait event detection, cascade and swing ratio calculation
   
2. inverse-kinematics.py
   Implements joint angle computations
   
3. inverse_dynamics.py
   Implements joint force and moment computations
   

Dependencies

Python 3.7
NumPy
Pandas Matplotlib

Data

In order to be able to test the package, sample gait data is provided in /data. It contains the 3D coordinates of markers and ground reaction force obtained from two force plates.
The markers should be in the following order:

1. Neck
2. Left ASIS
3. Left lateral epicondyle of knee
4. Left lateral malleolus
5. Head of left 2th metatarsal
6. Head of left 5th metatarsal
7. Right ASIS
8. Right lateral epicondyle of knee
9. Right lateral malleolus
10. Head of right 2th metatarsal
11. Head of right 5th metatarsal

The force plate data should be in the following order:

1. Center of pressure of left force plate
2. Forces on the left force plate
3. Moments on the left force plate
4. Center of pressure of right force plate
5. Forces on the right force plate
6. Moments on the right force plate

This computation assumes the following coordinate system:
x is from right to left leg
y is from bottom to top
z is from back to front

Testing

When in the repository directory, run test.py

python test.py