> For the complete documentation index, see [llms.txt](https://docs.openbrim.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openbrim.org/templates/spliced-i-girder-bridge-workflow/substructure-spig/soil-structure-interaction-spig/soil-layer-spig.md).

# Soil Layer \[SPIG]

The Soil Layer definition is used to specify the characteristics of the soil. Various models are available in OpenBrIM.

Regarding soil models, note that when a soil model is selected, only the necessary parameters for that model are displayed to the engineer.

## **General:**

**Soil Type \[Cohesionless=0/Cohesive=1/Rock=2]:** Specify the soil type. Avaliable Soil Models are filtered according to the Soil Type.

**Unit Weight:** Specify the unit weight of the soil. Enter the total unit weight: the lateral (p-y) models use it as entered above the **Water Table Elevation** of the Soil Set and subtract the unit weight of water (62.4 pcf) below it to get the effective unit weight.

**Top of Layer Elevation:** This parameter specifies the global elevation of top layer of the soil.

**Bottom of Layer Elevation:** This parameter specifies the global elevation of bottom layer of the soil.

## **Lateral:**

**Model (Cohesionless) \[Sand (Reese)=0/Sand (API)=1/Liquefied Sand (Rollins)=2/Sand (O'Neill)=3/Hybrid Liquefied Sand (Franke and Rollins)=4/c-phi Soil=5/Linear (Subgrade)=6/Custom P-Y=99]:** Specify the lateral soil model for cohesionless soils.

**Model (Cohesive) \[Soft Clay (Matlock)=0/Stiff Clay without Free Water (Welch and Reese)=1/Stiff Clay with Free Water (Reese)=2/Soft Clay (API)=3/Loess (Johnson)=4/Linear (Subgrade)=5/Custom P-Y=99]:** Specify the lateral soil model for cohesive soils.

**Model (Rock) \[Weak Rock (Reese)=0/Strong Rock (Turner)=1/Limestone (McVay)=2/Limestone Uncoupled (McVay)=3/Massive Rock (Liang)=4/Linear (Subgrade)=5/Custom P-Y=99]:** Specify the lateral soil model for rock.

**Custom P-Y:** When Custom P-Y model is selected, define the custom P-Y curve data points. The first point must be \[0,0], all values must be positive, and at least three points are required.

**Undrained Shear Strength:** The undrained shear strength (cohesion) of the soil, used for the clay models (Soft Clay (Matlock), Soft Clay (API), Stiff Clay with/without Free Water) and as the cohesion of the c-phi Soil model.

**Average Undrained Shear Strength:** The average undrained shear strength over the depth, used for Stiff Clay models.

**Major Principal Strain at 50%:** The strain at 50% of the maximum principal stress difference, used for the clay models, Soft Clay (API) and Hybrid Liquefied Sand.

**Internal Friction Angle:** The internal friction angle of the soil, used for the sand models (Sand (Reese), Sand (API), Sand (O'Neill)) and c-phi Soil.

**Subgrade Modulus:** The modulus of subgrade reaction, used for Sand (Reese), Sand (API), Sand (O'Neill), c-phi Soil, Linear (Subgrade) and Stiff Clay with Free Water models.

**Residual Shear Strength:** The residual (post-liquefaction) shear strength of the liquefied soil, used for the Hybrid Liquefied Sand model.

**Empirical Constant J:** The dimensionless constant of the API soft-clay ultimate resistance, 0.25 to 0.5 (0.5 for Gulf of Mexico clays), used for the Soft Clay (API) model.

**CPT Cone Tip Resistance:** The cone penetration test tip resistance, used for the Loess (Johnson) model.

**Mass Modulus:** The initial mass modulus of the rock, used for Weak Rock (Reese) model.

**Stiffness Constant (k\_rm):** A dimensionless constant relating rock mass modulus to intact rock modulus, used for Weak Rock (Reese) model.

**Unconfined Compressive Strength:** The unconfined compressive strength of the rock, used for Weak Rock, Strong Rock, Limestone, Limestone Uncoupled and Massive Rock models.

**Rock Quality Designation (RQD) %:** The Rock Quality Designation as a percentage, used for Weak Rock (Reese) model.

The next four inputs are the rock-mass parameters of the Massive Rock (Liang) model (Liang, Yang and Nusairat, 2009), shown only for that model; it also reads the **Unconfined Compressive Strength** above, and the pile section stiffness it needs is taken from the pile.

**Poisson's Ratio of Rock Mass:** The Poisson's ratio of the rock mass, 0.3 by default. It sets the initial slope of the p-y curve, K\_i = E\_m (D / 12 in) e^(−2ν) (E\_p I\_p / (E\_m D⁴))^0.284, where D is the pile diameter and E\_p I\_p the flexural stiffness of the pile section.

**Geological Strength Index (GSI):** The GSI of the rock mass, greater than 0 and at most 100. It scales the intact rock to the rock mass: the Hoek-Brown constants m\_b = m\_i e^((GSI − 100)/28) and s = e^((GSI − 100)/9), and the rock-mass modulus E\_m = (E\_i / 100) e^(GSI/21.7).

**Hoek-Brown Constant of Intact Rock (m\_i):** The Hoek-Brown material constant of the intact rock. Reduced to m\_b through the GSI, it defines the Hoek-Brown strength of the rock mass, from which the limit pressure at depth and the friction angle and cohesion of the near-surface wedge are derived together with the unconfined compressive strength.

**Intact Rock Modulus:** The modulus of the intact rock, which must be positive. The rock-mass modulus E\_m that the p-y curve uses is scaled from it through the GSI.

For theoretical details about the models, refer to [Lateral Soil Models](https://github.com/openbrim/platform/blob/master/technical-background/soil-structure-interaction/general.md).

## **Axial:**

**Model (Cohesionless) \[Driven Pile (McVay)=0/Drilled Shaft Sand (Reese and O'Neill)=1/Driven Pile Sand (Mosher)=2/Driven Pile Sand (API)=3/Drilled Shaft Gravelly Sand (Rollins)=4/Drilled Shaft Gravel (Rollins)=5/Drilled Shaft IGM Non-Cohesive (Mayne and Harris)=6/Custom T-Z=99]:** Specify the axial soil model for cohesionless soils.

**Model (Cohesive) \[Driven Pile (McVay)=0/Drilled Shaft Clay (Reese and O'Neill)=1/Driven Pile Clay (Coyle and Reese)=2/Driven Pile Clay (API)=3/Drilled Shaft Clay-Shale (Aurora and Reese)=4/Drilled Shaft IGM Cohesive (O'Neill)=5/Custom T-Z=99]:** Specify the axial soil model for cohesive soils.

**Model (Rock) \[Driven Pile (McVay)=0/Drilled Shaft Limestone (McVay)=1/Drilled Shaft IGM Cohesive (O'Neill)=2/Drilled Shaft IGM Non-Cohesive (Mayne and Harris)=3/Custom T-Z=99]:** Specify the axial soil model for rock.

**Custom T-Z:** When Custom T-Z model is selected, define the custom T-Z curve data points. The first point must be \[0,0], all values must be positive, and at least three points are required.

**Poisson's Ratio of Soil:** The Poisson's ratio of the soil, used for Driven Pile (McVay) model.

**Shear Modulus:** The shear modulus of the soil, used for Driven Pile (McVay) model.

**The ultimate shear stress (Skin friction):** The ultimate unit skin friction resistance along the pile shaft, used for the Driven Pile (McVay), Driven Pile Sand (Mosher), Driven Pile Clay (Coyle and Reese) and Drilled Shaft Limestone (McVay) models.

**Undrained Shear Strength:** The undrained shear strength of the clay, used for the Drilled Shaft Clay (Reese and O'Neill), Driven Pile Clay (API) and Drilled Shaft Clay-Shale models.

**Initial Modulus of Side Resistance (K\_t):** The initial slope of the Mosher side-resistance curve, used for the Driven Pile Sand (Mosher) model: 6000–10000 lb/ft²/in for loose, 10000–14000 for medium dense and 14000–18000 for dense sand. The curve is the hyperbola t = z / (1/K\_t + z/t\_u), with t\_u the ultimate shear stress (skin friction) above, so both must be positive.

The next four inputs are the parameters of the Driven Pile Sand (API) model, the same four as the FB-MultiPier dialog, and are shown only for that model.

**Internal Friction Angle:** The friction angle φ of the sand, which must be greater than 5° (the soil-pile friction angle is taken as δ = φ − 5°). It is used only when the Nominal Unit Skin Friction below is 0.

**Coefficient of Lateral Earth Pressure (0.8 open-ended unplugged, 1.0 full displacement):** The K of the shaft friction factor β = K tan δ, 0.8 by default; it must be positive. Like the friction angle, it is used only when the Nominal Unit Skin Friction is 0.

**Nominal Unit Skin Friction (0 = computed from the friction angle and K):** A nominal unit skin friction above 0 is the ultimate unit skin friction of the curve itself, and the friction angle and K are then not used (this is how FB-MultiPier treats the field; it is neither a cap nor a floor). With 0, where FB-MultiPier returns no side resistance at all, the skin friction is instead computed by API RP 2GEO, f = β p'0 limited to f\_lim, where β = K tan δ with δ = φ − 5° (K = 0.8 for open-ended unplugged piles, 1.0 for full-displacement piles; at K = 0.8 and φ = 25° / 30° / 35° / 40° this gives the tabulated β = 0.29 / 0.37 / 0.46 / 0.56) and f\_lim is read from the same table through the friction angle (1.4 / 1.7 / 2.0 / 2.4 kips/ft², interpolated linearly).

**Displacement at Nominal Unit Skin Friction (0 = 1% of pile diameter):** The displacement at nominal unit skin friction is the z\_peak of the RP 2GEO t-z table, 0.25 % to 2 % of the pile diameter; 0 = 1 % of the pile diameter. It is shown for the Driven Pile Sand (API) and Driven Pile Clay (API) models.

**Shaft Friction Factor beta (0 = compute from depth):** The β factor of the Drilled Shaft Gravelly Sand (Rollins) and Drilled Shaft Gravel (Rollins) models; the ultimate unit side resistance is β times the effective vertical stress. With 0 it is computed from the depth z in metres: β = 2.0 − 0.15 z^0.75, kept between 0.25 and 1.8, for gravelly sand, and β = 3.4 e^(−0.085 z), kept between 0.25 and 3.0, for gravel.

**Load Transfer Trend Line \[Lower/Average/Upper] (Upper is not available for Gravelly Sand):** The fitted trend line of the same two Rollins models (Rollins et al., 2005) to use: the lower bound, the average (the default) or the upper bound of the side resistance mobilized against displacement as a percentage of the shaft diameter. Upper is rejected for Drilled Shaft Gravelly Sand, whose upper-bound polynomial is misprinted in the FB-MultiPier manual; it is available for Drilled Shaft Gravel.

**Residual to Peak Adhesion Ratio (0.70 to 0.90):** The residual skin friction of the Driven Pile Clay (API) curve as a fraction of the peak, 0.70 to 0.90 (0.90 by default; 0 is read as 0.90). It is reached at twice the displacement of the peak and held beyond. The Driven Pile Clay (API) model also reads the Displacement at Nominal Unit Skin Friction above as the displacement of its peak; 0 = 1 % of the pile diameter, which is the value FB-MultiPier fixes for this model.

**Shear Strength Reduction Factor alpha (0.5 slurry or casing, 0.75 dry):** The α of the Drilled Shaft Clay-Shale model, 0.5 for the slurry or casing method and 0.75 for the dry method (0.5 by default). The ultimate unit side resistance is α times the Undrained Shear Strength above (Aurora and Reese, 1976).

The next nine inputs are the parameters of the Drilled Shaft IGM Cohesive model (O'Neill et al., 1996, Model 1), shown only for that model; the socket length and the concrete modulus are taken from the pile.

**Unconfined Compressive Strength of IGM:** The unconfined compressive strength q\_u of the intermediate geomaterial. The ultimate side resistance is α q\_u for a smooth socket and 0.5 √(q\_u q\_t) for a rough socket (McVay et al., 1992); for a rough socket q\_u also divides the normal stress of the fluid concrete to give the characteristic parameter n.

**Mass Modulus of IGM (Socket):** The mass modulus E\_m of the geomaterial along the socket, which must be positive. With the concrete modulus it sets the stiffness of the socket through log(E\_c/E\_m), and so the initial slope of the t-z curve. It is also shown, and used the same way, for the Drilled Shaft IGM Cohesive (O'Neill) tip model.

**Mass to Intact Modulus Ratio (E\_m/E\_i):** The ratio of the mass modulus to the intact modulus of the geomaterial, estimated from the RQD; 1 by default. Below 1 it reduces the side resistance by a factor of 0.45 at 0.05, 0.55 at 0.1, 0.7 at 0.3, 0.8 at 0.5 and 1.0 at 1, interpolated linearly.

**Borehole Wall \[Smooth/Rough]:** The condition of the socket wall. Rough (the default) takes the side resistance as 0.5 √(q\_u q\_t) and computes n from the normal stress of the fluid concrete; Smooth takes it as α q\_u and uses the smooth-socket n and α below.

**Split Tensile Strength of IGM:** The split tensile strength q\_t of the geomaterial, used for the side resistance of a rough socket.

**Unit Weight of Shaft Concrete:** The unit weight of the fluid concrete, 150 lb/ft³ by default. It gives the normal stress the concrete exerts on the borehole wall of a rough socket (buoyant below the water table).

**Concrete Slump:** The slump of the shaft concrete, 175 mm (about 6.9 in) by default. With the depth below the top of the concrete it gives the fluidity factor M (Figure 35 of the report, read between 125 and 225 mm) that scales the normal stress on the borehole wall.

**Characteristic Parameter n (Smooth Socket):** The parameter n for a smooth socket (Figure 36 of the report), 0.39 by default; for a rough socket n is computed instead. The t-z curve is linear up to the point where the normalized displacement reaches n and softens beyond it.

**Side Resistance Factor alpha (Smooth Socket):** The factor α for a smooth socket (Figure 34 of the report), 0.4 by default; the side resistance of a smooth socket is α q\_u.

The next four inputs are the parameters of the Drilled Shaft IGM Non-Cohesive model (Mayne and Harris, 1993, as revised by O'Neill et al., 1996); the socket length and the shaft modulus are taken from the pile. They are shown for that side-resistance model and also for the Drilled Shaft IGM Non-Cohesive (Mayne and Harris) tip model.

**SPT Blow Count N60:** The SPT blow count corrected to 60 % energy, which must be positive. Every property of the geomaterial is derived from it: the preconsolidation pressure 0.2 N60 p\_a, the effective friction angle φ' = atan\[(N60 / (12.2 + 20.3 σ'v/p\_a))^0.34] and the modulus E\_sL = 22 p\_a N60^0.82, with p\_a the atmospheric pressure.

**Poisson's Ratio of IGM:** The Poisson's ratio of the geomaterial, about 0.3 (the default). It enters the load-settlement solution of the socket (O'Neill et al., 1996, Eqs. 48–52).

**Drilled Under Slurry \[No/Yes]:** Yes for a shaft drilled under slurry with good construction control: the wall friction angle is then taken as 0.75 φ'. No uses φ'.

**Side to Base Modulus Ratio (E\_sL/E\_b):** The ratio of the geomaterial modulus along the side to the modulus below the base, 2.5 by default (Piedmont residuum); it must be positive. It enters the influence factor of the socket solution, and the tip model takes the base modulus as E\_sL divided by it.

For theoretical details about the models, refer to [Axial TZ Soil Models](https://openbrim.atlassian.net/wiki/spaces/OBrIM/pages/3049685025/Axial+TZ+Curves).

## **Tip:**

**Model \[Driven Pile (McVay)=0/Drilled Shaft Sand (Reese and O'Neill)=1/Drilled Shaft Clay (Reese and O'Neill)=2/Driven Pile Sand (Mosher)=3/Driven Pile Sand (API)=4/Drilled Shaft Gravelly Sand and Gravel=5/Driven Pile Clay (Skempton)=6/Driven Pile Clay (API)=7/Drilled Shaft Clay-Shale (Aurora and Reese)=8/Drilled Shaft IGM Cohesive (O'Neill)=9/Drilled Shaft IGM Non-Cohesive (Mayne and Harris)=10/Custom Q-Z=99]:** Specify the appropriate model according to the definition of the soil material.

**Custom Q-Z:** When Custom Q-Z model is selected, define the custom Q-Z curve data points. The first point must be \[0,0], all values must be positive, and at least three points are required.

**Poisson's Ratio of Soil:** The Poisson's ratio of the soil, used for Driven Pile (McVay) tip model.

**Shear Modulus:** The shear modulus of the soil, used for Driven Pile (McVay) tip model.

**The ultimate tip resistance:** The ultimate unit tip resistance at the pile base, used for Driven Pile (McVay) model.

**Uncorrected SPT N:** The uncorrected Standard Penetration Test (SPT) blow count, used for the Drilled Shaft Sand (Reese and O'Neill) and Drilled Shaft Gravelly Sand and Gravel tip models.

**Undrained Shear Strength:** The undrained shear strength of the clay at the pile tip, used for the Drilled Shaft Clay (Reese and O'Neill), Driven Pile Clay (Skempton), Driven Pile Clay (API) and Drilled Shaft Clay-Shale tip models.

The next three inputs are the parameters of the Driven Pile Sand (Mosher) tip curve (Vijayvergiya, 1977), q = q\_u (z/z\_c)^n, shown only for that model. The curve is not capped at q\_u beyond the critical displacement, as in FB-MultiPier.

**Ultimate Unit End Bearing:** The unit end bearing q\_u reached at the critical tip displacement.

**Critical Tip Displacement:** The tip displacement z\_c at which the ultimate unit end bearing is reached, 0.25 in by default; it must be positive.

**Tip Curve Exponent n (1/2 loose, 1/3 medium dense, 1/4 dense):** The exponent n of the curve, 1/3 by default.

The next three inputs are the parameters of the Driven Pile Sand (API) tip model, the same three as the FB-MultiPier dialog, and are shown only for that model. The unit end bearing is q = N\_q p'0 limited to the nominal unit end bearing; the curve reaches it at a tip displacement of 10 % of the pile diameter.

**Internal Friction Angle:** The friction angle of the sand at the tip, which must be positive. It is used only when the Bearing Capacity Factor N\_q below is 0, to read N\_q from the table.

**Nominal Unit End Bearing (0 = no limit):** The limit on the unit end bearing N\_q p'0; 0 = no limit.

**Bearing Capacity Factor N\_q (0 = from the friction angle):** A bearing capacity factor above 0 is used as entered (12 to 50 in the API RP 2GEO design parameter table); with 0 it is read from that table through the friction angle (8 / 12 / 20 / 40 / 50 at φ = 20° / 25° / 30° / 35° / 40°, interpolated linearly), and the friction angle is used only in that case. It must not be negative.

The next two inputs are the parameters of the Driven Pile Clay (Skempton) tip curve, q = (9 c\_u / 2) (z / (2 D ε50))^n limited to 9 c\_u, where c\_u is the Undrained Shear Strength above and D the pile diameter; they are shown only for that model.

**Major Principal Strain at 50% (Tip):** The strain ε50 at 50 % of the maximum stress of the clay at the tip, 0.01 by default; it must be positive.

**Displacement Exponent n:** The exponent n of the curve (n = 0.5 for clays, the default).

**Bearing Capacity Factor N\_c (7 slurry displacement, 8 casing or dry):** The N\_c of the Drilled Shaft Clay-Shale tip model, 7 for the slurry displacement method and 8 for the casing or dry method (8 by default). The unit end bearing is N\_c times the Undrained Shear Strength above, limited to 40 tsf (the limit of the Reese and O'Neill drilled-shaft clay model whose curve shape it uses).

**Mass Modulus of IGM below the Tip:** The mass modulus of the bearing IGM for the Drilled Shaft IGM Cohesive tip model; the socket modulus, socket length and concrete modulus are shared with the side-resistance model.

For theoretical details about the models, [Axial QZ Soil Models](https://github.com/openbrim/platform/blob/master/technical-background/soil-structure-interaction/general.md).

## **Torsional:**

**Model \[Hyperbolic Curve=0/Custom T-θ=99]:** Specify the appropriate model according to the definition of the soil material.

**Custom T-θ:** When Custom T-θ model is selected, define the custom torque-rotation curve data points. The first point must be \[0,0], all values must be positive, and at least three points are required.

**Shear Modulus:** The shear modulus of the soil, used for Hyperbolic Curve torsional model.

**Torsional Shear Stress:** The ultimate torsional shear stress at the soil-pile interface, used for Hyperbolic Curve torsional model.

{% hint style="info" %}
About **Custom Models**:

* The first point must be **\[0,0]**.
* All other points must have only positive values.
* At least three points must be entered.
  {% endhint %}

For theoretical details about the models, [Torsional Soil Models](https://github.com/openbrim/platform/blob/master/technical-background/soil-structure-interaction/general.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.openbrim.org/templates/spliced-i-girder-bridge-workflow/substructure-spig/soil-structure-interaction-spig/soil-layer-spig.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
