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.
| 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 |
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.
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.
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.
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.