Using FreeSurfer

The open-source software FreeSurfer can be used to extract the cortical envelope from a T1 MRI. It also registers the individual cortex surfaces to surface-based anatomical atlases (Desikan-Killiany, Destrieux, Brodmann). The process is fully automatic and the results can be imported in Brainstorm with just a few mouse clicks.

Running FreeSurfer

1. Downloading and installing FreeSurfer is very easy. It just takes some time because the distribution package is huge (get ready to download several Gb). You have two options: you have a Linux system and you want to install FreeSurfer, or you don't and you want to run FreeSurfer in a Linux virtual machine.
   Just follow the instructions: http://surfer.nmr.mgh.harvard.edu/fswiki/DownloadAndInstall

2. Set up the FreeSurfer in a csh/tcsh environment: run the following lines, or add them at the end of your $HOME/.cshrc script for permanent change. If you're not sure what csh is: type "echo $SHELL" to know what is the name of the shell that you use. If it says "/bin/tcsh" or "/bin/csh", this is for you.

   setenv FREESURFER_HOME /.../local/freesurfer
   setenv SUBJECTS_DIR /.../data/freesurfer/subjects
   setenv FUNCTIONALS_DIR /.../data/freesurfer/sessions
   source /.../local/freesurfer/FreeSurferEnv.csh

3. Set up the FreeSurfer environment in a bash environment (add those lines at the end of your $HOME/.bashrc script):

   export FREESURFER_HOME=/.../local/freesurfer
   export SUBJECTS_DIR=/.../data/ftadel/freesurfer
   export FUNCTIONALS_DIR=/.../data/ftadel/freesurfer
   source $FREESURFER_HOME/FreeSurferEnv.sh

4. Run the reconstruction:

   recon-all -i <mri_file> -subjid <subject_id>
   recon-all -all -subjid <subject_id>

5. Go home, come back the next day. The process is fully automatic, but quite resource-consuming.

6. Done. Everything is ready to be imported in Brainstorm. The results are usually good, but depending on the quality of the structural MR, it may fail. Because of this unpredictable behavior, you always need to check visually the final surfaces. The FreeSurfer wiki suggests that you check all the steps with FreeSurfer. We suggest instead that you load it all in Brainstorm and go back to the manual checking/editing only if it looks bad.

7. More detailed instructions for setting up the environment and tuning the reconstruction here:
   http://surfer.nmr.mgh.harvard.edu/fswiki/RecommendedReconstruction

Importing the results in Brainstorm

1. Switch to the anatomy side of the database explorer
2. Create a new subject, set the default anatomy option to "No, use individual anatomy"

3. Right-click on the subject > Import FreeSurfer folder...
   
   
   
   

4. Select the top folder of your subject <subject_id> (/.../data/freesurfer/subjects/subject_id)

5. Then you're prompted for the number of vertices you want in the final cortex surface. This will by extension define the number of dipoles to estimate during the source estimation process. By default we set this value to 15000 for the entire brain (it means 7500 for each hemisphere).
   
   
   
   

6. The MRI Viewer appears, and a help window asks you to validate the orientation of the MRI and to define the 6 fiducial points. If something doesn't look right at this step, for instance if the MRI is not presented with a correct orientation, you should stop this automatic import process and follow the manual instructions in the basic tutorial pages.
   
   
   
   

7. Place the six fiducials. If you need help, refer to this page: CoordinateSystems

8. Click on Save to keep your modifications, and the automatic import will go on.
9. The files that are imported from the subject_id folder are the following:

   • /mri/T1.mgz (T1 MRI volume)

   • /mri/aseg.mgz (segmentation of subcortical structures)

   • /surf/?h.pial (grey/csf interface)

   • /surf/?h.smoothwm (grey/white matter interface)

   • /surf/?h.sphere.reg (registered parametrized sphere, for subject co-registration)

   • /label/?h.*.annot (cortical surface-based atlases)

   • /surf/?h.thickness (cortical thickness map: option available only in the "process" version)

