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.
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 (1.x.x, /path/to/pyjamalib)
- Example of using the library associeted with JAMA.
- Example of using JAMA in a real situation.
- Example of using the library using data extracted using Vicon and Xsens.
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.
- Tulio Almeida - GitHub - Google Scholar
- Abner Rodrigues - GitHub - Google Scholar
- André Dantas - GitHub - Google Scholar
- de Almeida TF, Morya E, Rodrigues AC, de Azevedo Dantas AFO. Development of a Low-Cost Open-Source Measurement System for Joint Angle Estimation. Sensors. 2021; 21(19):6477. https://doi.org/10.3390/s21196477
- If you publish any paper using PyJama please contact us to update here!
- Daniele Comotti & Michele Ermidoro Reference for the 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