NREL / buildstock-query

BuildStockQuery is a python library for querying datasets generated by ResStock™ and ComStock™.
https://nrel.github.io/buildstock-query/
BSD 3-Clause "New" or "Revised" License
9 stars 1 forks source link

add get_upgraded_buildstock #11

Closed lixiliu closed 1 year ago

lixiliu commented 1 year ago

Resolves #[issue number here].

Pull Request Description

Added function in UpgradeAnalyzer to create a buildstock that has an upgrade package applied. Logic is taken directly from existing output: report_df, which summarizes the application of the upgrade by option. Buildstock format is the same as the original buildstock (i.e., without columns renamed to lower cases).

Caveat - upgraded buildstock should not be simulated directly as a precomputed buildstock without a thorough review because the upgrade yaml may not address all parameters pertinent to an upgrade, thereby causing inconsistency in the housing attributes of the upgraded buildstock.

For example, we typically specify a heat pump upgrade directly with HVAC Heating, Cooling, and/or Shared Efficiency. This alone would not automatically change the Heating Fuel of the upgrade to Electricity. This could be a feature to be developed later.

Another feature would be to flag # of dwelling units that were the same as before after an upgrade option (not package) is applied, as this means some parameters in the baseline are being upgraded to the same incumbent options, which may not be intentional.