Skip to content

Improvements of the ZapLine function to remove line noise from EEG/MEG data. Adds automatic detection of the number of components to remove, and chunks the data into segments to account for nonstationarities.

License

Notifications You must be signed in to change notification settings

MariusKlug/zapline-plus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

83 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Zapline-plus

Zapline-plus is a wrapper for Zapline that automatically removes spectral peaks like line noise from your data while ensuring minimal negative impact, preserving both the non-noise spectrum and the data rank. It searches for noise frequencies, divides the data into spatially stable chunks, and adapts the cleaning strength automatically. A detailed plot is created.

Quick start

If you just want to download the package and use Zapline-plus with any data matrix, you can feed that data and the sampling rate directly in like this:

cleanedData = clean_data_with_zapline_plus(data,srate);

Or if you live in the EEGLAB universe, you can install Zapline-plus via the EEGLAB plugins manager and then run the cleaning either via the Tools GUI or in the command line like this:

EEG = clean_data_with_zapline_plus_eeglab_wrapper(EEG,struct('noisefreqs','line')) % specifying the config is optional

Detailed user guide

Please check out the wiki articles for a detailed guide on how to use Zapline-plus and how to interpret the plot.

Please cite

Klug, M., & Kloosterman, N. A. (2022). Zapline-plus: A Zapline extension for automatic and adaptiveremoval of frequency-specific noise artifacts in M/EEG. Human Brain Mapping,1–16. https://doi.org/10.1002/hbm.25832

de Cheveigne, A. (2020). ZapLine: a simple and effective method to remove power line artifacts. NeuroImage, 1, 1-13. https://doi.org/10.1016/j.neuroimage.2019.116356

Dependencies of Noisetools are provided with permission by Alain de Cheveigné. Please visit the original repository for more info and additional noise removal tools: http://audition.ens.fr/adc/NoiseTools/

Requirements

  • Signal Processing Toolbox
  • Statistics Toolbox

About

Improvements of the ZapLine function to remove line noise from EEG/MEG data. Adds automatic detection of the number of components to remove, and chunks the data into segments to account for nonstationarities.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages