Deletions are marked like this. | Additions are marked like this. |
Line 3: | Line 3: |
Follow the instructions below for running the [[FsTutorial|freesurfer tutorials]]. These instruction are valid for both Mac OSX and Linux platforms (freesurfer is not available on Windows platform). | Follow the instructions below for running the [[FsTutorial|FreeSurfer tutorials]]. These instruction are valid for both Mac OSX and Linux platforms (FreeSurfer is not available on Windows platform). |
Line 5: | Line 5: |
''Please note, some experience with the command line (Terminal) is required to successfully install and run freesurfer. If you do not have previous experience with the command line, and you are setting up your computer in preparation for the freesurfer course, it is probably best to simply attempt to install freesurfer, and download the tutorial data onto your machine, then wait till after the first freesurfer course presentation [[http://surfer.nmr.mgh.harvard.edu/pub/docs/unix_jargon_ani.ppt|Unix Tutorial for FreeSurfer Users]] until you start running the tutorials on your own machine.'' | ''Please note, some experience with the command line (Terminal) is required to successfully install and run FreeSurfer. If you do not have previous experience with the command line, and you are setting up your computer in preparation for the FreeSurfer course, it is probably best to simply attempt to install FreeSurfer, and download the tutorial data onto your machine, then wait till after the first FreeSurfer course presentation [[http://surfer.nmr.mgh.harvard.edu/pub/docs/unix_jargon_ani.ppt|Unix Tutorial for FreeSurfer Users]] until you start running the tutorials on your own machine.'' |
Line 7: | Line 7: |
=== 1. Install freesurfer === | === 1. Install FreeSurfer === |
Line 9: | Line 9: |
The first step is to install freesurfer on your personal machine. To install freesurfer, follow the instructions on | The first step is to install FreeSurfer on your personal machine. To install FreeSurfer, follow the instructions on |
Line 12: | Line 12: |
''Please note, the tutorials require users to have the "development version" of freesurfer installed. So when it comes time to select the version for download do NOT select version 5.3, download the "development version" instead, which can be found [[ftp://surfer.nmr.mgh.harvard.edu/pub/dist/freesurfer/dev/|on this page]].'' | ''Please note, the tutorials require users to have the "development version" of FreeSurfer installed. So when it comes time to select the version for download do NOT select version 5.3, download the "development version" instead, which can be found [[ftp://surfer.nmr.mgh.harvard.edu/pub/dist/freesurfer/dev/|on this page]].'' |
Line 17: | Line 17: |
Before continuing, please ensure you have a functioning freesurfer installation by running the test commands on the [[https://surfer.nmr.mgh.harvard.edu/fswiki/TestingFreeSurfer| testing freesurfer installation]] page. It would be pointless to continue otherwise. If you are having issues running the test commands, please follow the instructions on the [[https://surfer.nmr.mgh.harvard.edu/fswiki/SetupConfiguration|Setup and Configuaration page]]. | Before continuing, please ensure you have a functioning FreeSurfer installation by running the test commands on the [[https://surfer.nmr.mgh.harvard.edu/fswiki/TestingFreeSurfer| testing Freesurfer installation]] page. It would be pointless to continue otherwise. If you are having issues running the test commands, please follow the instructions on the [[https://surfer.nmr.mgh.harvard.edu/fswiki/SetupConfiguration|Setup and Configuaration page]]. |
Line 20: | Line 20: |
Once you have a functioning freesurfer installation, it is time to download the freesurfer tutorial data set [[ftp://surfer.nmr.mgh.harvard.edu/pub/data/tutorial_data.tar.gz|tutorial_data.tar.gz]]. When the download completes you will want to extract its contents. This can be done on most operating systems by simply double-clicking the file. '''''REMEMBER THE LOCATION OF THE EXTRACTED CONTENTS''''', you will need to set an an environment variable called '''TUTORIAL_DATA''', set to this this directory, in order to do the tutorials. Its content should look as follows: | Once you have a functioning Freesurfer installation, it is time to download the FreeSurfer tutorial data set [[ftp://surfer.nmr.mgh.harvard.edu/pub/data/tutorial_data.tar.gz|tutorial_data.tar.gz]]. When the download completes you will want to extract its contents. This can be done on most operating systems by simply double-clicking the file. '''''REMEMBER THE LOCATION OF THE EXTRACTED CONTENTS''''', you will need to set an an environment variable called '''TUTORIAL_DATA''', set to this this directory, in order to do the tutorials. Its content should look as follows: |
Line 26: | Line 26: |
Configuring your freesurfer installation for the tutorials requires one simple step, sourcing freesurfer and setting the '''TUTORIAL_DATA''' environment variable (setting it to the location of the extracted file from above). Continuing with the example from above, the steps below show the commands to type AFTER sourcing freesurfer. If you type the {{{ls $TUTORIAL_DATA}}} command and see the directories extracted in step #2, you are ready to begin the [[FsTutorial|freesurfer tutorials]]. | Configuring your FreeSurfer installation for the tutorials requires one simple step, sourcing FreeSurfer and setting the '''TUTORIAL_DATA''' environment variable (setting it to the location of the extracted file from above). Continuing with the example from above, the steps below show the commands to type AFTER sourcing FreeSurfer. If you type the {{{ls $TUTORIAL_DATA}}} command and see the directories extracted in step #2, you are ready to begin the [[FsTutorial|freesurfer tutorials]]. |
FreeSurfer Tutorial Data set
Follow the instructions below for running the FreeSurfer tutorials. These instruction are valid for both Mac OSX and Linux platforms (FreeSurfer is not available on Windows platform).
Please note, some experience with the command line (Terminal) is required to successfully install and run FreeSurfer. If you do not have previous experience with the command line, and you are setting up your computer in preparation for the FreeSurfer course, it is probably best to simply attempt to install FreeSurfer, and download the tutorial data onto your machine, then wait till after the first FreeSurfer course presentation Unix Tutorial for FreeSurfer Users until you start running the tutorials on your own machine.
1. Install FreeSurfer
The first step is to install FreeSurfer on your personal machine. To install FreeSurfer, follow the instructions on the download and installation page.
Please note, the tutorials require users to have the "development version" of FreeSurfer installed. So when it comes time to select the version for download do NOT select version 5.3, download the "development version" instead, which can be found on this page.
2. Download tutorial data
Before continuing, please ensure you have a functioning FreeSurfer installation by running the test commands on the testing Freesurfer installation page. It would be pointless to continue otherwise. If you are having issues running the test commands, please follow the instructions on the Setup and Configuaration page.
Once you have a functioning Freesurfer installation, it is time to download the FreeSurfer tutorial data set tutorial_data.tar.gz. When the download completes you will want to extract its contents. This can be done on most operating systems by simply double-clicking the file. REMEMBER THE LOCATION OF THE EXTRACTED CONTENTS, you will need to set an an environment variable called TUTORIAL_DATA, set to this this directory, in order to do the tutorials. Its content should look as follows:
3. Configure your system
Configuring your FreeSurfer installation for the tutorials requires one simple step, sourcing FreeSurfer and setting the TUTORIAL_DATA environment variable (setting it to the location of the extracted file from above). Continuing with the example from above, the steps below show the commands to type AFTER sourcing FreeSurfer. If you type the ls $TUTORIAL_DATA command and see the directories extracted in step #2, you are ready to begin the freesurfer tutorials.
$> export TUTORIAL_DATA=/Users/localzeke/Downloads/tutorial_data $> ls $TUTORIAL_DATA buckner_data fsfast-functional diffusion_recons fsfast-tutorial.subjects diffusion_tutorial long-tutorial