Product(s):	WaterSight
Version(s):	10.00.
Area:	Documentation

Note: It is highly recommended to turn off and delete track changes in the WaterGEMS model prior to upload in WaterSight (more information below) and also to upload a zip extension file (with just the sqlite extension) for performance reasons.

Overview

In the Numerical Models Administration page the user can:

• Upload or configure an existent hydraulic model - Configuration (this page)
• Download previous simulation runs to do further analysis in WaterGEMS/CAD and analyse potential message errors or warnings - Previous Simulation page.

Configuration

This configuration page is used to upload the hydraulic model and set the options for the automated real time simulation.

Sensors measurements can be used as boundary conditions for the hydraulic model runs, contributing to increase the confidence in the model calculated results (such as tank levels, PRV settings, pump status and relative speed, etc). Besides this, zone patterns and hydraulic grade line patterns for tanks and reservoirs can also be used as boundary conditions for the model runs, but in this case they are not applied only for initial conditions, but rather to the all simulation period. More information can be found here.

The uploaded WaterGEMS model will automatically run in WaterSight, at a given frequency defined by the user and also considering the hindcast and forecast period defined (more detail below). If the WaterGEMS model contains more than one scenario, only the active scenario will be considered in WaterSight. 

General Tips

In order to successfully run the hydraulic model in WaterSight, the user should first check if the EPS model is successfully running in WaterGEMS. In case there are errors, the user should first correct them using WaterGEMS. To take full advantage of WaterSight capabilities, the user should check if the WaterGEMS hydraulic model is updated with all relevant network elements (all linear and vertical assets). Some tips below:

• customer meter elements should be updated in the model and, ideally, the billing ID field in the model matches the ID provided in the Customer Meter and Billing configuration files (customers will be used in the Pipe Break, Fire Event and Pump Shutdown workflow),

• isolation valves should be updated (will be used in the Pipe Break and valve operations workflow). The user can use TCV, GPV or isolation valves types in WaterGEMS to represent the operating valves in WaterSight;

• SCADA elements are created and mapped to the respective model elements (this is important to assure that model boundary conditions are being fed by real sensors measurements. Both name of the SCADA signals and units need to match those defined in WaterSight. More information here),

• when using the automatic demand adjustment option of WaterSight (see below for more information) it is required that the zones name in the WaterGEMS hydraulic model are associated to the nodes and match the names given to the zones in WaterSight.

• tank definition in the model must match the SCADA type. If the SCADA signal is Level, the tank "Operating range type" should be defined by Level. If HGL, then tank Operating range type" should be defined by Elevation.

• to increase model performance in WaterSight, please make sure to:

  • delete all track changes from the WaterGEMS model. To delete track changes go to the review tab in WaterGEMS >> select Bulk Archive >> delete records (see image below). After that, please make sure to compact database, by acceding to File >> Database utilities >> Compact Database. At the end, make sure to save the file. This workflow can significantly reduce the size of the SQLite file in case the utility is using the track change functionality quite often.

Fig 1 - Delete track changes in the WaterGEMS model	Fig 2 - Compact Database in WaterGEMS

• • whenever possible increase the hydraulic time step in WaterGEMS (Go to Home >> Options >> Base Calculation Options >> Hydraulic Time Step) - recommendation is 15 minutes
  • make sure that the "Calculate Customer Results" is False (Go to Home >> Options >> Base Calculation Options >> Calculate Customer results)
  • if the model is still taking a long time to run, adjust the number of trials (reduce) and the damping limit (increase)
  • other changes might be done in the WaterGEMS model prior to upload in WaterSight that might lead to significant increases in performance. For more information on the other potential changes, take a look at this article - how to increase model performance in WaterGEMS

• water quality results: WaterSight can also display water quality results such as age and constituent analysis. In case of a constituent analysis the user needs to define the constituent properties and the concentration at the sources in the WaterGEMS model. More information about the workflow to set up age and constituent analysis in WaterGEMS, take a look here. For more detailed information about defining constituent properties in WaterGEMS, take a look at this article. Please note that to see water quality results in WaterSight the calculation type in WaterGEMS needs to be set to "Age, Constituent & Trace" as mentioned below. Also make sure to define a trace node in WaterGEMS (like for example a tank or Reservoir) otherwise the model will not run.

• Only one hydraulic model file is supported by digital twin, however in case the water utility has several model files of distinguish areas and pretends to upload into one single digital twin, it is possible to aggregate those into one single model file by using the Import submodels functionality of WaterGEMS. To do that open one of the WaterGEMS file, go to File >> Import >> Submodels and add the second SQlite file. Please note that in case there are errors while importing the submodel, most likely that both submodels have duplicated element labels. In that case make sure to rename pipes labels and/or junctions labels and/or other element labels. This can be quickly achieved using the relabel function available from the flex tables (when clicking with the right button of the mouse over the Label column header). Also make sure that, prior to merge the models, that in both models the demand alternative has the exactly same name, so that both can be considered. More information here.

Two submodels uploaded into WaterSight

WaterGEMS Model Setup

Required Settings

• If the WaterGEMS model contains more than one scenario, only the active scenario will be considered in WaterSight. Be sure the appropriate scenario is set as active and save the file prior to uploading.
• Update the calculation within WaterGEMS. Go to Home >> Options  and proccede with the following additional configurations:
  • Calculation Type: SCADAConnect Simulator
  • SCADA Calculation type: "Hydraulics only", if only running hydraulics; "Age, Constituent & Trace" if running both hydraulics and water quality analysis
  • Simulation mode: needs to be set to Historical

Figure 1 - Updating calculation options in the WaterGEMS prior uploading into WaterSight.

• Once done, make sure that the model successfully computes in WaterGEMS with no errors. If there are errors the user will need to fix those before uploading the model in WaterSight.

Recommended Settings - Set initial conditions for the model runs based on real measurements from sensors 

SCADA or other telemetry data can be used to set the initial conditions for the model run when they are correctly configured in the uploaded WaterGEMS model. More information here. 

SewerGEMS Model Setup

Required Settings

WaterSight can also support the upload of a Sewer Model from SewerGEMS. For that, it is required first to create a digital twin which type is water collection.

The required settings to upload a sewer model in WaterSight are the following:

• Update the calculation within WaterGEMS. Go to Home >> Options  >> Solver and choose as calculation type SCADA Connect Simulator
• Update the solver. Go to Home >> Options  >> Solver and choose as Active Numerical Solver the option Explicit (SWMM solver)
• On Storm data options, create a new empty Rain file and make sure to associate it with the Rainfall Runoff active alternative. This file will be automatically used by WaterSight to write the real rainfall conditions for the period of the run (WaterSight is directly connected to IBM Weather service).

Recommended Settings - Set initial conditions for the model runs based on real measurements from sensors 

In SewerGEMS (SWMM Solver) it is possible to connect junction and storage nodes such as Manholes, CSs, inlets, Wetwells, Ponds to import Initial Depth values. It also can import values of Initial Flow for Gravity Conduits/Channels, and Pump's Status, Relative Speed Factor. It's important to notice that values on Pollutant/Contaminant concentration from Sensors are not imported as initial conditions by default on SewerGEMS. Once configured in SewerGEMS (SCADA elements are created and associated with the model element), those can be supported in WaterSight. 

WaterSight Hydraulic Model Fields

Add Model

Click in the "Add" button (+) located on top to add a new hydraulic model.

Tips: Only one hydraulic model file is supported by digital twin however it is possible to aggregate several model files into one using the import submodel feature available in WaterGEMS. More information above, under General tips. To upload a new model file, it is strongly suggested to upload a ZIP extension (just including the sqlite extension) and to turn off and delete track changes

Once clicking "Add", a new row in the table will appear and the user can now upload and edit the configurations of the new model. For that, make sure to click on the row and edit the right side panel that will appear.

 

Delete Model

Click in the row and then click in the delete button to delete the entire hydraulic model. A new hydraulic model can then be uploaded again.

Note: It is also possible to reupload a new model without needing to delete the previous one - ideal workflow once the user wants to update a more recent model. For reupload of a new model just click on the first row and then in the right side panel press the upload Model button and upload the latest model.

Rebuild i-model

Whenever the hydraulic model is uploaded or re-uploaded with all the minimum requirements settings (see above) but there are issues with the visualization of the model in WaterSight, make sure to click on this button to force a complete rebuild of the model. There is no risk to loose any information by pressing in this button. 

Model Domain

Internal model ID generated by the system once the model is uploaded. 

Model Type 

Model input format. For now it is only possible to upload WaterGEMS models.

Spinup (h)

Time period at the start of a model run where the results are considered unstable and are not displayed. This is particularly important for model runs where initial inertia is important. For water supply models spinup this can be relevant when simulating water quality.  In most cases this value can be set to 0, as consecutive model runs use previous results to update initial settings.

Hindcast (h)

The Hindcast is a time period of time leading up to the current time where past model calculated results can be compared with historical sensor values. A hindcast period of 12-24 hours is useful for calibrating and validating a near-realtime hydraulic model, as well as in giving context to current and forecast conditions. If the model is configured with Control Overrides from SCADA sensors, a hindcast period can have accurate behavior of pump and valve setpoints even if logical controls have not been fully defined in the model. 

Forecast (h)

The time period into the future, starting from the current time, for which model results will be calculated. Note that the forecast period cannot take advantage of SCADA Control Overrides, so controls must be defined in the model which appropriately mimic both automated setpoints and typical manual adjustments to pump and valve operations. When first developing a near-realtime hydraulic model, it is often best to focus first on calibrating an accurate hindcast, and then refine controls to improve the forecast. 

Results of each model run are automatically saved in the Previous Simulations page. 

Run Frequency (h)

Define the automatic run frequency of the model. For example if 1 hour is defined, this means that the model will automatically run every hour. 

Demand Adjustment

Select the demand adjustment options that will be automatically applied by WaterSight:

No Update: 

This means that  WaterSight will use the same exact demand values defined in the WaterGEMS uploaded model, including all base demands and unit demands, demand multipliers (patterns) and other demand adjustments defined by the user. 

