Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

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

NameRequiredDescriptionDefault
wall_stem_height_ftNoRetaining Wall Height (H in Feet) (ft). Height from footing base to top of retained soil. Default: 12. Min: 3. Max: 35.
soil_unit_weight_pcfNoBackfill Moist Soil Unit Weight (γ in PCF) (PCF). Compacted sand/gravel backfill density. Default: 120. Min: 95. Max: 140.
soil_internal_friction_angle_degNoSoil Internal Friction Angle (ϕ in Degrees) (degrees). Granular backfill typically ϕ = 30° to 34°. Default: 32. Min: 20. Max: 45.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools