Autorecon2: Difference between revisions

From CCN Wiki
Jump to navigation Jump to search
No edit summary
Line 41: Line 41:


== Quality Control ==
== Quality Control ==
After this step has completed, load up the generated mesh in a program called tksurfer:
After this step has completed, you can overlay the surface mesh vector on to the source T1 anatomical image in tkmedit:
tkmedit brainmask.mgz -surfs
You will want to confirm that the pial boundaries, which define where the grey matter is located, correspond to the source image data.
See the following wiki page for examples of where it doesn't, and what to do if not:
[https://surfer.nmr.mgh.harvard.edu/fswiki/FsTutorial/PialEdits_tktools Pial Editing]
Next, load up the generated mesh in a program called tksurfer:
  tksurfer <subjectname> <hemi> <surf>
  tksurfer <subjectname> <hemi> <surf>
Where ''subjectname'' is the name that you passed to autorecon2.sh (e.g., FS_T1_501), ''hemi'' is the hemisphere you want to load (one of either '''lh''' or '''rh'''), and the ''surf'' flag indicates which surface you want to view (typically I look at the 'pial' surface, which corresponds to the outside grey matter surface. E.g.:
Where ''subjectname'' is the name that you passed to autorecon2.sh (e.g., FS_T1_501), ''hemi'' is the hemisphere you want to load (one of either '''lh''' or '''rh'''), and the ''surf'' flag indicates which surface you want to view (typically I look at the 'pial' surface, which corresponds to the outside grey matter surface. E.g.:
  tksurfer FS_T1_501 lh pial
  tksurfer FS_T1_501 lh pial
You can rotate the surface around along all 3D axes and confirm that it looks like what you would expect a normal brain to look like. Errors in the surface construction would be evident by strangely-shaped features, like spikes or pits along the surface.
You can rotate the surface around along all 3D axes and confirm that it looks like what you would expect a normal brain to look like. Errors in the surface construction would be evident by strangely-shaped features, like spikes or pits along the surface.

Revision as of 15:54, 12 April 2016

The -autorecon2 directive tells Freesurfer to convert the cubic voxel-based T1 (high-resolution anatomical) image into a triangular mesh surface model. It generates a separate surface mesh for each hemisphere, and from this point on in the process, each hemisphere will have its own independent set of files.

If you checked your data carefully after autorecon1 has finished you should find that the second step goes fairly smoothly.

There is a script, autorecon2.sh that is a wrapper for the recon-all command with the -autorecon2 directive. It simply requires you to specify a valid subjectid within your $SUBJECTS_DIR. Note that a valid subjectid will be the name of the directory generated by Freesurfer when executing the -autorecon1 directive. For example, if my source data prior to running Freesurfer came from:

  • /home
    • /mydirectory
      • /fmri
        • /sub_001
          • /MPRAGE

My $SUBJECTS_DIR might be set to be /home/mydirectory/fmri. After running autorecon1.sh, depending on the value given for the -subjid flag, a new directory might now exist containing all the resulting outputs, e.g.:

  • /home
    • /mydirectory
      • /fmri
        • /FS_001

For all subsequent processing steps, the subject id is FS_001 for this data set, and not 001.

If you have an autorecon2.sh script in your ~/bin/ directory, inspect it first before running it, and ensure that you understand what it's doing. For reference, here's what a script of mine looks like:

#!/bin/bash
# Usage: autorecon2.sh <subjectid>

PROJECTROOT=/home/chris/ubfs/cpmcnorg/openfmri/booth/ #Change this: where are your data located?

OLD_SUBJECTS_DIR=${SUBJECTS_DIR} #Your subjects directory might be initially set to something else
SUBJECTS_DIR=${PROJECTROOT} #now tell freesurfer where the subject in question resides
export SUBJECTS_DIR 

echo SUBJECTS_DIR: ${SUBJECTS_DIR}

subjectID=$1
recon-all -autorecon2 \
  -subjid ${subjectID}

SUBJECTS_DIR=${OLD_SUBJECTS_DIR} #reset subjects_dir to whatever it was before
export SUBJECTS_DIR 

When I ran my autorecon1.sh script, it created a new folder called FS_T?_* for the individual (I was working on longitudinal data, where there was a T1 and T2 time point for each participant). When I ran it for the T1 data for subject 501, it created a folder in $SUBJECTS_DIR called FS_T1_501. After editing the brainmask.mgz file for this participant, I ran autorecon2.sh like this:

autorecon2.sh FS_T1_501

The -autorecon2 directive takes several hours to complete. Initial estimates were as long as 11 hours, though it recently took only about 5 or 6 hours to run on a different participant. Either way, you should plan to do some other work while you're waiting for this step to be completed.

Quality Control

After this step has completed, you can overlay the surface mesh vector on to the source T1 anatomical image in tkmedit:

tkmedit brainmask.mgz -surfs

You will want to confirm that the pial boundaries, which define where the grey matter is located, correspond to the source image data. See the following wiki page for examples of where it doesn't, and what to do if not: Pial Editing Next, load up the generated mesh in a program called tksurfer:

tksurfer <subjectname> <hemi> <surf>

Where subjectname is the name that you passed to autorecon2.sh (e.g., FS_T1_501), hemi is the hemisphere you want to load (one of either lh or rh), and the surf flag indicates which surface you want to view (typically I look at the 'pial' surface, which corresponds to the outside grey matter surface. E.g.:

tksurfer FS_T1_501 lh pial

You can rotate the surface around along all 3D axes and confirm that it looks like what you would expect a normal brain to look like. Errors in the surface construction would be evident by strangely-shaped features, like spikes or pits along the surface.