Development Changelog
v3.5.0
Released: pendingcharacteristics
[characteristics] [feature] [documentation] [outputs] [technical reference guide] ¶
Date: 2025-04-06
Title: Solar Hot Water
Description: Break out Solar Thermal from Other Fuel for Water Heater Fuel, consolidate Solar Hot Water with Water Heater Efficiency, assign all solar hot water systems as roof pitch installed 40ft solar collectors with some orientation diversity.
Assignees: Lixi Liu, Anthony Fontanini, Jeff Maguire
References: pull request 1356
[characteristics] [feature] [documentation] [outputs] [technical reference guide] ¶
Date: 2025-02-28
Title: Electric Vehicles
Description: Introduce EVs, including vehicle and charging stock characterization and assignment of EV battery modeling arguments.
Assignees: Andrew Speake, Anthony Fontanini, Rajendra Adhikari
References: pull request 1299
[characteristics] [feature] ¶
Date: 2024-12-30
Title: Well pump distribution using AHS
Description: Use 2017-2019 AHS data to create Misc Well Pump distribution (~11% nationally) with respect to geography/urbanity, building type, and foundation type. Previously well pump was randomly assigned via a manually created distribution.
resstock-estimation: pull request 437
Assignees: Lixi Liu
References: #resstock-estimation 437, pull request 1325
[characteristics] [feature] ¶
Date: 2024-12-03
Title: Add heat pump pool heaters
Description: Add heat pump pool heaters to the baseline.
resstock-estimation: pull request 436
Assignees: Janet Reyna
References: pull request 1324
[characteristics] [electrical panel] [outputs] [standard data release] ¶
Date: 2025-08-06
Title: Panel metrics in SDR
Description: Add metrics for electrical panel breaker space and capacity constraint into SDR’s postprocessing workflow.
Assignees: Lixi Liu
References: pull request 1453
[characteristics] [emissions] [outputs] [standard data release] ¶
Date: 2025-07-31
Title: Cambium 2024 emissions factors
Description: Update the Cambium Emissions factors and geographies from Cambium 2022 to Cambium 2024
Assignees: Andrew Parker, Anthony Fontanini
References: #1281, pull request 1452
[characteristics] [documentation] [technical reference guide] ¶
Date: 2025-04-22
Title: Update Hawaii PV 2023
Description: Update PV data from EIA Form 861 2018 to 2023 to have the latest information.
Assignees: Janet Reyna
References: pull request 1385
[characteristics] [documentation] [technical reference guide] ¶
Date: 2025-04-15
Title: Hawaii cooling saturation
Description: Remove fallback rules from Hawaii and match technology saturation from RECS2020.
Assignees: Janet Reyna
References: pull request 1380
[characteristics] [documentation] [technical reference guide] ¶
Date: 2025-04-06
Title: Refrigeration correction factors
Description: Assign state-level correction factors for freezer and secondary refrigeration to account for the fact that homes can have more than 1 freezer and 2 refrigerators. This also corrects the freezer usage, which was previously assigned to match the national saturation of freezers.
resstock-estimation: pull request 447
Assignees: Lixi Liu, Anthony Fontanini
References: pull request 1379
[characteristics] [documentation] ¶
Date: 2025-04-09
Title: Update HVAC Cooling Partial Space Conditioning for Hawaii
Description: Update of HVAC Cooling Partial Space Conditioning.tsv to separate Hawaii and Miami and to allow for more partial space conditioning in Hawaii.
Assignees: Janet Reyna
References: pull request 1377
[characteristics] [documentation] ¶
Date: 2025-04-05
Title: Differentiate Hawaii in IECC Climate Zone 1A
Description: Split out Hawaii and Florida in Climate Zone 1A to support Hawaii differentiation.
resstock-estimation
Assignees: Janet Reyna
References: pull request 1374
[characteristics] ¶
Date: 2025-01-30
Title: Add Hawaii to TSVs
Description: Add Hawaii in all TSVs - includes a change to PV System Size.tsv to give samples to Hawaii in anticipation of adding to Hawaii to Has PV.tsv. Update TRG to include Hawaii.
resstock-estimation: pull request 441
Assignees: Janet Reyna
References: pull request 1339
standard data release
[feature] [standard data release] ¶
Date: 2025-05-20
Title: SDR Integration Tests
Description: Add ResStock post-processing code to create a publication version of the annual results and commit them for the minimal buildstock test result.
Assignees: Rajendra Adhikari, Anthony Fontanini, Joe Robertson
References: pull request 1398, pull request 1412
[feature] [standard data release] ¶
Date: 2025-04-29
Title: SDR Upgrade Analysis
Description: Implemented CI workflow for validating option application in SDR yaml and added checks to ensure all upgrade options have non-zero applicability.
Assignees: Rajendra Adhikari, Anthony Fontanini
References: pull request 1384
[feature] [documentation] [outputs] [standard data release] ¶
Date: 2025-04-04
Title: HVAC Load Flexibility
Description: Introduce HVAC load flexibility capability to ResStockArgumentsPostHPXML measure. The measure, when asked for, modifies the heating and cooling setpoint to reduce heating and cooling load during peak period to reduce HVAC energy use.
Assignees: Rajendra Adhikari
References: pull request 1259
[standard data release] ¶
Date: 2025-06-18
Title: Use HVAC Detailed Performance Option for a Ducted ASHP
Description: Introduce an ASHP upgrade measure for SDR that is a typical cold climate ducted air source heat pump with detailed performance data. This pull request uses a couple detailed HVAC performance options to define the curves for a ducted version of a variable speed cold climate ASHP. Options are added to options_lookup.tsv and the cold climate ASHP upgrade is added to sdr_upgrades_tmy3.yml.
Assignees: Philip White, Joe Robertson, Anthony Fontanini
References: pull request 1197, pull request 1429
[standard data release] ¶
Date: 2025-06-11
Title: Clean up the SDR yaml file
Description: Clean up the SDR yaml file by moving anchors to the reference section of the yaml. Remove non-SDR upgrades for the 9/30/2025 release.
Assignees: Anthony Fontanini
References: pull request 1429
[standard data release] ¶
Date: 2025-05-28
Title: Two Speed and Variable Speed Geothermal Heat Pumps
Description: Add/modify upgrades defined in the SDR yml file for single-speed, dual-speed (with and without light touch envelope), and variable-speed geothermal heat pumps (GHPs). Use the same package apply logic as ASHP, but only for dwelling units with ducts.
OpenStudio-HPXML: pull request 1878
Assignees: Joe Robertson
References: pull request 1372, pull request 1420
[standard data release] ¶
Date: 2025-04-18
Title: Add Electric Vehicle Demand Flexibility Upgrades
Description: Add Electric Vehicle load flexibility upgrade measures to the Standard Data Release project file.
Assignees: Rajendra Adhikari, Andrew Speake, Anthony Fontanini
References: pull request 1369
[standard data release] ¶
Date: 2025-04-17
Title: EE + Adoption meaure upgrades for EV SDR
Description: Add electric vehicle adoption and electric vehicle efficiency upgrade measures to the SDR project file.
Assignees: Philip White, Andrew Speake
References: pull request 1362
[outputs] [standard data release] ¶
Date: 2025-04-01
Title: Remove end-use emissions from SDR YAML outputs
Description: ResStock SDR currently do not publish end-use emissions. ResStock SDR only publishes totals and totals by fuel. In an effort to reduce the number of outputs, end-use emissions outputs have been removed from the SDR raw outputs. The end-use emissions can still be called out for testing purposes.
Assignees: Anthony Fontanini
References: pull request 1371
documentation
[documentation] [technical reference guide] ¶
Date: 2025-03-12
Title: Update Technical Reference Guide from 3.3.0 to develop
Description: Update the Technical Reference Guide based on the PRs from the split-off point of ResStock Release 3.3.0 to the current develop.
Assignees: Anthony Fontanini
References: pull request 1361
[documentation] [technical development guide] ¶
Date: 2025-01-29
Title: TDG: repository development, including subtree
Description: Add a new “Repository Development” section to the Advanced Tutorial for describing syncing and testing OpenStudio-HPXML branches. Also, remove “Installer Setup” – not sure how relevant this page is anymore.
Assignees: Joe Robertson
References: pull request 1330
[documentation] [ci] [technical development guide] [technical reference guide] ¶
Date: 2025-01-11
Title: Add ResStock Technical Reference Guide
Description: Add the ResStock Technical Reference Guide to the repository and compile it on GitHub actions to keep the PDF up to date.
Assignees: Anthony Fontanini
References: #resstock-estimation 437, pull request 1338
workflow
[workflow] [feature] ¶
Date: 2025-06-17
Title: Use Autosizing Limits and Maintain Duct System Curve
Description: For ducted heat pump upgrades, it adds the ability to limit the autosized heating/cooling capacity based on the existing duct system, and adjust the blower fan efficiency to maintain the duct system curve. This feature is enabled by setting a new ResStockArguments measure argument heat_pump_sizing_is_duct_limited=true for HVAC Heating Efficiency options.
OpenStudio-HPXML: pull request 1584
Assignees: Joe Robertson
References: #1154, pull request 1408
[workflow] [feature] [outputs] ¶
Date: 2025-04-30
Title: Latest OS-HPXML
Description: Make EV charging/discharging unavailable during vacancy periods. Introduce a new argument for including detailed zone conditions timeseries outputs (i.e., temperatures, humidities).
OpenStudio-HPXML: pull request 1967, pull request 1982
Assignees: Joe Robertson
References: pull request 1368
[workflow] [feature] ¶
Date: 2025-03-11
Title: Latest OS-HPXML
Description: All OpenStudio-HPXML changes, no required ResStock changes. Updates to NEEP ASHP sample files, fix possible HVAC sizing error, HPXML class update for attic/foundation types, speed up weather processing, combi boiler error fix, smooth schedule EV plugload, shift all schedules in sync, and fix occupancy aggregation.
Assignees: Joe Robertson
References: pull request 1353
[workflow] [feature] [outputs] ¶
Date: 2025-02-19
Title: Latest OS-HPXML
Description: Allows requesting timeseries EnergyPlus output meters (e.g., –hourly “MainsWater:Facility”), similar to requesting EnergyPlus output variables. Adds new net peak electricity outputs that include PV.
OpenStudio-HPXML: pull request 1918, pull request 1930
Assignees: Joe Robertson, Scott Horowitz
References: pull request 1347
[workflow] [feature] ¶
Date: 2025-02-04
Title: New ResStockArgumentsPostHPXML measure
Description: This measure is introduced to the workflow for postprocessing the output of the BuildResidentialHPXML and BuildResidentialScheduleFile measures. In short, we can use generated schedules (e.g., occupant schedule) to create other detailed schedules (e.g., setpoint schedules). Currently, this is just a stubbed version of the measure – future versions will actually take advantage of the new functionality.
Assignees: Joe Robertson, Rajendra Adhikari
References: #927, pull request 929
[workflow] ¶
Date: 2025-05-15
Title: Update electrical panel open breaker prediction
Description: Update the electrical panel open breaker prediction to account for EV charger presence.
Assignees: Lixi Liu
References: pull request 1385
[workflow] [standard data release] ¶
Date: 2024-01-23
Title: Add Standard Data Release YAML to GitHub Actions
Description: Add an initial Standard Data Release (SDR) YAML file. Add the SDR upgrade file into CI tests to continue progress towards end-to-end testing.
Assignees: Anthony Fontanini
References: #1261, pull request 1329
misc
[bugfix] [postprocessing] ¶
Date: 2025-08-12
Title: Gracefully handle failures in upgrades
Description: Failures in upgrades are treated as if the upgrade didn’t apply, and we copy baseline results for that building. Previously, if there were failures in any building in any upgrades, we removed those buildings from all upgrades.
Assignees: Rajendra Adhikari
References: pull request 1467
[bugfix] [postprocessing] ¶
Date: 2025-07-08
Title: Postprocessing output data type fix
Description: A bug in resstockpostprocessing was making the datatype of applicability to be boolean in baseline but string in upgrades for the parquet files. This was causing the Athena query to fail. This PR fixes the bug.
Assignees: Rajendra Adhikari
References: pull request 1439
[bugfix] [hvac] ¶
Date: 2025-07-08
Title: Fix for BA seasons always enabled
Description: A bug in the code does not allow auto seasons to be turned off. The intended behavior is to run without auto seasons. This pull request fixes this issue.
resstock-estimation: pull request 416
Assignees: Joe Robertson
References: pull request 1254, pull request 1441
[bugfix] ¶
Date: 2025-04-18
Title: Prevent ducted secondary heating when primary heating is ducted
Description: OS-HPXML disallows multiple heating systems on a single distribution system, and ResStock is not set up to have multiple distribution systems. Disallowing ducted secondary heating when primary heating is ducted will prevent this error.
Assignees: Yingli Lou, Lixi Liu, Anthony Fontanini
References: pull request 1362