Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_proctor_soil_compaction

Calculate field soil dry density from wet density and moisture content, and determine relative compaction and pass/fail status against specified maximum dry density.

Instructions

Soil Compaction Dry Density & Optimum Moisture (Proctor Test). Calculate soil dry density from wet bulk density and moisture content, and determine relative compaction percentage against ASTM D698 / D1557 Proctor maximums. Discipline: ENGINEERING. Governing mathematical model / formula: Dry Density γ_d = Wet Density γ_wet / (1 + Moisture Content w% / 100) | Relative Compaction = (γ_d / Max γ_d) × 100.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of calculated_dry_density_pcf (Calculated Field Dry Density), relative_compaction_pct (Achieved Relative Compaction), pass_fail_status (Engineering Specification Status), water_mass_pcf (Water Mass in Soil Matrix) using measured_wet_density_pcf (Measured Field Wet Density (PCF) in PCF (lbs/cu ft)), soil_moisture_content_pct (Field Moisture Content (w %) in %), proctor_max_dry_density (Laboratory Maximum Dry Density (PCF) in PCF), specified_compaction_pct (Specified Engineering Requirement (%) in %). 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.

  • SIBLING ROUTING: Use this dedicated specialist tool for 'Soil Compaction Dry Density & Optimum Moisture (Proctor Test)' rather than generic dispatchers like omni_universal_query. For cross-discipline dynamic dispatch, see omni_universal_query.

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): "proctor-soil-compaction"

    • category (string): "engineering"

    • name (string): "Soil Compaction Dry Density & Optimum Moisture (Proctor Test)"

    • formula (string): Governing mathematical formula string

    • inputs (object): Echoed input parameter dictionary with applied defaults

    • metrics (object): Dictionary of computed outputs:

      • metrics.calculated_dry_density_pcf (Calculated Field Dry Density): Formatted display string (e.g. '119.15 PCF')

      • metrics.relative_compaction_pct (Achieved Relative Compaction): Formatted display string (e.g. '97.7% Compaction')

      • metrics.pass_fail_status (Engineering Specification Status): Formatted display string (e.g. 'PASSES Specification (≥ 95.0%)')

      • metrics.water_mass_pcf (Water Mass in Soil Matrix): Formatted display string (e.g. '13.35 lbs Water / cu ft')

    • 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_proctor_soil_compaction"
  }
}

Input Schema

NameRequiredDescriptionDefault
proctor_max_dry_densityNoLaboratory Maximum Dry Density (PCF) (PCF). ASTM D698 Standard or D1557 Modified Proctor peak density. Default: 122. Min: 90. Max: 150.
measured_wet_density_pcfNoMeasured Field Wet Density (PCF) (PCF (lbs/cu ft)). Nuclear density gauge field wet density measurement. Default: 132.5. Min: 85. Max: 160.
specified_compaction_pctNoSpecified Engineering Requirement (%) (%). Standard specification: 95% under foundations and roadways. Default: 95. Min: 85. Max: 100.
soil_moisture_content_pctNoField Moisture Content (w %) (%). Oven-dry or gauge moisture percentage. Default: 11.2. Min: 2. Max: 35.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools