A user friendly application for screening and manipulation of ECG data and the analysis of heart rate variability.


Updated 3 Nov 2020

From GitHub

View License on GitHub

# HRVTool v1.07
## Methods for analyzing Heart Rate Variability

The present functions are originally made for Matlab R2016b. Errors may occur using older releases (at least R2014b required). Additional toolboxes are not required to run the basic analysis.
The Image Processing Toolbox is recommended and required to use the 'picker'-functionality.
Importing ECGs out of PDFs requires Matlab start as administrator and the installation of Inkscape (or for Linux: PDFminer and pdf2svg).

**HRV.m** is a Matlab class containing function for analyzing HRV.
**HRVTool.m** contains the code to start the GUI (Graphical User Interface) on Matlab.
**HRVTool.mlappinstall** is the app package which can be installed with Matlab.

Please run HRVTool.m to start the GUI or click on the icon in the App menu of Matlab.
The user interface has been tested on Windows 10, Linux Ubuntu 18.04 and Mac OS 10.15.6.

### Supported file types
- [x] HRM - Polar files
- [x] MAT - Matlab files, structures or workspace variables containing waveforms or RR intervals (in ms)
- [x] TXT - text files containing waveforms or RR intervals (in ms)
- [x] ECG - PhysioNet files (PhysioNet wfdb toolbox required)
- [x] WAV - Hexoskin files
- [x] EDF - European Data Format
- [x] ACQ - BIOPAC data (Source code of Jimmy Shen)
- [x] ISHNE - Holter Standard Format (ECG and annotation data)
- [x] MIBF - Machine Independent Beat file (GE Marquette holter format)
- [x] PDF - ECG-PDFs from Apple Watch and AliveCor devices (Kardia and aliveecg)

Other formats are possible to integrate. Please address your wishes to

Supporting files to load BIOPAC ACQ data (load_acq.m, acq2mat.m) are licensed by Jimmy Shen given the copyright notice LICENSE_ACQ.
Copyright (c) 2009, Jimmy Shen
All other supported files and functions are licensed under the terms of the MIT License (MIT) given in LICENSE and LICENSE_ICONS
Copyright (c) 2015-2020 Marcus Vollmer

27 October 2020

Cite As

Vollmer, Marcus. “HRVTool - an Open-Source Matlab Toolbox for Analyzing Heart Rate Variability.” 2019 Computing in Cardiology Conference (CinC), Computing in Cardiology, 2019, doi:10.22489/cinc.2019.032.

View more styles

Vollmer, Marcus. “A Robust, Simple and Reliable Measure of Heart Rate Variability Using Relative RR Intervals.” 2015 Computing in Cardiology Conference (CinC), IEEE, 2015, doi:10.1109/cic.2015.7410984.

View more styles
MATLAB Release Compatibility
Created with R2020b
Compatible with R2016b and later releases
Platform Compatibility
Windows macOS Linux
Find more on ECG / EKG in Help Center and MATLAB Answers

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!

Versions that use the GitHub default branch cannot be downloaded

Version Published Release Notes

Changed dialog window procedure to allow the import of data from files and the workspace. Added dialog for importing annotation files to ignore beats. Minor changes in reading and writing edf-files and in the import of ECG-pdfs.


Support of ECG-PDFs (*.pdf) from Apple Watch and AliveCor Kardia. It also imports the beat ticks (annotations) that comes with the PDF. Save the annotations as EDF files and import workspace variables. Approximate entropy included.


Citation notes updated


EDF import function improved to save memory. Saving of pdf-screenshots with resolution selection and printer friendly light colors. MIB/MIBF files from GE Marquette holter devices (Machine Independent Beat file, '*.mib', '*.mibf') supported.


Editing annotations (align all or local beats to negative or positive peaks). Buttons: show/hide annotations, normalize the waveform, font size. Animation of waveform data. Selection of a color scheme (dark mode). Automated resizing of fonts.


Bug resolved when searching for the app path.


Added functionality for editing/saving annotations (add, remove and ignore beats). Support of ISHNE Holter Standard Format ('*.ecg', '*.ann'). Selection of beat types when importing PhysioNet and ISHNE annotation files. Simplified search for AppPath.


BIOPAC ACQ files supported.

You are also able to install the latest MatlabApp from

You are now able to read the '*.csv' files with a comma as a decimal mark. Resolved some bugs in reading the application path and in the path of '*.wav' files.
Additional toolboxes are not required any more
Ability to read the '*.edf' files - the European Data Format - a standard format for medical time series. Corrected calculation for Approximate Entropy ApEn in the HRV.m class.
You are now able to read the ECG from '*.wav' files which are generated from Hexoskin products using the binary file export

To view or report issues in this GitHub add-on, visit the GitHub Repository.
To view or report issues in this GitHub add-on, visit the GitHub Repository.