What the module calculates
Gravity wall checks the external stability of a wall that holds the soil back by its own weight: a trapezoidal body on a stepped footing, in stone masonry or plain concrete. You draw the section with eight dimensions, describe one backfill soil, add surcharges, water and an earthquake if they apply, and the module works out every force on the wall per metre run, then checks four things:
- Sliding along the base: FSs = (μb·Neff + Ptoe) / ΣHdrive.
- Overturning about the toe, the front bottom corner of the footing: FSo = ΣMresisting / ΣMoverturning.
- Bearing: the largest base pressure qmax against the allowable pressure qall.
- Eccentricity of the base resultant against B/6, which keeps the whole base in contact.
The earth pressure acts on the vertical plane through the back edge of the footing; the soil between that plane and the back of the wall is counted as part of the wall. You choose Rankine or Coulomb for the static pressure, and the earthquake always uses Mononobe–Okabe with the horizontal and vertical coefficients you give. Groundwater on both sides, base uplift, uniform, strip and point surcharges, and passive resistance in front of the footing (sliding only) are optional.
Which retaining-wall module is for what
- This module is for a wall that works by weight and is not reinforced: the body is treated as one rigid block, and its external stability is checked.
- The Cantilever RC wall is for a reinforced-concrete wall with a stem, a toe and a heel, and gives the actions in the stem and the slabs.
- The MSE wall is for reinforced soil, checked level by level.
To see the earth-pressure theories on their own, open Rankine, Coulomb or Mononobe–Okabe. The strip and point loads follow the same idea as the Strip load and Point load modules.
Before you start: what you need
| What | Notes |
|---|---|
| The section of the wall | Total height H from the underside of the base to the top, the top width Wu, the batter offsets on the front and back of the body, the footing projections and the footing heights, front and back. |
| The wall material | Stone masonry or plain concrete and its unit weight γm. |
| One soil | Moist and saturated unit weights, the effective friction angle φ′ (the soil is cohesionless: c′ = 0), the friction coefficient μb of the base on the foundation, and the allowable bearing pressure qall. The same soil is used behind the wall, in front of it and under the base. |
| The ground in front | The height Df of the ground above the underside of the base, and whether it may be removed (then enter zero). |
| Loads and water | Surcharges behind the wall, the groundwater depth behind the wall, a water level in front, and, for an earthquake, kh and kv. |
| The required factors | Four minimum factors of safety: sliding and overturning, static and seismic. |
Quick start in eight steps
- Open the module and choose the units
Open Gravity wall from the Retaining Walls family. Pick SI · kN, SI · tf or US at the top right; you can change it at any time, even after Analyze.
- Draw the wall
In Geometry enter H, Wu, the batter offsets Wdl and Wdr, the footing projections Wbl and Wbr and the footing heights Hfl and Hfr. The drawing follows every change and the section shows the base width B.
- Describe the ground
Set the backfill surface (Backfill Slope), the ground in front (Passive-Side Fill) and the soil (Soil Definition).
- Add loads, water and the earthquake
In Surcharge Load add uniform, strip or point loads; in Groundwater switch the water on each side on; in Earthquake choose Yes and enter kh and kv.
- Choose the material and the criteria
Pick Stone masonry or Plain concrete in Wall material and check the four required factors in Stability criteria.
- Choose the method
In Analysis Settings choose Rankine or Coulomb, the passive state and the other options.
- Press Analyze
Press Analyze. A window reports All checks satisfied or lists the warnings. Show results opens the Results tab; Stay on the model (offered with warnings) keeps the Model tab.
- Read the answer and take the report
Results gives the four checks for the static case and each seismic case; Calculations shows the working; Report saves a PDF or a Word file.
The screen: four views of the wall
The layout is the one every GeoTerva module shares, described in the workspace guide. The drawing on the left has four views, chosen with the buttons above it, and a row of four summary cards below it.
2D View
A section of the wall with all its dimensions, the soil with its name, unit weights and friction angle, the backfill slope β, the ground in front, the water tables (dashed lines marked GWT) and the surcharges. The ringed mark pivot O is the toe, the point the overturning moments are taken about. The 2D view follows your inputs before Analyze and after it.
Strip and point loads appear on the drawing with their values and distances from the back face of the wall at its top. The drawing is scaled so that the farthest strip or point load stands on the drawn ground, and the labels of a uniform, a strip and a point load are stacked so that they do not overlap.
Nothing on the drawing is dragged to change a value. A strip or point load is pressed on the drawing to open it in the load form of the Surcharge Load section.

3D View
The wall extruded along its length, a picture of the section you entered. Drag to rotate · double-click to reset: dragging turns the wall, and a double-click returns the starting angle. The 3D view shows the wall only: loads, water and results are not drawn in it.

