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).
-
Download the latest official release from https://github.com/bbl-brainbehaviorlab/MPAL/archive/master.zip and extract it.
OR
Clone the repository usinggit clone https://github.com/bbl-brainbehaviorlab/MPAL.git
. -
Install Python 3.7.
-
Install pip and setuptools.
-
On terminal, use
cd
to change directory to the extracted folder.
(E.g.,cd <directory_path>/MPAL-master
) -
Use
pip install .
orpip3 install .
to install all dependencies.
-
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) -
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