• InfoWater Pro

Creating an Output Relate

Create a DB Query based on an Output Relate that establishes a link between modeling input data and simulation output results.


Tutorial resources

These downloadable resources will be used to complete this tutorial:

iwtr2023M09U06_Creating-an-Output-Relate.zip

Step-by-step:

The Output Relate option is used to establish the relationship between modeling input data and simulation output results. Once a relate (or link) is established, you can then apply queries to the current project based on modeling inputs and simulation output results simultaneously. Output relates are stored in an external database (dBase IV) file, which can be linked with other third-party GIS software to view the analysis results.

  1. Open the appropriate .aprx file in ArcGIS Pro.
  2. From the ribbon, InfoWater Pro tab, Project panel, click Initialize.

To create an output relate to find junctions that have a high pressure during the simulation:

  1. In the Model Explorer, Operation tab, click Output Relate.
    The Model Explorer, Operation tab, with Output Relate selected
  1. Right-click Output Relate and select New.
  2. In the Output Relate Identification popup, type an Output Relate ID of “JUNCT_C, Current Scenario Junction Range”.
  3. Click OK.
  4. In the Output Relate dialog box:
    1. In the Source Output Data group, expand the Desired Output Report drop-down and select Junction Range.
    2. Expand the Desired Report Page type drop-down and select Pressure. When you do, the Desired Report Page value changes to 2.
    3. Enable the Automatic Update option. 

Note: With the Automatic Update option ON, the relate table will be automatically updated every time you run a simulation when the relate’s target scenario and target simulation are active.

The Output Relate dialog box, with the settings configured to automatically update

  1. Click Update Current Relate Now.
  2. If you see a message that the current relate updated successfully, click OK.
  3. Click OK again to close the Output Relate dialog.

To set up a DB query that uses this Output Relate:

  1. In the Model Explorer, on the Operation tab, right-click DB Query and select New.
  2. In the DB Query Identification popup, type a DB Query ID of “JUNCT_C, Querying Output Relate”.
  3. Click OK.
  4. In the DB Query dialog box, switch to the Output Relate(s) tab.
  5. Make sure JUNCT_C, Current Scenario Junction Range is displayed in the drop-down. Then, click Add Relate to attach this Output Relate to the DB Query.
    The DB Query dialog box displaying the Output Relate(s) tab with the Add Relate icon highlighted
  1. Click the Query Statement tab.
  2. Click the Query Builder icon.

In the Query Builder dialog box, a JUNCT_C tab appears, representing the Output Relate you created. To build a query for junctions with a pressure that drops below 0 psi:

  1. Click the JUNCT_C tab.
  2. Select the fields and operators and then click Add, OR type the query directly into the Query Statement type box: “JUNCT_C->MIN_VALUE<= 0.000000”.
    The Query Builder dialog box with settings needed to build a query for junctions with a pressure that drops below 0 psi
  1. Click Validate to make sure your query is valid.
  2. Click OK to close the validation message
  3. Click OK to close the Query Builder.
  4. Click OK to close the DB Query.

To now apply this query to the domain:

  1. On the ribbon, InfoWater Pro tab, Domain panel, click Domain Manager.
  2. In the Domain Manager:
    1. Set the Element Source to DB Query.
    2. Expand the drop-down and select JUNCT_C, Querying Output Relate.
    3. Click Add to add any junctions with a minimum pressure less than 0 psi to the map.

The Domain Manager dialog box with the JUNCT_C DB Query selected

  1. Click Close to close the Domain Manager.
  2. On the ribbon, InfoWater Pro tab, Domain panel, click Zoom Domain to zoom to the area designated by the query.
  3. Select the junction J1404, between the reservoir and two pumps.
    InfoWater Pro ribbon, Domain tab, with Zoom Domain tool highlighted and selected junction highlighted in red in the map
  1. In the Model Explorer, Attribute tab, drag the slide bar for this element and view the Output > Pressure settings.

Note that the pressure becomes negative after hour 4 of the simulation.

The Model Explorer, Attribute tab for Junction J1404, with slide bar at 04:00 hours and Pressure setting highlighted

Negative pressures are worth reviewing, as they often mean demands cannot be met at those nodes. The EPANET engine requires that all demands are fulfilled, so it is mathematically possible to get negative pressures even though that would not be reflected in an actual system. The negative pressure at this junction can be ignored as it was digitized for splitting flow to the pumps, so its pressure is artificially reduced by being so close to the reservoir.

  1. On the ribbon, InfoWater Pro tab, Domain panel, click Clear Domain.