Skip to content
Open
Show file tree
Hide file tree
Changes from 18 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions BuildResidentialHPXML/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -1726,7 +1726,7 @@ Select an advanced research feature to use in the model, if desired.

- **Required:** ``false``

- **Choices:** <br/> - `None`<br/> - `Temperature Capacitance Multiplier, 1`<br/> - `Temperature Capacitance Multiplier, 4`<br/> - `Temperature Capacitance Multiplier, 10`<br/> - `Temperature Capacitance Multiplier, 15`<br/> - `On/Off Thermostat Deadband, 1F`<br/> - `On/Off Thermostat Deadband, 2F`<br/> - `On/Off Thermostat Deadband, 3F`<br/> - `Heat Pump Backup Staging, 5 kW`<br/> - `Heat Pump Backup Staging, 10 kW`<br/> - `Experimental Ground-to-Air Heat Pump Model`<br/> - `HVAC Allow Increased Fixed Capacities`
- **Choices:** <br/> - `None`<br/> - `Temperature Capacitance Multiplier, 1`<br/> - `Temperature Capacitance Multiplier, 4`<br/> - `Temperature Capacitance Multiplier, 10`<br/> - `Temperature Capacitance Multiplier, 15`<br/> - `On/Off Thermostat Deadband, 1F`<br/> - `On/Off Thermostat Deadband, 2F`<br/> - `On/Off Thermostat Deadband, 3F`<br/> - `Latent Degradation Model w/ Blower-Off Delay, 0 sec`<br/> - `Latent Degradation Model w/ Blower-Off Delay, 45 sec`<br/> - `Latent Degradation Model w/ Blower-Off Delay, 90 sec`<br/> - `Heat Pump Backup Staging, 5 kW`<br/> - `Heat Pump Backup Staging, 10 kW`<br/> - `Experimental Ground-to-Air Heat Pump Model`<br/> - `HVAC Allow Increased Fixed Capacities`


- **Default:** `None`
Expand All @@ -1741,7 +1741,7 @@ Select a second advanced research feature to use in the model, if desired.

- **Required:** ``false``

- **Choices:** <br/> - `None`<br/> - `Temperature Capacitance Multiplier, 1`<br/> - `Temperature Capacitance Multiplier, 4`<br/> - `Temperature Capacitance Multiplier, 10`<br/> - `Temperature Capacitance Multiplier, 15`<br/> - `On/Off Thermostat Deadband, 1F`<br/> - `On/Off Thermostat Deadband, 2F`<br/> - `On/Off Thermostat Deadband, 3F`<br/> - `Heat Pump Backup Staging, 5 kW`<br/> - `Heat Pump Backup Staging, 10 kW`<br/> - `Experimental Ground-to-Air Heat Pump Model`<br/> - `HVAC Allow Increased Fixed Capacities`
- **Choices:** <br/> - `None`<br/> - `Temperature Capacitance Multiplier, 1`<br/> - `Temperature Capacitance Multiplier, 4`<br/> - `Temperature Capacitance Multiplier, 10`<br/> - `Temperature Capacitance Multiplier, 15`<br/> - `On/Off Thermostat Deadband, 1F`<br/> - `On/Off Thermostat Deadband, 2F`<br/> - `On/Off Thermostat Deadband, 3F`<br/> - `Latent Degradation Model w/ Blower-Off Delay, 0 sec`<br/> - `Latent Degradation Model w/ Blower-Off Delay, 45 sec`<br/> - `Latent Degradation Model w/ Blower-Off Delay, 90 sec`<br/> - `Heat Pump Backup Staging, 5 kW`<br/> - `Heat Pump Backup Staging, 10 kW`<br/> - `Experimental Ground-to-Air Heat Pump Model`<br/> - `HVAC Allow Increased Fixed Capacities`


- **Default:** `None`
Expand Down
10 changes: 10 additions & 0 deletions BuildResidentialHPXML/measure.rb
Original file line number Diff line number Diff line change
Expand Up @@ -1337,6 +1337,16 @@ def set_header(runner, hpxml, args)
hpxml.header.hvac_onoff_thermostat_deadband = onoff_db
end

hvac_bod = args[:advanced_feature_hvac_blower_off_delay]
hvac_bod = args[:advanced_feature_2_hvac_blower_off_delay] if hvac_bod.nil?
if not hvac_bod.nil?
if (not hpxml.header.latent_degradation_model_blower_off_delay.nil?) && (hpxml.header.latent_degradation_model_blower_off_delay != hvac_bod)
errors << "Advanced feature 'HVAC Blower-Off Delay' cannot vary across dwelling units."
end
hpxml.header.latent_degradation_model_blower_off_delay = hvac_bod
hpxml.header.latent_degradation_model_enabled = true
end

