ComStock 2025 Release 3

See the technical reference documentation for details on assumptions and how the baseline building stock is represented.
See the upgrade documentation for details on measures included in this release (some currently pending publication review/approval).

Software Stack

OpenStudio v3.10.0
EnergyPlus v25.1.0
buildstockbatch v2024.11.0

What's Changed

• Update profiling to run locally and get simulation time by @eringold in #360
• Update Pull Request Template by @mdahlhausen in #365
• Asparke2/sdr 2025 r2 by @ChristopherCaradonna in #361
• Add basic and full metadata columns into data dictionary by @mpraprost in #378
• Fix nulls in out.utility_bills.electricity_bill_num_bills by @eringold in #381
• Split out propane and fuel oil no 2 energy results by @mdahlhausen in #300
• Gap model by @eringold in #328
• Updates gap model for 2025 Release 2 by @asparke2 in #384
• New compare upgrades template by @mpraprost in #387
• Water to water heat pump outputs fix by @amylebar in #374
• Ccaradon/sdr 2025 r3 by @ChristopherCaradonna in #388
• Add Grocery Stores by @mdahlhausen in #364
• Update tsvs-v29.zip by @LandanT in #390
• Add missing district energy emissions columns to postprocessing by @mdahlhausen in #391
• Enable criteria pollutant emissions in full metadata by @mdahlhausen in #394
• Landan t/issue385 fix by @LandanT in #393
• Add criteria pollutant emissions support to postprocessing by @mdahlhausen in #395
• Turn off equipment counts by @mpraprost in #403
• Ghp measure fixes by @mpraprost in #405
• Update hpc.py by @ChristopherCaradonna in #409
• HPRTU curve fixes by @JanghyunJK in #416
• SDR: pump upgrade measure by @JanghyunJK in #397
• SDR: high-efficiency RTU upgrade measure by @JanghyunJK in #398
• EUSS temperature setbacks measure by @amyeallen1 in #408
• EUSS fan SP reset measure by @amyeallen1 in #407
• Updating column names of newly added variables by @amyeallen1 in #423
• Ccaradoj/sdr 2025 r4 fix other fuel breakdown by @ChristopherCaradonna in #429
• Add missing imports, remove duplicate propane and fuel oil columns by @ChristopherCaradonna in #432

Full Changelog: 2025-2...2025-3

ComStock 2025 Release 2

ComStock 2025-2 is the 6th ComStock measure dataset release.
See the technical reference documentation for details on assumptions and how the baseline building stock is represented.
See the upgrade documentation for details on measures included in this release (some currently pending publication review/approval).

Software Stack

OpenStudio v3.8.0
EnergyPlus v24.1.0
buildstockbatch v2024.11.0

What's Changed

