MINHERS -> HERS

Author: shorowit

Changelog.md

@@ -2,7 +2,7 @@
 
 __New Features__
 - Updates to OpenStudio 3.10/EnergyPlus 25.1/HPXML v4.2-rc2.
-- HVAC modeling updates per RESNET MINHERS Addendum 82:
+- HVAC modeling updates per RESNET HERS Addendum 82:
   - **Breaking change**: `CompressorType` required for central and mini-split air conditioners and heat pumps as well as ground-to-air heat pumps.
   - **Breaking change**: Replaces `HeatingCapacityRetention[Fraction | Temperature]` with `HeatingCapacityFraction17F`.
   - Optional input `SimulationControl/AdvancedResearchFeatures/GroundToAirHeatPumpModelType` to choose "standard" (default) or "experimental"; "experimental" ground-to-air heat pump model better accounts for coil staging.
@@ -21,7 +21,7 @@ __New Features__
     - **Breaking change**: Updated requirements for allowed combinations of `CapacityDescription` and `OutdoorTemperature`; see the [documentation](https://openstudio-hpxml.readthedocs.io/en/latest/workflow_inputs.html#hpxml-hvac-detailed-perf-data) for more details.
     - Detailed performance datapoints can now be specified for single stage and two stage equipment too.
     - Adds more error-checking to ensure appropriate data inputs.
-- Updates asset calculations for dishwashers, clothes washers, fixtures, and hot water waste per RESNET MINHERS Addenda 81 and 90f.
+- Updates asset calculations for dishwashers, clothes washers, fixtures, and hot water waste per RESNET HERS Addenda 81 and 90f.
 - Allows optional `ClothesDryer/DryingMethod` input to inform whether the appliance is vented or ventless.
 - Infiltration improvements:
   - Improves defaults for `InfiltrationVolume`, `InfiltrationHeight`, and `AverageCeilingHeight`.

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>6bd91023-9aea-4434-9777-4ae48e3b8a3b</version_id>
-  <version_modified>2025-06-27T21:07:47Z</version_modified>
+  <version_id>669d3120-0a96-475d-ae87-ffc2346c8ea8</version_id>
+  <version_modified>2025-06-27T21:11:41Z</version_modified>
   <xml_checksum>D8922A73</xml_checksum>
   <class_name>HPXMLtoOpenStudio</class_name>
   <display_name>HPXML to OpenStudio Translator</display_name>
@@ -348,7 +348,7 @@
       <filename>defaults.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>A7E3E8D2</checksum>
+      <checksum>45421D2F</checksum>
     </file>
     <file>
       <filename>electric_panel.rb</filename>
@@ -378,7 +378,7 @@
       <filename>hotwater_appliances.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>CCAAE4CD</checksum>
+      <checksum>0808DD47</checksum>
     </file>
     <file>
       <filename>hpxml.rb</filename>
@@ -414,7 +414,7 @@
       <filename>hvac.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>04E08240</checksum>
+      <checksum>7475293B</checksum>
     </file>
     <file>
       <filename>hvac_sizing.rb</filename>

HPXMLtoOpenStudio/resources/defaults.rb

@@ -2268,14 +2268,14 @@ def self.apply_hvac(runner, hpxml_bldg, weather, convert_shared_systems, unit_nu
       when HPXML::HVACTypeHeatPumpAirToAir, HPXML::HVACTypeHeatPumpMiniSplit
         if heat_pump.pan_heater_watts.nil?
           if heat_pump.fraction_heat_load_served > 0
-            heat_pump.pan_heater_watts = 150.0 # W, per RESNET MINHERS Addendum 82
+            heat_pump.pan_heater_watts = 150.0 # W, per RESNET HERS Addendum 82
           else
             heat_pump.pan_heater_watts = 0.0
           end
           heat_pump.pan_heater_watts_isdefaulted = true
         end
         if heat_pump.pan_heater_control_type.nil? && heat_pump.pan_heater_watts > 0
-          heat_pump.pan_heater_control_type = HPXML::HVACPanHeaterControlTypeContinuous # Per RESNET MINHERS Addendum 82
+          heat_pump.pan_heater_control_type = HPXML::HVACPanHeaterControlTypeContinuous # Per RESNET HERS Addendum 82
           heat_pump.pan_heater_control_type_isdefaulted = true
         end
       end
@@ -3238,7 +3238,7 @@ def self.apply_crankcase_heating(hpxml_bldg)
       if HVAC.is_room_dx_hvac_system(hvac_system)
         hvac_system.crankcase_heater_watts = 0.0
       else
-        # 10 W/ton of cooling capacity per RESNET MINHERS Addendum 82
+        # 10 W/ton of cooling capacity per RESNET HERS Addendum 82
         if hvac_system.is_a?(HPXML::HeatPump) && (hvac_system.fraction_cool_load_served == 0)
           # Heat pump only provides heating, use heating capacity instead
           hvac_system.crankcase_heater_watts = 10.0 * UnitConversions.convert(hvac_system.heating_capacity, 'Btu/hr', 'ton')
@@ -7592,7 +7592,7 @@ def self.set_hvac_fan_power_rated(hvac_system)
       # Fan not separately modeled
       hvac_ap.fan_power_rated = 0.0
     else
-      # Based on RESNET MINHERS Addendum 82
+      # Based on RESNET HERS Addendum 82
       psc_ducted_watts_per_cfm = 0.414 # W/cfm, PSC fan
       psc_ductless_watts_per_cfm = 0.414 # W/cfm, PSC fan
       bpm_ducted_watts_per_cfm = 0.281 # W/cfm, BPM fan
@@ -7654,7 +7654,7 @@ def self.set_hvac_degradation_coefficient(hvac_system)
     if HVAC.is_room_dx_hvac_system(hvac_system)
       hvac_ap.c_d = 0.22
     else
-      # Per RESNET MINHERS Addendum 82
+      # Per RESNET HERS Addendum 82
       case hvac_system.compressor_type
       when HPXML::HVACCompressorTypeSingleStage, HPXML::HVACCompressorTypeTwoStage
         hvac_ap.c_d = 0.08
@@ -7728,12 +7728,12 @@ def self.interpolate_seer2(seer2, eer2, seer2_array, seer2_eer2_ratio_array, cop
     end
     clg_ap.cool_ff_chg_values = [26.67, 35.0]
 
-    # Coefficients for HVAC installation quality per RESNET MINHERS Addendum 82
+    # Coefficients for HVAC installation quality per RESNET HERS Addendum 82
     clg_ap.cool_cap_fflow_spec_iq = [0.718664047, 0.41797409, -0.136638137]
     clg_ap.cool_eir_fflow_spec_iq = [1.143487507, -0.13943972, -0.004047787]
 
     if cooling_system.is_a?(HPXML::HeatPump) && cooling_system.heat_pump_type == HPXML::HVACTypeHeatPumpGroundToAir
-      # Based on RESNET MINHERS Addendum 82
+      # Based on RESNET HERS Addendum 82
       clg_ap.cool_rated_shr_gross = 0.708
       clg_ap.cool_rated_cfm_per_ton = HVAC::RatedCFMPerTon
 
@@ -7824,7 +7824,7 @@ def self.interpolate_seer2(seer2, eer2, seer2_array, seer2_eer2_ratio_array, cop
       return
     end
 
-    # Based on RESNET MINHERS Addendum 82
+    # Based on RESNET HERS Addendum 82
     clg_ap.cool_cap_fflow_spec = clg_ap.cool_cap_fflow_spec_iq
     clg_ap.cool_eir_fflow_spec = clg_ap.cool_eir_fflow_spec_iq
     set_hvac_degradation_coefficient(cooling_system)
@@ -7847,7 +7847,7 @@ def self.interpolate_seer2(seer2, eer2, seer2_array, seer2_eer2_ratio_array, cop
 
     clg_ap.cop95full = UnitConversions.convert(cooling_system.cooling_efficiency_eer2, 'Btu/hr', 'W')
 
-    # Based on RESNET MINHERS Addendum 82
+    # Based on RESNET HERS Addendum 82
     case compressor_type
     when HPXML::HVACCompressorTypeSingleStage
       clg_ap.qm95full = 0.936 # Q95full/Q82full
@@ -7902,7 +7902,7 @@ def self.interpolate_seer2(seer2, eer2, seer2_array, seer2_eer2_ratio_array, cop
     clg_ap.cool_rated_shr_gross = 0.708
   end
 
-  # Sets heating performance factors based on RESNET MINHERS Addendum 82.
+  # Sets heating performance factors based on RESNET HERS Addendum 82.
   #
   #
   # @param heating_system [HPXML::HeatingSystem or HPXML::HeatPump] The HPXML heating system or heat pump of interest
@@ -7935,12 +7935,12 @@ def self.interpolate_hspf2(hspf2, qm17full, hspf2_array, qm17full_array, cop47fu
     end
     htg_ap.heat_ff_chg_values = [0.0, 8.33] # Add a zero term to combine cooling and heating calculation
 
-    # Coefficients for HVAC installation quality per RESNET MINHERS Addendum 82
+    # Coefficients for HVAC installation quality per RESNET HERS Addendum 82
     htg_ap.heat_cap_fflow_spec_iq = [0.694045465, 0.474207981, -0.168253446]
     htg_ap.heat_eir_fflow_spec_iq = [2.185418751, -1.942827919, 0.757409168]
 
     if heating_system.is_a?(HPXML::HeatPump) && heating_system.heat_pump_type == HPXML::HVACTypeHeatPumpGroundToAir
-      # Based on RESNET MINHERS Addendum 82
+      # Based on RESNET HERS Addendum 82
       htg_ap.heat_rated_cfm_per_ton = HVAC::RatedCFMPerTon
 
       case hpxml_header.ground_to_air_heat_pump_model_type
@@ -8080,7 +8080,7 @@ def self.interpolate_hspf2(hspf2, qm17full, hspf2_array, qm17full_array, cop47fu
     hspf2 = heating_system.heating_efficiency_hspf2
     compressor_type = heating_system.compressor_type
 
-    # Based on RESNET MINHERS Addendum 82
+    # Based on RESNET HERS Addendum 82
     case compressor_type
     when HPXML::HVACCompressorTypeSingleStage
       htg_ap.eirm17full = 1.356 # (P17full/Q17full)/(P47full/Q47full)
@@ -8150,7 +8150,7 @@ def self.interpolate_hspf2(hspf2, qm17full, hspf2_array, qm17full_array, cop47fu
     htg_ap.heat_eir_ft_spec = [0.722917608, 0.003520184, 0.000143097, -0.005760341, 0.000141736, -0.000216676]
   end
 
-  # Adds default heat pump detailed performance datapoints based on RESNET MINHERS Addendum 82.
+  # Adds default heat pump detailed performance datapoints based on RESNET HERS Addendum 82.
   #
   # @param heat_pump [HPXML::HeatPump] The HPXML heat pump of interest
   # @return [nil]
@@ -8341,7 +8341,7 @@ def self.set_detailed_performance_data_heating(heat_pump)
                                   isdefaulted: true) unless capacityLCTmin.nil?
   end
 
-  # Adds default heat pump or air conditioner detailed performance datapoints based on RESNET MINHERS Addendum 82.
+  # Adds default heat pump or air conditioner detailed performance datapoints based on RESNET HERS Addendum 82.
   #
   # @param cooling_system [HPXML::CoolingSystem or HPXML::HeatPump] The HPXML cooling system or heat pump of interest
   # @return [nil]

HPXMLtoOpenStudio/resources/hotwater_appliances.rb

@@ -618,7 +618,7 @@ def self.calc_dishwasher_energy_gpd(runner, eri_version, hpxml_bldg, dishwasher,
       kwh_per_cyc = ((dishwasher.label_annual_gas_cost * 0.5497 / dishwasher.label_gas_rate - dishwasher.rated_annual_kwh * dishwasher.label_electric_rate * 0.02504 / dishwasher.label_electric_rate) / (dishwasher.label_electric_rate * 0.5497 / dishwasher.label_gas_rate - 0.02504)) / lcy
       if n_occ.nil? # Asset calculation
         if Constants::ERIVersions.index(eri_version) >= Constants::ERIVersions.index('latest') # FIXME: Change from 'latest' when incorporated in 301 standard
-          # RESNET MINHERS Addendum 81 Eq. 4.2-36a
+          # RESNET HERS Addendum 81 Eq. 4.2-36a
           if unit_type == HPXML::ResidentialTypeApartment
             scy = 135.7 + 13.5 * nbeds
           else
@@ -719,7 +719,7 @@ def self.calc_clothes_dryer_energy(runner, eri_version, hpxml_bldg, clothes_drye
       rmc = (0.97 * (clothes_washer.capacity / clothes_washer.integrated_modified_energy_factor) - clothes_washer.rated_annual_kwh / 312.0) / ((2.0104 * clothes_washer.capacity + 1.4242) * 0.455) + 0.04
       if n_occ.nil? # Asset calculation
         if Constants::ERIVersions.index(eri_version) >= Constants::ERIVersions.index('latest') # FIXME: Change from 'latest' when incorporated in 301 standard
-          # RESNET MINHERS Addendum 81 Eq. 4.2-34
+          # RESNET HERS Addendum 81 Eq. 4.2-34
           if unit_type == HPXML::ResidentialTypeApartment
             scy = 213.9 + 27.5 * nbeds
           else
@@ -833,7 +833,7 @@ def self.calc_clothes_washer_energy_gpd(runner, eri_version, hpxml_bldg, clothes
       lcy = clothes_washer.label_usage * 52.0 # label cycles per year
       if n_occ.nil? # Asset calculation
         if Constants::ERIVersions.index(eri_version) >= Constants::ERIVersions.index('latest') # FIXME: Change from 'latest' when incorporated in 301 standard
-          # RESNET MINHERS Addendum 81 Eq. 4.2-34
+          # RESNET HERS Addendum 81 Eq. 4.2-34
           if unit_type == HPXML::ResidentialTypeApartment
             scy = 213.9 + 27.5 * nbeds
           else
@@ -1191,7 +1191,7 @@ def self.get_fixtures_gpd(eri_version, hpxml_bldg, daily_mw_fractions)
     if Constants::ERIVersions.index(eri_version) >= Constants::ERIVersions.index('2014A')
       if n_occ.nil? # Asset calculation
         if Constants::ERIVersions.index(eri_version) >= Constants::ERIVersions.index('latest') # FIXME: Change from 'latest' when incorporated in 301 standard
-          # RESNET MINHERS Addendum 90f Eq. 4.2-29 (refFgpd)
+          # RESNET HERS Addendum 90f Eq. 4.2-29 (refFgpd)
           if unit_type == HPXML::ResidentialTypeApartment
             ref_f_gpd = 21.75 + 8.46 * nbeds
           else
@@ -1256,7 +1256,7 @@ def self.get_dist_waste_gpd(eri_version, hpxml_bldg)
 
     if n_occ.nil? # Asset calculation
       if Constants::ERIVersions.index(eri_version) >= Constants::ERIVersions.index('latest') # FIXME: Change from 'latest' when incorporated in 301 standard
-        # RESNET MINHERS Addendum 81 Eq. 4.2-29 (refWgpd)
+        # RESNET HERS Addendum 81 Eq. 4.2-29 (refWgpd)
         if unit_type == HPXML::ResidentialTypeApartment
           ref_w_gpd = 11.27 * (nbeds**0.323)
         else

HPXMLtoOpenStudio/resources/hvac.rb

@@ -8,8 +8,8 @@ module HVAC
   AirSourceCoolRatedOWB = 75.0 # degF, Rated outdoor wetbulb for air-source systems, cooling
   AirSourceCoolRatedIDB = 80.0 # degF, Rated indoor drybulb for air-source systems, cooling
   AirSourceCoolRatedIWB = 67.0 # degF, Rated indoor wetbulb for air-source systems, cooling
-  RatedCFMPerTon = 400.0 # cfm/ton of rated capacity, RESNET MINHERS Addendum 82
-  CrankcaseHeaterTemp = 50.0 # degF, RESNET MINHERS Addendum 82
+  RatedCFMPerTon = 400.0 # cfm/ton of rated capacity, RESNET HERS Addendum 82
+  CrankcaseHeaterTemp = 50.0 # degF, RESNET HERS Addendum 82
   MinCapacity = 1.0 # Btuh
   MinAirflow = 3.0 # cfm; E+ min airflow is 0.001 m3/s
   GroundSourceHeatRatedWET = 70.0 # degF, Rated water entering temperature for ground-source systems, heating
@@ -2412,7 +2412,7 @@ def self.calculate_fan_power(max_fan_power, fan_ratio, hvac_system)
 
       return max_fan_power
     else
-      # Based on RESNET MINHERS Addendum 82
+      # Based on RESNET HERS Addendum 82
       if hvac_system.fan_motor_type == HPXML::HVACFanMotorTypeBPM
         pow = hvac_system.distribution_system_idref.nil? ? 3 : 2.75
         return max_fan_power * (fan_ratio**pow)
@@ -2641,7 +2641,7 @@ def self.convert_datapoint_net_to_gross(dp, mode, speed_index, hvac_system)
   end
 
   # Extrapolate data points at the min/max outdoor drybulb temperatures to cover the full range of
-  # equipment operation. Extrapolates net capacity and input power per RESNET MINHERS Addendum 82:
+  # equipment operation. Extrapolates net capacity and input power per RESNET HERS Addendum 82:
   # - Cooling, Min ODB: Linear from 82F and 95F, but no less than 50% power of the 82F value
   # - Cooling, Max ODB: Linear from 82F and 95F
   # - Heating, Min ODB: Linear from lowest two temperatures
@@ -2837,7 +2837,7 @@ def self.add_datapoint_adaptive_step_size(datapoints_by_speed, mode, hvac_system
           else
             new_dp = HPXML::HeatingPerformanceDataPoint.new(nil)
           end
-          # Interpolate based on net power and capacity per RESNET MINHERS Addendum 82.
+          # Interpolate based on net power and capacity per RESNET HERS Addendum 82.
           new_dp.input_power = dp.input_power + Float(j) / (n_pt + 1) * (dp2.input_power - dp.input_power)
           new_dp.capacity = (dp.capacity + Float(j) / (n_pt + 1) * (dp2.capacity - dp.capacity)).round
           new_dp.outdoor_temperature = dp.outdoor_temperature + Float(j) / (n_pt + 1) * (dp2.outdoor_temperature - dp.outdoor_temperature)
@@ -2851,7 +2851,7 @@ def self.add_datapoint_adaptive_step_size(datapoints_by_speed, mode, hvac_system
   end
 
   # Adds detailed performance datapoints to include sensitivity to indoor temperatures.
-  # Based on RESNET MINHERS Addendum 82.
+  # Based on RESNET HERS Addendum 82.
   #
   # @param hvac_system [HPXML::HeatingSystem or HPXML::CoolingSystem or HPXML::HeatPump] The HPXML HVAC system of interest
   # @param datapoints_by_speed [Hash] Map of capacity description => array of detailed performance datapoints
@@ -4717,7 +4717,7 @@ def self.apply_pan_heater_ems_program(model, ems_program, htg_coil, conditioned_
   end
 
   # Create EMS program and Other equipment objects to account for delivered cooling load and supplemental heating energy during defrost.
-  # The defrost model is defined per RESNET MINHERS Addendum 82.
+  # The defrost model is defined per RESNET HERS Addendum 82.
   #
   # @param model [OpenStudio::Model::Model] OpenStudio Model object
   # @param htg_coil [OpenStudio::Model::CoilHeatingDXSingleSpeed or OpenStudio::Model::CoilHeatingDXMultiSpeed] OpenStudio Heating Coil object