hpbak = args[:advanced_feature_heat_pump_backup_capacity_increment]
hpbak = args[:advanced_feature_2_heat_pump_backup_capacity_increment] if hpbak.nil?
if not hpbak.nil?
Expand Down
36 changes: 30 additions & 6 deletions BuildResidentialHPXML/measure.xml
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@
<schema_version>3.1</schema_version>
<name>build_residential_hpxml</name>
<uid>a13a8983-2b01-4930-8af2-42030b6e4233</uid>
<version_id>a388db27-a2f7-4811-8d2e-95ba875a8820</version_id>
<version_modified>2026-04-02T19:43:52Z</version_modified>
<version_id>a5100732-58ee-47a2-8655-cbd3b2e4a4bd</version_id>
<version_modified>2026-04-13T14:50:45Z</version_modified>
<xml_checksum>2C38F48B</xml_checksum>
<class_name>BuildResidentialHPXML</class_name>
<display_name>HPXML Builder</display_name>
Expand Down Expand Up @@ -11081,6 +11081,18 @@
<value>On/Off Thermostat Deadband, 3F</value>
<display_name>On/Off Thermostat Deadband, 3F</display_name>
</choice>
<choice>
<value>Latent Degradation Model w/ Blower-Off Delay, 0 sec</value>
<display_name>Latent Degradation Model w/ Blower-Off Delay, 0 sec</display_name>
</choice>
<choice>
<value>Latent Degradation Model w/ Blower-Off Delay, 45 sec</value>
<display_name>Latent Degradation Model w/ Blower-Off Delay, 45 sec</display_name>
</choice>
<choice>
<value>Latent Degradation Model w/ Blower-Off Delay, 90 sec</value>
<display_name>Latent Degradation Model w/ Blower-Off Delay, 90 sec</display_name>
</choice>
<choice>
<value>Heat Pump Backup Staging, 5 kW</value>
<display_name>Heat Pump Backup Staging, 5 kW</display_name>
Expand Down Expand Up @@ -11140,6 +11152,18 @@
<value>On/Off Thermostat Deadband, 3F</value>
<display_name>On/Off Thermostat Deadband, 3F</display_name>
</choice>
<choice>
<value>Latent Degradation Model w/ Blower-Off Delay, 0 sec</value>
<display_name>Latent Degradation Model w/ Blower-Off Delay, 0 sec</display_name>
</choice>
<choice>
<value>Latent Degradation Model w/ Blower-Off Delay, 45 sec</value>
<display_name>Latent Degradation Model w/ Blower-Off Delay, 45 sec</display_name>
</choice>
<choice>
<value>Latent Degradation Model w/ Blower-Off Delay, 90 sec</value>
<display_name>Latent Degradation Model w/ Blower-Off Delay, 90 sec</display_name>
</choice>
<choice>
<value>Heat Pump Backup Staging, 5 kW</value>
<display_name>Heat Pump Backup Staging, 5 kW</display_name>
Expand Down Expand Up @@ -11413,7 +11437,7 @@
<filename>README.md</filename>
<filetype>md</filetype>
<usage_type>readme</usage_type>
<checksum>9F136C7C</checksum>
<checksum>B9841315</checksum>
</file>
<file>
<filename>README.md.erb</filename>
Expand All @@ -11430,7 +11454,7 @@
<filename>measure.rb</filename>
<filetype>rb</filetype>
<usage_type>script</usage_type>
<checksum>73832BEA</checksum>
<checksum>4F3E18D4</checksum>
</file>
<file>
<filename>constants.rb</filename>
Expand All @@ -11448,13 +11472,13 @@
<filename>options/advanced_feature.tsv</filename>
<filetype>tsv</filetype>
<usage_type>resource</usage_type>
<checksum>E5849695</checksum>
<checksum>B3A4A22E</checksum>
</file>
<file>
<filename>options/advanced_feature_2.tsv</filename>
<filetype>tsv</filetype>
<usage_type>resource</usage_type>
<checksum>E5849695</checksum>
<checksum>B3A4A22E</checksum>
</file>
<file>
<filename>options/appliance_clothes_dryer.tsv</filename>
Expand Down
42 changes: 23 additions & 19 deletions BuildResidentialHPXML/resources/options/advanced_feature.tsv
Original file line number Diff line number Diff line change
@@ -1,19 +1,23 @@
Option Name Temperature Capacitance Multiplier HVAC On-Off Thermostat Deadband Temperature [F] Heat Pump Backup Capacity Increment [Btu/hr] Ground-to-Air Heat Pump Model Type HVAC Allow Increased Fixed Capacities
None
"Temperature Capacitance Multiplier, 1" 1
"Temperature Capacitance Multiplier, 4" 4
"Temperature Capacitance Multiplier, 10" 10
"Temperature Capacitance Multiplier, 15" 15
"On/Off Thermostat Deadband, 1F" 1
"On/Off Thermostat Deadband, 2F" 2
"On/Off Thermostat Deadband, 3F" 3
"Heat Pump Backup Staging, 5 kW" 17060.71
"Heat Pump Backup Staging, 10 kW" 34121.42
Experimental Ground-to-Air Heat Pump Model experimental
HVAC Allow Increased Fixed Capacities TRUE

# Temperature Capacitance Multiplier: Multiplier on air heat capacitance. Affects the transient calculation of indoor air temperatures. Values greater than 1.0 have the effect of smoothing or damping the rate of change in the indoor air temperature from timestep to timestep.
# HVAC On-Off Thermostat Deadband Temperature: Temperature difference between cut-in and cut-out temperature for HVAC operation. Requires 1-minute timesteps.
# Heat Pump Backup Capacity Increment: Capacity increment of multi-stage heat pump backup systems.
# Ground-to-Air Heat Pump Model Type: Ground-to-air heat pump system model type.
"# HVAC Allow Increased Fixed Capacities: If 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."
Option Name Temperature Capacitance Multiplier HVAC On-Off Thermostat Deadband Temperature [F] HVAC Blower-Off Delay [sec] Heat Pump Backup Capacity Increment [Btu/hr] Ground-to-Air Heat Pump Model Type HVAC Allow Increased Fixed Capacities
None
"Temperature Capacitance Multiplier, 1" 1
"Temperature Capacitance Multiplier, 4" 4
"Temperature Capacitance Multiplier, 10" 10
"Temperature Capacitance Multiplier, 15" 15
"On/Off Thermostat Deadband, 1F" 1
"On/Off Thermostat Deadband, 2F" 2
"On/Off Thermostat Deadband, 3F" 3
"Latent Degradation Model w/ Blower-Off Delay, 0 sec" 0
"Latent Degradation Model w/ Blower-Off Delay, 45 sec" 45
"Latent Degradation Model w/ Blower-Off Delay, 90 sec" 90
Comment on lines +10 to +12
Copy link
Copy Markdown
Contributor Author

@shorowit shorowit Apr 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added three "advanced feature" options for the BuildResidentialHPXML measure.

"Heat Pump Backup Staging, 5 kW" 17060.71
"Heat Pump Backup Staging, 10 kW" 34121.42
Experimental Ground-to-Air Heat Pump Model experimental
HVAC Allow Increased Fixed Capacities TRUE

# Temperature Capacitance Multiplier: Multiplier on air heat capacitance. Affects the transient calculation of indoor air temperatures. Values greater than 1.0 have the effect of smoothing or damping the rate of change in the indoor air temperature from timestep to timestep.
# HVAC On-Off Thermostat Deadband Temperature: Temperature difference between cut-in and cut-out temperature for HVAC operation. Requires 1-minute timesteps.
# HVAC Blower-Off Delay: Time that the HVAC fan runs after the end of a cooling cycle. This increases the overall efficiency of the cooling system but also introduces humidity back into the home.
# Heat Pump Backup Capacity Increment: Capacity increment of multi-stage heat pump backup systems.
# Ground-to-Air Heat Pump Model Type: Ground-to-air heat pump system model type.
"# HVAC Allow Increased Fixed Capacities: If 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."
42 changes: 23 additions & 19 deletions BuildResidentialHPXML/resources/options/advanced_feature_2.tsv
Original file line number Diff line number Diff line change
@@ -1,19 +1,23 @@
Option Name Temperature Capacitance Multiplier HVAC On-Off Thermostat Deadband Temperature [F] Heat Pump Backup Capacity Increment [Btu/hr] Ground-to-Air Heat Pump Model Type HVAC Allow Increased Fixed Capacities
None
"Temperature Capacitance Multiplier, 1" 1
"Temperature Capacitance Multiplier, 4" 4
"Temperature Capacitance Multiplier, 10" 10
"Temperature Capacitance Multiplier, 15" 15
"On/Off Thermostat Deadband, 1F" 1
"On/Off Thermostat Deadband, 2F" 2
"On/Off Thermostat Deadband, 3F" 3
"Heat Pump Backup Staging, 5 kW" 17060.71
"Heat Pump Backup Staging, 10 kW" 34121.42
Experimental Ground-to-Air Heat Pump Model experimental
HVAC Allow Increased Fixed Capacities TRUE

# Temperature Capacitance Multiplier: Multiplier on air heat capacitance. Affects the transient calculation of indoor air temperatures. Values greater than 1.0 have the effect of smoothing or damping the rate of change in the indoor air temperature from timestep to timestep.
# HVAC On-Off Thermostat Deadband Temperature: Temperature difference between cut-in and cut-out temperature for HVAC operation. Requires 1-minute timesteps.
# Heat Pump Backup Capacity Increment: Capacity increment of multi-stage heat pump backup systems.
# Ground-to-Air Heat Pump Model Type: Ground-to-air heat pump system model type.
"# HVAC Allow Increased Fixed Capacities: If 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."
Option Name Temperature Capacitance Multiplier HVAC On-Off Thermostat Deadband Temperature [F] HVAC Blower-Off Delay [sec] Heat Pump Backup Capacity Increment [Btu/hr] Ground-to-Air Heat Pump Model Type HVAC Allow Increased Fixed Capacities
None
"Temperature Capacitance Multiplier, 1" 1
"Temperature Capacitance Multiplier, 4" 4
"Temperature Capacitance Multiplier, 10" 10
"Temperature Capacitance Multiplier, 15" 15
"On/Off Thermostat Deadband, 1F" 1
"On/Off Thermostat Deadband, 2F" 2
"On/Off Thermostat Deadband, 3F" 3
"Latent Degradation Model w/ Blower-Off Delay, 0 sec" 0
"Latent Degradation Model w/ Blower-Off Delay, 45 sec" 45
"Latent Degradation Model w/ Blower-Off Delay, 90 sec" 90
"Heat Pump Backup Staging, 5 kW" 17060.71
"Heat Pump Backup Staging, 10 kW" 34121.42
Experimental Ground-to-Air Heat Pump Model experimental
HVAC Allow Increased Fixed Capacities TRUE

# Temperature Capacitance Multiplier: Multiplier on air heat capacitance. Affects the transient calculation of indoor air temperatures. Values greater than 1.0 have the effect of smoothing or damping the rate of change in the indoor air temperature from timestep to timestep.
# HVAC On-Off Thermostat Deadband Temperature: Temperature difference between cut-in and cut-out temperature for HVAC operation. Requires 1-minute timesteps.
# HVAC Blower-Off Delay: Time that the HVAC fan runs after the end of a cooling cycle. This increases the overall efficiency of the cooling system but also introduces humidity back into the home.
# Heat Pump Backup Capacity Increment: Capacity increment of multi-stage heat pump backup systems.
# Ground-to-Air Heat Pump Model Type: Ground-to-air heat pump system model type.
"# HVAC Allow Increased Fixed Capacities: If 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."
1 change: 1 addition & 0 deletions Changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ __New Features__
- HVAC updates:
- Dual-fuel heat pumps with switchover temperatures > 25F are now autosized based on 25F to allow some additional heating capacity buffer.
- Improves handling of duct leakage specified using cfm25/cfm50.
- Adds advanced research feature for latent degradation model, including an input to specify an HVAC blower-off delay.
- Allows "other" for `SoilType`; adds variation to dry/wet soil conductivity and diffusivity values for unknown/other/loam soil types.
- Output updates:
- **Breaking change**: Annual peak load outputs for heating and cooling now use units of Btu/h instead of kBtu/h for consistency with other outputs.
Expand Down
34 changes: 17 additions & 17 deletions HPXMLtoOpenStudio/measure.xml
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@
<schema_version>3.1</schema_version>
<name>hpxm_lto_openstudio</name>
<uid>b1543b30-9465-45ff-ba04-1d1f85e763bc</uid>
<version_id>15c39750-5947-45ef-887d-47606442ed57</version_id>
<version_modified>2026-04-02T19:46:00Z</version_modified>
<version_id>902d5bac-29da-455f-bdf8-f2ab988890e1</version_id>
<version_modified>2026-04-13T14:50:51Z</version_modified>
<xml_checksum>D8922A73</xml_checksum>
<class_name>HPXMLtoOpenStudio</class_name>
<display_name>HPXML to OpenStudio Translator</display_name>
Expand Down Expand Up @@ -217,13 +217,13 @@
<filename>airflow.rb</filename>
<filetype>rb</filetype>
<usage_type>resource</usage_type>
<checksum>2F17E22A</checksum>
<checksum>08A1E217</checksum>
</file>
<file>
<filename>battery.rb</filename>
<filetype>rb</filetype>
<usage_type>resource</usage_type>
<checksum>E058674B</checksum>
<checksum>E49D3A84</checksum>
</file>
<file>
<filename>calendar.rb</filename>
Expand All @@ -235,7 +235,7 @@
<filename>constants.rb</filename>
<filetype>rb</filetype>
<usage_type>resource</usage_type>
<checksum>6430B8D3</checksum>
<checksum>5EF534B8</checksum>
</file>
<file>
<filename>constructions.rb</filename>
Expand Down Expand Up @@ -367,7 +367,7 @@
<filename>defaults.rb</filename>
<filetype>rb</filetype>
<usage_type>resource</usage_type>
<checksum>F91B9101</checksum>
<checksum>7C57F239</checksum>
</file>
<file>
<filename>electric_panel.rb</filename>
Expand Down Expand Up @@ -403,7 +403,7 @@
<filename>hpxml.rb</filename>
<filetype>rb</filetype>
<usage_type>resource</usage_type>
<checksum>BF5902DA</checksum>
<checksum>A8A9DC80</checksum>
</file>
<file>
<filename>hpxml_schema/HPXML.xsd</filename>
Expand All @@ -421,7 +421,7 @@
<filename>hpxml_schematron/EPvalidator.sch</filename>
<filetype>sch</filetype>
<usage_type>resource</usage_type>
<checksum>9B5934A8</checksum>
<checksum>43C0728B</checksum>
</file>
<file>
<filename>hpxml_schematron/iso-schematron.xsd</filename>
Expand All @@ -433,19 +433,19 @@
<filename>hvac.rb</filename>
<filetype>rb</filetype>
<usage_type>resource</usage_type>
<checksum>86BE60D7</checksum>
<checksum>B71D1069</checksum>
</file>
<file>
<filename>hvac_sizing.rb</filename>
<filetype>rb</filetype>
<usage_type>resource</usage_type>
<checksum>A5C3D289</checksum>
<checksum>02820BCC</checksum>
</file>
<file>
<filename>internal_gains.rb</filename>
<filetype>rb</filetype>
<usage_type>resource</usage_type>
<checksum>D8FFFC3A</checksum>
<checksum>CD7FA760</checksum>
</file>
<file>
<filename>lighting.rb</filename>
Expand Down Expand Up @@ -493,13 +493,13 @@
<filename>model.rb</filename>
<filetype>rb</filetype>
<usage_type>resource</usage_type>
<checksum>A41E8C73</checksum>
<checksum>E80D049D</checksum>
</file>
<file>
<filename>output.rb</filename>
<filetype>rb</filetype>
<usage_type>resource</usage_type>
<checksum>7F8E008D</checksum>
<checksum>4F98F5CE</checksum>
</file>
<file>
<filename>psychrometrics.rb</filename>
Expand Down Expand Up @@ -715,7 +715,7 @@
<filename>waterheater.rb</filename>
<filetype>rb</filetype>
<usage_type>resource</usage_type>
<checksum>096F8A5F</checksum>
<checksum>24B2A2DB</checksum>
</file>
<file>
<filename>weather.rb</filename>
Expand Down Expand Up @@ -751,7 +751,7 @@
<filename>test_defaults.rb</filename>
<filetype>rb</filetype>
<usage_type>test</usage_type>
<checksum>989C355A</checksum>
<checksum>464440F3</checksum>
</file>
<file>
<filename>test_electric_panel.rb</filename>
Expand Down Expand Up @@ -781,7 +781,7 @@
<filename>test_hvac.rb</filename>
<filetype>rb</filetype>
<usage_type>test</usage_type>
<checksum>542405D7</checksum>
<checksum>F9CB3527</checksum>
</file>
<file>
<filename>test_hvac_sizing.rb</filename>
Expand Down Expand Up @@ -829,7 +829,7 @@
<filename>test_validation.rb</filename>
<filetype>rb</filetype>
<usage_type>test</usage_type>
<checksum>5146716A</checksum>
<checksum>560591E8</checksum>
</file>
<file>
<filename>test_vehicle.rb</filename>
Expand Down
Loading