FAILEVEL(LF,LD)

(r) The maximum elevation of the prescribed levee failure if different (lower) than
the levee crest (LEVELEV). Set FAILEVEL = 0 to fail the levee when overtopped.
---
FAILRATE(LF,LD)
(r) The rate of vertical levee failure in feet or meters per hour.
---
FAILTIME(LF,LD)
(r) The duration (hours) that the levee will fail after the FAILEVEL elevation is
exceeded by the flow depth. Set FAILTIME = 0 if the level fails immediately when
overtopped.
---
FAILWIDRATE(LF,LD)
(r) The rate at which the levee breach widens (ft/hr or m/hr). The breach stops
increasing if the breach exceeds the grid element width for that direction.
---
FAILWIDTH(LF,LD)
(r) The flow width (ft or m) of levee failure. This flow width relates to one of
the eight flow directions and should be less than the length of the side of a grid
element times 0.4142 (length of an octagon side).
---
GFRAGCHAR
(c) Global levee fragility curve ID. One letter (e.g. S) and one number (e.g. 3)
and must correspond to a levee fragility curve ID in the BREACH.DAT file.
---
GFRAGPROB
(r) Global levee fragility curve failure probability. This is assigned to all levee
grid elements.
---
ILEVFAIL
(i) Switch to identify levee failure model. Set ILEVFAIL = 0 for no levee failure.
Set ILEVFAIL = 1 for prescribed level failure rates of breach opening. Set
ILEVFAIL = 2 for initiating the levee or dam breach failure routine. See Comment
6.
---
LDIR(L,IM)
(i) Flow direction (of the 8 possible overland flow directions) that will be cutoff
by a levee in a given grid element. The possible flow directions are:

1 = north 5 = northeast
2 = east 6 = southeast
3 = south 7 = southwest
4 = west 8 = northwest
---
LEVBASE(LF,LD)
(r) The elevation of the levee crest after complete failure. Set LEVBASE = 0 if
levee failure results in the levee crest being reset to the floodplain elevation in
the FPLAIN.DAT file. If levee failure exceeds LEVBASE elevation, the floodplain
elevation is set to LEVBASE.
---
LEVCHAR(L)
Character Identifier for Lines 2 and 3, where �L� = line 2, �D� = line 3, �F� =
line 4, and �W� = line 5.
---
LEVCREST(L,IM)
(r) The elevation of the levee crest (see comment 4).
---
LFAILDIR(LF,LD)
(i) The potential failure direction (one of eight possible flow directions). See
comment 3.
---
LFAILGRID(LF)
(i) The floodplain grid element number with a levee that may potentially fail.
See comment 1.
---
LEVFRAGCHAR
(c) Individual levee grid element fragility curve ID. This corresponds to one of
the levee fragility curves listed in BREACH.DAT
---
LEVFRAGPROB
(r) Individual levee grid element fragility curve probability.
---
LEVFRAGRID
(i) Individual levee grid element with fragility curve assignment.
---
LGRIDNO(L)
(i) The grid element number containing the levee segment (see comment 2).
---
RAISELEV
(r) Incremental height (ft or m) that all the levee grid element crest elevations
are raised.
***
Instructional Comments for the LEVEE.DAT File

1. The general operating rules for the levee failure are as follows:
a. If the levee fails when overtopped by the flow, set FAILEVEL and FAILTIME =
0.
b. If the levee is to fail at specified level below the top of the levee, set
FAILEVEL equal to the failure elevation.
c. If the levee is to fail at a specific level below the top of the levee after
being inundation for a specific duration, assign appropriate values to both the
FAILEVEL and FAILTIME variables.
d. If the levee fails to a new base levee that is different than the floodplain
elevation, assign an appropriate elevation to LEVBASE.
e. After levee failure, flows will occur through a breach width of FAILWIDTH for
that flow direction.
f. Progressive levee failure is simulated by assigning a value to FAILRATE
(ft/hr). This computes the new levee crest elevation as failure proceeds.
FAILRATE is a vertical rate of decrease in the levee breach elevation.

2. No multiple channels will be assigned to grid elements with levees. Multiple

channels in a levee grid element are eliminated automatically by the model.

3. Each levee grid element can have up to eight failure directions. Note that
the failure with will be based on an octagon with is 0.4142 times the side length
of the grid.

4. Flow over a levee is computed as broadcrested weir flow using a coefficient

of 2.85 until the tailwater depth is 85% of the headwater depth. The flow then
reverts to overland flow based on the water surface elevations on each side of the
levee and the flow depth over the levee.

5. Levee freeboard deficit is reported in the output file LEVEEDEFIC.OUT. Four

levels of freeboard deficit are listed in the file as follows:
Level Available Freeboard
0 > 3 ft (0.9 m)
0 2 ft < freeboard < 3 ft
1 1 ft < freeboard < 2 ft
2 freeboard < 1 ft
3 levee overtopped

6. There two options for specifying levee or dam breach failure. Set ILEVFAIL =
1 to assess the breach failure with prescribed rates of breach opening vertically
and horizontally. Set ILEVFAIL = 2 to allow the model to simulate the breach
geotechnical failure using a modify NWS BREACH model routine.