Pressure and Forces
Both views are available after Analyze; before it they say “Not analysed — press Analyze on the Model tab”. They are drawings of the same results, with chips above them:
- Pressure draws the pressures on the Virtual back (the plane x = B through the back edge of the footing), on the Front resistance of the footing, or the water pressure under the base (Base uplift). The last two are offered when the model has them, and in those two views the Layers group gives way to a Shown note, because their content is fixed. Load case switches between Static and the seismic cases; Layers shows or hides each component: soil, surcharge, strip and point loads, seismic increment, seismic total, hydrostatic and hydrodynamic water, and the resultant.
- Forces draws the free body of the wall: every wall part (C1, C2 …) and soil zone (S1, S2 …) with its weight and lever arm, the thrusts, the uplift, the inertia forces, the pivot O, the totals ΣMo, ΣMr and the factor FSo. Its Load case and Layers chips (Weights, Earth pressure, Surcharge, Water & uplift, Seismic, Front resistance) work as in the Pressure view.
- The (?) beside each chip group explains it. The chips change only what is drawn; the checks always use every component.




The summary cards
Four cards under the drawing: Sliding, Overturning, Bearing capacity and Eccentricity. Each shows the Static value against its limit and the Seismic value, the governing seismic case. Before Analyze every value is a dash. Afterwards a card is green when its checks pass and red when one fails; without an earthquake the Seismic side reads a dash and “not analysed”.

Entering the model, section by section
The Model tab is a column of sections. Each opens when you click its title and the others close; Next and Back walk you through. Analyze waits in the bar at the bottom. Units are shown beside the boxes: where two or three are given, they are SI · kN, SI · tf and US in turn. Defaults are the SI · kN values; in US the same example shows, for instance, 9.84 ft for H, 114.59 pcf for γ and 4.177 ksf for qall. The module stops the analysis for values outside the limits named in the field tables; the messages are listed in Messages.
Model data
The first section holds the model itself, not a calculation input. Every change is kept in this browser, so the page opens again with the wall you last modelled, analysed or not. The unit system and the Calculations level of detail are remembered too.
- Model name: a label for the model; it is offered when you save.
- Save to file… writes the model to a .gtrv file (the browser’s Save window where it has one, otherwise a download); Open file… reads one back.
- Quick Save… asks for a name and keeps this version in the browser; choose it in the list and press Load, or Delete. A name that exists asks whether to replace it. A Quick Save holds every input, whether the model was analysed, and the report cover, and lives only in this browser; use a file to move a model.
- Reset to defaults returns every input to the example without a question (the unit system stays) and says “The inputs are back at the module defaults, and this is now the model kept in the browser.”

Geometry
A trapezoidal body on a stepped footing. H is the total height from the underside of the base to the top of the wall; the batter offsets and the footing projections and heights are set separately on the front (toward the toe) and on the back (toward the backfill). The section shows the derived base width B = Wbl + Wdl + Wu + Wdr + Wbr and says the analysis strip is 1.0 m (all forces are per metre run).

| Field | Default | What to enter |
|---|---|---|
| H total wall height | 3.00 m · ft | Greater than zero. The two footing heights must be smaller than H. |
| Wu top width | 1.00 m · ft | Greater than zero. |
| Wdl, Wdr batter offsets, front and back | 0.50 m · ft each | Zero or more; zero gives a vertical face. |
| Wbl, Wbr footing projections, front and back | 0.50 m · ft each | Zero or more. |
| Hfl, Hfr footing heights, front and back | 0.50 m · ft each | Greater than zero and smaller than H. |
Backfill Slope
Flat (the default) or Inclined. For Inclined enter the slope angle β in degrees; it rises away from the wall when positive and falls away when negative. The uniform surcharge follows the same ground line, and a readout shows the surface mode and the slope.

| Field | Default | What to enter |
|---|---|---|
| β backfill slope angle | 0.0° | Between −45° and 45°, the limits themselves refused; the box arrows run over the same range, −44.5° to 44.5°. The magnitude must also stay below φ′ (see Messages). A flat backfill sets β = 0. |
Passive-Side Fill
The height Df of the ground in front of the wall above the underside of the base. Where it stands above the top of the front footing (Hfl), the fill over the footing moves with the wall and its weight is a vertical load. The lateral resistance on the front face of the footing, from the front ground (less hignore) down to the base, is credited at the state chosen in Analysis Settings. Enter Df = 0 if the front soil may be removed.

| Field | Default | What to enter |
|---|---|---|
| Df front ground height | 0.00 m · ft | From 0 to H. |
Soil Definition
One soil for the backfill, the ground in front and the foundation. The soil is cohesionless (c′ = 0).

