CESM2.2.1 DATM2.0 Namelist Definitions
Model Version: 2.2.1
Change CESM Version
Component Tag:
cime5.8.32.1
HTML Created:
2024-10-01
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 |