|
Size: 3899
Comment:
|
Size: 2533
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| == Unpacking FreeSurfer == | [wiki:Self:FreeSurferWiki top] | [wiki:Self:Installation previous] | [wiki:Self:SetupConfiguration next] |
| Line 3: | Line 3: |
| The distribution consists of the following files which can either be downloaded from http://surfer.nmr.mgh.harvard.edu or obtained from a CDROM. |
== FreeSurfer Linux Installation == |
| Line 7: | Line 5: |
| If you downloaded the distribution, unpack the tarball with this command: |
1. Obtain a license key from http://surfer.nmr.mgh.harvard.edu/registration.html or from a previous installation. If you are using a previous installation, the license file is found in the main freesurfer directory and is called '.license'. |
| Line 10: | Line 7: |
| `tar zxvf <the-file-you-downloaded>` | 2. cd to the directory just above where you want !FreeSurfer to be installed (the ParentDir). You will need about 1G of space on this disk partition. |
| Line 12: | Line 9: |
| This will create a directory called freesurfer, which will henceforth be referred to as DISTDIR. |
3. Enter the command (replacing 'freesurfer.tar.gz' with the actual filename downloaded): |
| Line 15: | Line 11: |
| If you are getting the files from a CDROM, the top level of the CDROM should have the following files in it. Use this directory as DISTDIR. |
`tar xvfz freesurfer.tar.gz` |
| Line 18: | Line 13: |
| In DISTDIR are the following files: | This will create a directory called freesurfer, in which will be the following files: |
| Line 20: | Line 15: |
| `INSTALL` -- this file [[BR]] `license.freesurfer` -- license agreement [[BR]] `freesurfer.tar.gz` -- FreeSurfer tree[[BR]] |
`INSTALL` -- this file[[BR]] `license.freesurfer` -- license agreement[[BR]] `freesurfer.tar.gz` -- !FreeSurfer tree[[BR]] |
| Line 24: | Line 19: |
| `minc.tar.gz` -- MNI MINC tools/binaries[[BR]] `bert.raw.tar.gz` -- FreeSurfer tutorial data[[BR]] `bert.func.tar.gz` -- FreeSurfer functional tutorial data[[BR]] `bert.recon.tar.gz` -- reconstructed FreeSurfer tutorial data[[BR]] |
`bert.raw.tar.gz` -- !FreeSurfer tutorial data[[BR]] `bert.func.tar.gz` -- !FreeSurfer functional tutorial data[[BR]] `bert.recon.tar.gz` -- reconstructed !FreeSurfer tutorial data[[BR]] |
| Line 30: | Line 24: |
| == To install FreeSurfer from tar files == 1. Obtain a license key from http://surfer.nmr.mgh.harvard.edu/download.html or from a previous installation. If you are using a previous installation, the license file should be freesurfer/.license. 2. cd to the directory just above where you want FreeSurfer to be installed (the ParentDir). You will need about 1G of space on this disk partition. 3. Enter the command: `tar xvfz DISTDIR/freesurfer.tar.gz` This will create a directory called freesurfer. 4. The default subjects directory (the directory in which your subjects' data will be placed) is freesurfer/subjects. You may wish set to up your installation differently, e.g. if you have a large external hard drive you want to use for subject data. See below for details. Regardless, cd into your subjects directory and enter the commands: |
4. The default subjects directory (the directory in which your subjects' data will be placed) is freesurfer/subjects. You may wish set to up your installation differently, e.g. if you have a large external hard drive you want to use for subject data. See the [wiki:Self:SetupConfiguration 'Setup and Configuration'] section for details. Regardless, cd into your subjects directory (the default is called 'subjects', located within the freesurfer installation directory) and enter the commands: |
| Line 45: | Line 27: |
| `tar xvfz DISTDIR/bert.recon.tar.gz` | `tar xvfz DISTDIR/bert.recon.tar.gz`[[BR]] `tar xvfz DISTDIR/talairach.tar.gz` |
| Line 47: | Line 30: |
| This will populate your subjects directory with 'average7', and the FS tutorial's sample data set 'bert'. | This will populate your subjects directory with 'average7', the sample data set 'bert', and the MINC atlas subject 'talairach'. |
| Line 51: | Line 34: |
| FreeSurfer uses some of the tools developed at the Montreal Neurological Institue (MNI) (http://www.bic.mni.mcgill.ca) to align antomical volumes (using minctracc) and to compute the Talairach transform (using mritotal). You must have the MNI tools installed to be able to access this functionality through FreeSurfer. | !FreeSurfer uses some of the tools developed at the Montreal Neurological Institue (MNI) (http://www.bic.mni.mcgill.ca) to align antomical volumes (using minctracc) and to compute the Talairach transform (using mritotal). You must have the MNI tools installed to be able to access this functionality through !FreeSurfer. |
| Line 53: | Line 36: |
| The tools can be downloaded and installed directly from the MNI. As a service to our users, we also offer binaries for the MNI tools. Unfortunately, once the MNI binaries have been created, they will not work unless they are located in the same directory where they were compiled. Accordingly, if you want to install the binaries we supply, you will have to put them in the same place we put them. Also, perl must be in the same place as on our system. === To install our binaries === 1. Create a symbolic link to your perl in the location that matches ours. Execute the following commands. Note that you may need to execute some of them with root permission; su to root, use sudo, or talk to your system administrator. `cd /usr`[[BR]] `mkdir -p pubsw/bin`[[BR]] `cd pubsw/bin`[[BR]] `ln -s `which perl` perl`[[BR]] 2. Untar the MNI binaries and place them into the proper location. Execute the following commands: `cd /usr/pubsw`[[BR]] `mkdir -p packages`[[BR]] `cd packages`[[BR]] `tar xvfz DISTDIR/minc.tar.gz` === Install MNI talairach subject === Those not using the functional stream can skip this step. 1. cd to your subjects directory and enter the following command: `tar xvfz DISTDIR/talairach.tar.gz` This will create a directory called talairach. |
Refer to the file ftp://surfer.nmr.mgh.harvard.edu/pub/dist/mni.srcbuild.README.txt for more information on building the MINC toolkit from the source code. |
[wiki:FreeSurferWiki top] | [wiki:Installation previous] | [wiki:SetupConfiguration next]
FreeSurfer Linux Installation
1. Obtain a license key from http://surfer.nmr.mgh.harvard.edu/registration.html or from a previous installation. If you are using a previous installation, the license file is found in the main freesurfer directory and is called '.license'.
2. cd to the directory just above where you want FreeSurfer to be installed (the ParentDir). You will need about 1G of space on this disk partition.
3. Enter the command (replacing 'freesurfer.tar.gz' with the actual filename downloaded):
tar xvfz freesurfer.tar.gz
This will create a directory called freesurfer, in which will be the following files:
INSTALL -- this fileBR license.freesurfer -- license agreementBR freesurfer.tar.gz -- FreeSurfer treeBR talairach.tar.gz -- MNI 305 talairach brainBR bert.raw.tar.gz -- FreeSurfer tutorial dataBR bert.func.tar.gz -- FreeSurfer functional tutorial dataBR bert.recon.tar.gz -- reconstructed FreeSurfer tutorial dataBR average7.tar.gz -- contains average labels for checking spherical morphBR
4. The default subjects directory (the directory in which your subjects' data will be placed) is freesurfer/subjects. You may wish set to up your installation differently, e.g. if you have a large external hard drive you want to use for subject data. See the [wiki:SetupConfiguration 'Setup and Configuration'] section for details. Regardless, cd into your subjects directory (the default is called 'subjects', located within the freesurfer installation directory) and enter the commands:
tar xvfz DISTDIR/average7.tar.gz BR tar xvfz DISTDIR/bert.recon.tar.gzBR tar xvfz DISTDIR/talairach.tar.gz
This will populate your subjects directory with 'average7', the sample data set 'bert', and the MINC atlas subject 'talairach'.
MINC installation
FreeSurfer uses some of the tools developed at the Montreal Neurological Institue (MNI) (http://www.bic.mni.mcgill.ca) to align antomical volumes (using minctracc) and to compute the Talairach transform (using mritotal). You must have the MNI tools installed to be able to access this functionality through FreeSurfer.
Refer to the file ftp://surfer.nmr.mgh.harvard.edu/pub/dist/mni.srcbuild.README.txt for more information on building the MINC toolkit from the source code.