| Field | Default | What to enter |
|---|---|---|
| Name | Soil | The label shown on the drawing. |
| γ moist unit weight | 18.0 kN/m³ · t/m³ · pcf | Greater than zero. |
| γsat saturated unit weight | 20.0 kN/m³ · t/m³ · pcf | Greater than zero and greater than γw. Used below the water table. |
| φ′ effective friction angle | 30.0° | Greater than 0° and smaller than 60°. |
| μb base friction coefficient | 0.55 | Greater than zero. The base resists sliding by μb·Neff; no adhesion is used. |
| qall allowable bearing pressure | 200 kPa · t/m² · ksf | Greater than zero. |
Surcharge Load
Up to six loads on the ground behind the wall, of three kinds. Choose the kind in New load, fill its boxes and press + Add load: it joins the table (“0 of 6”, “1 of 6” … counts them). Press a row, or the load on the drawing, to edit it (Done returns to a new load; Delete load removes it; × removes a row). Several uniform loads add up.
The lateral pressure of a strip or point load is taken by the elastic solutions for a rigid wall, as the section says. A load with a zero value is left out of the calculation.

| Field | Default | What to enter |
|---|---|---|
| q uniform surcharge | 10.0 kPa · t/m² · ksf in the form | Zero or more; acts over the whole retained surface. The table starts empty, so the example has no surcharge until you press Add load. |
| qs strip load; x1, x2 edges | empty | Load zero or more; near edge x1 zero or more; far edge x2 greater than x1 (the box stops at 0.1). Distances run from the back face of the wall at its top. |
| Q point load; x distance | empty | Load zero or more; distance zero or more. A point load closer than 0.30 m is calculated at 0.30 m. |
Groundwater
Two independent switches, both off in the example. Retained side water: zw is the depth of the water table below the top of the wall, and γw the unit weight of water. Front-side water: hwf is the height of water above the underside of the base in front of the wall. Below the retained water table the soil is taken at γsat, with the pore pressure as a force of its own.

| Field | Default | What to enter |
|---|---|---|
| zw water depth below the wall top | 1.50 m · ft | Zero or more. |
| γw water unit weight | 9.81 kN/m³ · 1.00 t/m³ · 62.45 pcf | Greater than zero; γsat must exceed it. |
| hwf front water height | 0.30 m · ft | Zero or more. |
Earthquake
No (the default) or Yes. With Yes the module adds the seismic cases: Mononobe–Okabe thrust on the same pressure plane, the inertia of the wall and of the soil that moves with it, and hydrodynamic water. kv is taken upward and downward, and both cases are checked; with kv = 0 there is a single case.
The module takes kh and kv as you enter them.

| Field | Default | What to enter |
|---|---|---|
| kh horizontal coefficient | 0.15 | From 0 up to, not including, 1. |
| kv vertical coefficient | 0.10 | From 0 up to, not including, 1. |
Wall material
Stone masonry (the default, 22 kN/m³) or Plain concrete (24 kN/m³). Choosing a material sets its usual unit weight; the value in the box can then be changed.

| Field | Default | What to enter |
|---|---|---|
| γm unit weight of the wall | 22.0 kN/m³ · 2.24 t/m³ · 140.05 pcf | Greater than zero. |
Stability criteria
The minimum factors of safety the checks are compared with. The eccentricity limit B/6 and the allowable pressure are not entered here.

| Field | Default | What to enter |
|---|---|---|
| FSs sliding, static | 1.50 | Greater than zero. |
| FSo overturning, static | 2.00 | Greater than zero. |
| FSse sliding, seismic | 1.10 | Greater than zero. |
| FSoe overturning, seismic | 1.10 | Greater than zero. |
Analysis Settings
The method and the options of the passive resistance and the uplift. They are described in Choosing the method.
The passive state offers Full Passive, 2/3 Passive + 1/3 Rest, 1/3 Passive + 2/3 Rest (the default) and Full Rest.

