Water Module theory: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
No edit summary
Tag: Manual revert
 
(55 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Water Module buttons}}
The following topics are described on this page:
The following topics are described on this page:
* Introduction to the Water Module Theory
* {{inlink|Introduction to the Water Module Theory}}
* Calculation modules
* [[#Calculation Models|Calculation modules]] {{inlink|Calculation Models}}
* Theories and formulas  
* [[#Formulas|Theories and formulas ]]
* Computational structure and sequences
* [[#Calculation related information|Computational structure and sequences]]
* [[Water Model Limits]] (some basic rules)


===Introduction to the Water Module Theory ===
===Introduction to the Water Module Theory ===
The [[Water Module]] in the {{software}} is an implementation of a 2D grid based shallow water model based on the 2D Saint Venant equations (see [[Surface_water_model_(Water_Overlay)|Surface Water Model]]). The module is further enhanced with infiltration, evaporation, groundwater flow and hydraulic structures.<br>
<br>


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


[[File:Rainfall overlay 05.PNG|600px|center]]
To perform the calculations, the project area is first rasterized into a [[Grid overlay|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 [[Timestep formula (Water Overlay)|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|testbed water module]] project, available in all domains, to see some of the components of the [[Water Module]] in a project.
[[File:Rainfall overlay 04.PNG|600px|center]]
 
<br>
To perform the calculations, the project area is divided into a [[Grid overlay|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 [[Timestep formula (Water Overlay)|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|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 [[Water module benchmarks|benchmarks and tests]]. Fast results are achieved by executing the water calculations on High performance GPU servers.


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 [[Water module benchmarks|benchmarks and tests]]. Fast results are achieved by executing the water calculations on High performance GPU servers.
<gallery widths=500px heights=300px>
File:Water_module_layers.jpeg|Supported layers in rain, flooding and ground water calculations.
File:Water_module_flows.jpeg|Supported flows between the layers in rain, flooding and ground water calculations.
</gallery>


===Calculation Models===
===Calculation Models===
Line 23: Line 25:


Multiple models are implemented which in conjunction form the water model in its entirety.
Multiple models are implemented which in conjunction form the water model in its entirety.
<div style="column-count:2">
* [[Surface model (Water Overlay)]]
* [[Ground model (Water Overlay)]]
* [[Elevation model (Water Overlay)]]
* [[Rain model (Water Overlay)]]
* [[Infiltration model (Water Overlay)]]
* [[Evaporation model (Water Overlay)]]
* [[Storage model (Water Overlay)]]
* [[Sewer model (Water Overlay)]]
* [[Tracer flow model (Water_Overlay)]]
* [[Border model (Water Overlay)]]
* [[Breach model (Water Overlay)]]
</div>


* [[Surface_model_(Water_Overlay)|Surface model]]
===Formulas===
* [[Underground_model_(Water_Overlay)|Underground model]]
* [[Rain_model_(Water_Overlay)|Rain model]]
* [[Evaporation model (Water Overlay)|Evaporation model]]
* [[Sewer_model_(Water_Overlay)|Sewer model]]
* [[Storage_model_(Water_Overlay)| Storage model]]
* [[Substance_flow_model_(Water_Overlay)|Substance flow model]]
* [[Border_model_(Water_Overlay)|Border model]]
 
====Model connections====
To gain insight into how this Water Overlay ties together several models, see [[Model_connections_(Water_Overlay)|Model connections]].
 
====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.
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====
* [[Surface_water_level_formula_(Water_Overlay)|Surface water level formula]]
<div style="column-count:2">
* [[Groundwater_level_formula_(Water_Overlay)|Groundwater level formula]]
* [[Surface water level formula (Water Overlay)]]
* [[Surface_flow_formula_(Water_Overlay)|Surface flow formula]]
* [[Surface flow formula (Water Overlay)]]
* [[Underground_flow_formula_(Water_Overlay)|Underground flow formula]]
* [[Surface infiltration formula (Water Overlay)]]
* [[Surface_evaporation_formula_(Water_Overlay)|Surface evaporation formula]]
* [[Surface evaporation formula (Water Overlay)]]
* [[Underground_evaporation_formula_(Water_Overlay)|Underground evaporation formula]]
* [[Groundwater level formula (Water Overlay)]]
* [[Surface_infiltration_formula_(Water_Overlay)|Surface infiltration formula]]
* [[Ground flow formula (Water Overlay)]]
* [[Underground_infiltration_formula_(Water_Overlay)|Underground infiltration formula]]
* [[Ground infiltration formula (Water Overlay)]]
* [[Ground evaporation formula (Water Overlay)]]
* [[Ground bottom flow formula (Water Overlay)]]
</div>


Hydraulic structure related Formula's:
====Hydraulic structure related formulas====
* [[Culvert_formula_(Water_Overlay)|Culvert formula]]
<div style="column-count:2">
* [[Weir_formula_(Water_Overlay)|Weir formula]]
* {{linkappend  |postd=&nbsp;formula  |post=&nbsp;formula (Water Overlay) | Culvert         }}
* [[Breach_growth_formula_(Water_Overlay)|Breach growth formula]]
* {{linkappend  |postd=&nbsp;formula  |post=&nbsp;formula (Water Overlay) | Weir           }}
* [[Breach_flow_formula_(Water_Overlay)|Breach flow formula]]
* {{linkappend  |postd=&nbsp;formula  |post=&nbsp;formula (Water Overlay) | Breach growth   }}
* [[Pump_formula_(Water_Overlay)|Pump formula]]
* {{linkappend  |postd=&nbsp;formula  |post=&nbsp;formula (Water Overlay) | Breach flow     }}
* [[Sewer_Overflow_formula_(Water_Overlay)|Sewer Overflow formula]]
* {{linkappend  |postd=&nbsp;formula  |post=&nbsp;formula (Water Overlay) | Pump           }}
* [[Inlet_formula_(Water_Overlay)|Inlet formula]]
* {{linkappend  |postd=&nbsp;formula  |post=&nbsp;formula (Water Overlay) | Sewer Overflow }}
* {{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====
* [[Timestep_formula_(Water_Overlay)|Timestep formula]]
* [[Timestep formula (Water Overlay)]]
* [[Calculation_preference_formula_(Water_Overlay)|Calculation preference formula]]
* [[Season formula (Water Overlay)]]


Calculations are performed in a specific [[order_of_calculations_(Water_Overlay)|order]]:
====Calculation related information====
* [[Order of calculations (Water Overlay)|Order of calculations]]


{{Water Module buttons}}
{{WaterOverlay formula nav}}

Latest revision as of 12:36, 5 March 2024

Benchmarks button.png
Introduction button.png
Water Module
Benchmarks button.png
Getting started button.png
Tutorials
Benchmarks button.png
Overview button.png
Overview
Benchmarks button.png
Theory button.png
Theory
Benchmarks button.png
Benchmarks button.png
Benchmarks


The following topics are described on this page:

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

Water Module
Benchmarks button.png
Introduction button.png
Water Module
Benchmarks button.png
Getting started button.png
Tutorials
Benchmarks button.png
Overview button.png
Overview
Benchmarks button.png
Theory button.png
Theory
Benchmarks button.png
Benchmarks button.png
Benchmarks
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
Retrieved from "https://support.tygron.com/w/index.php?title=Water_Module_theory&oldid=60092"