A Python Open Source Application for the Analysis of Hand Motion

MPAL is a Python open-source and interactive application designed for analyzing hand motion. This application takes 3D coordinates retrieved from, for example, a motion tracking device, and visualizes the data frame-by-frame together with algorithm-generated labels that describe motion pattern. All folders and files under this repository are released under the GNU-GPL v3.0 license (see LICENSE).

1. Download the latest official release from https://github.com/bbl-brainbehaviorlab/MPAL/archive/master.zip and extract it.
   OR
   Clone the repository using git clone https://github.com/bbl-brainbehaviorlab/MPAL.git.

2. Install Python 3.7.

3. Install pip and setuptools.

4. On terminal, use cd to change directory to the extracted folder.
   (E.g., cd <directory_path>/MPAL-master)

5. Use pip install . or pip3 install . to install all dependencies.

1. On terminal, use cd to change directory to the MPAL subfolder within the main application folder.
   (E.g., cd <directory_path>/MPAL-master/MPAL)
   (You should see __init__.py, app.py, analysis.py, & preprocessing.py in this folder)

2. Enter python3 app.py to run the application.

Lo, C., Chu, S., Penney, T., & Schirmer, A. (2021). 3D Hand-Motion Tracking and Bottom-Up Classification Sheds Light on the Physical Properties of Gentle Stroking. Neuroscience, 464, 90-104. https://doi.org/10.1016/j.neuroscience.2020.09.037