Diff for "FreeSurferForMartinosUsers"

Differences between revisions 7 and 8

FreeSurfer can be accessed from any Linux computer on the Martinos network. This page will show you how to access the FreeSurfer program and points you towards some tutorials to help learn how to use it.

Accessing FreeSurfer

First, consider if you need access to the stable or development version of FreeSurfer. If you are not sure, you probably want to use the stable version. The development version contains new and untested features.

For whichever version you want, copy and paste a command below into your terminal:

Stable:

source /usr/local/freesurfer/nmr-stable60-env

Development:

source /usr/local/freesurfer/nmr-dev-env

To ensure that worked, type freeview into the command prompt, press enter, and see if FreeView opened. FreeView is a tool that comes with FreeSurfer - it lets you look at the data FreeSurfer creates along with many other files common to MRI research.

Processing your first subject

If you have data you would like to process with FreeSurfer, you can do so using the command recon-all. An example of how to run this command is below:

recon-all -all -i <one slice in the anatomical dicom series> -s <subject id that you make up>

Things to note:

-all will run all the steps in the FreeSurfer processing stream. Alternatively, you can run different parts of the stream.
-i stands for input. Here, you would specify one dicom file/slice in the MPRAGE scan series you collected (FreeSurfer will find the rest of the slices automatically). You could also specify nifti files as input. If you have more than one MPRAGE or input for a given subject, use another -i flag for each one.
-s specifies the name of the subject and will create a directory with that name for all the subject's FreeSurfer output.

The process is complete when the last line printed to the screen (and in the recon-all.log found in the subject's scripts directory) says "recon-all exited without errors". If you run into errors, search the mailing list for help or follow the steps in BugReporting.

Learning how to use FreeSurfer

Here is a recommended way to get up to speed on using FreeSurfer:

If you are not familiar with using a Unix terminal, watch this video: https://www.youtube.com/watch?v=6eJMxh7PlOY
Here is a link to online versions of a FreeSurfer course: https://surfer.nmr.mgh.harvard.edu/fswiki/FsTutorial
- Each lecture has a corresponding video found here: https://www.youtube.com/channel/UCruQerP8aa-gYttXkAcyveA
- To get a basic understanding of FreeSurfer it is recommended to go through all course material up to and including "Quality Checking a Recon". From there you can complete the rest to explore different specific functions of FreeSurfer, or select tutorials related to the research you plan to do.

General Linux Help

Examples of scripts and aliases that can make it easier to source, use, and process with FreeSurfer can be found here.
Some basic information on text editors can be found here.

Need help?

There is a wealth of knowledge here on the FSWiki. On the top right hand corner is a search bar - be sure to press the Text option when searching, it offers more results than Topic.
Other resources include an online support archive, see here for more details: https://surfer.nmr.mgh.harvard.edu/fswiki/FreeSurferSupport

Deletions are marked like this.	Additions are marked like this.
Line 19:	Line 19:
	== Processing your first subject == If you have data you would like to process with FreeSurfer, you can do so using the command recon-all. An example of how to run this command is below: {{{ recon-all -all -i <one slice in the anatomical dicom series> -s <subject id that you make up> }}} Things to note: * -all will run all the steps in the FreeSurfer processing stream. Alternatively, you can run different parts of the stream. * -i stands for input. Here, you would specify one dicom file/slice in the MPRAGE scan series you collected (FreeSurfer will find the rest of the slices automatically). You could also specify nifti files as input. If you have more than one MPRAGE or input for a given subject, use another -i flag for each one. * -s specifies the name of the subject and will create a directory with that name for all the subject's FreeSurfer output. The process is complete when the last line printed to the screen (and in the recon-all.log found in the subject's scripts directory) says "recon-all exited without errors". If you run into errors, search the mailing list for help or follow the steps in BugReporting.