Merge commit '7641d52062a4d4087092fa53882cad4d62e98a66' into hptest

hpxml-measures/Changelog.md

@@ -4,7 +4,7 @@ __New Features__
 - Adds inputs for modeling skylight curbs and/or shafts.
 - Allows alternative infiltration input `AirInfiltrationMeasurement/LeakinessDescription`, in which the infiltration level is estimated using age of home, climate zone, foundation type, etc.
 - Central Fan Integrated Supply (CFIS) mechanical ventilation enhancements:
-  - Allows modeling systems with no strategy to meet remainder of ventilation target (`CFISControls/AdditionalRuntimeOperatingMode="none"`).
+  - CFIS systems with no strategy to meet remainder of ventilation target (`CFISControls/AdditionalRuntimeOperatingMode="none"`).
 - HVAC Manual J design load and sizing calculations:
   - Adds optional inputs and outputs for blower fan heat and piping load.
   - Adds optional `HVACSizingControl/ManualJInputs/InfiltrationMethod` input to specify which infiltration method to use for design load calculations.

hpxml-measures/HPXMLtoOpenStudio/measure.xml

@@ -3,8 +3,8 @@
   <schema_version>3.1</schema_version>
   <name>hpxm_lto_openstudio</name>
   <uid>b1543b30-9465-45ff-ba04-1d1f85e763bc</uid>
-  <version_id>f16fb702-6d18-408b-a85f-fc3c31bc92ef</version_id>
-  <version_modified>2024-08-08T18:51:39Z</version_modified>
+  <version_id>2ab041da-cf56-49da-8a1b-e3f04ef6ef3a</version_id>
+  <version_modified>2024-08-09T17:13:39Z</version_modified>
   <xml_checksum>D8922A73</xml_checksum>
   <class_name>HPXMLtoOpenStudio</class_name>
   <display_name>HPXML to OpenStudio Translator</display_name>
@@ -315,7 +315,7 @@
       <filename>data/unavailable_periods.csv</filename>
       <filetype>csv</filetype>
       <usage_type>resource</usage_type>
-      <checksum>73BFECE2</checksum>
+      <checksum>3C44FFBB</checksum>
     </file>
     <file>
       <filename>energyplus.rb</filename>
@@ -387,7 +387,7 @@
       <filename>hvac_sizing.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>16F1A401</checksum>
+      <checksum>9A1C84AA</checksum>
     </file>
     <file>
       <filename>lighting.rb</filename>
@@ -573,7 +573,7 @@
       <filename>schedules.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>C1B88015</checksum>
+      <checksum>2778CD55</checksum>
     </file>
     <file>
       <filename>simcontrols.rb</filename>

hpxml-measures/HPXMLtoOpenStudio/resources/data/unavailable_periods.csv

@@ -33,3 +33,5 @@ house_fan,0,1
 kitchen_fan,1,1
 bath_fan,1,1
 whole_house_fan,0,1
+battery_charging,0,1
+battery_discharging,0,1

hpxml-measures/HPXMLtoOpenStudio/resources/schedules.rb

@@ -1787,7 +1787,8 @@ def self.unavailable_period_applies(runner, schedule_name, col_name)
       end
     end
 
-    fail "Could not find row='#{schedule_name}' in unavailable_periods.csv"
+    runner.registerWarning("Could not find row='#{schedule_name}' in unavailable_periods.csv; it will not be affected by the '#{col_name}' unavailable period.")
+    return false
   end
 
   # Ensure that the defined schedule value array (or string of numbers) is the correct length.
@@ -1895,8 +1896,8 @@ def initialize(name, used_by_unavailable_periods, can_be_stochastic, type)
     WaterHeaterSetpoint: Column.new('water_heater_setpoint', false, false, :setpoint),
     WaterHeaterOperatingMode: Column.new('water_heater_operating_mode', false, false, :zero_or_one),
     Battery: Column.new('battery', false, false, :neg_one_to_one),
-    BatteryCharging: Column.new('battery_charging', false, false, nil),
-    BatteryDischarging: Column.new('battery_discharging', false, false, nil),
+    BatteryCharging: Column.new('battery_charging', true, false, nil),
+    BatteryDischarging: Column.new('battery_discharging', true, false, nil),
     HVAC: Column.new('hvac', true, false, nil),
     HVACMaximumPowerRatio: Column.new('hvac_maximum_power_ratio', false, false, :frac),
     WaterHeater: Column.new('water_heater', true, false, nil),

hpxml-measures/docs/source/workflow_inputs.rst

@@ -3543,7 +3543,8 @@ Each central fan integrated supply (CFIS) system is entered as a ``/HPXML/Buildi
   .. [#] HoursInOperation is combined with the flow rate to form the hourly target ventilation rate (e.g., inputs of 90 cfm and 8 hrs/day produce an hourly target ventilation rate of 30 cfm).
   .. [#] If FanPower not provided, defaults to 0.58 W/cfm based on ANSI/RESNET/ICC 301-2022 Addendum C.
   .. [#] HVACDistribution type cannot be :ref:`hvac_distribution_hydronic`.
-  .. [#] Blower airflow rate when operating in ventilation only mode (i.e., not heating or cooling mode), as a fraction of the maximum blower airflow rate.
+  .. [#] VentilationOnlyModeAirflowFraction only applies when AdditionalRuntimeOperatingMode="air handler fan".
+         Defines the blower airflow rate when operating in ventilation only mode (i.e., not heating or cooling mode), as a fraction of the maximum blower airflow rate.
          This value will depend on whether the blower fan can operate at reduced airflow rates during ventilation only operation.
          It is used to determine how much conditioned air is recirculated through ducts during ventilation only operation, resulting in additional duct losses.
          A value of zero will result in no conditioned air recirculation, and thus no additional duct losses.

hpxml-measures/workflow/hpxml_inputs.json

@@ -999,6 +999,10 @@
     "parent_hpxml": "sample_files/base-battery.xml",
     "schedules_filepaths": "../../HPXMLtoOpenStudio/resources/schedule_files/battery.csv"
   },
+  "sample_files/base-battery-scheduled-power-outage.xml": {
+    "parent_hpxml": "sample_files/base-battery-scheduled.xml",
+    "schedules_power_outage_periods": "Jul 1 5 - Jul 31 14"
+  },
   "sample_files/base-bldgtype-sfa-unit.xml": {
     "parent_hpxml": "sample_files/base.xml",
     "geometry_unit_type": "single-family attached",