# Datos de entrada

Cada campo de un modelo de una zapata, como lo da el esquema del motor: qué es, su unidad y su convención, y sus límites.

Un modelo es un documento JSON, el mismo que arman los formularios del estudio, escribe su IA y envía un agente con `create_model`. Cada elemento tiene un `id`, estable y único en el modelo (los resultados nombran con él los elementos de los que depende cada chequeo), y un `name`, que se ve en el lienzo y en la memoria; los estratos pueden llevar además un `color`. Todo modelo dice su `contract_version`, hoy la 15. Las unidades son SI: kN, m, kPa, kN/m³ y grados.

Estos son sus campos, del propio esquema del motor: de ahí salen los formularios del estudio, y es lo que `get_tool_schema` le da a un agente. Los nombres de los campos y sus descripciones están en inglés, como el estudio.

`footing` uno de · obligatorio

`circular` A circular footing, such as under a tank or a tower: its load centred.

`shape` texto · obligatorio · = "circular"

`diameter` número · obligatorio · ≥ 0,1

Diameter B (m). The bearing resistance and the elastic settlement take a square of the same area (AASHTO C10.6.1.3).

`embedment_depth` número · opcional · ≥ 0 · por defecto 0

Depth of the base below the ground surface, Df (m).

`embedment_permanent` sí o no · opcional · por defecto false

Whether the soil over the base, down to Df, stays through the structure's life: no scour, excavation or trench will take it away. AASHTO counts that soil's shear in the bearing (dq, Eq. 10.6.3.1.2a-10, at most 1.4) only where it stays and no stratum above the base is weaker than the one below it (10.6.3.1.2a); false, the default, takes dq = 1.0, as for a base whose cover may go. AASHTO's equation's: Meyerhof's general one keeps its own depth factors.

`allowable_bearing_pressure` número · opcional · > 0

Optional: the allowable bearing pressure a soil study gives for the footing at its depth, or a presumptive value (AASHTO Table C10.6.2.5.1-1) (kPa): the total pressure at the base, every load that reaches it, is checked against it (where the study gives a net value, add the overburden pressure at the base). In free mode the edge pressure, the greatest of the base's linear pressure diagram (an MSE block's uniform pressure); under AASHTO the uniform pressure on the effective area at Service I, the service limit state only (10.5.2.1; a wall's base by 11.6.2.2), the strength limit state's bearing still from the strata. Empty, no such check.

`load` grupo · obligatorio

A circle has no moments here: its load is centred.

`dead` grupo · obligatorio

The permanent part: the structure's own weight and what stays on it (AASHTO's DC, components and attachments), with the footing's own weight, and the soil on it unless given as vertical\_earth\_pressure: all that reaches the soil at the base.

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the soil at the base of the footing (kN).

`horizontal` número · opcional · por defecto 0

Horizontal load (kN).

`wearing_surfaces` grupo · opcional

