Differences between revisions 1 and 36 (spanning 35 versions)
Revision 1 as of 2005-09-06 22:29:00
Size: 2884
Editor: anonymous
Comment: missing edit-log entry for this revision
Revision 36 as of 2008-11-20 14:48:37
Size: 4301
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
[wiki:Self:FsTutorial top] | [wiki:Self:FsTutorial/FslFeatFreeSurfer previous] [[FsTutorial|top]] | [[FsTutorial/FslFeatFreeSurfer|previous]]
== Overlaying FSL Feat statistical maps ==
Line 3: Line 4:
== Overlaying FSL Feat statistical maps ==  *To follow this exercise exactly be sure you've downloaded the [[FsTutorial/Data|tutorial data set]] before you begin. If you choose not to download the data set you can follow these instructions on your own data, but you will have to substitute your own specific paths and subject names.
Line 5: Line 6:
In this exercise, the data set of subject '''bert''' is used for demonstration. To begin the exercises, first enter the following directory, and then set the current directory to be the default subjects directory using this command: In this exercise, the data set of subject '''bert''' is used for demonstration. Type the following prior to beginning the exercises:
----
Line 7: Line 9:
cd $FREESURFER_HOME/subjects/buckner_data/tutorial_subjs
setenv SUBJECTS_DIR ${PWD}
tcsh
setenv SUBJECTS_DIR
$FREESURFER_HOME/subjects/buckner_data/tutorial_subjs
cd $SUBJECTS_DIR/fbert-feat
ln -s
$FREESURFER_HOME/subjects/fsaverage
ln -s $FREESURFER_HOME/subjects/bert
Line 10: Line 15:
----
The subjects 'fsaverage' and 'bert' may already exist in the subjects directory, so ignore any warnings that might be issued that say 'File exists'.
Line 13: Line 20:
Use the following command to display the zmap (zstat1.img) overlaid onto the bert's orig volume. It will display the automatic segmentation, and will also set the threshold at z = 1.3: Use the following command to display the zmap (zstat1.nii.gz) from the first run overlaid onto the bert's orig volume. It will display the automatic segmentation, and will also set the threshold at z = 2.3:
----
Line 15: Line 23:
tkmedit bert orig -aux brain -overlay ./fbert.feat/stats/zstat1.img \
    -overlay-reg ./fbert.feat/reg/freesurfer/anat2exf.register.dat \
    -fthresh 1.3 -fmid 2.3 -fslope 1 \
    -segmentation ${SUBJECTS_DIR}/bert/mri/aseg ${FREESURFER_HOME}/tkmeditColorsCMA
 tkmedit bert orig.mgz lh.white -aux brain.mgz \
   -overlay ./fbert1.feat/stats/zstat1.nii.gz \
   -overlay-reg ./fbert1.feat/reg/freesurfer/anat2exf.register.dat \
   -segmentation aparc+aseg.mgz -fthresh 2.3 -fmax 4.3
Line 20: Line 28:
----
You should see the image below:<<BR>>
{{attachment:tkm-zstat1-cor-128.th23.small.jpg}} <<BR>>
When you click or mouse over a voxel, the cortical or subcortical structure that that voxel belongs to will be displayed in the control panel. You can view any of the volumes in the stats dir in this way as well as the clustered maps in the feat directory.
Line 21: Line 33:
You should see the image below:[[BR]]
attachment:tkm-zstat1-cor-128-small.jpg
=== 2.0 View statistical maps on bert's surface ===
To view any of the statistical maps on bert's surface, close the tkmedit GUI (or open a new terminal window) and run:
----
{{{
tksurfer bert lh inflated \
  -overlay ./fbert1.feat/stats/zstat1.nii.gz \
  -overlay-reg ./fbert1.feat/reg/freesurfer/anat2exf.register.dat \
  -fthresh 2.3 -fmid 3.3 -fslope 1 -annot aparc.annot
}}}
----
Change the cortical parcellation to outline mode with View->LabelStyle->Outline. You should see the image below:<<BR>>
{{attachment:tks-zstat1-rh-lat.th23.small.jpg}}
<<BR>>
When you click or mouse over a vertex, the control panel will display the name of the cortical structure. You can view any of the volumes in the stats dir in this way as well as the clustered maps in the feat directory. You can also run the tkmedit and tksurfer commands above in separate shells and use the Save-Point/Goto-Point functionality to navigate through the volume and surface.
Line 24: Line 48:
=== 2.0 Sampling statistical maps onto bert's surface === === 3.0 Displaying Same-Subject, Cross-Run GFEAT Results ===
Line 26: Line 50:
In order to display the statistical map overlaid onto the surface, the data in fbert.feat must be resampled. This is done with feat2surf. Documentation for what it does and how it does it can be obtained with: Typically, one collects more than one run/series of functional data
for each subject. The individual runs are analyzed separately, then
combined in standard space with GFEAT using a fixed-effects
model. Since the data are no longer in the subject's native functional
space, a different registration matrix is needed to map the GFEAT
results to the individual. Each run of reg-feat2anat will create a
reg/freesurfer/anat2std.register.dat. Any one of these can be used to
map the GFEAT data to the subject's anatomy.

