DATM2.1 Fortran Namelist Definitions

Component tag: cime5.6.19

HTML created on: 2019-06-09

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) ['Anomaly.Forcing.Precip', 'Anomaly.Forcing.Temperature', 'Anomaly.Forcing.Pressure', 'Anomaly.Forcing.Humidity', 'Anomaly.Forcing.Uwind', 'Anomaly.Forcing.Vwind', 'Anomaly.Forcing.Shortwave', 'Anomaly.Forcing.Longwave']
      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']
      If set, include bias correction streams in namelist.
    
decomp datm_nml datm char ['1d', 'root']
      Set the decomposition option for the data model.  valid options are
      placing the global array on the root task or a simple stride-one
      load balanced one-dimensional decomposition.  other decompositions
      may be added in the future. valid values are ['root','1d'].
      1d = Vector decomposition, root = run only on the master task
    
factorfn datm_nml datm char ['any char']
      filename containing correction factors for use only with CORE2 modes (CORE2_IAF and CORE2_NYF).
    
force_prognostic_true datm_nml datm logical ['.true.', '.false.']
      If true, prognostic is forced to true. (default=false)
    
iradsw datm_nml datm integer ['any integer']
      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 2 timesteps every iradsw.  values less than 0 turn
      set the next radiation to the present time plus two timesteps every
      -iradsw hours.  if iradsw is zero, the next radiation time is the
      present time plus 1 timestep.  (default=0.)
    
presaero datm_nml datm logical ['.true.', '.false.']
      If true, prescribed aerosols are sent from datm (must be true for running with CLM).
    
restfilm datm_nml datm char ['any char']
      Model restart filename for the data atmosphere model data.  This is
      optional.  If both restfils and restfilm are undefined, the restart
      filename will be read from the DATM restart pointer file (or files for multiple instances).
    
restfils datm_nml datm char ['any char']
      stream restart filename for the data atmosphere stream data.  This is
      optional.  If both restfils and restfilm are undefined, the restart
      filename will be read from the DATM restart pointer file (or files for multiple instances).
    
wiso_datm datm_nml datm logical ['.true.', '.false.']
      flag which if true, says to turn on water isotopes
    
datamode shr_strdata_nml streams char ['CLMNCEP', 'COPYALL', 'CORE2_NYF', 'CORE2_IAF', 'CORE_IAF_JRA', 'NULL']
      general method that operates on the data.  this is generally
      implemented in the data models but is set in the strdata method for
      convenience.  valid options are dependent on the data model and will
      be described elsewhere.  NULL is always a valid option and means no
      data will be generated.  default='NULL'

      datamode = "NULL"
      turns off the data model as a provider of data to the coupler.
      The atm_present flag will be set to false
      and the coupler will assume no exchange of data to or from the data model.
      datamode = "COPYALL"
      The default science mode of the data model is the COPYALL mode.
      COPYALL 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.  There are several other
      scientific modes supported by the model, they are listed below.  The
      mode is selected by a character string set in the strdata namelist
      variable dataMode.
      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 = "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.
    
domainfile shr_strdata_nml streams char ['any char']
      model spatial gridfile associated with the strdata.  grid information will
      be read from this file and that grid will serve as the target grid
      for all input data for this strdata input.
    
dtlimit shr_strdata_nml streams real(30) ['any real(30)']
      array (up to 30 elements) of delta time ratio limits placed on the
      time interpolation associated with the array of streams.  this real
      value causes the model to stop if the ratio of the running maximum
      delta time divided by the minimum delta time is greater than the
      dtlimit for that stream.  for instance, with daily data, the delta
      time should be exactly one day throughout the dataset and the computed
      maximum divided by minimum delta time should always be 1.0.  for
      monthly data, the delta time should be between 28 and 31 days and the
      maximum ratio should be about 1.1.  the running value of the delta
      time is computed as data is read and any wraparound or cycling is also
      included.  this input helps trap missing data or errors in cycling.
      to turn off trapping, set the value to 1.0e30 or something similar.
    
fillalgo shr_strdata_nml streams char(30) ['copy', 'bilinear', 'nn', 'nnoni', 'nnonj', 'spval']
      array (up to 30 elements) of fill algorithms associated with the array
      of streams.  valid options are just copy (ie. no fill), special value,
      nearest neighbor, nearest neighbor in "i" direction, or nearest
      neighbor in "j" direction.
      valid values:  'copy','spval','nn','nnoni','nnonj'
    
fillmask shr_strdata_nml streams char(30) ['nomask', 'srcmask', 'dstmask', 'bothmask']
      plays no role is fill algorithm at the present time.
      valid values: "nomask,srcmask,dstmask,bothmask"
    
fillread shr_strdata_nml streams char(30) ['any char']
      array (up to 30 elements) of filenames associated with the array of
      streams.  specifies the weights file to read in instead of computing the
      weights on the fly for the fill operation.  if this is set, fillalgo
      and fillmask are ignored.
    
