Skip to content
supreethms1809 edited this page Mar 7, 2023 · 25 revisions

EarthWorks

Earthworks Documentation

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 Repository Structure

Earthworks is hosted in a separate space EarthworksOrg. Current release of Earthworks is based on cesm2_3_beta08 tag.

Earthworks supported configurations

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.

Software Requirements

Earthworks is released via git. Below are the steps to obtain the Earthwork source code

  1. Clone the repository git clone [email protected]:EarthWorksOrg/EarthWorks.git my_earthworks_sandbox This will create a directory my_earthworks_sandbox/ in your current working directory.
  2. 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>
  3. 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.

Earthworks Build Instructions

Earthworks Run Instructions

Known Issues