• SDR 2024 r2 by @ChristopherCaradonna in #282
• Thermal Bridging and Derating by @mdahlhausen in #183
• update dockerfile to custom ghedesigner version by @mpraprost in #266
• add unmet hours plots by @ChristopherCaradonna in #280
• Update compare_upgrades.py.template by @ChristopherCaradonna in #285
• EUSS VRF DOAS update by @JanghyunJK in #168
• fix electricity emissions column being used by total with mid case sum by @mpraprost in #277
• Fix egrid emission calculation for df measures by @JieXiong9119 in #258
• typo fix in postprocessing naming_mixin script by @JanghyunJK in #286
• remove old ghedesigner version, replaced by custom commit in line 79 by @mpraprost in #288
• percentage savings calculation fix in post-processing by @JanghyunJK in #271
• CI fix by @wenyikuang in #287
• Fix airtightness units by @mdahlhausen in #273
• Add cooling tower water use to variable reporting by @mdahlhausen in #289
• L taylor/cbec2018 update by @LandanT in #284
• correct arg name by @JanghyunJK in #291
• make sure author names dont wrap onto next line by @mpraprost in #293
• Fix ruby CI tests by @wenyikuang in #292
• CBECS 2018 HVAC documentation update by @LandanT in #296
• Update buildstock batch workflow generator version by @ChristopherCaradonna in #301
• Revise utility rate results by @eringold in #295
• Utility bills reporting fix by @eringold in #303
• fixes optional not initialized baseline error for VLT by @ChristopherCaradonna in #305
• Add district energy to emissions reporting by @mdahlhausen in #302
• Add criteria pollutants to emissions reporting by @mdahlhausen in #304
• Update tract_to_elec_util mapping by @eringold in #312
• Fix postprocessing workflow by @ChristopherCaradonna in #313
• EUSS/SDR: roof/window measure updates and combining with HP-RTU measure by @JanghyunJK in #276
• EUSS/SDR: HP-RTU measure - upsizing logic fix by @JanghyunJK in #274
• lookup table format fix by @JanghyunJK in #319
• Correct pollutant emission units and add to postprocessing data by @mdahlhausen in #326
• Landan t/hvac charts by @LandanT in #325
• EEDF: add new demand flexibility output variables related to the grid peak load reduction objective by @JieXiong9119 in #324
• utility bill percent savings calculation fix by @JanghyunJK in #316
• EUSS/SDR: HPRTU measure update by @JanghyunJK in #323
• EEDF: utility bill measure expansion: breaking down demand charge and energy charge costs by @JanghyunJK in #318
• SDR 2025 Cycle 1 - Condensing Gas Boilers by @mpraprost in #294
• EUSS FY25 Release 2 - Electric Resistance Boilers by @mpraprost in #255
• GHP measure package implementation by @mpraprost in #322
• Fix VLT issue in all window upgrade measures by @mpraprost in #307
• SDR: utility bill cost adjustments to all breakdown costs by @JanghyunJK in #331
• Ccaradon/hp rtu lab data by @ChristopherCaradonna in #332
• EUSS/SDR: chiller replacement by @JanghyunJK in #283
• SDR: options lookup fix by @JanghyunJK in #333
• EUSS/SDR: Sync two DF measures for final merge by @JieXiong9119 in #330
• EUSS/SDR: Demand Flexibility measures new objective - grid peak load reduction by @JieXiong9119 in #298
• EUSS/SDR: Demand Flexibility measures combining with PV measure (package feature) by @JieXiong9119 in #297
• Ltaylor/fix local run readme by @LandanT in #334
• HP RTU setback measure for merge by @amyeallen1 in #337
• Ccaradon/sdr lbl df measures by @ChristopherCaradonna in #339
• Ccaradon/sdr pv no postprocessing yet by @ChristopherCaradonna in #340
• bugfix in options lookup for df emissions objective by @JieXiong9119 in #341
• Aallen/hp rtu reduced setback merge v2 by @ChristopherCaradonna in #342
• Ccaradon/sdr pv by @ChristopherCaradonna in #344
• Update annual energy measure bar plot for PV breakdown by @ChristopherCaradonna in #345
• Remove deprecated postprocessing methods by @asparke2 in #343
• A bugfix in hpc script for moving models from kestral to s3 by @wenyikuang in #264
• SDR: Demand Flexibility Measures Refactor by @JieXiong9119 in #363
• Sdr 2025 r3 upgrade envelope to latest code by @mpraprost in #366
• Sdr 2025 r3 lighting controls by @mpraprost in #367
• Ccaradon/sdr 2025 r3 pv batt by @ChristopherCaradonna in #370
• SDR: Update DF measure with new input argument of pv measure by @JieXiong9119 in #371

New Contributors

• @amyeallen1 made their first contribution in #337

Full Changelog: 2024-2...2025-2

2025-1

ComStock 2025-1 is the 5th ComStock measure dataset release.
See the documentation for details on measures included in this release (some currently pending publication review/approval).

Software Stack:

OpenStudio v3.8.0
EnergyPlus v24.1.0
buildstockbatch v2024.11.0

What's Changed

• SDR 2024 r2 by @ChristopherCaradonna in #282
• Thermal Bridging and Derating by @mdahlhausen in #183
• update dockerfile to custom ghedesigner version by @mpraprost in #266
• Add unmet hours plots by @ChristopherCaradonna in #280
• Update compare_upgrades.py.template by @ChristopherCaradonna in #285
• EUSS VRF DOAS update by @JanghyunJK in #168
• Fix electricity emissions column being used by total with mid case sum by @mpraprost in #277
• Fix egrid emission calculation for df measures by @JieXiong9119 in #258
• Typo fix in postprocessing naming_mixin script by @JanghyunJK in #286
• Remove old ghedesigner version, replaced by custom commit in line 79 by @mpraprost in #288
• Percentage savings calculation fix in post-processing by @JanghyunJK in #271
• CI fix by @wenyikuang in #287
• Fix airtightness units by @mdahlhausen in #273
• Add cooling tower water use to variable reporting by @mdahlhausen in #289
• L taylor/cbec2018 update by @LandanT in #284
• Correct arg name by @JanghyunJK in #291
• Make sure author names dont wrap onto next line by @mpraprost in #293
• Fix ruby CI tests by @wenyikuang in #292
• CBECS 2018 HVAC documentation update by @LandanT in #296
• Update buildstock batch workflow generator version by @ChristopherCaradonna in #301
• Revise utility rate results by @eringold in #295
• Utility bills reporting fix by @eringold in #303
• Fixes optional not initialized baseline error for VLT by @ChristopherCaradonna in #305
• Add district energy to emissions reporting by @mdahlhausen in #302
• EUSS/SDR: roof/window measure updates and combining with HP-RTU measure by @JanghyunJK in #276
• EUSS/SDR: HP-RTU measure - upsizing logic fix by @JanghyunJK in #274
• lookup table format fix by @JanghyunJK in #319
• EEDF: add new demand flexibility output variables related to the grid peak load reduction objective by @JieXiong9119 in #324
• utility bill percent savings calculation fix by @JanghyunJK in #316
• EUSS/SDR: HPRTU measure update by @JanghyunJK in #323
• EEDF: utility bill measure expansion: breaking down demand charge and energy charge costs by @JanghyunJK in #318
• SDR 2025 Cycle 1 - Condensing Gas Boilers by @mpraprost in #294
• EUSS FY25 Release 2 - Electric Resistance Boilers by @mpraprost in #255
• GHP measure package implementation by @mpraprost in #322
• Fix VLT issue in all window upgrade measures by @mpraprost in #307
• SDR: utility bill cost adjustments to all breakdown costs by @JanghyunJK in #331
• Ccaradon/hp rtu lab data by @ChristopherCaradonna in #332
• EUSS/SDR: chiller replacement by @JanghyunJK in #283
• SDR: options lookup fix by @JanghyunJK in #333
• EUSS/SDR: Sync two DF measures for final merge by @JieXiong9119 in #330
• EUSS/SDR: Demand Flexibility measures new objective - grid peak load reduction by @JieXiong9119 in #298
• EUSS/SDR: Demand Flexibility measures combining with PV measure (package feature) by @JieXiong9119 in #297
• HP RTU setback measure for merge by @amyeallen1 in #337
• Ccaradon/sdr lbl df measures by @ChristopherCaradonna in #339
• Ccaradon/sdr pv no postprocessing yet by @ChristopherCaradonna in #340
• Bugfix in options lookup for df emissions objective by @JieXiong9119 in #341
• Aallen/hp rtu reduced setback merge v2 by @ChristopherCaradonna in #342
• Ccaradon/sdr pv by @ChristopherCaradonna in #344
• Update annual energy measure bar plot for PV breakdown by @ChristopherCaradonna in #345
• Updating data sources references. by @rHorsey in #359

New Contributors

• @amyeallen1 made their first contribution in #337

Full Changelog: 2024-2...2025-1

ComStock 2024 Release 2

