Differences between revisions 35 and 45 (spanning 10 versions)

DBA tutorial: Compute sources in deep cerebral structures

Authors: Jean-Eudes Le Douget, Francois Tadel, Denis Schwartz

This tutorial explains step-by-step how to use the DBA (Deep Brain Activity) functionality, useful to assess subcortical source localization.

Contents

Import database
Select deep structures
Compute source activity
Compute statistics
Volume scouts
DBA constraints [TODO]
References

Import database

This tutorial is based on resting-state recordings for 7 subjects with two conditions: eyes open (YO), eyes closed (YF). We have recorded 20 runs of 15 seconds for each subject and each condition, .

The goal is to compute the contrast between the two conditions in the alpha band. The data has already been filtered in the alpha frequency band (7-13Hz) and the default anatomy is used for all the subjects.

Start by downloading the tutorial dataset: *file.zip*.
The file is an exported Brainstorm protocol. To load in your database, use the menu:
File > Load Protocol > Load from zip file.

Select deep structures

The first step consists in creating the surface file that includes the cortex and the deep structures that we want to include in the model. Here, in the default anatomy:

Double-click on "aseg atlas" (which contains the subcortical structures)
Select the amygdala, the thalamus and the hippocampus, and create a subatlas

Merge the cortex with the atlas of selected structures ; rename the structure created in CortexDBA

Create a new atlas "Source Model Atlas", and set modeling options to "Deep brain"

Compute source activity

Then, compute a headmodel for each subject as "Custom Source Model" ; it is advised to run it as batch from the pipeline editor.

At this stage, it is now possible to compute sources.

You can now visualize activity the same way as for usual headmodels.

If activities of the volume structures (thalamus and amygdala here) do not appear, try moving the Min size cursor to max and then back to 1.

Compute statistics

Now that the source calculations are done, we design a statistical analysis to assess the eyes-open and eyes-closed contrast.

First, the alpha-power is time-averaged for each run
Then, the "Process2" tab is used : place the source power files of the eyes-closed condition in the "Files A" space and of the eyes-open condition in the "Files B" space.
To gain time, it is possible to sort the functional data by conditions, place the subjects in "FilesA" and "FilesB" and use the filter to include only files that contain 'avg' (for time-averaged files)
Run a Student's T-Test to compute a statistical contrast between the conditions
The stat file can then be visualized and the values corresponding to subcortical structures are also appearing
It is also interesting to observe the difference of means between conditions. To compute this, instead of runnning a Student's T-Test, select the "Difference of means" option

Volume scouts

Some subcortical structures are modeled as volume source structures (for instance here, the thalamus and the amygdala). It is not possible to display scouts time series for these structures from the "Source model" or "Structures" atlases. It is necessary to create a new atlas, specific to volumic scouts. The steps are the following :

First, create the volumic atlas

Second, to create a new scout :
- Click on the "Create scout" cross, and click one point of the structure you want to include in the scout
- Click on the "Increase scout size" as many times as necessary to include all the points of the volume, for example in the right thalamus
- Rename the scout and set the correct region and the desired function
- Repeat this operation for all the volumic scouts you want to create
Finally, you can display time series of your choice

DBA constraints [TODO]

Describe the constraints applied to each region.

References

Attal Y, Bhattacharjee M, Yelnik J, Cottereau B, Lefèvre J, Okada Y, Bardinet E, Chupin M, Baillet S (2009)
Modelling and detecting deep brain activity with MEG and EEG

IRBM, 30(3):133-138

Attal Y, Schwartz D (2013)
Assessment of Subcortical Source Localization Using Deep Brain Activity Imaging Model with Minimum Norm Operators: A MEG Study
PLOS ONE, 8(3):e59856

Dumas T, Dubal S, Attal Y, Chupin M, Jouvent R (2013)
MEG Evidence for Dynamic Amygdala Modulations by Gaze and Facial Emotions
PLOS ONE, 8(9): e74145

-  ⇤ ← Revision 35 as of 2015-09-21 16:03:38 → 
  Size: 9310
  Editor: ?JeaneudesLedouget
  Comment:
+   ← Revision 45 as of 2015-09-21 16:36:33 → ⇥
  Size: 6587
  Editor: ?JeaneudesLedouget
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 13:
- * Start by downloading the tutorial dataset: *file.zip*.
+ * Start by downloading the tutorial dataset: *file.zip*. <<BR>>
 Line 15:
- * The file is an exported Brainstorm protocol. To load in your database, use the menu:<<BR>> File > Load Protocol > '''Load from zip file'''. <<BR>><<BR>> {{attachment:DBA_LoadProtocol.png||height="209",width="293"}}
+ * The file is an exported Brainstorm protocol. To load in your database, use the menu:<<BR>> File > Load Protocol > '''Load from zip file'''. <<BR>><<BR>>
{{attachment:DBA_LoadProtocol.png||height="209",width="293"}}
-Line 20:
+Line 21:
- * Double-click on "aseg atlas" (which contains the subcortical structures)
+ * Double-click on "aseg atlas" (which contains the subcortical structures) <<BR>>
-Line 22:
+Line 23:
- * Select the amygdala, the thalamus and the hippocampus, and create a subatlas
+ * Select the amygdala, the thalamus and the hippocampus, and create a subatlas <<BR>>
-Line 26:
+Line 27:
- * Merge the cortex with the atlas of selected structures ; rename the structure created in CortexDBA
+ * Merge the cortex with the atlas of selected structures ; rename the structure created in CortexDBA <<BR>>
-Line 28:
+Line 29:
-{{attachment:DBA_MergeSurfaces.png||height="295",width="223"}}                                                        {{attachment:DBA_RenameCtx.png||height="198",width="135"}}
+{{attachment:DBA_MergeSurfaces.png||height="295",width="223"}}                                                                  {{attachment:DBA_RenameCtx.png||height="198",width="135"}}
-Line 30:
+Line 31:
- * Create a new atlas "Source Model Atlas", and set modeling options to "Deep brain"
+ * Create a new atlas "Source Model Atlas", and set modeling options to "Deep brain" <<BR>>
-Line 39:
+Line 40:
-----
/!\ '''Edit conflict - other version:'''

----
-Line 45:
+Line 42:
-----
/!\ '''Edit conflict - your version:'''

----


----
/!\ '''End of edit conflict'''

----
-Line 57:
+Line 44:
-----
/!\ '''Edit conflict - other version:'''

----
-Line 63:
+Line 46:
-----
/!\ '''Edit conflict - your version:'''

----
{{attachment:ComputeSources.png}} {{attachment:SourceOptions.png}} {{attachment:SourceOptions2.png}}

----
/!\ '''End of edit conflict'''

----
-Line 75:
+Line 48:
-----
/!\ '''Edit conflict - other version:'''

----
-Line 81:
+Line 50:
-----
/!\ '''Edit conflict - your version:'''

----
{{attachment:VisuActivity.png}}

----
/!\ '''End of edit conflict'''

----
If the activity of the volume structures (thalamus and amygdala here) do not appear, try moving the Min size cursor to max and then back to 1.
+If activities of the volume structures (thalamus and amygdala here) do not appear, try moving the Min size cursor to max and then back to 1.
-Line 96:
+Line 55:
-----
/!\ '''Edit conflict - other version:'''

----
 * First, the alpha-power is time-averaged for each run<<BR>> {{attachment:DBA_AverageTime.png||height="259",width="303"}}  {{attachment:DBA_AverageTimeOptions.png||height="216",width="236"}}
+ * First, the alpha-power is time-averaged for each run<<BR>>
 {{attachment:DBA_AverageTime.png||height="259",width="303"}}       {{attachment:DBA_AverageTimeOptions.png||height="216",width="236"}}
-Line 103:
+Line 59:
- * Run a Student's T-Test to compute a statistical contrast between the conditions<<BR>> {{attachment:DBA_Ttest.png||height="422",width="383"}}  {{attachment:DBA_TtestOptions.png||height="283",width="226"}}
 * The stat file can then be visualized and the values corresponding to subcortical structures are also appearing<<BR>> {{attachment:DBA_VisuStat.png||height="286",width="523"}}
 * It is also interesting to observe the difference of means between conditions. To compute this, instead of runnning a Student's T-Test, select the "Difference of means" option<<BR>> {{attachment:DBA_DiffOfMeans.png||height="283",width="394"}}

----
/!\ '''Edit conflict - your version:'''

----
 * First, the alpha-power is time-averaged for each run<<BR>> {{attachment:AverageTime.png}} {{attachment:AverageTimeOptions3.png}}

 * Then, the "Process2" tab is used : place the source power files of the eyes-closed condition in the "Files A" space and of the eyes-open condition in the "Files B" space.<<BR>>To gain time, it is possible to sort the functional data by conditions, place the subjects in "FilesA" and "FilesB" and use the filter to include only files that contain 'avg' (for time-averaged files)
 * Run a Student's T-Test to compute a statistical contrast between the conditions<<BR>> {{attachment:Ttest.png}} {{attachment:TtestOptions.png}}
 * The stat file can then be visualized and the values corresponding to subcortical structures are also appearing<<BR>> {{attachment:VisuStat.png}}
 * It is also interesting to observe the difference of means between conditions. To compute this, instead of runnning a Student's T-Test, select the "Difference of means" option<<BR>> {{attachment:DiffOfMeans.png}}

