<?xml-stylesheet type="text/xsl" href="http://www.cgd.ucar.edu/~cam/namelist/namelist_definition_CAM.xsl"?>

<namelist_definition>

<!-- Each namelist variable is defined in an <entry> element.  The
     content of the element is the documentation of how the variable is
     used.  Other aspects of the variable's definition are expressed as
     attributes of the <entry> element.  Note that it is an XML requirement
     that the attribute values are enclosed in quotes.  The attributes are:

     id
          The variable's name.  *** N.B. *** The name must be lower case.
          The module convert all namelist variable names to lower case
          since Fortran is case insensitive.

     type
          An abbreviation of the fortran declaration for the variable.
	  Valid declarations are:

          char*n
	  integer
	  logical
	  real

	  Any of these types may be followed by a comma separated list of
	  integers enclosed in parenthesis to indicate an array.

	  The current namelist validation code only distinquishes between
	  string and non-string types.

     input_pathname
          Only include this attribute to indicate that the variable
          contains the pathname of an input dataset that resides in the
          CCSM inputdata directory tree.  Note that the variables
          containing the names of restart files that are used in branch
          runs don't reside in the inputdata tree and should not be given
          this attribute.

	  The recognized values are "abs" to indicate that an absolute
          pathname is required, or "rel:var_name" to indicate that the
          pathname is relative and that the namelist variable "var_name"
          contains the absolute root directory.

     category
          A category assigned for organizing the documentation.

     group
          The namelist group that the variable is declared in.

     valid_values
          This is an optional attribute that is mainly useful for variables
          that have only a small number of allowed values.
                                                                        -->
	     
<!-- FKB -->
<entry id="do_fkb_activation" type="logical" category="fkb"
       group="fkb_nl" valid_values="" >
       Toggle neural network (FKB) aerosol activation correction ON/OFF
       </entry>     

<entry id="do_fkb_activation_test" type="logical" category="fkb"
       group="fkb_nl" valid_values="" >
       Toggle FKB aerosol activation test ON/OFF
       </entry>

<entry id="fkb_act_model_txt" type="char*256" category="fkb"
       group="fkb_nl" valid_values="" >
       Full pathname of neural network (FKB) model weight for aerosol activation emulator
       </entry>

<entry id="fkb_smax_model_txt" type="char*256" category="fkb"
       group="fkb_nl" valid_values="" >
       Full pathname of neural network (FKB) model weight for Smax emulator
       </entry>

<entry id="do_fkb_aerosol_optics" type="integer" category="fkb"
       group="fkb_nl" valid_values="" >
       Toggle neural network (FKB) aerosol optics options
       </entry>

<entry id="fkb_aer_opt_model1_txt" type="char*256" category="fkb"
       group="fkb_nl" valid_values="" >
       Full pathname of neural network (FKB) model weight for aerosol optics
       </entry>

<entry id="fkb_aer_opt_model2_txt" type="char*256" category="fkb"
       group="fkb_nl" valid_values="" >
       Full pathname of neural network (FKB) model weight for aerosol optics
       </entry>

<!-- There is a duplicated nml definitions for nudging parameters
     in the current master branch, and it is removed in the PR          -->
<!-- Nudging Parameters -->

<entry id="Nudge_Model" type="logical" category="nudging"
       group="nudging_nl" valid_values="" >
       Toggle Model Nudging ON/OFF.
       Default: FALSE
       </entry>

<entry id="Nudge_Allow_Missing_File" type="logical" category="nudging"
       group="nudging_nl" valid_values="" >
       User-defined flag to inform Nudging if all nudged data files exist.
       1. If .false.: all nudged data files must show up during the
           whole nudging period. Otherwise, the model will exit if a
           nudged data file is not found.
       2. If .true.: user allows the model to continue to run even if a
          nudged data file is not found. The model will continue to run with the
          nudging turned off, and only a warning message will be added to the
          simulation log file.
       Default: FALSE
       </entry>

<entry id="Nudge_Path" type="char*256" input_pathname="abs" category="nudging"
       group="nudging_nl" valid_values="" >
       Full pathname of analyses data to use for nudging.
       Default: none
       </entry>

<entry id="Nudge_File_Template" type="char*80" category="nudging"
       group="nudging_nl" valid_values="" >
       Template for Nudging analyses file names.
       Default: none
       </entry>

<entry id="Nudge_Times_Per_Day" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Number of analyses files per day.
       Default: none
       </entry>

<entry id="Model_Times_Per_Day" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Number of time to update model data per day.
       Default: none
       </entry>

<entry id="Nudge_Uprof" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Profile index for U nudging.
       Default: none
       </entry>

<entry id="Nudge_Ucoef" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Coeffcient for U nudging.
       Default: none
       </entry>

<entry id="Nudge_Vprof" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Profile index for V nudging.
       Default: none
       </entry>

<entry id="Nudge_Vcoef" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Coeffcient for V nudging.
       Default: none
       </entry>

<entry id="Nudge_Tprof" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Profile index for T nudging.
       Default: none
       </entry>

<entry id="Nudge_Tcoef" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Coeffcient for T nudging.
       Default: none
       </entry>

<entry id="Nudge_Qprof" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Profile index for Q nudging.
       Default: none
       </entry>

<entry id="Nudge_Qcoef" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Coeffcient for Q nudging.
       Default: none
       </entry>

<entry id="Nudge_PSprof" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Profile index for PS nudging.
       Default: none
       </entry>

<entry id="Nudge_PScoef" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Coeffcient for PS nudging.
       Default: none
       </entry>

<entry id="Nudge_Beg_Year" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Year at which Nudging Begins.
       Default: none
       </entry>

<entry id="Nudge_Beg_Month" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Month at which Nudging Begins.
       Default: none
       </entry>

<entry id="Nudge_Beg_Day" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Day at which Nudging Begins.
       Default: none
       </entry>

<entry id="Nudge_End_Year" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Year at which Nudging Ends.
       Default: none
       </entry>

<entry id="Nudge_End_Month" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Month at which Nudging Ends.
       Default: none
       </entry>

<entry id="Nudge_End_Day" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Day at which Nudging Ends.
       Default: none
       </entry>

<entry id="Nudge_Hwin_lo" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       LOW Coeffcient for Horizontal Window.
       Default: none
       </entry>

<entry id="Nudge_Hwin_hi" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       HIGH Coeffcient for Horizontal Window.
       Default: none
       </entry>

<entry id="Nudge_Hwin_lat0" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       LAT0 of Horizonalt Window.
       Default: none
       </entry>

<entry id="Nudge_Hwin_latWidth" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Width of LAT Window.
       Default: none
       </entry>

<entry id="Nudge_Hwin_latDelta" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Steepness of LAT Window.
       Default: none
       </entry>

<entry id="Nudge_Hwin_lon0" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       LON0 of Horizontal Window.
       Default: none
       </entry>

<entry id="Nudge_Hwin_lonWidth" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Width of LON Window.
       Default: none
       </entry>

<entry id="Nudge_Hwin_lonDelta" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Steepness of LON Window.
       Default: none
       </entry>

<entry id="Nudge_Vwin_lo" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       LOW Coeffcient for Vertical Window.
       Default: none
       </entry>

<entry id="Nudge_Vwin_hi" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       HIGH Coeffcient for Vertical Window.
       Default: none
       </entry>

<entry id="Nudge_Vwin_Hindex" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       HIGH Level Index for Verical Window.
       Default: none
       </entry>

<entry id="Nudge_Vwin_Hdelta" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Steepness of HIGH end of Vertical Window.
       Default: none
       </entry>

<entry id="Nudge_Vwin_Lindex" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       LOW Level Index for Verical Window.
       Default: none
       </entry>

<entry id="Nudge_Vwin_Ldelta" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Steepness of LOW end of Vertical Window.
       Default: none
       </entry>

<entry id="Nudge_Method" type="char*80" category="nudging"
       group="nudging_nl" valid_values="" >
       Method to perform Nudging analyses.
       1. Step: the model meteorology is nudged toward the same (future) time
          slice of the constraining data within each nudging window (e.g., 6-hr).
       2. Linear: the model meteorology is nudged toward the state at the next
          model time step, which is linearly interpolated between two neighboring
          time slices of the constraining data.
       3. IMT: the model meteorology is nudged toward the constraining data at
          the same model time step and nudging is only applied when the constrainging
          data is available.
       Default: Linear
       </entry>

<entry id="Nudge_Tau" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Use user-defined relaxation time scale (unit: hour).
       If Nudge_Tau > 0, the relaxation time scale is determined by Nudge_Tau;
       If not, the relaxation time scale is determined by Nudge_Times_Per_Day and nudging strength specified in the namelist (e.g. Nudge_Ucoef).
       Default: -999
       </entry>

<entry id="Nudge_Loc_PhysOut" type="logical" category="nudging"
       group="nudging_nl" valid_values="" >
       If TRUE, change the location of calculation of nudging tendency to
       the same location where the model state variables are written out.
       If FALSE, calculate the nudging tendency at the beginning of
       tphysbc (the same as the default model).
       Default: TRUE
       </entry>

<entry id="Nudge_CurrentStep" type="logical" category="nudging"
       group="nudging_nl" valid_values="" >
       Linearly interpolate nudging data to current (set to TRUE) or future
       (set to FALSE, used by the default model) model time step.
       Default: FALSE
       </entry>

<entry id="Nudge_File_Ntime" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Number of time slices per nudging data file
       The current nudging code only works for the nudging data file with one-day data.
       It does not work correctly when the nudging data file contains multiple-day data.
       Thus, Nudge_File_Ntime has to equal to 1 or Nudge_Times_Per_Day.
       Set default Nudge_File_Ntime to 0 to force the user to set its value correctly.
       Default: 0
       </entry>

<!-- Aerosols: Data (CAM version) -->

<entry id="bndtvaer" type="char*256" input_pathname="abs" category="aero_data_cam"
       group="cam3_aero_data_nl" valid_values="" >
Full pathname of time-variant boundary dataset for aerosol masses.
Default: set by build-namelist.
</entry>

<entry id="cam3_aero_data_on" type="logical" category="aero_data_cam"
       group="cam3_aero_data_nl" valid_values="" >
Add CAM3 prescribed aerosols to the physics buffer.
Default: FALSE
</entry>

<!-- Coupler between Physics and Dynamics -->

<entry id="phys_chnk_fdim" type="integer"  category="perf_dp_coup"
       group="cam_inparm" valid_values="">
The basic data structure for fields in the physics is the chunk. The
horizontal (column) dimension is factored between the first chunk dimension
and the number of chunks, with the size of the first dimension influencing
serial performance (e.g. vectorization or fit into cache) and the
number of chunks limiting the available MPI and OpenMP parallelism.
The number of chunks is always chosen to provide an equal number of chunks
per computational thread (subject to the constraint that each chunk is
assigned at least one column). However, the declared size of the first
dimension is a free parameter, indicating the maximum number of columns
that can be assigned to a chunk (thus also impacting the total number of
chunks). This was originally specified at compile-time, based on
experiments in the early 2000s indicating that the compilers at the time
generated more efficient code when the first dimension was known
at compile time, perhaps for improved alignment in memory layout or improved
vectorization. This is now exposed as a runtime parameter. If phys_chnk_fdim
is greater then 0, then the runtime pcols parameter is set to phys_chnk_fdim.
If phys_chnk_fdim is less than or equal to 0, then pcols is calculated based
on the values of the namelist variables phys_loadbalance, phys_chnk_fdim_max,
and phys_chnk_fdim_mult, and on the problem specifics, attempting to
minimize load imbalance between chunks, wasted space within chunks, and the
number of chunks. The original compile-time behavior can be restored by
defining the CPP token PPCOLS when building the model, in which case the
original compile-time maximum (PCOLS) is still used. Note that PPCOLS is
defined when the '-pcols' option is specifed in the call to CAM configure,
in which case PCOLS is set to value of the '-pcols' argument.
Default: 0
</entry>

<entry id="phys_chnk_fdim_max" type="integer"  category="perf_dp_coup"
       group="cam_inparm" valid_values="">
If phys_chnk_fdim is less than 1 (so runtime pcols is calculated)
and phys_chnk_fdim_max is greater than 0, then phys_chnk_fdim_max
is an upper bound on the size of the runtime pcols parameter.
Otherwise it is ignored.
Default: 16 when no overriding rules. See namelist_defaults_eam.xml
</entry>

<entry id="phys_chnk_fdim_mult" type="integer"  category="perf_dp_coup"
       group="cam_inparm" valid_values="">
If phys_chnk_fdim is less than 1 (so runtime pcols is calculated) and
phys_chnk_fdim_mult is greater than 1 and either phys_chnk_fdim_max is
less than 1 (so ignored) or phys_chnk_fdim_mult is less than or equal to
phys_chnk_fdim_max, then the runtime pcols is required to be an integer
multiple of phys_chnk_fdim_mult. This can be useful for memory alignment
of local variables.
Default: 1 when no overriding rules. See namelist_defaults_eam.xml
</entry>

<entry id="phys_alltoall" type="integer"  category="perf_dp_coup"
       group="cam_inparm" valid_values="0,1,2,11,12,13">
Dynamics/physics transpose method for nonlocal load-balance.  0: use
mpi_alltoallv. 1: use point-to-point MPI-1 two-sided implementation. 2: use
point-to-point MPI-2 one-sided implementation if supported, otherwise use
MPI-1 implementation. 3: use Co-Array Fortran implementation if supported,
otherwise use MPI-1 implementation. 11-13: use mod_comm, choosing any of
several methods internal to mod_comm.  The method within mod_comm (denoted
mod_method) has possible values 0,1,2 and is set according to mod_method =
phys_alltoall - modmin_alltoall, where modmin_alltoall is 11. -1: use
option 1 when each process communicates with less than half of the other
processes, otherwise use option 0 (approx.).
Default: -1
</entry>

<entry id="phys_chnk_cost_write" type="logical"  category="perf_dp_coup"
       group="cam_inparm" valid_values="">
Enable/disable output of measured physics cost per chunk.
Default: .true.
</entry>

<entry id="phys_chnk_per_thd" type="integer"  category="perf_dp_coup"
       group="cam_inparm" valid_values="">
Select target number of chunks per thread.  Must be positive.
Default: 1
</entry>

<entry id="phys_loadbalance" type="integer"  category="perf_dp_coup"
       group="cam_inparm" valid_values="">
Physics grid decomposition options.
-1: each chunk is a dynamics block.
 0: chunk definitions and assignments do not require interprocess comm.
 1: chunk definitions and assignments do not require internode comm.
 2: optimal diurnal, seasonal, and latitude load-balanced chunk definition and assignments.
 3: chunk definitions and assignments only require communication with one other process.
 4: concatenated blocks, no load balancing, no interprocess communication.
Default: 0
</entry>

<entry id="phys_twin_algorithm" type="integer"  category="perf_dp_coup"
       group="cam_inparm" valid_values="">
Physics grid decomposition options.
 0: assign columns to chunks as single columns, wrap mapped across chunks
 1: use (day/night; north/south) twin algorithm to determine load-balanced pairs of
      columns and assign columns to chunks in pairs, wrap mapped
Default: 0 for unstructured grid dycores, 1 for lat/lon grid dycores
</entry>

<!-- Diagnostics -->

<entry id="diag_cnst_conv_tend" type="char*8"  category="diagnostics"
       group="cam_diag_opts" valid_values="none,q_only,all" >
Output constituent tendencies due to convection.  Set to
'none', 'q_only' or 'all'.
Default: 'q_only', but 'none' for WACCM configurations.
</entry>

<entry id="do_circulation_diags" type="logical"  category="diagnostics"
       group="circ_diag_nl" valid_values="" >
Turns on TEM circulation diagnostics history output.  Only valid for FV dycore.

do_circulation_diags MUST be .true. in all FV cases with WACCM's QBO forcing
enabled. Cases with qbo_use_forcing = .true. and do_circulation_diags =
.false. will produce invalid output.

Default: .true. for WACCM, otherwise .false.
</entry>

<entry id="print_energy_errors" type="logical"  category="diagnostics"
       group="cam_inparm" valid_values="" >
Turn on verbose output identifying columns that fail energy/water
conservation checks.
Default: FALSE
</entry>

<!-- Dry Convective Adjustment -->

<entry id="nlvdry" type="integer"  category="dry_conv_adj"
       group="cam_inparm" valid_values="" >
Number of layers from the top of the model over which to do dry convective
adjustment. Must be less than plev (the number of vertical levels).
Default: 3
</entry>

<!-- Dynamics: Finite Volume -->

<entry id="ct_overlap" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Overlapping of trac2d and cd_core subcycles.
Default: 0
</entry>

<entry id="fft_flt" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="0,1" >
1 for FFT filter always, 0 for combined algebraic/FFT filter.  The value 0
is used for CAM3, otherwise it is using the value 1.  In the CAM3
version of the model it was necessary to build with the CPP
variable ALT_PFT defined to get the behavior now obtained by setting fft_flt=1.
Default: set by build-namelist
</entry>

<entry id="div24del2flag" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="2,4,42" >
Chooses type of divergence damping and velocity diffusion.
div24del2flag = 2 for ldiv2 (default),
              = 4 for ldiv4,
              = 42 for ldiv4 + ldel2
where
ldiv2: 2nd-order divergence damping everywhere and increasing in top layers
ldiv4: 4th-order divergence damping
ldel2: 2nd-order velocity-component damping targetted to top layers,
       with coefficient del2coef

Default: set by build-namelist
</entry>

<entry id="del2coef" type="real"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Chooses level of velocity diffusion.
Default: 3.0e5
</entry>

<entry id="filtcw" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="0,1" >
Enables optional filter for intermediate c-grid winds, (courtesy of Bill Putman).
Default: 0
</entry>

<entry id="force_2d" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
Set to 1 to force the 2D transpose computation when a 1D decomposition is
used.  This is intended for debugging purposes only.
Default: 0
</entry>

<entry id="geopktrans" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="0,1,2" >
Geopotential method (routines geopk, geopk16, or geopk_d).
0 for transpose method, 1 for method using semi-global z communication
with optional 16-byte arithmetic, 2 for method using local
z communication; method 0, method 1 with 16-byte arithmetic and method 2
are all bit-for-bit across decompositions; method 0 scales better than
method 1 with npr_z, and method 1 is superior to method 0 for small npr_z.
The optimum speed is attained using either method 1 with 8-byte
arithmetic (standard for geopk16) or method 2 when utilizing the
optimal value for the associated parameter geopkblocks; for the last
two subcycles of a timestep, method 0 is automatically used; see
geopk.F90 and cd_core.F90.

Default: 0
</entry>

<entry id="geopkblocks" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
Geopotential method 2 pipeline parameter (routine geopk_d).
geopk_d implements a pipeline algorithm by dividing the
information that must be moved between processes into blocks. geopkblocks
specifies the number of blocks to use. The larger the number of blocks,
the greater the opportunity for overlapping communication with computation
and for decreasing instantaneous bandwidth requirements. The smaller the
number of blocks, the fewer MPI messages sent, decreasing MPI total latency.
See geopk_d within geopk.F90.
Default: 1
</entry>

<entry id="modc_sw_dynrun" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
Mod_comm irregular underlying communication method for dyn_run/misc.
0 for original mp_sendirr/mp_recvirr
1 for mp_swapirr and a point-to-point implementation of communication pattern
2 for mp_swapirr and a collective (MPI_Alltoallv) implementation of communication pattern
Default: 0
</entry>

<entry id="modc_hs_dynrun" type="logical"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication handshaking for dyn_run/misc
Default: .true.
</entry>

<entry id="modc_send_dynrun" type="logical"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication blocking send for dyn_run/misc,
false for nonblocking send
Default: .true.
</entry>

<entry id="modc_mxreq_dynrun" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
Maximum number of outstanding nonblocking MPI requests to allow when
using mp_swapirr and point-to-point communications for dyn_run/misc.
Setting this less than the maximum can improve robustness for large process
count runs. If set to less than zero, then do not limit the number of
outstanding send/receive requests.
Default: -1 (so no limit)
</entry>

<entry id="modc_sw_cdcore" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
Mod_comm irregular underlying communication method for cd_core/geopk
0 for original mp_sendirr/mp_recvirr
1 for mp_swapirr and a point-to-point implementation of communication pattern
2 for mp_swapirr and a collective (MPI_Alltoallv) implementation of communication pattern
Default: 0
</entry>

<entry id="modc_hs_cdcore" type="logical"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication handshaking for cd_core/geopk
Default: .true.
</entry>

<entry id="modc_send_cdcore" type="logical"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
True for geopk_d and mod_comm irregular communication blocking send for
cd_core/geopk; false for nonblocking send.
Default: .true.
</entry>

<entry id="modc_mxreq_cdcore" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
Maximum number of outstanding nonblocking MPI requests to allow when
using mp_swapirr and point-to-point communications for cd_core/geopk.
Setting this less than the maximum can improve robustness for large process
count runs. If set to less than zero, then do not limit the number of
outstanding send/receive requests.
Default: -1 (so no limit)
</entry>

<entry id="modc_sw_gather" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
Mod_comm irregular underlying communication method for gather
0 for original mp_sendirr/mp_recvirr
1 for mp_swapirr and a point-to-point implementation of communication pattern
2 for mp_swapirr and a collective (MPI_Alltoallv) implementation of communication pattern
Default: 0
</entry>

<entry id="modc_hs_gather" type="logical"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication handshaking for gather
Default: .true.
</entry>

<entry id="modc_send_gather" type="logical"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication blocking send for gather,
false for nonblocking send
Default: .true.
</entry>

<entry id="modc_mxreq_gather" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
Maximum number of outstanding nonblocking MPI requests to allow when
using mp_swapirr and point-to-point communications for gather.
Setting this less than the maximum can improve robustness for large process
count runs. If set to less than zero, then do not limit the number of
outstanding send/receive requests.
Default: -1 (so no limit)
</entry>

<entry id="modc_sw_scatter" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
Mod_comm irregular underlying communication method for scatter
0 for original mp_sendirr/mp_recvirr
1 for mp_swapirr and a point-to-point implementation of communication pattern
2 for mp_swapirr and a collective (MPI_Alltoallv) implementation of communication pattern
Default: 0
</entry>

<entry id="modc_hs_scatter" type="logical"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication handshaking for scatter
Default: .true.
</entry>

<entry id="modc_send_scatter" type="logical"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication blocking send for scatter,
false for nonblocking send
Default: .true.
</entry>

<entry id="modc_mxreq_scatter" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
Maximum number of outstanding nonblocking MPI requests to allow when
using mp_swapirr and point-to-point communications for scatter.
Setting this less than the maximum can improve robustness for large process
count runs. If set to less than zero, then do not limit the number of
outstanding send/receive requests.
Default: -1 (so no limit)
</entry>

<entry id="modc_sw_tracer" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
Mod_comm irregular underlying communication method for multiple tracers
0 for original mp_sendtrirr/mp_recvtrirr
1 for mp_swaptrirr and point-to-point communications
2 for mp_swaptrirr and all-to-all communications
Default: 0
</entry>

<entry id="modc_hs_tracer" type="logical"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication handshaking for multiple tracers
Default: .true.
</entry>

<entry id="modc_send_tracer" type="logical"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication blocking send for multiple
tracers, false for nonblocking send
Default: .true.
</entry>

<entry id="modc_mxreq_tracer" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
Maximum number of outstanding nonblocking MPI requests to allow when
using mp_swaptrirr and point-to-point communications for multiple tracers.
Setting this less than the maximum can improve robustness for large process
count runs. If set to less than zero, then do not limit the number of
outstanding send/receive requests.
Default: -1 (so no limit)
</entry>

<entry id="modc_onetwo" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
One or two simultaneous mod_comm irregular communications (excl. tracers)
Default: 1
</entry>

<entry id="modc_tracers" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
Max number of tracers for simultaneous mod_comm irregular communications
Default: 1
</entry>

<entry id="iord" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Order (mode) of X interpolation (1,..,6).
East-West transport scheme (used with Finite Volume dynamical core only).
Default: 4
</entry>

<entry id="jord" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Order (mode) of Y interpolation (1,..,6).
North-South transport scheme (used with Finite Volume dynamical core only).
Default: 4
</entry>

<entry id="kord" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Scheme to be used for vertical mapping.
Default: 4
</entry>

<entry id="modcomm_gatscat" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="0,1,2" >
For mod_comm gather/scatters, 0 for temporary contiguous buffers; 1 for mpi derived
types.
Default: 0
</entry>

<entry id="modcomm_geopk" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="0,1,2" >
For geopk (geopktrans=1) messages, 0 for temporary contiguous buffers; 1 for mpi derived
types.
Default: 0
</entry>

<entry id="modcomm_transpose" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="0,1,2" >
For mod_comm transposes, 0 for temporary contiguous buffers; 1 for mpi derived
types.
Default: 0
</entry>

<entry id="npr_yz" type="integer(4)"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
A four element integer array which specifies the YZ and XY decompositions.
The first two elements are the number of Y subdomains and number of Z
subdomains in the YZ decomposition.  The second two elements are the number
of X subdomains and the number of Y subdomains in the XY decomposition.
Note that both the X and Y subdomains must contain at least 3 grid points.
For example, a grid with 96 latitudes can contain no more than 32 Y
subdomains.  There is no restriction on the number of grid points (levels)
in a Z subdomain, but note that the threading parallelism in the FV dycore
is over levels, so for parallel efficiency it is best to have at least the
number of levels in each Z subdomain as there are threads available.

There are a couple of rough rules of thumb to follow when setting the 2D
decompositions.  The first is that the number of Y subdomains in the YZ
decomposition should be the same as the number of Y subdomains in the XY
decomposition (npr_yz(1) == npr_yz(4)).  The second is that the total
number of YZ subdomains (npr_yz(1)*npr_yz(2)) should equal the total number
of XY subdomains (npr_yz(3)*npr_yz(4)).

Default: ntask,1,1,ntask where ntask is the number of MPI tasks.  This is a
1D decomposition in latitude.
</entry>

<entry id="nsplit" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Number of dynamics timesteps per physics timestep. If zero, a best-estimate
will be automatically calculated.
Default: 0
</entry>

<entry id="nspltrac" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Number of tracer advection timesteps per physics timestep.
Nsplit is partitioned into nspltrac and nsplit/nspltrac,
with the latter being the number of dynamics timesteps per
tracer timestep, possibly rounded upward; after initialization,
the code quantity nsplit is redefined to be the number of
dynamics timesteps per tracer timestep.
Default: 0
</entry>

<entry id="nspltvrm" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Number of vertical re-mapping timesteps per physics timestep.
Nspltrac is partitioned into nspltvrm and nspltrac/nspltvrm,
with the latter being the number of tracer timesteps per
re-mapping timestep, possibly rounded upward; after initialization,
the code quantity nspltrac is redefined to be the number of
tracer timesteps per re-mapping timestep.
Default: 0
</entry>

<entry id="trac_decomp" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Size of tracer domain decomposition for trac2d.
Default: 1
</entry>


<!-- Dynamics: Finite Volume: Offline -->

<entry id="met_cell_wall_winds" type="logical"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
TRUE =&gt; the offline meteorology winds are defined on the model grid cell walls.
Default: FALSE
</entry>

<entry id="met_data_file" type="char*256" input_pathname="rel:met_data_path" category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
Name of file that contains the offline meteorology data.
Default: none
</entry>

<entry id="met_data_path" type="char*256" input_pathname="abs" category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
Name of directory that contains the offline meteorology data.
Default: none
</entry>

<entry id="met_filenames_list" type="char*256" input_pathname="abs" category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
Name of file that contains names of the offline meteorology data files.
Default: none
</entry>

<entry id="met_remove_file" type="logical"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
TRUE =&gt; the offline meteorology file will be removed from local disk when no longer needed.
Default: FALSE
</entry>

<entry id="met_rlx_top" type="real"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
(km) top of relaxation region of winds for offline waccm
Default:
</entry>

<entry id="met_rlx_bot" type="real"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
(km) bottom of relaxation region of winds for offline waccm
Default:
</entry>

<entry id="met_max_rlx" type="real"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
maximum of vertical relaxation function in bottom portion
Default: 1.0
</entry>

<entry id="met_fix_mass" type="logical"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
switch to turn on/off mass fixer for offline driver
Default: true
</entry>

<entry id="met_shflx_name" type="char*16"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
srf heat flux field name in met data file
Default:
</entry>

<entry id="met_qflx_name" type="char*16"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
water vapor flux field name in met data file
Default:
</entry>

<entry id="met_shflx_factor" type="real"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
multiplication factor for srf heat flux
Default: 1.0
</entry>

<entry id="met_qflx_factor" type="real"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
multiplication factor for water vapor flux
Default: 1.0
</entry>

<entry id="met_snowh_factor" type="real"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
multiplication factor for snow hieght
Default: 1.0
</entry>

<entry id="met_srf_feedback" type="logical"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
if false then do not allow surface models feedbacks influence climate
Default: true
</entry>

<entry id="met_srf_nudge_flux" type="logical"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
if true nudge meteorology surface fields TAUX, TAUY, SHFLX, QFLX rather than force
Default: true
</entry>

<!-- Dynamics: Spectral -->

<entry id="eul_nsplit" type="integer"  category="dyn_spectral"
       group="dyn_spectral_inparm" valid_values="" >
Number of dynamics timesteps per physics timestep. If zero, a best-estimate
will be automatically calculated.
Default: 1
</entry>

<entry id="dif2" type="real"  category="dyn_spectral"
       group="dyn_spectral_inparm" valid_values="" >
del^2 horizontal diffusion coefficient. Default: resolution dependent,
e.g. 2.5e5 for T42 EUL.
</entry>

<entry id="dif4" type="real"  category="dyn_spectral"
       group="dyn_spectral_inparm" valid_values="">
del^4 horizontal diffusion coefficient. Default: resolution dependent,
e.g. 1.0e16 for T42 EUL.
</entry>

<entry id="divdampn" type="real"  category="dyn_spectral"
       group="dyn_spectral_inparm" valid_values="">
Number of days (from timestep 0) to run divergence damper. Use only if spectral
model becomes dynamicallly unstable during initialization. Suggested value:
2. (Value must be &gt;= 0.)  Default: 0.
</entry>

<entry id="dyn_allgather" type="integer"  category="dyn_spectral"
       group="spmd_dyn_inparm" valid_values="">
Spectral dynamics gather option.
Default: 0
</entry>

<entry id="dyn_alltoall" type="integer"  category="dyn_spectral"
       group="spmd_dyn_inparm" valid_values="">
Spectral dynamics transpose option.
Default: 0
</entry>

<entry id="dyn_equi_by_col" type="logical"  category="dyn_spectral"
       group="spmd_dyn_inparm" valid_values="">
Flag indicating whether to assign latitudes to equidistribute columns or
latitudes. This only matters when using a reduced grid.
Default: TRUE
</entry>

<entry id="dyn_npes" type="integer"  category="dyn_spectral"
       group="spmd_dyn_inparm" valid_values="">
Number of processes assigned to dynamics (SE, EUL and SLD dycores).
Default: Total number of processes assigned to job.
</entry>

<entry id="dyn_npes_stride" type="integer"  category="dyn_spectral"
       group="spmd_dyn_inparm" valid_values="">
Stride for dynamics processes (EUL and SLD dycores).
E.g., if stride=2, assign every second process to the dynamics.
Default: 1
</entry>

<entry id="eps" type="real"  category="dyn_spectral"
       group="dyn_spectral_inparm" valid_values="">
Time filter coefficient.  Default: 0.06
</entry>

<entry id="kmxhdc" type="integer"  category="dyn_spectral"
       group="dyn_spectral_inparm" valid_values="">
Number of levels over which to apply Courant limiter, starting at top of
model.
Default: 5
</entry>

<!-- Fixers -->

<entry id="use_mass_borrower" type="logical" category="fixers"
       group="phys_ctl_nl" valid_values="" >
Whether or not to use the new mass borrower (instead of QNEG3).
Default: set by build-namelist.
</entry>

<entry id="use_qqflx_fixer" type="logical" category="fixers"
       group="phys_ctl_nl" valid_values="" >
Whether or not to use the new qqflx fixer (instead of QNEG4).
Default: set by build-namelist.
</entry>

<entry id="print_fixer_message" type="logical" category="fixers"
       group="phys_ctl_nl" valid_values="" >
Whether or not to printout fixer diagnostic message.
Default: set by build-namelist.
</entry>

<entry id="ieflx_opt" type="integer"  category="fixers"
       group="phys_ctl_nl" valid_values="">
IEFLX fixer options
Default: 0
</entry>

<!-- Gravity Wave Drag -->

<entry id="use_gw_oro" type="logical" category="gw_drag"
       group="phys_ctl_nl" valid_values="" >
Whether or not to enable gravity waves produced by orography.
Default: set by build-namelist.
</entry>

<entry id="use_gw_front" type="logical" category="gw_drag"
       group="phys_ctl_nl" valid_values="" >
Whether or not to enable gravity waves produced by frontogenesis.
Default: set by build-namelist.
</entry>

<entry id="use_gw_convect" type="logical" category="gw_drag"
       group="phys_ctl_nl" valid_values="" >
Whether or not to enable gravity waves produced by convection.
Default: set by build-namelist.
</entry>

<entry id="use_gw_energy_fix" type="logical" category="gw_drag"
       group="phys_ctl_nl" valid_values="" >
Whether or not to enable GWD brute-force energy fix.
Default: set by build-namelist.
</entry>

<entry id="pgwv" type="integer" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Gravity wave spectrum dimension (wave numbers are from -pgwv to pgwv).
Default: set by build-namelist.
</entry>

<entry id="gw_dc" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Width of speed bins (delta c) for gravity wave spectrum (reference wave
speeds are from -pgwv*dc to pgwv*dc).
Default: set by build-namelist.
</entry>

<entry id="tau_0_ubc" type="logical" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Force the stress due to gravity waves to be zero at the top of the model.
In the low-top model, this helps to conserve momentum and produce a QBO.
Default: set by build-namelist.
</entry>

<entry id="gw_convect_hcf" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Heating rate conversion factor associated with convective gravity waves
Default: 20.0
</entry>

<entry id="effgw_beres" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Efficiency associated with convective gravity waves from the Beres
scheme.
Default: set by build-namelist.
</entry>

<entry id="effgw_cm" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Efficiency associated with gravity waves from frontogenesis.
Default: set by build-namelist.
</entry>

<entry id="effgw_oro" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Efficiency associated with orographic gravity waves.
Default: set by build-namelist.
</entry>

<entry id="fcrit2" type="real"  category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Critical Froude number squared.
Default: set by build-namelist.
</entry>

<entry id="frontgfc" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Frontogenesis function critical threshold.
Default: set by build-namelist.
</entry>

<entry id="gw_drag_file" type="char*256" input_pathname="abs" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Full pathname of Beres lookup table data file for gravity waves.
Default: set by build-namelist.
</entry>

<entry id="taubgnd" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Background source strength (used for waves from frontogenesis).
Default: set by build-namelist.
</entry>

<!-- Greenhouse Gases: CO2, CH4, N2O, CFC11, CFC12 (original CAM versions) -->

<entry id="bndtvghg" type="char*256" input_pathname="abs" category="ghg_cam"
       group="chem_surfvals_nl" valid_values="" >
Full pathname of time-variant boundary dataset for greenhouse gas surface
values.
Default: set by build-namelist.
</entry>

<entry id="ch4vmr" type="real"  category="ghg_cam"
       group="chem_surfvals_nl" valid_values="" >
CH4 volume mixing ratio.  This is used as the time invariant surface value
of CH4 if no time varying values are specified.
Default: set by build-namelist.
</entry>

<entry id="co2vmr" type="real"  category="ghg_cam"
       group="chem_surfvals_nl" valid_values="" >
CO2 volume mixing ratio.  This is used as the time invariant surface value
of CO2 if no time varying values are specified.
Default: set by build-namelist.
</entry>

<entry id="co2vmr_rad" type="real"  category="ghg_cam"
       group="chem_surfvals_nl" valid_values="" >
User override for the prescribed CO2 volume mixing ratio used by the radiation
calculation.  Note however that the prescribed value of CO2 which is sent
to the surface models is still the one that is set using either the
<varname>co2vmr</varname> or the <varname>scenario_ghg</varname> variables.
Default: not used
</entry>

<entry id="f11vmr" type="real"  category="ghg_cam"
       group="chem_surfvals_nl" valid_values="" >
CFC11 volume mixing ratio adjusted to reflect contributions from many GHG
species.  This is used as the time invariant surface value of F11 if no
time varying values are specified.
Default: set by build-namelist.
</entry>

<entry id="f12vmr" type="real"  category="ghg_cam"
       group="chem_surfvals_nl" valid_values="" >
CFC12 volume mixing ratio.  This is used as the time invariant surface value
of CFC12 if no time varying values are specified.
Default: set by build-namelist.
</entry>

<entry id="n2ovmr" type="real"  category="ghg_cam"
       group="chem_surfvals_nl" valid_values="" >
N2O volume mixing ratio.  This is used as the time invariant surface value
of N2O if no time varying values are specified.
Default: 0.311e-6
</entry>

<entry id="ghg_yearstart_data" type="integer"  category="ghg_cam"
       group="chem_surfvals_nl" valid_values="" >
Data start year.  Use in conjunction
with <varname>ghg_yearstart_model</varname>.
Default: 0
</entry>

<entry id="ghg_yearstart_model" type="integer"  category="ghg_cam"
       group="chem_surfvals_nl" valid_values="" >
Model start year.  Use in conjunction
with <varname>ghg_yearstart_data</varname>.
Default: 0
</entry>

<entry id="ramp_co2_annual_rate" type="real"  category="ghg_cam"
       group="chem_surfvals_nl" valid_values="" >
Amount of co2 ramping per year (percent).  Only used
if <varname>scenario_ghg</varname> = 'RAMP_CO2_ONLY'
Default: 1.0
</entry>

<entry id="ramp_co2_cap" type="real"  category="ghg_cam"
       group="chem_surfvals_nl" valid_values="" >
CO2 cap if &gt; 0, floor otherwise.  Specified as multiple or fraction of
inital value; e.g., setting to 4.0 will cap at 4x initial CO2 setting.
Only used if <varname>scenario_ghg</varname> = 'RAMP_CO2_ONLY'
Default: boundless if <varname>ramp_co2_annual_rate</varname> &gt; 0, zero otherwise.
</entry>

<entry id="ramp_co2_start_ymd" type="integer"  category="ghg_cam"
       group="chem_surfvals_nl" valid_values="" >
Date on which ramping of co2 begins.  The date is encoded as an integer in
the form YYYYMMDD.  Only used if <varname>scenario_ghg</varname> = 'RAMP_CO2_ONLY'
Default: 0
</entry>

<entry id="rampyear_ghg" type="integer"  category="ghg_cam"
       group="chem_surfvals_nl" valid_values="" >
If <varname>scenario_ghg</varname> is set to "RAMPED" then the greenhouse
gas surface values are interpolated between the annual average values
read from the file specified by <varname>bndtvghg</varname>.
In that case, the value of this variable (&gt; 0) fixes the year of the
lower bounding value (i.e., the value for calendar day 1.0) used in the
interpolation.  For example, if rampyear_ghg = 1950, then the GHG surface
values will be the result of interpolating between the values for 1950 and
1951 from the dataset.
Default: 0
</entry>

<entry id="scenario_ghg" type="char*16"  category="ghg_cam"
       group="chem_surfvals_nl" valid_values="FIXED,RAMPED,RAMP_CO2_ONLY,CHEM_LBC_FILE" >
Controls treatment of prescribed co2, ch4, n2o, cfc11, cfc12 volume mixing
ratios.  May be set to 'FIXED', 'RAMPED', 'RAMP_CO2_ONLY', or 'CHEM_LBC_FILE'.
FIXED =&gt; volume mixing ratios are fixed and have either default or namelist
         input values.
RAMPED =&gt; volume mixing ratios are time interpolated from the dataset
          specified by <varname>bndtvghg</varname>.
RAMP_CO2_ONLY =&gt; only co2 mixing ratios are ramped at a rate determined by
                    the variables <varname>ramp_co2_annual_rate</varname>, <varname>ramp_co2_cap</varname>,
                    and <varname>ramp_co2_start_ymd</varname>.
CHEM_LBC_FILE =&gt; volume mixing ratios are set from the chemistry lower boundary
                    conditions dataset specified by <varname>flbc_file</varname>.
Default: FIXED
</entry>

<!-- Greenhouse Gases: prognostic CH4, N2O, CFC11, CFC12 (original CAM versions) -->

<entry id="bndtvg" type="char*256" input_pathname="abs" category="ghg_chem"
       group="chem_inparm" valid_values="" >
Full pathname of time-variant boundary dataset for greenhouse gas production/loss
rates.  Only used by the simple prognostic GHG chemistry scheme that is
enabled via the argument "-prog_species GHG" to configure.
Default: set by build-namelist.
</entry>

<entry id="ghg_chem" type="logical"  category="ghg_chem"
       group="chem_inparm" valid_values="" >
This variable should not be set by the user.  It is set by build-namelist
when the user specifies the argument "-prog_species GHG" to configure which
turns on a simple prognostic chemistry scheme for CH4, N2O, CFC11 and
CFC12.
Default: set by build-namelist
</entry>


<!-- CO2 cycle for BGC -->

<entry id="co2_cycle_rad_passive" type="logical" category="co2_cycle"
       group="camexp" valid_values="" >
Flag to set rad_climate variable so that the prognostic CO2 controlled by
the co2_cycle module is radiatively passive.
Default: FALSE
</entry>

<entry id="co2_flag" type="logical"  category="co2_cycle"
       group="co2_cycle_nl" valid_values="" >
If TRUE turn on CO2 code.
Default: FALSE
</entry>

<entry id="co2_readflux_fuel" type="logical"  category="co2_cycle"
       group="co2_cycle_nl" valid_values="" >
If TRUE read co2 flux from fuel.
Default: FALSE
</entry>

<entry id="co2_readflux_ocn" type="logical"  category="co2_cycle"
       group="co2_cycle_nl" valid_values="" >
If TRUE read co2 flux from ocn.
Default: FALSE
</entry>

<entry id="co2_readflux_aircraft" type="logical"  category="co2_cycle"
       group="co2_cycle_nl" valid_values="" >
If TRUE read co2 aircraft flux from file.
Default: set by build-namelist
</entry>


<entry id="co2flux_ocn_file" type="char*256" input_pathname="abs" category="co2_cycle"
       group="co2_cycle_nl" valid_values="" >
Filepath for dataset containing CO2 flux from ocn.
Default: none
</entry>

<entry id="co2flux_fuel_file" type="char*256" input_pathname="abs" category="co2_cycle"
       group="co2_cycle_nl" valid_values="" >
Filepath for dataset containing CO2 flux from fossil fuel.
Default: none
</entry>

<entry id="co2_print_diags_timestep" type="logical"  category="co2_cycle"
       group="co2_cycle_nl" valid_values="" >
If TRUE print out CO2 conservation checks every timestep.
Default: FALSE
</entry>

<entry id="co2_print_diags_monthly" type="logical"  category="co2_cycle"
       group="co2_cycle_nl" valid_values="" >
If TRUE print out CO2 conservation checks monthly.
Default: FALSE
</entry>

<entry id="co2_print_diags_total" type="logical"  category="co2_cycle"
       group="co2_cycle_nl" valid_values="" >
If TRUE print out a CO2 conservation for the lenght of the run.
Default: FALSE
</entry>

<entry id="co2_conserv_error_tol_per_year" type="real" category="co2_cycle"
       group="co2_cycle_nl" valid_values="" >
error tolerance for CO2 conservation
Default: 5.e-13
</entry>

<!-- CondiDiag-->

<entry id="metric_name" type="char*8(10)"  category="history"
       group="conditional_diag_nl" valid_values="" >
List of fields to use as metrics in conditional sampling.
Default: none
</entry>

<entry id="metric_nver" type="integer(10)"  category="history"
       group="conditional_diag_nl" valid_values="" >
Numbers of vertical levels of the metrics used in conditional sampling
Different metrics can have different vertical dimension sizes.
Default: none
</entry>

<entry id="metric_cmpr_type" type="integer(10)"  category="history"
       group="conditional_diag_nl" valid_values="-2,-1,0,1,2" >
Types of comparison to be used in conditional sampling:
-2 means .le.,
-1 means .lt.,
 0 means .eq. within tolerance,
 1 means .gt.,
 2 means .ge..
Different metrics can have different comparison types.
Default: none
</entry>

<entry id="metric_threshold" type="real(10)"  category="history"
       group="conditional_diag_nl" valid_values="" >
Thresholds to be used in conditional sampling.
Different metrics can have different thresholds.
Default: none
</entry>

<entry id="metric_tolerance" type="real(10)"  category="history"
       group="conditional_diag_nl" valid_values="" >
Tolerances for the "equal to" comparison type if the type is
specified using metric_cmpr_type. The values are ignored
if other comparison types are specified.
Default: none
</entry>

<entry id="cnd_eval_chkpt" type="char*10(10)"  category="history"
       group="conditional_diag_nl" valid_values="" >
A list. Each element specifies the checkpoint at which the
corresponding conditional sampling criterion
will be evaluated. The number of checkpoints specified here
should match the number of non-empty elements in metric_name;
Default: none
</entry>

<entry id="cnd_end_chkpt" type="char*10(10)"  category="history"
       group="conditional_diag_nl" valid_values="" >
A list. Each element specifies the checkpoint that marks the end
of validity of the corresponding sampling condition.
At this checkpoint, the masking of QoIs will be done
and the masked values will be sent to history buffer.
Default: none
</entry>

<entry id="qoi_name" type="char*8(20)"  category="history"
       group="conditional_diag_nl" valid_values="" >
List of fields (Quantities of Interest, QoIs) to be
monitored or conditionally sampled.
Default: none
</entry>

<entry id="qoi_nver" type="integer(20)"  category="history"
       group="conditional_diag_nl" valid_values="" >
Dimension sizes of the QoIs.
Default: none
</entry>

<entry id="qoi_x_dp" type="integer(20)"  category="history"
       group="conditional_diag_nl" valid_values="" >
Whether a QoI should be multiplied by dp for output;
if so, wet or dry.
Default: none
</entry>


<entry id="qoi_chkpt" type="char*10(250)"  category="history"
       group="conditional_diag_nl" valid_values="" >
Checkpoints at which QoIs will be monitored or conditionally sampled.
Default: none
</entry>

<entry id="chkpt_x_dp" type="integer(250)"  category="history"
       group="conditional_diag_nl" valid_values="" >
Whether QoIs at a checkpoint should be multiplied by dp
for output if applicable; if so, wet or dry.
Default: none
</entry>

<entry id="l_output_state" type="logical"  category="history"
       group="conditional_diag_nl" valid_values=".true.,.false." >
Whether the state of the above-specified fields will be written
to history file(s).
Default: none
</entry>

<entry id="l_output_incrm" type="logical"  category="history"
       group="conditional_diag_nl" valid_values=".true.,.false." >
Whether the increments of the above-specified fields will be written
to history file(s).
Default: none
</entry>

<entry id="hist_tape_with_all_output" type="integer(10)"  category="history"
       group="conditional_diag_nl" valid_values="" >
Indices of history tapes that will each contain a whole suite of CondiDiag output.
Default: none
</entry>

<!-- History and Initial Conditions Output -->

<entry id="avgflag_pertape" type="char*1(15)"  category="history"
       group="cam_history_nl" valid_values="A,B,I,X,M" >
Sets the averaging flag for all variables on a particular history file
series. Valid values are:

 A ==&gt; Average
 B ==&gt; GMT 00:00:00 average
 I ==&gt; Instantaneous
 M ==&gt; Minimum
 X ==&gt; Maximum

The default is to use the averaging flags for each variable that are set in
the code via calls to subroutine addfld.

Defaults: set in code via the addfld and add_default subroutine calls.
</entry>

<entry id="empty_htapes" type="logical"  category="history"
       group="cam_history_nl" valid_values="" >
If true don't put any of the variables on the history tapes by
default. Only output the variables that the user explicitly lists in
the <varname>fincl#</varname> namelist items.  Default: FALSE
</entry>

<entry id="fexcl1" type="char*24(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of fields to exclude from the 1st history file (by default the name
of this file contains the string "h0").
Default: none
</entry>
<entry id="fexcl2" type="char*24(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of fields to exclude from the 2nd history file (by default the name
of this file contains the string "h1").
Default: none
</entry>
<entry id="fexcl3" type="char*24(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of fields to exclude from the 3rd history file (by default the name
of this file contains the string "h2").
Default: none
</entry>
<entry id="fexcl4" type="char*24(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of fields to exclude from the 4th history file (by default the name
of this file contains the string "h3").
Default: none
</entry>
<entry id="fexcl5" type="char*24(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of fields to exclude from the 5th history file (by default the name
of this file contains the string "h4").
Default: none
</entry>
<entry id="fexcl6" type="char*24(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of fields to exclude from the 6th history file (by default the name
of this file contains the string "h5").
Default: none
</entry>
<entry id="fexcl7" type="char*24(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of fields to exclude from the 7th history file (by default the name
of this file contains the string "h6").
Default: none
</entry>
<entry id="fexcl8" type="char*24(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of fields to exclude from the 8th history file (by default the name
of this file contains the string "h7").
Default: none
</entry>
<entry id="fexcl9" type="char*24(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of fields to exclude from the 9th history file (by default the name
of this file contains the string "h8").
Default: none
</entry>
<entry id="fexcl10" type="char*24(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of fields to exclude from the 10th history file (by default the name
of this file contains the string "h9").
Default: none
</entry>
<entry id="fexcl11" type="char*24(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of fields to exclude from the 11th history file (by default the name
of this file contains the string "h10").
Default: none
</entry>
<entry id="fexcl12" type="char*24(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of fields to exclude from the 12th history file (by default the name
of this file contains the string "h11").
Default: none
</entry>
<entry id="fexcl13" type="char*24(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of fields to exclude from the 13th history file (by default the name
of this file contains the string "h12").
Default: none
</entry>
<entry id="fexcl14" type="char*24(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of fields to exclude from the 14th history file (by default the name
of this file contains the string "h13").
Default: none
</entry>
<entry id="fexcl15" type="char*24(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of fields to exclude from the 15th history file (by default the name
of this file contains the string "h14").
Default: none
</entry>

<entry id="fincl1" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of fields to include on the first history file (by default the name of
this file contains the string "h0").  The added fields must be in Master
Field List.  The averaging flag for the output field can be specified by
appending a ":" and a valid averaging flag to the field name.  Valid flags
are:

 A ==&gt; Average
 B ==&gt; GMT 00:00:00 average
 I ==&gt; Instantaneous
 M ==&gt; Minimum
 X ==&gt; Maximum

Default:  set in code via the addfld and add_default subroutine calls.
</entry>
<entry id="fincl2" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for the 2nd history file (by default
the name of this file contains the string "h1").
Default: none.
</entry>
<entry id="fincl3" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for the 3rd history file (by default
the name of this file contains the string "h2").
Default: none.
</entry>
<entry id="fincl4" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for the 4th history file (by default
the name of this file contains the string "h3").
Default: none.
</entry>
<entry id="fincl5" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for the 5th history file (by default
the name of this file contains the string "h4").
Default: none.
</entry>
<entry id="fincl6" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for the 6th history file (by default
the name of this file contains the string "h5").
Default: none.
</entry>
<entry id="fincl7" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for the 7th history file (by default
the name of this file contains the string "h6").
Default: none.
</entry>
<entry id="fincl8" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for the 8th history file (by default
the name of this file contains the string "h7").
Default: none.
</entry>
<entry id="fincl9" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for the 9th history file (by default
the name of this file contains the string "h8").
Default: none.
</entry>
<entry id="fincl10" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for the 10th history file (by default
the name of this file contains the string "h9").
Default: none.
</entry>
<entry id="fincl11" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for the 11th history file (by default
the name of this file contains the string "h10").
Default: none.
</entry>
<entry id="fincl12" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for the 12th history file (by default
the name of this file contains the string "h11").
Default: none.
</entry>
<entry id="fincl13" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for the 13th history file (by default
the name of this file contains the string "h12").
Default: none.
</entry>
<entry id="fincl14" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for the 14th history file (by default
the name of this file contains the string "h13").
Default: none.
</entry>
<entry id="fincl15" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for the 15th history file (by default
the name of this file contains the string "h14").
Default: none.
</entry>

<entry id="clubb_history" type="logical"  category="history"
       group="clubb_his_nl" valid_values="" >
if .true. then output CLUBBs history statistics
</entry>

<entry id="clubb_rad_history" type="logical"  category="history"
       group="clubb_his_nl" valid_values="" >
if .true. then output CLUBBs radiative history statistics
</entry>

<entry id="clubb_vars_zt" type="char*16(10000)"  category="history"
       group="clubb_stats_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for CLUBB statistics on zt grid.
Default: none.
</entry>

<entry id="clubb_vars_zm" type="char*16(10000)"  category="history"
       group="clubb_stats_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for CLUBB statistics on zm grid.
Default: none.
</entry>

<entry id="clubb_vars_rad_zt" type="char*16(10000)"  category="history"
       group="clubb_stats_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for CLUBB statistics on radiation zt grid.
Default: none.
</entry>

<entry id="clubb_vars_rad_zm" type="char*16(10000)"  category="history"
       group="clubb_stats_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for CLUBB statistics on radiation zm grid.
Default: none.
</entry>

<entry id="clubb_vars_sfc" type="char*16(10000)"  category="history"
       group="clubb_stats_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for CLUBB statistics on surface.
Default: none.
</entry>

<entry id="clubb_iop_name" type="char*200"  category="history"
       group="scm_nl" valid_values="" >
Name of the IOP case so case specific adjustments can be made in CLUBB.
Default: none.
</entry>

<entry id="collect_column_output" type="logical(15)" category="history"
   group="cam_history_nl" valid_values="">
Collect all column data into a single field and output in ncol format,
much faster than default when you have a lot of columns.
</entry>

<entry id="fincl1lonlat" type="char*128(750)"  category="history"
       group="cam_history_nl" valid_values="" >
List of columns or contiguous columns at which the fincl1 fields will be
output. Individual columns are specified as a string using a longitude
degree (greater or equal to 0.) followed by a single character
(e)ast/(w)est identifer, an underscore '_' , and a latitude degree followed
by a single character (n)orth/(s)outh identifier.  For example, '10e_20n'
would pick the model column closest to 10 degrees east longitude by 20
degrees north latitude.  A group of contiguous columns can be specified
using bounding latitudes and longitudes separated by a colon.  For example,
'10e:20e_15n:20n' would select the model columns which fall with in the
longitude range from 10 east to 20 east and the latitude range from 15
north to 20 north.
Default: none
</entry>
<entry id="fincl2lonlat" type="char*128(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1lonlat</varname>, but for 2nd history file.
</entry>
<entry id="fincl3lonlat" type="char*128(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1lonlat</varname>, but for 3rd history file.
</entry>
<entry id="fincl4lonlat" type="char*128(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1lonlat</varname>, but for 4th history file.
</entry>
<entry id="fincl5lonlat" type="char*128(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1lonlat</varname>, but for 5th history file.
</entry>
<entry id="fincl6lonlat" type="char*128(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1lonlat</varname>, but for 6th history file.
</entry>
<entry id="fincl7lonlat" type="char*128(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1lonlat</varname>, but for 7th history file.
</entry>
<entry id="fincl8lonlat" type="char*128(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1lonlat</varname>, but for 8th history file.
</entry>
<entry id="fincl9lonlat" type="char*128(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1lonlat</varname>, but for 9th history file.
</entry>
<entry id="fincl10lonlat" type="char*128(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1lonlat</varname>, but for 10th history file.
</entry>
<entry id="fincl11lonlat" type="char*128(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1lonlat</varname>, but for 11th history file.
</entry>
<entry id="fincl12lonlat" type="char*128(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1lonlat</varname>, but for 12th history file.
</entry>
<entry id="fincl13lonlat" type="char*128(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1lonlat</varname>, but for 13th history file.
</entry>
<entry id="fincl14lonlat" type="char*128(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1lonlat</varname>, but for 14th history file.
</entry>
<entry id="fincl15lonlat" type="char*128(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as <varname>fincl1lonlat</varname>, but for 15th history file.
</entry>


<entry id="fwrtpr1" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Specific fields which will be written using the non-default precision on
the 1st history file.
Default: none
</entry>
<entry id="fwrtpr2" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Specific fields which will be written using the non-default precision on
the 2nd history file.
Default: none
</entry>
<entry id="fwrtpr3" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Specific fields which will be written using the non-default precision on
the 3rd history file.
Default: none
</entry>
<entry id="fwrtpr4" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Specific fields which will be written using the non-default precision on
the 4th history file.
Default: none
</entry>
<entry id="fwrtpr5" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Specific fields which will be written using the non-default precision on
the 5th history file.
Default: none
</entry>
<entry id="fwrtpr6" type="char*26(750)"  category="history"
       group="cam_history_nl" valid_values="" >
Specific fields which will be written using the non-default precision on
the 6th history file.
Default: none
</entry>

<entry id="hfilename_spec" type="char*256(15)"  category="history"
       group="cam_history_nl" valid_values="" >

Array of history filename specifiers.  The filenames of up to fifteen history
output files can be controlled via this variable.  Filename specifiers give
generic formats for the filenames with specific date and time components,
file series number (0-14), and caseid, filled in when the files are
created. The following strings are expanded when the filename is created:
%c=caseid; %t=file series number (0-14); %y=year (normally 4 digits, more
digits if needed); %m=month; %d=day; %s=seconds into current day; %%=%
symbol.  Note that the caseid may be set using the namelist
variable <varname>case_name</varname>.

For example, for a simulation with caseid="test" and current date and time
of 0000-12-31 0:00UT, a filename specifier of "%c.cam2.h%t.%y-%m.nc" would
expand into "test.cam2.h0.0000-12.nc" for the first history file.  The
filename specifier "%c.cam2.h%t.%y-%m-%d-%s.nc" would expand to
"test.cam2.h1.0000-12-31-00000.nc" for the second history file. Spaces are
not allowed in filename specifiers. Although the character "/" is allowed
in the specifier, it will be interpreted as a directory name and the
corresponding directories will have to be created in the model execution
directory (directory given to configure with -cam_exedir option) before
model execution.  The first element is for the primary history file which
is output by default as a monthly history file.  Entries 2 through 15 are
user specified auxilliary output files.

Defaults: "%c.cam2.h0.%y-%m.nc", "%c.cam2.h1.%y-%m-%d-%s.nc", ...,
          "%c.cam2.h5.%y-%m-%d-%s.nc"
</entry>

<entry id="sathist_track_infile" type="char*256" input_pathname="abs" category="history"
       group="satellite_options_nl" valid_values="" >
Full pathname of the satellite track data used by the satellite track history
output feature.
Default: none
</entry>
<entry id="sathist_hfilename_spec" type="char*256"  category="history"
       group="satellite_options_nl" valid_values="" >
Satellite track history filename specifier.  See <varname>hfilename_spec</varname>
Default:  "%c.cam2.sat.%y-%m-%d-%s.nc"
</entry>
<entry id="sathist_fincl" type="char*18(750)"  category="history"
       group="satellite_options_nl" valid_values="" >
List of history fields to output along the satellite track specified by  <varname>sathist_track_infile</varname>
Default: none
</entry>
<entry id="sathist_mfilt" type="integer"  category="history"
       group="satellite_options_nl" valid_values="" >
Sets the number of observation columns written the satellite track history file
series.
Default: 100000
</entry>

<entry id="sathist_nclosest" type="integer"  category="history"
       group="satellite_options_nl" valid_values="" >
Sets the number of columns closest to the observation that should be output. Setting
this to a number greater than 1 allows for spatial interpolation in the post processing.
Default: 1
</entry>

<entry id="sathist_ntimestep" type="integer"  category="history"
       group="satellite_options_nl" valid_values="" >
Sets the number of timesteps closest to the observation that should be output. Setting
this to a number greater than 1 allows for temporal interpolation in the post processing.
Default: 1
</entry>

<entry id="inithist" type="char*8"  category="history"
       group="cam_history_nl" valid_values="NONE,NSTEPS,HOURLY,6-HOURLY,DAILY,MONTHLY,YEARLY,CAMIOP,ENDOFRUN" >
Frequency that initial files will be output: 6-hourly, daily, monthly,
yearly, or never.  Valid values: 'NONE', 'NSTEPS','HOURLY', '6-HOURLY', 'DAILY', 'MONTHLY',
'YEARLY', 'CAMIOP', 'ENDOFRUN'.
Default: 'YEARLY'
</entry>

<entry id="inithist_nsteps" type="integer"  category="history"
       group="cam_history_nl" valid_values="" >
Number of physics steps that initial files will be output. Used only when inithist == 'NSTEPS'
Default: 1
</entry>

<entry id="inithist_all" type="logical"  category="history"
       group="cam_history_nl" valid_values="" >
If false then include only REQUIRED fields on IC file.  If true then
include required AND optional fields on IC file.
Default: FALSE
</entry>

<entry id="mfilt" type="integer(15)"  category="history"
       group="cam_history_nl" valid_values="" >
Array containing the maximum number of time samples written to a history
file.  The first value applies to the primary history file, the second
through sixth to the auxillary history files.
Default: 1,30,30,30,30,30,30,30,30,30,30,30,30,30,30
</entry>

<entry id="lcltod_start" type="integer(15)"  category="history"
       group="cam_history_nl" valid_values="" >
Array containing the starting time of day for local time history averaging.
Used in conjuction with lcltod_stop. If lcltod_stop is less than lcltod_start,
then the time range wraps around 24 hours. The start time is included in the
interval. Time is in seconds and defaults to 39600 (11:00 AM).  The first value
applies to the primary hist. file, the second to the first aux. hist. file, etc.
Default: none
</entry>

<entry id="lcltod_stop" type="integer(15)"  category="history"
       group="cam_history_nl" valid_values="" >
Array containing the stopping time of day for local time history averaging.
Used in conjuction with lcltod_start. If lcltod_stop is less than lcltod_start,
then the time range wraps around 24 hours. The stop time is not included in the
interval. Time is in seconds and defaults to 0 (midnight).  The first value
applies to the primary hist. file, the second to the first aux. hist. file, etc.
Default: none
</entry>

<entry id="ndens" type="integer(15)"  category="history"
       group="cam_history_nl" valid_values="1,2" >

Array specifying the precision of real data written to each history file
series. Valid values are 1 or 2. '1' implies output real values are 8-byte
and '2' implies output real values are 4-byte.

Default: 2,2,2,2,2,2,2,2,2,2
</entry>

<entry id="nhtfrq" type="integer(15)"  category="history"
       group="cam_history_nl" valid_values="" >

Array of write frequencies for each history file series.
If <varname>nhtfrq(1)</varname> = 0, the file will be a monthly average.
Only the first file series may be a monthly average.  If
<varname>nhtfrq(i)</varname> &gt; 0, frequency is specified as number of
timesteps.  If <varname>nhtfrq(i)</varname> &lt; 0, frequency is specified
as number of hours.

Default: 0,-24,-24,-24,-24,-24,-24,-24,-24,-24,-24,-24,-24,-24,-24
</entry>

<entry id="interpolate_output" type="logical(15)" category="history"
    group="cam_history_nl" valid_values="">
If interpolate_output(k) = .true., then the k'th history file will be
interpolated to a lat/lon grid before output.
Default: .false.
</entry>

<entry id="interpolate_nlat" type="integer(15)" category="history"
    group="cam_history_nl" valid_values="">
Size of latitude dimension of grid for interpolated output.
If interpolate_nlat and interpolate_nlon are zero, reasonable values
will be chosen by the dycore based on the run resolution.
Default: 0
</entry>

<entry id="interpolate_nlon" type="integer(15)" category="history"
    group="cam_history_nl" valid_values="">
Size of longitude dimension of grid for interpolated output.
If interpolate_nlat and interpolate_nlon are zero, reasonable values
will be chosen by the dycore based on the run resolution.
Default: 0
</entry>

<entry id="interpolate_type" type="integer(15)" category="history"
    group="cam_history_nl" valid_values="0,1">
Selects interpolation method for output on lat/lon grid.
0: Use SE's native high-order method.
1: Use a bilinear method.
Default: 1 (bilinear)
</entry>

<entry id="interpolate_gridtype" type="integer(15)" category="history"
    group="cam_history_nl" valid_values="1,2,3">
Selects output grid type for lat/lon interpolated output.
1: Equally spaced, including poles (FV scalars output grid).
2: Gauss grid (CAM Eulerian).
3: Equally spaced, no poles (FV staggered velocity).
Default: 1
</entry>

<!-- Initial Conditions -->

<entry id="ncdata" type="char*256" input_pathname="abs" category="initial_conditions"
       group="cam_inparm" valid_values="" >
Full pathname of initial atmospheric state dataset (NetCDF format).
Default: set by build-namelist.
</entry>

<entry id="pertlim" type="real"  category="initial_conditions"
       group="cam_inparm" valid_values="" >
Perturb the initial conditions for temperature randomly by up to the given
amount. Only applied for initial simulations.
Default: 0.0
</entry>

<entry id="new_random" type="logical"  category="initial_conditions"
       group="cam_inparm" valid_values="" >
Use a new RNG in dynamics/se/random_xgc.F90 that is more robust and repeatable than the compiler-dependent
fortran intrinsic random_number.
Default: FALSE
</entry>

<entry id="seed_custom" type="integer"  category="initial_conditions"
       group="cam_inparm" valid_values="" >
Specify a custom seed value for RNG when pertlim /= 0.0. If seed_custom == 0,
Then the default seed is used, which is the same from run to run, based only
on a unique column index
Default: 0
</entry>

<entry id="seed_clock" type="logical"  category="initial_conditions"
       group="cam_inparm" valid_values="" >
bitwise XOR the system_clock with the existing seed value to ensure it is unique.
Default: FALSE
</entry>

<entry id="readtrace" type="logical"  category="initial_conditions"
       group="cam_inparm" valid_values="" >
If TRUE, try to initialize data for all consituents by reading from the
initial conditions dataset. If variable not found then data will be
initialized using internally-specified default values.  If FALSE then don't
try reading constituent data from the IC file; just use the
internally-specified defaults.
Default: TRUE
</entry>

<!-- COSP Cloud Simulator control LOGICALS -->

<entry id="docosp" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, the COSP cloud simulator is run.
Setting this namelist variable happens automatically if you compile with COSP.
COSP will not run unless this is set to .true. in the namelist!
Turn on the desired simulators using lXXX_sim namelist vars
If no specific simulators are specified, all of the simulators
are run on all columns and all output is saved. (useful for testing).
COSP is available with CAM4 and CAM5 physics.
This default logical is set in cospsimulator_intr.F90.
Default: FALSE
</entry>

<entry id="cosp_amwg" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, COSP cloud simulators are run to produce
all output required for the COSP plots in the AMWG diagnostics package.
sets cosp_ncolumns=10 and cosp_nradsteps=3
(appropriate for COSP statistics derived from seasonal averages),
and runs MISR, ISCCP, MODIS, CloudSat radar and CALIPSO lidar simulators
(cosp_lmisr_sim=.true.,cosp_lisccp_sim=.true.,
cosp_lmodis_sim=.true.,cosp_lradar_sim=.true.,cosp_llidar_sim=.true.).
This default logical is set in cospsimulator_intr.F90.
Default: TRUE
</entry>

<entry id="cosp_lite" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, the COSP cloud simulators are run to produce
select output for the AMWG diagnostics package.
sets cosp_ncolumns=10 and cosp_nradsteps=3
(appropriate for COSP statistics derived from seasonal averages),
and runs MISR, ISCCP, MODIS, and CALIPSO lidar simulators
(cosp_lmisr_sim=.true.,cosp_lisccp_sim=.true.,
cosp_lmodis_sim=.true.,cosp_llidar_sim=.true.).
This default logical is set in cospsimulator_intr.F90.
Default: FALSE
</entry>

<entry id="cosp_passive" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, the passive COSP cloud simulators are run to produce
select output for the AMWG diagnostics package.
sets cosp_ncolumns=10 and cosp_nradsteps=3
(appropriate for COSP statistics derived from seasonal averages),
and runs MISR, ISCCP, and MODIS simulators
(cosp_lmisr_sim=.true.,cosp_lisccp_sim=.true.,cosp_lmodis_sim=.true.).
This default logical is set in cospsimulator_intr.F90.
Default: FALSE
</entry>

<entry id="cosp_active" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, the active COSP cloud simulators are run to produce
select output for the AMWG diagnostics package.
sets cosp_ncolumns=10 and cosp_nradsteps=3
(appropriate for COSP statistics derived from seasonal averages),
and runs CloudSat radar and CALIPSO lidar simulators
(cosp_lradar_sim=.true.,cosp_llidar_sim=.true.).
This default logical is set in cospsimulator_intr.F90.
Default: FALSE
</entry>

<entry id="cosp_isccp" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, the ISCCP cloud simulator is run to produce
select output for the AMWG diagnostics package.
sets cosp_ncolumns=10 and cosp_nradsteps=3
(appropriate for COSP statistics derived from seasonal averages),
and runs ISCCP simulator
(cosp_lmisr_sim=.false.,cosp_lisccp_sim=.true.,
cosp_lmodis_sim=.false.,cosp_lradar_sim=.false.,cosp_llidar_sim=.false.).
This default logical is set in cospsimulator_intr.F90.
1236: Default: FALSE
</entry>

<entry id="cosp_runall" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, run all simulators using the default values cosp_ncolumns=50 and
cosp_nradsteps=1.  This option is mainly intended for testing, but it also
must be used in order to output the input fields needed to run the
simulator in an offline mode (via setting cosp_histfile_aux=.true.).
Default: FALSE
</entry>

<entry id="cosp_lradar_sim" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, COSP radar simulator will be run and all non-subcolumn output
will be saved.
Default: FALSE
</entry>

<entry id="cosp_llidar_sim" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, COSP lidar simulator will be run and all non-subcolumn output
will be saved
Default: FALSE
</entry>

<entry id="cosp_lisccp_sim" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, COSP ISCCP simulator will be run and all non-subcolumn output
will be saved.  ISCCP simulator is run on only daylight
columns.
Default: FALSE
</entry>

<entry id="cosp_lmisr_sim" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, MISR simulator will be run and all non-subcolumn output
will be saved.  MISR simulator is run on only daylight
columns.
Default: FALSE
</entry>

<entry id="cosp_lmodis_sim" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, MODIS simulator will be run and all non-subcolumn output
will be saved.

Default: FALSE
</entry>

<!-- COSP CFMIP Cloud Simulator LOGICALS -->

<entry id="cosp_cfmip_3hr" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, the COSP cloud simulator is run for CFMIP 3-hourly
experiments.
This default logical is set in cospsimulator_intr.F90
Default: FALSE
</entry>

<entry id="cosp_cfmip_da" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, the COSP cloud simulator is run for CFMIP daily
experiments.
This default logical is set in cospsimulator_intr.F90
Default: FALSE
</entry>

<entry id="cosp_cfmip_off" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, the COSP cloud simulator is run for CFMIP off-line
monthly experiments.
This default logical is set in cospsimulator_intr.F90
Default: FALSE
</entry>

<entry id="cosp_cfmip_mon" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, the COSP cloud simulator is run for CFMIP monthly
experiments.
This default logical is set in cospsimulator_intr.F90
Default: FALSE
</entry>

<!-- COSP input control parameters -->

<entry id="cosp_ncolumns" type="integer"  category="cosp"
       group="cospsimulator_nl" valid_values="">
Number of subcolumns in SCOPS
This default logical is set in cospsimulator_intr.F90
Default: 50
</entry>

<!-- COSP sampling parameters -->

<entry id="cosp_sample_atrain" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
Turns on sampling along a-train orbit for radar and lidar simulators.
This default logical is set in cospsimulator_intr.F90
Default: FALSE
</entry>

<entry id="cosp_atrainorbitdata" type="char*256"  category="cosp"
       group="cospsimulator_nl" valid_values="">
Path for the Atrain orbit data file provided by CFMIP.
There is no default for this, but sample_atrain = .true. will not work
if this namelist variable is undefined.
currently /project/cms/jenkay/SCAM/repository/cloudsat_orbit_08921_14250.nc
Default: no default set now, need to specify in namelist
</entry>

<!-- COSP output parameters -->

<entry id="cosp_histfile_num" type="integer"  category="cosp"
       group="cospsimulator_nl" valid_values="">
This specifies the CAM history tape where COSP diagnostics will be written.
Ignored/not used if any of the cosp_cfmip_* namelist variables are invoked.

This default is set in cospsimulator_intr.F90
Default: 1
</entry>
<entry id="cosp_histfile_aux" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, additional output is added to make it possible to
run COSP off-line.

This default is set in cospsimulator_intr.F90
Default: FALSE
</entry>
<entry id="cosp_histfile_aux_num" type="integer"  category="cosp"
       group="cospsimulator_nl" valid_values="">
This specifies the CAM history tape where extra COSP diagnostics will be written.

This default is set in cospsimulator_intr.F90
Default: 2
</entry>

<entry id="cosp_nradsteps" type="integer"  category="cosp"
       group="cospsimulator_nl" valid_values="">
This specifies the frequency at which is COSP is called,
every cosp_nradsteps radiation timestep.

This default is set in cospsimulator_intr.F90
Default: 1
</entry>

<entry id="cosp_lfrac_out" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
Turns on sub-column output from COSP.
If both the isccp/misr simulators and the lidar/radar simulators
are run, lfrac_out is from the isccp/misr simulators columns.
This default logical is set in cospsimulator_intr.F90
Default: FALSE
</entry>

<!-- Cloud Macro/Micro-physics -->

<entry id="cld_macmic_num_steps" type="integer" category="conv"
       group="phys_ctl_nl" valid_values="" >
Number of macrophysics/microphysics substeps.
Default: 1
</entry>

<!-- Cldwat -->
<entry id="cldwat_icritc" type="real" category="conv"
       group="cldwat_nl" valid_values="" >
Threshold for autoconversion of cold ice in RK microphysics scheme.
Default: set by build-namelist
</entry>

<entry id="cldwat_icritw" type="real" category="conv"
       group="cldwat_nl" valid_values="" >
Threshold for autoconversion of warm ice in RK microphysics scheme.
Default: set by build-namelist
</entry>

<entry id="cldwat_conke" type="real" category="conv"
       group="cldwat_nl" valid_values="" >
Tunable constant for evaporation of precip in RK microphysics scheme.
Default: set by build-namelist
</entry>

<entry id="cldwat_r3lcrit" type="real" category="conv"
       group="cldwat_nl" valid_values="" >
Critical radius at which autoconversion become efficient in RK microphysics
scheme.
Default: set by build-namelist
</entry>

<!-- macro_park -->
<entry id="macro_park_do_cldice" type="logical" category="conv"
       group="macro_park_nl" valid_values="" >
Switch to control whether Park macrophysics should prognose
cloud ice (cldice).
Default: .true.
</entry>

<entry id="macro_park_do_cldliq" type="logical" category="conv"
       group="macro_park_nl" valid_values="" >
Switch to control whether Park macrophysics should prognose
cloud liquid (cldliq).
Default: .true.
</entry>

<entry id="macro_park_do_detrain" type="logical" category="conv"
       group="macro_park_nl" valid_values="" >
Switch to control whether Park macrophysics should perform
detrainment into the stratiform cloud scheme.
Default: .true.
</entry>


<!-- general microphysics -->

<entry id="micro_p3_tableversion" type="char*16" category="microphys"
       group="micro_nl" valid_values="" >
Version number for P3 microphysics tables.
Default: 1
</entry>

<entry id="micro_p3_lookup_dir" type="char*128" input_pathname="abs" category="conv"
       group="micro_nl" valid_values="" >
Directory where P3 initialization files are located.
</entry>


<entry id="spa_datapath" type="char*256" input_pathname="abs" category="cam_chem"
       group="spa_nl" valid_values="" >
Full pathname of the directory that contains the spa input file
Default: None
</entry>

<entry id="spa_file" type="char*256" input_pathname="rel:spa_datapath" category="cam_chem"
       group="spa_nl" valid_values="" >
Filename of dataset for spa
Default: None
</entry>

<entry id="spa_type" type="char*32" category="cam_chem"
       group="spa_nl" valid_values="CYCLICAL,SERIAL,INTERP_MISSING_MONTHS,FIXED" >
Type of time interpolation for data in spa files.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.
Default: 'SERIAL'
</entry>

<entry id="spa_cycle_yr" type="integer" category="cam_chem"
       group="spa_nl" valid_values="" >
The  cycle year of the prescribed aerosol data
if <varname>spa_type</varname>  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="micro_aerosolactivation" type="logical" category="microphys"
       group="micro_nl" valid_values="" >
Specify if aerosol activation is used in microphysics scheme.
Default: TRUE
</entry>

<entry id="micro_subgrid_cloud" type="logical" category="microphys"
       group="micro_nl" valid_values="" >
Specify if cloud fraction is applied to microphysics tendencies.
Default: TRUE
</entry>

<entry id="micro_tend_output" type="logical" category="microphys"
       group="micro_nl" valid_values="" >
Output microphysics tendencies in standard atm output file.
Default: FALSE
</entry>

<!-- micro_p3 -->
<entry id="p3_qc_autocon_expon" type="real" category="microphysics"
	group="micro_nl" valid_values="" >
Exponent of power function fit used by P3 qc in autoconversion 
Default: 2.47_rtype
</entry>

<entry id="p3_qc_accret_expon" type="real" category="microphysics"
	group="micro_nl" valid_values="" >
Exponent of power function fit used by P3 qc in accretion 
Default: 1.15_rtype
</entry>

<entry id="p3_nc_autocon_expon" type="real" category="microphysics"
	group="micro_nl" valid_values="" >
Exponent of power function fit used by P3 nc in autoconversion 
Default: -1.79_rtype
</entry>

<entry id="p3_accret_coeff" type="real" category="microphysics"
	group="micro_nl" valid_values="" >
Coefficient fit used by P3 in accretion 
Default: 67._rtype
</entry>

<entry id="p3_autocon_coeff" type="real" category="microphysics"
	group="micro_nl" valid_values="" >
Coefficient fit used by P3 in autoconversion 
Default: 1350._rtype
</entry>

<entry id="p3_wbf_coeff" type="real" category="microphysics"
	group="micro_nl" valid_values="" >
Coefficient for Wegener-Bergeron-Findeisen process in P3 
Default: 0.7_rtype
</entry>

<entry id="p3_max_mean_rain_size" type="real" category="microphysics"
	group="micro_nl" valid_values="" >
Maximal mean rain size in P3
Default: 0.005_rtype
</entry>

<entry id="p3_embryonic_rain_size" type="real" category="microphysics"
	group="micro_nl" valid_values="" >
Embryonic rain size from autoconversion in P3
Default: 0.000025_rtype
</entry>


<!-- micro_p3 -->
<entry id="p3_qc_autoCon_Expon" type="real" category="microphysics"
	group="micro_nl" valid_values="" >
Exponent of power function fit used by P3 qc in autoconversion
Default: 2.47_rtype
</entry>

<entry id="p3_qc_accret_Expon" type="real" category="microphysics"
	group="micro_nl" valid_values="" >
Exponent of power function fit used by P3 qc in accretion
Default: 1.15_rtype
</entry>


<entry id="do_prescribed_CCN" type="logical" category="microphys"
       group="micro_nl" valid_values="" >
Specify if CCN concentration is read in from ncdf file within p3.
Default: FALSE
</entry>

<entry id="do_Cooper_inP3" type="logical" category="microphys"
       group="micro_nl" valid_values="" >
Specify if ice nucleation is done using the Cooper scheme within p3.
Default: FALSE
</entry>

<!-- micro_boss -->
<entry id="log_a_auto_t1" type="real" category="microphys"
       group="micro_nl" valid_values="" >
Autoconversion mass parameter a.
Default: 60.96150355_rtype
</entry>

<entry id="b_auto_t1" type="real" category="microphys"
       group="micro_nl" valid_values="" >
Autoconversion mass parameter b.
Default: 7.097681584_rtype
</entry>

<entry id="log_mc_auto_inv" type="real" category="microphys"
       group="micro_nl" valid_values="" >
Autoconversion number parameter.
Default: 9.968997092_rtype
</entry>

<entry id="log_a_acc" type="real" category="microphys"
       group="micro_nl" valid_values="" >
Accretion parameter a.
Default: 4.469278867_rtype
</entry>

<entry id="b_acc_mc" type="real" category="microphys"
       group="micro_nl" valid_values="" >
Accretion parameter b.
Default: 1.242355129_rtype
</entry>

<entry id="b_acc_mr" type="real" category="microphys"
       group="micro_nl" valid_values="" >
Accretion parameter b.
Default: 0.88106741_rtype
</entry>

<entry id="log_a_sc_c" type="real" category="microphys"
       group="micro_nl" valid_values="" >
Cloud self-collection number parameter a.
Default: 13.99349228_rtype
</entry>

<entry id="b_sc_c" type="real" category="microphys"
       group="micro_nl" valid_values="" >
Cloud self-collection number parameter b.
Default: 2.014438692_rtype
</entry>

<entry id="log_a_sc_r" type="real" category="microphys"
       group="micro_nl" valid_values="" >
Rain self-collection number parameter a.
Default: 13.99349228_rtype
</entry>

<entry id="b_sc_r" type="real" category="microphys"
       group="micro_nl" valid_values="" >
Rain self-collection number parameter b.
Default: 1.501765635_rtype
</entry>


<!-- micro_mg -->
<entry id="micro_do_nccons" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Specify in-stratus cloud droplet number concentration for stratiform microphysics and radiation.
Default: FALSE
</entry>

<entry id="micro_do_nicons" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Specify in-stratus cloud ice number concentration for stratiform microphysics and radiation.
Default: FALSE
</entry>