| Field | Default | What to enter |
|---|---|---|
| Static earth pressure | Rankine | Rankine or Coulomb. |
| w passive state | 1/3 Passive + 2/3 Rest | Four choices, listed below the table. |
| toe: include toe passive resistance | on | A switch. |
| hignore unreliable top layer | 0.00 m · ft | Zero or more. |
| ηp,E seismic passive credit | 0.00 | From 0 to 1. |
| Base uplift: Include | on | A switch. |
Choosing the method and the options
Static earth pressure: Rankine or Coulomb
Both act on the vertical plane through the back edge of the footing (x = B), soil against soil, so no wall friction is used: the thrust is parallel to the backfill surface (δ = β). For this plane the Coulomb thrust equals the Rankine thrust exactly. With a flat backfill the two give the same Ka; with a sloping backfill the Rankine card shows the horizontal coefficient and the Coulomb card the coefficient along the surface, and the forces are identical. In the example with β = 10° the module gives Ka = 0.3442 for Rankine and 0.3495 for Coulomb, and the same sliding factor of 2.75, overturning factor of 8.53 and qmax of 61.80 kPa in both.
Seismic earth pressure: Mononobe–Okabe
Always Mononobe–Okabe, on the same plane. The module finds θ = tan⁻¹(kh / (1 ± kv)), the thrust PAE and the increment ΔPAE = PAE − PA over the static thrust, which acts at 0.6 of the plane height above its bottom. The static thrust keeps its static diagram. Hydrodynamic water is always included when the earthquake is on and water is present.
Passive resistance in front of the footing
The soil in front adds a resistance to sliding only (never to overturning or bearing): Ptoe = ∫Kmob·σ′v dz over the front face of the footing, with Kmob = w·Kp + (1 − w)·K0, Rankine Kp, Jaky K0. The passive state w chooses how much of the full passive resistance is relied on. The weight of the fill over the front footing is used whether the toe switch is on or off.
The table gives the resistance and the sliding factor of the example with Df = 0.8 m (nothing else changed; the foundation is the same soil):
| Option | Ptoe kN/m | FSs |
|---|---|---|
| Full Passive (w = 1) | 17.28 | 3.74 |
| 2/3 Passive + 1/3 Rest | 12.48 | 3.56 |
| 1/3 Passive + 2/3 Rest (the default) | 7.68 | 3.38 |
| Full Rest (w = 0) | 2.88 | 3.21 |
| Toe switch off | 0.00 | 3.10 |
- hignore lowers the ground the passive stresses start from, for soil that may be lost to frost, erosion or a trench. With hignore = 0.3 m the example gives Ptoe = 3.00 kN/m and FSs = 3.21.
- ηp,E is the share of Ptoe credited in the seismic cases; the default 0 gives friction only. With Df = 0.8 m and an earthquake, 0 gives a seismic sliding factor of 1.36 (kᵥ upward) and 0.5 gives 1.43.
- The (?) beside the passive-resistance options opens a window with a sketch of each option and its formula; it is a reading aid and changes nothing.

Base uplift
With water present, the pore pressure under the base is a linear head between the retained and the front water levels, and its resultant U reduces the effective normal force. It is a drainage assumption about the foundation; a blocked drain or an artesian layer needs its own head. In the example with the retained water on, U = 22.07 kN/m at x = 2.000 m from the toe, and switching the uplift off changes the sliding factor from 2.01 to 2.36.
Analyze and read the results
Press Analyze. A progress bar runs, the model locks, and a window opens:
- All checks satisfied with “Every stability check of this model is satisfied and the calculation raised no warning.” and Show results.
- Attention — N warnings with “Review these points before the results are used.”, the warnings, Show results and Stay on the model.
The bar then reads Analysed — all checks satisfied (or Analysed — N warnings) with Edit inputs and, with warnings, a Warnings (N) button that opens the list again. Edit inputs asks “The results will be cleared. Edit the inputs?” and unlocks the model. The unit system can still be changed while the model is locked; the cards and tables convert. The analysed state is kept in the browser with the model.

The Results tab
Opened by Show results, or by the tab. Design checks is a table of the four checks (and the information line qmin ≥ 0) for the static case and for each seismic case. Each cell gives the value, the limit and the verdict, with a bar of demand over capacity (FS: required / FS; qmax / qall; |e| / (B/6)) and a tick at 1.0. The case that governs each check is outlined and marked GOVERNING. A banner above says All checks satisfied or, for example, 1 check not satisfied, naming the check.

| Check | Limit | The example |
|---|---|---|
| Sliding FSs | required 1.50 | 3.04 |
| Overturning FSo | required 2.00 | 9.68 |
| Bearing qmax | limit 200.00 kPa | 56.75 kPa |
| Eccentricity |e| | limit 0.500 m | 0.070 m |
| qmin (information) | full contact | 42.75 kPa |
Verdicts are OK and NOT OK; qmin is marked info (a negative qmin says the base is only partly in contact, the same condition as |e| > B/6). Where the resultant falls outside the base the bearing and eccentricity cells say cannot be evaluated with the reason.

Below the checks the tab gives the pressure resultants (the horizontal resultant and height of each component, the uplift, the seismic total and increment, the hydrodynamic water and the inertia), the weights, lever arms and moments of the wall parts and the soil zones with a polygon check, and cards for the earth pressure (Ka, Kae, Pa, the water force) and for the static and seismic stability.