ComStock 2024-2 is the 4th ComStock measure dataset release.
See the documentation for details on measures included in this release (currently pending publication approval).
See the ComStock documentation website for links to the dataset.

Software Stack:

OpenStudio v3.8.0
EnergyPlus v24.1.0
buildstockbatch v2024.01.0

What's Changed

• Update HPC Documentation by @LandanT in #151
• Furnace count supplemental coil reporting by @LandanT in #131
• Fixed Deprecated Method Issue Across Multiple Measures by @LandanT in #146
• Fixed OA Reporting For Zone Equipment by @LandanT in #148
• Fix autosize method in hardsizing measure by @LandanT in #154
• Adds comparisons to EIA emissions data by @asparke2 in #100
• Add ISO 15927-6 comment to degree day section by @mdahlhausen in #157
• Fix measure test failing for SetExteriorLightingTemplate by @eringold in #158
• Fixed Issues 156 by @LandanT in #159
• Update comstock_hpc_training with kestrel specific instructions by @mpraprost in #164
• Update comstock_hpc_training.md to include slurm debugging by @rHorsey in #169
• Added euss yml and removed la100 measure by @mpraprost in #173
• Update On-Site Emissions Table Reference in Reference Documentation by @laurenklun in #176
• Fix polars version by @mdahlhausen in #180
• Update to OpenStudio 3.8.0 and add LBNL GEM gem by @mpraprost in #182
• Add utility bills to upgrade measure plots in postprocessing by @ChristopherCaradonna in #178
• Fix the profiler script for #165 by @wenyikuang in #181
• Fix OA fraction column name by @mpraprost in #184
• Fix the temp directory field in hpc.py by @LandanT in #185
• Add timeseries plots to upgrade measure postprocessing by @ChristopherCaradonna in #187
• Map mismatched counties to join_geospatial.py by @amylebar in #189
• Fix typo in emissions factors by @mpraprost in #194
• update cambium factors to match resstock by @mpraprost in #192
• Fixed the issues during name generating for saving column. by @wenyikuang in #196
• Baseline updates for openstudio-standards update by @mdahlhausen in #197
• update summarize_failures by @eringold in #114
• openstudio-standards update by @mdahlhausen in #195
• update template yml with new os-standards release by @mpraprost in #205
• Input side of sampling v2 by @rHorsey in #207
• comstock sensitivity measure update: replacing TableMultiVariableLookup to TableLookup by @JanghyunJK in #209
• Use serial update for each upgrades data frame by @wenyikuang in #186
• Removing extra spaces from the word intensity in the plots. by @rHorsey in #211
• Rhorsey/sampling v2 plotting patch by @rHorsey in #217
• Add rubocop rake task by @mdahlhausen in #227
• [WIP] Check the metadata in the postprocess when the pl.data in the memory by @wenyikuang in #224
• fixes to documentation by @mpraprost in #161
• Update heat pump RTU measure to accommodate OS translation issues for multispeed coils by @ChristopherCaradonna in #245
• Update DOAS mini split measure to fix heat recovery error introduced with OS version update by @mpraprost in #236
• Update ideal air loads measure by @ChristopherCaradonna in #221
• EUSS HP-RTU measure updates by @JanghyunJK in #233
• EUSS Demand Flexibility Measures emission reduction / decarbonization objective by @JieXiong9119 in #200
• EUSS Demand Flexibility Measures new lighting control measure and thermostat control updates by @JieXiong9119 in #199
• For test - fix bugs for df lighting and tstat measures by @JieXiong9119 in #250
• Aggregate the error summaries per each upgrade. by @wenyikuang in #248
• bring measure changes from fan_updates_6 branch by @mpraprost in #251
• Update test template and workflow measures by @mdahlhausen in #235
• change to stds method by @mpraprost in #253
• Fix* emissions reporting by @eringold in #231
• Rubocop fixes to reporting measures by @mdahlhausen in #254
• Postprocessing update: add output variables related to peak intensity & savings and emission intensity & savings by @JieXiong9119 in #257
• Update DEER NIST building type lookup by @mdahlhausen in #267
• Update to openstudio-standards 0.7.0 by @mdahlhausen in #262
• Update .rubocop.yml by @mdahlhausen in #272
• Updates postprocessing for new sampling / increased geographic resolution by @asparke2 in #275
• New sampling documentation by @amylebar in #278

