Runtime Parameters: Miscellaneous - hyschive/gamer-fork GitHub Wiki

Parameters described on this page: OPT__VERBOSE,   OPT__TIMING_BARRIER,   OPT__TIMING_BALANCE,   OPT__TIMING_MPI,   OPT__RECORD_NOTE,   OPT__RECORD_UNPHY,   OPT__RECORD_MEMORY,   OPT__RECORD_PERFORMANCE,   OPT__MANUAL_CONTROL,   OPT__RECORD_CENTER,   COM_CEN_X,   COM_CEN_Y,   COM_CEN_Z,   COM_MAX_R,   COM_MIN_RHO,   COM_TOLERR_R,   COM_MAX_ITER,   OPT__RECORD_USER,   OPT__OPTIMIZE_AGGRESSIVE,   OPT__SORT_PATCH_BY_LBIDX,   OPT__CK_REFINE,   OPT__CK_PROPER_NESTING,   OPT__CK_CONSERVATION,   OPT__CK_NORMALIZE_PASSIVE,   OPT__CK_RESTRICT,   OPT__CK_FINITE,   OPT__CK_PATCH_ALLOCATE,   OPT__CK_FLUX_ALLOCATE,   OPT__CK_NEGATIVE,   OPT__CK_MEMFREE,   OPT__CK_PARTICLE,   OPT__CK_INTERFACE_B,   OPT__CK_DIVERGENCE_B,   OPT__CK_INPUT_FLUID  

Parameters below are shown in the format:   Name   (Valid Values)   [Default Value]

• OPT__VERBOSE   (0=off, 1=on)   [0]

  • Description: Show details of the simulation progress.
  • Restriction:

• OPT__TIMING_BARRIER   (0=off, 1=on; <0 → set to default)   [-1]

  • Description: Synchronize all MPI processes (by invoking MPI_Barrier()) before timing. It will lead to more accurate timing results but may also deteriorate the performance.
  • Restriction: Only applicable when enabling the compilation option --timing.

• OPT__TIMING_BALANCE   (0=off, 1=on)   [0]

  • Description: Record the maximum and minimum times consumed by various major routines among all MPI processes to check load balancing. The results will be recorded in the file Record__Timing.
  • Restriction: Only applicable when enabling the compilation option --timing.

• OPT__TIMING_MPI   (0=off, 1=on)   [0]

  • Description: Record the MPI bandwidth achieved by various MPI calls in the file Record__TimingMPI_Rank*.
  • Restriction: Only applicable when enabling both the compilation options --timing and --mpi.

• OPT__RECORD_NOTE   (0=off, 1=on)   [1]

  • Description: Record the general simulation information, such as compilation options and runtime parameters, in the file Record__Note.
  • Restriction:

• OPT__RECORD_UNPHY   (0=off, 1=on)   [1]

  • Description: Record the number of cells with unphysical results being corrected in the file Record__NCorrUnphy.
  • Restriction:

• OPT__RECORD_MEMORY   (0=off, 1=on)   [1]

  • Description: Record the total memory consumption of each MPI process in the file Record__MemInfo.
  • Restriction:

• OPT__RECORD_PERFORMANCE   (0=off, 1=on)   [1]

  • Description: Record the code performance in the file Record__Performance.
  • Restriction: Only applicable when enabling the compilation option --timing.

• OPT__MANUAL_CONTROL   (0=off, 1=on)   [1]

  • Description: Support enforcing data dump and/or terminating simulations during the runtime. See Enforcing Outputs and Terminating Simulations for details.
  • Restriction:

• OPT__RECORD_CENTER   (0=off, 1=on)   [0]

  • Description: Record the position of maximum density, minimum potential, and center of mass in the file Record__Center.
  • Restriction:

• COM_CEN_X   (within the simulation domain; if one of COM_CEN_X/Y/Z < 0.0 -> peak density position x)   [-1.0]

  • Description: x coordinate as an initial guess for determining the center of mass for OPT__RECORD_CENTER.
  • Restriction:

• COM_CEN_Y   (within the simulation domain; if one of COM_CEN_X/Y/Z < 0.0 -> peak density position y)   [-1.0]

  • Description: y coordinate as an initial guess for determining the center of mass for OPT__RECORD_CENTER.
  • Restriction:

• COM_CEN_Z   (within the simulation domain; if one of COM_CEN_X/Y/Z < 0.0 -> peak density position z)   [-1.0]

  • Description: z coordinate as an initial guess for determining the center of mass for OPT__RECORD_CENTER.
  • Restriction:

