v3.0.0 Changelog

v3.0.0

Released: 2023-02-03

characteristics

  • [characteristics] [feature] [income]

    Date: 2022-11-09

    Title: Add AMI + modified tsvs from resstock-estimation refactoring/opt

    Description: Add area median income. Using the traditional method of copying files over from resstock-estimation, add AMI and other modified tsvs from a recent set of resstock-estimation PRs refactoring and optimizing tsv_making processes.

    resstock-estimation: pull request 243, pull request 302, pull request 304

    Assignees: Lixi Liu, Anthony Fontanini

    References: pull request 1004

  • [characteristics] [feature] [floor area]

    Date: 2022-10-27

    Title: AHS 2019 and 2021 data for simulated conditioned floor area

    Description: Modeled floor area based on AHS 2021 and AHS 2019. Use the AHS 2019, 2021 data for the simulated conditioned floor area ResStock arguments. Link to the AHS table used is HERE. For multi-family the ACS multi-family building types were combined using a weighted average where there were enough samples.

    Assignees: Anthony Fontanini, Lixi Liu

    References: pull request 978

  • [characteristics] [feature] [hvac]

    Date: 2022-07-15

    Title: Introduce cooling partial space conditioning

    Description: Add distributions for partial space cooling. Introduce partial space conditioning for cooling.

    resstock-estimation: pull request 235, pull request 233, pull request 241

    Assignees: Anthony Fontanini, Rajendra Adhikari

    References: pull request 964

  • [characteristics] [feature] [income]

    Date: 2022-07-08

    Title: add income + tenure to floor_area

    Description: Add Income and Tenure into Geometry Floor Area. Add Income and Tenure to Geometry Floor Area.

    resstock-estimation: pull request 233

    Assignees: Lixi Liu

    References: pull request 949

  • [characteristics] [feature] [income]

    Date: 2022-05-06

    Title: Add income, tenure, fix occupants

    Description: Add Income and Tenure tsv, update PUMS tsvs from 2017 5-yrs to 2019 5-yrs, update dependencies and fix encoding error in Occupants.tsv. Update PUMS tsvs from 2017 5-yrs to 2019 5-yrs. Add new tvs: Income, Income RECS2015, Federal Poverty Level, Tenure, and PUMA Metro Status (a few of them are explained in detail below.)

    Assignees: Lixi Liu, Anthony Fontanini, Nate Moore

    References: pull request 900

  • [characteristics] [feature] [heat pumps]

    Date: 2022-05-02

    Title: Improve heat pump distributions for Texas and Florida

    Description: Improve distributions of heat pumps in the southeast U.S. by spliting IECC zone 2A into two zones: 2A (FL, GA, AL, MS) and 2A (TX, LA). Currently using IECC climate zone for HVAC Heating Type. Zone 2A is 16%-20% HP, whereas Reportable Domain of TX (3%), FL (20%). Solution: Split 2A into two chunks, 2A (FL, GA, AL, MS), and 2A (TX, LA).

    resstock-estimation: pull request 209

    Assignees: Phil White, Eric Wilson, Anthony Fontanini

    References: pull request 913

  • [characteristics] [feature] [mechanics]

    Date: 2022-04-27

    Title: update tsvs with new sampling_prob

    Description: Update tsvs with new sampling_probability calculation.

    resstock-estimation: pull request 210, pull request 203

    Assignees: Lixi Liu

    References: pull request 905

  • [characteristics] [feature] [geography]

    Date: 2022-04-20

    Title: City Boundaries

    Description: Cities with more than 15,000 dwelling units are added as a geographic characteristic. Adding City boundaries as a housing characteristic in ResStock. This way users can aggregate directly by a given City.

    resstock-estimation: pull request 196

    Assignees: Anthony Fontanini

    References: pull request 874

  • [characteristics] [feature] [testing]

    Date: 2022-03-09

    Title: Changes after switching to ResStock-HPXML

    Description: For the testing project, sample equal distributions of (1) smooth and stochastic schedules (each 50%) and (2) faulted and non-faulted HVAC systems (each 50%). project_testing/Schedules.tsv to equal distribution of Default and Stochastic. project_testing/HVAC System Is Faulted.tsv to equal distribution of No and Yes.

    resstock-estimation: pull request 193

    Assignees: Joe Robertson, Andrew Speake

    References: pull request 828

  • [characteristics] [bugfix] [mechanics]

    Date: 2022-08-26

    Title: Update join_tsv to use raw source_count

    Description: Update low-sample downscaling logic to use raw source_weight, which leads to minor changes to Geometry Floor Area and HVAC Partial Space Conditioning. TSV changes from updating join_distributions_in_order to use raw source_weight (previously, it uses what is now called fallback_weight which artificially increases the weight of undersampled options, thus making it deviate more from the sample truth marginal distributions)

    resstock-estimation: pull request 248

    Assignees: Lixi Liu, Anthony Fontanini

    References: pull request 982

  • [characteristics] [bugfix] [mechanics]

    Date: 2022-08-22

    Title: TSV changes from improved low samples handling

    Description: Remove Void from dependency columns in TSVs and update tests. Some TSVs have “Option=Void” as one of the available options. The idea behind Void is that certain dependency conditions are structurally impossible. For example, for “HVAC Heating Type and Fuel.tsv”, it’s impossible that “Heating Fuel” = Electricity and “HVAC Heating Efficiency” = “Fuel Boiler”. So, this particular dependency condition get’s Void option.

    resstock-estimation: pull request 245

    Assignees: Rajendra Adhikari

    References: pull request 981

  • [characteristics] [bugfix] [mechanics]

    Date: 2022-07-09

    Title: Ll/rename sources

    Description: Rename sources subfolders so all tsv_makers can be imported as packages. Rename sources folders so all tsv_makers can be imported as packages. Packages cannot contain names that start with a number.

    resstock-estimation: pull request 238

    Assignees: Lixi Liu

    References: pull request 959

  • [characteristics] [bugfix] [mechanics]

    Date: 2022-06-02

    Title: Fix/tsv tags sampling prob etc

    Description: Fix minor bug in sampling probability calculation.

    resstock-estimation: pull request 221

    Assignees: Lixi Liu, Anthony Fontanini

    References: pull request 934

  • [characteristics] [bugfix] [mechanics]

    Date: 2022-04-04

    Title: Reduce TSV Sizes

    Description: Reduce housing characteristic file size by relaxing the six digit float format in the housing characteristics. As housing characteristics get bigger, we are moving to a compact writing style. The 6-digit float format requirement was put in place when most of the characteristics were not scripted. Now that there is a standard workflow for creating the characteristics, the formatting requirements are being relaxed. This change should allow for more accurate characteristic distributions because the exponential format can be used. The change should also stop round-off errors.

    resstock-estimation: pull request 200

    Assignees: Anthony Fontanini

    References: pull request 877

