RELAX-v2.0.0

RELAX

The Reduction of Electroencephalographic Artifacts (RELAX) is an open source extension for EEGLAB that provides a fully automated method to clean EEG data.

Downloading RELAX:
To download and install RELAX, click on the source code in the "Assets" section below, and unzip into your EEGLAB plugins folder.

Further information:
Further information can be found in the publication manuscripts, which must be cited when RELAX is used:

Bailey, N. W., Biabani, M., Hill, A. T., Miljevic, A., Rogasch, N. C., McQueen, B., ... & Fitzgerald, P. B. (2023). Introducing RELAX: An automated pre-processing pipeline for cleaning EEG data-Part 1: Algorithm and application to oscillations. Clinical Neurophysiology.

Bailey, N. W., Hill, A. T., Biabani, M., Murphy, O. W., Rogasch, N. C., McQueen, B., ... & Fitzgerald, P. B. (2023). RELAX part 2: A fully automated EEG data cleaning algorithm that is applicable to Event-Related-Potentials. Clinical Neurophysiology.

New cleaning technique:

Additionally, we have recently published a pre-print providing a method to target wICA cleaning to specific artifact periods and frequencies. Details about this new cleaning technique can be found in the following pre-print, which should be cited if the targeted wICA method is used:

Bailey N.W., Hill A.T., Godfrey K., Perera M.P.N., Rogasch N.C., Fitzgibbon B.M., & Fitzgerald P.B. (2024). EEG is better when cleaning effectively targets artifacts. BioRxiv. https://doi.org/10.1101/2024.06.06.597688

RELAX 2.0.0 also makes available MWF cleaning with the ability to set sparse delay embeddings in the MWF cleaning approach, which our pre-print suggests enables better cleaning performance than just using consecutive samples as the delay embeddings.

Instructions can be found in the Wiki (the fifth button from the left in the toolbar at the top of the webpage).

Full Changelog: RELAX-v1.1.5...RELAX-v2.0.0

RELAX-v1.1.5

RELAX 1.1.5

Was the version before RELAX 2.0.0.

Accidentally deleted the release notes when trying to release RELAX 2.0.0!

Have provided the 1.1.5 version here just in case.

RELAX-v1.1.4

RELAX
The Reduction of Electroencephalographic Artifacts (RELAX) is an open source extension for EEGLAB that provides a fully automated method to clean EEG data.

Downloading RELAX:
To download and install RELAX, click on the source code in the "Assets" section below, and unzip into your EEGLAB plugins folder.

Further information:
Further information can be found in the publication manuscripts, which must be cited when RELAX is used:

Bailey, N. W., Biabani, M., Hill, A. T., Miljevic, A., Rogasch, N. C., McQueen, B., ... & Fitzgerald, P. B. (2023). Introducing RELAX: An automated pre-processing pipeline for cleaning EEG data-Part 1: Algorithm and application to oscillations. Clinical Neurophysiology.

Bailey, N. W., Hill, A. T., Biabani, M., Murphy, O. W., Rogasch, N. C., McQueen, B., ... & Fitzgerald, P. B. (2023). RELAX part 2: A fully automated EEG data cleaning algorithm that is applicable to Event-Related-Potentials. Clinical Neurophysiology.

Additional details can also be found in the supplementary materials, the PDFs of which are in this release.

Instructions can be found in the Wiki (the fourth button from the left in the toolbar at the top of the webpage), which is currently under development.

v1.1.4

Added a line to ensure the PREP folder path is maintained in MATLAB's path list (the most recent EEGLAB update caused an issue with this for some reason). Added the option to downsample data after filtering but prior to cleaning if users require data to have a lower sample rate (this can accelerate cleaning). Fixed a minor error the blink amplitude cleaning outcome metric if the sample rate was not 1000Hz.

v1.1.3

Fixed a few minor bugs that caused errors when processing atypical data (eg. data without blinks when blinks were expected). Added options to increase compatibility with more varied data (eg. data that contained high power alpha in frontal electrodes, which made relative amplitude threshold based blink detection difficult). Added options to the beta version to make possible a wider range of user preferences (eg. using picard as the ICA algorithm, interpolating rejected electrodes into the cleaned data before saving).

