Difference between revisions of "Freesurfer"

Latest revision as of 20:09, 12 August 2022

Description

Freesurfer is a set of automated tools for reconstruction of the brain’s cortical surface from structural MRI data, and overlay of functional MRI data onto the reconstructed surface.

Environment Modules

Run module spider freesurfer to find out what environment modules are available for this application.

System Variables

HPC_FREESURFER_DIR - installation directory

Additional Information

Starting with freesurfer/6.0.0 the software is available as a Singularity container. To run any executable use the 'launch_freesurfer' wrapper after loading the module.

E.g.

launch_freesurfer dcmunpack

NOTE:

Freesurfer comes with Freeview software. Freeview is a completely separate software from Freesurfer and is used purely for data visualization. Freesurfer 6 includes Freeview 2.0.

Citation

If you publish research that uses freesurfer you have to cite it as follows:

See [1] in the Freesurfer wiki on how to correctly cite Freesurfer tools.

@@ Line 1: / Line 1: @@
-[[Category:Software]][[Category:Bioinformatics]][[Category:Neurology]][[Category:Neuroimaging]]
+[[Category:Software]][[Category:Neuroscience]][[Category:Biology]][[Category:Imaging]]
 {|<!--CONFIGURATION: REQUIRED-->
 |{{#vardefine:app|freesurfer}}
@@ Line 19: / Line 19: @@
 Freesurfer is a set of automated tools for reconstruction of the brain’s cortical surface from structural MRI data, and overlay of functional MRI data onto the reconstructed surface.<!--Modules-->
-==Required Modules==
+==Environment Modules==
-===Serial===
+Run <code>module spider {{#var:app}}</code> to find out what environment modules are available for this application.
-* {{#var:app}}
-<!--
-===Parallel (OpenMP)===
-* intel
-* {{#var:app}}
-===Parallel (MPI)===
-* intel
-* openmpi
-* {{#var:app}}
--->
 ==System Variables==
-* HPC_{{#uppercase:{{#var:app}}}}_DIR and FREESURFER_HOME - installation directory
+* HPC_{{uc:{{#var:app}}}}_DIR - installation directory
-* HPC_FREESURFER_BIN - executable directory
-===Freesurfer configuration variables===
-The following variables are preset by the {{#var:app}} module:
-* SUBJECTS_DIR
-* FUNCTIONALS_DIR
-* FSFAST_HOME
-* MNI_DIR
-===Matlab configuration===
-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);
-or load the ''freesurfer'' module and run
- source $HPC_FREESURFER_DIR/SetUpFreeSurfer.sh
 <!--Configuration-->
 {{#if: {{#var: conf}}|==Configuration==
@@ Line 53: / Line 30: @@
 <!--Run-->
 {{#if: {{#var: exe}}|==Additional Information==
-If you encounter a NVIDIA video driver compatibility issue with FreeView try the following workaround.
+Starting with freesurfer/6.0.0 the software is available as a Singularity container. To run any executable use the 'launch_freesurfer' wrapper after loading the module.
+E.g.
+ launch_freesurfer dcmunpack
+'''NOTE:'''
-The freeview program uses OpenGL extensions, which appear to be driver-dependent. If you're running freeview on gui.rc.ufl.edu or gui1.rc.ufl.edu you can get freeview to run within an 'xpra' session, which will handle GLX automatically.
+Freesurfer comes with Freeview software. Freeview is a completely separate software from Freesurfer and is used purely for data visualization. Freesurfer 6 includes Freeview 2.0.
-. Install Xpra on your client machine - see (https://www.xpra.org)
-. Log into gui or gui1 node and start freeview as follows:pick a random PORT number from 1000 to 50000
-For example, for user USERNAME and port 3223 we can do the following:
-<pre>
-$ module load freesurfer
-$ module unload python
-$ xpra start :PORT --start-child=freeview
-Example:
-$ xpra start :3223 --start-child=freeview
-. Attach to the xpra session from your local machine with
-$ xpra attach ssh:USERNAME@gui1.rc.ufl.edu:3223
-</pre>
-A freeview window should show up on your local desktop.
 |}}
 <!--PBS scripts-->