SlipSurfaceIQ LE — reference
Calculation engine
| Method | Equilibrium | Surfaces |
|---|---|---|
| Bishop simplified | moment | circular |
| Ordinary / Fellenius | moment (circle) / force | circular and non-circular |
| Janbu simplified / corrected (f0) | force | circular and non-circular |
| Corps of Engineers #1, #2 | force | circular and non-circular |
| Lowe-Karafiath | force | circular and non-circular |
| Spencer | force + moment | circular and non-circular |
| GLE / Morgenstern-Price (half-sine, constant, clipped sine, trapezoidal) | force + moment | circular and non-circular |
- Slicing: a chosen number of equal-width slices plus extra boundaries at every ground, water table, load and polyline-surface vertex, so the top of each slice is straight. Slice weights are integrated through all material regions (γ above, γsat below the water table).
- Non-linear strength: for curved envelopes the solvers iterate on the effective normal stress on each slice base and use the instantaneous (tangent) c and φ.
- Admissibility: solutions with mα < 0.2 (Whitman & Bailey) or a negative mobilised base shear are rejected; interslice forces above a configurable multiple of the total weight are treated as singular. Both checks can be tuned in Project Settings → Advanced.
- Failure direction: right-to-left or left-to-right.
- Geometry: the ground must be a continuous, single-valued profile y(x). Vertical slope faces and overhangs are rejected with an explanatory message; vertical sides at the outer model limits are supported.
Material models
Every material has a unit weight, an optional saturated unit weight, a colour and water parameters (whether the water table acts on it and the piezometric factor Hu).
| Model | Strength | Notes |
|---|---|---|
| Mohr-Coulomb | τ = c′ + σ′n tan φ′ | |
| Undrained (Tresca) | τ = su | total stress, pore pressure not used |
| SHANSEP | su = max(su,min ; S · σ′v · OCRm) | Ladd & Foott; σ′v at the slice base |
| Hardening Soil | τ = c′ + σ′n tan φ′ | the Mohr-Coulomb failure surface of the HS model; stiffness parameters stored for reference |
| SANISAND | τ = σ′n tan φ(ψ) | state parameter ψ = e − ec (Dafalias & Manzari 2004) |
| Power-law envelope | τ = a · pa · (1 + σ′n/pa)b | concave envelope for granular materials |
| Power Curve | τ = a (σ′n + d)b + c | as in Slide2 |
| Barton-Bandis | τ = σ′n tan(φr + JRCn log10(JCSn / σ′n)) | joints, with scale correction |
| CNI rock mass | τ = a · σc · ((σn − T0) / σc)n | Cylwik, Killian & Cicchini (2023) |
| Generalised Hoek-Brown | σ1 = σ3 + σci (mb σ3/σci + s)a | mb, s, a from GSI, mi and D (Hoek et al. 2002) |
| Hoek-Brown (mb, s, a) | same envelope | mb, s and a entered directly |
The Hoek-Brown envelopes are converted to τ–σn curves (Balmer) and used with instantaneous c and φ.
Groundwater, seismic loads and tension cracks
- Water table: u = Hu · γw · (water table − base elevation); Hu and whether the water acts are set per material. Ponded water above the ground is added to the slice weight.
- Ru coefficient: u = Ru · σv.
- Pseudo-static seismic loading: a horizontal force kh·W in the failure direction at the slice centroid; kv positive upward gives a vertical load (1 − kv)·W.
- Tension crack: drawn as a line or created from a depth (Rankine zc = 2c / (γ√Ka) as a suggestion). A slip surface crossing it on the crest side is cut there; the crack can be dry, full or partly filled, and the water thrust V = ½ γw hw² acts at hw/3.
Loads, supports and facings
Distributed loads (uniform or linearly varying, vertical or normal to the surface) and line loads at any angle are included as forces and moments in every method.
| Support type | Force T (per support, divided by the out-of-plane spacing) |
|---|---|
| End anchored | tensile capacity |
| Grouted tieback | min(tensile, bond strength × min(bond length, Lout)) |
| Soil nail | min(tensile, bond × Lout, plate + bond × Lin) |
| Geotextile | min(tensile strength, pullout × min(Lin, Lout)) |
| Geosynthetic | min(C · tensile, Pin, Pout), with anchorage options |
| Micro-pile | pile shear strength |
Each support is active (reduces the driving force) or passive (mobilised like shear strength, T/F), and acts parallel to the support, tangent to the slip surface or perpendicular to the support. Bolts can be placed one by one on the slope face or as bolt patterns. A shotcrete + wire-mesh facing adds its weight as a surface load and, where the slip surface passes through it, a resisting force T = τ·t + As·fy.
Critical surface search
- Circular: each candidate is defined by its two ground intersections and the central angle, so every candidate is a valid circle.
- Non-circular, polyline: straight segments through interior vertices; the best surface is refined by optimising every vertex, then inserting mid-segment vertices and optimising again.
- Non-circular, B-spline: a smooth surface, optionally convex only.
- User-defined: a hand-drawn surface is analysed directly.
- Optimiser: differential evolution (global) + Nelder-Mead (local); non-circular searches start from the critical circle of a quick circular pre-search. Search effort: fast, normal or fine.
- Slope limits for the exit and entry points and an optional minimum sliding-mass depth.
The computation runs in the background and can be cancelled; the computing dialog reports the stage, the surfaces evaluated, the best FS and the remaining time.
PDF report
File → PDF Report (Ctrl+P) creates a report in the interface language: a cover with a critical FS card assessed against a target FS (Adequate / Marginal / Inadequate), contents, summary, model figure, material tables, analysis and search settings, loads, supports and facings, a results table and FS comparison chart, critical surface figures, mobilised support forces, tension crack results and appendices with slice data and coordinates. The sections can be switched on or off.
Files, DXF and Python
- Projects are saved as
.slp.json; files from earlier versions are converted when opened. - DXF import and export of the 2D geometry on the layers
SS_EXTERNAL,SS_MATERIAL,SS_WATER,SS_CRACK,SS_SURFACEandSS_SUPPORT. LINE, LWPOLYLINE, POLYLINE, ARC and SPLINE are read; drawing units are converted to metres. - Python scripting (Tools → Python scripting) edits the
projectobject; changes are validated and applied as one undoable step.
Bundled examples
Available under File → Examples, from the command line with --example "<name>", and as project files in the examples folder:
Example (--example) | File | Shows |
|---|---|---|
| Simple slope (10 m, 2H:1V) | simple_slope.slp.json | homogeneous slope |
| ACADS EX1(a) | acads_1a.slp.json | ACADS verification problem |
| Layered slope + water table | layered_water_table.slp.json | fill, soft clay and weathered rock (Hoek-Brown) with a water table |
| Anchored cut + surcharge | anchored_cut.slp.json | two rows of grouted tiebacks, distributed and line loads |
| Slope with tension crack | tension_crack.slp.json | water-filled tension crack in stiff clay |
| Soil nail + shotcrete | soil_nail_shotcrete.slp.json | soil-nail pattern, shotcrete facing, notes |
| Undrained clay | undrained_clay.slp.json | total-stress (su) analysis |
| Power-law envelope | power_law.slp.json | non-linear strength |
| Seismic kh=0.15 | seismic.slp.json | pseudo-static seismic loading |
Verification
The test suite checks the engine against reference solutions, among them:
- ACADS EX1(a): Bishop 0.985, Spencer 0.984, GLE 0.984 (Slide2: 0.987 / 0.986 / 0.986).
- Planar block: every force-equilibrium method reproduces the closed-form rigid-block solution to 10⁻⁶, with seismic loads, external loads and active and passive anchors.
- Hoek & Bray planar sliding with a vertical tension crack (dry, half full, full): seven methods to 10⁻⁶.
- Bishop–GLE moment consistency, support capacity formulas, mirror symmetry, an independent Bishop reference, the infinite slope limit and the tangent consistency of every non-linear strength model.
Roadmap
- Probabilistic analysis (Monte Carlo)
- Sarma method
- Back analysis
Engineering disclaimer. SlipSurfaceIQ LE is provided without any warranty. Results depend entirely on the input geometry, strength parameters, groundwater and loads. Always review them with engineering judgement and, where it matters, with independent calculations.