Every method of slices needs the shear strength available on the base of each slice. OGR Slip2D offers 22 strength models, from Mohr–Coulomb and undrained strength to Hoek–Brown, Barton–Bandis, anisotropic and tabulated envelopes. The chapter first shows how a curved envelope becomes a cohesion and a friction angle on every slice, then describes each model: the expression the program evaluates, its default parameters and the source of the formula.
3.5.1How a strength model enters the analysis#
A strength model is a function that returns the shear strength available on a plane under an effective normal stress . It enters the analysis through the mobilised shear force on the base of each slice, Eq. (3.1.2). The methods of slices are written for a base with a cohesion and a friction angle (Eq. (3.2.1)), so a model whose envelope is not a straight line is replaced, on each slice, by its tangent at the stress the base carries:
where
- instantaneous cohesion (kPa) and friction angle (°) of slice
- effective normal stress at which the envelope is read on that slice, taken as zero when it is negative (kPa)
Figure 3.5.1 shows the construction on the default Hoek–Brown envelope. Where it can, the program uses the derivative the model supplies; otherwise it differentiates the envelope numerically with a centred step of , one-sided near zero. For Mohr–Coulomb the construction returns and themselves, whatever is.
Where the envelope is read#
The stress is not known before the method has been solved. The first solve reads every envelope at the estimate
where
- total vertical load on the slice: its weight, the loads on its top, any water standing on it, the vertical load of any support crossing it and, under seismic loading, its vertical seismic force (kN/m)
- inclination (°) and length (m) of the base, and pore pressure on it (kPa)
A tangent taken anywhere other than at the stress the method finally resolves is not the envelope there: it lies above a concave curve, and on an envelope that passes through the origin a tangent read at zero stress carries no strength at all. When at least one slice of the surface has an envelope whose slope changes with the stress, OGR Slip2D therefore solves again with each such envelope read at the effective normal stress of the method's own solution, and repeats until the two agree:
Slices whose envelope is a straight line keep the estimate of Eq. (3.5.3), which makes no difference to them. A surface that has not settled after 50 solves is reported as not converged rather than given a factor of safety. How this iteration sits inside each method's own iteration on is described in Section 3.3.7.
The linearisation is BishopSimplified._local_c_phi, shared by every method; the iteration to the method's own stress is the self_consistent_envelope wrapper (tolerance ENVELOPE_STRESS_TOL = 1e-6, at most ENVELOPE_MAX_PASSES = 50 solves), applied to Bishop, both Janbu methods, Spencer, GLE/Morgenstern–Price, Lowe–Karafiath and the two Corps of Engineers methods. The Ordinary method is not wrapped: its base normal force does not depend on or , so the first reading is already the fixed point. A slice whose envelope was read at a negative stress and therefore entered the solver with no strength is listed in the analysis notes.
Models that read more than the normal stress#
Some models depend on where the base is and how it is oriented. For them the solver passes, with , a description of the base: its inclination , the depth of its centre below the ground, the elevation of the top of the material layer it lies in, its distance to the nearest point of the ground surface, the local orientation of the bedding when the material is linked to an anisotropic surface, and the vertical effective stress
where
- vertical load of the slice (its weight and the vertical loads applied to it) and weight of any water standing on it, with no seismic coefficient (kN/m)
- slice width (m)
The tables of this chapter say which of these each model reads. A model that needs the description but is evaluated without one (for instance when an envelope is plotted) states below what it falls back on.
Tensile strength and partial factors#
Two further properties of a model are used elsewhere. Its tensile strength is the tension the Tensile Stress Check tolerates on a slice base (Section 3.3.6); it is zero for every model except the two Hoek–Brown models, for which it is given in Eq. (3.5.19). Its partial-factor category says what a design standard divides when it is active (Section 3.12): and , the undrained strength , or the shear strength as a whole. Table 3.5.1 lists the category of every model.
3.5.2The 22 models at a glance#
Table 3.5.1 lists the models in the order of this chapter, with the name shown in the program, the identifier a project file, the Python API and the command line use, the parameters with their default values, what the model reads besides , and its partial-factor category.
| Model and identifier | Parameters (default) | Also reads | Partial factor |
|---|---|---|---|
Mohr-Coulombmohr_coulomb | cohesion = 10 kPa, friction_angle = 30° | — | |
Undrained (φ=0)undrained | cohesion = 50 kPa | — | |
Undrained, c(depth below layer top)undrained_depth_layer | cohesion_top = 20 kPa, cohesion_change = 2 kPa/m, cutoff = 100 kPa (off) | top of the layer | |
Undrained, c(depth below datum)undrained_depth_datum | cohesion_datum = 20 kPa, cohesion_change = 2 kPa/m, datum = 0 m, cutoff = 100 kPa (off) | elevation of the base | |
Undrained, c(distance to slope)undrained_slope_distance | cohesion_top = 20 kPa, cohesion_change = 2 kPa/m, cutoff = 100 kPa (off) | distance to the ground | |
Drained-Undraineddrained_undrained | cohesion = 5 kPa, phi = 28°, sigma_threshold = 100 kPa | — | |
SHANSEPshansep | S = 0.25, m = 0.8, OCR = 1, A = 0 kPa, su_min = 0 kPa | ||
Vertical Stress Ratiovertical_stress_ratio | K = 0.25, min_strength = 0 kPa | ||
Hoek-Brownhoek_brown_classic | sigci = 15 000 kPa, m = 0.357, s = 0.0017 | — | |
Generalized Hoek-Brownhoek_brown | sigci = 50 000 kPa, mb = 2.5, s = 0.004, a = 0.5 | — | |
Barton-Bandisbarton_bandis | phi_r = 30°, JRC = 8, JCS = 50 000 kPa, max_total_friction = 75° | — | |
Power Curvepower_curve | a = 0.7, b = 1.0, c = 3 kPa, d = 0 kPa, waviness = 0° | — | |
Hyperbolichyperbolic | c_inf = 150 kPa, phi_0 = 20° | — | |
Anisotropic Linearanisotropic_linear | c1 = 5 kPa, phi1 = 15°, c2 = 20 kPa, phi2 = 30°, bedding_angle = 0°, A = 10°, B = 30° | , local bedding | |
Snowden Modified Anisotropic Linearsnowden_anisotropic_linear | bedding_angle = 0°, A1 = A2 = 10°, B1 = B2 = 30°, plus a bedding and a rock-mass strength function | , local bedding | each function's own |
Anisotropic Strength Functionanisotropic_strength_function | table of rows (angle to, , ) | ||
Generalized Anisotropicgeneralized_anisotropic | table of rules (angle range → strength model or material) | , and what each rule's model reads | each rule's own |
Shear/Normal Functionshear_normal_function | table of points (, ) | — | |
Discrete Functiondiscrete_function | table of points (, ) | — | |
C/Phi Functionc_phi_function | table of rows (, , ) | — | |
Infinite Strengthinfinite_strength | none | — | not factored |
No Strength (water)no_strength | none | — | not factored |
Every model is a subclass of StrengthModel registered under its identifier; the registry of version 0.1.235 holds these 22 models. A material is given its model in Properties → Define Materials…, and the parameter names above are the keys of the model's params in a saved .ogr file. The tabulated and composite models store their tables beside the numeric parameters. All stresses are effective stresses in kPa and all angles are in degrees.
3.5.3Soil models#
Mohr–Coulomb#
The linear envelope of Coulomb (1776), written in effective stresses:
A tensile normal stress contributes no friction: below the strength stays at . Strength gained from matric suction above the water table is added to as described in Section 3.5.8.
Undrained strength (φ = 0)#
The total-stress analysis of a saturated clay loaded faster than it can drain, in which the shear strength is the undrained strength and does not depend on the normal stress (Skempton, 1948):
The single parameter is cohesion = (default 50 kPa).
Undrained strength varying with depth#
In a normally consolidated clay the undrained strength is proportional to the vertical effective stress (Ladd & Foott, 1974), so under level ground it grows linearly with depth, and published soft-ground profiles are stated that way (Duncan & Wright, 2005). Three models implement the straight line
where
- undrained strength at the reference, (kPa)
- rate of change with (kPa/m)
- cutoff, applied only when it is enabled: a maximum for a rising profile and a minimum for a falling one (kPa)
The three models differ only in where is measured from (Table 3.5.2). The line is not bounded below zero: where it reaches zero inside a material, that part of the material has no strength, and the analysis notes give the elevation at which this happens.
| Identifier | parameter | Without a slice | |
|---|---|---|---|
undrained_depth_layer | , with the top of the material layer the base lies in | cohesion_top | |
undrained_depth_datum | , negative above the datum | cohesion_datum | |
undrained_slope_distance | distance from the centre of the base to the nearest point of the ground surface | cohesion_top |
Drained–undrained#
A drained Mohr–Coulomb envelope capped by a constant strength, equal to the drained strength at a threshold normal stress :
Its parameters are cohesion = (5 kPa), phi = (28°) and sigma_threshold = (100 kPa). The threshold is a stress, not a strength, and a design standard does not factor it.
SHANSEP#
The undrained strength normalised by the vertical effective stress and the overconsolidation ratio, after Ladd & Foott (1974):
where
- normally consolidated strength ratio (default 0.25)
- exponent (0.8) and overconsolidation ratio (1)
- strength added to the normalised term, and a floor on the result (both 0 kPa)
- vertical effective stress at the base, Eq. (3.5.5)
The strength does not depend on , so the methods read it as a cohesion with . Where is zero the strength is . The pore pressure in includes any excess pore pressure from an undrained load (, Section 3.6): an undrained load does not consolidate the soil, so it leaves the stress the strength depends on unchanged. Evaluated without a slice, the model uses in place of .
Vertical stress ratio#
A strength proportional to the vertical effective stress at the base, with a floor:
with K = 0.25 and min_strength = = 0 kPa by default. It is the SHANSEP model of Eq. (3.5.10) with , and , and like it the methods read it as a cohesion; without a slice it uses in place of .
3.5.4Rock models#
Hoek–Brown and Generalized Hoek–Brown#
The Hoek–Brown criterion gives the strength of a jointed rock mass in terms of the principal effective stresses. OGR Slip2D offers it in its original form (Hoek & Brown, 1980), model hoek_brown_classic,
and in its generalised form (Hoek, Carranza-Torres & Corkum, 2002), model hoek_brown,
where
- major and minor principal effective stresses at failure (kPa)
- uniaxial compressive strength of the intact rock (
sigci, kPa) - rock-mass constants; the classic model is the generalised one with
For the generalised model the three constants can be derived from the Geological Strength Index, the intact-rock constant and the disturbance factor with the relations of Hoek et al. (2002):
The GSI… button of Properties → Define Materials…, shown for the Generalized Hoek-Brown model, opens the Parameter Calculator, which evaluates Eq. (3.5.14) and Eq. (3.5.15) as you type and writes , and into the material. It offers descriptive tables for GSI, by lithology and by excavation method. GSI is clamped to 0–100. is accepted from 0 to 2 and clamped to 1.999, where would become undefined; Hoek et al. (2002) define from 0, for undisturbed rock masses, to 1, for very disturbed ones, and the calculator's own guidance table stays within that range.
Source: ogr_core/materials/parameter_calculator.py · ogr_gui/dialogs/parameter_calculator_dialog.pyThe methods need the strength on the plane of the slice base, that is, the Mohr envelope of the criterion. For any criterion it follows from the relations of Balmer (1952), as given by Hoek et al. (2002):
where
- slope of the criterion, , at the same
OGR Slip2D does not evaluate Eq. (3.5.16). It evaluates, for both models, the expressions
where , with and for the classic model; when the bracket is not positive.
The program's own source records (defect D171) that the envelope of Eq. (3.5.18) "is not yet this criterion's Mohr envelope", and the caveat applies to both Hoek–Brown models. The expression gives at , where the criterion's envelope has a finite intercept: 307.5 kPa with the default constants of the generalised model and 122.2 kPa with those of the classic model. Figure 3.5.2 compares the two curves for the generalised defaults. Check the strength a Hoek–Brown material actually receives against the envelope you intend before relying on a result.
Both models have a finite tensile strength, the root of the bracket of Eq. (3.5.13), which is the biaxial tensile strength of Hoek et al. (2002) and does not depend on :
(with for the classic model). It is the tension the Tensile Stress Check allows on a slice base in these materials, and it is zero when , or is not positive. The tensile strength comes from the criterion itself and is not affected by the approximation of Eq. (3.5.18).
Barton–Bandis#
The strength of a rock joint from its joint roughness coefficient and joint wall compressive strength, in the form with the residual friction angle of Barton & Choubey (1977) reviewed by Barton & Bandis (1990). OGR Slip2D evaluates
where
- residual friction angle (
phi_r, default 30°) - joint roughness coefficient (8) and joint wall compressive strength (50 000 kPa)
- cap on the total friction angle (
max_total_friction, 75°)
Above the roughness term is zero and the joint mobilises alone. The cap keeps the angle finite as the stress tends to zero; with the default parameters it acts only below about 0.12 kPa.
The cap is the parameter max_total_friction and it limits the total angle , 75° by default. The class docstring describes the cap as 70° + ; the code applies max_total_friction, which is what this page describes.
BartonBandis)
Power curve#
An envelope made of a cohesion intercept, a power of the normal stress and a waviness angle:
The power term is taken as zero where . The parameters are a (0.7), b (1.0), c (3 kPa), the offset d (0 kPa) and the waviness angle waviness = (0°), which adds the contribution of joint waviness rather than a friction angle of the material. With the default values the curve is the straight line . The model supplies its exact derivative for the linearisation of Eq. (3.5.2).
Hyperbolic#
An envelope that starts from the origin with slope and tends to a limiting strength at high stress:
with c_inf = = 150 kPa and phi_0 = = 20° by default; its exact derivative is .
Figure 3.5.3 plots the four envelopes of this section and the Mohr–Coulomb envelope of Section 3.5.3 with their default parameters, as the program evaluates them, and Table 3.5.3 gives the values at five stresses.
| (kPa) | Mohr–Coulomb | Hoek–Brown | Barton–Bandis | Power curve | Hyperbolic |
|---|---|---|---|---|---|
| 10 | 15.8 | 15.1 | 17.0 | 10.0 | 3.6 |
| 50 | 38.9 | 64.9 | 68.8 | 38.0 | 16.2 |
| 100 | 67.7 | 113.5 | 126.1 | 73.0 | 29.3 |
| 200 | 125.5 | 188.9 | 231.6 | 143.0 | 49.0 |
| 500 | 298.7 | 344.8 | 517.8 | 353.0 | 82.2 |
3.5.5Anisotropic models#
In a bedded or foliated material the strength depends on the orientation of the slip surface relative to the layering. The four anisotropic models read the inclination of each slice base, measured counter-clockwise from the horizontal; the first two compare it with a bedding direction, the last two use it directly.
Anisotropic linear#
A Mohr–Coulomb material whose cohesion and friction change linearly from a bedding strength to a rock-mass strength as the base turns away from the bedding (Mercer, 2012). With the acute angle between the base and the bedding,
where
- inclination of the bedding (
bedding_angle, 0°), or its local value at the slice when the material is linked to an anisotropic surface - angle up to which only the bedding strength applies (10°), and angle beyond which only the rock-mass strength applies (30°); is a step
The tangent of the friction angle is interpolated, not the angle itself. Figure 3.5.4 shows the strength of the default material at kPa as the base rotates. Evaluated without a slice, the model returns the weaker of the two extreme orientations, and .
Snowden modified anisotropic linear#
The anisotropic linear model with two extensions (Mercer, 2012). The transition may differ on either side of the bedding, and the bedding and rock-mass strengths are functions of the normal stress, each either a shear/normal function or a C/Phi function (Section 3.5.6):
where is folded into , and is given by Eq. (3.5.24) with in place of . By default , , and the two functions are single-row C/Phi functions equal to the default and of the anisotropic linear model, so the two default materials are the same material. Without a slice the model returns the weakest of the strengths at , and .
Anisotropic strength function#
A table of ranges of the base inclination itself, each with a constant cohesion and friction angle. With rows in increasing and the last one at ,
An inclination that falls exactly on a limit belongs to the lower range. The default table is , , . Without a slice the model returns the weakest row at the given stress. A table saved by a version before 0.1.218, when the same numbers were interpolated points, is kept in the file but refused by the analysis until it has been reviewed.
Generalized anisotropic#
Any strength model, or the strength of another material, assigned to a range of base inclination. The ranges are absolute inclinations folded into ; the first rule whose range holds the inclination supplies the strength, a limit belongs to the lower range, and the chosen model receives the same description of the base, so a child model that reads or a depth gets it. Weight, water and every other property are those of the parent material. A set of rules that leaves an inclination uncovered, or whose model cannot be built, is refused before the analysis starts. Without a slice the model returns the weakest of its rules' models.
A material is linked to an anisotropic surface in Properties → Define Materials…; only the anisotropic linear and Snowden models read the local bedding from it, and a Generalized Anisotropic material that still links one is refused, because its ranges are absolute inclinations. The tangent of in Eq. (3.5.25) has been interpolated since version 0.1.225; earlier versions interpolated the angle.
Source: ogr_core/materials/builtin_models.py · ogr_core/project/rules.py3.5.6Tabulated functions#
Three models take the envelope from a table, typically fitted to laboratory results. They involve no formula of their own beyond the interpolation.
| Model | Table | Between rows | Outside the table | Default table |
|---|---|---|---|---|
| Shear/Normal Function | points , sorted by | linear in | end value held | (0, 5), (100, 45), (300, 110) kPa |
| Discrete Function | points , sorted by | step: the of the last point with | end value held | (0, 10), (100, 50), (200, 80) kPa |
| C/Phi Function | rows , increasing | and (the angle) linear in ; | end row held | (0, 5, 35°), (100, 10, 30°), (300, 20, 25°) |
For the C/Phi function the program supplies the exact derivative of , including the change of with stress, to the linearisation of Eq. (3.5.2); the other two are differentiated segment by segment. A design standard divides the of every point of the first two tables, and the interpolated and of the third.
3.5.7Infinite strength and no strength#
infinite_strength models a material that the slip surface cannot shear, such as sound bedrock or a structure; in the linearisation of Eq. (3.5.2) it becomes a cohesion of kPa with , and a design standard does not factor it. Supports whose capacity depends on the strength of the surrounding ground receive none from it, and the analysis notes say so (Section 3.10). no_strength returns , for water or open voids.
3.5.8Unsaturated strength#
Above the water table a seepage analysis returns negative pore pressures, and matric suction adds to the strength of the soil. Fredlund, Morgenstern & Widger (1978) extended Mohr–Coulomb with a second friction angle for the suction:
OGR Slip2D applies it as a bilinear envelope through two properties of the material, and the air-entry value . With the suction : when the negative pore pressure is kept and acts through ; when the pore pressure is taken as and the excess suction adds the cohesion
to of Eq. (3.5.2), for every strength model. Both properties default to zero, which clips negative pore pressures to zero so that suction adds nothing. The suction can also be capped by a negative pore-pressure cutoff. The pore pressures themselves are the subject of Section 3.6.
The treatment is apply_unsaturated_policy in the slicer, which stores on each slice so that every method receives it through the same linearisation. A design standard divides by the factor on .
An error in the strength model or its parameters passes straight into the factor of safety. Take the envelope and its parameters from tests on the materials of the site, and check that the strength each material receives over the range of stresses of your slope is the one you intended. The default parameters are placeholders and must be replaced before a result is used for design.
3.5.9References#
- Balmer, G. (1952). A general analytical solution for Mohr's envelope. Proceedings of the American Society for Testing Materials, 52, 1260–1271.
- Barton, N. & Bandis, S. (1990). Review of predictive capabilities of JRC-JCS model in engineering practice. In N. Barton & O. Stephansson (eds), Rock Joints, 603–610. Balkema, Rotterdam.
- Barton, N. & Choubey, V. (1977). The shear strength of rock joints in theory and practice. Rock Mechanics, 10(1–2), 1–54.
- Coulomb, C.A. (1776). Essai sur une application des règles de maximis et minimis à quelques problèmes de statique, relatifs à l'architecture. Mémoires de Mathématique et de Physique présentés à l'Académie Royale des Sciences par divers Savans, 7, 343–382.
- Duncan, J.M. & Wright, S.G. (2005). Soil Strength and Slope Stability. Wiley, Hoboken.
- Fredlund, D.G., Morgenstern, N.R. & Widger, R.A. (1978). The shear strength of unsaturated soils. Canadian Geotechnical Journal, 15(3), 313–321.
- Hoek, E. & Brown, E.T. (1980). Empirical strength criterion for rock masses. Journal of the Geotechnical Engineering Division, ASCE, 106(GT9), 1013–1035.
- Hoek, E., Carranza-Torres, C. & Corkum, B. (2002). Hoek–Brown failure criterion – 2002 edition. Proceedings of the 5th North American Rock Mechanics Symposium, Toronto, 1, 267–273.
- Ladd, C.C. & Foott, R. (1974). New design procedure for stability of soft clays. Journal of the Geotechnical Engineering Division, ASCE, 100(GT7), 763–786.
- Mercer, K.G. (2012). The history and development of the anisotropic linear model: part 1. Australian Centre for Geomechanics Newsletter, Vol. 38 (July 2012), 13–16. Part 2 followed in the same newsletter: Mercer, K.G. (2013), Vol. 40 (July 2013), 1–5.
- Skempton, A.W. (1948). The φ = 0 analysis of stability and its theoretical basis. Proceedings of the 2nd International Conference on Soil Mechanics and Foundation Engineering, Rotterdam, 1, 72–78.