Move latest to 07_19 and create a new latest with bill arg changes.

.github/workflows/ci.yml

@@ -16,15 +16,15 @@ jobs:
         python-version: ['3.8', '3.9', '3.10', '3.11']
     name: Tests - Python ${{ matrix.python-version }}
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           path: buildstockbatch
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           repository: NREL/resstock
           path: resstock
-          ref: develop
-      - uses: actions/setup-python@v4
+          ref: latest-os-hpxml
+      - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
       - name: Download weather
@@ -63,13 +63,13 @@ jobs:
           check_name: Testing Report
           fail_on_failure: true
       - name: Save Coverage Report
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         if: ${{ matrix.python-version == '3.11' }}
         with:
           name: coverage-report-html
           path: buildstockbatch/coverage/htmlreport/
       - name: Save Coverage Report XML
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         if: ${{ matrix.python-version == '3.11' }}
         with:
           name: coverage-report-xml
@@ -80,7 +80,7 @@ jobs:
           cd buildstockbatch/docs
           make html SPHINXOPTS="-W --keep-going -n"
       - name: Save Docs
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         if: ${{ matrix.python-version == '3.11' }}
         with:
           name: documentation
@@ -90,12 +90,12 @@ jobs:
     strategy:
       fail-fast: false
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           repository: NREL/resstock
           path: resstock
-          ref: develop
-      - uses: actions/setup-python@v4
+          ref: latest-os-hpxml
+      - uses: actions/setup-python@v5
         with:
           python-version: 3.11
       - name: Download weather

.github/workflows/coverage.yml

@@ -13,13 +13,13 @@ jobs:
     if: ${{ github.event.workflow_run.event == 'pull_request' }}
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
           ref: ${{ github.event.workflow_run.head_commit.id }}
 
       - name: Download Coverage Artifacts
-        uses: Legit-Labs/action-download-artifact@v2
+        uses: Legit-Labs/action-download-artifact@v3
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           workflow: ${{ github.event.workflow_run.workflow_id }}

buildstockbatch/workflow_generator/residential/latest/__init__.py

@@ -1,8 +1,9 @@
-__version__ = "2024.07.19"
+__version__ = "2024.07.20"
 version_info = {
     "version": __version__,
     "version_description": """
-In this version, the UpgradeCosts measure is converted to a regular measure
-and is run early in the workflow. ReportHPXMLOutput measure is no longer used.
+In this version, optional include_annual_bills and
+include_monthly bills arguments are exposed for reporting
+annual and monthly utility bill outputs.
 """,
 }

buildstockbatch/workflow_generator/residential/latest/residential_hpxml_arg_mapping.py

@@ -64,4 +64,10 @@
             "output_variables": "user_output_variables",
         },
     },
+    "ReportUtilityBills": {
+        "simulation_output_report": {
+            "include_annual_bills": "register_annual_bills",
+            "include_monthly_bills": "register_monthly_bills",
+        },
+    },
 }

buildstockbatch/workflow_generator/residential/latest/residential_hpxml_defaults.py

@@ -66,7 +66,12 @@
         "timeseries_num_decimal_places": 3,
         "user_output_variables": "",
     },
-    "ReportUtilityBills": {"include_annual_bills": True, "include_monthly_bills": False},
+    "ReportUtilityBills": {
+        "include_annual_bills": False,
+        "include_monthly_bills": False,
+        "register_annual_bills": True,
+        "register_monthly_bills": False,
+    },
     "UpgradeCosts": {"debug": False},
     "ServerDirectoryCleanup": {
         "retain_in_osm": False,

buildstockbatch/workflow_generator/residential/latest/residential_hpxml_schema.yml

@@ -64,6 +64,8 @@ sim-output-report-spec:
     add_timeseries_dst_column: bool(required=False)
     add_timeseries_utc_column: bool(required=False)
     output_variables: list(include('output-var-spec'), required=False)
+    include_annual_bills: bool(required=False)
+    include_monthly_bills: bool(required=False)
 output-var-spec:
     name: str(required=True)
 measure-spec:

buildstockbatch/workflow_generator/residential/latest/tests/test_residential_workflow_generator.py

@@ -62,6 +62,7 @@
                     {"name": "Zone Mean Air Temperature"},
                     {"name": "Zone People Occupant Count"},
                 ],
