Surface model (Water Overlay)

From Tygron Preview Support Wiki
Jump to navigation Jump to search

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

where:

ht = water depth at time t
ut = velocity in the x direction at time t
vt = velocity in the y direction at time t
Bx = slope in the x direction
By = slope in the y direction
g = gravitational constant

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.

For each grid cell:
B = bottom elevation
h = water depth
w = water surface elevation

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

Flowing water

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.

Water level initialization

In theory, each grid cell can have a unique water level and accompanying water depth. 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. We make the following distinction:

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 depth 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 inundation level is below the surface elevation of the grid cell, the water depth is assumed to be 0 and the water level equal to the surface elevation.

The terrain height is defined by the terrain height in the project. The surface height is further influenced by the height of constructions present in the project (bounded by DESIGN_FLOOD_ELEVATION_M) and by the BREACH_HEIGHT of breaches.

Notes

Related formulas

Related models

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 2019-04-11)

Template:WaterOverlay nav