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
| Name | Required | Description | Default |
|---|---|---|---|
| proctor_max_dry_density | No | Laboratory Maximum Dry Density (PCF) (PCF). ASTM D698 Standard or D1557 Modified Proctor peak density. Default: 122. Min: 90. Max: 150. | |
| measured_wet_density_pcf | No | Measured Field Wet Density (PCF) (PCF (lbs/cu ft)). Nuclear density gauge field wet density measurement. Default: 132.5. Min: 85. Max: 160. | |
| specified_compaction_pct | No | Specified Engineering Requirement (%) (%). Standard specification: 95% under foundations and roadways. Default: 95. Min: 85. Max: 100. | |
| soil_moisture_content_pct | No | Field Moisture Content (w %) (%). Oven-dry or gauge moisture percentage. Default: 11.2. Min: 2. Max: 35. |