The Held-Suarez Example
From Maplcode.org
Contents |
[edit] Overview
The MAPL distribution includes an example of a complete application that applies the Held-Suarez test of dry dynamical cores to the finite-volume core FVdycore.
The application combines MAPL versions FVdycore and Held-Suarez leaf ESMF gridded components in a MAPL-ESMF composite component. This in turn is combined with an instance of MAPL_History into an executable application by writing a very thin Cap or main program that relies on MAPL_Cap for most of the work. The figure on the right shows graphically the components that make up this example and how they are wired together. The sources for four of the components (all except the history component) are linked from the table below.
The protex documentation (FV_HeldSuarez.pdf) of the user code of this application describes the various gridded components, the contents of their Import and Export states, and the user specifiable resources. The code itself is part of the MAPL distribution. Understanding the code will require referring to "An Introduction to MAPL" (MAPL_Intro.pdf).
[edit] Key Source Code Files
| File Name | Notes |
| fvhs/src/Application/FV_HeldSuarez.F90 | Application main (MAPL cap). |
| fvhs/src/GEOSagcm_GridComp/GEOS_AgcmSimpleGridComp.F90 | Parent for FV dynamics and Held-Suarez physics (MAPL composite component - also MAPL computational SetServices root). |
| fvhs/src/GEOSagcm_GridComp/FVdycore_GridComp/FVdycore_GridCompMod.F90 | FV dynamics (MAPL leaf component). |
| fvhs/src/GEOSagcm_GridComp/GEOShs_GridComp/GEOS_HsGridComp.F90 | Held-Suarez physics (MAPL leaf component). |
| fvhs/src/Application/HISTORY.rc | Configuration file for history component. |
| fvhs/src/Application/CAP.rc | Configuration file for application cap. |
| fvhs/src/GEOSagcm_GridComp/AgcmSimple.rc | Configuration file for FV dynamics and Held-Suarez physics parent. |
