Differences between revisions 7 and 8
Deletions are marked like this. Additions are marked like this.
Line 23: Line 23:
If you haven't done so already, [[Registration|obtain a license]], and copy the .license file to your $FREESURFER_HOME directory (e.g. /Applications/freesurfer). In theory, this simple task could be done with !TextEdit which already exists on Mac systems, but !TextEdit is a horrible program with a few bugs that actually prevents the user from being able to create a simple file called '''.license'''. So the next best way to do this is to download and install the small text editing program [[https://wiki.gnome.org/Apps/Gedit|gedit]]. Download and install gedit, open it (Applications -> gedit), copy the contents of the email into gedit, and save it to a file in your home directory called '''.license'''

{{attachment:gedit_save.png}}

Permission issues will probably prevent you from saving to the '''Applications/freesurfer''' directory. In this case, your next best option is to save the '''.license''' file to you home directory, then use the terminal to manually copy it from your home directory, to the '''Application/freesurfer''' directory. Once you save the '''.license''' file to your home directory, open a terminal and issue the following command:
If you haven't done so already, [[Registration|obtain a license]], and copy the license text from the email and create a file called '''license.txt''' in your $FREESURFER_HOME directory (e.g. /Applications/freesurfer). Permission issues will probably prevent you from saving to the '''Applications/freesurfer''' directory. In this case, your next best option is to save the '''license.txt''' file to you home directory, then use the terminal to manually copy it from your home directory, to the '''Application/freesurfer''' directory. Once you save the '''license.txt''' file to your home directory, open a terminal and issue the following command:
Line 30: Line 26:
sudo cp ~/.license /Applications/freesurfer sudo cp ~/license.txt /Applications/freesurfer
Line 34: Line 30:
Ultimately, the goal is simply to get a file called '''.license''' with the contents of the email, into the /Applications/freesurfer directory. This can be done with gedit, vim, emacs, or countless other simple text editors. Ultimately, the goal is simply to get a file called '''license.txt''' with the contents of the email, into the /Applications/freesurfer directory. This can be done with gedit, vim, emacs, or countless other simple text editors.

top | previous | next

FreeSurfer Setup and Configuration

Basic setup

To start using FreeSurfer, open a Terminal window by going to Finder then clicking Application -> Utilities -> Terminal. In order to load FreeSurfer you will need to type the following commands into the terminal window:

export FREESURFER_HOME=/Applications/freesurfer
source $FREESURFER_HOME/SetUpFreeSurfer.sh

You have the option of either typing those commands everytime you open a new terminal window OR adding those two lines somewhere in the .profile file in your home directory (If you don't already have a .profile file in your home directory, you can go ahead and create one). If you choose the latter method, FreeSurfer will load everytime you open a new terminal window and you won't have to type the two commands above. Regardless of the method you choose, once FreeSurfer is loaded, the terminal window should display some basic information and appear similar to the snapshot below.

terminal.png

The file Application/freesurfer/SetUpFreeSurfer.sh is a bash script that will configure the environment so that FreeSurfer can be used. It sets a few environment variables, sources other shell scripts to set up support libraries, and performs some checks that need to be passed before FreeSurfer can start. This file needs to be 'sourced' before running any FreeSurfer binaries.

License

If you haven't done so already, obtain a license, and copy the license text from the email and create a file called license.txt in your $FREESURFER_HOME directory (e.g. /Applications/freesurfer). Permission issues will probably prevent you from saving to the Applications/freesurfer directory. In this case, your next best option is to save the license.txt file to you home directory, then use the terminal to manually copy it from your home directory, to the Application/freesurfer directory. Once you save the license.txt file to your home directory, open a terminal and issue the following command:

sudo cp ~/license.txt /Applications/freesurfer

You will be prompted for your password.

Ultimately, the goal is simply to get a file called license.txt with the contents of the email, into the /Applications/freesurfer directory. This can be done with gedit, vim, emacs, or countless other simple text editors.

Optional configuration settings

The defaults declared in the SetUpFreeSurfer.sh script should work for most installations. However, users should free to edit this file to customize certain environment variables:

1. Your declaration of the FREESURFER_HOME variable could be moved within the SetUpFreeSurfer.sh script.

2. The default SUBJECTS_DIR, which is $FREESURFER_HOME/subjects, is most likely the first variable that you will want to customize, as you may keep different groups of subjects in different directories. You may include the following either directly in the SetUpFreeSurfer.sh script, or prior to calling it:

  • export SUBJECTS_DIR=<full path to subject dir>

3. If you do NOT intend to use the functional tools, then add the following line to the additional configuration section:

  • export=NO_FSFAST

If you do intend to use the functional tools, then add these lines to your ~/matlab/startup.m file:

  • fsfasthome = getenv('FSFAST_HOME');
    fsfasttoolbox = sprintf('%s/toolbox',fsfasthome);
    path(path,fsfasttoolbox);

4. You may also wish to declare a path to an FSL installation you might have (required for TRACULA):

  • export FSL_DIR=/usr/local/fsl

5. Save the file. You will need to source this file (SetUpFreeSurfer.sh) every time you want to use !Freesurfer.

Optional removal of third-party packages

Freesurfer includes in its distribution several third-party open-sourced packages which are required for Freesurfer to fully function. The distributed packages have not been modified from their source origins, so it is possible to delete the distributed package if an equivalent package is already installed on your system. Please be aware that the packages distributed with Freesurfer have been tested for compatibility with its tools.

The distributed packages, their version, and location are listed here:

Package

Version

$FREESURFER_HOME Location

MNI

1.4*

/mni

Tcl/Tk/Tix/BLT

8.4.6**

/lib/tcltktixblt

*refers to MINC version **refers to Tcl/Tk version

To use a prior installed package, just move or delete the Freesurfer directory containing the package, and replace with a symbolic link to your own package. For instance, assuming an MNI toolkit is already installed in /usr/local/mni:

cd $FREESURFER_HOME
mv mni mni-backup
ln -s /usr/local/mni mni

The FreeSurferEnv.sh setup script will now point to those tools.

Testing FreeSurfer

Next: testing your FreeSurfer installation.

SetupConfiguration_Mac (last edited 2014-09-03 12:45:30 by ZekeKaufman)