Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

ResStock-HPXML: detailed bill calcs #382

Merged
merged 10 commits into from Oct 10, 2023
Merged

ResStock-HPXML: detailed bill calcs #382

Show file tree
Hide file tree
Changes from 7 commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
b56444c
Update hpxml wfg with new detailed_filepath yml field.
joseph-robertson Jul 25, 2023
e052515
Update the docs. [ci skip]
joseph-robertson Jul 25, 2023
29dac74
More updates to the docs.
joseph-robertson Jul 26, 2023
94a04eb
Minor update. [ci skip]
joseph-robertson Jul 26, 2023
1c53787
More updates to docs. [ci skip]
joseph-robertson Jul 31, 2023
0b37a43
Merge remote-tracking branch 'origin/develop' into detailed-bill-calcs
nmerket Aug 16, 2023
8aeafb2
Merge branch 'develop' into detailed-bill-calcs
joseph-robertson Sep 13, 2023
4ce1f53
Update the changelog.
joseph-robertson Oct 9, 2023
b2ad74a
Update the wfg docs.
joseph-robertson Oct 9, 2023
47452b2
Merge remote-tracking branch 'origin/develop' into detailed-bill-calcs
nmerket Oct 10, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
2 changes: 2 additions & 0 deletions buildstockbatch/workflow_generator/residential_hpxml.py
View file
Open in desktop
Expand Up @@ -79,6 +79,7 @@ def validate(cls, cfg):
utility-bill-scenario-spec:
scenario_name: str(required=True)
simple_filepath: str(required=False)
detailed_filepath: str(required=False)
elec_fixed_charge: num(required=False)
elec_marginal_rate: num(required=False)
gas_fixed_charge: num(required=False)
Expand Down Expand Up @@ -299,6 +300,7 @@ def create_osw(self, sim_id, building_id, upgrade_idx):
utility_bills_map = [
['utility_bill_scenario_names', 'scenario_name'],
['utility_bill_simple_filepaths', 'simple_filepath'],
['utility_bill_detailed_filepaths', 'detailed_filepath'],
['utility_bill_electricity_fixed_charges', 'elec_fixed_charge'],
['utility_bill_electricity_marginal_rates', 'elec_marginal_rate'],
['utility_bill_natural_gas_fixed_charges', 'gas_fixed_charge'],
Expand Down
7 changes: 5 additions & 2 deletions docs/workflow_generators/residential_hpxml.rst
View file
Open in desktop
Expand Up @@ -20,6 +20,7 @@ Configuration Example

utility_bills:
- scenario_name: Bills1
gas_marginal_rate: 1.05
pv_compensation_type: NetMetering

simulation_output_report:
Expand Down Expand Up @@ -59,7 +60,7 @@ Arguments

- ``scenario_name``: Name of the emissions scenario.
- ``type``: Type of emission (e.g., CO2e, NOx, etc.).
- ``elec_folder``: Folder of schedule files with hourly electricity emissions factors values. Units are kg/MWh. Path is relative to buildstock_directory's resources folder. File names must contain GEA region names.
- ``elec_folder``: Folder of schedule files with hourly electricity emissions factors values. Units are kg/MWh. Folder path is relative to buildstock_directory's `resources`_ folder. File names must contain GEA region names.
- ``gas_value``: Annual emissions factor for natural gas. Units are lb/MBtu (million Btu).
- ``propane_value``: Annual emissions factor for propane. Units are lb/MBtu (million Btu).
- ``oil_value``: Annual emissions factor for fuel oil. Units are lb/MBtu (million Btu).
Expand All @@ -68,7 +69,8 @@ Arguments
- ``utility_bills`` (optional): Add these arguments to the `BuildExistingModel`_ measure for performing utility bill calculations.

- ``scenario_name``: Name of the utility bills scenario.
- ``simple_filepath``: File with all fixed charges / marginal rates for each option of a chosen parameter (e.g., State).
- ``simple_filepath``: File with all fixed charge / marginal rate / PV argument values for each option of a chosen parameter (e.g., State). These will override any fixed charge / marginal rate / PV argument values specified in the YML file. Any blank fields will be defaulted. File path is relative to buildstock_directory's `resources`_ folder.
- ``detailed_filepath``: File with electricity tariff path for each option of a chosen parameter (e.g., County). File may also contain all fixed charge / marginal rate / PV argument values. These will override any fixed charge / marginal rate / PV argument values specified in the YML file. Any blank fields will be defaulted. File path is relative to buildstock_directory's `resources`_ folder. Electricity tariff paths are relative to the parent folder of the ``detailed_filepath`` file.
- ``elec_fixed_charge``: Monthly fixed charge for electricity.
- ``elec_marginal_rate``: Marginal rate for electricity. Units are $/kWh.
- ``gas_fixed_charge``: Monthly fixed charge for natural gas.
Expand Down Expand Up @@ -136,6 +138,7 @@ Arguments
.. _BuildExistingModel: https://github.com/NREL/resstock/blob/develop/measures/BuildExistingModel/measure.xml
.. _ReportSimulationOutput: https://github.com/NREL/resstock/blob/develop/resources/hpxml-measures/ReportSimulationOutput/measure.xml
.. _ServerDirectoryCleanup: https://github.com/NREL/resstock/blob/develop/measures/ServerDirectoryCleanup/measure.xml
.. _resources: https://github.com/NREL/resstock/blob/develop/resources

.. _hpxml-build-existing-model-defaults:

Expand Down