Inputs
Every field a model of a retaining wall 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.
wallone of · required
concreteGravity, cantilever, L or T walls of concrete or masonry: solid parts.
partslist · required · 1–20 items
Bottom up, in a section with the toe at x = 0 and the backfill towards larger x. The wall's height is the sum of the parts' heights.
Each item is one of:
rectangle
shapetext · required · = "rectangle"
xnumber · optional · default 0
Horizontal position of the part's bottom-left corner, from the toe (m).
heightnumber · required · > 0
Height (m).
widthnumber · required · > 0
Width (m).
trapezoid
shapetext · required · = "trapezoid"
xnumber · optional · default 0
Horizontal position of the part's bottom-left corner, from the toe (m).
heightnumber · required · > 0
Height (m).
bottom_widthnumber · required · > 0
Width at the bottom (m).
top_widthnumber · required · ≥ 0
Width at the top (m); 0 makes a triangle.
back_batternumber · optional · ≥ 0 · < 90 · default 0
Angle from the vertical of the face on the backfill side (deg); 0 keeps that face vertical and the other one leans.
embedment_depthnumber · optional · ≥ 0 · default 0
Depth of the base below the ground in front of the toe (m).
kindtext · required · = "concrete"
materialgroup · required
Mass or reinforced concrete, or mortared masonry: no voids.
unit_weightnumber · required · > 0
Unit weight (kN/m³): about 24 for concrete.
gabionStacked gabion levels, one part each: every level is checked too.
partslist · required · 1–20 items
Bottom up, in a section with the toe at x = 0 and the backfill towards larger x. The wall's height is the sum of the parts' heights.
Each item is one of:
rectangle
shapetext · required · = "rectangle"
xnumber · optional · default 0
Horizontal position of the part's bottom-left corner, from the toe (m).
heightnumber · required · > 0
Height (m).
widthnumber · required · > 0
Width (m).
trapezoid
shapetext · required · = "trapezoid"
xnumber · optional · default 0
Horizontal position of the part's bottom-left corner, from the toe (m).
heightnumber · required · > 0
Height (m).
bottom_widthnumber · required · > 0
Width at the bottom (m).
top_widthnumber · required · ≥ 0
Width at the top (m); 0 makes a triangle.
back_batternumber · optional · ≥ 0 · < 90 · default 0
Angle from the vertical of the face on the backfill side (deg); 0 keeps that face vertical and the other one leans.
embedment_depthnumber · optional · ≥ 0 · default 0
Depth of the base below the ground in front of the toe (m).
kindtext · required · = "gabion"
materialgroup · required
unit_weightnumber · required · > 0
Unit weight of the gabions, voids included (kN/m³).
base_friction_anglenumber · required · > 0 · < 90
Friction between stacked gabion levels, for each level's sliding (deg).
backfillgroup · required
surface_slopenumber · optional · ≥ 0 · < 90 · default 0
Slope of the backfill surface (deg from the horizontal), no steeper than the friction angle of any backfill stratum.
stratalist · required · at least 1
Top down from the crest to the base, each with its thickness: together they add up to the wall's height.
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).
water_tablegroup · optional
null when the backfill is drained, the usual case.
depthnumber · required · ≥ 0
Depth below the wall's crest (m): behind the wall the water can't stand above it.
foundationgroup · required
stratalist · required · at least 1
Top down from the ground in front of the toe; 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).
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.
loadslist · optional
Loads on the backfill surface; often none.
Each item:
typetext · optional · = "uniform" · default "uniform"
qnumber · required · ≥ 0
Surcharge q (kPa).