-
Notifications
You must be signed in to change notification settings - Fork 0
Home
EarthWorks
Earthworks is a collaborative project between Colorado State University (CSU), National Center for Atmospheric Research (NCAR), and Others. Earthworks is based on cesm2_3_beta08.
Earthworks is hosted in a separate space EarthworksOrg. Current release of Earthworks is based on cesm2_3_beta08 tag.
The following compsets are supported in Earthworks EarthWorks supports a set of CESM compsets of increasing complexity and realism. However, in EarthWorks the atmosphere, ocean and sea ice are all based on the MPAS dynamical core framework. The supported testcases range from atmospheres with idealized physics,to full CAM6-MPAS atmospheres coupled to additional components to form Earth System Models. The test cases include:
-
FHS94. The HELD-SUAREZ test case replaces the CAM physics package with a simple relaxation of the temperature field toward a zonally symmetric equilibrium profile and simple linear drag at the lower boundary. This test case follows the specifications outlined by Held and Suarez (1994), Bull. Amer. Met. Soc., 75, 1825-1830. Because of its long run time (1200 days) this idealized case is supported in EarthWorks only at the 120 km resolution with 32 layers. The FHS94 test case and compset are described in more detail at: held-suarez
-
FKESSLER: Is a moist baroclinic wave test case with KESSLER microphysics. The version tested here uses the CAM-MPAS model. Like FHS94, KESSLER is a simplified model for validating the dynamical core and is supported in EarthWorks only at the 120 km resolution with 32 layers. The 10-day test, and the validation its results, is described in: fkessler
-
F2000Climo: Present day (2000) atmosphere + (CTSM) land surface with prescribed (data) ocean. See f2000climo for configuration details.
-
QPC6 (AquaPlanet): is an idealized global atmospheric model in which the planetary surface is covered by water. Most commonly, the sea surface temperature is prescribed by an analytic zonal distribution in latitude. For an analysis of CESM (CAM5) results for the AquaPlanet test case, see for example Brian Medeiros, David L. Williamson, Jerry G. Olson, Reference Aquaplanet climate in the Community Atmosphere Model, Version 5. JAMES, Volume 8, Issue 1, March 2016. QPC6. See QPC6-AquaPlanet for compset details.
-
Fully Coupled: CAM-MPAS Atmosphere 32 layers / MPAS Ocean / MPAS Sea ice on identical icosahedral grids; plus CTSM land, and stub runoff, glacier, and wave components. Initial condition is a Jan 1 atmosphere, and ocean and sea ice restarts from one year into a spin up from rest and Levitus climatology.
Installing, building and running Earthworks requires:
- a Unix-like operating system (Linux, AIX, OS X, etc.)
- git client version 1.8 or newer subversion client (we have tested with versions 1.6.11 and newer)
- python3 version 3.6 or newer
- perl version 5
- build tools gmake and cmake
- Fortran and C compilers See Details on Fortran compiler versions below for more information
- LAPACK and BLAS libraries
- a NetCDF library version 4.3 or newer built with the same compiler you will use for CESM
- a PnetCDF library is optional
- a functioning MPI environment (unless you plan to run on a single core with the CIME mpi-serial library)
Earthworks is released via git. Below are the steps to obtain the Earthwork source code
- Clone the repository
git clone [email protected]:EarthWorksOrg/EarthWorks.git my_earthworks_sandboxThis will create a directory my_earthworks_sandbox/ in your current working directory. - By default, the above git clone points to the main branch or current release branch/tag of Earthworks. To Checkout other tags use the following commands
cd my_earthworks_sandbox
git checkout <tag_name> - Run the script manage_externals/checkout_externals.
./manage_externals/checkout_externals. The checkout_externals script is a package manager that will populate the Earthworks directory with the relevant versions of each of the components along with the CIME infrastructure code.