10. The successive steps that are performed automatically by Brainstorm:
    • Import all the surfaces (left/right, white/pial)
    • Load all the atlases available for each surface (note that the .pial and .smoothwm surfaces are matching point-to-point, so the same annotation files are imported for both surface types)
    • Load the registered spheres for the the left and right hemisperes
    • Downsample each hemisphere to the number specified in the options (by default 7500, half of the total default number 15000)
    • Merge left and right hemispheres for the two surface types: white matter and cortex envelope
    • Delete all the unnecessary surfaces
    • Generate a head surface from the MRI
    • Read the sub-cortical atlas aseg.mgz as a set of labelled surfaces

11. The files you can see in the database explorer at the end:
    
    
    
    

    • MRI: The T1 MRI of the subject, imported from the MGH file format (.mgz)

    • head mask (10000,0,2): Scalp surface generated by Brainstorm. The numbers indicate the parameters that were used automatically for this head: vertices=10000, erode factor=0, fill holes=2 (those are detailed later)

    • cortex_300000V: High-resolution cortex surface that was generated by FreeSurfer, that contains usually between 200,000 and 300,000 vertices.This one appears in green, it means that is going to be used as the default by the processes that require a cortex surface.

    • cortex_15000V: Low-resolution cortex surface, downsampled using the reducepatch function from Matlab (it keeps a meaningful subset of vertices from the original surface).

    • white_300000V: High-resolution white matter envelope from FreeSurfer

    • white_15000V: Low-resolution white matter, processed with reducepatch

    • aseg atlas: Atlas of subcortical regions

12. A figure is automatically shown at the end of the process, to check visually that the low-resolution cortex and head surfaces were properly generated and imported. If it doesn't look like the following picture, do not go any further in your source analysis, fix the anatomy first.
    
    
    
    

Handling errors

How to check the quality of the result

It's hard to estimate what would be a good cortical reconstruction. What you are trying to spot at this level is mostly the obvious errors, like when the early stages of the brain extraction didn't perform well, just with a visual inspection. Play with the Smooth slider in the Surface tab. If it looks like a brain (two separate hemispheres) in both smooth and original views, it is probably ok.

Display the cortex surface on top of the MRI slices, to make sure that they are well aligned, that the surface follows well the folds, and that left and right were not flipped: right-click on the low-resolution cortex > MRI registration > Check MRI/surface registration...

The cortex looks bad

It is critical to get a good cortex surface for source estimation. If the final cortex surface looks bad, it means that something didn't work well somewhere along the FreeSurfer pipeline. You can refer to the following page to fix the problems manually:
http://surfer.nmr.mgh.harvard.edu/fswiki/RecommendedReconstruction

If after following those instructions you still don't manage to get good surfaces, you can try to run the automatic MRI segmentation from BrainVISA or BrainSuite.

The head surface looks bad

It is not mandatory to have a perfect head surface to use any of the Brainstorm features: you don't necessarily have to recognize the face (for the anonymity of the figures, it can be even better if you don't).

The head surface is important mostly for the alignment of the MEG sensors and the MRI. If you digitized the head shape with a Polhemus device, you can align automatically the head surface (hence the MRI) with the MEG sensors (in the same referential as the Polhemus points). The quality of this automatic registrations depends on the quality of both surfaces: the Polhemus head shape (green points) and the head surface from the MRI (grey surface). If you placed lots of points on the nose but your head surface doesn't have a nose, those points are not going to help. Except for that, a nice head shape is mainly useful for producing nicer figures.

If the default head surface looks bad, you can try generating another one: right-click on the subject folder > Generate head surface. The options are:

• Number of vertices: Number of points that are kept from the initial isosurface computed from the MRI. Increasing this number may increase the quality of the final surface.

• Erode factor: Number of pixels to erode after the first binary threshold of the MRI. Increasing this number removes small components that are connected to the head.