First, verify that the registration is good with:
----
Line 28: Line 62:
feat2surf --help tkregister2 --mov fbert.gfeat/mean_func.nii.gz --surf \
  --reg fbert1.feat/reg/freesurfer/anat2std.register.dat
Line 30: Line 65:
To run it on this data set, run: ----
mean_func.nii.gz is the mean of the example_func's in standard space. Note: if there
is a problem with this registration, you need to repair the registrations
for each individual run.


Now show gfeat results on anatomical volume:
----
Line 32: Line 74:
feat2surf --feat fbert.feat tkmedit bert orig.mgz -seg aparc+aseg.mgz \
  -ov fbert.gfeat/cope1.feat/stats/zstat1.nii.gz \
  -ovreg fbert1.feat/reg/freesurfer/anat2std.register.dat \
  -fthresh 2.3 -fmax 4.3
Line 34: Line 79:
Verify that this has created four directories under fbert.feat: reg_surf-lh, reg_surf-rh, reg_surf-lh-average7, and reg_surf-rh-average7. Each one of these directories will have a stats directory in which all the statistics from fbert.feat/stats have been resampled onto the surface. The average7 directories are resampled onto the common surface spaced (defined by average7). ----
Here we've used the anat2std.register.dat from the first run.
Line 36: Line 82:
=== 3.0 Viewing statistical maps on bert's surface ===

To view the statistical maps on the right hemisphere, run tksurfer:
Now show gfeat results on the surface:
----
Line 40: Line 85:
tksurfer bert rh inflated \
  -o ./fbert.feat/reg_surf-rh/stats/zstat1.mgh -overlay-reg-identity \
  -fthresh 1.3 -fmid 2.3 -fslope 1
tksurfer bert lh inflated -annot aparc.annot \
  -ov fbert.gfeat/cope1.feat/stats/zstat1.nii.gz \
 
-ovreg fbert1.feat/reg/freesurfer/anat2std.register.dat \
  -fthresh 2.3 -fmid 3.3 -fslope 1
Line 44: Line 90:
Note that you can run the above tkmedit command (from a different window) simultaneously with
the tksurfer command to visualize the same data on the volume and in the surface. You can
then use the Save/Goto Point buttons to navigate between the surface and volume.

You should see the image below:[[BR]]
attachment:tks-zstat1-rh-lat-small.jpg

=== 4.0 Overlaying zmap onto the FSL's standard volume ===

You can also use tkmedit to view your results on the FSL standard volume
instead of the individual's anatomical with the following command:
{{{
tkmedit -f $FSLDIR/etc/standard/avg152T1_brain.img \
     -overlay ./fbert.feat/stats/zstat1.img \
     -overlay-reg ./fbert.feat/reg/freesurfer/std2exf.register.dat \
     -fthresh 1.3 -fmid 2.3 -fslope 1
}}}
----

top | previous

