• InfoWorks WS Pro

Validating models

Explain the concept of validation, and specifically, what engineering validation is.


Tutorial resources

These downloadable resources will be used to complete this tutorial:

iwsp2023M03U03_Validating_Models.wspt

Step-by-step Guide

In InfoWorks WS Pro, models must be validated to ensure that they are hydraulically sound before simulations can be run. The validation process involves finding errors and warnings—if any exist—and then fixing them one at a time.

To open a transportable database:

  1. Click File > Open > Open transportable database.

In the InfoWorks WS Pro interface, the File menu expanded with the Open flyout displayed and Open transportable database selected.

  1. In a file browser, open the Session 3 folder.
  2. In the Session 3 folder, open the Data folder.
  3. Select “Validating Models.wspt”.
  4. Click Open.
  5. On your keyboard, press and hold SHIFT.
  6. In the transportable database window, click the Session 03 model group.
  7. Click the Session 03 – Lock model group.

The transportable database window with Transportable Database expanded in the file tree, and with the Session 03 and Session 03 - Lock model groups selected.

  1. Right-click the selected model groups and select Copy.
  2. In the Model Group window, right-click Database and click Paste all.

In the Model Group window, the Database shortcut menu with Paste all selected.

  1. Close the transportable database window.

To start the validation process:

  1. In the Model Group window, expand the Session 03 model group.
  2. Drag-and-drop BridgeNet into the workspace to open the GeoPlan.

The Model Group tree expanded, the network selected, and opened in the workspace.

Note: If you have the control and demand diagram already associated with the network, they will open with the network. Skip to Step 18.

  1. From the Model Group window, drag-and-drop the BridgeCon control into the workspace.
  2. Expand the Demand Diagram Group.
  3. Drag-and-drop the BridgeTown demand diagram into the workspace.

The BridgeTown ADAW Demand Diagram window open in the workspace.

To validate the network:

  1. In the menu bar, select Network > Validate Network.

The Network menu with Validate Network selected and called out.

  1. From the Model Group window, drag the BridgeCon control into the Validate Network dialog box and drop it into the Control group box.
  2. From the Model Group window, drag BridgeTown ADAW into the Validate Network box and drop it into the Demand Diagram group box.
  3. Click OK.

The Network Validation dialog box for BridgeNet, with BridgeCon in the Control group box and BridgeTown ADAW in the Demand Diagram group box.

  1. In the Output Window, review the list of errors and warnings.

The Output Window with a list of errors and warnings, with columns including Code, Object Type, Field, and Message.

  • A red circle with an exclamation mark (!) indicates an error. The model will not run until it is resolved.

Note: Re-validate the model after fixing each error. Sometimes, resolving one error will solve others linked to it.

  • A yellow circle with an exclamation mark (!) indicates a warning. The model will run, but something is outside of default parameters.

Note: You may not need to resolve a warning if it represents a change or setting you intended.

  1. Double-click error E0040 and notice that nothing happens, because it is a Connectivity issue, as listed in the Field column.
  2. In the Output Window, double-click error E0208, and a grid appears showing the exact location of the problem.

The Grid window for error E0208, pinpointing the exact location of the error.

To resolve a connectivity error:

  1. In the ribbon, select GeoPlan > Tracing tools > Connectivity trace.

In the GeoPlan menu, the Tracing tools flyout with Connectivity trace selected.

In the Subnetworks Found dialog, notice there are two subnetworks, meaning a single connectivity break in the network is separating it into two subnetworks.

  1. Click either of the subnetworks to select it.
  2. Click Find Selected SubNetworks (Ret).
  3. In the GeoPlan, review the subnetwork, highlighted in red, for the source of the connectivity issue.

The Subnetworks Found dialog with a subnetwork selected, Find Selected SubNetworks highlighted, and the GeoPlan in the background with the subnetwork highlighted in red.

  1. Zoom in to see the error in more detail.

In this example, a junction is not complete, so water cannot flow from the reservoir upstream past this point.

The GeoPlan zoomed in to the incomplete junction causing the error.

  1. In the Tools toolbar, expand the Object category drop-down and select Link.

The New object drop-down with Link selected.

  1. In the Tools toolbar, click New object.

The Tools toolbar with the New object command called out.

  1. In the GeoPlan, click the node at the end of the upstream portion of the network to place a start point.
  2. Click again on the node across from the start point.

The GeoPlan with the newly created link in red and the end node placement called out.

  1. In the Create New Link dialog, in the Type drop-down, select Pipe.
  2. Click OK.

The Create New Link dialog with the Type set to Pipe and OK selected.

  1. In the Properties panel, review the properties for the pipe just created.

Note: In this example, the small cells next to the Diameter (mm) and CW - k (mm) fields are red. This means you are required to enter values for those properties.

  1. In the Diameter (mm) field, enter “250” to set the diameter of the pipe.
  2. In the CW – k (mm) field, enter “0.1” to set the friction coefficient.

The Properties panel of the newly created pipe, with the Diameter and CW – k, or friction coefficient, fields highlighted in red, and values entered.

  1. Close the Properties panel.
  2. Repeat Step 18 to validate the model again.

Notice the Output Window only lists three errors, as the connectivity issue is solved. Solving that issue also resolved the warning that had previously appeared here. Also, notice the Reservoir error is now at the top of the list.

To resolve a reservoir error:

  1. In the Output window, drag either window edge outward until you can see Top Water Level (ft AD) listed at the top of the Field column.
  2. Double-click reservoir error E0208 to view its details in a grid.

In the Grid window, in the Top Water Level (m AD) column, notice the first cell is blank. This is a common error that often happens when importing data from other sources, such as GIS.

The Output Window with the reservoir error highlighted; and above, the Grid window with the blank Top Water Level field highlighted. .

  1. In the Grid window, in the blank Top Water Level cell, enter the same value listed below it.

The Grid window with a value entered in the Top Water Level cell to resolve the reservoir error.

  1. Click in another cell to confirm that the new value has been saved.
  2. Close the window.
  3. Validate the model again, as in Step 18.

Notice the Output Window now lists only one error, again emphasizing that fixing one error can solve another.

To resolve a valve error:

  1. In the Output Window, double-click the valve error to view its details.

Note: You can fix the error in the grid, but sometimes, it is easier to use the GeoPlan.

  1. In the Grid window, at the bottom of the left column, right-click the green cell with the black arrow, and click Select and find in GeoPlan.

The Output Window with the valve error highlighted in red; and above, the Grid view of the error, with the green-cell menu expanded and Select and find in GeoPlan called out and selected.

Notice this changes the window from a grid to a zoomed-in view of the GeoPlan with the valve highlighted in red.

  1. In the Tools toolbar, click Properties.

The GeoPlan zoomed into the highlighted valve, and in the Tools toolbar, the Properties command called out.

  1. Click the valve to view its properties.

Note: Because this is a pressure-reducing valve (PRV), it requires a control node. In this example, the node immediately downstream is used as the control.

  1. At the top of the Properties panel, under Definition, select the To Node, ST28363410.

The Properties panel of the valve, Definition section with the To Node field called out.

  1. Copy the value to the clipboard.
  2. In the Properties panel, under Valve Control, click to select the Control Node field.
  3. Paste the value into the field.

In the Properties panel of the valve, Valve Control section, the new Control Node value is highlighted in red.

  1. Repeat Step 18 to validate the model again.

The Output Window is now cleared of all errors and warnings, meaning that the model is now hydraulically sound and ready to be run through simulations.