nz-solar-potential

How the money is worked out

Every dollar figure on the map comes from the bill tool, bill_tool.js. It models a power bill with and without solar (and a battery), then runs the savings out over the panels’ life. Cost tiers, prices and the battery simulation it calls are in economics.js.

It is a model, not a quote. Every input is on screen and editable, and every figure opens to its workings.

Tests: node tests/test_bill_tool.mjs and node tests/test_economics.mjs.

The steps

  1. Household use. A home uses the Electricity Authority’s average for its regional council (EMI, 2025; Otago 7,829 kWh a year), scaled for how many people live there and for the size of the house (by roof area: under 100 m² 30% less, 100–140 m² 15% less, 140–220 m² typical, 220–300 m² 15% more, 300–400 m² 30% more, over 400 m² 50% more), plus electric cars. How much each season’s day uses follows the town’s metered half-hourly load (EMI); its spread over the hours follows metered homes (GREEN Grid study, 2015): low overnight, a morning peak, a midday dip and a larger evening peak. A non-home building uses electricity per m² of floor by type (business 100, school 35, hospital 150, community 40 kWh/m² a year, at least 6,000 kWh) on a floor of roof area × storeys from its LiDAR height, plus heating by degree-days and cars.
  2. Your bills (optional). Enter a winter and a summer bill, or a yearly kWh figure, and the modelled load is scaled to match.
  3. Solar. The roof’s own average day in each season: the generation curve drawn on the building card, scaled to the system shown. Its year equals the roof’s annual generation figure.
  4. Hour by hour. For an average day in each season, solar serves the load first, then charges the battery, then exports. What is left comes from the grid. The bill is imports × price + daily charge − exports × buyback.
  5. Over the years. Bill savings are run out for 30 years: power prices rise, export rates fall, panels lose output, and the inverter (and any battery) is replaced. Figures are in today’s dollars by default.
  6. Results. Winter and summer monthly bills now and with solar, bill savings, net savings over 30 years, payback year and return on investment (the yearly rate at which the savings, discounted back, equal the cost).

Default assumptions

Assumption Default
Install cost $3,000/kW under 3 kW; $2,300 for 3–8 kW; $1,800 for 8–25 kW; $1,500 for 25–50 kW; $1,200 over 50 kW (incl. GST). Each rate sits at the middle of its band and the per-kW rate runs in a straight line between them (costPerKw), so the total rises with every kW
Home prices 50c/kWh peak, 25c off-peak, $2.50/day; flat plan 30c. The Electricity Authority’s prices replace these where the site names a network region (SITE.priceRegion)
Business prices 22c/kWh peak, 12c off-peak, no daily charge (energy prices only; network charges are a separate bill solar does not change); flat plan 18c
Export price 12c/kWh in the day; at peak 23c for a home and 15c for a business; falling 2% a year
Peak hours 7–10am and 6–9pm
Power price rise 4% a year
General inflation (to today’s dollars) 2% a year
Panel output loss 0.5% a year
System life 30 years
Inverter replaced in year 16 (after 15 years) at 18% of the solar cost
Battery $900/kWh, 5 kW, 90% round trip, 10% reserve, replaced in year 15 (after 14 years) at 70% of today’s price; charges from solar only, never the grid
Household 3 people (EMI regional average home and the town’s metered load shape), no car, no battery

Home or business

The council’s district plan zone decides it (tools/fetch_zoning.py, Queenstown Lakes District Council). Roof size is not a use signal: a 450 m² house and a 450 m² shop look the same from above. Where a zone allows both, or no zoning exists, a roof over 400 m² or a system over 100 kW counts as a business.

System size

Until you move the size slider, a home (one household, under 350 m² of roof) shows its best panels up to 14 kW. Businesses and larger residential buildings show every panel that fits. The building card also works out the economic size, the panels that pay for themselves, and offers it with one tap.

Panel colours

Every roof’s panel colours come from the same bill model. Panels that cover power used on site, sunniest first, are valued at the retail price. The rest are valued at the export price. A panel’s colour shows whether its generation repays its share of the cost. A roof that is not open uses the daily shape of a sunny-side roof in its area, scaled to its own yearly kWh, so it keeps its colours when you open it.

Battery for resilience

Low-solar runs come from ERA5 daily sunlight, 1940–2025 (low_solar.js). For a home, the battery is sized to run on roof and battery alone through the year’s hardest low-solar run (a normal year, once a decade, or the record), using the bill tool’s hour-by-hour household use, winter heating included. If the roof makes less than the home uses on an average winter day, that shortfall is shown separately.

What the model leaves out

Check it yourself