Breach (Water Overlay)

A Breach area can be used to simulate a breach in a levee.

A breach area can be defined via the BREACH_HEIGHT attribute. It can have an input area or external area with a water body outside of the hydrological model. Water can flow through the breach form the input (or external area) into the breach area just behind the levee and vise versa.

Features

• The breach can grow over time, based on its initial width and the critical speed at which water may flow, see Breach_growth_formula_(Water_Overlay). If a BREACH_WIDTH is defined, the breach's polygon is intersected with a circle emanating from the centerpoint of the polygon. It is only in that intersection, dubbed the "active breach", that water will flow in from the simulated external water body. The radius of the circle defining the intersection will expand as water flows, based on the critical speed of the water as defined in the BREACH_SPEED attribute.

• The terrain covered by the entire breach area is adjusted to the minimum height defined by its BREACH_HEIGHT attribute. This is to prevent the terrain height from interfering with the flow.

• Water flowing through or across a 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. If 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, creating an intersection exactly the size of the polygon.

• The BREACH_HEIGHT attribute can also have multiple values over time, this allows you this simulate the breach vertical growth.

Notes

• 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 and outer water levels are visualized per timeframe on the breach object in the 3D map, these can be very useful to see how the breach is progressing.

Icon	Key	Unit	Range	Description	Default value
	BREACH_HEIGHT	m + datum		The new terrain height at the location of the breach.	n/a
	BREACH_WIDTH	m		The initial width of the breach.	10000
	BREACH_ANGLE	geo angle (0-360°)	-1.7976931348623157E308 to 1.7976931348623157E308	The angle at which water flows out through the breach.	n/a
	BREACH_SPEED	m/s		The critical speed factor in the breach width grow-formula (e.g. 0.2 for sand and 0.5 for clay).	n/a
	BREACH_INPUT_AREA	ID of an Area		The Area item representing the influx area for the breach.	none
	EXTERNAL_SURFACE_LEVEL	m + datum		The height of the bottom of the external water body behind the breach. The lowest level the external water level can lower to.	0
	EXTERNAL_WATER_LEVEL	m + datum		The water level of the external water body behind the breach. The initial level the water level is set to.	0
	EXTERNAL_AREA	m²		The surface area of the external water body behind the breach. The larger the external water body, the more water can flow from it (or into it), and the smaller the effect of the inflow or outflow of water on the external water level. When provided with a second value, this key will also define a bottom area for the external water body, transforming its cross-section from a rectangle to a trapezoid.	n/a

How-to's

• How to add a breach with external area manually
• How to add a breach with input area manually
• How to import a breach with input area
• How to set dynamic breach height
• How to visualize multiple sequential breaches (Water Overlay)

Videos

Modeling breach growth

See also

• Elevation model (Water Overlay)
• Breach growth formula (Water Overlay)
• Breach flow formula (Water Overlay)

---

Water Module

Water Module

Tutorials

Overview

Theory

Benchmarks

Group

Hydrological features

Water area

Water level • Water relative

Sewer area

Sewer storage • Sewer pump speed

Inundation area

Inundation level

Aquifer

Aquifer kd • Aquifer datum

Breach

Breach height • Breach width • Breach angle • Breach coefficient • Breach speed • Breach input area • Breach level area • External surface level • External water level • External area

Rain area

Rain m

Limitation area

Limit area

Output

Object flow output • Object height output • Object datum output a • Object datum output b • Object width output

Related

Building attributes • Hydraulic structures •  Terrain attributes • Model attributes • Results • Simulation data