Use Test Cases
What are they?
The use test cases 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 use test cases routinely require large data files that are too cumbersome to be bundled with the ESMF distribution. They therefore must be checked out separately from the SourceForge repository.
Version Limitations
Tags for the use_test_cases module must match ESMF release tags, or you may get errors. The use test cases require ESMF releases of version 3.0.0 or later. See table below for specifics.
| Name | Description | Supported in ESMF Versions: |
|---|---|---|
| Bundle redistribution | Redistribution of data from one Bundle to another where the Grids are identical but Grid decompositions are different. | 300, 301, 302, 303 |
| Bundle redistribution: Arbitrarily distributed grids | Bundle redistribution from an arbitrarily distributed grid to another arbitrarily distributed grid. | 301, 302, 303 |
| Regrid | Coupled multi-component regridding between general curvilinear coordinate grids using array level sparse matrix multiplication | 303, 310-310p1, 310r-310rp1 |
| Sparse matrix multiply | Regrid between general curvilinear coordinate grids using Array level sparse matrix multiply | 300, 301, 302, 303, 310-310p1, 310r-310rp1 |
Checking Out
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. The command is (enter as one line):
cvs -z3 -d:pserver:anonymous@esmf.cvs.sourceforge.net:/cvsroot/esmf
co -P -r [tag] use_test_cases
where [tag] is the CVS tag.
Browse
Alternatively, the source can be viewed by browsing the use test cases folder.
Building and Running
To build and run the use test cases, see the READMEs bundled with the use_test_cases module.
