controls_dev.defaults

! ============
! controls_dev
! ============

! .. warning::
!
!  CONTAINS OPTIONS THAT HAVE NOT YET BEEN THE GIVEN A GREEN LIGHT FOR GENERAL USE.
!  IN PARTICULAR, THESE ARE NOT YET FOR USE IN RESEARCH TO BE PUBLISHED.

      ! TDC options
      ! ~~~~~~~~~~~
      ! ::

      compare_TDC_to_MLT = .false.

      ! RSP2 parameters
      ! ~~~~~~~~~~~~~~~

      !|   RSP2_alfad =     1.0d0         ! turbulent dissipation; damp ~ RSP2_alfad
      !|   RSP2_alfap =     0.0d0         ! turbulent pressure; Pt ~ alfap
      !|   RSP2_alfat =     0.0d0         ! turbulent flux; Lt ~ RSP2_alfat
      !|   RSP2_alfam =     0.25d0        ! turbulent viscosity; Eq and Uq ~ RSP2_alfam
      !|   RSP2_alfar =     0.0d0         ! radiative dissipation of turbulent energy; Dr ~ RSP2_alfar
      !
      ! RSP2 time weighting is determined by the velocity_time_centering controls.
      !
      !     + for Pt and Lt in turbulent energy equation
      !     + for P and grav in momentum equation
      !     + for P and L in energy equation
      !     + for area when multiplied by P
      !
      ! RSP2_Lsurf_factor: Lsurf = RSP2_Lsurf_factor*area(1)*clight*crad*T(1)**4
      ! RSP2_use_Stellingwerf_Lr as in RSP
      !

      ! ::

    RSP2_alfad = 1.0d0
    RSP2_alfap = 0.0d0
    RSP2_alfat = 0.0d0
    RSP2_alfam = 0.25d0
    RSP2_alfar = 0.0d0

    RSP2_min_Lt_div_L_for_overshooting_mixing_type = 1d-4
    RSP2_min_Lc_div_L_for_convective_mixing_type = 1d-4

    RSP2_Lsurf_factor = 0.5d0

    RSP2_report_adjust_w = .false.
    RSP2_use_L_eqn_at_surface = .true.
    RSP2_assume_HSE = .true.
    RSP2_use_RSP_eqn_for_Y_face = .true.
    RSP2_use_mass_interp_face_values = .false.
    RSP2_use_Stellingwerf_Lr = .true.

    RSP2_num_outermost_cells_forced_nonturbulent = 0
    RSP2_num_innermost_cells_forced_nonturbulent = 0

   RSP2_w_fix_if_neg = 5d-5
   RSP2_w_min_for_damping = 1d2
   RSP2_source_seed = 0d0

   RSP2_remesh_when_load = .true.

   RSP2_nz = 150
   RSP2_nz_outer = 40
   RSP2_T_anchor = 11d3
   RSP2_dq_1_factor = 2d0

   RSP2_nz_div_IBOTOM = 30d0


      ! period controls

      ! ::

    RSP2_target_steps_per_cycle = 600
    RSP2_min_max_R_for_periods = -1

      ! when to stop

      ! ::

    RSP2_max_num_periods = -1
    RSP2_GREKM_avg_abs_frac_new = 0.1d0
    RSP2_GREKM_avg_abs_limit = -1

      ! output data for work integrals during a particular period

      ! ::

    RSP2_work_period = -1
    RSP2_work_filename = 'work.data'

      ! output data for 3d map.  format same as for gnuplot pm3d

      ! ::

    RSP2_write_map = .false.
    RSP2_map_columns_filename = 'map_columns.list'

      ! items listed in your map columns must also appear in your profile columns

      ! ::

    RSP2_map_filename = 'map.data'
    RSP2_map_first_period = -1
    RSP2_map_last_period = -1
    RSP2_map_zone_interval = 2
    RSP2_map_history_filename = 'map_history.data'


