-
Notifications
You must be signed in to change notification settings - Fork 57
Outputs
This page describes various data formats and options for storing simulation snapshots. For simulation logs recording, for example, performance, load balancing, and memory consumption, see Simulation Logs.
Related options: SUPPORT_HDF5
Parameters described on this page: OPT__OUTPUT_TOTAL, OPT__OUTPUT_PART, OPT__OUTPUT_TEXT_FORMAT_FLT, OPT__OUTPUT_USER, OPT__OUTPUT_PAR_MODE, OPT__OUTPUT_BASEPS, OPT__OUTPUT_BASE, OPT__OUTPUT_POT, OPT__OUTPUT_PAR_DENS, OPT__OUTPUT_CC_MAG, OPT__OUTPUT_PRES, OPT__OUTPUT_TEMP, OPT__OUTPUT_ENTR, OPT__OUTPUT_CS, OPT__OUTPUT_DIVVEL, OPT__OUTPUT_MACH, OPT__OUTPUT_DIVMAG, OPT__OUTPUT_LORENTZ, OPT__OUTPUT_3VELOCITY, OPT__OUTPUT_ENTHALPY, OPT__OUTPUT_USER_FIELD, OPT__OUTPUT_MODE, OPT__OUTPUT_RESTART, OUTPUT_STEP, OUTPUT_DT, OUTPUT_WALLTIME, OUTPUT_WALLTIME_UNIT, OUTPUT_PART_X, OUTPUT_PART_Y, OUTPUT_PART_Z, INIT_DUMPID,
Other related parameters: none
Parameters below are shown in the format: Name
(Valid Values) [Default Value]
-
-
Description:
Output the simulation snapshots in the specified binary format (HDF5 or simple C-binary),
which will store all simulation information such as grid data, particle data,
tree structure, runtime parameters, and compilation options. These snapshots can be used for
restarting simulations.
The snapshot filename is currently fixed to
Data_%06d
. See also OPT__OUTPUT_MODE for specifying the data dump frequency. -
Restriction:
OPT__OUTPUT_TOTAL=1
is only applicable when enabling the compilation option SUPPORT_HDF5. Data analysis with yt is currently only supported for the HDF5 snapshots of GAMER.
-
Description:
Output the simulation snapshots in the specified binary format (HDF5 or simple C-binary),
which will store all simulation information such as grid data, particle data,
tree structure, runtime parameters, and compilation options. These snapshots can be used for
restarting simulations.
The snapshot filename is currently fixed to
-
- Description: Output the data of a single line or slice in the text format. Use OUTPUT_PART_X, OUTPUT_PART_Y, and OUTPUT_PART_Z to specify the target coordinates. This output option is mainly for quick inspection for simple test problems with symmetry. Use OPT__OUTPUT_TOTAL for more general data analysis with yt. See also OPT__OUTPUT_MODE for specifying the data dump frequency.
- Restriction:
-
-
Description:
String format of floating-point data in output text files.
Please use the scientific notation
%XX.YYe
such as%14.6e
. This will affect files generated by, for example, OPT__OUTPUT_PART, OPT__OUTPUT_PAR_MODE=1, and OPT__OUTPUT_BASEPS. - Restriction:
-
Description:
String format of floating-point data in output text files.
Please use the scientific notation
-
-
Description:
Output user-specified data. Edit
src/Output/Output_Uer.cpp
or a problem-specific function (for the latter, see Add Problem Specific Functionalities). - Restriction:
-
Description:
Output user-specified data. Edit
-
- Description: Output particle data in either the text or binary format. This option is mainly for debugging purposes since the simulation snapshots (with the option OPT__OUTPUT_TOTAL) already store particle data.
- Restriction:
-
- Description: Output the mass density power spectrum on the root level.
- Restriction:
-
- Description: Only output the base-level (i.e., root level) data for OPT__OUTPUT_PART.
- Restriction:
-
- Description: Output the gravitational potential data on grids.
- Restriction:
-
- Description: Store the particle or total mass density on grids in the simulation snapshots. The particle interpolation scheme is set by PAR_INTERP.
- Restriction: Only applicable when enabling OPT__OUTPUT_TOTAL.
-
- Description: Output the cell-centered magnetic field (mandatory for yt analysis).
- Restriction: For MHD only.
-
- Description: Output the gas pressure (or gas + cosmic-ray pressure when enabling COSMIC_RAY) on grids. Magnetic pressure is always excluded.
- Restriction:
-
- Description: Output the gas temperature on grids.
- Restriction:
-
- Description: Output the gas entropy on grids.
- Restriction: Mainly used by the gamma-law EoS.
-
- Description: Output the sound speed on grids.
- Restriction:
-
- Description: Output the divergence of gas velocity on grids.
- Restriction:
-
- Description: Output the Mach number on grids.
- Restriction:
-
OPT__OUTPUT_DIVMAG
(0=off, 1=on) [0]-
Description:
Output
$|\nabla \cdot B| \Delta h / |B|$ , where$B$ is the magnetic field and$\Delta h$ is cell width. - Restriction: For MHD only.
-
Description:
Output
-
- Description: Output the SRHD Lorentz factor on grids.
- Restriction: For SRHD only.
-
- Description: Output the SRHD three-velocity on grids.
- Restriction: For SRHD only.
-
- Description: Output the SRHD reduced enthalpy on grids.
- Restriction: For SRHD only.
-
-
Description:
Choose the data output frequency.
-
1
: Every OUTPUT_STEP root-level step -
2
: Every OUTPUT_DT time interval -
3
: According to the dump timetable Input__DumpTable
-
- Restriction: Must enable at least one of the output options OPT__OUTPUT_TOTAL, OPT__OUTPUT_PART, OPT__OUTPUT_USER, OPT__OUTPUT_PAR_MODE, and OPT__OUTPUT_BASEPS.
-
Description:
Choose the data output frequency.
-
- Description: Output a snapshot immediately after restarting a simulation. It can be useful if some physical quantities change during restart (e.g., new particles are added).
- Restriction:
-
- Description: See OPT__OUTPUT_MODE=1.
- Restriction:
-
- Description: See OPT__OUTPUT_MODE=2.
- Restriction:
-
-
Description:
Output data every
OUTPUT_WALLTIME
wall-clock time, the unit of which is set by OUTPUT_WALLTIME_UNIT. Note that it is independent of OPT__OUTPUT_MODE. - Restriction: Must enable at least one of the output options OPT__OUTPUT_TOTAL, OPT__OUTPUT_PART, OPT__OUTPUT_USER, OPT__OUTPUT_PAR_MODE, and OPT__OUTPUT_BASEPS.
-
Description:
Output data every
-
- Description: Unit of OUTPUT_WALLTIME.
- Restriction:
-
- Description: x coordinate for OPT__OUTPUT_PART.
- Restriction:
-
- Description: y coordinate for OPT__OUTPUT_PART.
- Restriction:
-
- Description: z coordinate for OPT__OUTPUT_PART.
- Restriction:
-
- Description: Set the first data dump ID. Note that it is unnecessary to set this value in most cases, even when restarting simulations, unless you want to overwrite the default value.
- Restriction:
Typically, the simulation output interval is controlled by
OUTPUT_STEP,
OUTPUT_DT, or the timetable
Input__DumpTable
depending on
OPT__OUTPUT_MODE.
One can also enforce output by creating a file named
DUMP_GAMER_DUMP
(e.g., using touch DUMP_GAMER_DUMP
) in the same
directory as the executable gamer
. The program will check the existence
of this file after every root-level update. If it is detected,
the program will output data (assuming at least one of the output options described
on this page is enabled) and delete the file DUMP_GAMER_DUMP
.
Note that this functionality is supported only when the runtime parameter
OPT__MANUAL_CONTROL
is on.
Getting Started
User Guide
- Installation
- Running the Code
- Adding New Simulations
- Runtime Parameters
- MPI and OpenMP
- GPU
- Physics Modules
- Outputs
- Simulation Logs
- Data Analysis
- In Situ Python Analysis
- Test Problems
- Troubleshooting
Advanced Topics
Developer Guide