namelist_definition.xml

<?xml version="1.0"?>

<?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.
                                                                        -->

<!-- Frierson Simple Physics Parameters -->

<entry id="frierson_Wind_min" type="real" category="frierson"
       group="frierson_nl" valid_values="" >
       Minimum Wind Threshold for surface flux calculations which is
       added to avoid possible cases that would result in a division by zero.
       Default: 1.0d-5
       </entry>

<entry id="frierson_Z0" type="real" category="frierson"
       group="frierson_nl" valid_values="" >
       Surface Roughness Length for surface drag calculation.
       Default: 3.21d-5
       </entry>

<entry id="frierson_Ri_c" type="real" category="frierson"
       group="frierson_nl" valid_values="" >
       Critical Richardson Number for stable mixing cutoff.
       Default: 1.0
       </entry>

<entry id="frierson_Fb" type="real" category="frierson"
       group="frierson_nl" valid_values="" >
       Surface Layer Fraction of boundary layer depth.
       The prescribed fraction of the boundary layer depth
       for surface interactions.
       Default: 0.1
       </entry>

<entry id="frierson_Albedo" type="real" category="frierson"
       group="frierson_nl" valid_values="" >
       Frierson Albedo: Frierson's Net Solar Flux=>  938.4 = 1360*(1.-0.31)
       The Frierson model prescribes a net solar flux which incorporated the
       effects of albedo. Rather than adhering to this formulation, the net
       solar flux is obtained by a more common practice of specifying an albedo
       value. For the approximate (simple) solar flux of 1360 W m-2, the albedo
       value of 0.31 yields the value used by Frierson.
       Default: 0.31
       </entry>

<entry id="frierson_DeltaS" type="real" category="frierson"
       group="frierson_nl" valid_values="" >
       Latitudinal Variation of Shortwave Radiation.
       Shortwave radiation contains no seasonal/diurnal variations and has a
       Latitudinal variation specified by DeltaS according to:
               R_solar = (R_net/4)*[1 + DeltaS*P_2(Lat)]
       where P_2 is the second Legendre polynomial.
       Default: 1.4
       </entry>

<entry id="frierson_Tau_eqtr" type="real" category="frierson"
       group="frierson_nl" valid_values="" >
       Longwave Optical Depth at Equator.
       The optical depths are specified as a function of Latitude to approximate
       the effects of water vapor according to:
        Tau_0 = Tau_eqtr + (Tau_pole - Tau_eqtr)*sin^2(Lat)
       Default: 6.0
       </entry>

<entry id="frierson_Tau_pole" type="real" category="frierson"
       group="frierson_nl" valid_values="" >
       Longwave Optical Depth at Poles.
       The optical depths are specified as a function of Latitude to approximate
       the effects of water vapor according to:
        Tau_0 = Tau_eqtr + (Tau_pole - Tau_eqtr)*sin^2(Lat)
       Default: 1.5
       </entry>

<entry id="frierson_LinFrac" type="real" category="frierson"
       group="frierson_nl" valid_values="" >
       Linear Optical Depth Parameter for stratosphere.
       The pressure dependence of optical depths that approximate the effects of
       water vapor varies according to:
          Tau = Tau_0*[ LinFrac*(P/P_s) + (1-LinFrac)*(P/P_s)^4 ]
       Default: 0.1
       </entry>

<entry id="frierson_C0" type="real" category="frierson"
       group="frierson_nl" valid_values="" >
       Ocean Mixed-Layer Heat Capacity.
       The ocean surface is a slab mixed layer with a specified heat capacity in units of J K-1 m-2
       Default: 1.e7
       </entry>

<entry id="frierson_WetDryCoef" type="real" category="frierson"
       group="frierson_nl" valid_values="" >
       Scale Factor for E0 (saturation vapor pressure) to contol wet/dry experiments.
       WetDryCoef=0  corresponds to the atmosphere in the dry limit.
       Friersons wet limit corresponds to WetDryCoef=10.
       Default: 1.
       </entry>

<entry id="frierson_Tmin" type="real" category="frierson"
       group="frierson_nl" valid_values="" >
       Tsrf Initial Condition: Minimum SST (K).
       The ocean temperatures are initailized with the values:
        T_s = Tmin + Tdlt*exp[-0.5*(Lat/Twidth)^2]
       Default: 271.
       </entry>

<entry id="frierson_Tdlt" type="real" category="frierson"
       group="frierson_nl" valid_values="" >
       Tsrf Initial Condition: Equator-Pole SST difference (K).
       The ocean temperatures are initailized with the values:
        T_s = Tmin + Tdlt*exp[-0.5*(Lat/Twidth)^2]
       Default: 39.
       </entry>

<entry id="frierson_Twidth" type="real" category="frierson"
       group="frierson_nl" valid_values="" >
       Tsrf Initial Condition: Latitudinal width parameter for sst (degrees latitude)
       The ocean temperatures are initailized with the values:
        T_s = Tmin + Tdlt*exp[-0.5*(Lat/Twidth)^2]
       Default: 26.
       </entry>