Full Changelog: 2024-1...2024-2

ComStock 2024 Release 1

ComStock 2024-1 corresponds with EUSS release 3.
See the documentation for details on measures included in this release.

Software Stack:

OpenStudio v3.7.0
EnergyPlus v23.2.0
buildstockbatch v2023.10.0

What's Changed

• Fix F-Factor Failures by @eringold in #64
• Correct PVAV coil type by @mdahlhausen in #67
• Fix PVAV keyword argument by @eringold in #70
• Fix README links by @eringold in #88
• Add Soil Properties by @mpraprost in #63
• Add AMI comparisons to postprocessing by @mdahlhausen in #52
• Fix simulation log file lookup by @mpraprost in #93
• Fix additional F-factor failures by @eringold in #95
• update design levels and fractions for kitchen equipment by @mpraprost in #66
• Update kaleido version by @wenyikuang in #89
• Fix applicability logic for EUSS economizer fault measures by @JanghyunJK in #30
• Add utility bill calculations by @asparke2 in #71
• Postprocessing enhancements by @eringold in #55
• Fix Heat Pump Boiler measure by @ChristopherCaradonna in #101
• Initial ComStock CI by @wenyikuang in #90
• Fix sampling timeout by @amylebar in #104
• Reduce total occupancy by @eringold in #102
• Add columns to options_lookup for Kestral by @mpraprost in #107
• Reduce model design days by @mdahlhausen in #105
• Fix economizer damper fault schedule by @JanghyunJK in #108
• Fix utility bill postprocessing by @ChristopherCaradonna in #112
• EUSS measure package tests by @ChristopherCaradonna in #119
• Warehouse thermostats and HVAC systems by @eringold in #118
• EUSS GTO measures by @mpraprost in #120
• Rename EUSS wall insulation measure by @mpraprost in #121
• Rename demand flexibility measures in options lookup by @ChristopherCaradonna in #122
• Add Alaska and Hawaii to sampling by @amylebar in #123
• EUSS Demand Flexibility measure updates by @JieXiong9119 in #124
• EUSS Demand Flexibility measures by @JieXiong9119 in #68
• Update options lookup for EUSS df load shift measure by @JieXiong9119 in #125
• Update variable speed HP-RTU COPs by @ChristopherCaradonna in #126
• Add multiple upgrade comparison plots by @ChristopherCaradonna in #127
• Fix hours of operation figures in documentation by @amylebar in #128
• Remove LA100 QAQC measure by @ChristopherCaradonna in #130
• Create typical measure unit test fixes by @mpraprost in #132
• Measure unit test fixes by @eringold in #134
• Update ComStock HPC training documentation by @LandanT in #138
• Fix utility bill post processing by @ChristopherCaradonna in #115
• Fix measure unit tests by @mdahlhausen in #137
• Updates postproc README to include Kestrel environment setup by @asparke2 in #141
• Fix comstock-integrated test Jenkins settings by @wenyikuang in #136
• Fix issues in the resources/measure test by @wenyikuang in #135
• 2024 Release 1 Postprocessing Updates by @asparke2 in #150

New Contributors

• @wenyikuang made their first contribution in #89
• @JieXiong9119 made their first contribution in #124
• @LandanT made their first contribution in #138

Full Changelog: 2023-2...2024-1

ComStock 2023 Release 2

This release of ComStock aligns with the baseline model used to generate the ComStock End Use Savings Shape 2023 Release 2 dataset. For additional details on the dataset please refer to the published datasets page of our documentation website and the recording of the data release webinar.

Initial public ComStock release

v1.0.0

ComStock V1 Public Release.