Reading a failing check
When a check fails, its cell shows NOT OK in red, the card under the drawing turns red, and the warnings name the cause and a remedy, for example “Widen the base or increase the front resistance.”

The Calculations tab, the report and the Theory tab
Calculations
Two levels, chosen with Summary and Detailed above the working; the choice is kept in the browser. A contents list opens each section, with open all and close all.
- Summary has one short step per result with the formula and your numbers: Geometry and weights, Earth-pressure coefficients, one Load case section for the static case and each seismic case (resultants, sliding, overturning, bearing), and a Summary of checks. Four sections for a static model, six with the two seismic cases.
- Detailed is the full working in eight sections: Input data (every value the calculation uses), Geometry and wall components (each part with area, centroid, weight and moment), Soil weights, Earth-pressure coefficients and stresses, Pressures, Stability (the force ledger, sliding, the moments about the toe, the base pressure), Summary of checks, and Assumptions and warnings. With an earthquake each seismic case adds its own Seismic case, Pressures and Stability sections: fourteen sections with both kv directions.


Report
Fill the Report cover (project, location, client, report number, date, prepared by, title or qualification, checked by, and optional notes printed only when filled in). It is kept in the browser and saved with the model file. Save as PDF and Download Word (.docx) are greyed out until the model is analysed. The module offers one report, the Summary report, and the preview below the buttons is that report.
Its parts follow the model: for the example, 1 Purpose and scope, 2 Design basis and assumptions, 3 Geometry and section, 4 Soil, material and load parameters, 5 Resisting forces, 6 Lateral earth pressure coefficients, 7 Driving forces, 8 Overturning check, 9 Sliding check, 10 Eccentricity and base pressure, 11 Summary of results. With an earthquake, Seismic parameters is added and the driving forces and the overturning check gain the seismic cases (12 parts).

