Skip to content

LNS automated matlab scripts for ERP pre-processing (v.2.0)

License

Notifications You must be signed in to change notification settings

CorentinWicht/autoERP2.0

 
 

Repository files navigation

autoERP2.0

This is an updated version of the original autoERP developed by Hugo Najberg and Corentin Wicht.

Changes from autoERP to autoERP2.0

  1. EEGLAB and its plugins have been updated and compatibility issues have been addressed.
  2. The to-be-interpolated electrodes are now removed before running CleanLine and ASR pre-processing algorithms (to avoid injecting high-amplitude noise and compromising the algorithms efficiency).
  3. The GUI offers the possibility to define boundary triggers (Beginning and End of files) to remove portions of the EEG recording (outside these boundaries) which may be useless (e.g. break between blocks of trials). Again, the idea is to avoid injecting noisy data (e.g. muscle movements) into the pre-processing algorithms.

All the changes were reported in the Wiki user manual.

Description:

LNS automated Matlab scripts for pre-processing raw EEG signal into filtered epoched data (Filtering_epoching.m), performing Independent Components Analyses (ICA) (Comp_ICA.m), and computing ERPs after interpolation and artefacts rejection (ERPs.m).

Flexible and adaptable to all designs and folder trees.

All steps can be skiped. All default values can be modified.

A log is generated after each run to explain what was done to the files.

For more information on how to get started, please refer to the Wiki user manual.

⚠️ Currently only compatible with raw .bdf (BioSemi) and .set files with 64 channels

Script order and details:

1) Filter_epoching.m

This script filters, imports marker files (.mrk) and epochs .bdf or .set files. You can create and save your epoching parameters in a .mat file to re-load them in a future use of this script.

Filtering pipeling:

  1. Re-referencing
  2. Bandpass filtering
  3. Removing sinusoidal noise (CleanLine)
  4. Detecting blinks (Blinker)
  5. Non-sinusoidal noise filtering (ASR)
  6. Removing the blinks detected in 4.
  7. Applying baseline correction

At the end of the epoching process, a to_interpolate.xlsx file is generated.
You can write in it the bad channels that will have to be interpolated and load them during the ERPs script.
Do not erase the first example line of the to_interpolate.xlsx file.

2) comp_ICA.m (optional)

This script will automatically computed ICA on all the loaded files and will prompt the user to select the components that should be rejected for each of the files. The components rejection graphical interface is based on the ICLabel display.

3) ERPs.m

  1. Interpolate the bad channels
  2. Reject epochs containings artifacts while ignoring the bad channels: 80uV threshold criterion and 30uV jumps
  3. Compute the ERP based on averaging parameters
  4. Compute the average reference or reference to Cz

You can create and save your averaging parameters to re-load them in a future use of this script. If no merging condition and no events are given, each file will be averaged over all its epochs. At the end of the run, a file named Ntrials.xlsx is generated. It contains the number of epochs at the start, deleted during artifacts rejection, and in the final ERPs.

Dependencies

PLUGINS Description
EEGLAB v2021.0 Main software that manages most of the preprocessing and analyses toolboxes described in the table below
BLINKER v1.1.2 BLINKER is an automated pipeline for detecting eye blinks in EEG and calculating various properties of these blinks
CleanLine v2.0 This plugin adaptively estimates and removes sinusoidal (e.g. line) noise from your ICA components or scalp channels using multi-tapering and a Thompson F-statistic
Clean_rawdata v2.3 This plugin is used solely for the vis_artifacts.m function for the ICA script
ICLabel v1.3 An automatic EEG independent component classifer plugin
EEGInterp Homemade function to compute multiquadric interpolation based on radial basis function

Isolated functions:

The dependencies are already included in the Functions folder and loaded automatically.

Authors

Hugo Najberg
SNSF PhD student
[email protected], [email protected]
Laboratory for Neurorehabilitation Science
University of Fribourg, Switzerland

Corentin Aurèle Wicht
SNSF Doc.CH PhD student
[email protected], [email protected]
Laboratory for Neurorehabilitation Science
University of Fribourg, Switzerland

Cite the repository

C.A. Wicht, H. Najberg, autoERP2.0, (2021), GitHub repository https://github.com/CorentinWicht/autoERP2.0
DOI

License

Creative Commons License
This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License.

See the LICENSE.md file for details

Acknowledgments:

PD Dr. Lucas Spierer from the University of Fribourg provided substantial support and advices regarding theoretical conceptualization as well as access to the workplace and the infrastructure required to successfully complete the project. Additionally, Dr. Michael Mouthon and Dr. Michael De Pretto provided substantial advice on the pre-processing pipeline, ergonomy and testing.

Fundings

This project was supported by a grant from the Velux Foundation (Grant #1078 to LS); from the Swiss National Science Foundation (Grant #320030_175469 to LS); and from the Research Pool of the University of Fribourg to PD Dr. Lucas Spierer.

About

LNS automated matlab scripts for ERP pre-processing (v.2.0)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • MATLAB 91.5%
  • Cuda 2.2%
  • C++ 2.1%
  • M 0.9%
  • Fortran 0.7%
  • TeX 0.6%
  • Other 2.0%