EPAC
extended Phase-Amplitude Coupling EEGLAB toolbox with additional automatic assessment of coupling origins as Reliable/Ambiguous
Install / Use
/learn @GabrielaJurkiewicz/EPACREADME
% extended Phase-amplitude coupling EEGLAB toolbox % % Copyright (C) 2019 Gabriela Jurkiewicz % % This program is free software: you can redistribute it and/or modify % it under the terms of the GNU General Public License as published by % the Free Software Foundation, either version 3 of the License, or % (at your option) any later version. % % This program is distributed in the hope that it will be useful, % but WITHOUT ANY WARRANTY; without even the implied warranty of % MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the % GNU General Public License for more details. % % You should have received a copy of the GNU General Public License % along with this program. If not, see http://www.gnu.org/licenses/. % % Gabriela Jurkiewicz gabriela.j.jurkiewicz@gmail.com
- Authors and copyrights
This EEGLAB plugin was written by Gabriela Jurkiewicz and published under the terms of the GNU General Public License 3. It includes files with different authorship stated in the headlines:
- pinknoise.m
- DataHash.m
- tf_cwt.m
- tf_morlet.m
- Appliance
This software implements algorithm for detection of phase-amplitude cross-frequency coupling to be used in data analysis under EEGLAB toolbox. Program allows a user to perform calculations and indicate the path where the results will be saved.
- Usage
To use this software you need:
- Matlab, version 2011a or newer
- Eeglab, version 11_0_4_3b or newer
To install this plugin you need to place its entire directory inside the eeglab-directory/plugins/, where eeglab-directory is a directory in which your eeglab is located.
- Functionalities
After installation you should be able to locate this plugin in the eeglab main menu under Tools > extended Phase-Amplitude Coupling. This software for now consists of three functionalities:
-
extended Modulation Index - performs the extended Modulation Index analysis for a given data and saves the results in the localization indicated by the user. The results consists of images summarizing the analysis, MAT structure containing the results and MAT structure containing the configuration parameters. It requires several parameters as an input - check documentation for details (pop_eMI_calc.m).
-
Modulation Index - calculates the Modulation Index (Tort et al. 2010) for a given data and saves the results in the localization indicated by the user. The results consists of images summarizing the analysis, MAT structure containing the results and MAT structure containing the configuration parameters. It requires several parameters as an input - check documentation for details (pop_MI_calc.m).
-
direct PAC estimate - calculates the direct PAC estimate (Ozkurt and Schnitzler 2011) for a given data and saves the results in the localization indicated by the user. The results consists of images summarizing the analysis, MAT structure containing the results and MAT structure containing the configuration parameters. It requires several parameters as an input - check documentation for details (pop_dPAC_calc.m).
There are exemplary programs (Test_properPAC.m, Test_epiphenomenalPAC.m, Test_properPAC_inVivo.m) and datasets (Test_properPAC_1.set, Test_properPAC_2.set, Test_properPAC_inVivo.set, Test_epiphenomenalPAC_1a.set, Test_epiphenomenalPAC_1b.set, Test_epiphenomenalPAC_2a.set, Test_epiphenomenalPAC_2b.set) that show the results for artificial and in vivo data. More information on those examples inside exemplary scripts.
More information about methods included in toolbox could be find in article: Jurkiewicz G. J., Hunt M. J., Zygierewicz J., "Addressing pitfalls in phase-amplitude coupling analysis with an extended Modulation Index toolbox", Neuroinformatics, 2020, doi:10.1007/s12021-020-09487-3
