# Warnings

Every warning a retaining wall's result can carry, keyed by its code, from a resultant outside the base to an MSE wall's reinforcement, and what it supposes.

A warning flags something unusual in this result: data that don’t fit together, a value at the edge of a method’s range or chart, or a physical condition the numbers show. **Results** marks each one as danger, caution or information: one about a check on that check’s page, one about the whole model under **Notes**. The calculation report lists them too. Each entry below carries the engine’s code, the one an answer from the API or the MCP gives.

## The base

### Resultant outside the base

Danger · `resultant_outside_base`

$e \ge B/2$: the wall overturns, and there is no contact pressure to compute ([Stability](https://rischio.io/docs/retaining-wall/theory/stability/#eccentricity)). An allowable bearing pressure given isn’t checked: the warning names it, and the model has no verdict unless another check fails ([An allowable bearing pressure](https://rischio.io/docs/retaining-wall/theory/bearing-capacity/#an-allowable-bearing-pressure)).

### Base lift-off

Danger · `base_lift_off`

$B/6 \lt e \lt B/2$: the resultant is outside the middle third, $q_{min}$ is negative, and that edge of the base loses contact with the soil. In free mode, with an allowable bearing pressure given, a concrete or gabion wall’s pressure check then takes the triangle on the part in contact ([An allowable bearing pressure](https://rischio.io/docs/retaining-wall/theory/bearing-capacity/#an-allowable-bearing-pressure)).

### Allowable pressure above the ultimate

Caution · `allowable_above_resistance`

The allowable bearing pressure given is at or above the ultimate pressure the foundation’s strata give under the base, with the inclination of the wall’s load. An allowable pressure is always below its ultimate, so either the value or the strata are off ([An allowable bearing pressure](https://rischio.io/docs/retaining-wall/theory/bearing-capacity/#an-allowable-bearing-pressure)).

### Local or punching shear

Caution · `local_shear_possible`

Vesic’s rigidity index of the stratum $B/2$ below the base is below its critical value, so the base may fail in local or punching shear, and the bearing resistance takes the stratum’s reduced strength, $c^* = 0.67c$ and $\tan\phi^* = 0.67\tan\phi$ (AASHTO 10.6.3.1.2b), as a [footing’s](https://rischio.io/docs/shallow-foundation/theory/bearing-capacity/#local-or-punching-shear) does.

### A weaker stratum governs

Caution · `weaker_stratum_governs`

A stratum below the one the base rests on is weaker and within the critical depth (a softer clay under a clay, within the reach of the two clays’ $N_m$, past it too): the base would punch through into it, and that sets $q_n$ (AASHTO 10.6.3.1.2d to f; [The strata below](https://rischio.io/docs/retaining-wall/theory/bearing-capacity/#the-strata-below)).

### A stratum below without its strength

Caution · `stratum_below_without_strength`

A clay below the base is given without its $c_u$, only its consolidation, so the bearing capacity counts neither it nor what lies under it. Give its $c_u$ to see whether the base punches into it.

### Underconsolidated clay

Caution · `underconsolidated_as_normally_consolidated`

A clay under the base has $\sigma'_c$ below $\sigma'_{vo}$ at its middle, an $OCR$ under 1, and its [settlement](https://rischio.io/docs/retaining-wall/theory/bearing-capacity/#settlement) takes each of its layers as normally consolidated from its $\sigma'_o$, as AASHTO’s Eq. 10.6.2.4.3-3 does. The settlement still to come under the ground’s own load (FHWA-NHI-06-088, §7.5.2.3) isn’t included.

### Unusual friction angle

Caution · `unusual_friction_angle`

A stratum has $\phi'$ above 45°: possible in rock fill, rare in soil, and often a typing error. The calculation runs, and the warning points at the stratum.

## Earth pressure

### Long heel

Information · `long_heel_rankine`

With Coulomb, the Rankine wedge from the heel misses the wall, so the thrust is taken by Rankine on the virtual back through the heel, as AASHTO does ([The wall’s back](https://rischio.io/docs/retaining-wall/theory/earth-pressure/#the-walls-back)). Under AASHTO, which always takes the code’s plane, it doesn’t show.

### Tension crack to the base

Information · `tension_crack_to_the_base`

With [Rankine with cohesion](https://rischio.io/docs/retaining-wall/theory/earth-pressure/#rankine-with-cohesion), the crack is as deep as the wall: the backfill holds itself up, its surcharge included, and its soil pushes nothing. Only water or a line load behind the wall pushes it, and without them there’s no sliding check.

## Under the earthquake

### A wall taller than 60 ft

Caution · `seismic_tall_wall`

The wall is taller than 18.3 m (60 ft), where AASHTO asks a dynamic analysis of the wall and its soil (11.6.5.2.2). The pseudo-static result is a first estimate ([Under an earthquake](https://rischio.io/docs/retaining-wall/theory/earth-pressure/#under-an-earthquake)).

## MSE and modular walls

### Short MSE reinforcement

Caution · `mse_short_reinforcement`

The layers are shorter than FHWA’s minimum, the greater of $0.7H$ and 2.4 m ([MSE walls](https://rischio.io/docs/retaining-wall/theory/mse/)).

### Short effective length

Caution · `mse_short_effective_length`

A layer reaches less than 1 m past the failure surface, FHWA’s minimum $L_e$ ([Pullout](https://rischio.io/docs/retaining-wall/theory/mse/#pullout)).

### Shallow MSE embedment

Caution · `mse_shallow_embedment`

The base of an MSE wall is less than $H/20$ and 0.6 m below the ground in front, FHWA’s minimum on level ground.

### Layers too far apart

Caution · `mse_spacing_above_limit`

A layer carries more than 2.7 ft (0.82 m) of the wall’s height, the most AASHTO’s methods for the reinforcement’s load take without full-scale data (11.10.6.2.1b).

### Traffic under 0.61 m of fill

Caution · `mse_traffic_below_two_feet`

The traffic surcharge on an MSE wall is less than the weight of 0.61 m of its reinforced fill, which AASHTO takes as the least (11.10.10.2).

### A friction angle that asks for tests

Caution · `friction_angle_needs_tests`

The reinforced fill’s $\phi'$ is above 34°, or a retained soil’s above 30°: AASHTO takes more only from tests of that soil (11.10.6.2 and 11.10.5.1), so have it tested.

### A modular wall's friction above AASHTO's table

Caution · `modular_wall_friction_above_table`

The wall friction you gave is above Table C3.11.5.9-1’s for the back of a modular wall, $0.50\phi'$ for a continuous back and $0.75\phi'$ for a stepped one, the most AASHTO takes in Coulomb’s $k_a$ ([Wall friction](https://rischio.io/docs/retaining-wall/theory/earth-pressure/#wall-friction)).

### L/H outside the displacement chart

Information · `mse_lateral_displacement_outside_curve`

$L/H$ is outside the curve of AASHTO’s Fig. C11.10.4.2-1, so there’s no estimate of the wall’s [lateral displacement](https://rischio.io/docs/retaining-wall/theory/mse/#lateral-displacement).

## What a check supposes

What a method or the code assumes isn’t a warning: Results says it on the page of each check it moves, under **What it supposes**, and the calculation report beside that check. These are the ones a wall’s checks can say.

### The soil in front left out of sliding

`sliding_passive_not_counted`

The passive resistance of the soil in front is left out of sliding, the safe side AASHTO allows (11.6.3.5): scour, frost or a trench may take that soil.

### Uplift taken linear

`linear_uplift_pressure`

The uplift under the base varies linearly from the heel to the toe, with no seepage analysis ([Weights and uplift](https://rischio.io/docs/retaining-wall/theory/stability/#weights-and-uplift)).

### No cohesion in the thrust

`backfill_cohesion_not_counted`

A cohesive backfill’s thrust has no cohesion term: AASHTO’s earth pressure, $p = k_a\gamma_s z$, isn’t lowered by $c'$ or $s_u$ (3.11.5.1, C3.11.5.3), the safe side.

### A cohesive backfill that creeps

`cohesive_backfill_between_active_and_at_rest`

AASHTO asks a cohesive backfill that creeps to be designed with extreme caution, for a pressure between active and at rest (C11.6.1.2). Rischio takes the active pressure, the least it could be: how far above it to design is your judgment, and a granular backfill avoids the question.

### No cohesion under the earthquake

`seismic_cohesion_not_counted`

Under the earthquake, a drained backfill’s cohesion isn’t counted: the seismic thrust takes $\phi'$ alone, which only raises $P_{AE}$, the safe side. AASHTO counts a clear cohesion by Anderson et al.’s wedge (A11.3.2), which Rischio doesn’t compute.

### The base on a stratum below the top one

`bearing_stratum_differs`

The bearing capacity takes the stratum at the level of the base, not the one at the surface.

### General shear assumed

`general_shear_assumed`

The stratum $B/2$ below the base has no modulus and Poisson’s ratio, so Vesic’s rigidity index can’t tell whether it would fail in local or punching shear: the bearing takes general shear. Give them to check it.

### Strata taken as one

`strata_taken_as_one`

The two-strata methods take two strata, and no source gives one for more (USACE EM 1110-1-1905, ¶4-2g): to reach a weaker stratum deeper down, the strata between are taken as the one the base rests on. Of every pairing, Rischio takes the one with the lowest capacity.

### A stratum below no weaker

`stratum_below_not_weaker`

A stratum below the base at least as strong as the one above it in every property its shear strength takes (the same material, and no lower $c'$, $\phi'$ or $s_u$, or $\gamma$) is no weaker second layer (AASHTO 10.6.3.1.2d): it doesn’t lower the bearing capacity, though it lies within the critical depth. It happens with one soil split into strata just below a base whose soil over it stays, where the depth factor raises the base’s own capacity more than the cut’s depth raises the stratum below’s.

### A stiffer clay below left out

`stiffer_clay_below_not_counted`

A stiffer clay below the base’s would raise the bearing capacity (AASHTO 10.6.3.1.2e), which Rischio doesn’t count: the bearing takes the base’s clay alone, the conservative side.

### Rock below left out

`rock_below_not_counted`

Rock below the strata isn’t counted in the bearing resistance: AASHTO’s equations for a base on soil don’t take it, the conservative side.

### No three-dimensional correction

`consolidation_three_dimensional_not_applied`

A consolidating stratum thicker than the base is wide doesn’t take AASHTO’s three-dimensional correction $\mu_c$ (Fig. 10.6.2.4.3-3): the one-dimensional settlement stands, the safe side.

### No net pressure

`no_net_pressure`

The base adds no net pressure: its load over its area is no more than the overburden the excavation took away, so nothing consolidates under it.

### The settlement's load factor, the owner's

`aashto_settlement_gamma_by_owner`

AASHTO sets the load factor on a settlement, $\gamma_{SE}$, for Hough’s and Schmertmann’s methods and for consolidation (Table 3.4.1-5). For the elastic settlement it’s the owner’s to set: Rischio takes 1.00, to be confirmed with the owner.

### The Simplified Method, without J

`mse_simplified_without_stiffness`

Without the geosynthetic’s secant stiffness $J$, $T_{max}$ is AASHTO’s Simplified Method’s (Appendix B11), also acceptable. With $J$, the wall takes AASHTO’s own method for geosynthetics, the Stiffness Method, with its resistance factors and its soil failure check (11.10.6.2.1e, 11.10.4.3; [Each layer’s load](https://rischio.io/docs/retaining-wall/theory/mse/#each-layers-load)).

### The facing stiffness factor at 1.0

`mse_facing_stiffness_one`

The facing stiffness factor $\Phi_{fs}$ is taken as 1.0, as AASHTO allows on the safe side (C11.10.6.2.1e), so the strain limit is 2.5 %. A stiff face, concrete panels or blocks, asks 2 % unless its $\Phi_{fs}$ is shown to be about 1.0 (C11.10.4.3): set 2 % as the limit.

### No cohesion in the retained backfill

`mse_retained_cohesion_left_out`

The retained backfill pushes on the reinforced block without its cohesion: AASHTO and FHWA GEC 11 take its $c$ as 0 for the long term, the safe side.

---

Source: https://rischio.io/docs/retaining-wall/warnings/