• COM_MAX_R   (>0.0; <0.0 → __FLT_MAX__)   [-1.0]

  • Description: Maximum radius for determining the center of mass for OPT__RECORD_CENTER.
  • Restriction:

• COM_MIN_RHO   (≥0.0)   [-1.0]

  • Description: Minimum density for determining the center of mass for OPT__RECORD_CENTER.
  • Restriction:

• COM_TOLERR_R   (>0.0; <0.0 → maximum spatial resolution)   [-1.0]

  • Description: Maximum tolerated error of deviation in distance during the iterations of determining the center of mass for OPT__RECORD_CENTER.
  • Restriction:

• COM_MAX_ITER   (≥1)   [10]

  • Description: Maximum number of iterations for determining the center of mass for OPT__RECORD_CENTER.
  • Restriction:

• OPT__RECORD_USER   (0=off, 1=on)   [0]

  • Description: Perform user-specified simulation diagnostics. See Problem Specific Diagnostics for details.
  • Restriction:

• OPT__OPTIMIZE_AGGRESSIVE   (0=off, 1=on)   [0]

  • Description: Apply aggressive performance optimizations. This option is experimental.
  • Restriction:

• OPT__SORT_PATCH_BY_LBIDX   (0=off, 1=on)   [1]

  • Description: Sort patches by their load-balance indices before dumping data and during restart to improve bitwise reproducibility, especially when restarting with the same number of MPI processes.
  • Restriction: Not supported by --mpi=false.

• OPT__CK_REFINE   (0=off, 1=on)   [0]

  • Description: Check the grid refinement (deprecated).
  • Restriction: Only work with the refinement option OPT__FLAG_RHO.

• OPT__CK_PROPER_NESTING   (0=off, 1=on)   [0]

  • Description: Check the proper-nesting condition.
  • Restriction:

• OPT__CK_CONSERVATION   (0=off, 1=on)   [0]

  • Description: Check the conservation laws. The results will be recorded in the file Record__Conservation.
  • Restriction:

• OPT__CK_NORMALIZE_PASSIVE   (0=off, 1=on)   [0]

  • Description: Check the normalization of passive scalars. Make sure to turn on OPT__NORMALIZE_PASSIVE. Otherwise this check will likely fail.
  • Restriction:

• OPT__CK_RESTRICT   (0=off, 1=on)   [0]

  • Description: Check the data restriction (i.e., the averages of fine-grid data equal the coarse-grid data). Make sure to turn on both OPT__FIXUP_RESTRICT and OPT__INIT_RESTRICT. Otherwise this check will likely fail.
  • Restriction:

• OPT__CK_FINITE   (0=off, 1=on)   [0]

  • Description: Check if all variables are finite (i.e., not "NaN" or "Infinite").
  • Restriction:

• OPT__CK_PATCH_ALLOCATE   (0=off, 1=on)   [0]

  • Description: Check if all patches are properly allocated. This is used mainly for debugging purposes.
  • Restriction:

• OPT__CK_FLUX_ALLOCATE   (0=off, 1=on)   [0]

  • Description: Check if all flux arrays are properly allocated. This is used mainly for debugging purposes.
  • Restriction:

• OPT__CK_NEGATIVE   (0=off, 1=mass density, 2=pressure and entropy, 3=both)   [0]

  • Description: Check if any of the target variables becomes negative.
  • Restriction:

• OPT__CK_MEMFREE   (0=off, >0.0 → threshold in GB)   [1.0]

  • Description: Check the free memory. The program will be terminated automatically if the available memory becomes smaller than a given threshold.
  • Restriction:

• OPT__CK_PARTICLE   (0=off, 1=on)   [0]

  • Description: Check the particle allocation. This is used mainly for debugging purposes.
  • Restriction:

• OPT__CK_INTERFACE_B   (0=off, 1=on)   [0]

  • Description: Check the consistency of the magnetic field on the patch interfaces. This is used mainly for debugging purposes.
  • Restriction: For --mhd only.

• OPT__CK_DIVERGENCE_B   (0=off, 1=on)   [0]

  • Description: Check the divergence-free constraint on the magnetic field. This is used mainly for debugging purposes.
  • Restriction: For --mhd only.

• OPT__CK_INPUT_FLUID   (0=off, 1=on)   [0]

  • Description: Check the input data of the fluid solver for debugging purposes.
  • Restriction:

• Main page of Runtime Parameters