Differences between revisions 28 and 38 (spanning 10 versions)
Revision 28 as of 2016-06-26 22:34:26
Size: 2420
Editor: ZekeKaufman
Comment:
Revision 38 as of 2022-03-28 13:47:57
Size: 2214
Editor: AndrewHoopes
Comment:
Deletions are marked like this. Additions are marked like this.
Line 5: Line 5:
The InternalFreeSurferDistributions are 'stable' and 'dev'. Please see ReleasePolicy for information on the release policy for these distributions.
Line 8: Line 8:
Here are instructions on how to set-up your environment to use the InternalFreeSurferDistributions. Here are instructions on how to set-up your environment to use the Internal !FreeSurfer Distributions.
Line 10: Line 10:
All computers on the Martinos Center NMR network should have the directory '''/usr/local/freesurfer'''. Inside there, you will see the files '''nmr-stable53-env''' and '''nmr-dev-env'''. Sourcing these will set up your environment to use the stable or dev version, respectively. For example, to use the stable version, which is what most users should do, use the following setup command: The Internal !FreeSurfer Distributions are 'stable' and 'dev'. All computers on the Martinos Center NMR network should have the directory '''/usr/local/freesurfer'''. Inside there, you will see the file '''fsenv'''. Sourcing this will set up your environment to use the stable or dev versions. For example, to use the current stable version (7.2.0), which is what most users should do, use the following setup command:

'''Version 7.2.0:'''
{{{
$> source /usr/local/freesurfer/fsenv 7.2.0
}}}

'''dev:'''
{{{
$> source /usr/local/freesurfer/fsenv dev
}}}

'''NOTE:''' Do not put this command in your .cshrc or .bashrc file! If /usr/local/freesurfer is down for whatever reason, then your login will not work.

You should see your prompt change and your environment will be set up to run !FreeSurfer. Note that the programs may appear to be in a different location. That's OK, because {{{/usr/local/freesurfer}}} is actually a link to a platform specific version that resides in a different directory, much like how {{{/usr/pubsw}}} works. If you don't know what this means, don't worry.

Your {{{FREESURFER_HOME}}} will actually be {{{/usr/local/freesurfer/7.2.0}}} or {{{/usr/local/freesurfer/dev}}}, etc... so if you'd like to set {{{FREESURFER_HOME}}} manually and without changing your prompt, you can still do so:
Line 13: Line 29:
$ source /usr/local/freesurfer/nmr-stable53-env
}}}
## csh
$> setenv FREESURFER_HOME /usr/local/freesurfer/7.2.0
$> source $FREESURFER_HOME/SetUpFreesurfer.csh
Line 16: Line 33:
'''NOTE:''' Do not put this command in your .cshrc file! If /usr/local/freesurfer is down for whatever reason, then your login will not work.

You should see the prompt change to {{{(nmr-stable53-env)}}} and your environment should then be set up to run FreeSurfer. Note that the programs may appear to be in a different location:

{{{
$ which freeview
/space/freesurfer/centos6_x86_64/stable5_3_0/bin/freeview
}}}

That's OK, because {{{/usr/local/freesurfer}}} is actually a link to a platform specific version that resides in a different directory, much like how {{{/usr/pubsw}}} works. If you don't know what this means, don't worry.

Your {{{FREESURFER_HOME}}} will actually be {{{/usr/local/freesurfer/stable5_3_0}}} or {{{/usr/local/freesurfer/dev}}}, so if you'd like to set {{{FREESURFER_HOME}}} manually, you can still do so.

You can suppress output from sourcing these scripts with the {{{FS_FREESURFERENV_NO_OUTPUT}}} environment variable:

{{{
setenv FS_FREESURFERENV_NO_OUTPUT
}}}

You can keep the prompt from changing to {{{(nmr-stable53-env)}}} or {{{(nmr-dev-env)}}} by setting {{{FSENV_KEEP_PROMPT}}}:

{{{
setenv FSENV_KEEP_PROMPT
## bash
$> export FREESURFER_HOME=/usr/local/freesurfer/7.2.0
$> source $FREESURFER_HOME/SetUpFreesurfer.sh
Line 45: Line 42:

top

FreeSurfer Distributions for Internal Users

Distributions

Access

Here are instructions on how to set-up your environment to use the Internal FreeSurfer Distributions.

The Internal FreeSurfer Distributions are 'stable' and 'dev'. All computers on the Martinos Center NMR network should have the directory /usr/local/freesurfer. Inside there, you will see the file fsenv. Sourcing this will set up your environment to use the stable or dev versions. For example, to use the current stable version (7.2.0), which is what most users should do, use the following setup command:

Version 7.2.0:

$> source /usr/local/freesurfer/fsenv 7.2.0

dev:

$> source /usr/local/freesurfer/fsenv dev

NOTE: Do not put this command in your .cshrc or .bashrc file! If /usr/local/freesurfer is down for whatever reason, then your login will not work.

You should see your prompt change and your environment will be set up to run FreeSurfer. Note that the programs may appear to be in a different location. That's OK, because /usr/local/freesurfer is actually a link to a platform specific version that resides in a different directory, much like how /usr/pubsw works. If you don't know what this means, don't worry.

Your FREESURFER_HOME will actually be /usr/local/freesurfer/7.2.0 or /usr/local/freesurfer/dev, etc... so if you'd like to set FREESURFER_HOME manually and without changing your prompt, you can still do so:

## csh
$> setenv FREESURFER_HOME /usr/local/freesurfer/7.2.0
$> source $FREESURFER_HOME/SetUpFreesurfer.csh

## bash
$> export FREESURFER_HOME=/usr/local/freesurfer/7.2.0
$> source $FREESURFER_HOME/SetUpFreesurfer.sh

Frozen Version

Users are strongly encouraged to "Freeze" their copy of FreeSurfer in a project-specific directory like their SUBJECTS_DIR. To make a copy, just download the public distribution from ftp://surfer.nmr.mgh.harvard.edu/pub/dist/freesurfer

Obsolete Versions

There are the older versions that are still available for compatibility, see the Archives section of the public download page.

InternalFreeSurferDistributions (last edited 2022-03-28 13:47:57 by AndrewHoopes)