Surface model (Water Overlay): Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
__NOTOC__
__NOTOC__
==Computation==
==Computation==
The [[Water Module]]'s primary function is simulating two-dimensional flow of water across the surface. In order to do this, the project area is first discretized into ''x'' by ''y'' cells depending on the configured [[grid cell size]]. Secondly, a set of rules is required that describes the behavior of the flow. This is done through a second-order semi-discrete central-upwind scheme produced by Kurganov and Petrova (2007)<ref name="Kurganov2"/>, which is based on the 2-D Saint-Venant equations (a.k.a. shallow water equations):
The [[Water Module]]'s primary function is simulating two-dimensional flow of water across the surface. In order to do this, the project area is first discretized into ''x'' by ''y'' cells depending on the configured [[grid cell size]]. Secondly, water is initialized in the model. Finally, a set of rules is required that describes the behavior of the flow.  
[[File:2D-Saint-Venant_system.png|left]]
where
: h<sub>t</sub> = water depth at time t
: u<sub>t</sub> = velocity in the x-direction at time t
: v<sub>t</sub> = velocity in the y-direction at time t
: B<sub>x</sub> = slope in the x-direction
: B<sub>y</sub> = slope in the y-direction
: g = gravitational constant
{{clear|left}}
 
[[File:Waterlevel_schematic.png|right|x200px|frame|For each grid cell:<br>B = bottom elevation<br>h = water depth<br>w = water surface elevation]]
This scheme deviates from the original Saint-Venant equations in that it approaches the system in terms of water surface elevation (''w = h + B'') and flux (''hu'' and ''hv''), instead of just the water depth (''h''). The image on the right aims to clarify on the various terms in the model equations. <!--More technical information on the {{software}}'s implementation of the ''Well-Balanced Positivity Preserving Central-Upwind Scheme'' can be found [[Surface_flow_formula_(Water_Overlay)|here]].-->
 
====Flowing water====
In the model, imbalances in the water surface elevation across the grid drive the flow of water until a state of equilibrium is reached in terms of ''w'' and flux.


===Water level initialization===
===Water level initialization===
Line 29: Line 14:
If a grid cell is neither part of any water level area nor inundation area, or the assigned water level is lower than its [[terrain height (Water Overlay)|bottom elevation]], the water depth is assumed to be zero and the water level becomes equal to the bottom elevation. In turn, this bottom (or surface) elevation is equal to the local [[terrain height]] of the project area, though it may be altered by the presence of a construction or the [[Breach height (Water Overlay)|BREACH_HEIGHT]] attribute of a [[Breach (Water Overlay)|breach]].
If a grid cell is neither part of any water level area nor inundation area, or the assigned water level is lower than its [[terrain height (Water Overlay)|bottom elevation]], the water depth is assumed to be zero and the water level becomes equal to the bottom elevation. In turn, this bottom (or surface) elevation is equal to the local [[terrain height]] of the project area, though it may be altered by the presence of a construction or the [[Breach height (Water Overlay)|BREACH_HEIGHT]] attribute of a [[Breach (Water Overlay)|breach]].


