CESM3.0a DATM Namelist Definitions
Model Version: 3.0a
Change CESM Version
Component Tag:
cdeps1.0.96
HTML Created:
2026-07-02
| Variable | Namelist Group | Category | Entry Type | Valid Values | Possible Default Values | Description and out-of-the-box Default |
|---|---|---|---|---|---|---|
| anomaly_forcing | datm_nml | datm | char(10) | ['none', 'Anomaly.Forcing.cmip5.rcp45', 'Anomaly.Forcing.cmip6.ssp126', 'Anomaly.Forcing.cmip6.ssp245', 'Anomaly.Forcing.cmip6.ssp370', 'Anomaly.Forcing.cmip6.ssp585'] | undefined |
If set, include anomaly forcing streams in namelist.
|
| bias_correct | datm_nml | datm | char | ['BC.QIAN.CMAP.Precip', 'BC.QIAN.GPCP.Precip', 'BC.CRUNCEP.CMAP.Precip', 'BC.CRUNCEP.GPCP.Precip'] | undefined |
If set, include bias correction streams in namelist.
|
| datamode | datm_nml | datm | char | ['CLMNCEP', 'CORE2_NYF', 'CORE2_IAF', 'CORE_IAF_JRA', 'CORE_RYF6162_JRA', 'CORE_RYF8485_JRA', 'CORE_RYF9091_JRA', 'CORE_RYF0304_JRA', 'ERA5', 'SIMPLE', 'CPLHIST', '1PT'] | is CLMNCEP for: {'datm_mode': 'CLM'} is CLMNCEP for: {'datm_mode': '1PT'} is CORE2_IAF for: {'datm_mode': 'CORE2_IAF'} is CORE_IAF_JRA for: {'datm_mode': 'CORE_IAF_JRA'} is ERA5 for: {'datm_mode': 'ERA5'} is SIMPLE for: {'datm_mode': 'SIMPLE'} is CPLHIST for: {'datm_mode': 'CPLHIST'} $DATM_MODE |
general method that operates on the data.
----datamode = "CPLHIST"----
CPLHIST mode will examine the fields found in all input data streams,
if any input field names match the field names used internally, they
are copied into the export array and passed directly to the coupler
without any special user code. Any required fields not found on an
input stream will be set to zero except for aerosol deposition fields
which will be set to a special value.
----datamode = "CORE2_NYF"----
Coordinated Ocean-ice Reference Experiments (CORE) Version 2 Normal Year Forcing.
----datamode = "CORE2_IAF"----
In conjunction with with CORE Version 2 atmospheric forcing data,
provides the atmosphere forcing favored by the Ocean Model Working
Group when coupling an active ocean model with observed atmospheric
forcing. This mode and associated data sets implement the CORE-IAF
Version 2 forcing data, as developed by Large and Yeager (2008) at
NCAR. See the documentation for CORE version 2 datasets at
http://data1.gfdl.noaa.gov/nomads/forms/mom4/COREv2.html Also see
W.G.Large, S.G.Yeager (2008), The global climatology of an
interannually varying air-sea flux data set.
Clm Dyn doi 10.1007/s00382-008-0441-3.
----datamode = "CORE_IAF_JRA"----
JRA55 intra-annual year forcing
----datamode = "CORE_RYF6162_JRA"----
JRA55 Repeat Year Forcing 1961-1962
----datamode = "CORE_RYF8485_JRA"----
JRA55 Repeat Year Forcing 1984-1985
----datamode = "CORE_RYF9091_JRA"----
JRA55 Repeat Year Forcing 1990-1991
----datamode = "CORE_RYF0304_JRA"----
JRA55 Repeat Year Forcing 2003-2004
----datamode = "CLMNCEP"----
In conjunction with NCEP climatological atmosphere data, provides the
atmosphere forcing favored by the Land Model Working Group when
coupling an active land model with observed atmospheric forcing. This
mode replicates code previously found in CLM (circa 2005), before the
LMWG started using the CCSM flux coupler and data models to do
active-land-only simulations.
----datamode = "ERA5"----
Fifth generation ECMWF atmospheric reanalysis of the global climate
----datamode = "SIMPLE"----
Namelist-configurable, constant datm forcing for simple experiments
----datamode = "CPLHIST" ----
|
| dn10 | const_forcing_nml | datm | real | ['any real'] | 1.204 |
density at the lowest model layer
units: kg m-3
|
| factorfn_data | datm_nml | datm | char | ['any char'] | null is $DIN_LOC_ROOT/atm/datm7/CORE2/COREv2.correction_factors.T62.121007.nc for: {'datm_mode': 'CORE2_NYF'} is $DIN_LOC_ROOT/atm/datm7/CORE2/COREv2.correction_factors.T62.121007.nc for: {'datm_mode': 'CORE2_IAF'} is null for: {'datm_mode': 'CORE2_IAF', 'model_grid': '01col'} |
filename containing correction factor data for use only with CORE2 modes (CORE2_IAF and CORE2_NYF).
|
| factorfn_mesh | datm_nml | datm | char | ['any char'] | null is $DIN_LOC_ROOT/share/meshes/T62_040121_ESMFmesh_c20190714.nc for: {'datm_mode': 'CORE2_NYF'} is $DIN_LOC_ROOT/share/meshes/T62_040121_ESMFmesh_c20190714.nc for: {'datm_mode': 'CORE2_IAF'} is null for: {'datm_mode': 'CORE2_IAF', 'model_grid': '01col'} |
filename containing correction factor data for use only with CORE2 modes (CORE2_IAF and CORE2_NYF).
|
| flds_co2 | datm_nml | datm | logical | ['.true.', '.false.'] | .true. is .false. for: {'datm_co2_tseries': 'none'} |
If true, prescribed co2 is sent from datm (must be true for running with CLM).
|
| flds_presaero | datm_nml | datm | logical | ['.true.', '.false.'] | .true. is .false. for: {'datm_presaero': 'none'} |
If true, prescribed aerosols are sent from datm (must be true for running with CLM).
|
| flds_presndep | datm_nml | datm | logical | ['.true.', '.false.'] | .true. is .false. for: {'datm_presndep': 'none'} |
If true, prescribed nitrogen deposition fluxes are sent from datm (must be true for running with CLM).
|
| flds_preso3 | datm_nml | datm | logical | ['.true.', '.false.'] | .true. is .false. for: {'datm_preso3': 'none'} |
If true, prescribed o3 is sent from datm (must be true for running with CLM).
|
| iradsw | datm_nml | datm | integer | ['any integer'] | 1 is -1 for: {'datm_mode': 'CPLHIST'} |
Frequency to update radiation in number of steps (or hours if negative).
irdasw is the radiation setting used to compute the next shortwave Julian date.
Values greater than 1 set the next radiation to the present time plus either 1 or 2
timesteps (depending on the value of nextsw_cday_calc) every iradsw timesteps.
Values less than 0 set the next radiation to the present time plus either 1 or 2
timesteps (depending on the value of nextsw_cday_calc) every -iradsw hours. If
iradsw is either 0 or 1, the next radiation time is the present time plus 1
timestep. (default=1 for non-CPLHIST cases, and -1 for CPLHIST cases.)
|
| nextsw_cday_calc | datm_nml | datm | char | ['cam6', 'cam7'] | cam6 is cam7 for: {'datm_mode': 'CPLHIST'} |
Logic to use for calculating nextsw_cday. This variable has no effect when iradsw is
0 or 1, so by default this only applies in CPLHIST cases.
For CPLHIST cases, this should agree with the version of CAM (or other atmosphere
model) used to generate the CPLHIST forcings; the valid values for this variable are
based on this: 'cam6' is appropriate for cases generated with the driver ordering in
CAM6 and earlier, and 'cam7' is appropriate for cases generated with the driver
ordering in CAM7 and later.
For 'cam6', the next radiation timestep is set to the present time plus 2 timesteps
when mod(tod+dtime,delta_radsw)==0. For 'cam7', the next radiation timestep is set
to the present time plus 1 timestep when mod(tod,delta_radsw)==0.
|
| peak_lwdn | const_forcing_nml | datm | real | ['any real'] | 450.0 |
Peak idealized longwave radiation to be passed to ice/ocean surface.
units: W m-2
|
| peak_swdn | const_forcing_nml | datm | real | ['any real'] | 330.0 |
Peak idealized shortwave radiation to be passed to ice/ocean surface.
units: W m-2
|
| q | const_forcing_nml | datm | real | ['any real'] | 0.0 |
Constant bottom layer specific humidity
units: kg kg-1
|
| restfilm | datm_nml | datm | char | ['any char'] | null |
Model restart filename for the data atmosphere model data. This is
optional. If restfilm is null, the restart
filename will be read from the DATM restart pointer file (or files for multiple instances).
|
| skip_restart_read | datm_nml | datm | logical | ['.true.', '.false.'] | $DATM_SKIP_RESTART_READ |
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.
|
| slp | const_forcing_nml | datm | real | ['any real'] | 101325.0 |
inst_pres_height_surface
units: Pa
|
| t | const_forcing_nml | datm | real | ['any real'] | 273.15 |
Constant air temperature at lowest model layer
units: K
|
| u | const_forcing_nml | datm | real | ['any real'] | 0.0 |
Constant zonal wind speed forcing for simple models.
units: m s-1
|
| v | const_forcing_nml | datm | real | ['any real'] | 0.0 |
Constant meridional wind speed forcing for simple models.
units: m s-1
|
| model_maskfile | datm_nml | streams | char | ['any char'] | $ATM_DOMAIN_MESH is null for: {'single_column': 'true'} |
file specifying model mask if not obtained from input model mesh
|
| model_meshfile | datm_nml | streams | char | ['any char'] | $ATM_DOMAIN_MESH is null for: {'single_column': 'true'} |
file specifying model mesh
|
| nx_global | datm_nml | streams | integer | ['any integer'] | $ATM_NX is 1 for: {'single_column': 'true'} |
global size of nx
|
| ny_global | datm_nml | streams | integer | ['any integer'] | $ATM_NY is 1 for: {'single_column': 'true'} |
global size of ny
|
| streamslist | streams_file | streams | char(100) | ['any char'] | is CLM_QIAN.Solar,CLM_QIAN.Precip,CLM_QIAN.TPQW for: {'datm_mode': 'CLM_QIAN$'} is CLMCRUJRA2024b.Solar,CLMCRUJRA2024b.Precip,CLMCRUJRA2024b.TPQW for: {'datm_mode': 'CLMCRUJRA2024b'} is CLMCRUJRA2024.Solar,CLMCRUJRA2024.Precip,CLMCRUJRA2024.TPQW for: {'datm_mode': 'CLMCRUJRA2024(?!b)'} is CLMCRUNCEPv7.Solar,CLMCRUNCEPv7.Precip,CLMCRUNCEPv7.TPQW for: {'datm_mode': 'CLMCRUNCEPv7'} is CLMGSWP3v1.Solar,CLMGSWP3v1.Precip,CLMGSWP3v1.TPQW for: {'datm_mode': 'CLMGSWP3v1'} is CLMNLDAS2.Solar,CLMNLDAS2.Precip,CLMNLDAS2.TPQW for: {'datm_mode': 'CLMNLDAS2'} is 1PT.mexicocityMEX for: {'datm_mode': '1PT', 'model_grid': '1x1_mexicocityMEX'} is 1PT.vancouverCAN for: {'datm_mode': '1PT', 'model_grid': '1x1_vancouverCAN'} is 1PT.urbanc_alpha for: {'datm_mode': '1PT', 'model_grid': '1x1_urbanc_alpha'} is NEON.$NEONSITE for: {'datm_mode': '1PT', 'model_grid': 'CLM_USRDAT', 'neon': 'True'} is PLUMBER2.$PLUMBER2SITE for: {'datm_mode': '1PT', 'model_grid': 'CLM_USRDAT', 'neon': 'True'} is CLM_USRDAT.$CLM_USRDAT_NAME for: {'datm_mode': '1PT', 'model_grid': 'CLM_USRDAT'} is CORE2_NYF.GISS,CORE2_NYF.GXGXS,CORE2_NYF.NCEP for: {'datm_mode': 'CORE2_NYF'} is CORE2_IAF.GCGCS.PREC,CORE2_IAF.GISS.LWDN,CORE2_IAF.GISS.SWDN,CORE2_IAF.GISS.SWUP,CORE2_IAF.NCEP.DN10,CORE2_IAF.NCEP.Q_10,CORE2_IAF.NCEP.SLP_,CORE2_IAF.NCEP.T_10,CORE2_IAF.NCEP.U_10,CORE2_IAF.NCEP.V_10,CORE2_IAF.CORE2.ArcFactor for: {'datm_mode': 'CORE2_IAF'} is CORE_IAF_JRA_1p4_2018.GCGCS.PREC,CORE_IAF_JRA_1p4_2018.GISS.LWDN,CORE_IAF_JRA_1p4_2018.GISS.SWDN,CORE_IAF_JRA_1p4_2018.NCEP.Q_10,CORE_IAF_JRA_1p4_2018.NCEP.SLP_,CORE_IAF_JRA_1p4_2018.NCEP.T_10,CORE_IAF_JRA_1p4_2018.NCEP.U_10,CORE_IAF_JRA_1p4_2018.NCEP.V_10 for: {'datm_mode': 'CORE_IAF_JRA_1p4_2018'} is CORE_IAF_JRA_1p5_2023.GCGCS.PREC,CORE_IAF_JRA_1p5_2023.GISS.LWDN,CORE_IAF_JRA_1p5_2023.GISS.SWDN,CORE_IAF_JRA_1p5_2023.NCEP.Q_10,CORE_IAF_JRA_1p5_2023.NCEP.SLP_,CORE_IAF_JRA_1p5_2023.NCEP.T_10,CORE_IAF_JRA_1p5_2023.NCEP.U_10,CORE_IAF_JRA_1p5_2023.NCEP.V_10 for: {'datm_mode': 'CORE_IAF_JRA_1p5_2023'} is CORE_RYF6162_JRA.GISS.LWDN,CORE_RYF6162_JRA.GISS.SWDN,CORE_RYF6162_JRA.GCGCS,CORE_RYF6162_JRA.NCEP for: {'datm_mode': 'CORE_RYF6162_JRA'} is CORE_RYF8485_JRA.GISS.LWDN,CORE_RYF8485_JRA.GISS.SWDN,CORE_RYF8485_JRA.GCGCS,CORE_RYF8485_JRA.NCEP for: {'datm_mode': 'CORE_RYF8485_JRA'} is CORE_RYF9091_JRA.GISS.LWDN,CORE_RYF9091_JRA.GISS.SWDN,CORE_RYF9091_JRA.GCGCS,CORE_RYF9091_JRA.NCEP for: {'datm_mode': 'CORE_RYF9091_JRA'} is CORE_RYF0304_JRA.GISS.LWDN,CORE_RYF0304_JRA.GISS.SWDN,CORE_RYF0304_JRA.GCGCS,CORE_RYF0304_JRA.NCEP for: {'datm_mode': 'CORE_RYF0304_JRA'} is CORE_IAF_JRA.PREC,CORE_IAF_JRA.LWDN,CORE_IAF_JRA.SWDN,CORE_IAF_JRA.Q_10,CORE_IAF_JRA.SLP_,CORE_IAF_JRA.T_10,CORE_IAF_JRA.U_10,CORE_IAF_JRA.V_10 for: {'datm_mode': 'CORE_IAF_JRA'} is CORE2_IAF.NCEP.DENS.SOFS,CORE2_IAF.NCEP.PSLV.SOFS,CORE2_IAF.PREC.SOFS.DAILY,CORE2_IAF.LWDN.SOFS.DAILY,CORE2_IAF.SWDN.SOFS.DAILY,CORE2_IAF.SWUP.SOFS.DAILY,CORE2_IAF.SHUM.SOFS.6HOUR,CORE2_IAF.TBOT.SOFS.6HOUR,CORE2_IAF.U.SOFS.6HOUR,CORE2_IAF.V.SOFS.6HOUR,CORE2_IAF.CORE2.ArcFactor for: {'datm_mode': 'CORE2_IAF', 'model_grid': '01col'} is ERA5_HOURLY for: {'datm_mode': 'ERA5'} is undefined for: {'datm_mode': 'SIMPLE'} is CPLHISTForcing.Solar,CPLHISTForcing.nonSolarFlux,CPLHISTForcing.State3hr,CPLHISTForcing.State1hr for: {'datm_mode': 'CPLHIST'} |
List of streams used for the given DATM_MODE |
| Variable | Namelist Group | Category | Entry Type | Valid Values | Possible Default Values | Description and out-of-the-box Default |