Skip to content

devnums/pyheartlib

Repository files navigation

Pyheartlib

Documentation Status Workflow license-AGPL--3.0 OS Python Version codecov PyPI pre-commit Imports: isort Code style: black Ruff DOI

Pyheartlib is a Python package for processing electrocardiogram (ECG) recordings. This software facilitates working with signals for tasks such as heartbeat detection, heartbeat classification, and arrhythmia classification. Utilizing it, researchers can focus on these tasks without the burden of designing data processing modules. The package transforms original data into processed signal excerpts and their computed features in order to be used for training various machine learning models including advanced deep learning models, which can be trained by taking advantage of Keras and Tensorflow libraries.

Documentation

Documentation is available at the link below.

pyheartlib.readthedocs.io.

Requirements

Current version of the package was tested on:

  • Ubuntu: 20.04 | 22.04 & Python: 3.10 | 3.11 & Processor: x86_64

  • macOS: 12.6.9 | 13.6 & Python: 3.10 | 3.11 & Processor: x86_64

However, it may also be compatible with other systems.

Installation

The package can be installed with pip:

$ pip install pyheartlib

Examples

Examples can be found in the examples section of the documentation and also in the GitHub repository (examples).

Citation

To cite this software, please use:

Mohammadi, S., (2024). Pyheartlib: A Python package for processing electrocardiogram signals. Journal of Open Source Software, 9(95), 5792, https://doi.org/10.21105/joss.05792

BibTeX:

@article{devnums_pyheartlib_2024,
    doi = {10.21105/joss.05792},
    url = {https://doi.org/10.21105/joss.05792},
    year = {2024},
    publisher = {The Open Journal},
    volume = {9},
    number = {95},
    pages = {5792},
    author = {Sadegh Mohammadi},
    title = {Pyheartlib: A Python package for processing electrocardiogram signals},
    journal = {Journal of Open Source Software}
}

Contributing

Feedback and contributions are appreciated. The guidelines for contributing are provided here.

Discussions & Support

For any questions, discussions, or problems with this software, please join us on Discord. An alternative option is to open a GitHub issue. (Issues, New issue)

License

Pyheartlib is released under the AGPL-3.0-only License.