10127
Comment:

11061

Deletions are marked like this.  Additions are marked like this. 
Line 73:  Line 73: 
* '''PLS : Contrast: '''You can first look at the contrast between two conditions: Doubleclick on the contrast file. The contrast is shown in the form of time series; however, the xaxis is not actual time. In fact, the integer numbers show the number of conditions (e.g. 1 for condition 1 or “Faces” and 2 for Condition 2 or “Scrambled Faces”) and the noninteger ones should be ignored.<<BR>><<BR>> {{attachment:contrast.gif}} 
* '''PLS : Contrast: '''You can first look at the contrast between two conditions: Doubleclick on the contrast file. The contrast is shown in the form of time series; however, the xaxis is not actual time. In fact, the integer numbers show the number of conditions (e.g. 1 for condition 1 or “Faces” and 2 for Condition 2 or “Scrambled Faces”) and the noninteger ones should be ignored.<<BR>><<BR>> {{attachment:contrast.gif}} 
Line 79:  Line 78: 
* Note: You will see two numbers in the table for pvalue of the latent variable when you run PLS for two conditions. Ignore the second one.<<BR>><<BR>> {{attachment:p_value.gif}} <<BR>> * '''PLS: Bootstrap ratio: '''This file is saved in the format of source maps. Doubleclick on open the file. The color map shows bootstrap ratios for each source at each time point. There are some important points you should keep in mind when working with bootstrap ratios: * Bootstrap ratios show how reliably each source is contributing to the observed contrast and latent variable at each time point. A bootstrap ratio larger than 2.58 is considered reliable. Therefore, adjust the amplitude of bootstrap ratios to 25%26% to be able to see the reliable signals. For this, choose “Surface” tab from Brainstorm window and adjust the “Amplitude”.<<BR>><<BR>> {{attachment:bootstrap_ratio.gif}} <<BR>> * ghf * * 
Partial Least Squares (PLS)
Authors: Golia Shafiei
This tutorial explains the concept of Partial Least Squares (PLS) analysis in general, which was first introduced to the neuroimaging community in 1996 (McIntosh et al., 1996). In addition, we illustrate how to use PLS process on a sample data in Brainstorm.
Contents
License
PLS is a free toolbox that is available at Baycrest (https://www.rotmanbaycrest.on.ca/index.php?section=84). The PLS code is written entirely in MATLAB (Mathworks Inc) and can be downloaded from https://www.rotmanbaycrest.on.ca/index.php?section=345. To cite PLS Toolbox, please see the “References” section of this tutorial.
Introduction
Partial Least Squares (PLS) analysis is a multivariate statistical technique that is used to find the relationship between two blocks of variables. PLS that has various applications and types (Krishnan et al., 2011); however, the focus of this tutorial is on MeanCentered PLS analysis, which is a common type of PLS while working with neuroimaging data. In this type of PLS analysis, one data block is neural activity (e.g. MEG measurements/source data here) while the other one is the experiment design (e.g. different groups/conditions).
PLS analysis is based on extracting the common information between the two data blocks by finding a correlation matrix and linear combinations of variables in both data blocks that have maximum covariance with one another. In the example provided here, we find a contrast between different conditions as well as patterns of brain activity that maximally covary with that specific contrast.
For this purpose, we take the neural activity as one data block, matrix X, where the rows of matrix X are observations (participants/trials) nested in conditions or groups, and the columns of X are variables that are arranged in a way that time scales are nested within sources. The other data block, matrix Y, is a matrix of dummy coding that is related to experimental design (different groups or conditions) (Krishnan et al., 2011).
PLS analysis first calculates a meancentered matrix using matrices X and Y. Then, singular value decomposition (SVD) is applied on the meancentered matrix. The outcome of PLS analysis is a set of latent variables that are in fact linear combinations of initial variables of the two data blocks that maximally covary with the resulting contrasts (Krishnan et al., 2011, Misic et al., 2016).
Finally, the statistical significance of a latent variable is defined by a pvalue calculated from permutation test. In addition, bootstrapping is used to assess the reliability of each original variable (e.g. a source at a time point) that contributes to the latent variable. Bootstrap ratios are calculated for each original variable for this purpose. More specifically, each latent variable consists of a set of singular values that describe the effect size, as well as a set of singular vectors, or weights, that define the contribution of each initial variable to the latent variables. The ratio of these weights to the standard errors estimated from bootstrapping is called bootstrap ratio. Therefore, the larger the magnitude of a bootstrap ratio, the larger the weight (i.e. contribution to the latent variable) and the smaller the standard error (i.e. higher stability) (McIntosh and Lobaugh, 2004, Misic et al., 2016). Bootstrap ratio can be equivalent to a zscore if we have an approximately normal bootstrap distribution (Efron and Tibshirani, 1986).
PLS analysis was explained in general in this section. However, this tutorial assumes that the users are already familiar with basics of PLS analysis. If PLS is new to you or if you want to read more about PLS and its applications in details, please refer to the articles introduced in “References” section.
Download and installation
In order to run PLS process in Brainstorm, the PLS Toolbox must be downloaded from here and added to MATLAB pathway.
Data, PreProcessing and Source Analysis
The data processed here is the same dataset that is used in MEG visual tutorial: Single subject and MEG visual tutorial: Group analysis. This dataset consists in simultaneous MEG/EEG recordings of 19 subjects performing a simple visual task on a large number of famous, unfamiliar and scrambled faces. The detailed presentation of experiment is available in the MEG visual tutorial: Single Subject.
You can follow this tutorial after processing the data as illustrated in MEG visual tutorial: Single Subject. Then:
Find the subject averages as it is explained in MEG visual tutorial: Group analysis by following the steps in the visual group analysis up to Section 7: Subject averages: Filter and normalize.
After you found all the averages across subjects, continue with Section 7 and filter the signals below 32Hz and extract time as it is explained. However, when filtering the sources, do not normalize the source values with respect to baseline (i.e. do not find zscore).
At this point, continue with the rest of the group analysis tutorial: Project sources on template and apply spatial smoothing on the source maps.
 Data is now ready for PLS analysis.
Running PLS
There are two PLS processes available in Brainstorm: * You can run PLS analysis for only two conditions through the Process2 tab at the bottom of the Brainstorm window.
You can also run PLS analysis for more than two conditions through the Process1 tab at the bottom of the Brainstorm window. This option is explained in the “Advanced” section of this tutorial.
Both of these two processes work in a similar way:
Input: the input files are the source data from different conditions. Number of samples per condition must be the same for all conditions. In order to find meaningful results from PLS statistical analysis, each of the conditions should at least contain 5 observations/trials.
Note: You can also run PLS analysis on sensor level data (channel data). However, the results will not be as meaningful and useful as the ones from source level data.
Output: the output files include bootstrap ratios and pvalues for all latent variables. In addition, you can look at the contrast between conditions (groups and/or experimental tasks) for each latent variable. The output files are explained in details in the following sections.
We will continue with explaining the PLS process for only two conditions from now and we will leave PLS process for more conditions for the Advanced section of this tutorial.
Select files
 Select the process2 tab at the bottom of Brainstorm window.
Drag and drop 16 source files from Group_analysis/FacesMEG to the left (Files A).
Drag and drop 16 source files from Group_analysis/ScrambledMEG to the right (Files B).
Note that the number of files in each window (“A” and “B”) must be the same.
Run PLS
 In Process2, click on [Run].
Select process Test > Partial Lest Squares (PLS). This opens the Pipeline editor window with the PLS process for two conditions.
“Condition 1” and “Condition 2”: Name of the two input conditions: “Condition 1” and “Condition 2” are related to files in windows “A” and “B” of “Process2” tab, respectively. We can use “Faces” and “Scrambled Faces” as the condition names here.
Number of Permutations: Indicates the number of permutations you want to run in PLS.
Number of Bootstraps: Indicates the number of bootstraps you want to run in PLS.
Sensor types or name: Indicates the type of sensors that has been used for source localization (e.g. MEG or EEG). This will occur in the result file name as well.
Run the process when the options are set. The process will take some time depending on the number of files, number of permutations and bootstraps. The results are then saved in Group Analysis > IntraSubject folder.
PLS Results
Output files include contrast between conditions, pvalue of the latent variable and bootstrap ratios:
PLS : Contrast: You can first look at the contrast between two conditions: Doubleclick on the contrast file. The contrast is shown in the form of time series; however, the xaxis is not actual time. In fact, the integer numbers show the number of conditions (e.g. 1 for condition 1 or “Faces” and 2 for Condition 2 or “Scrambled Faces”) and the noninteger ones should be ignored.
PLS: pvalue for latent variable: if you double click on this files, you will see a table containing the pvalue of the latent variable that is related to the contrast shown above. A significant latent variable means the contrast observed between two conditions is also significant.
Note: You will see two numbers in the table for pvalue of the latent variable when you run PLS for two conditions. Ignore the second one.
PLS: Bootstrap ratio: This file is saved in the format of source maps. Doubleclick on open the file. The color map shows bootstrap ratios for each source at each time point. There are some important points you should keep in mind when working with bootstrap ratios:
Bootstrap ratios show how reliably each source is contributing to the observed contrast and latent variable at each time point. A bootstrap ratio larger than 2.58 is considered reliable. Therefore, adjust the amplitude of bootstrap ratios to 25%26% to be able to see the reliable signals. For this, choose “Surface” tab from Brainstorm window and adjust the “Amplitude”.
 ghf
References