{"id":44600831,"url":"https://github.com/embodied-computation-group/systole","last_synced_at":"2026-02-14T09:39:50.519Z","repository":{"id":41403048,"uuid":"219720901","full_name":"embodied-computation-group/systole","owner":"embodied-computation-group","description":"Systole: A python package for cardiac signal synchrony and analysis","archived":false,"fork":false,"pushed_at":"2025-05-08T17:23:33.000Z","size":462919,"stargazers_count":85,"open_issues_count":14,"forks_count":31,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-02-03T13:31:56.733Z","etag":null,"topics":["biosignals","bokeh","electrocardiography","heart-rate-variability","hrv","oximeter","photoplethysmography","physiological-signals","ppg","psychology-experiments","psychophysiology"],"latest_commit_sha":null,"homepage":"https://embodied-computation-group.github.io/systole/#","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/embodied-computation-group.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-11-05T10:43:47.000Z","updated_at":"2025-10-21T18:27:02.000Z","dependencies_parsed_at":"2023-01-19T05:15:24.471Z","dependency_job_id":"fb1452b6-5605-4b06-abd7-9598bafc6c4f","html_url":"https://github.com/embodied-computation-group/systole","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/embodied-computation-group/systole","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/embodied-computation-group%2Fsystole","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/embodied-computation-group%2Fsystole/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/embodied-computation-group%2Fsystole/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/embodied-computation-group%2Fsystole/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/embodied-computation-group","download_url":"https://codeload.github.com/embodied-computation-group/systole/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/embodied-computation-group%2Fsystole/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29442128,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T07:24:13.446Z","status":"ssl_error","status_checked_at":"2026-02-14T07:23:58.969Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["biosignals","bokeh","electrocardiography","heart-rate-variability","hrv","oximeter","photoplethysmography","physiological-signals","ppg","psychology-experiments","psychophysiology"],"created_at":"2026-02-14T09:39:50.039Z","updated_at":"2026-02-14T09:39:50.511Z","avatar_url":"https://github.com/embodied-computation-group.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n.. image:: https://img.shields.io/badge/License-GPL%20v3-blue.svg\n  :target: https://github.com/embodied-computation-group/systole/blob/master/LICENSE\n\n.. image:: https://badge.fury.io/py/systole.svg\n    :target: https://badge.fury.io/py/systole\n\n.. image:: https://joss.theoj.org/papers/10.21105/joss.03832/status.svg\n   :target: https://doi.org/10.21105/joss.03832\n\n.. image:: https://codecov.io/gh/embodied-computation-group/systole/branch/master/graph/badge.svg\n   :target: https://codecov.io/gh/embodied-computation-group/systole\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n  :target: https://github.com/psf/black\n\n.. image:: https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat\u0026labelColor=ef8336\n  :target: https://pycqa.github.io/isort/\n\n.. image:: http://www.mypy-lang.org/static/mypy_badge.svg\n  :target: http://mypy-lang.org/\n\n.. image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\u0026logoColor=white\n  :target: https://github.com/pre-commit/pre-commit\n\n.. image:: https://badges.gitter.im/ecg-systole/community.svg\n   :target: https://gitter.im/ecg-systole/community?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\n\n================\n\n.. image:: https://github.com/embodied-computation-group/systole/blob/dev/docs/source/images/logo.png\n   :align: center\n\n================\n\n**Systole** is an open-source Python package implementing simple tools for working with cardiac signals for psychophysiology research. In particular, the package provides tools to pre-process, visualize, and analyze cardiac data. \nThis includes tools for data epoching, artefact detection, artefact correction, evoked heart rate analyses, heart rate \nvariability analyses, circular statistical approaches to analysing cardiac cycles, and synchronising stimulus \npresentation with different cardiac phases via Psychopy.\n\nThe documentation can be found under the following `link \u003chttps://embodied-computation-group.github.io/systole/#\u003e`_.\n\nIf you have questions, you can ask them in the `Gitter chat \u003chttps://gitter.im/ecg-systole/community?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u003e`_.\n\nHow to cite?\n++++++++++++\n\nIf you are using **Systole** in a publication we ask you to cite the following paper::\n\n  Legrand, N. \u0026 Allen, M., (2022). Systole: A python package for cardiac signal synchrony and analysis. Journal of Open Source Software, 7(69), 3832, https://doi.org/10.21105/joss.03832\n\n\nInstallation\n++++++++++++\n\nSystole can be installed using pip:\n\n.. code-block:: shell\n\n  pip install systole\n\nThe following packages are required to use Systole:\n\n* `Numpy \u003chttps://numpy.org/\u003e`_ (\u003e=1.15)\n* `SciPy \u003chttps://www.scipy.org/\u003e`_ (\u003e=1.3.0)\n* `Pandas \u003chttps://pandas.pydata.org/\u003e`_ (\u003e=0.24)\n* `Numba \u003chttp://numba.pydata.org/\u003e`_ (\u003e=0.51.2)\n* `Seaborn \u003chttps://seaborn.pydata.org/\u003e`_ (\u003e=0.9.0)\n* `Matplotlib \u003chttps://matplotlib.org/\u003e`_ (\u003e=3.0.2)\n* `Bokeh \u003chttps://docs.bokeh.org/en/latest/index.html#\u003e`_ (\u003e=2.3.3)\n* `pyserial \u003chttps://pyserial.readthedocs.io/en/latest/pyserial.html\u003e`_ (\u003e=3.4)\n* `setuptools \u003chttps://setuptools.pypa.io/en/latest/\u003e`_ (\u003e=38.4)\n* `requests \u003chttps://docs.python-requests.org/en/latest/\u003e`_ (\u003e=2.26.0)\n* `tabulate \u003chttps://github.com/astanin/python-tabulate/\u003e`_ (\u003e=0.8.9)\n\n\nThe Python version should be 3.7 or higher.\n\nTutorials\n=========\n\nFor an introduction to Systole and cardiac signal analysis, you can refer to the following tutorial:\n\n.. list-table::\n   :widths: 60 40\n   :header-rows: 0\n   :align: center\n\n   * - Cardiac signal analysis \n     - |Colab badge 1|\n   * - Detecting cardiac cycles \n     - |Colab badge 2|\n   * - Detecting and correcting artefats \n     - |Colab badge 3|\n   * - Heart rate variability \n     - |Colab badge 4|\n   * - Instantaneous and evoked heart rate \n     - |Colab badge 5|\n   * - Working with BIDS folders\n     - |Colab badge 6|\n\n.. |Colab badge 1| image:: https://colab.research.google.com/assets/colab-badge.svg\n  :target: https://colab.research.google.com/github/embodied-computation-group/systole/blob/dev/source/notebooks/1-PhysiologicalSignals.ipynb\n\n.. |Colab badge 2| image:: https://colab.research.google.com/assets/colab-badge.svg\n  :target: https://colab.research.google.com/github/embodied-computation-group/systole/blob/dev/source/notebooks/2-DetectingCycles.ipynb\n\n.. |Colab badge 3| image:: https://colab.research.google.com/assets/colab-badge.svg\n  :target: https://colab.research.google.com/github/embodied-computation-group/systole/blob/dev/source/notebooks/3-DetectingAndCorrectingArtefacts.ipynb\n\n.. |Colab badge 4| image:: https://colab.research.google.com/assets/colab-badge.svg\n  :target: https://colab.research.google.com/github/embodied-computation-group/systole/blob/dev/source/notebooks/4-HeartRateVariability.ipynb\n\n.. |Colab badge 5| image:: https://colab.research.google.com/assets/colab-badge.svg\n  :target: https://colab.research.google.com/github/embodied-computation-group/systole/blob/dev/source/notebooks/5-InstantaneousHeartRate.ipynb\n\n.. |Colab badge 6| image:: https://colab.research.google.com/assets/colab-badge.svg\n  :target: https://colab.research.google.com/github/embodied-computation-group/systole/blob/dev/source/notebooks/6-WorkingWithBIDSFolders.ipynb\n\n\nGetting started\n+++++++++++++++\n\n.. code-block:: python\n\n  from systole import import_dataset1\n\n  # Import ECg recording\n  signal = import_dataset1(modalities=['ECG']).ecg.to_numpy()\n\n\nSignal extraction and interactive plotting\n==========================================\nThe package integrates a set of functions for interactive or non interactive data visualization based on `Matplotlib \u003chttps://matplotlib.org/\u003e`_ and `Bokeh \u003chttps://docs.bokeh.org/en/latest/index.html#\u003e`_.\n\n.. code-block:: python\n\n  from systole.plots import plot_raw\n\n  plot_raw(signal[60000 : 120000], modality=\"ecg\", backend=\"bokeh\", \n              show_heart_rate=True, show_artefacts=True, figsize=300)\n\n.. image:: https://github.com/embodied-computation-group/systole/blob/dev/docs/source/images/raw.png\n   :align: center\n\n\nArtefacts detection and rejection\n=================================\nArtefacts can be detected and corrected in the RR interval time series or the peaks vector using the method proposed by Lipponen \u0026 Tarvainen (2019).\n\n.. code-block:: python\n\n  from systole.detection import ecg_peaks\n  from systole.plots import plot_subspaces\n\n  # R peaks detection\n  signal, peaks = ecg_peaks(signal, method='pan-tompkins', sfreq=1000)\n\n  plot_subspaces(peaks, input_type=\"peaks\", backend=\"bokeh\")\n\n.. image:: https://github.com/embodied-computation-group/systole/blob/dev/docs/source/images/subspaces.png\n   :align: center\n\n\nHeart rate variability analysis\n===============================\nSystole implements time-domain, frequency-domain and non-linear HRV indices, as well as tools for evoked heart rate analysis.\n\n.. code-block:: python\n\n  from bokeh.layouts import row\n  from systole.plots import plot_frequency, plot_poincare\n\n  row(\n      plot_frequency(peaks, input_type=\"peaks\", backend=\"bokeh\", figsize=(300, 200)),\n      plot_poincare(peaks, input_type=\"peaks\", backend=\"bokeh\", figsize=(200, 200)),\n      )\n\n.. image:: https://github.com/embodied-computation-group/systole/blob/dev/docs/source/images/hrv.png\n   :align: center\n\n\nOnline systolic peak detection, cardiac-stimulus synchrony, and cardiac circular analysis\n=========================================================================================\n\nThe package natively supports recording of physiological signals from the following setups:\n- `Nonin 3012LP Xpod USB pulse oximeter \u003chttps://www.nonin.com/products/xpod/\u003e`_ together with the `Nonin 8000SM 'soft-clip' fingertip sensors \u003chttps://www.nonin.com/products/8000s/\u003e`_ (USB).\n- Remote Data Access (RDA) via BrainVision Recorder together with `Brain product ExG amplifier \u003chttps://www.brainproducts.com/\u003e`_ (Ethernet).\n\nInteractive visualization of BIDS structured datasets\n=====================================================\n\n.. code-block:: python\n\n  from systole.viewer import Viewer\n\n  view = Viewer(\n      input_folder=\"/BIDS/folder/path/\",\n      pattern=\"task-mytask\",\n      modality=\"beh\",\n      signal_type=\"ECG\"\n  )\n\n.. image:: https://github.com/embodied-computation-group/systole/blob/dev/docs/source/images/editor.gif\n   :align: center\n\nInserting and removing peaks\n============================\n\n.. image:: https://github.com/embodied-computation-group/systole/blob/dev/docs/source/images/peaks.gif\n   :align: center\n\nAnnotating bad segments\n=======================\n\n.. image:: https://github.com/embodied-computation-group/systole/blob/dev/docs/source/images/segments.gif\n   :align: center\n\nDevelopment\n+++++++++++\n\nThis module was created and is maintained by Nicolas Legrand and Micah Allen (ECG group, https://the-ecg.org/). If you want to contribute, feel free to contact one of the developers, open an issue or submit a pull request.\n\nThis program is provided with NO WARRANTY OF ANY KIND.\n\nAcknowledgements\n++++++++++++++++\n\nThis software and the ECG are supported by a Lundbeckfonden Fellowship (R272-2017-4345), and the AIAS-COFUND II fellowship programme that is supported by the Marie Skłodowska-Curie actions under the European Union’s Horizon 2020 (Grant agreement no 754513), and the Aarhus University Research Foundation.\n\nSystole was largely inspired by pre-existing toolboxes dedicated to heartrate variability and signal analysis.\n\n* HeartPy: https://python-heart-rate-analysis-toolkit.readthedocs.io/en/latest/\n\n* hrv: https://github.com/rhenanbartels/hrv\n\n* pyHRV: https://pyhrv.readthedocs.io/en/latest/index.html\n\n* ECG-detector: https://github.com/berndporr/py-ecg-detectors\n\n* Pingouin: https://pingouin-stats.org/\n\n* NeuroKit2: https://github.com/neuropsychology/NeuroKit\n\n================\n\n|AU| |lundbeck| |lab|\n\n.. |AU| image::  https://github.com/embodied-computation-group/systole/blob/dev/docs/source/images/au_clinisk_logo.png\n   :width: 100%\n\n.. |lundbeck| image::  https://github.com/embodied-computation-group/systole/blob/dev/docs/source/images/lundbeckfonden_logo.png\n   :width: 20%\n\n.. |lab| image::  https://github.com/embodied-computation-group/systole/blob/master/ECG_logo%20(1).png\n   :width: 20%\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fembodied-computation-group%2Fsystole","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fembodied-computation-group%2Fsystole","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fembodied-computation-group%2Fsystole/lists"}