The settings described on this page regulate the name and very specific content of the output file generated by DREAM.
At the end of a simulation, DREAM will save data from the simulation to an
output file. By default, this file is named
output.h5 and is created
right before DREAM exits. The user can specify a custom name for the output
file by calling the
setFilename() method on the
Output object of the
ds = DREAMSettings() ... ds.output.setFilename("custom-output-filename.h5")
DREAM automatically monitors the execution time of certain critical parts of
the simulation. Information about the execution time can be output to
at the end of a successfull simulation, and can also be stored in the final
Measurement of execution time is regulated by the
setTiming() method which
takes two booleans as arguments:
stdout, whether details about execution
time should be printed to
stdout at the end of the simulation, and
whether the details should be stored in the final output file generated.
ds = DREAMSettings() ... # Print timing info to stdout AND store in output file ds.output.setTiming(stdout=True, file=True)
By default, no timing information is created.
Simulation output will generally be stored even if DREAM crashes. The named output file will then be created (or overwritten if it already exists) and contain data from all time steps that finished successfully. The data file can be loaded as usual with the DREAM Python output interface.
Load settings from the given dictionary.
data (dict) – Dictionary to load settings from.
Set the name of the output file.
filename (str) – Name of output file to store simulation data to.
Specify whether or not to save a copy of the input settings to the output file (enabled by default).
save (bool) – If
True, copy settings to the output file.
Specifies whether to print timing information and/or include it in the output file.
stdout (bool) – If
True, prints details about execution time to
stdout at the end of the simulation.
file (bool) – If
True, stores details about execution time in the output file after the simulation.
Returns a Python dictionary containing all settings of this Output object.
verify (bool) – If
True, verifies the settings of this object before generating the dictionary.
Verify that the Output settings are consistent.