Water Overlay: Difference between revisions
No edit summary |
|||
(39 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
A Water Overlay is | A Water Overlay is a [[Grid Overlay|grid 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. Depending on the use case, the simulated period can be set to few seconds and up to a few months. The [[Water_Module_Theory|theory]] section describes in detail how calculations are performed. | ||
__NOTOC__ | |||
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, 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 | The final results of the calculation can be inspected, as well as intermediate snapshots of the hydrological situation during the simulation, known as [[Timeframes (Water Overlay)|timeframes]]. | ||
==Variants== | ==Variants== | ||
A Water Module will be initialized 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. | |||
{| class="wikitable" | {| class="wikitable" | ||
|[[File:Overlay_rainfall.png]] | |[[File:Overlay_rainfall.png]] | ||
Line 31: | Line 29: | ||
;[[Hydraulic structures (Water Overlay)|Hydraulic structures]] | ;[[Hydraulic structures (Water Overlay)|Hydraulic structures]] | ||
:See [[Hydraulic structures (Water Overlay)|Hydraulic structures]] for the list of supported structures. | :See [[Hydraulic structures (Water Overlay)|Hydraulic structures]] for the list of supported structures. | ||
;[[ | ;[[Additional_hydrological_attributes_of_buildings_(Water Overlay)|Hydrological attributes of buildings]] | ||
:Besides the [[ | :Besides the [[building]]s which directly influence the hydrologic model as a [[Hydraulic structures (Water Overlay)|hydraulic structure]], each building may also have attributes which can contribute to the hydrological model in some way. These attributes are stored and used on a grid cell level. This is different from the hydraulic structure attributes, which are stored and used on an object level. For a full list, see [[Additional_hydrological_attributes_of_buildings_(Water Overlay)|Additional hydrological attributes of buildings]]. | ||
;[[Terrain_attributes_(Water_Overlay)| Hydrological attributes of terrain]] | ;[[Terrain_attributes_(Water_Overlay)| Hydrological attributes of terrain]] | ||
:[[Terrain]]s in a project have a number of hydrological attributes which can influence the flow of water in a project. Because there is always both surface and underground terrain defined for the entirety of the project area, all cells are affected by all attributes of terrains, unless a | :[[Terrain]]s in a project have a number of hydrological attributes which can influence the flow of water in a project. Because there is always both surface and underground terrain defined for the entirety of the project area, all cells are affected by all attributes of terrains, unless a building is present with overwriting values. For a full list, see [[Terrain_attributes_(Water_Overlay)| Terrain attributes for the water overlay]]. | ||
;[[Model_attributes_(Water_Overlay)|Model settings]] | ;[[Model_attributes_(Water_Overlay)|Model settings]] | ||
:For a full list, see: [[Model_attributes_(Water_Overlay)|Water Model attributes]] | :For a full list, see: [[Model_attributes_(Water_Overlay)|Water Model attributes]] | ||
Line 44: | Line 42: | ||
==Results== | ==Results== | ||
With a Water Overlay, | With a Water Overlay, a user can generate multiple [[Results_(Water_Overlay)|results]] for a single water simulation. 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== | ||
* [[How | * [[How to add and remove an Overlay]] | ||
* [[How | * [[How to manually configure a Water Overlay|Configure a Water Overlay]] | ||
* [[How | * [[How to edit an overlay legend|Edit an overlay legend]] | ||
* [[How to add Subsidence (Water Overlay)|Combine with Subsidence Overlay]] | |||
* [[How | * [[Water Model Limits]] (some basic rules) | ||
===Features and components=== | ===Features and components=== | ||
[[Hydrological features (Water Overlay)|Hydrological features]] | * [[Hydrological features (Water Overlay)|Hydrological features]] | ||
[[Hydraulic structures (Water Overlay)|Hydraulic structures]] | * [[Hydraulic structures (Water Overlay)|Hydraulic structures]] | ||
* [[How to_manually_configure_a_Water_Overlay|Manual configuration Options]] | |||
* [[Simulation data (Water Overlay)|Simulation data]] | |||
===Attributes=== | ===Attributes=== | ||
[[Model attributes (Water Overlay)|Water Module Attributes]] | * [[Model attributes (Water Overlay)|Water Module Attributes]] | ||
[[Hydrological attributes of | * [[Hydrological attributes of buildings (Water Overlay)|Hydrological Attributes of Buildings]] | ||
[[ | * [[Hydrological attributes of terrains (Water Overlay)|Hydrological Attributes of Terrains]] | ||
{{WaterOverlay output nav}} | |||
{{Overlay nav}} | |||
[[Category:Water Module]][[Category:Overlays with result types]] |
Latest revision as of 13:40, 17 January 2023
A Water Overlay is a grid 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. Depending on the use case, the simulated period can be set to few seconds and up to a few months. 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
A Water Module will be initialized 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.
Rainfall Overlay | provides insight into the water stress and impact caused by (excessive) rainfall | |
Flooding Overlay | provides insight into water stress and impact caused by breaches in levees or other sources causing excessive water inflow | |
Groundwater Overlay | provides insight into long-term processes of water flow both on the surface and underground |
Results
With a Water Overlay, a user can generate multiple results for a single water simulation. For further information about these outcomes, see also results and result types.
How-to's
- How to add and remove an Overlay
- Configure a Water Overlay
- Edit an overlay legend
- Combine with Subsidence Overlay
- Water Model Limits (some basic rules)