pyemgpipeline
pyemgpipeline: A Python package for electromyography processing - Published in JOSS (2022)
Science Score: 93.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 1 DOI reference(s) in JOSS metadata -
○Academic publication links
-
○Committers with academic emails
-
○Institutional organization owner
-
✓JOSS paper metadata
Published in Journal of Open Source Software
Scientific Fields
Repository
Basic Info
- Host: GitHub
- Owner: aalhossary
- License: gpl-3.0
- Language: Python
- Default Branch: master
- Size: 16.6 MB
Statistics
- Stars: 11
- Watchers: 3
- Forks: 4
- Open Issues: 0
- Releases: 1
Metadata Files
README.md
EMG Signal Processing Pipeline
pyemgpipeline is an electromyography (EMG) signal processing pipeline package.
This package implements internationally accepted EMG processing conventions and provides a high-level interface for ensuring user adherence to those conventions, in terms of (1) processing parameter values, (2) processing steps, and (3) processing step order.
The processing steps included in the package are DC offset removal, bandpass filtering, full wave rectification, linear envelope, end frame cutting, amplitude normalization, and segmentation.
Scope
This package defines the processing pipeline for both surface EMG and intramuscular EMG but not for high density EMG. The EMG recording requires that the minimum sample rate be at least twice the highest cutoff frequency of the bandpass filter based on the Nyquist theorem.
Overview
In pyemgpipeline, class DataProcessingManager in module wrappers is
designed as the main wrapper for high-level, guided processing,
and users are encouraged to use it to adhere to accepted EMG processing conventions.
The other classes, methods, and functions are considered as lower level processing
options.
The package is organized in modules processors, wrappers, and plots.
Module processors includes the base class BaseProcessor of all signal
processors and seven classes for different processing steps:
DCOffsetRemover, BandpassFilter, FullWaveRectifier, LinearEnvelope,
EndFrameCutter, AmplitudeNormalizer, and Segmenter.
Module wrappers includes three wrapper classes to facilitate the signal
processing by integrating data and individual processors.
Class EMGMeasurement works for data of a single trial,
class EMGMeasurementCollection works for data of multiple trials,
and class DataProcessingManager is the high-level, guided processing wrapper
with EMG processing conventions.
Module plots includes
the function plot_emg to plot EMG signals on matplotlib figures
and the class EMGPlotParams to manage the plot-related parameters.
Documentation
The documentation describes how to use this package, including package installation, quick start, examples explaining the breadth of the package’s functionality, and API reference.
Community Guidelines
For contribution, please clone the repository, make changes, and create a pull request.
For reporting any issues, please use github issues.
For support, please contact the authors via their emails or github issues.
Citation
If you use this package in your project, please cite this work.
Owner
- Name: Amr ALHOSSARY
- Login: aalhossary
- Kind: user
- Location: United States
- Company: Wesleyan University
- Website: https://www.linkedin.com/in/amralhossary/
- Repositories: 25
- Profile: https://github.com/aalhossary
Postdoctoral research fellow
JOSS Publication
pyemgpipeline: A Python package for electromyography processing
Authors
Nanyang Technological University, School of Mechanical & Aerospace Engineering
Nanyang Technological University, Rehabilitation Research Institute of Singapore
Kyoto University, Department of Human Health Sciences
Nanyang Technological University, School of Mechanical & Aerospace Engineering, Nanyang Technological University, Rehabilitation Research Institute of Singapore
Nanyang Technological University, Rehabilitation Research Institute of Singapore
Editor
Øystein Sørensen
Tags
electromyography EMG processingGitHub Events
Total
- Watch event: 1
- Fork event: 1
Last Year
- Watch event: 1
- Fork event: 1
Committers
Last synced: 7 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| tlwu | t****8@g****m | 63 |
| Amr ALHOSSARY | a****y@h****m | 8 |
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 4
- Total pull requests: 0
- Average time to close issues: 13 days
- Average time to close pull requests: N/A
- Total issue authors: 2
- Total pull request authors: 0
- Average comments per issue: 2.25
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- osorensen (3)
- tuliofalmeida (1)
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 138 last-month
- Total dependent packages: 0
- Total dependent repositories: 1
- Total versions: 3
- Total maintainers: 1
pypi.org: pyemgpipeline
EMG signal processing pipeline
- Homepage: https://github.com/aalhossary/pyemgpipeline
- Documentation: https://pyemgpipeline.readthedocs.io/
- License: GNU General Public License v3 (GPLv3)
-
Latest release: 1.0.0
published almost 4 years ago
Rankings
Maintainers (1)
Dependencies
- matplotlib *
- numpy *
- scipy *