Workspaces#

Utilizing the CESM model requires knowledge of the locations of the different parts of the model. The CESM model consists of five main directory tree areas that make up the CESM Workspace.

One of the key elements of the Tutorial will be learning where each of these workspace elements are located and how to use them to setup, build, run and analyze the output of model simulations.

There are 5 main directories (see figure, below) you will need to navigate:

  1. The path to your CESM source code. This is referred to as $SRCROOT (or $CESMCODE) and contains the $CIMEROOT.

  2. The path to the input data, referred to as $CESMDATA.

  3. The path to your experiment case directories. This is referred to as $CASEROOT.

  4. The path to your build and run directories, referred to as the $EXEROOT and $RUNDIR, respectively.

  5. The path to your archived model output, referred to as $DOUT_S_ROOT.

We will investigate these more detail in the remainder of the Tutorial.

Note on Terminology

  • Paths are the directions to the location of different pieces of your workspace.

  • Roots are saved paths that point to a specific piece of the model.

Workspace Overview#

CESM workspace

Figure: Overview of the CESM2 Workspace Paths

Each of these directories contains sub-directories. You will need to learn to navigate between these directories.

Create CESM Code Directory#

Create a workspace location where you can put your CESM code on the Cheyenne glade file system. In all exercises in this tutorial $USER is a placeholder and you should use your NCAR HPC login name when completing the exercise.

cd /glade/work/$USER
mkdir code

Create Cases Workspace Location#

Create a workspace location where all your cases from this tutorial will be located on the Cheyenne glade file system.

cd /glade/work/$USER
mkdir cases

Other Workspace Locations#

The INPUTDATA directory does not need to be set up directly on NCAR HPC as these data are in a common directory.

We will not directly set up your Build/Run or Archive workspace locations. These directories will be automatically created when you create a CESM case.