+                "include_monthly_bills": True,
             },
             "server_directory_cleanup": {"retain_in_osm": True, "retain_eplusout_msgpack": True},
             "reporting_measures": [
@@ -302,8 +303,11 @@ def test_residential_hpxml(upgrade, dynamic_cfg):
 
     utility_bills_step = osw["steps"][index]
     assert utility_bills_step["measure_dir_name"] == "ReportUtilityBills"
-    assert utility_bills_step["arguments"]["include_annual_bills"] is True
+    assert utility_bills_step["arguments"]["include_annual_bills"] is False
     assert utility_bills_step["arguments"]["include_monthly_bills"] is False
+    assert utility_bills_step["arguments"]["register_annual_bills"] is True
+    if "simulation_output_report" in workflow_args:
+        assert utility_bills_step["arguments"]["register_monthly_bills"] is True
     index += 1
 
     if "reporting_measures" in workflow_args:

buildstockbatch/workflow_generator/residential/latest/tests/testing_resstock_data/measures/ReportUtilityBills/measure.xml

@@ -3,8 +3,8 @@
   <schema_version>3.1</schema_version>
   <name>report_utility_bills</name>
   <uid>ca88a425-e59a-4bc4-af51-c7e7d1e960fe</uid>
-  <version_id>23d2e18e-c2ac-4c68-a5c4-fd4372203a39</version_id>
-  <version_modified>2024-05-18T14:35:04Z</version_modified>
+  <version_id>2d6b4393-2fe5-429a-a130-da41a8cb36f0</version_id>
+  <version_modified>2024-05-29T18:54:32Z</version_modified>
   <xml_checksum>15BF4E57</xml_checksum>
   <class_name>ReportUtilityBills</class_name>
   <display_name>Utility Bills Report</display_name>
@@ -37,7 +37,7 @@
     <argument>
       <name>include_annual_bills</name>
       <display_name>Generate Annual Utility Bills</display_name>
-      <description>Generates annual utility bills.</description>
+      <description>Generates output file containing annual utility bills.</description>
       <type>Boolean</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -56,7 +56,7 @@
     <argument>
       <name>include_monthly_bills</name>
       <display_name>Generate Monthly Utility Bills</display_name>
-      <description>Generates monthly utility bills.</description>
+      <description>Generates output file containing monthly utility bills.</description>
       <type>Boolean</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -107,6 +107,44 @@
       <required>false</required>
       <model_dependent>false</model_dependent>
     </argument>
+    <argument>
+      <name>register_annual_bills</name>
+      <display_name>Register Annual Utility Bills</display_name>
+      <description>Registers annual utility bills with the OpenStudio runner for downstream processing.</description>
+      <type>Boolean</type>
+      <required>false</required>
+      <model_dependent>false</model_dependent>
+      <default_value>true</default_value>
+      <choices>
+        <choice>
+          <value>true</value>
+          <display_name>true</display_name>
+        </choice>
+        <choice>
+          <value>false</value>
+          <display_name>false</display_name>
+        </choice>
+      </choices>
+    </argument>
+    <argument>
+      <name>register_monthly_bills</name>
+      <display_name>Register Monthly Utility Bills</display_name>
+      <description>Registers monthly utility bills with the OpenStudio runner for downstream processing.</description>
+      <type>Boolean</type>
+      <required>false</required>
+      <model_dependent>false</model_dependent>
+      <default_value>false</default_value>
+      <choices>
+        <choice>
+          <value>true</value>
+          <display_name>true</display_name>
+        </choice>
+        <choice>
+          <value>false</value>
+          <display_name>false</display_name>
+        </choice>
+      </choices>
+    </argument>
   </arguments>
   <outputs />
   <provenances />
@@ -125,7 +163,7 @@
       <filename>README.md</filename>
       <filetype>md</filetype>
       <usage_type>readme</usage_type>
-      <checksum>E137125B</checksum>
+      <checksum>13D965BE</checksum>
     </file>
     <file>
       <filename>README.md.erb</filename>
@@ -142,7 +180,7 @@
       <filename>measure.rb</filename>
       <filetype>rb</filetype>
       <usage_type>script</usage_type>
-      <checksum>22A6665F</checksum>
+      <checksum>99961E51</checksum>
     </file>
     <file>
       <filename>detailed_rates/Sample Flat Rate Min Annual Charge.json</filename>
@@ -240,47 +278,29 @@
       <usage_type>resource</usage_type>
       <checksum>56DDA6EC</checksum>
     </file>
-    <file>
-      <filename>simple_rates/Average_retail_price_of_electricity.csv</filename>
-      <filetype>csv</filetype>
-      <usage_type>resource</usage_type>
-      <checksum>02EEEF39</checksum>
-    </file>
     <file>
       <filename>simple_rates/HouseholdConsumption.csv</filename>
       <filetype>csv</filetype>
       <usage_type>resource</usage_type>
       <checksum>0BEECB93</checksum>
     </file>
     <file>
-      <filename>simple_rates/NG_PRI_SUM_A_EPG0_PRS_DMCF_A.csv</filename>
-      <filetype>csv</filetype>
-      <usage_type>resource</usage_type>
-      <checksum>C5FFF659</checksum>
-    </file>
-    <file>
-      <filename>simple_rates/PET_PRI_WFR_A_EPD2F_PRS_DPGAL_W.csv</filename>
-      <filetype>csv</filetype>
+      <filename>simple_rates/README.md</filename>
+      <filetype>md</filetype>
       <usage_type>resource</usage_type>
-      <checksum>8C00508D</checksum>
+      <checksum>C7E1E1CB</checksum>
     </file>
     <file>
-      <filename>simple_rates/PET_PRI_WFR_A_EPLLPA_PRS_DPGAL_W.csv</filename>
+      <filename>simple_rates/pr_all_update.csv</filename>
       <filetype>csv</filetype>
       <usage_type>resource</usage_type>
-      <checksum>614B155F</checksum>
-    </file>
-    <file>
-      <filename>simple_rates/README.md</filename>
-      <filetype>md</filetype>
-      <usage_type>resource</usage_type>
-      <checksum>7832E08F</checksum>
+      <checksum>CF6409BD</checksum>
     </file>
     <file>
       <filename>util.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>70347ABF</checksum>
+      <checksum>CD3334FF</checksum>
     </file>
     <file>
       <filename>Contains Demand Charges.json</filename>
@@ -322,7 +342,7 @@
       <filename>test_report_utility_bills.rb</filename>
       <filetype>rb</filetype>
       <usage_type>test</usage_type>
-      <checksum>3C2DECE9</checksum>
+      <checksum>CDF8B24F</checksum>
     </file>
   </files>
 </measure>

buildstockbatch/workflow_generator/residential/v2024_07_19/__init__.py

@@ -0,0 +1,8 @@
+__version__ = "2024.07.19"
+version_info = {
+    "version": __version__,
+    "version_description": """
+In this version, the UpgradeCosts measure is converted to a regular measure
+and is run early in the workflow. ReportHPXMLOutput measure is no longer used.
+""",
+}