----
/!\ '''End of edit conflict'''

----
+ * Run a Student's T-Test to compute a statistical contrast between the conditions<<BR>>
 {{attachment:DBA_Ttest.png||height="422",width="383"}}     {{attachment:DBA_TtestOptions.png||height="283",width="226"}}
 * The stat file can then be visualized and the values corresponding to subcortical structures are also appearing<<BR>>
 {{attachment:DBA_VisuStat.png||height="286",width="523"}}
 * It is also interesting to observe the difference of means between conditions. To compute this, instead of runnning a Student's T-Test, select the "Difference of means" option<<BR>>
 {{attachment:DBA_DiffOfMeans.png||height="283",width="394"}}
-Line 126:
+Line 69:
-----
/!\ '''Edit conflict - other version:'''
+ * First, create the volumic atlas<<BR>>
{{attachment:DBA_VolumeScouts.png||height="264",width="668"}}
 * Second, to create a new scout :
  * Click on the "Create scout" cross, and  click one point of the structure you want to include in the scout<<BR>>
 {{attachment:DBA_VolumeScout_FirstPoint.png||height="291",width="659"}}
-Line 129:
+Line 75:
-----
 * First, create the volumic atlas<<BR>> {{attachment:DBA_VolumeScouts.png}}
 * Second, to create a new scout :
  * Click on the "Create scout" cross, and  click one point of the structure you want to include in the scout<<BR>> {{attachment:DBA_VolumeScout_FirstPoint.png||height="350",width="777"}}
  * Click on the "Increase scout size" as many times as necessary to include all the points of the volume, for example in the right thalamus<<BR>> {{attachment:DBA_IncreaseScoutSize2.png||height="442",width="887"}} {{attachment:DBA_Scout_RightThal.png}}
  * Rename the scout and set the correct region and the desired function<<BR>> {{attachment:DBA_RenameScout.png}} {{attachment:DBA_SetRegion.png}} {{attachment:DBA_SetFunction.png}}
+  * Click on the "Increase scout size" as many times as necessary to include all the points of the volume, for example in the right thalamus<<BR>>
 {{attachment:DBA_IncreaseScoutSize2.png||height="239",width="148"}}                 {{attachment:DBA_Scout_RightThal.png||height="272",width="266"}}
  * Rename the scout and set the correct region and the desired function<<BR>> {{attachment:DBA_RenameScout.png||height="78",width="192"}}
 {{attachment:DBA_SetRegion2.png||height="271",width="260"}}        {{attachment:DBA_SetFunction2.png||height="270",width="244"}}
-Line 136:
+Line 80:
- * Finally, you can display time series of your choice<<BR>> {{attachment:DBA_DispolayScoutsTS.png}}

----
/!\ '''Edit conflict - your version:'''

----
 * First, create the volumic atlas<<BR>> {{attachment:VolumeScouts.png}}
 * Second, to create a new scout :
  * Click on the "Create scout" cross, and  click one point of the structure you want to include in the scout<<BR>> {{attachment:VolumeFirstPoint.png}}
  * Click on the "Increase scout size" as many times as necessary to include all the points of the volume, for example in the right thalamus<<BR>> {{attachment:IncreaseScoutSize.png}} {{attachment:RightThal.png}}
  * Rename the scout and set the correct region and the desired function<<BR>> {{attachment:RenameScout.png}} {{attachment:SetRegion.png}} {{attachment:SetFunction.png}}
  * Repeat this operation for all the volumic scouts you want to create
 * Finally, you can display time series of your choice<<BR>> {{attachment:DisplayScoutsTS.png}}

----
/!\ '''End of edit conflict'''

----
+ * Finally, you can display time series of your choice<<BR>> {{attachment:DBA_DispolayScoutsTS.png||height="306",width="280"}}
-Line 161:
+Line 88:
-----
/!\ '''Edit conflict - other version:'''

----
-Line 167:
+Line 90:
-----
/!\ '''Edit conflict - your version:'''

----
 . '''IRBM''', 30(3):133-138

----
/!\ '''End of edit conflict'''

----

Software

Users

Development