Skip to content

Commit 1669d77

Browse files
committed
fixing typos
1 parent 4f64f5b commit 1669d77

File tree

2 files changed

+27
-27
lines changed

2 files changed

+27
-27
lines changed

Diff for: plugins/SIFT/Chapter-7.-Statistics-in-SIFT.md

+7-7
Original file line numberDiff line numberDiff line change
@@ -43,8 +43,8 @@ suffer from inaccuracies when the number of samples is not very large or
4343
when assumptions are violated. Nonetheless, these tests can provide a
4444
useful way to quickly check for statistical significance, possibly
4545
following up with a more rigorous surrogate statistical test. These
46-
tests are implemented in SIFTs **`stat_analyticStats()`** function. To
47-
our knowledge, SIFT is the only publically available toolbox that
46+
tests are implemented in SIFT's **`stat_analyticStats()`** function. To
47+
our knowledge, SIFT is the only publicly available toolbox that
4848
implements these analytic tests.
4949

5050
## 7.2. Nonparametric surrogate statistics
@@ -60,7 +60,7 @@ corresponding to the expected distribution of the estimator when a
6060
particular null hypothesis has been enforced. Two popular surrogate
6161
methods are **bootstrap resampling and phase
6262
randomization.** These
63-
tests are implemented in SIFTs **`stat_surrogateStats()`** function.
63+
tests are implemented in SIFT's **`stat_surrogateStats()`** function.
6464

6565
### 7.2.1. Bootstrap resampling
6666

@@ -112,7 +112,7 @@ collection of values (for example, obtaining p-values for a complete
112112
time-frequency image), we should expect some number of non-significant
113113
values to exceed the significance threshold. As such, it is important to
114114
correct for multiple comparisons using tests such as False Discovery
115-
Rate (FDR) (Benjamini and Hochberg, 1995) using EEGLABs **`fdr()`** function.
115+
Rate (FDR) (Benjamini and Hochberg, 1995) using EEGLAB's **`fdr()`** function.
116116

117117
## 7.3. Practical statistics in SIFT
118118

@@ -304,8 +304,8 @@ As mentioned above, users need to export connectivity matrices stored in the **E
304304

305305
This approach adopts a 3-stage process:
306306

307-
**1. Identify K ROIs (clusters).** You may use affinity clustering of sources
308-
across subject populations using EEGLABs Measure-Product clustering.
307+
**1. Identify K ROI's (clusters).** You may use affinity clustering of sources
308+
across subject populations using EEGLAB's Measure-Product clustering.
309309

