The Simulation object is used to store inputs that define basic parameters of the model, such as run duration. The Simulation object is created automatically when a new model is started, and thus does not appear in the Model Builder.
Simulation Inputs
Keyword |
Description |
Key Inputs |
|
RunDuration |
Duration of the simulation run in which statistics will be recorded. |
InitializationDuration |
The initialization interval for the simulation run. The model will run for the InitializationDuration interval and then clear the statistics and execute for the specified RunDuration interval. The total length of the simulation run will be the sum of the InitializationDuration and RunDuration inputs. |
ExitAtStop |
If TRUE, the program will be closed on completion of the last simulation run. Otherwise, the last run will be paused. |
GlobalSubstreamSeed |
Global seed that sets the sub-stream for each probability distribution. Must be an integer >= 0. GlobalSubstreamSeed works together with each probability distribution's RandomSeed keyword to determine its random sequence. It allows the user to change all the random sequences in a model with a single input. The default value is the replication number for the simulation run being executed. |
PrintReport |
If TRUE, a full output report is printed to the file <configuration file name>.rep at the end of the simulation run. |
ReportDirectory |
The directory where output files will be written. The default location is the directory of the input configuration file. |
RunOutputList |
One or more selected outputs to be printed at the end of each simulation run. Each output is specified by an expression. In script mode (-s tag), the selected outputs are printed to the command line (standard out). Otherwise, they are printed to the file <configuration file name>.dat. It is best to include only dimensionless quantities and non-numeric outputs in the RunOutputList. An output with dimensions can be made non-dimensional by dividing it by 1 in the desired unit, e.g. '[Queue1].AverageQueueTime / 1[h]' is the average queue time in hours. A dimensional number will be displayed along with its unit. The format function can be used if a fixed number of decimal places is required. |
Options |
|
AttributeDefinitionList, CustomOutputList |
See Section 6.2. |
GeorgianCalendar |
If TRUE, the simulation uses the standard Gregorian calendar that includes leap years. If FALSE, the simulation uses a simplified calendar that has a fixed 365 days per year. |
StartDate |
The calendar date and time that corresponds to zero simulation time. |
PauseCondition |
An optional expression that pauses the run when TRUE is returned. |
ExitAtPauseCondition |
If TRUE, the simulation run will be terminated when the PauseCondition expression returns TRUE. If multiple runs have been specified, then the next run will be started. If no more runs have been specified, the simulation will be paused or terminated depending on the input to the ExitAtStop keyword. |
MaxEntitiesToDisplay |
The maximum number of entities to display in the view windows. A model can contain more than this number of entities, but only this number will be displayed. This limit prevents JaamSim from becoming unresponsive when the number of entities in a model exceeds the graphics capabilities of the computer. |
TickLength |
The smallest time increment for JaamSim's internal integer-based time keeping. The default value of 1 microsecond will support simulation runs of more than 100 years. |
Multiple Runs |
|
ScenarioIndexDefinitionList |
Defines the number of scenario indices and the maximum value N for each index. When running multiple scenarios, each index will be iterated from 1 to N starting with the last index. One scenario will be executed for every combination of the scenario index values. For example, if three scenario indices are defined with ranges of 3, 5, and 10, then a total of 3*5*10 = 150 scenarios will be executed. If left blank, a single scenario index is defined and there are no restrictions on the values that can be assigned to the StartingScenarioNumber and EndingScenarioNumber inputs. |
StartingScenarioNumber |
The first scenario number to be executed. |
EndingScenarioNumber |
The last scenario number to be executed. |
NumberOfReplications |
The number of replications to perform for each scenario. |
PrintReplications |
If TRUE, the run output report will include an entry for each replication that was performed. If FALSE, the report will show entries only for the scenarios. |
PrintConfidenceIntervals |
If TRUE, the run output report will include the 95% confidence intervals for the outputs defined by the input to RunOutputList keyword. The confidence intervals are calculated using the factor for the Student's T distribution corresponding to 95% confidence and the standard deviation for the output values over the replications. |
PrintRunLabels |
If TRUE, the first column of the run output report will show the scenario number for each simulation run. If the PrintReplications input is also TRUE, then the second column will show the replication number. |