Skip to content
supreethms1809 edited this page Mar 6, 2023 · 27 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

  • FHS94
  • FKESSLER
  • F2000 climo
  • QPC6
  • Fully Coupled

Software Requirements

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

  1. Clone the repository git clone git@github.com: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