Breach (Water Overlay): Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 14: Line 14:


{{Overlay attribute
{{Overlay attribute
|attribute=[[Breach_height_(Water_Overlay)|BREACH_HEIGHT]]
|attribute=[[Breach height (Water Overlay)|BREACH_HEIGHT]]
|unit={{mdatum}}
|unit={{mdatum}}
|description=The new [[terrain height]] at the location of the breach.  
|description=The new [[terrain height (Water Overlay)|terrain height]] at the location of the breach.  
|defaultvalue=n/a
|defaultvalue=n/a
|icon=[[File:waterwizard_icon_breach_height.png]]
|icon=[[File:waterwizard_icon_breach_height.png]]
|attribute2=[[Breach_width_(Water_Overlay)|BREACH_WIDTH]]
|attribute2=[[Breach width (Water Overlay)|BREACH_WIDTH]]
|unit2=m
|unit2=m
|description2=The initial width of the breach.
|description2=The initial width of the breach.
|defaultvalue2=10000
|defaultvalue2=10000
|icon2=[[File:waterwizard_icon_breach_width.png]]
|icon2=[[File:waterwizard_icon_breach_width.png]]
|attribute3=[[Breach_angle_(Water_Overlay)|BREACH_ANGLE]]
|attribute3=[[Breach angle (Water Overlay)|BREACH_ANGLE]]
|unit3={{geoangle}}
|unit3={{geoangle}}
|description3=The angle at which water can flow from the breach.  
|description3=The angle at which water can flow from the breach.  
|defaultvalue3=n/a
|defaultvalue3=n/a
|icon3=[[File:waterwizard_icon_breach_angle.png]]
|icon3=[[File:waterwizard_icon_breach_angle.png]]
|attribute4=[[Breach_speed_(Water_Overlay)|BREACH_SPEED]]
|attribute4=[[Breach speed (Water Overlay)|BREACH_SPEED]]
|unit4=m/s
|unit4=m/s
|description4=The critical speed factor in the [[Breach_growth_formula_(Water_Overlay)|Breach width grow-formula]].
|description4=The critical speed factor used in the [[Breach growth formula (Water Overlay)|Breach width growth formula]].
|defaultvalue4=n/a
|defaultvalue4=n/a
|icon4=[[File:waterwizard_icon_breach_speed.png]]
|icon4=[[File:waterwizard_icon_breach_speed.png]]
|attribute5=[[External_surface_level_(Water_Overlay)|EXTERNAL_SURFACE_LEVEL]]
|attribute5=[[External surface level (Water Overlay)|EXTERNAL_SURFACE_LEVEL]]
|unit5={{mdatum}}
|unit5={{mdatum}}
|description5=The height of the bottom of the external water body behind the breach. The lowest level the external water level can lower to.
|description5=The height of the bottom of the external water body behind the breach. The lowest level the external water level can lower to.
|defaultvalue5=0
|defaultvalue5=0
|icon5=[[File:waterwizard_icon_external_surface_level.png]]
|icon5=[[File:waterwizard_icon_external_surface_level.png]]
|attribute6=[[External_water_level_(Water_Overlay)|EXTERNAL_WATER_LEVEL]]
|attribute6=[[External water level (Water Overlay)|EXTERNAL_WATER_LEVEL]]
|unit6={{mdatum}}
|unit6={{mdatum}}
|description6=The water level of the external water body behind the breach. The initial level the water level is set to.
|description6=The water level of the external water body behind the breach. The initial level the water level is set to.
|defaultvalue6=0
|defaultvalue6=0
|icon6=[[File:waterwizard_icon_external_water_level.png]]
|icon6=[[File:waterwizard_icon_external_water_level.png]]
|attribute7=[[External_area_(Water_Overlay)|EXTERNAL_AREA]]
|attribute7=[[External area (Water Overlay)|EXTERNAL_AREA]]
|unit7=m²
|unit7=m²
|description7=The surface area of the external water body behind the breach. The larger the external water body, the more water can flow from it, and the smaller the effect of the inflow or outflow of water on the external water level.
|description7=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.
|defaultvalue7=n/a
|defaultvalue7=n/a
|icon7=[[File:waterwizard_icon_external_surface_level.png]]
|icon7=[[File:waterwizard_icon_external_surface_level.png]]
|attribute8=[[Breach_input_area_(Water_Overlay)|BREACH_INPUT_AREA]]
|attribute8=[[Breach input area (Water Overlay)|BREACH_INPUT_AREA]]
|unit8=Item ID
|unit8=Area ID
|description8=The [[Area]] representing the influx area for the breach.  
|description8=The [[area]] representing the influx area for the breach. Water will flow directly from the influx area to the breach itself.  
|defaultvalue8=none
|defaultvalue8=none
|icon8=[[File:waterwizard_icon_breach_input_area.png]]
|icon8=[[File:waterwizard_icon_breach_input_area.png]]

Revision as of 13:56, 19 June 2019

A breach is a modification to the terrain height, with an optional in- or outflow of water for the hydrological model. This can be used to represent calamitous situations, such as a breach in a levee. Breaches can also be used to easily simulate a terrain height increase, like a levee.

A breach can either be defined solely as a terrain height modification using its BREACH_HEIGHT attribute, or as a connection to a water body outside of the hydrological model by adding attributes related to the external water body. If the breach is only defined as a terrain height change, only water that is already created or defined in some other way in the hydrological model can flow through and from it.

If the breach is given the attributes required for the external water body, water will automatically be created or removed uniformly on the breach, depending on the simulated water body "behind" the breach.

The breach can grow over time, based on its initial width and the critical speed at which water may flow. 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. All cells in the active breach are considered directly adjacent to the external water body.

The terrain covered by the entire breach area is considered lowered to the height defined by its BREACH_HEIGHT attribute, even if the active breach does not extend across the entirety of the breach area.

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.

If no critical speed 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.

Template:Overlay attribute