######################################################################

 -- Mathematics + Computer Science Div. / Argonne National Laboratory

    Model Coupling Toolkit (MCT)

    Jay Larson
    Robert Jacob
    Everest Ong
    Ray Loy
	
    For more information, see http://www.mcs.anl.gov/mct

    See MCT/COPYRIGHT for license.

######################################################################

  This is version 2.8 of the Model Coupling Toolkit (MCT).

  Our purpose in creating this toolkit is to support the construction
  of highly portable and extensible high-performance couplers 
  for distributed memory parallel coupled models.

######################################################################


  Current Contents of the directory MCT:

  README   -- this file

  COPYRIGHT - copyright statement and license.

  mct/     -- Source code for the Model Coupling Toolkit.

  mpeu/    -- Source code for the message-passing environment utilities
              library (MPEU), which provides support for MCT 

  mpi-serial/  -- Source code for optional mpi replacement library.

  examples/-- Source code for examples which demonstrate the use of MCT.

  doc/     -- documentation for MCT

  protex/  -- tool for constructing documentation from source code

  data/    -- input data for running example programs.  Not needed to
              compile the library.

  m4/      -- files for autoconf (not needed to build).

Optional Contents available

  babel/   -- multi language interface for MCT using BABEL.
              See babel/README for more information.

######################################################################
  REQUIREMENTS:

  Building MCT requires a Fortran90 compiler.

  An MPI library is now optional.  To compile without MPI, add
  --enable-mpiserial to the configure command below.  Note that
  not all the examples will work without MPI.  See mpi-serial/README
  for more information.


  The MCT library builds and the examples run on the following
  platforms/compilers:

  Linux: Portland Group, Intel, gfortran, Absoft, Pathscale, Lahey, NAG
  MacOSX: gfortran
  IBM (AIX) xlf
  IBM BlueGene (see PLATFORM NOTE below)
  SGI Altix
  Cray XT/XK
  Compaq  Compaq Fortran Compiler (X5.5-2801-48CAG or later)
  SUN (Solaris) f90 WorkShop
  NEC
  Fujitsu

  Running some of the examples requires a parallel platform.
  Memory requirements are modest.

######################################################################
  BUILD INSTRUCTIONS:

  In the top level directory (the location of this README):
	> ./configure
	> make

  "make examples" will build the example programs.

  BUILD HELP:
  Try "./configure -help"  for a list of options.

  The correct Fortran90 compiler must be in your current path.
  A frequent problem on Linux is when more than one F90 compiler
  is in your path and configure finds one and later finds mpif90
  for another.

  Example: If configure has trouble finding the correct F90 compiler:
    > ./configure FC=pgf90. 

  You can also direct configure through environment variables:
    > setenv FC xlf90
    > ./configure

  If the build fails, please do the following:
    > ./configure >& config.out
    > make >& make.out
  and send us config.out, make.out and config.log (which is produced by the
  configure command)

  PLATFORM NOTES:
  On a BlueGene/P, use:
  >  ./configure FC=bgxlf90_r CC=mpixlc_r MPIFC=mpixlf90_r (can also use versions without _r)
  At ALCF, one can just type "./configure".

  On the Cray X* (e.g. jaguar) use:
  > ./configure --host=Linux FC=ftn MPIFC=ftn 

######################################################################
  INSTALLATION INSTRUCTIONS:

  "make install" will copy the .mod files to the /usr/include directory
  and the *lib.a files to /usr/lib.   To override these choices, use
  "-prefix" when running configure:
       > ./configure --prefix=/home/$USER
  With the above option, "make install" will place .mod's in /home/$USER/include 
  and *lib.a's in /home/$USER/lib

######################################################################
  BUILDING AND RUNNING THE EXAMPLES

  The programs in MCT/examples/simple require no input.

  The programs in MCT/examples/climate_concur1 and MCT/examples/climate_sequen1
  require some input data in a directory called MCT/data.  The dataset is available with MCT
   or separately from the website.

  To build them, type "make examples" in the top level directory or
  cd to examples and type "make".

######################################################################

  Both MCT and MPEU source code are self-documenting.  All modules 
  and routines contain prologues that can be extracted and processed 
  into LaTeX source code by the public-domain tool ProTeX.  ProTeX is
  available by anonymous ftp from:

     Software:
      ftp://dao.gsfc.nasa.gov/pub/papers/sawyer/protex1.4.tar.Z 
     Documentation:
      ftp://dao.gsfc.nasa.gov/pub/office_notes/on9711r0.ps.Z 

  You can build the documentation with protex and latex by following
  the directions in the doc directory.

######################################################################

  REVISION HISTORY:

  18 Oct, 2000 -- Initial prototype
  09 Feb, 2001 -- working MxN transfer
  27 Apr, 2001 -- Sparse Matrix Multiply
  13 Jun, 2001 -- General Grid
  23 Aug, 2001 -- Linux PGF90 port
  14 Dec, 2001 -- PCM support
  29 Mar, 2002 -- Rearranger
  14 Nov, 2002 -- version 1.0.0 -- first public release
  11 Feb, 2003 -- version 1.0.4
  12 Mar, 2003 -- version 1.0.5
  02 Apr, 2003 -- version 1.0.7
  03 Jul, 2003 -- version 1.0.9
  26 Aug, 2003 -- version 1.0.12
  12 Sep, 2003 -- version 1.0.14
  21 Jan, 2004 -- version 1.4.0
  05 Feb, 2004 -- version 1.6.0
  23 Apr, 2004 -- version 2.0.0
  18 May, 2004 -- version 2.0.1
  11 Jul, 2004 -- version 2.0.2
  19 Oct, 2004 -- version 2.0.3 (not released)
  21 Jan, 2005 -- version 2.1.0
  01 Dec, 2005 -- version 2.2.0
  22 Apr, 2006 -- version 2.2.1 (not released)
  08 Sep, 2006 -- version 2.2.2
  16 Oct, 2006 -- version 2.2.3
  10 Jan, 2007 -- version 2.3.0
  17 Aug, 2007 -- version 2.4.0
  21 Nov, 2007 -- version 2.4.1
  20 Dec, 2007 -- version 2.4.2 (not released)
  21 Jan, 2008 -- version 2.4.3 (not released)
  28 Jan, 2008 -- version 2.5.0
  20 May, 2008 -- version 2.5.1
  05 Mar, 2009 -- version 2.6.0
  05 Jan, 2010 -- version 2.7.0 (released only in CCSM4)
  28 Feb, 2010 -- version 2.7.1 (released only in CESM1)
  30 Nov, 2010 -- version 2.7.2 (released only in CESM1.0.3)
  25 Jan, 2011 -- version 2.7.3 (not released)
  07 Mar, 2012 -- version 2.7.4 (not released)
  30 Apr, 2012 -- version 2.8.0 


Tag MCT_2_8_0
README,v 1.49 2012-04-27 21:52:58 jacob Exp

