carolchuchu / erplab Goto Github PK

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.

To install ERPLAB v7.0.0, 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/eeglab13_6_4b/plugins/erplab7.0.0/). 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. Find our tutorial here.

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.

• We recommend a 64 bit OS, 64 bit Matlab, and at least 4 GB RAM. Most modern computers meet this.
• The Matlab Signal Processing Toolbox is required
  • Entering in the command ver in the Command Window will produce a list of installed toolboxes. Check this list to see whether the Signal Processing Toolbox is installed
• EEGLAB v12 or later is recommended. EEGLAB v11 is not recommended.

Find installation help here

Here is a list of some confirmed-working environments for ERPLAB.

*ERPLAB v7.0.0

• Updated tools for pre-processing continuous EEG, including functions for

  • deleting time segments
  • shifting event codes
  • selective electrode interpolation

• Crucial compatibility fixes to allow running in R2017b and later, while still being backwards-compatible with older versions of Matlab. No more yellow warnings about NARGCHK in R2016a or later.

Some additions and minor bugfixes, including:

• Removing channels can now avoid deleting all channel location information
• More channel location tools
• Measurement Window GUI now fits on a smaller screen
• Improvements in 'Preprocess Continuous EEG' options
• Fixed a bug where the number of loaded erpsets would be mistakenly taken to be zero
• Improved Current-Source-Density compatibility
• Replaced the error 'Quack' noise with a beep, and replaced some error pictures.

Minor bugfixes, including:

• Cleaned up the Measurement Viewer text and options
• Measurement Viewer helper text now only shown when relevant

Minor bugfixes, including:

• Fixed BDF Library url-link in BDF-Visualizer
• Swapped artifact and user-flag display in BDF-Visualizer

Minor bugfixes, including:

• Shift Event Codes GUI fix - now doesn't crash on launch.
• Adopted [Major].[Minor].[Patch] version numbers, this being v6.1.1, with backward-compatible file loading. Note - from v6.0, we no longer indicate the file type usage in the version number, and this is now always taken to be 1.

With ERPLAB v6.0, we include a variety of new features, user-interface improvements, bug-fixes, and improvements to existing functions. Among these, we have:

EEG or ERP data can be used to compute an estimate of the Current Source Density (CSD). We include new functions to take data loaded in ERPLAB (either EEG or ERP) and compute the CSD data. We use CSD methods from Jürgen Kayser (from the CSD Toolbox).

These tools can be found in the new 'ERPLAB -> Data Transformations' menu. A new ERPLAB dataset is generated, with CSD data in the place of EEG/ERP data.

Find CSD documentation here

In the ERP Measurement tool, ERPLAB can record measurements of local peaks and the time of a fractional peak, like 50% peak. Previously, this fractional peak measurement was taken from the 'onset' of the peak, before the peak. In v6.0, ERPLAB also has an option to measure the fractional peak 'offset', the 50% peak value after the peak.

For more easy editing, ERPLAB documentation has been moved to a wiki here.

Bug fixes as detailed here