Model Version: 3.0a
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