omni_retaining_wall_rankine_earth
Calculates Rankine active and passive earth pressure coefficients, total lateral thrust, and overturning moment for retaining wall design.
Instructions
Retaining Wall Rankine Lateral Earth Pressure (Active & Passive) Calculator. Calculate active and passive earth pressure coefficients (Ka, Kp), total lateral thrust force, and overturning moment for retaining wall design. Discipline: ENGINEERING. Governing mathematical model / formula: Active Coefficient Ka = tan²(45° - ϕ / 2) | Total Thrust P_a = ½ · Ka · γ · H².
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of total_active_thrust_force (Total Active Lateral Force (P_a)), active_pressure_coeff_ka (Rankine Active Coefficient (Ka)), overturning_moment_ft_lbs (Overturning Moment About Toe), passive_pressure_coeff_kp (Rankine Passive Coefficient (Kp)) using wall_stem_height_ft (Retaining Wall Height (H in Feet) in ft), soil_internal_friction_angle_deg (Soil Internal Friction Angle (ϕ in Degrees) in degrees), soil_unit_weight_pcf (Backfill Moist Soil Unit Weight (γ in PCF) in PCF). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Retaining Wall Rankine Lateral Earth Pressure (Active & Passive) Calculator' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "retaining-wall-rankine-earth"
category (string): "engineering"
name (string): "Retaining Wall Rankine Lateral Earth Pressure (Active & Passive) Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.total_active_thrust_force (Total Active Lateral Force (P_a)): Formatted display string (e.g. '2,642.0 lbs / linear ft')
metrics.active_pressure_coeff_ka (Rankine Active Coefficient (Ka)): Formatted display string (e.g. '0.307')
metrics.overturning_moment_ft_lbs (Overturning Moment About Toe): Formatted display string (e.g. '10,568 ft-lbs / ft')
metrics.passive_pressure_coeff_kp (Rankine Passive Coefficient (Kp)): Formatted display string (e.g. '3.255')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_retaining_wall_rankine_earth"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wall_stem_height_ft | No | Retaining Wall Height (H in Feet) (ft). Height from footing base to top of retained soil. Default: 12. Min: 3. Max: 35. | |
| soil_unit_weight_pcf | No | Backfill Moist Soil Unit Weight (γ in PCF) (PCF). Compacted sand/gravel backfill density. Default: 120. Min: 95. Max: 140. | |
| soil_internal_friction_angle_deg | No | Soil Internal Friction Angle (ϕ in Degrees) (degrees). Granular backfill typically ϕ = 30° to 34°. Default: 32. Min: 20. Max: 45. |