Generalised Multi Run Configuration dialog

Use this dialog to set up a simulation that runs multiple test cases.

To open the dialog for a new configuration, right-click Generalised Multi Run Group in the Model Group window and select New | Generalised Multi Run Config.

To open the dialog for an existing configuration, select an item from the Generalised Multi Run Group in the Model Group window.

Show image

Test Cases page

You use this page to specify test cases in the grid on the right side. You can enter the test cases manually, although a wizard is provided on the left side to make the creation of multiple test cases quicker.

Click to see page properties

Item

Description

Wizard

The selections you make in the wizard are applied to the test case grid on the right when you click the Add button. You can change the selections in the wizard then click the Add button again to create more test cases in the grid.

Selection List	You can click the # (Current) button to specify that the current selection on the GeoPlan should be used. Alternatively, you can drop a selection list into this box or select one using the Browse button. The selection list must contain network objects for which test cases are to be created. If you don't use a selection list, you can instead choose an object type and a specific object to use for a test case (see below).
Object Type	Choose the type of object for which you want to create a test case. Instances of this object type must exist in the current network and, if a selection list is used, in the selection list. If you choose an object type that does not exist in the current network or in the selection list, you will not be able to complete the wizard. Note: If you are using a selection list, test cases will be created for all objects of this type in the selection list. In this case, the wizard will not allow you to choose individual objects, although you could delete unwanted test cases created for those objects from the test case grid should you want to.
Field / Value grid	This grid is populated with appropriate parameters (fields) when you choose an object type. Select the parameters (fields) that you want to include in the test case(s). You can set the value for the parameter here. For multiple test cases created from these settings, you will eventually be able to change the value for individual test cases in the grid on the right.
Test case name	You can enter a name that will be used for all test cases created when you next click the Add button. If you give different test cases the same name, they will all be applied in the same run. Test cases with different names will be applied in separate runs. If you do not enter a name here, click Append object ID to test case name to use the object ID as the test case name.
Append object ID to test case name	Tick this box if you want the test case name to include the ID of the object that features in the test case. If you have not entered a specific test case name, the object ID will be used as the test case name.
Object ID	If you are using a selection list, test cases will be created for all relevant objects in the list, using the IDs for those objects. You do not need to select the individual object IDs, so the Object ID drop-down list is not available. If you are not using a selection list, one test case will be created for each object whose object ID you select from the drop-down list.
Add	Click this button to add all the details you have specified so far to the test cases grid on the right. You can click this button multiple times to add test cases to the grid, changing the details on the wizard each time if required.

Test case grid

You can create test cases directly on this grid, or you can populate the grid using the wizard on the left. Even if you use the wizard, you can change the test case details in the grid, and you can add new test cases manually. You can delete a test case by right-clicking its left-most (grey) column and selecting Delete.

Test Case	Enter a name for the test case. All test cases with the same name will be applied in the same run.
Table	Choose an object type for which instances exist in the current network. Alternatively, you can choose Run, and then choose a parameter (field) that can be modified as successive test cases are implemented.
Object Id	Choose the object for this test case by selecting its ID. If there are no instances of the selected object type, this list will be empty.
Field	Choose the parameter (field) to be used in the test case.
Value	Choose or enter the parameter value for the test case.

CSV Import

Click this button to import a .csv file containing test case information previously set up.

Mapped CSV Import

Click to open theGMR Mapped CSV Import dialog, which is used to set up test cases based on components from a CSV file or SQL results grid. These test cases are transferred to the test case grid, described above.

CSV Export

Click this button to create a .csv file containing the current test case configuration.

Examples of creating Test Cases

Generalised Multi Run (GMR) is setup by specifying test cases. The following image shows a very simple case. There are three test cases and so there will be three runs. Each run involves closing a single pipe, and the run takes the name of the pipe.

To make this simple list of test cases, use the “wizard” section on the left pane of the dialog.

Start with a selection list of three pipes. Drop this into the drop target.
From the drop-down menu, select Pipe (Control). This exposes the fields for the pipe control fields.
Find Pipe Closed and check the box (i.e. closed)0
Check the box Append Object ID to test case name. Leave the Test case name blank.
Click the Add - - > button. Three test cases are created. Each takes the name of its pipe, and each test case involves closing the pipe.

To add multiple objects in one test case:

Start with a selection list of three pipes. Drop this into the drop target.
From the drop-down menu, select Pipe (Control). This exposes the fields for the pipe control fields.
Find Pipe Closed and check the box (i.e. closed).
Set the test case name to RED.
Click Add - - >.

A single test case is created. The GMR would run single simulation called RED, in which three pipes are closed.

Repeat the steps above but with the name YELLOW.
Click Add - - >.
Delete one of the rows of the YELLOW test case

Now the GMR has two simulations called RED and YELLOW with three and two closures, respectively. Continue in this way to make two further test cases called ORANGE and BLUE.

For the set-up of a more complex GMR. Take the three pipes, and for each pipe, set up a burst. The burst involves setting several Control fields. But go beyond this and set up three different burst sizes.

Start with a selection list of three pipes. Drop this into the drop target.
From the drop-down menu, select Pipe (Control). This exposes the fields for the pipe control fields.
Set the burst fields: enable the burst; for the entire simulation; a flow type burst; a fixed flow; a flow value of 0.5 l/s. So, there are five Control fields.
For test case, give the name SmallLeak and check the box Append object ID to test case name.
Click Add - - >.
Modify the leak value to 1.0 l/s and change the name to MediumLeak. Click Add - ->.

In this way you have multiple tests cases for each object. And each test case involves the setting of multiple fields.

As can be seen, the wizard offers a lot of flexibility. In addition, you can export the test cases to CSV, manipulate them and reimport them. For even greater power, you can use SQL to generate a table which is imported into the test case grid. See GMR Mapped CSV Import dialog for more information.

Results page

You can use this page to specify a subset of results to keep. You might want to do this to save storage space.

Click to see page properties

Analysis page

You can use this page to specify analysis options.

Click to see page properties

Item

Description

Analysis

Use simulation result fields	Select to carry out analysis based on the information in the Simulation results fields area (see below).
Use stored query	Select to carry out analysis based on a stored query. Specify which stored query to use in the Results query section.
None	Select to carry out no analysis.

Results query

Available only if the Analysis option is set to Use stored query.

Stored Query	Drop a query object into this box or select one using the Browse button.
Run query at time	Enter or select a date and time to run the query.

Simulation results fields

Available only if the Analysis option is set to Use simulation result fields.

Use test objects	Select to see results for the objects used on the Test Cases page.
Use selection list	Select to see results for a subset of objects used on the Test Cases page, as specified in a selection list. If this option is chosen, drop a selection list into the Selection List box or choose one using the Browse button.
Show InfoWorks TS results in fields	Tick to include these results in the grid below.
Results field grid	Select the fields to be included in the analysis.

Perform base simulation

A base simulation is one without any of the changes specified in this configuration. Tick the box to run a base simulation in addition to the simulations you have set up on the Test Cases page. You might want to do this so that you can compare "before and after" values.

Examples of the Analysis of GMR results

The Analysis tab decides what values go into the summary table. The summary table is structured as follows:

The Test Case and Object ID fields will form a primary key within the summary table.

As an example, if using a query to populate the report, Result-1 could be pressure at time T1, Result-2 could be pressure at time T2 and Result-3 might be Max Pressure. This table will be “sliced and diced” for final display in the grid or GeoPlan. Aggregation will take place across Object ID or Test case name to give minima to Result-1 or maxima for Result-3.

The summary table is constructed from pre-existing summary fields or from a query.

Pre-existing summary fields- Use a selection list or use the list of test case objects. Choose some summary result fields; these will appear in the summary table.
Run a query - For this you can also request that a Base Run is used (i.e., the original run with no test case instructions) and both Test Case and Base Run would be available in the query.

An example of a query is seen below. It is designed for pipes. The query returns an object id (as the result column object_id) and a result column called SeriousReversal, which will be 0 or 1 if there is a large number of flow reversals. Test case ID is automatically output.

select OID AS object_id , IIF( (sim.pctflowf > 20 and sim.pctflowf < 80 and sim.vnegmax < -0.15 and sim.vposmax > 0.15 and sim.reversal > 10),1,0) AS SeriousResersval

The summary table will contain three columns: test_case, object_id, SeriousReveral

Save button

Click to save the configuration.

GMR Mapped CSV Import dialog

Schedule Hydraulic Run view

Model Group window

About simulations

Using selection lists