DETECT_ECG_BEATS - detects beats in ECG.

DETECT_ECG_BEATS detects beats in an electrocardiogram (ECG) signal using two beat detectors, and uses the agreement between beat detectors to assess the quality of beat detections.

Inputs

  • ecg : a vector of ECG values

  • fs : the sampling frequency of the ECG in Hz

  • options : (optional) a structure of options which determine the settings used for the analysis:

    • options.win_durn - The duration of windows over which to perform quality assessment (in secs)
    • options.win_overlap - The overlap of windows (in secs)
    • options.verbose - A logical indicating whether (1) or not (0) to display text in the Command Window
    • options.qrs_tol_window - The acceptable tolerance window around QRS spikes (in secs)
    • options.beat_detectors - The ECG beat detectors to be used. Provide a cell containing either 1 or 2 out of: {'gqrs', 'jqrs', 'rpeakdetect'}
    • options.hpf - A logical indicating whether (1) or not (0) to high-pass filter the ECG to remove baseline wander

  • no_signal_vector : (optional) a vector of the same length as the ECG vector, which indicates whether (1) or not (0) there was a signal at each sample

Outputs

  • agreed_beats_inds : the indices of detected beats which both beat detectors agree on

  • qual : a logical indicating whether (1) or not (0) beats agreed between beat detectors for each ECG sample

  • temporary file - this script creates a temporary file in the current directory

Exemplary usage:

    options.win_durn = 20;
    [agreed_beats_inds, qual] = detect_ecg_beats(ecg, fs, options)

Requirements:

When using the gqrs beat detector, the Waveform Database Software Package (WFDB) for MATLAB and Octave is required, available from: https://doi.org/10.13026/6zcz-e163

Documentation

https://ppg-beats.readthedocs.io/

Author

Peter H. Charlton, University of Cambridge, February 2022.

Acknowledgment:

This script uses scripts from the PhysioNet Cardiovascular Signal Toolbox (under the GNU public licence):

It also uses the 'rpeakdetect.m' script (under the GNU public licence):

Version

1.0

License - GPL-3.0

   This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
   This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
   You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.