v2.4.0 Changelog
v2.4.0
Released: 2021-01-27characteristics
[characteristics] [feature] [water heater] ¶
Date: 2020-12-10
Title: Feature/water heater update
Description: Introduce premium water heaters and heat pump water heaters into building stock, differentiate between central and in-unit water heating, and split water heater fuel and efficiency into different housing characteristics. This pull request updates the water heater housing characteristics.
resstock-estimation: pull request 87
Assignees: Anthony Fontanini
References: pull request 513
[characteristics] [feature] [plug loads] ¶
Date: 2020-11-22
Title: Multiplier updates to plug load measure
Description: Allow for plug load energy consumption to vary by Census Division and include additional “diversity” multiplier in plug load equations. This pull request separates out multipliers meant to adjust total energy and multipliers meant to adjust diversity of the results. The ResidentialMiscPlugLoads argument mult has been split into two multipliers (energy_mult and diversity_mult). The energy multiplier now allows the plug load energy use to vary with building type and RECS 2015 definition of Census Division (the Mountain division is split into North and South). The diversity_mult argument is simply the same as the previous definition of mult.
resstock-estimation: pull request 86
Assignees: Joe Robertson, Anthony Fontanini
References: pull request 511
[characteristics] [feature] [lighting] ¶
Date: 2020-11-22
Title: Add spatial and building type dependencies to lighting saturations
Description: Lighting saturations based on RECS 2015 with new building type and spatial dependencies. This pull request updates the Lighting.tsv to include dependencies on building type and RECS 2015 definition of Census Division. The RECS 2015 definition of Census division is similar to the U.S. Census definition, except RECS breaks out the Mountain Census Division into a North and South Subdivision.
resstock-estimation: pull request 84
Assignees: Anthony Fontanini
References: pull request 510
[characteristics] [feature] [occupants] ¶
Date: 2020-11-16
Title: Number of occupants based on PUMS
Description: Update Occupants per unit from RECS 2015 to PUMS 5-yr 2017. This pull request updates the number of occupants (that gets passed into the stochastic load generator) from RECS 2015 to PUMS 5-yr 2017. The switch to PUMS allows PUMA level spatial granularity in the distributions and leverages more than 6 million samples.
Assignees: Anthony Fontanini
References: pull request 509
[characteristics] [feature] [envelope] ¶
Date: 2020-11-10
Title: Update Geometry Foundation Type to be Based on RECS
Description: Update foundation type from the [Building Foundation Design Handbook](https://www.osti.gov/biblio/6980439-building-foundation-design-handbook) published in 1988 to RECS 2009. This pull request updates the Geometry Foundation Type.tsv from the “Building Foundation Design Handbook” published in 1988 to RECS 2009. The new TSV has dependencies on IECC Climate and Moisture regions and Vintage ACS.
resstock-estimation: pull request 63, pull request 73
Assignees: Anthony Fontanini
References: pull request 492
[characteristics] [feature] [mechanics] ¶
Date: 2020-09-09
Title: HVAC tsv restructuring
Description: Restructure HVAC housing characteristics to 1) simplify the structure, 2) allow for integrating more local data sources, 3) update reference years for HVAC and refrigerator ages and efficiencies from 2009 to 2018, 4) add assumption comments to all HVAC-related housing characteristics, 5) improve Room AC efficiency distributions using ENERGY STAR saturation data, and 6) fix some incorrect assignment of Option=None heating systems. We have an inordinate number of tsvs presently describing the hvac systems in OpenStudio-BuildStock. This PR reorders and merges existing hvac tsvs while preserving the necessary interactions. The major changes to structure are to move from multiple heating fuel-specific efficiency TSV files to a single TSV for heating efficiencies. The “Is Heat Pump” TSV is also expanded to include ducted/non-ducted options for use as an interim dependency.
resstock-estimation: pull request 32
Assignees: Tobi Adekanye, Eric Wilson
References: pull request 478
[characteristics] [feature] [vacancy] ¶
Date: 2020-08-17
Title: Introduce Vacant Units
Description: Distinguish between vacant and occupied dwelling units using PUMS data. The purpose of the pull request is to introduce vacant units into the residential stock. This work was motivated by the following maps that shows the fraction of vacant units by building type and PUMA.
resstock-estimation: pull request 36
Assignees: Anthony Fontanini
References: pull request 473
[characteristics] [feature] [plug loads] ¶
Date: 2020-08-11
Title: Separate plug load equations for SFD, SFA, MF
Description: Based on RECS 2015, separate the plug load equations for single-family detached, single-family attached, and multifamily buildings. Using RECS 2015 a multilinear regression is performed to determine the annual MELS for ResStock. The dependent variables are the number of occupants (noccupants) and the finished floor area (ffa) of the dwelling unit. The MELS definition is a combination of microwave, television, humidifiers, and other devices. The RECS fields for these variables are KWHMICRO, KWHTVREL, KWHHUM, and KWHNEC, respectively.
resstock-estimation: pull request 45
Assignees: Joe Robertson, Anthony Fontanini
References: pull request 471
[characteristics] [feature] [setpoints] ¶
Date: 2020-08-10
Title: Update Setpoint and Setpoint Schedule Distributions
Description: Update the dependencies for heating and cooling setpoint tsvs (Setpoint, Has Offset, Offset Magnitude, and Offset Period) to IECC climate zone. Updates the thermostat heating and cooling setpoint distributions (setpoint, has offset, offset magnitude, offset schedule) to be dependent on IECC climate zone instead of AIA zone.
Assignees: Andrew Speake
References: pull request 468
[characteristics] [feature] [heating fuel] ¶
Date: 2020-08-10
Title: Feature/heating fuel puma
Description: Update heating fuel distributions to be by Public Use Microdata Area (PUMA) rather than State. This pull request modifies the state level description of Heating Fuel type to PUMA. See the graphics below for modifications of heating fuel types. The data is based on PUMS 5-yr 2016, and for sample sizes that are less than 10, the state average is used.
resstock-estimation: pull request 49
Assignees: Anthony Fontanini
References: pull request 474
[characteristics] [bugfix] [mechanics] ¶
Date: 2021-01-07
Title: Fix: All buildings have double-loaded corridors
Description: In the Corridor.tsv, assign single-family attached, single-family detached, and mobile homes with a “Not Applicable” option. In the project_national/housing_characteristics/Corridor.tsv, all buildings are assigned a “Double-Loaded Corridor.” However, the single-family detached, mobile homes, and single-family attached buildings do not have corridors. For single-family detached, mobile homes, and single-family attached buildings, measures/BuildExistingModel/measure.rb removes the calls to the ResidentialGeometryCreateMultifamily measure.
Assignees: Anthony Fontanini
References: pull request 522
[characteristics] [bugfix] [climate zones] ¶
Date: 2020-11-10
Title: Add IECC zone dependency to HVAC Cooling Type and some minor heat pump fixes
Description: Reintroduce IECC climate zone dependency to HVAC Cooling Type and some heat pump fixes. Addresses #64 by adding IECC zone as a dependency. Lumping some of the other dependencies to bring up sample sizes. Increased from ~47% to 60% rows with fewer than 10 samples, but overall I think it is a net improvement.
resstock-estimation: pull request 67
Assignees: Anthony Fontanini
References: pull request 497
[characteristics] [bugfix] [vacancy] ¶
Date: 2020-09-24
Title: Fix/vacant units
Description: Update spatial distribution of units based on total dwelling unit counts rather than occupied unit counts. After talking with @TobiAdekanye, we realized that the spatial distribution of dwelling units are based on only the occupied dwelling units. When the vacant units were pulled into ResStock, the TSV creation functions in sources/spatial/tsv_maker.py in the resstock-estimation repository should have been updated to acs_count instead of acs_occupied_count. This was an oversight when I merged in the Vacant Units.
resstock-estimation: pull request 56
Assignees: Anthony Fontanini
References: pull request 486
workflow
[workflow] [feature] [mechanics] ¶
Date: 2021-01-20
Title: Feature/weather infrastructure
Description: Allow for flexible weather regions based on weather data available and introduce TMY3 weather files for the new weather format. This PR generalizes the weather data available for a given AMY or TMY analysis. ResStock currently uses 941 static weather stations. The stations are used based on the Location.tsv.
resstock-estimation: pull request 95
Assignees: Anthony Fontanini
References: pull request 525
[workflow] [feature] [ducts] ¶
Date: 2021-01-13
Title: Update duct related calcs in airflow.rb
Description: Update the duct leakage “total” to “to outside” conversion to be based on ASHRAE Standard 152. Addresses https://trello.com/c/VmcGehGM/62-duct-leakage-total.
Assignees: Joe Robertson
References: pull request 532
[workflow] [feature] [heat pumps] ¶
Date: 2021-01-07
Title: Report supplemental electric heating
Description: Separate heat pump electric supplemental heating from total electric heating in output reporting. Break “supplemental electric heating” out of “electric heating”. This is important for heat pump analysis.
Assignees: Joe Robertson
References: pull request 512
[workflow] [feature] [mechanics] ¶
Date: 2020-11-13
Title: ResStock/ComStock weather syncronization
Description: Synchronize weather between ResStock and ComStock which increases the number of weather stations from 215 to 941. This pull request synchronizes the weather files for both ResStock and ComStock. Currently, ResStock uses 215 weather regions defined by county. ComStock uses 941 weather files also defined by county. For applications (especially GEB applications) where combined results from ResStock and ComStock are desired, it is important that the residential and commercial models use the same weather data. This way both residential and commercial models respond to hot days, cold days, rainy days together to predict more accurate combined loads.
resstock-estimation: pull request 58
Assignees: Anthony Fontanini
References: pull request 507
[workflow] [feature] [envelope] ¶
Date: 2020-09-23
Title: Roofing material options and tsvs updates
Description: Increase roofing material options; update roofing material tsv files to include these new options. Expand roof material options and update related tsv files.
Assignees: Joe Robertson
References: pull request 485
[workflow] [feature] [schedules] ¶
Date: 2020-07-16
Title: Generate schedule csv on the fly and use Schedule:File objects on its columns
Description: Major change to most occupant-related schedules. Occupant activities are now generated on-the-fly and saved to .csv files used by Schedule:File objects. Schedules are generated using time-inhomogenous Markov chains derived from American Time Use Survey data, supplemented with sampling duration and power level from NEEA RBSA data, as well as DHW draw duration and flow rate data from Aquacraft/AWWA data [(see pre-print for details)](https://arxiv.org/abs/2111.01881). The Stochastic Occupancy Modelling introduces major change to most occupant-related schedules. Occupant activities are now generated on-the-fly and saved to .csv files used by Schedule:File objects. Schedules are generated using time-inhomogenous Markov chains derived from American Time Use Survey data, supplemented with sampling duration and power level from NEEA RBSA data, as well as DHW draw duration and flow rate data from Aquacraft/AWWA data.
Assignees: Joe Robertson, Rajendra Adhikari
References: pull request 348
[workflow] [feature] [quantities of interest] ¶
Date: 2020-07-08
Title: Report peak kw
Description: Report the annual peak use and timing using the quantities of interest measure. Report peak use and timing using the QOIReport measure.
Assignees: Joe Robertson
References: pull request 460
[workflow] [bugfix] [envelope] ¶
Date: 2021-01-26
Title: Fix: Effective R Value Calculation for HVAC Sizing
Description: Calculate slab surface effective R values used in HVAC sizing with unit-level variables. Fixes how the effective R value of a slab is calculated for use in the HVAC sizing measure. The effective R values were previously calculated use the slab area of the entire building footprint and the exposed perimeter of the individual unit, causing the R value to scale incorrectly with larger buildings. This calculates the R value using variables specific to the unit, not the building.
Assignees: Andrew Speake
References: pull request 537
[workflow] [bugfix] [weather] ¶
Date: 2021-01-20
Title: Bugfix for DST start hour and end date.
Description: Fix DST start hour error and end date error. The PR fixes 2 issues with the current calculation of DST time column. Currently, DST spring forward occurs at 1:00 AM standard time. The time jumps from 0:59 to 2:00. It should jump from 1:59 to 3:00 instead. This fixes the problem. The DST end date is currently one day behind what’s specified in the options_lookup or weather file. This PR also fixes that. The clocks are supposed to shift back by one hour at 2:00 AM on the same date as DST end date. See https://www.timeanddate.com/time/change/usa.
Assignees: Rajendra Adhikari
References: pull request 530
[workflow] [bugfix] [weather] ¶
Date: 2021-01-11
Title: Change to UTC time calculations to avoid DST messing things up
Description: Fix bug related to incorrect timestamps when using AMY weather file. Resolves the issue of timestamps being incorrect around the DST switchover time when using AMY weather files.
Assignees: Rajendra Adhikari
References: pull request 528
[workflow] [bugfix] [vacancy] ¶
Date: 2021-01-07
Title: Make sure vacant units have zero ceiling fan energy
Description: Remove ceiling fan energy for vacant units. Vacant units currently have ceiling fan energy. This PR introduces an option where the ceiling fan energy is zero. The ratio of ceiling fans is kept the same, so 72% of units have ceiling fans for either occupied or vacant units. This ensures the counts of ceiling fans are consistent, but vacant units have no ceiling fan energy.
Assignees: Anthony Fontanini
References: pull request 527
[workflow] [bugfix] [mechanics] ¶
Date: 2020-12-23
Title: Fix surface area reporting for collapsed buildings
Description: Fix for calculating door and below-grade wall area of multifamily and single-family attached buildings with collapsed geometries. Fixes below grade wall and door area calculations in SimulationOutputReport when minimal_collapsed = true for MF and SFA buildings. Previously, units_represented was not used to scale foundation wall or door area, and therefore areas were underestimated when building geometries were collapsed.
Assignees: Andrew Speake
References: pull request 523
[workflow] [bugfix] [mechanics] ¶
Date: 2020-12-10
Title: Account for collapsed units when determining geometry variables for infiltration calculation
Description: Account for collapsed units when determining geometry variables (building floor/wall area and volume) in infiltration calculations; add airflow unit tests. Fixes how geometry variables (building ffa, building volume, and building exterior wall area) are calculated in the Airflow.rb measure when minimal_collapsed == True. The “collapsed” units were not originally accounted for when determining these variables, influencing the calculated leakage area at each unit. This changes the infiltration and HVAC sizing in SFA buildings, and most likely MF buildings as well.
Assignees: Andrew Speake
References: pull request 518
[workflow] [appliances] [bugfix] ¶
Date: 2020-11-22
Title: Add monthly multiplier for cooking, clothes washer, clothes dryer, and dishwasher
Description: Reintroduce monthly multipliers with stochastic load model for dishwasher, clothes washer and clothes dryer and cooking. The cooking schedule was previously (before the ResidentialScheduleGenerator was introduced) generated using weekend, weekday, and monthly multiplier schedule. Currently, they are generated using the Markov-chain by the ResidentialScheduleGenerator. This pull request adds monthly multipliers to the schedule so generated.
Assignees: Rajendra Adhikari
References: pull request 504
[workflow] [bugfix] [internal gains] ¶
Date: 2020-10-27
Title: Internal gain calcs for sizing updates/fixes
Description: For the purpose of calculating cooling and dehumidification loads for HVAC sizing, use simple internal gains equation from ANSI/RESNET/ICC 301 (consistent with HPXML workflow); this fixes a bug introduced in [#348](https://github.com/NREL/resstock/pull/348) that caused cooling capacities to be ~3x larger than they should be. Updates to be consistent with how the hpxml workflow processes internal gains.
Assignees: Joe Robertson
References: pull request 501
[workflow] [bugfix] [mechanics] ¶
Date: 2020-08-18
Title: Addresses #479, garage zone infiltration not always added to model
Description: Iterate all spaces in a thermal zone when checking for zone type; fixes missing infiltration for protruding garages in 1-story homes. For 1-story, SFD homes with protruding garages, we expect an effective leakage area object added to the model for the garage and garage attic spaces, as shown below. However, these only get added about half of the time.
Assignees: Joe Robertson
References: pull request 480
[workflow] [bugfix] [schedules] ¶
Date: 2020-08-13
Title: Addresses #476, appliance design levels fluctuate between runs
Description: Fix for pseudo-random number generator that was generating non-deterministic occupancy schedules Fixes an issue with sampling an integer without using the pseudo-random number generator seed.
Assignees: Joe Robertson
References: pull request 477
misc
[bugfix] [envelope] [mechanics] ¶
Date: 2020-10-07
Title: Update partition wall area calculation for MF and SFA buildings
Description: Exclude existing shared walls when calculating the partition wall area of MF and SFA buildings. Updates how partition wall surface area is calculated so that shared walls in MF and SFA buildings do not count as existing partition wall mass. This means that MF and SFA building partition walls are now calculated the same as SFD buildings - as a direct proportion of the finished floor area.
Assignees: Andrew Speake
References: pull request 496