amisepa/BrainBeats

The BrainBeats toolbox, implemented as an EEGLAB plugin, allows joint processing and analysis of EEG and cardiovascular signals (ECG/PPG).

BrainBeats

The BrainBeats toolbox, implemented as an EEGLAB plugin, allows joint processing and analysis of EEG and cardiovascular signals (ECG and PPG) for brain-heart interplay research. Both the general user interface (GUI) and command line are supported (see tutorial). BrainBeats currently supports: 1) Heartbeat-evoked potentials (HEP) and oscillations (HEO); 2) Extraction of EEG and HRV features; 3) Extraction of heart artifacts from EEG signals; 4) brain-heart coherence.

THREE METHODS AVAILABLE

1. Process EEG data for heartbeat-evoked potentials (HEP) analysis using ECG or PPG signals. Steps include signal processing of EEG and cardiovascular signals, inserting R-peak markers into the EEG data, segmentation around the R-peaks with optimal window length, time-frequency decomposition.

Example of HEP at the subject level, obtained from simultaneous EEG-ECG signals

Example of HEP at the subject level, obtained from simultaneous EEG-PPG signals

2. Extract EEG and HRV features from continuous data in the time, frequency, and nonlinear domains.

   • HRV time domain: SDNN, RMSSD, pNN50.

   • HRV frequency domain: VLF-power, ULF-power, LF-power, HF-power, LF:HF ratio, Total power.

   • HRV nonlinear domain: Poincare, fuzzy entropy, fractal dimension, PRSA.

   • EEG frequency domain: average band power (delta, theta, alpha, beta, gamma), individual alpha frequency (IAF), alpha asymmetry.

   • EEG nonlinear domain: fuzzy entropy, fractal dimension

Example of power spectral density (PSD) estimated from HRV and EEG data

Example of EEG features extracted from sample dataset

3. Remove heart components from EEG signals using ICA and ICLabel.

Example of extraction of cardiovascular components from EEG signals

4. Compute brain-heart coherence (beta version, please test and give feedback)

Example of several brain-heart coherence measures computed with BrainBeats from simultaneous EEG and ECG signals

Scalp topography showing scalp regions coherent with ECG signal for each frequency band

Requirements

• MATLAB installed (https://www.mathworks.com/downloads)
• EEGLAB installed (https://github.com/sccn/eeglab)
• Some data containing EEG and cardiovascular signals (ECG or PPG) within the same file (i.e. recorded simultaneously). Or use the tutorial dataset provided in this repository located in the "sample_data" folder. Source: sub-32 in https://nemar.org/dataexplorer/detail?dataset_id=ds003838

Step-by-step tutorial

See our publication for a step-by-step tutorial using the sample dataset: https://www.jove.com/t/65829/brainbeats-as-an-open-source-eeglab-plugin-to-jointly-analyze-eeg

Full-text preprint: https://www.biorxiv.org/content/10.1101/2023.06.01.543272v3.full

Version history

v1.5 (5/2/2024) - METHOD 4 (brain-heart coherence) added

v1.4 (4/1/2024) - publication JoVE (methods 1, 2, 3)