EEGLAB Bugs

From SCCN
Jump to: navigation, search

Some information here may be outdated or fixed with newer versions of EEGLAB. Please examine your current version documentation to check.

How do I report a Bug?

EEGLAB bugs are managed under Github EEGLAB Issues. The old EEGLAB Bugzilla interface has been deprecated although it is still being used to track potential improvements.

Dealing with EEGLAB bugs and suggestions:

  • Since EEGLAB has been developed under Matlab, there is litle risk that using EEGLAB will crash your machine or erase files inadvertently, unless Matlab itself crashes. This is one advantage of using Matlab.
  • Most of the core EEGLAB functions have been or are being used in our published manuscripts, which are available for download from the SCCN website. Consult these papers, plus the extensive EEGLAB tutorial and help facilities, for instructions and examples of their use.
  • About 1000 test cases run daily on EEGLAB code to test its integrity and that its functions are stable. See EEGLAB test cases
  • EEGLAB is an open source project. To understand in more detail how any signal processing is performed, you may simply study the function source file. To adjust its performance, you may simply edit it yourself. Note: If you do this successfully, please consider issuing a pull request on Github. See more information on contributing to EEGLAB.
  • If you encounter a bug, please first read carefully the Matlab commandline and any error window text, to determine whether you may be able to avoid the problem directly. Next, test whether the error occurs using current release of EEGLAB. If so, check the Github EEGLAB Issues to see if your issue has already been reported.
    • If your issue has been reported, you may comment on the bug.
    • If your issue has not been reported, you may submit a new bug. Once you press the "New issue" button, you will be guided on how on the type of information needed to report your bug.

Some known EEGLAB bugs and/or missing features:

  • Epoch selection using pop_eegplot(): Epochs selected for rejection using eegplot() data scrolling are not saved in EEGLAB history until the epochs are actually rejected. This means that they will not be reproduced automatically in a new EEGLAB session. However, the labeled epochs are identified in the field EEG.reject.manualrej that is saved along wth the dastaset. Also, and more importantly, when the labeled epochs are actually rejected, this operation is saved in EEGLAB history.
  • Zooming using pop_eegplot(): When zooming and selecting epochs, only the data may be zoomed.
  • Spectral analysis (with no Matlab Signal Processing Toolbox): The spec() function emulates the function psd() but not the function pwelch() (psd() was replaced by pwelch(), beginning with EEGLAB 4.3, for technical reasons). As a result, the scaling of the spectrum (by the spectopo() function only) is slightly different than when the Matlab Signal Processing Toolbox is present. Also, for unknown reasons, the spec() function cannot handle frequencies that have been filtered out and may return inaccurately high power over these frequency regions.
  • Matlab versions and OS: Matlab versions have different bugs under different OS and these bugs - usually graphical bugs - may affect EEGLAB. The latest one we know of is the fact that Matlab version 2018a (all OS) requires a patch for EEGLAB to work.
Return to EEGLAB Wiki
Return to SCCN Wiki Home