v1.1.2

Fixed a bug that occurred when the number of bad electrodes recommended for deletion exceeded the user set threshold. Added a warning to check files where the number of electrodes that were recommended for deletion exceeded the user set threshold.

v1.1.1

Fixed an error in the specification of triggers to levels for a single factor regression baseline correction in the epoching wrapper, so that the regression baseline correction method should be functional for any user set trigger.

Altered the labelling of the extended infomax ICA option in the GUI so it should be more clear to the user what this option reflects.

v1.1.0

Introduced new options in a beta version, which have not been formally tested but may improve performance:

Provided the option to leave low pass filtering until after the MWF cleaning, which significantly alleviates the risk of rank deficiencies in the MWF cleaning, allowing for much longer MWF delay periods (we've tested up to 30), providing theoretically better cleaning performance.

Provided the option to use EEGLAB's filter rather than just Butterworth filtering (previously this was not available as low pass filtering with EEGLAB's filter led to almost constant rank deficiencies in MWF cleaning).

Provided the option to use Zapline Plus to clean line noise (instead of just Butterworth notch filtering). Note that this is probably not appropriate for data that has had an online notch filter applied, and the authors of Zapline Plus do not recommend it's use for data sampled at higher than 250Hz.

RELAX-v1.1.3

RELAX

The Reduction of Electroencephalographic Artifacts (RELAX) is an open source extension for EEGLAB that provides a fully automated method to clean EEG data.

Downloading RELAX:
To download and install RELAX, click on the source code in the "Assets" section below, and unzip into your EEGLAB plugins folder.

Further information:
Further information can be found in the publication manuscripts, which must be cited when RELAX is used:

Bailey, N. W., Biabani, M., Hill, A. T., Miljevic, A., Rogasch, N. C., McQueen, B., ... & Fitzgerald, P. B. (2023). Introducing RELAX: An automated pre-processing pipeline for cleaning EEG data-Part 1: Algorithm and application to oscillations. Clinical Neurophysiology.

Bailey, N. W., Hill, A. T., Biabani, M., Murphy, O. W., Rogasch, N. C., McQueen, B., ... & Fitzgerald, P. B. (2023). RELAX part 2: A fully automated EEG data cleaning algorithm that is applicable to Event-Related-Potentials. Clinical Neurophysiology.

Additional details can also be found in the supplementary materials, the PDFs of which are in this release.

Instructions can be found in the Wiki (the fourth button from the left in the toolbar at the top of the webpage), which is currently under development.

v1.1.3

Fixed a few minor bugs that caused errors when processing atypical data (eg. data without blinks when blinks were expected). Added options to increase compatibility with more varied data (eg. data that contained high power alpha in frontal electrodes, which made relative amplitude threshold based blink detection difficult). Added options to the beta version to make possible a wider range of user preferences (eg. using picard as the ICA algorithm, interpolating rejected electrodes into the cleaned data before saving).

v1.1.2

Fixed a bug that occurred when the number of bad electrodes recommended for deletion exceeded the user set threshold. Added a warning to check files where the number of electrodes that were recommended for deletion exceeded the user set threshold.

v1.1.1

Fixed an error in the specification of triggers to levels for a single factor regression baseline correction in the epoching wrapper, so that the regression baseline correction method should be functional for any user set trigger.

Altered the labelling of the extended infomax ICA option in the GUI so it should be more clear to the user what this option reflects.

v1.1.0

Introduced new options in a beta version, which have not been formally tested but may improve performance:

Provided the option to leave low pass filtering until after the MWF cleaning, which significantly alleviates the risk of rank deficiencies in the MWF cleaning, allowing for much longer MWF delay periods (we've tested up to 30), providing theoretically better cleaning performance.

Provided the option to use EEGLAB's filter rather than just Butterworth filtering (previously this was not available as low pass filtering with EEGLAB's filter led to almost constant rank deficiencies in MWF cleaning).

Provided the option to use Zapline Plus to clean line noise (instead of just Butterworth notch filtering). Note that this is probably not appropriate for data that has had an online notch filter applied, and the authors of Zapline Plus do not recommend it's use for data sampled at higher than 250Hz.