Overlaying FSL Feat statistical maps

  • To follow this exercise exactly be sure you've downloaded the tutorial data set before you begin. If you choose not to download the data set you can follow these instructions on your own data, but you will have to substitute your own specific paths and subject names.

In this exercise, the data set of subject bert is used for demonstration. Type the following prior to beginning the exercises:


tcsh
setenv SUBJECTS_DIR $FREESURFER_HOME/subjects/buckner_data/tutorial_subjs
cd $SUBJECTS_DIR/fbert-feat
ln -s $FREESURFER_HOME/subjects/fsaverage
ln -s $FREESURFER_HOME/subjects/bert


The subjects 'fsaverage' and 'bert' may already exist in the subjects directory, so ignore any warnings that might be issued that say 'File exists'.

1.0 Overlaying the statistical map onto the bert's orig volume

Use the following command to display the zmap (zstat1.nii.gz) from the first run overlaid onto the bert's orig volume. It will display the automatic segmentation, and will also set the threshold at z = 2.3:


 tkmedit bert orig.mgz lh.white -aux brain.mgz \
   -overlay ./fbert1.feat/stats/zstat1.nii.gz \
   -overlay-reg ./fbert1.feat/reg/freesurfer/anat2exf.register.dat \
   -segmentation aparc+aseg.mgz  -fthresh 2.3 -fmax 4.3


You should see the image below:
tkm-zstat1-cor-128.th23.small.jpg
When you click or mouse over a voxel, the cortical or subcortical structure that that voxel belongs to will be displayed in the control panel. You can view any of the volumes in the stats dir in this way as well as the clustered maps in the feat directory.

2.0 View statistical maps on bert's surface

To view any of the statistical maps on bert's surface, close the tkmedit GUI (or open a new terminal window) and run:


tksurfer bert lh inflated \
  -overlay ./fbert1.feat/stats/zstat1.nii.gz \
  -overlay-reg ./fbert1.feat/reg/freesurfer/anat2exf.register.dat \
  -fthresh 2.3 -fmid 3.3 -fslope 1 -annot aparc.annot


Change the cortical parcellation to outline mode with View->LabelStyle->Outline. You should see the image below:
tks-zstat1-rh-lat.th23.small.jpg
When you click or mouse over a vertex, the control panel will display the name of the cortical structure. You can view any of the volumes in the stats dir in this way as well as the clustered maps in the feat directory. You can also run the tkmedit and tksurfer commands above in separate shells and use the Save-Point/Goto-Point functionality to navigate through the volume and surface.

3.0 Displaying Same-Subject, Cross-Run GFEAT Results

Typically, one collects more than one run/series of functional data for each subject. The individual runs are analyzed separately, then combined in standard space with GFEAT using a fixed-effects model. Since the data are no longer in the subject's native functional space, a different registration matrix is needed to map the GFEAT results to the individual. Each run of reg-feat2anat will create a reg/freesurfer/anat2std.register.dat. Any one of these can be used to map the GFEAT data to the subject's anatomy.

First, verify that the registration is good with:


tkregister2 --mov fbert.gfeat/mean_func.nii.gz --surf \
  --reg fbert1.feat/reg/freesurfer/anat2std.register.dat 


mean_func.nii.gz is the mean of the example_func's in standard space. Note: if there is a problem with this registration, you need to repair the registrations for each individual run.

Now show gfeat results on anatomical volume:


tkmedit bert orig.mgz -seg aparc+aseg.mgz \
  -ov fbert.gfeat/cope1.feat/stats/zstat1.nii.gz \
  -ovreg fbert1.feat/reg/freesurfer/anat2std.register.dat \
  -fthresh 2.3 -fmax 4.3


Here we've used the anat2std.register.dat from the first run.

Now show gfeat results on the surface:


tksurfer bert lh inflated -annot aparc.annot \
  -ov fbert.gfeat/cope1.feat/stats/zstat1.nii.gz \
  -ovreg fbert1.feat/reg/freesurfer/anat2std.register.dat \
  -fthresh 2.3 -fmid 3.3 -fslope 1


FsTutorial/OverlayFeatStatisticalMaps (last edited 2021-09-22 11:40:04 by DevaniCordero)