1 Notes on building VXL for MGH Freesurfer:
   2 
   3 Here is how v1.13.0 was installed:
   4 
   5   cd /usr/pubsw/packages/vxl
   6   mkdir 1.13.0
   7   ln -s 1.13.0 current
   8   cd current
   9   unzip <wherever>/vxl-1.13.0.zip 
  10   mv vxl-1.13.0 src
  11   cd src
  12   ccmake .
  13 
  14 <wherever> is the path to the source tarball,
  15 which can be found at:
  16 ftp://surfer.nmr.mgh.harvard.edu/pub/dist/fs_supportlibs/src
  17 or at the VXL homepage.
  18 
  19 ccmake brings-up the setup utility.  All BUILD_ packages 
  20 should be set to OFF, except for the VNL numerics and 
  21 utilities packages, and tests.  Static libs are built
  22 to spare the grief of dealing with LD_LIBRARY_PATH, but
  23 freesurfer does not prevent building and using shared libs 
  24 in a custom installation, like a laptop or home computer.
  25 The SSE instructions are used so that 32b platform results
  26 match those on the 64b platform (which uses SSE by default).
  27 The install path (CMAKE_INSTALL_PATH) is also updated. 
  28 So these are the things to check in the ccmake screen:
  29 
  30   BUILD_<something>	OFF, except for:
  31 
  32   BUILD_CORE_NUMERICS	  ON
  33   BUILD_CORE_UTILITIES	ON
  34   BUILD_SHARED_LIBS	    OFF
  35   BUILD_TESTING		      ON
  36   CMAKE_BUILT_TYPE      Release
  37   CMAKE_INSTALL_PREFIX	/usr/pubsw/packages/vxl/1.13.0
  38   CMAKE_CXX_FLAGS       -msse2 -mfpmath=sse
  39   CMAKE_C_FLAGS         -msse2 -mfpmath=sse
  40 
  41 Press 'c' a couple times, then 'g' to generate the 
  42 makefile.  Then:
  43 
  44   make
  45   make test
  46   make install
  47   make clean
  48   cd /usr/pubsw/packages/vxl
  49   ./fix_perms.csh
  50 
  51 All tests run during make test should pass (at least 
  52 they do on the Linux platform).  Some platforms, like
  53 Mac OS X 10.3.9, have problems building the tests, so
  54 those can be set to OFF (ie, re-run ccmake). make install 
  55 creates /lib /include and /share in CMAKE_INSTALL_PREFIX.
  56 make clean deletes the temporary build files.
  57 
  58 Running the fix_perms script, which exists only at the
  59 NMR center, ensures that permissions get reset to 
  60 where fsdev groups owns and can write all files.
  61 
  62 Nick
  63 1 March 2010