The current implementation of OpenEP is a Matlab library which depends upon access to the Matlab executable to run. Once you have Matlab installed on your system, download the OpenEP source code, or clone from Github and add the entire directory to your Matlab path. Then you are ready to begin exploring OpenEP.
Matlab R2020a, or later.
OpenEP installation is as simple as downloading the source code and adding to the Matlab path. Depending on your experience you can simply download the code here, or you can install using version control as outlined below.
- Step 1
Grab the source code using git
mkdir ~/openep cd ~/openep git clone https://github.com/openep/openep-core.git
Checkout the develop branch
git checkout develop
- Step 2
Launch Matlab and add the OpenEP directories to the path
openEpPath = '~/openep/openep-core'; addpath(genpath(openEpPath));
- Step 3
OpenEP is now ready to use!
To test out your new OpenEP installation, try working with the OpenEP Example Datasets:
cd ~/openep git clone https://github.com/openep/openep-examples.git
Make sure the
openep-examples directory is added to your Matlab path.
openEpExPath = '~/openep/openep-examples' addpath(genpath(openEpExPath));
You shoud now be able to try the OpenEP demo:
If everything is working correctly you should see a figure similar to the following: (Note however that there is currently a bug where the colormap of the colorbar in the conduction velocity panel is not correct).
Each OpenEP function is fully documented within the file header. A complete list of the API Reference Documentation is also available here - API Reference Documentation.
The data format for OpenEP is also documented here - Data Reference Documentation.
If you use OpenEP in your research, please cite the Frontiers in Physiology publication together with the Zenodo DOI for the particular OpenEP release that you use
Frontiers in Physiology Publication
Williams SE, Roney CH, Connolly A, Sim I, Whitaker J, O’Hare D, Kotadia I, O’Neill L, Corrado C, Bishop M, Niederer SA, Wright M, O’Neill M and Linton NWF (2021) OpenEP: A Cross-Platform Electroanatomic Mapping Data Format and Analysis Platform for Electrophysiology Research. Front. Physiol. 12:646023. doi: 10.3389/fphys.2021.646023
OpenEP Releases (Zenodo)
Williams SE and Linton NWF (DATE). OpenEP/openep-core: vX.X.XX (Version vX.X.XX). Zenodo. https://doi.org/10.5281/zenodo.4471318
Note that the DOI above always resolves to the latest OpenEP release, but the Date and Version Numbers need to be updated.
Contributing to OpenEP
OpenEP has been in continually development for the past 10 years during the course of the developers’ active electrophysiology research. The OpenEP platform itself was available to selected collaborators throughout this time but was made available to the community at the end of 2020 with the first official release in February 2021.
We hope that the open source nature of this platform will now support future collaborative developments in open electrophysiology data analysis and we encourage interested researchers, academcis and industry partners to contact firstname.lastname@example.org to discuss collaborations.