Scenario Manager - Example

Navigation:  Toolboxes > Scenario Manager >

Scenario Manager - Example

Previous pageReturn to chapter overviewNext page

Introduction

You can see the toolbox in action with the example model Lifting System - Test Automation. We will run this model tow show you how the Scenario Manager can be used.

Editor

1.In the 20-sim Editor go to the Library tab
2.In the Library tab select Examples - Signal Processing - Lifting System - Test Automation.
3.Drag and drop the model to the right to open the model.

Now the Editor will look like:

Lifting System - Test Automation

As you can see, in the model two AssertSignal blocks have been added.

AssertSignal1 (Continuous): compares the actual position with the set-point position. If both deviate more that 5 cm, the output testResult goes from true to false.
AssertSignal2 (Boolean): The minimum value of the pressures in both chambers is compared with a constant signal of 5 bar. If any one of the pressures is lower, the output of the AssertSignal2 block testResult goes from true to false.

We will use the two AssertSignal blocks to verify the outcomes of several Scenarios in the Scenario Manager.

Scenario Manager

Now we will open the Scenario Manager and run some scenarios:

1.From the Tools menu select Scenario Manager.
2.Select Proportional Gains.

 

The Scenario Manager will look like:

Scenario_Manager_Example_Category

 

Category

At the left in the Scenario Manager you will see a tree with Categories and Scenarios. Categories are listed directly under Home. In the picture above you see the category Proportional Gains, the Category Valve Settings and the Category Failing Tests. Under the Categories, the Scenarios are listed (kp = 4 etc, kp = 5, kp = 6, Gleak =  1e-14 etc.).

 

In the middle of the Scenario Manager, you can see the various Actions that have been selected. Each Action will perform a certain task. Actions are carried out sequentially, from the left to the right, and from the top to the bottom. In the picture above, the category Proportional Gains is selected. The Actions that apply for this Category are indicated in purple:

Pre-simulation: The Actions that are shown here, are carried out before the simulation. In the picture above no Actions have been selected.
Simulation: The Actions that are shown here, are carried out during the simulation. In the picture above the Actions Run Simulation and OK to Continue are shown.
Post-simulation: The Actions that are shown here, are carried after a simulation. In the picture above the two Actions AssertTest are shown.

 

Scenario

3.Select kp = 4.

Now the Scenario Manager will look like:

Scenario_Manager_Eaxmple_Scenario

 

As you can see, the Pre-simulation bar shows one Action extra, Set Parameter. The color of the Actions is blue.

 

Actions from a Category are shown in purple.
Actions from a Scenario are shown in blue.
When running a scenario, all Actions will be executed.

 

In the Scenario of the picture above a parameter value will be set, the a simulation will be run followed by asking the user to press OK and then check the output of the AssertSignal modules.

Running a Category

4.Open the 20-sim Simulator: In the 20-sim Editor click Model - Start Simulator.
5.Move the Simulator window on aside from the Scenario Manager window, so you can see both.
6.In the Scenario Manager choose the Category Proportional Gains
7.Click on the Play button Scenario_Manager_Play.

 

Now the first scenario of this Category will be run. In the Simulator window you can see the simulation run:

Lifting System - Test Automation - Simulator

8.Press OK after each run.

 

After the three runs have been performed, the Scenario Manager will look like:

 

Scenario_Manager_TestsOK

 

Left of the Scenarios, you will see V-signs indicating that the Scenarios were run successfully: the AssertSignal blocks have given a true output at the end of each run.

9.In the Scenario Manager choose the Category Valve Settings.
10.Click on the Run category button.

Now three Scenarios will be run without asking you to click OK. Left of the Scenarios, you will see V-signs indicating that the tests were successful.

11.In the Scenario Manager choose the Category Failing Tests
12.Click on the Run category button.

Left of the Scenarios, you will see red crosses, indicating that the tests were not successful: the AssertSignal blocks have given a false output at the end of each run.

 

Running a Scenario

You can also run a Scenario individually.

13.In the Scenario Manager choose the Scenario Amax = 1e-8
14.Click on the Play button.

Now the Scenario will run. After the Scenario has been run, one of the Actions has a red edge. If you click on the Action, you will see the corresponding log. It will show that a time = 0.16 s the simulation output was deviating too much from the desired value.

 

Scenario_Manager_Exampe_Log

Inspecting a Module

You can inspect a module by clicking on it.

15.In the Scenario Manager click on the Module Set Parameter.

Now the Scenario Manager will look like:

 

Scenario_Manager_SetParameter

 

At the right of the Scenario manager, you can see the settings of this Action. It will set the parameter of the 20-sim model to a certain value. By clicking on the pencil buttons, you can change the settings.