Skip to content

Commit

Permalink
Minor edits
Browse files Browse the repository at this point in the history
  • Loading branch information
billsacks committed Oct 13, 2021
1 parent 436eea3 commit 7f1d191
Showing 1 changed file with 24 additions and 23 deletions.
47 changes: 24 additions & 23 deletions doc/source/cesm_configurations.rst
Original file line number Diff line number Diff line change
Expand Up @@ -109,34 +109,35 @@ The CESM2 components can be combined in numerous ways to carry out
various scientific or software experiments. A particular mix of
components, *along with* component-specific configuration and/or
namelist settings is called a `component set or compset
<http://www.cesm.ucar.edu/models/cesm2/cesm/compsets.html>`_. CESM
has a shorthand naming convention for component sets that are
supported out-of-the-box.

The compset name usually has a well defined first letter followed by
some characters that are indicative of the configuration setup. Each
compset name has a corresponding short name.

The first letter generally indicates which of the components are fully
active (prognostic), which are data components, and which are completely
absent (or stub). For the most part, this first letter refers only to
the atmosphere (atm), land (lnd), sea ice (ice) and ocean (ocn)
components. The type of component used for river (rof), land ice (glc)
and ocean wave (wav) is either specified in some other way in the alias
or is not specified explicitly. For example, an evolving land ice (glc)
model is denoted by a capital G near the end of the compset alias (e.g.,
B1850G is similar to B1850 but with an evolving Greenland ice sheet). In
some cases, the distinction between prognostic and data components is
not clear-cut -- for example, when using a data ocean model in slab
ocean model (SOM) mode, or when using a prognostic sea ice model (CICE)
in prescribed mode.
<http://www.cesm.ucar.edu/models/cesm2/cesm/compsets.html>`_. CESM has a
shorthand naming convention (known as an alias) for component sets that
are supported out-of-the-box. The compset alias usually has a
well-defined first letter followed by some characters that are
indicative of the configuration setup.

The first letter in a compset alias generally indicates which of the
components are fully active (prognostic), which are data components, and
which are completely absent (or stub). For the most part, this first
letter refers only to the atmosphere (atm), land (lnd), sea ice (ice)
and ocean (ocn) components. The type of component used for river (rof),
land ice (glc) and ocean wave (wav) is either specified in some other
way in the alias or is not specified explicitly. For example, an
evolving land ice (glc) model is denoted by a capital G near the end of
the compset alias (e.g., B1850G is similar to B1850 but with an evolving
Greenland ice sheet). In some cases, the distinction between prognostic
and data components is not clear-cut -- for example, when using a data
ocean model in slab ocean model (SOM) mode, or when using a prognostic
sea ice model (CICE) in prescribed mode.

The following table summarizes these first-letter designations in
compset aliases:

.. table::

+-------------+--------------------+-----------------+--------------------------------------------------------------------------------------------------------------+
| Designation | Active Components | Data Components | Notes |
+=============+====================+=================+==============================================================================================================+
| A | -- | VARIES | All data components (exact set of data components differs for different compsets); used for software testing |
| A | -- | various | All data components (exact set of data components differs for different compsets); used for software testing |
+-------------+--------------------+-----------------+--------------------------------------------------------------------------------------------------------------+
| B | atm, lnd, ice, ocn | -- | Fully active components |
+-------------+--------------------+-----------------+--------------------------------------------------------------------------------------------------------------+
Expand All @@ -158,7 +159,7 @@ in prescribed mode.
+-------------+--------------------+-----------------+--------------------------------------------------------------------------------------------------------------+
| Q | atm | ocn | Aquaplanet compsets |
+-------------+--------------------+-----------------+--------------------------------------------------------------------------------------------------------------+
| S | -- | -- | Driver only; used for software testing |
| S | -- | -- | No components present; used for software testing |
+-------------+--------------------+-----------------+--------------------------------------------------------------------------------------------------------------+
| T | glc | lnd | \ |
+-------------+--------------------+-----------------+--------------------------------------------------------------------------------------------------------------+
Expand Down

0 comments on commit 7f1d191

Please sign in to comment.