omni_drainage_tile_spacing
Calculates subsurface drainage tile lateral spacing, pipe size, water-table drawdown, and installed cost per acre from soil conductivity, drainage coefficient, and installation depth.
Instructions
Agricultural Subsurface Drainage Tile Spacing & Sizing Calculator. Calculate subsurface corrugated HDPE drainage tile lateral spacing in feet, drainage coefficient, and pipe diameter using Hooghoudt's equation. Discipline: AGRICULTURE. Governing mathematical model / formula: Tile Spacing S² = (8 · K · d · h + 4 · K · h²) / Drainage Coefficient (q in/day).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of recommended_tile_spacing_ft (Optimal Lateral Tile Spacing), linear_feet_tile_per_acre (Required Tile Pipe Per Acre), water_table_drawdown_time (Water Table Drawdown Speed), turnkey_drainage_cost_acre (Est. Installed Cost (@ $1.25/ft)) using soil_hydraulic_cond_in_hr (Soil Hydraulic Conductivity (Inches/Hour) in in/hr), drainage_coefficient_in_day (Drainage Coefficient (Inches/Day) in in/day), tile_installation_depth_ft (Tile Installation Depth (Feet) in ft). 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 'Agricultural Subsurface Drainage Tile Spacing & Sizing Calculator' 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): "drainage-tile-spacing"
category (string): "agriculture"
name (string): "Agricultural Subsurface Drainage Tile Spacing & Sizing Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.recommended_tile_spacing_ft (Optimal Lateral Tile Spacing): Formatted display string (e.g. '45.0 Feet Apart')
metrics.linear_feet_tile_per_acre (Required Tile Pipe Per Acre): Formatted display string (e.g. '968 Linear Feet / Acre')
metrics.water_table_drawdown_time (Water Table Drawdown Speed): Formatted display string (e.g. '24 Hours (Prevents Root Drowning)')
metrics.turnkey_drainage_cost_acre (Est. Installed Cost (@ $1.25/ft)): Formatted display string (e.g. '$1,210.00 / Acre')
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_drainage_tile_spacing"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| soil_hydraulic_cond_in_hr | No | Soil Hydraulic Conductivity (Inches/Hour) (in/hr). Silty clay ~0.2, silt loam ~0.8, sandy loam ~2.0. Default: 0.8. Min: 0.05. Max: 5. | |
| tile_installation_depth_ft | No | Tile Installation Depth (Feet) (ft). Average depth from ground surface to tile invert. Default: 3.5. Min: 2.5. Max: 6. | |
| drainage_coefficient_in_day | No | Drainage Coefficient (Inches/Day) (in/day). Standard field crops = 0.38 - 0.50 in/24hr; specialty crops = 0.75 - 1.0 in/24hr. Default: 0.5. Min: 0.25. Max: 1.5. |