Methodology & limitations
Every assumption in the open.
A solar payback estimate is only useful if you can inspect its data, formulas and blind spots. This is exactly what the current model does—and does not do.
Solar production data
Production comes from the European Commission JRC PVGIS 5.3 PVcalc service. Requests use crystalline silicon, 1 kWp peak power, fixed tilt and aspect, a configurable system-loss percentage and terrain horizon. Directory pages use 30° tilt, due south (aspect 0°) and 14% losses so cities remain comparable.
The annual value is PVGIS E_y for 1 kWp; monthly values are E_m. Year-to-year variation is PVGIS SD_y. These are long-term modelled estimates from satellite radiation records, not measurements on an individual roof.
Caching and failure behavior
Profiles are cached for 24 hours in the serving environment and may be served with shared cache headers. If a refresh fails and an older cached profile exists, that profile is returned with a visible stale-data notice. If no profile exists, the city reports a service failure rather than inventing a value.
Energy allocation
- Generation in year n = annual yield × system size × (1 − degradation)n−1.
- Self-used energy = generation × self-use share, capped at annual household consumption.
- Exported energy = generation − self-used energy.
- Import savings = self-used energy × import tariff, escalated at the import escalation rate.
- Export revenue = exported energy × export tariff, escalated independently.
The self-use percentage is an annual user assumption. It does not infer hourly behavior from an annual total.
Cash flow and investment metrics
- Upfront cost = system size × installed cost per kWp − confirmed grant, floored at zero.
- Maintenance = system size × annual maintenance per kWp, escalated at the maintenance escalation rate.
- Inverter replacement is deducted in the selected year when enabled; replacement cost is zero by default only if the user excludes it.
- Annual net cash flow = import savings + export revenue − maintenance − replacement.
- Simple payback is interpolated within the year cumulative undiscounted cash first reaches zero.
- NPV discounts upfront and annual flows at the selected discount rate.
- IRR is solved by bisection across −99% to 100% and is blank when no sign change exists in that interval.
- LCOE = discounted upfront, maintenance and replacement costs ÷ discounted generation.
Reference payback in the directory
Reference economics use one common illustrative scenario to make cities comparable. They are not local installation prices, tariff estimates or recommended system sizes. Always replace the defaults with your own quote and bill.
What the model does not know
- Hourly consumption, interval-meter data, battery dispatch, round-trip losses, depth of discharge or battery degradation.
- Roof-specific shading, structural suitability, usable area, cable routes, planning restrictions or equipment downtime.
- Fixed bill charges, time-of-use tariffs, taxes, net-metering rules or tariff changes unless explicitly entered.
- Panel-level failures, warranty outcomes, insurance, financing interest, taxes and residual equipment value.
For a battery or complex-tariff decision, use an hourly model with real consumption data and a site-specific engineering assessment.
Reproducibility
CSV and PDF exports include the scenario assumptions, solar source period, retrieval date and annual cash-flow ledger. Saved scenarios include a dated profile snapshot. Shared scenarios request a current profile and can therefore differ if PVGIS updates its data.