fillwrite shr_strdata_nml streams char(30) ['any char']
      array (up to 30 elements)  of filenames associated with the array of
      streams.  specifies the weights file to generate after weights are
      computed on the fly for the fill operation.  this allows a user to
      save and reuse a set of weights later.
    
mapalgo shr_strdata_nml streams char(30) ['copy', 'bilinear', 'nn', 'nnoni', 'nnonj', 'spval']
      array (up to 30 elements) of fill algorithms associated with the array
      of streams.  valid options are copy by index, set to special value,
      nearest neighbor, nearest neighbor in "i" direction, nearest neighbor
      in "j" direction, or bilinear.
      valid values: copy,spval,nn,nnoni,nnonj,bilinear
    
mapmask shr_strdata_nml streams char(30) ['nomask', 'srcmask', 'dstmask', 'bothmask']
      array (up to 30 elements) of masking algorithms for mapping input data
      associated with the array of streams.  valid options are map only from
      valid src points, map only to valid destination points, ignore all
      masks, map only from valid src points to valid destination points.
      valid values: srcmask, dstmask, nomask,bothmask
    
mapread shr_strdata_nml streams char(30) ['any char']
      array (up to 30 elements) of filenames associated with the array of
      streams.  specifies the weights file to read instead of computing
      weights on the fly for the mapping (interpolation) operation.  if this
      is set, mapalgo and mapmask are ignored.
    
mapwrite shr_strdata_nml streams char(30) ['any char']
      array (up to 30 elements) of filenames associated with the array of
      streams.  specifies the weights file to generate after weights are
      computed on the fly for the mapping (interpolation) operation.  this
      allows a user to save and reuse a set of weights later.
    
readmode shr_strdata_nml streams char(30) ['single', 'full_file']
      array (up to 30 elements) of reading mode associated with the array of
      streams.  specifies the mode of reading temporal stream dataset.
      valid options are "single" (read temporal dataset one at a time) or
      "full_file" (read all entires of temporal dataset in a given netcdf file)
      valid values: single,full_file
    
streams shr_strdata_nml streams char(30) ['any char']
      character array (up to 30 elements) of stream input files.  this
      string is actually parsed by a stream method and so the format is
      specified by the stream module.  this string consists of a
      "stream_input_filename year_align year_first year_last".  the
      stream_input_filename is a stream text input file and the format and
      options are described elsewhere.  year_align, year_first, and
      year_last provide information about the time axis of the file and how
      to relate the input time axis to the model time axis.
    
streamslist streams_file streams char(100) ['any char']
List of streams used for the given datm_mode
strm_datdir streams_file streams char ['any char']
Stream data file directory.
strm_datfil streams_file streams char ['any char']
Stream data file path(s).
strm_datvar streams_file streams char ['any char']
Stream data variable name(s).
strm_domdir streams_file streams char ['any char']
Stream domain file directory.
strm_domfil streams_file streams char ['any char']
Stream domain file path(s).
strm_domvar streams_file streams char ['any char']
Stream domain variable name(s).
strm_offset streams_file streams integer ['any integer']
Stream offset.
strm_year_align streams_file streams integer ['any integer']
Simulation year to align stream to.
strm_year_end streams_file streams integer ['any integer']
Last year of stream.
strm_year_start streams_file streams integer ['any integer']
First year of stream.
taxmode shr_strdata_nml streams char(30) ['extend', 'cycle', 'limit']
      array of time axis modes associated with the array of streams for
      handling data outside the specified stream time axis.
      valid options are to cycle the data based on the first, last, and
      align settings associated with the stream dataset, to extend the first
      and last valid value indefinitely, or to limit the interpolated data
      to fall only between the least and greatest valid value of the time array.
      valid values: cycle,extend,limit
    
tintalgo shr_strdata_nml streams char(30) ['coszen', 'nearest', 'linear', 'lower', 'upper']
      array (up to 30 elements) of time interpolation options associated with the array of
      streams.
      valid values: lower,upper,nearest,linear,coszen
      lower   = Use lower time-value
      upper   = Use upper time-value
      nearest = Use the nearest time-value
      linear  = Linearly interpolate between the two time-values
      coszen  = Scale according to the cosine of the solar zenith angle (for solar)
    
vectors shr_strdata_nml streams char ['any char']
      list of paired colon delimited field names that should be treated as
      vectors when carrying out spatial interpolation.  unlike other
      character arrays in this namelist, this array is completely decoupled
      from the list of streams.  this is a list of vector pairs that span
      all input streams where different fields of the vector pair could
      appear in different streams.
      for example, vectors = 'u:v','taux:tauy'.
    
Variable Namelist Group Category Entry Type Valid Values Possible Default Values Description and out-of-the-box Default