Water Module theory: Difference between revisions

Latest revision as of 12:36, 5 March 2024

Water Module

Tutorials

Overview

Theory

Benchmarks

The following topics are described on this page:

Introduction to the Water Module Theory
Calculation modules Calculation Models
Theories and formulas
Computational structure and sequences
Water Model Limits (some basic rules)

Introduction to the Water Module Theory

The Water Module in the Tygron Platform is an implementation of a 2D grid based shallow water model, based on the 2D Saint Venant equations (see Surface Model). The module is further enhanced with infiltration, evaporation, groundwater flow and hydraulic structures.

To perform the calculations, the project area is first rasterized into a large grid of cells. Each cell has a specific quantity of water and specific hydrological parameters based on the data in the project. The total time which should be simulated is divided into discrete timesteps. Per timestep, each cell communicates with its adjacent cells to exchange water, based on it's water level, surface height, current flow direction and other factors. Accuracy and reliability is obtained by dividing the project area and simulation time into sufficiently small cells and steps, at the cost of more computation time. Take a look at the testbed water module project, available in all domains, to see some of the components of the Water Module in a project.

The Water Module enables users to implement a water model for their project which is accurate and delivers fast results. To ensure accuracy, the Water Module is repeatedly tested against multiple (internationally) acknowledged hydrological benchmarks and tests. Fast results are achieved by executing the water calculations on High performance GPU servers.

Supported layers in rain, flooding and ground water calculations.
Supported flows between the layers in rain, flooding and ground water calculations.

Calculation Models

The Water Module performs a large number of calculations to form a complete hydrological simulation. Depending on the desired viewpoint, both the overarching concepts as well as the implemented formulas can be reviewed for detailed insight into how the water overlay works.

Multiple models are implemented which in conjunction form the water model in its entirety.

Formulas

The precise calculations which govern the water overlay's simulation are many and varied, and based as much as possible on available expert knowledge.

Model flow formulas

Hydraulic structure related formulas

Module related formulas

Calculation related information

Order of calculations

Models

Surface • Ground • Rain • Evaporation • Infiltration • Elevation • Breach • Sewer • Storage • Tracer flow • Border • Order
Model formulas

Timestep • Season • Surface water level • Groundwater level
Flow formulas

Surface flow • Surface infiltration • Ground flow • Ground infiltration • Surface evaporation • Ground evaporation • Ground bottom flow
Hydraulic structure formulas

Culvert • Weir • Breach growth • Breach flow • Pump • Sewer Overflow • Inlet • Drainage
Related

Building attributes • Hydrological features • Hydraulic structures • Terrain attributes • Model attributes • Results • Simulation data

@@ Line 1: / Line 1: @@
-{{stub|todo=
-* Find cleaner way to show overview of pictures, rather than screen-filling images with small text.
-* Leverage Table of Contents for list of content
-}}
 {{Water Module buttons}}
@@ Line 30: / Line 25: @@
 Multiple models are implemented which in conjunction form the water model in its entirety.
-<div style="column-count:3">
+<div style="column-count:2">
-* [[Surface model (Water Overlay)|Surface model]]
+* [[Surface model (Water Overlay)]]
-* [[Ground_model (Water Overlay)|Ground model]]
+* [[Ground model (Water Overlay)]]
-* [[Elevation model (Water Overlay)|Elevation model]]
+* [[Elevation model (Water Overlay)]]
-* [[Rain model (Water Overlay)|Rain model]]
+* [[Rain model (Water Overlay)]]
-* [[Infiltration model (Water Overlay)|Infiltration model]]
+* [[Infiltration model (Water Overlay)]]
-* [[Evaporation model (Water Overlay)|Evaporation model]]
+* [[Evaporation model (Water Overlay)]]
-* [[Storage_model (Water Overlay)| Storage model]]
+* [[Storage model (Water Overlay)]]
-* [[Sewer model (Water Overlay)|Sewer model]]
+* [[Sewer model (Water Overlay)]]
-* [[Tracer flow model (Water_Overlay)|Tracer flow model]]
+* [[Tracer flow model (Water_Overlay)]]
-* [[Border model (Water Overlay)|Border model]]
+* [[Border model (Water Overlay)]]
-* [[Breach model (Water Overlay)|Breach model]]
+* [[Breach model (Water Overlay)]]
 </div>
@@ Line 47: / Line 42: @@
 The precise calculations which govern the water overlay's simulation are many and varied, and based as much as possible on available expert knowledge.
-====Model related formula's====
+====Model flow formulas====
 <div style="column-count:2">
 * [[Surface water level formula (Water Overlay)]]
@@ Line 60: / Line 55: @@
 </div>
-====Hydraulic structure related formula's====
+====Hydraulic structure related formulas====
+<div style="column-count:2">
 * {{linkappend  |postd=&nbsp;formula  |post=&nbsp;formula (Water Overlay) | Culvert         }}
 * {{linkappend  |postd=&nbsp;formula  |post=&nbsp;formula (Water Overlay) | Weir            }}
@@ Line 69: / Line 65: @@
 * {{linkappend  |postd=&nbsp;formula  |post=&nbsp;formula (Water Overlay) | Inlet           }}
 * {{linkappend  |postd=&nbsp;formula  |post=&nbsp;formula (Water Overlay) | Drainage        }}
+</div>
-====Module related formula's====
+====Module related formulas====
-* [[Surface water level formula (Water Overlay)]]
-* [[Groundwater level formula (Water Overlay)]]
 * [[Timestep formula (Water Overlay)]]
 * [[Season formula (Water Overlay)]]