ERPLAB Toolbox is a free, open-source Matlab package for analyzing ERP data. It is tightly integrated with EEGLAB Toolbox, extending EEGLAB’s capabilities to provide robust, industrial-strength tools for ERP processing, visualization, and analysis. A graphical user interface makes it easy for beginners to learn, and Matlab scripting provides enormous power for intermediate and advanced users. Click the Wiki icon at the top of the page for documentation, tutorials, and FAQs.
To ask questions, subscribe to the ERPLAB email list (https://erpinfo.org/erplab-email-list). Bug reports can be submitted via GitHub or by sending an email to erplab-bugreports@ucdavis.edu.To install ERPLAB v10.1, download the zip file (linked above), unzip and place the folder in the 'plugins' folder of your existing EEGLAB installation (e.g. /Users/Steve/Documents/MATLAB/eeglab2019_1/plugins/erplab/
). More installation help can be found here.
To run ERPLAB, ensure that the correct EEGLAB folder is in your current Matlab path, and run eeglab
as a command from the Matlab Command Window. If you are new to ERPLAB, we strongly recommend that you go through the ERPLAB Tutorial before using ERPLAB with your own data.
We encourage most users to use this latest major version.
We anticipate that ERPLAB will work with most recent OSs, Matlab versions and EEGLAB versions.
- The Matlab Signal Processing Toolbox is required.
- EEGLAB v2021 or later is almost always necessary.
However, in order to use the latest MVPC routines (see here), Matlab versions and EEGLAB versions must be recent. In addition, some MATLAB toolboxes are required.
- Matlab 2020b + is REQUIRED for MVPC routines.
- EEGLAB 2023.1 + is REQUIRED for MVPC routines.
- The Matlab Statistics and Machine Learning Toolbox
- The Matlab Parallel Processing Toolbox (recommended)
Find more ERPLAB installation help here.
Here is a list of some confirmed-working environments for ERPLAB.
ERPLAB v10.0+ works with...
OS | Matlab | EEGLAB | Working? |
---|---|---|---|
Mac OS 14.2.1 'Sonoma' | Matlab R 2023a | EEGLAB v2023.1 | ✓ |
Mac OS 11.7.6 'Big Sur' | Matlab R 2020a | EEGLAB v2023.0 | ✓ |
Mac OS 10.15.7 'Catalina' | Matlab R2020b | EEGLAB v2023.0 | ✓ |
Mac OS 10.15 'Catalina' | Matlab R2016a | EEGLAB v2019_1 | ✓ |
(https://www.mathworks.com/downloads/web_downloads/download_update?release=R2018a&s_tid=ebrg_R2018a_2_1757132&s_tid=mwa_osa_a) | |||
Mac OS 10.13.5 'High Sierra' | Matlab R2015a | EEGLAB v14.1.2 | ✓ |
Windows 10 | Matlab R2021a | EEGLAB v2023.0 | ✓ |
Windows 10 | Matlab R2020b | EEGLAB v2021.1 | ✓ |
Ubuntu 18.04 LTS | Matlab R2019a | EEGLAB v2020 | ✓ |
Ubuntu 18.04 LTS | Matlab R2019a | EEGLAB v2019_1 | ✓ |
ERPLAB should work with most modern OSs, Matlab versions, and EEGLAB releases. Let us know if you see any incompatibility. Starting in ERPLAB v10.0, MATLAB'S "App Designer" was the default GUI system used for the MVPC routines and require at least MATLAB 2020a+ & EEGLAB 2023.1+ in order to work as expected.
Now Includes: Update to decoding toolbox. By default, beta weights will no longer be saved with MVPC files, dramatically reducing file size.
MVPCset and BESTset commands will now be saved into EEG working memory history (shown when using the function eegh).
Various quality of life changes and bug fixes across ERPLAB.
Now Includes:
ERP Decoding routine: Users can now apply multivariate-pattern classification routines to binned and epoched ERP data. See here for more information.
- NOTE: These routines require at least MATLAB 2020a+ & EEGLAB 2023.1+ in order to work as expected.
- NOTE: These routines also require the following toolboxes: Matlab Statistics and Machine Learning Toolbox, Matlab Parallel Processing Toolbox (recommended)
Advanced ERP Wave Viewer: Plotting ERP waveforms are easier than ever using "ERP Wave Viewer". See: ERPLAB > Plot ERPs > Advanced ERP Waveform Viewer (Beta)
Now Includes: Create Artificial Waveform Viewer routine: Users can simulate a variety of waveforms to be saved as ERP files (.erp). See documentation here.
New options for adding noise to data via EEG and ERP channel operations (see here).
Users may now shift string event codes in time in addtion to numeric event codes (see Preprocess EEG > Shift Event Codes (continuous EEG)).
Various bug fixes across ERPLAB.
Now includes: Updated Data Quality (DQ) metrics specifications on averaged ERP waveforms, including a new metric: SD across trials.
A new DQ metric for continuous EEG: Spectral Data Quality (continuous EEG)
Various bug fixes concerning bootstrapped SMEs, filtering, and EEG channel operations.
Note: ERPLAB v9.00 is the recommended version for use with best practices in ERP data processing and analyses as outlined in Dr. Steven J Luck's new Applied Event-Related Potential Data Analysis e-book here.
Now includes: Ability to low-pass filter prior to marking EEG segments with all artifact detection routines (data is not saved with the filter).
Ability to calculate Data Quality measures (e.g. analytic SME) on multiple binned and epoched EEGset files prior to creating ERPs. -More information about the SME can be found here. -See Applied Event-Related Potential Data Analysis e-book here for best-practices on this approach.
Various fixes to the GUI layouts for many routines (e.g. "Delete Time Segments" for EEG processing).
ERPLAB tutorial, manual, and other documentation can be found on the ERPLAB wiki, here.