FreeSurfer Release Notes

These Release Notes cover what's new in a release, and known issues.

See also DownloadAndInstall, and BugReporting.

Stable v4.1.0

14 Oct 2008

Stable release version 4.1.0 is a minor release containing bug fixes.

What's New

Bug fixes:
- Problems with the longitudinal analysis stream (affecting recon-all, mri_ca_label, mri_ca_register, and FSL's flirt) have been fixed. Refer to the help text output from recon-all -help for new usage instructions of the longitudinal stream.
- mri_segstats and mris_wm_volume bugs fixed. Users of the ?h-cerebral-white-matter stats in the aseg.stats and wmparc.stats files should re-run recon-all -segstats -wmstats.
- mris_make_surfaces problem causing a 'spike' feature in the pial surface in the insula has been fixed.

Known issues

aparcstats2table bug: if some of the subjects in a group have missing values of a certain label, aparcstats2table fails to designate a 0 for them, leaving the number of columns for that subject short by one (or specifically, by the number of missing labels relative to the other subjects), thereby making the table nearly useless. there is no workaround. a fix should appear in the next release.
aseg.stats/wmparc.stats problem: structure volumes, such as hippocampus, are reported as being about 2% smaller in wmparc.stats compared to the same structure in aseg.stats. the difference is due to differing partial-voluming compensation methods. a fix will appear in the next release. the values in aseg.stats are the correct values.

Stable v4.0.5

15 June 2008

Stable release version 4.0.5 is a new feature and bug fix release.

What's New

New features:
- Now supports Gifti v1.0 surface format read and write (.gii file extension) for exchanging surface files with Caret, AFNI, BrainVisa, BrainVoyager and Vistrails.
- Updated Qdec v1.1: has aseg/aparc stats tables import; miscellaneous user features.
- New volume and surface viewing app: freeview (beta). Note: freeview is not yet available for the Mac.
Bug fixes:
- Qdec now uses VTK v5.0 instead of v5.1, to fix the problem with message: "TclTk error: invalid command name "vtkTemp349"

Known issues

Same issues as v4.0.4
Bug in mri_segstats: some input data exposes a problem which results in a huge (GB) recon-all.log file, and incorrect results for ?h-cerebral-white-matter in the wmparc.stats file. this bug will be fixed in the next release.
It is possible for a 'spike' to appear in the pial surface near the insula, like this image, in some subject data. A fix for mris_make_surfaces will appear in the next release.
White matter parcellation (mris_wm_volume) bug:
- isthmus cingulate segmentation appears between thalamus and pallidum.
- parahippocampal segmentation appears next to ventralDC.
- white matter extending into cortex (affects 4.0.3 and 4.0.4).
- ASeg.stats: white matter volume way too low.
- A fix for mris_wm_volume will appear in the next release.
A bug in the longitudinal analysis stream has been found. A fix will appear in the next release.

Stable v4.0.4

6 May 2008

Stable release version 4.0.4 is a bug fix release.

What's New

Bug fixes:
- The tksurfer bug, where the text on the color-scalebar, and the caption text, may not appear, or appear dim, has been fixed.
- The tksurfer bug, where it can exit with an error 'alloc: invalid block' when an overlay is loaded, has been fixed.
- The recon-all -localGI bugs have been fixed.

Known issues

mris_make_surfaces can let the pial surface extend inward toward the insular cortex in cases where the extreme capsule is so thin that no voxels are labeled as white matter (and no significant gm/wm contrast boundary exists). There is no work-around.
The qdec app produces a 'Bad Match' error when started on some Linux platforms. The work-around is to add this to your /etc/X11/xorg.conf file:

Section "Extensions"
   Option "Composite" "false"
EndSection

Input data having a FOV greater than 256 will fail in the -autorecon2 stage during mri_fill, because the wm.mgz file is 256³ while the norm.mgz and aseg.mgz files are FOV³ (where FOV > 256). The work-around is to use the --cropsize256 flag with recon-all with -autorecon1.
The surface files ?h.volume are not produced by recon-all yet, but are mentioned in mris_preproc. Production of the ?h.volume files by recon-all (calculating ?h.area * ?h.thickness) will be available in a future release.

Stable v4.0.3

31 March 2008

Stable release version 4.0.3 is a bug fix and new feature release.

What's New

Bug fixes:
- The -log option of mris_anatomical_stats was fixed.
- In qdec, the problem where a popup window appeared containing the message 'FsgdfPlot_IsWindowShowing' has been fixed.
- The problem where make_average_subject failed with the message 'Cannot allocate memory' has been fixed.
- The mri_ca_register and mri_ca_label segfault bug on the Mac OS has been fixed.
- In tkmedit, the problem where the cursor goes to the wrong location when tal coords are entered has been fixed.
- mris_preproc fixed: can now transform multiple volumes from the same subject.
New features:
- Updated qdec, now allows saving/loading a project data file.
- A new option, -lGI, will calculate a local gyrification index. See localGI.
- New Brodmann area labels for the 'fsaverage' subject. See BA Maps.
- talairach_with_skull.lta generation is now robust in presence of increased background noise levels.

Known issues

mris_make_surfaces can let the pial surface extend inward toward the insular cortex in cases where the extreme capsule is so thin that no voxels are labeled as white matter (and no significant gm/wm contrast boundary exists). There is no work-around.
The qdec app produces a 'Bad Match' error when started on some Linux platforms. The work-around is to add this to your /etc/X11/xorg.conf file:

Section "Extensions"
   Option "Composite" "false"
EndSection

Input data having a FOV greater than 256 will fail in the -autorecon2 stage during mri_fill, because the wm.mgz file is 256³ while the norm.mgz and aseg.mgz files are FOV³ (where FOV > 256). The work-around is to use the --cropsize256 flag with recon-all with -autorecon1.
The surface files ?h.volume are not produced by recon-all yet, but are mentioned in mris_preproc. Production of the ?h.volume files by recon-all (calculating ?h.area * ?h.thickness) will be available in a future release.
In tksurfer, the text on the color-scalebar, and the caption text, may not appear, or appear dim. A fix for this will appear in the next release. There is no work-around.
The -localGI feature is broken, in particular, the mris_fill utility. The effect is a shifted filled.mgz relative to the true surfaces. A fix will appear in the next release.
tksurfer can exit with an error 'alloc: invalid block' when an overlay is loaded. A fix will appear in the next release.

Stable v4.0.2

16 December 2007

Stable release version 4.0.2 is a bug fix and new feature release.

What's New

Bug fixes:
- Fixed mris_flatten bug where the map did not unfold properly.
- Fixed unpacksdcmdir (mri_convert) issue, string: "syngo MR B15".
- Fixed bug where mri_fill might fail with the message "could not find any points where lh and rh wm are nbrs".
- mris_thickness_diff and mris_surface_stats now properly handle .mgh file io.
New features:
- Improved -tal-check option, for checking the Talairach alignment.
- The FSL package is no longer included in the distribution (except for the binary 'flirt', found in freesurfer/bin).

Known issues

mris_make_surfaces can let the pial surface extend inward toward the insular cortex in cases where the extreme capsule is so thin that no voxels are labeled as white matter (and no significant gm/wm contrast boundary exists). There is no work-around.
The qdec app produces a 'Bad Match' error when started on some Linux platforms. The work-around is to setenv XLIB_SKIP_ARGB_VISUALS 1 if using tcsh, or export XLIB_SKIP_ARGB_VISUALS=1 if using bash.
Input data having a FOV greater than 256 will fail in the -autorecon2 stage during mri_fill, because the wm.mgz file is 256³ while the norm.mgz and aseg.mgz files are FOV³ (where FOV > 256). The work-around is to use the --cropsize256 flag with recon-all with -autorecon1.
The surface files ?h.volume are not produced by recon-all yet, but are mentioned in mris_preproc. Production of the ?h.volume files by recon-all (calculating ?h.area * ?h.thickness) will be available in a future release.
The -log option of mris_anatomical_stats does not work. A fix will appear in the next release.
In qdec, a popup window containing the message 'FsgdfPlot_IsWindowShowing' may appear. To fix this, copy this script to your $FREESURFER_HOME/lib/tcl directory: attachment:fsgdfPlot.tcl . This fix will appear in the next release.
make_average_subject can fail with the message 'Cannot allocate memory'. A fix will appear in the next release.
mri_ca_register and mri_ca_label can segfault on the Mac OS. A fix will appear in the next release.
In tkmedit, when tal coords are entered, the cursor goes to the wrong location. A fix will appear in the next release.
mris_preproc, when transforming multiple volumes from the same subject, each file converted overwrites the previous. A fix will appear in the next release.

Stable v4.0.1

18 September 2007

Stable release version 4.0.1 is a bug fix release.

What's New

Bug fixes:
- Fixed seg-faulting mri_convert in unpacksdcmdir.
- Fixed tkmedit problem whereby volume display after loading talairach.xfm was incorrect.
- Fixed seg-faulting mris_annot_to_segmentation.
- Fixed tksurfer problem whereby curvature and overlay displays could not be turned off.
- Fixed qdec problem where the display could be hidden on small screens (now has scroll bars).
- Updated spatialsmooth-sess such that it no longer uses FSL's 'ip' binary.

Known issues

When making flatmaps with mris_flatten, sometimes the map never unfolds properly (where there can be a section where it folds over itself). The fix for this bug will appear in a future release.
The qdec app produces a 'Bad Match' error when started on some Linux platforms. The work-around is to setenv XLIB_SKIP_ARGB_VISUALS 1 if using tcsh, or export XLIB_SKIP_ARGB_VISUALS=1 if using bash.
Input data having a FOV greater than 256 will fail in the -autorecon2 stage during mri_fill, because the wm.mgz file is 256³ while the norm.mgz and aseg.mgz files are FOV³ (where FOV > 256). The work-around is to use the --cropsize256 flag with recon-all with -autorecon1.
The surface files ?h.volume are not produced by recon-all yet, but are mentioned in mris_preproc. Production of the ?h.volume files by recon-all (calculating ?h.area * ?h.thickness) will be available in a future release.
mris_make_surfaces will let a surface in callosal regions extend across midline in some cases. This bug will be fixed in the next release. There is no work-around.
unpacksdcmdir (mri_convert) issue: "ERROR: incorrectly formatted version string syngo MR B15". A fix for this problem will appear in the next release.
The -tal-check option for checking the Talairach alignment step does not always catch failures. An improved checker will appear in the next release.
mri_fill might fail with the message "could not find any points where lh and rh wm are nbrs". A fix will appear in the next release.

Stable v4.0.0

21 August 2007

Stable release version 4.0.0 is a major release with new features and bug fixes.

What's New

New features:
- The corpus callosum is now segmented into five separate labels in the subcortical segmentation volume 'aseg.mgz'
- White matter is now parcellated for gyral regions
- mris_wm_volume - calculates the total white matter volume
- Improved talairach alignment, with automatic failure detection
- Improved atlas-based skull-strip
- Longitudinal analysis (recon-all -long, see help section in recon-all --help)
- Qdec - group analysis GUI tool
- DTI recon stream: see dt_recon --help, also new: dmri_poistats (see --help) Linux Centos only
- FSFast:
  - Full NIFTI compliance
  - mkanalysis GUI -- set up analysis AND contrasts
  - selxavg3-sess -- now replaces stxgrinder, implicit intensity normalization, better whitening
  - tksurfer-sess -- replaces paint-sess and surf-sess
  - tkmedit-sess -- accepts multiple contrasts
  - isxconcat-sess + mri_glmfit -- intersubject averaging (RFx, FFx, weighted RFx), replaces func2sph-sess, func2tal-sess, and isxavg-??-sess, GRF
  - No longer needed: stxgrinder-sess, paint-sess, func2sph, fun2tal, isxavg-??, mkcontrast, inorm-sess
- Average subject subcortical segmentation
- Updated numerics libraries (NRC and GSL replaced by VXL), paving the way for an open-source release.
Bug fixes:
- Corrected midline parcellation (during cortical parcellation, areas of the anterior cingulate cortex (rostral anterior cingulate in the parcellation atlas), were mislabeled as corpus callosum or "unlabeled subcortical")
- Corrected aseg: removal of grey matter around callosum
- Corrected average subject surface area
- Corrected problem with average subject thickness generation (mismatched number of vertices)
- Corrected problem with mris_anatomical_stats, where incorrect results were reported for the measures 'average integrated rectified mean curvature', 'average integrated rectified Gaussian curvature', 'folding index', and 'intrinsic curvature index'.

Known issues

When using unpacksdcmdir, mri_convert will fail with a segmentation fault. A fix will appear in the next release.
In tkmedit, the displayed volume after loading the talairach.xfm file is not correct. The work-around is to either load the talairach.lta file, or use tkregister2 instead. This will be fixed in the next release.
mris_annot_to_segmentation may segfault. A fixed version will appear in the next release.
In tksurfer, if you have both curvature and an overlay loaded, and you turn both off, the overlay stays on. This will be fixed in the next release.
When making flatmaps with mris_flatten, sometimes the map never unfolds properly (where there can be a section where it folds over itself). The fix for this bug will appear in a future release.
In qdec, the Analyze button can be hidden on small screens. This will be fixed in the next release.
The qdec app produces a 'Bad Match' error when started on some Linux platforms. There is no work-around at this time.
Input data having a FOV greater than 256 will fail in the -autorecon2 stage during mri_fill, because the wm.mgz file is 256³ while the norm.mgz and aseg.mgz files are FOV³ (where FOV > 256). The work-around is to use the --cropsize256 flag with recon-all with -autorecon1.
The surface files ?h.volume are not produced by recon-all yet, but are mentioned in mris_preproc. Production of the ?h.volume files by recon-all (calculating ?h.area * ?h.thickness) will be available in a future release.

Stable v3.0.5

7 Feb 2007

Stable release version 3.0.5 is a bug-fix release.

What's New

Bug fixes:
- Fixed bug in NIFTI reader in FreeSurfer (see details below in v3.0.4 Known Issues).
- Fixed bug in 'unpacksdcmdir' and 'mri_convert' commands on the Intel Mac distribution.
- Fixed bug in recon-all such that now xopts is correctly processed by mri_nu_correct.mni.

Known Issues

Input data having a FOV greater than 256 will fail in the -autorecon2 stage during mri_fill, because the wm.mgz file is 256³ while the norm.mgz and aseg.mgz files are FOV³ (where FOV > 256). The work-around is to use the --cropsize option of mri_convert (see its --help for details) to convert the orig.mgz file to 256³.
During cortical parcellation, areas of the anterior cingulate cortex (rostral anterior cingulate in the parcellation atlas), are mislabelled as corpus callosum or "unlabelled subcortical". A fix for this is in the works, possibly for the next release.
When making flatmaps with mris_flatten, sometimes the map never unfolds properly (where there can be a section where it folds over itself). The fix for this bug will appear in a future release.
On the Mac, make_average_subject (and make_average_volume and make_average_surface) will fail if more than 252 subjects are specified. The work-around is to type 'limit descriptors unlimited' before running these scripts. A fix will appear in the next release.
mris_anatomical_stats, as executed by recon-all, reports incorrect results for the measures 'average integrated rectified mean curvature', 'average integrated rectified Gaussian curvature', 'folding index', and 'intrinsic curvature index'. The other reported measures ('total white matter volume', 'total surface area', 'total gray matter volume' and 'average cortical thickness') are correct as reported by recon-all's execution of mris_anatomical_stats. There is no work-around. A fix will appear in the next release.

Stable v3.0.4

25 Nov 2006

Stable release version 3.0.4 is a bug-fix release.

What's New

Bug fixes:
- Fixed problem with left hemi of fsaverage subject (see v3.0.3 Known Issues, below, for details).
- Fixed bug whereby the pial surface can cross the midline in the cingulate/callosum area to the other hemisphere. The change [attachment:bert-medial-wall-diffs.tiff affects this area].
- Fixed 'glutInit' bug occuring on Fedora Core and Debian Linux installations using tksurfer.
- Fixed bug in mri_normalize which core dumped for low SNR input volumes.
- Fixed bug in tksurfer with "Don't cross functional threshold" parameter.
- Fixed problem with public declaration of Tcl/Tk/Tix/BLT environment variables which caused problems with FSL and 3D Slicer.
New features:
- Label file named <subjid>/label/?h.cortex.label is a single label for all of cortex.

Known Issues

Input data having a FOV greater than 256 will fail in the -autorecon2 stage during mri_fill, because the wm.mgz file is 256³ while the norm.mgz and aseg.mgz files are FOV³ (where FOV > 256). The work-around is to use the --cropsize option of mri_convert (see its --help for details) to convert the orig.mgz file to 256³.
The 'unpacksdcmdir' command, and 'mri_convert' of some DICOM formatted data, will fail on the Intel Mac distribution v3.0.4, due to a byte-endian issue. The v3.0.4b distribution has a fix for these problems.
recon-all does not process xopts for mri_nu_correct.mni. The fix will appear in the next release.
There is a small bug in the NIFTI reader in FreeSurfer, which causes the sform/qfrom matrix to be slightly off for oblique volumes that are non-isotropic (the more oblique and the more non-isotropic, the worse). Part of the error involves the matrix being slightly non-orthogonal. The fix for this bug will appear in the next release. There is NO effect of this bug if any of the following apply:
1. You use mri_convert to convert from DICOM (or any other non-NIFTI format) to NIFTI
2. Your volumes are not oblique
3. Your volumes are isotropic
During cortical parcellation, areas of the anterior cingulate cortex (rostral anterior cingulate in the parcellation atlas), are mislabelled as corpus callosum or "unlabelled subcortical". A fix for this is in the works, possibly for the next release.
When making flatmaps with mris_flatten, sometimes the map never unfolds properly (where there can be a section where it folds over itself). The fix for this bug will appear in a future release.

Stable v3.0.3

24 May 2006

Stable release version 3.0.3 is a bug-fix and feature-addition release.

What's New

Bug fixes:
- Fixed a bug in tksurfer in which if an overlay and the curvature was loaded, the curvature would draw under the overlay even if the curvature display was turned off.
- Modified the way NIFTI1 files are stored (these are the single .nii and .nii.gz files). The change is somewhat esoteric: the vox_offset is now 352 instead of 348. 352 is the NIFTI spec, so we were technically out of compliance before, although AFNI, FSL, and SPM did not seem to have a problem with 348.
- Fixed bug in make_average_surface and make_average_volume scripts which limited the number of subjects that could be specified on the command line.
New features:
- asegstats2table and aparcstats2table - scripts to generate text/ascii tables of freesurfer stats data (eg, aseg.stats). This can then be easily imported into a stats program.

Known Issues

In tksurfer, if using the -fthresh option, specify the number as a float (-fthresh 2.0) not an integer (don't use -fthresh 2).
There is a problem with the left hemi of the fsaverage subject, specifically lh.sphere.reg. This will cause some inaccuracies in the visualization of maps on the left hemi of fsaverage and other average subjects (but the statistics themselves should be ok). The corrected lh.sphere.reg for fsaverage will be included in the next release. Or, if you have an average subject that you want to correct, you do not have to rebuild it. Rather, you can simply:

cd youraveragesubject/surf
cp lh.sphere.reg lh.sphere.reg.old # backup
cp rh.sphere.reg lh.sphere.reg # copy rh.sphere to lh.sphere

There is a bug whereby the pial surface can cross the midline in the cingulate/callosum area to the other hemisphere. There is no workaround. The bug will be fixed in the next release. This change will [attachment:bert-medial-wall-diffs.tiff affect this area].
tksurfer will fail on Fedora Core and Debian Linux installations which use freeglut, as 'glutInit' is not executed. This bug will be fixed in the next release.
mri_normalize may core dump for low SNR input volumes. This bug will be fixed in the next release.
In tksurfer, fills that use the "Don't cross functional threshold" parameter do not correctly fill negative functional areas. This bug will be fixed in the next release (v3.0.4).
Tcl/Tk/Tix/BLT environment variables declared in freesurfer setup file causes problems with other apps, like FSL and 3D Slicer. This problem will be fixed in the next release. The workaround is to not call the Freesurfer setup script when using the other apps.

Stable v3.0.2

18 April 2006

Stable release version 3.0.2 is a bug-fix and feature-addition release.

What's New

Bug fixes:
- The --all-info or --version command-line corrupting bug has been fixed.
- The mris_fix_topology mrisDefectAnalysis bug has been fixed.
- The bug where control points were being truncated instead of rounded by mri_normalize, which could offset them by 1 voxel, has been fixed.
- The bug where curvature was being computed incorrectly for RH9 binaries has been fixed (affected spherical morph, and curvature overlay).
- eTIV calculations are now correct (they were ~25% too large, specifically, multiply pre v3.0.2 eTIV values by .744 to get the correct eTIV).
- mri_label2vol - fixed bug for segmentation IDs over 999. Runs much faster now.
New features:
- bem directory is created in subjects dir (for the MEG people)
- Better integration with FSL (compatible with FSL-nifti)
- Uses robust estimates of class statistics in mri_normalize, mri_segment and mris_make_surfaces. Helps in low contrast (such as SPGR-based) images in which the gray matter is oversegmented.

Known Issues

None at this time.

Stable v3.0.1

13 March 2006

Stable release version 3.0.1 is a bug-fix release.

What's New

FIX_VERTEX_AREA no longer need be set in the environment outside of recon-all.
In tkmedit, while loading a functional overlay or time course, the registration file name is now read properly.
The FSFast utility mkanalysis-sess.new now accepts only sequence names matching "TR " (instead of all occurrences of TR).

Known Issues

When running mri_surfcluster with average7 inside your csd file, make sure to specify --subject average7 --really-use-average7 or else it will underestimate the clustersize and cause the significances to be too low.
mris_fix_topology may exit recon-all with the following message in the log: mrisDefectAnalysis : defect 123 overlap defect 119, where your defect numbers will be different. If this happens for one of your subjects, there is no work-around. A fix will appear in the next release.
If the flags --all-info or --version are included at the beginning of a command-line, it will corrupt the subsequent command-line arguments. The work-around is to not include --all-info or --version with other command-line arguments. A fix will appear in the next release.
On the rh9 distribution, sometimes the ?h.curv files produced are incorrect, displaying as nearly all red (instead of green and red, indicating gyri and sulci). This produces incorrect cortical parcellation data. There is no known work-around at this time. This problem does not appear when using the Centos or Mac distributions.
tkmedit saves control points for intensity normalization in floating point RAS coordinates, but mri_normalize truncated these when they are read in with the -f command (the default behavior when the tmp/control.dat file exists). This can result in the control points being displaced by a voxel from the location that tkmedit displays them.
mri_label_volume estimated TIV calculation are about 25% too large. This will be fixed in the next release.
Be sure to read about the changes to recon-all, detailed below, and also read about the new fsaverage subject.

Stable v3.0

5 March 2006

Stable release version 3.0 is a major release containing many new features over the prior stable release (version 2.2).

Important! The recon-all script has been updated. Please read the ReconAllChanges page which describes these changes! Users of prior 'dev' releases should also take note of the changes.

COR file format is no longer accepted by recon-all. mgz file's have replaced this old format.
brainmask.mgz has replaced what was the brain volume. You should visualize and make all edits to brainmask.mgz and not to brain.mgz
recon-all will now save all your changes by default. Any manual changes/edits to the talairach, setting of control points, edits to volumes etc will be saved and used by default and you must specify when you wish to ignore these changes.
Data processed with an older release should make use of the -legacy flag in recon-all.

What's New

Sub-cortical segmentation - Each MRI volume voxel is assigned one of 37 possible neuroanatomical labels, including left and and right caudate, putamen, pallidum, thalamus, lateral ventricles, hippocampus, and amygdala. The labeling allows for volumetric measurement of these structures. The segmentation information also improves the ability to create a filled white-matter volume.
Automated filling of ventricles and basal ganglia - Improves the ability to create a filled white-matter volume (which is used in the surface creation process). Note: this requires the use of the new average subject fsaverage because the surface registration changes.
Improved automation - The need to conduct manual edits to account for skull-stripping and cutting-plane problems is reduced. The topology fixer is much better at handling temporal lobe strands. Overall, greater than 90% of hemispheres processed by recon-all do not require manual intervention.
Improved GUI tools - The GUI tools tkmedit and tksurfer incorporate many usability improvements requested by the user-base.
New cortical parcellation - A neuroanatomical label is assigned to each location on the cortical surface model based on probabilistic information estimated from a manually labeled training set.
Surface-based GLM analysis - Utilities for conducting group analysis studies with GLM.
Multiple comparison correction for surface analysis - False discovery rate (FDR), permutation and Monte Carlo simulations.
New average subject. $FREESURFER_HOME/subjects/fsaverage. Keeps info about average surface area.
Average subject customization. Make your own average subject from your cohort.
Extensive testing - The recon-all processing stream has been tested against several hundred subjects, different pulse-sequence types, and different MRI system platforms.
Online tutorial of the Freesurfer work-flow - This release is compatible with the on-line tutorial. Tutorial data must be downloaded separately.
Simplified distribution download and installation - The critical library and toolkit dependencies (MNI, FSL, GSL, Tcl/Tk/Tix/BLT, and Qt) are included to ease installation. These third-party open-sourced packages can be removed if they are already installed on the target system (although full Freesurfer functionality is no longer assured). For Mac OS X, a GUI installation package is provided.
Compatible with all mouse pads
Now Y2K compliant!

Known Issues

Make sure to run "setenv FIX_VERTEX_AREA" if using any commands outside of recon-all, particularly the mri_glmfit and mri_surfcluster programs. To be safe, you can just add the line "setenv FIX_VERTEX_AREA" into FreeSurferEnv.csh or your .cshrc file. This will only affect those downloading the new version. This will automatically be done for those in the Martinos Center.
In tkmedit, while loading a functional overlay or time course, the registration file name may not be read properly. A workaround is to load the overlay or time course from the command line (see tkmedit for details).
The surface registration curvature target has changed with the new automatic filling of ventricles and basal ganglia. Do not mix newly reconstructed subjects with those that used the old target. For new data recons, display overlay maps on the new average subject fsaverage. For older data, use average7.
There are some changes in the way that mri_surfcluster and mri_glmfit computes cluster sizes and how these interact with the average subject (and average7) see the notes fsaverage for more detail.