workflow

  • [workflow] [feature] [utility bills]

    Date: 2022-09-09

    Title: Optionally calculate simple utility bills

    Description: Add ability to calculate simple utility bills for various scenarios. Call new ReportUtilityBills measure from OS-HPXML.

    Assignees: Joe Robertson

    References: pull request 984

  • [workflow] [feature] [cost multipliers]

    Date: 2022-04-11

    Title: Unvented crawlspace upgrade

    Description: Add a new “Floor Area, Foundation (ft^2)” cost multiplier.

    Assignees: Joe Robertson

    References: pull request 870

  • [workflow] [feature] [cost multipliers]

    Date: 2022-04-06

    Title: Handle incremental costs of (1) adding attic insulation and (2) reducing (%) infiltration

    Description: Add a new “Floor Area, Attic * Insulation Increase (ft^2 * Delta R-value)” cost multiplier for handling incremental costs of adding attic insulation. Handle incremental costs of adding attic insulation.

    Assignees: Joe Robertson

    References: pull request 848

  • [workflow] [feature] [cost multipliers]

    Date: 2022-04-06

    Title: Handle incremental costs of (1) adding attic insulation and (2) reducing (%) infiltration

    Description: Allow air leakage % reduction upgrades (e.g., 25%), and add a new “Floor Area, Conditioned * Infiltration Reduction (ft^2 * Delta ACH50)” cost multiplier for handling incremental costs of such upgrades. Add generic multiplier argument to infiltration options to facilitate % reductions in ACH50.

    Assignees: Joe Robertson

    References: pull request 848

  • [workflow] [feature] [mechanics]

    Date: 2022-02-28

    Title: Extend ApplyUpgrade for upgrade measures

    Description: Allow upgrade options to be defined in the lookup using measures other than ResStockArguments. Support “upgrade” measures that are not part of the OS-HPXML workflow, and are tacked on after model is created.

    Assignees: Joe Robertson

    References: pull request 839

  • [workflow] [feature] [rim joists]

    Date: 2022-02-16

    Title: Enable rim joists

    Description: Enable rim joists for homes with basements/crawlspaces; assumes a height of 9.25 inches and calculates rim joist assembly R-value from new insulation arguments. Enable rim joists (set this by default, and r-value to foundation wall r-value); we could potentially enable rim joists between floors by adjusting average ceiling height, but we won’t for now.

    Assignees: Joe Robertson

    References: pull request 831

  • [workflow] [feature] [hescore]

    Date: 2022-02-14

    Title: HEScore Workflow

    Description: Enable the HEScore workflow to be run with BuildExistingModel. Enables to the HEScore workflow to be run from BuildExistingModel. A new argument os_hescore_directory is added in BuildExistingModel which points to a local checkout of https://github.com/NREL/OpenStudio-HEScore.

    Assignees: Andrew Speake

    References: pull request 782

  • [workflow] [feature] [mechanics]

    Date: 2022-02-10

    Title: ResStock-HPXML

    Description: Transition to using the HPXML-based workflow. Subtree resources/hpxml-measures to github.com/NREL/OpenStudio-HPXML.

    OpenStudio-HPXML: pull request 372

    Assignees: Joe Robertson, Andrew Speake

    References: pull request 443

  • [workflow] [bugfix] [setpoints]

    Date: 2022-08-17

    Title: Support auto_seasons arguments

    Description: Fix heating and cooling auto-season inputs. Looks like OS-HPXML auto_seasons related arguments may have been updated, but ResStockArguments subsequently was not. I believe this was not caught because our testing project does not currently sample any setpoint options which enable the auto_seasons arguments.

    Assignees: Joe Robertson

    References: pull request 975

  • [workflow] [bugfix] [mechanics]

    Date: 2022-03-09

    Title: Changes after switching to ResStock-HPXML

    Description: Clean up option names for natural ventilation and hot water distribution.

    resstock-estimation: pull request 193

    Assignees: Joe Robertson

    References: pull request 828

  • [workflow] [bugfix] [heat pumps]

    Date: 2022-02-16

    Title: Remove backup switchover temp for non dual fuel heat pumps

    Description: Remove the zero degree switchover temperature for heat pump backup heating. Remove heat_pump_backup_heating_switchover_temp=0.0 for non dual fuel heat pumps. Leave heat_pump_backup_heating_switchover_temp=30.0 for dual fuel heat pumps.

    Assignees: Joe Robertson, Andrew Speake

    References: pull request 833

  • [workflow] [bugfix] [mechanics]

    Date: 2022-02-14

    Title: Model finished attics

    Description: For homes with a finished attic or cathedral ceilings, models a conditioned attic instead of a vented attic. Change geometry_attic_type=VentedAttic when Geometry Attic Type samples Finished Attic or Cathedral Ceilings.

    Assignees: Joe Robertson, Andrew Speake

    References: pull request 830

software

  • [software] [feature] [openstudio]

    Date: 2023-02-01

    Title: Latest OS-HPXML

    Description: Update to OpenStudio v3.5.1.

    OpenStudio-HPXML: pull request 1251

    Assignees: Joe Robertson, Scott Horowitz

    References: pull request 1015