==================================
Appendix B: Model Namelist Options
==================================

|

This chapter summarizes the complete set of namelist options available when running the MPAS non-hydrostatic atmosphere model. All date-time string specifications are of the form described at the beginning of `Appendix A <./appA_init_namelist>`_.

|

|

B.1 |nbsp| |nbsp| |nbsp| nhyd_model
===================================

**config_time_integration** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Time integration scheme *(hidden by default)*
   Possible Values, 'SRK3' *(default: SRK3)*

|

**config_time_integration_order** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Order for RK time integration
   Possible Values, 2 or 3 *(default: 2)*

|

**config_dt** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, s
   Description, Model time step in seconds
   Possible Values, Positive real values *(default: 720.0)*

|

**config_calendar_type** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Simulation calendar type *(hidden by default)*
   Possible Values, 'gregorian'\, 'gregorian_noleap' *(default: gregorian)*

|

**config_start_time** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Starting time for model simulation
   Possible Values, 'YYYY-MM-DD_hh:mm:ss' *(default: none)*

|

**config_stop_time** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Stopping time for model simulation *(hidden by default)*
   Possible Values, 'YYYY-MM-DD_hh:mm:ss' *(default: none)*

|

**config_run_duration** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Length of model simulation
   Possible Values, [DDD]\_hh:mm:ss *(default: 5_00:00:00*

|

**config_split_dynamics_transport** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Whether to super-cycle scalar transport
   Possible Values, Logical values *(default: true)*

|

**config_number_of_sub_steps** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Number of acoustic steps per full RK step
   Possible Values, Positive\, even integer values\, typically 2 or 6 depending on transport splitting *(default: 2)*

|

**config_dynamics_split_steps** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, When config_split_dynamics_transport = T\, the number of RK steps per transport step
   Possible Values, Positive integer values *(default: 3)*

|

**config_h_mom_eddy_visc2** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, m\ :sup:`2` s\ :sup:`-1`
   Description, :math:`\\nabla^2` eddy viscosity for horizontal diffusion of momentum *(hidden by default)* 
   Possible Values, Positive real values *(default: 0.0)*

|

**config_h_mom_eddy_visc4** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, m\ :sup:`4` s\ :sup:`-1`
   Description, :math:`\\nabla^2` eddy hyper-viscosity for horizontal diffusion of momentum *(hidden by default)* 
   Possible Values, Positive real values *(default: 0.0)*

|

**config_v_mom_eddy_visc2** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, m\ :sup:`2` s\ :sup:`-1`
   Description, :math:`\\nabla^2` eddy viscosity for vertical diffusion of momentum *(hidden by default)* 
   Possible Values, Positive real values *(default: 0.0)*

|

**config_h_theta_eddy_visc2** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, m\ :sup:`2` s\ :sup:`-1`
   Description, :math:`\\nabla^2` eddy viscosity for horizontal diffusion of theta *(hidden by default)* 
   Possible Values, Positive real values *(default: 0.0)*

|

**config_h_theta_eddy_visc4** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, m\ :sup:`4` s\ :sup:`-1`
   Description, :math:`\\nabla^2` eddy hyper-viscosity for horizontal diffusion of theta *(hidden by default)* 
   Possible Values, Positive real values *(default: 0.0)*

|

**config_v_theta_eddy_visc2** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, m\ :sup:`2` s\ :sup:`-1`
   Description, :math:`\\nabla^2` eddy viscosity for vertical diffusion of theta *(hidden by default)* 
   Possible Values, Positive real values *(default: 0.0)*

|

**config_horiz_mixing** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Formulation of horizontal mixing
   Possible Values,'2d_fixed' or '2d_smagorinsky' *(default: 2d_smagorinsky)*

|

**config_len_disp** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, m
   Description, Horizontal length scale\, used by the Smagorinsky formulation of horizontal diffusion and by 3-d divergence damping *(hidden by default)*
   Possible Values, Positive real values. A zero value implies that the length scale is prescribed by the nominalMinDc value in the input file. *(default: 0.0)*

|

**config_visc4_2dsmag** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Scaling coefficient of :math:`\\delta x^3` to obtain :math:`\\nabla^4` diffusion coefficient
   Possible Values, Non-negative real values *(default: 0.05)*

|

**config_del4u_div_factor** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Scaling factor for the divergent component of :math:`\\nabla^4u` calculation *(hidden by default)*
   Possible Values, Positive real values *(default: 10.0)*

|

**config_w_adv_order** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Horizontal advection order for w *(hidden by default)*
   Possible Values, 2\, 3\, or 4 *(default: 3)*

|

**config_theta_adv_order** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Horizontal advection order for theta *(hidden by default)*
   Possible Values, 2\, 3\, or 4 *(default: 3)*

|

**config_scalar_adv_order** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Horizontal advection order for scalars *(hidden by default)*
   Possible Values, 2\, 3\, or 4 *(default: 3)*

|

**config_u_vadv_order** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Vertical advection order for normal velocities (u) *(hidden by default)*
   Possible Values, 2\, 3\, or 4 *(default: 3)*

|

**config_w_vadv_order** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Vertical advection order for w *(hidden by default)*
   Possible Values, 2\, 3\, or 4 *(default: 3)*

|

**config_theta_vadv_order** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Vertical advection order for theta *(hidden by default)*
   Possible Values, 2\, 3\, or 4 *(default: 3)*

|

**config_scalar_vadv_order** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Vertical advection order for scalars *(hidden by default)*
   Possible Values, 2\, 3\, or 4 *(default: 3)*

|

**config_scalar_advection** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Whether to advect scalar fields
   Possible Values, true or false *(default: true)*

|

**config_positive_definite** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Whether to enable positive-definite advection of scalars *(hidden by default)*
   Possible Values, true or false *(default: false)*

|

**config_monotonic** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Whether to enable monotonic limiter in scalar advection
   Possible Values, true or false *(default: true)*

|

**config_coef_3rd_order** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Upwinding coefficient in the 3rd order advection scheme
   Possible Values, 0 |le| config_coef_3rd_order |le| 1 *(default: 0.25)*

|

**config_smagorinsky_coef** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Dimensionless empirical parameter relating the strain tensor to the eddy viscosity in the Smagorinsky turbulence model *(hidden by default)*
   Possible Values, Real values typically in the range of 0.1 to 0.4 *(default: 0.125)*

|

**config_mix_full** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Mix full :math:`\\theta` and :math:`u` fields\, or mix perturbation from initial state *(hidden by default)* 
   Possible Values, true or false *(default: true)*

|

**config_epssm** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Off-centering parameter for the vertically implicit acoustic integration
   Possible Values, Positive real values *(default: 0.1)*

|

**config_smdiv** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, 3-d divergence damping coefficient
   Possible Values, Positive real values *(default: 0.1)*

|

**config_apvm_upwinding** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Amount of upwinding in APVM *(hidden by default)*
   Possible Values, 0 |le| config_apvm_upwinding |le| 1 *(default: 0.5)*

|

**config_h_ScaleWithMesh** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Scale eddy viscosities with mesh-density function for horizontal diffusion *(hidden by default)*
   Possible Values, true or false *(default: true)*

|

**config_num_halos** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Number of halo layers for fields *(hidden by default)*
   Possible Values, Integer values\, typically 2 or 3; DO NOT CHANGE *(default: 2)*

|

**config_relax_zone_divdamp_coef** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Coefficient for the divergent component of the Laplacian filter of momentum in the relaxation zone *(hidden by default)*
   Possible Values, Positive real values *(default: 6.0)*

|

|

|

B.2 |nbsp| |nbsp| |nbsp| damping
================================

**config_zd** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, m
   Description, Height MSL to begin w-damping profile 
   Possible Values, Positive real values *(default: 22000.0)*

|

**config_xnutr** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Maximum w-damping coefficient at model top
   Possible Values, 0 |le| config_xnutr |le| 1 *(default: )*

|

**config_mpas_cam_coef** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Coefficient for scaling the 2nd-order horizontal mixing in the mpas_cam absorbing layer *(hidden by default)*
   Possible Values, 0 |le| config_mpas_cam_coef |le| 1\, standard value is 0.2 *(default: 0.0)*

|

**config_number_cam_damping_levels** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Number of layers in which to apply cam 2nd-order horizontal filter top of model; viscosity linearly ramps to zero by layer number from the top *(hidden by default)*
   Possible Values, Positive integer values *(default: 4)*

|

**config_rayleigh_damp_u** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, 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 *(hidden by default)*
   Possible Values, true or false *(default: false)*

|

**config_rayleigh_damp_u_timescale_days** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, days
   Description, Timescale\, in days (86400 s)\, for the Rayleigh damping on horizontal velocity in the top-most model levels *(hidden by default)*
   Possible Values, Positive real values *(default: 5.0)*

|

**config_number_rayleigh_damp_u_levels** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Number of 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 *(hidden by default)*
   Possible Values, Positive integer values *(default: 6)*

|

|

|

B.3 |nbsp| |nbsp| |nbsp| limited_area
=====================================

**config_apply_lbcs** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, m
   Description, Whether to apply lateral boundary conditions 
   Possible Values, true or false; this option must be set to true for limited-area simulations and false for global simulations *(default: false)*

|

|

|

B.4 |nbsp| |nbsp| |nbsp| io
===========================

**config_restart_timestamp_name** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Filename used to store most recent restart time stamp *(hidden by default)*
   Possible Values, Any valid filename *(default: restart_timestamp)*

|

**config_pio_num_iotasks** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Number of tasks to perform file I/O
   Possible Values, Integer valued\, 0 |le| config_pio_num_iotasks |le| (# MPI tasks); 0 indicates all tasks perform I/O *(default: 0)*

|

**config_pio_stride** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Stride between file I/O tasks
   Possible Values, Integer value\, |le| (# MPI tasks) / config_pio_num_iotasks *(default: 1)*

|

|

|

B.5 |nbsp| |nbsp| |nbsp| decomposition
======================================

**config_block_decomp_file_prefix** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Prefix of graph decomposition file\, to be suffixed with the MPI task count
   Possible Values, Any valid filename *(default: x1.40962.graph.info.part.)*

|

**config_number_of_blocks** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Number of blocks to assign to each MPI task *(hidden by default)*
   Possible Values, Positive integer values *(default: 0)*

|

**config_explicit_proc_decomp** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Whether to use an explicit mapping of blocks to MPI tasks *(hidden by default)*
   Possible Values, true or false *(default: false)*

|

**config_proc_decomp_file_prefix** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Prefix of block mapping file *(hidden by default)*
   Possible Values, Any valid filename *(default: graph.info.part.)*

|

|

|

B.6 |nbsp| |nbsp| |nbsp| restart
================================

**config_do_restart** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Whether this run of the model is to restart from a previous restart file
   Possible Values, true or false *(default: false)*

|

**config_do_DAcycling** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Whether to re-compute coupled fields :math:`\\theta_{m}`\, :math:`\\tilde{\\rho}`\, :math:`\\rho u`\, etc. from uncoupled fields when restarting the model; used for cycling DA experiments that analyze uncoupled fields in restart files *(hidden by default)* 
   Possible Values, true or false *(default: false)*

|

|

|

B.7 |nbsp| |nbsp| |nbsp| printout
=================================

**config_print_global_minmax_vel** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Whether to print the global min/max of horizontal normal velocity and vertical velocity each timestep
   Possible Values, true or false *(default: true)*

|

**config_print_detailed_minmax_vel** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, 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
   Possible Values, true or false *(default: false)*

|

**config_print_global_minmax_sca** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Whether to print the global min/mx of scalar fields each timestep *(hidden by default)*
   Possible Values, true or false *(default: false)*

|

|

|

B.8 |nbsp| |nbsp| |nbsp| IAU
============================

**config_IAW_option** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Incremental Analysis Update scheme
   Possible Values, 'off' or 'on'; 'off' turns off IAW; 'on' uses equal weighting of increments across the IAU window *(default: off)*

|

**config_IAU_window_length_s** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, s
   Description, Length of window over which analysis increments are applied
   Possible Values, Non-negative real values *(default: 21600.)*

|

|

|

B.9 |nbsp| |nbsp| |nbsp| assimilation
=====================================

**config_jedi_da** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Whether this run is within the JEDI data assimilation framework; used to add temperature and specific humidity as diagnostics *(hidden by default)*
   Possible Values, true or false *(default: false)*

|

|

|

B.10 |nbsp| |nbsp| |nbsp| development
=====================================

**config_halo_exch_method** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Method to use for exchanging halos *(hidden by default)*
   Possible Values, 'mpas_dmpar'\, 'mpas_halo' *(default: mpas_halo)*

|

|

|

B.11 |nbsp| |nbsp| |nbsp| physics
=================================

**input_soil_data** (character)

.. csv-table::
   :width: 80%
   :widths: 20,60

   :escape: \

   Units, " "
   Description, Input soil use classification *(hidden by default)*
   Possible Values,

|

**input_soil_temperature_lab** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Days over which the deep soil temperature is computed using skin temperature *(hidden by default)*
   Possible Values, Positive integers *(default: 140)*

|

**num_soil_layers** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Number of soil layers in Noah land surface scheme *(hidden by default)*
   Possible Values, Positive integers; for Noah LSM\, must be set to 4 *(default: 4)*

|

**months** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Number of months per year *(hidden by default)*
   Possible Values, Positive integer values; DO NOT CHANGE *(default: 12)*

|

**noznlev** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Number of prescribed pressure levels for input climatological ozone volume mixing ratios *(hidden by default)*
   Possible Values, Positive integers *(default: 59)*

|

**naerlev** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Number of prescribed pressure levels for input climatological aerosol mixing ratios *(hidden by default)*
   Possible Values, Positive integers *(default: 29)*

|

**camdim1** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Dimension of CAM radiation absorption save array *(hidden by default)*
   Possible Values, Positive integers *(default: 4)*

|

**config_frac_seaice** (logial)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Logical for configuration of fractional seaice *(hidden by default)*
   Possible Values, .true. for seaice between 0 and 1; .false. for seaice equal to 0 or 1 (flag) *(default: true)*

|

**config_sfc_albedo** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Logical for configuration of surface albedo *(hidden by default)*
   Possible Values, .true. for climatologically varying surface albedo; .false. for fixed input data *(default: true)*

|

**config_sfc_snowalbedo** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Logical for configuration of maximum surface albedo for snow *(hidden by default)*
   Possible Values, .true. for geographical distributions; .false. for fixed input data *(default: true)*

|

**config_sst_update** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Logical for configuration of sea-surface temperature
   Possible Values, .true. for time-varying sea-surface temperatures; .false.\, otherwise *(default: false)*

|

**config_sstdiurn_update** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Logical for configuration of diurnal cycle of sea-surface temperatures
   Possible Values, .true. for applying a diurnal cycle to sea-surface temperatures; .false.\, otherwise *(default: false)*

|

**config_deepsoiltemp_udpate** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Logical for configuration of deep soil temperatures
   Possible Values, .true. for slowly time-varying deep soil temperatures; .false.\, otherwise *(default: false)*

|

**config_o3climatology** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Logical for configuration of input ozone data in RRTMG long- and short-wave radiation *(hidden by default)*
   Possible Values, .true. for using monthly-varying ozone data; .false. for using fixed vertical profile *(default: true)*

|

**config_microp_re** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Logical for calculation of the effective radii for cloud water\, cloud ice\, and snow *(hidden by default)*
   Possible Values, .true. for calculating effective radii; .false. for using defaults in RRTMG radiation *(default: false)*

|

**config_ysu_pblmix** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Logical for turning on/off top-down\, radiation-driven mixing *(hidden by default)*
   Possible Values, .true. to turn on top-down radiation-driven mixing; .false.\, otherwise *(default: false)*

|

**config_n_microp** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Number of microphysics time-steps per physics time-steps *(hidden by default)*
   Possible Values, Positive integers *(default: 1)*

|

**config_radtlw_interval** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, time interval between calls to parameterization of long-wave radiation
   Possible Values, 'DD_HH:MM:SS' or 'none' *(default: 00:30:00)*

|

**config_radtsw_interval** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, time interval between calls to parameterization of short-wave radiation
   Possible Values, 'DD_HH:MM:SS' or 'none' *(default: 00:30:00)*

|

**config_conv_interval** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Time interval between calls to parameterization of convection *(hidden by default)*
   Possible Values, 'DD_HH:MM:SS' or 'none' *(default: none)*

|

**config_pbl_interval** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Time interval between calls to parameterization of planetary boundary layer *(hidden by default)*
   Possible Values, 'DD_HH:MM:SS' or 'none' *(default: none)*

|

**config_camrad_abs_update** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Time interval between updates of absorption/emission coefficients in CAM radiation *(hidden by default)*
   Possible Values, 'DD_HH:MM:SS' or 'none' *(default: 06:00:00)*

|

**config_greeness_update** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Time interval between updates of greeness fraction *(hidden by default)*
   Possible Values, 'DD_HH:MM:SS' or 'none' *(default: 24:00:00)*

|

**config_bucket_update** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Time interval between updates of accumulated rain and radiation diagnostics
   Possible Values, 'DD_HH:MM:SS' or 'none' *(default: none)*

|

**config_physics_suite** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Choice of physics suite
   Possible Values, 'mesoscale_reference'\, 'convection_permitting'\, or 'none' *(default: mesoscale_reference)*

|

**config_microp_scheme** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Configuration for cloud microphysics schemes *(hidden by default)*
   Possible Values, 'suite'\, 'mp_wsm6'\, 'mp_thompson'\, 'mp_kessler'\, 'off' *(default: suite)*

|

**config_convection_scheme** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Configuration for convection schemes *(hidden by default)*
   Possible Values, 'suite'\, 'cu_kain_fritsch'\, 'cu_tiedtke'\, 'cu_ntiedtke'\, 'cu_grell_freitas'\, 'off' *(default: suite)*

|

**config_lsm_scheme** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Configuration for land-surface schemes *(hidden by default)*
   Possible Values, 'suite'\, 'noah'\, 'off' *(default: suite)*

|

**config_pbl_scheme** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Configuration for planetary boundary layer schemes *(hidden by default)*
   Possible Values, 'suite'\, 'bl_ysu'\, 'bl_mynn'\, 'off' *(default: suite)*

|

**config_gwdo_scheme** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Configuration of gravity wave drag over orography *(hidden by default)*
   Possible Values, 'suite'\, 'bl_ysu_gwdo'\, 'off' *(default: suite)*

|

**config_radt_cld_scheme** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Configuration for calculation of horizontal cloud fraction *(hidden by default)*
   Possible Values, 'suite'\, 'cld_fraction'\, 'cld_incidence' *(default: suite)*

|

**config_radt_lw_scheme** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Configuration for long-wave radiation schemes *(hidden by default)*
   Possible Values, 'suite'\, 'rrtmg_lw'\, 'cam_lw'\, 'off' *(default: suite)*

|

**config_radt_sw_scheme** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Configuration for short-wave radiation schemes *(hidden by default)*
   Possible Values, 'suite'\, 'rrtmg_sw'\, 'cam_sw'\, 'off' *(default: suite)*

|

**config_sfclayer_scheme** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Configuration for surface-layer schemes *(hidden by default)*
   Possible Values, 'suite'\, 'sf_monin_obukhov'\, 'sf_mynn'\, 'off' *(default: suite)*

|

**config_gfconv_closure_deep** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Closure option for deep convection in Grell-Freitas convection scheme *(hidden by default)*
   Possible Values, 0 *(default: 0)*

|

**config_gfconv_closure_shallow** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Closure option for shallow convection in Grell-Freitas convection scheme *(hidden by default)*
   Possible Values, 8 *(default: 8)*

|

**config_mynn_tkeadvect** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, = true: do MYNN TKE advection *(hidden by default)*
   Possible Values, true or false *(default: false)*

|

**config_mynn_tkebudget** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, =1: option to add the MYNN TKE budget terms to output *(hidden by default)*
   Possible Values, 0 or 1 *(default: 0)*

|

**config_mynn_closure** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, 2.5 level or 3.0 level for the MYNN TKE turbulence closure *(hidden by default)*
   Possible Values, 2.0\, 2.5\, 3.0 *(default: 2.5)*

|

**config_mynn_cloudpdf** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Switch to different cloud PDFs to represent subgrid clouds in the MYNN PBL scheme *(hidden by default)*
   Possible Values, 0\, 1\, 2 *(default: 2)*

|

**config_mynn_mixlength** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Mixing length in the MYNN PBL scheme; |br| =0: Nakanishi and Niino\, 2009 |br| =1: RAP/HRRR |br| =2: Ito et al.\, 2015 |br| *(hidden by default)*
   Possible Values, 0\, 1\, 2 *(default: 2)*

|

**config_mynn_stfunc** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Option to switch flux profile relationship for surface; |br| =0: Dyer-Hicks |br| =1: Cheng-Brustaert |br| *(hidden by default)*
   Possible Values, 0\, 1 *(default: 1)*

|

**config_mynn_topdown** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Option to add top-down diffusion driven by cloud-top radiative cooling *(hidden by default)*
   Possible Values, 0\, 1 *(default: 0)*

|

**config_mynn_scaleaware**

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Option to turn on the scale-aware option *(hidden by default)*
   Possible Values, 0\, 1 *(default: 1)*

|

**config_mynn_dheat_opt** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Option to activate heating due to dissipation of TKE *(hidden by default)*
   Possible Values, 0\, 1 *(default: 1)*

|

**config_mynn_edmf** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, =1: activate the EDMF option in the MYNN PBL scheme (=0 otherwise) *(hidden by default)*
   Possible Values, 0\, 1 *(default: 1)*

|

**config_mynn_edmf_dd** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, =1: activate the EDMF downdraft option in the MYNN PBL scheme (=0 otherwise) *(hidden by default)*
   Possible Values, 0\, 1 *(default: 0)*

|

**config_mynn_edmf_mom** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, =1: activate momentum transport with the EDMF option for the MYNN PBL scheme (=0 otherwise) *(hidden by default)*
   Possible Values, 0\, 1 *(default: 0)*

|

**config_mynn_edmf_tke** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, =1: activate TKE transport with the EDMF option for the MYNN PBL scheme (=0 otherwise) *(hidden by default)*
   Possible Values, 0\, 1 *(default: 0)*

|

**config_mynn_edmf_output** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, =0: suppress the allocation of variables needed in the EDMF option for the MYNN PBL scheme (=0 otherwise) *(hidden by default)*
   Possible Values, 0\, 1 *(default: 0)*

|

**config_mynn_mixscalars** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, =1: activate mixing of scalars in the MYNN PBL scheme (=0 otherwise) *(hidden by default)*
   Possible Values, 0\, 1 *(default: 1)*

|

**config_mynn_mixclouds** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, =1: activate TKE mixing of cloud condensates in the MYNN PBL scheme (=0 otherwise) *(hidden by default)*
   Possible Values, 0\, 1 *(default: 1)*

|

**config_mynn_mixqt** (integer)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, =0: activate mixing of moisture species separately |br| =1: activate mixing of total water in the MYNN PBL scheme (=0 otherwise) *(hidden by default)*
   Possible Values, 0\, 1 *(default: 0)*

|

**config_bucket_radt** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Threshold above which accumulated radiation diagnostics are reset *(hidden by default)*
   Possible Values, Positive real values *(default: 1.0e9)*

|

**config_bucket_rainc** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Threshold above which accumulated convective precipitation is reset *(hidden by default)*
   Possible Values, Positive real values *(default: 100.0)*

|

**config_bucket_rainnc** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Threshold above which the accumulated grid-scale precipitation is reset *(hidden by default)*
   Possible Values, Positive real values *(default: 100.0)*

|

**config_oml1d** (logical)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Whether to activate the 1-d ocean mixed-layer model *(hidden by default)*
   Possible Values, true or false *(default: false)*

|

**config_oml_hml0** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, m
   Description, If greater than zero\, provides the constanct\, intial mixed-layer depth; if zero\, initial mixed-layer depth will be taken from the 'oml_initial' field *(hidden by default)*
   Possible Values, Non-negative real values *(default: 30.0)*

|

**config_oml_gamma** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, K m\ :sup:`-1`
   Description, Deep water lapse rate in 1-d OML model *(hidden by default)*
   Possible Values, Real values *(default: 0.14)*

|

**config_oml_relaxation_time** (real)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, s
   Description, Relaxation time to initial values in 1-d OML *(hidden by default)*
   Possible Values, Non-negative real values *(default: 864000)*

|

|

|

B.12 |nbsp| |nbsp| |nbsp| soundings
===================================

**config_sounding_interval** (character)

.. csv-table::
   :widths: 20,60
   :width: 80%
   :escape: \

   Units, " "
   Description, Interval between writing of soundings; a value of 'none' disables writing of soundings
   Possible Values, '[DDD]\_hh:mm:ss' or 'none' *(default: none)*

|

|

|

|

|

.. rst-class:: horizbuttons-next-m

* `Next: Appendix C: Grid Description -> <./appC_grid.html>`_

|