Run Properties: Simulation

GoldSim provides a number of special reserved names, referred to as Run Properties, that can be directly referenced in expressions. Some Run Properties return basic information about the simulation.

These can be found under the “Simulation” folder:

The Simulation Run Properties are described below:

TimestepLength: This is the length of the current timestep. More specifically, it is the time since the last model update. (At time = 0, the TimestepLength is set to the length of the first scheduled timestep). Note that under some circumstances (e.g. when creating “unscheduled updates” to better represent discrete events, or to dynamically adjust the timestep during a simulation), a model can be updated between scheduled timesteps, and this will be reflected by the TimestepLength Run Property.

   Note: At Etime = 0, TimestepLength returns the anticipated length of the first step (i.e., the length of the first scheduled timestep).

   Note: An example file which illustrates the use of TimestepLength (RunProperties.gsm) can be found in the General Examples/ Running folder in your GoldSim directory (accessed by selecting File | Open Example... from the main menu).

Realization: This is the realization number. For a deterministic simulation, it is always equal to 0. It is unitless.

NumOfReal:  This is the total number of realizations being carried out in the simulation.

   Note: NumOfReal actually represents the value entered into the # Realizations field in the Simulation Settings dialog, and this is not necessarily the same as the number of realizations that are carried out. In some cases (e.g., if you specify a Deterministic run, if you instruct GoldSim to run a particular realization, or if you are doing distributed processing), GoldSim will actually only run a single realization, but would still report the value from the # Realizations field as the NumOfReal.

SimDuration:  This is the total duration (i.e., the amount of simulated time) represented by the simulation.

Related Topics…

Learn more about: