CESM3.0a DATM CASEROOT Variable Definitions
Model Version: 3.0a
Change CESM Version
Component Tag:
cdeps1.0.96
HTML Created:
2026-07-02
Use the CASEROOT tools xmlquery to query these variables and xmlchange to change their values.
| Parameter Name | Default Value | Data Type | Group | CASEROOT File | Valid Values | Description |
|---|---|---|---|---|---|---|
| COMP_ATM | datm | char | case_comp | env_case.xml | ['datm'] | Name of atmospheric component |
| DATM_MODE | CORE2_NYF | char | run_component_datm | env_run.xml | ['CORE2_NYF', 'CORE2_IAF', 'CLM_QIAN', 'CLM_QIAN_WISO', '1PT', 'CLMCRUJRA2024', 'CLMCRUJRA2024b', 'CLMCRUNCEPv7', 'CLMGSWP3v1', 'CLMNLDAS2', 'CPLHIST', 'CORE_IAF_JRA', 'CORE_IAF_JRA_1p4_2018', 'CORE_IAF_JRA_1p5_2023', 'CORE_RYF6162_JRA', 'CORE_RYF8485_JRA', 'CORE_RYF9091_JRA', 'CORE_RYF0304_JRA', 'ERA5', 'SIMPLE'] | Mode for data atmosphere component.
CORE2_NYF (CORE2 normal year forcing) are modes used in forcing prognostic ocean/sea-ice components.
CLMCRUJRA2024, CLMCRUJRA2024b, CLMCRUNCEPv7, CLMGSWP3v1, CLMNLDAS2 and 1PT are modes using observational data for forcing prognostic land components.
WARNING for CLMNLDAS2: This is a regional forcing dataset over the U.S. (25-53N, 235-293E). Garbage data will be produced for runs extending beyond this regional domain. |
| DATM_PRESAERO | clim_2000 | char | run_component_datm | env_run.xml | ['none', 'clim_1850', 'clim_2000', 'clim_2010', 'hist', 'SSP1-1.9', 'SSP1-2.6', 'SSP2-4.5', 'SSP3-7.0', 'SSP4-3.4', 'SSP4-6.0', 'SSP5-3.4', 'SSP5-8.5', 'cplhist'] | DATM prescribed aerosol forcing |
| DATM_PRESNDEP | clim_2000 | char | run_component_datm | env_run.xml | ['none', 'clim_1850_cmip7', 'clim_2000_cmip7', 'clim_2010_cmip7', 'hist_cmip7', 'clim_1850_cmip6', 'clim_2000_cmip6', 'clim_2010_cmip6', 'hist_cmip6', 'SSP1-2.6', 'SSP2-4.5', 'SSP3-7.0', 'SSP5-3.4', 'SSP5-8.5', 'cplhist'] | DATM prescribed nitrogen deposition forcing |
| DATM_PRESO3 | clim_2000 | char | run_component_datm | env_run.xml | ['none', 'clim_1850', 'clim_2000', 'clim_2010', 'hist', 'SSP2-4.5', 'SSP3-7.0', 'SSP5-8.5'] | DATM prescribed ozone forcing |
| DATM_TOPO | observed | char | run_component_datm | env_run.xml | ['none', 'observed', 'cplhist'] | DATM surface topography forcing |
| DATM_CO2_TSERIES | none | char | run_component_datm | env_run.xml | ['none', 'cplhist', 'cmip6_20tr', 'cmip7_20tr', 'omip.iaf', 'omip.jra', 'SSP1-1.9', 'SSP1-2.6', 'SSP2-4.5', 'SSP3-7.0', 'SSP4-3.4', 'SSP4-6.0', 'SSP5-3.4', 'SSP5-8.5'] | DATM CO2 time series |
| DATM_CPLHIST_DOMAIN_FILE | null | char | run_component_datm | env_run.xml | None |
Full pathname for domain file for datm when DATM_MODE is
CPLHIST, NOTE: if this is set to 'null' (the default), then
domain information is read in from the first coupler history
file in the target stream and it is assumed that the first
coupler stream file that is pointed to contains the domain
information for that stream.
|
| DATM_CPLHIST_DIR | UNSET | char | run_component_datm | env_run.xml | None | directory for coupler history data mode (only used for when DATM_MODE is CPLHIST) |
| DATM_CPLHIST_CASE | UNSET | char | run_component_datm | env_run.xml | None | case name used to determine stream filenames when DATM_MODE is CPLHIST |
| DATM_YR_ALIGN | 1 | integer | run_component_datm | env_run.xml | None |
Simulation year corresponding to DATM_YR_START. A common usage
is to set this to RUN_STARTDATE. With this setting, the forcing
in the first year of the run will be the forcing of year
DATM_YR_START. Another use case is to align the calendar
of transient forcing with the model calendar. For example,
setting DATM_YR_ALIGN=DATM_YR_START will lead to
the forcing calendar being the same as the model calendar. The
forcing for a given model year would be the forcing of the same
year. This would be appropriate in transient runs where the
model calendar is setup to span the same year range as the
forcing data.
|
| DATM_YR_START | 2004 | integer | run_component_datm | env_run.xml | None | starting year to loop data over |
| DATM_YR_START_FILENAME | 9999 | integer | run_component_datm | env_run.xml | None | Start year listed in PLUMBER2 filenames for certain datm_modes. Currently only used in PLUMBER2; leave as the default value (9999) for other cases. |
| DATM_YR_END | 2004 | integer | run_component_datm | env_run.xml | None | ending year to loop data over |
| DATM_SKIP_RESTART_READ | FALSE | logical | run_component_datm | env_run.xml | ['TRUE', 'FALSE'] | If set to true, than datm restarts will not be read on a continuation run.
This capability is used, for example, in CTSM spinup runs.
|
| Parameter Name | Default Value | Data Type | Group | CASEROOT File | Valid Values | Description |