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

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

    Model Coupling Toolkit (MCT)

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

    See MCT/COPYRIGHT for license.

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

  This is version 2.2.0 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.

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:

  IBM (AIX) xlf
  SGI (IRIX64) f90 MIPSpro 
  SGI Altix
  SUN (Solaris) f90 WorkShop
  Compaq  Compaq Fortran Compiler (X5.5-2801-48CAG or later)
  Cray X1
  Linux: Portland Group, Intel, g95, Absoft, Pathscale, Lahey, NAG
     NOTE:  In general, Intel version 8.1 and later have no problems.
      Some earlier versions generated internal compiler errors.
      See the MCT homepage for more information.
  NEC
  Fujitsu

  Running the examples requires a parallel platform.
  Memory requirements are reasonable.

######################################################################
  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 F90=pgf90. 

  You can also direct configure through environment variables:
    > setenv F90 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)


######################################################################
  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



Tag $Name: MCT_2_2_0 $
$Id: README,v 1.21 2005/12/01 18:35:02 jacob Exp $