<!-- Nudging Parameters -->

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

        FORCING:
        --------
        Nudging tendencies are applied as a relaxation force between the current
        model state values and target state values derived from the avalilable
        analyses. The form of the target values is selected by the 'Nudge_Force_Opt'
        option, the timescale of the forcing is determined from the given
        'Nudge_TimeScale_Opt', and the nudging strength Alpha=[0.,1.] for each
        variable is specified by the 'Nudge_Xcoef' values. Where X={U,V,T,Q,PS}

               F_nudge = Alpha*((Target-Model(t_curr))/TimeScale

        WINDOWING:
        ----------
        The region of applied nudging can be limited using Horizontal/Vertical
        window functions that are constructed using a parameterization of the
        Heaviside step function.

        The Heaviside window function is the product of separate horizonal and vertical
        windows that are controled via 12 parameters:

            Nudge_Hwin_lat0:     Specify the horizontal center of the window in degrees.
            Nudge_Hwin_lon0:     The longitude must be in the range [0,360] and the
                                 latitude should be [-90,+90].
            Nudge_Hwin_latWidth: Specify the lat and lon widths of the window as positive
            Nudge_Hwin_lonWidth: values in degrees.Setting a width to a large value (e.g. 999)
                                 renders the window a constant in that direction.
            Nudge_Hwin_latDelta: Controls the sharpness of the window transition with a
            Nudge_Hwin_lonDelta: length in degrees. Small non-zero values yeild a step
                                 function while a large value yeilds a smoother transition.
            Nudge_Hwin_Invert  : A logical flag used to invert the horizontal window function
                                 to get its compliment.(e.g. to nudge outside a given window).

            Nudge_Vwin_Lindex:   In the vertical, the window is specified in terms of model
            Nudge_Vwin_Ldelta:   level indcies. The High and Low transition levels should
            Nudge_Vwin_Hindex:   range from [0,(NLEV+1)]. The transition lengths are also
            Nudge_Vwin_Hdelta:   specified in terms of model indices. For a window function
                                 constant in the vertical, the Low index should be set to 0,
                                 the High index should be set to (NLEV+1), and the transition
                                 lengths should be set to 0.001
            Nudge_Vwin_Invert  : A logical flag used to invert the vertical window function
                                 to get its compliment.
       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.
        (e.g. '/$DIN_LOC_ROOT/atm/cam/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.
        (e.g. '%y/ERAI_ne30np4_L30.cam2.i.%y-%m-%d-%s.nc')
       Default: none
       </entry>

<entry id="Nudge_Times_Per_Day" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Number of analyses files per day.
        (e.g. 4 --> 6 hourly analyses)
       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.
        (e.g. 48 --> 1800 Second timestep)
       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_Force_Opt" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Select the form of nudging forcing, where (t'==Analysis times ; t==Model Times)
         0 -> NEXT-OBS: Target=Anal(t'_next)
         1 -> LINEAR:   Target=(F*Anal(t'_curr) +(1-F)*Anal(t'_next))
                            F =(t'_next - t_curr )/Tdlt_Anal
       Default: 0
       </entry>

<entry id="Nudge_TimeScale_Opt" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Select the timescale of nudging force, where (t'==Analysis times ; t==Model Times)
         0 -->  TimeScale = 1/Tdlt_Anal
         1 -->  TimeScale = 1/(t'_next - t_curr )
       Default: 0
       </entry>

<entry id="Nudge_Uprof" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Profile index for U nudging.
         0 == OFF      (No Nudging of this variable)
         1 == CONSTANT (Spatially Uniform Nudging)
         2 == HEAVISIDE WINDOW FUNCTION
       Default: 0
       </entry>

<entry id="Nudge_Ucoef" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Normalized Coeffcient for U nudging.
         [0.,1.] fraction of nudging tendency applied.
       Default: 0.
       </entry>

<entry id="Nudge_Vprof" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Profile index for V nudging.
         0 == OFF      (No Nudging of this variable)
         1 == CONSTANT (Spatially Uniform Nudging)
         2 == HEAVISIDE WINDOW FUNCTION
       Default: 0
       </entry>

<entry id="Nudge_Vcoef" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Normalized Coeffcient for V nudging.
         [0.,1.] fraction of nudging tendency applied.
       Default: 0.
       </entry>

<entry id="Nudge_Tprof" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Profile index for T nudging.
         0 == OFF      (No Nudging of this variable)
         1 == CONSTANT (Spatially Uniform Nudging)
         2 == HEAVISIDE WINDOW FUNCTION
       Default: 0
       </entry>

<entry id="Nudge_Tcoef" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Normalized Coeffcient for T nudging.
         [0.,1.] fraction of nudging tendency applied.
       Default: 0.
       </entry>

<entry id="Nudge_Qprof" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Profile index for Q nudging.
         0 == OFF      (No Nudging of this variable)
         1 == CONSTANT (Spatially Uniform Nudging)
         2 == HEAVISIDE WINDOW FUNCTION
       Default: 0
       </entry>

<entry id="Nudge_Qcoef" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Normalized Coeffcient for Q nudging.
         [0.,1.] fraction of nudging tendency applied.
       Default: 0.
       </entry>

<entry id="Nudge_PSprof" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Profile index for PS nudging.
         0 == OFF      (No Nudging of this variable)
         1 == CONSTANT (Spatially Uniform Nudging)
         2 == HEAVISIDE WINDOW FUNCTION
       Default: 0
       </entry>

<entry id="Nudge_PScoef" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Normalized Coeffcient for PS nudging.
         [0.,1.] fraction of nudging tendency applied.
       Default: 0.
       </entry>

<entry id="Nudge_Hwin_lat0" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       LAT0 center of Horizontal Window in degrees [-90.,90.].
       Default: none
       </entry>

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

<entry id="Nudge_Hwin_latDelta" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Width of transition which controls the steepness of window transition in latitude.
        0. --> Step function
       Default: none
       </entry>

<entry id="Nudge_Hwin_lon0" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       LON0 center of Horizontal Window in degrees [0.,360.].
       Default: none
       </entry>

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

<entry id="Nudge_Hwin_lonDelta" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Width of transition which controls the steepness of window transition in longitude.
        0. --> Step function
       Default: none
       </entry>

<entry id="Nudge_Hwin_Invert" type="logical" category="nudging"
       group="nudging_nl" valid_values="" >
       Invert Horizontal Window Function to its Compliment.
         TRUE  = value=0 inside the specified window, 1 outside
         FALSE = value=1 inside the specified window, 0 outside
       Default: FALSE
       </entry>

<entry id="Nudge_Vwin_Hindex" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       HIGH Level Index for Verical Window specified in terms of model level indices.
         (e.g. For a 30 level model, Nudge_Vwin_Hindex ~ 30 )
       Default: none
       </entry>

<entry id="Nudge_Vwin_Hdelta" type="real" category="nudging"
       group="nudging_nl" valid_values="" >
       Width of transition for 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 specified in terms of model level indices.
         (e.g. Nudge_Vwin_Lindex ~ 0 )
       Default: none
       </entry>

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

<entry id="Nudge_Vwin_Invert" type="logical" category="nudging"
       group="nudging_nl" valid_values="" >
       Invert Vertical Window Function to its Compliment.
         TRUE  = value=0 inside the specified window, 1 outside
         FALSE = value=1 inside the specified window, 0 outside
       Default: FALSE
       </entry>

<entry id="Nudge_ZonalFilter" type="logical" category="nudging"
       group="nudging_nl" valid_values="" >
       Switch to turn on zonal mean filtering nudging.  If TRUE, the nudging scheme
       filters 3D model and the 3D input target data to zonal mean values, and then
       applies nudging to the differences.
       Default: FALSE
       </entry>

<entry id="Nudge_ZonalNbasis" type="integer" category="nudging"
       group="nudging_nl" valid_values="" >
       Number of zonal mean basis functions (number of m=0 spherical harmonics) used in
       zonal mean filtering nudging.
       Default: none
       </entry>

<!-- Physics grid decomp including physics dynamics coupling methods -->

<entry id="phys_alltoall" type="integer"  category="perf_dp_coup"
       group="phys_grid_nl" valid_values="-1,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 (if max_nproc_smpx and nproc_busy_d are both &gt; npes/2).
Default: -1
</entry>

<entry id="phys_chnk_per_thd" type="integer"  category="perf_dp_coup"
       group="phys_grid_nl" 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="phys_grid_nl" 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: 2
</entry>

<entry id="phys_twin_algorithm" type="integer"  category="perf_dp_coup"
       group="phys_grid_nl" 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'
</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.

Default: .false.,  unless it is overridden (WACCM with interactive chemistry and a few other specific
          configurations do this)
</entry>

<entry id="ctem_diags_numlats" type="integer"  category="diagnostics"
       group="ctem_diags_nl" valid_values="" >
Number of latitude grid points for zonal average Transformed Eulerian Mean (TEM)
diagnostics history fields.  Values greater than zero turn on the TEM diagostics.
Default: 0
</entry>

<entry id="phys_grid_ctem_zm_nbas" type="integer"  category="diagnostics"
       group="phys_grid_ctem_opts" valid_values="" >
Number of zonal mean basis functions (number of m=0 spherical harmonics) used in
Transformed Eulerian Mean (TEM) diagnostics
</entry>

<entry id="phys_grid_ctem_za_nlat" type="integer"  category="diagnostics"
       group="phys_grid_ctem_opts" valid_values="" >
Number of latitude grid points for zonal average TEM diagnostics history fields
</entry>

<entry id="phys_grid_ctem_nfreq" type="integer"  category="diagnostics"
       group="phys_grid_ctem_opts" valid_values="" >
  Frequency of TEM diagnostics calucation.
  If &gt; 0, frequency is specified as number of timesteps.
  If &lt; 0, frequency is specified as number of hours.
</entry>

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

<entry id="print_qneg_warn" type="char*8"  category="diagnostics"
       group="qneg_nl" valid_values="summary,timestep,off" >
Control the writing of qneg3 and qneg4 warning messages.
'summary' causes a summary of QNEG3 and QNEG4 errors to be
    printed at the end of the run
'timestep' causes a summary of QNEG3 and QNEG4 errors to be printed at the
    end of each timestep. The total is reset at the end of each timestep.
'off' causes the qneg3 and qneg4 warnings to be supressed.
Note that these settings do not affect the availability of qneg
    history variables.
Default: 'summary'
</entry>

<!-- Dry Convective Adjustment -->

<entry id="dadadj_nlvdry" type="integer"  category="dry_conv_adj"
       group="dadadj_nl" 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>

<entry id="dadadj_niter" type="integer"  category="dry_conv_adj"
       group="dadadj_nl" valid_values="" >
The maximum number of iterations to achieve convergence in dry adiabatic adjustment.
For WACCM-X it can be advantageous to use a number which is much higher than the CAM
default.
Default: 15
</entry>

<!-- Dynamics: Finite Volume -->

<entry id="fv_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="fv_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="fv_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="fv_iord" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Order (mode) of X interpolation (1,..,6).
East-West transport scheme.
   = 1: first order upwind
   = 2: 2nd order van Leer (Lin et al 1994)
   = 3: standard PPM
   = 4: enhanced PPM (default)
Default: 4
</entry>

<entry id="fv_jord" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Order (mode) of Y interpolation (1,..,6).
North-South transport scheme.
   = 1: first order upwind
   = 2: 2nd order van Leer (Lin et al 1994)
   = 3: standard PPM
   = 4: enhanced PPM (default)
Default: 4
</entry>

<entry id="fv_kord" type="integer"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Scheme to be used for vertical mapping.
   = 1: first order upwind
   = 2: 2nd order van Leer (Lin et al 1994)
   = 3: standard PPM
   = 4: enhanced PPM (default)
Default: 4
</entry>

<entry id="fv_conserve" type="logical"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Flag indicating whether the dynamics uses internal algorithm for energy
conservation.
Default: .false.
</entry>

<entry id="fv_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="fv_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.
Default: set by build-namelist
</entry>

<entry id="fv_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="fv_del2coef" type="real"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Chooses level of velocity diffusion.
Default: 3.0e5
</entry>

<entry id="fv_high_order_top" type="logical"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Flag to extend standard 4th-order PPM scheme to model top.
Default: .false.
</entry>

<entry id="fv_am_geom_crrct" type="logical"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Flag to turn on corrections in FV geometry and/or pressure terms.
Default: .false.
</entry>

<entry id="fv_am_correction" type="logical"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Flag to turn on corrections that improve angular momentum conservation.
Default: .false.
</entry>

<entry id="fv_am_fixer" type="logical"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Flag to apply an arbitrary fix based on solid-body rotation to the zonal
velocity fields to improve conservation of angular momentum.
Default: .false.
</entry>

<entry id="fv_am_fix_lbl" type="logical"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Flag to apply the fixer turned on by fv_am_fixer level by level.  The
intent is to not contaminate the stratospheric circulation with
tropospheric AM loss, where it is most likely greatest (due to the larger
divergence fields).  This option is experimental.
Default: .false.
</entry>

<entry id="fv_am_diag" type="logical"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Flag to turn on a diagnostic calculation of angular momentum which is
written to the log file at each time step.  Also enables calculation of
fields written to history file which are used in conjuction with those
enabled by do_circulation_diags for detailed analysis.
Default: .false.
</entry>

<entry id="fv_high_altitude" type="logical"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="" >
Switch to apply variable physics appropriate for the thermosphere and ionosphere
Default: set by build-namelist
</entry>

<entry id="fv_print_dpcoup_warn" type="char*8"  category="dyn_fv"
       group="dyn_fv_inparm" valid_values="off,full" >
Flag to determine how to handle dpcoup warning messages
Default: off
</entry>

<!-- MPI configuration for FV dycore -->

<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="0,1,2" >
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="0,1,2" >
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="0,1,2" >
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: 1
</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: 64
</entry>

<entry id="modc_sw_scatter" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="0,1,2" >
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: .false.
</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="1,2" >
One or two simultaneous mod_comm irregular communications (excl. tracers)
Default: 2
</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: 3
</entry>

<entry id="modcomm_gatscat" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="0,1" >
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="spmd_fv_inparm" valid_values="0,1" >
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="spmd_fv_inparm" valid_values="0,1" >
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="fv_ct_overlap" type="integer"  category="dyn_fv"
       group="spmd_fv_inparm" valid_values="" >
Overlapping of trac2d and cd_core subcycles.
Default: 0
</entry>

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

<entry id="print_filew_warn" type="char*8"  category="dyn_fv"
       group="fill_nl" valid_values="off,full" >
Control the writing of filew warning messages.
Default: 'off'
</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: 60.
</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: 50.
</entry>

<entry id="met_rlx_bot_top" type="real"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
(km) top of ramping relaxation region for metdata at model bottom
Default: 0.
</entry>

<entry id="met_rlx_bot_bot" type="real"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
(km) bottom of ramping relaxation region for metdata at model bottom
Default: 0.
</entry>

<entry id="met_rlx_time" type="real"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
Relaxation time (hours) applied to specified meteorology.
 - positive values less then time step size gives 100% nudging
 - negative values gives 0.0% nudging (infinite relaxation time)
Default: 0.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: 'SHFLX'
</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: 'QFLX'
</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>

<entry id="met_srf_land" type="logical"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
If true nudge meteorology surface fields over the land. If false, then fields are
still nudged over the ocean.
Default: true
</entry>

<entry id="met_srf_land_scale" type="logical"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
If met_srf_land is false, then determines whether to nudge proportional to the non-land
fraction (i.e. 1 - land fraction) (true), or to nudge everywhere except where land
fraction is 1 (false).
Default: false
</entry>

<entry id="met_srf_rad" type="logical"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
If true nudge meteorology surface fields from radiation. These include ASDIR, ASDIF,
ALDIR, ALDIF, and LWUP.
Default: false
</entry>

<entry id="met_srf_refs" type="logical"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
If true nudge meteorology reference surface fields. These include TSREF, QREF, and U10.
Default: false
</entry>

<entry id="met_srf_sst" type="logical"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
If true nudge meteorology reference for sea surface temperature and sea ice fraction
(SST and SEAICEFRAC).
Default: false
</entry>

<entry id="met_srf_tau" type="logical"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
If true nudge surface sheer stress (TAUX, TAUY) from the meteorology.
Default: true
</entry>

<entry id="met_nudge_temp" type="logical"  category="dyn_fv_off"
       group="metdata_nl" valid_values="" >
If true nudge atmospheric temperature (T) from the meteorology.
Default: true
</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_front_igw" type="logical" category="gw_drag"
       group="phys_ctl_nl" valid_values="" >
Whether or not to enable inertial gravity waves produced by frontogenesis.
Default: set by build-namelist.
</entry>

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

<entry id="use_gw_convect_sh" type="logical" category="gw_drag"
       group="phys_ctl_nl" valid_values="" >
Whether or not to enable gravity waves produced by shallow convection.
Default: .false.
</entry>

<entry id="use_gw_movmtn_pbl" type="logical" category="gw_drag"
       group="phys_ctl_nl" valid_values="" >
Whether or not to enable gravity waves from PBL moving mountains source.
Default: .false.
</entry>

<entry id="use_gw_rdg_resid" type="logical" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Whether or not to enable gravity waves from residual (non-ridge)
orography
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="pgwv_long" type="integer" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Dimension for long wavelength gravity wave spectrum (wave numbers are from
-pgwv_long to pgwv_long).
Default: set by build-namelist.
</entry>

<entry id="gw_dc_long" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Width of speed bins (delta c) for long wavelength gravity wave spectrum
(reference wave speeds are from -pgwv_long*dc_long to pgwv_long*dc_long).
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_apply_tndmax" type="logical" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Apply limiter on maximum wind tendency from stress divergence in gravity wave drag scheme.
Default: set by build-namelist
</entry>

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

<entry id="effgw_beres_sh" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Efficiency associated with convective gravity waves from the Beres
scheme (shallow convection).
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_cm_igw" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Efficiency associated with inertial 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="use_gw_rdg_beta" type="logical" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Whether or not to enable gravity waves produced by meso-Beta Ridges.
Default: set by build-namelist
</entry>

<entry id="n_rdg_beta" type="integer" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Number of meso-Beta ridges (per gridbox) to invoke.
Default: 10 (set by build-namelist)
</entry>

<entry id="effgw_rdg_beta" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Efficiency scaling factor associated with anisotropic OGW.
Default: set by build-namelist.
</entry>

<entry id="effgw_rdg_beta_max" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Max efficiency associated with anisotropic OGW.
Default: 1.0
</entry>

<entry id="effgw_rdg_resid" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Efficiency scaling factor associated with residual non-ridge topo
Default: set by build-namelist.
</entry>

<entry id="effgw_movmtn_pbl" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Efficiency scaling factor for moving mountain source
Default: set by build-namelist.
</entry>

<entry id="movmtn_psteer" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Global steering level (Pa) for moving mtns. If negative steering level, it will be provided by future code
Default: set by build-namelist.
</entry>

<entry id="movmtn_plaunch" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Global launch level (Pa) for moving mtns. If negative launch level, it will be provided by future code
Default: set by build-namelist.
</entry>

<entry id="movmtn_source" type="integer" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Integer code for movmtn source: 1=vorticity, 2=upwp
Default: set by build-namelist.
</entry>

<entry id="rdg_beta_cd_llb" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Drag coefficient for obstacles in low-level flow.
Default: 1.0
</entry>

<entry id="trpd_leewv_rdg_beta" type="logical" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Whether or not to allow trapping for meso-Beta Ridges.
Default: FALSE (set by build-namelist)
</entry>

<entry id="use_gw_rdg_gamma" type="logical" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Whether or not to enable gravity waves produced by meso-gamma Ridges.
Default: FALSE (set by build-namelist)
</entry>

<entry id="n_rdg_gamma" type="integer" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Number of meso-gamma ridges (per gridbox) to invoke.
Default: -1 (set by build-namelist)
</entry>

<entry id="effgw_rdg_gamma" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Efficiency scaling factor associated with anisotropic OGW.
Default: set by build-namelist.
</entry>

<entry id="effgw_rdg_gamma_max" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Max efficiency associated with anisotropic OGW.
Default: 1.0
</entry>

<entry id="rdg_gamma_cd_llb" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Drag coefficient for obstacles in low-level flow.
Default: 1.0
</entry>

<entry id="trpd_leewv_rdg_gamma" type="logical" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Whether or not to allow trapping for meso-gamma Ridges.
Default: set by build-namelist
</entry>

<entry id="bnd_rdggm" type="char*256" input_pathname="abs" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Full pathname of boundary dataset for meso-gamma ridges.
Default: set by build-namelist.
</entry>

<entry id="gw_oro_south_fac" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Factor to multiply tau by, for orographic waves in the southern hemisphere.
Default: 1._r8
</entry>

<entry id="gw_prndl" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Inverse Prandtl number used in gravity wave diffusion
Default: set by build-namelist
</entry>

<entry id="gw_qbo_hdepth_scaling" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Scaling factor for heating depth in gravity waves from convection.  If less than 1.0
this acts as an effective reduction of the gravity wave phase speeds needed to drive
the QBO.
Default: set by build-namelist
</entry>

<entry id="gw_lndscl_sgh" type="logical" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Scale SGH by land fraction in gravity wave drag
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="front_gaussian_width" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Width of gaussian used to create frontogenesis tau profile [m/s].
Default: set by build-namelist.
</entry>

<entry id="alpha_gw_movmtn" type="real" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Tunable parameter controlling proportion of boundary layer momentum flux escaping as GW momentum flux
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 sourced
from deep convection.
Default: set by build-namelist.
</entry>

<entry id="gw_drag_file_sh" 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 sourced
from shallow convection.
Default: set by build-namelist.
</entry>

<entry id="gw_drag_file_mm" type="char*256" input_pathname="abs" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Relative pathname of lookup table for deep convective moving mountain GW source
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>

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

<entry id="gw_polar_taper" type="logical" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Whether or not to use tapering at the poles to reduce the effects of
mid-scale gravity waves from frontogenesis.
Default: set by build-namelist.
</entry>

<entry id="gw_top_taper" type="logical" category="gw_drag"
       group="gw_drag_nl" valid_values="" >
Whether or not to apply tapering at the top of the model (above 0.6E-02 Pa)
to reduce undesired effects of gravity waves in the thermosphere/ionosphere.
Default: set by build-namelist
</entry>

<!-- Gravity Wave Ridge -->

<entry id="gw_rdg_do_divstream" type="logical" category="gw_rdg"
       group="gw_rdg_nl" valid_values="" >
If .true. use separate dividing streamlines for downslope wind and flow
splitting regimes ("DS" configuration).
If .false. use single dividing streamline as in Scinocca &amp; McFarlane
2000 ("SM" configuration).
Default: set by build-namelist.
</entry>

<entry id="gw_rdg_do_smooth_regimes" type="logical" category="gw_rdg"
       group="gw_rdg_nl" valid_values="" >
If true, then use smooth regimes
Default: set by build-namelist.
</entry>

<entry id="gw_rdg_do_adjust_tauoro" type="logical" category="gw_rdg"
       group="gw_rdg_nl" valid_values="" >
If true, then adjust tauoro
Default: set by build-namelist.
</entry>

<entry id="gw_rdg_do_backward_compat" type="logical" category="gw_rdg"
       group="gw_rdg_nl" valid_values="" >
If true, then adjust for bit-for-bit answers with the ("N5") configuration
Default: set by build-namelist.
</entry>

<entry id="gw_rdg_C_BetaMax_DS" type="real"  category="gw_rdg"
       group="gw_rdg_nl" valid_values="" >
Enhancement factor for downslope wind stress in DS configuration.
Default: set by build-namelist.
</entry>

<entry id="gw_rdg_C_GammaMax" type="real"  category="gw_rdg"
       group="gw_rdg_nl" valid_values="" >
Enhancement factor for depth of downslope wind regime in DS configuration
Default: set by build-namelist.
</entry>

<entry id="gw_rdg_Frx0" type="real"  category="gw_rdg"
       group="gw_rdg_nl" valid_values="" >
Lower inverse Froude number limits on linear ramp terminating downslope wind regime for high mountains in DS configuration
Default: set by build-namelist.
</entry>

<entry id="gw_rdg_Frx1" type="real"  category="gw_rdg"
       group="gw_rdg_nl" valid_values="" >
Upper inverse Froude number limits on linear ramp terminating downslope wind regime for high mountains in DS configuration
Default: set by build-namelist.
</entry>

<entry id="gw_rdg_C_BetaMax_SM" type="real"  category="gw_rdg"
       group="gw_rdg_nl" valid_values="" >
Enhancement factor for downslope wind stress in SM configuration.
Default: set by build-namelist.
</entry>

<entry id="gw_rdg_Fr_c" type="real"  category="gw_rdg"
       group="gw_rdg_nl" valid_values="" >
Critical inverse Froude number
Default: set by build-namelist.
</entry>

<entry id="gw_rdg_orohmin" type="real"  category="gw_rdg"
       group="gw_rdg_nl" valid_values="" >
minimum surface displacement height for orographic waves (m)
Default: set by build-namelist.
</entry>

<entry id="gw_rdg_orovmin" type="real"  category="gw_rdg"
       group="gw_rdg_nl" valid_values="" >
Minimum wind speed for orographic waves
Default: set by build-namelist.
</entry>

<entry id="gw_rdg_orostratmin" type="real"  category="gw_rdg"
       group="gw_rdg_nl" valid_values="" >
Minimum stratification allowing wave behavior
Default: set by build-namelist.
</entry>

<entry id="gw_rdg_orom2min" type="real"  category="gw_rdg"
       group="gw_rdg_nl" valid_values="" >
Minimum stratification allowing wave behavior
Default: set by build-namelist.
</entry>

<entry id="gw_rdg_do_vdiff" type="logical"  category="gw_rdg"
       group="gw_rdg_nl" valid_values="" >
If TRUE gravity wave ridge scheme will contribute to vertical diffusion tendencies.
Default: TRUE
</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
{{ hilight }}co2vmr{{ closehilight }} or the {{ hilight }}scenario_ghg{{ closehilight }} 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: set by build-namelist
</entry>

<entry id="ghg_yearstart_data" type="integer"  category="ghg_cam"
       group="chem_surfvals_nl" valid_values="" >
Data start year.  Use in conjunction
with {{ hilight }}ghg_yearstart_model{{ closehilight }}.
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 {{ hilight }}ghg_yearstart_data{{ closehilight }}.
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 {{ hilight }}scenario_ghg{{ closehilight }} = '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 {{ hilight }}scenario_ghg{{ closehilight }} = 'RAMP_CO2_ONLY'
Default: boundless if {{ hilight }}ramp_co2_annual_rate{{ closehilight }} &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 {{ hilight }}scenario_ghg{{ closehilight }} = 'RAMP_CO2_ONLY'
Default: 0
</entry>

<entry id="rampyear_ghg" type="integer"  category="ghg_cam"
       group="chem_surfvals_nl" valid_values="" >
If {{ hilight }}scenario_ghg{{ closehilight }} is set to "RAMPED" then the greenhouse
gas surface values are interpolated between the annual average values
read from the file specified by {{ hilight }}bndtvghg{{ closehilight }}.
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 {{ hilight }}bndtvghg{{ closehilight }}.
RAMP_CO2_ONLY =&gt; only co2 mixing ratios are ramped at a rate determined by
                    the variables {{ hilight }}ramp_co2_annual_rate{{ closehilight }}, {{ hilight }}ramp_co2_cap{{ closehilight }},
                    and {{ hilight }}ramp_co2_start_ymd{{ closehilight }}.
CHEM_LBC_FILE =&gt; volume mixing ratios are set from the chemistry lower boundary
                    conditions dataset specified by {{ hilight }}flbc_file{{ closehilight }}.
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: set by build-namelist
</entry>

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

<entry id="co2_readflux_ocn" type="logical"  category="co2_cycle"
       group="co2_cycle_nl" valid_values="" >
If TRUE read co2 ocn flux from file.
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>

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

<entry id="avgflag_pertape" type="char*1(10)"  category="history"
       group="cam_history_nl" valid_values="A,B,I,X,M,N,L,S" >
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
 N ==&gt; average over nsteps
 X ==&gt; Maximum
 L ==&gt; Local-time
 S ==&gt; Standard deviation

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 {{ hilight }}fincl#{{ closehilight }} namelist items.
Default: FALSE
</entry>

<entry id="write_nstep0" type="logical"  category="history"
       group="cam_history_nl" valid_values="" >
If true then write the nstep==0 time sample to all history files except
the monthly average file.  This output is primarily useful for development
and debugging as it captures changes to the model state made during the
initialization phase of the run.
Default: FALSE
</entry>

<entry id="fexcl1" type="char*24(1000)"  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(1000)"  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(1000)"  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(1000)"  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(1000)"  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(1000)"  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(1000)"  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(1000)"  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(1000)"  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(1000)"  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="fincl1" type="char*26(1000)"  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
 N ==&gt; average over nsteps
 X ==&gt; Maximum
 L ==&gt; Local-time
 S ==&gt; Standard deviation

Default:  set in code via the addfld and add_default subroutine calls.
</entry>
<entry id="fincl2" type="char*26(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1{{ closehilight }}, 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(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1{{ closehilight }}, 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(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1{{ closehilight }}, 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(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1{{ closehilight }}, 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(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1{{ closehilight }}, 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(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1{{ closehilight }}, 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(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1{{ closehilight }}, 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(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1{{ closehilight }}, 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(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1{{ closehilight }}, but for the 10th history file (by default
the name of this file contains the string "h9").
Default: none.
</entry>

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

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

<entry id="clubb_vars_zt" type="char*35(10000)"  category="history"
       group="clubb_stats_nl" valid_values="" >
Same as {{ hilight }}fincl1{{ closehilight }}, but for CLUBB statistics on zt grid.
</entry>

<entry id="clubb_vars_zm" type="char*35(10000)"  category="history"
       group="clubb_stats_nl" valid_values="" >
Same as {{ hilight }}fincl1{{ closehilight }}, but for CLUBB statistics on zm grid.
</entry>

<entry id="clubb_vars_rad_zt" type="char*35(10000)"  category="history"
       group="clubb_stats_nl" valid_values="" >
Same as {{ hilight }}fincl1{{ closehilight }}, but for CLUBB statistics on radiation zt grid.
</entry>

<entry id="clubb_vars_rad_zm" type="char*35(10000)"  category="history"
       group="clubb_stats_nl" valid_values="" >
Same as {{ hilight }}fincl1{{ closehilight }}, but for CLUBB statistics on radiation zm grid.
</entry>

<entry id="clubb_vars_sfc" type="char*35(10000)"  category="history"
       group="clubb_stats_nl" valid_values="" >
Same as {{ hilight }}fincl1{{ closehilight }}, but for CLUBB statistics on surface.
</entry>

<entry id="collect_column_output" type="logical(10)" 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(1000)"  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.
</entry>
<entry id="fincl2lonlat" type="char*128(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1lonlat{{ closehilight }}, but for 2nd history file.
</entry>
<entry id="fincl3lonlat" type="char*128(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1lonlat{{ closehilight }}, but for 3rd history file.
</entry>
<entry id="fincl4lonlat" type="char*128(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1lonlat{{ closehilight }}, but for 4th history file.
</entry>
<entry id="fincl5lonlat" type="char*128(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1lonlat{{ closehilight }}, but for 5th history file.
</entry>
<entry id="fincl6lonlat" type="char*128(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1lonlat{{ closehilight }}, but for 6th history file.
</entry>
<entry id="fincl7lonlat" type="char*128(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1lonlat{{ closehilight }}, but for 7th history file.
</entry>
<entry id="fincl8lonlat" type="char*128(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1lonlat{{ closehilight }}, but for 8th history file.
</entry>
<entry id="fincl9lonlat" type="char*128(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1lonlat{{ closehilight }}, but for 9th history file.
</entry>
<entry id="fincl10lonlat" type="char*128(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Same as {{ hilight }}fincl1lonlat{{ closehilight }}, but for 10th history file.
</entry>

<entry id="fwrtpr1" type="char*26(1000)"  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(1000)"  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(1000)"  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(1000)"  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(1000)"  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(1000)"  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="fwrtpr7" type="char*26(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Specific fields which will be written using the non-default precision on
the 7th history file.
Default: none
</entry>
<entry id="fwrtpr8" type="char*26(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Specific fields which will be written using the non-default precision on
the 8th history file.
Default: none
</entry>
<entry id="fwrtpr9" type="char*26(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Specific fields which will be written using the non-default precision on
the 9th history file.
Default: none
</entry>
<entry id="fwrtpr10" type="char*26(1000)"  category="history"
       group="cam_history_nl" valid_values="" >
Specific fields which will be written using the non-default precision on
the 10th history file.
Default: none
</entry>

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

Array of history filename specifiers.  The filenames of up to six 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-5), 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-5); %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 {{ hilight }}case_name{{ closehilight }}.

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 6 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 {{ hilight }}hfilename_spec{{ closehilight }}
Default:  "%c.cam2.sat.%y-%m-%d-%s.nc"
</entry>
<entry id="sathist_fincl" type="char*26(1000)"  category="history"
       group="satellite_options_nl" valid_values="" >
List of history fields to output along the satellite track specified by  {{ hilight }}sathist_track_infile{{ closehilight }}
Default: none
</entry>
<entry id="sathist_mfilt" type="integer"  category="history"
       group="satellite_options_nl" valid_values="" >
Sets the maximum number of observation columns written to 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,6-HOURLY,DAILY,MONTHLY,YEARLY,CAMIOP,ENDOFRUN" >
Frequency that initial files will be output: 6-hourly, daily, monthly,
yearly, or never.  Valid values: 'NONE', '6-HOURLY', 'DAILY', 'MONTHLY',
'YEARLY', 'CAMIOP', 'ENDOFRUN'.
Default: 'YEARLY'
</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(10)"  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 tenth to the auxillary history files.
Default: 1,30,30,30,30,30,30,30,30,30
</entry>

<entry id="lcltod_start" type="integer(10)"  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(10)"  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(10)"  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(10)"  category="history"
       group="cam_history_nl" valid_values="" >

Array of write frequencies for each history file series.
If {{ hilight }}nhtfrq(i){{ closehilight }} = 0, the file will be a monthly average.
If {{ hilight }}nhtfrq(i){{ closehilight }} &gt; 0, frequency is specified as number of
timesteps.  If {{ hilight }}nhtfrq(i){{ closehilight }} &lt; 0, frequency is specified
as number of hours.

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

<entry id="interpolate_output" type="logical(10)" 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(10)" 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(10)" 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(10)" 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(10)" 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_initfiles_nl" 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_initfiles_nl" 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="cam_branch_file" type="char*256" category="initial_conditions"
       group="cam_initfiles_nl" valid_values="">
Full pathname of master restart file from which to branch. Setting is
Required for branch run.
Default: none
</entry>

<entry id="scale_dry_air_mass" type="real" category="initial_conditions"
       group="cam_initfiles_nl" valid_values="">
Specify whether and how to perform dry surface pressure scaling. If less than or equal to 0.0,
do not perform scaling. If greater than 0.0, perform scaling to scale_dry_air_mass
value (in Pa) as the average dry surface pressure target.
Default: set by build-namelist.
</entry>

<entry id="readtrace" type="logical"  category="initial_conditions"
       group="constituents_nl" 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, CAM5, CAM6 and CAM7 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: FALSE
</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>

<entry id="cosp_lrttov_sim" type="logical"  category="cosp"
       group="cospsimulator_nl" valid_values="">
If true, RTTOV simulator will be run and output
will be saved according to the appropriate RTTOV
instrument namelist files in "rttov_instrument_namelists".

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>

<entry id="cosp_rttov_Ninstruments" type="integer"  category="cosp"
       group="cospsimulator_nl" valid_values="">
Number of RTTOV instruments to simulate.
This default logical is set in cospsimulator_intr.F90
Default: 0
</entry>
    
<entry id="cosp_rttov_instrument_namelists" type="char*256(50)"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
List of RTTOV instrument namelist files to read when running RTTOV in COSP.
File paths are read relative to the case run directory 
(e.g. /glade/derecho/scratch/$USER/$CASENAME/run/). Each namelist file
contains information specifying the simulated instrument, channels, and
outputs. Templates and instructions can be found in the COSP-RTTOV 
code repository.
Default: none
</entry>

<!-- Swathing input control parameters. -->
<entry id="cosp_N_SWATHS_ISCCP" type="integer*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Number of satellite sampling swaths used to mask COSP ISCCP data.
Default: none
</entry>

<entry id="cosp_N_SWATHS_MISR" type="integer*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Number of satellite sampling swaths used to mask COSP MISR data.
Default: none
</entry>

<entry id="cosp_N_SWATHS_MODIS" type="integer*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Number of satellite sampling swaths used to mask COSP MODIS data.
Default: none
</entry>

<entry id="cosp_N_SWATHS_CSCAL" type="integer*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Number of satellite sampling swaths used to mask COSP CloudSat-CALIPSO data.
Default: none
</entry>

<entry id="cosp_N_SWATHS_PARASOL" type="integer*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Number of satellite sampling swaths used to mask COSP PARASOL data.
Default: none
</entry>

<entry id="cosp_N_SWATHS_ATLID" type="integer*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Number of satellite sampling swaths used to mask COSP ATLID data.
Default: none
</entry>

<entry id="cosp_SWATH_LOCALTIMES_ISCCP" type="real*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Swath localtimes (hours) for masking COSP ISCCP data. The sampling 
"local time" refers to a linear shift from UTC as a function of a 
gridcell’s longitude (t_local = t_UTC − longitude * 24/360).
Default: none
</entry>

<entry id="cosp_SWATH_LOCALTIMES_MISR" type="real*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Swath localtimes (hours) for masking COSP MISR data. The sampling 
"local time" refers to a linear shift from UTC as a function of a 
gridcell’s longitude (t_local = t_UTC − longitude * 24/360).
Default: none
</entry>

<entry id="cosp_SWATH_LOCALTIMES_MODIS" type="real*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Swath localtimes (hours) for masking COSP MODIS data. The sampling 
"local time" refers to a linear shift from UTC as a function of a 
gridcell’s longitude (t_local = t_UTC − longitude * 24/360).
Default: none
</entry>

<entry id="cosp_SWATH_LOCALTIMES_CSCAL" type="real*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Swath localtimes (hours) for masking COSP CloudSat-CALIPSO data. The  
sampling "local time" refers to a linear shift from UTC as a function of a 
gridcell’s longitude (t_local = t_UTC − longitude * 24/360).
Default: none
</entry>

<entry id="cosp_SWATH_LOCALTIMES_PARASOL" type="real*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Swath localtimes (hours) for masking COSP PARASOL data. The sampling 
"local time" refers to a linear shift from UTC as a function of a 
gridcell’s longitude (t_local = t_UTC − longitude * 24/360).
Default: none
</entry>

<entry id="cosp_SWATH_LOCALTIMES_ATLID" type="real*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Swath localtimes (hours) for masking COSP ATLID data. The sampling 
"local time" refers to a linear shift from UTC as a function of a 
gridcell’s longitude (t_local = t_UTC − longitude * 24/360).
Default: none
</entry>

<entry id="cosp_SWATH_WIDTHS_ISCCP" type="real*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Swath widths (kilometers) for masking COSP ISCCP data. The "swath width"
determines the spatial region around each local time that is simulated. 
Supplying a swath width in units of distance rather than radians produces
a larger sampling density at higher latitudes that is consistent with
observations.
Default: none
</entry>

<entry id="cosp_SWATH_WIDTHS_MISR" type="real*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Swath widths (kilometers) for masking COSP MISR data. The "swath width"
determines the spatial region around each local time that is simulated. 
Supplying a swath width in units of distance rather than radians produces
a larger sampling density at higher latitudes that is consistent with
observations.
Default: none
</entry>

<entry id="cosp_SWATH_WIDTHS_MODIS" type="real*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Swath widths (kilometers) for masking COSP MODIS data. The "swath width"
determines the spatial region around each local time that is simulated. 
Supplying a swath width in units of distance rather than radians produces
a larger sampling density at higher latitudes that is consistent with
observations.
Default: none
</entry>

<entry id="cosp_SWATH_WIDTHS_CSCAL" type="real*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Swath widths (kilometers) for masking COSP CSCAL data. The "swath width"
determines the spatial region around each local time that is simulated. 
Supplying a swath width in units of distance rather than radians produces
a larger sampling density at higher latitudes that is consistent with
observations.
Default: none
</entry>

<entry id="cosp_SWATH_WIDTHS_PARASOL" type="real*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Swath widths (kilometers) for masking COSP PARASOL data. The "swath width"
determines the spatial region around each local time that is simulated. 
Supplying a swath width in units of distance rather than radians produces
a larger sampling density at higher latitudes that is consistent with
observations.
Default: none
</entry>

<entry id="cosp_SWATH_WIDTHS_ATLID" type="real*10"  category="cosp"
       group="cospsimulator_nl" valid_values="" >
Swath widths (kilometers) for masking COSP ATLID data. The "swath width"
determines the spatial region around each local time that is simulated. 
Supplying a swath width in units of distance rather than radians produces
a larger sampling density at higher latitudes that is consistent with
observations.
Default: none
</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: -1
</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="rk_strat_icritc" type="real" category="conv"
       group="rk_stratiform_nl" valid_values="" >
Threshold for autoconversion of cold ice in RK microphysics scheme.
Default: set by build-namelist
</entry>

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

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

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

<entry id="rk_strat_polstrat_rhmin" type="real" category="conv"
       group="rk_stratiform_nl" valid_values="" >
Relative humidity threshold for stratospheric cloud water condensation in RK microphysics
poleward of 50 degrees.
Default: none
</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., except for carma=cirrus and carma=carma_dust
</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., except for carma=cirrus and carma=carma_dust
</entry>

<!-- micro_mg -->

<entry id="micro_mg_version" type="integer" category="microphys"
       group="micro_mg_nl" valid_values="" >
Version number for MG microphysics.  This value is set automatically based
on settings in configure and passed to build-namelist
Default: 1 for CAM5, 2 for CAM6 and 3 for CAM7
</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_dcs" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Autoconversion size threshold
Default: set by build-namelist
</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., except for carma=cirrus and carma=carma_dust
</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_do_graupel" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Switch to control whether MG microphysics should prognose
dense precipitating ice as graupel. mg3 only.
Default: .true. for mg3
</entry>

<entry id="micro_mg_do_hail" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Switch to control whether MG microphysics should prognose
dense precipitating ice as hail. mg3 only.
Default: .false.
</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" >
Type of precipitation fraction.
Default: for CLUBB runs =&gt; in_cloud;
             all others =&gt; max_overlap
</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="micro_mg_accre_enhan_fact" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Unitless ratio to increase the accretion process in microphysics as a method of accounting for unrepresented subgridscale variability.
Default: 1
</entry>

<entry id="micro_mg_autocon_fact" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Unitless ratio to directly scale the autoconversion process in microphysics as a method of accounting for unrepresented subgridscale variability.
Default: 0.01
</entry>

<entry id="micro_mg_autocon_nd_exp" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Unitless exponent of cloud number condensation in the KK autoconversion parameterization equation. See Khairoutdinov and Kogan, 2002.
Default: -1.1
</entry>

<entry id="micro_mg_autocon_lwp_exp" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Unitless exponent of liquid water path in the KK autoconversion parameterization equation. See Khairoutdinov and Kogan, 2002.
Default: 2.47
</entry>

<entry id="micro_mg_homog_size" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Mean volume radius of droplets used in the process of homogeneously freezing below -40C in (m). Default value is currently the previously assumed 25 microns.
Default: 25.e-6 m
</entry>

<entry id="micro_mg_vtrmi_factor" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Unitless scaling factor for ice fall speed to account for sub-grid scale ice crystal shape variability.
Default: 1.0
</entry>

<entry id="micro_mg_vtrms_factor" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Unitless scaling factor for snow fall speed to account for sub-grid scale ice crystal shape variability.
Default: 1.0
</entry>

<entry id="micro_mg_effi_factor" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Unitless scaling factor for ice effective radius as seen by radiation. This scaling factor adjusts for sub-grid scale ice crystal shape variability.
Default: 1.0
</entry>

<entry id="micro_mg_iaccr_factor" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Ice accrete cloud droplet factor
Default: 1
</entry>

<entry id="micro_mg_max_nicons" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
Maximum allowed ice number concentration
Default: 1.0e8
</entry>

<entry id="micro_do_sb_physics" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Do Seifert and Behang (2001) autoconversion and accretion physics when set to true.
Default: .false.
</entry>

<entry id="micro_mg_warm_rain" type="char*16" category="microphys"
       group="micro_mg_nl" valid_values="kk2000,sb2001,tau,emulated" >
Warm rain process
sb2001 turns on alternative autoconversion and accretion scheme for liquid in microphysics (Seifert and Behang 2001)
kk2000 uses original autoconversion and accretion scheme for liquid in microphysics
tau replaces autoconversion and accretion with a faster emulator to generate machine learning training data
emulated turns on use of machine learning for warm rain
Default: set in namelist_defaults
</entry>

<entry id="stochastic_emulated_filename_quantile" type="char*256" input_pathname="abs" category="microphys"
       group="stochastic_emulated_nl" >
Neural net file for warm_rain machine learning
</entry>

<entry id="stochastic_emulated_filename_input_scale" type="char*256" input_pathname="abs" category="microphys"
       group="stochastic_emulated_nl" >
Neural net input scaling values file for warm_rain machine learning
</entry>

<entry id="stochastic_emulated_filename_output_scale" type="char*256" input_pathname="abs" category="microphys"
       group="stochastic_emulated_nl" >
Neural net output scaling values file for warm_rain machine learning
</entry>

<entry id="pumas_stochastic_tau_kernel_filename" type="char*256" input_pathname="abs" category="microphys"
       group="pumas_stochastic_tau_nl" >
Coefficients for the stochastic collection kernel used by the TAU stochastic collection code, invoked in PUMAS with micro_pumas_warm_rain = 'tau'
</entry>

<entry id="micro_do_massless_droplet_destroyer" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Do destruction of massless droplets
Default: .false.
</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. unless use_subcol_microp is true
</entry>

<entry id="micro_mg_adjust_cpt" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Switch to control whether MG microphysics should adjust the temperature
at the level containing the cold point tropopause by using the value
obtain by extrapolating between levels.
Default: set by build-namelist
</entry>

<entry id="micro_mg_nccons" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Set .true. to hold cloud droplet number constant.
Default: .false.
</entry>

<entry id="micro_mg_nicons" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Set .true. to hold cloud ice number constant.
Default: .false.
</entry>

<entry id="micro_mg_ngcons" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Set .true. to hold cloud graupel number constant.
Default: .false.
</entry>

<entry id="micro_mg_ncnst" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
In-cloud droplet number concentration when micro_mg_nccons=.true.
Default: 100.e6 m-3
</entry>

<entry id="micro_mg_ninst" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
In-cloud ice number concentration when micro_mg_nicons=.true.
Default: 0.1e6 m-3
</entry>

<entry id="micro_mg_ngnst" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
In-cloud graupel number concentration when micro_mg_nicons=.true.
Default: 0.0005e6 m-3
</entry>

<entry id="micro_mg_nrcons" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Set .true. to hold cloud rain number constant.
Default: .false.
</entry>

<entry id="micro_mg_nrnst" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
In-cloud rain number concentration when micro_mg_nrcons=.true.
Default: 0.2e6 m-3
</entry>

<entry id="micro_mg_nscons" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Set .true. to hold cloud snow number constant.
Default: .false.
</entry>

<entry id="micro_mg_nsnst" type="real" category="microphys"
       group="micro_mg_nl" valid_values="" >
In-cloud snow number concentration when micro_mg_nscons=.true.
Default: 0.005e6 m-3
</entry>

<entry id="micro_mg_evap_sed_off" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
If .true., sedimenting condensate does not evaporate
Default: .false.
</entry>

<entry id="micro_mg_icenuc_rh_off" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
If .true., remove RH threshold from ice nucelation calculation
Default: .false.
</entry>

<entry id="micro_mg_icenuc_use_meyers" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Hard code Meyers 1992 Temp dependent ice nucleation in microphysics
Default: .false.
</entry>

<entry id="micro_mg_evap_scl_ifs" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Apply 0.3 scaling factor to evaporation of precipitation as done in the
IFS model (https://www.ecmwf.int/en/forecasts/documentation-and-support)
Default: .false.
</entry>

<entry id="micro_mg_evap_rhthrsh_ifs" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Do not evaporate precipitation until RH &lt; 90% as done in the
IFS model (https://www.ecmwf.int/en/forecasts/documentation-and-support)
Default: .false.
</entry>

<entry id="micro_mg_rainfreeze_ifs" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
Freeze rain at 0C as done in the
IFS model (https://www.ecmwf.int/en/forecasts/documentation-and-support)
Default: .false.
</entry>

<entry id="micro_mg_ifs_sed" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
If .false., use the default sedimentation fall speed calculation from MG2 for all species. If .true., use constant sedimentation fall speeds for snow and ice, and no sedimentation of liquid, to be consistant with how species descend in the IFS model (https://www.ecmwf.int/en/forecasts/documentation-and-support)
Default: .false.
</entry>

<entry id="micro_mg_precip_fall_corr" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
If .true., ensure non-zero precipitation fallspeed (rain,snow and graupel) if precipitation exists above in column (from M2005 in WRFv3.3)
Default: .false.
</entry>

<entry id="micro_mg_implicit_fall" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
If .true., use implicit fall speed (sedimentation) routine for all hydrometeors. Improves numerical stability of precipitation
Default: .true.
</entry>

<entry id="micro_mg_accre_sees_auto" type="logical" category="microphys"
       group="micro_mg_nl" valid_values="" >
If true, then the autoconverted liquid is added to rain and removed from cloud before accretion is estimated.
Default: .true.
</entry>


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

<entry id="microp_aero_npccn_scale" type="real" category="microphys"
       group="microp_aero_nl" valid_values="" >
Unitless scaling factor for the activated number concentration of cloud condensation nuclei.
Default: 1.0
</entry>

<entry id="microp_aero_wsub_scale" type="real" category="microphys"
       group="microp_aero_nl" valid_values="" >
Unitless scaling factor for the liquid droplet subgrid scale vertical velocity during aerosol activation.
Default: set by build-namelist
</entry>

<entry id="microp_aero_wsubi_scale" type="real" category="microphys"
       group="microp_aero_nl" valid_values="" >
Unitless scaling factor for ice droplet subgrid scale vertical velocity during aerosol activation.
Default: 1.0
</entry>

<entry id="microp_aero_wsub_min" type="real" category="microphys"
       group="microp_aero_nl" valid_values="" >
Minimum subgrid vertical velocity (before scale factor) for liquid droplets during aerosol activation with units of (m s-1).
Default: set by build-namelist
</entry>

<entry id="microp_aero_wsub_min_asf" type="real" category="microphys"
       group="microp_aero_nl" valid_values="" >
Minimum subgrid vertical velocity (after scale factor) for liquid droplets during aerosol activation with units of (m s-1).
Default: set by build-namelist
</entry>

<entry id="microp_aero_wsubi_min" type="real" category="microphys"
       group="microp_aero_nl" valid_values="" >
Minimum subgrid vertical velocity for ice droplets during aerosol activation with units of (m s-1).
Default: 0.001 m s-1
</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="hetfrz_bc_scalfac" type="real" category="microphys"
       group="hetfrz_classnuc_nl" valid_values="" >
Heterogeneous freezing scaling factor for black carbon aerosols.
Default: 0.01
</entry>

<entry id="hetfrz_dust_scalfac" type="real" category="microphys"
       group="hetfrz_classnuc_nl" valid_values="" >
Heterogeneous freezing scaling factor for dust aerosols.
Default: 0.05
</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., except .true. for CAM6 and CAM7
</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="nucleate_ice_subgrid" type="real" category="microphys"
       group="nucleate_ice_nl" valid_values="" >
Subgrid scaling factor for relative humidity in ice nucleation code. If it has
a value of -1, then indicates that the subgrid scaling factor will be
calculated on the fly as 1 / qsatfac (i.e. the saturation scaling factor).
Default: set by build-namelist
</entry>

<entry id="nucleate_ice_subgrid_strat" type="real" category="microphys"
       group="nucleate_ice_nl" valid_values="" >
Subgrid scaling factor for relative humidity in ice nucleation code in the
stratosphere. If it has a value of -1, then indicates that the subgrid
scaling factor will be calculated on the fly as 1 / qsatfac (i.e. the
saturation scaling factor).
Default: set by build-namelist
</entry>

<entry id="nucleate_ice_incloud" type="logical" category="microphys"
       group="nucleate_ice_nl" valid_values="" >
Switch to determine whether ice nucleation happens using the incloud (true) or
the gridbox average (false) relative humidity.  When true, it is assumed that
the incloud relative humidity for nucleation is 1.
Default: .true., except .false. for CAM6 and CAM7
</entry>

<entry id="nucleate_ice_strat" type="real" category="microphys"
       group="nucleate_ice_nl" valid_values="" >
Fraction of Aitken mode sulfate particles assumed to nucleate ice in the polar
stratospheric. Provides an increase in homogeneous freezing over the Liu&amp;Penner method.
Temporary solution to adjust ice surface area density and dehydration in the
polar stratosphere where there doesn't seem to be enough nucleation. A value of
zero means Liu&amp;Penner is used.
Default: 1.0
</entry>

<entry id="nucleate_ice_use_troplev" type="logical" category="microphys"
       group="nucleate_ice_nl" valid_values="" >
Indicates whether to use the tropopause level to determine where to adjust
nucleation for the stratosphere (true) or whether to use a hard coded transition
level from 100 to 125 hPa applied only in the polar regions (false).
Default: .true.
</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: 1800.0
</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: .true.
</entry>

<entry id="cldfrc_ice" type="logical" category="cldfrc"
       group="cldfrc_nl" valid_values="" >
Switch for ice cloud fraction calculation.
Default: .true. for CAM5, CAM6 and CAM7, otherwise .false.
</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.0 for CAM6 and CAM7;
         all others =&gt; 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_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 for CAM5, CAM6 and CAM7; all others=&gt; 750.e2
</entry>

<entry id="cldfrc_iceopt" type="integer" category="conv"
       group="cldfrc_nl" valid_values="" >
Scheme for ice cloud fraction: 1=wang &amp; sassen, 2=schiller (iciwc),
3=wood &amp; field, 4=Wilson (based on smith), 5=modified slingo (ssat &amp; empyt cloud)
Default: set by build-namelist
</entry>

<entry id="cldfrc_icecrit" type="real" category="conv"
       group="cldfrc_nl" valid_values="" >
Critical RH for ice clouds (Wilson &amp; Ballard scheme).
Default: set by build-namelist
</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>

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

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

<entry id="cldfrc2m_qist_min" type="real" category="conv"
       group="cldfrc2m_nl" valid_values="" >
Minimum in-stratus IWC constraint [ kg/kg ]
Default: set by build-namelist
</entry>

<entry id="cldfrc2m_qist_max" type="real" category="conv"
       group="cldfrc2m_nl" valid_values="" >
Maximum in-stratus IWC constraint [ kg/kg ]
Default: set by build-namelist
</entry>

<entry id="cldfrc2m_do_subgrid_growth" type="logical" category="conv"
       group="cldfrc2m_nl" valid_values="" >
Use cloud fraction to determine whether to do growth of ice clouds below
RHice of 1 down to RHice = rhmini.
Default: .true. for CAM6 and CAM7; all others =&gt; .false.
</entry>

<entry id="cldfrc2m_do_avg_aist_algs" type="logical" category="conv"
       group="cldfrc2m_nl" valid_values="" >
For small ice cloud concentrations, take the geometric mean of the iceopt=4 and iceopt=5 area fractions
Default: .true. for CAM_DEV; all others .false.
</entry>

<entry id="zmconv_momcu" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Convective momentum transport parameter (upward)
Default: set by build-namelist
</entry>

<entry id="zmconv_momcd" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Convective momentum transport parameter (downward)
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_lnd" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Tunable evaporation efficiency for land 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_num_cin" type="integer" category="conv"
       group="zmconv_nl" valid_values="" >
The number of negative buoyancy regions that are allowed before the convection top and CAPE calculations are completed.
Default: =&gt; 1 for CAM6 and CAM7;
         =&gt; 5 for all other
</entry>

<entry id="zmconv_dmpdz" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Tunable entrainment rate in ZM deep convection scheme in units of (m-1).
Default: -1.0e-3 m-1
</entry>

<entry id="zmconv_tiedtke_add" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Tunable parcel temperature perturbation in ZM deep convection scheme in units of (K).
Default: 0.5K perturbation
</entry>

<entry id="zmconv_capelmt" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Tunable triggering threshold for convection in ZM deep scheme in units of (J kg-1).
Default: 70.0 J kg-1
</entry>

<entry id="zmconv_parcel_pbl" type="logical" category="conv"
       group="zmconv_nl" valid_values="" >
Turn on ZM deep convection initial parcel properties as a function of a well mixed boundary layer
Default: .false.
</entry>

<entry id="zmconv_parcel_hscale" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
 The fraction of the boundary layer (PBL) depth, over which to mix the initial ZM convective parcel properties (fraction).
Default: 0.5
</entry>

<entry id="zmconv_tau" type="real" category="conv"
       group="zmconv_nl" valid_values="" >
Convective adjustment timescale in units of (s)
Default: 3600.0 s
</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 &amp; Koop (2005)
Default: GoffGratch; except MurphyKoop for carma=cirrus or carma=cirrus_dust
</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;
   'CloudObj' Create sub-columns where most water is assigned to cloud sub-columns;
   'tstcp'    testing;
   'vamp'     Variation Across Microphysics Profiles simple deterministic scheme;
   'off'      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_tstcp_restart" type="logical" category="conv"
       group="subcol_tstcp_nl" valid_values="" >
Tests the restart capabilities of weights with a more adequate test
'true' to set the weights to a slightly more complicated pattern for restart testing
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>

<entry id="subcol_silhs_corr_file_path" type="char*256" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Location of SILHS correlation input files - usually the path to the SILHS code directory.
</entry>

<entry id="subcol_silhs_corr_file_name" type="char*16" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Correlation input file run name (as in 'rico' or 'arm97' or 'default')
</entry>

<entry id="subcol_silhs_meanice" type="logical" category="conv"
       group="subcol_silhs_nl" valid_values="" >
A special configuration that sends mean ice mixing ratios and number concentrations to microphysics but allows cloud liquid water and number concentrations to vary. Should reduce the impact of negative condensate. Default False.
</entry>

<entry id="subcol_silhs_q_to_micro" type="logical" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Whether to send SILHS liq and ice mixing ratios to microphysics (if false, uses grid mean values).
</entry>

<entry id="subcol_silhs_n_to_micro" type="logical" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Whether to send SILHS liq and ice num concentrations to microphysics (if false, uses grid mean values).
</entry>

<entry id="subcol_silhs_constrainmn" type="logical" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Whether to constrain samples of ice, liquid and vapor to the same subcolumn mean as the grid mean value.
</entry>

<entry id="subcol_silhs_use_clear_col" type="logical" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Whether to use a clear-air only column to ensure consistant subcolumn cloud fraction
</entry>

<entry id="subcol_silhs_var_covar_src" type="logical" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Flag to use SILHS to calculate the effect of microphysics on CLUBB's predictive
(co)variances rtp2 (total water variance), thlp2 (theta-l variance), and rtpthlp
(covariance of total water and theta-l), as well as on CLUBB's predictive fluxes
wprtp (total water flux) and wpthlp (flux of theta-l).
</entry>

<entry id="subcol_silhs_ncnp2_on_ncnm2" type="real" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Prescribed in-cloud ratio [N_cn'^2] / [N_cn]^2 [no units]
</entry>

<entry id="subcol_silhs_hmp2_ip_on_hmm2_ip_slope%rr" type="real" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Slope of linear equation that calculates precribed in-cloud rain water mixing ratio [r_r'^2] / [r_r]^2   [1/m]
</entry>

<entry id="subcol_silhs_hmp2_ip_on_hmm2_ip_slope%Nr" type="real" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Slope of linear equation that calculates precribed in-cloud rain drop concentration ratio [N_r'^2] / [N_r]^2   [1/m]
</entry>

<entry id="subcol_silhs_hmp2_ip_on_hmm2_ip_slope%rs" type="real" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Slope of linear equation that calculates precribed in-cloud snow mixing ratio [r_s'^2] / [r_s]^2   [1/m]
</entry>

<entry id="subcol_silhs_hmp2_ip_on_hmm2_ip_slope%Ns" type="real" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Slope of linear equation that calculates precribed in-cloud snow concentration ratio [N_s'^2] / [N_s]^2   [1/m]
</entry>

<entry id="subcol_silhs_hmp2_ip_on_hmm2_ip_slope%ri" type="real" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Slope of linear equation that calculates precribed in-cloud ice mixing ratio [r_i'^2] / [r_i]^2   [1/m]
</entry>

<entry id="subcol_silhs_hmp2_ip_on_hmm2_ip_slope%Ni" type="real" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Slope of linear equation that calculates precribed in-cloud ice concentration ratio [N_i'^2] / [N_i]^2   [1/m]
</entry>

<entry id="subcol_silhs_hmp2_ip_on_hmm2_ip_intrcpt%rr" type="real" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Intercept of linear equation that calculates precribed in-cloud rain water mixing ratio [r_r'^2] / [r_r]^2   [1/m]
</entry>

<entry id="subcol_silhs_hmp2_ip_on_hmm2_ip_intrcpt%Nr" type="real" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Intercept of linear equation that calculates precribed in-cloud rain drop concentration ratio [N_r'^2] / [N_r]^2   [-]
</entry>

<entry id="subcol_silhs_hmp2_ip_on_hmm2_ip_intrcpt%rs" type="real" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Intercept of linear equation that calculates precribed in-cloud snow mixing ratio [r_s'^2] / [r_s]^2   [-]
</entry>

<entry id="subcol_silhs_hmp2_ip_on_hmm2_ip_intrcpt%Ns" type="real" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Intercept of linear equation that calculates precribed in-cloud snow concentration ratio [N_s'^2] / [N_s]^2   [-]
</entry>

<entry id="subcol_silhs_hmp2_ip_on_hmm2_ip_intrcpt%ri" type="real" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Intercept of linear equation that calculates precribed in-cloud ice mixing ratio [r_i'^2] / [r_i]^2   [-]
</entry>

<entry id="subcol_silhs_hmp2_ip_on_hmm2_ip_intrcpt%Ni" type="real" category="conv"
       group="subcol_silhs_nl" valid_values="" >
Intercept of linear equation that calculates precribed in-cloud ice concentration ratio [N_i'^2] / [N_i]^2   [-]
</entry>

<entry id="subcol_silhs_l_lh_importance_sampling" type="logical" category="conv"
       group="silhs_config_flags_nl" valid_values="" >
Enables importance sampling for SILHS subcolumns
</entry>

<entry id="subcol_silhs_l_Lscale_vert_avg" type="logical" category="conv"
       group="silhs_config_flags_nl" valid_values="" >
Enables calculation of Lscale_vert_avg, used to generate SILHS samples.
</entry>

<entry id="subcol_silhs_l_lh_straight_mc" type="logical" category="conv"
       group="silhs_config_flags_nl" valid_values="" >
Enables straight Monte Carlo sampling, this overrides l_lh_importance_sampling.
</entry>

<entry id="subcol_silhs_l_lh_clustered_sampling" type="logical" category="conv"
       group="silhs_config_flags_nl" valid_values="" >
Enables the "new" SILHS importance sampling scheme with prescribed probabilities. Requires l_lh_importance_sampling.
</entry>

<entry id="subcol_silhs_l_rcm_in_cloud_k_lh_start" type="logical" category="conv"
       group="silhs_config_flags_nl" valid_values="" >
Determine starting SILHS first sampling level (k_lh_start) based on maximum within-cloud rcm. If false, and if l_random_k_lh_start is also false, then the SILHS first sampling level is the column maximum of liquid cloud water.
</entry>

<entry id="subcol_silhs_l_random_k_lh_start" type="logical" category="conv"
       group="silhs_config_flags_nl" valid_values="" >
Determine starting SILHS first sampling level (k_lh_start) based on random choice. Overrides l_rcm_in_cloud_k_lh_start if true.
</entry>

<entry id="subcol_silhs_l_max_overlap_in_cloud" type="logical" category="conv"
       group="silhs_config_flags_nl" valid_values="" >
Assumption of maximum vertical overlap when grid-box rcm exceeds cloud threshold.
</entry>

<entry id="subcol_silhs_l_lh_instant_var_covar_src" type="logical" category="conv"
       group="silhs_config_flags_nl" valid_values="" >
Produces "instantaneous" variance-covariance microphysical source terms, ignoring discretization effects.
</entry>

<entry id="subcol_silhs_l_lh_limit_weights" type="logical" category="conv"
       group="silhs_config_flags_nl" valid_values="" >
Limit SILHS sample point weights for stability.
</entry>

<entry id="subcol_silhs_l_lh_var_frac" type="logical" category="conv"
       group="silhs_config_flags_nl" valid_values="" >
Prescribe variance fractions.
</entry>

<entry id="subcol_silhs_l_lh_normalize_weights" type="logical" category="conv"
       group="silhs_config_flags_nl" valid_values="" >
Scale sample point weights to sum to num_samples (the "ratio estimate").
</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,off,CLUBB_SGS" >
Type of deep convection scheme employed.  'ZM' for Zhang-McFarlane;
'off' for none.
Default: 'ZM' unless using 'pbl=none'
</entry>

<entry id="microp_scheme" type="char*16" category="conv"
       group="phys_ctl_nl" valid_values="NONE,RK,MG" >
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 and CAM6
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="none,park,RK,CLUBB_SGS" >
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="" >
Flag for CLUBB_SGS.  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="shallow_scheme" type="char*16" category="conv"
       group="phys_ctl_nl" valid_values="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 {{ hilight }}eddy_scheme{{ closehilight }}).
</entry>

<entry id="do_beljaars" type="logical" category="pbl"
       group="blj_nl" valid_values="" >
Logical switch to turn on the beljaars scheme
Default: set by build-namelist
</entry>

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

<entry id="tms_orocnst" type="real" category="pbl"
       group="tms_nl" valid_values="" >
Turbulent mountain stress parameter used when turbulent mountain stress calculation
is turned on. See {{ hilight }}do_tms{{ closehilight }}.
Default: 1.0 for CAM, set by build-namelist for WACCM, T31
</entry>

<entry id="tms_z0fac" type="real" category="pbl"
       group="tms_nl" valid_values="" >
Factor determining z_0 from orographic standard deviation [ no unit ]
Used when turbulent mountain stress calc is turned on. See {{ hilight }}do_tms{{ closehilight }}.
Default: set by build-namelist for WACCM, T31
</entry>

<entry id="eddy_lbulk_max" type="real" category="pbl"
       group="eddy_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="pbl"
       group="eddy_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="pbl"
       group="eddy_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="pbl"
       group="eddy_diff_nl" valid_values="" >
Moist entrainment enhancement parameter.
Default: set by build-namelist
</entry>

<entry id="kv_top_pressure" type="real" category="pbl"
       group="eddy_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="pbl"
       group="eddy_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="pbl"
       group="eddy_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="pbl"
       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>

<entry id="diff_sponge_fac" type="real" category="pbl"
       group="vert_diff_nl" valid_values="" >
Factor to add sponge layer vertical diffusion of zonal and meridional components
of the wind verctor (following the profile for del2 damping in the spectral-element dycore).

Sponge layer interface coefficients for model tops above ptop=1E-3Pa (e.g. WACCM):

        kvm_sponge(1) = 2.e5*diff_sponge_fac
        kvm_sponge(2) = 2.e5*diff_sponge_fac
        kvm_sponge(3) = 1.5e5*diff_sponge_fac
        kvm_sponge(4) = 1.0e5*diff_sponge_fac
        kvm_sponge(5) = 0.5e5*diff_sponge_fac
        kvm_sponge(6) = 0.1e5*diff_sponge_fac

Else:

	kvm_sponge(1) = 2.e4*diff_sponge_fac
        kvm_sponge(2) = 2.e4*diff_sponge_fac
        kvm_sponge(3) = 0.4e*diff_sponge_fac
        kvm_sponge(4) = 0.1e4*diff_sponge_fac

Vertical diffusion in configurations with model tops below ~80km
(e.g., LT and MT) is only recommended for spin-up with diff_sponge_fac=1.
For higher tops diff_sponge_fac=1 can improve model stability in general.

A too large diff_sponge_fac value can lead to "stove pipes" in the
the zonally averaged zonal wind in the sponge layer.

Default: 0.0
</entry>

<!-- CLUBB PBL Diff nl -->

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

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

<entry id="clubb_do_adv" type="logical" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
Switch for CLUBB_ADV parameter that turns on advection of CLUBB pdf moments by
the dynamics core. Very experimental.
</entry>

<entry id="clubb_l_ascending_grid" type="logical" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
Causes advance_clubb_core to run in ascending mode, where the surface is at k=1, which is opposite
of the descending cam grid. This is mainly a testing/debugging option - it requires an expensive 
data flipping step and should not change answers significantly.
</entry>

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

<entry id="clubb_rnevap_effic" type="real" category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
Rain evaporation efficiency factor.
</entry>

<entry id="clubb_do_icesuper" type="logical"  category="pblrad"
       group="clubbpbl_diff_nl" valid_values="" >
Flag to perform a saturation adjustment for ice which will add ice mass if the
air is supersaturated with respect to ice.
</entry>

<!-- CLUBB params namelist -->

<entry id="clubb_beta" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Plume widths for theta_l and rt
</entry>

<entry id="clubb_bv_efold" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
E-folding parameter for mixed Brunt Vaisala Frequency
</entry>

<entry id="clubb_c1" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Limiting value of C1 when skewness of w (vertical velocity) is small in
magnitude in the C1 skewness function.  Increasing the value of C1 increases the
damping of CLUBB's wp2 (variance of vertical velocity).
</entry>

<entry id="clubb_c1b" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Limiting value of C1 when skewness of w (vertical velocity) is large in
magnitude in the C1 skewness function.  Increasing the value of C1 increases the
damping of CLUBB's wp2 (variance of vertical velocity).
</entry>

<entry id="clubb_c11" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Low Skewness in C11 Skew Function
</entry>

<entry id="clubb_c11b" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
High Skewness in C11 Skew Function
</entry>

<entry id="clubb_c14" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Constant for u'^2 and v'^2 terms
</entry>

<entry id="clubb_C2rt" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
C2 coef. for the rtp2_dp1 term
</entry>

<entry id="clubb_C2rtthl" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
C2 coef. for the rtpthlp_dp1 term
</entry>

<entry id="clubb_C2thl" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
C2 coef. for the thlp2_dp1 term
</entry>

<entry id="clubb_C4" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
C4 coefficient in the wp2 return-to-isotropy term.  A higher value of C4
tends wp2 more towards the value of subgrid TKE.
</entry>

<entry id="clubb_c6rt" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
CLUBB tunable parameter - Low Skewness in C6rt Skw. Function
</entry>

<entry id="clubb_c6rtb" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
CLUBB tunable parameter - High Skewness in C6rt Skw. Function
</entry>

<entry id="clubb_c6rtc" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
CLUBB tunable parameter - Degree of Slope of C6rt Skw. Function
</entry>

<entry id="clubb_c6thl" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
CLUBB tunable parameter - Low Skewness in C6thl Skw. Function
</entry>

<entry id="clubb_c6thlb" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
CLUBB tunable parameter - High Skewness in C6thl Skw. Function
</entry>

<entry id="clubb_c6thlc" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
CLUBB tunable parameter - Degree of Slope of C6thl Skw. Function
</entry>

<entry id="clubb_C7" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Low Skewness in C7 Skw. Function
</entry>

<entry id="clubb_C7b" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
High Skewness in C7 Skw. Function
</entry>

<entry id="clubb_C8" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coef. #1 in C8 Skewness Equation
</entry>

<entry id="clubb_C8b" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coefficient in the C8 skewness equation.  Increasing the value of C8b increases
the damping of CLUBB's wp3 when skewness of w (vertical velocity) is large in
magnitude.
</entry>

<entry id="clubb_C_invrs_tau_bkgnd" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coefficient of inverse tau term contributed by background constant value (units: none)
</entry>

<entry id="clubb_C_invrs_tau_sfc" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coefficient of inverse tau term contributed by surface log law (units: none)
</entry>

<entry id="clubb_C_invrs_tau_shear" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coefficient of inverse tau term contributed by vertical wind shear (units: none)
</entry>

<entry id="clubb_C_invrs_tau_N2" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coefficient of inverse tau term contributed by Brunt Vaisala frequency (units: none)
</entry>

<entry id="clubb_C_invrs_tau_N2_clear_wp3" type="real" category="pblrad"
      group="clubb_params_nl" valid_values="" >
Coefficient of inverse tau term contributed by Brunt Vaisala frequency but for wp3 (units: none)
</entry>

<entry id="clubb_C_invrs_tau_N2_wp2" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coefficient of inverse tau term contributed by Brunt Vaisala frequency but for wp3_wp2 (units: none)
</entry>

<entry id="clubb_C_invrs_tau_N2_wpxp" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coefficient of inverse tau term contributed by Brunt Vaisala frequency but for xm_wpxp (units: none)
</entry>

<entry id="clubb_C_invrs_tau_N2_xp2" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coefficient of inverse tau term contributed by Brunt Vaisala frequency but for xp2_wpxp (units: none)
</entry>

<entry id="clubb_c_K1" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coefficient of Kh_zm (diffusivity on momentum grid levels) in the wp2 (variance
of vertical velocity) predictive equation.
</entry>

<entry id="clubb_c_K10" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Momentum coefficient of Kh_zm
</entry>

<entry id="clubb_c_K10h" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Thermo of Kh_zm
</entry>

<entry id="clubb_c_K2" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coefficient of Kh_zm (diffusivity on momentum grid levels) in the scalar
variance predictive equations (e.g. rtp2, variance of total water).
</entry>

<entry id="clubb_c_K8" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coefficient of Kh_zt (diffusivity on thermodynamic grid levels) in the wp3
(third-order moment of vertical velocity) predictive equation.
</entry>

<entry id="clubb_c_K9" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coefficient of Kh_zm (diffusivity on momentum grid levels) in the up2 (variance
of the west-east wind component) and vp2 (variance of the south-north wind
component) predictive equations.
</entry>

<entry id="clubb_C_uu_shr" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coefficient in the wp2 (variance of vertical velocity) pressure terms opposing shear production.
</entry>

<entry id="clubb_C_uu_buoy" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coefficient in the wp2 (variance of vertical velocity) pressure terms opposing buoyancy production.
</entry>

<entry id="clubb_C_wp2_splat" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coefficient for gustiness near ground.
</entry>

<entry id="clubb_C_wp3_pr_turb" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coefficient in the pressure-turbulence term of CLUBB's wp3 predictive equation.
</entry>

<entry id="clubb_detice_rad" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Radius of detrained ice drops as they are used in the CLUBB parameterization in units of (m).
</entry>

<entry id="clubb_detliq_rad" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Radius of detrained liquid drops as they are used in the CLUBB parameterization in units of (m).
</entry>

<entry id="clubb_detphase_lowtemp" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Temperature at which detrained water is classified as entirely ice (no liquid)
in the CLUBB parameterization in units of (K).
</entry>

<entry id="clubb_do_energyfix" type="logical"  category="conv"
       group="clubb_params_nl" valid_values="" >
Apply adjustments to dry static energy so that CLUBB conserves
energy.
</entry>

<entry id="clubb_do_liqsupersat" type="logical"  category="conv"
       group="clubb_params_nl" valid_values="" >
Apply liquid supersaturation adjustment code
</entry>

<entry id="clubb_gamma_coef" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Low Skewness in gamma coefficient Skewness Function (units: none)
Default changes depending on grid and physics options
</entry>

<entry id="clubb_gamma_coefb" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Limiting value of gamma when skewness of w (vertical velocity) is large in
magnitude in the gamma skewness function.  Increasing the value of gamma
increases the standard deviation of w in both Gaussians in CLUBB's double
Gaussian PDF, and also decreases the difference between the means of w from
each Gaussian.
</entry>

<entry id="clubb_grid_adapt_in_time_method" type="integer" category="pblrad"
       group="clubb_params_nl" valid_values="0,1" >
Specifier for method to construct a grid density function to adapt grid to.
Valid values: 0 (no grid adaptation), 1 (use Lscale and wp2)
</entry>

<entry id="clubb_fill_holes_type" type="integer" category="pblrad"
       group="clubb_params_nl" valid_values="0,1,2,3,4,5,6" >
Selects which algorithm the fill_holes routine uses to correct 
below threshold values in field solutions.
0: off - Skip the mass conservative hole filling step, rely on blunt clipping
1: global - Fast but minimally local, most methods use this as a fallback step
2: sliding_window - Expensive but highly local when possible, falls back to global fill if needed
3: widening_windows - Slightly parallelizable, local when possible, falls back to global if needed
4: smart_window - Uses hueristics to determine ranges to fill, fast and highly local when possible, falls back to global if needed
5: smart_window_smooth - Same as smart_window, but with experimental smoothing features that slightly increases cost, NO GLOBAL FALLBACK
6: parallel_fill - Highly local when possible, completely parallelizable but computationally wasteful, falls back to global if needed
See CLUBB_core/model_flags.F90 or CLUBB_core/fill_holes.F90 for more detail.
</entry>

<entry id="clubb_grid_remap_method" type="integer" category="pblrad"
       group="clubb_params_nl" valid_values="1" >
Specifier for method to remap values from one grid to another.
Valid values: 1 (ullrich remapping)
</entry>

<entry id="clubb_iiPDF_type" type="integer" category="pblrad"
       group="clubb_params_nl" valid_values="1,2,3,4,5,6,7" >
Selected option for the two-component normal (double Gaussian) PDF type to use for the w, rt,
and theta-l (or w, chi, and eta) portion of CLUBB's multivariate, two-component PDF.
iiPDF_ADG1 = 1 (ADG1 PDF), iiPDF_ADG2 = 2 (ADG2 PDF), iiPDF_3D_Luhar = 3 (3D Luhar PDF),
iiPDF_new = 4 (new PDF), iiPDF_TSDADG = 5 (TSDADG PDF), iiPDF_LY93 = 6 (Lewellen and Yoh (1993)),
iiPDF_new_hybrid = 7 (new hybrid PDF)
</entry>

<entry id="clubb_ipdf_call_placement" type="integer" category="pblrad"
       group="clubb_params_nl" valid_values="1,2,3" >
Option for the placement of the call to CLUBB's PDF closure. The options include: ipdf_pre_advance_fields (1) calls the PDF closure before advancing prognostic fields. ipdf_post_advance_fields (2) calls after advancing prognostic fields, and ipdf_pre_post_advance_fields (3) calls both before and after advancing prognostic fields.
</entry>

<entry id="clubb_lambda0_stability_coef" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="">
Intensity of stability correction applied to C1 and C6
</entry>

<entry id="clubb_lmin_coef" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="">
Coefficient used to determine the minimum allowable value of CLUBB's length
scale (Lscale) in a grid-spacing dependent formula.  Increasing the value of
clubb_lmin_coef increases the minimum allowable value for length scale.
</entry>

<entry id="clubb_l_add_dycore_grid" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to remap values from the dycore grid.
</entry>

<entry id="clubb_l_brunt_vaisala_freq_moist" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to uses an alternate equation to calculate the Brunt-Vaisala frequency.
This equation calculates an in-cloud Brunt-Vaisala frequency.
</entry>

<entry id="clubb_l_C2_cloud_frac" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to use cloud fraction to adjust the value of the
turbulent dissipation coefficient, C2.
</entry>

<entry id="clubb_l_calc_thlp2_rad" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Include the contribution of radiation to thlp2
</entry>

<entry id="clubb_l_calc_w_corr" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Calculate the correlations between w and the hydrometeors
</entry>

<entry id="clubb_l_call_pdf_closure_twice" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to call CLUBB's PDF closure at both thermodynamic and momentum vertical
grid levels.  When this flag is turned off, CLUBB's PDF closure is only called
on thermodynamic grid levels.
</entry>

<entry id="clubb_l_const_Nc_in_cloud" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Use a constant cloud droplet conc. within cloud
</entry>

<entry id="clubb_l_damp_wp2_using_em" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to use a dissipation formula of -(2/3)*em/tau_zm, as in Bougeault (1981),
in the wp2 (variance of vertical velocity) predictive equation.
</entry>

<entry id="clubb_l_damp_wp3_Skw_squared" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to damp CLUBB's wp3 by the square of skewness of w (Skw).  When this flag
is turned off, wp3 is damped according to Skw to the 4th power.  This damping
equation also involves the coefficient clubb_C8b (see description of clubb_C8b).
</entry>

<entry id="clubb_l_diag_Lscale_from_tau" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag that, when it is enabled, first calculates dissipation time tau, and then
calculates the mixing length scale as Lscale = tau * sqrt(tke).  When the flag
is turned off, Lscale is calculated first, and then dissipation time-scale tau
is calculated as tau = Lscale / sqrt(tke).
</entry>

<entry id="clubb_l_diagnose_correlations" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Diagnose correlations instead of using fixed ones
</entry>

<entry id="clubb_l_diffuse_rtm_and_thlm" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Implicit diffusion on moisture and temperature, implemented within CLUBB's
matrix equations for wprtp/rtm and wpthlp/thlm.
</entry>

<entry id="clubb_l_do_expldiff_rtm_thlm" type="logical"  category="pblrad"
       group="clubb_params_nl" valid_values="" >
Explicit diffusion on temperature and moisture by CLUBB, in addition to CLUBB's
normal prognostic equations for rtm and thlm.
</entry>

<entry id="clubb_l_e3sm_config" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to run CLUBB with E3SM settings.
</entry>

<entry id="clubb_l_enable_relaxed_clipping" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to relax clipping on wpxp in xm_wpxp_clipping_and_stats.
</entry>

<entry id="clubb_l_fix_w_chi_eta_correlations" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Use a fixed correlation for s and t Mellor(chi/eta)
</entry>

<entry id="clubb_l_godunov_upwind_wpxp_ta" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
This flag determines whether we want to use an upwind differencing approximation
rather than a centered differencing for turbulent advection terms. It affects
wpxp only.
</entry>

<entry id="clubb_l_godunov_upwind_xpyp_ta" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
This flag determines whether we want to use an upwind differencing approximation
rather than a centered differencing for turbulent advection terms. It affects
xpyp only.
</entry>

<entry id="clubb_l_intr_sfc_flux_smooth" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to apply a locally calculated ustar to momentum surface fluxes in the
clubb interface.
</entry>

<entry id="clubb_l_lmm_stepping" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to apply Linear Multistep Method (LMM) stepping in CLUBB.
</entry>

<entry id="clubb_l_lscale_plume_centered" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Uses PDF to compute perturbed values for l_avg_Lscale code
</entry>

<entry id="clubb_l_min_wp2_from_corr_wx" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to set an additional minimum threshold on wp2 (in addition to w_tol_sqd)
based on maintaining a realizable correlation (value between -1 and 1) of w and
another variable, x.  When this flag is enabled, the value of wp2 will be
increased when the correlation is not realizable until the correlation becomes
realizable.  When this flag is turned off, the magnitude of wpxp will be
decreased when the correlation is not realizable until the correlation becomes
realizable.  This correction is applied at the point in the code where wp2 is
advanced one timestep.
</entry>

<entry id="clubb_l_min_xp2_from_corr_wx" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to set an additional minimum threshold on xp2 (in addition to x_tol^2),
where xp2 is a variance such as rtp2 (variance of total water) or thlp2
(variance of liquid water potential temperature).  This threshold is based on
maintaining a realizable correlation (value between -1 and 1) of w and x.  When
this flag is enabled, the value of xp2 will be increased when the correlation is
not realizable until the correlation becomes realizable.  When this flag is
turned off, the magnitude of wpxp will be decreased when the correlation is not
realizable until the correlation becomes realizable.  This correction is applied
at the point in the code where xp2 is advanced one timestep.
</entry>

<entry id="clubb_l_mono_flux_lim_rtm" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to turn on the clubb monotonic flux limiter for rtm.
</entry>

<entry id="clubb_l_mono_flux_lim_spikefix" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to turn on the smoothing code options for the monotonic flux limiter.
</entry>

<entry id="clubb_l_mono_flux_lim_thlm" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to turn on the clubb monotonic flux limiter for thlm.
</entry>

<entry id="clubb_l_mono_flux_lim_um" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to turn on the clubb monotonic flux limiter for um (zonal momemtum).
</entry>

<entry id="clubb_l_mono_flux_lim_vm" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to turn on the clubb monotonic flux limiter for vm (meridional momemtum).
</entry>

<entry id="clubb_l_partial_upwind_wp3" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to use an "upwind" discretization rather than a centered discretization
for the portion of the wp3 turbulent advection term for ADG1 that is linearized
in terms of wp3(t+1). (Requires ADG1 PDF and l_standard_term_ta=true).
</entry>

<entry id="clubb_l_predict_upwp_vpwp" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to predict horizontal momentum fluxes upwp and vpwp along with mean
horizontal winds um and vm.  When this flag is turned off, upwp and vpwp are
calculated by down-gradient diffusion.
</entry>

<entry id="clubb_l_ho_nontrad_coriolis" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to implement the nontraditional Coriolis terms in the 
prognostic equations of w'w', u'w', and u'u.
</entry>

<entry id="clubb_l_ho_trad_coriolis" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to implement the traditional Coriolis terms in the
prognostic equations of v'w' and u'w'.
</entry>

<entry id="clubb_l_prescribed_avg_deltaz" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
used in adj_low_res_nu. If .true., avg_deltaz = deltaz
</entry>

<entry id="clubb_l_rcm_supersat_adj" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to take any remaining supersaturation after CLUBB PDF call and add it to
rcm (mean cloud water mixing ratio).  Supersaturation may be found after the
PDF call due to issues when the PDF is called on both the thermodynamic grid
levels and the momentum grid levels and variables are interpolated between the
two grid level types.
</entry>

<entry id="clubb_l_rtm_nudge" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Turn on (true) and off (false) rtm nudging.
</entry>

<entry id="clubb_l_smooth_Heaviside_tau_wpxp" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to use smooth Heaviside 'Peskin' in computation of invrs_tau.
</entry>

<entry id="clubb_l_standard_term_ta" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Use the standard discretization for the turbulent advection terms.  Setting to
.false. means that a_1 and a_3 are pulled outside of the derivative in
advance_wp2_wp3_module.F90 and in advance_xp2_xpyp_module.F90.
</entry>

<entry id="clubb_l_stability_correct_Kh_N2_zm" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Whether or not we want CLUBB to apply a stability correction Kh_N2_zm.
</entry>

<entry id="clubb_l_stability_correct_tau_zm" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to use a stability corrected version of CLUBB's time scale (tau_zm).  This
creates a time scale that provides stronger damping at altitudes where
Brunt-Vaisala frequency is large.
</entry>

<entry id="clubb_l_tke_aniso" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Use anisotropic turbulent kinetic energy in the CLUBB higher order closure, i.e.
calculate TKE = 1/2 (u'^2 + v'^2 + w'^2). This improves the simulation of complex
turbulence but at a greater cost than running without.
</entry>

<entry id="clubb_l_trapezoidal_rule_zm" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag that uses the trapezoidal rule to adjust fields calculated by CLUBB's PDF
(e.g. cloud fraction) by taking into account the values of these fields from an
adjacent vertical grid level.  The clubb_l_trapezoidal_rule_zm flag applies this
adjustment to PDF fields calculated on momentum vertical grid levels.
</entry>

<entry id="clubb_l_trapezoidal_rule_zt" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag that uses the trapezoidal rule to adjust fields calculated by CLUBB's PDF
(e.g. cloud fraction) by taking into account the values of these fields from an
adjacent vertical grid level.  The clubb_l_trapezoidal_rule_zt flag applies this
adjustment to PDF fields calculated on thermodynamic vertical grid levels.
</entry>

<entry id="clubb_l_upwind_xm_ma" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
This flag determines whether we want to use an upwind differencing approximation
rather than a centered differencing for turbulent or mean advection terms. It
affects rtm, thlm, sclrm, um and vm.
</entry>

<entry id="clubb_l_upwind_xpyp_ta" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to use "upwind" discretization in the turbulent advection term in the
xpyp predictive equation, where xpyp is a field such as rtp2 (variance of
vertical velocity) or rtpthlp (covariance of total water and liquid water
potential temperature).  When this flag is turned off, centered discretization
is used.
</entry>

<entry id="clubb_l_uv_nudge" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Turn on (true) or off (false) uv wind speed nudging.
</entry>

<entry id="clubb_l_use_C11_Richardson" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to calculate the value of CLUBB's C11 based on Richardson number, where
C11 is a coefficient in a wp3 pressure term and is used to balance the effects
of pressure and buoyancy in the wp3 predictive equation.
</entry>

<entry id="clubb_l_use_C7_Richardson" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to calculate the value of CLUBB's C7 based on Richardson number, where
C7 is a coefficient in a wpxp pressure term and is used to balance the effects
of pressure and buoyancy in the wpxp predictive equation.  The variable wpxp is
a flux such as total water flux or flux of liquid water potential temperature.
</entry>

<entry id="clubb_l_use_cloud_cover" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to allow cloud fraction and mean cloud water at adjacent vertical grid
levels influence the amount of cloudiness and amount of cloud water in a
grid box.
</entry>

<entry id="clubb_l_use_precip_frac" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to use precipitation fraction in KK microphysics. The
precipitation fraction is automatically set to 1 when this
flag is turned off.
</entry>

<entry id="clubb_l_use_shear_Richardson" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to use shear in the calculation of Richardson number.
</entry>

<entry id="clubb_l_use_thvm_in_bv_freq" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to use mean theta-v in the calculation of Brunt-Vaisala frequency.
</entry>

<entry id="clubb_l_use_tke_in_wp2_wp3_K_dfsn" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to use Total Kenetic Energy (TKE) in eddy diffusion for wp2 and wp3.
</entry>

<entry id="clubb_l_use_tke_in_wp3_pr_turb_term" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag to use Total Kenetic Energy (TKE) formulation for wp3 pr_turb (turbulent
production) term.
</entry>

<entry id="clubb_l_vary_convect_depth" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag used to calculate convective velocity using a variable estimate of layer
depth based on the depth over which wpthlp is positive near the ground when true
</entry>

<entry id="clubb_l_vert_avg_closure" type="logical" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Flag that, when it is enabled, automatically enables CLUBB's
l_trapezoidal_rule_zt, l_trapezoidal_rule_zm, and l_call_pdf_closure_twice.
</entry>

<entry id="clubb_mult_coef" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Coef. applied to log(avg dz/thresh)
</entry>

<entry id="clubb_nu2" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Constant in the diffusivity term in the scalar variance predictive equations
(e.g. rtp2, variance of total water).
</entry>

<entry id="clubb_nu9" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Constant in the diffusivity term in the up2 (variance of the west-east wind
component) and vp2 (variance of the south-north wind component) predictive
equations.
</entry>

<entry id="clubb_penta_solve_method" type="integer" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Specifier for method to solve the penta-diagonal system that is common in CLUBB.
Valid values: 0 (lapack), 1 (penta_lu), 2 (penta_bicgstab)
</entry>

<entry id="clubb_Skw_denom_coef" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Factor to decrease sensitivity in the denominator of Skw calculation
</entry>

<entry id="clubb_skw_max_mag" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Maximum magnitude of skewness allowed.
</entry>

<entry id="clubb_tridiag_solve_method" type="integer" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Specifier for method to solve tri-diagonal systems that are common in CLUBB.
Experimental option and currently the only valid value is 1: lapack
</entry>

<entry id="clubb_up2_sfc_coef" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Factor used in calculating the surface values of up2 (variance of the u wind
component) and vp2 (variance of the v wind component).  Increasing
clubb_up2_sfc_coef increases the values of up2 and vp2 at the surface.
</entry>

<entry id="clubb_wpxp_L_thresh" type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
CLUBB tunable parameter - Lscale threshold: damp C6 and C7 (units: m)
</entry>

<entry id="clubb_wpxp_Ri_exp"  type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Exponent for Richardson number in calculation of invrs_tau_wpxp term
</entry>

<entry id="clubb_z_displace"  type="real" category="pblrad"
       group="clubb_params_nl" valid_values="" >
Displacement of log law profile above ground  (units: m)
</entry>

<!-- for CLUBB+MF -->
<entry id="do_clubb_mf" type="logical" category="conv"
       group="clubb_mf_nl" valid_values="" >
If .true. add ensemble mass fluxes to CLUBB's higher-order equation set.
Together with CLUBB, this constitutes an eddy-diffusivity mass-flux approach.
Default: .false.
</entry>

<entry id="do_clubb_mf_diag" type="logical" category="conv"
       group="clubb_mf_nl" valid_values="" >
If .true. add detailed budget terms to output by default.  Note that do_clubb_mf must also be set to .true.
Default: .false.
</entry>

<entry id="clubb_mf_L0" type="real" category="conv"
       group="clubb_mf_nl" valid_values="" >
Entrainment length scale in meters for individual plumes. Not used if
do_clubb_mf=FALSE.
Default: 50.0
</entry>

<entry id="clubb_mf_ent0" type="real" category="conv"
       group="clubb_mf_nl" valid_values="" >
Entrainment efficiency for individual plumes. Not used if
do_clubb_mf=FALSE.
Default: 0.22
</entry>

<entry id="clubb_mf_nup" type="integer" category="conv"
       group="clubb_mf_nl" valid_values="" >
Real: number of plumes in mass flux ensemble
Default: 10
</entry>

<!-- CARMA Sectional Microphysics -->

<entry id="carma_model" type="char*32" category="carma"
       group="carma_nl" valid_values="" >
The name of the active CARMA microphysics model or none when CARMA
is not active.
Default: none
</entry>

<entry id="carma_sulfnuc_method" type="char*10" category="carma"
       group="carma_nl" valid_values="ZhaoTurco,Vehkamaki" >
 Nucleation methods:
  ZhaoTurco
      Zhao, J. and Turco, R.,
      Nucleation simulations in the wake of a jet aircraft in stratospheric flight,
      J. Aerosol Sci., 26, 779-795, 1995,
      https://doi.org/10.1016/0021-8502(95)00010-A
  Vehkamaki
     Vehkamaki, H., M. Kulmala, I. Napari, K.E.J. Lehtinen,
     C. Timmreck, M. Noppel and A. Laaksonen, 2002,
     An improved parameterization for sulfuric acid-water nucleation
     rates for tropospheric and stratospheric conditions,
     J. Geophys. Res., 107, 4622, doi:10.1029/2002jd002184
Default: none
</entry>

<entry id="carma_conmax" type="real" category="carma"
       group="carma_nl" valid_values="" >
A fraction that scales how tight the convergence criteria are to
determine that the substepping has resulted in a valid solution.
Smaller values will force more substepping.
CARMA particles.
Default: 0.1
</entry>

<entry id="carma_dt_threshold" type="real" category="carma"
       group="carma_nl" valid_values="" >
When non-zero, the largest change in temperature (K)
allowed per substep.
Default: 0.
</entry>

<entry id="carma_do_coremasscheck" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that do coremasscheck after certain subroutines
and abort the model if the check not pass.
Default: FALSE
</entry>

<entry id="carma_do_aerosol" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that the CARMA model is an aerosol model, and
should be called in tphysac.
Default: TRUE
</entry>

<entry id="carma_do_cldice" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that CARMA is a cloud ice model and should
be called in tphysbc.
Default: FALSE
</entry>

<entry id="carma_do_cldliq" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that CARMA is a cloud liquid model and should
be called in tphysbc.
Default: FALSE
</entry>

<entry id="carma_do_clearsky" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that CARMA should do clear sky calculations for
particles that are not part of a cloud in addition to doing a
separate calculation for incloud particles. Only valid when
carma_do_incloud is true.
Default: FALSE
</entry>

<entry id="carma_do_cloudborne" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating whether CARMA aerosol should be allowed to become
cloudborne. It is actually CAM and not CARMA that moves aerosol
between cloudborne and interstitial.
Default: FALSE
</entry>

<entry id="carma_do_coag" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating whether the coagulation process is enabled for
CARMA particles.
Default: FALSE
</entry>

<entry id="carma_do_detrain" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that CARMA is responsible for detrain condensate
from convection into the model.
Default: FALSE
</entry>

<entry id="carma_do_drydep" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that the dry deposition process is enabled for
CARMA particles.
Default: FALSE
</entry>

<entry id="carma_do_emission" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that the emission of particles is enabled for
CARMA.
Default: FALSE
</entry>

<entry id="carma_do_explised" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that sedimentation should be calculated using an
explicit technique where the substepping is used to keep the CFL
condition from being violated rather than the default PPM scheme.
Default: FALSE
</entry>

<entry id="carma_do_fixedinit" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating CARMA coefficients should only be initialized once from
a fixed temperature profile rather than recomputed for each column. This
improves performance, but reduces accuracy. By default the temperature
profile used is calculated as the average of the initial condition file,
but a predefined profile can be provided.
Default: FALSE
</entry>

<entry id="carma_do_partialinit" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating used in cunjunction with carma_do_fixedinit to indicate
that only the coagulation coefficients should only be initialized from
a fixed temperature profile and all other coeeficients will be recalculated.
Coagulation is the slowest initialization, so this improves performance while
still retaining accuracy for most processes.
Default: FALSE
</entry>

<entry id="carma_do_grow" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that the condensational growth process is enabled for
CARMA particles.
Default: FALSE
</entry>

<entry id="carma_do_budget_diags" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that model specific budget diagnostics should be
generated.
Default: FALSE
</entry>

<entry id="carma_do_package_diags" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that model specific budget diagnostics should be
generated per physics package for the packages listed in
carma_diag_packages.
Default: FALSE
</entry>

<entry id="carma_diags_packages" type="char*12(100)" category="carma"
       group="carma_nl" valid_values="" >
List of physics packages for which diagnostic output is desired.
Default: NONE
</entry>

<entry id="carma_debug_packages" type="char*32(100)" category="carma"
       group="carma_nl" valid_values="" >
List of physics packages for which debug output from the local carma
state checker is desired.
Default: NONE
</entry>

<entry id="carma_diags_file" type="integer" category="carma"
       group="carma_nl" valid_values="" >
When > 0, indicates the history file to be used by default for diagnostic output.
A value of 1 indicates the h0 file. When 0 no diagnostics are output.
Default: 0
</entry>

<entry id="carma_rad_feedback" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that CARMA sulfate mass mixing ratio will be used
in radiation calculation.
Default: FALSE
</entry>

<entry id="carma_hetchem_feedback" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that CARMA sulfate surface area density will be used
in heterogeneous chemistry rate calculation.
Default: FALSE
</entry>

<entry id="carma_do_incloud" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that CARMA should treat cloud particles as incloud
rather than gridbox average calculations.
Default: FALSE
</entry>

<entry id="carma_do_optics" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that carma should generate optical properties files
for the CAM radiation code.
Default: FALSE
</entry>

<entry id="carma_do_pheat" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that particle heating will be used for the condensational
growth process.
Default: FALSE
</entry>

<entry id="carma_do_pheatatm" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that particle heating will affect the atmospheric
temperature.
Default: FALSE
</entry>

<entry id="carma_do_substep" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that substepping will be used for the condensational
growth process.
Default: FALSE
</entry>

<entry id="carma_do_thermo" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that changes in heating will be calculated as a result
CARMA processes and will affect the CAM heating tendency.
Default: FALSE
</entry>

<entry id="carma_do_wetdep" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that the wet deposition process is enabled for
CARMA particles.
Default: FALSE
</entry>

<entry id="carma_do_vdiff" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that the effect of Brownian diffusion will be calculated for
CARMA particles. NOTE: This needs to be used in conjunction with CARMA
sedimentation.
Default: FALSE
</entry>

<entry id="carma_do_vtran" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating that the sedimentation process is enabled for
CARMA particles.
Default: FALSE
</entry>

<entry id="carma_flag" type="logical" category="carma"
       group="carma_nl" valid_values="" >
Flag indicating whether CARMA is enabled. If CARMA has been included
in the build (configure -carma with something other than none), then
this will cause all of the CARMA constituents and field names to be
registered, but no other CARMA process will be preformed. This overrides
the individual CARMA process flags.
Default: FALSE
</entry>

<entry id="carma_maxretries" type="integer" category="carma"
       group="carma_nl" valid_values="" >
Specifies the maximum number of retry attempts to be used when
condensational growth requires substepping, but the original estimate
for the amount of substepping was insufficient.
Default: 8
</entry>

<entry id="carma_maxsubsteps" type="integer" category="carma"
       group="carma_nl" valid_values="" >
Specifies the maximum number of substeps that could be used for the
first guess when condensational growth requires substepping.
Default: 1
</entry>

<entry id="carma_cstick" type="real" category="carma"
       group="carma_nl" valid_values="" >
Accommodation coefficient for coagulation.
Default: 1.0
</entry>

<entry id="carma_gsticki" type="real" category="carma"
       group="carma_nl" valid_values="" >
Accommodation coefficient for growth with ice.
Default: 0.93
</entry>

<entry id="carma_gstickl" type="real" category="carma"
       group="carma_nl" valid_values="" >
Accommodation coefficient for growth with liquid.
Default: 1.0
</entry>

<entry id="carma_tstick" type="real" category="carma"
       group="carma_nl" valid_values="" >
Accommodation coefficient for temperature.
Default: 1.0
</entry>

<entry id="carma_rhcrit" type="real" category="carma"
       group="carma_nl" valid_values="" >
Critical relative humidity for liquid cloud formation, used
for sub-grid scale in-cloud saturation.
Default: 1.0
</entry>

<!-- CARMA model - meteor impact -->

<entry id="carma_emis_dust" type="real" category="carma_model"
       group="carma_model_nl" valid_values="" >
Global mass of dust emission for the event.
Default: 0. (kg)
</entry>

<entry id="carma_emis_soot" type="real" category="carma_model"
       group="carma_model_nl" valid_values="" >
Global mass of dust emission for the event.
Default: 0. (kg)
</entry>

<entry id="carma_emis_startdate" type="integer" category="carma_model"
       group="carma_model_nl" valid_values="" >
Starting date for emissions in the form of (yyyyddd) where yyyy is a year and
ddd is a day of year.
Default: 1 (yyyyddd)
</entry>

<entry id="carma_emis_starttime" type="integer" category="carma_model"
       group="carma_model_nl" valid_values="" >
Starting time for the emission event in GMT.
Default: 0. (s Z)
</entry>

<entry id="carma_emis_stopdate" type="integer" category="carma_model"
       group="carma_model_nl" valid_values="" >
Stopping date for emissions in the form of (yyyyddd) where yyyy is a year and
ddd is a day of year.
Default: 1 (yyyyddd)
</entry>

<entry id="carma_emis_stoptime" type="integer" category="carma_model"
       group="carma_model_nl" valid_values="" >
Stoping time for the emission event in GMT.
Default: 0. (s)
</entry>

<entry id="carma_emis_minlat" type="real" category="carma_model"
       group="carma_model_nl" valid_values="" >
Minimum latitude of the area for emssions from the event.
Default: -90. (degrees north)
</entry>

<entry id="carma_emis_maxlat" type="real" category="carma_model"
       group="carma_model_nl" valid_values="" >
Maximum latitude of the area for emssions from the event.
Default: 90. (degrees north)
</entry>

<entry id="carma_emis_minlon" type="real" category="carma_model"
       group="carma_model_nl" valid_values="" >
Minimum longitude of the area for emssions from the event.
Default: 0. (degrees east)
</entry>

<entry id="carma_emis_maxlon" type="real" category="carma_model"
       group="carma_model_nl" valid_values="" >
Maximum longitude of the area for emssions from the event.
Default: 360. (degrees east)
</entry>

<entry id="carma_fractal_soot" type="logical" category="carma_model"
       group="carma_model_nl" valid_values="" >
Are the soot particles treated as fractals?
Default: FALSE
</entry>

<!-- CARMA model - meteor smoke &amp; pmc -->

<entry id="carma_do_escale" type="logical" category="carma_model"
       group="carma_model_nl" valid_values="" >
Flag indicating that meteor smoke emission will be scaled by a
global relative flux based upon the carma_escale_file.
Default: FALSE
</entry>

<entry id="carma_emis_total" type="real" category="carma_model"
       group="carma_model_nl" valid_values="" >
The total meteor smoke emission rate in kt/year. The flux will be
scaled to total that value.
Default: 16.0
</entry>

<entry id="carma_emis_file" type="char*256" input_pathname="abs" category="carma_model"
       group="carma_model_nl" valid_values="" >
Specifies the name of the file containing the meteor smoke emission
(ablation) profile.
Default: set by build-namelist.
</entry>

<entry id="carma_escale_file" type="char*256" input_pathname="abs" category="carma_model"
       group="carma_model_nl" valid_values="" >
Specifies the name of the file containing the global realtive flux
specification.
Default: set by build-namelist.
</entry>

<entry id="carma_launch_doy" type="integer" category="carma_model"
       group="carma_model_nl" valid_values="" >
Specifies the day of year when tracers will start being emitted for the tracer test.
Default: 1
</entry>

<entry id="carma_emission_rate" type="real" category="carma_model"
       group="carma_model_nl" valid_values="" >
The emission rate of inert tracers used in the test. A positive value indicates that
the rate is a column mass (kg/m2/s) and a negative value indicate that it is a mass
mixing ratio (kg/kg/s).
Default: 1e-9
</entry>

<entry id="carma_neutral_h2so4" type="logical" category="carma_model"
       group="carma_model_nl" valid_values="" >
Flag indicating that h2so4 vapor pressures should be calculated as if they were
over sulfates that have been totally neutralized.
Default: FALSE
</entry>


<!-- CARMA model - cirrus -->

<entry id="carma_sulfate_method" type="char*32" category="carma_model"
       group="carma_model_nl" valid_values="bulk,carma,fixed,modal" >
Specifies the method to use to get the prescribed sulfate aerosols for use with nucleation
of cirrus clouds. This can be different than the sulfate aerosols that are used with the
climate.
Default: fixed
</entry>

<!-- CARMA model - cirrus &amp; pmc -->

<entry id="carma_mice_file" type="char*256" input_pathname="abs" category="carma_model"
       group="carma_model_nl" valid_values="" >
Specifies the name of the file containing ice refrative indicies as a function of wavelength
used for the particle heating calculation.
Default: set by build-namelist.
</entry>

<!-- CARMA model - dust -->

<entry id="carma_soilerosion_file" type="char*256" input_pathname="abs" category="carma_model"
       group="carma_model_nl" valid_values="" >
Specifies the name of the file containing soil erosion factors. This is used by
the dust model.
Default: set by build-namelist.
</entry>

<entry id="carma_dustemisfactor" type="real" category="carma"
       group="carma_model_nl" valid_values="" >
CARMA dust emissions scaling factor
Default: 0.5e-9_r8
</entry>



<!-- CARMA model - sea salt -->

<entry id="carma_do_WeibullK" type="logical" category="carma_model"
       group="carma_model_nl" valid_values="" >
Flag indicating that a calculated Weibull K should be used.
Default: FALSE
</entry>

<entry id="carma_seasalt_emis" type="char*32" category="carma_model"
       group="carma_model_nl" valid_values="" >
Specifies the name of the sea salt emission parameterization.
Default: Gong
</entry>

<!-- CARMA model - aerosol -->
<entry id="carma_BCOCemissions" type="char*32" category="carma_model"
       group="carma_model_nl" valid_values="Yu2015,Specified" >
Specifies the input method of black and organic carbon aerosol emissions
for the trop_strat CARMA model.

Valid options are:

 Yu2015 -- method used in Yu et. al, 2015
 Specified -- {{ hilight }}emissions_specifier{{ closehilight }} method which places emissions in physcis buffer

Default: Yu2015
</entry>

<entry id="carma_SO4elevemis" type="char*32" category="carma_model"
       group="carma_model_nl" valid_values="NONE,Specified" >
Specifies the input method of sulfate emissions
for the trop_strat CARMA model.

Valid options are:

 Specified -- {{ hilight }}elev_emis_specifier{{ closehilight }} method which places emissions in physcis buffer

Default: NONE
</entry>

<entry id="elev_emis_specifier" type="char*256(50)" category="cam_chem"
       group="elevated_emissions_opts" valid_values="" >
List of full pathnames of surface emission datasets.

Elevated emission data added to physcis buffer read from a set of netcdf file.
Each tracer species emissions is read from its own file as directed by the
namelist variable {{ hilight }}elev_emis_specifier{{ closehilight }}.  The
{{ hilight }}emissions_specifier{{ closehilight }} variable tells the model
which species have emissions and the file path for the corresponding species.
That is, the {{ hilight }}elev_emis_specifier{{ closehilight }} variable is
set something like:

 elev_emis_specifier = 'SO4 -> /path/emis.SO4.nc',
                       'OC -> /path/emis.OC.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="elev_emis_type" type="char*32" category="cam_chem"
       group="elevated_emissions_opts" 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 {{ hilight }}elev_emis_specifier{{ closehilight }}.
Default: 'CYCLICAL'
</entry>

<entry id="elev_emis_cycle_yr" type="integer" category="cam_chem"
       group="elevated_emissions_opts" valid_values="" >
The  cycle year of the elevated emissions data
if {{ hilight }}elev_emis_type{{ closehilight }}  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="elev_emis_fixed_ymd" type="integer" category="cam_chem"
       group="elevated_emissions_opts" valid_values="" >
The date at which the elevated emissions are fixed
if {{ hilight }}elev_emis_type{{ closehilight }} is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="elev_emis_fixed_tod" type="integer" category="cam_chem"
       group="elevated_emissions_opts" valid_values="" >
The time of day (seconds) corresponding to {{ hilight }}elev_emis_fixed_ymd{{ closehilight }}
at which the elevated emissions are fixed
if {{ hilight }}elev_emis_type{{ closehilight }} is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="BC_GAINS_filename" type="char*256" input_pathname="abs" category="carma_model"
       group="carma_model_nl" valid_values="" >
BC GAINS file.
Default: set by build-namelist.
</entry>

<entry id="OC_GAINS_filename" type="char*256" input_pathname="abs" category="carma_model"
       group="carma_model_nl" valid_values="" >
OC GAINS file.
Default: set by build-namelist.
</entry>

<entry id="BC_ship_filename" type="char*256" input_pathname="abs" category="carma_model"
       group="carma_model_nl" valid_values="" >
BC ship file.
Default: set by build-namelist.
</entry>

<entry id="OC_ship_filename" type="char*256" input_pathname="abs" category="carma_model"
       group="carma_model_nl" valid_values="" >
OC ship file.
Default: set by build-namelist.
</entry>

<entry id="BC_GFEDv3_filename" type="char*256" input_pathname="abs" category="carma_model"
       group="carma_model_nl" valid_values="" >
BC GFEDv3 file.
Default: set by build-namelist.
</entry>

<entry id="OC_GFEDv3_filename" type="char*256" input_pathname="abs" category="carma_model"
       group="carma_model_nl" valid_values="" >
OC GFEDv3 file.
Default: set by build-namelist.
</entry>

<entry id="Chlorophy11_file" type="char*256" input_pathname="abs" category="carma_model"
       group="carma_model_nl" valid_values="" >
Dust erosion factor file.
Default: set by build-namelist.
</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="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="pbuf_nl" 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="cam4,cam5,cam6,cam7,adiabatic,held_suarez,kessler,frierson" >
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="use_simple_phys" type="logical" category="build"
       group="phys_ctl_nl" valid_values="" >
Flag for simple 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="cam_chempkg" type="char*32" category="build" group="phys_ctl_nl"
       valid_values="none,ghg_mam4,terminator,trop_mam3,trop_mam4,trop_mam7,trop_mozart,trop_strat_mam4_ts2,
                     trop_strat_mam4_vbs,trop_strat_mam4_vbsext,trop_strat_mam4_slh,trop_strat_mam5_slh,
                     trop_strat_mam5_t1s1,trop_strat_mam5_t1s2,trop_strat_mam5_t2s1,trop_strat_mam5_t4s2,
                     trop_strat_mam5_vbsext,trop_strat_noaero,waccm_ma,waccm_mad,waccm_ma_sulfur,waccm_sc,
                     waccm_sc_mam4,waccm_mad_mam4,waccm_ma_mam4,waccm_tsmlt_mam4,waccm_tsmlt_mam4_vbsext,
                     waccm_tsmlt_mam4_slh,waccm_tsmlt_mam5_slh,waccm_mad_mam5,waccm_ma_mam5,waccm_tsmlt_mam5,
                     waccm_tsmlt_mam5_vbsext,waccm_t4ma_mam5,waccm_ma_noaero,geoschem_mam4">
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="cam_physics_mesh" type="char*256" input_pathname="abs"
       category="build" group="phys_ctl_nl" valid_values="" >
Full pathname to CAM physics grid ESMF mesh file.
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="use_hemco" type="logical" category="hemco"
       group="phys_ctl_nl" valid_values="" >
If TRUE then the Harmonized Emissions Component, HEMCO, will be used
to calculate emissions in chemistry. ext_frc_specifier and srf_emis_specifier
will be ignored.
Default: FALSE
</entry>

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

<entry id="oplus_adiff_limiter" type="real" category="waccmx"
       group="ionosphere_nl" valid_values="" >
Limiter for ambipolar diffusion coefficient used in O+ transport in the
ionosphere.
Default: 1.5e+8
</entry>

<entry id="oplus_shapiro_const" type="real" category="waccmx"
       group="ionosphere_nl" valid_values="" >
Shapiro constant for spatial smoother used in O+ transport in the
ionosphere.
Default: 0.03
</entry>

<entry id="oplus_enforce_floor" type="logical"  category="waccmx"
       group="ionosphere_nl" valid_values="">
Switch to apply floor to O+ concentrations within in ionosphere O+ transport.
Default: TRUE
</entry>

<entry id="oplus_ring_polar_filter" type="logical"  category="waccmx"
       group="ionosphere_nl" valid_values="">
Switch to apply ring polar filter within in ionosphere O+ transport.
Default: FALSE
</entry>

<entry id="oplus_grid" type="integer(2)"
       category="waccmx" group="ionosphere_nl" valid_values="" >
Oplus transport grid size, entered as num_longitudes, num_latitudes.
Default: set by build-namelist
</entry>

<entry id="edyn_grid" type="char*8"
       category="waccmx" group="ionosphere_nl" valid_values="80x97,160x193,320x385,640x769" >
Magnetic grid resolution (nlon x nlat).
Default: set by build-namelist
</entry>

<entry id="ionos_npes" type="integer"
       category="waccmx" group="ionosphere_nl" valid_values="" >
Number of MPI processes on which to run the WACCM-X ionosphere
electro-dynamo and O+ ion transport modules.
Default: 0 (use all atmosphere tasks)
</entry>

<entry id="ionos_xport_active" type="logical"  category="waccmx"
       group="ionosphere_nl" valid_values="">
Switch to to turn on/off O+ transport in ionosphere.
Default: set by build-namelist
</entry>

<entry id="ionos_xport_nsplit" type="integer"  category="waccmx"
       group="ionosphere_nl" valid_values="">
Number of ion transport steps per physics timestep.
Default: 5
</entry>

<entry id="ionos_edyn_active" type="logical"  category="waccmx"
       group="ionosphere_nl" valid_values="">
Switch to invoke electro-dynamo to compute ion drift velocities used in
O+ transport in ionosphere.  If false, ExB empirical model is used to
provide the ion drift velocities for O+ transport.
Default: set by build-namelist
</entry>

<entry id="ionos_epotential_model" type="char*16"  category="waccmx"
       group="ionosphere_nl" valid_values="heelis,weimer">
Electric potential model used in the waccmx ionosphere.
Default: set by build-namelist
</entry>

<entry id="ionos_debug_hist" type="logical"  category="waccmx"
       group="ionosphere_nl" valid_values="">
Switch to add history fields to master field list for the purpose
of debugging ionospheric processes in WACCMX.
Default: FALSE
</entry>

<entry id="epot_crit_colats" type="real*2"  category="waccmx"
       group="ionosphere_nl" valid_values="">
Co-latitudes (degrees) of the critical angles where the ionosphere
high-latitude electric potential is merged with the low and middle
latitude electric potential computed by the electro-dynamo of WACCM-X.
Default: none
</entry>

<entry id="wei05_coefs_file" type="char*256" input_pathname="abs" category="waccmx"
       group="ionosphere_nl" valid_values="" >
Full pathname of dataset for coefficient data used in Weimer05
high latitude electric potential model.
Default: set by build-namelist.
</entry>

<entry id="ionos_epotential_amie" type="logical"  category="waccmx"
       group="ionosphere_nl" valid_values="">
Give the user the ability to input prescribed high-latitude electric potential.
Default: FALSE
</entry>

<entry id="amienh_files" type="char*256(20)" input_pathname="abs" category="waccmx"
       group="ionosphere_nl" valid_values="" >
List of full pathnames of AMIE electic potential inputs for northern hemisphere.
Default: NONE.
</entry>

<entry id="amiesh_files" type="char*256(20)" input_pathname="abs" category="waccmx"
       group="ionosphere_nl" valid_values="" >
List of full pathnames of AMIE electic potential inputs for southern hemisphere.
Default: NONE.
</entry>

<entry id="ionos_epotential_ltr" type="logical"  category="waccmx"
       group="ionosphere_nl" valid_values="">
Give the user the ability to input LTR high-latitude electric potential.
Default: FALSE
</entry>

<entry id="ltr_files" type="char*256(20)" input_pathname="abs" category="waccmx"
       group="ionosphere_nl" valid_values="" >
List of full pathnames of LTR electic potential inputs for both hemispheres.
Default: NONE.
</entry>

<!-- HEMCO -->

<entry id="hemco_data_root" type="char*256" input_pathname="abs" category="hemco"
       group="hemco_nl" valid_values="" >
Full pathname of HEMCO data root for use in reading HEMCO input files.
(e.g., '$DIN_LOC_ROOT/atm/cam/geoschem/emis/ExtData/HEMCO').
Default: set by build-namelist.
</entry>

<entry id="hemco_config_file" type="char*256" input_pathname="abs" category="hemco"
       group="hemco_nl" valid_values="" >
Full pathname of the HEMCO_Config.rc input file used to configure HEMCO.
Default: set by build-namelist.
</entry>

<entry id="hemco_diagn_file" type="char*256" input_pathname="abs" category="hemco"
       group="hemco_nl" valid_values="" >
Full pathname of the HEMCO_Diagn.rc input file used to configure HEMCO diagnostics.
Default: set by build-namelist.
</entry>

<entry id="hemco_grid_xdim" type="integer" category="hemco"
       group="hemco_nl" valid_values="">
Number of x-dimensions in HEMCO internal grid.
Default: set by build-namelist.
</entry>

<entry id="hemco_grid_ydim" type="integer" category="hemco"
       group="hemco_nl" valid_values="">
Number of y-dimensions in HEMCO internal grid.
Default: set by build-namelist.
</entry>

<entry id="hemco_emission_year" type="integer" category="hemco"
       group="hemco_nl" valid_values="">
Force emission year for HEMCO clock if positive. This will force cycling of data on this year.
Default: set by build-namelist for climo cases, otherwise -1 to use model clock.
</entry>

<!-- GEOS-Chem model -->

<entry id="geoschem_chem_inputs" type="char*256" input_pathname="abs" category="geoschem"
       group="geoschem_nl" valid_values="" >
Full pathname of the GEOS-Chem chemistry inputs directory.
Default: set by build-namelist.
</entry>

<entry id="geoschem_aeropt_inputs" type="char*256" input_pathname="abs" category="geoschem"
       group="geoschem_nl" valid_values="" >
Full pathname of the aerosols optical property inputs directory used in GEOS-Chem outside of Cloud-J.
Default: set by build-namelist.
</entry>

<entry id="geoschem_photol_inputs" type="char*256" input_pathname="abs" category="geoschem"
       group="geoschem_nl" valid_values="" >
Full pathname of the Cloud-J photolysis inputs directory used in GEOS-Chem.
Default: set by build-namelist.
</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="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: set by build-namelist
</entry>

<entry id="do_hb_above_clubb" type="logical" category="pbl"
       group="phys_ctl_nl" valid_values="" >
Logical: If True activate Holtslag and Boville vertical diffusion scheme where CLUBB is not active
         (note that CLUBB top is dynamic in each column)
Default: Set by build-namelist.
</entry>

<!-- Convective Scavenging -->

<entry id="convproc_do_aer" type="logical"  category="conv"
       group="phys_ctl_nl" valid_values="" >
Switch to use new convective scavenging for modal aerosols.  This scheme
replaces the call to ZM's convtran for the the modal aerosol number and
mass mixing ratio constituents.
Default: .false.
</entry>

<entry id="convproc_do_gas" type="logical"  category="conv"
       group="aerosol_convproc_opts" valid_values="" >
Switch to turn on / off trace gas tendencies due to the MAM
convective cloud processing scheme.
Default: .false.
</entry>

<entry id="deepconv_wetdep_history" type="logical"  category="conv"
       group="aerosol_convproc_opts" valid_values="" >
Switch to turn on / off default history fields associated with aerosol
wet deposition fluxes as computed in the MAM convective cloud processing scheme.
Default: .true.
</entry>

<entry id="convproc_do_deep" type="logical"  category="conv"
       group="aerosol_convproc_opts" valid_values="" >
Switch to turn on / off deep convection in the MAM convective
cloud processing scheme.
Default: .true.
</entry>

<entry id="convproc_do_shallow" type="logical"  category="conv"
       group="aerosol_convproc_opts" valid_values="" >
Switch to turn on / off shallow convection in the MAM convective
cloud processing scheme.
Default: .false.
</entry>

<entry id="convproc_do_evaprain_atonce" type="logical"  category="conv"
       group="aerosol_convproc_opts" valid_values="" >
Switch to control when aerosols are released by rain re-evaporation in wet removal and redistribution
of aerosol mass in modes. If FALSE then aerosols are immediately released back to its original mode
from the rain as the rain evaporates. If TRUE the aerosols are released only when the rain totally
evaporates and the mass of given aerosol components is released back in the most coarse mode for
such component. For example, dust, sea salt and sulfate aerosols released by the rain evaporation are
redistributed to coarse mode aerosol mass.  Also, released POM, SOA and BC mass are redistributed into
accumulated mode aerosol mass.
Default: .false.
</entry>

<entry id="convproc_pom_spechygro" type="real" category="conv"
       group="aerosol_convproc_opts" valid_values="" >
Hygroscopicity of primary organic mater used in MAM convective cloud processing scheme.
Set to -1 to use the values defined in the physical properties file.
Default: -1
</entry>

<entry id="convproc_wup_max" type="real" category="conv"
       group="aerosol_convproc_opts" valid_values="" >
Maximum updraft velocity (m/s) in MAM convective cloud processing scheme.
Default: 4 m/s
</entry>

<!-- Diagnostics -->
<entry id="thermo_budget_histfile_num" type="integer"  category="diagnostics"
       group="thermo_budget_nl" valid_values="1,2,3,4,5,6,7,8,9,10" >
History tape number thermo budget output is written to.
Default: 1
</entry>

<entry id="thermo_budget_history" type="logical"  category="diagnostics"
       group="thermo_budget_nl" valid_values="" >
Produce output for the energy budget diagnostic package.
Default: .false.
</entry>

<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_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_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>

<entry id="history_waccmx" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch for diagnostic output used primarily for WACCM-X runs.
Default: .true. if WACCM-X is on, .false. otherwise.
</entry>

<entry id="history_chemistry" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch for diagnostics specific to the current chemistry package or
configuration.
Default: .true.
</entry>

<entry id="history_carma" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch for diagnostics specific to the current CARMA model.
Default: .false.
</entry>

<entry id="history_carma_srf_flx" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch for diagnostics specific to the current CARMA model.
Default: .false.
</entry>

<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="history_cesm_forcing" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch to turn on/off default output specific to CESM forcings.
Default: .false.
</entry>

<entry id="history_dust" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch for diagnostics specific to dust.
Default: .false.
</entry>

<entry id="history_scwaccm_forcing" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch to turn on/off default output specific to WACCM-SC forcings.
Default: .false.
</entry>

<entry id="history_chemspecies_srf" type="logical"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
Switch to turn on/off default output chemical species mixing ratios in the surface layer.
Default: .false.
</entry>

<entry id="offline_driver" type="logical" category="offline_unit_driver"
       group="phys_ctl_nl" valid_values="" >
True when model is configured to use an offline driver.
Default: Set by build-namelist.
</entry>

<entry id="atm_dep_flux" type="logical" category="fluxes"
       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 {{ hilight }}chem_rad_passive{{ closehilight }} 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="cam_snapshot_before_num" type="integer"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
History file number for before snapshots for CAM snapshot
Default:
</entry>

<entry id="cam_snapshot_after_num" type="integer"  category="diagnostics"
       group="phys_ctl_nl" valid_values="" >
History file number for after snapshots for CAM snapshot
Default:
</entry>

<entry id="cam_take_snapshot_before" type="char*32"  category="diagnostics"
       group="phys_ctl_nl" valid_values="chem_emissions,aoa_tracers_timestep_tend,co2_cycle_set_ptend,chem_timestep_tend,orographic_form_drag_stress,vertical_diffusion_section,aero_model_drydep,gw_tend,qbo_relax,iondrag_calc_section,physics_dme_adjust,physics_dme_adjust,dadadj_tend,convect_deep_tend,convect_shallow_tend,convect_diagnostics_calc,macrop_driver_tend,clubb_tend_cam,microp_section,microp_driver_tend_subcol,aero_model_wetdep,radiation_tend,held_suarez_tend,kessler_tend,thatcher_jablonowski_precip_tend,rk_stratiform_tend,rayleigh_friction_tend,user_set" >
Name of parameterization to take snapshot before running
user_set is used when a user inserts a call to cam_snapshot_all_outfld
  using cam_snapshot_before_num as the first argument.
Default: Unused
</entry>

<entry id="cam_take_snapshot_after" type="char*32"  category="diagnostics"
       group="phys_ctl_nl" valid_values="chem_emissions,aoa_tracers_timestep_tend,co2_cycle_set_ptend,chem_timestep_tend,orographic_form_drag_stress,vertical_diffusion_section,aero_model_drydep,gw_tend,qbo_relax,iondrag_calc_section,physics_dme_adjust,physics_dme_adjust,dadadj_tend,convect_deep_tend,convect_shallow_tend,convect_diagnostics_calc,macrop_driver_tend,clubb_tend_cam,microp_section,microp_driver_tend_subcol,aero_model_wetdep,radiation_tend,held_suarez_tend,kessler_tend,thatcher_jablonowski_precip_tend,rk_stratiform_tend,rayleigh_friction_tend,user_set" >
Name of parameterization to take snapshot after running
user_set is used when a user inserts a call to cam_snapshot_all_outfld
  using cam_snapshot_after_num as the first argument.
Default: Unused
</entry>

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

<entry id="conv_water_in_rad" type="integer" category="radiation"
       group="conv_water_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="conv_water_frac_limit" type="real" category="radiation"
       group="conv_water_nl" valid_values="" >
Lower limit of cumulus cloud fraction.
Default: set by build-namelist
</entry>

<entry id="use_rad_uniform_angle" type="logical" category="radiation"
       group="radiation_nl" valid_values="" >
If true, use a uniform angle for the calculation of coszrs within radiation
Default: set by build-namelist.
</entry>

<entry id="rad_uniform_angle" type="real" category="radiation"
       group="radiation_nl" valid_values="" >
The angle (in radians) to use in the calculation of coszrs within radiation
Default: set by build-namelist.
</entry>

<entry id="absems_data" type="char*256" input_pathname="abs" category="radiation"
       group="radiation_nl" valid_values="" >
Full pathname of absorption/emission dataset.  Used only by camrt scheme.
It consists of terms used for determining the absorptivity and
emissivity of water vapor in the longwave parameterization of radiation.
Default: set by build-namelist.
</entry>

<entry id="iradae" type="integer"  category="radiation"
       group="radiation_nl" valid_values="">
Frequency of absorptivity/emissivity calculations in time steps (if
positive) or model hours (if negative).  To avoid having the abs/ems values
saved on the restart output, make sure that the interval of the abs/ems
calculation evenly divides the restart interval.
Default: -12
</entry>

<entry id="iradlw" type="integer"  category="radiation"
       group="radiation_nl" valid_values="">
Frequency 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="">
Frequency 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="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="graupel_in_rad" type="logical"  category="radiation"
       group="radiation_nl" valid_values="" >
Calculate radiative effect of graupel/hail (using snow optics)
Default: FALSE
</entry>

<entry id="p_top_for_equil_rad" type="real"  category="radiation"
       group="radheat_nl" valid_values="" >
Top valid pressure level LTE radiation scheme
Default: 1.0 for WACCM/WACCMX
         2. for all other RRTMGP runs
         0.0 for all other runs
</entry>

<entry id="p_top_for_radmrg" type="real"  category="radiation"
       group="radheat_nl" valid_values="" >
Top pressure level LTE/non-LTE merger region
</entry>

<entry id="p_bot_for_radmrg" type="real"  category="radiation"
       group="radheat_nl" valid_values="" >
Bottom pressure level LTE/non-LTE merger region
</entry>

<entry id="qrsmlt_scaling" type="real"  category="radiation"
       group="radheat_nl" valid_values="" >
Scaling factor for simplified QRS MLT heating in CAM
</entry>

<entry id="use_rad_dt_cosz" type="logical"  category="radiation"
       group="radiation_nl" valid_values="" >
If true, then average the zenith angle over the radiation timestep rather
than using instantaneous values.
Default: FALSE
</entry>

<entry id="mode_defs" type="char*256(120)"  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="bin_defs" type="char*256(640)"  category="radiation"
       group="rad_cnst_nl" valid_values="" >
Definitions for the aerosol bins 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 radiation driver output data.
Default: 'A'
</entry>

<entry id="rad_data_fdh" type="logical"  category="offline_unit_driver"
       group="rad_data_nl" valid_values="" >
Switch to turn on Fixed Dynamical Heating in the offline radiation tool (PORT).
Default: false
</entry>

<!-- RRTMGP -->

<entry id="rrtmgp_coefs_lw_file" type="char*256" category="radiation"
       group="radiation_nl" valid_values="" >
Relative pathname for LW gas optics coefficients for RRTMGP.  This data is
part of the RRTMGP source, thus this pathname is relative to the root source
code directory for the CAM component.
Default: set by build-namelist.
</entry>

<entry id="rrtmgp_coefs_sw_file" type="char*256" category="radiation"
       group="radiation_nl" valid_values="" >
Relative pathname for SW gas optics coefficients for RRTMGP.  This data is
part of the RRTMGP source, thus this pathname is relative to the root source
code directory for the CAM component.
Default: set by build-namelist.
</entry>


<!-- Aerosol and cloud optics -->

<entry id="water_refindex_file" type="char*256" input_pathname="abs" category="radiation"
       group="aerosol_optics_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>


<!-- Rayleigh Friction Parameterization -->

<entry id="rayk0" type="integer" category="rayleigh_friction"
       group="rayleigh_friction_nl" 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="rayleigh_friction_nl" 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="rayleigh_friction_nl" 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>


<!-- Single column mode -->

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

<entry id="scm_cambfb_mode" type="logical" category="scam"
       group="scam_nl" valid_values="">
Column bfb match with cam generated IOP.
Default: FALSE
</entry>

<entry id="scm_backfill_iop_w_init" type="logical" category="scam"
       group="scam_nl" valid_values="">
Backfill missing IOP values for omega/T/q/Ps from initial data file.
Default: FALSE
</entry>

<entry id="scm_crm_mode" type="logical" category="scam"
       group="scam_nl" valid_values="">
Column radiation mode.
Default: FALSE
</entry>

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

<entry id="scm_clubb_iop_name" type="char*200" category="scam"
       group="scam_nl" valid_values="">
IOP name for CLUBB running in single column mode
Default: ""
</entry>

<entry id="scm_relaxation" type="logical" category="scam"
       group="scam_nl" valid_values="">
Use relaxation.
Default: FALSE
</entry>

<entry id="scm_relax_fincl" type="char*24(1000)"  category="scam"
       group="scam_nl" valid_values="" >
List of fields that will be relaxed to obs
Default: none
</entry>

<entry id="scm_relax_linear" type="logical" category="scam"
       group="scam_nl" valid_values="">
Use relaxation. Linearly interpolate the timescale within specified
pressure range. (bpm)
Default: FALSE
</entry>

<entry id="scm_relax_top_p" type="real" category="scam"
       group="scam_nl" valid_values="">
Upper most pressure that will be relaxed.
Default: 1e36
</entry>

<entry id="scm_relax_bot_p" type="real" category="scam"
       group="scam_nl" valid_values="">
Lower most pressure that will be relaxed.
Default: -1e36
</entry>

<entry id="scm_relax_tau_sec" type="real" category="scam"
       group="scam_nl" valid_values="">
SCAM relaxation time constant in seconds
Default: 10800
</entry>

<entry id="scm_relax_tau_top_sec" type="real" category="scam"
       group="scam_nl" valid_values="">
SCAM relaxation time constant in seconds that will be used at
top of pressure range (i.e., the smaller pressure value). Will
be used from top of pressure range to model top.
Default: 10800
</entry>

<entry id="scm_relax_tau_bot_sec" type="real" category="scam"
       group="scam_nl" valid_values="">
SCAM relaxation time constant in seconds that will be used at
bottom of pressure range (i.e., the larger pressure value).
Default: 10800
</entry>

<entry id="scm_use_obs_T" type="logical" category="scam"
       group="scam_nl" valid_values="">
Use the SCAM-IOP specified T instead of using forecasted T at each time step.
Default: FALSE
</entry>

<entry id="scm_use_obs_uv" type="logical" category="scam"
       group="scam_nl" valid_values="">
Use the SCAM-IOP specified u,v instead of using forecasted u,v at each time step.
Default: TRUE
</entry>

<entry id="scm_zadv_T"  type="char*16" category="scam"
       group="scam_nl" valid_values="iop,eulc,off">
Use specific type of vertical advection for T.  Possible choices are 'iop', 'eulc' and 'off'
Default: 'eulc'
</entry>

<entry id="scm_zadv_uv" type="char*16" category="scam"
       group="scam_nl" valid_values="iop,eulc,off">
Use specific type of vertical advection for uv. Possible choices are 'iop', 'eulc' and 'off'
Default: 'eulc'
</entry>

<entry id="scm_zadv_q" type="char*16" category="scam"
       group="scam_nl" valid_values="iop,eulc,slt,off">
Use specific type of vertical advection for q. Possible choices are 'iop', 'eulc', 'slt'  and 'off'
Default: 'slt'
</entry>

<entry id="scm_iop_lhflxshflxTg" type="logical" category="scam"
       group="scam_nl" valid_values="">
Use the SCAM-IOP specified surface LHFLX/SHFLX/ustar/Tg instead of using internally-computed values
Default: FALSE
</entry>

<entry id="scm_use_obs_qv" type="logical" category="scam"
       group="scam_nl" valid_values="">
Use the SCAM-IOP specified observed water vapor at each time step instead of forecast value
Default: FALSE
</entry>

<entry id="scm_use_3dfrc" type="logical" category="scam"
       group="scam_nl" valid_values="">
Use the SCAM-IOP 3d forcing if true, use combination of dycore vertical advection and iop horiz advection if false
Default:False
</entry>

<entry id="scm_force_latlon" type="logical" category="scam"
       group="scam_nl" valid_values="">
Force scam to use the lat lon fields specified in the scam namelist not what is closest to IOP avail lat lon
Default: FALSE
</entry>

<!-- Solar Parameters -->

<entry id="solar_const" type="real" category="solar"
       group="solar_data_opts" valid_values="">
Total solar irradiance (W/m2).
Default: 1361.27
</entry>

<entry id="solar_irrad_data_file" type="char*256" input_pathname="abs" category="solar"
       group="solar_data_opts" valid_values="" >
Full pathname of dataset for file that contains the solar photon energy spectra or TSI data
as a time series
Default: set by build-namelist
</entry>

<entry id="solar_euv_data_file" type="char*256" input_pathname="abs" category="solar"
       group="solar_data_opts" valid_values="" >
Full pathname of dataset for file that contains the solar EUV data
as a time series
Default: none
</entry>

<entry id="solar_parms_data_file" type="char*256" input_pathname="abs" category="waccm"
       group="solar_data_opts" valid_values="" >
Full pathname of time-variant 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="solar_wind_data_file" type="char*256" input_pathname="abs" category="waccm"
       group="solar_data_opts" valid_values="" >
Full pathname of time-variant  dataset for the time-dependent solar wind parameters
(solar wind velocity and density; IMF By and Bz components).
Default: set by build-namelist.
</entry>

<entry id="solar_data_type" type="char*8" category="solar"
       group="solar_data_opts" valid_values="FIXED,SERIAL" >
Type of time interpolation for data in {{ hilight }}solar_irrad_data_file{{ closehilight }}.
Can be set to "FIXED" or "SERIAL".
Default: SERIAL
</entry>

<entry id="solar_data_ymd" type="integer"  category="solar"
       group="solar_data_opts" valid_values="" >
If {{ hilight }}solar_data_type{{ closehilight }} is "FIXED" then solar_data_ymd
is the date the solar data is fixed to.  If {{ hilight }}solar_data_type{{ closehilight }}
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_data_opts" valid_values="" >
Seconds of the day corresponding to {{ hilight }}solar_data_ymd{{ closehilight }}
Default: current model time of day
</entry>

<entry id="solar_htng_spctrl_scl" type="logical"  category="solar"
       group="solar_data_opts" valid_values="" >
Use spectral scaling in the radiation heating
Default: set by build-namelist
</entry>

<!-- Test Tracers -->

<entry id="test_tracer_names" type="char*16(30)" category="test_tracers"
       group="test_tracers_nl" valid_values="" >
User can specify names for test tracers to be read from the initial file.
The number of names specified should be given as the value of the -nadv_tt
option to configure.
Default: ''
</entry>

<entry id="test_tracer_num" type="logical" category="test_tracers"
       group="test_tracers_nl" 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 variable to
the value N.  If {{ hilight }}test_tracer_names{{ closehilight }} have been specified
then N should be the number of names supplied.
If {{ hilight }}test_tracer_names{{ closehilight }} have not been specified, then the
tracer_suite module generates the tracer names and supplies the initial
values.
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="integer"  category="time_mgr"
       group="camexp" valid_values="">
The length (in seconds) of the atm time step, i.e., the driver calls the
atm component once every dtime seconds.  This is also the coupling interval
between the dynamics and physics packages.  This variable is not actually
used in the atm model, but rather is used by build-namelist to set the
value of {{ hilight }}atm_cpl_dt{{ closehilight }}.  So it will have an effect only
when running CAM using standalone scripts.  The CESM scripts have their own
method for setting {{ hilight }}atm_cpl_dt{{ closehilight }}.
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_initfiles_nl" valid_values="" >
Full pathname of time-invariant boundary dataset for topography fields.
Default: set by build-namelist.
</entry>

<entry id="use_topo_file" type="logical" category="topo"
       group="cam_initfiles_nl" valid_values="" >
Setting use_topo_file=.false. allows the user to specify that PHIS, SGH,
SGH30, and LANDM_COSLAT are all zero without having to supply a topo file
full of zeros.
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>

<!-- 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,OFF" >
Wet deposition method used
  MOZ --> mozart scheme is used
  NEU --> J Neu's scheme is used
  OFF --> wet deposition is turned off
Default: NEU
</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="gas_wetdep_ice_uptake_list" type="char*16(1000)" category="cam_chem"
       group="wetdep_inparm" valid_values="" >
List of gas-phase species that undergo ice scavenging in the NEU
wet deposition scheme.
Default: set by build-namelist
</entry>

<!-- Short-Lived Halogen (SLH) Namelist Definitions -->

<entry id="SSAdehal_ScalingFactor" type="real" category="cam_chem"
       group="slh_nl" valid_values="" >
Scaling-factor for SLH dehalogenation reaction (XONO2,XNO2,HOX) on Sea-Salt Aerosols.
Default: set by build-namelist
</entry>

<entry id="SSAhno3_ScalingFactor" type="real" category="cam_chem"
       group="slh_nl" valid_values="" >
Scaling-factor for SLH acid displacement reaction (HNO3-->HCl) on Sea-Salt Aerosols.
Default: set by build-namelist
</entry>

<entry id="SSAn2o5_ScalingFactor" type="real" category="cam_chem"
       group="slh_nl" valid_values="" >
Scaling-factor for SLH dinitrogen pentoxide reaction (N2O5-->HNO3+CLNO2) on Sea-Salt Aerosols
Default: set by build-namelist.
</entry>

<entry id="LIQfraprx_ScalingFactor_I" type="real" category="cam_chem"
       group="slh_nl" valid_values="" >
Scaling-factor for SLH washout (Iodine) on liquid droplets based on Free-Regime Approx.
Default: set by build-namelist
</entry>

<entry id="ICEfraprx_ScalingFactor_I" type="real" category="cam_chem"
       group="slh_nl" valid_values="" >
Scaling-factor for SLH washout (Iodine) on ice crystals based on Free-Regime Approx.
Default: set by build-namelist
</entry>

<entry id="ICEfraprx_ScalingFactor_Br" type="real" category="cam_chem"
       group="slh_nl" valid_values="" >
Scaling-factor for SLH washout (Bromine) on ice crystals based on Free-Regime Approx.
Default: set by build-namelist
</entry>

<entry id="modal_accum_coarse_exch" type="logical" category="cam_chem"
       group="aerosol_nl" valid_values="" >
Turns on accumulation to coarse mode exchange appropriate for the stratosphere.
This also changes the default mode definitions (widths and edges) via default
aerosol property input files.
Default: FALSE
</entry>

<entry id="modal_strat_sulfate" type="logical" category="cam_chem"
       group="aerosol_nl" valid_values="" >
Turns on prognostic modal sulfate aerosols in the stratosphere.
Default: FALSE
</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="SO4_sol_facti" type="real" category="cam_chem"
       group="camexp" valid_values="" >
In-cloud solubility factor used in SO4 wet removal
Default: set by build-namelist.
</entry>
<entry id="SO4_sol_factb" type="real" category="cam_chem"
       group="camexp" valid_values="" >
Below-cloud solubility factor used in SO4 wet removal
Default: set by build-namelist.
</entry>
<entry id="NH4_sol_facti" type="real" category="cam_chem"
       group="camexp" valid_values="" >
In-cloud solubility factor used in NH4 wet removal
Default: set by build-namelist.
</entry>
<entry id="NH4_sol_factb" type="real" category="cam_chem"
       group="camexp" valid_values="" >
Below-cloud solubility factor used in NH4 wet removal
Default: set by build-namelist.
</entry>
<entry id="NH4NO3_sol_facti" type="real" category="cam_chem"
       group="camexp" valid_values="" >
In-cloud solubility factor used in NH4NO3 wet removal
Default: set by build-namelist.
</entry>
<entry id="NH4NO3_sol_factb" type="real" category="cam_chem"
       group="camexp" valid_values="" >
Below-cloud solubility factor used in NH4NO3 wet removal
Default: set by build-namelist.
</entry>
<entry id="CB2_sol_facti" type="real" category="cam_chem"
       group="camexp" valid_values="" >
In-cloud solubility factor used in CB2 wet removal
Default: set by build-namelist.
</entry>
<entry id="CB2_sol_factb" type="real" category="cam_chem"
       group="camexp" valid_values="" >
Below-cloud solubility factor used in CB2 wet removal
Default: set by build-namelist.
</entry>
<entry id="OC2_sol_facti" type="real" category="cam_chem"
       group="camexp" valid_values="" >
In-cloud solubility factor used in OC2 wet removal
Default: set by build-namelist.
</entry>
<entry id="OC2_sol_factb" type="real" category="cam_chem"
       group="camexp" valid_values="" >
Below-cloud solubility factor used in OC2 wet removal
Default: set by build-namelist.
</entry>
<entry id="dust_sol_facti" type="real" category="cam_chem"
       group="camexp" valid_values="" >
In-cloud solubility factor used in wet removal of BULK dust
Default: set by build-namelist.
</entry>
<entry id="dust_sol_factb" type="real" category="cam_chem"
       group="camexp" valid_values="" >
Below-cloud solubility factor used in wet removal of BULK dust
Default: set by build-namelist.
</entry>
<entry id="sslt_sol_facti" type="real" category="cam_chem"
       group="camexp" valid_values="" >
In-cloud solubility factor used in wet removal of BULK sea salt
Default: set by build-namelist.
</entry>
<entry id="sslt_sol_factb" type="real" category="cam_chem"
       group="camexp" valid_values="" >
Below-cloud solubility factor used in wet removal of BULK sea salt
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="aero_wetdep_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="aero_wetdep_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="aero_wetdep_nl" valid_values="" >
Tuning for in-cloud scavenging of cloud-borne modal aerosols.
Default: set by build-namelist.
</entry>

<entry id="seasalt_emis_scale" type="real" category="cam_chem"
       group="aerosol_nl" valid_values="" >
Tuning for seasalt_emis
Default: set by build-namelist.
</entry>

<entry id="aer_sol_facti" type="real(1000)" category="cam_chem"
       group="aerosol_nl" valid_values="" >
In-cloud solubility factor used in BULK aerosol wet removal
Default: set by build-namelist.
</entry>

<entry id="aer_sol_factb" type="real(1000)" category="cam_chem"
       group="aerosol_nl" valid_values="" >
Below-cloud solubility factor used in BULK aerosol wet removal
Default: set by build-namelist.
</entry>

<entry id="aer_scav_coef" type="real(1000)" category="cam_chem"
       group="aerosol_nl" valid_values="" >
Scavenging coefficient used in BULK aerosol wet removal
Default: set by build-namelist.
</entry>

<entry id="SO4_scav_coef" type="real(1000)" category="cam_chem"
       group="camexp" valid_values="" >
Scavenging coefficient used in the wet removal of SO4
Default: set by build-namelist.
</entry>

<entry id="NH4_scav_coef" type="real(1000)" category="cam_chem"
       group="camexp" valid_values="" >
Scavenging coefficient used in the wet removal of NH4
Default: set by build-namelist.
</entry>

<entry id="CB2_scav_coef" type="real(1000)" category="cam_chem"
       group="camexp" valid_values="" >
Scavenging coefficient used in the wet removal of CB2
Default: set by build-namelist.
</entry>

<entry id="OC2_scav_coef" type="real(1000)" category="cam_chem"
       group="camexp" valid_values="" >
Scavenging coefficient used in the wet removal of OC2
Default: set by build-namelist.
</entry>

<entry id="DST01_scav_coef" type="real(1000)" category="cam_chem"
       group="camexp" valid_values="" >
Scavenging coefficient used in the wet removal of DST01
Default: set by build-namelist.
</entry>

<entry id="DST02_scav_coef" type="real(1000)" category="cam_chem"
       group="camexp" valid_values="" >
Scavenging coefficient used in the wet removal of DST02
Default: set by build-namelist.
</entry>

<entry id="DST03_scav_coef" type="real(1000)" category="cam_chem"
       group="camexp" valid_values="" >
Scavenging coefficient used in the wet removal of DST03
Default: set by build-namelist.
</entry>

<entry id="DST04_scav_coef" type="real(1000)" category="cam_chem"
       group="camexp" valid_values="" >
Scavenging coefficient used in the wet removal of DST04
Default: set by build-namelist.
</entry>

<entry id="SSLT01_scav_coef" type="real(1000)" category="cam_chem"
       group="camexp" valid_values="" >
Scavenging coefficient used in the wet removal of SSLT01
Default: set by build-namelist.
</entry>

<entry id="SSLT02_scav_coef" type="real(1000)" category="cam_chem"
       group="camexp" valid_values="" >
Scavenging coefficient used in the wet removal of SSLT02
Default: set by build-namelist.
</entry>

<entry id="SSLT03_scav_coef" type="real(1000)" category="cam_chem"
       group="camexp" valid_values="" >
Scavenging coefficient used in the wet removal of SSLT03
Default: set by build-namelist.
</entry>

<entry id="SSLT04_scav_coef" type="real(1000)" category="cam_chem"
       group="camexp" valid_values="" >
Scavenging coefficient used in the wet removal of SSLT04
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="depvel_lnd_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="chem_inparm" valid_values="" >
Full pathname of dataset which contains land vegetation information used in modal aerosol deposition.
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>

<entry id="steady_state_ion_elec_temp" type="logical" category="waccmx"
       group="ion_electron_temp_nl" valid_values="" >
If TRUE a steady state solution is used to calculate electron and
ion temperature.
Default: TRUE
</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_potential_max" type="real" category="waccm_phys"
       group="iondrag_nl" valid_values="" >
Maximum cross cap electric potential used in Heelis high-latitude potential
empirical model for WACCM ion drag and joule heating.
Default: set by build-namelist (120 kV).
</entry>

<entry id="empirical_ion_velocities" type="logical" category="waccm_phys"
       group="iondrag_nl" valid_values="" >
Switch to turn on empirical ExB ion drift velocities model for use in ion drag
parameterizations.  If this is false then it is assumed ion drift velocities are
supplied by an active ionosphere 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 {{ hilight }}srf_emis_specifier{{ closehilight }}.
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 {{ hilight }}srf_emis_type{{ closehilight }}  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 {{ hilight }}srf_emis_type{{ closehilight }} 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 {{ hilight }}srf_emis_fixed_ymd{{ closehilight }}
at which the surface emissions are fixed
if {{ hilight }}srf_emis_type{{ closehilight }} 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="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 {{ hilight }}ext_frc_type{{ closehilight }}  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 {{ hilight }}ext_frc_type{{ closehilight }} 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 {{ hilight }}ext_frc_fixed_ymd{{ closehilight }}
at which the external forcings are fixed
if {{ hilight }}ext_frc_type{{ closehilight }} 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 {{ hilight }}ext_frc_specifier{{ closehilight }}.  The
{{ hilight }}ext_frc_specifier{{ closehilight }} variable tells the model which species have elevated
emissions and the file path for the corresponding species.  That is, the
{{ hilight }}ext_frc_specifier{{ closehilight }} 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 {{ hilight }}flbc_type{{ closehilight }}  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 {{ hilight }}flbc_type{{ closehilight }} 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 {{ hilight }}flbc_fixed_ymd{{ closehilight }}
at which the fixed lower boundary data is fixed
if {{ hilight }}flbc_type{{ closehilight }} 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="lght_no_prd_factor" type="real" category="cam_chem"
       group="lightning_nl" valid_values="" >
Multiplication factor  applied to the lighting NOx production
Default: 1.0.
</entry>

<entry id="no_xfac_ubc" type="real" category="waccm"
       group="upper_bc_opts" 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="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="" >
Filename of file that contains aircraft input file lists. The filenames in the files are relative
to the directory specified by {{ hilight }}aircraft_datapath{{ closehilight }}.
Default: set by build-namelist.
</entry>

<entry id="aircraft_datapath" type="char*256" input_pathname="abs" 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: set by build-namelist.
</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="aircraft_co2_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="camexp" valid_values="" >
Full pathname of the ac_CO2 file specified in the filelist in
{{ hilight }}aircraft_specifier{{ closehilight }}.  This is only to
get this name into the cam.input_data_list for the CESM scripts.
Default: set by build-namelist.
</entry>



<entry id="gcr_ionization_datapath" type="char*256" input_pathname="abs" category="cam_chem"
       group="gcr_ionization_nl" valid_values="" >
Full pathname of the directory that contains the files specified in
{{ hilight }}gcr_ionization_filelist{{ closehilight }}.
Default: set by build-namelist.
</entry>

<entry id="gcr_ionization_filename" type="char*256" input_pathname="rel:gcr_ionization_datapath" category="cam_chem"
       group="gcr_ionization_nl" valid_values="" >
Filename of dataset for ionization rates by galactic cosmic rays.
Default: set by build-namelist.
</entry>

<entry id="gcr_ionization_filelist" type="char*256" input_pathname="rel:gcr_ionization_datapath" category="cam_chem"
       group="gcr_ionization_nl" valid_values="" >
Filename of file that contains a sequence of filenames for ionization
rates by galactic cosmic rays.  The filenames in this file are relative
to the directory specified by {{ hilight }}gcr_ionization_datapath{{ closehilight }}.
Default: set by build-namelist.
</entry>

<entry id="gcr_ionization_fldname" type="char*16" category="cam_chem"
       group="gcr_ionization_nl" valid_values="" >
Names of variables containing ionization rates (/cm3/sec) in the cosmic rays datasets.
Default: none
</entry>

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

<entry id="gcr_ionization_cycle_yr" type="integer" category="cam_chem"
       group="gcr_ionization_nl" valid_values="" >
The  cycle year of the prescribed green house gas data
if {{ hilight }}gcr_ionization_type{{ closehilight }}  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="gcr_ionization_fixed_ymd" type="integer" category="cam_chem"
       group="gcr_ionization_nl" valid_values="" >
The date at which the prescribed green house gas data  is fixed
if {{ hilight }}gcr_ionization_type{{ closehilight }} is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="gcr_ionization_fixed_tod" type="integer" category="cam_chem"
       group="gcr_ionization_nl" valid_values="" >
The time of day (seconds) corresponding to {{ hilight }}gcr_ionization_fixed_ymd{{ closehilight }}
at which the prescribed green house gas data is fixed
if {{ hilight }}gcr_ionization_type{{ closehilight }} is 'FIXED'.
Default: 0 seconds
</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
{{ hilight }}prescribed_aero_filelist{{ closehilight }}.
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 {{ hilight }}prescribed_aero_specifier{{ closehilight }} and
{{ hilight }}aerodep_flx_specifier{{ closehilight }} 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 specified
by {{ hilight }}prescribed_aero_datapath{{ closehilight }}.
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 {{ hilight }}prescribed_aero_type{{ closehilight }}  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 {{ hilight }}prescribed_aero_type{{ closehilight }} 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 {{ hilight }}prescribed_aero_fixed_ymd{{ closehilight }}
at which the prescribed aerosol data is fixed
if {{ hilight }}prescribed_aero_type{{ closehilight }} 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
{{ hilight }}aerodep_flx_filelist{{ closehilight }}.
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 specified
by {{ hilight }}aerodep_flx_datapath{{ closehilight }}.
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 {{ hilight }}aerodep_flx_type{{ closehilight }}  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 {{ hilight }}aerodep_flx_type{{ closehilight }} 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 {{ hilight }}ssaerodep_flx_fixed_ymd{{ closehilight }}
at which the prescribed aerosol flux data is fixed
if {{ hilight }}saerodep_flx_type{{ closehilight }} is 'FIXED'.
Default: 0 seconds
</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
{{ hilight }}prescribed_ghg_filelist{{ closehilight }}.
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 specified
by {{ hilight }}prescribed_ghg_datapath{{ closehilight }}.
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 {{ hilight }}prescribed_ghg_type{{ closehilight }}  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 {{ hilight }}prescribed_ghg_type{{ closehilight }} 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 {{ hilight }}prescribed_ghg_fixed_ymd{{ closehilight }}
at which the prescribed green house gas data is fixed
if {{ hilight }}prescribed_ghg_type{{ closehilight }} 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
{{ hilight }}prescribed_ozone_filelist{{ closehilight }}.
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 specified
by {{ hilight }}prescribed_ozone_datapath{{ closehilight }}.
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 {{ hilight }}prescribed_ozone_type{{ closehilight }}  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 {{ hilight }}prescribed_ozone_type{{ closehilight }} 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 {{ hilight }}prescribed_ozone_fixed_ymd{{ closehilight }}
at which the prescribed ozone data is fixed
if {{ hilight }}prescribed_ozone_type{{ closehilight }} 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
{{ hilight }}prescribed_volcaero_filelist{{ closehilight }}.
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
volcanic aerosols.  The filenames in this file are relative to the directory specified
by {{ hilight }}prescribed_volcaero_datapath{{ closehilight }}.
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_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 {{ hilight }}prescribed_volcaero_type{{ closehilight }}  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 {{ hilight }}prescribed_volcaero_type{{ closehilight }} 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 {{ hilight }}prescribed_volcaero_fixed_ymd{{ closehilight }}
at which the prescribed volcanic aerosol data is fixed
if {{ hilight }}prescribed_volcaero_type{{ closehilight }} is 'FIXED'.
Default: 0 seconds
</entry>


<entry id="prescribed_strataero_datapath" type="char*256" input_pathname="abs" category="cam_chem"
       group="prescribed_strataero_nl" valid_values="" >
Full pathname of the directory that contains the files specified in
{{ hilight }}prescribed_strataero_filelist{{ closehilight }}.
Default: set by build-namelist.
</entry>

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

<entry id="prescribed_strataero_filelist" type="char*256" input_pathname="rel:prescribed_strataero_datapath" category="cam_chem"
       group="prescribed_strataero_nl" valid_values="" >
Filename of file that contains a sequence of filenames for prescribed
stratospheric aerosols.  The filenames in this file are relative to the directory specified
by {{ hilight }}prescribed_strataero_datapath{{ closehilight }}.
Default: set by build-namelist.
</entry>

<entry id="prescribed_strataero_specifier" type="char*16" category="cam_chem"
       group="prescribed_strataero_nl" valid_values="" >
Name of variable containing prescribed stratospheric aerosol specifiers
Default: set by the CAM program
</entry>

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

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

<entry id="prescribed_strataero_cycle_yr" type="integer" category="cam_chem"
       group="prescribed_strataero_nl" valid_values="" >
The  cycle year of the prescribed volcanic aerosol data
if {{ hilight }}prescribed_strataero_type{{ closehilight }}  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="prescribed_strataero_fixed_ymd" type="integer" category="cam_chem"
       group="prescribed_strataero_nl" valid_values="" >
The date at which the prescribed volcanic aerosol data  is fixed
if {{ hilight }}prescribed_strataero_type{{ closehilight }} is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="prescribed_strataero_fixed_tod" type="integer" category="cam_chem"
       group="prescribed_strataero_nl" valid_values="" >
The time of day (seconds) corresponding to {{ hilight }}prescribed_strataero_fixed_ymd{{ closehilight }}
at which the prescribed volcanic aerosol data is fixed
if {{ hilight }}prescribed_strataero_type{{ closehilight }} is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="prescribed_strataero_feedback" type="logical" category="cam_chem"
       group="camexp" valid_values="" >
Switch to turn on climate feed backs due to prescribed stratospheric aerosols via
the rad_climate namelist variable.
Default: false
</entry>

<entry id="prescribed_strataero_3modes" type="logical" category="cam_chem"
       group="camexp" valid_values="" >
If true the prescribed stratospheric aerosols have three distribution modes.
Default: true for CAM6, otherwise false
</entry>

<entry id="prescribed_strataero_use_chemtrop" type="logical" category="aerosol"
       group="prescribed_strataero_nl" valid_values="" >
Indicates whether to use the unified chemistry tropopause method to set prescribed
stratospheric aerosols below the tropopause to zero.  This has a maximum altitude
level corresponding to 300 hPa for latitudes poleward of 50 degrees.
Default: set by build-namelist
</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="snoe_ubc_file" type="char*256" input_pathname="abs" category="waccm"
       group="upper_bc_opts" 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="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 {{ hilight }}srf_emis_specifier{{ closehilight }}.  The
{{ hilight }}srf_emis_specifier{{ closehilight }} variable tells the model which species have emissions
and the file path for the corresponding species.  That is, the
{{ hilight }}srf_emis_specifier{{ closehilight }} 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="emissions_specifier" type="char*256(50)" category="cam_chem"
       group="surface_emissions_opts" valid_values="" >
List of full pathnames of surface emission datasets.

Surface emission data added to physcis buffer read from a set of netcdf file.
Each tracer species emissions is read from its own file as directed by the
namelist variable {{ hilight }}emissions_specifier{{ closehilight }}.  The
{{ hilight }}emissions_specifier{{ closehilight }} variable tells the model
which species have emissions and the file path for the corresponding species.
That is, the {{ hilight }}emissions_specifier{{ closehilight }} variable is
set something like:

 emissions_specifier = 'BC -> /path/emis.BC.nc',
                       'OC -> /path/emis.OC.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="emissions_type" type="char*32" category="cam_chem"
       group="surface_emissions_opts" 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 {{ hilight }}emissions_specifier{{ closehilight }}.
Default: 'CYCLICAL'
</entry>

<entry id="emissions_cycle_yr" type="integer" category="cam_chem"
       group="surface_emissions_opts" valid_values="" >
The  cycle year of the surface emissions data
if {{ hilight }}emissions_type{{ closehilight }}  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="emissions_fixed_ymd" type="integer" category="cam_chem"
       group="surface_emissions_opts" valid_values="" >
The date at which the surface emissions are fixed
if {{ hilight }}emissions_type{{ closehilight }} is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="emissions_fixed_tod" type="integer" category="cam_chem"
       group="surface_emissions_opts" valid_values="" >
The time of day (seconds) corresponding to {{ hilight }}emissions_fixed_ymd{{ closehilight }}
at which the surface emissions are fixed
if {{ hilight }}emissions_type{{ closehilight }} is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="sulf_file" type="char*256" input_pathname="abs" category="cam_chem"
       group="sulf_nl" valid_values="" >
Full pathname of dataset containing tropopheric sulfate aerosols
Default: set by build-namelist.
</entry>

<entry id="sulf_datapath" type="char*256" input_pathname="abs" category="cam_chem"
       group="sulf_nl" valid_values="" >
Full pathname of the directory that contains the files specified in
{{ hilight }}sulf_filelist{{ closehilight }}.
Default: set by build-namelist.
</entry>

<entry id="sulf_filelist" type="char*256" input_pathname="rel:sulf_datapath" category="cam_chem"
       group="sulf_nl" valid_values="" >
Filename of file that contains a sequence of filenames for prescribed
sulfate.  The filenames in this file are relative to the directory specified
by {{ hilight }}sulf_datapath{{ closehilight }}.
Default: set by build-namelist.
</entry>

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

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

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

<entry id="sulf_cycle_yr" type="integer" category="cam_chem"
       group="sulf_nl" valid_values="" >
The  cycle year of the prescribed sulfate data
if {{ hilight }}sulf_type{{ closehilight }}  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="sulf_fixed_ymd" type="integer" category="cam_chem"
       group="sulf_nl" valid_values="" >
The date at which the prescribed sulfate data is fixed
if {{ hilight }}sulf_type{{ closehilight }} is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="sulf_fixed_tod" type="integer" category="cam_chem"
       group="sulf_nl" valid_values="" >
The time of day (seconds) corresponding to {{ hilight }}sulf_fixed_ymd{{ closehilight }}
at which the prescribed sulfate data is fixed
if {{ hilight }}sulf_type{{ closehilight }} is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="tgcm_ubc_file" type="char*256" input_pathname="abs" category="waccm"
       group="upper_bc_opts" 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="upper_bc_opts" 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="upper_bc_opts" valid_values="" >
The cycle year of the TGCM upper boundary data
if {{ hilight }}tgcm_ubc_type{{ closehilight }}  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="tgcm_ubc_fixed_ymd" type="integer" category="waccm"
       group="upper_bc_opts" valid_values="" >
The date at which the TGCM upper boundary data is fixed
if {{ hilight }}tgcm_ubc_type{{ closehilight }} is 'FIXED'.
Format: YYYY
Default: 0
</entry>

<entry id="tgcm_ubc_fixed_tod" type="integer" category="waccm"
       group="upper_bc_opts" valid_values="" >
The time of day (seconds) corresponding to {{ hilight }}tgcm_ubc_fixed_ymd{{ closehilight }}
at which the TGCM upper boundary data is fixed
if {{ hilight }}tgcm_ubc_type{{ closehilight }} is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="t_pert_ubc" type="real" category="waccm"
       group="upper_bc_opts" valid_values="" >
Perturbation applied to the upper boundary temperature.
Default: 0.0
</entry>

<entry id="ubc_specifier" type="char*64(pcnst)"  category="upper_boundary"
       group="upper_bc_opts" valid_values="" >

List of fields that have fixed upper boundary conditions (temperature and mass mixing ratios)
and corresponding data sources. Each entry in this list is of the form:
  FLD->source
where source may be of the following:
  MSIS - NRL neutral atmosphere empirical model (Mass Spectrometer Incoherent Scatter radar)
  TGCM - Input file generated by Thermospheric General Circulation Model
  SNOE - Input file generated from Student Nitric Oxide Explorer satellite observations
  UBC_FILE - Generalized input file which spans the upper boundary altitude
  value (mmr|vmr) - Set to a constant value (e.g., 1.2e-6 mmr)

These fields can be set to constant values with units of "mmr" (mass mixing ratio)
or "vmr" (volume mixing ratio).  The upper boundary values of source UBC_FILE are prescribed
in the UBC_FILE_path file. Fields of source UBC_FILE may include a CAM constituent name
and a file field name separated by ":".

Note: Constituents not included in ubc_specifier default to zero flux through the upper boundary.

Example:
  ubc_specifier = 'Q:H2O->UBC_FILE', 'CH4->2.D-10vmr', 'F->1.0D-15mmr', 'HF->1.0D-15mmr',
                  'T->MSIS', 'H->MSIS', 'N->MSIS','O->MSIS', 'O2->MSIS', 'H2->TGCM', 'NO->SNOE'

Default: set by build-namelist
</entry>

<entry id="ubc_file_path" type="char*512" input_pathname="abs" category="upper_boundary"
       group="upper_bc_file_opts" valid_values="" >
Full path of the file containing prescribed upper boundary conditions.
Default: NONE
</entry>

<entry id="ubc_file_input_type" type="char*32" category="upper_boundary"
       group="upper_bc_file_opts" valid_values="CYCLICAL,SERIAL,INTERP_MISSING_MONTHS,FIXED" >
Type of time interpolation for data in {{ hilight }}ubc_file_path file{{ closehilight }}.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.
Default: NONE
</entry>

<entry id="ubc_file_cycle_yr" type="integer" category="upper_boundary"
       group="upper_bc_file_opts" valid_values="" >
The cycle year of the prescribed upper boundary data
if {{ hilight }}ubc_file_input_type{{ closehilight }} is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="ubc_file_fixed_ymd" type="integer" category="upper_boundary"
       group="upper_bc_file_opts" valid_values="" >
The date at which the upper boundary data is fixed
if {{ hilight }}ubc_file_input_type{{ closehilight }} is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="ubc_file_fixed_tod" type="integer" category="upper_boundary"
       group="upper_bc_file_opts" valid_values="" >
The time of day (seconds) corresponding to {{ hilight }}ubc_file_fixed_ymd{{ closehilight }}
at which the upper boundary data is fixed
if {{ hilight }}ubc_file_input_type{{ closehilight }} is 'FIXED'.
Default: 0 seconds
</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="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
{{ hilight }}tracer_cnst_filelist{{ closehilight }}.
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 specified
by {{ hilight }}tracer_cnst_datapath{{ closehilight }}.
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 {{ hilight }}tracer_cnst_type{{ closehilight }}  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 {{ hilight }}tracer_cnst_type{{ closehilight }} 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 {{ hilight }}tracer_cnst_fixed_ymd{{ closehilight }}
at which the chemical constituents data is fixed
if {{ hilight }}tracer_cnst_type{{ closehilight }} 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
{{ hilight }}tracer_srcs_filelist{{ closehilight }}.
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 specified
by {{ hilight }}tracer_srcs_datapath{{ closehilight }}.
Default: set by build-namelist.
</entry>

<entry id="tracer_srcs_rmfile" type="logical" category="cam_chem"
       group="chem_inparm" valid_values="" >
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 {{ hilight }}tracer_srcs_type{{ closehilight }}  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 {{ hilight }}tracer_srcs_type{{ closehilight }} 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 {{ hilight }}tracer_srcs_fixed_ymd{{ closehilight }}
at which the chemical sources data is fixed
if {{ hilight }}tracer_srcs_type{{ closehilight }} is 'FIXED'.
Default: 0 seconds
</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>

<entry id="photo_max_zen" type="real" category="cam_chem"
       group="chem_inparm" valid_values="" >
Maximum zenith angle (degrees) used for photolysis.
Default: set by build-namelist.
</entry>

<entry id="tuvx_config_path" type="char*256" input_pathname="abs" category="chemistry"
       group="tuvx_opts" valid_values="" >
Filepath of TUV-X configuration specification.
Default: NONE
</entry>

<entry id="tuvx_active" type="logical" category="chemistry"
       group="tuvx_opts" valid_values="" >
Switch to turn on TUV-X photolysis.
Default: FALSE
</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="dep_data_file" type="char*500" input_pathname="abs" category="dry_deposition"
       group="drydep_inparm" valid_values="" >
Full pathname of file containing gas phase deposition data including effective
Henry's law coefficients.
Default: set by build-namelist.
</entry>

<entry id="rxn_rate_sums" type="char*256(200)" category="cam_chem"
       group="rxn_rate_diags_nl" valid_values="" >
Give the user the ability to specify rate families (or groupings) diagnostics based
on reaction tag names. These group names can be added to history fincl variables.
A "+" character at the end of a string indicates that the summation will continue with the next string.
Example:
 rate_sums =
   'OX_P = NO_HO2 + CH3O2_NO + 2*jo2_b ... ',
   'OX_L = NO2_O_M + HO2_O3 + CLO_O ...',
   'RO2_RO2_sum = CH3O2_CH3O2a + CH3O2_CH3O2b + C2H5O2_CH3O2 + C2H5O2_C2H5O2 + CH3CO3_CH3O2 +',
               'CH3CO3_CH3CO3 + CH3H7O2_CH3O2 + RO2_CH3O2 + MACRO2_CH3O2 ...',
 fincl1 = 'OX_P','OX_L', 'RO2_RO2_sum', ...
Default: none
</entry>

<entry id="vmr_sums" type="char*256(200)" category="cam_chem"
       group="species_sums_nl" valid_values="" >
Give the user the ability to specify species families (or groupings) diagnostics in volume mixing ratio.
These group names can be added to history fincl variables.  The units are mole/mole.
A "+" character at the end of a string indicates that the summation will continue with the next string.
Example:
 vmr_sums =
   'SOAG = SOAG0 + SOAG1 + SOAG2 + SOAG3 + SOAG4',
   'NOy = N + NO + NO2 + NO3 + 2*N2O5 + HNO3 + HO2NO2 + CLONO2 +',
       'BRONO2 + PAN + MPAN + ISOPNO3 + ONITR +',
       'HONITR + ALKNIT + ISOPNITA + ISOPNITB + ISOPNOOH + NC4CH2OH +',
       'NC4CHO + NOA + NTERPOOH + PBZNIT + TERPNIT'
 fincl1 = 'NOy','SOAG', ...
Default: none
</entry>

<entry id="mmr_sums" type="char*256(200)" category="cam_chem"
       group="species_sums_nl" valid_values="" >
Give the user the ability to specify species families (or groupings) diagnostics in mass mixing ratio.
These group names can be added to history fincl variables. The units are kg/kg.
A "+" character at the end of a string indicates that the summation will continue with the next string.
Example:
 mmr_sums =
    'soa_a1 = soa1_a1 + soa2_a1 + soa3_a1 + soa4_a1 + soa5_a1',
    'soa_a2 = soa1_a2 + soa2_a2 + soa3_a2 + soa4_a2 + soa5_a2'
 fincl1 = 'soa_a1','soa_a2', ...
Default: none
</entry>

<entry id="chem_use_chemtrop" type="logical" category="chemistry"
       group="chem_inparm" valid_values="" >
Indicates whether to use the unified chemistry tropopause method to set the
tropopause used in gas phase and aerosol chemical processes.  This has a maximum altitude
level corresponding to 300 hPa for latitudes poleward of 50 degrees.
Default: set by build-namelist
</entry>

<entry id="fire_emis_factors_file" type="char*256" input_pathname="abs" category="Fire_emissions"
       group="fire_emis_nl" valid_values="" >
File containing fire emissions factors.
Default: none
</entry>

<entry id="fire_emis_specifier" type="char*1024(100)" category="Fire_emissions"
       group="fire_emis_nl" valid_values="" >
Fire emissions specifier.
Default: none
</entry>

<entry id="fire_emis_elevated" type="logical" category="Fire_emissions"
       group="fire_emis_nl" valid_values="" >
If true fire emissions are input into atmosphere as elevated forcings.
Otherwise they are treated as surface emissions.
Default: TRUE
</entry>

<entry id="ocean_salinity_file" type="char*256" input_pathname="abs" category="ocean_emissions"
       group="ocean_emis_nl" valid_values="" >
File containing ocean salinity
Default: none
</entry>

<entry id="csw_specifier" type="char*256(1000)" category="ocean_emissions"
       group="ocean_emis_nl" valid_values="" >
Specifies a list of chemical species and corresponding seawater concentration files.
Each tracer species seawater concentration is read from its own file as directed by the
namelist variable {{ hilight }}csw_specifier{{ closehilight }}.  The
{{ hilight }}csw_specifier{{ closehilight }} variable tells the model which species have seawater
concentration and the file path for the corresponding species.  Each file path may be
proceeded by a scaling factor.
Example:

csw_specifier = 'DMS      -> /path/Csw_DMS_HiResML_f09f09_1990_2019_20190616a.nc',
                'CH3COCH3 -> 0.75*/path/Csw_Acetone_HiResML_f09f09_1990_2019_20190814a.nc'

These can be read in as a time series of data, cyle over a given year, or be fixed to a given date
as directed by {{ hilight }}csw_time_type{{ closehilight }}.

Default: none
</entry>

<entry id="csw_time_type" type="char*32" category="ocean_emissions"
       group="ocean_emis_nl" valid_values="CYCLICAL,SERIAL,INTERP_MISSING_MONTHS,FIXED" >
Type of time interpolation of seawater concentration datasets specified.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.
by {{ hilight }}csw_specifier{{ closehilight }}.
Default: 'CYCLICAL'
</entry>

<entry id="csw_cycle_yr" type="integer" category="ocean_emissions"
       group="ocean_emis_nl" valid_values="" >
The cycle year of the seawater concentration data
if {{ hilight }}csw_time_type{{ closehilight }}  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="bubble_mediated_transfer" type="logical" category="ocean_emissions"
       group="ocean_emis_nl" valid_values="" >
Bubble-mediated sea-air transfer. See ocean_emis.F90 for details.
Default: FALSE
</entry>

<entry id="stream_ndep_year_first" type="integer" category="Nitrogen Deposition"
       group="ndep_stream_nl" valid_values="" >
Year first to use in nitrogen deposition stream data.
</entry>

<entry id="stream_ndep_year_last" type="integer" category="Nitrogen Deposition"
       group="ndep_stream_nl" valid_values="" >
Year last to use in nitrogen deposition stream data.
</entry>

<entry id="stream_ndep_year_align" type="integer" category="Nitrogen Deposition"
       group="ndep_stream_nl" valid_values="" >
Model year to align with stream_ndep_year_first.
</entry>

<entry id="stream_ndep_data_filename" type="char*256" input_pathname="abs" category="Nitrogen Deposition"
       group="ndep_stream_nl" valid_values="" >
Nitrogen deposition stream data filename.
</entry>

<entry id="stream_ndep_mesh_filename" type="char*256" input_pathname="abs" category="Nitrogen Deposition"
       group="ndep_stream_nl" valid_values="" >
Grid mesh file corresponding to stream_ndep_data_filename.
</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*512(200)" 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>

<entry id="carma_fields" type="char*256" category="carma"
       group="carma_inparm" valid_values="" >
List of fluxes needed by the CARMA model, from CLM to CAM.
Default: set by build-namelist.
</entry>

<entry id="dust_emis_method" type="char*80" category="dust_emissions"
       group="dust_emis_inparm" valid_values="Zender_2003,Leung_2023" >
Which dust emission method is going to be used.
Either the Zender 2003 scheme or the Leung 2023 scheme.
Default: Zender_2003
</entry>

<entry id="zender_soil_erod_source" type="char*80" category="dust_emissions"
       group="dust_emis_inparm" valid_values="none,lnd,atm" >
Option only applying for the Zender_2003 method for whether the soil erodibility
file is handled in the active LAND model or in the ATM model.
(only used when dust_emis_method is Zender_2003)
Default: atm
</entry>

<!-- Ozone namelist variables shared between CAM and driver -->

<entry id="atm_ozone_frequency" type="char*64" category="ozone_coupling"
       group="ozone_coupling_nl" valid_values="subdaily,multiday_average">
Frequency of surface ozone field passed from CAM to surface components.
Surface ozone is passed every coupling interval, but this namelist flag
indicates whether the timestep-level values are interpolated from a
coarser temporal resolution.
Default: set by build-namelist.
</entry>

<entry id="atm_provides_lightning" type="logical" category="lightning_coupling"
       group="lightning_coupling_nl" valid_values="">
If TRUE atmosphere model will provide prognosed lightning flash frequency.
Default: FALSE
</entry>

<!-- WACCM_GHG Chemistry -->

<entry id="waccm_forcing_file" type="char*256" input_pathname="rel:waccm_forcing_datapath" category="waccm_sc"
       group="waccm_forcing_nl" valid_values="" >
Filename of the prescribed waccm forcing data used with waccm_sc 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_sc"
       group="waccm_forcing_nl" valid_values="" >
Full pathname of the directory that contains the files specified in
{{ hilight }}waccm_forcing_filelist{{ closehilight }}.
Default: set by build-namelist.
</entry>

<entry id="waccm_forcing_filelist" type="char*256" input_pathname="rel:waccm_forcing_datapath" category="waccm_sc"
       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 specified
by {{ hilight }}waccm_forcing_datapath{{ closehilight }}.
Default: set by build-namelist.
</entry>

<entry id="waccm_forcing_rmfile" type="logical" category="waccm_sc"
       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_sc"
       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_sc"
       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: 'CYCLICAL'
</entry>

<entry id="waccm_forcing_cycle_yr" type="integer" category="waccm_sc"
       group="waccm_forcing_nl" valid_values="" >
The  cycle year of the prescribed waccm forcing data
if {{ hilight }}waccm_forcing_type{{ closehilight }}  is 'CYCLICAL'.
Format: YYYY
Default: 0
</entry>

<entry id="waccm_forcing_fixed_ymd" type="integer" category="waccm_sc"
       group="waccm_forcing_nl" valid_values="" >
The date at which the prescribed waccm forcing data is fixed
if {{ hilight }}waccm_forcing_type{{ closehilight }} is 'FIXED'.
Format: YYYYMMDD
Default: 0
</entry>

<entry id="waccm_forcing_fixed_tod" type="integer" category="waccm_sc"
       group="waccm_forcing_nl" valid_values="" >
The time of day (seconds) corresponding to {{ hilight }}waccm_forcing_fixed_ymd{{ closehilight }}
at which the prescribed waccm forcing data is fixed
if {{ hilight }}waccm_forcing_type{{ closehilight }} is 'FIXED'.
Default: 0 seconds
</entry>

<entry id="h2orates" type="char*256" input_pathname="abs" category="waccm_sc"
       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="nlte_use_mo" type="logical" category="waccm_phys"
       group="radheat_nl" valid_values="" >
Determines which constituents are used from non-LTE calculations.
TRUE implies use prognostic constituents.
FALSE implies use constituents from dataset specified by {{ hilight }}waccm_forcing_file{{ closehilight }}.
Default: TRUE for full chemistry WACCM; FALSE for WACCM_SC.
</entry>

<entry id="nlte_limit_co2" type="logical" category="waccm_phys"
       group="radheat_nl" valid_values="" >
If TRUE apply upper limit to CO2 concentrations passed to the Formichev non-LTE cooling calculation
(code not intended for values greater than 720 ppmv).  Running with flag set to TRUE could lead to
incorrect cooling rates if model CO2 exceeds 720 ppmv.  If FALSE simulation will abort if CO2 levels
exceed this value at altitudes above 1 mbar.  The 720 ppmv CO2 limiter in the Formichev non-LTE cooling
scheme is applied to all vertical levels regardless of this setting.
Default: FALSE
</entry>

<entry id="nlte_use_aliarms" type="logical" category="waccm_phys"
       group="radheat_nl" valid_values="" >
If TRUE, then use the ALI-ARMS scheme (an alternative method of computing non-LTE heating rates in the upper atmosphere)
Default: FALSE
</entry>

<entry id="nlte_aliarms_every_x" type="integer" category="waccm_phys"
       group="radheat_nl" valid_values="" >
Call ALI-ARMS every X timesteps
Default: 1
</entry>

<entry id="nlte_use_extco2" type="logical" category="waccm_phys"
       group="radheat_nl" valid_values="" >
If TRUE, then use the extended CO2 scheme of Lopez-Puertas et al. 2024 as an alernative method of computing non-LTE
CO2 cooling rates in the upper atmosphere. (DOI:10.5194/gmd-17-4401-2024)
Default: FALSE
</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="fixed_geomag_year" type="integer" category="waccm"
       group="geomag_nl" valid_values="" >
If set this year is used for setting geomagnetic coordinates through out the
simulation.  If not set the model simulation year is used.
Default: none
</entry>

<entry id="igrf_geomag_coefs_file" type="char*256" input_pathname="abs" category="waccm"
       group="geomag_nl" valid_values="" >
International Geomagnetic Reference Field (IGRF) coefficients.
Default: None.
</entry>

<entry id="epp_all_filepath" type="char*256" input_pathname="abs" category="waccm"
       group="epp_ionization_nl" valid_values="" >
Filepath input dataset for ionization due to energetic particle precipitation.
Default: None.
</entry>
<entry id="epp_all_varname" type="char*80" category="waccm"
       group="epp_ionization_nl" valid_values="" >
Variable name in netCDF file {{ hilight }}epp_all_filepath{{ closehilight }} which contains
ion pairs production rates.
Default: None.
</entry>

<entry id="epp_spe_filepath" type="char*256" input_pathname="abs" category="waccm"
       group="epp_ionization_nl" valid_values="" >
Filepath input dataset for ionization due to solar proton events.
Default: None.
</entry>
<entry id="epp_spe_varname" type="char*80" category="waccm"
       group="epp_ionization_nl" valid_values="" >
Variable name in netCDF file {{ hilight }}epp_spe_filepath{{ closehilight }} which contains
ion pairs production rates.
Default: None.
</entry>

<entry id="epp_mee_filepath" type="char*256" input_pathname="abs" category="waccm"
       group="epp_ionization_nl" valid_values="" >
Filepath input dataset for ionization due to medium energy electrons.
Default: None.
</entry>
<entry id="epp_mee_varname" type="char*80" category="waccm"
       group="epp_ionization_nl" valid_values="" >
Variable name in netCDF file {{ hilight }}epp_mee_filepath{{ closehilight }} which contains
ion pairs production rates.
Default: None.
</entry>

<entry id="epp_gcr_filepath" type="char*256" input_pathname="abs" category="waccm"
       group="epp_ionization_nl" valid_values="" >
Filepath input dataset for ionization due to galactic cosmic rays.
Default: None.
</entry>
<entry id="epp_gcr_varname" type="char*80" category="waccm"
       group="epp_ionization_nl" valid_values="" >
Variable name in netCDF file {{ hilight }}epp_gcr_filepath{{ closehilight }} which contains
ion pairs production rates.
Default: None.
</entry>

<entry id="mee_ion_inline" type="logical" category="waccm"
       group="mee_ion_nl" valid_values="" >
Switch to turn on medium energy electron ionization chemical forcings
computed inline using Ap geomagnetic activity index input data.
Default: FALSE
</entry>

<entry id="mee_ion_blc" type="real" category="waccm"
       group="mee_ion_nl" valid_values="" >
Bounce cone loss angle (degrees) for medium energy electrons in radiation belts.
Must range from 0 to 90 degrees.
Default: 80 degrees
</entry>

<entry id="mee_ion_diagonly" type="logical" category="waccm"
       group="mee_ion_nl" valid_values="" >
If TRUE, compute medium energy electron ionization rates only for output to history stream.
Otherwise,  apply the ionization rates as forcings to the chemistry.
Default: FALSE
</entry>

<entry id="mee_fluxes_filepath" type="char*256" input_pathname="abs" category="waccm"
       group="mee_fluxes_opts" valid_values="" >
Filepath input dataset for radiation belt medium energy electrons fluxes incident
on upper atmosphere.
Default: None.
</entry>

<entry id="mee_fluxes_fillin" type="logical" category="waccm"
       group="mee_fluxes_opts" valid_values="" >
If TRUE, fill in missing fluxes with computed fluxes based in Ap index using van de Kamp
method.
Default: FALSE
</entry>

<entry id="apply_lunar_tides" type="logical" category="waccm_phys"
       group="lunar_tides_opts" valid_values="" >
Switch to apply lunar tidal tendencies to neutral winds.
Default: FALSE
</entry>

<!-- Dry air major species -->

<entry id="dry_air_species" type="char*6(20)"  category="physconst"
       group="air_composition_nl" valid_values="" >
List of major species of dry air.  If not set then the composition of dry
air is considered fixed at tropospheric conditions and the properties of
dry air are constant.  If set then the list of major species is assumed to
have 'N2' listed last.  This information is currently used only for
computing the variable properties of air in WACCM-X configurations.
Default: Set by build-namelist.
</entry>

<!-- Water species in moist air -->

<entry id="water_species_in_air" type="char*6(20)"  category="physconst"
       group="air_composition_nl" valid_values="" >
List of water species that are included in "moist" air.  This is currently
used only by the SE dycore to generalize the computation of the moist air
mass and thermodynamic properties.
Default: Set by build-namelist.
</entry>

<!-- SE dycore -->

<entry id="se_fine_ne" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Set for refined exodus meshes (variable viscosity).
Viscosity in namelist specified for regions with a resolution equivilant
to a uniform grid with se_ne = se_fine_ne.
Default: -1 (not used)
</entry>

<entry id="se_ftype" type="integer" category="se"
       group="dyn_se_inparm" valid_values="0,1,2" >
CAM physics forcing option:
0: tendencies
1: adjustments
2: hybrid
Default: Set by build-namelist.
</entry>

<entry id="se_hypervis_power" type="real" category="se"
       group="dyn_se_inparm" valid_values="" >
Scalar viscosity with variable coefficient.
Use variable hyperviscosity based on element area limited by
se_max_hypervis_courant.
Default: 0
</entry>

<entry id="se_hypervis_scaling" type="real" category="se"
       group="dyn_se_inparm" valid_values="" >
Use tensor hyperviscosity.
Citation: Guba, O., Taylor, M. A., Ullrich, P. A., Overfelt, J. R., and
Levy, M. N.: The spectral element method (SEM) on variable-resolution
grids: evaluating grid sensitivity and resolution-aware numerical
viscosity, Geosci. Model Dev., 7, 2803-2816,
doi:10.5194/gmd-7-2803-2014, 2014.
Default: 0 (i.e., not used)
</entry>

<entry id="se_hypervis_subcycle" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Number of hyperviscosity subcycles per dynamics timestep.
Default: Set by build-namelist
</entry>

<entry id="se_hypervis_subcycle_sponge" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Number of hyperviscosity subcycles per dynamics timestep in sponge del2 diffusion.
Default: Set by build-namelist
</entry>

<entry id="se_molecular_diff" type="real" category="se"
       group="dyn_se_inparm" valid_values="" >
Used by SE dycore to apply sponge layer diffusion to u, v, and T for
stability of WACCM configurations. The diffusion is modeled on 3D molecular
diffusion and thermal conductivity by using actual molecular diffusion and
thermal conductivity coefficients multiplied by the value of
se_molecular_diff.

If set &lt;= 0.0 then the code is not activated.  If set &gt; 0.0 then
the molecular diffusion and thermal conductivity coefficients will be
multiplied by a factor of se_molecular_diff.

Default: 0.
</entry>

<entry id="se_min_temperature" type="real" category="se"
       group="dyn_se_inparm" valid_values="" >
Used by spectral element dynamical core to apply floor to temperature.
If set to a value greater than zero the floor is applied.
Otherwise, no floor is applied.
Default: 0.
</entry>

<entry id="se_hypervis_subcycle_q" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Number of hyperviscosity subcycles done in tracer advection code.
Default: Set by build-namelist.
</entry>

<entry id="se_limiter_option" type="integer" category="se"
       group="dyn_se_inparm" valid_values="0,4,8" >
Limiter used for horizontal tracer advection:
0: None
4: Sign-preserving limiter.
8: Monotone limiter.
Default: 8
</entry>

<entry id="se_max_hypervis_courant" type="real" category="se"
       group="dyn_se_inparm" valid_values="" >
Upper bound for Courant number, used to limit se_hypervis_power.
Default: 1.0e99 (i.e., not used) unless se_refined_mesh=TRUE
</entry>

<entry id="se_mesh_file" type="char*256" input_pathname="abs" category="se"
       group="dyn_se_inparm" valid_values="" >
Filename of exodus file to read grid from (generated by CUBIT or SQuadGen).
Default: ""
</entry>

<entry id="se_ne" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Number of elements along a cube edge.
Must match value of grid. Set this to zero to use a refined mesh.
Default: Set by build-namelist.
</entry>

<entry id="se_npes" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Number of PEs to be used by SE dycore.
Default: Number of PEs used by CAM.
</entry>

<entry id="se_nsplit" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Number of dynamics steps per physics timestep.
Default: Set by build-namelist.
</entry>

<entry id="se_nu" type="real" category="se"
       group="dyn_se_inparm" valid_values="" >
Hyperviscosity coefficient for u,v, T [m^4/s].
If &lt; 0, se_nu is automatically set.
Default: Set by build-namelist.
</entry>

<entry id="se_nu_div" type="real" category="se"
       group="dyn_se_inparm" valid_values="" >
Hyperviscosity applied to divergence component of winds [m^4/s].
If &lt; 0, uses se_nu_p.
Default: Set by build-namelist.
</entry>

<entry id="se_nu_p" type="real" category="se"
       group="dyn_se_inparm" valid_values="" >
Hyperviscosity coefficient applied to pressure-level thickness [m^4/s].
If &lt; 0, se_nu_p is automatically set.
Default: Set by build-namelist.
</entry>

<entry id="se_nu_top" type="real" category="se"
       group="dyn_se_inparm" valid_values="" >
Second-order viscosity applied only near the model top [m^2/s].
Default: Set by build-namelist.
</entry>

<entry id="se_sponge_del4_nu_fac" type="real" category="se"
       group="dyn_se_inparm" valid_values="" >
Hyperviscosity coefficient se_nu [m^4/s] for u,v, T is increased to
se_nu_p*se_sponge_del4_nu_fac following a hyperbolic tangent function
centered around pressure at vertical index se_sponge_del4_lev:

 0.5_r8*(1.0_r8+tanh(2.0_r8*log(pmid(se_sponge_del4_lev)/press)))

where press is pressure

If &lt; 0, se_sponge_del4_nu_fac is automatically set based on model top location.
Default: Set by build-namelist.
</entry>

<entry id="se_sponge_del4_nu_div_fac" type="real" category="se"
       group="dyn_se_inparm" valid_values="" >
Divergence damping hyperviscosity coefficient se_nu_div [m^4/s] for u,v is increased to
se_nu_p*se_sponge_del4_nu_div_fac following a hyperbolic tangent function
centered around pressure at vertical index se_sponge_del4_lev:

 0.5_r8*(1.0_r8+tanh(2.0_r8*log(pmid(se_sponge_del4_lev)/press)))

where press is pressure

If &lt; 0, se_sponge_del4_nu_div_fac is automatically set based on model top location.
Default: Set by build-namelist.
</entry>

<entry id="se_sponge_del4_lev" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Level index around which increased del4 damping is centered.

See se_sponge_del4_nu_fac and se_sponge_del4_nu_div_fac

If &lt; 0, se_sponge_del4_lev is automatically set based on model top location.
Default: Set by build-namelist.
</entry>

<entry id="se_large_Courant_incr" type="logical" category="se"
       group="dyn_se_inparm" valid_values="" >
  If TRUE the CSLAM algorithm will work for Courant number larger than 1 with
  a low-order increment for tracer mass more than one grid cell width away
</entry>

<entry id="se_fvm_supercycling" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Number of SE rsplit time-steps CSLAM supercycles
rsplit/se_fvm_supercycling must be an integer
</entry>

<entry id="se_fvm_supercycling_jet" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Number of SE rsplit time-steps CSLAM supercycles in the jet region
(which is specified by kmin_jet and kmax_jet)
rsplit/se_fvm_supercycling_jet must be an integer
se_fvm_supercycling_jet/se_fvm_supercyling must be an integer
</entry>

<entry id="se_kmin_jet" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
  Min level index where CSLAM runs with se_fvm_supercycling_jet
  (if se_fvm_supercycling_jet.ne.se_fvm_supercycling) or
  min index where are Courant number increment is active
  (se_large_Courant_incr=.true.)
</entry>

<entry id="se_kmax_jet" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
  Max level index where CSLAM runs with se_fvm_supercycling_jet
  (if se_fvm_supercycling_jet.ne.se_fvm_supercycling) or
  max index where are Courant number increment is active
  (se_large_Courant_incr=.true.)
</entry>


<entry id="se_qsplit" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Tracer advection is done every qsplit dynamics timesteps.
Default: Set by build-namelist.
</entry>

<entry id="se_refined_mesh" type="logical" category="se"
       group="dyn_se_inparm" valid_values="" >
TRUE specified use of a refined grid (mesh) for this run.
Default: FALSE
</entry>

<entry id="se_rsplit" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Vertically lagrangian code vertically remaps every rsplit tracer timesteps.
Default: Set by build-namelist.
</entry>

<entry id="se_statefreq" type="integer" category="se"
       group="dyn_se_inparm" 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_tstep_type" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Time stepping method for SE dycore
se_tstep_type=1  RK2 followed by qsplit-1 Leapfrog steps; second-order accurate in time (CESM1.2.0 setting)
se_tstep_type=2  RK2-SSP 3 stage (as used by tracers)
se_tstep_type=3  classic Runga-Kutta (RK) 3 stage
se_tstep_type=4  Kinnmark&amp;Gray Runga-Kutta (RK) 4 stage
Default: 4
</entry>

<entry id="se_statediag_numtrac" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Number of tracers to include in logfile diagnostics for SE dycore
Default: 3
</entry>

<entry id="se_vert_remap_T" type="char*32" category="se"
       group="dyn_se_inparm" valid_values="thermal_energy_over_P,Tv_over_logP">
CAM-SE vertical remapping of temperature:
"thermal_energy_over_P": Map cp*T (thermal energy conserving) using a
                         pressure coordinate.
"Tv_over_logP"         : Map virtual temperature using a log pressure coordinate.

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

<entry id="se_vert_remap_uvTq_alg" type="char*32" category="se"
       group="dyn_se_inparm" valid_values="PPM_bc_mirror,PPM_bc_PCoM,PPM_bc_linear_extrapolation,FV3_PPM,FV3_CS,FV3_CS_2dz_filter,FV3_non_monotone_CS_2dz_filter">
CAM-SE vertical remap algorithm for u,v,T, and water species.
PPM_bc_mirror: PPM vertical remap with mirroring at the boundaries
     (solid wall boundary conditions, high-order throughout)
PPM_bc_PCoM: PPM vertical remap without mirroring at the boundaries
     (no boundary conditions enforced, first-order at two cells bordering top and bottom
     boundaries)
PPM_bc_linear_extrapolation: PPM with linear extrapolation in ghost cells (code from A. Bradley, DOE)

The following options use the FV3 vertical remapping algorithm.

FV3_PPM: Monotone PPM
FV3_CS: Monotonic cubic spline with 2*delta_z oscillations removed
FV3_CS_2dz_filter: Selectively monotonic cubic spline, where local extrema are retained,
     with 2*delta_z oscillations removed
FV3_non_monotone_CS_2dz_filter: Non-monotonic (linear) cubic spline with 2*delta_z oscillations removed;

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

<entry id="se_vert_remap_tracer_alg" type="char*32" category="se"
       group="dyn_se_inparm" valid_values="PPM_bc_mirror,PPM_bc_PCoM,PPM_bc_linear_extrapolation,FV3_PPM,FV3_CS,FV3_non_monotone_CS_2dz_filter">
CAM-SE vertical remap algorithm for non-water tracers
PPM_bc_mirror: PPM vertical remap with mirroring at the boundaries
     (solid wall boundary conditions, high-order throughout)
PPM_bc_PCoM: PPM vertical remap without mirroring at the boundaries
     (no boundary conditions enforced, first-order at two cells bordering top and bottom
     boundaries)
PPM_bc_linear_extrapolation: PPM with linear extrapolation in ghost cells (code from A. Bradley, DOE)

The following options use the FV3 vertical remapping algorithm.

FV3_PPM: Monotone PPM
FV3_CS: Monotonic cubic spline with 2*delta_z oscillations removed
FV3_non_monotone_CS_2dz_filter: Non-monotonic (linear) cubic spline with 2*delta_z oscillations removed;

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

<entry id="se_write_restart_unstruct" type="logical" category="se"
       group="dyn_se_inparm" valid_values="" >
Set .true. to allow writing SE dynamics fields to the restart file using the
unstructured grid format.  This allows the restart file to be used as an
initial file, but its use as a restart file will introduce roundoff size
differences into the simulation.
Default: .false.
</entry>

<!-- Nudging -->
<entry id="se_met_nudge_u" type="real" category="se"
       group="dyn_se_inparm" valid_values="" >
Nudging factor for prescribed winds in SE dycore
Units: 1/sec
Default: 2e-5
</entry>

<entry id="se_met_nudge_t" type="real" category="se"
       group="dyn_se_inparm" valid_values="" >
Nudging factor for prescribed temperature in SE dycore
Units: 1/sec
Default: 2e-5
</entry>

<entry id="se_met_nudge_p" type="real" category="se"
       group="dyn_se_inparm" valid_values="" >
Nudging factor for prescribed surface pressure in SE dycore
Units: 1/sec
Default: 0.0
</entry>

<entry id="se_met_tevolve" type="integer" category="se"
       group="dyn_se_inparm" valid_values="0,1" >
Switch to turn on/off time evolution of dynamics nudging
Default: 0
</entry>

<!-- Physics grid entries -->
<entry id="se_fv_nphys" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Number of equally-spaced horizontal physics points per spectral
element. A number greater than zero will define [se_fv_nphys] equally
spaced physics points in each direction (e.g., se_fv_nphys = 3 will
result in 9 equally-spaced physics points per element).
Default: 0 = feature disabled, use dynamics GLL points.
</entry>

<!-- Option to write SCRIP grid file -->
<entry id="se_write_grid_file" type="char*16" category="se"
       group="dyn_se_inparm" valid_values="no,SCRIP" >
If 'SCRIP', write a NetCDF file with the grid in SCRIP format.
If using a finite-volume physics grid, write the FVM grid, otherwise
write the native GLL grid.
Note that if this option is used, the simulation will exit after writing.
Default: 'no'
</entry>

<entry id="se_grid_filename" type="char*256" category="se"
       group="dyn_se_inparm" valid_values="" >
Name of grid file to write if se_write_grid_file is set.
Default: Set according to active grid
</entry>

<entry id="se_write_gll_corners" type="logical" category="se"
       group="dyn_se_inparm" valid_values="" >
Set to true to write the SEMapping.nc file.
Default: .false.
</entry>

<entry id="native_mapping_outgrids" type="char*256(5)" category="se"
       group="native_mapping_nl" valid_values="" >
List of SCRIP grid filenames each representing a destination grid. If provided during a CAM simulation running the spectral element dycore, mapping files will be created from the native cubed-sphere grid to each destination grid. Both native mapping (using the internal spectral element basis functions) and bilinear maps are created.
Default: none
</entry>

<!-- SE performance (threading) entries -->
<entry id="se_horz_num_threads" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Number of threads to use for loops over elements.
Default: Set by build-namelist.
</entry>

<entry id="se_vert_num_threads" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Number of threads to use when processing vertical loops. Normally
equal to se_tracer_num_threads.
Default: Set by build-namelist.
</entry>

<entry id="se_tracer_num_threads" type="integer" category="se"
       group="dyn_se_inparm" valid_values="" >
Number of threads to use when processing loops over threads.
Normally equal to se_vert_num_threads.
Default: Set by build-namelist.
</entry>

<entry id="se_pgf_formulation" type="integer" category="se"
       group="dyn_se_inparm" valid_values="1,2,3" >

  1: Exner version of pressure gradient force (PGF)
  see Appendix A in https://agupubs.onlinelibrary.wiley.com/doi/epdf/10.1029/2022MS003192

  2: Traditional pressure gradient formulation (grad p)

  3: Hybrid (formulation 1 where hybm>0 else formulation 2)
     Use hybrid PGF option for WACCM-x to make WACCM-x consistent with PGF
     used in CAM in the troposphere and traditional PGF formulation above

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

<entry id="se_dribble_in_rsplit_loop" type="integer" category="se"
       group="dyn_se_inparm" valid_values="0,1" >

  0: physics tendencies will be added every vertical remapping time-step (dt_phys/se_nsplit)
     for se_ftype=0,2

  1: physics tendencies will be added every dynamics time-step (dt_phys/se_nsplit*se_rsplit)
     for se_ftype=0,2

     If se_ftype=1 then se_dribble_in_rsplit_loop has no effect since physics tendencies are added as an adjustment

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


<!-- MPAS dycore -->

<entry id="mpas_time_integration" type="char*512" category="mpas"
       group="nhyd_model" valid_values="SRK3">
Time integration scheme in MPAS dycore.
Default: SRK3
</entry>

<entry id="mpas_time_integration_order" type="integer" category="mpas"
       group="nhyd_model" valid_values="2,3">
Order for RK time integration in MPAS dycore.
Default: 2
</entry>

<entry id="mpas_dt" type="real" category="mpas"
       group="nhyd_model" valid_values="">
Time step (seconds) in MPAS dycore
Default: Set by build-namelist.
</entry>

<entry id="mpas_split_dynamics_transport" type="logical" category="mpas"
       group="nhyd_model" valid_values="">
Whether to super-cycle scalar transport in MPAS dycore.
Default: TRUE
</entry>

<entry id="mpas_number_of_sub_steps" type="integer" category="mpas"
       group="nhyd_model" valid_values="">
Number of acoustic steps per full RK step in MPAS dycore.
Default: 2
</entry>

<entry id="mpas_dynamics_split_steps" type="integer" category="mpas"
       group="nhyd_model" valid_values="">
When {{ hilight }}mpas_split_dynamics_transport{{ closehilight }} = .true., the
number of RK steps per transport step in MPAS dycore.
Default: 3
</entry>

<entry id="mpas_h_mom_eddy_visc2" type="real" category="mpas"
       group="nhyd_model" valid_values="">
Del^2 eddy viscosity for horizontal diffusion of momentum in MPAS dycore.
Default: 0.0
</entry>

<entry id="mpas_h_mom_eddy_visc4" type="real" category="mpas"
       group="nhyd_model" valid_values="">
Del^4 eddy hyper-viscosity for horizontal diffusion of momentum in MPAS dycore.
Default: 0.0
</entry>

<entry id="mpas_v_mom_eddy_visc2" type="real" category="mpas"
       group="nhyd_model" valid_values="">
Del^2 eddy viscosity for vertical diffusion of momentum in MPAS dycore.
Default: 0.0
</entry>

<entry id="mpas_h_theta_eddy_visc2" type="real" category="mpas"
       group="nhyd_model" valid_values="">
Del^2 eddy viscosity for horizontal diffusion of theta in MPAS dycore.
Default: 0.0
</entry>

<entry id="mpas_h_theta_eddy_visc4" type="real" category="mpas"
       group="nhyd_model" valid_values="">
Del^4 eddy hyper-viscosity for horizontal diffusion of theta in MPAS dycore.
Default: 0.0
</entry>

<entry id="mpas_v_theta_eddy_visc2" type="real" category="mpas"
       group="nhyd_model" valid_values="">
Del^2 eddy viscosity for vertical diffusion of theta in MPAS dycore.
Default: 0.0
</entry>

<entry id="mpas_horiz_mixing" type="char*512" category="mpas"
       group="nhyd_model" valid_values="2d_fixed,2d_smagorinsky">
Formulation of horizontal mixing in MPAS dycore.
Default: 2d_smagorinsky
</entry>

<entry id="mpas_len_disp" type="real" category="mpas"
       group="nhyd_model" valid_values="">
Horizontal length scale, used by the Smagorinsky formulation of horizontal
diffusion and by 3-d divergence damping in MPAS dycore.
Default: 120000.0
</entry>

<entry id="mpas_visc4_2dsmag" type="real" category="mpas"
       group="nhyd_model" valid_values="">
Scaling coefficient of delta_x^3 to obtain Del^4 diffusion coefficient in
MPAS dycore.
Default: 0.05
</entry>

<entry id="mpas_del4u_div_factor" type="real" category="mpas"
       group="nhyd_model" valid_values="">
Scaling factor for the divergent component of Del^4 u calculation in MPAS
dycore.
Default: 10.0
</entry>

<entry id="mpas_w_adv_order" type="integer" category="mpas"
       group="nhyd_model" valid_values="2,3,4">
Horizontal advection order for w in MPAS dycore.
Default: 3
</entry>

<entry id="mpas_theta_adv_order" type="integer" category="mpas"
       group="nhyd_model" valid_values="2,3,4">
Horizontal advection order for theta in MPAS dycore.
Default: 3
</entry>

<entry id="mpas_scalar_adv_order" type="integer" category="mpas"
       group="nhyd_model" valid_values="2,3,4">
Horizontal advection order for scalars in MPAS dycore.
Default: 3
</entry>

<entry id="mpas_u_vadv_order" type="integer" category="mpas"
       group="nhyd_model" valid_values="2,3,4">
Vertical advection order for normal velocities (u) in MPAS dycore
Default: 3
</entry>

<entry id="mpas_w_vadv_order" type="integer" category="mpas"
       group="nhyd_model" valid_values="2,3,4">
Vertical advection order for w in MPAS dycore.
Default: 3
</entry>

<entry id="mpas_theta_vadv_order" type="integer" category="mpas"
       group="nhyd_model" valid_values="2,3,4">
Vertical advection order for theta in MPAS dycore.
Default: 3
</entry>

<entry id="mpas_scalar_vadv_order" type="integer" category="mpas"
       group="nhyd_model" valid_values="2,3,4">
Vertical advection order for scalars in MPAS dycore.
Default: 3
</entry>

<entry id="mpas_scalar_advection" type="logical" category="mpas"
       group="nhyd_model" valid_values="">
Whether to advect scalar fields in MPAS dycore
Default: TRUE
</entry>

<entry id="mpas_positive_definite" type="logical" category="mpas"
       group="nhyd_model" valid_values="">
Whether to enable positive-definite advection of scalars in MPAS dycore.
Default: FALSE
</entry>

<entry id="mpas_monotonic" type="logical" category="mpas"
       group="nhyd_model" valid_values="">
Whether to enable monotonic limiter in scalar advection in MPAS dycore.
Default: TRUE
</entry>

<entry id="mpas_coef_3rd_order" type="real" category="mpas"
       group="nhyd_model" valid_values="">
Upwinding coefficient in the 3rd order advection scheme in MPAS dycore.
Default: 1.0
</entry>

<entry id="mpas_smagorinsky_coef" type="real" category="mpas"
       group="nhyd_model" valid_values="">
Dimensionless empirical parameter relating the strain tensor to the eddy
viscosity in the Smagorinsky turbulence model in MPAS dycore.
Default: 0.125
</entry>

<entry id="mpas_mix_full" type="logical" category="mpas"
       group="nhyd_model" valid_values="">
Mix full theta and u fields, or mix perturbation from intitial state in
MPAS dycore.
Default: TRUE
</entry>

<entry id="mpas_epssm" type="real" category="mpas"
       group="nhyd_model" valid_values="">
Off-centering parameter for the vertically implicit acoustic integration in
MPAS dycore
Default: 0.1
</entry>

<entry id="mpas_smdiv" type="real" category="mpas"
       group="nhyd_model" valid_values="">
3-d divergence damping coefficient in MPAS dycore.
Default: 0.1
</entry>

<entry id="mpas_apvm_upwinding" type="real" category="mpas"
       group="nhyd_model" valid_values="">
Amount of upwinding in APVM in MPAS dycore.
Default: 0.5
</entry>

<entry id="mpas_h_ScaleWithMesh" type="logical" category="mpas"
       group="nhyd_model" valid_values="">
Scale eddy viscosities with mesh-density function for horizontal diffusion
in MPAS dycore.
Default: TRUE
</entry>

<entry id="mpas_zd" type="real" category="mpas"
       group="damping" valid_values="">
Height in meters above MSL to begin w-damping profile in MPAS dycore.
Default: 22000.0
</entry>

<entry id="mpas_xnutr" type="real" category="mpas"
       group="damping" valid_values="">
Maximum w-damping coefficient at model top in MPAS dycore.
Default: 0.2
</entry>

<entry id="mpas_cam_coef" type="real" category="mpas"
       group="damping" valid_values="">
Coefficient for scaling the 2nd-order horizontal diffusion in the mpas_cam absorbing
layer. The absorbing layer depth is controlled with mpas_cam_damping_levels. The damping
coefficients scale linearly with mpas_cam_coef. A value of 0.0 (or
mpas_cam_damping_levels=0) disables the 2nd-order diffusion in the absorbing layer. Sponge
layer absorption can also be provided by Rayleigh damping.

E.g. a value of 1.0 with mpas_cam_damping_levels=3 will result in damping coefficients of
2E6 m^2/s, 6E5, 2E5 in the top-most three layers on the dynamics variables u, w, and
theta.
Default: 0.0
</entry>

<entry id="mpas_cam_damping_levels" type="integer" category="mpas"
       group="damping" valid_values="">
Number mpas_cam absorbing layers in which to apply 2nd-order horizontal diffusion.
Viscocity linearly ramps to zero by layer number from the top. mpas_cam_damping_levels and
mpas_cam_coef must both be greater than 0 for the diffusion to be enabled.
Default: 0
</entry>

<entry id="mpas_rayleigh_damp_u" type="logical" category="mpas"
       group="damping" valid_values="">
Whether to apply Rayleigh damping on horizontal velocity in the top-most model levels.
The number of levels is specified by the config_number_rayleigh_damp_u_levels option,
and the damping timescale is specified by the config_rayleigh_damp_u_timescale_days option.
Default: TRUE
</entry>

<entry id="mpas_rayleigh_damp_u_timescale_days" type="real" category="mpas"
       group="damping" valid_values="">
Timescale, in days (86400 s), for the Rayleigh damping on horizontal velocity in
the top-most model levels.
Default: 5.0
</entry>

<entry id="mpas_number_rayleigh_damp_u_levels" type="integer" category="mpas"
       group="damping" valid_values="">
Number layers in which to apply Rayleigh damping on horizontal velocity at top of model;
damping linearly ramps to zero by layer number from the top
Default: 3
</entry>

<entry id="mpas_apply_lbcs" type="logical" category="mpas"
       group="limited_area" valid_values="">
Whether to apply lateral boundary conditions
Default: FALSE
</entry>

<entry id="mpas_jedi_da" type="logical" category="mpas"
       group="assimilation" valid_values="">
Whether this run is within the JEDI data assimilation framework; used to add
temperature and specific humidity as diagnostics
Default: FALSE
</entry>

<entry id="mpas_block_decomp_file_prefix" type="char*512" input_pathname="abs" category="mpas"
       group="decomposition" valid_values="">
Prefix of the MPAS graph decomposition file, to be suffixed with the MPI
task count.  The prefix includes the full pathname of the directory
containing the file.
Default: Set by build-namelist.
</entry>

<entry id="mpas_do_restart" type="logical" category="mpas"
       group="restart" valid_values="">
Whether this run with the MPAS dycore is to restart from a previous restart
file or not.
Default: Set by build-namelist.
</entry>

<entry id="mpas_print_global_minmax_vel" type="logical" category="mpas"
       group="printout" valid_values="">
Whether to print the global min/max of horizontal normal velocity and
vertical velocity each timestep in MPAS dycore.
Default: TRUE
</entry>

<entry id="mpas_print_detailed_minmax_vel" type="logical" category="mpas"
       group="printout" valid_values="">
Whether to print the global min/max of horizontal normal velocity and
vertical velocity each timestep, along with the location in the domain
where those extrema occurred in MPAS dycore.
Default: FALSE
</entry>

<entry id="mpas_print_global_minmax_sca" type="logical" category="mpas"
       group="printout" valid_values="">
Whether to print the global min/max of scalar fields each timestep in MPAS
dycore.
Default: FALSE
</entry>


<!-- Dycore testing  -->

<entry id="analytic_ic_type" type="char*80" category="dyn_test"
       group="analytic_ic_nl"
       valid_values="none,held_suarez_1994,moist_baroclinic_wave_dcmip2016,dry_baroclinic_wave_dcmip2016,dry_baroclinic_wave_jw2006,us_standard_atmosphere" >
Specify the type of analytic initial conditions for an initial run.
held_suarez_1994: Initial conditions specified in Held and Suarez (1994)
moist_baroclinic_wave_dcmip2016: Moist baroclinic wave as used in the DCMIP 2016 experiments
dry_baroclinic_wave_dcmip2016: Dry baroclinic wave as used in the DCMIP 2016 experiments
dry_baroclinic_wave_jw2006: Dry baroclinic wave as specified in Jablonowski and Williamson (2006)
us_standard_atmosphere: static atmospheric state (u,v)=0, standard lapse rate for T, PS is hydrostatic equilibrium with topography
(this ic is recommended for spinning up new initial condition files when changing horizontal or vertical resolution)
Default: 'none'
</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 {{ hilight }}atm_logfile{{ closehilight }}
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 {{ hilight }}cpl_logfile{{ closehilight }}
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 {{ hilight }}lnd_logfile{{ closehilight }}
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 {{ hilight }}rof_logfile{{ closehilight }}
will be written to.
Default: "."
</entry>

<entry id="sim_year" type="char*9" category="cam"
       group="camexp" valid_values="1850,2000,2010,1850-2000,1850-2015">
This varible is only used internally by build-namelist to determine
appropriate defaults for climatological or transient forcing datasets.
Default: set by build-namelist.
</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="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="cpair" type="real" category="physconst"
       group="physconst_nl" valid_values="" >
Heat capacity of dry air at constant pressure [J/kg/K].
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="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>

<!-- for offine unit drivers -->

<entry id="offline_driver_infile" type="char*256" input_pathname="abs" category="offline_unit_driver"
       group="offline_driver_nl" valid_values="" >
Filepath for dataset for offline unit driver.
Default: none
</entry>

<entry id="offline_driver_fileslist" type="char*256" input_pathname="abs" category="offline_unit_driver"
       group="offline_driver_nl" valid_values="" >
List of filepaths for dataset for offline unit driver.
Default: none
</entry>

<!-- for fv3 dynamical core -->

<entry id="fv3_clock_grain" type="char*256" category="dyn_fv3"
       group="fms_nml" valid_values="" >
The level of clock granularity used for performance timing sections
of code. Possible values in order of increasing detail are:
NONE, COMPONENT, SUBCOMPONENT, MODULE_DRIVER, MODULE, ROUTINE,
LOOP, and INFRA.
Default: none
</entry>

<entry id="fv3_domains_stack_size" type="integer" category="dyn_fv3"
       group="fms_nml" valid_values="" >
Integer: The size in words of the MPP_DOMAINS user stack. If
fv3_domains_stack_size &gt; 0, the following MPP_DOMAINS routine is called:
call mpp_domains_set_stack_size (fv3_domains_stack_size). If
fv3_domains_stack_size = 0 then the size set by
mpp_domains_mod is used.
Default: 6000000
</entry>

<entry id="fv3_stack_size" type="integer" category="dyn_fv3"
       group="fms_nml" valid_values="" >
Integer: The size in words of the MPP user stack. If fv3_stack_size &gt; 0, the following
MPP routine is called: call mpp_set_stack_size (fv3_stack_size). If fv3_stack_size = 0
then the defaults set by mpp_mod is used.
Default: 6000000
</entry>

<entry id="fv3_print_memory_usage" type="logical" category="dyn_fv3"
       group="fms_nml" valid_values="" >
Logical: If set to .TRUE., memory usage statistics will be printed at various
points in the code. It is used to study memory usage, e.g to detect
memory leaks.
Default: FALSE
</entry>

<entry id="fv3_adjust_dry_mass" type="logical" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Logical: whether to adjust the global dry-air mass to
the value set by fv3_adjust_dry_mass. This is only done in an initialization
step, particularly when using an initial condition from an external
dataset, interpolated from another resolution (either horizontal or
vertical), or when changing the topography, so that the global mass
of the atmosphere matches some estimate of observed value. It is
recommended to only set this to True when initializing the model.
Default: FALSE
</entry>

<entry id="fv3_beta" type="real" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Real: Parameter specifying fraction of time-off-centering for
backwards evaluation of the pressure gradient force. The default value
of 0.0 indicates a fully backwards evaluation of the pressure gradient
force using the updated (time n+1) dynamical fields. A value of 0.5
will equally weight the PGF determined at times n and n+1, but may not
be stable; values larger than 0.45 are not recommended. A value of 0.4
is recommended for most hydrostatic simulations, which allows an
improved representation of inertia-gravity waves in the tropics. In
non-hydrostatic simulations using the semi-implicit solver (a_imp &gt; 0.5)
the values of a_imp and fv3_beta should add to 1, so that the
time-centering is consistent between the PGF and the nonhydrostatic
solver. Proper range is 0 to 0.45.
Default: 0.
</entry>

<entry id="fv3_consv_am" type="logical" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Logical: whether to enable Angular momentum fixer.
Default: FALSE
</entry>

<entry id="fv3_consv_te" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Real: fraction of total energy lost during the adiabatic integration
between calls of the physics, to be added back globally as heat;
essentially the strength of the energy fixer in the physics. Note that
this is a global energy fixer and cannot add back energy locally.
The default algorithm increments the potential temperature so the
pressure gradients are unchanged. Proper range is 0
to 1. 1 will restore the energy completely to its original value before
entering the physics; a value of 0.7 roughly causes the energy fixer
to compensate for the amount of energy changed by the physics in
GFDL HiRAM or AM3.
Default: 0
</entry>

<entry id="fv3_dddmp" type="real" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Real: Dimensionless coefficient for the second-order Smagorinsky type
divergence damping. 0.0 is the default but 0.2 (the Smagorinsky
constant) is recommended if ICs are noisy
Default: 0.0
</entry>

<entry id="fv3_delt_max" type="real" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Real: maximum allowed magnitude of the dissipative heating
rate, K/s; larger magnitudes are clipped to this amount. This can
help avoid instability that can occur due to strong heating when d_con &gt; 0.
A value of 0.008 (a rate equivalent to about 800K per day) is sufficient
to stabilize the model at 3 km resolution.
Default: 0.0
</entry>

<entry id="fv3_dnats" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: The number of tracers which are not to be advected by
the dynamical core, but still passed into the dynamical core; the last
dnats+pnats tracers in field_table are not advected.
Default: 0
</entry>

<entry id="fv3_do_sat_adj" type="logical" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Logical: If true activate Fast Saturation Adjustment Module. It adjusts
cloud water evaporation (cloud water change to water vapor), cloud water freezing
(cloud water change to cloud ice), and cloud ice deposition
(water vapor change to cloud ice).
Default: FALSE
</entry>

<entry id="fv3_do_vort_damp" type="logical" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Logical: whether to apply flux damping (of strength governed by fv3_vtdm4)
to the fluxes of vorticity, air mass, and nonhydrostatic vertical
velocity (there is no dynamically correct way to
add explicit diffusion to the tracer fluxes). The form is the same
as is used for the divergence damping, including the same order
(from fv3_nord) damping, unless fv3_nord = 0, in which case this damping
is fourth-order, or if fv3_nord = 3, in which case this damping is
sixth-order (instead of eighth-order). We recommend enabling this
damping when the linear or non-monotonic horizontal advection
schemes are enabled, but is unnecessary and not recommended
when using monotonic advection.
Default: FALSE
</entry>

<entry id="fv3_dwind_2d" type="logical" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Logical: whether to use a simpler and faster algorithm for interpolating the A-grid (cell-centered) wind tendencies computed from
the physics to the D-grid. Typically, the A-grid wind tendencies are
first converted in 3D cartesian coordinates and then interpolated
before converting back to 2D local coordinates. When this option
enabled, a much simpler but less accurate 2D interpolation is used.
Default: FALSE
</entry>

<entry id="fv3_d_con" type="real" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Real: Fraction of kinetic energy lost to net damping (divergence
and vorticity) to be converted to heat. Acts as a dissipative heating
mechanism in the dynamical core. Proper range is 0
to 1. Note that this is a local, physically correct, energy fixer.
Default: 0
</entry>

<entry id="fv3_d_ext" type="real" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Real: coefficient for external (barotropic) mode damping.
Proper range is 0 to 0.02. A value of 0.01 or 0.02 may help
improve the models maximum stable time step in low-resolution
(2-degree or poorer) simulations; otherwise a value of 0 is recommended.
Default: 0
</entry>

<entry id="fv3_d2_bg" type="real" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Real: coefficient for background second-order divergence damping.
This option remains active even if fv3_nord is nonzero.
Proper range is 0 to 0.02.
Default: 0.0
</entry>

<entry id="fv3_d2_bg_k1" type="real" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Real: strength of second-order diffusion in the top sponge
layer. This value, and fv3_d2_bg_k2, will be changed
appropriately in the model (depending on the height of model top),
so the actual damping may be very reduced. See atmos_cubed_sphere/model/dyn_core
for details. Recommended range is 0. to 0.2. Note that since diffusion is
converted to heat if fv3_d_con &gt; 0 larger amounts of spongelayer diffusion may be less stable.
Default: 0.15
</entry>

<entry id="fv3_d2_bg_k2" type="real" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Real: strength of second-order diffusion in the second sponge
layer from the model top. This value should be
lower than fv3_d2_bg_k1.
Default: 0.02
</entry>

<entry id="fv3_d4_bg" type="real" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Real: Dimensionless coefficient for background higher-order
divergence damping. If no second-order divergence
damping is used, then values between 0.1 and 0.16 are recommended.
Requires fv3_nord &gt; 0. Note that the scaling for fv3_d4_bg differs from that
of fv3_d2_bg; fv3_nord ge 1 and fv3_d4_bg = 0.16 will be less diffusive than
fv3_nord = 0 and fv3_d2_bg = 0.02.
Default: 0.15
</entry>

<entry id="fv3_fill" type="logical" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Logical: Fills in negative tracer values by taking positive tracers from
the cells above and below. This option is useful when the physical
parameterizations produced negatives.
Default: TRUE
</entry>

<entry id="fv3_fv_debug" type="logical"  category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
true for debug print
Default: FALSE
</entry>

<entry id="fv3_fv_diag" type="logical"  category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
true to print diagnostics
Default: FALSE
</entry>

<entry id="fv3_lcp_moist" type="logical" category="dyn_fv3"
       group="dyn_fv3_inparm" valid_values="" >
If TRUE the continuous equations the dynamical core is based on will conserve a
comprehensive moist total energy based on cp for dry air and all condensates.
If FALSE the continuous equations the dynamical core is based on will conserve
a total energy based on cp for dry air only (same total energy as CAM physics uses).
For more details see Lauritzen et al., (2018;DOI:10.1029/2017MS001257)
Default: TRUE
</entry>

<entry id="fv3_lcv_moist" type="logical" category="dyn_fv3"
       group="dyn_fv3_inparm" valid_values="" >
If TRUE the continuous equations the dynamical core is based on will conserve a
comprehensive moist total energy based on cv for dry air and all condensates.
If FALSE the continuous equations the dynamical core is based on will conserve
a total energy based on cp for dry air only (same total energy as CAM physics uses).
For more details see Lauritzen et al., (2018;DOI:10.1029/2017MS001257)
Default: FALSE
</entry>

<entry id="fv3_fv_sg_adj" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: timescale (in seconds) at which to remove two-delta-z
instability when the local (between two adjacent levels) Richardson
number is less than 1. This is achieved by local mixing, which conserves
mass, momentum, and total energy. Values of 0 or smaller
disable this feature. If fv3_n_sponge &lt; 0 then the mixing is applied
only to the top fv3_n_sponge layers of the domain. Proper range is 0 to 3600.
Default: 0
</entry>

<entry id="fv3_grid_type" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: which type of grid to use. If 0, the equidistant gnomonic
cubed-sphere will be used. If 4, a doubly-periodic f-plane cartesian
grid will be used. If -1, the grid is read from INPUT/grid_spec.nc.
Other FV3 grid type values (2, 3, 5, 6, and 7) are not supported
and will likely not run.
Default: 0
</entry>

<entry id="fv3_hord_dp" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: horizontal advection scheme for mass. A positivity
constraint may be warranted for fv3_hord_dp but not strictly necessary.

Hord horizontal advection method
================================
5     Unlimited fifth-order scheme with 2 delta x filter; fastest and
      least diffusive
6     Intermediate-strength monotonicity constraint. Gives best
      ACC but weaker TCs
7     #6 with a positive-definite constraint
8     Lin 2004 monotone PPM constraint; overall best for tracers?
9     Hunyh constraint: more expensive but less diffusive than #8
10    9, with a 2 delta x filter, and the Huynh constraint applied only if a
      certain condition is met; otherwise unlimited
-5    #5 with a positive-definite constraint
-10   #10 with a positive-definite constraint
Default: -10 (hydrostatic) or -5 (non-hydrostatic)
</entry>

<entry id="fv3_hord_mt" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: horizontal advection scheme for momentum fluxes. A
complete list of kord options is given in the table below.
10 is the default for hydrostatic simulations, using a
limited form of the monotonicity constraint
of Huynh, which is less diffusive than other constraints.
5 is the default for non-hydrostatic simulations which uses the
completely unlimited (linear or non-monotone) PPM scheme.
If no monotonicity constraint is applied, enabling
the flux damping (fv3_do_vort_damp = .true.) is highly recommended
to control grid-scale noise. It is also recommended that fv3_hord_mt,
fv3_hord_vt, fv3_hord_tm, and fv3_hord_dp use the same value, to ensure consistent
transport of all dynamical fields, unless a positivity constraint
on mass advection (fv3_hord_dp) is desired.

Hord horizontal advection method
================================
5     Unlimited fifth-order scheme with 2 delta x filter; fastest and
      least diffusive
6     Intermediate-strength monotonicity constraint. Gives best
      ACC but weaker TCs
7     #6 with a positive-definite constraint
8     Lin 2004 monotone PPM constraint; overall best for tracers?
9     Hunyh constraint: more expensive but less diffusive than #8
10    9, with a 2 delta x filter, and the Huynh constraint applied only if a
      certain condition is met; otherwise unlimited
-5    #5 with a positive-definite constraint
-10   #10 with a positive-definite constraint
Default: 10 (hydrostatic) or 5 (non-hydrostatic)

</entry>

<entry id="fv3_hord_tm" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: horizontal advection scheme for potential temperature
and layer thickness in nonhydrostatic simulations.
10 is the default for hydrostatic simulations, using a
limited form of the monotonicity constraint
of Huynh, which is less diffusive than other constraints.
5 is the default for non-hydrostatic simulations which uses the
completely unlimited (linear or non-monotone) PPM scheme.

Hord horizontal advection method
================================
5     Unlimited fifth-order scheme with 2 delta x filter; fastest and
      least diffusive
6     Intermediate-strength monotonicity constraint. Gives best
      ACC but weaker TCs
7     #6 with a positive-definite constraint
8     Lin 2004 monotone PPM constraint; overall best for tracers?
9     Hunyh constraint: more expensive but less diffusive than #8
10    9, with a 2 delta x filter, and the Huynh constraint applied only if a
      certain condition is met; otherwise unlimited
-5    #5 with a positive-definite constraint
-10   #10 with a positive-definite constraint
Default: 10 (hydrostatic) or 5 (non-hydrostatic)
</entry>

<entry id="fv3_hord_tr" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: horizontal advection scheme for tracers. 8 by default.
This value can differ from the other hord options since tracers are
sub-cycled and require positive-definite
advection to control the appearance of non-physical negative masses.
8 (fastest) or 10 (least diffusive) are typically recommended.

Hord horizontal advection method
================================
5     Unlimited fifth-order scheme with 2 delta x filter; fastest and
      least diffusive
6     Intermediate-strength monotonicity constraint. Gives best
      ACC but weaker TCs
7     #6 with a positive-definite constraint
8     Lin 2004 monotone PPM constraint; overall best for tracers?
9     Hunyh constraint: more expensive but less diffusive than #8
10    9, with a 2 delta x filter, and the Huynh constraint applied only if a
      certain condition is met; otherwise unlimited
-5    #5 with a positive-definite constraint
-10   #10 with a positive-definite constraint
Default:8
</entry>

<entry id="fv3_hord_vt" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: horizontal advection scheme for absolute vorticity and
for vertical velocity in nonhydrostatic simulations.
10 is the default for hydrostatic simulations, using a
limited form of the monotonicity constraint
of Huynh, which is less diffusive than other constraints.
5 is the default for non-hydrostatic simulations which uses the
completely unlimited (linear or non-monotone) PPM scheme.

Hord horizontal advection method
================================
5     Unlimited fifth-order scheme with 2 delta x filter; fastest and
      least diffusive
6     Intermediate-strength monotonicity constraint. Gives best
      ACC but weaker TCs
7     #6 with a positive-definite constraint
8     Lin 2004 monotone PPM constraint; overall best for tracers?
9     Hunyh constraint: more expensive but less diffusive than #8
10    9, with a 2 delta x filter, and the Huynh constraint applied only if a
      certain condition is met; otherwise unlimited
-5    #5 with a positive-definite constraint
-10   #10 with a positive-definite constraint
Default: 10 (hydrostatic) or 5 (non-hydrostatic)
</entry>

<entry id="fv3_hydrostatic" type="logical" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Logical: whether to use the hydrostatic or nonhydrostatic
solver.
Default: TRUE
</entry>

<entry id="fv3_ke_bg" type="real" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Real: background KE production (m^2/s^3) over a small step
Use this to conserve total energy if fv3_consv_te=0
Default: 0
</entry>

<entry id="fv3_kord_mt" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: vertical remapping scheme for the winds.
9 is recommended as the safest option, although 10, and 11 can also
be useful.

kord table
==========
4    Monotone PPM
6    Vanilla PPM
7    PPM with Hyunh monotonicity constraint(more expensive but less diffusive)
9    Monotonic Cubic Spline
10   Selectively (local extrema retained) monotonic Cubic Spline with 2 delta z
     oscillations removed
11   Non-monotonic cubic spline with 2 delta z oscillations removed
Default: 9

</entry>

<entry id="fv3_kord_tm" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: vertical remapping scheme for temperature. If positive (not
recommended), then vertical remapping is performed on
total energy instead of temperature (see remap_t below).
kord table
==========
4    Monotone PPM
6    Vanilla PPM
7    PPM with Hyunh monotonicity constraint(more expensive but less diffusive)
9    Monotonic Cubic Spline
10   Selectively (local extrema retained) monotonic Cubic Spline with 2 delta z
     oscillations removed
11   Non-monotonic cubic spline with 2 delta z oscillations removed
-9   Monotonic Cubic Spline with a positive-definite constraint
Default: -9
</entry>

<entry id="fv3_kord_tr" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: vertical remapping scheme for tracers.
9 or 11 recommended.  It is recommended that the value
of fv3_kord_tr should match fv3_kord_tm.

kord table
==========
4    Monotone PPM
6    Vanilla PPM
7    PPM with Hyunh monotonicity constraint(more expensive but less diffusive)
9    Monotonic Cubic Spline
10   Selectively (local extrema retained) monotonic Cubic Spline with 2 delta z
     oscillations removed
11   Non-monotonic cubic spline with 2 delta z oscillations removed
Default: 9
</entry>

<entry id="fv3_kord_wz" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: vertical remapping scheme for vertical velocity in
nonhydrostatic simulations. It is recommended that the value
of fv3_kord_wz should match fv3_kord_mt.

kord table
==========
4    Monotone PPM
6    Vanilla PPM
7    PPM with Hyunh monotonicity constraint(more expensive but less diffusive)
9    Monotonic Cubic Spline
10   Selectively (local extrema retained) monotonic Cubic Spline with 2 delta z
     oscillations removed
11   Non-monotonic cubic spline with 2 delta z oscillations removed
Default: 9
</entry>

<entry id="fv3_k_split" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: number of vertical remappings per dt_atmos (physics
time step).
Default: 2
</entry>

<entry id="fv3_layout" type="integer(2)" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer(2): Processor layout on each tile. The number of PEs
assigned to a domain must equal fv3_layout(1)*fv3_layout(2)*ntiles. Must be
set.
Default: none
</entry>

<entry id="fv3_make_nh" type="logical" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Logical: Whether to re-initialize the nonhydrostatic state, by
re-computing dz from hydrostatic balance and setting w to 0.
Default: FALSE
</entry>

<entry id="fv3_na_init" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: Number of forward-backward dynamics steps used to
initialize adiabatic solver. Not recommended if not
cold-starting the model.
Default: 0
</entry>

<entry id="fv3_ncnst" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: Number of tracer species advected by fv_tracer in the dynamical core.
Typically this is set automatically by reading in values from field_table,
but fv3_ncnst can be set to a smaller value so only the first ncnst tracers
listed in field_table are not advected.
Default: none
</entry>

<entry id="fv3_nord" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: order of divergence damping: 0 for second-order; 1 for
fourth-order; 2 for sixth-order; 3 for eighth-order.
Sixth-order may yield a better solution for low resolutions (one degree or
coarser) by virtue of it being more scale-selective and will not damp
moderately-well-resolved disturbances as much as does lower-order
damping.
Default: 3
</entry>

<entry id="fv3_no_dycore" type="logical" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Logical: disables execution of the dynamical core, only running
the initialization, diagnostic, and I/O routines, and any physics
that may be enabled.
Default: FALSE
</entry>

<entry id="fv3_npx" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: Number of grid corners in the x-direction on one tile of the
domain; so one more than the number of grid cells across a tile. On
the cubed sphere this is one more than the number of cells across a
cube face. Must be set.
Default: none
</entry>

<entry id="fv3_npy" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: Number of grid corners in the y-direction on one tile of the
domain. This value should be identical to fv3_npx on a cubed-sphere
grid; doubly periodic or nested grids do not have this restriction.
Must be set.
Default: none
</entry>

<entry id="fv3_npz" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
z Integer: Number of vertical levels. Each choice of fv3_npz comes with a
pre-defined set of hybrid sigma-pressure levels and model top (see
fv_eta.F90). Must be set.
Default: none
</entry>

<entry id="fv3_ntiles" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: Number of tiles on the domain. For the cubed sphere, this
should be 6, one tile for each face of the cubed sphere; normally for
most other domains (including nested grids) this should be set to 1.
Must be set.
Default: 6
</entry>

<entry id="fv3_nwat" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: Number of water species to be included in condensate and
water vapor loading. The masses of the first nwat tracer species
will be added to the dry air mass, so that p is the mass of dry air,
water vapor, and the included condensate species. The value used
depends on the microphysics in the physics package you are using.
This value is set by namelist defaults.
Default: None
</entry>

<entry id="fv3_n_split" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: number of small dynamics (acoustic) time steps between
vertical remapping. A setting of 0 allows the model to choose a value
by examining the resolution, dt_atmos, and fv3_k_split.
Default: 6
</entry>

<entry id="fv3_n_sponge" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: controls the number of layers at the upper boundary
on which the 2 delta x filter is applied.
Default: 0
</entry>

<entry id="fv3_print_freq" type="integer" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Integer: number of hours between print out of max/min and
air/tracer mass diagnostics to standard output. 0
never prints out any output; set to -1 to see output after every
dt_atmos. Computing these diagnostics requires some computational overhead.
Default: 0
</entry>

<entry id="fv3_range_warn" type="logical" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Logical: checks whether the values of the prognostic variables
are within a reasonable range at the end of a dynamics time
step, and prints a warning if not. Adds computational overhead,
so we only recommend using this when debugging.
Default: FALSE
</entry>

<entry id="fv3_rf_cutoff" type="real" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Real: pressure below which no Rayleigh damping is applied if
tau &gt; 0.
Default: 750
</entry>

<entry id="fv3_tau" type="real" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Real: time scale (in days) for Rayleigh friction applied to horizontal
and vertical winds; lost kinetic energy is converted to heat, except
on nested grids. 0.0 disables damping. Larger values yield less damping.
For models with tops at 1 mb or lower
values between 10 and 30 are useful for preventing overly-strong
polar night jets; for higher-top hydrostatic models values between
5 and 15 should be considered; and for non-hydrostatic models
values of 10 or less should be considered, with smaller values for
higher-resolution.
Default: 10
</entry>

<entry id="fv3_vtdm4" type="real" category="dyn_fv3"
       group="fv_core_nml" valid_values="" >
Real: coefficient for background other-variable damping. The
value of fv3_vtdm4 should be less than that of fv3_d4_bg. A good first guess
for fv3_vtdm4 is about one-third the value of fv3_d4_bg.
Requires fv3_do_vort_damp to be .true. Disabled for values less than
1.e-3. Other-variable damping should not be used if a monotonic
horizontal advection scheme is used.
Default: 0.0
</entry>

<entry id="fv3_scale_ttend" type="logical" category="dyn_fv3"
       group="dyn_fv3_inparm" valid_values="" >
If TRUE perform temp tendency scaling before send to fv3 dynamics
Default: FALSE
</entry>

</namelist_definition>