omni_geothermal_ground_loop
Calculates vertical borehole depth or horizontal trench footage for geothermal heat pump ground loops, returning required loop length, bore count, fluid volume, and pump head.
Instructions
Geothermal Heat Pump Ground Loop Borehole Length Calculator. Calculate required vertical borehole depth or horizontal trench loop footage for closed-loop ground-source geothermal heat pump systems. Discipline: ENERGY. Governing mathematical model / formula: Total Vertical Borehole Feet = Heat Pump Tonnage × Borehole Ft/Ton (typically 150 - 200 ft/ton).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of total_loop_footage (Total Required Loop Length), number_of_bores (Recommended Boreholes / Trenches), loop_volume_gal (Circulation Fluid Volume), pump_head_ft (Estimated Loop Pressure Head) using system_tons (Heat Pump Capacity (Tons) in Tons), soil_thermal_cond (Ground Thermal Conductivity (BTU/hr·ft·°F)), loop_configuration (Loop Geometry (1 = Vertical Borehole, 2 = Horizontal Trench)). 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 'Geothermal Heat Pump Ground Loop Borehole Length 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): "geothermal-ground-loop"
category (string): "energy"
name (string): "Geothermal Heat Pump Ground Loop Borehole Length Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.total_loop_footage (Total Required Loop Length): Formatted display string (e.g. '720.0 Linear Feet')
metrics.number_of_bores (Recommended Boreholes / Trenches): Formatted display string (e.g. '4 Bores @ 180 ft each')
metrics.loop_volume_gal (Circulation Fluid Volume): Formatted display string (e.g. '64.8 Gallons')
metrics.pump_head_ft (Estimated Loop Pressure Head): Formatted display string (e.g. '28.5 ft H₂O')
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_geothermal_ground_loop"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| system_tons | No | Heat Pump Capacity (Tons) (Tons). Building design thermal cooling/heating tonnage. Default: 4. Min: 1.5. Max: 50. | |
| soil_thermal_cond | No | Ground Thermal Conductivity (BTU/hr·ft·°F). Dry clay ~0.8, damp loam ~1.3, wet granite/limestone ~1.8. Default: 1.4. Min: 0.6. Max: 2.5. | |
| loop_configuration | No | Loop Geometry (1 = Vertical Borehole, 2 = Horizontal Trench). 1 for vertical drilling, 2 for horizontal excavation. Default: 1. Min: 1. Max: 2. |