Pore pressure enters the factor of safety through the effective normal stress on the base of each slice, so the water conditions of the model affect the result directly. OGR Slip2D obtains pore pressures from water surfaces drawn on the model, from a pore-pressure ratio, from a constant, from a grid of measured or computed values, or from a finite-element seepage analysis. Which of these a given material uses depends on the groundwater method of the project and on its own water parameters.
2.4.1Choosing the groundwater method#
Two choices work together. The project's Method, on the Groundwater page of Analysis → Project Settings… (Section 2.1.4), says whether pore pressures come from a grid or from a finite-element analysis. Each material's Water Parameters, in Properties → Define Materials… (Water parameters), say where that material takes its pore pressure from. A new material is dry until its water parameters point at something.
| Method | Pore pressure from | To set up |
|---|---|---|
water_table (default), piezo_line | Water surfaces drawn on the model | Draw the water table or piezometric lines and assign them to the materials (Section 2.4.3) |
ru | The pore-pressure ratio of each material | Water Parameters: type ru and the Ru coefficient (The pore-pressure ratio ru) |
none | The water parameters of each material | Leave every material at none for a dry analysis |
grid_total_head, grid_pressure_head, grid_pore_pressure | A grid of points, interpolated | Groundwater → Water Pressure Grid… (Section 2.4.5) |
fea_steady, fea_transient | A finite-element seepage field | The Groundwater menu, step by step (Section 2.9) |
In version 0.1.235 the four methods none, water_table, piezo_line and ru do not change how pore pressure is computed: a material whose type is water_table reads the water table whichever of the four is chosen, and a material left at none is dry under all four. The method matters for the grid methods, for the finite-element methods, and for a rapid drawdown analysis, which runs only with water_table or piezo_line. Choose the method that matches what the materials use, so that the project settings describe the model.
2.4.2How a material takes its pore pressure#
The Type in a material's Water Parameters decides the pore pressure at every point of the material, and so at the base of every slice in it. The theory behind each one is in Section 3.6.
| Type | Pore pressure |
|---|---|
none | Zero: the material is dry. |
water_table | From the water table assigned to the material, by Eq. (2.4.1). Zero above it. |
piezometric | From the piezometric line assigned to the material, by the same equation. |
ru | A fraction of the vertical stress, Eq. (2.4.2). |
constant | The value of Constant u, everywhere in the material. |
fem | Interpolated from the finite-element seepage field; negative values (suction) are kept and handled through the unsaturated parameters. Compute refuses to run without a computed field. |
With a grid method the grid overrides these types, except constant and ru, for every material whose Use the water pressure grid box is ticked (Section 2.4.5).
The seepage field reaches only the materials whose type is fem, but Define Materials hides the whole Water Parameters group while fea_steady or fea_transient is the project method. Set the type of the materials to fem before switching the method in Project Settings. A transient run in which no material uses the field says so in its notes.
Water surfaces and Hu#
Below a water table or a piezometric line, the pore pressure is hydrostatic, scaled by the coefficient :
where
- unit weight of the pore fluid, Pore Fluid Unit Weight in Project Settings (9.81 kN/m³)
- vertical distance from the point up to the water surface (m); where the point is above it
- the material's Hu coefficient when ticked, otherwise the project's Default Hu (1.0); with Auto Hu ticked in the material or in the project, , with the inclination of the water surface above the point
is the hydrostatic pressure under a horizontal water surface. assumes that the equipotential through the point is straight, which is exact only for an infinite slope with seepage parallel to its surface. The pore pressure is zero at any abscissa outside the horizontal extent of the water surface, so draw water surfaces across the whole width of the materials they serve.
The pore-pressure ratio ru#
With the type ru, the pore pressure is a fixed fraction of the vertical stress at the point:
where
- the material's Ru coefficient, 0 to 1
- unit weight of the material that contains the point (its saturated unit weight when it uses one), applied over the whole depth, and depth of the point below the ground surface
- depth of any ponded water above the ground at that abscissa
External loads (distributed, line and seismic) are not part of .
2.4.3Water tables and piezometric lines#
A water table is the phreatic surface; a piezometric line records a pressure head measured or estimated somewhere in the ground. Both give pore pressure by Eq. (2.4.1), but they are not interchangeable:
- a model has one water table at most, and any number of piezometric lines, numbered 1, 2, … in the order they are drawn;
- only the water table forms ponded water where it rises above the ground (Section 2.4.4);
- only the water table allows a separate saturated unit weight below it (General);
- only the water table limits a water pressure grid: with both, above the water table.
To add one:
- Choose Boundaries → Add Water Table (Ctrl+3) or Boundaries → Add Piezometric Line (Ctrl+5).
- Click its vertices from left to right, covering the whole width of the materials it serves, and finish with Enter.
- If the project has materials, the Assign Water Surface dialog opens on the line just drawn: tick the materials that take their pore pressure from it and press OK.
Assign Water Surface#
The dialog also opens from Properties → Assign Water Surface…, and assigns one water surface to several materials at once. Choose the surface in Water Surface; the table lists every material with a check box, ticked for those already assigned to it, and the Current Water Surface of each. Select All and Clear All tick or untick the whole list.
- Ticking a material assigns the surface to it and sets its type to
water_tableorpiezometricto match. - Unticking a material that was assigned to this surface removes the assignment and makes it dry again.
- Materials assigned to a different surface are never changed by unticking.
The same assignment can be made one material at a time with the Water Surface list of Define Materials. A material of type water_table or piezometric left at (first of this type) reads the first surface of that type in drawing order, which is the same thing when there is only one; with several piezometric lines, assign each material explicitly.
2.4.4Ponded water#
Where the water table is drawn above the ground surface (a reservoir against an embankment, or a flooded toe), the space between the two is standing water. OGR Slip2D applies it as a load that needs no assignment to the materials: a hydrostatic pressure normal to the ground surface, on the slices beneath it.
- Piezometric lines never create ponded water, and neither does the drawdown line on its own.
- With a finite-element method the standing water comes from the boundary conditions of the seepage analysis: wherever the prescribed total head is above the boundary.
- Ponded water carries no seismic force (Section 2.5.4).
- It can be shown filled or hatched on the canvas with View → Display Options…, tab Water, Ponded water.
2.4.5Water pressure grid#
A grid gives the pore pressure by interpolation from scattered data points, such as piezometer readings or the output of a seepage analysis made elsewhere.
- In Project Settings → Groundwater choose
grid_total_head,grid_pressure_headorgrid_pore_pressure. The method says what the values of the grid are: total head (then ), pressure head () or pore pressure directly. - Open Groundwater → Water Pressure Grid…, which is greyed out with any other method, and enter the points: type them in the table (Add row, Delete selected, Clear) or read them with Import CSV….
- Press OK. The status bar gives the number of points; an empty table removes the grid.
| Field | Meaning | Default |
|---|---|---|
| Grid type | Read-only: total head, pressure head or pore pressure, from the groundwater method | — |
| Interpolation | Thin Plate Spline: a smooth surface through every point that reproduces a planar field exactly (Harder & Desmarais, 1972). Inverse Distance (IDW): weighted average of the nearest points, with weights inversely proportional to the square of the distance. | Thin Plate Spline |
| IDW neighbours | Number of nearest points used by the inverse-distance interpolation (1 to 64) | 8 |
| Allow suction (keep u < 0) | Keep negative interpolated pore pressures instead of setting them to zero | off |
| x, y, value | The points, in m and in the unit of the grid type (m of head or kPa) | — |
A CSV file holds three numbers per line (, and the value) separated by commas, semicolons, tabs or spaces, with a point as the decimal separator; header lines, blank lines and lines starting with # are skipped. With more than 300 points, or when the spline system is ill-conditioned, the thin plate spline gives way to the inverse-distance interpolation.
The grid governs every material whose Use the water pressure grid box is ticked in Define Materials (the default), except materials of type constant or ru, which keep their own value. Untick the box to let a material take its pore pressure from its own water parameters instead. A water table in the same model sets above itself. View → Display Options…, tab Water, shows the grid values on the canvas.
An interpolated field is reliable inside the cloud of points and much less so outside it, where it is extrapolated. Slip surfaces near the crest often reach beyond the last piezometer: add points there rather than trusting the extrapolation.
2.4.6Excess pore pressure (B-bar)#
A soil of low permeability loaded faster than it can drain responds with a rise in pore pressure, which Skempton (1954) writes as proportional to the change in vertical stress:
The pore pressure used in the analysis is the one the material gets from its water parameters plus this excess. To use it:
- In Project Settings → Groundwater → Advanced choose Calculate Excess Pore Pressure (B-bar method). It cannot be combined with a rapid drawdown or a transient analysis.
- In Define Materials, the Excess Pore Pressure group appears. Give a B-bar greater than 0 to every material that develops excess pore pressure; a material with B-bar 0 is free-draining and develops none.
- Say what loads them. A material with Material weight creates excess pore pressure ticked loads the materials beneath it with its own weight. A distributed or line load with Load creates excess pore pressure (B-bar method) ticked loads the materials beneath it with the vertical component of its force (Section 2.5.6).
The added vertical stress is the stress applied directly above the point, transmitted straight down without spreading, as the method assumes. A line load is a concentrated force, so the stress it adds depends on the width of the slice it falls on, and its excess pore pressure grows as the slices get narrower; model a surcharge whose excess pore pressure matters as a distributed load.
2.4.7Rapid drawdown and finite elements#
Two more ways of obtaining pore pressures have pages of their own:
For a rapid drawdown, choose Rapid Drawdown analysis and a procedure on the Groundwater page of Project Settings, draw the final level with Boundaries → Add Drawdown Line (Ctrl+4), and tick Undrained Behaviour on the materials of low permeability, with a B-bar or an undrained envelope depending on the procedure (Rapid drawdown and excess pore pressure). Groundwater → Drawdown Level Sweep… repeats the analysis at a range of reservoir levels (11 by default, 2 to 101), with or without the total drawdown, and reports the critical level, because the total drawdown is not always the critical one.
The pore pressure at a point is computed in one function for every method of slices, from the material that contains the point and the project's groundwater settings. Ponded water is applied by the slicer as a load on the ground surface, not as a pore pressure.
Source: ogr_core/hydraulic/pore_pressure.py · ogr_core/hydraulic/ponded_water.py · ogr_core/hydraulic/water_pressure_grid.py · ogr_core/hydraulic/excess_pore_pressure.py