Share
 
 

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 (GMR) 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.

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.

Item Description
Wizard

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

Selection List

You can click # (Current) 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.
Generate test case for isolation area

Allows you to use isolation areas in GMR.

For each isolation area code found in the Selection Links to be included in analysis, all links in the isolation area will be closed and a simulation run. There will be one simulation run per isolation area.

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 the GMR 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.

  1. Start with a selection list of three pipes. Drop this into the drop target.

  2. From the drop-down menu, select Pipe (Control). This exposes the fields for the pipe control fields.

  3. Find Pipe Closed and check the box (i.e., closed).

  4. Check the box Append Object ID to Test Case Name. Leave the Test Case Name blank.

  5. Click Add - - > . 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:

  1. Start with a selection list of three pipes. Drop this into the drop target.

  2. From the drop-down menu, select Pipe (Control). This exposes the fields for the pipe control fields.

  3. Find Pipe Closed and check the box (i.e., closed).

  4. Set the test case name to RED.

  5. Click Add - - >.

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

  1. Repeat the steps above but with the name YELLOW.

  2. Click Add - - >.

  3. 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.

  1. Start with a selection list of three pipes. Drop this into the drop target.

  2. From the drop-down menu, select Pipe (Control). This exposes the fields for the pipe control fields.

  3. 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.

  4. For test case, give the name SmallLeak and check the box Append Object ID to Test Case Name.

  5. Click Add - - >.

  6. 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

Item Description

Test cases

Keep test cases if query returns results:

Stored Query

You could create a SQL query that selects a subset of results. Drop the query into the box or select it using the Browse button.

Run query at time

You can select a date and time at which the query should be run.
TVD results

You can choose to discard all time variable results, perhaps because you do not want them to take up storage space.

You can choose to keep or discard certain combinations of results and summaries, perhaps because you want to conserve storage space.

Examples of Results handling in GMR

The minimum for the retention of results is to keep the summary data cube, Keep Summary Report Only. This allows the generation of grid reports, as well as thematic colouration in the GeoPlan. This summary report is always retained

At the other extreme, Keep All TVD Results allows individual simulations to be examined but of course the volume of data may cause performance and storage problems.

Intermediate approaches are:

  • Keep individual test cases if a query returns a “positive”. For example, you might have a query to select a reservoir if its level drops below 20% full. Any test case that includes results like this will be retained.

  • Keep summaries for individual test cases, but discard time varying results.

Analysis page

You can use this page to specify analysis options.

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.
Use simulation result fields and stored query If this option is selected, you can use the simulation results fields and also use a SQL query at the same time.
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.
Perform Service Level Analysis

This option allows you to perform Service Level Analysis.

By default, this option is not selected.

Clicking the Options button opens the Critical Link Analysis Options dialog where you can set up your options for analysis criteria, minimum and maximum pressure, event demand efficiency, and failure count type during a critical link analysis simulation.

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:

Test Case name

Object ID name Result 1 Result 2 Result 3 Result 4 Result N

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.

Related Information

Was this information helpful?