Inputs
Every field a model of a footing takes, as the engine's schema gives it: what it is, its unit and convention, and its limits.
A model is a JSON document, the same one the studio’s forms build, its AI writes and an agent sends with create_model. Every element has an id, stable and unique in the model (the results name by it the elements each check depends on), and a name, shown on the canvas and in the report; strata can also carry a color. Every model states its contract_version, today 2. Units are SI: kN, m, kPa, kN/m³ and degrees.
These are its fields, from the engine’s own schema: what the studio’s forms are built from, and what get_tool_schema gives an agent.
footingone of · required
rectangularA rectangular or square footing, such as under a column.
shapetext · required · = "rectangular"
widthnumber · required · > 0
Width B (m), the side the horizontal load and moment_width act along. The bearing capacity and the settlement take the shorter side as B either way.
lengthnumber · required · > 0
Length L (m).
embedment_depthnumber · optional · ≥ 0 · default 0
Depth of the base below the ground surface, Df (m).
loadgroup · required
verticalnumber · required · > 0
Vertical load that reaches the soil at the base of the footing (kN).
horizontalnumber · optional · default 0
Horizontal load in the direction of the width (kN).
moment_widthnumber · optional · default 0
Moment that moves the load off centre along the width (kN·m); positive moves it towards x = B.
moment_lengthnumber · optional · default 0
Moment that moves the load off centre along the length (kN·m).
stripA long footing, such as under a wall: analysed per metre of length.
shapetext · required · = "strip"
widthnumber · required · > 0
Width B (m).
embedment_depthnumber · optional · ≥ 0 · default 0
Depth of the base below the ground surface, Df (m).
loadgroup · required
Per metre of footing: there is no length, so no moment along it.
verticalnumber · required · > 0
Vertical load that reaches the soil at the base (kN/m).
horizontalnumber · optional · default 0
Horizontal load in the direction of the width (kN/m).
moment_widthnumber · optional · default 0
Moment that moves the load off centre along the width (kN·m/m); positive moves it towards x = B.
soilgroup · required
stratalist · required · at least 1
Top down from the ground surface; the last stratum may leave its thickness out (it extends down).
Each item:
thicknessnumber · optional · > 0
Thickness (m).
unit_weightnumber · required · > 0
Unit weight γ (kN/m³).
saturated_unit_weightnumber · optional · > 0
Saturated unit weight γsat (kN/m³), at least γ. Required where the stratum reaches below the water table.
cohesionnumber · optional · ≥ 0 · default 0
Cohesion c (kPa).
friction_anglenumber · optional · ≥ 0 · < 90 · default 0
Friction angle φ (deg).
stiffnessgroup · optional
Optional: with the stiffness of every stratum the elastic settlement is computed too.
elastic_modulusnumber · required · > 0
Elastic modulus Es (kPa).
poisson_rationumber · required · ≥ 0 · ≤ 0.5
Poisson's ratio μs.
water_tablegroup · optional
null when there is none.
depthnumber · required
Depth below the ground surface on its side (m); negative when the water stands above it.