Test ESMF

Test ESMF with applications

An ESMF application can better test if ESMF is successfully installed and how ESMF works as a coupler.

ESMF coupled flow demonstration case

The coupled flow case and other demonstration cases can be found at:

https://www.earthsystemcog.org/projects/esmf/external_demos

The tutorials and introductions of the coupled flow case are:

  1. PDF: https://www.earthsystemcog.org/site_media/projects/esmf/ESMF_CoupledFlow.pdf

  2. html: http://www.earthsystemmodeling.org/users/training/tutorials_noheader/index.html

Compile the demonstration case

The demonstration case in our git repository is slightly different from the original one, because we have fixed the bug in the test case, modified the parameters in the simulations, and added a simple post-processing MATLAB code. The location of the demonstration case is: $PROJECT_DIR/esmf_test_application/esmf_test_coupled_flow, where PROJECT_DIR is the directory of the project.

  1. Compile ESMF with NetCDF and OpenMPI.

  2. In the command line, set the makefile of ESMF:

    export ESMFMKFILE=$ESMF_DIR/lib/libg/Linux.pgi.64.openmpi.default/esmf.mk

  3. Make the demonstration case:

    make

Run the demonstration case

To run the demonstration case in parallel:

mpirun -np 4 ESMF_CoupledFlow

The demonstration case generates a series of output files:

PET0.ESMF_LogFile - ESMF log file containing all error messages logged.
DE.nc             - NetCDF file containing decomposition element ids.
FLAG.nc           - NetCDF file containing flag of boundary conditions.
OMEGA.nc          - NetCDF file containing time series of vorticity.
SIE.nc            - NetCDF file containing time series of internal energy.
U_velocity.nc     - NetCDF file containing time series of U velocity component.
V_velocity.nc     - NetCDF file containing time series of V velocity component.

  • All output data files are removed by the “dust” Makefile target.

  • The “clean” Makefile target removes all object, module and the executable file.

  • The “distclean” Makefile target combines the “dust” and “clean” targets.

Notes

In the original demonstration case, there seems to be no coupling between the flow and the injector. Hence, the following lines in CouplerMod.F90 file are commented out:

253            ! check isneeded flag here
254            !! if (.not. isFieldNeeded(importState, datanames(i), rc=rc)) then
255            !!     !print *, "skipping field ", trim(datanames(i)), " not needed"
256            !!     cycle
257            !! endif

NUOPC prototype code

There are several NUOPC prototype code examples:

https://sourceforge.net/p/esmfcontrib/svn/HEAD/tree/NUOPC/ http://www.earthsystemmodeling.org/esmf_releases/non_public/ESMF_7_0_0/NUOPC_howtodoc/

The example of an ATM–CON–OCN model based on NUOPC:

https://sourceforge.net/p/esmfcontrib/svn/HEAD/tree/NUOPC/tags/ESMF_7_0_0/AtmOcnConProto/

We have also added this example case is our project (location: $PROJECT_DIR/esmf_test_application/esmf_test_atm_ocn). To compile and run this example:

export ESMFMKFILE=$ESMF_DIR/lib/libg/Linux.pgi.64.openmpi.default/esmf.mk
make
mpirun -np 6 esmApp