Merge pull request #1838 from NREL/update_openei_rates

Update residential URDB utility rates

Changelog.md

@@ -29,6 +29,7 @@ __New Features__
   - **Breaking change**: Replaced `slab_perimeter_depth` argument with `slab_perimeter_insulation_depth`.
   - **Breaking change**: Replaced `schedules_vacancy_periods`, `schedules_power_outage_periods`, and `schedules_power_outage_periods_window_natvent_availability` arguments with `schedules_unavailable_period_types`, `schedules_unavailable_period_dates`, and `schedules_unavailable_period_window_natvent_availabilities`; this improves flexibility for handling more unavailable period types.
 - **Breaking change**: Disaggregates "Walls" into "Above Grade Walls" and "Below Grade Walls" in results_design_load_details.csv output file.
+- Updates `openei_rates.zip` with the latest residential utility rates from the [OpenEI U.S. Utility Rate database](https://apps.openei.org/USURDB/).
 - Adds a warning if the sum of supply/return duct leakage to outside values is very high.
 
 __Bugfixes__

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>3ff55cf2-a36f-498e-ad02-6e405913caa1</version_id>
-  <version_modified>2024-08-21T20:29:04Z</version_modified>
+  <version_id>97a99fc7-cb71-4c58-a69a-b5b744ec8646</version_id>
+  <version_modified>2024-09-18T19:18:42Z</version_modified>
   <xml_checksum>15BF4E57</xml_checksum>
   <class_name>ReportUtilityBills</class_name>
   <display_name>Utility Bills Report</display_name>
@@ -182,6 +182,12 @@
       <usage_type>script</usage_type>
       <checksum>93B04330</checksum>
     </file>
+    <file>
+      <filename>detailed_rates/README.md</filename>
+      <filetype>md</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>D038669F</checksum>
+    </file>
     <file>
       <filename>detailed_rates/Sample Flat Rate Min Annual Charge.json</filename>
       <filetype>json</filetype>
@@ -282,7 +288,7 @@
       <filename>detailed_rates/openei_rates.zip</filename>
       <filetype>zip</filetype>
       <usage_type>resource</usage_type>
-      <checksum>56DDA6EC</checksum>
+      <checksum>F41F4AA4</checksum>
     </file>
     <file>
       <filename>simple_rates/HouseholdConsumption.csv</filename>
@@ -348,7 +354,7 @@
       <filename>test_report_utility_bills.rb</filename>
       <filetype>rb</filetype>
       <usage_type>test</usage_type>
-      <checksum>83A62469</checksum>
+      <checksum>E03F767D</checksum>
     </file>
   </files>
 </measure>

ReportUtilityBills/resources/detailed_rates/README.md

@@ -0,0 +1,5 @@
+The **openei_rates.zip** file is produced by running `openstudio tasks.rb download_utility_rates`.
+
+Rates sourced from the [OpenEI U.S. Utility Rate database](https://apps.openei.org/USURDB/).
+
+Last updated on 9/18/2024.

ReportUtilityBills/tests/test_report_utility_bills.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'oga'
+require_relative '../../HPXMLtoOpenStudio/resources/calendar'
 require_relative '../../HPXMLtoOpenStudio/resources/constants'
 require_relative '../../HPXMLtoOpenStudio/resources/energyplus'
 require_relative '../../HPXMLtoOpenStudio/resources/hpxml'