===Notes===
====Notes====
* Water can be added to and removed from the described surface system by the [[Rain model (Water Overlay)|rain]], [[Evaporation model (Water Overlay)|evaporation]] and [[Infiltration model (Water Overlay)|infiltration model]], as well as certain [[Hydraulic structures (Water Overlay)|hydraulic structures]] and [[Breach (Water Overlay)|breach]]es.
* Water can be added to and removed from the described surface system by the [[Rain model (Water Overlay)|rain]], [[Evaporation model (Water Overlay)|evaporation]] and [[Infiltration model (Water Overlay)|infiltration model]], as well as certain [[Hydraulic structures (Water Overlay)|hydraulic structures]] and [[Breach (Water Overlay)|breach]]es.
* In the case of [[Underground model (Water Overlay)|subsurface flow]] a different flow system with different equations are used.
* In the case of [[Underground model (Water Overlay)|subsurface flow]] a different flow system with different equations are used.
* In addition to water flowing in between grid cells, water can also flow ''through'' [[Hydraulic structures (Water Overlay)|hydraulic constructions]].
* In addition to water flowing in between grid cells, water can also flow ''through'' [[Hydraulic structures (Water Overlay)|hydraulic constructions]].
* The [[Design flood elevation m model attribute (Water Overlay)|DESIGN_FLOOD_ELEVATION_M]] attribute confines the maximum surface elevation induced by constructions.
* The [[Design flood elevation m model attribute (Water Overlay)|DESIGN_FLOOD_ELEVATION_M]] attribute confines the maximum surface elevation induced by constructions.
===Suface flow scheme===
In the model, imbalances in the water surface elevation across the grid drive the flow of water until a state of equilibrium is reached in terms of ''w'' and flux. Behavior of the flow is described by a second-order semi-discrete central-upwind scheme produced by Kurganov and Petrova (2007)<ref name="Kurganov2"/>, which is based on the 2-D Saint-Venant equations (a.k.a. shallow water equations):
[[File:2D-Saint-Venant_system.png|left]]
where
: h<sub>t</sub> = water depth at time t
: u<sub>t</sub> = velocity in the x-direction at time t
: v<sub>t</sub> = velocity in the y-direction at time t
: B<sub>x</sub> = slope in the x-direction
: B<sub>y</sub> = slope in the y-direction
: g = gravitational constant
{{clear|left}}
[[File:Waterlevel_schematic.png|300px|thumb|right|For each grid cell:<br>B = bottom elevation<br>h = water depth<br>w = water surface elevation]]
This scheme deviates from the original Saint-Venant equations in that it approaches the system in terms of water surface elevation (''w = h + B'') and flux (''hu'' and ''hv''), instead of just the water depth (''h''). The image on the right aims to clarify on the various terms in the model equations. This method relies on a continuous piecewise linear approximation of the surface, which is further explained on [[Elevation model (Water Overlay)|this]] page.<!--More technical information on the {{software}}'s implementation of the ''Well-Balanced Positivity Preserving Central-Upwind Scheme'' can be found [[Surface_flow_formula_(Water_Overlay)|here]].-->
This scheme is further extended with the shoreline reconstruction method by Bollerman et al (2014), which ensures better numerical stability at the wetting and drying fronts of a flood wave<ref name="Bollerman"/>. An elaborate explanation is provided by Horváth et al. (2014)<ref name="Horvath"/>.
General sequence of steps:
# Each cell's elevation value (B in Fig. 1) is set equal to the value at its center and the interface midpoints.
# Slopes of conserved variables (U in Fig. 1), i.e., continuity and momentum in ''x''- and ''y''-direction, are reconstructed.
# Values of conserved variables at the cell interface midpoints are compared with the left-sided and right-sided values with respect to the cell's center.
# Slopes of partially dry cells are modified to prevent negative depth values and numerical instability.
# Fluxes are computed at each cell interface to determine the values of the conserved variable at the cell centers for the next time step.
# The largest allowed time step is calculated.
# Time is incremented with the calculated time step and changes in water level and fluxes are subsequently applied.


==References==
==References==
<references>
<references>
<ref name="Bollerman">Bollermann, Andreas & Chen, Guoxian & Kurganov, Alexander & Noelle, Sebastian. (2014). A Well-balanced Reconstruction for Wetting, Drying Fronts. IGPM Report. 313. ∙ found at: https://www.researchgate.net/publication/269417532_A_Well-balanced_Reconstruction_for_Wetting_Drying_Fronts (last visited: 2019-07-24)</ref>
<ref name="Horvath">Zsolt Horváth, Jürgen Waser, Rui A. P. Perdigão, Artem Konev and Günter Blöschl (2014) ∙ A two-dimensional numerical scheme of dry/wet fronts for the Saint-Venant system of shallow water equations ∙ found at: http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.700.7977&rep=rep1&type=pdf and http://visdom.at/media/pdf/publications/Poster.pdf (last visited 2018-06-29)</ref>
<ref name="Kurganov2">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)</ref>
<ref name="Kurganov2">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)</ref>
</references>
</references>