310310
**2. Compute all incoming and outgoing individually statistically
311311
significant connections between each pair of ROIs.** To do so, for each connection between 2 clusters, assess if it is significant across subjects, then create a \[ K X K
@@ -320,7 +320,7 @@ high agreement in terms of source locations (missing variable problem).
320320
A more robust approach (in development with Wes Thompson) uses smoothing splines and Monte-Carlo methods
321321
for joint estimation of posterior probability (with confidence
322322
intervals) of cluster centroid location and between-cluster
323-
connectivity. This method takes into account the missing variable
323+
connectivity. This method takes into account the "missing variable"
324324
problem inherent to the disjoint clustering approach and provides robust
325325
group connectivity statistics. A poster was [published](https://sccn.ucsd.edu/~scott/pdf/Thompson_and_Mullen_Poster_ICONXI.pdf) on this topic, but the code is not yet available.
326326

Diff for: plugins/imat/index.md

+20-20
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ To view the plugin source code, please visit the plugin's [GitHub repository](ht
1111
# IMAT - Independent Modulator Analysis Toolbox
1212

1313
## What is IMA?
14-
Independent Modulator Analysis (IMA) is a method for decomposing spectral fluctuations of temporally independent EEG sources into ‘spatio-spectrally’ distinct spectral modulator processes. Such processes might might derive from and isolate coordinated multiplicative scaling effects of functionally near-independent modulatory factors, for example the effects of modulations roduced in cortico-subcortical or sensory-cortical loops, or by signalling from brainstem-centered import recognition systems using dopamine, serotonin, noradrenaline, etc. (see schematic figure below from [Onton & Makeig, 2009](https://www.frontiersin.org/articles/10.3389/neuro.09.061.2009/full)). Rather than attempting to decompose the mean power spectrum for a component process to identify narrow-band processes superimposed on a 1/f baseline spectum, IMAT identifies characteristic frequency bands in which spectral power *varies* across time. This allows IMA to find *both* narrow and wide band modes. Also, the identified modes need not be singular. For example, IMA will separate the joint activity of an alpha or mu rhythm and its harmonics from endogenous beta band fluctuations occupying overlapping frequency ranges. IMA is applied to independent component (IC) source processes in the data which can be localized in the brain or to a specific scalp muscle, etc. IMA thereby identifies IC subsets that are co-modulated in a specified IM frequency band; these might be thought of as co-modulation networks with a common influence and susceptibility.
14+
Independent Modulator Analysis (IMA) is a method for decomposing spectral fluctuations of temporally independent EEG sources into 'spatio-spectrally' distinct spectral modulator processes. Such processes might might derive from and isolate coordinated multiplicative scaling effects of functionally near-independent modulatory factors, for example the effects of modulations roduced in cortico-subcortical or sensory-cortical loops, or by signalling from brainstem-centered import recognition systems using dopamine, serotonin, noradrenaline, etc. (see schematic figure below from [Onton & Makeig, 2009](https://www.frontiersin.org/articles/10.3389/neuro.09.061.2009/full)). Rather than attempting to decompose the mean power spectrum for a component process to identify narrow-band processes superimposed on a 1/f baseline spectum, IMAT identifies characteristic frequency bands in which spectral power *varies* across time. This allows IMA to find *both* narrow and wide band modes. Also, the identified modes need not be singular. For example, IMA will separate the joint activity of an alpha or mu rhythm and its harmonics from endogenous beta band fluctuations occupying overlapping frequency ranges. IMA is applied to independent component (IC) source processes in the data which can be localized in the brain or to a specific scalp muscle, etc. IMA thereby identifies IC subsets that are co-modulated in a specified IM frequency band; these might be thought of as co-modulation networks with a common influence and susceptibility.
1515

1616
<img src="./Docs/figs/IndependentModulators.png" width="400">
1717

@@ -30,7 +30,7 @@ All plug-ins in EEGLAB, including IMAT, can be installed in two ways. To install
3030

3131
1. **From the EEGLAB Plug-in Manager:** Launch EEGLAB and select menu item **File > Manage EEGLAB Extensions** in the main EEGLAB window. A plug-in manager window will pop up. Look for and select the IMAT plug-in, then press **Install/Update**.
3232

33-
2. **From the web:** Download the IMAT plug-in zip file either from [this](https://github.com/sccn/imat) GitHub page (select Download Zip) or from [this EEGLAB wiki plug-ins page](https://sccn.ucsd.edu/wiki/Plugin_list_all) (select **IMAT**). Decompress the zip file in the plug-ins folder in the main EEGLAB folder (*../eeglab/plugins/*).
33+
2. **From the web:** Download the IMAT plug-in zip file either from [this](https://github.com/sccn/imat) GitHub page (select 'Download Zip') or from [this EEGLAB wiki plug-ins page](https://sccn.ucsd.edu/wiki/Plugin_list_all) (select **IMAT**). Decompress the zip file in the plug-ins folder in the main EEGLAB folder (*../eeglab/plugins/*).
3434

3535
Restart EEGLAB. If the installation is successful, a menu item to call IMAT, **Tools > Decompose IC spectograms by IMAT**, will appear in the EEGLAB menu.
3636

@@ -40,7 +40,7 @@ Restart EEGLAB. If the installation is successful, a menu item to call IMAT, **T
4040
2. For component selection and clustering it is of advantage to also estimate equivalent current dipole models for the brain-based ICs.
4141
3. For automatic selection of components you need to install the EEGLAB plug-in [IC Label](https://sccn.ucsd.edu/wiki/ICLabel)
4242
4. For plotting dipole density of clusters you need to install the EEGLAB plug-in Fieldtrip lite.
43-
5. IMAT can handle either epoched or continuous data. Be aware that for epoched data, the epochs should have length to accomodate at least 3 cycles of the lowest frequency at which IMA is to be computed.
43+
5. IMAT can handle either epoched or continuous data. Be aware that for epoched data, the epochs should have length to accommodate at least 3 cycles of the lowest frequency at which IMA is to be computed.
4444

4545
Please refer to the section above on how to install EEGLAB plug-ins.
4646

@@ -50,7 +50,7 @@ Please refer to the section above on how to install EEGLAB plug-ins.
5050
## Running IMAT
5151
Before running IMAT, start EEGLAB and load an EEG dataset.
5252

53-
To run IMAT on the loaded dataset, launch the Run IMA (*pop\_runIMA*) window, either by typing *pop\_runIMA* on the MATLAB command line or by calling it from the EEGLAB menu by selecting **Tools > Decompose spectograms by IMA > Run IMA**, as highlighted in the figure below.
53+
To run IMAT on the loaded dataset, launch the Run IMA (*pop_runIMA*) window, either by typing *pop_runIMA* on the MATLAB command line or by calling it from the EEGLAB menu by selecting **Tools > Decompose spectograms by IMA > Run IMA**, as highlighted in the figure below.
5454

5555
<img src="./Docs/figs/RunIMA.png" width="1000">
5656
In the resulting window (above right) we can specify:
@@ -59,20 +59,20 @@ In the resulting window (above right) we can specify:
5959
2. Which frequency range in which to compute IMA (**Freq. limits (Hz)**)
6060
3. The frequency scale (**Freq scale**) linear of log scale
6161
4. A factor to regulate dimensionality reduction in the time windows of the spectral data using PCA dimension reduction before ICA decomposition (**pcfac**) - the smaller the *pcfac*, the more dimensions will be retained *ndims = (freqsxICs)/pcfac* where *freqs* is the number of estimated frequencies and *ICs* is the number of ICs (default is 7)
62-
5. Other IMA options (**pop\_runima options**) – e.g., which ICA algorithm to use (see *pop_runima* help for more details)
62+
5. Other IMA options (**pop_runima options**) – e.g., which ICA algorithm to use (see *pop_runima* help for more details)
6363

6464

6565
**Running IMA from the command line**
6666

67-
*[EEG, IMA] = pop\_runIMA(EEG, 'freqscale', 'log', 'frqlim', [6 120], 'pcfac', 7, 'cycles', [6 0.5], 'selectICs', {'brain'}, 'icatype', 'amica');*
67+
*[EEG, IMA] = pop_runIMA(EEG, 'freqscale', 'log', 'frqlim', [6 120], 'pcfac', 7, 'cycles', [6 0.5], 'selectICs', {'brain'}, 'icatype', 'amica');*
6868

6969
Here we are computing IMA on a single subject's data, selecting ''Brain ICs'' using ICLabel, with parameters for time-frequency decomposition: log frequency scaling, frequency limits: 6 to 120 Hz, wavelet cycles [6 0.5], reducing the dimensions of timewindows
7070
of the time/frequency decomposition using pfac 7, and using AMICA for ICA decomposition.
7171

7272

7373
## The IMA structure
7474

75-
*pop\_runIMA* saves the IMA results in an IMA structure, in the same folder as the EEG file it is run on.
75+
*pop_runIMA* saves the IMA results in an IMA structure, in the same folder as the EEG file it is run on.
7676

7777
After running IMA (either from the gui or from the command line) type *IMA* in the Matlab command line to display the IMA structure.
7878

@@ -177,7 +177,7 @@ On the command line enter: *pop_plotspecdecomp(EEG, 'plottype', 'ims', 'comps',
177177
<img src="./Docs/figs/SuperimposedIMmodes.png" width="1000">
178178

179179

180-
**2. Spectral envelope** (*pop\_plotspecenv*)
180+
**2. Spectral envelope** (*pop_plotspecenv*)
181181

182182
To visualize the contributions of IMs to the mean log spectrum of an IC, launch **Tools > Decompose spectograms by IMA > Plot IMA results > Spectral envelope**
183183

@@ -192,7 +192,7 @@ In the resulting window (above right) we can specify:
192192
3. Indices of the ICs and IMs to plot
193193

194194
On the command line enter:
195-
*pop\_plotspecenv(EEG,'comps', [1 2 5], 'factors', [1 2 3 6], 'frqlim', [6 120], 'plotenv', 'full');*
195+
*pop_plotspecenv(EEG,'comps', [1 2 5], 'factors', [1 2 3 6], 'frqlim', [6 120], 'plotenv', 'full');*
196196

197197
Here is an example of plotting IMs **Full envelope** of inflence on the IC power spectra. The IC mean log power spectrum is shown as a black trace. Outer light grey limits represent the 1st and 99th percentiles of IC spectral variation associated with the IM. Dark grey areas represent the 1st and 99th percentiles of the PCA-reduced spectral data used in the IMA analysis.
198198

@@ -250,7 +250,7 @@ Before running IMAT on multiple conditions or for group analysis, you need to bu
250250

251251
Before running IMAT, start EEGLAB and load the STUDY set.
252252

253-
To run IMAT on the loaded STUDY, launch the Run IMA (*pop\_runIMA_study*) window, either by typing *pop\_runIMA_study* on the MATLAB command line or by calling it from the EEGLAB menu by selecting **STUDY > STUDY IMA > Run STUDY IMA** as highlighted in the figure below. This will run a separate IMA decomposition for each subject in the study. That is, a joint IMA is computed over all the conditions for each single subject in the STUDY.
253+
To run IMAT on the loaded STUDY, launch the Run IMA (*pop_runIMA_study*) window, either by typing *pop_runIMA_study* on the MATLAB command line or by calling it from the EEGLAB menu by selecting **STUDY > STUDY IMA > Run STUDY IMA** as highlighted in the figure below. This will run a separate IMA decomposition for each subject in the study. That is, a joint IMA is computed over all the conditions for each single subject in the STUDY.
254254

255255
<img src="./Docs/figs/runSTUDYIMA.png" width="1000">
256256
In the resulting window (above right) we can specify:
@@ -259,12 +259,12 @@ In the resulting window (above right) we can specify:
259259
2. Which frequency range to compute IMA on (**Freq. limits (Hz)**).
260260
3. The frequency scaling (**Freq scale**), linear or log.
261261
4. A factor to regulate dimensionality reduction on the time windows of the spectral data using PCA before spectrogram ICA decomposition (**pcfac**) - the smaller the pcfac, the more dimensions will be retained *ndims = (freqsxICs)/pcfac* where *freqs* is the number of frequencies estimated and *ICs* is the number of ICs (default is 7)
262-
5. Other IMA options (**pop\_runima_study options**) – e.g., which ICA algorithm to use (see *pop_runima_study* help for more details)
262+
5. Other IMA options (**pop_runima_study options**) – e.g., which ICA algorithm to use (see *pop_runima_study* help for more details)
263263

264264

265265
**Running IMA from the command line**
266266

267-
*[STUDY] = pop\_runIMA_study(STUDY, ALLEEG, 'freqscale', 'log','frqlim', [6 120],
267+
*[STUDY] = pop_runIMA_study(STUDY, ALLEEG, 'freqscale', 'log','frqlim', [6 120],
268268
'pcfac', 7,
269269
'cycles', [6 0.5],
270270
'selectICs', {'brain'},
@@ -275,7 +275,7 @@ Here we are computing IMA on the subject data contained in the STUDY set; a sepa
275275

276276
## The IMA structure in the STUDY environment
277277

278-
*pop\_runIMA_study* saves the IMA results in the IMA structure which is associated with the subject-specific EEG files and saved in the same folder as the EEG files it is run on.
278+
*pop_runIMA_study* saves the IMA results in the IMA structure which is associated with the subject-specific EEG files and saved in the same folder as the EEG files it is run on.
279279

280280
The filenames of the subject-specific IMA files are saved in:
281281
{% raw %}
@@ -372,7 +372,7 @@ There are three main plotting functions for visualizing IMAT results for single
372372
2. Spectral envelope
373373
3. Time courses
374374

375-
**1. Superimposed Components** (*pop\_plotspecdecomp_study*)
375+
**1. Superimposed Components** (*pop_plotspecdecomp_study*)
376376

377377
To visualize the IM decomposition for single subjects in the study, launch **STUDY > STUDY IMA > Plot IMA results > Superimposed Components**
378378

@@ -388,13 +388,13 @@ In the resulting window (above right) we can specify:
388388
4. Indices of the ICs and IMs to plot
389389

390390
On the command line enter:
391-
*pop\_plotspecdecomp_study(STUDY, 'plottype', 'comb', 'subject', '3')*
392-
*pop\_plotspecdecomp_study(STUDY, 'plottype', 'ics', 'subject', '3')*
393-
*pop\_plotspecdecomp_study(STUDY, 'plottype', 'ims', 'subject', '3')*
391+
*pop_plotspecdecomp_study(STUDY, 'plottype', 'comb', 'subject', '3')*
392+
*pop_plotspecdecomp_study(STUDY, 'plottype', 'ics', 'subject', '3')*
393+
*pop_plotspecdecomp_study(STUDY, 'plottype', 'ims', 'subject', '3')*
394394

395395
The type of plots are the same as for single subjects visualizations, please refer to the section above for more information.
396396

397-
**2. Spectral envelope** (*pop\_plotspecenv_study*)
397+
**2. Spectral envelope** (*pop_plotspecenv_study*)
398398

399399
To visualize the contribution of IMs added to the mean log spectrum of an IC for a single subject launch **STUDY > STUDY IMA > Plot IMA results > Spectral envelope**
400400

@@ -412,7 +412,7 @@ In the resulting window (above right) we can specify:
412412
The function plots separate spectral loadings for each condition. Here is an example plotting the **Full envelope** of IMs for two *Eyes_open* and *Eyes_closed* conditions separately. The IC mean log power spectrum is shown as a black trace. The outer light grey limits represent the 1st and 99th percentiles of variation in the IC log spectrum across time. Dark grey areas represent the 1st and 99th percentiles for the PCA-reduced IC spectral data that has been used in the IMA analysis.
413413

414414
On the command line enter:
415-
*pop\_plotspecenv_study(STUDY,'comps', [1 2 5], 'factors', [1 2 3 6], 'frqlim', [6 120],'plotcond', 'on', 'subject', '3');*
415+
*pop_plotspecenv_study(STUDY,'comps', [1 2 5], 'factors', [1 2 3 6], 'frqlim', [6 120],'plotcond', 'on', 'subject', '3');*
416416

417417
<img src="./Docs/figs/envECSTUDY.png" width="500">
418418

@@ -487,7 +487,7 @@ In the resulting window (above right) we can specify:
487487
3. **Target peak freq** The target peak frequency specifies the target frequency to stretch spectra to when the 'stretch_spectra' flag is 'on', if 'Target peak freq' is empty, uses the center frequency of the 'Freq. range'
488488

489489
On the command line enter:
490-
*pop\_collecttemplates(STUDY, 'peakrange', [8 12],
490+
*pop_collecttemplates(STUDY, 'peakrange', [8 12],
491491
'stretch_spectra', 'on',
492492
'targetpeakfreq', 10,
493493
'plot_templ', 'on');*

0 commit comments

Comments
 (0)