Background
The configuration of an E3SM case is specified by a long string called a “component set”. Here is an example for an atmosphere-only case:
1850_CAM5%CMIP6_CLM45%SPBC_CICE%PRES_DOCN%DOM_SROF_SGLC_SWAV
That’s a lot to type so every compset has a shorter alias and the first letter in that alias indicates what combination of components are full active models or not. The alias for the above is:
F1850C5-CMIP6
The meaning of the first letter in the compset naming component set alias is inherited from CESM and has a long history. Below The below table taken is modified from http://www.cesm.ucar.edu/models/cesm1.0/cesm/cesm_doc_1_0_4/x42.html but these conventions date back to when the model was called CCSM.
A “data” model will take the place of a full model and send In the table below, you’ll see components like “datm” and “swav”. To turn off feedbacks, active components can be substituted by a version that just sends data e.g. “datm” is a data atmosphere model. A “data” model sends real values for all expected fields (from files) .A “stub” model just provides a routine to the coupler so that the rest of the system can’t tell if its a full model or not.
In some cases you don’t even need a data model. You just need something for the coupler to call and does nothingin the place it expects. A “stub” model serves this purpose. e.g. “swav” is a stub wave model. No data is sent.
Also in the table below, “glc” is the land-ice model (because it used to be called the “glacier” model).
For fully coupled cases (aka “B cases”), E3SM To distinguish between CESM and E3SM cases, we adopted different naming for some compset aliases including using multiple letters.
Original letters
Designation | Components | Details |
|---|---|---|
A | datm,dlnd,dice,docn,drof,sglc, swav | All DATA components with stub glc and wav (used primarily for testing the coupler) |
B | NOT USED by E3SM. | The “fully coupled” cases in CESM. |
C | NOT USED by E3SM. | in CESM, POP active with data atm, lnd(runoff), and ice plus stub glc. |
CMPASO
mpas-ocean active with data atm, land, runoff and seaice. stub glc and wav.
D | NOT USED by E3SM | This would be an active MPAS-sea ice only case with data atm and ocn and stub lnd, runoff |
DTESTM
datm,slnd, mpas-seaice, docn, drof, sglc, swav
, |
glc, wav. | ||
E | eam, elm,mpas-seaice, docn,sglc, swav | EAM, ELM, MOSART and CICE active with data ocean (som mode) plus stub glc, wav. We have these defined but don’t use/test them. Like an F-case but the sea-ice is fully active and active runoff is added. |
F | eam, elm, cice, docn, srof, sglc, swav (need to replace cice with mpas-seaice equivalent) | EAM, ELM, and old CICE (prescribed mode) active with data ocean (sstdata mode) plus stub rof, wav and glc. What we use when we say “atmosphere only” |
G |
NOT used by E3SM
in CESM, POP and CICE active with data atm and and runoff plus stub lnd, glc and wav. Instead we have...
GMPAS
Called “GMPAS”. datm, slnd, mpas- |
ocean, mpas- |
seaice, drof, swav, sglc |
Active sea ice and ocean, | ||
H | NOT USED by E3SM | This would be the same as a G case but stub runoff instead of data runoff. We have none of these defined. |
I | datm, elm, mosart, sice,socn, swav, sglc | ELM and MOSART active with data atm and stub ice, ocean, wave and glc. NOTE Some I-cases have stub atm. |
IG | datm, elm, mosart, sice, socen, save, mali, swav | land-ice with active land and river. datm, stub otherwise. |
S | satm,slnd,sice,socn,srof,sglc,swav | All STUB components (used for testing only) |
TG | satm, |
elm, sice,socn,srof, mpas-landice, swav | Active land model and land-ice with stub everything else | |
V | satm, slnd, sice, socn, srof, sglc, ww3 | Active wave model only case |
X | xatm,xlnd,xice,xocn,sglc,swav | All DEAD components except for stub glc and wav (used for testing only) |
E3SM additions
Designation | Components | Details |
|---|---|---|
WCYCLE (fka A_ |
WCYCLE) | eam,elm,mpas-ocean,mpas-seaice, mosart, sglc | FULLY Active water cycle cases with stub glc, wav. Our version of a “B-case”. The “A_” was for ACME so we will drop that in v2. |
BGC | eam,elm,mpas-ocean,mpas-seaice, mosart, sglc with BGC pieces turned on. | FULLY active BGC cases with stub glc, wav |
CMPASO | datm,dice,dlnd, mpas-ocean, drof, sglc, swav | mpas-ocean active with data atm, land, runoff and seaice. stub glc and wav. |
CRYO | eam,elm,mpas-ocean,mpas-seaice, mosart, mpas-landice, stub wav. | FULLY active with stub wav. |
DTESTM | datm,slnd, mpas-seaice, docn, drof, sglc, swav | MPAS-seaice with data atm, ocn, and runoff. Stub glc, wav. |
GMPAS | datm,slnd, mpas-seaice, mpas-ocean, drof, sglc, swav | MPAS-ocean and MPAS-seaice active with data atm and runoff, stub lnd, glc, wav. The ocean and sea-ice version of an F-case. |
MALI | mpas-landice, satm, slnd, socn, srof, swav | MPAS-landice and stub everything else. |
MPAS-LISO | active mpas-landice, seaice and ocean. datmk slnd, swav | All MPAS models active |