Skip to content

SlipSurfaceIQ LE — reference ​

Calculation engine ​

MethodEquilibriumSurfaces
Bishop simplifiedmomentcircular
Ordinary / Felleniusmoment (circle) / forcecircular and non-circular
Janbu simplified / corrected (f0)forcecircular and non-circular
Corps of Engineers #1, #2forcecircular and non-circular
Lowe-Karafiathforcecircular and non-circular
Spencerforce + momentcircular and non-circular
GLE / Morgenstern-Price (half-sine, constant, clipped sine, trapezoidal)force + momentcircular 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).

ModelStrengthNotes
Mohr-Coulombτ = c′ + σ′n tan φ′
Undrained (Tresca)τ = sutotal stress, pore pressure not used
SHANSEPsu = 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)bconcave envelope for granular materials
Power Curveτ = a (σ′n + d)b + cas in Slide2
Barton-Bandisτ = σ′n tan(φr + JRCn log10(JCSn / σ′n))joints, with scale correction
CNI rock massτ = a · σc · ((σn − T0) / σc)nCylwik, Killian & Cicchini (2023)
Generalised Hoek-Brownσ1 = σ3 + σci (mb σ3/σci + s)amb, s, a from GSI, mi and D (Hoek et al. 2002)
Hoek-Brown (mb, s, a)same envelopemb, 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 typeForce T (per support, divided by the out-of-plane spacing)
End anchoredtensile capacity
Grouted tiebackmin(tensile, bond strength × min(bond length, Lout))
Soil nailmin(tensile, bond × Lout, plate + bond × Lin)
Geotextilemin(tensile strength, pullout × min(Lin, Lout))
Geosyntheticmin(C · tensile, Pin, Pout), with anchorage options
Micro-pilepile 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.

  • 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_SURFACE and SS_SUPPORT. LINE, LWPOLYLINE, POLYLINE, ARC and SPLINE are read; drawing units are converted to metres.
  • Python scripting (Tools → Python scripting) edits the project object; 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)FileShows
Simple slope (10 m, 2H:1V)simple_slope.slp.jsonhomogeneous slope
ACADS EX1(a)acads_1a.slp.jsonACADS verification problem
Layered slope + water tablelayered_water_table.slp.jsonfill, soft clay and weathered rock (Hoek-Brown) with a water table
Anchored cut + surchargeanchored_cut.slp.jsontwo rows of grouted tiebacks, distributed and line loads
Slope with tension cracktension_crack.slp.jsonwater-filled tension crack in stiff clay
Soil nail + shotcretesoil_nail_shotcrete.slp.jsonsoil-nail pattern, shotcrete facing, notes
Undrained clayundrained_clay.slp.jsontotal-stress (su) analysis
Power-law envelopepower_law.slp.jsonnon-linear strength
Seismic kh=0.15seismic.slp.jsonpseudo-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.

SlipSurfaceIQ LE is free and open-source software under the GNU AGPL-3.0.
Source and downloads on GitHub.