diff --git a/HPXMLtoOpenStudio/measure.xml b/HPXMLtoOpenStudio/measure.xml index 09937a86d5..9a31e41d22 100644 --- a/HPXMLtoOpenStudio/measure.xml +++ b/HPXMLtoOpenStudio/measure.xml @@ -3,8 +3,8 @@ 3.1 hpxml_to_openstudio b1543b30-9465-45ff-ba04-1d1f85e763bc - 033831a5-9516-48c0-9ed2-d9f07b0e1609 - 2026-05-21T21:45:00Z + 40a959a9-0600-4ced-87d0-95260a45a38b + 2026-06-17T16:15:54Z D8922A73 HPXMLToOpenStudio HPXML to OpenStudio Translator @@ -217,7 +217,7 @@ airflow.rb rb resource - FEB9F10E + 50E3B7E9 battery.rb @@ -367,7 +367,7 @@ defaults.rb rb resource - 4044148D + A3B194F3 electric_panel.rb @@ -391,19 +391,19 @@ geometry.rb rb resource - 7F402CF9 + 4666E48F hotwater_appliances.rb rb resource - 3413BD58 + E0198FBF hpxml.rb rb resource - 4741A9D8 + 7BB98B65 hpxml_schema/HPXML.xsd @@ -421,7 +421,7 @@ hpxml_schematron/EPvalidator.sch sch resource - 0D042BF0 + 54FA6347 hpxml_schematron/iso-schematron.xsd @@ -715,7 +715,7 @@ waterheater.rb rb resource - C9FBD6FB + C428F4AB weather.rb @@ -751,7 +751,7 @@ test_defaults.rb rb test - 396FC7B6 + BE1661EA test_electric_panel.rb @@ -763,7 +763,7 @@ test_enclosure.rb rb test - F3EDA5AC + 0DA5536E test_generator.rb @@ -829,7 +829,7 @@ test_validation.rb rb test - 08D1113A + EA35509A test_vehicle.rb @@ -841,7 +841,7 @@ test_water_heater.rb rb test - 8DBA3BD3 + F216022C test_weather.rb diff --git a/HPXMLtoOpenStudio/resources/hotwater_appliances.rb b/HPXMLtoOpenStudio/resources/hotwater_appliances.rb index d0c9cf8729..4f9dc63e6f 100644 --- a/HPXMLtoOpenStudio/resources/hotwater_appliances.rb +++ b/HPXMLtoOpenStudio/resources/hotwater_appliances.rb @@ -615,11 +615,12 @@ def self.calc_dishwasher_energy_gpd(runner, eri_version, hpxml_bldg, dishwasher, end if Constants::ERIVersions.index(eri_version) >= Constants::ERIVersions.index('2019A') - if dishwasher.rated_annual_kwh.nil? - dishwasher.rated_annual_kwh = calc_dishwasher_annual_kwh_from_ef(dishwasher.energy_factor) + rated_annual_kwh = dishwasher.rated_annual_kwh + if rated_annual_kwh.nil? + rated_annual_kwh = calc_dishwasher_annual_kwh_from_ef(dishwasher.energy_factor) end lcy = dishwasher.label_usage * 52.0 - 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 + kwh_per_cyc = ((dishwasher.label_annual_gas_cost * 0.5497 / dishwasher.label_gas_rate - 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 HERS Addendum 81 Eq. 4.2-36a @@ -637,18 +638,19 @@ def self.calc_dishwasher_energy_gpd(runner, eri_version, hpxml_bldg, dishwasher, dwcpy = scy * (12.0 / dishwasher.place_setting_capacity) annual_kwh = kwh_per_cyc * dwcpy - gpd = (dishwasher.rated_annual_kwh - kwh_per_cyc * lcy) * 0.02504 * dwcpy / 365.0 + gpd = (rated_annual_kwh - kwh_per_cyc * lcy) * 0.02504 * dwcpy / 365.0 else - if dishwasher.energy_factor.nil? - dishwasher.energy_factor = calc_dishwasher_ef_from_annual_kwh(dishwasher.rated_annual_kwh) + energy_factor = dishwasher.energy_factor + if energy_factor.nil? + energy_factor = calc_dishwasher_ef_from_annual_kwh(dishwasher.rated_annual_kwh) end dwcpy = (88.4 + 34.9 * nbeds) * (12.0 / dishwasher.place_setting_capacity) - annual_kwh = ((86.3 + 47.73 / dishwasher.energy_factor) / 215.0) * dwcpy + annual_kwh = ((86.3 + 47.73 / energy_factor) / 215.0) * dwcpy if Constants::ERIVersions.index(eri_version) >= Constants::ERIVersions.index('2014A') - gpd = dwcpy * (4.6415 * (1.0 / dishwasher.energy_factor) - 1.9295) / 365.0 + gpd = dwcpy * (4.6415 * (1.0 / energy_factor) - 1.9295) / 365.0 else - gpd = ((88.4 + 34.9 * nbeds) * 8.16 - (88.4 + 34.9 * nbeds) * 12.0 / dishwasher.place_setting_capacity * (4.6415 * (1.0 / dishwasher.energy_factor) - 1.9295)) / 365.0 + gpd = ((88.4 + 34.9 * nbeds) * 8.16 - (88.4 + 34.9 * nbeds) * 12.0 / dishwasher.place_setting_capacity * (4.6415 * (1.0 / energy_factor) - 1.9295)) / 365.0 end end @@ -714,13 +716,15 @@ def self.calc_clothes_dryer_energy(runner, eri_version, hpxml_bldg, clothes_drye end if Constants::ERIVersions.index(eri_version) >= Constants::ERIVersions.index('2019A') - if clothes_dryer.combined_energy_factor.nil? - clothes_dryer.combined_energy_factor = calc_clothes_dryer_cef_from_ef(clothes_dryer.energy_factor) + combined_energy_factor = clothes_dryer.combined_energy_factor + if combined_energy_factor.nil? + combined_energy_factor = calc_clothes_dryer_cef_from_ef(clothes_dryer.energy_factor) end - if clothes_washer.integrated_modified_energy_factor.nil? - clothes_washer.integrated_modified_energy_factor = calc_clothes_washer_imef_from_mef(clothes_washer.modified_energy_factor) + integrated_modified_energy_factor = clothes_washer.integrated_modified_energy_factor + if integrated_modified_energy_factor.nil? + integrated_modified_energy_factor = calc_clothes_washer_imef_from_mef(clothes_washer.modified_energy_factor) end - 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 + rmc = (0.97 * (clothes_washer.capacity / 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 HERS Addendum 81 Eq. 4.2-34 @@ -736,7 +740,7 @@ def self.calc_clothes_dryer_energy(runner, eri_version, hpxml_bldg, clothes_drye scy = 123.0 + 61.0 * n_occ # Eq. 1 from http://www.fsec.ucf.edu/en/publications/pdf/fsec-pf-464-15.pdf end acy = scy * ((3.0 * 2.08 + 1.59) / (clothes_washer.capacity * 2.08 + 1.59)) - annual_kwh = (((rmc - 0.04) * 100) / 55.5) * (8.45 / clothes_dryer.combined_energy_factor) * acy + annual_kwh = (((rmc - 0.04) * 100) / 55.5) * (8.45 / combined_energy_factor) * acy if clothes_dryer.fuel_type == HPXML::FuelTypeElectricity annual_therm = 0.0 else @@ -744,11 +748,13 @@ def self.calc_clothes_dryer_energy(runner, eri_version, hpxml_bldg, clothes_drye annual_kwh = annual_kwh * 0.07 * (3.73 / 3.30) end else - if clothes_dryer.energy_factor.nil? - clothes_dryer.energy_factor = calc_clothes_dryer_ef_from_cef(clothes_dryer.combined_energy_factor) + energy_factor = clothes_dryer.energy_factor + if energy_factor.nil? + energy_factor = calc_clothes_dryer_ef_from_cef(clothes_dryer.combined_energy_factor) end - if clothes_washer.modified_energy_factor.nil? - clothes_washer.modified_energy_factor = calc_clothes_washer_mef_from_imef(clothes_washer.integrated_modified_energy_factor) + modified_energy_factor = clothes_washer.modified_energy_factor + if modified_energy_factor.nil? + modified_energy_factor = calc_clothes_washer_mef_from_imef(clothes_washer.integrated_modified_energy_factor) end if clothes_dryer.control_type == HPXML::ClothesDryerControlTypeTimer field_util_factor = 1.18 @@ -756,12 +762,12 @@ def self.calc_clothes_dryer_energy(runner, eri_version, hpxml_bldg, clothes_drye field_util_factor = 1.04 end if clothes_dryer.fuel_type == HPXML::FuelTypeElectricity - annual_kwh = 12.5 * (164.0 + 46.5 * nbeds) * (field_util_factor / clothes_dryer.energy_factor) * ((clothes_washer.capacity / clothes_washer.modified_energy_factor) - clothes_washer.rated_annual_kwh / 392.0) / (0.2184 * (clothes_washer.capacity * 4.08 + 0.24)) + annual_kwh = 12.5 * (164.0 + 46.5 * nbeds) * (field_util_factor / energy_factor) * ((clothes_washer.capacity / modified_energy_factor) - clothes_washer.rated_annual_kwh / 392.0) / (0.2184 * (clothes_washer.capacity * 4.08 + 0.24)) annual_therm = 0.0 else - annual_kwh = 12.5 * (164.0 + 46.5 * nbeds) * (field_util_factor / 3.01) * ((clothes_washer.capacity / clothes_washer.modified_energy_factor) - clothes_washer.rated_annual_kwh / 392.0) / (0.2184 * (clothes_washer.capacity * 4.08 + 0.24)) - annual_therm = annual_kwh * 3412.0 * (1.0 - 0.07) * (3.01 / clothes_dryer.energy_factor) / 100000 - annual_kwh = annual_kwh * 0.07 * (3.01 / clothes_dryer.energy_factor) + annual_kwh = 12.5 * (164.0 + 46.5 * nbeds) * (field_util_factor / 3.01) * ((clothes_washer.capacity / modified_energy_factor) - clothes_washer.rated_annual_kwh / 392.0) / (0.2184 * (clothes_washer.capacity * 4.08 + 0.24)) + annual_therm = annual_kwh * 3412.0 * (1.0 - 0.07) * (3.01 / energy_factor) / 100000 + annual_kwh = annual_kwh * 0.07 * (3.01 / energy_factor) end end diff --git a/docs/source/workflow_inputs.rst b/docs/source/workflow_inputs.rst index 646456b922..de660acbd9 100644 --- a/docs/source/workflow_inputs.rst +++ b/docs/source/workflow_inputs.rst @@ -155,7 +155,7 @@ If EmissionsType is "CO2e", "NOx" or "SO2" and a given fuel's emissions factor i wood pellets -- -- -- ============ ============== ============= ============= -Default values in lb/MBtu (million Btu) are from ANSI/RESNET/ICC 301-2022 Addendum B and include both combustion and pre-combustion (e.g., methane leakage for natural gas) emissions. +Default values in lb/MBtu (million Btu) are from `ANSI/RESNET/ICC 301-2022 Addendum B `_ and include both combustion and pre-combustion (e.g., methane leakage for natural gas) emissions. If no default value is available, a warning will be issued. @@ -484,7 +484,7 @@ Site information is entered in ``/HPXML/Building/BuildingDetails/BuildingSummary \- **unknown/other, dry**: 0.3680 - \- **unknown/other, mixed**: 1.0000 (based on ANSI/RESNET/ICC 301-2022 Addendum C) + \- **unknown/other, mixed**: 1.0000 (based on `ANSI/RESNET/ICC 301-2022 Addendum C `_) \- **unknown/other, wet**: 1.6320 @@ -601,7 +601,7 @@ Building occupancy is entered in ``/HPXML/Building/BuildingDetails/BuildingSumma .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided (and :ref:`schedules_detailed` not used), then :ref:`schedules_default` are used. .. [#] If MonthlyScheduleMultipliers not provided (and :ref:`schedules_detailed` not used), then :ref:`schedules_default` are used. - .. [#] Sensible and latent internal gains from general water use (floor mopping, shower evaporation, water films on showers, tubs & sinks surfaces, plant watering, etc.), as defined by `ANSI/RESNET/ICC 301-2019 `_. + .. [#] Sensible and latent internal gains from general water use (floor mopping, shower evaporation, water films on showers, tubs & sinks surfaces, plant watering, etc.), as defined by `ANSI/RESNET/ICC 301-2022 `_. If NumberofResidents provided, this will be adjusted using the above equations from RECS. .. [#] If GeneralWaterUseWeekdayScheduleFractions or GeneralWaterUseWeekendScheduleFractions not provided (and :ref:`schedules_detailed` not used), then :ref:`schedules_default` are used. .. [#] If GeneralWaterUseMonthlyScheduleMultipliers not provided (and :ref:`schedules_detailed` not used), then :ref:`schedules_default` are used. @@ -1023,7 +1023,7 @@ Building air leakage is entered in ``/HPXML/Building/BuildingDetails/Enclosure/A .. [#] If InfiltrationHeight not provided, it is estimated from other inputs (e.g., ConditionedFloorArea, NumberofConditionedFloorsAboveGrade, attics/foundations with WithinInfiltrationVolume=true, etc.). .. [#] InfiltrationHeight is defined as the vertical distance between the lowest and highest above-grade points within the pressure boundary, per ASHRAE 62.2. It is used along with the ``UnitHeightAboveGrade`` in :ref:`bldg_constr` to calculate the wind speed for the infiltration model. - .. [#] If Aext not provided and TypeOfInfiltrationLeakage is "unit total", defaults for single-family attached and apartment units to the ratio of exterior (adjacent to outside) envelope surface area to total (adjacent to outside, other dwelling units, or other MF spaces) envelope surface area, as defined by `ANSI/RESNET/ICC 301-2019 `_ and `ASHRAE 62.2-2019 `_. + .. [#] If Aext not provided and TypeOfInfiltrationLeakage is "unit total", defaults for single-family attached and apartment units to the ratio of exterior (adjacent to outside) envelope surface area to total (adjacent to outside, other dwelling units, or other MF spaces) envelope surface area, as defined by `ANSI/RESNET/ICC 301-2022 `_ and `ASHRAE 62.2-2019 `_. Note that all attached surfaces, even adiabatic surfaces, must be defined in the HPXML file. If single-family detached or TypeOfInfiltrationLeakage is "unit exterior only", Aext is 1. @@ -1179,7 +1179,7 @@ If the dwelling unit has a vented attic, additional information is entered in `` .. [#] UnitofMeasure choices are "SLA" (specific leakage area) or "ACHnatural" (natural air changes per hour). .. [#] If there are multiple vented attics, they must all have the same value. - .. [#] Value default based on `ANSI/RESNET/ICC 301-2019 `_. + .. [#] Value default based on `ANSI/RESNET/ICC 301-2022 `_. HPXML Foundations ***************** @@ -1228,7 +1228,7 @@ If the dwelling unit has a vented crawlspace, additional information is entered .. [#] UnitofMeasure only choice is "SLA" (specific leakage area). .. [#] If there are multiple vented crawlspaces, they must all have the same value. - .. [#] Value default based on `ANSI/RESNET/ICC 301-2019 `_. + .. [#] Value default based on `ANSI/RESNET/ICC 301-2022 `_. If the dwelling has a manufactured home belly-and-wing foundation, additional information is entered in ``/HPXML/Building/BuildingDetails/Enclosure/Foundations/Foundation/FoundationType/BellyAndWing``. @@ -2322,7 +2322,7 @@ Each in-unit boiler is entered as a ``/HPXML/Building/BuildingDetails/Systems/HV .. [#] The sum of all ``FractionHeatLoadServed`` (across all HVAC systems) must be less than or equal to 1. .. [#] FractionHeatLoadServed is required unless the heating system is a heat pump backup system (i.e., referenced by a ``HeatPump[BackupType="separate"]/BackupSystem``; see :ref:`hvac_heatpump`), in which case FractionHeatLoadServed is not allowed. Heat pump backup will only operate during colder temperatures when the heat pump runs out of heating capacity or is disabled due to a switchover/lockout temperature. - .. [#] If ElectricAuxiliaryEnergy not provided, defaults as follows per ANSI/RESNET/ICC 301-2019: + .. [#] If ElectricAuxiliaryEnergy not provided, defaults as follows per `ANSI/RESNET/ICC 301-2022 `_: \- **Oil boiler**: 330 kWh/yr @@ -2366,7 +2366,7 @@ Each shared boiler (serving multiple dwelling units) is entered as a ``/HPXML/Bu .. [#] The sum of all ``FractionHeatLoadServed`` (across all HVAC systems) must be less than or equal to 1. .. [#] FractionHeatLoadServed is required unless the heating system is a heat pump backup system (i.e., referenced by a ``HeatPump[BackupType="separate"]/BackupSystem``; see :ref:`hvac_heatpump`), in which case FractionHeatLoadServed is not allowed. Heat pump backup will only operate during colder temperatures when the heat pump runs out of heating capacity or is disabled due to a switchover/lockout temperature. - .. [#] If ElectricAuxiliaryEnergy nor SharedLoopWatts provided, defaults as follows per ANSI/RESNET/ICC 301-2019: + .. [#] If ElectricAuxiliaryEnergy nor SharedLoopWatts provided, defaults as follows per `ANSI/RESNET/ICC 301-2019 `_: \- **Shared boiler w/ baseboard**: 220 kWh/yr @@ -2532,10 +2532,10 @@ Each central air conditioner is entered as a ``/HPXML/Building/BuildingDetails/S .. [#] Cooling capacity autosized per ACCA Manual J/S based on cooling design load. .. [#] CompressorType choices are "single stage", "two stage", or "variable speed". .. [#] The sum of all ``FractionCoolLoadServed`` (across all HVAC systems) must be less than or equal to 1. - .. [#] If SEER provided, converted to SEER2 using ANSI/RESNET/ICC 301-2022 Addendum C. For example, SEER2 = SEER * 0.95 if EquipmentType is "split system". + .. [#] If SEER provided, converted to SEER2 using `ANSI/RESNET/ICC 301-2022 Addendum C `_. For example, SEER2 = SEER * 0.95 if EquipmentType is "split system". .. [#] In addition, EER2 must be <= SEER2; EER must be < SEER. .. [#] If neither EER2 nor EER provided, EER2 defaults to (0.73 * SEER2 + 1.47) for single stage, (0.63 * SEER2 + 2.34) for two stage, and (0.31 * SEER2 + 6.45) for variable speed, based on a regression analysis of `ENERGY STAR products `_. - .. [#] If EER provided, converted to EER2 using ANSI/RESNET/ICC 301-2022 Addendum C. For example, EER2 = EER * 0.95 if EquipmentType is "split system". + .. [#] If EER provided, converted to EER2 using `ANSI/RESNET/ICC 301-2022 Addendum C `_. For example, EER2 = EER * 0.95 if EquipmentType is "split system". .. [#] If CoolingDetailedPerformanceData is provided, see :ref:`clg_detailed_perf_data`. .. [#] FanMotorType choices are "PSC" (Permanent Split Capacitor) and "BPM" (Brushless Permanent Magnet). If there is a heating system attached to the DistributionSystem, the heating and cooling systems cannot have different values for FanMotorType. @@ -2547,7 +2547,7 @@ Each central air conditioner is entered as a ``/HPXML/Building/BuildingDetails/S .. [#] ChargeDefectRatio is defined as (InstalledCharge - DesignCharge) / DesignCharge; a value of zero means no refrigerant charge defect. A non-zero charge defect should typically only be applied for systems that are charged on site, not for systems that have pre-charged line sets. See `ANSI/RESNET/ACCA 310-2020 `_ for more information. - .. [#] If CrankcaseHeaterPowerWatts not provided, defaults to 10 W per ton of rated cooling capacity per RESNET HERS Addendum 82. + .. [#] If CrankcaseHeaterPowerWatts not provided, defaults to 10 W per ton of rated cooling capacity per `RESNET HERS Addendum 82 `_. .. [#] EquipmentType choices are "split system", "packaged system", "small duct high velocity system", or "space constrained system". .. _hvac_cooling_room_ac: @@ -2713,10 +2713,10 @@ Each mini-split air conditioner is entered as a ``/HPXML/Building/BuildingDetail .. [#] If DistributionSystem provided, HVACDistribution type must be :ref:`hvac_distribution_air` (type: "regular velocity") or :ref:`hvac_distribution_dse`. .. [#] Cooling capacity autosized per ACCA Manual J/S based on cooling design load. .. [#] The sum of all ``FractionCoolLoadServed`` (across all HVAC systems) must be less than or equal to 1. - .. [#] If SEER provided, converted to SEER2 using ANSI/RESNET/ICC 301-2022 Addendum C, where SEER2 = SEER * 0.95 if ducted and SEER2 = SEER if ductless. + .. [#] If SEER provided, converted to SEER2 using `ANSI/RESNET/ICC 301-2022 Addendum C `_, where SEER2 = SEER * 0.95 if ducted and SEER2 = SEER if ductless. .. [#] In addition, EER2 must be <= SEER2; EER must be < SEER. .. [#] If neither EER2 nor EER provided, EER2 defaults to (0.73 * SEER2 + 1.47) for single stage, (0.63 * SEER2 + 2.34) for two stage, and (0.31 * SEER2 + 6.45) for variable speed, based on a regression analysis of `ENERGY STAR products `_. - .. [#] If EER provided, converted to EER2 using ANSI/RESNET/ICC 301-2022 Addendum C, where EER2 = EER * 0.95 if ducted and EER2 = EER if ductless. + .. [#] If EER provided, converted to EER2 using `ANSI/RESNET/ICC 301-2022 Addendum C `_, where EER2 = EER * 0.95 if ducted and EER2 = EER if ductless. .. [#] If CoolingDetailedPerformanceData is provided, see :ref:`clg_detailed_perf_data`. .. [#] FanMotorType choices are "PSC" (Permanent Split Capacitor) and "BPM" (Brushless Permanent Magnet). If there is a heating system attached to the DistributionSystem, the heating and cooling systems cannot have different values for FanMotorType. @@ -2728,7 +2728,7 @@ Each mini-split air conditioner is entered as a ``/HPXML/Building/BuildingDetail .. [#] ChargeDefectRatio is defined as (InstalledCharge - DesignCharge) / DesignCharge; a value of zero means no refrigerant charge defect. A non-zero charge defect should typically only be applied for systems that are charged on site, not for systems that have pre-charged line sets. See `ANSI/RESNET/ACCA 310-2020 `_ for more information. - .. [#] If CrankcaseHeaterPowerWatts not provided, defaults to 10 W per ton of rated cooling capacity per RESNET HERS Addendum 82. + .. [#] If CrankcaseHeaterPowerWatts not provided, defaults to 10 W per ton of rated cooling capacity per `RESNET HERS Addendum 82 `_. .. _hvac_cooling_shared_chiller: @@ -2765,7 +2765,7 @@ Each shared chiller (serving multiple dwelling units) is entered as a ``/HPXML/B .. note:: - Chillers are modeled as central air conditioners with a SEER equivalent using the equation from `ANSI/RESNET/ICC 301-2019 `_. + Chillers are modeled as central air conditioners with a SEER equivalent using the equation from `ANSI/RESNET/ICC 301-2022 `_. .. _hvac_cooling_shared_tower: @@ -2798,7 +2798,7 @@ Each shared cooling tower (serving multiple dwelling units) is entered as a ``/H .. note:: - Cooling towers w/ water loop heat pumps are modeled as central air conditioners with a SEER equivalent using the equation from `ANSI/RESNET/ICC 301-2019 `_. + Cooling towers w/ water loop heat pumps are modeled as central air conditioners with a SEER equivalent using the equation from `ANSI/RESNET/ICC 301-2022 `_. .. _hvac_heatpump: @@ -2885,11 +2885,11 @@ Each air-to-air heat pump is entered as a ``/HPXML/Building/BuildingDetails/Syst Additional backup inputs are described in :ref:`hvac_hp_backup`. .. [#] The sum of all ``FractionHeatLoadServed`` (across all HVAC systems) must be less than or equal to 1. .. [#] The sum of all ``FractionCoolLoadServed`` (across all HVAC systems) must be less than or equal to 1. - .. [#] If SEER provided, converted to SEER2 using ANSI/RESNET/ICC 301-2022 Addendum C. For example, SEER2 = SEER * 0.95 if EquipmentType is "split system". + .. [#] If SEER provided, converted to SEER2 using `ANSI/RESNET/ICC 301-2022 Addendum C `_. For example, SEER2 = SEER * 0.95 if EquipmentType is "split system". .. [#] In addition, EER2 must be <= SEER2; EER must be < SEER. .. [#] If neither EER2 nor EER provided, EER2 defaults to (0.73 * SEER2 + 1.47) for single stage, (0.63 * SEER2 + 2.34) for two stage, and (0.31 * SEER2 + 6.45) for variable speed, based on a regression analysis of `ENERGY STAR products `_. - .. [#] If EER provided, converted to EER2 using ANSI/RESNET/ICC 301-2022 Addendum C. For example, EER2 = EER * 0.95 if EquipmentType is "split system". - .. [#] If HSPF provided, converted to HSPF2 using ANSI/RESNET/ICC 301-2022 Addendum C. For example, HSPF2 = HSPF * 0.85 if EquipmentType is "split system". + .. [#] If EER provided, converted to EER2 using `ANSI/RESNET/ICC 301-2022 Addendum C `_. For example, EER2 = EER * 0.95 if EquipmentType is "split system". + .. [#] If HSPF provided, converted to HSPF2 using `ANSI/RESNET/ICC 301-2022 Addendum C `_. For example, HSPF2 = HSPF * 0.85 if EquipmentType is "split system". .. [#] If CoolingDetailedPerformanceData is provided, see :ref:`clg_detailed_perf_data`. .. [#] If HeatingDetailedPerformanceData is provided, see :ref:`htg_detailed_perf_data`. .. [#] FanMotorType choices are "PSC" (Permanent Split Capacitor) and "BPM" (Brushless Permanent Magnet). @@ -2902,7 +2902,7 @@ Each air-to-air heat pump is entered as a ``/HPXML/Building/BuildingDetails/Syst .. [#] ChargeDefectRatio is defined as (InstalledCharge - DesignCharge) / DesignCharge; a value of zero means no refrigerant charge defect. A non-zero charge defect should typically only be applied for systems that are charged on site, not for systems that have pre-charged line sets. See `ANSI/RESNET/ACCA 310-2020 `_ for more information. - .. [#] If CrankcaseHeaterPowerWatts not provided, defaults to 10 W per ton of rated cooling capacity per RESNET HERS Addendum 82. + .. [#] If CrankcaseHeaterPowerWatts not provided, defaults to 10 W per ton of rated cooling capacity per `RESNET HERS Addendum 82 `_. .. [#] PanHeaterControlType choices are "continuous", "heat pump mode", or "defrost mode". .. [#] If PanHeaterControlType is "continuous", the pan heater will operate anytime the outdoor temperature is below 32F and above the minimum compressor operating temperature. If PanHeaterControlType is "heat pump mode", the pan heater will operate anytime the outdoor temperature is below 32F and the heat pump is operating. @@ -2981,11 +2981,11 @@ Each ``HeatPump`` should represent a single outdoor unit, whether connected to o Additional backup inputs are described in :ref:`hvac_hp_backup`. .. [#] The sum of all ``FractionHeatLoadServed`` (across all HVAC systems) must be less than or equal to 1. .. [#] The sum of all ``FractionCoolLoadServed`` (across all HVAC systems) must be less than or equal to 1. - .. [#] If SEER provided, converted to SEER2 using ANSI/RESNET/ICC 301-2022 Addendum C, where SEER2 = SEER * 0.95 if ducted and SEER2 = SEER if ductless. + .. [#] If SEER provided, converted to SEER2 using `ANSI/RESNET/ICC 301-2022 Addendum C `_, where SEER2 = SEER * 0.95 if ducted and SEER2 = SEER if ductless. .. [#] In addition, EER2 must be <= SEER2; EER must be < SEER. .. [#] If neither EER2 nor EER provided, EER2 defaults to (0.73 * SEER2 + 1.47) for single stage, (0.63 * SEER2 + 2.34) for two stage, and (0.31 * SEER2 + 6.45) for variable speed, based on a regression analysis of `ENERGY STAR products `_. - .. [#] If EER provided, converted to EER2 using ANSI/RESNET/ICC 301-2022 Addendum C, where EER2 = EER * 0.95 if ducted and EER2 = EER if ductless. - .. [#] If HSPF provided, converted to HSPF2 using ANSI/RESNET/ICC 301-2022 Addendum C, where HSPF2 = HSPF * 0.85 if ducted and HSPF2 = HSPF * 0.90 if ductless. + .. [#] If EER provided, converted to EER2 using `ANSI/RESNET/ICC 301-2022 Addendum C `_, where EER2 = EER * 0.95 if ducted and EER2 = EER if ductless. + .. [#] If HSPF provided, converted to HSPF2 using `ANSI/RESNET/ICC 301-2022 Addendum C `_, where HSPF2 = HSPF * 0.85 if ducted and HSPF2 = HSPF * 0.90 if ductless. .. [#] If CoolingDetailedPerformanceData is provided, see :ref:`clg_detailed_perf_data`. .. [#] If HeatingDetailedPerformanceData is provided, see :ref:`htg_detailed_perf_data`. .. [#] FanMotorType choices are "PSC" (Permanent Split Capacitor) and "BPM" (Brushless Permanent Magnet). @@ -2998,7 +2998,7 @@ Each ``HeatPump`` should represent a single outdoor unit, whether connected to o .. [#] ChargeDefectRatio is defined as (InstalledCharge - DesignCharge) / DesignCharge; a value of zero means no refrigerant charge defect. A non-zero charge defect should typically only be applied for systems that are charged on site, not for systems that have pre-charged line sets. See `ANSI/RESNET/ACCA 310-2020 `_ for more information. - .. [#] If CrankcaseHeaterPowerWatts not provided, defaults to 10 W per ton of rated cooling capacity per RESNET HERS Addendum 82. + .. [#] If CrankcaseHeaterPowerWatts not provided, defaults to 10 W per ton of rated cooling capacity per `RESNET HERS Addendum 82 `_. .. [#] PanHeaterControlType choices are "continuous", "heat pump mode", or "defrost mode". .. [#] If PanHeaterControlType is "continuous", the pan heater will operate anytime the outdoor temperature is below 32F and above the minimum compressor operating temperature. If PanHeaterControlType is "heat pump mode", the pan heater will operate anytime the outdoor temperature is below 32F and the heat pump is operating. @@ -3781,7 +3781,7 @@ Each exhaust only fan is entered as a ``/HPXML/Building/BuildingDetails/Systems/ .. [#] HoursInOperation is optional unless the VentilationFan refers to the supplemental fan of a :ref:`vent_fan_cfis` system, in which case it is not allowed because the runtime is automatically calculated for each hour to maintain the hourly target ventilation rate. .. [#] All other UsedFor... elements (i.e., ``UsedForLocalVentilation``, ``UsedForSeasonalCoolingLoadReduction``, ``UsedForGarageVentilation``) must be omitted or false. - .. [#] If FanPower not provided, defaults to 0.35 W/cfm based on `ANSI/RESNET/ICC 301-2019 `_. + .. [#] If FanPower not provided, defaults to 0.35 W/cfm based on `ANSI/RESNET/ICC 301-2022 `_. .. _vent_fan_supply_only: @@ -3821,7 +3821,7 @@ Each supply only fan is entered as a ``/HPXML/Building/BuildingDetails/Systems/M .. [#] HoursInOperation is optional unless the VentilationFan refers to the supplemental fan of a :ref:`vent_fan_cfis` system, in which case it is not allowed because the runtime is automatically calculated for each hour to maintain the hourly target ventilation rate. .. [#] All other UsedFor... elements (i.e., ``UsedForLocalVentilation``, ``UsedForSeasonalCoolingLoadReduction``, ``UsedForGarageVentilation``) must be omitted or false. - .. [#] If FanPower not provided, defaults to 0.35 W/cfm based on `ANSI/RESNET/ICC 301-2019 `_. + .. [#] If FanPower not provided, defaults to 0.35 W/cfm based on `ANSI/RESNET/ICC 301-2022 `_. .. _vent_fan_balanced: @@ -3860,7 +3860,7 @@ Each balanced (supply and exhaust) fan is entered as a ``/HPXML/Building/Buildin OpenStudio-HPXML does not currently support defaulting flow rates for multiple mechanical ventilation fans. .. [#] All other UsedFor... elements (i.e., ``UsedForLocalVentilation``, ``UsedForSeasonalCoolingLoadReduction``, ``UsedForGarageVentilation``) must be omitted or false. - .. [#] If FanPower not provided, defaults to 0.7 W/cfm based on `ANSI/RESNET/ICC 301-2019 `_. + .. [#] If FanPower not provided, defaults to 0.7 W/cfm based on `ANSI/RESNET/ICC 301-2022 `_. .. _vent_fan_hrv: @@ -3902,7 +3902,7 @@ Each heat recovery ventilator (HRV) is entered as a ``/HPXML/Building/BuildingDe .. [#] All other UsedFor... elements (i.e., ``UsedForLocalVentilation``, ``UsedForSeasonalCoolingLoadReduction``, ``UsedForGarageVentilation``) must be omitted or false. .. [#] AdjustedSensibleRecoveryEfficiency (ASRE) is similar to SensibleRecoveryEfficiency (SRE), in that it reflects heating season performance, but excludes fan electric consumption. Since OpenStudio-HPXML separately models fan electric consumption, ASRE is a preferable input to SRE because it can be directly used in the energy model. - .. [#] If FanPower not provided, defaults to 1.0 W/cfm based on `ANSI/RESNET/ICC 301-2019 `_. + .. [#] If FanPower not provided, defaults to 1.0 W/cfm based on `ANSI/RESNET/ICC 301-2022 `_. .. _vent_fan_erv: @@ -3947,7 +3947,7 @@ Each energy recovery ventilator (ERV) is entered as a ``/HPXML/Building/Building Since OpenStudio-HPXML separately models fan electric consumption, ATRE is a preferable input to TRE because it can be directly used in the energy model. .. [#] AdjustedSensibleRecoveryEfficiency (ASRE) is similar to SensibleRecoveryEfficiency (SRE), in that it reflects heating season performance, but excludes fan electric consumption. Since OpenStudio-HPXML separately models fan electric consumption, ASRE is a preferable input to SRE because it can be directly used in the energy model. - .. [#] If FanPower not provided, defaults to 1.0 W/cfm based on `ANSI/RESNET/ICC 301-2019 `_. + .. [#] If FanPower not provided, defaults to 1.0 W/cfm based on `ANSI/RESNET/ICC 301-2022 `_. .. _vent_fan_cfis: @@ -4213,7 +4213,7 @@ Each instantaneous tankless water heater is entered as a ``/HPXML/Building/Build \- **IECC zones 3-8, unknown**: "basement - unconditioned", "basement - conditioned", "conditioned space" - .. [#] If PerformanceAdjustment not provided, defaults to 0.94 (UEF) or 0.92 (EF) based on `ANSI/RESNET/ICC 301-2019 `_. + .. [#] If PerformanceAdjustment not provided, defaults to 0.94 (UEF) or 0.92 (EF) based on `ANSI/RESNET/ICC 301-2022 `_. .. [#] The sum of all ``FractionDHWLoadServed`` (across all WaterHeatingSystems) must equal to 1. .. [#] FractionDHWLoadServed represents only the fraction of the hot water load associated with the hot water **fixtures**. Additional hot water load from clothes washers/dishwashers will be automatically assigned to the appropriate water heater(s). @@ -4398,7 +4398,7 @@ If any water heating systems are provided, a single hot water distribution syste - :ref:`hot_water_dist_recirc` - :ref:`hot_water_dist_recirc_shared` -Hot water distribution systems are modeled according to the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2019 `_. +Hot water distribution systems are modeled according to the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2022 `_. If NumberofResidents is provided, then hot water distribution use from Equation 14 of `Estimating Daily Domestic Hot-Water Use in North American Homes `_ is substituted into the ANSI/RESNET/ICC 301 equations. .. note:: @@ -4423,7 +4423,7 @@ A standard hot water distribution system is entered as a ``/HPXML/Building/Build ``DrainWaterHeatRecovery`` element No Presence of drain water heat recovery device [#]_ ==================================== ======= ============ =========== ======== ======== ===================== - .. [#] If PipingLength not provided, calculated using the following equation from `ANSI/RESNET/ICC 301-2019 `_: + .. [#] If PipingLength not provided, calculated using the following equation from `ANSI/RESNET/ICC 301-2022 `_: PipeL = 2.0 * (CFA / NCfl)^0.5 + 10.0 * NCfl + 5.0 * Bsmnt @@ -4473,7 +4473,7 @@ An in-unit recirculation hot water distribution system is entered as a ``/HPXML/ \- **no control**: The pump runs continuously. - .. [#] If RecirculationPipingLoopLength not provided, calculated using the following equation from `ANSI/RESNET/ICC 301-2019 `_: + .. [#] If RecirculationPipingLoopLength not provided, calculated using the following equation from `ANSI/RESNET/ICC 301-2022 `_: RecircPipeL = 2.0 * (2.0 * (CFA / NCfl)^0.5 + 10.0 * NCfl + 5.0 * Bsmnt) - 20.0 @@ -4487,7 +4487,7 @@ An in-unit recirculation hot water distribution system is entered as a ``/HPXML/ .. [#] RecirculationPipingLoopLength is the recirculation loop length including both supply and return sides, measured longitudinally from plans, assuming the hot water piping does not run diagonally, plus 20 feet of piping for each floor level greater than one plus 10 feet of piping for unconditioned basements. .. [#] BranchPipingLength is the length of the branch hot water piping from the recirculation loop to the farthest hot water fixture from the recirculation loop, measured longitudinally from plans, assuming the branch hot water piping does not run diagonally. - .. [#] PumpPower default based on `ANSI/RESNET/ICC 301-2019 `_. + .. [#] PumpPower default based on `ANSI/RESNET/ICC 301-2022 `_. .. [#] Additional drain water heat recovery inputs are described in :ref:`water_heater_dwhr`. .. [#] If RecirculationPumpWeekdayScheduleFractions or RecirculationPumpWeekendScheduleFractions not provided (and :ref:`schedules_detailed` not used), then :ref:`schedules_default` are used. .. [#] If RecirculationPumpMonthlyScheduleMultipliers not provided (and :ref:`schedules_detailed` not used), then :ref:`schedules_default` are used. @@ -4515,7 +4515,7 @@ A shared recirculation hot water distribution system (serving multiple dwelling ``extension/RecirculationPumpMonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated recirculation pump monthly multipliers ========================================================= ======= ============ =================== ======== ======== ===================== - .. [#] If PipingLength not provided, calculated using the following equation from `ANSI/RESNET/ICC 301-2019 `_: + .. [#] If PipingLength not provided, calculated using the following equation from `ANSI/RESNET/ICC 301-2022 `_: PipeL = 2.0 * (CFA / NCfl)^0.5 + 10.0 * NCfl + 5.0 * Bsmnt @@ -4531,7 +4531,7 @@ A shared recirculation hot water distribution system (serving multiple dwelling .. [#] Additional drain water heat recovery inputs are described in :ref:`water_heater_dwhr`. .. [#] Recirculation pump energy will be apportioned to the dwelling unit using its number of bedrooms divided by the total number of bedrooms served by the recirculation system per `ANSI/RESNET/ICC 301-2022 `_. Each dwelling unit w/zero bedrooms should be counted as 1 bedroom -- e.g., a value of 3 should be entered for a shared system serving 3 studio (zero bedroom) apartments. - .. [#] PumpPower default based on `ANSI/RESNET/ICC 301-2019 `_. + .. [#] PumpPower default based on `ANSI/RESNET/ICC 301-2022 `_. .. [#] ControlType choices are "manual demand control", "presence sensor demand control", "temperature", "timer", or "no control". \- **manual demand control**: The pump only runs when a user presses a button indicating they are about to use hot water. @@ -4572,7 +4572,7 @@ If a drain water heat recovery (DWHR) device is specified, additional informatio Use "all" if there is one shower and it's connected to the DWHR or there are two or more showers connected to the DWHR. .. [#] EqualFlow should be true if the DWHR supplies pre-heated water to both the fixture cold water piping *and* the hot water heater potable supply piping. -Drain water heat recovery is modeled according to the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2019 `_. +Drain water heat recovery is modeled according to the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2022 `_. HPXML Water Fixtures ******************** @@ -4608,7 +4608,7 @@ Additional information can be entered in ``/HPXML/Building/BuildingDetails/Syste .. [#] If WaterFixturesWeekdayScheduleFractions or WaterFixturesWeekendScheduleFractions not provided (and :ref:`schedules_detailed` not used), then :ref:`schedules_default` are used. .. [#] If WaterFixturesMonthlyScheduleMultipliers not provided (and :ref:`schedules_detailed` not used), then :ref:`schedules_default` are used. -Water fixture hot water use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2019 `_, including RESNET HERS Addenda 81 and 90f. +Water fixture hot water use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2022 `_, including `RESNET HERS Addendum 81 `_ and `RESNET HERS Addendum 90f `_. If NumberofResidents is provided, then water fixture use from Equation 14 of `Estimating Daily Domestic Hot-Water Use in North American Homes `_ is substituted into the ANSI/RESNET/ICC 301 equations. HPXML Solar Thermal @@ -4738,7 +4738,7 @@ Many of the inputs are adopted from the `PVWatts model `_. + PV generation will be apportioned to the dwelling unit using its number of bedrooms divided by the total number of bedrooms served by the PV system per `ANSI/RESNET/ICC 301-2022 `_. HPXML Inverters ~~~~~~~~~~~~~~~ @@ -4968,7 +4968,7 @@ If not entered, the simulation will not include batteries. .. [#] If UsableCapacity not provided, defaults to 0.9 * NominalCapacity. .. [#] If RatedPowerOutput not provided, defaults to 0.5 * NominalCapacity * 1000. .. [#] NumberofBedroomsServed only required if IsSharedSystem is true. - Battery charging/discharging will be apportioned to the dwelling unit using its number of bedrooms divided by the total number of bedrooms served by the battery per ANSI/RESNET/ICC 301-2022 Addendum C. + Battery charging/discharging will be apportioned to the dwelling unit using its number of bedrooms divided by the total number of bedrooms served by the battery per `ANSI/RESNET/ICC 301-2022 Addendum C `_. .. note:: @@ -5069,7 +5069,7 @@ If not entered, the simulation will not include generators. .. [#] FuelType choices are "natural gas", "fuel oil", "fuel oil 1", "fuel oil 2", "fuel oil 4", "fuel oil 5/6", "diesel", "propane", "kerosene", "coal", "coke", "bituminous coal", "anthracite coal", "wood", or "wood pellets". .. [#] AnnualOutputkWh must also be < AnnualConsumptionkBtu*3.412 (i.e., the generator must consume more energy than it produces). .. [#] NumberofBedroomsServed only required if IsSharedSystem is true. - Annual consumption and annual production will be apportioned to the dwelling unit using its number of bedrooms divided by the total number of bedrooms served by the generator per `ANSI/RESNET/ICC 301-2019 `_. + Annual consumption and annual production will be apportioned to the dwelling unit using its number of bedrooms divided by the total number of bedrooms served by the generator per `ANSI/RESNET/ICC 301-2022 `_. .. note:: @@ -5132,7 +5132,7 @@ If IntegratedModifiedEnergyFactor or ModifiedEnergyFactor is provided, a complet ``Capacity`` double ft3 > 0 Yes Clothes washer volume ================================ ======= ======= =========== ============ ======= ==================================== -Clothes washer energy use and hot water use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2019 Addendum A `_, including RESNET HERS Addenda 81 and 90f. +Clothes washer energy use and hot water use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2022 `_, including `RESNET HERS Addendum 81 `_ and `RESNET HERS Addendum 90f `_. If NumberofResidents is provided, then the number of cycles from Equation 1 of `Estimating Daily Domestic Hot-Water Use in North American Homes `_ is substituted into the ANSI/RESNET/ICC 301 equations. HPXML Clothes Dryer @@ -5173,7 +5173,7 @@ If not entered, the simulation will not include a clothes dryer. .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided (and :ref:`schedules_detailed` not used), then :ref:`schedules_default` are used. .. [#] If MonthlyScheduleMultipliers not provided (and :ref:`schedules_detailed` not used), then :ref:`schedules_default` are used. -Clothes dryer energy use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2019 Addendum A `_, including RESNET HERS Addenda 81 and 90f. +Clothes dryer energy use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2022 `_, including `RESNET HERS Addendum 81 `_ and `RESNET HERS Addendum 90f `_. HPXML Dishwasher **************** @@ -5224,7 +5224,7 @@ If the RatedAnnualkWh or EnergyFactor is provided, a complete set of EnergyGuide ``LabelUsage`` double cyc/wk > 0 Yes EnergyGuide label number of cycles ======================== ======= ======= =========== ======== ======= ================================== -Dishwasher energy use and hot water use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2019 Addendum A `_, including RESNET HERS Addenda 81 and 90f. +Dishwasher energy use and hot water use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2022 `_, including `RESNET HERS Addendum 81 `_ and `RESNET HERS Addendum 90f `_. If NumberofResidents is provided, then the number of cycles from Equation 3 of `Estimating Daily Domestic Hot-Water Use in North American Homes `_ is substituted into the ANSI/RESNET/ICC 301 equations. HPXML Refrigerators @@ -5252,7 +5252,7 @@ If not entered, the simulation will not include a refrigerator. See :ref:`hpxml_locations` for descriptions. .. [#] If Location not provided and is the *primary* refrigerator, defaults to "conditioned space". If Location not provided and is a *secondary* refrigerator, defaults to the first present space type: "garage", "basement - unconditioned", "basement - conditioned", or "conditioned space". - .. [#] If RatedAnnualkWh not provided, it will be defaulted to represent a standard refrigerator from 2006 using the following equation based on `ANSI/RESNET/ICC 301-2019 `_: + .. [#] If RatedAnnualkWh not provided, it will be defaulted to represent a standard refrigerator from 2006 using the following equation based on `ANSI/RESNET/ICC 301-2022 `_: RatedAnnualkWh = 637.0 + 18.0 * NumberofBedrooms. .. [#] If multiple refrigerators are specified, there must be exactly one refrigerator described with PrimaryIndicator=true. .. [#] Either schedule fraction inputs (WeekdayScheduleFractions/WeekendScheduleFractions/MonthlyScheduleMultipliers) or schedule coefficient inputs (ConstantScheduleCoefficients/TemperatureScheduleCoefficients) may be used, but not both. @@ -5263,7 +5263,7 @@ If not entered, the simulation will not include a refrigerator. .. note:: - Refrigerator energy use is affected by its ambient temperature when ConstantScheduleCoefficients and TemperatureScheduleCoefficients are used, in which case hourly energy for refrigerators is determined following Equation 4.2-X2 of ANSI/RESNET/ICC 301-2022 Addendum C: + Refrigerator energy use is affected by its ambient temperature when ConstantScheduleCoefficients and TemperatureScheduleCoefficients are used, in which case hourly energy for refrigerators is determined following Equation 4.2-X2 of `ANSI/RESNET/ICC 301-2022 Addendum C `_: ((RatedAnnualkWh / 8760) * (ConstantScheduleCoefficients[hr] + TemperatureScheduleCoefficients[hr] * T_space) @@ -5299,7 +5299,7 @@ If not entered, the simulation will not include a standalone freezer. .. note:: - Freezer energy use is affected by its ambient temperature when ConstantScheduleCoefficients and TemperatureScheduleCoefficients are used, in which case hourly energy for freezers is determined following Equation 4.2-X2 of ANSI/RESNET/ICC 301-2022 Addendum C: + Freezer energy use is affected by its ambient temperature when ConstantScheduleCoefficients and TemperatureScheduleCoefficients are used, in which case hourly energy for freezers is determined following Equation 4.2-X2 of `ANSI/RESNET/ICC 301-2022 Addendum C `_: ((RatedAnnualkWh / 8760) * (ConstantScheduleCoefficients[hr] + TemperatureScheduleCoefficients[hr] * T_space) @@ -5370,7 +5370,7 @@ If a cooking range is specified, a single oven is also entered as a ``/HPXML/Bui ``IsConvection`` boolean No false Convection oven? ==================== ======= ====== =========== ======== ======= ================ -Cooking range/oven energy use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2019 `_. +Cooking range/oven energy use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2022 `_. If NumberofResidents provided, this will be adjusted using the equations from RECS in :ref:`building_occupancy`. HPXML Lighting & Ceiling Fans @@ -5437,7 +5437,7 @@ If specifying lighting type fractions, three ``/HPXML/Building/BuildingDetails/L .. [#] The sum of FractionofUnitsInLocation for a given Location (e.g., interior) must be less than or equal to 1. If the fractions sum to less than 1, the remainder is assumed to be incandescent lighting. - Interior, exterior, and garage lighting energy use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2019 `_. + Interior, exterior, and garage lighting energy use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2022 `_. If NumberofResidents is provided and zero (i.e., the dwelling unit is unoccupied), no lighting energy use will be modeled. .. _lighting_annual_energy: @@ -5495,13 +5495,13 @@ If not entered, the simulation will not include a ceiling fan. ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers ============================================================================= ======= ========== =========== ======== ======== ============================== - .. [#] If Efficiency and LabelEnergyUse not provided, LabelEnergyUse defaults to 42.6 W based on ANSI/RESNET/ICC 301-2022 Addendum C. + .. [#] If Efficiency and LabelEnergyUse not provided, LabelEnergyUse defaults to 42.6 W based on `ANSI/RESNET/ICC 301-2022 `_. If both are provided, LabelEnergyUse will be used in the model. - .. [#] If Count not provided, defaults to NumberofBedrooms + 1 based on `ANSI/RESNET/ICC 301-2019 `_. + .. [#] If Count not provided, defaults to NumberofBedrooms + 1 based on `ANSI/RESNET/ICC 301-2022 `_. .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided (and :ref:`schedules_detailed` not used), then :ref:`schedules_default` are used. - .. [#] If MonthlyScheduleMultipliers not provided (and :ref:`schedules_detailed` not used), defaults based on monthly average outdoor temperatures per `ANSI/RESNET/ICC 301-2019 `_ + .. [#] If MonthlyScheduleMultipliers not provided (and :ref:`schedules_detailed` not used), defaults based on monthly average outdoor temperatures per `ANSI/RESNET/ICC 301-2022 `_ -Ceiling fan energy use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2019 `_. +Ceiling fan energy use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2022 `_. .. note:: @@ -5703,9 +5703,9 @@ If not entered, the simulation will not include that type of plug load. .. [#] PlugLoadType choices are "other", "TV other", "well pump", or "electric vehicle charging". .. [#] If Value not provided, defaults as follows when NumberofResidents is not provided: - \- **other**: 0.91 * ConditionedFloorArea (based on `ANSI/RESNET/ICC 301-2019 `_) + \- **other**: 0.91 * ConditionedFloorArea (based on `ANSI/RESNET/ICC 301-2022 `_) - \- **TV other**: 413.0 + 69.0 * NumberofBedrooms (based on `ANSI/RESNET/ICC 301-2019 `_) + \- **TV other**: 413.0 + 69.0 * NumberofBedrooms (based on `ANSI/RESNET/ICC 301-2022 `_) \- **well pump**: 50.8 / 0.127 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920) (based on the `2010 BAHSP `_)