# Runtime Parameters Documentation for FLASH Release 4-beta

```
Grid/GridMain
bndPriorityOne [INTEGER] [1]
Valid Values: 1, 2, 3
indicates the direction (IAXIS, JAXIS or KAXIS) gets top priority when
applying boundary conditions in corner guardcells We define three values
for edges left, center, right, of which center represents interior,
while left and right represent the corresponding guardcells. We define a
corner where more than one dimension has its its guardcells, so the
application must determine which direction gets to fill them. In 2-D,
there are four corners: (left,left), (left,right), (right,left) and
(right,right). In 3-D case, the following corners are possible :
(left,left,left),(left,left,center),
(left,left,right),(left,center,left),
(left,center,right),(left,right,left),
(left,right,center),(left,right,right)
(center,left,left),(center,left,right),
(center,right,left),(center,right,right),
(right,left,left),(right,left,center),
(right,left,right),(right,center,left),
(right,center,right),(right,right,left),
(right,right,center),(right,right,right)
bndPriorityThree [INTEGER] [3]
Valid Values: 1, 2, 3
the least priority dimension in applying boundary conditions
bndPriorityTwo [INTEGER] [2]
Valid Values: 1, 2, 3
the second priority dimension in applying boundary conditions
convertToConsvdForMeshCalls [BOOLEAN] [FALSE]
indicates if appropriate variables are converted from primitive to
conserved form during propagation before control is passed to Paramesh
for refinement, derefinement, or guardcell filling.  This is the old way
of ensuring that solution variables are in the correct form for
interpolation. It involves unnecessary conversions back and forth and
should be obsoleted by the newer mechanism enabled by runtime parameter
"convertToConsvdInMeshInterp".  The name is a replacement for the old
"conserved_var" which many people have found to be very confusing
terminology.
eosMode [STRING] ["dens_ie"]
Valid Values: "dens_ie", "dens_pres", "dens_temp", "dens_ie_all",
"dens_ie_scatter", "dens_ie_gather", "dens_ie_sele_gather",
"dens_temp_equi", "dens_temp_all", "dens_temp_gather"
determines how to operate on thermodynamic quantities. Possible values
are "dens_ie", where density and internal energy are supplied and
pressure and temperature are returned; "dens_pres", where density and
pressure are given and energy and temperature are computed;  and
"dens_temp", where density and temperature are given and pressure and
energy are computed. Other values may also be available as, depending on
whether a multiTemp Eos is used and on implementation of additional
physics.
eosModeInit [STRING] ["dens_ie"]
Valid Values: "dens_ie", "dens_pres", "dens_temp", "dens_ie_all",
"dens_ie_scatter", "dens_ie_gather", "dens_temp_equi", "dens_temp_all",
"dens_temp_gather", "eos_nop"
determines how to operate on thermodynamic quantities for the initial
conditions.  A call to Simulation_initBlock sets initial conditions on
each block, and an eos call follows which ensures the initial values are
thermodynamically consistent.  The value of eosModeInit determines the
mode in which these eos calls operate.  Possible values are "dens_ie",
where density and internal energy are supplied and pressure and
temperature are returned; "dens_pres", where density and pressure are
given and energy and temperature are computed; and "dens_temp", where
density and temperature are given and pressure and energy are computed.
Other values may also be available as, depending on whether a multiTemp
Eos is used and on implementation of additional physics.
geometry [STRING] ["cartesian"]
Valid Values: "cartesian", "polar", "cylindrical", "spherical"
Grid geometry
geometryOverride [BOOLEAN] [FALSE]
whether to bypass some geometry sanity checks - use at your own risk.
grav_boundary_type [STRING] ["isolated"]
Valid Values: Unconstrained
Type of gravitational boundary condition
hole_bnd [INTEGER] [0]
Valid Values: Unconstrained
boundary type for hole: 0 = diode, 1 = reflect
Valid Values: Unconstrained
radius of hole cut from grid
hole_time [REAL] [0.0]
Valid Values: Unconstrained

hole_vel [REAL] [0.0]
Valid Values: Unconstrained

pistonDens [REAL] [1.0]
Valid Values: Unconstrained
density inside of custom region
pistonVelx [REAL] [0.0]
Valid Values: Unconstrained

pistonVely [REAL] [0.0]
Valid Values: Unconstrained

pistonVelz [REAL] [0.0]
Valid Values: Unconstrained

pistonXmax [REAL] [0.0]
Valid Values: Unconstrained
maximum x value of custom region
pistonXmin [REAL] [0.0]
Valid Values: Unconstrained
minimum x value of custom region
pistonYmax [REAL] [0.0]
Valid Values: Unconstrained
maximum y value of custom region
pistonYmin [REAL] [0.0]
Valid Values: Unconstrained
minimum y value of custom region
pistonZmax [REAL] [0.0]
Valid Values: Unconstrained
maximum z value of custom region
pistonZmin [REAL] [0.0]
Valid Values: Unconstrained
minimum z value of custom region
quietStartDens [REAL] [1.0]
Valid Values: Unconstrained
density inside of custom region
quietStartTemp [REAL] [1.0]
Valid Values: Unconstrained
temperature at which stuff is allowed to move
quietStartXmax [REAL] [0.0]
Valid Values: Unconstrained
maximum x value of custom region
quietStartXmin [REAL] [0.0]
Valid Values: Unconstrained
minimum x value of custom region
quietStartYmax [REAL] [0.0]
Valid Values: Unconstrained
maximum y value of custom region
quietStartYmin [REAL] [0.0]
Valid Values: Unconstrained
minimum y value of custom region
quietStartZmax [REAL] [0.0]
Valid Values: Unconstrained
maximum z value of custom region
quietStartZmin [REAL] [0.0]
Valid Values: Unconstrained
minimum z value of custom region
smalle [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for energy
smallx [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for abundances
unbiased_geometry [BOOLEAN] [FALSE]
attempt to remove floating point bias from geometry discretization. Not
implemented in FLASH3.
useHole [BOOLEAN] [false]
select whethter to excise a hole from the grid
usePiston [BOOLEAN] [false]
select whether to use a piston
useQuietStart [BOOLEAN] [false]
select whether or not to use a quiet start region
xl_boundary_type [STRING] ["periodic"]
Valid Values: Unconstrained
lower (left) boundary condition in x dir
xmax [REAL] [1.]
Valid Values: Unconstrained
physical domain upper bound in x dir
xmin [REAL] [0.]
Valid Values: Unconstrained
physical domain lower bound in x dir
xr_boundary_type [STRING] ["periodic"]
Valid Values: Unconstrained
upper (right) boundary condition in x dir
yl_boundary_type [STRING] ["periodic"]
Valid Values: Unconstrained
lower boundary condition in y dir
ymax [REAL] [1.]
Valid Values: Unconstrained
physical domain upper bound in y dir
ymin [REAL] [0.]
Valid Values: Unconstrained
physical domain lower bound in y dir
yr_boundary_type [STRING] ["periodic"]
Valid Values: Unconstrained
upper boundary condition in y dir
zl_boundary_type [STRING] ["periodic"]
Valid Values: Unconstrained
lower boundary condition in z dir
zmax [REAL] [1.]
Valid Values: Unconstrained
physical domain lower bound in x dir
zmin [REAL] [0.]
Valid Values: Unconstrained
physical domain lower bound in z dir
zr_boundary_type [STRING] ["periodic"]
Valid Values: Unconstrained
upper boundary condition in z dir

Grid/GridMain/Chombo
verbosity [INTEGER] [0]
Valid Values: 0 to INFTY

Grid/GridMain/Chombo/AMR
BRMeshRefineBlockFactor [INTEGER] [8]
Valid Values: 1 to INFTY

BRMeshRefineBufferSize [INTEGER] [1]
Valid Values: 0 to INFTY

BRMeshRefineFillRatio [REAL] [0.75]
Valid Values: 0.0 to 1.0

Whether to use quadratic coarse-fine boundary interpolation.
convertToConsvdForMeshCalls [BOOLEAN] [TRUE]
indicates if appropriate variables are converted from primitive to
conserved form during propagation before control is passed to Chombo for
refinement, derefinement, or guardcell filling.
convertToConsvdInMeshInterp [BOOLEAN] [FALSE]
indicates if appropriate variables are converted to conserved form
during propagation within the interpolation routines invoked by Chombo.
This applies to interpolation (both "prolongation" and "restriction") in
the course of refinement, derefinement, or guardcell filling.  This is
not yet implemented, but needs to get implemented soon because manually
converting in several different FLASH Fortran Grid leads to the
possibility of overlooking at least one FLASH Fortran Grid subroutine.
derefine_cutoff_1 [REAL] [0.2]
Valid Values: Unconstrained
threshold value to trigger derefinement for refine_var_1
derefine_cutoff_2 [REAL] [0.2]
Valid Values: Unconstrained
threshold value to trigger derefinement for refine_var_2
derefine_cutoff_3 [REAL] [0.2]
Valid Values: Unconstrained
threshold value to trigger derefinement for refine_var_3
derefine_cutoff_4 [REAL] [0.2]
Valid Values: Unconstrained
threshold value to trigger derefinement for refine_var_4
If true, let Paramesh redistribute blocks across processors early, so
that the block distribution chosen by Paramesh will be in effect when
time evolution begins after restart. If earlyBlockDistAdjustment is
false, the block distribution enacted by the IO unit when it read a
checkpoint file will normally still be in effect when time evolution
begins after a restart. This flag is ignored if not restarting from a
checkpoint.
When enableMaskedGCFill is FALSE, Grid_fillGuardCells is forced to
always ignore optional mask arguments when present in calls. This is the
cell filling.
flux_correct [BOOLEAN] [true]
turns on or off flux correction
gr_lrefineMaxRedDoByLogR [BOOLEAN] [FALSE]
Softly force effectively a lower lrefine_max depending on distance from
gr_lrefineMaxRedDoByTime [BOOLEAN] [FALSE]
Lower the effective lrefine_max as a function of time. See runtime
parameters gr_lrefineMaxRedTRef, gr_lrefineMaxRedTimeScale, and
gr_lrefineMaxRedLogBase.
gr_lrefineMaxRedLogBase [REAL] [10.0]
Valid Values: TINY to INFTY
Logarithm base for determining when repeated reductions in effective
lrefine_max should happen. The nth reduction will happen at
t=gr_lrefineMaxRedTRef+gr_lrefineMaxRedTimeScale*gr_lrefineMaxRedLogBase**(n-1).
Valid Values: Unconstrained
factor that determines a minimum resolution (and thus maximum refinement
level) based on distance from a center. See x_refine_center,
y_refine_center, z_refine_center for the center coordinates.  This is
approximately (linearly) equivalent to requiring a minimum *angular*
resolution, within the limits set by the global lrefine_min and
lrefine_max.  Only used when gr_lrefineMaxRedDoByLogR is TRUE.
gr_lrefineMaxRedTRef [REAL] [0.0]
Valid Values: Unconstrained
reference time for time-based max level reduction. The effective
reduction of lrefine_max only kicks in for times greater than
gr_lrefineMaxRedTRef. The first time lrefine_max is effectively lowered
actually happens at t=gr_lrefineMaxRedTRef+gr_lrefineMaxRedTimeScale.
gr_lrefineMaxRedTimeScale [REAL] [1.0]
Valid Values: TINY to INFTY
the time scale for effectively lowering lrefine_max: The first reduction
takes place at t=gr_lrefineMaxRedTRef+gr_lrefineMaxRedTimeScale.
iGridSize [INTEGER] [16]
Valid Values: 1 to INFTY
Global number of interior cells in the i direction
interpol_order [INTEGER] [2]
Valid Values: 0, 1, 2
the default interpolation order when using "monotonic" interpolation
routines
jGridSize [INTEGER] [16]
Valid Values: 1 to INFTY
Global number of interior cells in the j direction
kGridSize [INTEGER] [16]
Valid Values: 1 to INFTY
Global number of interior cells in the k direction
lrefine_del [INTEGER] [0]
Valid Values: Unconstrained
Try to reduce the maximum refinement level by this number of levels on a
restart.
lrefine_max [INTEGER] [1]
Valid Values: 1 to INFTY
maximum AMR refinement level
lrefine_max_prev [INTEGER] [1]
Valid Values: Unconstrained
for now a hack
lrefine_min [INTEGER] [1]
Valid Values: 1
minimum AMR refinement level
maxBlockSize [INTEGER] [16]
Valid Values: 0 to INFTY

max_particles_per_blk [INTEGER] [100]
Valid Values: Unconstrained
integer  if the number of particles in a block exceeds this, it must
refine  when particle count is a refinement criterion
min_particles_per_blk [INTEGER] [1]
Valid Values: Unconstrained
integer  if the number of particles in a block is below this, it must
derefine when particle count is a refinement criterion
nrefs [INTEGER] [2]
Valid Values: Unconstrained
refine/derefine AMR grid every nrefs timesteps
refRatio [INTEGER] [2]
Valid Values: 0 to INFTY
The integer refinement jump between levels
refine_cutoff_1 [REAL] [0.8]
Valid Values: Unconstrained
threshold value to trigger refinement for refine_var_1
refine_cutoff_2 [REAL] [0.8]
Valid Values: Unconstrained
threshold value to trigger refinement for refine_var_2
refine_cutoff_3 [REAL] [0.8]
Valid Values: Unconstrained
threshold value to trigger refinement for refine_var_3
refine_cutoff_4 [REAL] [0.8]
Valid Values: Unconstrained
threshold value to trigger refinement for refine_var_4
refine_filter_1 [REAL] [0.01]
Valid Values: Unconstrained
prevents error calculations to determine refinement from diverging
numerically for refine_var_1
refine_filter_2 [REAL] [0.01]
Valid Values: Unconstrained
prevents error calculations to determine refinement from diverging
numerically for refine_var_1
refine_filter_3 [REAL] [0.01]
Valid Values: Unconstrained
prevents error calculations to determine refinement from diverging
numerically for refine_var_3
refine_filter_4 [REAL] [0.01]
Valid Values: Unconstrained
prevents error calculations to determine refinement from diverging
numerically for refine_var_4
refine_on_particle_count [BOOLEAN] [false]
if true, the count of particles in blocks act as a refinement criterion
refine_var_1 [STRING] ["none"]
Valid Values: Unconstrained
indicates 1st variable on which to refine
refine_var_2 [STRING] ["none"]
Valid Values: Unconstrained
indicates 2nd variable on which to refine
refine_var_3 [STRING] ["none"]
Valid Values: Unconstrained
indicates 3rd variable on which to refine
refine_var_4 [STRING] ["none"]
Valid Values: Unconstrained
indicates 4th variable on which to refine
refine_var_count [INTEGER] [4]
Valid Values: Unconstrained
count of maximum allowed variable to be used
restrictBeforeGhostExchange [BOOLEAN] [True]
Whether to restrict all data before
small [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value ... DEV: for what?
smallp [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for pressure
smallt [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for temperature
smallu [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for velocity
smlrho [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for density
Valid Values: 0 to INFTY

x_refine_center [REAL] [0.0]
Valid Values: Unconstrained
First coordinate of center for distance-based refinement patterns
y_refine_center [REAL] [0.0]
Valid Values: Unconstrained
Second coordinate of center for distance-based refinement patterns
z_refine_center [REAL] [0.0]
Valid Values: Unconstrained
Third coordinate of center for distance-based refinement patterns

Grid/GridMain/Chombo/UG
compute_grid_size [BOOLEAN] [true]
compute grid size in the case of non-fixed-block size, non fixed block
size mode means block dims are not specified at compile time
flux_correct [BOOLEAN] [false]
turns flux correction on or off in UG always false since all blocks on
same level
iGridSize [INTEGER] [1]
Valid Values: Unconstrained
Global number of interior cells in the i direction ONLY needed when
running in NON_FIXED_BLOCKSIZE mode (ie. don't need for Paramesh or
simple Uniform Grid)
iProcs [INTEGER] [1]
Valid Values: Unconstrained
number of procs in the i dir
iguard [INTEGER] [4]
Valid Values: Unconstrained
number of guardcells in i direction.  Not yet in use.
jGridSize [INTEGER] [1]
Valid Values: Unconstrained
Global number of interior cells in the j direction ONLY needed when
running in NON_FIXED_BLOCKSIZE mode (ie. don't need for Paramesh or
simple Uniform Grid)
jProcs [INTEGER] [1]
Valid Values: Unconstrained
number of procs in the j dir
jguard [INTEGER] [4]
Valid Values: Unconstrained
number of guardcells in j direction, this is only implemented for nfbs
kGridSize [INTEGER] [1]
Valid Values: Unconstrained
Global number of interior cells in the k direction ONLY needed when
running in NON_FIXED_BLOCKSIZE mode (ie. don't need for Paramesh or
simple Uniform Grid)
kProcs [INTEGER] [1]
Valid Values: Unconstrained
number of procs in the k dir
kguard [INTEGER] [4]
Valid Values: Unconstrained
number of guardcells in k direction
nblockx [INTEGER] [1]
Valid Values: Unconstrained
number of blocks along X - ignored by UG Grid
nblocky [INTEGER] [1]
Valid Values: Unconstrained
number of blocks along Y - ignored by UG Grid
nblockz [INTEGER] [1]
Valid Values: Unconstrained
number of blocks along Z - ignored by UG Grid
smallp [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for pressure
smallt [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for temperature
smallu [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for velocity
smlrho [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for density

Grid/GridMain/UG
compute_grid_size [BOOLEAN] [true]
compute grid size in the case of non-fixed-block size, non fixed block
size mode means block dims are not specified at compile time
flux_correct [BOOLEAN] [false]
turns flux correction on or off in UG always false since all blocks on
same level
iGridSize [INTEGER] [1]
Valid Values: Unconstrained
Global number of interior cells in the i direction ONLY needed when
running in NON_FIXED_BLOCKSIZE mode (ie. don't need for Paramesh or
simple Uniform Grid)
iguard [INTEGER] [6]
Valid Values: Unconstrained
number of guardcells in i direction, not yet used. Meant for nofbs.
jGridSize [INTEGER] [1]
Valid Values: Unconstrained
Global number of interior cells in the j direction ONLY needed when
running in NON_FIXED_BLOCKSIZE mode (ie. don't need for Paramesh or
simple Uniform Grid)
jguard [INTEGER] [6]
Valid Values: Unconstrained
number of guardcells in j direction, not yet used. Meant for nofbs.
kGridSize [INTEGER] [1]
Valid Values: Unconstrained
Global number of interior cells in the k direction ONLY needed when
running in NON_FIXED_BLOCKSIZE mode (ie. don't need for Paramesh or
simple Uniform Grid)
kguard [INTEGER] [6]
Valid Values: Unconstrained
number of guardcells in k direction, not yet used. Meant for nofbs.
nblockx [INTEGER] [1]
Valid Values: Unconstrained
number of blocks along X - ignored by UG Grid
nblocky [INTEGER] [1]
Valid Values: Unconstrained
number of blocks along Y - ignored by UG Grid
nblockz [INTEGER] [1]
Valid Values: Unconstrained
number of blocks along Z - ignored by UG Grid
smallp [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for pressure
smallt [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for temperature
smallu [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for velocity
smlrho [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for density

Grid/GridMain/paramesh
convertToConsvdInMeshInterp [BOOLEAN] [TRUE]
indicates if appropriate variables are converted to conserved form
during propagation within the interpolation routines invoked by
Paramesh. This applies to interpolation (both "prolongation" and
"restriction") in the course of refinement, derefinement, or guardcell
filling. This is the newer way of ensuring that solution variables are
interpolated in the correct form. It avoids unnecessary conversions back
and force and should replace the old mechanism enabled by runtime
parameter "convertToConsvdForMeshCalls". However, it is only available
with PARAMESH 3 or later.
derefine_cutoff_1 [REAL] [0.2]
Valid Values: Unconstrained
threshold value to trigger derefinement for refine_var_1
derefine_cutoff_2 [REAL] [0.2]
Valid Values: Unconstrained
threshold value to trigger derefinement for refine_var_2
derefine_cutoff_3 [REAL] [0.2]
Valid Values: Unconstrained
threshold value to trigger derefinement for refine_var_3
derefine_cutoff_4 [REAL] [0.2]
Valid Values: Unconstrained
threshold value to trigger derefinement for refine_var_4
If true, let Paramesh redistribute blocks across processors early, so
that the block distribution chosen by Paramesh will be in effect when
time evolution begins after restart. If earlyBlockDistAdjustment is
false, the block distribution enacted by the IO unit when it read a
checkpoint file will normally still be in effect when time evolution
begins after a restart. This flag is ignored if not restarting from a
checkpoint.
flux_correct [BOOLEAN] [true]
turns on or off flux correction
gr_lrefineMaxRedDoByLogR [BOOLEAN] [FALSE]
Softly force effectively a lower lrefine_max depending on distance from
gr_lrefineMaxRedDoByTime [BOOLEAN] [FALSE]
Lower the effective lrefine_max as a function of time. See runtime
parameters gr_lrefineMaxRedTRef, gr_lrefineMaxRedTimeScale, and
gr_lrefineMaxRedLogBase.
gr_lrefineMaxRedLogBase [REAL] [10.0]
Valid Values: 1.0 to INFTY
Logarithm base for determining when repeated reductions in effective
lrefine_max should happen. The nth reduction will happen at
t=gr_lrefineMaxRedTRef+gr_lrefineMaxRedTimeScale*gr_lrefineMaxRedLogBase**(n-1).
Valid Values: 0.0 to INFTY
factor that determines a minimum resolution (and thus maximum refinement
level) based on distance from a center. See x_refine_center,
y_refine_center, z_refine_center for the center coordinates.  This is
approximately (linearly) equivalent to requiring a minimum *angular*
resolution, within the limits set by the global lrefine_min and
lrefine_max.  Only used when gr_lrefineMaxRedDoByLogR is TRUE.
gr_lrefineMaxRedTRef [REAL] [0.0]
Valid Values: Unconstrained
reference time for time-based max level reduction. The effective
reduction of lrefine_max only kicks in for times greater than
gr_lrefineMaxRedTRef. The first time lrefine_max is effectively lowered
actually happens at t=gr_lrefineMaxRedTRef+gr_lrefineMaxRedTimeScale.
gr_lrefineMaxRedTimeScale [REAL] [1.0]
Valid Values: TINY to INFTY
the time scale for effectively lowering lrefine_max: The first reduction
takes place at t=gr_lrefineMaxRedTRef+gr_lrefineMaxRedTimeScale.
gr_restrictAllMethod [INTEGER] [3]
Valid Values: 0 to 3
select a method to use for data restriction all the way up the tree of
blocks.  This this global data restriction is usually done when
IO_output is called, before the actual writing of plot or checkpoint
data, so that non-leaf blocks in plot and checkpoint files will have
meaningful data. Data restrictions that happen as part of guard cell
filling or within multigrid solvers are not affected by this setting.
For PARAMESH 2, this runtime parameter is currently ignored. With
PARAMESH 4, the following values are recognized:  0: No restriction is
done. 1: The original method, implemented in gr_restrictTree. 2: New
method, implemented using mpi_amr_restrict_fulltree. 3: New method,
implemented using Grid_restrictByLevels.
interpol_order [INTEGER] [2]
Valid Values: 0, 1, 2
the default interpolation order when using "monotonic" interpolation
routines
lrefine_del [INTEGER] [0]
Valid Values: Unconstrained
Try to reduce the maximum refinement level by this number of levels on a
restart.
lrefine_max [INTEGER] [1]
Valid Values: Unconstrained
maximum AMR refinement level
lrefine_max_prev [INTEGER] [1]
Valid Values: Unconstrained
for now a hack
lrefine_min [INTEGER] [1]
Valid Values: Unconstrained
minimum AMR refinement level
lrefine_min_init [INTEGER] [1]
Valid Values: 1 to INFTY
minimum AMR refinement level for initialization
max_particles_per_blk [INTEGER] [100]
Valid Values: Unconstrained
integer  if the number of particles in a block exceeds this, it must
refine  when particle count is a refinement criterion
min_particles_per_blk [INTEGER] [1]
Valid Values: Unconstrained
integer  if the number of particles in a block is below this, it must
derefine when particle count is a refinement criterion
nblockx [INTEGER] [1]
Valid Values: Unconstrained
num initial blocks in x dir
nblocky [INTEGER] [1]
Valid Values: Unconstrained
num initial blocks in y dir
nblockz [INTEGER] [1]
Valid Values: Unconstrained
num initial blocks in z dir
nrefs [INTEGER] [2]
Valid Values: Unconstrained
refine/derefine AMR grid every nrefs timesteps
refine_cutoff_1 [REAL] [0.8]
Valid Values: Unconstrained
threshold value to trigger refinement for refine_var_1
refine_cutoff_2 [REAL] [0.8]
Valid Values: Unconstrained
threshold value to trigger refinement for refine_var_2
refine_cutoff_3 [REAL] [0.8]
Valid Values: Unconstrained
threshold value to trigger refinement for refine_var_3
refine_cutoff_4 [REAL] [0.8]
Valid Values: Unconstrained
threshold value to trigger refinement for refine_var_4
refine_filter_1 [REAL] [0.01]
Valid Values: Unconstrained
prevents error calculations to determine refinement from diverging
numerically for refine_var_1
refine_filter_2 [REAL] [0.01]
Valid Values: Unconstrained
prevents error calculations to determine refinement from diverging
numerically for refine_var_1
refine_filter_3 [REAL] [0.01]
Valid Values: Unconstrained
prevents error calculations to determine refinement from diverging
numerically for refine_var_3
refine_filter_4 [REAL] [0.01]
Valid Values: Unconstrained
prevents error calculations to determine refinement from diverging
numerically for refine_var_4
refine_on_particle_count [BOOLEAN] [false]
if true, the count of particles in blocks act as a refinement criterion
refine_var_1 [STRING] ["none"]
Valid Values: Unconstrained
indicates 1st variable on which to refine
refine_var_2 [STRING] ["none"]
Valid Values: Unconstrained
indicates 2nd variable on which to refine
refine_var_3 [STRING] ["none"]
Valid Values: Unconstrained
indicates 3rd variable on which to refine
refine_var_4 [STRING] ["none"]
Valid Values: Unconstrained
indicates 4th variable on which to refine
refine_var_count [INTEGER] [4]
Valid Values: Unconstrained
count of maximum allowed variable to be used
small [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value ... DEV: for what?
smallp [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for pressure
smallt [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for temperature
smallu [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for velocity
smlrho [REAL] [1.E-10]
Valid Values: Unconstrained
Cutoff value for density
x_refine_center [REAL] [0.0]
Valid Values: Unconstrained
First coordinate of center for distance-based refinement patterns
y_refine_center [REAL] [0.0]
Valid Values: Unconstrained
Second coordinate of center for distance-based refinement patterns
z_refine_center [REAL] [0.0]
Valid Values: Unconstrained
Third coordinate of center for distance-based refinement patterns

Grid/GridMain/paramesh/Paramesh2
msgbuf [INTEGER] [1]
Valid Values: Unconstrained
triggers consolication of MPI messages in PM2. 1 indicates to
"consolidate". PM2 specific, should always stay at 1

grid_monotone_hack [BOOLEAN] [TRUE]
If .true., apply radical monotonicity constraints to interpolants (i.e.,
completely flatten them if they violate monotonicity)

Grid/GridMain/paramesh/paramesh4
When enableMaskedGCFill is FALSE, Grid_fillGuardCells is forced to
always ignore optional mask arguments when present in calls. This is the
cell filling.

Grid/GridMain/paramesh/paramesh4/Paramesh4dev/flash_avoid_orrery
use_flash_surr_blks_fill [BOOLEAN] [TRUE]

Grid/GridParticles
gr_ptNumToReduce [INTEGER] [10]
Valid Values: Unconstrained
integer  if particles are to be removed at runtime, how many
gr_ptRemove [BOOLEAN] [FALSE]
boolean.  This is a switch which determines the action if the number
gr_ptRemoveAlgo [INTEGER] [2]
Valid Values: Unconstrained
integer  The algorithm used in determining which particles to remove

Grid/GridParticles/GridParticlesMove
gr_ptMaxPerProcBlockFactor [REAL] [0.70]
Valid Values: 0.0 to 1.0
When the effective max_particles_per_blk is lowered on a processor
because refinement criteria based on the number of particles PER
PROCESSOR are used, then the new effective max_particles_per_blk is set
to (gr_ptMaxPerProcBlockFactor * pt_maxPerProc). In addition, when the
effective min_particles_per_blk is lowered on a processor because
refinement criteria based on the number of particles PER PROCESSOR are
used, then the new effective min_particles_per_blk is set to (0.5^NDIM *
gr_ptMaxPerProcBlockFactor * pt_maxPerProc).
gr_ptMaxPerProcBlockNoFuzz [INTEGER] [3]
Valid Values: 0 to INFTY
A safety margin for estimating the size of basically unpredictable
changes of the number of blocks on a processor when remeshing happens.
gr_ptMaxPerProcLowerThresh [REAL] [0.0625]
Valid Values: 0.0 to 1.0
A threshold. When the number of particles on a processor gets above
(ptMaxPerProcLowerThresh * number of blocks on the processor), the
effective min_particles_per_blk for blocks on this processor may be
lowered.
gr_ptMaxPerProcUpperThresh [REAL] [0.25]
Valid Values: 0.0 to 1.0
A threshold. When the number of particles on a processor gets above
(ptMaxPerProcUpperThresh * number of blocks on the processor), the
effective max_particles_per_blk for blocks on this processor may be
lowered.
gr_ptNumToReduce [INTEGER] [10]
Valid Values: Unconstrained
integer  if particles are to be removed at runtime, how many
gr_ptRefineOnPtMaxPerProc [BOOLEAN] [FALSE]
controls whether refinement criteria based on the number of particles
PER PROCESSOR are used. These work by strengthening refinement criteria
requested through the max_particles_per_blk and min_particles_per_blk
RPs.  Requires RP refine_on_particle_count to be TRUE.
gr_ptRemove [BOOLEAN] [FALSE]
boolean.  This is a switch which determines the action if the number
gr_ptRemoveAlgo [INTEGER] [2]
Valid Values: Unconstrained
integer  The algorithm used in determining which particles to remove
gr_ptSieveCheckFreq [INTEGER] [1]
Valid Values: Unconstrained
integer the frequency for checking the convergence of the

Grid/GridSolvers/HYPRE
gr_hypreFloor [REAL] [1.0e-12]
Valid Values: Unconstrained
floor value for using HYPRE to advance diffusion.
gr_hypreInfoLevel [INTEGER] [1]
Valid Values: Unconstrained
: Flag to output solver specific information such as Relative Residue,
num-iterations.
gr_hypreMaxIter [INTEGER] [10000]
Valid Values: Unconstrained
Max iterations of linear solver.
gr_hyprePCType [STRING] ["HYPRE_AMG"]
Valid Values: "HYPRE_NONE", "HYPRE_ILU", "HYPRE_AMG", "HYPRE_PARASAILS",
"hypre_ilu", "hypre_amg", "hypre_parasails", "hypre_none"

gr_hyprePrintSolveInfo [BOOLEAN] [FALSE]
: Flag to output solver specific information such as Relative Residue,
num-iterations.
gr_hypreRelTol [REAL] [1.0e-8]
Valid Values: Unconstrained
Relative tolerence of linear solver.
gr_hypreSolverType [STRING] ["HYPRE_PCG"]
Valid Values: "HYPRE_PCG", "HYPRE_AMG", "HYPRE_GMRES", "HYPRE_BICGSTAB",
"HYPRE_SPLIT", "hypre_pcg", "hypre_amg", "hypre_gmres",
"hypre_bicgstab", "hypre_split"
: Type of HYPRE solver to be used.
gr_hypreUseFloor [BOOLEAN] [TRUE]
whether to apply gr_hypreFloor to floor results from HYPRE. Should
probably be TRUE when using HYPRE to advance diffusion, FALSE otherwise.
However, flooring will always be turned off when using the HYPRE
implementation of Grid_solvePoisson, independent of the value of the
gr_hypreUseFloor runtime parameter.

Grid/GridSolvers/IsoBndMultipole
mpole_lmax [INTEGER] [0]
Valid Values: Unconstrained
Maximum multipole moment to use
octant [BOOLEAN] [false]
In 3d cartesian geometry, assume symmetry about left-facing volume faces
In 2d cylindrical coords, assume symmetry about grid bottom to evolve a

Grid/GridSolvers/Multigrid
mg_maxCorrections [INTEGER] [100]
Valid Values: Unconstrained
Maximum number of correction V-cycles to employ.
mg_maxResidualNorm [REAL] [1.E-6]
Valid Values: Unconstrained
Apply V-cycle corrections until this residual norm is reached or
mg_maxCorrections V-cycles have been performed.
mg_printNorm [BOOLEAN] [TRUE]
If .true., print the ratio of the residual norm to the source norm as
each V-cycle is completed.
True if only one quadrant is being calculated in 2-d cylindrical
coordinates

Grid/GridSolvers/Multigrid/PfftTopLevelSolve
maxDirectSolveLevel [INTEGER] [9999]
Valid Values: 1 to 9999

xl_mg_boundary_type [STRING] ["periodic"]
Valid Values: Unconstrained
lower (left) boundary condition in x dir
xr_mg_boundary_type [STRING] ["periodic"]
Valid Values: Unconstrained
upper (right) boundary condition in x dir
yl_mg_boundary_type [STRING] ["periodic"]
Valid Values: Unconstrained
lower boundary condition in y dir
yr_mg_boundary_type [STRING] ["periodic"]
Valid Values: Unconstrained
upper boundary condition in y dir
zl_mg_boundary_type [STRING] ["periodic"]
Valid Values: Unconstrained
lower boundary condition in z dir
zr_mg_boundary_type [STRING] ["periodic"]
Valid Values: Unconstrained
upper boundary condition in z dir

Grid/GridSolvers/Multipole
mpole_3daxisymmetric [BOOLEAN] [false]
In 3d cartesian geometry, use only m=0 multipole moments
mpole_dumpMoments [BOOLEAN] [false]
Should the Moment array be dumped at each timestep?
mpole_lmax [INTEGER] [0]
Valid Values: Unconstrained
Maximum multipole moment to use
mpole_r12 [REAL] [0.0]
Valid Values: Unconstrained

mpole_r23 [REAL] [1.0]
Valid Values: Unconstrained

mpole_rscale1 [REAL] [1.0]
Valid Values: Unconstrained

mpole_rscale2 [REAL] [1.0]
Valid Values: Unconstrained

mpole_rscale3 [REAL] [1.0]
Valid Values: Unconstrained

mpole_scaleType1 [INTEGER] [1]
Valid Values: Unconstrained

mpole_scaleType2 [INTEGER] [1]
Valid Values: Unconstrained

mpole_scaleType3 [INTEGER] [1]
Valid Values: Unconstrained

mpole_subSample [INTEGER] [1]
Valid Values: 1 to 12
Integer which controls the sub-sampling in the mpole_potential routine
and mpole_moments routine.  Set to smaller numbers to make potential
calculations (slightly) less smooth and faster. Was hardcoded in Flash2
as Nint6 = 6 in mpole_potential and Nint=2 in mpole_moments Defines the
3 zones (r12,r23 are fractions of rMax) Scaling factor for each zones.
Scaling Type for each of the regions, can be Constant,  Logarthmic
mpole_useMatrixMPI [BOOLEAN] [false]
Switch added during the DAT to calculate MPI_allreduce in a matrix
fashion & Set to .false. to retain the previous behaviour
octant [BOOLEAN] [false]
In 3d cartesian geometry, assume symmetry about left-facing volume faces
In 2d cylindrical coords, assume symmetry about grid bottom to evolve a

Grid/GridSolvers/Multipole_new
mpole_2DSymmetryPlane [BOOLEAN] [false]
In 2D coordinates, assume a plane of symmetry at the grid bottom. Can be
used for symmetrical problems to reduce computational domain.
mpole_3DAxisymmetry [BOOLEAN] [false]
Assumes rotational invariance around the main (z) axis in 3D cartesian
geometry domains, even if this holds only approximately. In effect it
uses only M=0 multipole moments.
mpole_DumpMoments [BOOLEAN] [false]
Should the Moment array be dumped at each timestep? Use this option only
with care, as the moments will be printed for each radial bin.
mpole_IgnoreInnerZone [BOOLEAN] [false]
If this is set .true., the inner zone will not be recognized and all
inner zone radii will be treated statistically. This can be used only if
Lmax is sufficiently low.
mpole_InnerZoneResolution [REAL] [0.1]
Valid Values: 0.0 to INFTY
The resolution spacing for the inner zone in units of the inner zone
atomic radius. Two inner zone radii will be considered different if they
are more than the resolution spacing apart. A very tiny number will
result in a complete separation of all inner zone radii into separate
bins. However, the resolution cannot be set to exactly zero, because its
inverse value needs to be calculated at some point in the code.
mpole_InnerZoneSize [INTEGER] [16]
Valid Values: 1 to INFTY
The size (radius) defining the inner zone in terms of the inner zone
atomic radius. This value needs to be an integer, as it will be used to
define dimensions of certain arrays.
mpole_Lmax [INTEGER] [0]
Valid Values: 0 to INFTY
Maximum multipole moment to use
Valid Values: 1 to INFTY
The maximum number of radial zones to be used
Should the Multipole solver print out detailed radial bin information at
each timestep?
mpole_ZoneExponent_1 [REAL] [1.0]
Valid Values: -INFTY to INFTY
The exponent value 't' in the radial equation r(Q) = s * dr * Q^t or the
radial equation r(Q) = s * dr * (e^(Qt)-1)/(e^t-1), defining the maximum
mpole_ZoneExponent_2 [REAL] [1.0]
Valid Values: -INFTY to INFTY
Idem for the 2nd radial zone.
mpole_ZoneExponent_3 [REAL] [1.0]
Valid Values: -INFTY to INFTY
Idem for the 3rd radial zone.
mpole_ZoneExponent_4 [REAL] [1.0]
Valid Values: -INFTY to INFTY
Idem for the 4th radial zone.
Valid Values: 0.0 to 1.0
The fraction of the maximum radius defining the 1st radial zone limit.
The total number of fractions given must match the maximum number of
radial zones specified and the fractions must be in increasing order and
less than 1. as we move from the 1st zone upwards. The last zone must
always have a fraction of exactly 1. If not, the code will enforce it.
Valid Values: 0.0 to 1.0
Idem for the 2nd radial zone.
Valid Values: 0.0 to 1.0
Idem for the 3rd radial zone.
Valid Values: 0.0 to 1.0
Idem for the 4th radial zone.
mpole_ZoneScalar_1 [REAL] [1.0]
Valid Values: 0.0 to INFTY
The scalar value 's' in the radial equation r(Q) = s * dr * Q^t or the
radial equation r(Q) = s * dr * (e^(Qt)-1)/(e^t-1), defining the maximum
mpole_ZoneScalar_2 [REAL] [1.0]
Valid Values: 0.0 to INFTY
Idem for the 2nd radial zone.
mpole_ZoneScalar_3 [REAL] [1.0]
Valid Values: 0.0 to INFTY
Idem for the 3rd radial zone.
mpole_ZoneScalar_4 [REAL] [1.0]
Valid Values: 0.0 to INFTY
Idem for the 4th radial zone.
mpole_ZoneType_1 [STRING] ["exponential"]
Valid Values: Unconstrained
String value containing the zone type for the 1st zone. If set to
'exponential' then the radial equation r(Q) = s * dr * Q^t is used. If
set to 'logarithmic' the radial equation r(Q) = s * dr *
(e^(Qt)-1)/(e^t-1) is used.
mpole_ZoneType_2 [STRING] ["exponential"]
Valid Values: Unconstrained
Idem for the 2nd radial zone.
mpole_ZoneType_3 [STRING] ["exponential"]
Valid Values: Unconstrained
Idem for the 3rd radial zone.
mpole_ZoneType_4 [STRING] ["logarithmic"]
Valid Values: Unconstrained
Idem for the 4th radial zone.