A library for analyze joint angles from IMU data
Project description
PyJama - Python for Joint Angle Measurement and Acquisition
PyJama is open access project that was developed during my master's work at Edmond and Lily Safra International Institute of Neuroscience of Santos Dumont Insitute. PyJama is a user friendly python library for analyzing human kinematics data. Aimed at analyzing data from IMU's, MIMU's, data from optical devices and in the future tracking data from deeplearning models. The PyJama library was designed based on the JAMA device.
Contents
Installation
The latest stable release is available on PyPI, and you can install it by saying
pip install pyjamalib
Anaconda users can install using conda-forge:
conda install -c conda-forge pyjamalib
To build PyJama from source, say python setup.py build.
Then, to install PyJama, say python setup.py install.
If all went well, you should be able to execute the demo scripts under examples
(OS X users should follow the installation guide given below).
Alternatively, you can download or clone the repository and use pip to handle dependencies:
unzip pyjamalib.zip
pip install -e pyjamalib
or
git clone https://github.com/tuliofalmeida/pyjama
pip install -e pyjamalib
By calling pip list you should see pyjamalib now as an installed package:
pyjamalib (0.x.x, /path/to/pyjamalib)
Examples
- Example of using the library using data extracted using JAMA.
- Example of using the library using data extracted using Vicon and Xsens.
Contributing
For minor fixes of code and documentation, please go ahead and submit a pull request. A gentle introduction to the process can be found here.
Check out the list of issues that are easy to fix. Working on them is a great way to move the project forward.
Larger changes (rewriting parts of existing code from scratch, adding new functions to the core, adding new libraries) should generally be discussed by opening an issue first. PRs with such changes require testing and approval.
Feature branches with lots of small commits (especially titled "oops", "fix typo", "forgot to add file", etc.) should be squashed before opening a pull request. At the same time, please refrain from putting multiple unrelated changes into a single pull request.
Development Team:
- Tulio Almeida - GitHub - Google Scholar
- Abner Cardoso - GitHub - Google Scholar
- André Dantas - GitHub - Google Scholar
Publications
The publications related to this project are still in the process of being published. If you publish any paper using JAMA please contact us to update here!
Credits
- Daniele Comotti GitHub used as a basis for filters
- Sebastian Madgwick Reference for the manipulations of quaternions
- Center for Vision, Speech & Signal Processing - University of Surrey. For making available the Total Capture dataset used to develop the library example. Reference paper: Trumble et. al., 2017
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pyjamalib-1.0.0-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 935aad73ac0510c071b7943472412b2ec35251a5480649d718e103dda11fe49e |
|
| MD5 | 7c61bda20f8226ae5f2de0b516b26709 |
|
| BLAKE2b-256 | f4363e7f6ee3b34018d1a0b8f43dd317422a54f3a01c7c0d551920347ac81e0e |