v1.1.2

RELAX

The Reduction of Electroencephalographic Artifacts (RELAX) is an open source extension for EEGLAB that provides a fully automated method to clean EEG data.

Downloading RELAX:
To download and install RELAX, click on the source code in the "Assets" section below, and unzip into your EEGLAB plugins folder.

Further information:
Further information can be found in the publication manuscripts, which must be cited when RELAX is used:

Bailey NW, Biabani M, Hill AT, Miljevic A, Rogasch NC, McQueen B, Murphy OW, Fitzgerald PB (2022). Introducing RELAX (the Reduction of Electroencephalographic Artifacts): A fully automated pre-processing pipeline for cleaning EEG data - Part 1: Algorithm and Application to Oscillations. BioRxiv.

Bailey NW, Hill AT, Biabani M, Murphy OW, Rogasch NC, McQueen B, Miljevic A, Fitzgerald PB (2022). Introducing RELAX (the Reduction of Electroencephalographic Artifacts): A fully automated pre-processing pipeline for cleaning EEG data – Part 2: Application to Event-Related Potentials. BioRxiv.

Additional details can also be found in the supplementary materials, the PDFs of which are in this release.

Instructions can be found in the Wiki (the fourth button from the left in the toolbar at the top of the webpage), which is currently under development.

v1.1.2

Fixed a bug that occurred when the number of bad electrodes recommended for deletion exceeded the user set threshold. Added a warning to check files where the number of electrodes that were recommended for deletion exceeded the user set threshold.

v1.1.1

Fixed an error in the specification of triggers to levels for a single factor regression baseline correction in the epoching wrapper, so that the regression baseline correction method should be functional for any user set trigger.

Altered the labelling of the extended infomax ICA option in the GUI so it should be more clear to the user what this option reflects.

v1.1.0

Introduced new options in a beta version, which have not been formally tested but may improve performance:

Provided the option to leave low pass filtering until after the MWF cleaning, which significantly alleviates the risk of rank deficiencies in the MWF cleaning, allowing for much longer MWF delay periods (we've tested up to 30), providing theoretically better cleaning performance.

Provided the option to use EEGLAB's filter rather than just Butterworth filtering (previously this was not available as low pass filtering with EEGLAB's filter led to almost constant rank deficiencies in MWF cleaning).

Provided the option to use Zapline Plus to clean line noise (instead of just Butterworth notch filtering). Note that this is probably not appropriate for data that has had an online notch filter applied, and the authors of Zapline Plus do not recommend it's use for data sampled at higher than 250Hz.

RELAX v 1.1.1

RELAX

The Reduction of Electroencephalographic Artifacts (RELAX) is an open source extension for EEGLAB that provides a fully automated method to clean EEG data.

Downloading RELAX:
To download and install RELAX, click on the source code in the "Assets" section below, and unzip into your EEGLAB plugins folder.

Further information:
Further information can be found in the publication manuscripts, which must be cited when RELAX is used:

Bailey NW, Biabani M, Hill AT, Miljevic A, Rogasch NC, McQueen B, Murphy OW, Fitzgerald PB (2022). Introducing RELAX (the Reduction of Electroencephalographic Artifacts): A fully automated pre-processing pipeline for cleaning EEG data - Part 1: Algorithm and Application to Oscillations. BioRxiv.

Bailey NW, Hill AT, Biabani M, Murphy OW, Rogasch NC, McQueen B, Miljevic A, Fitzgerald PB (2022). Introducing RELAX (the Reduction of Electroencephalographic Artifacts): A fully automated pre-processing pipeline for cleaning EEG data – Part 2: Application to Event-Related Potentials. BioRxiv.

Additional details can also be found in the supplementary materials, the PDFs of which are in this release.

Instructions can be found in the Wiki (the fourth button from the left in the toolbar at the top of the webpage), which is currently under development.

v1.1.1

Fixed an error in the specification of triggers to levels for a single factor regression baseline correction in the epoching wrapper, so that the regression baseline correction method should be functional for any user set trigger.

Altered the labelling of the extended infomax ICA option in the GUI so it should be more clear to the user what this option reflects.