<entry id="micro_nccons" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Liquid droplet concentration (in #/cc) when micro_do_nccons=.true.
Default: set by build-namelist
</entry>

<entry id="micro_nicons" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Ice crystal concentration (in #/cc) when micro_do_nicons=.true.
Default: set by build-namelist
</entry>

<entry id="micro_mincdnc" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Minimum droplet number conc (#/m3) imposed when micro_mincdnc > 0.
Default: -999.
</entry>

<entry id="p3_mincdnc" type="real" category="microphys"
       group="micro_nl" valid_values="" >
Minimum droplet number conc (#/m3) imposed when p3_mincdnc > 0.
Default: -999.
</entry>

<entry id="micro_mg_version" type="integer" category="microphys"
       group="micro_mg_nl" valid_values="" >
Version number for MG microphysics
Default: 1
</entry>

<entry id="micro_mg_sub_version" type="integer" category="microphys"
       group="micro_mg_nl" valid_values="" >
Sub-version number for MG microphysics
Default: 0
</entry>

<entry id="micro_mg_do_cldice" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Switch to control whether MG microphysics should prognose
cloud ice (cldice).
Default: .true.
</entry>

<entry id="micro_mg_do_cldliq" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Switch to control whether MG microphysics should prognose
cloud liquid (cldliq).
Default: .true.
</entry>

<entry id="micro_mg_num_steps" type="integer" category="microphys"
       group="micro_mg_nl" valid_values="" >
Number of substeps over MG microphysics.
Default: 1
</entry>

<entry id="micro_mg_precip_frac_method" type="char*16" category="microphys"
       group="micro_mg_nl" valid_values="max_overlap,in_cloud,mass_gradient" >
Type of precipitation fraction.
Default: max_overlap
</entry>

<entry id="micro_mg_mass_gradient_alpha" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Parameter controlling the rate at which precipitation fraction decreases when
the precipitation mass is *decreasing* as it falls (e.g. decreasing rain
fraction due to evaporation). This value should be positive.
Used only if micro_mg_precip_frac_method is set to mass_gradient.
Default: Set by build-namelist.
</entry>

<entry id="micro_mg_mass_gradient_beta" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Parameter controlling the rate at which precipitation fraction decreases when
the precipitation mass is *increasing* as it falls (e.g. when precipitation
falling from above is negligible compared to production concentrated in a small
area). This value should be non-negative.
Used only if micro_mg_precip_frac_method is set to mass_gradient.
Default: Set by build-namelist.
</entry>

<entry id="micro_mg_berg_eff_factor" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Efficiency factor for berg
Default: 1
</entry>

<entry id="microp_uniform" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Switch to control whether MG microphysics performs a uniform calculation or not
(useful for sub-columns)
Default: .false.
</entry>

<entry id="ice_sed_ai" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Fall speed parameter for cloud ice
Default: 700.0
</entry>

<entry id="micro_mg_dcs" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Autoconversion size threshold for cloud ice to snow (m)
Default: set by build-namelist
</entry>

<entry id="micro_mg_dcs_tdep" type="logical" category="microphysics"
       group="micro_mg_nl" valid_values="" >
Switch to turn on temperature dependent DCS.
Default: .false.
</entry>

<entry id="micro_mg_accre_enhan_fac" type="real" category="microphysics"
       group="phys_ctl_nl" valid_values="" >
Accretion enhancement factor from namelist
Default: 1.0_r8
</entry>

<entry id="prc_coef1" type="real" category="microphysics"
group="phys_ctl_nl" valid_values="" >
Tunable coefficient for autoconversion
Default: 1350.0_r8
</entry>

<entry id="prc_exp" type="real" category="microphysics"
group="phys_ctl_nl" valid_values="" >
Tunable exponent coefficient for autoconversion
Default: 2.47_r8
</entry>

<entry id="prc_exp1" type="real" category="microphysics"
group="phys_ctl_nl" valid_values="" >
Tunable exponent coefficient for autoconversion
Default: -1.79_r8
</entry>

<entry id="cld_sed" type="real" category="microphysics"
group="phys_ctl_nl" valid_values="" >
scale factor for cloud sedimentation velocity
Default: 1.0D0
</entry>

<entry id="mg_prc_coeff_fix" type="logical" category="microphysics"
group="phys_ctl_nl" valid_values="" >
Temporary variable for a bug fix. Introduced to maintain BFB, must be REMOVED later
Default: FALSE
</entry>

<entry id="rrtmg_temp_fix" type="logical" category="microphysics"
group="phys_ctl_nl" valid_values="" >
Temporary variable for a bug fix. Introduced to maintain BFB, must be REMOVED later
Default: FALSE
</entry>





<!-- micro_aero -->
<entry id="microp_aero_bulk_scale" type="real" category="microphysics"
       group="microp_aero_nl" valid_values="" >
prescribed aerosol bulk sulfur scale factor
Default: 2
</entry>

<entry id="microp_aero_wsub_scheme" type="integer" category="microphysics"
       group="microp_aero_nl" valid_values="" >
Updraft velocity paramterization option for ice nucleation.
Default: 1
</entry>

<entry id="microp_aero_wsubmin" type="real" category="microphysics"
       group="microp_aero_nl" valid_values="" >
Minimum subgrid vertical velocity
Default: 0.2
</entry>

<entry id="use_hetfrz_classnuc" type="logical" category="microphys"
       group="phys_ctl_nl" valid_values="" >
Switch to turn on heterogeneous freezing code.
Default: .false.
</entry>

<entry id="hist_hetfrz_classnuc" type="logical" category="microphys"
       group="hetfrz_classnuc_nl" valid_values="" >
Add diagnostic output for heterogeneous freezing code.
Default: .false.
</entry>

<entry id="use_preexisting_ice" type="logical" category="microphys"
       group="nucleate_ice_nl" valid_values="" >
Switch to turn on treatment of pre-existing ice in the ice nucleation code.
Default: .false.
</entry>

<entry id="hist_preexisting_ice" type="logical" category="microphys"
       group="nucleate_ice_nl" valid_values="" >
Add diagnostics for pre-existing ice option in ice nucleation code to history output.
Default: .false.
</entry>

<entry id="use_nie_nucleate" type="logical" category="microphys"
       group="nucleate_ice_nl" valid_values="" >
Use Niemand et al. ice nucleation scheme for mixed-phase cloud
Default: .false.
</entry>

<entry id="use_dem_nucleate" type="logical" category="microphys"
       group="nucleate_ice_nl" valid_values="" >
Use DeMott et al. ice nucleation scheme for mixed-phase cloud
Default: .false.
</entry>

<entry id="nucleate_ice_subgrid" type="real" category="microphys"
       group="nucleate_ice_nl" valid_values="" >
Subgrid scaling factor for relative humidity in ice nucleation code.
Default: set by build-namelist
</entry>

<entry id="so4_sz_thresh_icenuc" type="real" category="microphys"
       group="nucleate_ice_nl" valid_values="" >
ice nucleation SO2 size threshold for aitken mode
Default: set by build-namelist
</entry>

<!-- hkconv Moist Convection -->
<entry id="hkconv_cmftau" type="real" category="conv"
       group="hkconv_nl" valid_values="" >
Characteristic adjustment time scale for Hack shallow scheme.
Default: set by build-namelist
</entry>

<entry id="hkconv_c0" type="real" category="conv"
       group="hkconv_nl" valid_values="" >
Rain water autoconversion coefficient for Hack shallow scheme.
Default: set by build-namelist
</entry>

<!-- uwshcu Moist Convection -->
<entry id="uwshcu_rpen" type="real" category="conv"
       group="uwshcu_nl" valid_values="">
Penetrative entrainment efficiency in UW shallow scheme.
Default: set by build-namelist
</entry>

<!-- Cloud fraction -->

<entry id="cldfrc_freeze_dry" type="logical" category="cldfrc"
       group="cldfrc_nl" valid_values="" >
Switch for Vavrus "freeze dry" adjustment in cloud fraction.  Set to FALSE to
turn the adjustment off.
Default: set by build-namelist
</entry>

<entry id="cldfrc_ice" type="logical" category="cldfrc"
       group="cldfrc_nl" valid_values="" >
Switch for ice cloud fraction calculation.
Default: set by build-namelist
</entry>

<entry id="cldfrc_rhminl" type="real" category="cldfrc"
       group="cldfrc_nl" valid_values="" >
Minimum rh for low stable clouds.
Default: set by build-namelist
</entry>

<entry id="cldfrc_rhminl_adj_land" type="real" category="conv"
       group="cldfrc_nl" valid_values="" >
Adjustment to rhminl for land without snow cover.
Default: 0.10
</entry>

<entry id="cldfrc_rhminh" type="real" category="cldfrc"
       group="cldfrc_nl" valid_values="" >
Minimum rh for high stable clouds.
Default: set by build-namelist
</entry>

<entry id="cldfrc_rhminp" type="real" category="cldfrc" group="cldfrc_nl" valid_values="" >
Minimum rh for high stable clouds poleward of 60 degrees.
**This is valid only for RK microphysis scheme**
Default: set to cldfrc_rhminh
</entry>

<entry id="cldfrc_rhminp_botmb" type="real" category="cldfrc" group="cldfrc_nl" valid_values="" >
Maximum pressure level (mbars) where the <varname>cldfrc_rhminp</varname> setting is applied.
Default: 300. mbar
</entry>

<entry id="cldfrc_sh1" type="real" category="cldfrc"
       group="cldfrc_nl" valid_values="" >
parameter for shallow convection cloud fraction.
Default: set by build-namelist
</entry>

<entry id="cldfrc_sh2" type="real" category="cldfrc"
       group="cldfrc_nl" valid_values="" >
parameter for shallow convection cloud fraction.
Default: set by build-namelist
</entry>

<entry id="cldfrc_dp1" type="real" category="cldfrc"
       group="cldfrc_nl" valid_values="" >
parameter for deep convection cloud fraction.
Default: set by build-namelist
</entry>

<entry id="cldfrc_dp2" type="real" category="cldfrc"
       group="cldfrc_nl" valid_values="" >
parameter for deep convection cloud fraction.
Default: set by build-namelist
</entry>

<entry id="cldfrc_premit" type="real" category="cldfrc"
       group="cldfrc_nl" valid_values="" >
top pressure bound for mid level cloud.
Default: set by build-namelist
</entry>

<entry id="cldfrc_premib" type="real" category="conv"
       group="cldfrc_nl" valid_values="" >
Bottom height (Pa) for mid-level liquid stratus fraction.
Default: 700.e2
</entry>

<entry id="cldfrc_iceopt" type="integer" category="conv"
       group="cldfrc_nl" valid_values="" >
Scheme for ice cloud fraction: 1=wang & sassen, 2=schiller (iciwc),
3=wood & field, 4=Wilson (based on smith), 5=modified slingo (ssat & empty cloud)
6=Gettelman (based on Heymsfield), 7=all-or-nothing
Default: 5
</entry>

<entry id="cldfrc_minice" type="real" category="conv"
       group="cldfrc_nl" valid_value="" >
Minimum ice mass mixing ratio used for calculating the ice cloud fraction,
Used for cldfrc_iceopt = [4,5,6,7]
Default: 1e-5 for iceopt=7, else 1e-12
</entry>

<entry id="cldfrc_icecrit" type="real" category="conv"
       group="cldfrc_nl" valid_values="" >
Critical RH for ice clouds (Wilson & Ballard scheme).
Default: 0.93
</entry>

<entry id="cldfrc2m_rhmini" type="real" category="conv"
       group="cldfrc2m_nl" valid_values="" >
Minimum rh for ice cloud fraction &gt; 0.
Default: set by build-namelist
</entry>

<entry id="cldfrc2m_rhmaxi" type="real" category="conv"
       group="cldfrc2m_nl" valid_values="" >
rhi at which ice cloud fraction = 1.
Default: set by build-namelist
</entry>

<!-- condensate to rain autoconversion coefficient -->
<entry id="zmconv_c0_lnd" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Autoconversion coefficient over land in ZM deep convection scheme.
Default: set by build-namelist
</entry>

<entry id="zmconv_c0_ocn" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Autoconversion coefficient over ocean in ZM deep convection scheme.
Default: set by build-namelist
</entry>

<entry id="zmconv_ke" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Tunable evaporation efficiency in ZM deep convection scheme.
Default: set by build-namelist
</entry>

<entry id="zmconv_tau" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Relaxation time in ZM deep convection scheme.
Default: set by build-namelist
</entry>

<entry id="zmconv_dmpdz" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Parcel fractional mass entrainment rate
Default: set by build-namelist
</entry>

<entry id="zmconv_alfa" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Maximum downdraft mass flux fraction
Default: set by build-namelist
</entry>

<entry id="zmconv_trigdcape_ull" type="logical" category="conv"
       group="zmconv_nl" valid_values="" >
DCAPE trigger along with unrestricted launching level for ZM deep convection scheme.
Default: FALSE
</entry>

<entry id="zmconv_trig_dcape_only" type="logical" category="conv"
       group="zmconv_nl" valid_values="" >
DCAPE only trigger for ZM deep convection scheme.
Default: FALSE
</entry>

<entry id="zmconv_trig_ull_only" type="logical" category="conv"
       group="zmconv_nl" valid_values="" >
Use unrestricted launching level (ULL) only trigger  for ZM deep convection scheme. This is on top of standard CAPE-based ZM trigger
This is in contrast with zmconv_trigdcape_ull which uses both DCAPE and ULL for trigger
Default: FALSE
</entry>

<entry id="zmconv_tiedke_add" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
A ZM deep convection parameter
Default: set by build-namelist
</entry>

<entry id="zmconv_cape_cin" type="integer" category="conv"
       group="zmconv_nl" valid_values="" >
Number of negative buoyancy regions that are allowed before the conv. top and CAPE calc are completed
Default: set by build-namelist
</entry>

<entry id="zmconv_mx_bot_lyr_adj" type="integer" category="conv"
       group="zmconv_nl" valid_values="" >
Bottom layer adjustment for setting "launching" level(mx) (to be at maximum moist static energy)
Default: set by build-namelist
</entry>

<entry id="zmconv_tp_fac" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Tpert scale factor in ZM deep convection scheme.
Default: 0.D0
</entry>

<entry id="zmconv_microp" type="logical" category="conv"
       group="zmconv_nl" valid_values="" >
Microphysics option in ZM deep convection scheme.
Default: set by build-namelist
</entry>

<entry id="zmconv_clos_dyn_adj" type="logical" category="conv"
       group="zmconv_nl" valid_values="" >
Apply dynamics adjustment to CAPE closure
Default: set by build-namelist
</entry>

<entry id="zmconv_tpert_fix" type="logical" category="conv"
       group="zmconv_nl" valid_values="" >
logical switch for tpert impacts in ZM deep convection scheme
Default: set by build-namelist
</entry>


<entry id="zmconv_auto_fac" type="real" category="conv"
       group="zmconv_nl" valid_values="" >    
cloud droplet-rain autoconversion enhancement factor in convective microphysics scheme.
Default: set by build-namelist  
</entry>

<entry id="zmconv_accr_fac" type="real" category="conv"
       group="zmconv_nl" valid_values="" >    
cloud droplet-rain accretion enhancement factor in convective microphysics scheme.      
Default: set by build-namelist  
</entry>

<entry id="zmconv_micro_dcs" type="real" category="conv"
       group="zmconv_nl" valid_values="" >    
Autoconversion size threshold for cloud ice to snow (m)     
Default: set by build-namelist 
</entry>

<!-- MCSP -->
<entry id="zmconv_MCSP_heat_coeff" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Multiscale Coherent System Parameterization (MCSP), heating coefficient
Default: set by build-namelist
</entry>

<entry id="zmconv_MCSP_moisture_coeff" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Multiscale Coherent System Parameterization (MCSP), moisture coefficient
Default: set by build-namelist
</entry>

<entry id="zmconv_MCSP_uwind_coeff" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Multiscale Coherent System Parameterization (MCSP), zonal wind coefficient
Default: set by build-namelist
</entry>

<entry id="zmconv_MCSP_vwind_coeff" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Multiscale Coherent System Parameterization (MCSP), meridional wind coefficient
Default: set by build-namelist
</entry>


<!-- Cloud sedimentation -->

<entry id="cldsed_ice_stokes_fac" type="real" category="cldsed"
       group="cldsed_nl" valid_values="" >
Factor applied to the ice fall velocity computed from
Stokes terminal velocity.
Default: set by build-namelist
</entry>

<!-- Water Vapor Saturation -->

<entry id="wv_sat_scheme" type="char*16" category="wv_sat"
       group="wv_sat_nl" valid_values="GoffGratch,MurphyKoop" >
Type of water vapor saturation vapor pressure scheme employed.  'GoffGratch' for
Goff and Gratch (1946); 'MurphyKoop' for Murphy & Koop (2005)
Default: GoffGratch
</entry>

<!-- Switches for turning on/off individual parameterizations -->

<entry id="l_tracer_aero" type="logical" category="physc_test"
       group="phys_ctl_nl" valid_values="" >
Turn on aerosol related processes (emissions, chemistry, deposition, etc.)
Default: TRUE
</entry>

<entry id="l_vdiff" type="logical" category="physc_test"
       group="phys_ctl_nl" valid_values="" >
Calculate turbulent transport.
Default: TRUE
</entry>

<entry id="l_rayleigh" type="logical" category="physc_test"
       group="phys_ctl_nl" valid_values="" >
Calculate Rayleigh friction.
Default: TRUE
</entry>

<entry id="l_gw_drag" type="logical" category="physc_test"
       group="phys_ctl_nl" valid_values="" >
Calculate gravity wave drag.
Default: TRUE
</entry>

<entry id="l_ac_energy_chk" type="logical" category="physc_test"
       group="phys_ctl_nl" valid_values="" >
Turn on energy budget checks in tphysac.
Default: TRUE
</entry>

<entry id="l_bc_energy_fix" type="logical" category="physc_test"
       group="phys_ctl_nl" valid_values="" >
Turn on energy fixer in tphysbc.
Default: TRUE
</entry>

<entry id="l_dry_adj" type="logical" category="physc_test"
       group="phys_ctl_nl" valid_values="" >
Calculate dry adjustment.
Default: TRUE
</entry>

<entry id="l_st_mac" type="logical" category="physc_test"
       group="phys_ctl_nl" valid_values="" >
Calculate stratiform cloud macrophysics.
When the CAM4 Rasch-Kristjansson scheme is in use,
l_st_mac = .true. also swiches on the microphysics.
Default: TRUE
</entry>

<entry id="l_st_mic" type="logical" category="physc_test"
       group="phys_ctl_nl" valid_values="" >
Calculate stratiform cloud microphysics. Note that this switch
is implemented only for the Morrison-Gettelman scheme.
For Rasch-Kristjansson, the mac-only option has not been implemented
(i.e., depending on what is chosen for l_st_mac,
macro and microphysics are either both on or both off.)
Default: TRUE
</entry>

<entry id="l_rad" type="logical" category="physc_test"
       group="phys_ctl_nl" valid_values="" >
Do radiative transfer and heating/cooling calculation.
Default: TRUE
</entry>

<entry id="cflx_cpl_opt" type="integer" category="process_coupling"
       group="phys_ctl_nl" valid_values="" >
Numerical scheme for coupling surface tracer fluxes with the rest of model.
Default: 1 
</entry>

<!-- Physics sub-column switches -->

<entry id="use_subcol_microp" type="logical" category="conv"
       group="phys_ctl_nl" valid_values="" >
Control use of sub-columns within macro/micro physics;
'false' for no subcolumns.
Default: 'false'
</entry>

<entry id="subcol_scheme" type="char*16" category="conv"
       group="subcol_nl" valid_values="SILHS,CloudObj,tstcp,vamp,off" >
Type of sub-column generator scheme employed.  'SIHLS' Sub-columns generated with Latin Hypercube sampling of the CLUBB PDF;
Type of sub-column generator scheme employed.  'CloudObj' Create sub-columns where most water is assigned to cloud sub-columns;
Type of sub-column generator scheme employed.  'tstcp'    testing;
Type of sub-column generator scheme employed.  'vamp' Variation Across Microphysics Profiles simple deterministic scheme;
'off' for none.
Default: 'off'
</entry>

<entry id="subcol_tstcp_noAvg" type="logical" category="conv"
       group="subcol_tstcp_nl" valid_values="" >
Turns off averaging and assigns first subcolumn back to grid.  Needed for BFB comparisons
'true' for no averaging.
Default: '.false.'
</entry>

<entry id="subcol_tstcp_filter" type="logical" category="conv"
       group="subcol_tstcp_nl" valid_values="" >
Turns on/off filtering during averaing in tstcp
'true' to use filtering.
Default: '.false.'
</entry>

<entry id="subcol_tstcp_weight" type="logical" category="conv"
       group="subcol_tstcp_nl" valid_values="" >
Turns on/off use of weights during averaging in tstcp
'true' to use weights.
Default: '.false.'
</entry>

<entry id="subcol_tstcp_perturb" type="logical" category="conv"
       group="subcol_tstcp_nl" valid_values="" >
Perturbs the temperatures in state after copying for testing purposes
'true' to perturb temperatures.
Default: '.false.'
</entry>

<entry id="subcol_silhs_weight" type="logical" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Turns on/off use of weights during averaging in tstcp
'true' to use weights.
Default: '.true.'
</entry>

<entry id="subcol_silhs_numsubcol" type="integer" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Number of subcolumns/samples to use in this simulation. Must be less than psubcols.
Default: 4
</entry>

<!-- VAMP Sub-Column Generator -->

<entry id="subcol_vamp_ctyp" type="integer" category="conv"
       group="subcol_vamp_nl" valid_values="" >
Type of condensate to assume in VAMP Generator
1 Uniform Condensate
2 Variable Condensate Uniform Number
3 Variable Condensate Variable Number
Default: 3
</entry>

<entry id="subcol_vamp_otyp" type="integer" category="conv"
       group="subcol_vamp_nl" valid_values="" >
Type of overlap to assume in VAMP Generator 1 Maximum
Default: 1
</entry>

<entry id="subcol_vamp_nsubc" type="integer" category="conv"
       group="subcol_vamp_nl" valid_values="" >
Number of subcolumns in VAMP Generator
Default: 10
</entry>



<!-- Moist Convection and Microphysics -->

<entry id="deep_scheme" type="char*16" category="conv"
       group="phys_ctl_nl" valid_values="ZM,CLUBB_SGS,off" >
Type of deep convection scheme employed.  'ZM' for Zhang-McFarlane;
'off' for none.
Default: 'ZM'
</entry>

<entry id="microp_scheme" type="char*16" category="conv"
       group="phys_ctl_nl" valid_values="RK,MG,P3,off" >
Type of microphysics scheme employed.  'RK' for Rasch and Kristjansson
(1998); 'MG' for Morrison and Gettelman (2008), Gettelman et al (2010)
two moment scheme for CAM5.1, P3 for the P3 microphysics scheme, 
Morrison and Milbrandt (2015),Milbrandt and Morrison (2016)
Default: set by build-namelist (depends on value set in configure).
</entry>

<entry id="macrop_scheme" type="char*16" category="conv"
       group="phys_ctl_nl" valid_values="park,RK,CLUBB_SGS,off" >
Type of macrophysics scheme employed.  'park' for Park
(1998); 'RK' for Rasch and Kristjansson (1998); 'CLUBB_SGS' clubb.
Default: set by build-namelist
</entry>

<entry id="do_clubb_sgs" type="logical" category="conv"
       group="phys_ctl_nl" valid_values="" >
Switch for CLUBB_SGS
Default: FALSE
</entry>

<entry id="do_shoc_sgs" type="logical" category="conv"
       group="phys_ctl_nl" valid_values="" >
Switch for SHOC_SGS
Default: FALSE
</entry>

<entry id="do_aerocom_ind3" type="logical" category="conv"
       group="phys_ctl_nl" valid_values="" >
Switch for AeroCom diagnostics
Default: FALSE
</entry>

<entry id="shallow_scheme" type="char*16" category="conv"
       group="phys_ctl_nl" valid_values="off,Hack,UW,CLUBB_SGS" >
Type of shallow convection scheme employed.  'Hack' for Hack shallow convection;
'UW' for original McCaa UW pbl scheme, modified by Sungsu Park; 'CLUBB_SGS' for CLUBB_SGS
Default: set by build-namelist (depends on <varname>eddy_scheme</varname>).
</entry>

<entry id="do_tms" type="logical" category="pbl"
       group="phys_ctl_nl" valid_values="" >
Logical switch to turn on turbulent mountain stress calculation in
vertical diffusion routine.
Default: set by build-namelist
</entry>

<entry id="micro_do_icesupersat" type="logical"  category="conv"
       group="phys_ctl_nl" valid_values="" >
Apply ice supersaturation adjustment code
Default: .false.
</entry>

<entry id="eddy_lbulk_max" type="real" category="conv"
       group="vert_diff_nl" valid_values="" >
Maximum master length scale designed to address issues in diag_TKE outside the
boundary layer.
In order not to disturb turbulence characteristics in the lower troposphere,
this should be set at least larger than a few km. However, this does not
significantly improve the values outside of the boundary layer. Smaller values
make some improvement, but it is also noisy. Better results are seen using
eddy_leng_max or kv_freetrop_scale.
Default: 40.e3 (m)
</entry>

<entry id="eddy_leng_max" type="real" category="conv"
       group="vert_diff_nl" valid_values="" >
Maximum dissipation length scale designed to address issues with diag_TKE outside
the boundary layer, where the default value generates large diffusivities. A value
of 30 m is consistent with the length scales used in the HB scheme; however, this
will also reduce value in the boundary layer.
Default: 40.e3 (m)
</entry>

<entry id="eddy_max_bot_pressure" type="real" category="conv"
       group="vert_diff_nl" valid_values="" >
Bottom pressure level at which namelist values for eddy_leng_max and
eddy_lbulk_max are applied. Default values are used at lower levels (i.e. the
boundary layer).
Default: 100.e3 (hPa)
</entry>

<entry id="eddy_moist_entrain_a2l" type="real" category="conv"
       group="vert_diff_nl" valid_values="" >
Moist entrainment enhancement parameter.
Default: set by build-namelist
</entry>

<entry id="kv_top_pressure" type="real" category="conv"
       group="vert_diff_nl" valid_values="" >
Pressure (Pa) that defined the upper atmosphere for adjustment of
eddy diffusivities from diag_TKE using kv_top_scale.
Default: 0.
</entry>

<entry id="kv_top_scale" type="real" category="conv"
       group="vert_diff_nl" valid_values="" >
Scaling factor that is applied (multiplied) to the eddy diffusivities
in the upper atmosphere (see kv_top_pressure).
Default: 1.0
</entry>

<entry id="kv_freetrop_scale" type="real" category="conv"
       group="vert_diff_nl" valid_values="" >
Scaling factor that is applied (multiplied) to the eddy diffusivities
in the free troposphere (boundary layer to kv_top_pressure)
Default: 1.0
</entry>

<entry id="diff_cnsrv_mass_check" type="logical" category="conv"
       group="vert_diff_nl" valid_values="" >
Perform mass conservation check on eddy diffusion operation.
Default: FALSE
</entry>

<entry id="do_iss" type="logical" category="pbl"
       group="vert_diff_nl" valid_values="" >
Logical switch to turn on implicit turbulent surface stress calculation in
diffusion solver routine.
Default: set by build-namelist
</entry>

<!-- Added flags for regeneration and liq cld fraction bug fixes-->
<entry id="regen_fix" type="logical" category="conv"
       group="phys_ctl_nl" valid_values="" >
This is part of PNNL bug fixes under Polar project.It fixes the
aerosol regeration bug in ndrop.F90
Default: .false.
</entry>

<entry id="liqcf_fix" type="logical" category="conv"
       group="phys_ctl_nl" valid_values="" >
This is part of PNNL bug fixes under Polar project.It fixes the
liq cloud fraction bug in macro and micro physics
Default: .false.
</entry>

<!-- SHOC timestep -->
<entry id="shoc_timestep" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
SHOC timestep.  Setting to < 0 will set SHOC timestep equal to the
macrophysics and microphysics timestep (i.e. dtime/cld_macmic_num_steps).
Default: -1
</entry>

<!-- SHOC tunable parameters -->
<entry id="shoc_thl2tune" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Temperature variance tuning factor.
Default: set by build-namelist
</entry>

<entry id="shoc_qw2tune" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Moisture variance tuning factor.
Default: set by build-namelist
</entry>

<entry id="shoc_qwthl2tune" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Temperature moisture covariance tuning factor.
Default: set by build-namelist
</entry>

<entry id="shoc_w2tune" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Vertical velocity variance tuning factor.
Default: set by build-namelist
</entry>

<entry id="shoc_length_fac" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Length scale tuning factor.
Default: set by build-namelist
</entry>

<entry id="shoc_c_diag_3rd_mom" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Third moment vertical velocity tuning factor.
Default: set by build-namelist
</entry>

<entry id="shoc_lambda_low" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Lowest allowable value for stability correction for isotropic timescale.
Default: set by build-namelist
</entry>

<entry id="shoc_lambda_high" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Higest allowable value for stability correction for isotropic timescale.
Should be set to value equal to or greater than lambda_low.
Default: set by build-namelist
</entry>

<entry id="shoc_lambda_slope" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Controls the slope of increase of stability correction term from low to high values.
Default: set by build-namelist
</entry>

<entry id="shoc_lambda_thresh" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Minimum threshold of integrated stability to increase the stability correction term.
Default: set by build-namelist
</entry>

<entry id="shoc_Ckh" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Coefficient for eddy diffusivity of heat.
Default: set by build-namelist
</entry>

<entry id="shoc_Ckm" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Coefficient for eddy diffusivity of momentum.
Default: set by build-namelist
</entry>

<entry id="shoc_Ckh_s_min" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Minimum allowable value for coefficient for eddy diffusivity for heat for stable boundary layers.
Default: set by build-namelist
</entry>

<entry id="shoc_Ckh_s_max" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Maximum allowable value for coefficient for eddy diffusivity for heat for stable boundary layers.
Default: set by build-namelist
</entry>

<entry id="shoc_Ckm_s_min" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Minimum allowable value for coefficient for eddy diffusivity for momentum for stable boundary layers.
Default: set by build-namelist
</entry>

<entry id="shoc_Ckm_s_max" type="real" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Maximum allowable value for coefficient for eddy diffusivity for momentum for stable boundary layers.
Default: set by build-namelist
</entry>

<entry id="wup_in_cloud_shoc" type="logical" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Switch to turn on implementation of SHOC's mean updraft velocity in cloud.
Default: .false.
</entry>

<entry id="wup_in_cloud_clubb" type="logical" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
Switch to turn on implementation of CLUBB's mean updraft velocity in cloud.
Default: .false.
</entry>

<entry id="clubb_cloudtop_cooling" type="logical"  category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
Apply cloud top radiative cooling parameterization
Default: .false.
</entry>

<entry id="clubb_rainevap_turb" type="logical"  category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
Include effects of precip evaporation on turbulent moments
Default: .false.
</entry>

<entry id="clubb_expldiff" type="logical"  category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
Explicit diffusion on temperature and moisture when CLUBB is on
Default: .false.
</entry>

<entry id="clubb_stabcorrect" type="logical"  category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
CLUBB do explicit diffusion with a stability correction
Default: .false.
</entry>

<entry id="clubb_use_sgv" type="logical"  category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
Enables subgrid features gustiness, tpert, and thv fix
Default: .false.
</entry>

<entry id="do_clasp_shoc" type="logical" category="pblrad"
       group="shocpbl_diff_nl" valid_values="" >
Switch to turn on the clasp emulator for heterogeneous surface coupling   
Default: False
</entry>

<entry id="do_clasp_clubb" type="logical" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
Switch to turn on the clasp emulator for heterogeneous surface coupling   
Default: False
</entry>

<!-- Clubb timestep -->
<entry id="clubb_timestep" type="real" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
CLUBB timestep.
Default: set by build-namelist
</entry>

<entry id="clubb_rnevap_effic" type="real" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
Rain evaporation efficiency factor.
Default: set by build-namelist
</entry>

<entry id="clubb_do_adv" type="logical" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
Switch for CLUBB_ADV
Default: FALSE
</entry>

<entry id="clubb_do_deep" type="logical" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
Switch for CLUBBND_CAM
Default: FALSE
</entry>

<entry id="clubb_liq_deep" type="real" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
clubb liquid deep convection factor
Default: 8.e-6
</entry>

<entry id="clubb_liq_sh" type="real" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
clubb liquid shallow convection factor
Default: 10.e-6
</entry>

<entry id="clubb_ice_deep" type="real" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
clubb  ice deep convection factor
Default: 25.e-6
</entry>

<entry id="clubb_ice_sh" type="real" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
clubb ice shallow convection factor
Default: 50.e-6
</entry>

<entry id="clubb_tk1" type="real" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
temperature thresholds determining the fraction of condensate detrained from ZM as ice
Default: 268.15D0
</entry>

<entry id="clubb_tk2" type="real" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
temperature thresholds determining the fraction of condensate detrained from ZM as ice
Default: 238.15D0
</entry>

<entry id="relvar_fix" type="logical" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
Temporary variable for a bug fix. Introduced to maintain BFB, must be REMOVED later
Default: FALSE
</entry>

<!--Clubb config flags  -->
<entry id="clubb_vert_avg_closure" type="logical" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
CLUBB flag to determine 1) if the trapezoidal rule is called for the thermodynamic-level variables output from pdf_closure; 2) if the trapezoidal rule is called for three momentum-level variables output from pdf_closure; and 3) if call subroutine pdf_closure twice. True means all three options are True, while FALSE means all three options are false.
Default: TRUE
</entry>

<entry id="clubb_ipdf_call_placement" type="integer" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="1,2,3" >
Select the placement of the call to CLUBB's PDF: 1) ipdf_pre_advance_fields --> Call before advancing predictive fields ; 2) ipdf_post_advance_fields --> Call after advancing predictive fields ; 3) ipdf_pre_post_advance_fields --> Call both before and after advancing predictive fields
Default: 1
</entry>


<!-- Clubb tunable parameters -->

<entry id="C1" type="real" category="pblrad"
       group="initvars" valid_values="" >
Constant associated with the dissipation of the variance of vertical velocity
Default: 1.0. See clubb/parameters_tunable.F90
</entry>

<entry id="C2rt" type="real" category="pblrad"
       group="initvars" valid_values="" >
Constant associated with the dissipation of the variance of total water
Default: 1.0
</entry>

<entry id="C6rt" type="real" category="pblrad"
       group="initvars" valid_values="" >
Low skewness of Newtonian damping of water flux
Default: 4.0
</entry>

<entry id="C6rtb" type="real" category="pblrad"
       group="initvars" valid_values="" >
High skewness of Newtonian damping of water flux
Default: 6.0
</entry>

<entry id="C7" type="real" category="pblrad"
       group="initvars" valid_values="" >
Low skewness of buoyancy damping of water flux
Default: 0.5
</entry>

<entry id="C7b" type="real" category="pblrad"
       group="initvars" valid_values="" >
High skewness of buoyancy damping of water flux
Default: 0.5
</entry>

<entry id="C8" type="real" category="pblrad"
       group="initvars" valid_values="" >
Constant associated with Newtonian damping of the third moment of vertical velocity
Default: 4.2
</entry>

<entry id="C11" type="real" category="pblrad"
       group="initvars" valid_values="" >
Low skewnes of buoyancy damping of the third moment of vertical velocity
Default: 0.7
</entry>

<entry id="C11b" type="real" category="pblrad"
       group="initvars" valid_values="" >
High skewnes of buoyancy damping of the third moment of vertical velocity
Default: 0.35
</entry>

<entry id="C14" type="real" category="pblrad"
       group="initvars" valid_values="" >
Constant of Newtonian damping of the variances of u-wind and v-wind
Default: 1.0
</entry>

<entry id="beta" type="real" category="pblrad"
       group="initvars" valid_values="" >
Constant related to skewness of liquid water potential temperature and total water
Default: 2.4
</entry>

<entry id="gamma_coef" type="real" category="pblrad"
       group="initvars" valid_values="" >
Constant of the width of PDF in w-coordinate Low Skw. gamma coef. Skw. Fnct
Default: 0.32
</entry>

<entry id="mu" type="real" category="pblrad"
       group="initvars" valid_values="" >
Fractional parcel entrainment rate per unit height (1/m)
Default: 0.001
</entry>

<entry id="nu1" type="real" category="pblrad"
       group="initvars" valid_values="" >
Background coefficient of eddy diffusion
Default: 20.0
</entry>

<!-- Parameters to indirectly control clubb tunable parameters-->

<entry id="clubb_C1" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Constant associated with the dissipation of the variance of vertical velocity
Default: 1.0. See clubb/parameters_tunable.F90
</entry>

<entry id="clubb_C1b" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Constant associated with the dissipation of the variance of vertical velocity
Default: 1.0. See clubb/parameters_tunable.F90
</entry>

<entry id="clubb_C1c" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Constant associated with the dissipation of the variance of vertical velocity
Default: 1.0. See clubb/parameters_tunable.F90
</entry>

<entry id="clubb_C2rt" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Constant associated with the dissipation of the variance of total water
Default: 1.0
</entry>

<entry id="clubb_C2thl" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
C2 coef. for the thlp2_dp1 term
Default: 1.0 or clubb_C2rt if it is specified
</entry>

<entry id="clubb_C2rtthl" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
C2 coef. for the rtpthlp_dp1 term
Default: 1.3 or 1.3*clubb_C2rt if it is specified
</entry>

<entry id="clubb_C6rt" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Low skewness of Newtonian damping of water flux
Default: 4.0
</entry>

<entry id="clubb_C6rtb" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
High skewness of Newtonian damping of water flux
Default: 6.0
</entry>

<entry id="clubb_C6rtc" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
High skewness of Newtonian damping of water flux
Default: 1.0
</entry>

<entry id="clubb_C6thlb" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Low skewness of Newtonian damping of water flux
Default: 1.0
</entry>

<entry id="clubb_C6thlc" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Low skewness of Newtonian damping of water flux
Default: 6.0
</entry>


<entry id="clubb_C7" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Low skewness of buoyancy damping of water flux
Default: 0.5
</entry>

<entry id="clubb_C7b" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
High skewness of buoyancy damping of water flux
Default: 0.5
</entry>

<entry id="clubb_C8" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Constant associated with Newtonian damping of the third moment of vertical velocity
Default: 4.2
</entry>

<entry id="clubb_C11" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Low skewnes of buoyancy damping of the third moment of vertical velocity
Default: 0.7
</entry>

<entry id="clubb_C11b" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
High skewnes of buoyancy damping of the third moment of vertical velocity
Default: 0.35
</entry>

<entry id="clubb_C11c" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
High skewnes of buoyancy damping of the third moment of vertical velocity
Default: 0.5
</entry>

<entry id="clubb_C14" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Constant of Newtonian damping of the variances of u-wind and v-wind
Default: 1.0
</entry>

<entry id="clubb_beta" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Constant related to skewness of liquid water potential temperature and total water
Default: 2.4
</entry>

<entry id="clubb_gamma_coef" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Constant of the width of PDF in w-coordinate
Default: 0.32
</entry>

<entry id="clubb_gamma_coefb" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
High Skw. gamma coef. Skw. Fnct.
Default: 0.32 or clubb_gamma_coef if it is specified
</entry>

<entry id="clubb_gamma_coefc" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
High Skw. gamma coef. Skw. Fnct.
Default: 5.0or clubb_gamma_coef if it is specified
</entry>

<entry id="clubb_mu" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Fractional parcel entrainment rate per unit height (1/m)
Default: 0.001
</entry>

<entry id="clubb_nu1" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Background coefficient of eddy diffusion
Default: 20.0
</entry>

<entry id="clubb_c_K10" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Coefficient of Kh_zm
Default: 0.60
</entry>

<entry id="clubb_c_K10h" type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Coefficient of Kh_zm for eddy mixing of scalars
Default: 1.00
</entry>

<entry id="clubb_wpxp_L_thresh"  type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Lscale threshold: damp C6 & C7  [m]
Default: 60.0D0
</entry>

<entry id="clubb_altitude_thresh"  type="real" category="pblrad"
       group="clubb_param_nl" valid_values="" >
Lscale threshold: prevent large damping at low altitudes where Lscale is small
Default: 100.0D0
</entry>

=======
<!-- Ozone: Data (original CAM version) -->

<entry id="bndtvo" type="char*256" input_pathname="abs" category="o3_data_cam"
       group="cam3_ozone_data_nl" valid_values="" >
Full pathname of time-variant ozone mixing ratio boundary dataset.
Default: set by build-namelist.
</entry>

<entry id="cam3_ozone_data_on" type="logical"  category="o3_data_cam"
       group="cam3_ozone_data_nl" valid_values="" >
Add CAM3 prescribed ozone to the physics buffer.
Default: FALSE
</entry>

<entry id="ozncyc" type="logical"  category="o3_data_cam"
       group="cam3_ozone_data_nl" valid_values="" >
Flag for yearly cycling of ozone data. If set to FALSE, a multi-year
dataset is assumed, otherwise a single-year dataset is assumed, and ozone
will be cycled over the 12 monthly averages in the file.
Default: TRUE
</entry>

<!-- Performance Tuning and Profiling -->

<entry id="papi_ctr1_str" type="char*16"  category="performance"
       group="papi_inparm" valid_values="">
String identifying a hardware counter to the papi library.
Default: PAPI_TOT_CYC
</entry>

<entry id="papi_ctr2_str" type="char*16"  category="performance"
       group="papi_inparm" valid_values="">
String identifying a hardware counter to the papi library.
Default: PAPI_FP_OPS
</entry>

<entry id="papi_ctr3_str" type="char*16"  category="performance"
       group="papi_inparm" valid_values="">
String identifying a hardware counter to the papi library.
Default: PAPI_FP_INS
</entry>

<entry id="papi_ctr4_str" type="char*16"  category="performance"
       group="papi_inparm" valid_values="">
String identifying a hardware counter to the papi library.
Default: PAPI_NO_CTR
</entry>

<entry id="print_step_cost" type="logical"  category="performance"
       group="cam_inparm" valid_values="">
If TRUE, print CPU timing per model timestep.
Default: FALSE
</entry>

<entry id="profile_barrier" type="logical"  category="performance"
       group="prof_inparm" valid_values="">
Flag indicating whether the mpi_barrier in t_barrierf should be called.
Default: FALSE
</entry>

<entry id="profile_depth_limit" type="integer"  category="performance"
       group="prof_inparm" valid_values="">
Maximum number of levels of timer nesting .
Default: 99999
</entry>

<entry id="profile_detail_limit" type="integer"  category="performance"
       group="prof_inparm" valid_values="">
Maximum detail level to profile.
Default: 1
</entry>

<entry id="profile_disable" type="logical"  category="performance"
       group="prof_inparm" valid_values="">
Flag indicating whether timers are disabled.
Default: FALSE
</entry>

<entry id="profile_global_stats" type="logical"  category="performance"
       group="prof_inparm" valid_values="">
Collect and print out global performance statistics (for this component communicator).
Default: FALSE
</entry>

<entry id="profile_outpe_num" type="integer"  category="performance"
       group="prof_inparm" valid_values="">
Maximum number of processes writing out timing data (for this component communicator).
Default: -1
</entry>

<entry id="profile_outpe_stride" type="integer"  category="performance"
       group="prof_inparm" valid_values="">
Separation between process ids for processes that are writing out timing data
(for this component communicator).
Default: 1
</entry>

<entry id="profile_papi_enable" type="logical"  category="performance"
       group="prof_inparm" valid_values="">
Flag indicating whether the PAPI namelist should be read and HW performance counters
used in profiling.
Default: FALSE
</entry>

<entry id="profile_single_file" type="logical"  category="performance"
       group="prof_inparm" valid_values="">
Flag indicating whether the performance timer output should be written to a
single file (per component communicator) or to a separate file for each
process.
Default: TRUE
</entry>

<entry id="profile_timer" type="integer"  category="performance"
       group="prof_inparm" valid_values="">
Initialization of GPTL timing library.
Default: GPTLmpiwtime
</entry>

<entry id="swap_comm_protocol" type="integer"  category="performance"
       group="spmd_utils_nl" valid_values="">
Swap communication protocol option (reduced set):
 3, 5:                  nonblocking send
 2, 3, 4, 5:            nonblocking receive
 4, 5:                  ready send
Default: 4
</entry>

<entry id="swap_comm_maxreq" type="integer"  category="performance"
       group="spmd_utils_nl" valid_values="">
Swap communication maximum request count:
 &lt;=0: do not limit number of outstanding send/receive requests
  &gt;0: do not allow more than swap_comm_maxreq outstanding
      nonblocking send requests or nonblocking receive requests
Default: 128
</entry>

<entry id="fc_gather_flow_cntl" type="integer"  category="performance"
       group="spmd_utils_nl" valid_values="">
fc_gather flow control option:
 &lt; 0 : use MPI_Gather
 &gt;= 0: use point-to-point with handshaking messages and preposting
       receive requests up to
         max(min(1,fc_gather_flow_cntl),max_gather_block_size)
       ahead. Default value is defined by private parameter
       max_gather_block_size, which is currently set to 64.
Default: 64
</entry>

<!-- Physics Buffer -->

<entry id="pbuf_global_allocate" type="logical" category="pbuf"
       group="cam_inparm" valid_values="" >
Allocate all buffers as global.  This is a performance optimization on
machines for which allocation/deallocation of physpkg scope buffers on
every timestep was slow (Cray-X1).
Default: TRUE
</entry>

<!-- Physics control -->

<entry id="cam_physpkg" type="char*16" category="build"
       group="phys_ctl_nl" valid_values="cam3,cam4,cam5,ideal,adiabatic,default" >
Name of the CAM physics package.  N.B. this variable may not be set by
the user.  It is set by build-namelist via information in the configure
cache file to be consistent with how CAM was built.
Default: set by build-namelist
</entry>

<entry id="ideal_phys_option" type="char*128" group="phys_ctl_nl"
       valid_values="held-suarez,held-suarez-williamson,held-suarez-lin-williamson">
Type of idealized physics configuration to use if running cam_physpkg="ideal".
Default: held-suarez
</entry>

<entry id="cam_chempkg" type="char*16" category="build"
       group="phys_ctl_nl" valid_values="waccm_mozart,waccm_ghg,trop_mozart,
                                         trop_ghg,trop_bam,trop_mam3,trop_mam4,trop_mam4_resus_soag,
					 trop_mam4_mom,trop_mam7,trop_mam9,
                                         linoz_mam3,linoz_mam4_resus,
					 linoz_mam4_resus_soag,linoz_mam4_resus_mom,
					 linoz_mam4_resus_mom_soag,
                                         super_fast_llnl,super_fast_llnl_mam3,
					 superfast_mam4_resus_mom_soag,none " >
Name of the CAM chemistry package.  N.B. this variable may not be set by
the user.  It is set by build-namelist via information in the configure
cache file to be consistent with how CAM was built.
Default: set by build-namelist
</entry>

<entry id="waccmx_opt" type="char*16" category="waccm"
       group="phys_ctl_nl" valid_values="ionosphere,neutral,off" >
Runtime options of upper thermosphere WACCM-X.  'ionosphere' for
full ionopshere and neutral thermosphere, 'neutral' for just
neutral thermosphere, and off for no WACCM-X.
Default: 'off'
</entry>

<!-- Reference Pressures -->

<entry id="trop_cloud_top_press" type="real" category="press_lim"
       group="ref_pres_nl" valid_values="" >
Troposphere cloud physics will be done only below the top defined
by this pressure (Pa).
Default: set by build-namelist
</entry>

<entry id="clim_modal_aero_top_press" type="real" category="press_lim"
       group="ref_pres_nl" valid_values="" >
MAM affects climate only below the top defined by this pressure (Pa).
Default: 0 for non-MAM cases, otherwise set by build-namelist
</entry>

<entry id="do_molec_press" type="real" category="press_lim"
       group="ref_pres_nl" valid_values="" >
Molecular diffusion will be done only if the lowest pressure is
below this limit (Pa).
Default: 0.1
</entry>

<entry id="molec_diff_bot_press" type="real" category="press_lim"
       group="ref_pres_nl" valid_values="" >
The level closest to this pressure (Pa) is the bottom of the region
where molecular diffusion is done.
Default: 50.
</entry>

<!-- Physics Debugging -->

<entry id="phys_debug_lat" type="real"  category="phys_debug"
       group="phys_debug_nl" valid_values="">
Use this variable to specify the latitude (in degrees) of a column to
debug.  The closest column in the physics grid will be used.
Default: none
</entry>

<entry id="phys_debug_lon" type="real"  category="phys_debug"
       group="phys_debug_nl" valid_values="">
Use this variable to specify the longitude (in degrees) of a column to
debug.  The closest column in the physics grid will be used.
Default: none
</entry>

<entry id="state_debug_checks" type="logical"  category="phys_debug"
       group="phys_ctl_nl" valid_values="">
If set to .true., turns on extra validation of physics_state objects
in physics_update. Used mainly to track down which package is the
source of invalid data in state.
Default: .false.
</entry>


<!-- Planetary Boundary Layer and Vertical Diffusion -->

<entry id="srf_flux_avg" type="integer" category="pbl"
       group="phys_ctl_nl" valid_values="0,1" >
Switch to turn on adjustment of the surface fluxes to reduce instabilities
in the surface layer.  Set to 1 to turn on the adjustments.
Default: 0
</entry>

<entry id="eddy_scheme" type="char*16" category="pbl"
       group="phys_ctl_nl" valid_values="off,HB,diag_TKE,HBR,CLUBB_SGS" >
Type of eddy scheme employed by the vertical diffusion package.  'HB' for
Holtslag and Boville; 'diag_TKE' for diagnostic tke version of Grenier and
Bretherton; 'HBR' for Rasch modified version of 'HB'.
Default: 'HB'
</entry>

<entry id="linearize_pbl_winds" type="logical" category="pbl"
       group="phys_ctl_nl" valid_values="" >
If .true., a linearization of the response of the pbl scheme to surface stresses
is sent to the coupler every time step, using the fields 'wsresp' and 'tau_est'.
</entry>

<entry id="export_gustiness" type="logical" category="pbl"
       group="phys_ctl_nl" valid_values="" >
If .true., a gustiness value will be exported to the coupler, which allows
surface components to distinguish between the effect of mean wind and gustiness
when calculating fluxes (and in particular surface drag).

If .false., no extra value is exported, and gustiness is instead applied by the
atmosphere by scaling up the exported wind fields (ubot and vbot). This is
simpler and requires slightly less coupling overhead, but produces numerical
artifacts (oscillations) in surface stresses, particularly when the gustiness is
large compared with the mean wind.
</entry>


<!-- Flags for implementing code modifications under polar project -->

<!-- Scavenging mods-->

<entry id="convproc_do_aer" type="logical"  category="scavenging"
       group="phys_ctl_nl" valid_values="" >
Switch to use new unified convective transport for aerosols
Default: .false.
</entry>

<entry id="convproc_method_activate" type="integer"  category="scavenging"
       group="phys_ctl_nl" valid_values="0,1,2" >
Switch to choose activation method for unified convective transport of aerosols
Default: 2
</entry>
<entry id="convproc_do_gas" type="logical"  category="scavenging"
       group="phys_ctl_nl" valid_values="" >
Switch to use new unified convective transport scheme for gas
Default: .false.
</entry>

<entry id="resus_fix" type="logical"  category="scavenging"
       group="phys_ctl_nl" valid_values="" >
resuspension bug fix in wetdep.F90
Default: .false.
</entry>

<entry id="demott_ice_nuc" type="logical"  category="ice_nucleation"
       group="phys_ctl_nl" valid_values="" >
ice nucleation scheme by Demott
Default: .false.
</entry>

<entry id="pergro_mods" type="logical"  category="perturbation"
       group="phys_ctl_nl" valid_values="" >
switch to turn on pergro code changes
Default: .false.
</entry>

<entry id="pergro_test_active" type="logical"  category="perturbation"
       group="phys_ctl_nl" valid_values="" >
switch to turn on code instrumentations for running pergro test
Default: .false.
</entry>


<!-- Flag to turn on/off amicphys codes -->
<entry id="mam_amicphys_optaa" type="integer"  category="scavenging"
       group="phys_ctl_nl" valid_values="" >
invokes new microphysics code (single call to amicphys routine) if > 0
Default: 0
</entry>


<!-- number of so4(+nh4) monolayers needed to "age" a carbon particle -->
<entry id="n_so4_monolayers_pcage" type="real"  category="scavenging"
       group="phys_ctl_nl" valid_values="" >
number of so4(+nh4) monolayers needed to "age" a carbon particle
Default: Set by namelist
</entry>


<!-- Diagnostics -->

<entry id="history_amwg" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Produce output for the AMWG diagnostic package.
Default: .true.
</entry>

<entry id="history_verbose" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Produce verbose history output by default
Default: .false.
</entry>

<entry id="history_vdiag" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Produce output for the AMWG variability diagnostics.
Default: .false.
</entry>

<entry id="history_aerosol" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch for diagnostic output of the aerosol tendencies
Default: .false.
</entry>

<entry id="history_aero_optics" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch for diagnostic output of the aerosol optics
Default: .false.
</entry>

<entry id="history_eddy" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch for diagnostic output of eddy variables
Default: .false.
</entry>

<entry id="history_budget" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch for cam4 T/Q budget diagnostic output
Default: .false.
</entry>

<entry id="history_budget_histfile_num" type="integer"  category="diagnostics"
       group="phys_ctl_nl" valid_values="1,2,3,4,5,6" >
History tape number T/Q budget output is written to.
Default: 1
</entry>

<entry id="history_gaschmbudget" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch for gas chemistry tracers budget diagnostic output
Default: .false.
</entry>

<entry id="history_gaschmbudget_2D" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch for gas chemistry tracers 2D budget diagnostic output
Default: .false.
</entry>

<entry id="history_gaschmbudget_2D_levels" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch for gas chemistry tracers 2D budget diagnostic output within certain levels
Default: .false.
</entry>

<entry id="gaschmbudget_2D_L1_s" type="integer" category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Start layer of L1 for gas chemistry tracers 2D budget diagnostic output
Default: 1
</entry>

<entry id="gaschmbudget_2D_L1_e" type="integer" category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
End layer of L1 for gas chemistry tracers 2D budget diagnostic output
Default: 26
</entry>

<entry id="gaschmbudget_2D_L2_s" type="integer" category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Start layer of L2 for gas chemistry tracers 2D budget diagnostic output
Default: 27
</entry>

<entry id="gaschmbudget_2D_L2_e" type="integer" category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
End layer of L2 for gas chemistry tracers 2D budget diagnostic output
Default: 38
</entry>

<entry id="gaschmbudget_2D_L3_s" type="integer" category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Start layer of L3 for gas chemistry tracers 2D budget diagnostic output
Default: 39
</entry>

<entry id="gaschmbudget_2D_L3_e" type="integer" category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
End layer of L3 for gas chemistry tracers 2D budget diagnostic output
Default: 58
</entry>

<entry id="gaschmbudget_2D_L4_s" type="integer" category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Start layer of L4 for gas chemistry tracers 2D budget diagnostic output
Default: 59
</entry>

<entry id="gaschmbudget_2D_L4_e" type="integer" category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
End layer of L4 for gas chemistry tracers 2D budget diagnostic output
Default: 72
</entry>

<entry id="history_UCIgaschmbudget_2D" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch for gas chemistry tracers 2D budget diagnostic output
Default: .false.
</entry>

<entry id="history_UCIgaschmbudget_2D_levels" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch for gas chemistry tracers 2D budget diagnostic output within certain levels
Default: .false.
</entry>

<entry id="history_waccm" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch for diagnostic output used primarily for WACCM runs.
Default: .true. if WACCM physics is on, .false. otherwise.
</entry>
<!-- Bug fix flags -->
<entry id="fix_g1_err_ndrop" type="logical"  category="bugfixes"
       group="phys_ctl_nl" valid_values=".true.,.false.,.TRUE.,.FALSE." >
Switch to fix a bug in ndrop.F90 for "repeated g1 eqn".
Default: .false.


<entry id="history_clubb" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch for diagnostics specific to CLUBB.
Default: .true.
</entry>

<entry id="get_presc_aero_data" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Output needed to generate input to drive a prescribed aerosol climate run.
Requires that history_aerosol be set to true. Note that additional
post processing is required with output in order to generate a
prescribed aerosol climate run.
Default: .false.
</entry>

<!-- Radiation -->
<entry id="radiation_scheme" type="char*16" category="radiation"
       group="phys_ctl_nl" valid_values="rrtmg,rrtmgp" >
Type of radiation scheme employed.
Default: set by build-namelist
</entry>

<entry id="constant_zenith_deg" type="real"  category="radiation"
       group="phys_ctl_nl" valid_values="" >
Constant solar zenith angle value in degrees for idealized configurations
such as radiative-convective equilibrium experiments. This is disabled when
the value is less than 0
Default: -1
</entry>

<entry id="do_spa_optics" type="logical" category="radiation"
       group="radiation_nl" valid_values=".true.,.false." >
Specify if optics are read in from spa ncdf file.
Default: FALSE
</entry>

<entry id="conv_water_in_rad" type="integer" category="radiation"
       group="phys_ctl_nl" valid_values="0,1,2" >
Convective water used in radiation?
0 ==> No
1 ==> Yes - Arithmetic average.
2 ==> Yes - Average in emissivity.
Default: set by build-namelist
</entry>

<entry id="iradlw" type="integer"  category="radiation"
       group="radiation_nl" valid_values="">
Interval of long-wave radiation calculation in timesteps (if positive) or
model hours (if negative).
Default: -1
</entry>

<entry id="iradsw" type="integer"  category="radiation"
       group="radiation_nl" valid_values="">
Interval of short-wave radiation calculation in timesteps (if positive) or
model hours (if negative).
Default: -1
</entry>

<entry id="irad_always" type="integer"  category="radiation"
       group="radiation_nl" valid_values="">
Specifies length of time in timesteps (positive) or hours (negative) SW/LW
radiation will be run for every timestep from the start of an initial run.
Default: 0
</entry>

<entry id="do_aerosol_rad" type="logical"  category="radiation"
       group="radiation_nl" valid_values="" >
Indicates whether to consider aerosols in radiative calculations
Default: TRUE
</entry>

<entry id="fixed_total_solar_irradiance" type="real"  category="radiation"
       group="radiation_nl" valid_values="" >
Fixed value of solar constant for idealized configurations such as
radiative-convective equilibrium experiments. This is disabled when
the value is less than 0
Default: -1
</entry>

<entry id="spectralflux" type="logical"  category="radiation"
       group="radiation_nl" valid_values="" >
Return fluxes per band in addition to the total fluxes.
Default: FALSE
</entry>

<entry id="use_rad_dt_cosz" type="logical"  category="radiation"
       group="radiation_nl" valid_values="" >
If true, then use the radiation timestep for all cosz calculations.
NOTE: This logical flag is *temporary*. It should be REMOVED after we decide
to make this functionality default
Default: FALSE
</entry>

<entry id="raytau0" type="real"  category="physc_test"
       group="cam_inparm" valid_values="" >
Approximate value of decay time at model top (days);
#if 0., no rayleigh friction is applied
Default: 0.0D0
</entry>

<entry id="mode_defs" type="char*256(400)"  category="radiation"
       group="rad_cnst_nl" valid_values="" >
Definitions for the aerosol modes that may be used in the rad_climate and
rad_diag_* variables.
Default: set by build-namelist
</entry>

<entry id="rad_climate" type="char*256(n_rad_cnst)"  category="radiation"
       group="rad_cnst_nl" valid_values="" >
A list of the radiatively active species, i.e., species that affect the
climate simulation via the radiative heating rate calculation.
Default: set by build-namelist
</entry>

<entry id="rad_diag_1" type="char*256(n_rad_cnst)"  category="radiation"
       group="rad_cnst_nl" valid_values="" >
A list of species to be used in the first diagnostic radiative heating rate
calculation.  These species are not the ones affecting the climate
simulation.  This is a hook for performing radiative forcing calculations.
Default: none
</entry>

<entry id="rad_diag_2" type="char*256(n_rad_cnst)"  category="radiation"
       group="rad_cnst_nl" valid_values="" >
Analogous to rad_diag_1, but for the 2nd diagnostic calculation.
Default: none
</entry>

<entry id="rad_diag_3" type="char*256(n_rad_cnst)"  category="radiation"
       group="rad_cnst_nl" valid_values="" >
Analogous to rad_diag_1, but for the 3rd diagnostic calculation.
Default: none
</entry>

<entry id="rad_diag_4" type="char*256(n_rad_cnst)"  category="radiation"
       group="rad_cnst_nl" valid_values="" >
Analogous to rad_diag_1, but for the 4th diagnostic calculation.
Default: none
</entry>

<entry id="rad_diag_5" type="char*256(n_rad_cnst)"  category="radiation"
       group="rad_cnst_nl" valid_values="" >
Analogous to rad_diag_1, but for the 5th diagnostic calculation.
Default: none
</entry>

<entry id="rad_diag_6" type="char*256(n_rad_cnst)"  category="radiation"
       group="rad_cnst_nl" valid_values="" >
Analogous to rad_diag_1, but for the 6th diagnostic calculation.
Default: none
</entry>

<entry id="rad_diag_7" type="char*256(n_rad_cnst)"  category="radiation"
       group="rad_cnst_nl" valid_values="" >
Analogous to rad_diag_1, but for the 7th diagnostic calculation.
Default: none
</entry>

<entry id="rad_diag_8" type="char*256(n_rad_cnst)"  category="radiation"
       group="rad_cnst_nl" valid_values="" >
Analogous to rad_diag_1, but for the 8th diagnostic calculation.
Default: none
</entry>

<entry id="rad_diag_9" type="char*256(n_rad_cnst)"  category="radiation"
       group="rad_cnst_nl" valid_values="" >
Analogous to rad_diag_1, but for the 9th diagnostic calculation.
Default: none
</entry>

<entry id="rad_diag_10" type="char*256(n_rad_cnst)"  category="radiation"
       group="rad_cnst_nl" valid_values="" >
Analogous to rad_diag_1, but for the 10th diagnostic calculation.
Default: none
</entry>


<entry id="rad_data_output" type="logical"   category="radiation"
       group="rad_data_nl" valid_values="" >
output data needed for off-line radiation calculations
Default: FALSE
</entry>

<entry id="rad_data_histfile_num" type="integer"   category="radiation"
       group="rad_data_nl" valid_values="" >
History tape number radiation driver output data is written to.
Default: 0
</entry>

<entry id="rad_data_avgflag" type="char*1"   category="radiation"
       group="rad_data_nl" valid_values="" >
Averaging flag for adiation driver output data.
Default: 'A'
</entry>

<!-- Aerosol and cloud optics -->

<entry id="water_refindex_file" type="char*256" input_pathname="abs" category="radiation"
       group="modal_aer_opt_nl" valid_values="" >
Full pathname of dataset for water refractive indices used in modal aerosol optics
Default: none
</entry>


<entry id="drydep_srf_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="">
Dry deposition surface values interpolated to model grid, required for unstructured atmospheric grids
with modal chemistry.
Default: none
</entry>

<entry id="oldcldoptics" type="logical"  category="radiation"
       group="rad_cnst_nl" valid_values="" >
filepath and name for ice optics data for rrtmg
Default: none
</entry>

<entry id="liqcldoptics" type="char*32"  category="radiation"
       group="rad_cnst_nl" valid_values="slingo,gammadist" >
filepath and name for ice optics data for rrtmg
Default: none
</entry>

<entry id="icecldoptics" type="char*32"  category="radiation"
       group="rad_cnst_nl" valid_values="ebertcurry,mitchell" >
filepath and name for ice optics data for rrtmg
Default: none
</entry>

<entry id="iceopticsfile" type="char*256" input_pathname="abs"  category="radiation"
       group="rad_cnst_nl" valid_values="" >
filepath and name for ice optics data for rrtmg
Default: none
</entry>

<entry id="liqopticsfile" type="char*256" input_pathname="abs"  category="radiation"
       group="rad_cnst_nl" valid_values="" >
filepath and name for liquid cloud (gamma distributed) optics data for rrtmg
Default: none
</entry>

<!-- RRTMGP gaseous absorption coefficients -->
<entry id="rrtmgp_coefficients_file_lw" type="char*256" input_pathname="abs"
       category="radiation" group="radiation_nl" valid_values="">
File path for RRTMGP longwave gaseous absorption coefficients file.
</entry>

<entry id="rrtmgp_coefficients_file_sw" type="char*256" input_pathname="abs"
       category="radiation" group="radiation_nl" valid_values="">
File path for RRTMGP shortwave gaseous absorption coefficients file.
</entry>

<entry id="rrtmgp_enable_temperature_warnings" type="logical"
       category="radiation" group="radiation_nl" valid_values="">
Enables low temperature warnings in RRTMGP.
Disabling this is useful to avoid filling up logs for aqua planet cases.
Default: TRUE
</entry>

<!-- Rayleigh Friction Parameterization -->

<entry id="rayk0" type="integer" category="rayleigh_friction"
       group="cam_inparm" valid_values="">
Variable to specify the vertical index at which the
Rayleigh friction term is centered (the peak value).
Default: 2
</entry>

<entry id="raykrange" type="real" category="rayleigh_friction"
       group="cam_inparm" valid_values="">
Rayleigh friction parameter to determine the width of the profile.  If set
to 0 then a width is chosen by the algorithm (see rayleigh_friction.F90).
Default: 0.
</entry>

<entry id="raytau0" type="real" category="rayleigh_friction"
       group="cam_inparm" valid_values="">
Rayleigh friction parameter to determine the approximate value of the decay
time (days) at model top.  If 0.0 then no Rayleigh friction is applied.
Default: 0.
</entry>


<!-- Restart (Continuation and Branch) Runs -->

<entry id="cam_branch_file" type="char*256" category="restart"
       group="cam_inparm" valid_values="">
Full pathname of master restart file from which to branch. Setting is
Required for branch run.
Default: none
</entry>


<!-- Single column mode -->

<entry id="iopfile" type="char*128" input_pathname="abs" category="scam"
       group="cam_inparm" valid_values="" >
Full pathname of IOP dataset.
Default: set by build-namelist.
</entry>

<entry id="scm_iop_srf_prop" type="logical" category="scam"
       group="cam_inparm" valid_values="">
Use the specified surface properties.
Default: FALSE
</entry>

<entry id="iop_nudge_tscale" type="real" category="scam"
       group="cam_inparm" valid_values="">
Time scale to nudge to IOP forcing file.
Default: 10800 (s)

<entry id="dp_crm" type="logical" category="scam"
       group="cam_inparm" valid_values="">
Set to TRUE to turn on doubly periodic cloud resolving model mode.
Default: FALSE
</entry>

<entry id="iop_dosubsidence" type="logical" category="scam"
       group="cam_inparm" valid_values="">
Compute LS vertical transport using omega prescribed from IOP file.
Default: FALSE
</entry>

<entry id="iop_nudge_tq" type="logical" category="scam"
       group="cam_inparm" valid_values="">
Use relaxation for temperature and moisture.
Default: FALSE
</entry>

<entry id="iop_nudge_uv" type="logical" category="scam"
       group="cam_inparm" valid_values="">
Use relaxation for u and v winds.
Default: FALSE
</entry>

<entry id="iop_nudge_tq_low" type="real" category="scam"
       group="cam_inparm" valid_values="">
Lowest layer to apply relaxation for t and q.  Keep to default value to apply relaxation
at the surface.
Default: 1050.0 (hPa)
</entry>

<entry id="iop_nudge_tq_high" type="real" category="scam"
       group="cam_inparm" valid_values="">
Highest layer to apply relaxation for t and q.  Keep to default value to apply relaxation
at the model top.   
Default: 0.e3 (hPa)
</entry>

<entry id="iop_nudge_tscale" type="real" category="scam"
       group="cam_inparm" valid_values="">
Time scale to nudge to IOP forcing file.
Default: 10800 (s)
</entry>

<entry id="iop_perturb_high" type="real" category="scam"
       group="cam_inparm" valid_values="">
Highest layer to apply perturbations for doubly periodic CRM mode.
Default: 0.e3 (hPa)
</entry>

<entry id="scm_observed_aero" type="logical" category="scam"
       group="cam_inparm" valid_values="">
Initialize with observed aerosols from IOP file.
Default: FALSE
</entry>

<entry id="precip_off" type="logical" category="scm"
       group="cam_inparm" valid_values="">
Turn off microphysics computation.
Default: FALSE
</entry>                                                                        |
                                                                                |
<entry id="scm_zero_non_iop_tracers" type="logical" category="scam"
       group="cam_inparm" valid_values="">
Ignore all tracers from initial conditions file, and default all tracers not
specified in IOP to minimum value (usually zero).
Default: FALSE
</entry>

<!-- Solar Parameters -->

<entry id="solar_const" type="real" category="solar"
       group="solar_inparm" valid_values="">
Total solar irradiance (W/m2).
Default: set by build-namelist
</entry>

<entry id="solar_data_file" type="char*256" input_pathname="abs" category="solar"
       group="solar_inparm" valid_values="" >
Full pathname of dataset for file that contains the solar photon enerspectra or TSI data
as a time series
Default: none
</entry>

<entry id="solar_data_type" type="char*8" category="solar"
       group="solar_inparm" valid_values="FIXED,SERIAL" >
Type of time interpolation for data in <varname>solar_data_file</varname>.
Can be set to "FIXED" or "SERIAL".
Default: SERIAL
</entry>

<entry id="solar_data_ymd" type="integer"  category="solar"
       group="solar_inparm" valid_values="" >
If <varname>solar_data_type</varname> is "FIXED" then solar_data_ymd
is the date the solar data is fixed to.  If <varname>solar_data_type</varname>
is "SERIAL" the solar_data_ymd is the start date of the time series
of solar data.
Format: YYYYMMDD
Default: none
</entry>

<entry id="solar_data_tod" type="integer"  category="solar"
       group="solar_inparm" valid_values="" >
Seconds of the day corresponding to <varname>solar_data_ymd</varname>
Default: current model time of day
</entry>

<entry id="solar_htng_spctrl_scl" type="logical"  category="solar"
       group="solar_inparm" valid_values="" >
Use spectral scaling in the radiation heating
Default: false
</entry>

<!-- MMF -->
<entry id="use_MMF" type="logical"  category="conv"
       group="phys_ctl_nl" valid_values="" >
Turn on multiscale modelling framework
Default: false
</entry>

<entry id="use_MMF_VT" type="logical"  category="conv"
       group="phys_ctl_nl" valid_values="" >
Turn on MMF variance transport
Default: false
</entry>

<entry id="use_MMF_ESMT" type="logical"  category="conv"
       group="phys_ctl_nl" valid_values="" >
Turn on MMF explicit scalar momentum transport (ESMT)
Default: false
</entry>

<entry id="use_ECPP" type="logical"  category="conv"
       group="phys_ctl_nl" valid_values="" >
Turn on explicit cloud parameterized pollutants
Default: false
</entry>

<entry id="MMF_microphysics_scheme" type="char*16" category="conv"
       group="phys_ctl_nl" valid_values="m2005, sam1mom" >
Type of E3SM-MMF microphysics scheme employed.
Default: sam1mom
</entry>

<entry id="MMF_orientation_angle" type="real" category="conv"
       group="phys_ctl_nl" valid_values="">
Angle of CRM domain in degrees used to apply large scale wind forcing.
Default value depends on whether CRM domain is 2D or 3D. For 2D runs a value 
of 90deg used for a south-north orientation to reduce precipitation biases
that tend to occur when the CRM aligns with the prevailing wind.
A value of -1 enables an experimental randomly rotating CRM orientation.
Defaults: 
  2D CRM: 90 (i.e. north-south)
  3D CRM: 0
</entry>

<entry id="MMF_VT_wn_max" type="real" category="conv"
       group="phys_ctl_nl" valid_values="">
Wavenumber cutoff for filtered MMF variance transport.
A value of 0 disables filtering so that the total
variance is transported
Default: 0
</entry>

<!-- MMF Mean State Acceleration(MSA) definitions -->
<entry id="use_crm_accel" type="logical" category="conv"
       group="phys_ctl_nl" valid_values="">
Enables CRM mean-state acceleration when using E3SM-MMF.
Default: true
</entry>

<entry id="crm_accel_factor" type="real" category="conv"
       group="phys_ctl_nl" valid_values="">
CRM acceleration factor to apply if use_crm_accel is true
Default: 2.0
</entry>

<entry id="crm_accel_uv" type="logical" category="conv"
       group="phys_ctl_nl" valid_values="">
Turn on CRM mean-state acceleration for u,v when use_crm_accel is true.
If crm_accel_uv is false and use_crm_accel is true, then mean-state
acceleration will only be applied to scalar fields (liquid/ice static
energy and non-precipitating total water mixing ratio). This has
no effect when use_crm_accel is false.
Default: true

<!-- Test Tracers -->

<entry id="tracers_flag" type="logical" category="test_tracers"
       group="cam_inparm" valid_values="" >
This variable should not be set by the user.  If configure has been invoked
with the '-nadv_tt N' option then build-namelist will set this flag to true
which turns on the test tracer code.  Also, if the user invokes configure
with the option '-nadv N', and N is larger than the number of advected
constituents requested by all other physics and chemistry
parameterizations, then the number of test tracers is chosen
dynamically to fill the available slots in the constituents array up to the
total number requested by the -nadv option.
Default: set by configure
</entry>

<entry id="aoa_tracers_flag" type="logical" category="test_tracers"
       group="aoa_tracers_nl" valid_values="" >
If true age of air tracers are included.  This variable should not be set
by the user.  It will be set by build-namelist to be consistent with the
'-age_of_air_trcs' argument specified to configure.
Default: set by configure
</entry>

<entry id="aoa_read_from_ic_file" type="logical" category="test_tracers"
       group="aoa_tracers_nl" valid_values="" >
If true age of air tracers are read from the initial conditions file.
If this is not specified then they are not read from IC file.
Default: TRUE
</entry>

<!-- Time step -->

<entry id="dtime" type="real"  category="time_mgr"
       group="cam_inparm" valid_values="">
The length (in seconds) of the coupling interval between the dynamics and
physics.  Changing this variable directly impacts the physical
parameterizations in the model and may impact the climate.  Changing
resolution usually requires a change in <varname>dtime</varname>.
Default: is resolution and dycore dependent and is set by build-namelist.
</entry>

<!-- Topography -->

<entry id="bnd_topo" type="char*256" input_pathname="abs" category="topo"
       group="cam_inparm" valid_values="" >
Full pathname of time-invariant boundary dataset for topography fields.
Default: set by build-namelist.
</entry>

<!-- Tropopause -->

<entry id="tropopause_climo_file" type="char*256" input_pathname="abs" category="tropo"
       group="tropopause_nl" valid_values="" >
Full pathname of boundary dataset for tropopause climatology.
Default: set by build-namelist.
</entry>

<entry id="tropopause_output_all" type="logical" category="tropo"
       group="tropopause_nl" valid_values="" >
Flag to output optional tropopause variables.
Default: FALSE
</entry>

<entry id="tropopause_E90_thrd" type="real" category="tropo"
       group="tropopause_nl" valid_values="" >
E90 tropopause vmr threshold.
Default: 100.e-9
</entry>

<!-- CAM-CHEM -->

<entry id="ipcc_aircraft_emis" type="logical" category="cam_chem"
       group="camexp" valid_values="" >
Flag to tell build-namelist to use time-dependent external forcing
files for the aircraft emissions.
Default: FALSE
</entry>

<entry id="chem_rad_passive" type="logical" category="cam_chem"
       group="chem_inparm" valid_values="" >
Flag to set rad_climate variable so that the chemical tracers are
radiatively passive.
Default: FALSE
</entry>

<entry id="gas_wetdep_method" type="char*3" category="cam_chem"
       group="wetdep_inparm" valid_values="MOZ,NEU" >
Wet depostion method used
  MOZ --> mozart scheme is used
  NEU --> J Neu's scheme is used
Default: MOZ
</entry>

<entry id="gas_wetdep_list" type="char*16(1000)" category="cam_chem"
       group="wetdep_inparm" valid_values="" >
List of gas-phase species that undergo wet deposition via the wet deposition scheme.
Default: NONE
</entry>

<entry id="aer_wetdep_list" type="char*16(1000)" category="cam_chem"
       group="aerosol_nl" valid_values="" >
List of aerosol species that undergo wet deposition.
Default: set by build-namelist.
</entry>

<entry id="aer_drydep_list" type="char*16(1000)" category="cam_chem"
       group="aerosol_nl" valid_values="" >
List of aerosol species that undergo sediment (dry deposition).
Default: set by build-namelist.
</entry>

<entry id="sol_factb_interstitial" type="real" category="cam_chem"
       group="aerosol_nl" valid_values="" >
Tuning for below cloud scavenging of interstitial modal aerosols.
Default: set by build-namelist.
</entry>

<entry id="sol_factic_interstitial" type="real" category="cam_chem"
       group="aerosol_nl" valid_values="" >
Tuning for in-cloud scavenging of interstitial modal aerosols.
Default: set by build-namelist.
</entry>

<entry id="sol_facti_cloud_borne" type="real" category="cam_chem"
       group="aerosol_nl" valid_values="" >
In-cloud scav for cloud-borne aerosol tuning factor
Default: set by build-namelist.
</entry>
<!-- Flags for implementing code modifications under polar project -->
<entry id="sscav_tuning" type="logical"  category="cam_chem"
       group="aerosol_nl" valid_values="" >
Flag for wet scavenging tuning
Default: .false.
</entry>

<entry id="seasalt_emis_scale" type="real" category="cam_chem"
       group="aerosol_nl" valid_values="" >
Seasalt aerosol emission tuning factor
Default: set by build-namelist.
</entry>

<entry id="airpl_emis_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of boundary dataset for airplane emissions.
Default: set by build-namelist.
</entry>

<entry id="clim_soilw_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of dataset containing soil moisture fraction information used in 'xactive_atm'
method of calculating dry deposition of chemical tracers.
Default: set by build-namelist.
</entry>

<entry id="depvel_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of dataset which contains the prescribed deposition velocities used
in the 'table' method of calculating dry deposition  of chemical tracers.
Default: set by build-namelist.
</entry>

<entry id="depvel_lnd_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of dataset which contains land vegitation information used in 'xactive_atm'
method of calculating dry deposition of chemical tracers.
Default: set by build-namelist.
</entry>

<entry id="season_wes_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of dataset which contains season information used in 'xactive_atm'
method of calculating dry deposition of chemical tracers.
Default: set by build-namelist.
</entry>

<entry id="dust_emis_fact" type="real" category="cam_chem"
       group="dust_nl" valid_values="" >
Tuning parameter for dust emissions.
Default: set by build-namelist.
</entry>

<!-- sea salt tuning flag for polar project -->
<entry id="ssalt_tuning"  type="logical" category="cam_chem"
       group="phys_ctl_nl" valid_values="" >
Tuning flag for seasalt introduced to accompany unified convective transport scheme by PNNL
Default: .false.
</entry>

<entry id="efield_hflux_file" type="char*256" input_pathname="abs" category="waccm_phys"
       group="iondrag_nl" valid_values="" >
Full pathname of dataset for coefficient data used in WACCM to calculate ion drag
for high solar fluxes from the Scherliess low latitude electric potential model.
Default: set by build-namelist.
</entry>

<entry id="efield_lflux_file" type="char*256" input_pathname="abs" category="waccm_phys"
       group="iondrag_nl" valid_values="" >
Full pathname of dataset for coefficient data used in WACCM to calculate ion drag
for low solar fluxes from the Scherliess low latitude electric potential model.
Default: set by build-namelist.
</entry>

<entry id="efield_wei96_file" type="char*256" input_pathname="abs" category="waccm_phys"
       group="iondrag_nl" valid_values="" >
Full pathname of dataset for coefficient data used in WACCM to calculate ion drag
from the Weimer96 high latitude electric potential model.
Default: set by build-namelist.
</entry>

<entry id="electron_file" type="char*256" input_pathname="abs" category="waccm"
       group="chem_inparm" valid_values="" >
Full pathname of dataset for the neutral species absorption cross sections for EUV
photo reactions producing electrons.
Default: set by build-namelist.
</entry>

<entry id="srf_emis_type" type="char*32" category="cam_chem"
       group="chem_inparm" valid_values="CYCLICAL,SERIAL,INTERP_MISSING_MONTHS,FIXED" >
Type of time interpolation of emission datasets specified.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.
by <varname>srf_emis_specifier</varname>.
Default: 'CYCLICAL'
</entry>

<entry id="srf_emis_cycle_yr" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
The  cycle year of the surface emissions data
if <varname>srf_emis_type</varname>  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="srf_emis_fixed_ymd" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
The date at which the surface emissions are fixed
if <varname>srf_emis_type</varname> is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="srf_emis_fixed_tod" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
The time of day (seconds) corresponding to <varname>srf_emis_fixed_ymd</varname>
at which the surface emissions are fixed
if <varname>srf_emis_type</varname> is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="euvac_file" type="char*256" input_pathname="abs" category="waccm"
       group="chem_inparm" valid_values="" >
Full pathname of dataset for EUVAC solar EUV model (0.05-121nm).
Default: set by build-namelist.
</entry>

<entry id="euvacdat_file" type="char*256" input_pathname="abs" category="waccm"
       group="chem_inparm" valid_values="" >
Full pathname of dataset for variables used to compute the solar flux in the EUV
wavelength regime.  Used to compute EUV photorates and heating from EUV photolysis.
Default: set by build-namelist.
</entry>

<entry id="ext_frc_cycle_yr" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
The  cycle year of the external forcings (3D emissions) data
if <varname>ext_frc_type</varname>  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="ext_frc_fixed_ymd" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
Default: current model date
The date at which the external forcings are fixed
if <varname>ext_frc_type</varname> is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="ext_frc_fixed_tod" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
The time of day (seconds) corresponding to <varname>ext_frc_fixed_ymd</varname>
at which the external forcings are fixed
if <varname>ext_frc_type</varname> is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="ext_frc_specifier" type="char*256(1000)" category="cam_chem"
       group="chem_inparm" valid_values="" >
List of full pathnames of elevated emission (or external chemical forcings) datasets.

The chemistry package reads in elevated emission data from a set of netcdf files in
units of "molecules/cm3/s".  Each tracer species emissions is read from its
own file as directed by the namelist variable <varname>ext_frc_specifier</varname>.  The
<varname>ext_frc_specifier</varname> variable tells the model which species have elevated
emissions and the file path for the corresponding species.  That is, the
<varname>ext_frc_specifier</varname> variable is set something like:

 ext_frc_specifier = 'SO2 -> /path/vrt.emis.so2.nc',
                     'SO4 -> /path/vrt.emis.so4.nc', etc...

Each emission file can have more than one source.  When the emission are
read in the sources are summed to give a total emission field for the
corresponding species.  The emission can be read in as time series of data,
cycle over a given year, or be fixed to a given date.

The vertical coordinate in these emissions files should be 'altitude' (km) so that the
vertical redistribution to the model layers is done using a mass conserving method.
If the vertical coordinate is altitude then data needs to be ordered from the
surface to the top (increasing altitude).

Default: set by build-namelist.
</entry>

<entry id="ext_frc_type" type="char*32" category="cam_chem"
       group="chem_inparm" valid_values="CYCLICAL,SERIAL,INTERP_MISSING_MONTHS,FIXED" >
Type of time interpolation for fixed lower boundary data.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.
Default: 'CYCLICAL'
</entry>

<entry id="flbc_cycle_yr" type="integer" category="cam_chem"
       group="chem_surfvals_nl" valid_values="" >
The cycle year of the fixed lower boundary data
if <varname>flbc_type</varname>  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>
<entry id="flbc_fixed_ymd" type="integer" category="cam_chem"
       group="chem_surfvals_nl" valid_values="" >
The date at which the fixed lower boundary data is fixed
if <varname>flbc_type</varname> is 'FIXED'..
Format: YYYYMMDD
Default: 0
</entry>
<entry id="flbc_fixed_tod" type="integer" category="cam_chem"
       group="chem_surfvals_nl" valid_values="" >
The time of day (seconds) corresponding to <varname>flbc_fixed_ymd</varname>
at which the fixed lower boundary data is fixed
if <varname>flbc_type</varname> is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="flbc_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_surfvals_nl" valid_values="" >
Full pathname of dataset for fixed lower boundary conditions.
Default: set by build-namelist.
</entry>

<entry id="flbc_list" type="char*16(1000)" category="cam_chem"
       group="chem_surfvals_nl" valid_values="" >
List of species that are fixed at the lower boundary.
Default: set by build-namelist.
</entry>

<entry id="flbc_type" type="char*8" category="cam_chem"
       group="chem_surfvals_nl" valid_values="CYCLICAL,SERIAL,FIXED" >
Type of time interpolation for fixed lower boundary data.
Default: 'CYCLICAL'
</entry>

<entry id="fstrat_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of dataset for chemical tracers constrained  in the stratosphere
Default: set by build-namelist.
</entry>

<entry id="fstrat_list" type="char*16(1000)" category="cam_chem"
       group="chem_inparm" valid_values="" >
List of species that are constrained in the stratosphere.
Default: set by build-namelist.
</entry>

<entry id="fstrat_efold_list" type="char*16(1000)" category="cam_chem"
       group="chem_inparm" valid_values="" >
List of species from ChemUCI that e-fold decay in 30 days in the stratosphere.
Default: set by build-namelist.
</entry>

<entry id="lght_landmask_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of dataset for land mask applied to the lighting NOx production
Default: set by build-namelist.
</entry>

<entry id="lght_no_prd_factor" type="real" category="cam_chem"
       group="chem_inparm" valid_values="" >
Multiplication factor  applied to the lighting NOx production
Default: 1.0.
</entry>

<entry id="no_xfac_ubc" type="real" category="waccm"
       group="chem_inparm" valid_values="" >
Multiplication factor applied to the upper boundary NO mass mixing ratio.
Default: 1.0
</entry>

<entry id="photon_file" type="char*256" input_pathname="abs" category="waccm"
       group="chem_inparm" valid_values="" >
Full pathname of dataset for the neutral species absorption cross sections.
Default: set by build-namelist.
</entry>

<entry id="tuv_xsect_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of dataset for fast-tuv photolysis cross sections
Default: set by build-namelist.
</entry>

<entry id="o2_xsect_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of dataset of O2 cross sections for fast-tuv photolysis
Default: set by build-namelist.
</entry>

<entry id="exo_coldens_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of dataset of O2 and 03 column densities above the model for look-up-table photolysis
Default: set by build-namelist.
</entry>

<entry id="aircraft_specifier" type="char*256(100)" category="cam_chem"
       group="aircraft_emit_nl" valid_values="" >
Full pathname of the aircraft input file list
Default: none
</entry>

<entry id="aircraft_datapath" type="char*256" category="cam_chem"
       group="aircraft_emit_nl" valid_values="" >
Full pathname of the directory that contains the files specified in
{{ hilight }}aircraft_specifier{{ closehilight }}.
Default: none
</entry>


<entry id="aircraft_type" type="char*32" category="cam_chem"
       group="aircraft_emit_nl" valid_values="CYCLICAL_LIST,SERIAL" >
Type of time interpolation for data in aircraft aerosol files.
Default: 'CYCLICAL_LIST'
</entry>

<entry id="prescribed_aero_datapath" type="char*256" input_pathname="abs" category="cam_chem"
       group="prescribed_aero_nl" valid_values="" >
Full pathname of the directory that contains the files specified in
<varname>prescribed_aero_filelist</varname>.
Default: set by build-namelist.
</entry>

<entry id="prescribed_aero_model" type="char*5" category="cam_chem"
       group="camexp" valid_values="bulk,modal" >
Switch used to indicate which type of aerosols are prescribed -- bulk or modal.
This is used to set the default <varname>prescribed_aero_specifier</varname> and
<varname>aerodep_flx_specifier</varname> namelist variables.
Default: set by build-namelist
</entry>

<entry id="prescribed_aero_file" type="char*256" input_pathname="rel:prescribed_aero_datapath" category="cam_chem"
       group="prescribed_aero_nl" valid_values="" >
Filename of dataset for prescribed aerosols.
Default: set by build-namelist.
</entry>

<entry id="prescribed_aero_filelist" type="char*256" input_pathname="rel:prescribed_aero_datapath" category="cam_chem"
       group="prescribed_aero_nl" valid_values="" >
Filename of file that contains a sequence of filenames for prescribed
aerosols.  The filenames in this file are relative to the directory specied
by <varname>prescribed_aero_datapath</varname>.
Default: set by build-namelist.
</entry>

<entry id="prescribed_aero_rmfile" type="logical" category="cam_chem"
       group="prescribed_aero_nl" valid_values="" >
Remove the file containing prescribed aerosol concentrations from local disk when no longer needed.
Default: FALSE
</entry>

<entry id="prescribed_aero_specifier" type="char*32(50)" category="cam_chem"
       group="prescribed_aero_nl" valid_values="" >
A list of variable names of the concentration fields in the prescribed aerosol datasets
and corresponding names used in the physics buffer seperated by colons.  For example:

 prescribed_aero_specifier = 'pbuf_name1:ncdf_fld_name1','pbuf_name2:ncdf_fld_name2', ...

If there is no colon seperater then the specified name is used as both the pbuf_name and ncdf_fld_name,

Default: none
</entry>

<entry id="prescribed_aero_type" type="char*32" category="cam_chem"
       group="prescribed_aero_nl" valid_values="CYCLICAL,SERIAL,INTERP_MISSING_MONTHS,FIXED" >
Type of time interpolation for data in prescribed_aero files.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.
Default: 'SERIAL'
</entry>

<entry id="prescribed_aero_cycle_yr" type="integer" category="cam_chem"
       group="prescribed_aero_nl" valid_values="" >
The  cycle year of the prescribed aerosol data
if <varname>prescribed_aero_type</varname>  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="prescribed_aero_fixed_ymd" type="integer" category="cam_chem"
       group="prescribed_aero_nl" valid_values="" >
The date at which the prescribed aerosol data is fixed
if <varname>prescribed_aero_type</varname> is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="prescribed_aero_fixed_tod" type="integer" category="cam_chem"
       group="prescribed_aero_nl" valid_values="" >
The time of day (seconds) corresponding to <varname>prescribed_aero_fixed_ymd</varname>
at which the prescribed aerosol data is fixed
if <varname>prescribed_aero_type</varname> is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="aerodep_flx_datapath" type="char*256" input_pathname="abs" category="cam_chem"
       group="aerodep_flx_nl" valid_values="" >
Full pathname of the directory that contains the files specified in
<varname>aerodep_flx_filelist</varname>.
Default: set by build-namelist.
</entry>

<entry id="aerodep_flx_file" type="char*256" input_pathname="rel:aerodep_flx_datapath" category="cam_chem"
       group="aerodep_flx_nl" valid_values="" >
Filename of dataset for prescribed aerosols.
Default: set by build-namelist.
</entry>

<entry id="aerodep_flx_filelist" type="char*256" input_pathname="rel:aerodep_flx_datapath" category="cam_chem"
       group="aerodep_flx_nl" valid_values="" >
Filename of file that contains a sequence of filenames for prescribed
aerosols.  The filenames in this file are relative to the directory specied
by <varname>aerodep_flx_datapath</varname>.
Default: set by build-namelist.
</entry>

<entry id="aerodep_flx_rmfile" type="logical" category="cam_chem"
       group="aerodep_flx_nl" valid_values="" >
Remove the file containing prescribed aerosol deposition fluxes from local disk when no longer needed.
Default: FALSE
</entry>

<entry id="aerodep_flx_specifier" type="char*32(22)" category="cam_chem"
       group="aerodep_flx_nl" valid_values="" >
Names of variables containing aerosol data in the prescribed aerosol datasets.
Default: none
</entry>

<entry id="aerodep_flx_type" type="char*32" category="cam_chem"
       group="aerodep_flx_nl" valid_values="CYCLICAL,SERIAL,INTERP_MISSING_MONTHS,FIXED" >
Type of time interpolation for data in aerodep_flx files.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.
Default: 'SERIAL'
</entry>

<entry id="aerodep_flx_cycle_yr" type="integer" category="cam_chem"
       group="aerodep_flx_nl" valid_values="" >
The  cycle year of the prescribed aerosol flux data
if <varname>aerodep_flx_type</varname>  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="aerodep_flx_fixed_ymd" type="integer" category="cam_chem"
       group="aerodep_flx_nl" valid_values="" >
The date at which the prescribed aerosol flux data is fixed
if <varname>aerodep_flx_type</varname> is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="aerodep_flx_fixed_tod" type="integer" category="cam_chem"
       group="aerodep_flx_nl" valid_values="" >
The time of day (seconds) corresponding to <varname>ssaerodep_flx_fixed_ymd</varname>
at which the prescribed aerosol flux data is fixed
if <varname>saerodep_flx_type</varname> is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="mam_mom_datapath" type="char*256" input_pathname="abs" category="cam_chem"
       group="mam_mom_nl" valid_values="" >
Full pathname of the directory that contains the files specified in
<varname>mam_mom_filelist</varname>.
Default: 'atm/cam/chem/trop_mam/marine_BGC/'
</entry>

<entry id="mam_mom_filename" type="char*256" input_pathname="rel:mam_mom_datapath" category="cam_chem"
       group="mam_mom_nl" valid_values="" >
Filename of dataset for prescribed marine organic matter ocean concentrations.
Default: 'monthly_macromolecules_0.1deg_bilinear_latlon_year01_merge_date.nc'
</entry>

<entry id="mam_mom_filelist" type="char*256" input_pathname="rel:mam_mom_datapath" category="cam_chem"
       group="mam_mom_nl" valid_values="" >
Filename of file that contains a sequence of filenames for prescribed
marine organic matter ocean concentrations.  The filenames in this
file are relative to the directory specified
by <varname>mam_mom_datapath</varname>.
Default: none
</entry>

<entry id="mam_mom_rmfile" type="logical" category="cam_chem"
       group="mam_mom_nl" valid_values="" >
Remove the file containing prescribed aerosol deposition fluxes from
local disk when no longer needed.
Default: FALSE
</entry>

<entry id="mam_mom_specifier" type="char*32(22)" category="cam_chem"
       group="mam_mom_nl" valid_values="" >
Names of variables containing aerosol data in the prescribed aerosol datasets.
Default: 'chla:CHL1','mpoly:TRUEPOLYC','mprot:TRUEPROTC','mlip:TRUELIPC'
</entry>

<entry id="mam_mom_datatype" type="char*32" category="cam_chem"
       group="mam_mom_nl" valid_values="CYCLICAL,SERIAL,INTERP_MISSING_MONTHS,FIXED" >
Type of time interpolation for data in mam_mom files.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.
Default: 'CYCLICAL'
</entry>

<entry id="mam_mom_cycle_yr" type="integer" category="cam_chem"
       group="mam_mom_nl" valid_values="" >
The  cycle year of the prescribed aerosol flux data
if <varname>mam_mom_type</varname>  is 'CYCLICAL'.
Format: YYYY
Default: 1
</entry>

<entry id="mam_mom_fixed_ymd" type="integer" category="cam_chem"
       group="mam_mom_nl" valid_values="" >
The date at which the prescribed aerosol flux data is fixed
if <varname>mam_mom_type</varname> is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="mam_mom_fixed_tod" type="integer" category="cam_chem"
       group="mam_mom_nl" valid_values="" >
The time of day (seconds) corresponding to <varname>mam_mom_fixed_ymd</varname>
at which the prescribed aerosol flux data is fixed
if <varname>mam_mom_type</varname> is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="mam_mom_bubble_thickness" type="real" category="cam_chem"
       group="mam_mom_nl" valid_values="" >
Bubble film thickness (in m) for marine organic aerosol emission
mechanism.  The physically reasonable range is approximately
(0.1 - 1) x 10^ -6.
Default: 0.1e-6
</entry>

<entry id="mam_mom_mixing_state" type="integer" category="cam_chem"
       group="mam_mom_nl" valid_values="" >
Switch to select mixing state assumption in marine organic aerosol
code. Currently implemented options: 0 : total external mixture, add
to mass; 1 : total external mixture, replace mass; 2 : total internal
mixture, add to mass; 3 : total internal mixture, replace mass.
Default:0
</entry>

<entry id="mam_mom_parameterization" type="integer" category="cam_chem"
       group="mam_mom_nl" valid_values="" >
Selection of alternate parameterizations for marine organic matter
emissions.  Set fmoa=1 for Burrows et al., 2014 parameterization;
fmoa=2 for Gantt et al. (2011, ACP) parameterization; fmoa=3 for
simple parameterization based on Quinn et al., 2014; fmoa=4 for
Rinaldi et al. (JGR, 2013).
Default:1
</entry>

<entry id="prescribed_ghg_datapath" type="char*256" input_pathname="abs" category="cam_chem"
       group="prescribed_ghg_nl" valid_values="" >
Full pathname of the directory that contains the files specified in
<varname>prescribed_ghg_filelist</varname>.
Default: set by build-namelist.
</entry>

<entry id="prescribed_ghg_file" type="char*256" input_pathname="rel:prescribed_ghg_datapath" category="cam_chem"
       group="prescribed_ghg_nl" valid_values="" >
Filename of dataset for prescribed GHGs.
Default: set by build-namelist.
</entry>

<entry id="prescribed_ghg_filelist" type="char*256" input_pathname="rel:prescribed_ghg_datapath" category="cam_chem"
       group="prescribed_ghg_nl" valid_values="" >
Filename of file that contains a sequence of filenames for prescribed
GHGs.  The filenames in this file are relative to the directory specied
by <varname>prescribed_ghg_datapath</varname>.
Default: set by build-namelist.
</entry>

<entry id="prescribed_ghg_rmfile" type="logical" category="cam_chem"
       group="prescribed_ghg_nl" valid_values="" >
Remove the file containing prescribed green house gas concentrations from local disk when no longer needed.
Default: FALSE
</entry>

<entry id="prescribed_ghg_specifier" type="char*16(100)" category="cam_chem"
       group="prescribed_ghg_nl" valid_values="" >
Names of variables containing GHG data in the prescribed GHG datasets.
Default: none
</entry>

<entry id="prescribed_ghg_type" type="char*32" category="cam_chem"
       group="prescribed_ghg_nl" valid_values="CYCLICAL,SERIAL,INTERP_MISSING_MONTHS,FIXED" >
Type of time interpolation for data in prescribed_ghg files.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.
Default: 'SERIAL'
</entry>

<entry id="prescribed_ghg_cycle_yr" type="integer" category="cam_chem"
       group="prescribed_ghg_nl" valid_values="" >
The  cycle year of the prescribed green house gas data
if <varname>prescribed_ghg_type</varname>  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="prescribed_ghg_fixed_ymd" type="integer" category="cam_chem"
       group="prescribed_ghg_nl" valid_values="" >
The date at which the prescribed green house gas data  is fixed
if <varname>prescribed_ghg_type</varname> is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="prescribed_ghg_fixed_tod" type="integer" category="cam_chem"
       group="prescribed_ghg_nl" valid_values="" >
The time of day (seconds) corresponding to <varname>prescribed_ghg_fixed_ymd</varname>
at which the prescribed green house gas data is fixed
if <varname>prescribed_ghg_type</varname> is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="prescribed_ozone_datapath" type="char*256" input_pathname="abs" category="cam_chem"
       group="prescribed_ozone_nl" valid_values="" >
Full pathname of the directory that contains the files specified in
<varname>prescribed_ozone_filelist</varname>.
Default: set by build-namelist.
</entry>

<entry id="prescribed_ozone_file" type="char*256" input_pathname="rel:prescribed_ozone_datapath" category="cam_chem"
       group="prescribed_ozone_nl" valid_values="" >
Filename of dataset for prescribed ozone.
Default: set by build-namelist.
</entry>

<entry id="prescribed_ozone_filelist" type="char*256" input_pathname="rel:prescribed_ozone_datapath" category="cam_chem"
       group="prescribed_ozone_nl" valid_values="" >
Filename of file that contains a sequence of filenames for prescribed
ozone.  The filenames in this file are relative to the directory specied
by <varname>prescribed_ozone_datapath</varname>.
Default: set by build-namelist.
</entry>

<entry id="prescribed_ozone_name" type="char*16" category="cam_chem"
       group="prescribed_ozone_nl" valid_values="" >
Name of variable containing ozone data in the prescribed ozone datasets.
Default: 'ozone'
</entry>

<entry id="prescribed_ozone_rmfile" type="logical" category="cam_chem"
       group="prescribed_ozone_nl" valid_values="" >
Remove the file containing prescribed ozone concentrations from local disk when no longer needed.
Default: FALSE
</entry>

<entry id="prescribed_ozone_type" type="char*32" category="cam_chem"
       group="prescribed_ozone_nl" valid_values="CYCLICAL,SERIAL,INTERP_MISSING_MONTHS,FIXED" >
Type of time interpolation for data in prescribed_ozone files.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.
Default: 'SERIAL'
</entry>

<entry id="prescribed_ozone_cycle_yr" type="integer" category="cam_chem"
       group="prescribed_ozone_nl" valid_values="" >
The  cycle year of the prescribed ozone data
if <varname>prescribed_ozone_type</varname>  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="prescribed_ozone_fixed_ymd" type="integer" category="cam_chem"
       group="prescribed_ozone_nl" valid_values="" >
The date at which the prescribed ozone data is fixed
if <varname>prescribed_ozone_type</varname> is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="prescribed_ozone_fixed_tod" type="integer" category="cam_chem"
       group="prescribed_ozone_nl" valid_values="" >
The time of day (seconds) corresponding to <varname>prescribed_ozone_fixed_ymd</varname>
at which the prescribed ozone data is fixed
if <varname>prescribed_ozone_type</varname> is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="prescribed_volcaero_datapath" type="char*256" input_pathname="abs" category="cam_chem"
       group="prescribed_volcaero_nl" valid_values="" >
Full pathname of the directory that contains the files specified in
<varname>prescribed_volcaero_filelist</varname>.
Default: set by build-namelist.
</entry>

<entry id="prescribed_volcaero_file" type="char*256" input_pathname="rel:prescribed_volcaero_datapath" category="cam_chem"
       group="prescribed_volcaero_nl" valid_values="" >
Filename of dataset for prescribed volcaero.
Default: set by build-namelist.
</entry>

<entry id="prescribed_volcaero_filelist" type="char*256" input_pathname="rel:prescribed_volcaero_datapath" category="cam_chem"
       group="prescribed_volcaero_nl" valid_values="" >
Filename of file that contains a sequence of filenames for prescribed
volcaero.  The filenames in this file are relative to the directory specied
by <varname>prescribed_volcaero_datapath</varname>.
Default: set by build-namelist.
</entry>

<entry id="prescribed_volcaero_name" type="char*16" category="cam_chem"
       group="prescribed_volcaero_nl" valid_values="" >
Name of variable containing volcaero data in the prescribed volcaero datasets.
Default: 'MMRVOLC'
</entry>

<entry id="prescribed_volcaero_rmfile" type="logical" category="cam_chem"
       group="prescribed_volcaero_nl" valid_values="" >
Remove the file containing prescribed volcanic aerosol concentrations from local disk when no longer needed.
Default: FALSE
</entry>

<entry id="prescribed_volcaero_filetype" type="char*32" category="cam_chem"
       group="prescribed_volcaero_nl" valid_values="VOLC_MIXING_RATIO,VOLC_CMIP6" >
Default: 'VOLC_MIXING_RATIO'
</entry>

<entry id="prescribed_volcaero_type" type="char*32" category="cam_chem"
       group="prescribed_volcaero_nl" valid_values="CYCLICAL,SERIAL,INTERP_MISSING_MONTHS,FIXED" >
Type of time interpolation for data in prescribed_volcaero files.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.
Default: 'SERIAL'
</entry>

<entry id="prescribed_volcaero_cycle_yr" type="integer" category="cam_chem"
       group="prescribed_volcaero_nl" valid_values="" >
The  cycle year of the prescribed volcanic aerosol data
if <varname>prescribed_volcaero_type</varname>  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="prescribed_volcaero_fixed_ymd" type="integer" category="cam_chem"
       group="prescribed_volcaero_nl" valid_values="" >
The date at which the prescribed volcanic aerosol data  is fixed
if <varname>prescribed_volcaero_type</varname> is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="prescribed_volcaero_fixed_tod" type="integer" category="cam_chem"
       group="prescribed_volcaero_nl" valid_values="" >
The time of day (seconds) corresponding to <varname>prescribed_volcaero_fixed_ymd</varname>
at which the prescribed volcanic aerosol data is fixed
if <varname>prescribed_volcaero_type</varname> is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="rsf_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of dataset for radiative source function used in look up table photloysis
Default: set by build-namelist.
</entry>

<entry id="sad_file" type="char*256" input_pathname="abs" category="waccm"
       group="chem_inparm" valid_values="" >
Full pathname of dataset for stratospheric aerosol densities
Default: set by build-namelist.
</entry>

<entry id="sad_cycle_yr" type="integer" category="waccm"
       group="chem_inparm" valid_values="" >
The cycle year of the stratospheric aerosol data
if <varname>sad_cycle_type</varname>  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>
<entry id="sad_fixed_ymd" type="integer" category="waccm"
       group="chem_inparm" valid_values="" >
The date at which the stratospheric aerosol data is fixed
if <varname>sad_type</varname> is 'FIXED'..
Format: YYYYMMDD
Default: 0
</entry>
<entry id="sad_fixed_tod" type="integer" category="waccm"
       group="chem_inparm" valid_values="" >
The time of day (seconds) corresponding to <varname>sad_fixed_ymd</varname>
at which the stratospheric aerosol data is fixed
if <varname>sad_type</varname> is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="sad_type" type="char*16" category="waccm"
       group="chem_inparm" valid_values="FIXED,SERIAL,CYCLICAL" >
Type of time interpolation for stratospheric aerosol density data.
Can be set to 'CYCLICAL', 'SERIAL', or 'FIXED'.
Default: 'CYCLICAL'
</entry>

<entry id="snoe_ubc_file" type="char*256" input_pathname="abs" category="waccm"
       group="chem_inparm" valid_values="" >
Full pathname of dataset for the coefficients of the NOEM nitric oxide model used
to calculate its upper boundary concentration.
Default: set by build-namelist.
</entry>

<entry id="soil_erod_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="dust_nl" valid_values="" >
Full pathname of boundary dataset for soil erodibility factors.
Default: set by build-namelist.
</entry>

<entry id="solar_parms_file" type="char*256" input_pathname="abs" category="waccm"
       group="chem_inparm" valid_values="" >
Full pathname of time-variant boundary dataset for the time-dependent proxies for
solar and geomagnetic activity( F10.7, F10.7a, Kp, Ap ).
Default: set by build-namelist.
</entry>

<entry id="srf_emis_specifier" type="char*256(1000)" category="cam_chem"
       group="chem_inparm" valid_values="" >
List of full pathnames of surface emission datasets.

The chemistry package reads in emission data from a set of netcdf files in
units of "molecules/cm2/s".  Each tracer species emissions is read from its
own file as directed by the namelist variable <varname>srf_emis_specifier</varname>.  The
<varname>srf_emis_specifier</varname> variable tells the model which species have emissions
and the file path for the corresponding species.  That is, the
<varname>srf_emis_specifier</varname> variable is set something like:

 srf_emis_specifier = 'CH4 -> /path/emis.ch4.nc',
                      'CO  -> /path/emis.co.nc', etc...

Each emission file can have more than one source.  When the emission are
read in the sources are summed to give a total emission field for the
corresponding species.  The emission can be read in as time series of data,
cycle over a given year, or be fixed to a given date.

Default: set by build-namelist.
</entry>

<entry id="sulf_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of dataset containing tropopheric sulfate aerosols
Default: set by build-namelist.
</entry>

<entry id="tgcm_ubc_file" type="char*256" input_pathname="abs" category="waccm"
       group="chem_inparm" valid_values="" >
Full pathname of dataset for TGCM upper boundary
Default: set by build-namelist.
</entry>
<entry id="tgcm_ubc_data_type" type="char*32" category="waccm"
       group="chem_inparm" valid_values="CYCLICAL,SERIAL,INTERP_MISSING_MONTHS,FIXED" >
Type of time interpolation for data in TGCM upper boundary file.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.
Default: 'SERIAL'
</entry>

<entry id="tgcm_ubc_cycle_yr" type="integer" category="waccm"
       group="chem_inparm" valid_values="" >
The cycle year of the TGCM upper boundary data
if <varname>tgcm_ubc_type</varname>  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="tgcm_ubc_fixed_ymd" type="integer" category="waccm"
       group="chem_inparm" valid_values="" >
The date at which the TGCM upper boundary data is fixed
if <varname>tgcm_ubc_type</varname> is 'FIXED'.
Format: YYYY
Default: 0
</entry>

<entry id="tgcm_ubc_fixed_tod" type="integer" category="waccm"
       group="chem_inparm" valid_values="" >
The time of day (seconds) corresponding to <varname>tgcm_ubc_fixed_ymd</varname>
at which the TGCM upper boundary data is fixed
if <varname>tgcm_ubc_type</varname> is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="t_pert_ubc" type="real" category="waccm"
       group="chem_inparm" valid_values="" >
Perturbation applied to the upper boundary temperature.
Default: 0.0
</entry>

<entry id="chem_freq" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
Frequency in time steps at which the chemical equations are solved.
Default: 1
</entry>

<entry id="chlorine_loading_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Filename of dataset for linoz chlorine loading.
Default: none.
</entry>
<entry id="chlorine_loading_type" type="char*8" category="cam_chem"
       group="chem_inparm" valid_values="SERIAL,FIXED" >
Type of time interpolation type for data in  <varname>chlorine_loading_file</varname>
Default: 'SERIAL'
</entry>
<entry id="chlorine_loading_fixed_tod" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
The time of day (seconds) corresponding to <varname>chlorine_loading_fixed_ymd</varname>
at which the chlorine loading data is fixed
if <varname>chlorine_loading_type</varname> is 'FIXED'.
Default: 0 seconds
</entry>
<entry id="chlorine_loading_fixed_ymd" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
The date at which the chlorine loading data is fixed
if <varname>chlorine_loading_type</varname> is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>


<entry id="linoz_data_path" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of the directory that contains the files specified in
<varname>linoz_data_filelist</varname>.
Default: none.
</entry>

<entry id="linoz_data_file" type="char*256" input_pathname="rel:linoz_data_path" category="cam_chem"
       group="chem_inparm" valid_values="" >
Filename of dataset for LINOZ data.
Default: none.
</entry>

<entry id="linoz_data_filelist" type="char*256" input_pathname="rel:linoz_data_datapath" category="cam_chem"
       group="chem_inparm" valid_values="" >
Filename of file that contains a sequence of filenames of the linoz data.
The filenames in this file are relative to the directory specied
by <varname>linoz_data_datapath</varname>.
Default: set by build-namelist.
</entry>

<entry id="linoz_data_type" type="char*24" category="cam_chem"
       group="chem_inparm" valid_values="CYCLICAL,SERIAL,INTERP_MISSING_MONTHS,FIXED" >
Type of time interpolation for data in linoz_data files.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.
Default: 'SERIAL'
</entry>

<entry id="linoz_data_rmfile" type="logical" category="cam_chem"
       group="chem_inparm" valid_values="TRUE,FALSE" >
Remove the file containing LINOZ data from local disk when no longer needed.
Default: FALSE
</entry>

<entry id="linoz_data_cycle_yr" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
The  cycle year of the LINOZ data
if <varname>linoz_data_type</varname> is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="linoz_data_fixed_ymd" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
The date at which the LINOZ data  is fixed
if <varname>linoz_data_type</varname> is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="linoz_data_fixed_tod" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
The time of day (seconds) corresponding to <varname>linoz_data_fixed_ymd</varname>
at which the LINOZ data is fixed
if <varname>linoz_data_type</varname> is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="linoz_lbl" type="integer" category="linoz"
       group="linoz_nl" valid_values="" >
Tunable number of layers with ozone decay from the surface in Linoz
Default: 4
</entry>

<entry id="linoz_sfc" type="real" category="linoz"
       group="linoz_nl" valid_values="" >
Tunable boundary layer concentration (ppb) to which Linoz ozone e-fold
Default: 30.0e-9
</entry>

<entry id="linoz_tau" type="real" category="linoz"
       group="linoz_nl" valid_values="" >
Tunable Linoz e-fold time scale (in seconds) in the boundary layer
Default: 172800.0
</entry>

<entry id="linoz_psc_T" type="real" category="linoz"
       group="linoz_nl" valid_values="" >
Tunable Linoz PSC ozone loss temperature (K) threshold
Default: 193.0
</entry>



<entry id="tracer_cnst_datapath" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of the directory that contains the files specified in
<varname>tracer_cnst_filelist</varname>.
Default: set by build-namelist.
</entry>

<entry id="tracer_cnst_file" type="char*256" input_pathname="rel:tracer_cnst_datapath" category="cam_chem"
       group="chem_inparm" valid_values="" >
Filename of dataset for the prescribed chemical constituents.
Default: set by build-namelist.
</entry>

<entry id="tracer_cnst_filelist" type="char*256" input_pathname="rel:tracer_cnst_datapath" category="cam_chem"
       group="chem_inparm" valid_values="" >
Filename of file that contains a sequence of filenames for the prescribed chemical constituents.
The filenames in this file are relative to the directory specied
by <varname>tracer_cnst_datapath</varname>.
Default: set by build-namelist.
</entry>

<entry id="tracer_cnst_rmfile" type="logical" category="cam_chem"
       group="chem_inparm" valid_values="" >
Remove the file containing prescribed chemical constituents from local disk when no longer needed.
Default: FALSE
</entry>

<entry id="tracer_cnst_specifier" type="char*256(100)" category="cam_chem"
       group="chem_inparm" valid_values="" >
List of prescribed chemical constituents.
Default: set by build-namelist.
</entry>

<entry id="tracer_cnst_type" type="char*24" category="cam_chem"
       group="chem_inparm" valid_values="CYCLICAL,SERIAL,INTERP_MISSING_MONTHS,FIXED" >
Type of time interpolation for data in tracer_cnst files.
Default: 'SERIAL'
</entry>

<entry id="tracer_cnst_cycle_yr" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
The  cycle year of the prescribed chemical constituents data
if <varname>tracer_cnst_type</varname>  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="tracer_cnst_fixed_ymd" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
The date at which the chemical constituents data is fixed
if <varname>tracer_cnst_type</varname> is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="tracer_cnst_fixed_tod" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
The time of day (seconds) corresponding to <varname>tracer_cnst_fixed_ymd</varname>
at which the chemical constituents data is fixed
if <varname>tracer_cnst_type</varname> is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="tracer_srcs_datapath" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of the directory that contains the files specified in
<varname>tracer_srcs_filelist</varname>.
Default: set by build-namelist.
</entry>

<entry id="tracer_srcs_file" type="char*256" input_pathname="rel:tracer_srcs_datapath" category="cam_chem"
       group="chem_inparm" valid_values="" >
Filename of dataset for the prescribed chemical sources.
Default: set by build-namelist.
</entry>

<entry id="tracer_srcs_filelist" type="char*256" input_pathname="rel:tracer_srcs_datapath" category="cam_chem"
       group="chem_inparm" valid_values="" >
Filename of file that contains a sequence of datasets for the prescribed chemical sources.
The filenames in this file are relative to the directory specied
by <varname>tracer_srcs_datapath</varname>.
Default: set by build-namelist.
</entry>

<entry id="tracer_srcs_rmfile" type="logical" category="cam_chem"
       group="chem_inparm" valid_values="CYCLICAL,SERIAL,INTERP_MISSING_MONTHS,FIXED" >
Remove the file containing prescribed chemical sources from local disk when no longer needed.
Default: FALSE
</entry>

<entry id="tracer_srcs_specifier" type="char*256(100)" category="cam_chem"
       group="chem_inparm" valid_values="" >
List of prescribed chemical sources
Default: set by build-namelist.
</entry>

<entry id="tracer_srcs_type" type="char*24" category="cam_chem"
       group="chem_inparm" valid_values="" >
Type of time interpolation for data in tracer_srcs files.
Default: 'SERIAL'
</entry>

<entry id="tracer_srcs_cycle_yr" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
The  cycle year of the prescribed chemical sources data
if <varname>tracer_srcs_type</varname>  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="tracer_srcs_fixed_ymd" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
The date at which the chemical sources data is fixed
if <varname>tracer_srcs_type</varname> is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="tracer_srcs_fixed_tod" type="integer" category="cam_chem"
       group="chem_inparm" valid_values="" >
The time of day (seconds) corresponding to <varname>tracer_srcs_fixed_ymd</varname>
at which the chemical sources data is fixed
if <varname>tracer_srcs_type</varname> is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="xactive_prates" type="logical" category="cam_chem"
       group="chem_inparm" valid_values="" >
If TRUE then use the FTUV method to calculate the photolysis reactions rates,
otherwise use the look up table method.
Default: FALSE
</entry>

<entry id="do_cloudj_photolysis" type="logical" category="cam_chem"
       group="chem_inparm" valid_values="" >
If TRUE then use the Cloud-J method to calculate the photolysis reactions rates,
otherwise use the lookup table method.
Default: FALSE
</entry>

<entry id="do_cloudj_clouds" type="logical" category="cam_chem"
       group="chem_inparm" valid_values="" >
If TRUE then use cloud opacities in the Cloud-J calculation of photolysis reactions rates,
Default: TRUE
</entry>

<entry id="do_cloudj_aerosols" type="logical" category="cam_chem"
       group="chem_inparm" valid_values="" >
If TRUE then use aerosol opacities in the Cloud-J calculation of photolysis reactions rates,
Default: FALSE
</entry>

<entry id="do_cloudj_lookup_diag" type="logical" category="cam_chem"
       group="chem_inparm" valid_values="" >
If TRUE then output the photolysis rates calculated by the lookup table.
This is diagnostic only, since these rates won't be used in the simulation.  
Default: FALSE
</entry>

<entry id="do_cloudj_aerosol_diag" type="logical" category="cam_chem"
       group="chem_inparm" valid_values="" >
If TRUE then output the photolysis rates calculated by Cloud-J using aerosol opacities.
This is diagnostic only, since these rates won't be used in the simulation.  
Default: FALSE
</entry>

<entry id="do_cloudj_nocloud_diag" type="logical" category="cam_chem"
       group="chem_inparm" valid_values="" >
If TRUE then output the photolysis rates calculated by Cloud-J for a cloud-free column.
This is diagnostic only, since these rates won't be used in the simulation.  
Default: FALSE
</entry>

<entry id="read_se_emis" type="logical" category="cam_chem"
       group="chem_inparm" valid_values="" >
Flag to allow (if TRUE) reading emission datasets in model native SE grid.
Default: FALSE
</entry>

<entry id="xs_coef_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of dataset for  Chebyshev polynomial Coeff data used for photolysis
cross sections.
Default: set by build-namelist.
</entry>

<entry id="xs_long_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of cross section dataset for long wavelengh photolysis
Default: set by build-namelist.
</entry>

<entry id="xs_short_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of cross section dataset for short wavelengh photolysis
Default: set by build-namelist.
</entry>

<!-- Namelist read by seq_drydep_mod and shared by CAM and CLM -->

<entry id="drydep_list" type="char*16(1000)" category="dry_deposition"
       group="drydep_inparm" valid_values="" >
List of species that undergo dry deposition.
Default: set by build-namelist.
</entry>

<entry id="drydep_method" type="char*16" category="dry_deposition"
       group="drydep_inparm" valid_values="xactive_atm,xactive_lnd,table" >
Dry deposition method used.  This specifies the method used to calculate dry
deposition velocities of gas-phase chemical species.  The available methods
are:
 'table'       - prescribed method in CAM
 'xactive_atm' - interactive method in CAM
 'xactive_lnd' - interactive method in CLM
Default: set by build-namelist
</entry>

<entry id="megan_factors_file" type="char*256" input_pathname="abs" category="VOC_emissions"
       group="megan_emis_nl" valid_values="" >
File containing MEGAN emissions factors.
Default: set by build-namelist.
</entry>

<entry id="megan_specifier" type="char*1024(100)" category="VOC_emissions"
       group="megan_emis_nl" valid_values="" >
MEGAN specifier.
Default: set by build-namelist.
</entry>

<entry id="megan_mapped_emisfctrs" type="logical" category="VOC_emissions"
       group="megan_emis_nl" valid_values=".true.,.false." >
MEGAN mapped isoprene emissions facters switch
If true then use mapped MEGAN emissions facters for isoprene.
Default: .false.
</entry>

<!-- WACCM_GHG Chemistry -->

<entry id="waccm_forcing_file" type="char*256" input_pathname="rel:waccm_forcing_datapath" category="waccm_ghg"
       group="waccm_forcing_nl" valid_values="" >
Filename of the prescribed waccm forcing data used with waccm_ghg chemistry.
This contains prescribed constituents for non-LTE calculations and heating rates
for wavelengths less than 200 nm.
Default: set by build-namelist.
</entry>

<entry id="waccm_forcing_datapath" type="char*256" input_pathname="abs" category="waccm_ghg"
       group="waccm_forcing_nl" valid_values="" >
Full pathname of the directory that contains the files specified in
<varname>waccm_forcing_filelist</varname>.
Default: set by build-namelist.
</entry>

<entry id="waccm_forcing_filelist" type="char*256" input_pathname="rel:waccm_forcing_datapath" category="waccm_ghg"
       group="waccm_forcing_nl" valid_values="" >
A file that contains a sequence of filenames for prescribed waccm forcing data.
The filenames in this file are relative to the directory specied
by <varname>waccm_forcing_datapath</varname>.
Default: set by build-namelist.
</entry>

<entry id="waccm_forcing_rmfile" type="logical" category="waccm_ghg"
       group="waccm_forcing_nl" valid_values="" >
Remove the file containing prescribed waccm forcing data from local disk when no longer needed.
Default: FALSE
</entry>

<entry id="waccm_forcing_specifier" type="char*16(100)" category="waccm_ghg"
       group="waccm_forcing_nl" valid_values="" >
Names of variables containing concentrations and heating rate in the prescribed waccm forcing datasets.
Default: none
</entry>

<entry id="waccm_forcing_type" type="char*32" category="waccm_ghg"
       group="waccm_forcing_nl" valid_values="CYCLICAL,SERIAL,INTERP_MISSING_MONTHS,FIXED" >
Type of time interpolation for data in waccm_forcing files.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.
Default: 'SERIAL'
</entry>

<entry id="waccm_forcing_cycle_yr" type="integer" category="waccm_ghg"
       group="waccm_forcing_nl" valid_values="" >
The  cycle year of the prescribed waccm forcing data
if <varname>waccm_forcing_type</varname>  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="waccm_forcing_fixed_ymd" type="integer" category="waccm_ghg"
       group="waccm_forcing_nl" valid_values="" >
The date at which the prescribed waccm forcing data is fixed
if <varname>waccm_forcing_type</varname> is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="waccm_forcing_fixed_tod" type="integer" category="waccm_ghg"
       group="waccm_forcing_nl" valid_values="" >
The time of day (seconds) corresponding to <varname>waccm_forcing_fixed_ymd</varname>
at which the prescribed waccm forcing data is fixed
if <varname>waccm_forcing_type</varname> is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="h2orates" type="char*256" input_pathname="abs" category="waccm_ghg"
       group="chem_inparm" valid_values="" >
Full pathname of time-variant boundary dataset for H2O production/loss rates.
Default: set by build-namelist.
</entry>

<!-- WACCM -->

<entry id="strat_aero_feedback" type="logical" category="waccm"
       group="chem_inparm" valid_values="" >
 true =&gt; radiation feed backs from strat sulfur aerosol
Default: false
</entry>

<entry id="nlte_use_mo" type="logical" category="waccm_phys"
       group="radheat_nl" valid_values="" >
Determines which constituents are used from NLTE calculations.
TRUE implies use prognostic constituents.
FALSE implies use constituents from dataset specified by <varname>waccm_forcing_file</varname>.
Default: TRUE for full WACCM code; FALSE for WACCM_GHG.
</entry>

<entry id="qbo_cyclic" type="logical" category="waccm_phys"
       group="qbo_nl" valid_values="" >
TRUE implies assume cyclic qbo data.
Default: FALSE
</entry>

<entry id="qbo_forcing_file" type="char*256" input_pathname="abs" category="waccm_phys"
       group="qbo_nl" valid_values="" >
Filepath for qbo forcing dataset.
Default: Set by build-namelist.
</entry>

<entry id="qbo_use_forcing" type="logical" category="waccm_phys"
       group="qbo_nl" valid_values="" >
TRUE implies qbo package is active.
Default: FALSE
</entry>

<entry id="spe_data_file" type="char*256" input_pathname="abs" category="waccm"
       group="chem_inparm" valid_values="" >
Filepath for time-variant solar proton ionization dataset.
Default: Set by build-namelist.
</entry>

<entry id="spe_filenames_list" type="char*256" input_pathname="abs" category="waccm"
       group="chem_inparm" valid_values="" >
Filepath for file that lists a series of solar proton ionization dataset files.
Default: Set by build-namelist.
</entry>

<entry id="spe_remove_file" type="logical" category="waccm"
       group="chem_inparm" valid_values="" >
TRUE implies the offline solar proton ionization data file will be deleted when
finished with it.
Default: FALSE
</entry>

<entry id="spe_restart" type="logical" category="waccm"
       group="chem_inparm" valid_values="" >
TRUE implies restart (branch) from a previous run with solar proton events.
Default: TRUE
</entry>



<!-- SE dycore -->

<entry id="se_limiter_option" type="integer" category="se"
       group="ctl_nl" valid_values="0,4,8,9" >
Limiter used for horizontal tracer advection:
0: None
4: Sign-preserving limiter.
8: Monotone limiter.
9: CAAS monotone limiter.
Default: 9
</entry>

<entry id="vert_remap_q_alg" type="integer" category="se"
    group="ctl_nl" valid_values="0,1,2,10">
CAM-SE vertical remap algorithm
0: default value, Zerroukat monotonic splines
1: PPM vertical remap with mirroring at the boundaries
   (solid wall bc's, high-order throughout)
2: PPM vertical remap without mirroring at the boundaries
   (no bc's enforced, first-order at two cells bordering top and bottom
   boundaries)
10: PPM with 2nd order boundary treatment
Default: 10
</entry>

<entry id="se_ftype" type="integer" category="se"
       group="ctl_nl" valid_values="0,1,2,3,4" >
CAM physics forcing option:
0: tendencies
1: adjustments
2: hybrid
Default: Set by build-namelist.
</entry>

<entry id="integration" type="char*80" category="se"
       group="ctl_nl" valid_values="explicit" >
Time integration method.
Default: explicit.
</entry>

<entry id="se_ne" type="integer" category="se"
       group="ctl_nl" valid_values="" >
Use internally generated cubed sphere mesh of size 6 x se_ne x se_ne.
If se_ne=0 (RRM grids), read mesh from Exodus file.
Default: Set by build-namelist.
</entry>

<entry id="se_ne_x" type="integer" category="se"
       group="ctl_nl" valid_values="" >
Number of elements in the x direction, for doubly periodic mode
Default: Set by build-namelist.
</entry>

<entry id="se_ne_y" type="integer" category="se"
       group="ctl_nl" valid_values="" >
Number of elements in the y direction, for doubly periodic mode
Default: Set by build-namelist.
</entry>

<entry id="se_lx" type="real" category="se"
       group="ctl_nl" valid_values="" >
Length of domain in meters in x direction, for doubly periodic mode
Default: Set by build-namelist.
</entry>

<entry id="se_ly" type="real" category="se"
       group="ctl_nl" valid_values="" >
Length of domain in meters in y direction, for doubly periodic mode
Default: Set by build-namelist.
</entry>

<entry id="mesh_file" type="char*256" input_pathname="abs" category="se"
       group="ctl_nl" valid_values="" >
Exodus format grid file used when se_ne=0
Default: Set by build-namelist.
</entry>

<entry id="se_partmethod" type="integer" category="se"
       group="ctl_nl" valid_values="4" >
Mesh partitioning method.  The only supported value in CAM is 4 (space-filling).
Default: 4
</entry>

<entry id="statefreq" type="integer" category="se"
       group="ctl_nl" valid_values="" >
Frequency with which diagnostic output is written to log (output every
statefreq dynamics timesteps).
Default: Set by build-namelist.
</entry>

<entry id="se_topology" type="char*80" category="se"
       group="ctl_nl" valid_values="cube,plane" >
SE's topology.
Only "cube" is supported in CAM. "plane" allowed for SCREAM in doubly
periodic mode.
Default: Set by build-namelist.
</entry>

<entry id="se_geometry" type="char*80" category="se"
       group="ctl_nl" valid_values="sphere,plane" >
SE's geometry.
Only "sphere" is supported in CAM. "plane" allowed for SCREAM in doubly
periodic mode.
Default: Set by build-namelist.
</entry>

<entry id="vthreads" type="integer" category="se"
       group="ctl_nl" valid_values="" >
Number of vertical threads.
Default: 1.
</entry>

<entry id="theta_hydrostatic_mode" type="logical" category="se"
       group="ctl_nl" valid_values="" >
Run theta model in hydrostatic mode.
Default: true.
</entry>

<entry id="theta_advect_form" type="integer" category="se"
       group="ctl_nl" valid_values="" >
Indicates form of eqn. for vtheta in theta model.
0 is conservation form, 1 is expanded div form.
Default: 1.
</entry>

<entry id="pgrad_correction" type="integer" category="se"
       group="ctl_nl" valid_values="0,1" >
Turn on use of balanced geopotential state to reduce
pressure gradient discretization error.
Default: 0
</entry>
<entry id="hv_ref_profiles" type="integer" category="se"
       group="ctl_nl" valid_values="0,1,2" >
Modifications to hyperviscosity to minimize dissipation of
background reference states.
Default: 0
</entry>
<entry id="hv_theta_correction" type="integer" category="se"
       group="ctl_nl" valid_values="0,1" >
For potential temperature equation, use Laplacian on pressure surfaces in
hyperviscosity operator.
Default: 0
</entry>
<entry id="hv_theta_thresh" type="real" category="se"
       group="ctl_nl" valid_values="" >
Max threshold for Laplacian on pressure surface d(theta)/dp correction term.
Default (set by dycore)
</entry>

<entry id="vtheta_thresh" type="real" category="se"
       group="ctl_nl" valid_values="" >
Minimum threshold for virtual potential temperature in the theta dycore.
Values below this will trigger a warning and be clipped.
Default: (set by dycore).
</entry>

<entry id="cubed_sphere_map" type="integer" category="se"
       group="ctl_nl" valid_values="" >
Defines which map is used for reference element in homme.
Must be 2 for compsets using TempestRemap mapping files.
Default: 2
</entry>


<!-- timestep parameters -->

<entry id="se_nsplit" type="integer" category="se"
       group="ctl_nl" valid_values="" >
Number of dynamics steps per physics timestep.
dt_remap = dtime/se_nsplit
dt_tracer = dt_remap / rsplit
dt_dyn = dt_tracer / qsplit
dt_dyn_vis = dt_dyn / hypervis_subcycle
dt_tracer_vis = dt_tracer / hypervis_subcycle_q
Default: Set by build-namelist.
</entry>

<entry id="rsplit" type="integer" category="se"
       group="ctl_nl" valid_values="" >
Number of tracer steps per remap step.
If rsplit=0, vertically lagrangian code is off.
Default: Set by build-namelist.
</entry>

<entry id="qsplit" type="integer" category="se"
       group="ctl_nl" valid_values="" >
Number of dynamics steps per tracer step.
Default: Set by build-namelist.
</entry>

<entry id="se_tstep" type="real" category="se"
       group="ctl_nl" valid_values="" >
Dynamics timestep.  Replaces se_nsplit.
</entry>

<entry id="dt_tracer_factor" type="integer" category="se"
       group="ctl_nl" valid_values="" >
The tracer advection timestep is dt_tracer_factor*se_tstep, where se_tstep is
the dynamics timesteps. dt_tracer_factor*se_tstep must divide dtime, and one of
dt_remap_factor and dt_tracer_factor must divide the other.
Replaces qsplit, rsplit.
Default: Set by build-namelist.
</entry>

<entry id="dt_remap_factor" type="integer" category="se"
       group="ctl_nl" valid_values="" >
The vertically Lagrangian remap timestep is dt_remap_factor*se_tstep, where
se_tstep is the dynamics timesteps. dt_remap_factor*se_tstep must divide dtime,
and one of dt_remap_factor and dt_tracer_factor must divide the other.
Replaces qsplit, rsplit.
If dt_remap_factor=0, vertically Lagrangian code is off.
</entry>

<entry id="tstep_type" type="integer" category="se"
       group="ctl_nl" valid_values="" >
Time stepping method for SE dycore
tstep_type=1  RK2 followed by qsplit-1 Leapfrog steps; second-order accurate in time (CESM1.2.0 setting)
tstep_type=2  RK2-SSP 3 stage (as used by tracers)
tstep_type=3  classic Runga-Kutta (RK) 3 stage
tstep_type=5  Kinnmark&Gray Runga-Kutta (RK) 5 stage (3rd order accurate in time)
tstep_type=9  Kinnmark&Gray Runga-Kutta IMEX
Default: Set by build-namelist.
</entry>


<!-- viscosity parameters -->

<entry id="hypervis_order" type="integer" category="se"
       group="ctl_nl" valid_values="2" >
Hyperviscosity operator is the Laplacian^hypervis_order.
The only supported value in CAM is "2".
Default: Set by build-namelist.
</entry>

<entry id="hypervis_subcycle" type="integer" category="se"
       group="ctl_nl" valid_values="" >
Number of hyperviscosity subcycles per dynamics timestep.
Default: Set by build-namelist (probably 2).
</entry>

<entry id="hypervis_subcycle_tom" type="integer" category="se"
       group="ctl_nl" valid_values="" >
If non-zero, subcycle TOM diffusion operator separately from hyperviscsoity
with dt_vis_tom=dt_dyn/hypervis_subcycle_tom.
Default: 1
</entry>

<entry id="hypervis_subcycle_q" type="integer" category="se"
       group="ctl_nl" valid_values="" >
Number of hyperviscosity subcycles done in tracer advection code.
Default: Set by build-namelist.
</entry>


<entry id="nu" type="real" category="se"
       group="ctl_nl" valid_values="" >
Dynamics hyperviscosity [m^4/s].
Default: Set by build-namelist.
</entry>

<entry id="nu_div" type="real" category="se"
       group="ctl_nl" valid_values="" >
Weighting of divergence component when applying hyperviscosity.
If < 0, uses nu.
Default: -1.
</entry>

<entry id="nu_s" type="real" category="se"
       group="ctl_nl" valid_values="" >
Hyperviscosity applied to dynamics scalars [m^4/s].
If < 0, uses nu.
Default: -1.
</entry>

<entry id="nu_p" type="real" category="se"
       group="ctl_nl" valid_values="" >
Hyperviscosity applied to dp3d (layer thickness when running
vertically lagrangian dynamics) [m^4/s].
If < 0, uses nu.
Default: -1.
</entry>

<entry id="nu_q" type="real" category="se"
       group="ctl_nl" valid_values="" >
Hyperviscosity applied during tracer advection [m^4/s].
If < 0, uses nu.
Default: -1.
</entry>

<entry id="nu_top" type="real" category="se"
       group="ctl_nl" valid_values="" >
Second-order viscosity applied only near the model top [m^2/s].
Default: Set by build-namelist.
</entry>

<entry id="tom_sponge_start" type="real" category="se"
       group="ctl_nl" valid_values="" >
Bottom of sponge layer in hPa.
Default: 0 (use default value based on reference pressure at model top).
</entry>

<entry id="hypervis_scaling" type="real" category="se"
       group="ctl_nl" valid_values="" >
Default: Set by build-namelist.
</entry>

<entry id="hypervis_power" type="real" category="se"
       group="ctl_nl" valid_values="" >
Default: Set by build-namelist.
</entry>

<!-- tracer transport options -->

<entry id="transport_alg" type="integer" category="se"
       group="ctl_nl" valid_values="0,12" >
Tracer transport algorithm:
0: Eulerian flux-form.
12: COMPOSE semi-Lagrangian.
Default: 12
</entry>

<entry id="semi_lagrange_cdr_alg" type="integer" category="se"
       group="ctl_nl" valid_values="2,3,20,21,30" >
Constrained density reconstuctor (CDR) for property preservation:
2: QLT
3: CAAS
20: QLT with superlevels of 8 levels.
21: QLT with superlevels of 8 levels; use local CAAS over sublevels.
30: CAAS with superlevels of 8 levels.
Default: (set by dycore)
</entry>

<entry id="semi_lagrange_cdr_check" type="logical" category="se"
       group="ctl_nl" valid_values="">
Correctness check the CDR.
Default: (set by dycore)
</entry>

<entry id="semi_lagrange_nearest_point_lev" type="integer" category="se"
       group="ctl_nl" valid_values="">
Number of levels, counting from the top, that are allowed to use the
nearest point in the halo to the departure point, when necessary.
Default: (set by dycore)
</entry>

<entry id="semi_lagrange_hv_q" type="integer" category="se"
       group="ctl_nl" valid_values="">
Number of tracers, starting from 1, to which to apply hyperviscosity. For
example, to apply hyperviscosity to moisture, the first tracer, set the value to
1. Hyperviscosity is applied using nu_q as the coefficient.
Default: (set by dycore)
</entry>

<!-- Physics grid -->

<entry id="se_fv_phys_remap_alg" type="integer" category="se"
       group="ctl_nl" valid_values="0,1">
Remap algorithm to use to map between FV physics grid and GLL dynamics
grid. 0, default, provides the original algorithms; 1 provides
high-order algorithms implemented in gllfvremap_mod.
Default: (set by dycore).
</entry>

<!-- CAM I/O  -->

<entry id="pio_stride" type="integer" category="pio"
       group="pio_default_inparm" valid_values="" >
Default: 4
</entry>
<entry id="pio_numiotasks" type="integer" category="pio"
       group="pio_default_inparm" valid_values="" >
Default: -1
</entry>
<entry id="pio_typename" type="char*80" category="pio"
       group="pio_default_inparm" valid_values="netcdf,pnetcdf,netcdf4p,netcdf4c" >
Default: "netcdf"
</entry>
<entry id="pio_root" type="integer" category="pio"
       group="pio_default_inparm" valid_values="" >
Default: 1
<entry id="pio_debug_level" type="integer" category="pio"
       group="pio_default_inparm" valid_values="" >
Default: 0
</entry>
<entry id="pio_blocksize" type="integer" category="pio"
       group="pio_default_inparm" valid_values="" >
Default: -1
</entry>
<entry id="pio_buffer_size_limit" type="integer" category="pio"
       group="pio_default_inparm" valid_values="" >
Default: 0
</entry>
<entry id="pio_async_interface" type="logical" category="pio"
       group="pio_default_inparm" valid_values="" >
Default: .false.
</entry>


<!-- DOCN -->

<entry id="restfilm" type="char*256" input_pathname="abs" category="ocn"
       group="docn_nml" valid_values="" >
Full pathname of docn restart file.
Default: set by build-namelist.
</entry>

<entry id="ocn_in" type="char*24" category="ocn"
       group="docn_nml" valid_values="" >
Full pathname of docn restart file.
Default: set by build-namelist.
</entry>

<entry id="decomp" type="char*24" category="ocn"
       group="docn_nml" valid_values="" >
Full pathname of docn restart file.
Default: set by build-namelist.
</entry>

<!-- Backwards compatibility options: support for old DOM, CSIM4 -->
<!-- SST Data -->

<entry id="bndtvs" type="char*256" input_pathname="abs" category="ocn"
       group="camexp" valid_values="" >
Full pathname of time-variant sea-surface temperature and sea-ice
concentration boundary dataset.
Default: set by build-namelist.
</entry>

<entry id="focndomain" type="char*256" input_pathname="abs" category="ocn"
       group="camexp" valid_values="" >
Full pathname of
Default: set by build-namelist.
</entry>

<entry id="bndtvs_domain" type="char*256" input_pathname="abs" category="ocn"
       group="camexp" valid_values="" >
Full pathname of grid file for time-variant sea-surface temperature and sea-ice
concentration boundary dataset.
Default: set by build-namelist.
</entry>

<entry id="sstcyc" type="logical" category="ocn"
       group="camexp" valid_values="" >
Flag for yearly cycling of SST data. If set to FALSE, a multi-year dataset
is assumed, otherwise a single-year dataset is assumed, and SSTs will be
cycled over the first 12 values in the file.  Not used if running with
CCSM.
Default: TRUE
</entry>

<!-- CICE: These variables are passed through to the CICE build-namelist.   -->
<!--       They are provided here for convenience in setting up AMIP runs.  -->

<entry id="stream_year_first" type="integer" category="ice"
       group="camexp" valid_values="" >
The first year of the multi-year SST dataset which is read by CICE for
the prescribed ice fraction.  This needs to be set for AMIP simulations.
Default: 0
</entry>

<entry id="stream_year_last" type="integer" category="ice"
       group="camexp" valid_values="" >
The last year of the multi-year SST dataset which is read by CICE for
the prescribed ice fraction.  This needs to be set for AMIP simulations.
Default: 0
</entry>

<!-- DOM (CAM version) -->

<entry id="dom_branch_file" type="char*256" category="restart"
       group="dom_inparm" valid_values="">
Full pathname of master restart file from which to branch. Setting is
Required for branch run.
Default: none
</entry>

<!-- CSIM (CAM version) -->

<entry id="ice_conschk_frq" type="integer" category="csim"
       group="csim_inparm" valid_values="" >
This is only used when running as part of CCSM. If n &gt; 0 then sea
ice global energy checking will be done every n timesteps. If n &lt; 0 then
sea ice global energy checking will be done every n days.
</entry>

<entry id="csim_branch_file" type="char*256" category="restart"
       group="csim_inparm" valid_values="">
Full pathname of master restart file from which to branch. Setting is
Required for branch run.
Default: none
</entry>

<entry id="prognostic_icesnow" type="logical" category="csim"
       group="csim_inparm" valid_values="">
Prognostic snow over ice, currently limited to 0.5m.
If this is false then a snow climatology is used.
Default: TRUE
</entry>

<entry id="reset_csim_iceprops" type="logical" category="csim"
       group="csim_inparm" valid_values="">
If true =&gt; resets the csim ice properties to base state, i.e.,
no snow cover, TSICE and TS[1-4] are all set to
freezing.
The csim is sensitive to imbalances between the
surface temperature and ice temperatures. When
using an initial conditions dataset interpolated
from a different resolution you may have to set this
to true to get csim to run.  If set to true you will
have to allow time for the ice to spin up.
Default: FALSE
</entry>

<!-- ========================================================================================  -->
<!-- Rename component log files.  shr_file_mod::shr_file_setIO reads
     namelist /modelio/.  These variables in group camexp are treated
     specially in build-namelist, where they are put into the modelio
     namelist group in files with specific names that are read by each
     component.  -->

<entry id="atm_logfile" type="char*256" category="driver"
       group="camexp" valid_values="">
Name of file that the atmosphere component log messages will be written to.  By
default all log messages are written to stdout.
Default: ""
</entry>

<entry id="atm_logfile_diro" type="char*256" category="driver"
       group="camexp" valid_values="">
Absolute pathname of directory that the file specified by <varname>atm_logfile</varname>
will be written to.
Default: "."
</entry>

<entry id="cpl_logfile" type="char*256" category="driver"
       group="camexp" valid_values="">
Name of file that the driver component log messages will be written to.  By
default all log messages are written to stdout.
Default: ""
</entry>

<entry id="cpl_logfile_diro" type="char*256" category="driver"
       group="camexp" valid_values="">
Absolute pathname of directory that the file specified by <varname>cpl_logfile</varname>
will be written to.
Default: "."
</entry>

<entry id="lnd_logfile" type="char*256" category="driver"
       group="camexp" valid_values="">
Name of file that the land component log messages will be written to.  By
default all log messages are written to stdout.
Default: ""
</entry>

<entry id="lnd_logfile_diro" type="char*256" category="driver"
       group="camexp" valid_values="">
Absolute pathname of directory that the file specified by <varname>lnd_logfile</varname>
will be written to.
Default: "."
</entry>

<entry id="rof_logfile" type="char*256" category="driver"
       group="camexp" valid_values="">
Name of file that the runoff component log messages will be written to.  By
default all log messages are written to stdout.
Default: ""
</entry>

<entry id="rof_logfile_diro" type="char*256" category="driver"
       group="camexp" valid_values="">
Absolute pathname of directory that the file specified by <varname>rof_logfile</varname>
will be written to.
Default: "."
</entry>


<!-- ========================================================================================  -->
<!-- CPL7 Driver -->

<!-- coupler fields -->

<entry id="flds_co2a" type="logical"  category="driver"
       group="seq_cplflds_inparm" valid_values="" >
Default: FALSE
</entry>
<entry id="flds_co2b" type="logical"  category="driver"
       group="seq_cplflds_inparm" valid_values="" >
Default: FALSE
</entry>
<entry id="flds_co2c" type="logical"  category="driver"
       group="seq_cplflds_inparm" valid_values="" >
Default: FALSE
</entry>
<entry id="flds_co2_dmsa" type="logical"  category="driver"
       group="seq_cplflds_inparm" valid_values="" >
Default: FALSE
</entry>
<entry id="cplflds_custom" type="char*80"  category="driver"
       group="seq_cplflds_userspec" valid_values="" >
Default:
</entry>

<!-- Task/Thread layouts -->

<entry id="atm_pestride" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Stride used in selecting the processes in the atm communicator group.
Default: 1
</entry>

<entry id="atm_rootpe" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Root process of the atm communicator group.
Default: 0
</entry>

<entry id="atm_ntasks" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Number of atm tasks.
Default: total number of tasks assigned to job.
</entry>

<entry id="atm_nthreads" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Number of threads in each atm task.
Default: 1
</entry>

<entry id="lnd_pestride" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Stride used in selecting the processes in the lnd communicator group.
Default: 1
</entry>

<entry id="lnd_rootpe" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Root process of the lnd communicator group.
Default: 0
</entry>

<entry id="lnd_ntasks" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Number of lnd tasks.
Default: total number of tasks assigned to job.
</entry>

<entry id="lnd_nthreads" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Number of threads in each lnd task.
Default: 1
</entry>

<entry id="ice_pestride" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Stride used in selecting the processes in the ice communicator group.
Default: 1
</entry>

<entry id="ice_rootpe" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Root process of the ice communicator group.
Default: 0
</entry>

<entry id="ice_ntasks" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Number of ice tasks.
Default: total number of tasks assigned to job.
</entry>

<entry id="ice_nthreads" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Number of threads in each ice task.
Default: 1
</entry>

<entry id="ocn_pestride" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Stride used in selecting the processes in the ocn communicator group.
Default: 1
</entry>

<entry id="ocn_rootpe" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Root process of the ocn communicator group.
Default: 0
</entry>

<entry id="ocn_ntasks" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Number of ocn tasks.
Default: total number of tasks assigned to job.
</entry>

<entry id="ocn_nthreads" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Number of threads in each ocn task.
Default: 1
</entry>

<entry id="rof_pestride" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Stride used in selecting the processes in the rof communicator group.
Default: 1
</entry>

<entry id="rof_rootpe" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Root process of the rof communicator group.
Default: 0
</entry>

<entry id="rof_ntasks" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Number of rof tasks.
Default: total number of tasks assigned to job.
</entry>

<entry id="rof_nthreads" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Number of threads in each rof task.
Default: 1
</entry>

<entry id="cpl_pestride" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Stride used in selecting the processes in the cpl communicator group.
Default: 1
</entry>

<entry id="cpl_rootpe" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Root process of the cpl communicator group.
Default: 0
</entry>

<entry id="cpl_ntasks" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Number of cpl tasks.
Default: total number of tasks assigned to job.
</entry>

<entry id="cpl_nthreads" type="integer"  category="driver"
       group="ccsm_pes" valid_values="" >
Number of threads in each cpl task.
Default: 1
</entry>

<!-- Control info -->

<entry id="aqua_planet" type="logical"  category="driver"
       group="seq_infodata_inparm" valid_values="" >
If true, run model in "aqua planet" mode. Only one of
<varname>atm_adiabatic</varname>, <varname>atm_ideal_phys</varname>, or
<varname>aqua_planet</varname> can be true.
Default: FALSE
</entry>

<entry id="aqua_planet_sst" type="integer"  category="driver"
       group="seq_infodata_inparm" valid_values="1" >
Set the sst to a particular analytic solution.  **Not currently
functional** The type of analytic solution is currently hardcoded with a
parameter in ocn_comp.F90.
Default: 1
</entry>

<entry id="atm_adiabatic" type="logical"  category="driver"
       group="seq_infodata_inparm" valid_values="" >
If TRUE, do not run model physics, only run the dynamical core.
Only one of
<varname>atm_adiabatic</varname>, <varname>atm_ideal_phys</varname>, or
<varname>aqua_planet</varname> can be true.
Default: FALSE
</entry>

<entry id="atm_dep_flux" type="logical" category="driver"
       group="phys_ctl_nl" valid_values="" >
If FALSE then CAM will set the deposition fluxes to zero before sending
them to the coupler.  A side effect of setting the
variable <varname>chem_rad_passive</varname> to TRUE is that this variable
will be set to FALSE (the deposition fluxes must be set to zero in order
for the chemistry not to impact the climate).
Default: TRUE
</entry>

<entry id="atm_ideal_phys" type="logical"  category="driver"
       group="seq_infodata_inparm" valid_values="" >
If TRUE run the idealized Held&amp;Suarez physics package.
Only one of
<varname>atm_adiabatic</varname>, <varname>atm_ideal_phys</varname>, or
<varname>aqua_planet</varname> can be true.
Default: FALSE
</entry>

<entry id="bfbflag" type="logical"  category="driver"
       group="seq_infodata_inparm" valid_values="" >
bit for bit flag
Default: FALSE
</entry>

<entry id="brnch_retain_casename" type="logical"  category="driver"
       group="seq_infodata_inparm" valid_values="" >
If TRUE, use the pre-existing case name for a branch run.
Default: FALSE
</entry>

<entry id="budget_ann" type="integer" category="driver"
       group="seq_infodata_inparm" valid_values="" >
annual budget level
Default: 1
</entry>

<entry id="budget_daily" type="integer" category="driver"
       group="seq_infodata_inparm" valid_values="" >
daily budget level
Default: 0
</entry>

<entry id="budget_inst" type="integer" category="driver"
       group="seq_infodata_inparm" valid_values="" >
instantaneous budget level
Default: 0
</entry>

<entry id="budget_ltann" type="integer" category="driver"
       group="seq_infodata_inparm" valid_values="" >
long term budget level written at end of year
Default: 1
</entry>

<entry id="budget_ltend" type="integer" category="driver"
       group="seq_infodata_inparm" valid_values="" >
long term budget level written at end of run
Default: 0
</entry>

<entry id="budget_month" type="integer" category="driver"
       group="seq_infodata_inparm" valid_values="" >
monthly budget level
Default: 1
</entry>

<entry id="case_desc" type="char*256"  category="driver"
       group="seq_infodata_inparm" valid_values="" >
Case title.
Default: none.
</entry>

<entry id="case_name" type="char*80"  category="driver"
       group="seq_infodata_inparm" valid_values="" >
Case identifier.  The value of <varname>case_name</varname> is used in the
default filenames of both the history and restart files (see
the <varname>hfilename_spec</varname> namelist option).  The "%c" string in
the <varname>hfilename_spec</varname> templates are expanded using the
value of <varname>case_name</varname> when history filenames are created.
Default: set by build-namelist.
</entry>

<entry id="cpl_cdf64" type="logical"  category="driver"
       group="seq_infodata_inparm" valid_values="" >
Use netcdf 64 bit offset, large file support.
Default: FALSE
</entry>

<entry id="do_budgets" type="logical" category="driver"
       group="seq_infodata_inparm" valid_values="" >
T =&gt; do heat/water budget diagnostics
Default: FALSE
</entry>

<entry id="drv_threading" type="logical" category="driver"
       group="seq_infodata_inparm" valid_values="" >
T =&gt; enable run time setting of thread count for each component
Default: FALSE
</entry>

<entry id="flux_albav" type="logical" category="driver"
       group="seq_infodata_inparm" valid_values="" >
T =&gt; no diurnal cycle in ocn albedos.
Default: FALSE
</entry>

<entry id="flux_epbal" type="char*256" category="driver"
       group="seq_infodata_inparm" valid_values="" >
Selects E,P,R adjustment technique.
Default: 'off'
</entry>

<entry id="hostname" type="char*80"  category="driver"
       group="seq_infodata_inparm" valid_values="" >
Current machine.
Default: 'unknown'
</entry>

<entry id="info_debug" type="integer" category="driver"
       group="seq_infodata_inparm" valid_values="" >
Debug flag.
Default: 1
</entry>

<entry id="logfilepostfix" type="char*80" category="driver"
       group="seq_infodata_inparm" valid_values="" >
Postfix for output log files.
Default: '.log'
</entry>

<entry id="model_version" type="char*256"  category="driver"
       group="seq_infodata_inparm" valid_values="" >
Model version.
Default: 'unknown'
</entry>

<entry id="ocean_tight_coupling" type="logical"  category="driver"
       group="seq_infodata_inparm" valid_values="" >
Couple ocean on atm timestep.
Default: TRUE
</entry>

<entry id="orb_eccen" type="real"  category="driver"
       group="seq_infodata_inparm" valid_values="" >
Earth's eccentricity of orbit. (unitless: typically 0. to 0.1). Setting is
Required if <varname>orb_iyear</varname> not set.  Not used when running
as part of CCSM.
Default: none
</entry>

<entry id="orb_mode" type="char*256"  category="driver"
       group="seq_infodata_inparm" valid_values="fixed_year,variable_year,fixed_parameters" >
Mode to specify how orbital parameters are to be set.
Not used when running as part of CCSM.
Default: fixed_year
</entry>

<entry id="orb_iyear" type="integer"  category="driver"
       group="seq_infodata_inparm" valid_values="" >
Year (AD) used to compute earth's orbital parameters. If not set, then use
the values from
the <varname>orb_eccen</varname>, <varname>orb_mvelp</varname>,
and <varname>orb_obliq</varname> namelist parameters.  If only
<varname>orb_iyear</varname> is set, orbital parameters will be computed
automatically (based on Berger, 1977).  If one
of <varname>orb_eccen</varname>, <varname>orb_mvelp</varname>, or
<varname>orb_obliq</varname> is set, all three must be set.  If all four of
the above are set by the user, <varname>orb_iyear</varname> takes
precedence.  Setting is Required
unless <varname>orb_eccen</varname>, <varname>orb_mvelp</varname>,
and <varname>orb_obliq</varname> are set.  Not used when running as part of
CCSM.
Default: 1990.
</entry>

<entry id="orb_mvelp" type="real"  category="driver"
       group="seq_infodata_inparm" valid_values="" >
Earth's moving vernal equinox at perihelion (degrees: 0. to 360.0).
Setting is Required if <varname>orb_iyear</varname> not set.  Not used
when running as part of CCSM.
Default: none
</entry>

<entry id="orb_obliq" type="real"  category="driver"
       group="seq_infodata_inparm" valid_values="" >
Earth's orbital  angle of obliquity  (degrees: -90. to +90., typically 22. to 26.).
Setting is Required if <varname>orb_iyear</varname> not set.  Not used
when running as part of CCSM.
Default: none
</entry>

<entry id="outpathroot" type="char*256" category="driver"
       group="seq_infodata_inparm" valid_values="" >
Root output files
Default: './'
</entry>

<entry id="perpetual" type="logical"  category="time_mgr"
       group="seq_infodata_inparm" valid_values="" >
Set to TRUE to specify that the run will use a perpetual calendar, i.e., a
diurnal cycle will be present for the fixed calendar day specified
by <varname>perpetual_ymd</varname>.
Default: FALSE
</entry>

<entry id="perpetual_ymd" type="integer"  category="time_mgr"
       group="seq_infodata_inparm" valid_values="" >
Perpetual date encoded in an integer as (year*1000 + month*100 + day).
If <varname>aqua_planet</varname> = .true. then perpetual_ymd is ignored
and the perpetual date is set to 321.
Default: none.
</entry>

<entry id="restart_file" type="char*256" category="driver"
       group="seq_infodata_inparm" valid_values="" >
Restart filename.
Default: none
</entry>

<entry id="restart_file_override" type="char*256" category="driver"
       group="seq_infodata_inparm" valid_values="" >
List of namelist variables that may be overridden on a restart run.
Default: none
</entry>

<entry id="restart_pfile" type="char*256" category="driver"
       group="seq_infodata_inparm" valid_values="" >
Restart pointer filename.
Default: 'rpointer.drv'
</entry>

<entry id="samegrid" type="logical" category="driver"
       group="seq_infodata_inparm" valid_values="">
are ocean and ice grids same lat/lon/size
Default: TRUE
</entry>

<entry id="scmlat" type="real" category="scam"
       group="seq_infodata_inparm" valid_values="">
Latitude value of single column.
Default: none.
</entry>

<entry id="scmlon" type="real" category="scam"
       group="seq_infodata_inparm" valid_values="">
Longitude value of single column.
Default: none.
</entry>

<entry id="single_column" type="logical" category="scam"
       group="seq_infodata_inparm" valid_values="">
Set to TRUE to turn on single column mode.
Default: FALSE
</entry>

<entry id="start_type" type="char*8"  category="driver"
       group="seq_infodata_inparm" valid_values="startup,continue,branch" >
Run type.  'startup' is an initial run.  'continue' is a restart run.
'branch' is a restart run in which properties of the output history files
may be changed.
Default: 'startup'
</entry>

<entry id="username" type="char*80"  category="driver"
       group="seq_infodata_inparm" valid_values="" >
Current user.
Default: 'unknown'
</entry>

<entry id="vect_map" type="char*8"  category="driver"
       group="seq_infodata_inparm" valid_values="none,cart3d,cart3d_diag,cart3d_uvw,cart3d_uvw_diag" >
Invoke vector mapping option
Default: 'cart3d'
</entry>

<!-- Reproducible Distributed Sum Calculation -->

<entry id="reprosum_use_ddpdd" type="logical"  category="reprosum"
       group="seq_infodata_inparm" valid_values="">
Flag to indicate whether to use the double-double distributed sum algorithm
rather than the (almost) infinite precision reproducible distributed sum algorithm.
Default: FALSE
</entry>

<entry id="reprosum_recompute" type="logical"  category="reprosum"
       group="seq_infodata_inparm" valid_values="">
Flag to indicate whether a distributed sum that violates the difference
tolerance specified by reprosum_diffmax should be recomputed using
a floating point-based (but nonscalable) reproducible algorithm.
Default: FALSE
</entry>

<entry id="reprosum_diffmax" type="real"  category="reprosum"
       group="seq_infodata_inparm" valid_values="">
Relative difference between repro and nonrepro algorithms that will
generate a warning. This will also force a recompute using a nonscalable
algorithm if reprosum_recompute is true. If less than zero, then
the difference will not be evaluated (and the nonrepro algorithm will not
be computed).
Default: -1.0
</entry>

<!-- Time Manager -->

<entry id="atm_cpl_dt" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Coupling interval between the atmosphere and other system components.  This
is how frequently information can be communicated between the atmosphere
and the surface models.
Default: set by build-namelist.
</entry>

<entry id="atm_cpl_offset" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Default:
</entry>

<entry id="calendar" type="char*80"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="NO_LEAP,GREGORIAN" >
Calendar type "NO_LEAP" for consistent 365-days per year or "GREGORIAN" to
include leap-years. Note that if "GREGORIAN" is selected
leap-years will be used in the time manager, but the calculation of the
earth's orbit still assumes 365 day years.  Valid values are "NO_LEAP" or
"GREGORIAN".
Default: "NO_LEAP"
</entry>

<entry id="end_restart" type="logical"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Write restart at end of run.
Default: TRUE
</entry>

<entry id="ice_cpl_dt" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Default: set by build-namelist.
</entry>

<entry id="ice_cpl_offset" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Default:
</entry>

<entry id="lnd_cpl_dt" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Default: set by build-namelist.
</entry>

<entry id="lnd_cpl_offset" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Default:
</entry>

<entry id="ocn_cpl_dt" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Default: set by build-namelist.
</entry>

<entry id="ocn_cpl_offset" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Default:
</entry>

<entry id="rof_cpl_dt" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Default: set by build-namelist.
</entry>

<entry id="rof_cpl_offset" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Default:
</entry>

<entry id="ref_tod" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Reference time-of-day expressed as seconds past midnight.  Used in
conjuction with <varname>ref_ymd</varname> to set the reference time.
Default: set to <varname>start_tod</varname>.
</entry>

<entry id="ref_ymd" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Reference date encoded in an integer as (year*1000 + month*100 + day).
Used in
conjuction with <varname>ref_tod</varname> to set the reference time which
is used to define a time coordinate for the output history files.  The
convention for the unit string of a time coordinate is of the form
"time-unit since reference-time", for example, "days since 1990-01-01
00:00:00".  The reference-time part of this string is specified by the
<varname>ref_ymd</varname> and <varname>ref_tod</varname> variables.

Default: set to <varname>start_ymd</varname>.
</entry>

<entry id="restart_n" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Set the restart interval as a number of elapsed time units which are specified
by <varname>restart_option</varname>.
Default: 1
</entry>

<entry id="restart_option" type="char*8"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="none,nsteps,ndays,nmonths,nyears,monthly,yearly,end" >
Set the interval between writing restart files
using one of the options 'nsteps',
'ndays', 'nmonths', or 'nyears', in conjuction
with <varname>stop_n</varname> to set the number of time units.
A convenience option allows specifying that restart files be written at the
end of each month or at the end of each year by using the options
'monthly' or 'yearly' respectively.  It is also possible to request that no
restart files be written via the option 'none', or that restart files be
written only at the end of the run via the option 'end'.
Default: 'monthly'
</entry>

<entry id="start_tod" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Start time-of-day expressed as seconds past midnight.  Used in
conjuction with <varname>start_ymd</varname> to set the start time.
Default: 0.
</entry>

<entry id="start_ymd" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Start date encoded in an integer as (year*1000 + month*100 + day).
Used in
conjuction with <varname>start_tod</varname> to set the start date of
the simulation.
Default: set by build-namelist.
</entry>

<entry id="stop_n" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Set the length of run as a number of elapsed time units which are specified
by <varname>stop_option</varname>.
Default: 1
</entry>

<entry id="stop_option" type="char*8"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="nsteps,ndays,nmonths,nyears,date" >
Set the length of run as an elapsed time using one of the options 'nsteps',
'ndays', 'nmonths', or 'nyears', in conjuction
with <varname>stop_n</varname> to set the number of elapsed time units.
Alternatively, set the final simulation time in absolute terms by using the
option 'date' in conjuction with <varname>stop_ymd</varname>,
and <varname>stop_tod</varname> to specify a date and time of day at which
the simulation should stop.
Default: 'ndays'
</entry>

<entry id="stop_tod" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Stop time-of-day expressed as seconds past midnight.  Used in
conjuction with <varname>stop_ymd</varname> to set the stop time.
Default: 0.
</entry>

<entry id="stop_ymd" type="integer"  category="time_mgr"
       group="seq_timemgr_inparm" valid_values="" >
Stop date encoded in an integer as (year*1000 + month*100 + day).
Used in
conjuction with <varname>stop_tod</varname> to set the stop date of
the simulation.
Default: none.
</entry>


<!-- ========================================================================================  -->
<!-- CLM -->

<entry id="clump_pproc" type="integer" category="clm"
       group="clm_inparm" valid_values="" >
Clumps per processor.
Default: Number of threads per process; or 1 if no OMP.
</entry>

<entry id="co2_ppmv" type="real" category="clm"
       group="clm_inparm" valid_values="" >

Default: 355.
</entry>

<entry id="co2_type" type="char*16" category="clm"
       group="clm_inparm" valid_values="constant,prognostic,diagnostic" >
Type of CO2 feedback.
Default: 'constant' for BGC mode
</entry>

<entry id="create_crop_landunit" type="logical" category="clm"
       group="clm_inparm" valid_values="" >
on if to create crop as separate landunits
Default: FALSE
</entry>

<entry id="fatmlndfrc" type="char*256" input_pathname="abs" category="clm"
       group="clm_inparm" valid_values="" >
Full pathname of grid/landfrac data file (on atm grid).
Default: set by build-namelist.
</entry>

<entry id="fatmtopo" type="char*256" input_pathname="abs" category="clm"
       group="clm_inparm" valid_values="" >
Full pathname of atmosphere topography data file (on atm grid).
Default: set by build-namelist.
</entry>

<entry id="finidat" type="char*256" input_pathname="abs" category="clm"
       group="clm_inparm" valid_values="" >
Full pathname of initial conditions file.
Default: set by build-namelist.
</entry>

<entry id="flndtopo" type="char*256" input_pathname="abs" category="clm"
       group="clm_inparm" valid_values="" >
Full pathname of land topography file.
Default: set by build-namelist.
</entry>

<entry id="fpftcon" type="char*256" input_pathname="abs" category="clm"
       group="clm_inparm" valid_values="" >
Full pathname of PFT data file.
Default: set by build-namelist.
</entry>

<entry id="fpftdyn" type="char*256" input_pathname="abs" category="clm"
       group="clm_inparm" valid_values="" >
Full pathname of time varying PFT data file.
Default: set by build-namelist.
</entry>

<entry id="frivinp_rtm" type="char*256" input_pathname="abs" category="clm"
       group="clm_inparm" valid_values="" >
Full pathname of input datafile for rtm.
Default: set by build-namelist.
</entry>

<entry id="fsurdat" type="char*256" input_pathname="abs" category="clm"
       group="clm_inparm" valid_values="" >
Full pathname of surface data file.
Default: set by build-namelist.
</entry>

<entry id="fsnowoptics" type="char*256"  input_pathname="abs" category="clm"
       group="clm_inparm" valid_values="" >
SNICAR (SNow, ICe, and Aerosol Radiative model) optical data file name
</entry>

<entry id="fsnowaging" type="char*256"  input_pathname="abs" category="clm"
       group="clm_inparm" valid_values="" >
SNICAR (SNow, ICe, and Aerosol Radiative model) snow aging data file name
</entry>

<entry id="hist_avgflag_pertape" type="char*1(6)" category="clm"
       group="clm_inparm" valid_values="" >
Per file averaging flag.
Default: ' ',' ',' ',' ',' ',' '
</entry>

<entry id="hist_dov2xy" type="logical(6)" category="clm"
       group="clm_inparm" valid_values="" >
TRUE implies do grid averaging.  One value for each output history file.
Default: All TRUE.
</entry>

<entry id="hist_empty_htapes" type="logical" category="clm"
       group="clm_inparm" valid_values="" >
TRUE indicates no default history fields.
Default: FALSE
</entry>

<entry id="hist_fexcl1" type="char*34(1000)" category="clm"
       group="clm_inparm" valid_values="" >
Fields to exclude from history file 1.
Default: none.
</entry>

<entry id="hist_fexcl2" type="char*34(1000)" category="clm"
       group="clm_inparm" valid_values="" >
Fields to exclude from history file 2.
Default: none.
</entry>

<entry id="hist_fexcl3" type="char*34(1000)" category="clm"
       group="clm_inparm" valid_values="" >
Fields to exclude from history file 3.
Default: none.
</entry>

<entry id="hist_fexcl4" type="char*34(1000)" category="clm"
       group="clm_inparm" valid_values="" >
Fields to exclude from history file 4.
Default: none.
</entry>

<entry id="hist_fexcl5" type="char*34(1000)" category="clm"
       group="clm_inparm" valid_values="" >
Fields to exclude from history file 5.
Default: none.
</entry>

<entry id="hist_fexcl6" type="char*34(1000)" category="clm"
       group="clm_inparm" valid_values="" >
Fields to exclude from history file 6.
Default: none.
</entry>

<entry id="hist_fincl1" type="char*34(1000)" category="clm"
       group="clm_inparm" valid_values="" >
Fields to add to history file 1.
Default: none.
</entry>

<entry id="hist_fincl2" type="char*34(1000)" category="clm"
       group="clm_inparm" valid_values="" >
Fields to add to history file 2.
Default: none.
</entry>

<entry id="hist_fincl3" type="char*34(1000)" category="clm"
       group="clm_inparm" valid_values="" >
Fields to add to history file 3.
Default: none.
</entry>

<entry id="hist_fincl4" type="char*34(1000)" category="clm"
       group="clm_inparm" valid_values="" >
Fields to add to history file 4.
Default: none.
</entry>

<entry id="hist_fincl5" type="char*34(1000)" category="clm"
       group="clm_inparm" valid_values="" >
Fields to add to history file 5.
Default: none.
</entry>

<entry id="hist_fincl6" type="char*34(1000)" category="clm"
       group="clm_inparm" valid_values="" >
Fields to add to history file 6.
Default: none.
</entry>

<entry id="hist_mfilt" type="integer(6)" category="clm"
       group="clm_inparm" valid_values="" >
Per file maximum number of time samples.
Default: 30,30,30,30,30,30
</entry>

<entry id="hist_ndens" type="integer(6)" category="clm"
       group="clm_inparm" valid_values="1,2" >
Per file history output precision.
Default: 2,2,2,2,2,2
</entry>

<entry id="hist_nhtfrq" type="integer(6)" category="clm"
       group="clm_inparm" valid_values="" >
Per file history write frequency (0=monthly)
Default: 0,-24,-24,-24,-24,-24
</entry>

<entry id="hist_type1d_pertape" type="char*32(6)" category="clm"
       group="clm_inparm" valid_values="" >
Per file type1d
Default: ' ',' ',' ',' ',' ',' '
</entry>

<entry id="nrevsn" type="char*256" category="clm"
       group="clm_inparm" valid_values="" >
Full pathname of master restart file for branch run.
Default: none.
</entry>

<entry id="nsegspc" type="integer" category="clm"
       group="clm_inparm" valid_values="" >
number of segments per clump for decomposition
Default: 20
</entry>

<entry id="outnc_large_files" type="logical" category="clm"
       group="clm_inparm" valid_values="" >
on to output NetCDF files in large-file format
<default>Default: FALSE</default>
</entry>

<entry id="rest_flag" type="logical" category="clm"
       group="clm_inparm" valid_values="" >
FALSE implies don't write any restart files.
Default: TRUE
</entry>

<entry id="rtm_nsteps" type="integer" category="clm"
       group="clm_inparm" valid_values="" >
If greater than one, average rtm over rtm_nsteps time steps
</entry>

<entry id="sim_year" type="char*9" category="clm"
       group="camexp" valid_values="1850,2000,1850-2000">
This varible is only used internally by build-namelist to determine correct
defaults for datasets such as surface datasets, initial conditions, dynamic
PFT, aerosol-deposition, Nitrogen deposition rates etc.
Default: set by build-namelist.
</entry>

<entry id="urban_hac" type="char*16" category="clm"
       group="clm_inparm" valid_values="OFF,ON,ON_WASTEHEAT" >
Urban air conditioning/heating and wasteheat
<default>Default: 'off'</default>
</entry>

<entry id="urban_traffic" type="logical" category="clm"
       group="clm_inparm" valid_values="" >
TRUE if want urban traffic flux
<default>Default: FALSE</default>
</entry>

<entry id="wrtdia" type="logical" category="clm"
       group="clm_inparm" valid_values="" >
true if want output written
Default: FALSE
</entry>

<!-- ========================================================================================  -->
<!-- RTM -->

<entry id="rtm_mode" type="logical" category="rtm"
       group="rtm_inparm" valid_values="">
River runoff
Default: NULL
</entry>

<!-- ========================================================================================  -->
<!-- physical constants: -->

<entry id="sday" type="real" category="physconst"
       group="physconst_nl" valid_values="" >
Length of siderial day [seconds].
Default: set to shr_const value
</entry>

<entry id="rearth" type="real" category="physconst"
       group="physconst_nl" valid_values="" >
Radius of Earth [m].
Default: set to shr_const value
</entry>

<entry id="omega" type="real" category="physconst"
       group="physconst_nl" valid_values="" >
Earth Rotation rate [m/s].
Default: set to shr_const value
</entry>

<entry id="gravit" type="real" category="physconst"
       group="physconst_nl" valid_values="" >
Acceleration of gravity [m/s**2].
Default: set to shr_const value
</entry>

<entry id="mwdry" type="real" category="physconst"
       group="physconst_nl" valid_values="" >
Molecular weight of dry air [g/mol]
Default: set to shr_const value
</entry>

<entry id="mwh2o" type="real" category="physconst"
       group="physconst_nl" valid_values="" >
Molecular weight of water [g/mol].
Default: set to shr_const value
</entry>

<entry id="cpwv" type="real" category="physconst"
       group="physconst_nl" valid_values="" >
Heat capacity of water vapor at constant pressure [J/kg/K].
Default: set to shr_const value
</entry>

<entry id="tmelt" type="real" category="physconst"
       group="physconst_nl" valid_values="" >
Freezing point of water [K].
Default: set to shr_const value
</entry>

<entry id="tms_orocnst" type="real" category="physconst"
       group="physconst_nl" valid_values="" >
Turbulent mountain stress parameter used when turbulent mountain stress calculation
is turned on. See <varname>do_tms</varname>.
Default: 1.0 for CAM, set by build-namelist for WACCM, T31
</entry>

<entry id="tms_z0fac" type="real" category="physconst"
       group="physconst_nl" valid_values="" >
Factor determining z_0 from orographic standard deviation [ no unit ]
Used when turbulent mountain stress calc is turned on. See <varname>do_tms</varname>.
set by build-namelist for WACCM, T31
</entry>

<entry id="omega" type="real" category="physconst"
       group="physconst_nl" valid_values="" >
Planetary rotation rate (radians/second). Value set here is ONLY used in the atmosphere.
Default: set to shr_const value
</entry>

</namelist_definition>
