pv_efficiencynumberdefault: 0.180.1–0.3 (step 0.01)Conversion efficiency of photovoltaic panels (fraction). Standard commercial panels: 0.15–0.20; premium: 0.22–0.25.
Each 0.01 increase in efficiency adds roughly 6% to annual yield. High-efficiency panels cost more but reduce payback period on roof-area-constrained buildings.
wind_turbine_hub_heightnumberdefault: 00–150 (step 10)Hub height of any rooftop or ground-mounted wind turbines. Set to 0 to disable wind analysis.
Urban wind turbines are effective only above ~30 m hub height where mean wind speeds exceed 4 m/s. Buildings below 6 storeys rarely justify rooftop turbines.
target_renewable_pctnumberdefault: 500–100 (step 5)District-level target for on-site renewable generation as a fraction of total demand.
Achieving 50% self-sufficiency typically requires PV on 70–80% of suitable rooftops plus battery storage. 100% requires significant storage or export agreements.
battery_storage_hoursnumberdefault: 40–24 (step 1)Hours of average demand that can be covered by on-site battery storage. Increases self-consumption of PV.
4 hours of storage raises PV self-consumption from ~30% to ~60% in a typical residential district. Beyond 8 hours yields diminishing returns.
Run with default settings to see a baseline renewable potential map. Then: - Increase pv_efficiency to 0.22 to model premium panels - Set battery_storage_hours = 8 to see improved self-consumption - Adjust target_renewable_pct to find which buildings are critical to hitting district targets Sort the ROI table to prioritise buildings with <10-year payback for a near-term investment programme.