###################################################################### -- Argonne National Laboratory Model Coupling Toolkit (MCT) Robert Jacob Jay Larson Everest Ong Ray Loy For more information, see http://www.mcs.anl.gov/mct See MCT/LICENSE for license. ###################################################################### This is version 2.10 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 LICENSE -- 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. NO LONGER SUPPORTED ###################################################################### REQUIREMENTS: Building MCT requires a Fortran90 compiler. A full 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) NEC Fujitsu Running some of the examples requires a full MPI installation with mpirun 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, use: > ./configure FC=bgxlf90_r CC=mpixlc_r MPIFC=mpixlf90_r (can also use versions without _r) ###################################################################### 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 included in the MCT source and available from: http://gmao.gsfc.nasa.gov/software/protex/ 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 05 Jul, 2012 -- version 2.8.1 (not released) 12 Sep, 2012 -- version 2.8.2 (not released) 16 Dec, 2012 -- version 2.8.3 19 Jun, 2015 -- version 2.9.0 19 Apr, 2018 -- version 2.10.0 11 Feb, 2021 -- version 2.11.0