Changelog#
3.0.6#
Assumption changes
Updated gas supply projections to reflect Maui closure at the end of 2026.
Removed mining and construction from the list of subsectors where onsite anaerobic digestion is possible.
Updated some industrial sector ESD projection methods following review, most notably tying dairy processing demand to existing cattle stock projections.
Removed endogenous Methanex closure method, instead assuming closure when Maui closes end 2026.
Updated some heatpump costs following review.
Model fixes
Corrected a bug in NDGHG implementation that allowed coal to still be used for cooking post-2037.
Updated GIC demand data to reflect historical Methanex use more accurately.
Adjusted geothermal heatrates to better align with official statistics on primary energy.
Corrected a bug in diesel emissions for electricity generation.
Delayed convergence from empirical 2023 transport utilisation to harmonised within-bucket utilisation assumptions until 2035 (previously 2024), avoiding an abrupt shift immediately after the base year for some vehicle classes.
3.0.5#
Assumption changes
Solar generation capacity factors for different timeslices are now generated from NIWA EPW weather files using PVWatts, using MBIE’s October 2024 TMY3 (present climate) release.
Allowed the electricity sector to build new diesel peakers, using cost and efficiency assumptions from existing OCGT data.
Assumed all grid-scale solar utilised single-axis tracking technology.
Added or tweaked several new industrial technologies, allowing more flexibility in the demand end, including some hydrogen uses.
Added biomass as a fuel option for high-temperature heat in cement production to reflect the Golden Bay Cement biomass transition.
Added existing/known grid-scale battery installations.
Increased battery lifespan assumptions.
Increased geothermal generation lifespan assumptions.
Updated base year data to use latest release of EEUD, revising some figures.
Model features
Rebuilt hydrogen electrolysis methods to correctly utilise electricity demand.
Increased model detail of distributed solar, reflecting improved capacity factor from larger-scale rooftop installations.
Added a more robust demand-flex method. This means ripple control is reflected more accurately with minimal processing overhead. Scalable to other demand flex areas as needed.
Added more detail to near-term or historical modelled plant build timings, ensuring accurate partial generation when fully commissioned partway through a year.
Added new functionality to constrain capital uptake rates of selected technologies.
Model fixes
Resolved an error which led to excessive technology inflexibility in transport utilisation constraints. This allows for more realistic purchasing behaviour across different utilisation categories.
Disabled excessive optimisation of energy service demand between timeslices, which was leading to unrealistic demand flex behaviour. Note that this change also disables ESD timeslice reporting.
Corrected several links in biogas topology.
Resolved an issue that was leading to unrealistic switching behaviour in Other Industry demand.
3.0.4#
Assumption changes
Adjusted lightbulb lifetimes in residential and commercial sectors according to usage assumptions.
Ensured realistic minimum utilisation of peaking plants.
Slightly increased conservative hydro peaking contribution assummption to 90%.
Create “two-tier” LNG market, limiting its use to electricity generation.
Model fixes
Corrected implementation of new technologies for industrial applications.
Resolved a bug in implementation of 2037 coal boiler ban for intermediate process heat.
Resolved an issue that made industrial petrol engines more efficient than intended.
Resolved a bug leading to infeasible coal and biogas usage.
Added unallocated onsite generation to total system demand, ensuring system balance.
Add missing residential petrol emissions.
Allowed some industrial subsectors to electrify water heating using technologies already found in other subsectors.
3.0.3#
Features
Changed distributed solar process to use exogenous forecasts, providing more realistic results.
Rebuilt gas distribution network to allow for biomethane blending and more accurately represent maintenance costs as fixed, rather than per unit of throughput.
Assumption changes
Adjusted LNG terminal to fixed installation date in 2027 for Steady scenario. LNG remains excluded from Shift.
Also removed MIP functionality as this is no longer required.
Minor adjustments to capital costs for agricultural heating technologies following review.
Decreased average geothermal generation assumption slightly to align better with base year data.
Removed contingent gas from Steady scenario.
Model fixes
(Biofuel) Improved municipal waste production differences between scenarios.
(Gas supply) Fixed historical domestic field output levels.
(Electricity generation) Fixed incorrect wind availability curve assumptions.
(Electricity generation) Fixed dispatchable hydro and wind peak contribution factors not aligning with documentation.
(Agriculture) Improved modelling of geothermal heating for indoor cropping.
(Agriculture) Fixed a bug that meant agricultural energy emissions were counted incorrectly.
(Agriculture) Added greater distinction for refrigeration, offroad transport, and heating technologies.
(Agriculture) Resolved an issue that meant petrol-powered boats and farm bikes were more efficient than intended.
(Residential) Fixed an issue allowing too much flexibility in space heating technologies.
(Commercial) Added greater distinction for boilers, burners, and resistance heaters.
(Commercial) Fixed modelling of geothermal heating for education, healthcare, WSR, and other commercial sectors.
(Commercial) Resolved an error that led to some LPG, natural gas, diesel, and petrol technologies being cheaper than intended.
(Industry) Resolved an error that allowed Methanol and Urea to close different parts of their business at different rates.
3.0.2#
Features
Added more detail to residential load curves, allowing for different load profiles per use type.
Added an additional biofuel supply forecast scenario with AD feedstock growth and higher recoverability of biomass.
Separated biogas and biomethane modelling commodities, including a specific process for carbon scrubbing.
Added demand flex options for residential water heating, including splits between scenarios.
Model fixes
(Residential) Resolved an error that undercounted space heating demand in detached dwellings.
(Natural gas) Fixed a methodological error that double-counted domestic natural gas costs.
(Commercial) Resolved an error that left commercial heatpumps more expensive and with worse efficiency than intended.
(Residential, Commercial) Fixed a methodological error that overly restricted demand device time flexibility.
(Electricity generation) Ensured geothermal plants operate as baseload.
(Electricity generation) Resolved an error that limited hydro dam output flexibility.
Assumption changes
(Electricity generation) Adjusted Steady and Shift NREL scenarios from Conservative and Moderate to Moderate and Advanced, respectively.
(Commercial, Residential) Increased heatpump lifetimes slightly.
(Industrial) Removed some load curve assumptions.
3.0.1#
Features
Incorporated documentation into sphinx-based site for hosting on readthedocs.
Explorer now includes detailed transport demand, service, and capacity chart options.
Model fixes
(Biofuel) Ensured electricity demand was integrated into biofuel transformation processes.
(Commercial) Resolved an error that led to some demand technologies being cheaper than intended.
(Electricity) Ensured biogas and biomethane were made available as options for existing gas-fired plants.
(Electricity) Allowed Huntly Rankines to use black pellets.
(Transport) Ensured utilisation band constraints were properly fixed across model horizon.
(Transport) Resolved an error that led to electric heavy truck costs decreasing faster than intended in some scenarios.
(Transport) Resolved an error that led to some vehicle types having unrealistic utilisation rates.
3.0.0#
Features
Initial build of
PREPARE-TIMES-NZmodule, which creates TIMES-NZ model files based on hosted data and code.All preprocessing methods migrated to python and open-sourced, to ensure replicability and tracability.
Initial build of
TIMES-NZ-INTERNAL-QAmodule, which allows for post-processing and interrogation of model results.Results hosted publicly and can be explored at the highest possible level of detail to ensure transparency.
Rebuilt and updated model for base year 2023 and new Steady and Shift scenarios.