Work at SourceForge, help us to make it a better place! We have an immediate need for a Support Technician in our San Francisco or Denver office.

Close

Tree [5f250c] master ESMF_7_0_0_beta_snapshot_08 ESMF_7_0_0_beta_snapshot_09 /
History



File Date Author Commit
ESMF_Arb2ArbGridRedist 2014-01-02 Silverio Vasquez Silverio Vasquez [44e8dc] Update Copyright date to 2014.
ESMF_AttributeCIM2ESG 2013-08-13 Gerhard Theurich Gerhard Theurich [345e5f] Another attempt to fix the UTC repo after Attri...
ESMF_BundleRedist 2014-01-02 Silverio Vasquez Silverio Vasquez [44e8dc] Update Copyright date to 2014.
ESMF_Regrid 2013-08-13 Gerhard Theurich Gerhard Theurich [345e5f] Another attempt to fix the UTC repo after Attri...
ESMF_SparseMatMul 2014-01-02 Silverio Vasquez Silverio Vasquez [44e8dc] Update Copyright date to 2014.
ESMF_StateBenchOps 2014-05-02 Walter Spector Walter Spector [9c1ffe] Fix allocation/deallocation issues.
ESMF_StateBenchReconcile 2014-05-03 Walter Spector Walter Spector [5f250c] Recode allocates to avoid SEGVs in StateBenchRe...
ESMF_StateReconcile 2014-04-28 Walter Spector Walter Spector [b0ee78] Fix memory leaks in ESMF_StateReconcile test.
ESMF_WaterML 2013-08-13 Gerhard Theurich Gerhard Theurich [345e5f] Another attempt to fix the UTC repo after Attri...
scripts 2013-04-23 Gerhard Theurich Gerhard Theurich [1f70f6] Cleanup $Id$ CVS strings.
README 2014-02-04 Gerhard Theurich Gerhard Theurich [587982] Bump the master into 7.0.0 beta snapshot phase.
makefile 2013-04-23 Gerhard Theurich Gerhard Theurich [1f70f6] Cleanup $Id$ CVS strings.

Read Me

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

           README:  USE TEST CASES
      REVISIONTAG:  ESMF_7_0_0

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

PURPOSE
The use test cases (UTCs) are examples of how ESMF functions would be 
implemented in realistic situations. They require realistic inputs and processor
counts. Unlike the unit and system tests, the UTCs routinely require large data
files that are too cumbersome to be bundled with the ESMF distribution,
necessitating that they must be checked out separately from the SourceForge
repository.

DOWNLOAD
The use_test_cases module can be obtained from the main ESMF SourceForge CVS
repository by following the instructions on that page for checking out modules
by the anonymous CVS access.

cvs -z3 -d:pserver:anonymous@esmf.cvs.sourceforge.net:/cvsroot/esmf co -P -rREVISIONTAG use_test_cases

REVISIONTAG
The above cvs command specifies a REVISIONTAG indicating the precise tag that
is downloaded. This REVISIONTAG must match the ESMF version you are using. For
instance, if you are using ESMF version 2.2.2r you must specify ESMF_2_2_2r as
the REVISIONTAG when downloading the UTC sources.

BUILDING AND RUNNING
The makefiles included in the UTC source tree are designed to link into the
ESMF library build system. For this integration to work seamlessly it is
required that the use_test_cases directory created by the above cvs command be
placed into the ESMF source tree under the ./src subdirectory. In case the
cvs command was not executed while in ./src the use_test_cases directory should
be moved into ./src before proceeding.

The integration of the UTC makefiles into the ESMF library build system
furthermore requires that the appropriate ESMF_ environment variables are set
prior to building or running the use test cases. Please consult the main ESMF
README and the ESMF User's Guide for details.

In addition to these common ESMF_ environment variables one further environment
variable exists that only applies to the execution of use test cases:
ESMF_MAX_PROCS - if set it will serve as the upper limit up to which 
processor count UTC targets will be run.

The UTC makefile targets are:
 use_test_cases         : build and run UTCs
 use_test_cases_uni     : build UTCs and run them in uni-processor mode
 build_use_test_cases   : build UTCs (don't run)
 run_use_test_cases     : run UTCs (don't build)
 run_use_test_cases_uni : run UTCs in uni-processor mode (don't build)
 clean_use_test_cases   : remove UTC executables only


================================================================================
$Id$