Theory
The Theory tab explains the model in sections that open one by one: an overview and the wall system, the coordinates and free body, the geometry decomposition, the soil moving with the wall, effective stress, Rankine, Coulomb, at-rest and passive resistance, surcharge, hydrostatic water and uplift, Mononobe–Okabe, hydrodynamic water, the inertia of the wall and the soil, sliding, overturning and bearing, the scope of the checks, a worked example, the variables and the references. The internal stresses of the masonry or concrete body (compression, tension, shear along joints) belong to the structural design of the wall.
Worked example: the module’s own example
The module opens on this wall. All values are per metre run of wall.
| Section | Input | Value |
|---|---|---|
| Geometry | H, Wu, batters, footing projections, footing heights | H = 3.00 m, Wu = 1.00 m, Wdl = Wdr = 0.50 m, Wbl = Wbr = 0.50 m, Hfl = Hfr = 0.50 m, so B = 3.00 m |
| Soil | γ, φ′, μb, qall | 18.0 kN/m³, 30°, 0.55, 200 kPa |
| Material | γm | stone masonry, 22.0 kN/m³ |
| Others | flat backfill, Df = 0, no loads, no water, no earthquake | Rankine, passive state 1/3 Passive + 2/3 Rest |
Weights
Five wall parts: the front block 11.00 kN/m at x̄ = 0.500 m, the front batter 13.75 at 0.833, the core 66.00 at 1.500, the back batter 13.75 at 2.167 and the back block 11.00 at 2.500: Wm = 115.50 kN/m with a moment of 173.25 kN·m/m about the toe. The soil that moves with the wall (1.875 m² × 18) is Ws = 33.75 kN/m at x̄ = 2.611 m, moment 88.13. N = 115.50 + 33.75 = 149.25 kN/m.
Earth pressure
Ka = (1 − sin 30°) / (1 + sin 30°) = 0.3333; the pressure is 0 at the top and Ka·γ·H = 18.00 kPa at the base, so Pa = ½ · 0.3333 · 18 · 3.00² = 27.00 kN/m, at H/3 = 1.000 m above the base. Passive resistance is zero (Df = 0).
Sliding
Overturning
Base pressure and eccentricity
xR = (261.375 − 27.00) / 149.25 = 1.5704 m from the toe, so e = B/2 − xR = 1.5000 − 1.5704 = −0.0704 m (the Results tab shows 0.070 m), which is inside B/6 = 0.500 m. qmax = 149.25 / 3 · (1 + 6 · 0.0704 / 3) = 56.75 kPa and qmin = 42.75 kPa, against qall = 200 kPa. These are the numbers of the Results tab, the Calculations tab and the report.
The same wall with an earthquake
Switch Earthquake to Yes (kh = 0.15, kv = 0.10). With kv upward, θ = tan⁻¹(0.15 / 0.90) = 9.46°; Mononobe–Okabe gives PAE = 32.51 kN/m, an increment of 5.51 acting at 1.800 m, and the inertia of the wall and soil is 0.15 × 149.25 = 22.39 kN/m. Sliding: FSs = 0.55 × 134.325 / (32.51 + 22.39) = 1.35. Overturning: the upward kv·W adds to the overturning moment, Mo = 93.79 kN·m/m, so FSo = 261.375 / 93.79 = 2.79; qmax = 67.37 kPa and |e| = 0.252 m. With kv downward, θ = 7.77° and the factors are 1.50 (sliding), 3.74 (overturning) and qmax = 78.51 kPa. All against 1.10, 1.10 and 200 kPa: OK. The Results tab marks the kᵥ upward case as governing for sliding and overturning.
The same kind of wall in US units and in SI · tf
In US, enter H = 12 ft, Wu = 3 ft, the batter offsets, the footing projections and the footing heights 1.5 ft each, γ = 115 pcf, γsat = 125 pcf, φ′ = 32°, μb = 0.5 and qall = 4 ksf (the wall unit weight stays at its default, 140.05 pcf). The module gives FSs = 2.21, FSo = 5.85, qmax = 1.33 ksf and |e| = 0.100 ft. In SI · tf with H = 4 m, γ = 1.9, γsat = 2.1 and γm = 2.3 t/m³, φ′ = 32° and qall = 25 t/m² (other values as in the example), it gives FSs = 2.42, FSo = 5.83 and qmax = 7.29 t/m². A hand calculation of the same walls in SI units with the converted values gives the same factors.
How each input changes the answer
Each row changes one thing in the example (H = 3 m, Wu = 1 m, batters, projections and footing heights 0.5 m, γ = 18 kN/m³, γsat = 20 kN/m³, φ′ = 30°, μb = 0.55, γm = 22 kN/m³, flat backfill, no loads, no water, no earthquake, Rankine) and runs the module again; a remark under the change names anything else that is set. The numbers are the ones the module gives, so you can reproduce any row.
| Change | Sliding FSs | Overturning FSo |
|---|---|---|
| The example qmax = 56.75 kPa | 3.04 | 9.68 |
| Plain concrete γm 24 kN/m³ instead of 22 · qmax = 60.25 kPa | 3.25 | 10.26 |
| γm = 18 kN/m³ a lighter body · qmax = 49.75 kPa | 2.61 | 8.51 |
| φ′ = 25° Ka = 0.4059 · qmax = 52.83 kPa | 2.50 | 7.95 |
| φ′ = 35° Ka = 0.2710 · qmax = 60.12 kPa | 3.74 | 11.91 |
| γ = 20 kN/m³ the backfill is heavier · qmax = 58.78 kPa | 2.81 | 9.04 |
| H = 4 m all other dimensions as in the example · qmax = 72.92 kPa | 2.24 | 5.41 |
| H = 5 m all other dimensions as in the example · qmax = 119.08 kPa | 1.78 | 3.45 |
| Wu = 1.5 m B = 3.5 m · qmax = 61.35 kPa | 3.71 | 13.51 |
| Wbr = 1.0 m the back footing is longer, B = 3.5 m · qmax = 58.08 kPa | 3.61 | 13.05 |
| Wbl = 1.0 m the toe is longer, B = 3.5 m · qmax = 63.59 kPa | 3.15 | 12.50 |
| μb = 0.40 only sliding changes · qmax = 56.75 kPa | 2.21 | 9.68 |
| β = 10° (Inclined) Rankine; the Coulomb option gives the same · qmax = 61.80 kPa | 2.75 | 8.53 |
| A uniform surcharge of 10 kPa added in Surcharge Load · qmax = 52.75 kPa | 2.22 | 6.22 |
| Retained water on, zw = 1.5 m uplift on (default) · qmax = 44.89 kPa | 2.01 | 3.52 |
| Retained water on, uplift off zw = 1.5 m · qmax = 55.41 kPa | 2.36 | 8.52 |
| Retained water on, zw = 0.5 m uplift on; the module warns · qmax = 54.07 kPa | 1.28 | 2.25 |
| Df = 0.8 m passive state 1/3 Passive + 2/3 Rest, toe on · qmax = 55.35 kPa | 3.38 | 9.71 |
| Earthquake, kᵥ upward kh = 0.15, kv = 0.10; the governing case · qmax = 67.37 kPa | 1.35 | 2.79 |
What the rows show:
- Height has a large effect. Raising H to 5 m while the base stays 3 m wide takes FSo from 9.68 to 3.45 and qmax from 56.75 to 119.08 kPa: the thrust grows with H², the moment with H³.
- A longer toe raises overturning and sliding but also the toe pressure: Wbl = 1 m gives qmax = 63.59 kPa and qmin = 24.84 kPa, against 56.75 and 42.75 for the example.
- Water behind the wall costs a great deal: FSo falls from 9.68 to 3.52 with zw = 1.5 m, and to 2.25 with zw = 0.5 m. The uplift is a large part of it: with the uplift off FSo is 8.52.
- μb changes sliding only. FSs goes from 3.04 to 2.21 and nothing else moves.
- A sloping backfill, a surcharge and the friction angle act through the thrust: φ′ = 25° raises Pa from 27.00 to 32.88 kN/m, φ′ = 35° lowers it to 21.95.
- The earthquake takes sliding to 1.35 and overturning to 2.79 in the governing case; the seismic requirement is lower (1.10), and the retained water with zw = 0.5 m gives lower factors still.
Messages: when the module stops and when it warns
Stops
When a value cannot be used, Analyze opens a window titled Check the inputs with the problems in a list and the button Back to the model. Nothing is calculated; the bar keeps Not analysed. Correct the values and press Analyze again. A combination of values that has no solution opens a window of its own, listed in the table.