! mass corrections
! ================


      ! use_mass_corrections
      ! ~~~~~~~~~~~~~~~~~~~~

      ! Gravitational vs baryonic mass corrections.

      ! The Lagrangian coordinate (:math:`m`) in MESA is the baryonic
      ! mass and the density (:math:`\rho`) is the baryonic mass
      ! density.

      ! If false, then no distinction between gravitational and baryonic mass.
      ! If true, then the gravitational mass is calculated using mass corrections
      ! and the momentum equation, total energy equation, and Brunt are modified.

      ! The variable ``mass_correction`` is the quantity you multiply
      ! the baryonic mass density by to get the gravitational mass
      ! density:

      !     (mass density) = (baryon density) * amu * mass_correction

      ! Given the mass fractions in a cell, the value of
      ! mass_correction is provided by the ``chem`` module.

      ! MESA holds m_grav fixed during the newton iterations.  This results
      ! in an energy conservation error, because the specific potential energy
      ! changes when m_grav is updated afterwards.  A message showing
      ! the relative energy error incurred due to this assumption
      ! will be printed to the terminal.

      ! Not compatible with RSP.

      ! ::

    use_mass_corrections = .false.


      ! phase_separation_no_diffusion
      ! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

      ! if true and element diffusion is on, prevent element diffusion
      ! from occurring in the layers where phase separation mixing
      ! is present (experimental)

      ! ::

    phase_separation_no_diffusion = .false.


! split burn
! ==========


      ! op_split_burn_min_T_for_variable_T_solver
      ! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

      ! use variable T, constant density solver for op_split_burn in cells with T >= this limit at start of step.
      ! only adopted in cells with T >= op_split_burn_min_T at start of step.

      ! ::

    op_split_burn_min_T_for_variable_T_solver = 1d99


! TDC
! ===


      ! TDC_use_density_form_for_eddy_viscosity
      ! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

      ! If ``u_flag = .true.`` or ``TDC_use_density_form_for_eddy_viscosity = .true.``, use density
      ! derivative from newton solver to form d(v/r)/dr, used to compute Eq and Uq.

    TDC_use_density_form_for_eddy_viscosity = .false.


      ! use_TDC_enthalpy_flux_limiter
      ! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

      ! If use_TDC_enthalpy_flux_limiter = .true. , apply enthalpy flux limiter to TDC
      ! similar to the form presented in Wuchterl & Feuchtinger 1998, and Smolec 2008.

      ! ::

    use_TDC_enthalpy_flux_limiter = .false.


      ! use_face_values_eos_and_kap_mlt_tdc
      ! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

      ! MESA interpolates primitive solver variables such as T, rho, L, and
      ! composition, together with constructed quantities such as opacity,
      ! pressure, and other EOS results, onto cell faces for use in MLT and
      ! TDC. If use_face_values_eos_and_kap_mlt_tdc = .true., this option
      ! instead reconstructs only the primitive face variables and then makes
      ! additional EOS and opacity calls to obtain the thermodynamic quantities
      ! corresponding to that face state. Despite the cost of the extra EOS and
      ! opacity work, this can improve accuracy on coarse meshes, especially in
      ! unresolved opacity bumps in pulsating envelopes, and is a potential
      ! candidate for becoming the default mode, pending further testing.

      ! ::

    use_face_values_eos_and_kap_mlt_tdc = .false.


      ! include_mlt_Pturb_in_thermodynamic_gradients
      ! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

      ! If mlt_Pturb_factor > 0, includes the effect of turbulent pressure Pturb
      ! on thermodynamic gradients gradr, grada, and hence gradT.
      ! Not supported by other_alpha_mlt or starspots

      ! ::

    include_mlt_Pturb_in_thermodynamic_gradients = .false.


      ! include_mlt_in_velocity_time_centering
      ! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

      ! If doing velocity time_centering, include time centering in mlt. Depending on the time
      ! centering flags adopted, include_mlt_in_velocity_time_centering includes time centering
      ! for P, L, and r in geff, gradr, grada, and mlt.
      ! Currently not supported together with ``use_face_values_eos_and_kap_mlt_tdc``.

      ! ::

    include_mlt_in_velocity_time_centering = .false.


! Remeshing
! =========


      ! use_hydro_merge_limits_in_mesh_plan
      ! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

      ! Allows use of ``merge_amr_max_abs_du_div_cs``, ``merge_amr_du_div_cs_limit_only_for_compression``,
      ! and ``merge_amr_inhibit_at_jumps`` in default mesh_plan when ``use_split_merge_amr = .false.``.
      ! Only supports ``v_flag``.

      ! ::

    use_hydro_merge_limits_in_mesh_plan = .false.