-------------------------------------------
 SubjectsTools -> Back Compat Curv/3d
 SubjectsTools -> Undo Back Compat Curv
 SubjectsTools -> Forward Compat 3d
 SubjectsTools -> Undo Forward Compat 3d
-------------------------------------------
MGH freesurfer changed the data
formats for curvature and sulcus files
({rh,lh}.{curv,sulc}: 2-byte => 4-byte) and 3D
files (directories containing COR files ->
single-file *.mgz files).  These menu items
support basic forward and backward compatibility
between the old and new formats.

#########################################
 N.B.: No longer needed because csurf0.8 (and
 FreeSurfer0.8) now read curr MGH volume,
 curvature formats (as well as older formats)
#########################################

Back Compat Curv/3d 

If a subject's surface has been reconstructed
using new freesurfer and you want to view it
with this older distribution, copy the subject
into a $SUBJECTS_DIR, select the subject, and use
"Back Compat Curv/3d" to generate the new format
curvature files and 3d files.

For 3d files, the new format files (*.mgz files)
are left in place and old format files
(directories containing single-byte, single slice
COR- files) are regenerated alongside them.

For curvature files, new format (4 byte) files
are moved aside to {rh,lh}.{curv,sulc}FLOAT and
old style (2 byte) files are generated from the
4 bytes files.  Re-run OK.

Undo Back Compat Curv

To restore the new format curvature and
sulcus files, this menu item moves the
old format curvature and sulcus files to
{rh,lh}.{curv,sulc}OLD and restores the
new format files to their original names:
{rh,lh}.{curv,sulc}.  The 3d files are not
touched.  Re-run OK.

Forward Compat 3d

Current MGH freesurfer has a bug that prevents
it from reading COR format files (faulty path
manipulation relating to COR-.info file).
To work around this bug, click this menu item
for a subject before operating on it with MGH
freesurfer.

New format *.mgz files are generated from
COR file directories, and then the COR file
directories are moved aside to <dir>COR to
prevent new freesurfer from finding them (and
failing before it looks for *.mgz files).

The following files are generated and renamed:

Generated:

  orig/COR-*    =>  orig.mgz
  T1/COR-*      =>  T1.mgz
  brain/COR-*   =>  brain.mgz
  wm/COR-*      =>  wm.mgz
  filled/COR-*  =>  filled.mgz

Renamed/Moved-aside:

  orig/COR-*    =>  origCOR/COR-*
  T1/COR-*      =>  T1COR/COR-*
  brain/COR-*   =>  brainCOR/COR-*
  wm/COR-*      =>  wmCOR/COR-*
  filled/COR-*  =>  filledCOR/COR-*

Re-run OK (asks choice of whether to write
over *.mgz file -- e.g., if COR files have been
re-made and need to be re-exported).

Undo Forward Compat 3d

To undo the renaming of the COR file directories
use this menu item.  The *.mgz files generated by
a previous "Forward Compat 3d" will not be
touched.  Re-run OK.  Note that FreeSurfer0.8 can
now directly read *.mgz files.

