Water Overlay: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
(48 intermediate revisions by 5 users not shown)
Line 1: Line 1:
A water [[Overlay|overlay]] is an implementation of a number of hydrological formulas which together can simulate the flow of water across large areas with a high level of detail. These formulas combined form the model that is part of the [[Water Module]] in the Tygron Platform. Its calculations form a simulation of an arbitrary amount of time, during which water is allowed to move.
A Water Overlay is an [[Overlay|overlay]] for which results are calculated by the [[Water Module]]. The [[Water_Module_Basics|Basic theory of the Water Module]] in the {{software}} is an implementation of a 2D grid based shallow water model based on the 2D Saint Venant equations. The module is further enhanced with infiltration, evaporation, groundwater flow and hydraulic structures. Its calculations form a simulation of an arbitrary amount of time, during which water is allowed to move. The [[Water_Module_Theory|theory]] section describes in detail how calculations are performed.


Water flow is affected by properties of the surface across which it flows, including the [[terrain height]] and the properties of the underlying [[terrain]].
To perform the calculations, the project area is divided into a [[Grid overlay|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 its 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.


To perform the calculations, the project area is divided into a [[Grid overlay|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, every cell communicates with all adjacent cells to exchange water. By dividing the project area and simulation time into sufficiently small cells and steps the behavior becomes effective continuous.
The final results of the calculation can be inspected, as well as intermediate snapshots of the hydrological situation during the simulation, known as [[Timeframes model attribute (Water Overlay)|timeframes]].


The final results of the calculation can be inspected, as well as snapshots of the hydrological situation in the simulation, known as [[Timeframes model attribute (Water Overlay)|timeframes]].
==Variants==
 
The Water Module can be called upon by adding one of the following Overlays to a project. Each variant has a number of parameters tuned to best fit specific use-cases. This means that each of these overlays is based on the same theory and calculation method, however they are customized to conveniently provide insight in different aspects of the Water Module.  
==Different water overlays==
{| class="wikitable"
The water module can be called upon by adding one of the following overlays to a project. Each variant has a number of parameters tuned to best fit specific use-cases.
|[[File:Overlay_rainfall.png]]
 
|[[Rainfall_(Overlay)|Rainfall Overlay]]
[[File: Rainfall-Overlay.jpg|thumb|100px|link=Rainfall_(Overlay)|Rainfall Overlay]]<br>
|provides insight into the water stress and impact caused by (excessive) rainfall
:<code>[[Rainfall_(Overlay)|'''Rainfall Overlay''']]</code>: provides insight into the water stress and impact caused by (excessive) rainfall.<br>
|-
:<code>[[Flooding_(Overlay)|'''Flooding Overlay''']]</code>: provides insight into water stress and impact caused by breaches in levees or other sources causing excessive water inflow.<br>
|[[File:Overlay_flooding.png]]
:<code>[[Groundwater_(Overlay)|'''Groundwater Overlay''']]</code>: provides insight into long-term processes of water flow both on the surface and underground.<br>
|[[Flooding_(Overlay)|Flooding Overlay]]
|provides insight into water stress and impact caused by breaches in levees or other sources causing excessive water inflow
|-
||[[File:Overlay_groundwater.png]]
|[[Groundwater_(Overlay)|Groundwater Overlay]]
|provides insight into long-term processes of water flow both on the surface and underground  
|}
<!--==Input Data and Settings==
<!--==Input Data and Settings==
The calculations performed by the water overlay are influenced by many kinds of geographical information present in the project area. For any given location, [[terrain]], [[construction]]s and other features can influence either the initial state of the simulation or how water flows in a given area.
The calculations performed by the Water Overlay are influenced by many kinds of geographical information present in the project area. For any given location, [[terrain]], [[construction]]s and other features can influence either the initial state of the simulation or how water flows in a given area.


Furthermore, the water overlay features a number of overall settings which can be configured for the hydrological calculations and its results. These settings do not have a geographical or temporal element to them, and are fixed values relevant for the simulation as a whole.
Furthermore, the Water Overlay features a number of overall settings which can be configured for the hydrological calculations and its results. These settings do not have a geographical or temporal element to them, and are fixed values relevant for the simulation as a whole.


;[[Hydrologic_features_(Water_Overlay)|Hydological features]]
;[[Hydrologic_features_(Water_Overlay)|Hydrological features]]
:The water system can be enhanced with a number of hydrological features, which can be loaded in as [[area]]s. These hydrological features form special properties or modifications on the hydrological system. See [[Hydrologic_features_(Water_Overlay)|Hydological features]] for a list of supported features.
:The water system can be enhanced with a number of hydrological features, which can be loaded in as [[area]]s. These hydrological features form special properties or modifications on the hydrological system. See [[Hydrologic_features_(Water_Overlay)|Hydological features]] for a list of supported features.
;[[Hydraulic structures (Water Overlay)|Hydraulic structures]]
;[[Hydraulic structures (Water Overlay)|Hydraulic structures]]
Line 31: Line 37:


==Troubleshoot, warnings and recommendations==
==Troubleshoot, warnings and recommendations==
When the water overlay is used and calculations take place, there are some problems or points of attention the calculation can run into. Where possible, the water overlay will show appropriate warnings when running into any issues.
When the Water Overlay is used and calculations take place, there are some problems or points of attention the calculation can run into. Where possible, the Water Overlay will show appropriate warnings when running into any issues.
See [[Warning_and_recommendations_(Water_Overlay)|Troubleshoot, warnings and recommendations]];
See [[Warning_and_recommendations_(Water_Overlay)|Troubleshoot, warnings and recommendations]];
-->
-->


==Results==
==Results==
A water overlay generates different results. For further information about these outcomes, see also [[Results_(Water_Overlay)|results]] and [[Result type (Water Overlay)|result types]].
With a Water Overlay, one can generate different kinds of results. For further information about these outcomes, see also [[Results_(Water_Overlay)|results]] and [[Result type (Water Overlay)|result types]].


==How-to's==
==How-to's==
Line 43: Line 49:
* [[How-to use a Water Overlay|Use a Water Overlay]]
* [[How-to use a Water Overlay|Use a Water Overlay]]
* [[How-to edit an overlay legend|Edit an overlay legend]]
* [[How-to edit an overlay legend|Edit an overlay legend]]
* [[How-to_add_Subsidence_Overlay|Combine with Subsidence Overlay]]
* [[How to add Subsidence (Water Overlay)|Combine with Subsidence Overlay]]
 
==Quick overview==
===Features and components===
* [[Hydrological features (Water Overlay)|Hydrological features]]
* [[Hydraulic structures (Water Overlay)|Hydraulic structures]]
* [[How-to_manually_configure_a_Water_Overlay|Manual configuration Options]]
* [[Simulation data (Water Overlay)|Simulation data]]
 
===Attributes===
* [[Model attributes (Water Overlay)|Water Module Attributes]]<br>
* [[Hydrological attributes of constructions (Water Overlay)|Hydrological Attributes of Constructions]]<br>
* [[Hydrological attributes of terrains (Water Overlay)|Hydrological Attributes of Terrains]]<br>


[[Category:Water Module]]
{{Water Module buttons}}
{{Template:Overlay nav}}
{{Template:Overlay nav}}

Revision as of 07:14, 17 June 2019

A Water Overlay is an overlay for which results are calculated by the Water Module. The Basic theory of 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. The module is further enhanced with infiltration, evaporation, groundwater flow and hydraulic structures. Its calculations form a simulation of an arbitrary amount of time, during which water is allowed to move. The theory section describes in detail how calculations are performed.

To perform the calculations, the project area is divided into a 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 its 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.

The final results of the calculation can be inspected, as well as intermediate snapshots of the hydrological situation during the simulation, known as timeframes.

Variants

The Water Module can be called upon by adding one of the following Overlays to a project. Each variant has a number of parameters tuned to best fit specific use-cases. This means that each of these overlays is based on the same theory and calculation method, however they are customized to conveniently provide insight in different aspects of the Water Module.

Overlay rainfall.png Rainfall Overlay provides insight into the water stress and impact caused by (excessive) rainfall
Overlay flooding.png Flooding Overlay provides insight into water stress and impact caused by breaches in levees or other sources causing excessive water inflow
Overlay groundwater.png Groundwater Overlay provides insight into long-term processes of water flow both on the surface and underground

Results

With a Water Overlay, one can generate different kinds of results. For further information about these outcomes, see also results and result types.

How-to's

Quick overview

Features and components

Attributes