You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: plugins/PACTools/index.md
+10-23
Original file line number
Diff line number
Diff line change
@@ -77,20 +77,16 @@ The function pop_pac.m provides the front-end interface for the toolbox it also
77
77
### Plug-in setup
78
78
PACTools is a plugin to EEGLAB. Thus, its installation can be done directly from the EEGLAB plug-in manager (In the EEGLAB GUI see: File -> Manage EEGLAB extensions).
79
79
An alternative way is by downloading PACTools files to the user's local computer. Then, copying the folder with all the files to the EEGLAB folder located in *../eeglab/plugins/* and then restart EEGLAB. The toolbox can be located under the menu *Tools* in EEGLAB (see figure below).
In its current version, the toolbox provide basic function to compute and visualize PAC that can be executed either from command line calls or from graphical user interfaces (GUI) created for these ends. Acces to GUI can be done from the EEGLAB GUI through *Tools > PAC Tools*. Here we will be given the option to *Estimate PAC* or *Visualize PAC*.
86
85
87
86
#### Computing PAC with pop_pac
88
87
To invoke the GUI to compute PAC from the EEGLAB GUI, click the menu *Tools > PAC Tools > Estimate PAC*, otherwise, you can launch the GUI from the MATLAB command windows by typing `EEG = pop_pac(EEG)` (see figure below). Here we assume that the user has already loaded the EEG set where the PAC wants to be computed on.
The GUI is divided into five parts designated by the labels: **Data type**, **PAC Method**, **Optional inputs**, **Significance testing** and **Compute on NSG** .
96
92
In the first section (**Data type**), the type of data used for PAC computation can be chosen between channel data (*Channels*) or ICA decomposed data (*Components*).
@@ -108,10 +104,9 @@ Finally, three buttons lay at the bottom of the GUI designated to launch the hel
108
104
109
105
#### Visualizing PAC with pop_plotpac
110
106
Once PAC is computed using *pop_pac.m*, the results are stored in the EEG structure (see details in the next section). Visualization of the results can be done by invoking the function *pop_plotpac* from the command line (`pop_plotpac(EEG)`)or from the EEGLAB menu as *Tools > PAC Tools > Visualize PAC* (see figure below).
The GUI of poc_pacplot comprises four major sections(depicted in the figure above).
116
111
Section A : In this section the user can get a quick glimpse of the parameters used for the computation of PAC stored in the current EEG set.
117
112
Section B: Display all the channel/components pairs for which PAC has been computed. The first element of the pair corresponds to the stream used to compute the instantaneous Phase, while the second element corresponds to the one used for the instantaneous Amplitude.
@@ -197,16 +192,11 @@ Note: In this sample code, we assume the current directory to be the folder cont
197
192
198
193
This dataset contains a simulated PAC signal where the instantaneous phase at 8Hz and the instantaneous amplitude at 60Hz are coupled during two segments of the signal (see figure below).
After loading the dataset, we proceed to compute PAC with PACTools by using *pop_pac* GUI. To launch the GUI, select *Tools > PAC Tools > Estimate PAC* in the main EEGLAB GUI. Alternatively, you can use `EEG = pop_pac(EEG)` from the MATLAB command windows. Here we compute PAC using the Mean Vector Length Modulation Index method (*mvlmi*) between 10 phase frequencies in the range [4 15]Hz and 20 amplitude frequencies in the range [30 100]Hz. To perform this computation, set *pop_pac* GUI as shown in the figure below, and click **Ok**.
The equivalent command line call to perform this computation can be retreived with the command `eegh`. In this case will return in it last entry:
212
202
@@ -251,10 +241,7 @@ and
251
241
#### Visualization
252
242
To visualize the PAC values computed previously we use the *pop_plotpac* GUI (click *Tools > PAC Tools > Visualize PAC*). From the *pop_plotpac* GUI we select the channel pair and the measure to visualize, then proceed to plot PAC results using the enabled plots in section D of the GUI. The figure below shows the plots generated for the Instantaneous MIPAC (*instmipac*) from each of the plotting options available for this measure: *Comodulogram*, *Temporal comodulogram* and *Freq.-time PAC*. We used default plotting options here, but users are encouraged to explore how the different plotting parameter options modify the visualization.
This is an open-source project on constant development. Please, contact the authors at [email protected] for contributions. The use of the issue tracker is encouraged.
0 commit comments