
The Computational Morphometry Toolkit
==========================================================================


Release Notes -- CMTK 2.1.0
===========================

This release of CMTK improves the consistency of the configuration, build, and
packaging options. It is the first release to be included with NeuroDebian.

Significant additions are:

- command line tool documentation in "man" format

- support for mosaic DICOM files produced by Siemens MR scanners

- automatic deduction of fixed/moving image paths in "fview" GUI tool

- option to build with "cmtk" wrapper script and install all actual
  executables in a private binary directory.

For a complete list of changes and fixes, see the CHANGELOG file.


CMTK has been built and tested on the following platforms:

- Linux 32bit (Fedora 16), gcc 4.6.2
- Linux 64bit (Fedora 15), gcc 4.6.1, CUDA 3.2
- Linux, i386, Oracle Solaris Studio 12.2 C++ 5.11 2010/08/13
- MacOSX 10.6, x86_64, gcc 4.2.1, CUDA 3.2
- MacOSX 10.6, x86_64, llvm-gcc-4.2.1
- MacOSX 10.6, x86_64, clang 2.0
- Cygwin, gcc 4.3.4
- Windows XP, VisualStudio 9 (2008 Express Edition), CUDA 3.2
- Windows XP, VisualStudio 10SP1 (2010 Express Edition), CUDA 4.0
- OpenSolaris 11 Express, SunStudio 12.1, i386 (CC 5.10)
- OpenSolaris 11 Express, SunStudio 12.1, x86_64 (CC 5.10)
- OpenSolaris 11 Express, Oracle/SunStudio 12.2, x86_64


Platform-Specific Issues
========================


MacOS-X
-------

- Compilers on MacOS cannot build CMTK with shared libraries and OpenMP
  support enabled at the same time. This is due to an Apple bug and has
  nothing to do with CMTK per se. 

  http://www.nitrc.org/tracker/index.php?func=detail&aid=5451&group_id=212&atid=877

  Workaround: build CMTK with static libraries.


- Code coverage tests are only supported with gcc compiler and SDK 10.6. Older
  SDKs or the clang and llvm compiler front-ends do not support code coverage.

  http://www.nitrc.org/tracker/index.php?func=detail&aid=5450&group_id=212&atid=877


SolarisStudio Compiler, Linux/Intel
-----------------------------------

- SolarisStudio C++ 12.2 crashes when compiling the "Numerics" library with
  full optimization, -O3. A bug report has been filed with, and accepted by,
  Oracle:

  http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6989625

  Workaround: build "MinSizeRel" configuration, which sets optimization level
    to O2. Note that OpenMP must be disabled, because otherwise optimization
    is bumped back to O3 by default.


Open64 Compiler
---------------

- CMTK does not build in Release mode with the Open64 compiler due to internal
  compilar errors.

==========================================================================

This software is available from

  http://www.nitrc.org/projects/cmtk/

==========================================================================
