omni_solar_sizing
Calculates solar array size, panel count, annual kWh output, and roof area from monthly usage, sun hours, panel wattage, and offset target for accurate system planning.
Instructions
Solar Panel Array Sizing & kWh Calculator. Calculate solar panel system size (kW), required roof panels, daily energy generation, and utility offset. Discipline: CONSTRUCTION. Governing mathematical model / formula: System Size (kW) = [Annual kWh / (Sun Hours × 365)] / Derate Factor.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of system_size_kw (Recommended Array Size), panel_count (Total Solar Panels Needed), annual_production (Est. Annual Generation), roof_area_needed (Required Unshaded Roof Area) using monthly_kwh (Monthly Electric Usage in kWh), sun_hours (Average Peak Daily Sun Hours in hrs/day), panel_wattage (Solar Panel Rating in watts), offset_target (Target Electric Bill Offset 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 'Solar Panel Array Sizing & kWh 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): "solar-sizing"
category (string): "construction"
name (string): "Solar Panel Array Sizing & kWh Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.system_size_kw (Recommended Array Size): Formatted display string (e.g. '9.43 kW DC')
metrics.panel_count (Total Solar Panels Needed): Formatted display string (e.g. '24 panels (400W)')
metrics.annual_production (Est. Annual Generation): Formatted display string (e.g. '13,200 kWh/yr')
metrics.roof_area_needed (Required Unshaded Roof Area): Formatted display string (e.g. '432 sq 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_solar_sizing"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sun_hours | No | Average Peak Daily Sun Hours (hrs/day). US average is 4.0 to 5.5 peak sun hours. Default: 4.5. Min: 3. Max: 7. | |
| monthly_kwh | No | Monthly Electric Usage (kWh). Average monthly kilowatt-hours from electric bill. Default: 1100. Min: 200. Max: 5000. | |
| offset_target | No | Target Electric Bill Offset (%). Percentage of electric consumption to offset. Default: 100. Min: 25. Max: 150. | |
| panel_wattage | No | Solar Panel Rating (watts). Modern monocrystalline panel: 400W. Default: 400. Min: 300. Max: 500. |