Update Demand & Patterns (Global):

WaterSight will automatically compute a global pattern for the entire system, and will automatically apply this global pattern to all nodes of the network. The total demand for each node is obtained by adding up all base demands and unit demands (unit demands multiplied by number of units) defined in the WaterGEMS model and then by multiplying this final node demand by the global pattern automatically computed by WaterSight. 

Update Demand & Patterns (Zone-by-Zone)

WaterSight will automatically compute a pattern for each zone (according to each zone defined in the Zones configuration page), and will automatically apply each zone pattern to the nodes belonging to the respective zone.

Mere detailed information can  be found here - Automatic Demand Adjustment.

Smart meter Demand Adjustment

In case AMI data is available for the Large Customers, WaterSight can use that data to automatically update the patterns for those specific customer meters in the model and a remainder flow pattern - given by the difference of the total zone flow and the sum of all large customers flow - will be applied to the rest of all customers of the model that are within the zone. More information can be found here - AMI for Hydraulic Model.  

HGL Adjustment

Note: This option only becomes available (with the HGL signals to select) after the first upload of the model.

Enable or disable Hydraulic Grade adjustment for each reservoir model element. This feature is particularly useful when using hydraulic models of distribution systems that do not cover the transmission line.

Hydraulic models of distribution systems commonly have reservoirs elements representing DMA's inflow node (such as storage tanks). In that case, model's scope doesn´t cover the transmission line of the network that feeds the DMA, and usually a virtual reservoir is placed as starting point.

Whenever this happens, and instead of assuming a fixed hydraulic grade for the reservoir for the all period of the simulation run (corresponding for example to simulate the tank always full or always with an average level), WaterSight can forecast the real level of the tank and based on that calculate a pattern that can be applied to any reservoir model element in order to simulate the correct pressure levels at the boundary condition, for the all period of the run (and not only as initial conditions). 

In order to be able to enable or disable HGL adjustment for each reservoir, it is required that the hydraulic model contains at least one reservoir as model element with an associated hydraulic grade signal. The hydraulic grade signal needs to be created/added both on the WaterGEMS file and also uploaded in WaterSight, through sensor administration. For more detailed information on the specific steps to set up this, please take a look at this article  - Automatic Hydraulic Grade Adjustment.

Please note that the real-world upstream element may not be a tank, it may just be a pipe that connects a complicated upstream network that is not part of the model. So the real-world sensor might be a level, or it might be a pressure, or it might even already be an HGL. For all those cases, this feature can be applied, following the steps mentioned here - Automatic Hydraulic Grade Adjustment.

Active

Turn the model active or inactive. If inactive, the hydraulic model will not appear in WaterSight and the Modeling section will not be available.  

Valve Display

Display GPV as

In case user uses GPV valves in the WaterGEMS model file, those can be considered in WaterSight as Isolation Valve (default) or as Control Valve. In case they are considered as Isolation Valve, they will appear in the Current Simulation page under the Isolation valve group dropdown. In case they are considered as Control Valve, they will appear under the Control Valve group dropdown. 

Display TCV as

In case user uses TCV valves in the WaterGEMS model file, those can be considered in WaterSight as Isolation Valve (default) or as Control Valve. In case they are considered as Isolation Valve, they will appear in the Current Simulation page under the Isolation valve group dropdown. In case they are considered as Control Valve, they will appear under the Control Valve group dropdown. 

Allow valve status update through API

Making sure that valve status in WaterSight are updated is very important to achieve good confidence on the model results. With WaterSight it is possible to directly and automatically update valve status for example based on the latest GIS information, through an API. For more information, please contact your Bentley technical support person.

Upload

Click here to directly upload a WaterGEMS model - can be sqlite file or ZIP file extension. To assure a fastest upload, it is strongly suggested to use the ZIP extension (just including the sqlite extension) and to turn off and delete track changes in the WaterGEMS model. The upload Model button should also be used for further reuploads of the hydraulic model.

Once uploading a model, it will also request to define the EPS Code:

EPSG code

EPSG (European Petroleum Survey Group) code of the WaterGEMS model. This is required in order to have the model displayed in the correct position in the map. In most cases, the EPSG code or a description of the coordinate system can be found by examining the layer properties in any GIS software. Note that each layer may have different coordinate systems if the utility has not standardized to a single system. EPSG codes can be found by searching https://spatialreference.org/. 

In case there is an error during the model upload process or in case the model is based on an ESRI code (instead of EPSG code), the user has the possibility to define the WKT (well-known-text) for that specific EPSG / ESRI code that is not supported. For more information click here.

After defining a EPSG code, to change it again the user will need to reupload again a hydraulic model.

Styles

Manage the colour coding configuration for the model. More information here.

 

 

See Also

Current Simulation page

Imposing Initial Conditions from Sensors to the Model

Automatic Demand Adjustment

AMI for Hydraulic Model

Automatic Hydraulic Grade Adjustment

OpenFlows WaterSight TechNotes and FAQ's

Error Uploading model due to a not supported EPSG/ESRI Code

WaterSight Learning Resources Guide