Optional: wearing surfaces and utilities on the structure (AASHTO's DW, γp 1.50 or 0.65, Table 3.4.1-2); else they go in the dead part, at DC's factors.

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the soil at the base of the footing (kN).

`horizontal` número · opcional · por defecto 0

Horizontal load (kN).

`vertical_earth_pressure` grupo · opcional

Optional: the weight of the soil on the footing, as an abutment's or a retaining wall's (AASHTO's EV, γp 1.35 or 1.00, Table 3.4.1-2); else it goes in the dead part.

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the soil at the base of the footing (kN).

`horizontal` número · opcional · por defecto 0

Horizontal load (kN).

`horizontal_earth_pressure` grupo · opcional

Optional: the earth pressure on the structure the footing carries, its horizontal and vertical components and their moment (AASHTO's EH, γp 1.50 or 0.90 active, 1.35 or 0.90 at rest, Table 3.4.1-2).

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the soil at the base of the footing (kN).

`horizontal` número · opcional · por defecto 0

Horizontal load (kN).

`pressure_state` texto · obligatorio · uno de: active, at\_rest

The earth pressure the thrust was computed with: active (the wall moves away from the soil) or at rest; AASHTO factors them 1.50 and 1.35 at their maximum.

`earth_surcharge` grupo · opcional

Optional: what a permanent surcharge on the soil adds, on the footing or as the thrust it brings (AASHTO's ES, γp 1.50 or 0.75, Table 3.4.1-2).

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the soil at the base of the footing (kN).

`horizontal` número · opcional · por defecto 0

Horizontal load (kN).

`live` grupo · opcional

Optional: the part that comes and goes (occupancy, traffic, storage; AASHTO's LL with its IM), and the weight of a live surcharge on the soil over the footing, as over an abutment's heel. Each check takes it in or out, whichever is worse for that check (AASHTO 3.4.1): out where it relieves the footing, a moment that brings the resultant back toward the middle or a weight that adds friction against sliding (C11.5.6, Fig. C11.5.6-3); the settlement takes it in. Free mode takes it unfactored; a code with load factors factors each its own way.

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the soil at the base of the footing (kN).

`horizontal` número · opcional · por defecto 0

Horizontal load (kN).

`live_surcharge` grupo · opcional

Optional: the thrust of a live surcharge on the soil behind the structure, traffic's (AASHTO's LS, 1.75, Table 3.4.1-1), in or out apart from the live part: its horizontal force, its moment and, where the thrust is inclined, its own vertical component, which holds the footing as the thrust's (C11.5.6: one load factor on both). The surcharge's weight on the soil over the footing isn't its thrust: it goes in the live part, which Table 3.4.1-1 factors as it factors LS.

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the soil at the base of the footing (kN).

`horizontal` número · opcional · por defecto 0

Horizontal load (kN).

`friction_load` grupo · opcional

Optional: the friction a bearing or the superstructure passes to the structure (AASHTO's FR, 1.00, Table 3.4.1-1).

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the soil at the base of the footing (kN).

`horizontal` número · opcional · por defecto 0

Horizontal load (kN).

`time_since_loading` número · opcional · > 0

Optional: the years since the load began, at which the settlement is wanted: how far the clay's consolidation has gone (with its cv) and the sand's creep (Schmertmann's C2). Empty, the final consolidation and no creep (C2 = 1, as Leonards and Holtz advise for clean sands). The settlement check takes the final one.

`methods` grupo · opcional

Methods (advanced): each the designer's choice, with its default.

`bearing_capacity` texto · opcional · uno de: meyerhof\_general, vesic\_general

The nominal bearing resistance's equation; null, the design code's: meyerhof\_general in free mode, vesic\_general under AASHTO. meyerhof\_general: Meyerhof's general bearing capacity equation (1963), with De Beer's shape, Hansen's depth and Meyerhof's inclination factors, and the water table in q and in γ within B below the base (Das & Sivakugan, Eq. 6.28), the textbooks' equation, for a designer who works by it or checks against a book's example. vesic\_general: Vesic's general equation (1975) as AASHTO LRFD 10th writes it, Eq. 10.6.3.1.2a-1: Vesic's Nγ, De Beer's shape factors with the load's inclination factors (Brinch-Hansen's as Vesic modified them), Cwq and Cwγ for the water, and dq only where the soil above the base stays (embedment\_permanent) and none of it is weaker, under a code at most its cap; no dc. FHWA NHI-06-089 prints the equation without the inclination factors (Eq. 8-6) and advises against combining them with the shape factors (§8.4.3.5). For a designer who follows the manuals' and AASHTO's formulation. AASHTO admits either: its nominal resistance is by "accepted soil mechanics theories" (10.6.3.1.2a), with the theoretical method's resistance factor either way. A wall's base and an MSE block take Vesic's always.

`immediate_settlement` texto · opcional · uno de: elastic, schmertmann\_settlement · por defecto "elastic"

The immediate settlement (AASHTO 10.6.2.4.2): the elastic one (10.6.2.4.2a), for any soil, with every stratum's elastic properties (without them, no immediate settlement is computed); or Schmertmann's (10.6.2.4.2c), the strain influence method for cohesionless soils, on each stratum's Es (taken as measured in situ, X = 1.0), with its creep by the years since loading.

`rectangular` A rectangular or square footing, such as under a column.

`shape` texto · obligatorio · = "rectangular"

`width` número · obligatorio · ≥ 0,1

Width B (m), the shorter side, the one the horizontal load and moment\_width act along.

`length` número · obligatorio · ≥ 0,1

Length L (m), the longer side: L ≥ B.

`embedment_depth` número · opcional · ≥ 0 · por defecto 0

Depth of the base below the ground surface, Df (m).

`embedment_permanent` sí o no · opcional · por defecto false

Whether the soil over the base, down to Df, stays through the structure's life: no scour, excavation or trench will take it away. AASHTO counts that soil's shear in the bearing (dq, Eq. 10.6.3.1.2a-10, at most 1.4) only where it stays and no stratum above the base is weaker than the one below it (10.6.3.1.2a); false, the default, takes dq = 1.0, as for a base whose cover may go. AASHTO's equation's: Meyerhof's general one keeps its own depth factors.

`allowable_bearing_pressure` número · opcional · > 0

Optional: the allowable bearing pressure a soil study gives for the footing at its depth, or a presumptive value (AASHTO Table C10.6.2.5.1-1) (kPa): the total pressure at the base, every load that reaches it, is checked against it (where the study gives a net value, add the overburden pressure at the base). In free mode the edge pressure, the greatest of the base's linear pressure diagram (an MSE block's uniform pressure); under AASHTO the uniform pressure on the effective area at Service I, the service limit state only (10.5.2.1; a wall's base by 11.6.2.2), the strength limit state's bearing still from the strata. Empty, no such check.

`load` grupo · obligatorio

The load on a rectangular footing, at the centre of its base; its moments move it off the centre.

`dead` grupo · obligatorio

The permanent part: the structure's own weight and what stays on it (AASHTO's DC, components and attachments), with the footing's own weight, and the soil on it unless given as vertical\_earth\_pressure: all that reaches the soil at the base.

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the base of the footing (kN).

`horizontal` número · opcional · por defecto 0

Horizontal load in the direction of the width (kN).

`moment_width` número · opcional · por defecto 0

Moment that moves the load off centre along the width (kN·m); positive moves it towards x = B.

`moment_length` número · opcional · por defecto 0

Moment that moves the load off centre along the length (kN·m); positive moves it towards y = L.

`wearing_surfaces` grupo · opcional

Optional: wearing surfaces and utilities on the structure (AASHTO's DW, γp 1.50 or 0.65, Table 3.4.1-2); else they go in the dead part, at DC's factors.

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the base of the footing (kN).

`horizontal` número · opcional · por defecto 0

Horizontal load in the direction of the width (kN).

`moment_width` número · opcional · por defecto 0

Moment that moves the load off centre along the width (kN·m); positive moves it towards x = B.

`moment_length` número · opcional · por defecto 0

Moment that moves the load off centre along the length (kN·m); positive moves it towards y = L.

`vertical_earth_pressure` grupo · opcional

Optional: the weight of the soil on the footing, as an abutment's or a retaining wall's (AASHTO's EV, γp 1.35 or 1.00, Table 3.4.1-2); else it goes in the dead part.

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the base of the footing (kN).

`horizontal` número · opcional · por defecto 0

Horizontal load in the direction of the width (kN).

`moment_width` número · opcional · por defecto 0

Moment that moves the load off centre along the width (kN·m); positive moves it towards x = B.

`moment_length` número · opcional · por defecto 0

Moment that moves the load off centre along the length (kN·m); positive moves it towards y = L.

`horizontal_earth_pressure` grupo · opcional

Optional: the earth pressure on the structure the footing carries, its horizontal and vertical components and their moment (AASHTO's EH, γp 1.50 or 0.90 active, 1.35 or 0.90 at rest, Table 3.4.1-2).

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the base of the footing (kN).

`horizontal` número · opcional · por defecto 0

Horizontal load in the direction of the width (kN).

`moment_width` número · opcional · por defecto 0

Moment that moves the load off centre along the width (kN·m); positive moves it towards x = B.

`moment_length` número · opcional · por defecto 0

Moment that moves the load off centre along the length (kN·m); positive moves it towards y = L.

`pressure_state` texto · obligatorio · uno de: active, at\_rest

The earth pressure the thrust was computed with: active (the wall moves away from the soil) or at rest; AASHTO factors them 1.50 and 1.35 at their maximum.

`earth_surcharge` grupo · opcional

Optional: what a permanent surcharge on the soil adds, on the footing or as the thrust it brings (AASHTO's ES, γp 1.50 or 0.75, Table 3.4.1-2).

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the base of the footing (kN).

`horizontal` número · opcional · por defecto 0

Horizontal load in the direction of the width (kN).

`moment_width` número · opcional · por defecto 0

Moment that moves the load off centre along the width (kN·m); positive moves it towards x = B.

`moment_length` número · opcional · por defecto 0

Moment that moves the load off centre along the length (kN·m); positive moves it towards y = L.

`live` grupo · opcional

Optional: the part that comes and goes (occupancy, traffic, storage; AASHTO's LL with its IM), and the weight of a live surcharge on the soil over the footing, as over an abutment's heel. Each check takes it in or out, whichever is worse for that check (AASHTO 3.4.1): out where it relieves the footing, a moment that brings the resultant back toward the middle or a weight that adds friction against sliding (C11.5.6, Fig. C11.5.6-3); the settlement takes it in. Free mode takes it unfactored; a code with load factors factors each its own way.

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the base of the footing (kN).

`horizontal` número · opcional · por defecto 0

Horizontal load in the direction of the width (kN).

`moment_width` número · opcional · por defecto 0

Moment that moves the load off centre along the width (kN·m); positive moves it towards x = B.

`moment_length` número · opcional · por defecto 0

Moment that moves the load off centre along the length (kN·m); positive moves it towards y = L.

`live_surcharge` grupo · opcional

Optional: the thrust of a live surcharge on the soil behind the structure, traffic's (AASHTO's LS, 1.75, Table 3.4.1-1), in or out apart from the live part: its horizontal force, its moment and, where the thrust is inclined, its own vertical component, which holds the footing as the thrust's (C11.5.6: one load factor on both). The surcharge's weight on the soil over the footing isn't its thrust: it goes in the live part, which Table 3.4.1-1 factors as it factors LS.

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the base of the footing (kN).

`horizontal` número · opcional · por defecto 0

Horizontal load in the direction of the width (kN).

`moment_width` número · opcional · por defecto 0

Moment that moves the load off centre along the width (kN·m); positive moves it towards x = B.

`moment_length` número · opcional · por defecto 0

Moment that moves the load off centre along the length (kN·m); positive moves it towards y = L.

`friction_load` grupo · opcional

Optional: the friction a bearing or the superstructure passes to the structure (AASHTO's FR, 1.00, Table 3.4.1-1).

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the base of the footing (kN).

`horizontal` número · opcional · por defecto 0

Horizontal load in the direction of the width (kN).

`moment_width` número · opcional · por defecto 0

Moment that moves the load off centre along the width (kN·m); positive moves it towards x = B.

`moment_length` número · opcional · por defecto 0

Moment that moves the load off centre along the length (kN·m); positive moves it towards y = L.

`time_since_loading` número · opcional · > 0

Optional: the years since the load began, at which the settlement is wanted: how far the clay's consolidation has gone (with its cv) and the sand's creep (Schmertmann's C2). Empty, the final consolidation and no creep (C2 = 1, as Leonards and Holtz advise for clean sands). The settlement check takes the final one.

`methods` grupo · opcional

Methods (advanced): each the designer's choice, with its default.

`bearing_capacity` texto · opcional · uno de: meyerhof\_general, vesic\_general

The nominal bearing resistance's equation; null, the design code's: meyerhof\_general in free mode, vesic\_general under AASHTO. meyerhof\_general: Meyerhof's general bearing capacity equation (1963), with De Beer's shape, Hansen's depth and Meyerhof's inclination factors, and the water table in q and in γ within B below the base (Das & Sivakugan, Eq. 6.28), the textbooks' equation, for a designer who works by it or checks against a book's example. vesic\_general: Vesic's general equation (1975) as AASHTO LRFD 10th writes it, Eq. 10.6.3.1.2a-1: Vesic's Nγ, De Beer's shape factors with the load's inclination factors (Brinch-Hansen's as Vesic modified them), Cwq and Cwγ for the water, and dq only where the soil above the base stays (embedment\_permanent) and none of it is weaker, under a code at most its cap; no dc. FHWA NHI-06-089 prints the equation without the inclination factors (Eq. 8-6) and advises against combining them with the shape factors (§8.4.3.5). For a designer who follows the manuals' and AASHTO's formulation. AASHTO admits either: its nominal resistance is by "accepted soil mechanics theories" (10.6.3.1.2a), with the theoretical method's resistance factor either way. A wall's base and an MSE block take Vesic's always.

`immediate_settlement` texto · opcional · uno de: elastic, schmertmann\_settlement · por defecto "elastic"

The immediate settlement (AASHTO 10.6.2.4.2): the elastic one (10.6.2.4.2a), for any soil, with every stratum's elastic properties (without them, no immediate settlement is computed); or Schmertmann's (10.6.2.4.2c), the strain influence method for cohesionless soils, on each stratum's Es (taken as measured in situ, X = 1.0), with its creep by the years since loading.

`strip` A long footing, such as under a wall: analysed per metre of length.

`shape` texto · obligatorio · = "strip"

`width` número · obligatorio · ≥ 0,1

Width B (m); its loads are per metre of the footing's length.

`embedment_depth` número · opcional · ≥ 0 · por defecto 0

Depth of the base below the ground surface, Df (m).

`embedment_permanent` sí o no · opcional · por defecto false

Whether the soil over the base, down to Df, stays through the structure's life: no scour, excavation or trench will take it away. AASHTO counts that soil's shear in the bearing (dq, Eq. 10.6.3.1.2a-10, at most 1.4) only where it stays and no stratum above the base is weaker than the one below it (10.6.3.1.2a); false, the default, takes dq = 1.0, as for a base whose cover may go. AASHTO's equation's: Meyerhof's general one keeps its own depth factors.

`allowable_bearing_pressure` número · opcional · > 0

Optional: the allowable bearing pressure a soil study gives for the footing at its depth, or a presumptive value (AASHTO Table C10.6.2.5.1-1) (kPa): the total pressure at the base, every load that reaches it, is checked against it (where the study gives a net value, add the overburden pressure at the base). In free mode the edge pressure, the greatest of the base's linear pressure diagram (an MSE block's uniform pressure); under AASHTO the uniform pressure on the effective area at Service I, the service limit state only (10.5.2.1; a wall's base by 11.6.2.2), the strength limit state's bearing still from the strata. Empty, no such check.

`load` grupo · obligatorio

Per metre of footing: there is no length, so no moment along it.

`dead` grupo · obligatorio

The permanent part: the structure's own weight and what stays on it (AASHTO's DC, components and attachments), with the footing's own weight, and the soil on it unless given as vertical\_earth\_pressure: all that reaches the soil at the base.

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the soil at the base (kN/m).

`horizontal` número · opcional · por defecto 0

Horizontal load in the direction of the width (kN/m).

`moment_width` número · opcional · por defecto 0

Moment that moves the load off centre along the width (kN·m/m); positive moves it towards x = B.

`wearing_surfaces` grupo · opcional

Optional: wearing surfaces and utilities on the structure (AASHTO's DW, γp 1.50 or 0.65, Table 3.4.1-2); else they go in the dead part, at DC's factors.

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the soil at the base (kN/m).

`horizontal` número · opcional · por defecto 0

Horizontal load in the direction of the width (kN/m).

`moment_width` número · opcional · por defecto 0

Moment that moves the load off centre along the width (kN·m/m); positive moves it towards x = B.

`vertical_earth_pressure` grupo · opcional

Optional: the weight of the soil on the footing, as an abutment's or a retaining wall's (AASHTO's EV, γp 1.35 or 1.00, Table 3.4.1-2); else it goes in the dead part.

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the soil at the base (kN/m).

`horizontal` número · opcional · por defecto 0

Horizontal load in the direction of the width (kN/m).

`moment_width` número · opcional · por defecto 0

Moment that moves the load off centre along the width (kN·m/m); positive moves it towards x = B.

`horizontal_earth_pressure` grupo · opcional

Optional: the earth pressure on the structure the footing carries, its horizontal and vertical components and their moment (AASHTO's EH, γp 1.50 or 0.90 active, 1.35 or 0.90 at rest, Table 3.4.1-2).

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the soil at the base (kN/m).

`horizontal` número · opcional · por defecto 0

Horizontal load in the direction of the width (kN/m).

`moment_width` número · opcional · por defecto 0

Moment that moves the load off centre along the width (kN·m/m); positive moves it towards x = B.

`pressure_state` texto · obligatorio · uno de: active, at\_rest

The earth pressure the thrust was computed with: active (the wall moves away from the soil) or at rest; AASHTO factors them 1.50 and 1.35 at their maximum.

`earth_surcharge` grupo · opcional

Optional: what a permanent surcharge on the soil adds, on the footing or as the thrust it brings (AASHTO's ES, γp 1.50 or 0.75, Table 3.4.1-2).

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the soil at the base (kN/m).

`horizontal` número · opcional · por defecto 0

Horizontal load in the direction of the width (kN/m).

`moment_width` número · opcional · por defecto 0

Moment that moves the load off centre along the width (kN·m/m); positive moves it towards x = B.

`live` grupo · opcional

Optional: the part that comes and goes (occupancy, traffic, storage; AASHTO's LL with its IM), and the weight of a live surcharge on the soil over the footing, as over an abutment's heel. Each check takes it in or out, whichever is worse for that check (AASHTO 3.4.1): out where it relieves the footing, a moment that brings the resultant back toward the middle or a weight that adds friction against sliding (C11.5.6, Fig. C11.5.6-3); the settlement takes it in. Free mode takes it unfactored; a code with load factors factors each its own way.

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the soil at the base (kN/m).

`horizontal` número · opcional · por defecto 0

Horizontal load in the direction of the width (kN/m).

`moment_width` número · opcional · por defecto 0

Moment that moves the load off centre along the width (kN·m/m); positive moves it towards x = B.

`live_surcharge` grupo · opcional

Optional: the thrust of a live surcharge on the soil behind the structure, traffic's (AASHTO's LS, 1.75, Table 3.4.1-1), in or out apart from the live part: its horizontal force, its moment and, where the thrust is inclined, its own vertical component, which holds the footing as the thrust's (C11.5.6: one load factor on both). The surcharge's weight on the soil over the footing isn't its thrust: it goes in the live part, which Table 3.4.1-1 factors as it factors LS.

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the soil at the base (kN/m).

`horizontal` número · opcional · por defecto 0

Horizontal load in the direction of the width (kN/m).

`moment_width` número · opcional · por defecto 0

Moment that moves the load off centre along the width (kN·m/m); positive moves it towards x = B.

`friction_load` grupo · opcional

Optional: the friction a bearing or the superstructure passes to the structure (AASHTO's FR, 1.00, Table 3.4.1-1).

`vertical` número · opcional · ≥ 0 · por defecto 0

Vertical load that reaches the soil at the base (kN/m).

`horizontal` número · opcional · por defecto 0

Horizontal load in the direction of the width (kN/m).

`moment_width` número · opcional · por defecto 0

Moment that moves the load off centre along the width (kN·m/m); positive moves it towards x = B.

`time_since_loading` número · opcional · > 0

Optional: the years since the load began, at which the settlement is wanted: how far the clay's consolidation has gone (with its cv) and the sand's creep (Schmertmann's C2). Empty, the final consolidation and no creep (C2 = 1, as Leonards and Holtz advise for clean sands). The settlement check takes the final one.

`methods` grupo · opcional

Methods (advanced): each the designer's choice, with its default.

`bearing_capacity` texto · opcional · uno de: meyerhof\_general, vesic\_general

The nominal bearing resistance's equation; null, the design code's: meyerhof\_general in free mode, vesic\_general under AASHTO. meyerhof\_general: Meyerhof's general bearing capacity equation (1963), with De Beer's shape, Hansen's depth and Meyerhof's inclination factors, and the water table in q and in γ within B below the base (Das & Sivakugan, Eq. 6.28), the textbooks' equation, for a designer who works by it or checks against a book's example. vesic\_general: Vesic's general equation (1975) as AASHTO LRFD 10th writes it, Eq. 10.6.3.1.2a-1: Vesic's Nγ, De Beer's shape factors with the load's inclination factors (Brinch-Hansen's as Vesic modified them), Cwq and Cwγ for the water, and dq only where the soil above the base stays (embedment\_permanent) and none of it is weaker, under a code at most its cap; no dc. FHWA NHI-06-089 prints the equation without the inclination factors (Eq. 8-6) and advises against combining them with the shape factors (§8.4.3.5). For a designer who follows the manuals' and AASHTO's formulation. AASHTO admits either: its nominal resistance is by "accepted soil mechanics theories" (10.6.3.1.2a), with the theoretical method's resistance factor either way. A wall's base and an MSE block take Vesic's always.

`immediate_settlement` texto · opcional · uno de: elastic, schmertmann\_settlement · por defecto "elastic"

The immediate settlement (AASHTO 10.6.2.4.2): the elastic one (10.6.2.4.2a), for any soil, with every stratum's elastic properties (without them, no immediate settlement is computed); or Schmertmann's (10.6.2.4.2c), the strain influence method for cohesionless soils, on each stratum's Es (taken as measured in situ, X = 1.0), with its creep by the years since loading.

`soil` grupo · obligatorio

`strata` lista · obligatorio · 1–50 elementos

Top down from the ground surface; the last stratum may leave its thickness out (it extends down); given, the profile ends at its bottom, over a rigid layer the settlement stops at. A rock below the footing's soil ends the profile: the bearing resistance doesn't count it (the conservative side), and the settlement stops at it.

Cada elemento es uno de:

`drained` A sand, or a clay in the long term: its effective strength, asked where a method of the model reads it (strength\_asked); a sand's relative density, its state, which only the mode of a base's bearing failure reads (docs/ground-model.md, rule 3).

`thickness` número · opcional · > 0 · ≤ 1000

Thickness (m), at most 1000 (app.application.bounds).

`unit_weight` número · obligatorio · > 0

Unit weight γ (kN/m³). Without a measurement, AASHTO's traditional values (Table 3.5.1-1): a compacted sand, silt or clay 18.9; a loose sand, silt or gravel 15.7; a soft clay 15.7; a rolled gravel 22.0.

`saturated_unit_weight` número · opcional · > 0

Saturated unit weight γsat (kN/m³), at least γ and at most γ + 9.81, and more than water's 9.81. Required where the stratum reaches below the water table.

`soil_type` texto · obligatorio · uno de: gravel, sand, silty\_sand, clayey\_sand, silt, clay, rockfill

What the soil is: gravel, sand (clean, fine to coarse, or slightly silty), silty sand, clayey sand, silt or clay; or a quarried rock fill. Each method reads it to know whether it's for this soil (a sand's methods, a clay's), and nothing is assumed without it. A drained stratum may be any type (a clay in the long term, by c' and φ'); an undrained one is a clay or a silt.

`preconsolidation_pressure` número · opcional · > 0

Optional: preconsolidation pressure σ'c (kPa), the stratum's stress history: its consolidation takes it, and a clay's OCR for a pile's shaft. Empty, normally consolidated.

`behavior` texto · obligatorio · = "drained"

`cohesion` número · opcional · ≥ 0 · por defecto 0

Cohesion c' (kPa).

`friction_angle` número · opcional · > 0 · < 90

Friction angle φ' (deg). Required where a method of the model reads it: a footing's bearing resistance (every drained stratum's) and its sliding (the base stratum's), a wall's always; not where a footing in free mode has its allowable bearing pressure given, no horizontal load, and no strength on its base stratum.

`relative_density` número · opcional · ≥ 0 · ≤ 1

Optional, for a gravel, a sand or a silty sand without c': its relative density Dr, from 0 to 1, as the soil study gives it from its SPT, CPT or density tests. It decides only the mode the base on it fails in, by Vesic's chart of the modes of failure in sand (FHWA NHI-06-089 Fig. 8-19; AASHTO Fig. C10.6.3.1.2b-1) at the base's relative depth Df/B\*: where that's local or punching shear, the bearing is checked again with c\* and φ\*, beside the general one; φ' stays its strength. Empty, Vesic's rigidity index judges the mode where the stratum B/2 below the base gives its stiffness (Es and μs), else the general shear alone; past Df/B\* 3.67 the chart puts any sand in local or punching shear.

`stiffness` grupo · opcional

Optional: with the stiffness of every stratum the elastic settlement is computed too.

`soil_modulus` número · obligatorio · > 0

The soil's elastic modulus Es (kPa), taken as measured in situ (AASHTO 10.4.6.3: a pressuremeter's, where the deformation is critical).

`poisson_ratio` número · obligatorio · ≥ 0 · ≤ 0,5

Poisson's ratio μs.

`consolidation` grupo · opcional

Optional, for a silt or a clay: with these, the stratum's consolidation settlement is computed and added to the settlement (AASHTO 10.6.2.4.3).

`compression_index` número · obligatorio · > 0

Compression index Cc, from one-dimensional consolidation tests (AASHTO 10.4.6.3).

`swelling_index` número · opcional · > 0

Swelling index Cs. Required with a preconsolidation pressure above the stratum's σ'o.

`initial_void_ratio` número · obligatorio · > 0

Initial void ratio eo, at the stratum's initial vertical effective stress (AASHTO 10.6.2.4.3), from the consolidation test.

`coefficient_of_consolidation` número · opcional · > 0

Optional: coefficient of consolidation cv (m²/year), for how long the stratum takes; from 1 for a low permeability clay to 100 for an overconsolidated sandy one (Das & Sivakugan, section 2.16). It drains through the faces it shares with a drained soil or the ground surface.

`rock` Rock below the footing's soil (or a wall's): where the soil's settlement stops and the bearing resistance doesn't count it (AASHTO's equations take the soil, the conservative side). A base resting on the rock isn't calculated: it goes on the soil above.

`thickness` número · opcional · > 0 · ≤ 1000

Thickness (m), at most 1000 (app.application.bounds).

`behavior` texto · obligatorio · = "rock"

`undrained` A clay in the short term: its undrained strength, φ = 0.

`thickness` número · opcional · > 0 · ≤ 1000

Thickness (m), at most 1000 (app.application.bounds).

`unit_weight` número · obligatorio · > 0

Unit weight γ (kN/m³). Without a measurement, AASHTO's traditional values (Table 3.5.1-1): a compacted sand, silt or clay 18.9; a loose sand, silt or gravel 15.7; a soft clay 15.7; a rolled gravel 22.0.

`saturated_unit_weight` número · opcional · > 0

Saturated unit weight γsat (kN/m³), at least γ and at most γ + 9.81, and more than water's 9.81. Required where the stratum reaches below the water table.

`soil_type` texto · obligatorio · uno de: clay, silt

What the soil is: a clay or a silt, the soils taken undrained in the short term (a granular soil is always drained, Das & Sivakugan, section 2.22: make the stratum drained).

`preconsolidation_pressure` número · opcional · > 0

Optional: preconsolidation pressure σ'c (kPa), the stratum's stress history: its consolidation takes it, and a clay's OCR for a pile's shaft. Empty, normally consolidated.

`behavior` texto · obligatorio · = "undrained"

`undrained_shear_strength` número · opcional · > 0

Undrained shear strength cu (kPa). Required where a method of the model reads it: a footing's bearing resistance on the stratum it rests on, its sliding there, and a wall's always; not where a footing in free mode has its allowable bearing pressure given, no horizontal load, and no strength on its base stratum.

`drained_strength` grupo · opcional

Optional: the clay's effective strength c' and φ', where it could soften and lose strength with time (a stiff fissured or overconsolidated clay, a compacted cohesive fill): its bearing is checked drained as well, under the permanent loads only, and the lower governs (AASHTO 10.6.3.1.2a, C10.6.3.1.1). Empty, the short-term undrained check alone.

`cohesion` número · opcional · ≥ 0 · por defecto 0

Cohesion c' (kPa).

`friction_angle` número · obligatorio · > 0 · < 90

Friction angle φ' (deg) of the clay in the long term.

`stiffness` grupo · opcional

Optional: with the stiffness of every stratum the elastic settlement is computed too.

`soil_modulus` número · obligatorio · > 0

The soil's elastic modulus Es (kPa), taken as measured in situ (AASHTO 10.4.6.3: a pressuremeter's, where the deformation is critical).

`poisson_ratio` número · obligatorio · ≥ 0 · ≤ 0,5

Poisson's ratio μs.

`consolidation` grupo · opcional

Optional, for a silt or a clay: with these, the stratum's consolidation settlement is computed and added to the settlement (AASHTO 10.6.2.4.3).

`compression_index` número · obligatorio · > 0

Compression index Cc, from one-dimensional consolidation tests (AASHTO 10.4.6.3).

`swelling_index` número · opcional · > 0

Swelling index Cs. Required with a preconsolidation pressure above the stratum's σ'o.

`initial_void_ratio` número · obligatorio · > 0

Initial void ratio eo, at the stratum's initial vertical effective stress (AASHTO 10.6.2.4.3), from the consolidation test.

`coefficient_of_consolidation` número · opcional · > 0

Optional: coefficient of consolidation cv (m²/year), for how long the stratum takes; from 1 for a low permeability clay to 100 for an overconsolidated sandy one (Das & Sivakugan, section 2.16). It drains through the faces it shares with a drained soil or the ground surface.

`water_table` grupo · opcional

null when there is none.

`depth` número · obligatorio

Depth below the ground surface on its side (m); negative when the water stands above it.

`design` grupo · opcional

The mode its checks are judged in, free or a design code, and the designer's limits. Empty, free mode.

`code` texto · opcional · uno de: free\_mode, aashto\_lrfd\_10 · por defecto "free\_mode"

The mode the checks are judged in. free\_mode: no design code; the methods are the designer's (each left by the data, or chosen), each check gives its unfactored factor of safety or its quantity, and only the checks the designer set a limit for (limits) have a verdict; the limits the codes and manuals ask come beside each check as references. aashto\_lrfd\_10: AASHTO LRFD Bridge Design Specifications, 10th edition (2024), load and resistance factor design, each check φRn/ΣγQ ≥ 1, with the methods the code admits.

`limits` número · opcional

Optional: the designer's limits, by the check's id (its factor of safety, or its settlement, deflection or eccentricity in m). In free mode, the only checks with a verdict; under a code, in place of the code's, and the answer says what the code asks.

`resistance_factors` número · opcional

Optional, with a code of load and resistance factors: the resistance factors φ the designer edited, by the check's id, in place of the code's.

`load_modifier` grupo · opcional

With a code of load and resistance factors: the code's load modifier η = ηD ηR ηI on the strength limit state's factors (under AASHTO LRFD 10th, 1.3.2.1 to 1.3.5), 1.00 each by default.

`ductility` número · opcional · ≥ 0,95 · por defecto 1

ηD (AASHTO 1.3.3): 1.00 for conventional designs and details; 1.05 or more for nonductile components and connections; 0.95 or more where ductility-enhancing measures beyond the code's are specified.

`redundancy` número · opcional · ≥ 0,95 · por defecto 1

ηR (AASHTO 1.3.4): 1.00 for conventional redundancy, and always for a footing or a pile, whose φ already accounts for it (10.5; another value is refused there, and a pile's φ for few elements under its support is redundancy\_factor's); 1.05 or more for nonredundant members; 0.95 or more for exceptional redundancy.

`importance` número · opcional · ≥ 0,95 · por defecto 1

ηI (AASHTO 1.3.5): 1.00 for typical bridges; 1.05 or more for critical or essential bridges; 0.95 or more for relatively less important ones, as the Owner classifies them.

---

Source: https://rischio.io/es/docs/shallow-foundation/inputs/
