Breach model (Water Overlay)

From Tygron Support wiki
Revision as of 13:03, 18 January 2023 by Frank@tygron.nl (talk | contribs)
Jump to navigation Jump to search

A Breach can be defined as an area and is identified via the BREACH_HEIGHT attribute. Water flowing through the breach originates from a body of water. This body of water can be defined as an input area in the project or a conceptual external water body existing outside the project area. Water can flow through the breach from the input water body to the defined Breach area, and vice versa.

The breach is simulated as a generic weir with breach characteristics that models the energy loss, the weir input/output is dynamically mapped onto the 2D grid cells. Using the Verheij–van der Knaap method the breach can also grow over time from phase one deepening to phase two widening. Below a simple schematic of the different breach elements.


Side View of a Breach with a height, a Breach input area (Water Overlay) with a water level, a breach as an area where the water is released when it conceptually passes the breach and an inner level measurement point which calculated the downstream (inner) water level.
Top View of a Breach with a width and a direction, a point of measurement at a distance and an input area within a Water Area.
Top View of an alternative setup with a Breach with a width and a direction, a Breach level area and an external area which is conceptually located outside the project area.

Features

  • With larger breaches the water level inside the breach area can become turbulent. Therefor the inner water level (used for breach growth) is measured at a distance defined in BREACH_MEASUREMENT_DISTANCE_M behind the breach area when an BREACH_ANGLE is provided.
  • Instead of using an input area you can also define a fictitious external area, this can represent a larger water body outside the project area, e.g. a part of a sea. The external area also has it's own Surface level, Water level and Area.
  • If a BREACH_WIDTH attribute is defined, the breach's polygon is intersected with a circle emanating from the center-point of the polygon. It is only in that intersection, called "active", that water will flow in from the input area. The radius of the circle defining the intersection will expand as the breach grows over time.
  • Water flowing through the breach will flow in the direction defined by the BREACH_ANGLE attribute, regardless of whether the water flowed onto the breach from elsewhere in the water model, or from the simulated external water body. When no BREACH_ANGLE is defined, water can flow in any direction. Adding this attribute with also convert the breach advection speed (m/s) into the 2D cell of the breach area. It is recommended to always use this attribute for optimal flow.
  • If no BREACH_SPEED attribute is defined, the active breach will never grow.
  • If no width is defined, the width is assumed to be very large, using the full Breach area polygon.
  • The BREACH_HEIGHT attribute can also have multiple values over time, this allows you this simulate the breach vertical growth.


Notes

  • The elevation model covered by the entire breach area is lowered to at least the minimum height defined by its BREACH_HEIGHT attribute. This is to prevent the terrain height from interfering with the flow.
  • When using breach growth the inner water level is computed from the average value in the active breach area. For optimal flow simulation it is therefor recommended to place the breach area just behind the levee on a flat space.
  • Water on a breach area is automatically spread across the entire active breach area equally.
  • The inner/outer water levels and breach width are visualized per timeframe on the breach object in the 3D map, these can be very useful to see how the breach is progressing.
  • The Base Types Result child overlay can be used to see which part of entire the breach area is considered "active". Breach growth can be seen when checking multiple timeframes.
  • You can also optionally change the default breach weir coefficient to model energy loss by adding a WEIR_COEFFICIENT attribute to the Breach area.
  • When the water level of in the input area drops over time the flow can also reverse, flowing back into the e.g. the river/sea.

See also