How the Scenario Control Works in GoldSim

The Scenario control is designed so it behaves slightly differently depending on whether you are viewing the control within GoldSim or within the GoldSim Player. In particular, when used from within GoldSim (i.e., when a GoldSim user edits and runs a model from a Dashboard), it provides several additional options that are not available to Player users (as these features would likely confuse Player users, who are typically unfamiliar with the details of GoldSim).

The discussion below focuses on how the Scenario control would be used by someone who is running and editing their scenarios from within GoldSim (i.e., running GoldSim and using a Dashboard in Active view). 

It is assumed that such a user has a good understanding of GoldSim and the use of scenarios, and understands the difference between Result Mode and Scenario Mode.

In Active view within a Dashboard, the Scenario control displays the Active Scenario (or “Live Model”). If the model does not contain any scenarios, the control will display “Live Model” as the only option:

If the model includes scenarios, these will be included in the drop-list:

Scenarios can be created from a Dashboard in two ways:

   Pressing the “+” button on the Scenario control.

   After running the Live Model, and then resetting the model (by pressing F4), you are presented with an option to save the results as a scenario.

When you change to a different scenario in the Scenario control, the value in any input control that is linked to a Scenario Data element (i.e., a Data element that is scenario-specific) will instantaneously change.  If you then change the value in such an input control, that will become the value for the selected scenario.

   Note: Not all of the input controls in a Dashboard will necessarily be linked to Scenario Data.  Some may be linked to Data elements that are not Scenario Data. That is, some of the inputs will be scenario-specific, while others will apply to all scenarios. When you design your Dashboard(s), it will be critical to make it clear which input controls are scenario-specific and which are not.

   Note: If the Dashboard exposes Time Series or Lookup Table data via a button, that information is never scenario-specific.  If these are changed, they apply to all scenarios.  This is because only Data elements can vary between scenarios.

   Note: When a Scenario control is present on a Dashboard, all Scenario Data elements must be editable via a Dashboard control in one of the Dashboards in the model in order to create a Player file.  That is, if a Scenario Data element has been defined that is not accessible via a Dashboard, you will not be able to create a Player file.

If you have checked the Show “Scenario Data” button option in the properties dialog for the Scenario control, a button is added on the right-hand side of the control:

Graphical user interface, application, Word

Description automatically generated

Clicking on this button opens the Scenario Data dialog directly (allowing Scenario Data to be edited). Note that this button behaves somewhat differently in GoldSim Player (Scenario Data can be viewed but not edited).

When using a Scenario control within GoldSim the model can actually be run in two different ways:

   Pressing the Run button in the toolbar runs the scenario and places the model in Result Mode.  All output displays show results only for that particular scenario.

   Pressing the Run button on the Scenario control when a scenario is selected runs the scenario and places the model in Scenario Mode.  Hence, although output displays (such as thermometers) show the results for the Active Scenario, buttons linked to Time History and Distribution Result elements show results for ALL scenarios that have been run (and hence have results). Note, however, that pressing the Run button on the scenario control when “Live Model” is selected is identical to pressing the Run button in the toolbar. The model is placed into Result Mode, and your output controls display results for the Live Model.

Pressing the Run All button on the Scenario control runs all of the defined scenarios and places the model in Scenario Mode

Scenarios that have results are highlighted with an asterisk:

In this example the Base Case and High Flow scenarios have results.

It is important to re-emphasize that the scenario results shown in result displays are a function of the simulation mode (and hence how the model was run).  In Result Mode, only the results for the Active Scenario (i.e., the scenario shown in the control) are displayed.  In Scenario Mode, the results for all scenarios that have been run (using the Scenario control) are shown when viewing Time History and Distribution Result elements.

After you have run your model, you can reset the model (so that you can edit input controls) by pressing F4. If the Active Scenario has results (indicated by an asterisk), you must reset the model in order to change values of any input controls in the Dashboard.  If you change the Active Scenario to one that does not have results, you can change the values of input controls that are scenario-specific without having to reset the model (even if other scenarios have results).  However, if any of your scenarios have results, you can not change the values of any input controls that are not scenario-specific (i.e., that apply to all scenarios).

Pressing F4 to reset the model will display a dialog that may provide several choices.  The dialog that is displayed differs depending on 1) how you ran the model (is it in Scenario Mode or Result Mode); 2) whether the Live Model or a scenario was run; and 3) whether or not multiple scenarios in the model have results.

Related Topics…

Learn more about: