Skip to content

Commit c1f802a

Browse files
joseph-robertsonjoseph-robertson
committed
Update the docs.
1 parent 8e27f7c commit c1f802a

File tree

3 files changed

+16
-12
lines changed

3 files changed

+16
-12
lines changed

‎HPXMLtoOpenStudio/measure.xml

+3-3
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@
33
<schema_version>3.1</schema_version>
44
<name>hpxm_lto_openstudio</name>
55
<uid>b1543b30-9465-45ff-ba04-1d1f85e763bc</uid>
6-
<version_id>bbae7f1a-0062-44da-ab99-8b324164259d</version_id>
7-
<version_modified>2023-11-30T17:45:43Z</version_modified>
6+
<version_id>48f64f49-2808-48e0-b993-4f0cf62cf607</version_id>
7+
<version_modified>2023-11-30T18:08:06Z</version_modified>
88
<xml_checksum>D8922A73</xml_checksum>
99
<class_name>HPXMLtoOpenStudio</class_name>
1010
<display_name>HPXML to OpenStudio Translator</display_name>
@@ -298,7 +298,7 @@
298298
<filename>hvac_sizing.rb</filename>
299299
<filetype>rb</filetype>
300300
<usage_type>resource</usage_type>
301-
<checksum>3C5BDC5B</checksum>
301+
<checksum>70CCB359</checksum>
302302
</file>
303303
<file>
304304
<filename>lighting.rb</filename>

‎HPXMLtoOpenStudio/resources/hvac_sizing.rb

+2-2
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ def self.calculate(weather, hpxml_bldg, cfa, hvac_systems)
4949
apply_hvac_installation_quality(hvac_sizing_values, hvac_heating, hvac_cooling)
5050
apply_hvac_maximum_airflows(hvac_sizing_values, hvac_heating, hvac_cooling)
5151
apply_hvac_fixed_capacities(hvac_sizing_values, hvac_heating, hvac_cooling)
52-
apply_hvac_blower_fan_adjustments(hvac_sizing_values, hvac_heating, hvac_cooling)
52+
apply_hvac_blower_fan_adjustment(hvac_sizing_values, hvac_heating, hvac_cooling)
5353
apply_hvac_ground_loop(hvac_sizing_values, weather, hvac_cooling)
5454
apply_hvac_finalize_airflows(hvac_sizing_values, hvac_heating, hvac_cooling)
5555

@@ -1906,7 +1906,7 @@ def self.apply_hvac_maximum_airflows(hvac_sizing_values, hvac_heating, hvac_cool
19061906
end
19071907
end
19081908

1909-
def self.apply_hvac_blower_fan_adjustments(hvac_sizing_values, hvac_heating, hvac_cooling)
1909+
def self.apply_hvac_blower_fan_adjustment(hvac_sizing_values, hvac_heating, hvac_cooling)
19101910
'''
19111911
Fan W/cfm adjustment
19121912
'''

‎docs/source/workflow_inputs.rst

+11-7
Original file line numberDiff line numberDiff line change
@@ -607,19 +607,20 @@ HPXML HVAC Sizing Control
607607

608608
HVAC equipment sizing controls are entered in ``/HPXML/Building/BuildingDetails/BuildingSummary/extension/HVACSizingControl``.
609609

610-
================================= ======== ===== =========== ======== ======== ============================================
610+
================================= ======== ===== =========== ======== ======== =====================================================
611611
Element Type Units Constraints Required Default Description
612-
================================= ======== ===== =========== ======== ======== ============================================
612+
================================= ======== ===== =========== ======== ======== =====================================================
613613
``AllowIncreasedFixedCapacities`` boolean No false Logic for fixed capacity HVAC equipment [#]_
614614
``HeatPumpSizingMethodology`` string See [#]_ No HERS Logic for autosized heat pumps [#]_
615-
``UseMaximumAirflowRates`` boolean No false Logic for TODO
616-
================================= ======== ===== =========== ======== ======== ============================================
615+
``UseMaximumAirflowRates`` boolean No false Logic for defining maximum allowed airflow rates [#]_
616+
================================= ======== ===== =========== ======== ======== =====================================================
617617

618618
.. [#] If AllowIncreasedFixedCapacities is true, the larger of user-specified fixed capacity and design load will be used (to reduce potential for unmet loads); otherwise user-specified fixed capacity is used.
619619
.. [#] HeatPumpSizingMethodology choices are 'ACCA', 'HERS', or 'MaxLoad'.
620620
.. [#] If HeatPumpSizingMethodology is 'ACCA', autosized heat pumps have their nominal capacity sized per ACCA Manual J/S based on cooling design loads, with some oversizing allowances for larger heating design loads.
621621
If HeatPumpSizingMethodology is 'HERS', autosized heat pumps have their nominal capacity sized equal to the larger of heating/cooling design loads.
622622
If HeatPumpSizingMethodology is 'MaxLoad', autosized heat pumps have their nominal capacity sized based on the larger of heating/cooling design loads, while taking into account the heat pump's reduced capacity at the design temperature.
623+
.. [#] If UseMaximumAirflowRates is true, the smaller of user-specified airflow rates and design load will be used.
623624
624625
If any HVAC equipment is being autosized (i.e., capacities are not provided), additional inputs for ACCA Manual J can be entered in ``/HPXML/Building/BuildingDetails/BuildingSummary/extension/HVACSizingControl/ManualJInputs``.
625626

@@ -1901,9 +1902,9 @@ If an air-to-air heat pump is specified, additional information is entered in ``
19011902
``HeatingDetailedPerformanceData`` element No <none> Heating detailed performance data [#]_
19021903
``extension/HeatingCapacityRetention[Fraction | Temperature]`` double frac | F >= 0, < 1 | <= 17 No See [#]_ Heating output capacity retention at cold temperature [#]_
19031904
``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Blower fan efficiency at maximum fan speed
1904-
``extension/AdjustFanPowerWattsPerCFM`` boolean No false
1905-
``extension/HeatingAirflowCFM`` double cfm >= 0 No autosized
1906-
``extension/CoolingAirflowCFM`` double cfm >= 0 No autosized
1905+
``extension/AdjustFanPowerWattsPerCFM`` boolean No false Whether to adjust blower fan efficiency [#]_
1906+
``extension/HeatingAirflowCFM`` double cfm >= 0 No autosized Heating airflow rate [#]_
1907+
``extension/CoolingAirflowCFM`` double cfm >= 0 No autosized Cooling airflow rate [#]_
19071908
``extension/AirflowDefectRatio`` double frac -0.9 - 9 No 0.0 Deviation between design/installed airflows [#]_
19081909
``extension/ChargeDefectRatio`` double frac -0.9 - 9 No 0.0 Deviation between design/installed refrigerant charges [#]_
19091910
``extension/CrankcaseHeaterPowerWatts`` double W No 50.0 Crankcase heater power
@@ -1933,6 +1934,9 @@ If an air-to-air heat pump is specified, additional information is entered in ``
19331934
.. [#] The extension/HeatingCapacityRetention input is a more flexible alternative to HeatingCapacity17F, as it can apply to autosized systems and allows the heating capacity retention to be defined at a user-specified temperature (instead of 17F).
19341935
Either input approach can be used, but not both.
19351936
.. [#] If FanPowerWattsPerCFM not provided, defaulted to 0.5 W/cfm if HSPF <= 8.75, else 0.375 W/cfm.
1937+
.. [#] If AdjustFanPowerWattsPerCFM is true, adjust the blower fan W/cfm using provided HeatingAirflowCFM and CoolingAirflowCFM.
1938+
.. [#] HeatingAirflowCFM can either be the maximum allowed heating airflow rate when UseMaximumAirflowRates is true in :ref:`hvac_sizing_control`, or can be used for blower fan efficiency adjustment.
1939+
.. [#] CoolingAirflowCFM can either be the maximum allowed cooling airflow rate when UseMaximumAirflowRates is true in :ref:`hvac_sizing_control`, or can be used for blower fan efficiency adjustment.
19361940
.. [#] AirflowDefectRatio is defined as (InstalledAirflow - DesignAirflow) / DesignAirflow; a value of zero means no airflow defect.
19371941
See ANSI/RESNET/ACCA 310-2020 Standard for Grading the Installation of HVAC Systems for more information.
19381942
.. [#] ChargeDefectRatio is defined as (InstalledCharge - DesignCharge) / DesignCharge; a value of zero means no refrigerant charge defect.

0 commit comments

Comments
 (0)