omni_gravel
Calculate gravel, crushed stone, or pea gravel tonnage from area length, width, and depth. Returns cubic yards, cubic feet, tons needed, and tandem truckloads for driveways, bases, and drainage.
Instructions
Gravel & Crushed Stone Tonnage Calculator. Calculate cubic yards and metric/US tons of gravel, crush-and-run, or pea gravel for driveways, bases, and drainage. Discipline: CONSTRUCTION. Governing mathematical model / formula: Tons = [Cubic Yards × 1.4 Tons/cu yd].
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of tons_needed (Gravel Required), cubic_yards (Volume (Cubic Yards)), cubic_feet (Volume (Cubic Feet)), tandem_loads (Tandem Dump Truck Loads (~14t)) using length (Driveway / Area Length in ft), width (Driveway / Area Width in ft), depth (Gravel Depth in in), density (Aggregate Density in tons/yd³). 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 'Gravel & Crushed Stone Tonnage 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): "gravel"
category (string): "construction"
name (string): "Gravel & Crushed Stone Tonnage Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.tons_needed (Gravel Required): Formatted display string (e.g. '8.64 tons')
metrics.cubic_yards (Volume (Cubic Yards)): Formatted display string (e.g. '6.17 cu yd')
metrics.cubic_feet (Volume (Cubic Feet)): Formatted display string (e.g. '166.7 cu ft')
metrics.tandem_loads (Tandem Dump Truck Loads (~14t)): Formatted display string (e.g. '1 truckload')
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_gravel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| depth | No | Gravel Depth (in). Compacted layer depth in inches. Default: 4. Min: 1. Max: 24. | |
| width | No | Driveway / Area Width (ft). Width in feet. Default: 10. Min: 1. Max: 100. | |
| length | No | Driveway / Area Length (ft). Length in feet. Default: 50. Min: 1. Max: 1000. | |
| density | No | Aggregate Density (tons/yd³). Crushed limestone ~1.4 tons/yd³. Default: 1.4. Min: 1.1. Max: 1.8. |