Differences between revisions 1 and 28 (spanning 27 versions)
Revision 1 as of 2005-08-10 16:32:02
Size: 2269
Comment:
Revision 28 as of 2021-04-21 13:41:30
Size: 4024
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
[wiki:Self:FsTutorial top] | [wiki:Self:FsTutorial/GroupAnalysis previous] = THIS PAGE HAS BEEN MOVED TO SHAREPOINT! =
Please refer to this site/make edits here for the most updated information: https://partnershealthcare.sharepoint.com/sites/LCN/SitePages/Compute-Contrast.aspx
----
<<BR>>
<<BR>>
<<BR>>
Line 3: Line 8:
== Run mris_glm to compute contrast == [[FsTutorial|top]] | [[FsTutorial/GroupAnalysis|previous]]
Line 5: Line 10:
Follow these steps to run mris_glm for computing contrasts: == Group Analysis command lines ==
 *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.

In order to compute the contrasts you will first need to change to the tutorial data directory and setup SUBJECTS_DIR:
Line 8: Line 16:
# change to the tutorial data directory and setup SUBJECTS_DIR:
cd $FREESURFER_HOME/subjects/buckner_public_distribution/FsTutorialDataSet/group_analysis_tutorial
cd $TUTORIAL_DATA/buckner_data/tutorial_subjs/group_analysis_tutorial
Line 11: Line 18:
}}}

Change into the directory you ran the estimation step in, most likely called 'stats':

{{{
Line 14: Line 26:
Upon successful completion of the estimation step (computed in a prior exercise), mris_glm may be configured on command line with proper options to perform contrast computation: Upon successful completion of the make_average_subject command you should have an average subject in your SUBJECTS_DIR. After successfully completing [[FsTutorial/CreateFsgdFile|Exercise A.]] and [[FsTutorial/CreateContrastVectors|Exercise B.]] you should have an FSGD file called my_gender_age_fsgd.txt and a contrast file called age.mat, both in your SUBJECTS_DIR/stats directory. Confirm that those files exist:
{{{
ls my_gender_age_fsgd.txt age.mat
}}}
If my_gender_age_fsgd.txt does not exist, complete [[FsTutorial/CreateFsgdFile|Exercise A.]] If age.mat does not exist, complete [[FsTutorial/CreateContrastVectors|Exercise B.]], or just create a file called age.mat containing this line:
{{{
0 0 1
}}}

The following are sample commands, that can be used with the data, to complete a group analysis:
Line 17: Line 39:
mris_glm --hemi lh \
         --trgsubj average \
         --fsgd ./my_gender_age_fsgd.txt doss \
         --beta_in ./beta_doss-thickness-100lh bfloat \
         --var_in ./var_doss-thickness-100lh.w paint \
         --gcv 0 0 1 \
         --ces ./ces_Age_doss-thickness-100lh.w paint \
         --t ./t_Age_doss-thickness-100lh.w paint \
         --sigt ./sigt_Age_doss-thickness-100lh.w paint

mris_preproc --fsgd my_gender_age_fsgd.txt \
  --target average \
  --hemi lh \
  --meas thickness \
  --out lh.my_gender_age.thickness.mgh
Line 27: Line 46:

Once this completes you should see the file lh.my_gender_age.thickness.mgh. The next step, the smoothing step, will use this as input:
Line 28: Line 50:
# For the right hemisphere
mris_glm --hemi rh \
         --trgsubj average \
         --fsgd ./my_gender_age_fsgd.txt doss \
         --beta_in ./beta_doss-thickness-100rh bfloat \
         --var_in ./var_doss-thickness-100rh.w paint \
         --gcv 0 0 1 \
         --ces ./ces_Age_doss-thickness-100rh.w paint \
         --t ./t_Age_doss-thickness-100rh.w paint \
         --sigt ./sigt_Age_doss-thickness-100rh.w paint
mri_surf2surf --hemi lh \
  --s average \
  --sval lh.my_gender_age.thickness.mgh \
  --fwhm 10 \
  --tval lh.my_gender_age.thickness.10.mgh
Line 39: Line 56:
With the above configuration, mris_glm tests the given subjects for straight correlation between thickness and age. The command will read in the regression coefficients (--beta_in) and noise variance (--var_in) that were generated from the estimation process, and save the contrast effect size (ces), t-ratio of the contrast, and the significance of the t-ratio (i.e., t-test) in the same directory, all in paint format.
Line 41: Line 57:
Upon completion, make sure that the following files are available in the directory from which mris_glm was run by typing: Once this is complete you should see the file lh.my_gender_age.thickness.10.mgh. The next step will test the hypothesis you've set up using your contrast vector:
Line 43: Line 60:
ls -l ces_Age_doss-thickness-100lh.w
ls -l t_Age_doss-thickness-100lh.w
ls -l sigt_Age_doss-thickness-100lh.w
mri_glmfit --y lh.my_gender_age.thickness.10.mgh \
  --fsgd my_gender_age_fsgd.txt doss \
  --glmdir lh.my_gender_age.glmdir \
  --pca \
  --surf average lh \
  --C age.mat
}}}
Line 47: Line 68:
ls -l ces_Age_doss-thickness-100rh.w
ls -l t_Age_doss-thickness-100rh.w
ls -l sigt_Age_doss-thickness-100rh.w
You should have two new directories in $TUTORIAL_DATA/buckner_data/tutorial_subjs/group_analysis_tutorial/stats - lh.my_gender_age.glmdir and rh.my_gender_age.glmdir. If you do:

{{{
ls lh.my_gender_age.glmdir
Line 51: Line 73:
in that directory.
Line 53: Line 74:
you should see this:

{{{
age/ beta.mgh fsgd.X.mat pca-eres/ rvar.mgh y.fsgd
ar1.mgh eres.mgh mri_glmfit.log rstd.mgh Xg.dat
}}}

and if you do:
{{{
ls lh.my_gender_age.glmdir/age
}}}

you should see this:

{{{
C.dat F.mgh gamma.mgh maxvox.dat sig.mgh
}}}

You can view your results by opening the average subject in tksurfer:
{{{
tksurfer average lh inflated
}}}

and loading in your overlay, '''File -> Load Overlay''' and browse to stats/lh.my_gender_age.glmdir/age/sig.mgh.

It should look like this:
{{attachment:sig.mgh.jpg}}

If you would like to also view the scatter plots associated with this you can do so by '''File -> Load Group Descriptor File''' and browse to stats/lh.my_gender_age.glmdir/y.fsgd. Once that file is loaded, a window titled 'Thickness' will appear. Once that appears, then click on any point on the surface, and the thickness data for that surface vertex will appear in the Thickness plot window. The surface areas in blue indicating cortical thinning with age, as shown in the plot.

The commands are the same for the right hemisphere, replacing every '''lh''' with an '''rh'''.

THIS PAGE HAS BEEN MOVED TO SHAREPOINT!

Please refer to this site/make edits here for the most updated information: https://partnershealthcare.sharepoint.com/sites/LCN/SitePages/Compute-Contrast.aspx





top | previous

Group Analysis command lines

  • 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 order to compute the contrasts you will first need to change to the tutorial data directory and setup SUBJECTS_DIR:

cd $TUTORIAL_DATA/buckner_data/tutorial_subjs/group_analysis_tutorial
setenv SUBJECTS_DIR ${PWD}

Change into the directory you ran the estimation step in, most likely called 'stats':

cd stats

Upon successful completion of the make_average_subject command you should have an average subject in your SUBJECTS_DIR. After successfully completing Exercise A. and Exercise B. you should have an FSGD file called my_gender_age_fsgd.txt and a contrast file called age.mat, both in your SUBJECTS_DIR/stats directory. Confirm that those files exist:

ls my_gender_age_fsgd.txt age.mat

If my_gender_age_fsgd.txt does not exist, complete Exercise A. If age.mat does not exist, complete Exercise B., or just create a file called age.mat containing this line:

0 0 1

The following are sample commands, that can be used with the data, to complete a group analysis:

# For the left hemisphere

mris_preproc --fsgd my_gender_age_fsgd.txt \
  --target average \
  --hemi lh \
  --meas thickness \
  --out lh.my_gender_age.thickness.mgh

Once this completes you should see the file lh.my_gender_age.thickness.mgh. The next step, the smoothing step, will use this as input:

mri_surf2surf --hemi lh \
  --s average \
  --sval lh.my_gender_age.thickness.mgh \
  --fwhm 10 \
  --tval lh.my_gender_age.thickness.10.mgh

Once this is complete you should see the file lh.my_gender_age.thickness.10.mgh. The next step will test the hypothesis you've set up using your contrast vector:

mri_glmfit --y lh.my_gender_age.thickness.10.mgh \
  --fsgd my_gender_age_fsgd.txt doss \
  --glmdir lh.my_gender_age.glmdir \
  --pca \
  --surf average lh \
  --C age.mat

You should have two new directories in $TUTORIAL_DATA/buckner_data/tutorial_subjs/group_analysis_tutorial/stats - lh.my_gender_age.glmdir and rh.my_gender_age.glmdir. If you do:

ls lh.my_gender_age.glmdir

you should see this:

age/     beta.mgh  fsgd.X.mat      pca-eres/  rvar.mgh  y.fsgd
ar1.mgh  eres.mgh  mri_glmfit.log  rstd.mgh   Xg.dat

and if you do:

ls lh.my_gender_age.glmdir/age

you should see this:

C.dat  F.mgh  gamma.mgh  maxvox.dat  sig.mgh

You can view your results by opening the average subject in tksurfer:

tksurfer average lh inflated

and loading in your overlay, File -> Load Overlay and browse to stats/lh.my_gender_age.glmdir/age/sig.mgh.

It should look like this: sig.mgh.jpg

If you would like to also view the scatter plots associated with this you can do so by File -> Load Group Descriptor File and browse to stats/lh.my_gender_age.glmdir/y.fsgd. Once that file is loaded, a window titled 'Thickness' will appear. Once that appears, then click on any point on the surface, and the thickness data for that surface vertex will appear in the Thickness plot window. The surface areas in blue indicating cortical thinning with age, as shown in the plot.

The commands are the same for the right hemisphere, replacing every lh with an rh.

FsTutorial/ComputeContrast (last edited 2021-09-22 11:38:51 by DevaniCordero)