Runtime Parameters: Timestep  hyschive/gamerfork GitHub Wiki
This page describes various timestep constraints. See also Sections 2.1 and 2.6 in the GAMER2 code paper.
Related options: none
Parameters described on this page: DT__MAX, DT__FLUID, DT__FLUID_INIT, DT__SPEED_OF_LIGHT, DT__GRAVITY, DT__PARVEL, DT__PARVEL_MAX, DT__PARACC, DT__CR_DIFFUSION, DT__MAX_DELTA_A, DT__SYNC_PARENT_LV, DT__SYNC_CHILDREN_LV, OPT__DT_USER, OPT__DT_LEVEL, OPT__RECORD_DT, AUTO_REDUCE_DT, AUTO_REDUCE_DT_FACTOR, AUTO_REDUCE_DT_FACTOR_MIN, AUTO_REDUCE_MINMOD_FACTOR, AUTO_REDUCE_MINMOD_MIN, AUTO_REDUCE_INT_MONO_FACTOR, AUTO_REDUCE_INT_MONO_MIN
Other related parameters: [[]]
Parameters below are shown in the format: β Name
β (Valid Values) β [Default Value]

 Description: Maximum allowed timestep on all levels. This can be used to, for example, avoid too large timesteps on lower levels.
 Restriction:

 Description: CourantβFriedrichsβLewy (CFL) safety factor for the hydrodynamic solver. The default value and stable regime depend on the adopted fluid scheme. See Section 2.6, Eqs. [12] in the GAMER2 code paper for the exact formulae.
 Restriction:

DT__FLUID_INIT
β (β₯0.0; <0.0 β set to default) β [DT__FLUID] Description: CFL safety factor for the hydrodynamic solver at the first step. This could be useful when the first step requires a much smaller timestep.
 Restriction: Useless for restart.

 Description: Using the speed of light as the maximum information propagation speed for determining timesteps in special relativistic hydrodynamic simulations.
 Restriction: Only applicable when adopting the compilation option SRHD.

 Description: Safety factor when determining timestep from the gravitational acceleration of fluid. See Section 2.6, Eq. [3] in the GAMER2 code paper for the exact formula.
 Restriction:

 Description: Safety factor when determining timestep from the particle velocity. See Section 2.6, Eq. [4] in the GAMER2 code paper for the exact formula.
 Restriction:

 Description: Maximum allowed value of the timestep determined from the particle velocity. This could be useful when, for example, all particles are initially at rest, for which the timestep determined from the particle velocity is infinity.
 Restriction:

 Description: Safety factor when determining timestep from the particle acceleration. See Section 2.6, Eq. [3] in the GAMER2 code paper for the exact formula.
 Restriction: Only applicable when adopting the compilation option STORE_PAR_ACC.

 Description: CFL safety factor for cosmicray diffusion.
 Restriction: Only applicable when adopting the compilation option CR_DIFFUSION.


Description:
Maximum allowed fraction of increase in the cosmic scale factor a.
Specifically, it enforces Ξa β€
DT__MAX_DELTA_A
β a.  Restriction: Only applicable when adopting the compilation option COMOVING.

Description:
Maximum allowed fraction of increase in the cosmic scale factor a.
Specifically, it enforces Ξa β€


Description:
Allow timestep to increase by
1.0+DT__SYNC_PARENT
to help synchronize with the parent level. See also Section 2.1 in the GAMER2 code paper for more details  Restriction: For OPT__DT_LEVEL=3 only.

Description:
Allow timestep to increase by


Description:
Allow timestep to decrease by
1.0+DT__SYNC_CHILDREN_LV
to help synchronize with the children level. See also Section 2.1 in the GAMER2 code paper for more details  Restriction: For OPT__DT_LEVEL=3 only.

Description:
Allow timestep to decrease by


Description:
Enable a userdefined timestep criterion. Edit
src/Miscellaneous/Mis_GetTimeStep_User.cpp
or a problemspecific function (for the latter, see Add Problem Specific Functionalities).  Restriction:

Description:
Enable a userdefined timestep criterion. Edit


Description:
Constraints on the timesteps of adjacent levels.

1
: All levels must share the same timestep 
2
: Timesteps of a parent level is fixed to be twice smaller than its parent level 
3
: No constraint (except that the timestep of a children level cannot be larger than that of a parent level)

 Restriction:

Description:
Constraints on the timesteps of adjacent levels.

 Description: Record the timesteps set by various constraints in the file Record__TimeStep.
 Restriction:

 Description: Automatically reduce timestep by a factor of AUTO_REDUCE_DT_FACTOR, MINMOD_COEFF by a factor of AUTO_REDUCE_MINMOD_FACTOR, and INT_MONO_COEFF by a factor of AUTO_REDUCE_INT_MONO_FACTOR when the program fails until the timestep reducing factor becomes smaller than AUTO_REDUCE_DT_FACTOR_MIN or the interpolation coefficients become smaller than AUTO_REDUCE_MINMOD_MIN or AUTO_REDUCE_INT_MONO_MIN.
 Restriction: For OPT__DT_LEVEL=3 only.

 Description: See AUTO_REDUCE_DT.
 Restriction:

 Description: See AUTO_REDUCE_DT.
 Restriction:

 Description: See AUTO_REDUCE_DT.
 Restriction: Must enable AUTO_REDUCE_DT.

 Description: See AUTO_REDUCE_DT.
 Restriction: Must enable AUTO_REDUCE_DT.

 Description: See AUTO_REDUCE_DT.
 Restriction: Must enable AUTO_REDUCE_DT.

 Description: See AUTO_REDUCE_DT.
 Restriction: Must enable AUTO_REDUCE_DT.