omni_solar_pv_sizing
Calculates required solar PV DC system size, panel count, roof area, and daily generation from annual kWh usage, peak sun hours, derate factor, and panel wattage.
Instructions
Solar PV System Sizing & DC kW Array Calculator. Determine the exact DC kilowatt rating and number of solar panels required to offset 100% of annual household or facility electrical consumption. Discipline: ENERGY. Governing mathematical model / formula: Required DC kW = Annual kWh Demand / (365 × Daily Peak Sun Hours × Derate Factor).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of system_size_kw (Recommended DC System Size), panel_count (Required Number of Panels), roof_area_sqft (Estimated Roof Space Required), daily_generation (Avg Daily AC Energy Produced) using annual_usage_kwh (Annual Electricity Usage (kWh) in kWh), peak_sun_hours (Daily Peak Sun Hours in hrs/day), derate_factor (System Performance Ratio), panel_wattage (Panel Rated Wattage (Watts DC) in W), target_offset_pct (Target Energy 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.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Solar PV System Sizing & DC kW Array 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): "solar-pv-sizing"
category (string): "energy"
name (string): "Solar PV System Sizing & DC kW Array 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 DC System Size): Formatted display string (e.g. '8.9 kW DC')
metrics.panel_count (Required Number of Panels): Formatted display string (e.g. '22 panels')
metrics.roof_area_sqft (Estimated Roof Space Required): Formatted display string (e.g. '430 sq ft')
metrics.daily_generation (Avg Daily AC Energy Produced): Formatted display string (e.g. '32.8 kWh')
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_pv_sizing"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| derate_factor | No | System Performance Ratio. Losses from inverter, wiring, dust, and temperature. Default: 0.82. Min: 0.65. Max: 0.95. | |
| panel_wattage | No | Panel Rated Wattage (Watts DC) (W). Rated nameplate capacity per solar module. Default: 410. Min: 300. Max: 650. | |
| peak_sun_hours | No | Daily Peak Sun Hours (hrs/day). Average equivalent solar irradiance (kWh/m²/day). Default: 4.5. Min: 2.5. Max: 7. | |
| annual_usage_kwh | No | Annual Electricity Usage (kWh) (kWh). Sum of 12 monthly electric bills. Default: 12000. Min: 2000. Max: 150000. | |
| target_offset_pct | No | Target Energy Offset (%) (%). Desired percentage of electric bill to offset. Default: 100. Min: 25. Max: 150. |