| When | Message |
|---|---|
| H is zero or empty | “The wall height H must be greater than zero.” (with H = 0 the two footing heights are reported as well: “The front footing height Hfl must lie between 0 and H.” and “The back footing height Hfr must lie between 0 and H.”) |
| Wu is zero | “The top width Wu must be greater than zero.” |
| A batter offset is negative | “The batter offsets Wdl and Wdr must be zero or more.” |
| A footing projection is negative | “The footing projections Wbl and Wbr must be zero or more.” |
| A footing height is zero or not below H | “The front footing height Hfl must lie between 0 and H.” or “The back footing height Hfr must lie between 0 and H.” |
| β outside −45° to 45° (or at a limit) | “The backfill slope β must lie between −45° and 45°.” |
| β not smaller than φ′ in magnitude | A different window, titled The wall could not be analysed: “No real Rankine inclined-backfill solution for the entered β and φ′ (β must be smaller than φ′).” With Coulomb: “No real Coulomb solution for the entered β and φ′.” |
| Df above H | “The front ground height Df must lie between 0 and H.” |
| γ or γsat not positive; γsat not above γw | “Enter a positive moist unit weight γ.” · “Enter a positive saturated unit weight γsat.” · “γsat must exceed the water unit weight γw.” |
| φ′ zero or 60° and above | “The friction angle φ′ must lie between 0° and 60°.” |
| μb or qall not positive | “The base friction coefficient μᵦ must be greater than zero.” · “The allowable bearing pressure must be greater than zero.” |
| γm not positive; a required factor not positive | “Enter a positive unit weight of the wall material.” · “The stability criteria must be positive.” |
| Water on and zw or hwf negative | “The groundwater depth zw must be zero or more.” · “The front water height hwf must be zero or more.” |
| Earthquake on and kh or kv not below 1 | “kₕ must lie between 0 and 1.” · “kᵥ must lie between 0 and 1.” |
| ηp,E outside 0 to 1; hignore negative | “The seismic passive credit factor ηp,E must lie between 0 and 1.” · “The unreliable top layer hignore must be zero or more.” |
| A strip or point load is incomplete | For example “Strip load 2: the far edge x₂ must be greater than the near edge x₁.” When you press Add load with such values, the form says “The new load: the far edge x₂ must be greater than the near edge x₁.” |
When several values are wrong the messages are listed together.
Warnings
The module calculates and reports, and the window Attention — N warnings lists what to review, each with a remedy. The messages, as the module words them:
- “Sliding factor of safety below the requirement (static). FS = 0.99 < 1.50. Widen the base or increase the front resistance.” (also for each seismic case, written “(seismic +kₕ, kᵥ upward)” or “downward”).
- “Overturning factor of safety below the requirement (static). FS = 1.75 < 2.00. Widen the footing (Wbl, Wbr) or the body of the wall.”
- “Bearing pressure exceeds the allowable value (static). qmax = 56.75 kPa > qall = 40.00 kPa. Widen the base or reduce the loads.”
- “Partial base contact (seismic +kₕ, kᵥ upward). The resultant lies outside the middle third, so part of the base lifts off. Widen the base or reduce the lateral load.”
- “The retained groundwater table is 0.176 m above the ground at the top of the pressure plane (Static): the water column is taken to the plane bottom (hw = 3.000 m) and only its part below the plane top loads the plane.” followed by “The groundwater table lies above the backfill surface behind the wall, so free water would stand on the ground. Check the groundwater depth zw and the backfill slope β.”
- “The seismic load cases are not evaluated. No real Mononobe–Okabe equilibrium solution: the thrust has no maximum — it keeps growing as the failure plane approaches the backfill surface (θ = 37.87° > φ′ − β = 30.00°). Change the soil and seismic parameters under Analysis Settings. The static case below is unaffected.” (shown, for example, with φ′ = 30°, kh = 0.70 and kv = 0.10).
- “Front water height exceeds the passive-side soil height.” followed by “The water in front of the wall stands above the front fill. Check the front water height hwf against the front ground height Df.”
Where the resultant falls outside the base, the bearing and eccentricity cells read cannot be evaluated with “The resultant falls outside the base — the wall overturns.”
Good practice and common mistakes
- Enter Df = 0 when the soil in front may be removed. Then no fill weight and no passive resistance are credited. If you keep the front soil, consider hignore for the top layer that frost, erosion or a trench can take away.
- Treat water honestly. Behind the wall it cuts FSo by a large factor in the example; a wall with no drain needs the water switched on. Switch the uplift off only when the base is drained.
- Read the dynamic card as the governing seismic case. Look at both kv directions in the Results tab; the weaker one governs.
- Mind the sign of β. A positive angle rises away from the wall and raises the thrust; a negative one falls away.
- Use the passive state you can rely on. The default 1/3 Passive + 2/3 Rest credits a modest part of the passive resistance; the seismic credit ηp,E is 0 unless you decide otherwise.
- Add loads one by one and check the table. Up to six; strip and point loads are measured from the back face of the wall at its top.
- The checks are external. The module treats the body as one rigid block; the internal stresses of the masonry or concrete are for the structural design.
- Keep a record. Use Save to file for the project; the browser keeps the last model, and Quick Saves live in this browser only.
Frequently asked questions
What does the module check?
Sliding along the base, overturning about the toe, the largest base pressure against the allowable pressure, and the eccentricity of the base resultant against B/6, for the static case and, with an earthquake, for kv upward and downward. The example gives 3.04, 9.68, 56.75 kPa and 0.070 m.
On what plane is the earth pressure calculated?
On the vertical plane through the back edge of the footing, soil against soil, with the thrust parallel to the backfill surface. The soil between that plane and the back of the wall is counted as weight that moves with the wall. For this plane Coulomb and Rankine give the same thrust.
Which earth-pressure theory does the earthquake use?
Mononobe–Okabe, always, on the same plane, with the kh and kv you enter; the increment over the static thrust acts at 0.6 of the plane height above its bottom. kv is applied upward and downward and both cases are checked.
Does passive resistance help overturning or bearing?
No. The resistance of the soil in front of the footing is added to sliding only. Its state (w), the toe switch, hignore and, for the earthquake, ηp,E control how much is credited.
What if the front soil may be removed?
Enter Df = 0. Then there is no fill over the front footing and no passive resistance in the checks.
How many surcharges can I add, and how are they placed?
Up to six: uniform (over the whole surface), strip (near and far edge) and point (distance from the wall). Distances are measured from the back face of the wall at its top. A point load closer than 0.30 m is calculated at 0.30 m.
Can I move the wall or a load by dragging on the drawing?
No. Values are entered in the boxes. The only actions on the drawings are pressing a load to open it in the form, and, in the 3D view, dragging to rotate and double-clicking to reset.
Does the module remember my inputs?
Yes. Every change is kept in this browser, including whether the model was analysed, the unit system and the level of detail of the Calculations tab. The page opens on the last model; Reset to defaults returns to the example. Save to file and Quick Save keep versions.
Why does the Analyze window show warnings when every card is green?
Warnings also cover input conditions, for example a groundwater table above the ground behind the wall, or front water standing above the front fill. They are listed in the window and under Warnings in the bar.
Why is the overturning factor so much larger than the sliding factor in the example?
The weight acts about 1.5 m from the toe while the thrust acts about 1 m above the base, so the restoring moment is large; sliding depends on friction alone. Both are computed from the same forces, which you can follow in the force ledger of the Detailed calculation.
How do I change the unit system?
Choose SI · kN, SI · tf or US at the top right, before or after Analyze. Boxes, cards, tables and drawings convert; the calculation is the same. The module notes the unit beside every box.
What does the report contain?
A cover with your project details, then parts for the purpose and scope, the design basis and assumptions, the geometry, the soil, material and load parameters, the resisting forces, the earth-pressure coefficients, the driving forces, the overturning check, the sliding check, the eccentricity and base pressure, and a summary of results. It is saved as a PDF or a Word file after Analyze.