Revision as of 09:54, 24 July 2019

Computation

The Water Module's primary function is simulating two-dimensional flow of water across the surface. In order to do this, the project area is first discretized into x by y cells depending on the configured grid cell size. Secondly, water is initialized in the model. Finally, a set of rules is required that describes the behavior of the flow.

Water level initialization

In theory, each grid cell can have a unique bottom elevation and accompanying water depth, yielding a certain water surface elevation (or water level). However, in practice, water levels are often initialized for large groups of cells rather than individual cells, assuming that each (water level) area in a project has been assigned a water level. During the initialization phase a distinction is made between two types:

For all water terrains in a water level area, the volume of water per grid cell is such that the resulting water level at those locations conforms the value of the WATER_LEVEL attribute as provided by the corresponding water level area.

In contrast to water level areas, which generate water on water terrains, inundation areas generate water over all grid cells, regardless of its terrain type. Similarly, the volume of water per grid cell is determined by the INUNDATION_LEVEL attribute as provided by the corresponding inundation area.

If a grid cell is neither part of any water level area nor inundation area, or the assigned water level is lower than its bottom elevation, the water depth is assumed to be zero and the water level becomes equal to the bottom elevation. In turn, this bottom (or surface) elevation is equal to the local terrain height of the project area, though it may be altered by the presence of a construction or the BREACH_HEIGHT attribute of a breach.

Notes

Suface flow scheme

In the model, imbalances in the water surface elevation across the grid drive the flow of water until a state of equilibrium is reached in terms of w and flux. Behavior of the flow is described by a second-order semi-discrete central-upwind scheme produced by Kurganov and Petrova (2007)[1], which is based on the 2-D Saint-Venant equations (a.k.a. shallow water equations):

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
For each grid cell:
B = bottom elevation
h = water depth
w = water surface elevation

This scheme deviates from the original Saint-Venant equations in that it approaches the system in terms of water surface elevation (w = h + B) and flux (hu and hv), instead of just the water depth (h). The image on the right aims to clarify on the various terms in the model equations. This method relies on a continuous piecewise linear approximation of the surface, which is further explained on this page.

This scheme is further extended with the shoreline reconstruction method by Bollerman et al (2014), which ensures better numerical stability at the wetting and drying fronts of a flood wave[2]. An elaborate explanation is provided by Horváth et al. (2014)[3].

General sequence of steps:

  1. Each cell's elevation value (B in Fig. 1) is set equal to the value at its center and the interface midpoints.
  2. Slopes of conserved variables (U in Fig. 1), i.e., continuity and momentum in x- and y-direction, are reconstructed.
  3. Values of conserved variables at the cell interface midpoints are compared with the left-sided and right-sided values with respect to the cell's center.
  4. Slopes of partially dry cells are modified to prevent negative depth values and numerical instability.
  5. Fluxes are computed at each cell interface to determine the values of the conserved variable at the cell centers for the next time step.
  6. The largest allowed time step is calculated.
  7. Time is incremented with the calculated time step and changes in water level and fluxes are subsequently applied.

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)
  2. Bollermann, Andreas & Chen, Guoxian & Kurganov, Alexander & Noelle, Sebastian. (2014). A Well-balanced Reconstruction for Wetting, Drying Fronts. IGPM Report. 313. ∙ found at: https://www.researchgate.net/publication/269417532_A_Well-balanced_Reconstruction_for_Wetting_Drying_Fronts (last visited: 2019-07-24)
  3. Zsolt Horváth, Jürgen Waser, Rui A. P. Perdigão, Artem Konev and Günter Blöschl (2014) ∙ A two-dimensional numerical scheme of dry/wet fronts for the Saint-Venant system of shallow water equations ∙ found at: http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.700.7977&rep=rep1&type=pdf and http://visdom.at/media/pdf/publications/Poster.pdf (last visited 2018-06-29)

Template:WaterOverlay nav