v1.1.0

Introduced new options in a beta version, which have not been formally tested but may improve performance:

Provided the option to leave low pass filtering until after the MWF cleaning, which significantly alleviates the risk of rank deficiencies in the MWF cleaning, allowing for much longer MWF delay periods (we've tested up to 30), providing theoretically better cleaning performance.

Provided the option to use EEGLAB's filter rather than just Butterworth filtering (previously this was not available as low pass filtering with EEGLAB's filter led to almost constant rank deficiencies in MWF cleaning).

Provided the option to use Zapline Plus to clean line noise (instead of just Butterworth notch filtering). Note that this is probably not appropriate for data that has had an online notch filter applied, and the authors of Zapline Plus do not recommend it's use for data sampled at higher than 250Hz.

RELAX v1.1.0

RELAX
The Reduction of Electroencephalographic Artifacts (RELAX) is an open source extension for EEGLAB that provides a fully automated method to clean EEG data.

Downloading RELAX:
To download and install RELAX, click on the source code in the "Assets" section below, and unzip into your EEGLAB plugins folder.

Further information:
Further information can be found in the publication manuscripts, which must be cited when RELAX is used:

Bailey NW, Biabani M, Hill AT, Miljevic A, Rogasch NC, McQueen B, Murphy OW, Fitzgerald PB (2022). Introducing RELAX (the Reduction of Electroencephalographic Artifacts): A fully automated pre-processing pipeline for cleaning EEG data - Part 1: Algorithm and Application to Oscillations. BioRxiv.

Bailey NW, Hill AT, Biabani M, Murphy OW, Rogasch NC, McQueen B, Miljevic A, Fitzgerald PB (2022). Introducing RELAX (the Reduction of Electroencephalographic Artifacts): A fully automated pre-processing pipeline for cleaning EEG data – Part 2: Application to Event-Related Potentials. BioRxiv.

Additional details can also be found in the supplementary materials, the PDFs of which are in this release.

Instructions can be found in the Wiki (the fourth button from the left in the toolbar at the top of the webpage), which is currently under development.

v1.1.0

Introduces new options in a beta version, which have not been formally tested but may improve performance:

1. Provides the option to leave low pass filtering until after the MWF cleaning, which significantly alleviates the risk of rank deficiencies in the MWF cleaning, allowing for much longer MWF delay periods (we've tested up to 30), providing theoretically better cleaning performance.

2. Provides the option to use EEGLAB's filter rather than just Butterworth filtering (previously this was not available as low pass filtering with EEGLAB's filter led to almost constant rank deficiencies in MWF cleaning).

3. Provides the option to use Zapline Plus to clean line noise (instead of just Butterworth notch filtering). Note that this is probably not appropriate for data that has had an online notch filter applied, and the authors of Zapline Plus do not recommend it's use for data sampled at higher than 250Hz.

RELAX v1.0.1

RELAX

The Reduction of Electroencephalographic Artifacts (RELAX) is an open source extension for EEGLAB that provides a fully automated method to clean EEG data.

Downloading RELAX:

To download and install RELAX, click on the source code in the "Assets" section below, and unzip into your EEGLAB plugins folder.

Further information:

Further information can be found in the publication manuscripts, which must be cited when RELAX is used:

Bailey NW, Biabani M, Hill AT, Miljevic A, Rogasch NC, McQueen B, Murphy OW, Fitzgerald PB (2022). Introducing RELAX (the Reduction of Electroencephalographic Artifacts): A fully automated pre-processing pipeline for cleaning EEG data - Part 1: Algorithm and Application to Oscillations. BioRxiv.

Bailey NW, Hill AT, Biabani M, Murphy OW, Rogasch NC, McQueen B, Miljevic A, Fitzgerald PB (2022). Introducing RELAX (the Reduction of Electroencephalographic Artifacts): A fully automated pre-processing pipeline for cleaning EEG data – Part 2: Application to Event-Related Potentials. BioRxiv.

Additional details can also be found in the supplementary materials, the PDFs of which are in this release.

Instructions can be found in the Wiki (the fourth button from the left in the toolbar at the top of the webpage), which is currently under development.