Surface model (Water Overlay): Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 13: Line 13:


[[File:Waterlevel_schematic.png|right|x200px|frame|B = surface elevation of grid cell<br>h = water height of grid cell<br>w = water level of grid cell.]]
[[File:Waterlevel_schematic.png|right|x200px|frame|B = surface elevation of grid cell<br>h = water height of grid cell<br>w = water level of grid cell.]]
The implemented method rewrites the '''h''' from the original Saint-Venant system to <code>w = h + z</code>. See the following image for clarification on the terms water level, surface (or bottom) elevation and water height:
The implemented method rewrites the '''h''' from the original Saint-Venant system to <code>w = h + z</code>. See the image on the right for clarification on the terms water level, surface (or bottom) elevation and water height.
 
Based on variations in the surface elevation and water levels, which may cause unbalance, water will start flowing, until it eventually is balanced in terms of water level and fluxes ''hu'' and ''hv''.
 
<br style="clear:right">
<br style="clear:right">


===Surface water level initialization===
===Surface water level initialization===
The surface water level is initialized based on hydrological features present in the project. For all [[Water (Terrain) (Water Overlay)|water terrains]], water is placed on the surface of the world. The amount of water placed is such that the resulting water level in that location is equal to the [[Water level (Water Overlay)|WATER_LEVEL]] attribute of the [[Water level area (Water Overlay)|Water level area]] in that location. If there is no water level area in that location, the water level is assumed to be so low that no water is created. Besides the water level areas, [[Inundation(Overlay)|Inundation]] is added to the model. Water is placed in all locations where inundation is defined (regardless of the terrain type in that location, in contrast to the water level areas), such that the resulting height of the water inundating the land is equal to the inundation area's [[Inundation level (Water Overlay)|INUNDATION_LEVEL]] attribute.
In theory, each grid cell can have a unique water level and accompanying water height. In practice though, water levels are often initialized for large groups of cells, since it is assumed that a particular area within the project area has a given water level. Therefore, the surface water level is initialized based on hydrological features present.  
 
After the surface is initialized with water, all water on the surface will flow in accordance with the same rules. It does not matter whether the water was created when the model was initialized, and whether that water was due to a water terrain or due to inundation, or whether the water came in from another source.


On the surface, water can flow from one cell to an adjacent cell based on the relative heights of the water, the slope of the terrain, and the manning value of the terrain or construction in that location.
Beforehand, we make the following distinction: water levels of water terrains and potential water levels for inundated land.  


In addition to water flowing between geographically adjacent cells, water can also flow through hydrological constructions. When a [[Hydrological constructions (Water Overlay)|line-based hydrological construction]] exists in the project area, the 2 cells indicated by the endpoints of the line are considered adjacent as well. Flow between those cells is not dictated by the same parameters as the regular surface flow. Instead, water can flow between the 2 indicated cells based on the construction's underlying formula.
For all [[Water (Terrain) (Water Overlay)|water terrains]], the amount of water set on the grid cell is such that the resulting water level in that location is equal to the [[Water level (Water Overlay)|WATER_LEVEL]] attribute provided by the [[Water level area (Water Overlay)|Water level area]]. If no water level area is overlapping that grid cell, or the water level is below the surface elevation of the grid cell, the water height is assumed to be 0 and the water level equal to the surface elevation.


Water can also be added to or removed from the water model by [[Hydrological constructions (Water Overlay)|point-based hydrological constructions]]. Based on the construction's underlying formula water can be added or removed to the cell indicated by the construction. Only that single cell will receive or lose the calculated amount of water.
For the second case, [[Inundation(Overlay)|Inundation areas]] have been added to the model. Water is placed in all grid cells which are covered by an inundated area, (regardless of the terrain type in that location, in contrast to the water level areas), such that the resulting water level is again equal to the inundation area's [[Inundation level (Water Overlay)|INUNDATION_LEVEL]] attribute. If no inundation area is overlapping that grid cell, or the water level is below the surface elevation of the grid cell, the water height is assumed to be 0 and the water level equal to the surface elevation.


Water can also be removed from the surface by [[Miscellaneous hydrological properties of constructions (Water Overlay)|other properties]] of constructions, based on the construction's polygons (either moving it to another part of the hydrological model, or removing it completely from the hydorlogical model). When water is removed from the surface via a polygon-based construction, the removal of water is calculated per individual cell.
==Notes==
* Water can be added to and removed from the described ''surface system'' by Rain, Evaporation, Infiltration, certain Hydraulic structures and Breaches.
* Underground flow uses a different flow system and formula's, described in [[Underground_model_(Water_Overlay)|Underground model]].
* In addition to water flowing between adjacent grid cells, water can also flow through hydraulic constructions. This is described in [[Hydraulic structures (Water Overlay)|Hydraulic structures]].


==References==
==References==

Revision as of 12:37, 11 April 2019

The Water Module's primary function is the simulation of the 2-dimensional flow of water on the surface. In order to simulate flowing water, the project area is discretized into x by y cells, based on the configured grid cell size.

Secondly a model is required which describes the rules that need to be followed. For this we use the two-dimensional Saint-Venant system, which reads:

2D-Saint-Venant system.png



In the Tygron Platform this model is implemented using the Well Balanced Positivity Preserving Central-Upwind Scheme described in Kurganov and Petrova (2007)[1]. For more information about the implementation, see Surface flow formula.

B = surface elevation of grid cell
h = water height of grid cell
w = water level of grid cell.

The implemented method rewrites the h from the original Saint-Venant system to w = h + z. See the image on the right for clarification on the terms water level, surface (or bottom) elevation and water height.

Based on variations in the surface elevation and water levels, which may cause unbalance, water will start flowing, until it eventually is balanced in terms of water level and fluxes hu and hv.


Surface water level initialization

In theory, each grid cell can have a unique water level and accompanying water height. In practice though, water levels are often initialized for large groups of cells, since it is assumed that a particular area within the project area has a given water level. Therefore, the surface water level is initialized based on hydrological features present.

Beforehand, we make the following distinction: water levels of water terrains and potential water levels for inundated land.

For all water terrains, the amount of water set on the grid cell is such that the resulting water level in that location is equal to the WATER_LEVEL attribute provided by the Water level area. If no water level area is overlapping that grid cell, or the water level is below the surface elevation of the grid cell, the water height is assumed to be 0 and the water level equal to the surface elevation.

For the second case, Inundation areas have been added to the model. Water is placed in all grid cells which are covered by an inundated area, (regardless of the terrain type in that location, in contrast to the water level areas), such that the resulting water level is again equal to the inundation area's INUNDATION_LEVEL attribute. If no inundation area is overlapping that grid cell, or the water level is below the surface elevation of the grid cell, the water height is assumed to be 0 and the water level equal to the surface elevation.

Notes

  • Water can be added to and removed from the described surface system by Rain, Evaporation, Infiltration, certain Hydraulic structures and Breaches.
  • Underground flow uses a different flow system and formula's, described in Underground model.
  • In addition to water flowing between adjacent grid cells, water can also flow through hydraulic constructions. This is described in Hydraulic structures.

References

  1. Kurganov A, Petrova G (2007) ∙ A Second-Order Well-Balanced Positivity Preserving Central-Upwind Scheme for the Saint-Venant System ∙ found at: http://www.math.tamu.edu/~gpetrova/KPSV.pdf (last visited 2018-06-29)

Template:WaterOverlay nav