• Fill holes factor: Number of dimensions in which the holes should be identified and closed. Increasing this number removes more of the cavities of the head surface (0=no correction, 1=removes holes inside the surface, 3=closes all the features that make the surface non-convex)
  
  

Mixing FreeSurfer and BrainVISA

You can mix the surfaces generated by BrainVISA and FreeSurfer, for instance if you want to use the cortex surface from FreeSurfer and the head surface from BrainVISA, but you have to be very careful as the conventions used by the two software packages are different. First of all, the T1.mgz in FreeSurfer is not the original MRI, it is re-aligned an normalized volume. If you want to mix the two software or compare their results:

1. Start with running the FreeSurfer segmentation,

2. Then process the FreeSurfer T1.mgz MRI and with BrainVISA

If BrainVISA crashes when importing the file T1.mgz, you can use Brainstorm to convert from MGZ to NIfTI:

1. Import the T1.mgz MRI in Brainstorm (right-click on subject > Import MRI)

2. Export it as a NIfTI file (right-click on MRI > File > Export to file > set the file format to "MRI: NIfTI (*.nii)")

Subcortical structures: aseg atlas

Cortical parcellations

The default analysis pipeline in FreeSurfer implements an automatic parcellation of the cortical surface in anatomical regions. The description of this feature is available here:
http://freesurfer.net/fswiki/CorticalParcellation

Those atlases are imported in Brainstorm as scouts (cortical regions of interest), and saved directly in the surface files. To check where they are saved: right-click on the low-resolution cortex file > File > View .mat file. You can see that 4 structures "Atlas" are available, the first one that has Name='User scouts', and the second one Name='Destrieux'.

To access them from the interface:

1. Double-click on the low-resolution cortex (works with the high-resolution too, it's just longer to display)

2. Go to the Scout tab, and click on the drop-down list to select another Atlas (ie group of scouts):

   • Destrieux atlas (*.aparc.a2009s.annot)
   • Desikan-Killiany atlas (*.aparc.annot)
   • Some Brodman areas (*.BA.annot)

Examples

Desikan-Killiany atlas, in FreeSurfer:

Desikan-Killiany atlas, in Brainstorm:

Desikan-Killiany atlas, in Brainstorm after downsampling to 15000 vertices:

Parcellations for the default anatomy (MNI/Colin27)

The FreeSurfer cortex and white matter surfaces are available in the standard distribution of Brainstorm, they come with the all the FreeSurfer parcellations. You can use those surfaces instead of the default Brainstorm ones, which are created with BrainVISA, which do not include the Desikan-Killiany and Destrieux atlases.

1. In any protocol, go to the anatomy view, and select the "Default anatomy" folder.
   
   

2. If you do not see the surfaces "FreeSurfer: cortex *" and "FreeSurfer: white *", your protocol is not using the most recent version of the Brainstorm default anatomy. To update:

   • Make sure you are running the latest version of Brainstorm

   • Right-click on "Default anatomy" > Use default > MNI_Colin27

   • Close the MRI Viewer when it opens. Now you should see all the FreeSurfer surfaces

3. Make one of the FreeSurfer surfaces as your default cortex surface (for instance, the downsampled grey/csf interface):

   • Right-click on "FreeSurfer: cortex 15000V" > Set surface type > Cortex

   • Right-click on the top "cortex" file > Set surface type > Other (this is not necessary, but it avoids ambiguity)

   • To make sure that everything is updated properly: Right-click on "Default anatomy" > Reload
     
     

4. Double-click on the new default cortex (FreeSurfer: cortex 15000V) to open it

5. In the "Scout" tab, you should now have access to the three default FreeSurfer atlases: Brodmann, Desikan-Killiany, Destrieux.

6. You can now run source analysis (computation forward and inverse models) using this new cortex surface, and use the FreeSurfer atlases as regions of interest.

Feedback