Heating and Cooling Unavailable Days

[joseph-robertson]

Pull Request Description

Companion PR: https://github.com/NREL/resstock-estimation/pull/416

The purpose of this PR is to account for dwelling units whose HVAC system (heating/cooling) is unavailable for some number of days during the year (per RECS 2020).

Specifically, this PR:

• Adds new Heating Unavailable Days.tsv and Cooling Unavailable Days.tsv housing characteristics files
• Adds new arguments to ResStockArguments:
  • schedules_space_heating_unavailable_days (integer; assigned by Heating Unavailable Days)
  • schedules_space_cooling_unavailable_days (integer; assigned by Cooling Unavailable Days)
  • building_id
    • this becomes the seed for a random number generator (similar to how BuildResidentialScheduleFile uses it)
    • both BuildExistingModel and ApplyUpgrade assign building_id to ResStockArguments
• Updates ResStockArguments to determine unavailable period dates when sampled options are 1+ unavailable days:
  • Year Round
    • set the unavailable period to "Jan 1 - Dec 31"
  • Partial Year (e.g., 1, 7, 14 days)
    • get the Building America heating/cooling months per weather data and BAHSP definition
    • randomly select (deterministically) n-day period start/end dates beginning in the BA heating/cooling months (if no BA heating/cooling months, e.g., Hawaii, assume heating/cooling months are Dec-Feb/Jun-Aug)
    • set unavailable period arguments based on randomly selected n-day period start/end dates
    • if the number of unavailable days is longer than the season Building America season, the unavailable period will just extend beyond the BA season

This PR also updates BuildExistingModel to register the randomly selected unavailable periods:

• build_existing_model.heating_unavailable_period
• build_existing_model.cooling_unavailable_period

CI results:

Checklist

Not all may apply:

• Tests (and test files) have been updated
• Documentation has been updated
  • If related to resstock-estimation, checklist includes data dictionary, source report, options saturation, options_lookup.
• Add to the changelog_dev.rst file
• openstudio tasks.rb update_measures has been run
• No unexpected regression test changes on CI (checked comparison artifacts)