urbanopt-cli 0.10.0 → 0.11.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (712) hide show
  1. checksums.yaml +4 -4
  2. data/.github/release.yml +24 -0
  3. data/.github/workflows/nightly_ci_build.yml +37 -33
  4. data/.gitignore +1 -0
  5. data/CHANGELOG.md +25 -0
  6. data/CMakeLists.txt +7 -7
  7. data/FindOpenStudioSDK.cmake +10 -10
  8. data/LICENSE.md +8 -35
  9. data/README.md +25 -10
  10. data/example_files/Gemfile +9 -9
  11. data/example_files/example_project_combined.json +6 -2
  12. data/example_files/example_project_with_ghe.json +859 -0
  13. data/example_files/mappers/Baseline.rb +39 -415
  14. data/example_files/mappers/ChilledWaterStorage.rb +1 -1
  15. data/example_files/mappers/CreateBar.rb +1 -1
  16. data/example_files/mappers/EvCharging.rb +1 -1
  17. data/example_files/mappers/FlexibleHotWater.rb +1 -1
  18. data/example_files/mappers/Floorspace.rb +1 -1
  19. data/example_files/mappers/HighEfficiency.rb +1 -1
  20. data/example_files/mappers/HighEfficiencyCreateBar.rb +1 -1
  21. data/example_files/mappers/HighEfficiencyFloorspace.rb +1 -1
  22. data/example_files/mappers/PeakHoursMelsShedding.rb +1 -1
  23. data/example_files/mappers/PeakHoursThermostatAdjust.rb +1 -1
  24. data/example_files/mappers/ThermalStorage.rb +1 -1
  25. data/example_files/mappers/base_workflow.osw +11 -4
  26. data/example_files/mappers/residential/template/util.rb +138 -0
  27. data/example_files/mappers/residential/util.rb +276 -0
  28. data/example_files/measures/BuildResidentialModel/measure.rb +118 -230
  29. data/example_files/measures/BuildResidentialModel/measure.xml +344 -233
  30. data/example_files/measures/BuildResidentialModel/resources/geometry.rb +7 -2
  31. data/example_files/measures/BuildResidentialModel/resources/unit_conversions.rb +5 -0
  32. data/example_files/measures/BuildResidentialModel/resources/util.rb +5 -0
  33. data/example_files/measures/BuildResidentialModel/tests/test_build_residential_model.rb +344 -0
  34. data/example_files/measures/BuildResidentialModel/tests/xml_building/17/feature1.xml +2112 -0
  35. data/example_files/measures/BuildResidentialModel/tests/xml_building/17/feature2.xml +2112 -0
  36. data/example_files/osm_building/7.osm +0 -2
  37. data/example_files/osm_building/8.osm +0 -2
  38. data/example_files/osm_building/9.osm +0 -2
  39. data/example_files/python_deps/dependencies.json +4 -3
  40. data/example_files/resources/hpxml-measures/.gitattributes +3 -0
  41. data/example_files/resources/hpxml-measures/.github/pull_request_template.md +2 -2
  42. data/example_files/resources/hpxml-measures/.github/workflows/add_to_project.yml +17 -0
  43. data/example_files/resources/hpxml-measures/.github/workflows/config.yml +37 -8
  44. data/example_files/resources/hpxml-measures/.gitignore +1 -0
  45. data/example_files/resources/hpxml-measures/.readthedocs.yml +6 -2
  46. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/README.md +5596 -0
  47. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/README.md.erb +41 -0
  48. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/measure.rb +1324 -1035
  49. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/measure.xml +325 -236
  50. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/resources/geometry.rb +119 -152
  51. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/{build_residential_hpxml_test.rb → test_build_residential_hpxml.rb} +225 -107
  52. data/example_files/resources/hpxml-measures/BuildResidentialScheduleFile/README.md +96 -0
  53. data/example_files/resources/hpxml-measures/BuildResidentialScheduleFile/README.md.erb +41 -0
  54. data/example_files/resources/hpxml-measures/BuildResidentialScheduleFile/measure.rb +73 -31
  55. data/example_files/resources/hpxml-measures/BuildResidentialScheduleFile/measure.xml +60 -40
  56. data/example_files/resources/hpxml-measures/BuildResidentialScheduleFile/resources/README.md +48 -23
  57. data/example_files/resources/hpxml-measures/BuildResidentialScheduleFile/resources/constants.rb +5 -0
  58. data/example_files/resources/hpxml-measures/BuildResidentialScheduleFile/resources/schedules.rb +6 -12
  59. data/example_files/resources/hpxml-measures/BuildResidentialScheduleFile/tests/{build_residential_schedule_file_test.rb → test_build_residential_schedule_file.rb} +162 -35
  60. data/example_files/resources/hpxml-measures/Changelog.md +57 -1
  61. data/example_files/resources/hpxml-measures/Gemfile +1 -1
  62. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/README.md +83 -0
  63. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/README.md.erb +41 -0
  64. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/measure.rb +1081 -878
  65. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/measure.xml +258 -204
  66. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/airflow.rb +205 -178
  67. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/battery.rb +43 -18
  68. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/constants.rb +37 -112
  69. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/constructions.rb +34 -73
  70. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data/Xing_okstate_0664D_13659_Table_A-3.csv +4165 -0
  71. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data/unavailable_periods.csv +2 -2
  72. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/energyplus.rb +5 -1
  73. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/generator.rb +13 -7
  74. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/geometry.rb +95 -42
  75. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/hotwater_appliances.rb +132 -108
  76. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/hpxml.rb +1695 -1267
  77. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/hpxml_defaults.rb +668 -589
  78. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/hpxml_schema/HPXML.xsd +304 -553
  79. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/hpxml_schematron/EPvalidator.xml +197 -112
  80. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/hvac.rb +1140 -1745
  81. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/hvac_sizing.rb +412 -325
  82. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/lighting.rb +56 -48
  83. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/location.rb +49 -38
  84. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/materials.rb +5 -0
  85. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/meta_measure.rb +17 -1
  86. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/minitest_helper.rb +5 -0
  87. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/misc_loads.rb +94 -78
  88. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/output.rb +60 -2
  89. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/psychrometrics.rb +6 -1
  90. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/pv.rb +11 -5
  91. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/schedule_files/occupancy-non-stochastic.csv +1 -1
  92. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/schedule_files/occupancy-stochastic-30-mins.csv +52561 -0
  93. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/schedule_files/occupancy-stochastic_2.csv +8761 -0
  94. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/schedule_files/occupancy-stochastic_3.csv +8761 -0
  95. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/schedule_files/occupancy-stochastic_4.csv +8761 -0
  96. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/schedule_files/occupancy-stochastic_5.csv +8761 -0
  97. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/schedule_files/occupancy-stochastic_6.csv +8761 -0
  98. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/schedules.rb +129 -137
  99. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/simcontrols.rb +12 -21
  100. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/unit_conversions.rb +5 -0
  101. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/util.rb +7 -2
  102. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/utility_bills.rb +6 -1
  103. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/version.rb +7 -2
  104. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/waterheater.rb +179 -144
  105. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/weather.rb +129 -71
  106. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/xmlhelper.rb +5 -0
  107. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/xmlvalidator.rb +23 -6
  108. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_airflow.rb +129 -118
  109. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_battery.rb +25 -20
  110. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_defaults.rb +2282 -2239
  111. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_enclosure.rb +395 -204
  112. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_generator.rb +12 -7
  113. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_hotwater_appliance.rb +56 -51
  114. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_hvac.rb +369 -230
  115. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_hvac_sizing.rb +371 -191
  116. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_lighting.rb +27 -20
  117. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_location.rb +55 -5
  118. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_miscloads.rb +35 -30
  119. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_pv.rb +13 -8
  120. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_schedules.rb +107 -93
  121. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_simcontrols.rb +11 -6
  122. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_validation.rb +757 -573
  123. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_water_heater.rb +77 -72
  124. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_weather.rb +36 -6
  125. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/util.rb +5 -0
  126. data/example_files/resources/hpxml-measures/README.md +2 -0
  127. data/example_files/resources/hpxml-measures/Rakefile +10 -3
  128. data/example_files/resources/hpxml-measures/ReportSimulationOutput/README.md +787 -0
  129. data/example_files/resources/hpxml-measures/ReportSimulationOutput/README.md.erb +41 -0
  130. data/example_files/resources/hpxml-measures/ReportSimulationOutput/measure.rb +730 -418
  131. data/example_files/resources/hpxml-measures/ReportSimulationOutput/measure.xml +1215 -9
  132. data/example_files/resources/hpxml-measures/ReportSimulationOutput/tests/{output_report_test.rb → test_report_sim_output.rb} +130 -299
  133. data/example_files/resources/hpxml-measures/ReportUtilityBills/README.md +87 -0
  134. data/example_files/resources/hpxml-measures/ReportUtilityBills/README.md.erb +41 -0
  135. data/example_files/resources/hpxml-measures/ReportUtilityBills/measure.rb +261 -89
  136. data/example_files/resources/hpxml-measures/ReportUtilityBills/measure.xml +179 -94
  137. data/example_files/resources/hpxml-measures/ReportUtilityBills/resources/simple_rates/Average_retail_price_of_electricity.csv +68 -68
  138. data/example_files/resources/hpxml-measures/ReportUtilityBills/resources/simple_rates/NG_PRI_SUM_A_EPG0_PRS_DMCF_A.csv +3 -2
  139. data/example_files/resources/hpxml-measures/ReportUtilityBills/resources/simple_rates/PET_PRI_WFR_A_EPD2F_PRS_DPGAL_W.csv +713 -685
  140. data/example_files/resources/hpxml-measures/ReportUtilityBills/resources/simple_rates/PET_PRI_WFR_A_EPLLPA_PRS_DPGAL_W.csv +716 -688
  141. data/example_files/resources/hpxml-measures/ReportUtilityBills/resources/simple_rates/README.md +5 -2
  142. data/example_files/resources/hpxml-measures/ReportUtilityBills/resources/util.rb +18 -9
  143. data/example_files/resources/hpxml-measures/ReportUtilityBills/tests/test_report_utility_bills.rb +1308 -0
  144. data/example_files/resources/hpxml-measures/docs/requirements.txt +5 -0
  145. data/example_files/resources/hpxml-measures/docs/source/conf.py +1 -2
  146. data/example_files/resources/hpxml-measures/docs/source/intro.rst +3 -20
  147. data/example_files/resources/hpxml-measures/docs/source/usage_instructions.rst +1 -1
  148. data/example_files/resources/hpxml-measures/docs/source/workflow_inputs.rst +917 -564
  149. data/example_files/resources/hpxml-measures/docs/source/workflow_outputs.rst +79 -42
  150. data/example_files/resources/hpxml-measures/tasks.rb +2305 -2055
  151. data/example_files/resources/hpxml-measures/workflow/hpxml_inputs.json +270 -587
  152. data/example_files/resources/hpxml-measures/workflow/real_homes/house001.xml +559 -557
  153. data/example_files/resources/hpxml-measures/workflow/real_homes/house002.xml +522 -520
  154. data/example_files/resources/hpxml-measures/workflow/real_homes/house003.xml +534 -532
  155. data/example_files/resources/hpxml-measures/workflow/real_homes/house004.xml +547 -545
  156. data/example_files/resources/hpxml-measures/workflow/real_homes/house005.xml +546 -544
  157. data/example_files/resources/hpxml-measures/workflow/real_homes/house006.xml +603 -623
  158. data/example_files/resources/hpxml-measures/workflow/real_homes/house007.xml +613 -633
  159. data/example_files/resources/hpxml-measures/workflow/real_homes/house008.xml +699 -721
  160. data/example_files/resources/hpxml-measures/workflow/real_homes/house009.xml +662 -661
  161. data/example_files/resources/hpxml-measures/workflow/real_homes/house010.xml +657 -677
  162. data/example_files/resources/hpxml-measures/workflow/real_homes/house011.xml +470 -467
  163. data/example_files/resources/hpxml-measures/workflow/real_homes/house012.xml +441 -438
  164. data/example_files/resources/hpxml-measures/workflow/real_homes/house013.xml +468 -465
  165. data/example_files/resources/hpxml-measures/workflow/real_homes/house014.xml +469 -466
  166. data/example_files/resources/hpxml-measures/workflow/real_homes/house015.xml +468 -465
  167. data/example_files/resources/hpxml-measures/workflow/real_homes/house016.xml +717 -714
  168. data/example_files/resources/hpxml-measures/workflow/real_homes/house017.xml +647 -645
  169. data/example_files/resources/hpxml-measures/workflow/real_homes/house018.xml +569 -566
  170. data/example_files/resources/hpxml-measures/workflow/real_homes/house019.xml +602 -599
  171. data/example_files/resources/hpxml-measures/workflow/real_homes/house020.xml +630 -627
  172. data/example_files/resources/hpxml-measures/workflow/real_homes/house021.xml +776 -774
  173. data/example_files/resources/hpxml-measures/workflow/real_homes/house022.xml +670 -667
  174. data/example_files/resources/hpxml-measures/workflow/real_homes/house023.xml +632 -629
  175. data/example_files/resources/hpxml-measures/workflow/real_homes/house024.xml +731 -729
  176. data/example_files/resources/hpxml-measures/workflow/real_homes/house025.xml +672 -669
  177. data/example_files/resources/hpxml-measures/workflow/real_homes/house026.xml +667 -644
  178. data/example_files/resources/hpxml-measures/workflow/real_homes/house027.xml +646 -644
  179. data/example_files/resources/hpxml-measures/workflow/real_homes/house028.xml +690 -688
  180. data/example_files/resources/hpxml-measures/workflow/real_homes/house029.xml +701 -699
  181. data/example_files/resources/hpxml-measures/workflow/real_homes/house030.xml +637 -615
  182. data/example_files/resources/hpxml-measures/workflow/real_homes/house031.xml +690 -688
  183. data/example_files/resources/hpxml-measures/workflow/real_homes/house032.xml +557 -554
  184. data/example_files/resources/hpxml-measures/workflow/real_homes/house033.xml +534 -531
  185. data/example_files/resources/hpxml-measures/workflow/real_homes/house034.xml +636 -635
  186. data/example_files/resources/hpxml-measures/workflow/real_homes/house035.xml +616 -613
  187. data/example_files/resources/hpxml-measures/workflow/real_homes/house036.xml +601 -598
  188. data/example_files/resources/hpxml-measures/workflow/real_homes/house037.xml +581 -578
  189. data/example_files/resources/hpxml-measures/workflow/real_homes/house038.xml +624 -622
  190. data/example_files/resources/hpxml-measures/workflow/real_homes/house039.xml +584 -582
  191. data/example_files/resources/hpxml-measures/workflow/real_homes/house040.xml +631 -629
  192. data/example_files/resources/hpxml-measures/workflow/real_homes/house041.xml +922 -921
  193. data/example_files/resources/hpxml-measures/workflow/real_homes/house042.xml +855 -853
  194. data/example_files/resources/hpxml-measures/workflow/real_homes/house043.xml +739 -737
  195. data/example_files/resources/hpxml-measures/workflow/real_homes/house044.xml +798 -796
  196. data/example_files/resources/hpxml-measures/workflow/real_homes/house045.xml +696 -694
  197. data/example_files/resources/hpxml-measures/workflow/real_homes/house046.xml +487 -483
  198. data/example_files/resources/hpxml-measures/workflow/real_homes/house047.xml +443 -440
  199. data/example_files/resources/hpxml-measures/workflow/real_homes/house048.xml +688 -686
  200. data/example_files/resources/hpxml-measures/workflow/real_homes/house049.xml +722 -720
  201. data/example_files/resources/hpxml-measures/workflow/real_homes/house050.xml +619 -617
  202. data/example_files/resources/hpxml-measures/workflow/run_simulation.rb +13 -20
  203. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-coal.xml +9 -9
  204. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-dehumidifier-ief-portable.xml +11 -12
  205. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-dehumidifier-ief-whole-home.xml +11 -12
  206. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-dehumidifier-multiple.xml +12 -13
  207. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-dehumidifier.xml +11 -12
  208. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-gas.xml +9 -9
  209. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-modified.xml +9 -9
  210. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-none.xml +4 -4
  211. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-oil.xml +9 -9
  212. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-propane.xml +9 -9
  213. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-wood.xml +9 -9
  214. data/example_files/resources/hpxml-measures/workflow/sample_files/base-atticroof-cathedral.xml +11 -11
  215. data/example_files/resources/hpxml-measures/workflow/sample_files/base-atticroof-conditioned.xml +10 -10
  216. data/example_files/resources/hpxml-measures/workflow/sample_files/base-atticroof-flat.xml +9 -9
  217. data/example_files/resources/hpxml-measures/workflow/sample_files/base-atticroof-radiant-barrier.xml +10 -11
  218. data/example_files/resources/hpxml-measures/workflow/sample_files/base-atticroof-unvented-insulated-roof.xml +9 -9
  219. data/example_files/resources/hpxml-measures/workflow/sample_files/base-atticroof-vented.xml +8 -8
  220. data/example_files/resources/hpxml-measures/workflow/sample_files/base-battery-scheduled.xml +571 -569
  221. data/example_files/resources/hpxml-measures/workflow/sample_files/base-battery.xml +9 -9
  222. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-adjacent-to-multifamily-buffer-space.xml → base-bldgtype-mf-unit-adjacent-to-multifamily-buffer-space.xml} +5 -5
  223. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-adjacent-to-multiple.xml → base-bldgtype-mf-unit-adjacent-to-multiple.xml} +17 -17
  224. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-adjacent-to-non-freezing-space.xml → base-bldgtype-mf-unit-adjacent-to-non-freezing-space.xml} +5 -5
  225. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-adjacent-to-other-heated-space.xml → base-bldgtype-mf-unit-adjacent-to-other-heated-space.xml} +5 -5
  226. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-adjacent-to-other-housing-unit.xml → base-bldgtype-mf-unit-adjacent-to-other-housing-unit.xml} +5 -5
  227. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-infil-compartmentalization-test.xml → base-bldgtype-mf-unit-infil-compartmentalization-test.xml} +461 -461
  228. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-residents-1.xml → base-bldgtype-mf-unit-residents-1.xml} +453 -453
  229. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-boiler-chiller-baseboard.xml → base-bldgtype-mf-unit-shared-boiler-chiller-baseboard.xml} +11 -11
  230. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-boiler-chiller-fan-coil-ducted.xml → base-bldgtype-mf-unit-shared-boiler-chiller-fan-coil-ducted.xml} +11 -11
  231. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-boiler-chiller-fan-coil.xml → base-bldgtype-mf-unit-shared-boiler-chiller-fan-coil.xml} +11 -11
  232. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-boiler-chiller-water-loop-heat-pump.xml → base-bldgtype-mf-unit-shared-boiler-chiller-water-loop-heat-pump.xml} +11 -11
  233. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-boiler-cooling-tower-water-loop-heat-pump.xml → base-bldgtype-mf-unit-shared-boiler-cooling-tower-water-loop-heat-pump.xml} +11 -11
  234. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-boiler-only-baseboard.xml → base-bldgtype-mf-unit-shared-boiler-only-baseboard.xml} +11 -11
  235. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-boiler-only-fan-coil-ducted.xml → base-bldgtype-mf-unit-shared-boiler-only-fan-coil-ducted.xml} +11 -11
  236. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-boiler-only-fan-coil-eae.xml → base-bldgtype-mf-unit-shared-boiler-only-fan-coil-eae.xml} +11 -11
  237. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-mf-unit-shared-boiler-only-fan-coil-fireplace-elec.xml +433 -0
  238. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-boiler-only-fan-coil.xml → base-bldgtype-mf-unit-shared-boiler-only-fan-coil.xml} +11 -11
  239. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-boiler-only-water-loop-heat-pump.xml → base-bldgtype-mf-unit-shared-boiler-only-water-loop-heat-pump.xml} +11 -11
  240. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-chiller-only-baseboard.xml → base-bldgtype-mf-unit-shared-chiller-only-baseboard.xml} +11 -11
  241. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-chiller-only-fan-coil-ducted.xml → base-bldgtype-mf-unit-shared-chiller-only-fan-coil-ducted.xml} +11 -11
  242. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-chiller-only-fan-coil.xml → base-bldgtype-mf-unit-shared-chiller-only-fan-coil.xml} +11 -11
  243. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-chiller-only-water-loop-heat-pump.xml → base-bldgtype-mf-unit-shared-chiller-only-water-loop-heat-pump.xml} +11 -11
  244. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-cooling-tower-only-water-loop-heat-pump.xml → base-bldgtype-mf-unit-shared-cooling-tower-only-water-loop-heat-pump.xml} +11 -11
  245. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-generator.xml → base-bldgtype-mf-unit-shared-generator.xml} +13 -13
  246. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-ground-loop-ground-to-air-heat-pump.xml → base-bldgtype-mf-unit-shared-ground-loop-ground-to-air-heat-pump.xml} +13 -13
  247. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-laundry-room-multiple-water-heaters.xml → base-bldgtype-mf-unit-shared-laundry-room-multiple-water-heaters.xml} +480 -480
  248. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-laundry-room.xml → base-bldgtype-mf-unit-shared-laundry-room.xml} +10 -10
  249. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-mechvent-multiple.xml → base-bldgtype-mf-unit-shared-mechvent-multiple.xml} +15 -15
  250. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-mechvent-preconditioning.xml → base-bldgtype-mf-unit-shared-mechvent-preconditioning.xml} +13 -13
  251. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-mechvent.xml → base-bldgtype-mf-unit-shared-mechvent.xml} +13 -13
  252. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-pv.xml → base-bldgtype-mf-unit-shared-pv.xml} +13 -13
  253. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-water-heater-recirc.xml → base-bldgtype-mf-unit-shared-water-heater-recirc.xml} +13 -13
  254. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily-shared-water-heater.xml → base-bldgtype-mf-unit-shared-water-heater.xml} +13 -13
  255. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-multifamily.xml → base-bldgtype-mf-unit.xml} +13 -13
  256. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-attached-2stories.xml → base-bldgtype-sfa-unit-2stories.xml} +610 -610
  257. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-attached-atticroof-cathedral.xml → base-bldgtype-sfa-unit-atticroof-cathedral.xml} +558 -558
  258. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-attached-infil-compartmentalization-test.xml → base-bldgtype-sfa-unit-infil-compartmentalization-test.xml} +610 -610
  259. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-bldgtype-attached.xml → base-bldgtype-sfa-unit.xml} +610 -610
  260. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-combi-tankless-outside.xml +8 -8
  261. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-combi-tankless.xml +9 -9
  262. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-desuperheater-2-speed.xml +9 -9
  263. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-desuperheater-gshp.xml +9 -9
  264. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-desuperheater-hpwh.xml +9 -9
  265. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-desuperheater-tankless.xml +9 -9
  266. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-desuperheater-var-speed.xml +9 -9
  267. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-desuperheater.xml +9 -9
  268. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-dwhr.xml +9 -9
  269. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-indirect-detailed-setpoints.xml +507 -505
  270. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-indirect-dse.xml +9 -9
  271. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-indirect-outside.xml +8 -8
  272. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-indirect-standbyloss.xml +9 -9
  273. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-indirect-with-solar-fraction.xml +9 -9
  274. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-indirect.xml +9 -9
  275. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-jacket-electric.xml +9 -9
  276. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-jacket-gas.xml +9 -9
  277. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-jacket-hpwh.xml +9 -9
  278. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-jacket-indirect.xml +9 -9
  279. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-low-flow-fixtures.xml +12 -10
  280. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-multiple.xml +14 -14
  281. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-none.xml +5 -5
  282. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-recirc-demand.xml +9 -9
  283. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-recirc-manual.xml +9 -9
  284. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-recirc-nocontrol.xml +9 -9
  285. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-recirc-temperature.xml +9 -9
  286. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-recirc-timer.xml +9 -9
  287. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-solar-direct-evacuated-tube.xml +9 -9
  288. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-solar-direct-flat-plate.xml +9 -9
  289. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-solar-direct-ics.xml +9 -9
  290. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-solar-fraction.xml +9 -9
  291. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-solar-indirect-flat-plate.xml +9 -9
  292. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-solar-thermosyphon-flat-plate.xml +9 -9
  293. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-coal.xml +9 -9
  294. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-detailed-setpoints.xml +12 -10
  295. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-elec-uef.xml +9 -9
  296. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-gas-outside.xml +8 -8
  297. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-gas-uef-fhr.xml +9 -9
  298. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-gas-uef.xml +9 -9
  299. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-gas.xml +9 -9
  300. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-heat-pump-detailed-schedules.xml +13 -11
  301. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-heat-pump-operating-mode-heat-pump-only.xml +9 -9
  302. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-heat-pump-outside.xml +8 -8
  303. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-heat-pump-uef.xml +9 -9
  304. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-heat-pump-with-solar-fraction.xml +9 -9
  305. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-heat-pump-with-solar.xml +9 -9
  306. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-heat-pump.xml +9 -9
  307. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-model-type-stratified-detailed-occupancy-stochastic.xml +12 -10
  308. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-model-type-stratified.xml +9 -9
  309. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-oil.xml +9 -9
  310. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-wood.xml +9 -9
  311. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-detailed-setpoints.xml +12 -10
  312. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-electric-outside.xml +8 -8
  313. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-electric-uef.xml +9 -9
  314. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-electric.xml +9 -9
  315. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-gas-uef.xml +9 -9
  316. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-gas-with-solar-fraction.xml +9 -9
  317. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-gas-with-solar.xml +9 -9
  318. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-gas.xml +9 -9
  319. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-propane.xml +9 -9
  320. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-2stories-garage.xml +13 -14
  321. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-2stories.xml +11 -11
  322. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-beds-1.xml +9 -9
  323. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-beds-2.xml +9 -9
  324. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-beds-4.xml +9 -9
  325. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-beds-5.xml +9 -9
  326. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-ceilingtypes.xml +576 -576
  327. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-floortypes.xml +519 -519
  328. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-garage.xml +4 -5
  329. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-infil-ach-house-pressure.xml +9 -9
  330. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-infil-cfm-house-pressure.xml +9 -9
  331. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-infil-cfm50.xml +9 -9
  332. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-infil-ela.xml +548 -548
  333. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-infil-flue.xml +9 -9
  334. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-infil-natural-ach.xml +9 -9
  335. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-infil-natural-cfm.xml +551 -551
  336. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-orientations.xml +9 -9
  337. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-overhangs.xml +9 -9
  338. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-rooftypes.xml +9 -9
  339. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-skylights-physical-properties.xml +9 -9
  340. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-skylights-shading.xml +9 -9
  341. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-skylights-storms.xml +9 -9
  342. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-skylights.xml +9 -9
  343. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-split-level.xml +10 -11
  344. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-thermal-mass.xml +9 -9
  345. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-walltypes.xml +19 -19
  346. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-windows-natural-ventilation-availability.xml +555 -553
  347. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-windows-none.xml +9 -9
  348. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-windows-physical-properties.xml +9 -9
  349. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-windows-shading-seasons.xml +560 -558
  350. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-windows-shading.xml +9 -9
  351. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-windows-storms.xml +9 -9
  352. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-ambient.xml +10 -10
  353. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-basement-garage.xml +10 -11
  354. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-belly-wing-no-skirt.xml +496 -0
  355. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-belly-wing-skirt.xml +496 -0
  356. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-complex.xml +18 -18
  357. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-schedules-simple-power-outage-natvent-unavailable.xml → base-foundation-conditioned-basement-slab-insulation-full.xml} +552 -564
  358. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-conditioned-basement-slab-insulation.xml +9 -9
  359. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-conditioned-basement-wall-insulation.xml +555 -555
  360. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-conditioned-crawlspace.xml +8 -8
  361. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-multiple.xml +5 -5
  362. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-slab.xml +10 -11
  363. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-unconditioned-basement-above-grade.xml +4 -4
  364. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-unconditioned-basement-assembly-r.xml +4 -4
  365. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-unconditioned-basement-wall-insulation.xml +4 -4
  366. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-unconditioned-basement.xml +4 -4
  367. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-unvented-crawlspace.xml +9 -9
  368. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-vented-crawlspace-above-grade.xml +558 -0
  369. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-vented-crawlspace.xml +9 -9
  370. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-walkout-basement.xml +15 -15
  371. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-1-speed-cooling-only.xml +9 -9
  372. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-1-speed-heating-capacity-17f.xml +552 -552
  373. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-1-speed-heating-only.xml +9 -9
  374. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-1-speed-lockout-temperatures.xml +562 -562
  375. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-1-speed-seer2-hspf2.xml +557 -557
  376. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-1-speed.xml +9 -9
  377. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-2-speed.xml +9 -9
  378. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-var-speed-backup-boiler-hvac-seasons.xml +586 -586
  379. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-var-speed-backup-boiler-switchover-temperature.xml +9 -9
  380. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-var-speed-backup-boiler.xml +9 -9
  381. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-var-speed-backup-furnace.xml +9 -9
  382. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-autosize-air-to-air-heat-pump-var-speed-sizing-methodology-acca.xml → base-hvac-air-to-air-heat-pump-var-speed-detailed-performance-other-temperatures.xml} +89 -13
  383. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-autosize-air-to-air-heat-pump-var-speed-sizing-methodology-hers.xml → base-hvac-air-to-air-heat-pump-var-speed-detailed-performance.xml} +107 -13
  384. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-var-speed.xml +9 -9
  385. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-sizing-controls.xml +567 -565
  386. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize.xml +9 -9
  387. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-boiler-coal-only.xml +9 -9
  388. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-boiler-elec-only.xml +9 -9
  389. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-boiler-gas-central-ac-1-speed.xml +9 -9
  390. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-boiler-gas-only-pilot.xml +512 -512
  391. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-boiler-gas-only.xml +9 -9
  392. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-boiler-oil-only.xml +9 -9
  393. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-boiler-propane-only.xml +9 -9
  394. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-boiler-wood-only.xml +9 -9
  395. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-central-ac-only-1-speed-seer2.xml +536 -536
  396. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-central-ac-only-1-speed.xml +9 -9
  397. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-central-ac-only-2-speed.xml +9 -9
  398. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-autosize-central-ac-only-var-speed.xml → base-hvac-central-ac-only-var-speed-detailed-performance.xml} +49 -10
  399. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-central-ac-only-var-speed.xml +9 -9
  400. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-central-ac-plus-air-to-air-heat-pump-heating.xml +9 -9
  401. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-dse.xml +9 -9
  402. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-dual-fuel-air-to-air-heat-pump-1-speed-lockout-temperatures.xml +559 -559
  403. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-dual-fuel-air-to-air-heat-pump-1-speed.xml +9 -9
  404. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-dual-fuel-air-to-air-heat-pump-2-speed.xml +9 -9
  405. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-dual-fuel-air-to-air-heat-pump-var-speed.xml +9 -9
  406. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-dual-fuel-mini-split-heat-pump-ducted.xml +9 -9
  407. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-ducts-area-fractions.xml +11 -12
  408. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-ducts-area-multipliers.xml +558 -558
  409. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-ducts-buried.xml +554 -554
  410. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-autosize-furnace-gas-room-ac.xml → base-hvac-ducts-defaults.xml} +28 -14
  411. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-ducts-effective-rvalue.xml +552 -552
  412. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-ducts-leakage-cfm50.xml +9 -9
  413. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-ducts-leakage-percent.xml +9 -9
  414. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-elec-resistance-only.xml +9 -9
  415. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-evap-cooler-furnace-gas.xml +9 -9
  416. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-evap-cooler-only-ducted.xml +9 -9
  417. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-evap-cooler-only.xml +9 -9
  418. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-fireplace-wood-only.xml +9 -9
  419. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-floor-furnace-propane-only.xml +15 -10
  420. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-coal-only.xml +9 -9
  421. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-elec-central-ac-1-speed.xml +9 -9
  422. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-elec-only.xml +9 -9
  423. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-gas-central-ac-2-speed.xml +9 -9
  424. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-gas-central-ac-var-speed.xml +9 -9
  425. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-gas-only-detailed-setpoints.xml +12 -10
  426. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-gas-only-pilot.xml +541 -541
  427. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-gas-only.xml +9 -9
  428. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-gas-room-ac.xml +9 -9
  429. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-oil-only.xml +9 -9
  430. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-propane-only.xml +9 -9
  431. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-wood-only.xml +9 -9
  432. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-x3-dse.xml +9 -9
  433. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-ground-to-air-heat-pump-cooling-only.xml +9 -9
  434. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-ground-to-air-heat-pump-heating-only.xml +9 -9
  435. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-ground-to-air-heat-pump.xml +9 -9
  436. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-install-quality-air-to-air-heat-pump-1-speed.xml +9 -9
  437. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-install-quality-air-to-air-heat-pump-2-speed.xml +9 -9
  438. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-air-to-air-heat-pump-1-speed-autosized-backup.xml → base-hvac-install-quality-air-to-air-heat-pump-var-speed-detailed-performance.xml} +650 -556
  439. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-install-quality-air-to-air-heat-pump-var-speed.xml +9 -9
  440. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-install-quality-furnace-gas-central-ac-1-speed.xml +9 -9
  441. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-install-quality-furnace-gas-central-ac-2-speed.xml +9 -9
  442. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-install-quality-furnace-gas-central-ac-var-speed.xml +9 -9
  443. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-install-quality-furnace-gas-only.xml +9 -9
  444. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-install-quality-ground-to-air-heat-pump.xml +9 -9
  445. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-install-quality-mini-split-air-conditioner-only-ducted.xml +9 -9
  446. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-install-quality-mini-split-heat-pump-ducted.xml +9 -9
  447. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-air-conditioner-only-ducted.xml +9 -9
  448. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-autosize-mini-split-air-conditioner-only-ducted.xml → base-hvac-mini-split-air-conditioner-only-ductless-detailed-performance.xml} +50 -49
  449. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-air-conditioner-only-ductless.xml +9 -9
  450. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-heat-pump-ducted-cooling-only.xml +9 -9
  451. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-autosize-mini-split-heat-pump-ducted-sizing-methodology-maxload.xml → base-hvac-mini-split-heat-pump-ducted-detailed-performance.xml} +109 -14
  452. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-heat-pump-ducted-heating-only.xml +9 -9
  453. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-heat-pump-ducted.xml +9 -9
  454. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-heat-pump-ductless-backup-baseboard.xml +524 -524
  455. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-autosize-dual-fuel-mini-split-heat-pump-ducted-backup-hardsized.xml → base-hvac-mini-split-heat-pump-ductless-backup-furnace-ducts-defaults.xml} +560 -552
  456. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-heat-pump-ductless-backup-furnace.xml +563 -563
  457. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-heat-pump-ductless-backup-stove.xml +9 -9
  458. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-autosize-dual-fuel-mini-split-heat-pump-ducted.xml → base-hvac-mini-split-heat-pump-ductless-detailed-performance.xml} +108 -60
  459. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-heat-pump-ductless-heating-capacity-17f.xml +505 -505
  460. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-heat-pump-ductless.xml +9 -9
  461. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-multiple.xml +9 -9
  462. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-none.xml +10 -11
  463. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-ptac-with-heating-electricity.xml +9 -9
  464. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-ptac-with-heating-natural-gas.xml +504 -504
  465. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-ptac.xml +9 -9
  466. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-pthp-heating-capacity-17f.xml +512 -512
  467. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-pthp.xml +9 -9
  468. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-room-ac-only-33percent.xml +9 -9
  469. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-room-ac-only-ceer.xml +9 -9
  470. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-room-ac-only-detailed-setpoints.xml +12 -10
  471. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-room-ac-only.xml +9 -9
  472. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-room-ac-with-heating.xml +504 -504
  473. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-room-ac-with-reverse-cycle.xml +517 -517
  474. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-seasons.xml +9 -9
  475. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-setpoints-daily-schedules.xml +9 -9
  476. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-setpoints-daily-setbacks.xml +9 -9
  477. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-setpoints.xml +9 -9
  478. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-fixed-heater-gas-only.xml → base-hvac-space-heater-gas-only.xml} +10 -10
  479. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-stove-oil-only.xml +9 -9
  480. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-stove-wood-pellets-only.xml +9 -9
  481. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-undersized.xml +9 -9
  482. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-wall-furnace-elec-only.xml +9 -9
  483. data/example_files/resources/hpxml-measures/workflow/sample_files/base-lighting-ceiling-fans.xml +9 -9
  484. data/example_files/resources/hpxml-measures/workflow/sample_files/base-lighting-holiday.xml +9 -9
  485. data/example_files/resources/hpxml-measures/workflow/sample_files/base-lighting-kwh-per-year.xml +531 -528
  486. data/example_files/resources/hpxml-measures/workflow/sample_files/base-lighting-mixed.xml +536 -536
  487. data/example_files/resources/hpxml-measures/workflow/sample_files/base-lighting-none-ceiling-fans.xml +515 -515
  488. data/example_files/resources/hpxml-measures/workflow/sample_files/base-lighting-none.xml +9 -9
  489. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-AMY-2012.xml +9 -9
  490. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-baltimore-md.xml +9 -9
  491. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-capetown-zaf.xml +9 -9
  492. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-dallas-tx.xml +10 -11
  493. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-duluth-mn.xml +4 -4
  494. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-helena-mt.xml +9 -9
  495. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-honolulu-hi.xml +10 -11
  496. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-miami-fl.xml +10 -11
  497. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-phoenix-az.xml +10 -11
  498. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-portland-or.xml +9 -9
  499. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-balanced.xml +9 -9
  500. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-bath-kitchen-fans.xml +9 -9
  501. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-cfis-airflow-fraction-zero.xml +9 -9
  502. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-cfis-dse.xml +9 -9
  503. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-cfis-evap-cooler-only-ducted.xml +9 -9
  504. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-cfis-supplemental-fan-exhaust.xml +576 -576
  505. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-cfis-supplemental-fan-supply.xml +576 -576
  506. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-cfis.xml +9 -9
  507. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-erv-atre-asre.xml +9 -9
  508. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-erv.xml +9 -9
  509. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-exhaust-rated-flow-rate.xml +9 -9
  510. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-exhaust.xml +9 -9
  511. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-hrv-asre.xml +9 -9
  512. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-hrv.xml +9 -9
  513. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-multiple.xml +9 -9
  514. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-supply.xml +9 -9
  515. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-whole-house-fan.xml +9 -9
  516. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-additional-properties.xml +21 -19
  517. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-bills-pv-detailed-only.xml +605 -605
  518. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-bills-pv-mixed.xml +587 -587
  519. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-bills-pv.xml +9 -9
  520. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-bills.xml +9 -9
  521. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-defaults.xml +3 -3
  522. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-emissions.xml +9 -9
  523. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-generators-battery-scheduled.xml +587 -585
  524. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-generators-battery.xml +584 -584
  525. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-generators.xml +9 -9
  526. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-ground-conductivity.xml +555 -555
  527. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-loads-large-uncommon.xml +26 -26
  528. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-loads-large-uncommon2.xml +26 -26
  529. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-loads-none.xml +9 -9
  530. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-neighbor-shading-bldgtype-multifamily.xml +508 -508
  531. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-neighbor-shading.xml +9 -9
  532. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-shielding-of-home.xml +9 -9
  533. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-schedules-simple-power-outage-natvent-available.xml → base-misc-unit-multiplier.xml} +553 -564
  534. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-usage-multiplier.xml +26 -26
  535. data/example_files/resources/hpxml-measures/workflow/sample_files/base-multiple-mf-units.xml +2755 -0
  536. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-multiple-buildings.xml → base-multiple-sfd-buildings.xml} +31 -22
  537. data/example_files/resources/hpxml-measures/workflow/sample_files/base-pv-battery-ah.xml +9 -9
  538. data/example_files/resources/hpxml-measures/workflow/sample_files/base-pv-battery-garage.xml +4 -5
  539. data/example_files/resources/hpxml-measures/workflow/sample_files/base-pv-battery-round-trip-efficiency.xml +597 -597
  540. data/example_files/resources/hpxml-measures/workflow/sample_files/base-pv-battery-scheduled.xml +599 -597
  541. data/example_files/resources/hpxml-measures/workflow/sample_files/base-pv-battery.xml +9 -9
  542. data/example_files/resources/hpxml-measures/workflow/sample_files/base-pv-generators-battery-scheduled.xml +615 -613
  543. data/example_files/resources/hpxml-measures/workflow/sample_files/base-pv-generators-battery.xml +612 -612
  544. data/example_files/resources/hpxml-measures/workflow/sample_files/base-pv-generators.xml +596 -596
  545. data/example_files/resources/hpxml-measures/workflow/sample_files/base-pv.xml +9 -9
  546. data/example_files/resources/hpxml-measures/workflow/sample_files/base-residents-0-runperiod-1-month.xml +559 -559
  547. data/example_files/resources/hpxml-measures/workflow/sample_files/base-residents-0.xml +555 -555
  548. data/example_files/resources/hpxml-measures/workflow/sample_files/base-residents-1-misc-loads-large-uncommon.xml +616 -616
  549. data/example_files/resources/hpxml-measures/workflow/sample_files/base-residents-1-misc-loads-large-uncommon2.xml +616 -616
  550. data/example_files/resources/hpxml-measures/workflow/sample_files/base-residents-1.xml +547 -547
  551. data/example_files/resources/hpxml-measures/workflow/sample_files/base-residents-5.xml +515 -515
  552. data/example_files/resources/hpxml-measures/workflow/sample_files/base-schedules-detailed-all-10-mins.xml +14 -12
  553. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-crankcase-heater-40w.xml → base-schedules-detailed-mixed-timesteps-power-outage.xml} +565 -555
  554. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-schedules-detailed-occupancy-stochastic-vacancy-year-round.xml → base-schedules-detailed-mixed-timesteps.xml} +554 -563
  555. data/example_files/resources/hpxml-measures/workflow/sample_files/base-schedules-detailed-occupancy-stochastic-10-mins.xml +12 -10
  556. data/example_files/resources/hpxml-measures/workflow/sample_files/base-schedules-detailed-occupancy-stochastic-power-outage.xml +566 -564
  557. data/example_files/resources/hpxml-measures/workflow/sample_files/base-schedules-detailed-occupancy-stochastic-vacancy.xml +12 -10
  558. data/example_files/resources/hpxml-measures/workflow/sample_files/base-schedules-detailed-occupancy-stochastic.xml +12 -10
  559. data/example_files/resources/hpxml-measures/workflow/sample_files/base-schedules-detailed-setpoints-daily-schedules.xml +12 -10
  560. data/example_files/resources/hpxml-measures/workflow/sample_files/base-schedules-detailed-setpoints-daily-setbacks.xml +12 -10
  561. data/example_files/resources/hpxml-measures/workflow/sample_files/base-schedules-detailed-setpoints.xml +12 -10
  562. data/example_files/resources/hpxml-measures/workflow/sample_files/base-schedules-simple-power-outage.xml +619 -619
  563. data/example_files/resources/hpxml-measures/workflow/sample_files/base-schedules-simple-vacancy.xml +618 -618
  564. data/example_files/resources/hpxml-measures/workflow/sample_files/base-schedules-simple.xml +9 -9
  565. data/example_files/resources/hpxml-measures/workflow/sample_files/base-simcontrol-calendar-year-custom.xml +9 -9
  566. data/example_files/resources/hpxml-measures/workflow/sample_files/base-simcontrol-daylight-saving-custom.xml +9 -9
  567. data/example_files/resources/hpxml-measures/workflow/sample_files/base-simcontrol-daylight-saving-disabled.xml +9 -9
  568. data/example_files/resources/hpxml-measures/workflow/sample_files/base-simcontrol-runperiod-1-month.xml +9 -9
  569. data/example_files/resources/hpxml-measures/workflow/sample_files/base-simcontrol-temperature-capacitance-multiplier.xml +553 -553
  570. data/example_files/resources/hpxml-measures/workflow/sample_files/base-simcontrol-timestep-10-mins-occupancy-stochastic-10-mins.xml +12 -10
  571. data/example_files/resources/hpxml-measures/workflow/sample_files/base-simcontrol-timestep-10-mins-occupancy-stochastic-60-mins.xml +12 -10
  572. data/example_files/resources/hpxml-measures/workflow/sample_files/base-simcontrol-timestep-10-mins.xml +9 -9
  573. data/example_files/resources/hpxml-measures/workflow/sample_files/base-simcontrol-timestep-30-mins.xml +552 -552
  574. data/example_files/resources/hpxml-measures/workflow/sample_files/base.xml +9 -9
  575. data/example_files/resources/hpxml-measures/workflow/template-build-and-run-hpxml-with-stochastic-occupancy.osw +2 -0
  576. data/example_files/resources/hpxml-measures/workflow/template-run-hpxml-with-stochastic-occupancy-subset.osw +2 -0
  577. data/example_files/resources/hpxml-measures/workflow/template-run-hpxml-with-stochastic-occupancy.osw +2 -0
  578. data/example_files/resources/hpxml-measures/workflow/template-run-hpxml.osw +4 -1
  579. data/example_files/resources/hpxml-measures/workflow/tests/ACCA_Examples/Long_Residence.xml +385 -385
  580. data/example_files/resources/hpxml-measures/workflow/tests/ACCA_Examples/Vatilo_Residence.xml +378 -380
  581. data/example_files/resources/hpxml-measures/workflow/tests/ACCA_Examples/Victor_Residence.xml +369 -369
  582. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L100AC.xml +7 -7
  583. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L100AL.xml +7 -7
  584. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L110AC.xml +7 -7
  585. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L110AL.xml +7 -7
  586. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L120AC.xml +7 -7
  587. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L120AL.xml +7 -7
  588. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L130AC.xml +7 -7
  589. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L130AL.xml +7 -7
  590. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L140AC.xml +7 -7
  591. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L140AL.xml +7 -7
  592. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L150AC.xml +7 -7
  593. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L150AL.xml +7 -7
  594. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L155AC.xml +7 -7
  595. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L155AL.xml +7 -7
  596. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L160AC.xml +7 -7
  597. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L160AL.xml +7 -7
  598. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L170AC.xml +7 -7
  599. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L170AL.xml +7 -7
  600. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L200AC.xml +7 -7
  601. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L200AL.xml +7 -7
  602. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L202AC.xml +7 -7
  603. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L202AL.xml +7 -7
  604. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L302XC.xml +7 -8
  605. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L304XC.xml +7 -8
  606. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L322XC.xml +6 -6
  607. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L324XC.xml +6 -6
  608. data/example_files/resources/hpxml-measures/workflow/tests/base_results/results_sizing.csv +363 -0
  609. data/example_files/resources/hpxml-measures/workflow/tests/base_results/results_workflow_simulations1.csv +281 -0
  610. data/example_files/resources/hpxml-measures/workflow/tests/base_results/results_workflow_simulations1_bills.csv +281 -0
  611. data/example_files/resources/hpxml-measures/workflow/tests/base_results/results_workflow_simulations2.csv +141 -0
  612. data/example_files/resources/hpxml-measures/workflow/tests/base_results/results_workflow_simulations2_bills.csv +141 -0
  613. data/example_files/resources/hpxml-measures/workflow/tests/compare.py +12 -6
  614. data/example_files/resources/hpxml-measures/workflow/tests/util.rb +1141 -0
  615. data/example_files/weather/USA_CO_Denver.Intl.AP.725650_TMY3.ddy +536 -0
  616. data/example_files/weather/USA_CO_Denver.Intl.AP.725650_TMY3.epw +8768 -0
  617. data/example_files/weather/USA_CO_Denver.Intl.AP.725650_TMY3.stat +554 -0
  618. data/example_files/weather/USA_FL_MacDill.AFB.747880_TMY3.ddy +536 -0
  619. data/example_files/weather/USA_FL_MacDill.AFB.747880_TMY3.epw +8768 -0
  620. data/example_files/weather/USA_FL_MacDill.AFB.747880_TMY3.stat +553 -0
  621. data/example_files/weather/USA_GA_Atlanta-Hartsfield-Jackson.Intl.AP.722190_TMY3-cache.csv +35 -0
  622. data/example_files/weather/USA_GA_Atlanta-Hartsfield-Jackson.Intl.AP.722190_TMY3.ddy +536 -0
  623. data/example_files/weather/USA_GA_Atlanta-Hartsfield-Jackson.Intl.AP.722190_TMY3.epw +8768 -0
  624. data/example_files/weather/USA_GA_Atlanta-Hartsfield-Jackson.Intl.AP.722190_TMY3.stat +553 -0
  625. data/example_files/weather/USA_NY_Buffalo-Greater.Buffalo.Intl.AP.725280_TMY3-cache.csv +35 -0
  626. data/example_files/xml_building/17/README.md +4 -2
  627. data/example_files/xml_building/17/feature.xml +2112 -0
  628. data/lib/uo_cli/version.rb +1 -1
  629. data/lib/uo_cli.rb +122 -22
  630. data/uo_cli.gemspec +6 -8
  631. metadata +130 -177
  632. data/Jenkinsfile +0 -10
  633. data/example_files/base_workflow_res.osw +0 -276
  634. data/example_files/resources/hpxml-measures/ReportUtilityBills/tests/utility_bills_test.rb +0 -1226
  635. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-oil-location-miami-fl.xml +0 -551
  636. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-propane-location-portland-or.xml +0 -551
  637. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-1-speed-cooling-only.xml +0 -544
  638. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-1-speed-heating-only.xml +0 -550
  639. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-1-speed-sizing-methodology-acca.xml +0 -552
  640. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-1-speed-sizing-methodology-hers.xml +0 -552
  641. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-1-speed-sizing-methodology-maxload-miami-fl.xml +0 -552
  642. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-1-speed-sizing-methodology-maxload.xml +0 -552
  643. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-2-speed-sizing-methodology-acca.xml +0 -552
  644. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-2-speed-sizing-methodology-hers.xml +0 -552
  645. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-2-speed-sizing-methodology-maxload.xml +0 -552
  646. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-var-speed-backup-boiler.xml +0 -569
  647. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-var-speed-backup-furnace.xml +0 -599
  648. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-var-speed-sizing-methodology-maxload.xml +0 -552
  649. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-boiler-elec-only.xml +0 -506
  650. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-boiler-gas-central-ac-1-speed.xml +0 -560
  651. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-boiler-gas-only.xml +0 -507
  652. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-central-ac-only-1-speed.xml +0 -536
  653. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-central-ac-only-2-speed.xml +0 -536
  654. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-central-ac-plus-air-to-air-heat-pump-heating.xml +0 -565
  655. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-dual-fuel-air-to-air-heat-pump-1-speed-sizing-methodology-acca.xml +0 -553
  656. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-dual-fuel-air-to-air-heat-pump-1-speed-sizing-methodology-hers.xml +0 -553
  657. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-dual-fuel-air-to-air-heat-pump-1-speed-sizing-methodology-maxload.xml +0 -553
  658. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-elec-resistance-only.xml +0 -497
  659. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-evap-cooler-furnace-gas.xml +0 -544
  660. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-floor-furnace-propane-only.xml +0 -500
  661. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-furnace-elec-only.xml +0 -536
  662. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-furnace-gas-central-ac-2-speed.xml +0 -551
  663. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-furnace-gas-central-ac-var-speed.xml +0 -551
  664. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-furnace-gas-only.xml +0 -536
  665. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-ground-to-air-heat-pump-cooling-only.xml +0 -546
  666. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-ground-to-air-heat-pump-heating-only.xml +0 -552
  667. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-ground-to-air-heat-pump-sizing-methodology-acca.xml +0 -554
  668. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-ground-to-air-heat-pump-sizing-methodology-hers.xml +0 -554
  669. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-ground-to-air-heat-pump-sizing-methodology-maxload.xml +0 -554
  670. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-mini-split-heat-pump-ducted-cooling-only.xml +0 -543
  671. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-mini-split-heat-pump-ducted-heating-only.xml +0 -549
  672. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-mini-split-heat-pump-ducted-sizing-methodology-acca.xml +0 -551
  673. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-mini-split-heat-pump-ducted-sizing-methodology-hers.xml +0 -551
  674. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-mini-split-heat-pump-ductless-backup-baseboard.xml +0 -519
  675. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-mini-split-heat-pump-ductless-backup-stove.xml +0 -522
  676. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-ptac-with-heating.xml +0 -503
  677. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-ptac.xml +0 -496
  678. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-pthp-sizing-methodology-acca.xml +0 -518
  679. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-pthp-sizing-methodology-hers.xml +0 -518
  680. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-pthp-sizing-methodology-maxload.xml +0 -518
  681. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-room-ac-only.xml +0 -496
  682. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-room-ac-with-heating.xml +0 -503
  683. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-room-ac-with-reverse-cycle-sizing-methodology-acca.xml +0 -518
  684. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-room-ac-with-reverse-cycle-sizing-methodology-hers.xml +0 -518
  685. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-room-ac-with-reverse-cycle-sizing-methodology-maxload.xml +0 -518
  686. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-stove-oil-only.xml +0 -500
  687. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-wall-furnace-elec-only.xml +0 -500
  688. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-floor-furnace-propane-only-pilot-light.xml +0 -506
  689. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-portable-heater-gas-only.xml +0 -501
  690. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-undersized-allow-increased-fixed-capacities.xml +0 -556
  691. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-bills-none.xml +0 -548
  692. data/example_files/resources/hpxml-measures/workflow/sample_files/base-schedules-simple-vacancy-year-round.xml +0 -619
  693. data/example_files/resources/hpxml-measures/workflow/tests/base_results/results.csv +0 -475
  694. data/example_files/resources/hpxml-measures/workflow/tests/base_results/results_bills.csv +0 -475
  695. data/example_files/resources/hpxml-measures/workflow/tests/hpxml_translator_test.rb +0 -1313
  696. data/example_files/resources/measure-info.json +0 -26
  697. data/example_files/resources/meta_measure.rb +0 -301
  698. data/example_files/xml_building/17/unit 1.xml +0 -580
  699. data/example_files/xml_building/17/unit 2.xml +0 -553
  700. data/example_files/xml_building/17/unit 3.xml +0 -553
  701. data/example_files/xml_building/17/unit 4.xml +0 -580
  702. /data/example_files/{residential → mappers/residential/template/iecc}/clothes_dryer.tsv +0 -0
  703. /data/example_files/{residential → mappers/residential/template/iecc}/clothes_washer.tsv +0 -0
  704. /data/example_files/{residential → mappers/residential/template/iecc}/cooling_system.tsv +0 -0
  705. /data/example_files/{residential → mappers/residential/template/iecc}/dishwasher.tsv +0 -0
  706. /data/example_files/{residential → mappers/residential/template/iecc}/enclosure.tsv +0 -0
  707. /data/example_files/{residential → mappers/residential/template/iecc}/heat_pump.tsv +0 -0
  708. /data/example_files/{residential → mappers/residential/template/iecc}/heating_system.tsv +0 -0
  709. /data/example_files/{residential → mappers/residential/template/iecc}/mechanical_ventilation.tsv +0 -0
  710. /data/example_files/{residential → mappers/residential/template/iecc}/refrigerator.tsv +0 -0
  711. /data/example_files/{residential → mappers/residential/template/iecc}/water_heater.tsv +0 -0
  712. /data/example_files/resources/hpxml-measures/ReportUtilityBills/tests/{JacksonElectricMemberCorp-ResidentialSeniorCitizenLowIncomeAssistance.json → Detailed Rate.json} +0 -0
@@ -29,13 +29,6 @@ HPXML files submitted to OpenStudio-HPXML undergo a two step validation process:
29
29
 
30
30
  OpenStudio-HPXML **automatically validates** the HPXML file against both the XSD and Schematron documents and reports any validation errors, but software developers may find it beneficial to also integrate validation into their software.
31
31
 
32
- .. important::
33
-
34
- Usage of both validation approaches (XSD and Schematron) is recommended for developers actively working on creating HPXML files for EnergyPlus simulations:
35
-
36
- - Validation against XSD for general correctness and usage of HPXML
37
- - Validation against Schematron for understanding XML document requirements specific to running EnergyPlus
38
-
39
32
  Input Defaults
40
33
  **************
41
34
 
@@ -56,7 +49,7 @@ Default values would be used for the refrigerator energy use, location, and sche
56
49
 
57
50
  <Refrigerator>
58
51
  <SystemIdentifier id='Refrigerator1'/>
59
- <Location dataSource='software'>living space</Location>
52
+ <Location dataSource='software'>conditioned space</Location>
60
53
  <RatedAnnualkWh dataSource='software'>691.0</RatedAnnualkWh>
61
54
  <PrimaryIndicator dataSource='software'>true</PrimaryIndicator>
62
55
  <extension>
@@ -106,157 +99,6 @@ EnergyPlus simulation controls are entered in ``/HPXML/SoftwareInfo/extension/Si
106
99
  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.
107
100
  This heat capacitance effect is modeled on top of any other individual mass inputs (e.g., furniture mass, partition wall mass, interior drywall, etc.) in the HPXML.
108
101
 
109
- .. _hvac_sizing_control:
110
-
111
- HPXML HVAC Sizing Control
112
- *************************
113
-
114
- HVAC equipment sizing controls are entered in ``/HPXML/SoftwareInfo/extension/HVACSizingControl``.
115
-
116
- ================================= ======== ===== =========== ======== ======== ============================================
117
- Element Type Units Constraints Required Default Description
118
- ================================= ======== ===== =========== ======== ======== ============================================
119
- ``AllowIncreasedFixedCapacities`` boolean No false Logic for fixed capacity HVAC equipment [#]_
120
- ``HeatPumpSizingMethodology`` string See [#]_ No HERS Logic for autosized heat pumps [#]_
121
- ================================= ======== ===== =========== ======== ======== ============================================
122
-
123
- .. [#] 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.
124
- .. [#] HeatPumpSizingMethodology choices are 'ACCA', 'HERS', or 'MaxLoad'.
125
- .. [#] 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.
126
- If HeatPumpSizingMethodology is 'HERS', autosized heat pumps have their nominal capacity sized equal to the larger of heating/cooling design loads.
127
- 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.
128
-
129
- If any HVAC equipment is being autosized (i.e., capacities are not provided), additional inputs for ACCA Manual J can be entered in ``/HPXML/SoftwareInfo/extension/HVACSizingControl/ManualJInputs``.
130
-
131
- ================================= ======== ====== =========== ======== ============ ============================================
132
- Element Type Units Constraints Required Default Description
133
- ================================= ======== ====== =========== ======== ============ ============================================
134
- ``HeatingDesignTemperature`` double F No See [#]_ Heating design temperature
135
- ``CoolingDesignTemperature`` double F No See [#]_ Cooling design temperature
136
- ``HeatingSetpoint`` double F No 70 Conditioned space heating setpoint [#]_
137
- ``CoolingSetpoint`` double F No 75 Conditioned space cooling setpoint [#]_
138
- ``HumiditySetpoint`` double frac 0 - 1 No See [#]_ Conditioned space relative humidity
139
- ``InternalLoadsSensible`` double Btu/hr No See [#]_ Sensible internal loads for cooling design load
140
- ``InternalLoadsLatent`` double Btu/hr No 0 Latent internal loads for cooling design load
141
- ``NumberofOccupants`` integer No #Beds+1 [#]_ Number of occupants for cooling design load
142
- ================================= ======== ====== =========== ======== ============ ============================================
143
-
144
- .. [#] If HeatingDesignTemperature not provided, the 99% heating design temperature is obtained from the DESIGN CONDITIONS header section inside the EPW weather file.
145
- If not available in the EPW header, it is calculated from the 8760 hourly temperatures in the EPW.
146
- .. [#] If CoolingDesignTemperature not provided, the 1% cooling design temperature is obtained from the DESIGN CONDITIONS header section inside the EPW weather file.
147
- If not available in the EPW header, it is calculated from the 8760 hourly temperatures in the EPW.
148
- .. [#] Any heating setpoint other than 70F is not in compliance with Manual J.
149
- .. [#] Any cooling setpoint other than 75F is not in compliance with Manual J.
150
- .. [#] If HumiditySetpoint not provided, defaults to 0.5 unless there is a dehumidifier with a lower setpoint, in which case that value is used.
151
- .. [#] If InternalLoadsSensible not provided, defaults to 2400 Btu/hr if there is one refrigerator and no freezer, or 3600 Btu/hr if two refrigerators or a freezer.
152
- This default represents loads that normally occur during the early evening in mid-summer.
153
- Additional adjustments or custom internal loads can instead be specified here.
154
- .. [#] If NumberofOccupants not provided, defaults to the number of bedrooms plus one per Manual J.
155
- Each occupant produces an additional 230 Btu/hr sensible load and 200 Btu/hr latent load.
156
-
157
- .. _shadingcontrol:
158
-
159
- HPXML Shading Control
160
- *********************
161
-
162
- Shading controls for window and skylight summer/winter shading coefficients are entered in ``/HPXML/SoftwareInfo/extension/ShadingControl``.
163
- If not provided, summer will be default based on the cooling season defined in the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_, using monthly average temperatures.
164
- The remainder of the year is winter.
165
-
166
- ==================================== ======== ======= ============= ======== ======= =====================================
167
- Element Type Units Constraints Required Default Description
168
- ==================================== ======== ======= ============= ======== ======= =====================================
169
- ``SummerBeginMonth`` integer 1 - 12 Yes Summer shading start date
170
- ``SummerBeginDayOfMonth`` integer 1 - 31 Yes Summer shading start date
171
- ``SummerEndMonth`` integer 1 - 12 Yes Summer shading end date
172
- ``SummerEndDayOfMonth`` integer 1 - 31 Yes Summer shading end date
173
- ==================================== ======== ======= ============= ======== ======= =====================================
174
-
175
- HPXML Schedules
176
- ***************
177
-
178
- Schedules for a variety of building features can be 1) specified via simple inputs, 2) specified via detailed inputs, or 3) defaulted.
179
- It is allowed to use simple, detailed, and defaulted values in the same HPXML run.
180
-
181
- Simple Schedule Inputs
182
- ~~~~~~~~~~~~~~~~~~~~~~
183
-
184
- Simple schedule inputs are available as weekday/weekend fractions and monthly multipliers for a variety of building characteristics.
185
- For example, see the ``WeekdayScheduleFractions``, ``WeekendScheduleFractions``, and ``MonthlyScheduleMultipliers`` inputs for :ref:`buildingoccupancy`.
186
-
187
- .. _detailedschedules:
188
-
189
- Detailed Schedule Inputs
190
- ~~~~~~~~~~~~~~~~~~~~~~~~
191
-
192
- Detailed schedule inputs allow schedule values for every hour or timestep of the simulation.
193
- They can be used to reflect real-world or stochastic occupancy.
194
-
195
- Detailed schedule inputs are provided via one or more CSV file that should be referenced in the HPXML file as ``/HPXML/SoftwareInfo/extension/SchedulesFilePath`` elements.
196
- The column names available in the schedule CSV files are:
197
-
198
- =============================== ===== ================================================================================= ===============================
199
- Column Name Units Description Can Be Stochastically Generated
200
- =============================== ===== ================================================================================= ===============================
201
- ``occupants`` frac Occupant heat gain schedule. Yes
202
- ``lighting_interior`` frac Interior lighting energy use schedule. Yes
203
- ``lighting_exterior`` frac Exterior lighting energy use schedule. No
204
- ``lighting_garage`` frac Garage lighting energy use schedule. Yes
205
- ``lighting_exterior_holiday`` frac Exterior holiday lighting energy use schedule. No
206
- ``cooking_range`` frac Cooking range & oven energy use schedule. Yes
207
- ``refrigerator`` frac Primary refrigerator energy use schedule. No
208
- ``extra_refrigerator`` frac Non-primary refrigerator energy use schedule. No
209
- ``freezer`` frac Freezer energy use schedule. No
210
- ``dishwasher`` frac Dishwasher energy use schedule. Yes
211
- ``clothes_washer`` frac Clothes washer energy use schedule. Yes
212
- ``clothes_dryer`` frac Clothes dryer energy use schedule. Yes
213
- ``ceiling_fan`` frac Ceiling fan energy use schedule. Yes
214
- ``plug_loads_other`` frac Other plug load energy use schedule. Yes
215
- ``plug_loads_tv`` frac Television plug load energy use schedule. Yes
216
- ``plug_loads_vehicle`` frac Electric vehicle plug load energy use schedule. No
217
- ``plug_loads_well_pump`` frac Well pump plug load energy use schedule. No
218
- ``fuel_loads_grill`` frac Grill fuel load energy use schedule. No
219
- ``fuel_loads_lighting`` frac Lighting fuel load energy use schedule. No
220
- ``fuel_loads_fireplace`` frac Fireplace fuel load energy use schedule. No
221
- ``pool_pump`` frac Pool pump energy use schedule. No
222
- ``pool_heater`` frac Pool heater energy use schedule. No
223
- ``hot_tub_pump`` frac Hot tub pump energy use schedule. No
224
- ``hot_tub_heater`` frac Hot tub heater energy use schedule. No
225
- ``hot_water_dishwasher`` frac Dishwasher hot water use schedule. Yes
226
- ``hot_water_clothes_washer`` frac Clothes washer hot water use schedule. Yes
227
- ``hot_water_fixtures`` frac Fixtures (sinks, showers, baths) hot water use schedule. Yes
228
- ``heating_setpoint`` F Thermostat heating setpoint schedule. No
229
- ``cooling_setpoint`` F Thermostat cooling setpoint schedule. No
230
- ``water_heater_setpoint`` F Water heater setpoint schedule. No
231
- ``water_heater_operating_mode`` 0/1 Heat pump water heater operating mode schedule. 0=hyrbid/auto, 1=heat pump only. No
232
- ``battery`` frac Battery schedule. Positive for charging, negative for discharging. No
233
- ``vacancy`` 0/1 Vacancy schedule. 0=occupied, 1=vacant. Automatically overrides other columns. N/A
234
- ``outage`` 0/1 Power outage schedule. 0=power. 1=nopower. Automatically overrides other columns. N/A
235
- =============================== ===== ================================================================================= ===============================
236
-
237
- Columns with units of `frac` must be normalized to MAX=1; that is, these schedules only define *when* energy is used, not *how much* energy is used.
238
- In other words, the amount of energy or hot water used in each simulation timestep is essentially the schedule value divided by the sum of all schedule values in the column, multiplied by the annual energy or hot water use.
239
- Example schedule CSV files are provided in the ``HPXMLtoOpenStudio/resources/schedule_files`` directory.
240
-
241
- The schedule file must have a full year of data even if the simulation is not an entire year.
242
- Frequency of schedule values do not need to match the simulation timestep.
243
- For example, hourly schedules can be used with a 10-minute simulation timestep, or 10-minute schedules can be used with an hourly simulation timestep.
244
-
245
- A detailed stochastic occupancy schedule CSV file can also be automatically generated for you (see "Can Be Stochastically Generated" above for applicable columns); see the :ref:`usage_instructions` for the commands.
246
- Inputs for the stochastic schedule generator are entered in ``/HPXML/Building/BuildingDetails/BuildingSummary/BuildingOccupancy/NumberofResidents`` and ``/HPXML/Building/Site/Address/StateCode``.
247
- See :ref:`buildingoccupancy` and :ref:`buildingsite` for more information.
248
-
249
- .. warning::
250
-
251
- For simulations with daylight saving enabled (which is the default), EnergyPlus will skip forward an hour in the CSV on the "spring forward" day and repeat an hour on the "fall back" day.
252
-
253
- Default Schedules
254
- ~~~~~~~~~~~~~~~~~
255
-
256
- If neither simple nor detailed inputs are provided, then schedules are defaulted.
257
- Default schedules are typically smooth, averaged schedules.
258
- These default schedules are described elsewhere in the documentation (e.g., see :ref:`buildingoccupancy` for the default occupant heat gain schedule).
259
-
260
102
  HPXML Emissions Scenarios
261
103
  *************************
262
104
 
@@ -334,7 +176,7 @@ If EmissionsType is "CO2e", "NOx" or "SO2" and a given fuel's emissions factor i
334
176
  wood pellets -- -- --
335
177
  ============ ============== ============= =============
336
178
 
337
- Default values in lb/MBtu (million Btu) are from *Table 5.1.2(1) National Average Emission Factors for Household Fuels* from *ANSI/RESNET/ICCC 301 Standard for the Calculation and Labeling of the Energy Performance of Dwelling and Sleeping Units using an Energy Rating Index* and include both combustion and pre-combustion (e.g., methane leakage for natural gas) emissions.
179
+ Default values in lb/MBtu (million Btu) are from *Table 5.1.2(1) National Average Emission Factors for Household Fuels* from *ANSI/RESNET/ICC 301 Standard for the Calculation and Labeling of the Energy Performance of Dwelling and Sleeping Units using an Energy Rating Index* and include both combustion and pre-combustion (e.g., methane leakage for natural gas) emissions.
338
180
 
339
181
  If no default value is available, a warning will be issued.
340
182
 
@@ -368,11 +210,12 @@ For simple utility rate structures, inputs can be entered using a fixed charge a
368
210
  Element Type Units Constraints Required Default Notes
369
211
  ================================ ======== ======= =========== ======== ======== ====================
370
212
  ``FuelType`` string electricity Yes Fuel type
371
- ``FixedCharge`` double $/month No 12.0 Monthly fixed charge
213
+ ``FixedCharge`` double $/month No 12.0 Monthly fixed charge [#]_
372
214
  ``MarginalRate`` double $/kWh No See [#]_ Marginal flat rate
373
215
  ================================ ======== ======= =========== ======== ======== ====================
374
216
 
375
- .. [#] If MarginalRate not provided, defaults to state, regional, or national average based on EIA data that can be found at ``ReportUtilityBills/resources/Data/UtilityRates/Average_retail_price_of_electricity.csv``.
217
+ .. [#] If running :ref:`bldg_type_bldgs`, the fixed charge will apply to every dwelling unit in the building.
218
+ .. [#] If MarginalRate not provided, defaults to state, regional, or national average based on 2022 EIA data that can be found at ``ReportUtilityBills/resources/Data/UtilityRates/Average_retail_price_of_electricity.csv``.
376
219
 
377
220
  **Detailed**
378
221
 
@@ -408,11 +251,15 @@ For each scenario, fuel rates can be optionally entered as an ``/HPXML/SoftwareI
408
251
  .. [#] FuelType choices are "natural gas", "propane", "fuel oil", "coal", "wood", and "wood pellets".
409
252
  .. [#] FixedCharge defaults to $12/month for natural gas and $0/month for other fuels.
410
253
  .. [#] MarginalRate units are $/therm for natural gas, $/gallon for propane and fuel oil, and $/kBtu for other fuels.
411
- .. [#] | If MarginalRate not provided, defaults to state, regional, or national average based on EIA data that can be found at:
412
- | - **natural gas**: ``ReportUtilityBills/resources/Data/UtilityRates/NG_PRI_SUM_A_EPG0_PRS_DMCF_A.csv``
413
- | - **propane**: ``ReportUtilityBills/resources/Data/UtilityRates/PET_PRI_WFR_A_EPLLPA_PRS_DPGAL_W.csv``
414
- | - **fuel oil**: ``ReportUtilityBills/resources/Data/UtilityRates/PET_PRI_WFR_A_EPD2F_PRS_DPGAL_W.csv``
415
- | or defaults to $0.015/kBtu for other fuels.
254
+ .. [#] If MarginalRate not provided, defaults to state, regional, or national average based on 2022 EIA data that can be found at:
255
+
256
+ \- **natural gas**: ``ReportUtilityBills/resources/Data/UtilityRates/NG_PRI_SUM_A_EPG0_PRS_DMCF_A.csv``
257
+
258
+ \- **propane**: ``ReportUtilityBills/resources/Data/UtilityRates/PET_PRI_WFR_A_EPLLPA_PRS_DPGAL_W.csv``
259
+
260
+ \- **fuel oil**: ``ReportUtilityBills/resources/Data/UtilityRates/PET_PRI_WFR_A_EPD2F_PRS_DPGAL_W.csv``
261
+
262
+ or defaults to $0.015/kBtu for other fuels.
416
263
 
417
264
  PV Compensation
418
265
  ~~~~~~~~~~~~~~~
@@ -489,6 +336,63 @@ You can create an additional column in the CSV file to define another unavailabl
489
336
 
490
337
  It is not possible to eliminate all HVAC/DHW energy use (e.g. crankcase/defrost energy, water heater parasitics) in EnergyPlus during an unavailable period.
491
338
 
339
+ .. _hpxmlbuilding:
340
+
341
+ HPXML Building
342
+ --------------
343
+
344
+ OpenStudio-HPXML can be used to model either individual residential :ref:`bldg_type_units` or :ref:`bldg_type_bldgs`.
345
+
346
+ Each residential dwelling unit is entered in ``/HPXML/Building``.
347
+
348
+ ========================= ====== ======= =========== ======== ======= ==============================================
349
+ Element Type Units Constraints Required Default Notes
350
+ ========================= ====== ======= =========== ======== ======= ==============================================
351
+ ``BuildingID`` id Yes Unique identifier
352
+ ========================= ====== ======= =========== ======== ======= ==============================================
353
+
354
+ .. _bldg_type_units:
355
+
356
+ Dwelling Units
357
+ **************
358
+
359
+ The OpenStudio-HPXML workflow was originally developed to model individual residential dwelling units -- either a single-family detached (SFD) building, or a single unit of a single-family attached (SFA) or multifamily (MF) building.
360
+ This approach:
361
+
362
+ - Is required/desired for certain applications (e.g., a Home Energy Score or an Energy Rating Index calculation).
363
+ - Improves runtime speed by being able to simulate individual units in parallel (as opposed to simulating the entire building).
364
+
365
+ When modeling individual units of SFA/MF buildings, current capabilities include:
366
+
367
+ - Defining surfaces adjacent to generic SFA/MF spaces (e.g., "other housing unit" or "other multifamily buffer space"), in which temperature profiles will be assumed (see :ref:`hpxmllocations`).
368
+ - Locating various building components (e.g., ducts, water heaters, appliances) in these SFA/MF spaces.
369
+ - Defining shared systems (HVAC, water heating, mechanical ventilation, etc.), in which individual systems are modeled with adjustments to approximate their energy use attributed to the unit.
370
+
371
+ Note that only the energy use attributed to each dwelling unit is calculated.
372
+
373
+ .. _bldg_type_bldgs:
374
+
375
+ Whole SFA/MF Buildings
376
+ **********************
377
+
378
+ As of OpenStudio-HPXML v1.7.0, a new capability was added for modeling whole SFA/MF buildings in a single combined simulation.
379
+
380
+ For these simulations:
381
+
382
+ - Each dwelling unit is described by a separate ``Building`` element in the HPXML file.
383
+ - To run the single combined simulation, specify the Building ID as 'ALL' in the run_simulation.rb script or OpenStudio workflow.
384
+ - Unit multipliers (using the ``NumberofUnits`` element) can be specified to model *unique* dwelling units, rather than *all* dwelling units, reducing simulation runtime.
385
+ - Adjacent SFA/MF common spaces are still modeled using assumed temperature profiles, not as separate thermal zones.
386
+ - Shared systems are still modeled as individual systems, not shared systems connected to multiple dwelling unit.
387
+
388
+ Notes/caveats about this approach:
389
+
390
+ - Some inputs (e.g., EPW location or ground conductivity) cannot vary across ``Building`` elements.
391
+ - Batteries are not currently supported. Dehumidifiers and ground-source heat pumps are only supported if ``NumberofUnits`` is 1.
392
+ - Utility bill calculations using detailed rates are not supported.
393
+
394
+ Note that only the energy use for the entire building is calculated.
395
+
492
396
  .. _buildingsite:
493
397
 
494
398
  HPXML Building Site
@@ -575,10 +479,13 @@ Building occupancy is entered in ``/HPXML/Building/BuildingDetails/BuildingSumma
575
479
  ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
576
480
  ======================================== ======== ===== =========== ======== ======== ========================
577
481
 
578
- .. [#] | If NumberofResidents not provided, an *asset* calculation is performed assuming standard occupancy, in which various end use defaults (e.g., plug loads, appliances, and hot water usage) are calculated based on NumberofBedrooms and ConditionedFloorArea per `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_.
579
- | If NumberofResidents is provided, an *operational* calculation is instead performed in which the end use defaults are adjusted using the relationship between NumberofBedrooms and NumberofResidents from `RECS 2015 <https://www.eia.gov/consumption/residential/reports/2015/overview/>`_:
580
- | - **single-family detached or manufactured home**: NumberofBedrooms = -1.47 + 1.69 * NumberofResidents
581
- | - **single-family attached or apartment unit**: NumberofBedrooms = -0.68 + 1.09 * NumberofResidents
482
+ .. [#] If NumberofResidents not provided, an *asset* calculation is performed assuming standard occupancy, in which various end use defaults (e.g., plug loads, appliances, and hot water usage) are calculated based on NumberofBedrooms and ConditionedFloorArea per `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_.
483
+ If NumberofResidents is provided, an *operational* calculation is instead performed in which the end use defaults are adjusted using the relationship between NumberofBedrooms and NumberofResidents from `RECS 2015 <https://www.eia.gov/consumption/residential/reports/2015/overview/>`_:
484
+
485
+ \- **single-family detached or manufactured home**: NumberofBedrooms = -1.47 + 1.69 * NumberofResidents
486
+
487
+ \- **single-family attached or apartment unit**: NumberofBedrooms = -0.68 + 1.09 * NumberofResidents
488
+
582
489
  .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided (and :ref:`detailedschedules` not used), default values from Figures 25 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used: "0.061, 0.061, 0.061, 0.061, 0.061, 0.061, 0.061, 0.053, 0.025, 0.015, 0.015, 0.015, 0.015, 0.015, 0.015, 0.015, 0.018, 0.033, 0.054, 0.054, 0.054, 0.061, 0.061, 0.061".
583
490
  .. [#] If MonthlyScheduleMultipliers not provided (and :ref:`detailedschedules` not used), default values are used: "1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0".
584
491
 
@@ -591,6 +498,7 @@ Building construction is entered in ``/HPXML/Building/BuildingDetails/BuildingSu
591
498
  Element Type Units Constraints Required Default Notes
592
499
  ========================================================= ======== ========= ================================= ======== ======== =======================================================================
593
500
  ``ResidentialFacilityType`` string See [#]_ Yes Type of dwelling unit
501
+ ``NumberofUnits`` integer >= 1 No 1 Unit multiplier [#]_
594
502
  ``NumberofConditionedFloors`` double > 0 Yes Number of conditioned floors (including a conditioned basement; excluding a conditioned crawlspace)
595
503
  ``NumberofConditionedFloorsAboveGrade`` double > 0, <= NumberofConditionedFloors Yes Number of conditioned floors above grade (including a walkout basement)
596
504
  ``NumberofBedrooms`` integer >= 0 Yes Number of bedrooms
@@ -600,10 +508,164 @@ Building construction is entered in ``/HPXML/Building/BuildingDetails/BuildingSu
600
508
  ========================================================= ======== ========= ================================= ======== ======== =======================================================================
601
509
 
602
510
  .. [#] ResidentialFacilityType choices are "single-family detached", "single-family attached", "apartment unit", or "manufactured home".
511
+ .. [#] NumberofUnits defines the number of similar dwelling units represented by the HPXML ``Building`` element.
512
+ EnergyPlus simulation results will be multiplied by this value.
513
+ For example, when modeling :ref:`bldg_type_bldgs`, this allows modeling *unique* dwelling units, rather than *all* dwelling units, to reduce simulation runtime.
603
514
  .. [#] If NumberofBathrooms not provided, calculated as NumberofBedrooms/2 + 0.5 based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_.
604
515
  .. [#] If neither ConditionedBuildingVolume nor AverageCeilingHeight provided, AverageCeilingHeight defaults to the lesser of 8.0 and InfiltrationVolume / ConditionedFloorArea.
605
516
  If needed, additional defaulting is performed using the following relationship: ConditionedBuildingVolume = ConditionedFloorArea * AverageCeilingHeight + ConditionedCrawlspaceVolume.
606
517
 
518
+ HPXML Schedules
519
+ ***************
520
+
521
+ Schedules for a variety of building features can be 1) specified via simple inputs, 2) specified via detailed inputs, or 3) defaulted.
522
+ It is allowed to use simple, detailed, and defaulted values in the same HPXML run.
523
+
524
+ Simple Schedule Inputs
525
+ ~~~~~~~~~~~~~~~~~~~~~~
526
+
527
+ Simple schedule inputs are available as weekday/weekend fractions and monthly multipliers for a variety of building characteristics.
528
+ For example, see the ``WeekdayScheduleFractions``, ``WeekendScheduleFractions``, and ``MonthlyScheduleMultipliers`` inputs for :ref:`buildingoccupancy`.
529
+
530
+ .. _detailedschedules:
531
+
532
+ Detailed Schedule Inputs
533
+ ~~~~~~~~~~~~~~~~~~~~~~~~
534
+
535
+ Detailed schedule inputs allow schedule values for every hour or timestep of the simulation.
536
+ They can be used to reflect real-world or stochastic occupancy.
537
+
538
+ Detailed schedule inputs are provided via one or more CSV file that should be referenced in the HPXML file as ``/HPXML/Building/BuildingDetails/BuildingSummary/extension/SchedulesFilePath`` elements.
539
+ The column names available in the schedule CSV files are:
540
+
541
+ =============================== ===== ================================================================================= ===============================
542
+ Column Name Units Description Can Be Stochastically Generated
543
+ =============================== ===== ================================================================================= ===============================
544
+ ``occupants`` frac Occupant heat gain schedule. Yes
545
+ ``lighting_interior`` frac Interior lighting energy use schedule. Yes
546
+ ``lighting_exterior`` frac Exterior lighting energy use schedule. No
547
+ ``lighting_garage`` frac Garage lighting energy use schedule. Yes
548
+ ``lighting_exterior_holiday`` frac Exterior holiday lighting energy use schedule. No
549
+ ``cooking_range`` frac Cooking range & oven energy use schedule. Yes
550
+ ``refrigerator`` frac Primary refrigerator energy use schedule. No
551
+ ``extra_refrigerator`` frac Non-primary refrigerator energy use schedule. No
552
+ ``freezer`` frac Freezer energy use schedule. No
553
+ ``dishwasher`` frac Dishwasher energy use schedule. Yes
554
+ ``clothes_washer`` frac Clothes washer energy use schedule. Yes
555
+ ``clothes_dryer`` frac Clothes dryer energy use schedule. Yes
556
+ ``ceiling_fan`` frac Ceiling fan energy use schedule. Yes
557
+ ``plug_loads_other`` frac Other plug load energy use schedule. Yes
558
+ ``plug_loads_tv`` frac Television plug load energy use schedule. Yes
559
+ ``plug_loads_vehicle`` frac Electric vehicle plug load energy use schedule. No
560
+ ``plug_loads_well_pump`` frac Well pump plug load energy use schedule. No
561
+ ``fuel_loads_grill`` frac Grill fuel load energy use schedule. No
562
+ ``fuel_loads_lighting`` frac Lighting fuel load energy use schedule. No
563
+ ``fuel_loads_fireplace`` frac Fireplace fuel load energy use schedule. No
564
+ ``pool_pump`` frac Pool pump energy use schedule. No
565
+ ``pool_heater`` frac Pool heater energy use schedule. No
566
+ ``permanent_spa_pump`` frac Permanent spa pump energy use schedule. No
567
+ ``permanent_spa_heater`` frac Permanent spa heater energy use schedule. No
568
+ ``hot_water_dishwasher`` frac Dishwasher hot water use schedule. Yes
569
+ ``hot_water_clothes_washer`` frac Clothes washer hot water use schedule. Yes
570
+ ``hot_water_fixtures`` frac Fixtures (sinks, showers, baths) hot water use schedule. Yes
571
+ ``heating_setpoint`` F Thermostat heating setpoint schedule. No
572
+ ``cooling_setpoint`` F Thermostat cooling setpoint schedule. No
573
+ ``water_heater_setpoint`` F Water heater setpoint schedule. No
574
+ ``water_heater_operating_mode`` 0/1 Heat pump water heater operating mode schedule. 0=hybrid/auto, 1=heat pump only. No
575
+ ``battery`` frac Battery schedule. Positive for charging, negative for discharging. No
576
+ ``vacancy`` 0/1 Vacancy schedule. 0=occupied, 1=vacant. Automatically overrides other columns. N/A
577
+ ``outage`` 0/1 Power outage schedule. 0=power. 1=nopower. Automatically overrides other columns. N/A
578
+ =============================== ===== ================================================================================= ===============================
579
+
580
+ Columns with units of `frac` must be normalized to MAX=1; that is, these schedules only define *when* energy is used, not *how much* energy is used.
581
+ In other words, the amount of energy or hot water used in each simulation timestep is essentially the schedule value divided by the sum of all schedule values in the column, multiplied by the annual energy or hot water use.
582
+ Example schedule CSV files are provided in the ``HPXMLtoOpenStudio/resources/schedule_files`` directory.
583
+
584
+ The schedule file must have a full year of data even if the simulation is not an entire year.
585
+ Frequency of schedule values do not need to match the simulation timestep.
586
+ For example, hourly schedules can be used with a 10-minute simulation timestep, or 10-minute schedules can be used with an hourly simulation timestep.
587
+
588
+ A detailed stochastic occupancy schedule CSV file can also be automatically generated for you (see "Can Be Stochastically Generated" above for applicable columns); see the :ref:`usage_instructions` for the commands.
589
+ Inputs for the stochastic schedule generator are entered in ``/HPXML/Building/BuildingDetails/BuildingSummary/BuildingOccupancy/NumberofResidents`` and ``/HPXML/Building/Site/Address/StateCode``.
590
+ See :ref:`buildingoccupancy` and :ref:`buildingsite` for more information.
591
+
592
+ .. warning::
593
+
594
+ For simulations with daylight saving enabled (which is the default), EnergyPlus will skip forward an hour in the CSV on the "spring forward" day and repeat an hour on the "fall back" day.
595
+
596
+ Default Schedules
597
+ ~~~~~~~~~~~~~~~~~
598
+
599
+ If neither simple nor detailed inputs are provided, then schedules are defaulted.
600
+ Default schedules are typically smooth, averaged schedules.
601
+ These default schedules are described elsewhere in the documentation (e.g., see :ref:`buildingoccupancy` for the default occupant heat gain schedule).
602
+
603
+ .. _hvac_sizing_control:
604
+
605
+ HPXML HVAC Sizing Control
606
+ *************************
607
+
608
+ HVAC equipment sizing controls are entered in ``/HPXML/Building/BuildingDetails/BuildingSummary/extension/HVACSizingControl``.
609
+
610
+ ================================= ======== ===== =========== ======== ======== ============================================
611
+ Element Type Units Constraints Required Default Description
612
+ ================================= ======== ===== =========== ======== ======== ============================================
613
+ ``AllowIncreasedFixedCapacities`` boolean No false Logic for fixed capacity HVAC equipment [#]_
614
+ ``HeatPumpSizingMethodology`` string See [#]_ No HERS Logic for autosized heat pumps [#]_
615
+ ================================= ======== ===== =========== ======== ======== ============================================
616
+
617
+ .. [#] 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.
618
+ .. [#] HeatPumpSizingMethodology choices are 'ACCA', 'HERS', or 'MaxLoad'.
619
+ .. [#] 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.
620
+ If HeatPumpSizingMethodology is 'HERS', autosized heat pumps have their nominal capacity sized equal to the larger of heating/cooling design loads.
621
+ 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.
622
+
623
+ 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``.
624
+
625
+ ================================= ======== ====== =========== ======== ============ ============================================
626
+ Element Type Units Constraints Required Default Description
627
+ ================================= ======== ====== =========== ======== ============ ============================================
628
+ ``HeatingDesignTemperature`` double F No See [#]_ Heating design temperature
629
+ ``CoolingDesignTemperature`` double F No See [#]_ Cooling design temperature
630
+ ``HeatingSetpoint`` double F No 70 Conditioned space heating setpoint [#]_
631
+ ``CoolingSetpoint`` double F No 75 Conditioned space cooling setpoint [#]_
632
+ ``HumiditySetpoint`` double frac 0 - 1 No See [#]_ Conditioned space relative humidity
633
+ ``InternalLoadsSensible`` double Btu/hr No See [#]_ Sensible internal loads for cooling design load
634
+ ``InternalLoadsLatent`` double Btu/hr No 0 Latent internal loads for cooling design load
635
+ ``NumberofOccupants`` integer No #Beds+1 [#]_ Number of occupants for cooling design load
636
+ ================================= ======== ====== =========== ======== ============ ============================================
637
+
638
+ .. [#] If HeatingDesignTemperature not provided, the 99% heating design temperature is obtained from the DESIGN CONDITIONS header section inside the EPW weather file.
639
+ If not available in the EPW header, it is calculated from the 8760 hourly temperatures in the EPW.
640
+ .. [#] If CoolingDesignTemperature not provided, the 1% cooling design temperature is obtained from the DESIGN CONDITIONS header section inside the EPW weather file.
641
+ If not available in the EPW header, it is calculated from the 8760 hourly temperatures in the EPW.
642
+ .. [#] Any heating setpoint other than 70F is not in compliance with Manual J.
643
+ .. [#] Any cooling setpoint other than 75F is not in compliance with Manual J.
644
+ .. [#] If HumiditySetpoint not provided, defaults to 0.5 unless there is a dehumidifier with a lower setpoint, in which case that value is used.
645
+ .. [#] If InternalLoadsSensible not provided, defaults to 2400 Btu/hr if there is one refrigerator and no freezer, or 3600 Btu/hr if two refrigerators or a freezer.
646
+ This default represents loads that normally occur during the early evening in mid-summer.
647
+ Additional adjustments or custom internal loads can instead be specified here.
648
+ .. [#] If NumberofOccupants not provided, defaults to the number of bedrooms plus one per Manual J.
649
+ Each occupant produces an additional 230 Btu/hr sensible load and 200 Btu/hr latent load.
650
+
651
+ .. _shadingcontrol:
652
+
653
+ HPXML Shading Control
654
+ *********************
655
+
656
+ Shading controls for window and skylight summer/winter shading coefficients are entered in ``/HPXML/Building/BuildingDetails/BuildingSummary/extension/ShadingControl``.
657
+ If not provided, summer will be default based on the cooling season defined in the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_, using monthly average temperatures.
658
+ The remainder of the year is winter.
659
+
660
+ ==================================== ======== ======= ============= ======== ======= =====================================
661
+ Element Type Units Constraints Required Default Description
662
+ ==================================== ======== ======= ============= ======== ======= =====================================
663
+ ``SummerBeginMonth`` integer 1 - 12 Yes Summer shading start date
664
+ ``SummerBeginDayOfMonth`` integer 1 - 31 Yes Summer shading start date
665
+ ``SummerEndMonth`` integer 1 - 12 Yes Summer shading end date
666
+ ``SummerEndDayOfMonth`` integer 1 - 31 Yes Summer shading end date
667
+ ==================================== ======== ======= ============= ======== ======= =====================================
668
+
607
669
  HPXML Climate Zones
608
670
  -------------------
609
671
 
@@ -761,10 +823,13 @@ The presence of a flue or chimney with combustion air from conditioned space can
761
823
  ``extension/HasFlueOrChimneyInConditionedSpace`` boolean No See [#]_ Flue or chimney with combustion air from conditioned space
762
824
  ================================================ ======= ===== =========== ========= ======== ===============================================
763
825
 
764
- .. [#] | If HasFlueOrChimneyInConditionedSpace not provided, defaults to true if any of the following conditions are met, otherwise false:
765
- | - heating system is non-electric Furnace, Boiler, WallFurnace, FloorFurnace, Stove, PortableHeater, or FixedHeater located in conditioned space and AFUE/Percent is less than 0.89,
766
- | - heating system is non-electric Fireplace located in conditioned space, or
767
- | - water heater is non-electric with energy factor (or equivalent calculated from uniform energy factor) less than 0.63 and located in conditioned space.
826
+ .. [#] If HasFlueOrChimneyInConditionedSpace not provided, defaults to true if any of the following conditions are met, otherwise false:
827
+
828
+ \- heating system is non-electric Furnace, Boiler, WallFurnace, FloorFurnace, Stove, or SpaceHeater located in conditioned space and AFUE/Percent is less than 0.89,
829
+
830
+ \- heating system is non-electric Fireplace located in conditioned space, or
831
+
832
+ \- water heater is non-electric with energy factor (or equivalent calculated from uniform energy factor) less than 0.63 and located in conditioned space.
768
833
 
769
834
  HPXML Attics
770
835
  ************
@@ -796,6 +861,12 @@ If the dwelling unit has a vented crawlspace, crawlspace ventilation information
796
861
  .. [#] UnitofMeasure only choice is "SLA" (specific leakage area).
797
862
  .. [#] Value default based on `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_.
798
863
 
864
+ If the dwelling has a manufactured home belly-and-wing foundation, whether a
865
+ skirt is present can be optionally entered in
866
+ ``/HPXML/Building/BuildingDetails/Enclosure/Foundations/Foundation/FoundationType/BellyAndWing/SkirtPresent``.
867
+ The default, if that value is missing, is to assume there is a skirt present and
868
+ the floors above that foundation do not have exposure to the wind.
869
+
799
870
  HPXML Roofs
800
871
  ***********
801
872
 
@@ -822,25 +893,35 @@ For a multifamily building where the dwelling unit has another dwelling unit abo
822
893
  ``Insulation/AssemblyEffectiveRValue`` double F-ft2-hr/Btu > 0 Yes Assembly R-value [#]_
823
894
  ====================================== ================= ================ ===================== ========= ============================== ==================================
824
895
 
825
- .. [#] InteriorAdjacentTo choices are "attic - vented", "attic - unvented", "living space", or "garage".
896
+ .. [#] InteriorAdjacentTo choices are "attic - vented", "attic - unvented", "conditioned space", or "garage".
826
897
  See :ref:`hpxmllocations` for descriptions.
827
898
  .. [#] Orientation choices are "northeast", "east", "southeast", "south", "southwest", "west", "northwest", or "north"
828
899
  .. [#] If neither Azimuth nor Orientation provided, and it's a *pitched* roof, modeled as four surfaces of equal area facing every direction.
829
900
  Azimuth/Orientation is irrelevant for *flat* roofs.
830
901
  .. [#] RoofType choices are "asphalt or fiberglass shingles", "wood shingles or shakes", "shingles", "slate or tile shingles", "metal surfacing", "plastic/rubber/synthetic sheeting", "expanded polystyrene sheathing", "concrete", or "cool roof".
831
902
  .. [#] RoofColor choices are "light", "medium", "medium dark", "dark", or "reflective".
832
- .. [#] | If SolarAbsorptance not provided, defaults based on RoofType and RoofColor:
833
- | - **asphalt or fiberglass shingles**: dark=0.92, medium dark=0.89, medium=0.85, light=0.75, reflective=0.50
834
- | - **wood shingles or shakes**: dark=0.92, medium dark=0.89, medium=0.85, light=0.75, reflective=0.50
835
- | - **shingles**: dark=0.92, medium dark=0.89, medium=0.85, light=0.75, reflective=0.50
836
- | - **slate or tile shingles**: dark=0.90, medium dark=0.83, medium=0.75, light=0.60, reflective=0.30
837
- | - **metal surfacing**: dark=0.90, medium dark=0.83, medium=0.75, light=0.60, reflective=0.30
838
- | - **plastic/rubber/synthetic sheeting**: dark=0.90, medium dark=0.83, medium=0.75, light=0.60, reflective=0.30
839
- | - **expanded polystyrene sheathing**: dark=0.92, medium dark=0.89, medium=0.85, light=0.75, reflective=0.50
840
- | - **concrete**: dark=0.90, medium dark=0.83, medium=0.75, light=0.65, reflective=0.50
841
- | - **cool roof**: 0.30
903
+ .. [#] If SolarAbsorptance not provided, defaults based on RoofType and RoofColor:
904
+
905
+ \- **asphalt or fiberglass shingles**: dark=0.92, medium dark=0.89, medium=0.85, light=0.75, reflective=0.50
906
+
907
+ \- **wood shingles or shakes**: dark=0.92, medium dark=0.89, medium=0.85, light=0.75, reflective=0.50
908
+
909
+ \- **shingles**: dark=0.92, medium dark=0.89, medium=0.85, light=0.75, reflective=0.50
910
+
911
+ \- **slate or tile shingles**: dark=0.90, medium dark=0.83, medium=0.75, light=0.60, reflective=0.30
912
+
913
+ \- **metal surfacing**: dark=0.90, medium dark=0.83, medium=0.75, light=0.60, reflective=0.30
914
+
915
+ \- **plastic/rubber/synthetic sheeting**: dark=0.90, medium dark=0.83, medium=0.75, light=0.60, reflective=0.30
916
+
917
+ \- **expanded polystyrene sheathing**: dark=0.92, medium dark=0.89, medium=0.85, light=0.75, reflective=0.50
918
+
919
+ \- **concrete**: dark=0.90, medium dark=0.83, medium=0.75, light=0.65, reflective=0.50
920
+
921
+ \- **cool roof**: 0.30
922
+
842
923
  .. [#] InteriorFinish/Type choices are "gypsum board", "gypsum composite board", "plaster", "wood", "other", or "none".
843
- .. [#] InteriorFinish/Type defaults to "gypsum board" if InteriorAdjacentTo is living space, otherwise "none".
924
+ .. [#] InteriorFinish/Type defaults to "gypsum board" if InteriorAdjacentTo is conditioned space, otherwise "none".
844
925
  .. [#] AssemblyEffectiveRValue includes all material layers, interior/exterior air films, and insulation installation grade.
845
926
 
846
927
  HPXML Rim Joists
@@ -865,25 +946,31 @@ Each rim joist surface (i.e., the perimeter of floor joists typically found betw
865
946
 
866
947
  .. [#] ExteriorAdjacentTo choices are "outside", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
867
948
  See :ref:`hpxmllocations` for descriptions.
868
- .. [#] InteriorAdjacentTo choices are "living space", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", or "garage".
949
+ .. [#] InteriorAdjacentTo choices are "conditioned space", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", or "garage".
869
950
  See :ref:`hpxmllocations` for descriptions.
870
951
  .. [#] Orientation choices are "northeast", "east", "southeast", "south", "southwest", "west", "northwest", or "north"
871
952
  .. [#] If neither Azimuth nor Orientation provided, and it's an *exterior* rim joist, modeled as four surfaces of equal area facing every direction.
872
953
  Azimuth/Orientation is irrelevant for *interior* rim joists.
873
954
  .. [#] Siding choices are "wood siding", "vinyl siding", "stucco", "fiber cement siding", "brick veneer", "aluminum siding", "masonite siding", "composite shingle siding", "asbestos siding", "synthetic stucco", or "none".
874
955
  .. [#] Color choices are "light", "medium", "medium dark", "dark", or "reflective".
875
- .. [#] | If SolarAbsorptance not provided, defaults based on Color:
876
- | - **dark**: 0.95
877
- | - **medium dark**: 0.85
878
- | - **medium**: 0.70
879
- | - **light**: 0.50
880
- | - **reflective**: 0.30
956
+ .. [#] If SolarAbsorptance not provided, defaults based on Color:
957
+
958
+ \- **dark**: 0.95
959
+
960
+ \- **medium dark**: 0.85
961
+
962
+ \- **medium**: 0.70
963
+
964
+ \- **light**: 0.50
965
+
966
+ \- **reflective**: 0.30
967
+
881
968
  .. [#] AssemblyEffectiveRValue includes all material layers, interior/exterior air films, and insulation installation grade.
882
969
 
883
970
  HPXML Walls
884
971
  ***********
885
972
 
886
- Each wall surface not attached to a foundation space is entered as an ``/HPXML/Building/BuildingDetails/Enclosure/Walls/Wall``.
973
+ Each wall surface is entered as an ``/HPXML/Building/BuildingDetails/Enclosure/Walls/Wall``.
887
974
 
888
975
  ====================================== ================= ================ ===================== ============= =========== ====================================
889
976
  Element Type Units Constraints Required Default Notes
@@ -905,28 +992,35 @@ Each wall surface not attached to a foundation space is entered as an ``/HPXML/B
905
992
 
906
993
  .. [#] ExteriorAdjacentTo choices are "outside", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
907
994
  See :ref:`hpxmllocations` for descriptions.
908
- .. [#] InteriorAdjacentTo choices are "living space", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", or "garage".
995
+ .. [#] InteriorAdjacentTo choices are "conditioned space", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", or "garage".
909
996
  See :ref:`hpxmllocations` for descriptions.
910
997
  .. [#] WallType child element choices are ``WoodStud``, ``DoubleWoodStud``, ``ConcreteMasonryUnit``, ``StructuralInsulatedPanel``, ``InsulatedConcreteForms``, ``SteelFrame``, ``SolidConcrete``, ``StructuralBrick``, ``StrawBale``, ``Stone``, ``LogWall``, or ``Adobe``.
911
998
  .. [#] Orientation choices are "northeast", "east", "southeast", "south", "southwest", "west", "northwest", or "north"
912
999
  .. [#] If neither Azimuth nor Orientation provided, and it's an *exterior* wall, modeled as four surfaces of equal area facing every direction.
913
- Azimuth/Orientation is irrelevant for *interior* walls (e.g., between living space and garage).
1000
+ Azimuth/Orientation is irrelevant for *interior* walls (e.g., between conditioned space and garage).
914
1001
  .. [#] Siding choices are "wood siding", "vinyl siding", "stucco", "fiber cement siding", "brick veneer", "aluminum siding", "masonite siding", "composite shingle siding", "asbestos siding", "synthetic stucco", or "none".
915
1002
  .. [#] Color choices are "light", "medium", "medium dark", "dark", or "reflective".
916
- .. [#] | If SolarAbsorptance not provided, defaults based on Color:
917
- | - **dark**: 0.95
918
- | - **medium dark**: 0.85
919
- | - **medium**: 0.70
920
- | - **light**: 0.50
921
- | - **reflective**: 0.30
1003
+ .. [#] If SolarAbsorptance not provided, defaults based on Color:
1004
+
1005
+ \- **dark**: 0.95
1006
+
1007
+ \- **medium dark**: 0.85
1008
+
1009
+ \- **medium**: 0.70
1010
+
1011
+ \- **light**: 0.50
1012
+
1013
+ \- **reflective**: 0.30
1014
+
922
1015
  .. [#] InteriorFinish/Type choices are "gypsum board", "gypsum composite board", "plaster", "wood", "other", or "none".
923
- .. [#] InteriorFinish/Type defaults to "gypsum board" if InteriorAdjacentTo is living space or basement - conditioned, otherwise "none".
1016
+ .. [#] InteriorFinish/Type defaults to "gypsum board" if InteriorAdjacentTo is conditioned space or basement - conditioned, otherwise "none".
924
1017
  .. [#] AssemblyEffectiveRValue includes all material layers, interior/exterior air films, and insulation installation grade.
925
1018
 
926
1019
  HPXML Foundation Walls
927
1020
  **********************
928
1021
 
929
- Each wall surface attached to a foundation space is entered as an ``/HPXML/Building/BuildingDetails/Enclosure/FoundationWalls/FoundationWall``.
1022
+ Each foundation wall surface is entered as an ``/HPXML/Building/BuildingDetails/Enclosure/FoundationWalls/FoundationWall``.
1023
+ Any wall surface in contact with the ground is considered a foundation wall.
930
1024
 
931
1025
  ============================================================== ================= ================ =================== ========= ============== ====================================
932
1026
  Element Type Units Constraints Required Default Notes
@@ -1000,14 +1094,18 @@ Each floor/ceiling surface that is not in contact with the ground (Slab) nor adj
1000
1094
  ``Insulation/AssemblyEffectiveRValue`` double F-ft2-hr/Btu > 0 Yes Assembly R-value [#]_
1001
1095
  ====================================== ======== ============ =========== ======== ======== ============================
1002
1096
 
1003
- .. [#] ExteriorAdjacentTo choices are "outside", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
1097
+ .. [#] ExteriorAdjacentTo choices are "outside", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", "garage", "other housing unit", "other heated space", "other multifamily buffer space", "other non-freezing space", or "manufactured home underbelly".
1004
1098
  See :ref:`hpxmllocations` for descriptions.
1005
- .. [#] InteriorAdjacentTo choices are "living space", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", or "garage".
1099
+ .. [#] InteriorAdjacentTo choices are "conditioned space", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", or "garage".
1006
1100
  See :ref:`hpxmllocations` for descriptions.
1007
1101
  .. [#] FloorType child element choices are ``WoodFrame``, ``StructuralInsulatedPanel``, ``SteelFrame``, or ``SolidConcrete``.
1008
1102
  .. [#] InteriorFinish/Type choices are "gypsum board", "gypsum composite board", "plaster", "wood", "other", or "none".
1009
- .. [#] InteriorFinish/Type defaults to "gypsum board" if InteriorAdjacentTo is living space and the surface is a ceiling, otherwise "none".
1010
- .. [#] AssemblyEffectiveRValue includes all material layers, interior/exterior air films, and insulation installation grade.
1103
+ .. [#] InteriorFinish/Type defaults to "gypsum board" if InteriorAdjacentTo is conditioned space and the surface is a ceiling, otherwise "none".
1104
+ .. [#] AssemblyEffectiveRValue includes all material layers, interior/exterior
1105
+ air films, and insulation installation grade. For a manufactured home belly
1106
+ where the area of the belly wrap is different and usually greater than the
1107
+ floor area, the AssemblyEffectiveRValue should be adjusted to account for
1108
+ the surface area of the belly wrap and insulation.
1011
1109
 
1012
1110
  For floors adjacent to "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space", additional information is entered in ``Floor``.
1013
1111
 
@@ -1032,7 +1130,7 @@ Each space type that borders the ground (i.e., basement, crawlspace, garage, and
1032
1130
  ``Area`` double ft2 > 0 Yes Gross area
1033
1131
  ``Thickness`` double in >= 0 No See [#]_ Thickness [#]_
1034
1132
  ``ExposedPerimeter`` double ft >= 0 Yes Perimeter exposed to ambient conditions [#]_
1035
- ``DepthBelowGrade`` double ft >= 0 See [#]_ Depth from the top of the slab surface to grade
1133
+ ``DepthBelowGrade`` double ft >= 0 No See [#]_ Depth from the top of the slab surface to grade
1036
1134
  ``PerimeterInsulation/SystemIdentifier`` id Yes Unique identifier
1037
1135
  ``PerimeterInsulation/Layer/NominalRValue`` double F-ft2-hr/Btu >= 0 Yes R-value of vertical insulation
1038
1136
  ``PerimeterInsulation/Layer/InsulationDepth`` double ft >= 0 Yes Depth from top of slab to bottom of vertical insulation
@@ -1044,14 +1142,14 @@ Each space type that borders the ground (i.e., basement, crawlspace, garage, and
1044
1142
  ``extension/CarpetRValue`` double F-ft2-hr/Btu >= 0 No See [#]_ Carpet R-value
1045
1143
  ======================================================= ======== ============ =========== ========= ======== ====================================================
1046
1144
 
1047
- .. [#] InteriorAdjacentTo choices are "living space", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", or "garage".
1145
+ .. [#] InteriorAdjacentTo choices are "conditioned space", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", or "garage".
1048
1146
  See :ref:`hpxmllocations` for descriptions.
1049
1147
  .. [#] If Thickness not provided, defaults to 0 when adjacent to crawlspace and 4 inches for all other cases.
1050
1148
  .. [#] For a crawlspace with a dirt floor, enter a thickness of zero.
1051
1149
  .. [#] ExposedPerimeter includes any slab length that falls along the perimeter of the building's footprint (i.e., is exposed to ambient conditions).
1052
1150
  So a basement slab edge adjacent to a garage or crawlspace, for example, should not be included.
1053
- .. [#] DepthBelowGrade only required if the attached foundation has no ``FoundationWalls``.
1054
- For foundation types with walls, the the slab's position relative to grade is determined by the ``FoundationWall/DepthBelowGrade`` value.
1151
+ .. [#] If DepthBelowGrade not provided, defaults to zero for foundation types without walls.
1152
+ For foundation types with walls, DepthBelowGrade is ignored as the slab's position relative to grade is determined by the ``FoundationWall/DepthBelowGrade`` value(s).
1055
1153
  .. [#] InsulationWidth only required if InsulationSpansEntireSlab=true is not provided.
1056
1154
  .. [#] InsulationSpansEntireSlab=true only required if InsulationWidth is not provided.
1057
1155
  .. [#] If CarpetFraction not provided, defaults to 0.8 when adjacent to conditioned space, otherwise 0.0.
@@ -1087,17 +1185,21 @@ Each window or glass door area is entered as an ``/HPXML/Building/BuildingDetail
1087
1185
  .. [#] Summer vs winter shading seasons are determined per :ref:`shadingcontrol`.
1088
1186
  .. [#] InteriorShading/SummerShadingCoefficient default value indicates 30% reduction in solar heat gain, based on `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_.
1089
1187
  .. [#] InteriorShading/WinterShadingCoefficient default value indicates 15% reduction in solar heat gain, based on `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_.
1090
- .. [#] | GlassType choices are "clear" or "low-e". The ``UFactor`` and ``SHGC`` of the window will be adjusted depending on the ``GlassType``, based on correlations derived using `data reported by PNNL <https://labhomes.pnnl.gov/documents/PNNL_24444_Thermal_and_Optical_Properties_Low-E_Storm_Windows_Panels.pdf>`_.
1091
- | - **clear storm windows**: U-factor = U-factor of base window - (0.6435 * U-factor of base window - 0.1533); SHGC = 0.9 * SHGC of base window
1092
- | - **low-e storm windows**: U-factor = U-factor of base window - (0.766 * U-factor of base window - 0.1532); SHGC = 0.8 * SHGC of base window
1093
- | Note that a storm window is not allowed for a window with U-factor lower than 0.45.
1188
+ .. [#] GlassType choices are "clear" or "low-e". The ``UFactor`` and ``SHGC`` of the window will be adjusted depending on the ``GlassType``, based on correlations derived using `data reported by PNNL <https://labhomes.pnnl.gov/documents/PNNL_24444_Thermal_and_Optical_Properties_Low-E_Storm_Windows_Panels.pdf>`_.
1189
+
1190
+ \- **clear storm windows**: U-factor = U-factor of base window - (0.6435 * U-factor of base window - 0.1533); SHGC = 0.9 * SHGC of base window
1191
+
1192
+ \- **low-e storm windows**: U-factor = U-factor of base window - (0.766 * U-factor of base window - 0.1532); SHGC = 0.8 * SHGC of base window
1193
+
1194
+ Note that a storm window is not allowed for a window with U-factor lower than 0.45.
1195
+
1094
1196
  .. [#] FractionOperable reflects whether the windows are operable (can be opened), not how they are used by the occupants.
1095
1197
  If a ``Window`` represents a single window, the value should be 0 or 1.
1096
1198
  If a ``Window`` represents multiple windows (e.g., 4), the value should be between 0 and 1 (e.g., 0, 0.25, 0.5, 0.75, or 1).
1097
1199
  The total open window area for natural ventilation is calculated using A) the operable fraction, B) the assumption that 50% of the area of operable windows can be open, and C) the assumption that 20% of that openable area is actually opened by occupants whenever outdoor conditions are favorable for cooling.
1098
1200
  .. [#] AttachedToWall must reference a ``Wall`` or ``FoundationWall``.
1099
1201
 
1100
- If operable windows are defined, the availability of natural ventilation is entered in ``/HPXML/SoftwareInfo/extension``.
1202
+ If operable windows are defined, the availability of natural ventilation is entered in ``/HPXML/Building/BuildingDetails/BuildingSummary/extension``.
1101
1203
 
1102
1204
  ============================================= ======== ========= =========== ======== ======== ========================================================
1103
1205
  Element Type Units Constraints Required Default Notes
@@ -1191,10 +1293,14 @@ Each skylight is entered as an ``/HPXML/Building/BuildingDetails/Enclosure/Skyli
1191
1293
  .. [#] Orientation choices are "northeast", "east", "southeast", "south", "southwest", "west", "northwest", or "north"
1192
1294
  .. [#] GlassLayers choices are "single-pane", "double-pane", or "triple-pane".
1193
1295
  .. [#] Summer vs winter shading seasons are determined per :ref:`shadingcontrol`.
1194
- .. [#] | GlassType choices are "clear" or "low-e". The ``UFactor`` and ``SHGC`` of the skylight will be adjusted depending on the ``GlassType``, based on correlations derived using `data reported by PNNL <https://labhomes.pnnl.gov/documents/PNNL_24444_Thermal_and_Optical_Properties_Low-E_Storm_Windows_Panels.pdf>`_.
1195
- | - **clear storm windows**: U-factor = U-factor of base window - (0.6435 * U-factor of base window - 0.1533); SHGC = 0.9 * SHGC of base window
1196
- | - **low-e storm windows**: U-factor = U-factor of base window - (0.766 * U-factor of base window - 0.1532); SHGC = 0.8 * SHGC of base window
1197
- | Note that a storm window is not allowed for a skylight with U-factor lower than 0.45.
1296
+ .. [#] GlassType choices are "clear" or "low-e". The ``UFactor`` and ``SHGC`` of the skylight will be adjusted depending on the ``GlassType``, based on correlations derived using `data reported by PNNL <https://labhomes.pnnl.gov/documents/PNNL_24444_Thermal_and_Optical_Properties_Low-E_Storm_Windows_Panels.pdf>`_.
1297
+
1298
+ \- **clear storm windows**: U-factor = U-factor of base window - (0.6435 * U-factor of base window - 0.1533); SHGC = 0.9 * SHGC of base window
1299
+
1300
+ \- **low-e storm windows**: U-factor = U-factor of base window - (0.766 * U-factor of base window - 0.1532); SHGC = 0.8 * SHGC of base window
1301
+
1302
+ Note that a storm window is not allowed for a skylight with U-factor lower than 0.45.
1303
+
1198
1304
  .. [#] AttachedToRoof must reference a ``Roof``.
1199
1305
 
1200
1306
  If UFactor and SHGC are not provided and GlassLayers is not "glass block", additional information is entered in ``Skylight``.
@@ -1320,18 +1426,24 @@ Each heating system (other than a heat pump) is entered as an ``/HPXML/Building/
1320
1426
  ``FractionHeatLoadServed`` double frac 0 - 1 [#]_ See [#]_ Fraction of heating load served
1321
1427
  ================================= ======== ====== =========== ======== ============== ===============================
1322
1428
 
1323
- .. [#] UnitLocation choices are "living space", "basement - unconditioned", "basement - conditioned", "attic - unvented", "attic - vented", "garage", "crawlspace - unvented", "crawlspace - vented", "crawlspace - conditioned", "other exterior", "other housing unit", "other heated space", "other multifamily buffer space", "other non-freezing space", "roof deck", or "unconditioned space".
1324
- .. [#] | If UnitLocation not provided, defaults based on the distribution system:
1325
- | - **none**: "living space"
1326
- | - **air**: supply duct location with the largest area, otherwise "living space"
1327
- | - **hydronic**: same default logic as :ref:`waterheatingsystems`
1328
- | - **dse**: "living space" if ``FractionHeatLoadServed`` is 1, otherwise "unconditioned space"
1329
- .. [#] HeatingSystemType child element choices are ``ElectricResistance``, ``Furnace``, ``WallFurnace``, ``FloorFurnace``, ``Boiler``, ``Stove``, ``PortableHeater``, ``FixedHeater``, or ``Fireplace``.
1429
+ .. [#] UnitLocation choices are "conditioned space", "basement - unconditioned", "basement - conditioned", "attic - unvented", "attic - vented", "garage", "crawlspace - unvented", "crawlspace - vented", "crawlspace - conditioned", "other exterior", "other housing unit", "other heated space", "other multifamily buffer space", "other non-freezing space", "roof deck", "manufactured home belly", or "unconditioned space".
1430
+ .. [#] If UnitLocation not provided, defaults based on the distribution system:
1431
+
1432
+ \- **none**: "conditioned space"
1433
+
1434
+ \- **air**: supply duct location with the largest area, otherwise "conditioned space"
1435
+
1436
+ \- **hydronic**: same default logic as :ref:`waterheatingsystems`
1437
+
1438
+ \- **dse**: "conditioned space" if ``FractionHeatLoadServed`` is 1, otherwise "unconditioned space"
1439
+
1440
+ .. [#] HeatingSystemType child element choices are ``ElectricResistance``, ``Furnace``, ``WallFurnace``, ``FloorFurnace``, ``Boiler``, ``Stove``, ``SpaceHeater``, or ``Fireplace``.
1330
1441
  .. [#] HeatingSystemFuel choices are "electricity", "natural gas", "fuel oil", "fuel oil 1", "fuel oil 2", "fuel oil 4", "fuel oil 5/6", "diesel", "propane", "kerosene", "coal", "coke", "bituminous coal", "wood", or "wood pellets".
1331
1442
  For ``ElectricResistance``, "electricity" is required.
1332
1443
  .. [#] Heating capacity autosized per ACCA Manual J/S based on heating design load.
1333
1444
  .. [#] The sum of all ``FractionHeatLoadServed`` (across all HVAC systems) must be less than or equal to 1.
1334
1445
  .. [#] 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.
1446
+ 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.
1335
1447
 
1336
1448
  Electric Resistance
1337
1449
  ~~~~~~~~~~~~~~~~~~~
@@ -1428,9 +1540,11 @@ If an in-unit boiler if specified, additional information is entered in ``Heatin
1428
1540
  ``ElectricAuxiliaryEnergy`` double kWh/yr >= 0 No See [#]_ Electric auxiliary energy
1429
1541
  =========================== ======== ====== =========== ======== ======== =========================
1430
1542
 
1431
- .. [#] | If ElectricAuxiliaryEnergy not provided, defaults as follows:
1432
- | - **Oil boiler**: 330 kWh/yr
1433
- | - **Gas boiler**: 170 kWh/yr
1543
+ .. [#] If ElectricAuxiliaryEnergy not provided, defaults as follows:
1544
+
1545
+ \- **Oil boiler**: 330 kWh/yr
1546
+
1547
+ \- **Gas boiler**: 170 kWh/yr
1434
1548
 
1435
1549
  If instead a shared boiler is specified, additional information is entered in ``HeatingSystem``.
1436
1550
 
@@ -1442,10 +1556,14 @@ If instead a shared boiler is specified, additional information is entered in ``
1442
1556
  ``ElectricAuxiliaryEnergy`` or ``extension/FanCoilWatts`` double kWh/yr or W >= 0 No [#]_ Electric auxiliary energy or fan coil power
1443
1557
  ============================================================ ======== =========== =========== ======== ======== =========================
1444
1558
 
1445
- .. [#] | If ElectricAuxiliaryEnergy nor SharedLoopWatts provided, defaults as follows:
1446
- | - **Shared boiler w/ baseboard**: 220 kWh/yr
1447
- | - **Shared boiler w/ water loop heat pump**: 265 kWh/yr
1448
- | - **Shared boiler w/ fan coil**: 438 kWh/yr
1559
+ .. [#] If ElectricAuxiliaryEnergy nor SharedLoopWatts provided, defaults as follows:
1560
+
1561
+ \- **Shared boiler w/ baseboard**: 220 kWh/yr
1562
+
1563
+ \- **Shared boiler w/ water loop heat pump**: 265 kWh/yr
1564
+
1565
+ \- **Shared boiler w/ fan coil**: 438 kWh/yr
1566
+
1449
1567
  .. [#] FanCoilWatts only used if boiler connected to fan coil and SharedLoopWatts provided.
1450
1568
 
1451
1569
  Stove
@@ -1462,10 +1580,10 @@ If a stove is specified, additional information is entered in ``HeatingSystem``.
1462
1580
  ``extension/FanPowerWatts`` double W >= 0 No 40 Fan power
1463
1581
  ==================================================== ======= ====== =========== ======== ========= ===================
1464
1582
 
1465
- Portable/Fixed Heater
1466
- ~~~~~~~~~~~~~~~~~~~~~
1583
+ Space Heater
1584
+ ~~~~~~~~~~~~
1467
1585
 
1468
- If a portable heater or fixed heater is specified, additional information is entered in ``HeatingSystem``.
1586
+ If a space heater (portable or fixed) is specified, additional information is entered in ``HeatingSystem``.
1469
1587
 
1470
1588
  ================================================== ====== ===== =========== ======== ========= ===================
1471
1589
  Element Type Units Constraints Required Default Notes
@@ -1505,11 +1623,15 @@ Each cooling system (other than a heat pump) is entered as an ``/HPXML/Building/
1505
1623
  ``FractionCoolLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of cooling load served
1506
1624
  ========================== ======== ====== =========== ======== ======== ===============================
1507
1625
 
1508
- .. [#] UnitLocation choices are "living space", "basement - unconditioned", "basement - conditioned", "attic - unvented", "attic - vented", "garage", "crawlspace - unvented", "crawlspace - vented", "crawlspace - conditioned", "other exterior", "other housing unit", "other heated space", "other multifamily buffer space", "other non-freezing space", "roof deck", or "unconditioned space".
1509
- .. [#] | If UnitLocation not provided, defaults based on the distribution system:
1510
- | - **none**: "living space"
1511
- | - **air**: supply duct location with the largest area, otherwise "living space"
1512
- | - **dse**: "living space" if ``FractionCoolLoadServed`` is 1, otherwise "unconditioned space"
1626
+ .. [#] UnitLocation choices are "conditioned space", "basement - unconditioned", "basement - conditioned", "attic - unvented", "attic - vented", "garage", "crawlspace - unvented", "crawlspace - vented", "crawlspace - conditioned", "other exterior", "other housing unit", "other heated space", "other multifamily buffer space", "other non-freezing space", "roof deck", "manufactured home belly", or "unconditioned space".
1627
+ .. [#] If UnitLocation not provided, defaults based on the distribution system:
1628
+
1629
+ \- **none**: "conditioned space"
1630
+
1631
+ \- **air**: supply duct location with the largest area, otherwise "conditioned space"
1632
+
1633
+ \- **dse**: "conditioned space" if ``FractionCoolLoadServed`` is 1, otherwise "unconditioned space"
1634
+
1513
1635
  .. [#] CoolingSystemType choices are "central air conditioner", "room air conditioner", "evaporative cooler", "mini-split", "chiller", "cooling tower", or "packaged terminal air conditioner".
1514
1636
  .. [#] CoolingSystemFuel only choice is "electricity".
1515
1637
  .. [#] The sum of all ``FractionCoolLoadServed`` (across all HVAC systems) must be less than or equal to 1.
@@ -1519,26 +1641,28 @@ Central Air Conditioner
1519
1641
 
1520
1642
  If a central air conditioner is specified, additional information is entered in ``CoolingSystem``.
1521
1643
 
1522
- ================================================================ ====== =========== =========== ======== ============== ===========================================================
1523
- Element Type Units Constraints Required Default Notes
1524
- ================================================================ ====== =========== =========== ======== ============== ===========================================================
1525
- ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
1526
- ``AnnualCoolingEfficiency[Units="SEER" or Units="SEER2"]/Value`` double Btu/Wh or # > 0 Yes Rated efficiency [#]_
1527
- ``CoolingCapacity`` double Btu/hr >= 0 No autosized [#]_ Cooling output capacity
1528
- ``SensibleHeatFraction`` double frac 0 - 1 No See [#]_ Sensible heat fraction
1529
- ``CompressorType`` string See [#]_ No See [#]_ Type of compressor
1530
- ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Blower fan efficiency at maximum fan speed [#]_
1531
- ``extension/AirflowDefectRatio`` double frac -0.9 - 9 No 0.0 Deviation between design/installed airflows [#]_
1532
- ``extension/ChargeDefectRatio`` double frac -0.9 - 9 No 0.0 Deviation between design/installed refrigerant charges [#]_
1533
- ``extension/CrankcaseHeaterPowerWatts`` double W No 50.0 Crankcase heater power
1534
- ================================================================ ====== =========== =========== ======== ============== ===========================================================
1644
+ ================================================================ ======= =========== =========== ======== ============== ===========================================================
1645
+ Element Type Units Constraints Required Default Notes
1646
+ ================================================================ ======= =========== =========== ======== ============== ===========================================================
1647
+ ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
1648
+ ``CoolingCapacity`` double Btu/hr >= 0 No autosized [#]_ Cooling output capacity
1649
+ ``CompressorType`` string See [#]_ No See [#]_ Type of compressor
1650
+ ``AnnualCoolingEfficiency[Units="SEER" or Units="SEER2"]/Value`` double Btu/Wh or # > 0 Yes Rated efficiency [#]_
1651
+ ``SensibleHeatFraction`` double frac 0 - 1 No See [#]_ Sensible heat fraction
1652
+ ``CoolingDetailedPerformanceData`` element No <none> Cooling detailed performance data [#]_
1653
+ ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Blower fan efficiency at maximum fan speed [#]_
1654
+ ``extension/AirflowDefectRatio`` double frac -0.9 - 9 No 0.0 Deviation between design/installed airflows [#]_
1655
+ ``extension/ChargeDefectRatio`` double frac -0.9 - 9 No 0.0 Deviation between design/installed refrigerant charges [#]_
1656
+ ``extension/CrankcaseHeaterPowerWatts`` double W No 50.0 Crankcase heater power
1657
+ ================================================================ ======= =========== =========== ======== ============== ===========================================================
1535
1658
 
1536
1659
  .. [#] HVACDistribution type must be AirDistribution (type: "regular velocity") or DSE.
1537
- .. [#] If SEER2 provided, converted to SEER using ANSI/RESNET/ICC 301-2022 Addendum C, where SEER = SEER2 / 0.95 (assumed to be a split system).
1538
1660
  .. [#] Cooling capacity autosized per ACCA Manual J/S based on cooling design load.
1539
- .. [#] If not provided, defaults to 0.73 for single/two stage and 0.78 for variable speed.
1540
1661
  .. [#] CompressorType choices are "single stage", "two stage", or "variable speed".
1541
1662
  .. [#] If CompressorType not provided, defaults to "single stage" if SEER <= 15, else "two stage" if SEER <= 21, else "variable speed".
1663
+ .. [#] If SEER2 provided, converted to SEER using ANSI/RESNET/ICC 301-2022 Addendum C, where SEER = SEER2 / 0.95 (assumed to be a split system).
1664
+ .. [#] If SensibleHeatFraction not provided, defaults to 0.73 for single/two stage and 0.78 for variable speed.
1665
+ .. [#] If CoolingDetailedPerformanceData is provided, see :ref:`clg_detailed_perf_data`.
1542
1666
  .. [#] If FanPowerWattsPerCFM not provided, defaults to using attached furnace W/cfm if available, else 0.5 W/cfm if SEER <= 13.5, else 0.375 W/cfm.
1543
1667
  .. [#] If there is a heating system attached to the DistributionSystem, the heating and cooling systems cannot have different values for FanPowerWattsPerCFM.
1544
1668
  .. [#] AirflowDefectRatio is defined as (InstalledAirflow - DesignAirflow) / DesignAirflow; a value of zero means no airflow defect.
@@ -1555,15 +1679,15 @@ If a room air conditioner is specified, additional information is entered in ``C
1555
1679
  ================================================================== ====== ====== =========== ======== ============== ============================================
1556
1680
  Element Type Units Constraints Required Default Notes
1557
1681
  ================================================================== ====== ====== =========== ======== ============== ============================================
1558
- ``AnnualCoolingEfficiency[Units="EER" or Units="CEER"]/Value`` double Btu/Wh > 0 Yes Rated efficiency
1559
1682
  ``CoolingCapacity`` double Btu/hr >= 0 No autosized [#]_ Cooling output capacity
1683
+ ``AnnualCoolingEfficiency[Units="EER" or Units="CEER"]/Value`` double Btu/Wh > 0 Yes Rated efficiency
1560
1684
  ``SensibleHeatFraction`` double frac 0 - 1 No 0.65 Sensible heat fraction
1561
1685
  ``IntegratedHeatingSystemFuel`` string See [#]_ No <none> Fuel type of integrated heater
1562
1686
  ``extension/CrankcaseHeaterPowerWatts`` double W No 0.0 Crankcase heater power
1563
1687
  ================================================================== ====== ====== =========== ======== ============== ============================================
1564
1688
 
1565
- .. [#] IntegratedHeatingSystemFuel choices are "electricity", "natural gas", "fuel oil", "fuel oil 1", "fuel oil 2", "fuel oil 4", "fuel oil 5/6", "diesel", "propane", "kerosene", "coal", "coke", "bituminous coal", "wood", or "wood pellets".
1566
1689
  .. [#] Cooling capacity autosized per ACCA Manual J/S based on cooling design load.
1690
+ .. [#] IntegratedHeatingSystemFuel choices are "electricity", "natural gas", "fuel oil", "fuel oil 1", "fuel oil 2", "fuel oil 4", "fuel oil 5/6", "diesel", "propane", "kerosene", "coal", "coke", "bituminous coal", "wood", or "wood pellets".
1567
1691
 
1568
1692
  If the room air conditioner has integrated heating, additional information is entered in ``CoolingSystem``.
1569
1693
  Note that a room air conditioner with reverse cycle heating should be entered as a heat pump; see :ref:`room_ac_reverse_cycle`.
@@ -1587,8 +1711,8 @@ If a PTAC is specified, additional information is entered in ``CoolingSystem``.
1587
1711
  ================================================================== ====== ====== =========== ======== ============== ==========================================
1588
1712
  Element Type Units Constraints Required Default Notes
1589
1713
  ================================================================== ====== ====== =========== ======== ============== ==========================================
1590
- ``AnnualCoolingEfficiency[Units="EER" or Units="CEER"]/Value`` double Btu/Wh > 0 Yes Rated efficiency
1591
1714
  ``CoolingCapacity`` double Btu/hr >= 0 No autosized [#]_ Cooling output capacity
1715
+ ``AnnualCoolingEfficiency[Units="EER" or Units="CEER"]/Value`` double Btu/Wh > 0 Yes Rated efficiency
1592
1716
  ``SensibleHeatFraction`` double frac 0 - 1 No 0.65 Sensible heat fraction
1593
1717
  ``IntegratedHeatingSystemFuel`` string See [#]_ No <none> Fuel type of integrated heater
1594
1718
  ``extension/CrankcaseHeaterPowerWatts`` double W No 0.0 Crankcase heater power
@@ -1623,7 +1747,7 @@ If an evaporative cooler is specified, additional information is entered in ``Co
1623
1747
  ``CoolingCapacity`` double Btu/hr >= 0 No autosized [#]_ Cooling output capacity
1624
1748
  ================================= ======== ====== =========== ======== ============== ==================================
1625
1749
 
1626
- .. [#] If provided, HVACDistribution type must be AirDistribution (type: "regular velocity") or DSE.
1750
+ .. [#] If DistributionSystem provided, HVACDistribution type must be AirDistribution (type: "regular velocity") or DSE.
1627
1751
  .. [#] Cooling capacity autosized per ACCA Manual J/S based on cooling design load.
1628
1752
 
1629
1753
  Mini-Split Air Conditioner
@@ -1635,18 +1759,22 @@ If a mini-split air conditioner is specified, additional information is entered
1635
1759
  Element Type Units Constraints Required Default Notes
1636
1760
  ================================================================ ======== ====== =========== ======== ============== ===========================================================
1637
1761
  ``DistributionSystem`` idref See [#]_ No ID of attached distribution system
1638
- ``AnnualCoolingEfficiency[Units="SEER" or Units="SEER2"]/Value`` double Btu/Wh > 0 Yes Rated cooling efficiency [#]_
1639
1762
  ``CoolingCapacity`` double Btu/hr >= 0 No autosized [#]_ Cooling output capacity
1763
+ ``CompressorType`` string See [#]_ No variable speed Type of compressor
1764
+ ``AnnualCoolingEfficiency[Units="SEER" or Units="SEER2"]/Value`` double Btu/Wh > 0 Yes Rated cooling efficiency [#]_
1640
1765
  ``SensibleHeatFraction`` double frac 0 - 1 No 0.73 Sensible heat fraction
1766
+ ``CoolingDetailedPerformanceData`` element No <none> Cooling detailed performance data [#]_
1641
1767
  ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Blower fan efficiency at maximum fan speed
1642
1768
  ``extension/AirflowDefectRatio`` double frac -0.9 - 9 No 0.0 Deviation between design/installed airflows [#]_
1643
1769
  ``extension/ChargeDefectRatio`` double frac -0.9 - 9 No 0.0 Deviation between design/installed refrigerant charges [#]_
1644
1770
  ``extension/CrankcaseHeaterPowerWatts`` double W No 50.0 Crankcase heater power
1645
1771
  ================================================================ ======== ====== =========== ======== ============== ===========================================================
1646
1772
 
1647
- .. [#] If provided, HVACDistribution type must be AirDistribution (type: "regular velocity") or DSE.
1648
- .. [#] If SEER2 provided, converted to SEER using ANSI/RESNET/ICC 301-2022 Addendum C, where SEER = SEER2 / 0.95 if ducted and SEER = SEER2 if ductless.
1773
+ .. [#] If DistributionSystem provided, HVACDistribution type must be AirDistribution (type: "regular velocity") or DSE.
1649
1774
  .. [#] Cooling capacity autosized per ACCA Manual J/S based on cooling design load.
1775
+ .. [#] CompressorType only choices is "variable speed" (i.e., they are assumed to be inverter driven).
1776
+ .. [#] If SEER2 provided, converted to SEER using ANSI/RESNET/ICC 301-2022 Addendum C, where SEER = SEER2 / 0.95 if ducted and SEER = SEER2 if ductless.
1777
+ .. [#] If CoolingDetailedPerformanceData is provided, see :ref:`clg_detailed_perf_data`.
1650
1778
  .. [#] FanPowerWattsPerCFM defaults to 0.07 W/cfm for ductless systems and 0.18 W/cfm for ducted systems.
1651
1779
  .. [#] AirflowDefectRatio is defined as (InstalledAirflow - DesignAirflow) / DesignAirflow; a value of zero means no airflow defect.
1652
1780
  A non-zero airflow defect can only be applied for systems attached to a distribution system.
@@ -1654,10 +1782,6 @@ If a mini-split air conditioner is specified, additional information is entered
1654
1782
  .. [#] ChargeDefectRatio is defined as (InstalledCharge - DesignCharge) / DesignCharge; a value of zero means no refrigerant charge defect.
1655
1783
  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.
1656
1784
  See ANSI/RESNET/ACCA 310-2020 Standard for Grading the Installation of HVAC Systems for more information.
1657
-
1658
- .. note::
1659
-
1660
- Mini-splits do not have a ``CompressorType`` input because they are assumed to be inverter driven (variable speed).
1661
1785
 
1662
1786
  .. _hvac_cooling_chiller:
1663
1787
 
@@ -1669,8 +1793,8 @@ If a chiller is specified, additional information is entered in ``CoolingSystem`
1669
1793
  ========================================================================== ======== ====== =========== ======== ========= =========================================
1670
1794
  Element Type Units Constraints Required Default Notes
1671
1795
  ========================================================================== ======== ====== =========== ======== ========= =========================================
1672
- ``IsSharedSystem`` boolean true Yes Whether it serves multiple dwelling units
1673
1796
  ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
1797
+ ``IsSharedSystem`` boolean true Yes Whether it serves multiple dwelling units
1674
1798
  ``NumberofUnitsServed`` integer > 1 Yes Number of dwelling units served
1675
1799
  ``CoolingCapacity`` double Btu/hr >= 0 Yes Total cooling output capacity
1676
1800
  ``AnnualCoolingEfficiency[Units="kW/ton"]/Value`` double kW/ton > 0 Yes Rated efficiency
@@ -1696,8 +1820,8 @@ If a cooling tower is specified, additional information is entered in ``CoolingS
1696
1820
  ========================================================================== ======== ====== =========== ======== ========= =========================================
1697
1821
  Element Type Units Constraints Required Default Notes
1698
1822
  ========================================================================== ======== ====== =========== ======== ========= =========================================
1699
- ``IsSharedSystem`` boolean true Yes Whether it serves multiple dwelling units
1700
1823
  ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
1824
+ ``IsSharedSystem`` boolean true Yes Whether it serves multiple dwelling units
1701
1825
  ``NumberofUnitsServed`` integer > 1 Yes Number of dwelling units served
1702
1826
  ``extension/SharedLoopWatts`` double W >= 0 Yes Pumping and fan power serving the system
1703
1827
  ========================================================================== ======== ====== =========== ======== ========= =========================================
@@ -1726,15 +1850,21 @@ Each heat pump is entered as an ``/HPXML/Building/BuildingDetails/Systems/HVAC/H
1726
1850
  ``BackupType`` string See [#]_ No <none> Type of backup heating
1727
1851
  ================================= ======== ====== =========== ======== ========= ===============================================
1728
1852
 
1729
- .. [#] UnitLocation choices are "living space", "basement - unconditioned", "basement - conditioned", "attic - unvented", "attic - vented", "garage", "crawlspace - unvented", "crawlspace - vented", "crawlspace - conditioned", "other exterior", "other housing unit", "other heated space", "other multifamily buffer space", "other non-freezing space", "roof deck", or "unconditioned space".
1730
- .. [#] | If UnitLocation not provided, defaults based on the distribution system:
1731
- | - **none**: "living space"
1732
- | - **air**: supply duct location with the largest area, otherwise "living space"
1733
- | - **hydronic**: same default logic as :ref:`waterheatingsystems`
1734
- | - **dse**: "living space" if ``FractionHeatLoadServed``/``FractionCoolLoadServed`` are 1, otherwise "unconditioned space"
1853
+ .. [#] UnitLocation choices are "conditioned space", "basement - unconditioned", "basement - conditioned", "attic - unvented", "attic - vented", "garage", "crawlspace - unvented", "crawlspace - vented", "crawlspace - conditioned", "other exterior", "other housing unit", "other heated space", "other multifamily buffer space", "other non-freezing space", "roof deck", "manufactured home belly", or "unconditioned space".
1854
+ .. [#] If UnitLocation not provided, defaults based on the distribution system:
1855
+
1856
+ \- **none**: "conditioned space"
1857
+
1858
+ \- **air**: supply duct location with the largest area, otherwise "conditioned space"
1859
+
1860
+ \- **hydronic**: same default logic as :ref:`waterheatingsystems`
1861
+
1862
+ \- **dse**: "conditioned space" if ``FractionHeatLoadServed``/``FractionCoolLoadServed`` are 1, otherwise "unconditioned space"
1863
+
1735
1864
  .. [#] HeatPumpType choices are "air-to-air", "mini-split", "ground-to-air", "water-loop-to-air", "packaged terminal heat pump", or "room air conditioner with reverse cycle".
1736
1865
  .. [#] HeatPumpFuel only choice is "electricity".
1737
1866
  .. [#] BackupType choices are "integrated" or "separate".
1867
+ 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.
1738
1868
  Use "integrated" if the heat pump's distribution system and blower fan power applies to the backup heating (e.g., built-in electric strip heat or an integrated backup furnace, i.e., a dual-fuel heat pump).
1739
1869
  Use "separate" if the backup system has its own distribution system (e.g., electric baseboard or a boiler).
1740
1870
 
@@ -1743,26 +1873,28 @@ Air-to-Air Heat Pump
1743
1873
 
1744
1874
  If an air-to-air heat pump is specified, additional information is entered in ``HeatPump``.
1745
1875
 
1746
- ================================================================ ====== ======== ======================== ======== ============== =================================================
1747
- Element Type Units Constraints Required Default Notes
1748
- ================================================================ ====== ======== ======================== ======== ============== =================================================
1749
- ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
1750
- ``HeatingCapacity`` double Btu/hr >= 0 No autosized [#]_ Heating output capacity (excluding any backup heating)
1751
- ``HeatingCapacity17F`` double Btu/hr >= 0, <= HeatingCapacity No Heating output capacity at 17F, if available
1752
- ``CoolingCapacity`` double Btu/hr >= 0 No autosized [#]_ Cooling output capacity
1753
- ``CompressorType`` string See [#]_ No See [#]_ Type of compressor
1754
- ``CompressorLockoutTemperature`` double F No See [#]_ Minimum outdoor temperature for compressor operation
1755
- ``CoolingSensibleHeatFraction`` double frac 0 - 1 No See [#]_ Sensible heat fraction
1756
- ``FractionHeatLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of heating load served
1757
- ``FractionCoolLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of cooling load served
1758
- ``AnnualCoolingEfficiency[Units="SEER" or Units="SEER2"]/Value`` double Btu/Wh > 0 Yes Rated cooling efficiency [#]_
1759
- ``AnnualHeatingEfficiency[Units="HSPF" or Units="HSPF2"]/Value`` double Btu/Wh > 0 Yes Rated heating efficiency [#]_
1760
- ``extension/HeatingCapacityRetention[Fraction | Temperature]`` double frac | F >= 0, < 1 | <= 17 No See [#]_ Heating output capacity retention at cold temperature [#]_
1761
- ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Blower fan efficiency at maximum fan speed
1762
- ``extension/AirflowDefectRatio`` double frac -0.9 - 9 No 0.0 Deviation between design/installed airflows [#]_
1763
- ``extension/ChargeDefectRatio`` double frac -0.9 - 9 No 0.0 Deviation between design/installed refrigerant charges [#]_
1764
- ``extension/CrankcaseHeaterPowerWatts`` double W No 50.0 Crankcase heater power
1765
- ================================================================ ====== ======== ======================== ======== ============== =================================================
1876
+ ================================================================ ======= ======== ======================== ======== ============== =================================================
1877
+ Element Type Units Constraints Required Default Notes
1878
+ ================================================================ ======= ======== ======================== ======== ============== =================================================
1879
+ ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
1880
+ ``HeatingCapacity`` double Btu/hr >= 0 No autosized [#]_ Heating output capacity (excluding any backup heating)
1881
+ ``HeatingCapacity17F`` double Btu/hr >= 0, <= HeatingCapacity No Heating output capacity at 17F, if available
1882
+ ``CoolingCapacity`` double Btu/hr >= 0 No autosized [#]_ Cooling output capacity
1883
+ ``CompressorType`` string See [#]_ No See [#]_ Type of compressor
1884
+ ``CompressorLockoutTemperature`` double F No See [#]_ Minimum outdoor temperature for compressor operation
1885
+ ``CoolingSensibleHeatFraction`` double frac 0 - 1 No See [#]_ Sensible heat fraction
1886
+ ``FractionHeatLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of heating load served
1887
+ ``FractionCoolLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of cooling load served
1888
+ ``AnnualCoolingEfficiency[Units="SEER" or Units="SEER2"]/Value`` double Btu/Wh > 0 Yes Rated cooling efficiency [#]_
1889
+ ``AnnualHeatingEfficiency[Units="HSPF" or Units="HSPF2"]/Value`` double Btu/Wh > 0 Yes Rated heating efficiency [#]_
1890
+ ``CoolingDetailedPerformanceData`` element No <none> Cooling detailed performance data [#]_
1891
+ ``HeatingDetailedPerformanceData`` element No <none> Heating detailed performance data [#]_
1892
+ ``extension/HeatingCapacityRetention[Fraction | Temperature]`` double frac | F >= 0, < 1 | <= 17 No See [#]_ Heating output capacity retention at cold temperature [#]_
1893
+ ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Blower fan efficiency at maximum fan speed
1894
+ ``extension/AirflowDefectRatio`` double frac -0.9 - 9 No 0.0 Deviation between design/installed airflows [#]_
1895
+ ``extension/ChargeDefectRatio`` double frac -0.9 - 9 No 0.0 Deviation between design/installed refrigerant charges [#]_
1896
+ ``extension/CrankcaseHeaterPowerWatts`` double W No 50.0 Crankcase heater power
1897
+ ================================================================ ======= ======== ======================== ======== ============== =================================================
1766
1898
 
1767
1899
  .. [#] HVACDistribution type must be AirDistribution (type: "regular velocity") or DSE.
1768
1900
  .. [#] Heating capacity autosized per ACCA Manual J/S based on heating design load (unless a different HeatPumpSizingMethodology was selected in :ref:`hvac_sizing_control`).
@@ -1770,14 +1902,21 @@ If an air-to-air heat pump is specified, additional information is entered in ``
1770
1902
  .. [#] CompressorType choices are "single stage", "two stage", or "variable speed".
1771
1903
  .. [#] If CompressorType not provided, defaults to "single stage" if SEER <= 15, else "two stage" if SEER <= 21, else "variable speed".
1772
1904
  .. [#] If neither CompressorLockoutTemperature nor BackupHeatingSwitchoverTemperature provided, CompressorLockoutTemperature defaults to 25F if fossil fuel backup otherwise 0F.
1773
- .. [#] If not provided, defaults to 0.73 for single/two stage and 0.78 for variable speed.
1905
+ .. [#] If SensibleHeatFraction not provided, defaults to 0.73 for single/two stage and 0.78 for variable speed.
1774
1906
  .. [#] The sum of all ``FractionHeatLoadServed`` (across all HVAC systems) must be less than or equal to 1.
1775
1907
  .. [#] The sum of all ``FractionCoolLoadServed`` (across all HVAC systems) must be less than or equal to 1.
1776
1908
  .. [#] If SEER2 provided, converted to SEER using ANSI/RESNET/ICC 301-2022 Addendum C, where SEER = SEER2 / 0.95 (assumed to be a split system).
1777
1909
  .. [#] If HSPF2 provided, converted to HSPF using ANSI/RESNET/ICC 301-2022 Addendum C, where HSPF = HSPF2 / 0.85 (assumed to be a split system).
1778
- .. [#] | If neither extension/HeatingCapacityRetention nor HeatingCapacity17F provided, heating capacity retention defaults based on CompressorType:
1779
- | - **single/two stage**: 0.425 at 5F
1780
- | - **variable speed**: 0.5 at 5F
1910
+ .. [#] If CoolingDetailedPerformanceData is provided, see :ref:`clg_detailed_perf_data`.
1911
+ HeatingDetailedPerformanceData must also be provided.
1912
+ .. [#] If HeatingDetailedPerformanceData is provided, see :ref:`htg_detailed_perf_data`.
1913
+ CoolingDetailedPerformanceData must also be provided.
1914
+ .. [#] If neither extension/HeatingCapacityRetention nor HeatingCapacity17F nor HeatingDetailedPerformanceData provided, heating capacity retention defaults based on CompressorType:
1915
+
1916
+ \- **single/two stage**: 0.425 (at 5F)
1917
+
1918
+ \- **variable speed**: 0.0461 * HSPF + 0.1594 (at 5F)
1919
+
1781
1920
  .. [#] 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).
1782
1921
  Either input approach can be used, but not both.
1783
1922
  .. [#] If FanPowerWattsPerCFM not provided, defaulted to 0.5 W/cfm if HSPF <= 8.75, else 0.375 W/cfm.
@@ -1799,27 +1938,41 @@ If a mini-split heat pump is specified, additional information is entered in ``H
1799
1938
  ``HeatingCapacity`` double Btu/hr >= 0 No autosized [#]_ Heating output capacity (excluding any backup heating)
1800
1939
  ``HeatingCapacity17F`` double Btu/hr >= 0, <= HeatingCapacity No Heating output capacity at 17F, if available
1801
1940
  ``CoolingCapacity`` double Btu/hr >= 0 No autosized [#]_ Cooling output capacity
1941
+ ``CompressorType`` string See [#]_ No variable speed Type of compressor
1802
1942
  ``CompressorLockoutTemperature`` double F No See [#]_ Minimum outdoor temperature for compressor operation
1803
1943
  ``CoolingSensibleHeatFraction`` double frac 0 - 1 No 0.73 Sensible heat fraction
1804
1944
  ``FractionHeatLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of heating load served
1805
1945
  ``FractionCoolLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of cooling load served
1806
1946
  ``AnnualCoolingEfficiency[Units="SEER" or Units="SEER2"]/Value`` double Btu/Wh > 0 Yes Rated cooling efficiency [#]_
1807
1947
  ``AnnualHeatingEfficiency[Units="HSPF" or Units="HSPF2"]/Value`` double Btu/Wh > 0 Yes Rated heating efficiency [#]_
1808
- ``extension/HeatingCapacityRetention[Fraction | Temperature]`` double frac | F >= 0, < 1 | <= 17 No 0.5 | 5 Heating output capacity retention at cold temperature [#]_
1948
+ ``CoolingDetailedPerformanceData`` element No <none> Cooling detailed performance data [#]_
1949
+ ``HeatingDetailedPerformanceData`` element No <none> Heating detailed performance data [#]_
1950
+ ``extension/HeatingCapacityRetention[Fraction | Temperature]`` double frac | F >= 0, < 1 | <= 17 No See [#]_ Heating output capacity retention at cold temperature [#]_
1809
1951
  ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Blower fan efficiency at maximum fan speed
1810
1952
  ``extension/AirflowDefectRatio`` double frac -0.9 - 9 No 0.0 Deviation between design/installed airflows [#]_
1811
1953
  ``extension/ChargeDefectRatio`` double frac -0.9 - 9 No 0.0 Deviation between design/installed refrigerant charges [#]_
1812
1954
  ``extension/CrankcaseHeaterPowerWatts`` double W No 50.0 Crankcase heater power
1813
1955
  ================================================================ ======== ======== ======================== ======== ============== ==============================================
1814
1956
 
1815
- .. [#] If provided, HVACDistribution type must be AirDistribution (type: "regular velocity") or DSE.
1957
+ .. [#] If DistributionSystem provided, HVACDistribution type must be AirDistribution (type: "regular velocity") or DSE.
1816
1958
  .. [#] Heating capacity autosized per ACCA Manual J/S based on heating design load (unless a different HeatPumpSizingMethodology was selected in :ref:`hvac_sizing_control`).
1817
1959
  .. [#] Cooling capacity autosized per ACCA Manual J/S based on cooling design load (unless a different HeatPumpSizingMethodology was selected in :ref:`hvac_sizing_control`).
1960
+ .. [#] CompressorType only choice is "variable speed" (i.e., they are assumed to be inverter driven).
1818
1961
  .. [#] If neither CompressorLockoutTemperature nor BackupHeatingSwitchoverTemperature provided, CompressorLockoutTemperature defaults to 25F if fossil fuel backup otherwise -20F.
1819
1962
  .. [#] The sum of all ``FractionHeatLoadServed`` (across all HVAC systems) must be less than or equal to 1.
1820
1963
  .. [#] The sum of all ``FractionCoolLoadServed`` (across all HVAC systems) must be less than or equal to 1.
1821
1964
  .. [#] If SEER2 provided, converted to SEER using ANSI/RESNET/ICC 301-2022 Addendum C, where SEER = SEER2 / 0.95 if ducted and SEER = SEER2 if ductless.
1822
1965
  .. [#] If HSPF2 provided, converted to HSPF using ANSI/RESNET/ICC 301-2022 Addendum C, where HSPF = HSPF2 / 0.85 if ducted and HSPF = HSPF2 / 0.90 if ductless.
1966
+ .. [#] If CoolingDetailedPerformanceData is provided, see :ref:`clg_detailed_perf_data`.
1967
+ HeatingDetailedPerformanceData must also be provided.
1968
+ .. [#] If HeatingDetailedPerformanceData is provided, see :ref:`htg_detailed_perf_data`.
1969
+ CoolingDetailedPerformanceData must also be provided.
1970
+ .. [#] If neither extension/HeatingCapacityRetention nor HeatingCapacity17F nor HeatingDetailedPerformanceData provided, heating capacity retention defaults based on CompressorType:
1971
+
1972
+ \- **single/two stage**: 0.425 (at 5F)
1973
+
1974
+ \- **variable speed**: 0.0461 * HSPF + 0.1594 (at 5F)
1975
+
1823
1976
  .. [#] 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).
1824
1977
  Either input approach can be used, but not both.
1825
1978
  .. [#] FanPowerWattsPerCFM defaults to 0.07 W/cfm for ductless systems and 0.18 W/cfm for ducted systems.
@@ -1830,10 +1983,6 @@ If a mini-split heat pump is specified, additional information is entered in ``H
1830
1983
  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.
1831
1984
  See ANSI/RESNET/ACCA 310-2020 Standard for Grading the Installation of HVAC Systems for more information.
1832
1985
 
1833
- .. note::
1834
-
1835
- Mini-splits do not have a ``CompressorType`` input because they are assumed to be inverter driven (variable speed).
1836
-
1837
1986
  .. _pthp:
1838
1987
 
1839
1988
  Packaged Terminal Heat Pump
@@ -1852,7 +2001,7 @@ If a packaged terminal heat pump is specified, additional information is entered
1852
2001
  ``FractionHeatLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of heating load served
1853
2002
  ``FractionCoolLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of cooling load served
1854
2003
  ``AnnualCoolingEfficiency[Units="EER" or Units="CEER"]/Value`` double Btu/Wh > 0 Yes Rated cooling efficiency
1855
- ``AnnualHeatingEfficiency[Units="COP"]/Value`` double Btu/Wh > 0 Yes Rated heating efficiency
2004
+ ``AnnualHeatingEfficiency[Units="COP"]/Value`` double W/W > 0 Yes Rated heating efficiency
1856
2005
  ``extension/HeatingCapacityRetention[Fraction | Temperature]`` double frac | F >= 0, < 1 | <= 17 No 0.425 | 5 Heating output capacity retention at cold temperature [#]_
1857
2006
  ``extension/CrankcaseHeaterPowerWatts`` double W No 0.0 Crankcase heater power
1858
2007
  =============================================================== ======== ======== ======================== ======== ============== ==============================================
@@ -1883,7 +2032,7 @@ If a room air conditioner with reverse cycle is specified, additional informatio
1883
2032
  ``FractionHeatLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of heating load served
1884
2033
  ``FractionCoolLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of cooling load served
1885
2034
  ``AnnualCoolingEfficiency[Units="EER" or Units="CEER"]/Value`` double Btu/Wh > 0 Yes Rated cooling efficiency
1886
- ``AnnualHeatingEfficiency[Units="COP"]/Value`` double Btu/Wh > 0 Yes Rated heating efficiency
2035
+ ``AnnualHeatingEfficiency[Units="COP"]/Value`` double W/W > 0 Yes Rated heating efficiency
1887
2036
  ``extension/HeatingCapacityRetention[Fraction | Temperature]`` double frac | F >= 0, < 1 | <= 17 No 0.425 | 5 Heating output capacity retention at cold temperature [#]_
1888
2037
  ``extension/CrankcaseHeaterPowerWatts`` double W No 0.0 Crankcase heater power
1889
2038
  =============================================================== ======== ======== ======================== ======== ============== ==============================================
@@ -1980,7 +2129,7 @@ If a backup type ("integrated" or "separate") is provided, additional informatio
1980
2129
  ============================================================================= ======== ====== =========== ======== ========= ==========================================
1981
2130
 
1982
2131
  .. [#] If neither BackupHeatingSwitchoverTemperature nor CompressorLockoutTemperature provided, CompressorLockoutTemperature defaults as described above for individual heat pump types.
1983
- .. [#] If both BackupHeatingLockoutTemperature and CompressorLockoutTemperature provided, BackupHeatingLockoutTemperature must be greater than CompressorLockoutTemperature.
2132
+ .. [#] If both BackupHeatingLockoutTemperature and CompressorLockoutTemperature provided, BackupHeatingLockoutTemperature must be greater than or equal to CompressorLockoutTemperature.
1984
2133
  .. [#] If neither BackupHeatingSwitchoverTemperature nor BackupHeatingLockoutTemperature provided, BackupHeatingLockoutTemperature defaults to 40F for electric backup and 50F for fossil fuel backup.
1985
2134
 
1986
2135
  .. note::
@@ -2022,6 +2171,62 @@ If a backup type of "separate" is provided, additional information is entered in
2022
2171
  - The conditioned space cannot be partially heated (i.e., the sum of all ``FractionHeatLoadServed`` must be 1).
2023
2172
  - There cannot be multiple backup heating systems.
2024
2173
 
2174
+ HPXML HVAC Detailed Perf. Data
2175
+ ******************************
2176
+
2177
+ Some air-source HVAC system types allow detailed heating/cooling performance data to be provided using the ``CoolingDetailedPerformanceData`` and ``HeatingDetailedPerformanceData`` elements, as described above.
2178
+ One source of detailed performance data is `NEEP's Cold Climate Air Source Heat Pump List <https://ashp.neep.org>`_.
2179
+
2180
+ Currently detailed performance data can only be provided for variable-speed HVAC systems.
2181
+
2182
+ .. _clg_detailed_perf_data:
2183
+
2184
+ Detailed Cooling Performance Data
2185
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2186
+
2187
+ For air-source HVAC systems with detailed cooling performance data, two or more pairs of minimum/maximum capacity data are entered in ``CoolingDetailedPerformanceData/PerformanceDataPoint``.
2188
+
2189
+ ================================= ======== ====== =========== ======== ========= ==========================================
2190
+ Element Type Units Constraints Required Default Notes
2191
+ ================================= ======== ====== =========== ======== ========= ==========================================
2192
+ ``OutdoorTemperature`` double F See [#]_ Yes Outdoor drybulb temperature
2193
+ ``Capacity`` double Btu/hr Yes Cooling capacity at the specified outdoor temperature
2194
+ ``CapacityDescription`` string See [#]_ Yes Whether the datapoint corresponds to minimum or maximum capacity
2195
+ ``Efficiency[Units="COP"]/Value`` double W/W Yes Cooling efficiency at the specified outdoor temperature
2196
+ ================================= ======== ====== =========== ======== ========= ==========================================
2197
+
2198
+ .. [#] One of the minimum/maximum datapoint pairs must occur at the 95F rated outdoor temperature condition.
2199
+ The other datapoint pairs can be at any temperature.
2200
+ .. [#] CapacityDescription choices are "minimum" and "maximum".
2201
+
2202
+ In addition, the parent object must provide the ``CoolingCapacity`` and the ``CompressorType`` must be set to "variable speed".
2203
+ For heat pumps, :ref:`htg_detailed_perf_data` must also be provided.
2204
+ Note that when detailed cooling performance data is provided, some other inputs (like SEER) are ignored.
2205
+
2206
+ .. _htg_detailed_perf_data:
2207
+
2208
+ Detailed Heating Performance Data
2209
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2210
+
2211
+ For air-source HVAC systems with detailed heating performance data, two or more pairs of minimum/maximum capacity data are entered in ``HeatingDetailedPerformanceData/PerformanceDataPoint``.
2212
+
2213
+ ================================= ======== ====== =========== ======== ========= ==========================================
2214
+ Element Type Units Constraints Required Default Notes
2215
+ ================================= ======== ====== =========== ======== ========= ==========================================
2216
+ ``OutdoorTemperature`` double F See [#]_ Yes Outdoor drybulb temperature
2217
+ ``Capacity`` double Btu/hr Yes Heating capacity at the specified outdoor temperature
2218
+ ``CapacityDescription`` string See [#]_ Yes Whether the datapoint corresponds to minimum or maximum capacity
2219
+ ``Efficiency[Units="COP"]/Value`` double W/W Yes Heating efficiency at the specified outdoor temperature
2220
+ ================================= ======== ====== =========== ======== ========= ==========================================
2221
+
2222
+ .. [#] One of the minimum/maximum datapoint pairs must occur at the 47F rated outdoor temperature condition.
2223
+ The other datapoint pairs can be at any temperature.
2224
+ .. [#] CapacityDescription choices are "minimum" and "maximum".
2225
+
2226
+ In addition, the parent object must provide the ``HeatingCapacity`` and the ``CompressorType`` must be set to "variable speed".
2227
+ For heat pumps, :ref:`clg_detailed_perf_data` must also be provided.
2228
+ Note that when detailed cooling performance data is provided, some other inputs (like HSPF and HeatingCapacityRetention) are ignored.
2229
+
2025
2230
  .. _hvac_control:
2026
2231
 
2027
2232
  HPXML HVAC Control
@@ -2185,36 +2390,60 @@ Additional information is entered in each ``Ducts``.
2185
2390
  ``extension/DuctSurfaceAreaMultiplier`` double >= 0 No 1.0 Duct surface area multiplier
2186
2391
  ======================================================= ======= ============ ================ ======== ========== ======================================
2187
2392
 
2188
- .. [#] | It is recommended to provide DuctInsulationRValue and not DuctEffectiveRValue. DuctInsulationRValue should not include the exterior air film (i.e., use 0 for an uninsulated duct). For ducts buried in insulation (using DuctBuriedInsulationLevel), DuctInsulationRValue should only represent any surrounding insulation duct wrap and not the entire attic insulation R-value. On the other hand, DuctEffectiveRValue should include the exterior air film as well as other effects such as adjustments for insulation wrapped around round ducts, or effective heat transfer for ducts buried in attic insulation. DuctEffectiveRValue is used for the actual model heat transfer, and when not provided is calculated as follows:
2189
- | - **Uninsulated**: 1.7
2190
- | - **Supply, Insulated**: 2.2438 + 0.5619 * DuctInsulationRValue
2191
- | - **Supply, Partially Buried**: 5.83 + 2.0 * DuctInsulationRValue
2192
- | - **Supply, Fully Buried**: 9.4 + 1.9 * DuctInsulationRValue
2193
- | - **Supply, Deeply Buried**: 16.67 + 1.45 * DuctInsulationRValue
2194
- | - **Return, Insulated**: 2.0388 + 0.7053 * DuctInsulationRValue
2195
- | - **Return, Partially Buried**: 7.6 + 2.5 * DuctInsulationRValue
2196
- | - **Return, Fully Buried**: 11.83 + 2.45 * DuctInsulationRValue
2197
- | - **Return, Deeply Buried**: 20.9 + 1.9 * DuctInsulationRValue
2198
- | The uninsulated effective R-value is from ASHRAE Handbook of Fundamentals. The insulated effective R-values are from `True R-Values of Round Residential Ductwork <https://www.aceee.org/files/proceedings/2006/data/papers/SS06_Panel1_Paper18.pdf>`_. The buried effective R-values are from Table 13 of `Reducing Thermal Losses and Gains With Buried and Encapsulated Ducts <https://www.nrel.gov/docs/fy13osti/55876.pdf>`_. The equations assume that the average supply duct has an 8-inch diameter and the average return duct has a 14-in diameter
2393
+ .. [#] It is recommended to provide DuctInsulationRValue and not DuctEffectiveRValue. DuctInsulationRValue should not include the exterior air film (i.e., use 0 for an uninsulated duct).
2394
+ For ducts buried in insulation (using DuctBuriedInsulationLevel), DuctInsulationRValue should only represent any surrounding insulation duct wrap and not the entire attic insulation R-value.
2395
+ On the other hand, DuctEffectiveRValue should include the exterior air film as well as other effects such as adjustments for insulation wrapped around round ducts, or effective heat transfer for ducts buried in attic insulation.
2396
+ DuctEffectiveRValue is used for the actual model heat transfer, and when not provided is calculated as follows:
2397
+
2398
+ \- **Uninsulated**: 1.7
2399
+
2400
+ \- **Supply, Insulated**: 2.2438 + 0.5619 * DuctInsulationRValue
2401
+
2402
+ \- **Supply, Partially Buried**: 5.83 + 2.0 * DuctInsulationRValue
2403
+
2404
+ \- **Supply, Fully Buried**: 9.4 + 1.9 * DuctInsulationRValue
2405
+
2406
+ \- **Supply, Deeply Buried**: 16.67 + 1.45 * DuctInsulationRValue
2407
+
2408
+ \- **Return, Insulated**: 2.0388 + 0.7053 * DuctInsulationRValue
2409
+
2410
+ \- **Return, Partially Buried**: 7.6 + 2.5 * DuctInsulationRValue
2411
+
2412
+ \- **Return, Fully Buried**: 11.83 + 2.45 * DuctInsulationRValue
2413
+
2414
+ \- **Return, Deeply Buried**: 20.9 + 1.9 * DuctInsulationRValue
2415
+
2416
+ The uninsulated effective R-value is from ASHRAE Handbook of Fundamentals.
2417
+ The insulated effective R-values are from `True R-Values of Round Residential Ductwork <https://www.aceee.org/files/proceedings/2006/data/papers/SS06_Panel1_Paper18.pdf>`_.
2418
+ The buried effective R-values are from Table 13 of `Reducing Thermal Losses and Gains With Buried and Encapsulated Ducts <https://www.nrel.gov/docs/fy13osti/55876.pdf>`_.
2419
+ The equations assume that the average supply duct has an 8-inch diameter and the average return duct has a 14-in diameter.
2420
+
2199
2421
  .. [#] DuctBuriedInsulationLevel choices are "not buried", "partially buried", "fully buried", or "deeply buried".
2200
2422
  .. [#] Whether the ducts are buried in, e.g., attic loose-fill insulation.
2201
2423
  Partially buried ducts have insulation that does not cover the top of the ducts.
2202
2424
  Fully buried ducts have insulation that just covers the top of the ducts.
2203
2425
  Deeply buried ducts have insulation that continues above the top of the ducts.
2204
2426
  See the `Building America Solution Center <https://basc.pnnl.gov/resource-guides/ducts-buried-attic-insulation>`_ for more information.
2205
- .. [#] DuctLocation choices are "living space", "basement - conditioned", "basement - unconditioned", "crawlspace - unvented", "crawlspace - vented", "crawlspace - conditioned", "attic - unvented", "attic - vented", "garage", "outside", "exterior wall", "under slab", "roof deck", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
2427
+ .. [#] DuctLocation choices are "conditioned space", "basement - conditioned", "basement - unconditioned", "crawlspace - unvented", "crawlspace - vented", "crawlspace - conditioned", "attic - unvented", "attic - vented", "garage", "outside", "exterior wall", "under slab", "roof deck", "other housing unit", "other heated space", "other multifamily buffer space", "other non-freezing space", or "manufactured home belly".
2206
2428
  See :ref:`hpxmllocations` for descriptions.
2207
- .. [#] If DuctLocation not provided, defaults to the first present space type: "basement - conditioned", "basement - unconditioned", "crawlspace - conditioned", "crawlspace - vented", "crawlspace - unvented", "attic - vented", "attic - unvented", "garage", or "living space".
2208
- If NumberofConditionedFloorsAboveGrade > 1, secondary ducts will be located in "living space".
2209
- .. [#] The sum of all ``[DuctType="supply"]/FractionDuctArea`` and ``[DuctType="return"]/FractionDuctArea`` must each equal to 1.
2210
- .. [#] FractionDuctArea and/or DuctSurfaceArea are required if DuctLocation is provided.
2211
- .. [#] | If neither DuctSurfaceArea nor FractionDuctArea provided, duct surface areas will be calculated based on `ASHRAE Standard 152 <https://www.energy.gov/eere/buildings/downloads/ashrae-standard-152-spreadsheet>`_:
2212
- | - **Primary supply duct area**: 0.27 * F_out * ConditionedFloorAreaServed
2213
- | - **Secondary supply duct area**: 0.27 * (1 - F_out) * ConditionedFloorAreaServed
2214
- | - **Primary return duct area**: b_r * F_out * ConditionedFloorAreaServed
2215
- | - **Secondary return duct area**: b_r * (1 - F_out) * ConditionedFloorAreaServed
2216
- | where F_out is 1.0 when NumberofConditionedFloorsAboveGrade <= 1 and 0.75 when NumberofConditionedFloorsAboveGrade > 1, and b_r is 0.05 * NumberofReturnRegisters with a maximum value of 0.25.
2217
- | If FractionDuctArea is provided, each duct surface area will be FractionDuctArea times total duct area, which is calculated using the sum of primary and secondary duct areas from the equations above.
2429
+ .. [#] If DuctLocation not provided, defaults to the first present space type: "basement - conditioned", "basement - unconditioned", "crawlspace - conditioned", "crawlspace - vented", "crawlspace - unvented", "attic - vented", "attic - unvented", "garage", or "conditioned space".
2430
+ If NumberofConditionedFloorsAboveGrade > 1, secondary ducts will be located in "conditioned space".
2431
+ .. [#] The sum of all ``FractionDuctArea`` must each equal to 1, both for the supply side and return side.
2432
+ .. [#] FractionDuctArea or DuctSurfaceArea are required if DuctLocation is provided.
2433
+ If both are provided, DuctSurfaceArea will be used in the model.
2434
+ .. [#] If neither DuctSurfaceArea nor FractionDuctArea provided, duct surface areas will be calculated based on `ASHRAE Standard 152 <https://www.energy.gov/eere/buildings/downloads/ashrae-standard-152-spreadsheet>`_:
2435
+
2436
+ \- **Primary supply duct area**: 0.27 * F_out * ConditionedFloorAreaServed
2437
+
2438
+ \- **Secondary supply duct area**: 0.27 * (1 - F_out) * ConditionedFloorAreaServed
2439
+
2440
+ \- **Primary return duct area**: b_r * F_out * ConditionedFloorAreaServed
2441
+
2442
+ \- **Secondary return duct area**: b_r * (1 - F_out) * ConditionedFloorAreaServed
2443
+
2444
+ where F_out is 1.0 when NumberofConditionedFloorsAboveGrade <= 1 and 0.75 when NumberofConditionedFloorsAboveGrade > 1, and b_r is 0.05 * NumberofReturnRegisters with a maximum value of 0.25.
2445
+
2446
+ If FractionDuctArea is provided, each duct surface area will be FractionDuctArea times total duct area, which is calculated using the sum of primary and secondary duct areas from the equations above.
2218
2447
 
2219
2448
  Hydronic Distribution
2220
2449
  ~~~~~~~~~~~~~~~~~~~~~
@@ -2235,9 +2464,10 @@ Distribution System Efficiency (DSE)
2235
2464
  .. warning::
2236
2465
 
2237
2466
  A simplified DSE model is provided for flexibility, but it is **strongly** recommended to use one of the other detailed distribution system types for better accuracy.
2238
- Also note that when specifying a DSE system, its effect is reflected in the :ref:`workflow_outputs` but is **not** reflected in the raw EnergyPlus simulation outputs.
2467
+ The DSE input is simply applied to heating/cooling energy use for every hour of the year.
2468
+ Note that when specifying a DSE, its effect is reflected in the :ref:`workflow_outputs` but is **not** reflected in the raw EnergyPlus simulation outputs.
2239
2469
 
2240
- To define a DSE system, additional information is entered in ``HVACDistribution``.
2470
+ To define a DSE, additional information is entered in ``HVACDistribution``.
2241
2471
 
2242
2472
  ============================================= ======= ======= =========== ======== ========= ===================================================
2243
2473
  Element Type Units Constraints Required Default Notes
@@ -2246,7 +2476,7 @@ To define a DSE system, additional information is entered in ``HVACDistribution`
2246
2476
  ``AnnualCoolingDistributionSystemEfficiency`` double frac 0 - 1 Yes Seasonal distribution system efficiency for cooling
2247
2477
  ============================================= ======= ======= =========== ======== ========= ===================================================
2248
2478
 
2249
- DSE values can be calculated from `ASHRAE Standard 152 <https://www.energy.gov/eere/buildings/downloads/ashrae-standard-152-spreadsheet>`_.
2479
+ DSE values can be calculated using, e.g., `ASHRAE Standard 152 <https://www.energy.gov/eere/buildings/downloads/ashrae-standard-152-spreadsheet>`_.
2250
2480
 
2251
2481
  HPXML Ventilation Fan
2252
2482
  *********************
@@ -2287,24 +2517,36 @@ If not entered, the simulation will not include mechanical ventilation.
2287
2517
 
2288
2518
  .. [#] For central fan integrated supply systems, IsSharedSystem must be false.
2289
2519
  .. [#] FanType choices are "energy recovery ventilator", "heat recovery ventilator", "exhaust only", "supply only", "balanced", or "central fan integrated supply".
2290
- .. [#] | If flow rate not provided, defaults to the required mechanical ventilation rate per `ASHRAE 62.2-2019 <https://www.techstreet.com/ashrae/standards/ashrae-62-2-2019?product_id=2087691>`_:
2291
- | Qfan = Qtot - Φ*(Qinf * Aext)
2292
- | where
2293
- | Qfan = required mechanical ventilation rate (cfm)
2294
- | Qtot = total required ventilation rate (cfm) = 0.03 * ConditionedFloorArea + 7.5*(NumberofBedrooms + 1)
2295
- | Qinf = infiltration rate (cfm)
2296
- | Aext = 1 if single-family detached or TypeOfInfiltrationLeakage is "unit exterior only", otherwise ratio of SFA/MF exterior envelope surface area to total envelope surface area as described in :ref:`air_infiltration`
2297
- | Φ = 1 for balanced ventilation systems, and Qinf/Qtot otherwise
2520
+ .. [#] If flow rate not provided, defaults to the required mechanical ventilation rate per `ASHRAE 62.2-2019 <https://www.techstreet.com/ashrae/standards/ashrae-62-2-2019?product_id=2087691>`_:
2521
+
2522
+ Qfan = Qtot - Φ*(Qinf * Aext)
2523
+
2524
+ where
2525
+
2526
+ Qfan = required mechanical ventilation rate (cfm)
2527
+
2528
+ Qtot = total required ventilation rate (cfm) = 0.03 * ConditionedFloorArea + 7.5*(NumberofBedrooms + 1)
2529
+
2530
+ Qinf = infiltration rate (cfm)
2531
+
2532
+ Aext = 1 if single-family detached or TypeOfInfiltrationLeakage is "unit exterior only", otherwise ratio of SFA/MF exterior envelope surface area to total envelope surface area as described in :ref:`air_infiltration`
2533
+
2534
+ Φ = 1 for balanced ventilation systems, and Qinf/Qtot otherwise
2535
+
2298
2536
  .. [#] For a central fan integrated supply system, the flow rate should equal the amount of outdoor air provided to the distribution system, not the total airflow through the distribution system.
2299
2537
  .. [#] HoursInOperation is optional unless the VentilationFan refers to the supplemental fan of a CFIS system, in which case it is not allowed.
2300
2538
  .. [#] If HoursInOperation not provided, defaults to 24 (i.e., running continuously) for all system types other than central fan integrated supply (CFIS), and 8.0 (i.e., running intermittently) for CFIS systems.
2301
2539
  For a CFIS system, the HoursInOperation and the flow rate are combined to form the hourly target ventilation rate (e.g., inputs of 90 cfm and 8 hrs/day produce an hourly target ventilation rate of 30 cfm).
2302
2540
  For a CFIS system with a supplemental fan, the supplemental fan's runtime is automatically calculated for each hour (based on the air handler runtime) to maintain the hourly target ventilation rate.
2303
- .. [#] | If FanPower not provided, defaults based on `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_:
2304
- | - **energy recovery ventilator, heat recovery ventilator, or shared system**: 1.0 W/cfm
2305
- | - **balanced**: 0.7 W/cfm
2306
- | - **central fan integrated supply**: 0.5 W/cfm
2307
- | - **exhaust only" or "supply only**: 0.35 W/cfm
2541
+ .. [#] If FanPower not provided, defaults based on `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_:
2542
+
2543
+ \- **energy recovery ventilator, heat recovery ventilator, or shared system**: 1.0 W/cfm
2544
+
2545
+ \- **balanced**: 0.7 W/cfm
2546
+
2547
+ \- **central fan integrated supply**: 0.5 W/cfm
2548
+
2549
+ \- **exhaust only" or "supply only**: 0.35 W/cfm
2308
2550
 
2309
2551
  **Exhaust/Supply Only**
2310
2552
 
@@ -2480,11 +2722,14 @@ If not entered, the simulation will not include water heating.
2480
2722
  ========================= ======= ======= =========== ======== ======== ================================================================
2481
2723
 
2482
2724
  .. [#] WaterHeaterType choices are "storage water heater", "instantaneous water heater", "heat pump water heater", "space-heating boiler with storage tank", or "space-heating boiler with tankless coil".
2483
- .. [#] Location choices are "living space", "basement - unconditioned", "basement - conditioned", "attic - unvented", "attic - vented", "garage", "crawlspace - unvented", "crawlspace - vented", "crawlspace - conditioned", "other exterior", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
2725
+ .. [#] Location choices are "conditioned space", "basement - unconditioned", "basement - conditioned", "attic - unvented", "attic - vented", "garage", "crawlspace - unvented", "crawlspace - vented", "crawlspace - conditioned", "other exterior", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
2484
2726
  See :ref:`hpxmllocations` for descriptions.
2485
- .. [#] | If Location not provided, defaults to the first present space type:
2486
- | - **IECC zones 1-3, excluding 3A**: "garage", "living space"
2487
- | - **IECC zones 3A, 4-8, unknown**: "basement - conditioned", "basement - unconditioned", "living space"
2727
+ .. [#] If Location not provided, defaults to the first present space type:
2728
+
2729
+ \- **IECC zones 1-3, excluding 3A**: "garage", "conditioned space"
2730
+
2731
+ \- **IECC zones 3A, 4-8, unknown**: "basement - conditioned", "basement - unconditioned", "conditioned space"
2732
+
2488
2733
  .. [#] The sum of all ``FractionDHWLoadServed`` (across all WaterHeatingSystems) must equal to 1.
2489
2734
  .. [#] FractionDHWLoadServed represents only the fraction of the hot water load associated with the hot water **fixtures**.
2490
2735
  Additional hot water load from clothes washers/dishwashers will be automatically assigned to the appropriate water heater(s).
@@ -2517,10 +2762,14 @@ If a conventional storage water heater is specified, additional information is e
2517
2762
  If neither UsageBin nor FirstHourRating provided, UsageBin defaults to "medium".
2518
2763
  If FirstHourRating provided and UsageBin not provided, UsageBin is determined based on the FirstHourRating value.
2519
2764
  .. [#] RecoveryEfficiency must also be greater than the EnergyFactor (or UniformEnergyFactor).
2520
- .. [#] | If RecoveryEfficiency not provided, defaults as follows based on a regression analysis of `AHRI certified water heaters <https://www.ahridirectory.org/NewSearch?programId=24&searchTypeId=3>`_:
2521
- | - **Electric**: 0.98
2522
- | - **Non-electric, EnergyFactor < 0.75**: 0.252 * EnergyFactor + 0.608
2523
- | - **Non-electric, EnergyFactor >= 0.75**: 0.561 * EnergyFactor + 0.439
2765
+ .. [#] If RecoveryEfficiency not provided, defaults as follows based on a regression analysis of `AHRI certified water heaters <https://www.ahridirectory.org/NewSearch?programId=24&searchTypeId=3>`_:
2766
+
2767
+ \- **Electric**: 0.98
2768
+
2769
+ \- **Non-electric, EnergyFactor < 0.75**: 0.252 * EnergyFactor + 0.608
2770
+
2771
+ \- **Non-electric, EnergyFactor >= 0.75**: 0.561 * EnergyFactor + 0.439
2772
+
2524
2773
  .. [#] TankModelType choices are "mixed" or "stratified".
2525
2774
 
2526
2775
  Tankless
@@ -2550,7 +2799,7 @@ If a heat pump water heater is specified, additional information is entered in `
2550
2799
  ``FuelType`` string See [#]_ Yes Fuel type
2551
2800
  ``TankVolume`` double gal > 0 Yes Nominal tank volume
2552
2801
  ``UniformEnergyFactor`` or ``EnergyFactor`` double frac > 1, <= 5 Yes EnergyGuide label rated efficiency
2553
- ``HPWHOperatingMode`` string See [#]_ No hyrbid/auto Operating mode [#]_
2802
+ ``HPWHOperatingMode`` string See [#]_ No hybrid/auto Operating mode [#]_
2554
2803
  ``UsageBin`` or ``FirstHourRating`` string or double str or gal/hr See [#]_ or > 0 No See [#]_ EnergyGuide label usage bin/first hour rating
2555
2804
  ``WaterHeaterInsulation/Jacket/JacketRValue`` double F-ft2-hr/Btu >= 0 No 0 R-value of additional tank insulation wrap
2556
2805
  ============================================= ================ ============= =============== ======== =========== =============================================
@@ -2634,6 +2883,8 @@ If any water heating systems are provided, a single hot water distribution syste
2634
2883
  In attached/multifamily buildings, only the hot water distribution system serving the dwelling unit should be defined.
2635
2884
  The hot water distribution associated with, e.g., a shared laundry room should not be defined.
2636
2885
 
2886
+ Hot water distribution systems are modeled according to the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_.
2887
+
2637
2888
  Standard
2638
2889
  ~~~~~~~~
2639
2890
 
@@ -2645,12 +2896,18 @@ If the in-unit distribution system is specified as standard, additional informat
2645
2896
  ``PipingLength`` double ft > 0 No See [#]_ Length of piping [#]_
2646
2897
  ================ ======= ===== =========== ======== ======== =====================
2647
2898
 
2648
- .. [#] | If PipingLength not provided, calculated using the following equation from `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_:
2649
- | PipeL = 2.0 * (CFA / NCfl)^0.5 + 10.0 * NCfl + 5.0 * Bsmnt
2650
- | where
2651
- | CFA = conditioned floor area [ft2],
2652
- | NCfl = number of conditioned floor levels number of conditioned floor levels in the residence including conditioned basements,
2653
- | Bsmnt = presence (1.0) or absence (0.0) of an unconditioned basement in the residence.
2899
+ .. [#] If PipingLength not provided, calculated using the following equation from `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_:
2900
+
2901
+ PipeL = 2.0 * (CFA / NCfl)^0.5 + 10.0 * NCfl + 5.0 * Bsmnt
2902
+
2903
+ where
2904
+
2905
+ CFA = conditioned floor area [ft2],
2906
+
2907
+ NCfl = number of conditioned floor levels number of conditioned floor levels in the residence including conditioned basements,
2908
+
2909
+ Bsmnt = presence (1.0) or absence (0.0) of an unconditioned basement in the residence.
2910
+
2654
2911
  .. [#] PipingLength is the length of hot water piping from the hot water heater (or from a shared recirculation loop serving multiple dwelling units) to the farthest hot water fixture, measured longitudinally from plans, assuming the hot water piping does not run diagonally, plus 10 feet of piping for each floor level, plus 5 feet of piping for unconditioned basements (if any).
2655
2912
 
2656
2913
  Recirculation
@@ -2668,12 +2925,29 @@ If the in-unit distribution system is specified as recirculation, additional inf
2668
2925
  ================================= ======= ===== =========== ======== ======== =====================================
2669
2926
 
2670
2927
  .. [#] ControlType choices are "manual demand control", "presence sensor demand control", "temperature", "timer", or "no control".
2671
- .. [#] | If RecirculationPipingLoopLength not provided, calculated using the following equation from `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_:
2672
- | RecircPipeL = 2.0 * (2.0 * (CFA / NCfl)^0.5 + 10.0 * NCfl + 5.0 * Bsmnt) - 20.0
2673
- | where
2674
- | CFA = conditioned floor area [ft2],
2675
- | NCfl = number of conditioned floor levels number of conditioned floor levels in the residence including conditioned basements,
2676
- | Bsmnt = presence (1.0) or absence (0.0) of an unconditioned basement in the residence.
2928
+
2929
+ \- **manual demand control**: The pump only runs when a user presses a button indicating they are about to use hot water.
2930
+
2931
+ \- **presence sensor demand control**: The pump only runs when a sensor detects someone is present at the faucet.
2932
+
2933
+ \- **temperature**: The pump runs based on monitoring temperature at some point in the system.
2934
+
2935
+ \- **timer**: The pump is controlled by a timer.
2936
+
2937
+ \- **no control**: The pump runs continuously.
2938
+
2939
+ .. [#] If RecirculationPipingLoopLength not provided, calculated using the following equation from `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_:
2940
+
2941
+ RecircPipeL = 2.0 * (2.0 * (CFA / NCfl)^0.5 + 10.0 * NCfl + 5.0 * Bsmnt) - 20.0
2942
+
2943
+ where
2944
+
2945
+ CFA = conditioned floor area [ft2],
2946
+
2947
+ NCfl = number of conditioned floor levels number of conditioned floor levels in the residence including conditioned basements,
2948
+
2949
+ Bsmnt = presence (1.0) or absence (0.0) of an unconditioned basement in the residence.
2950
+
2677
2951
  .. [#] 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.
2678
2952
  .. [#] 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.
2679
2953
  .. [#] PumpPower default based on `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_.
@@ -2712,23 +2986,27 @@ If a drain water heat recovery (DWHR) device is specified, additional informatio
2712
2986
  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.
2713
2987
  .. [#] 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.
2714
2988
 
2989
+ Drain water heat recovery is modeled according to the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_.
2990
+
2715
2991
  HPXML Water Fixtures
2716
2992
  ********************
2717
2993
 
2718
2994
  Each water fixture is entered as a ``/HPXML/Building/BuildingDetails/Systems/WaterHeating/WaterFixture``.
2719
2995
 
2720
- ==================== ======= ===== =========== ======== ======== ===============================================
2721
- Element Type Units Constraints Required Default Notes
2722
- ==================== ======= ===== =========== ======== ======== ===============================================
2723
- ``SystemIdentifier`` id Yes Unique identifier
2724
- ``WaterFixtureType`` string See [#]_ Yes Bathroom faucet or shower
2725
- ``LowFlow`` boolean Yes Whether the fixture is considered low-flow [#]_
2726
- ==================== ======= ===== =========== ======== ======== ===============================================
2996
+ =============================== ================= ===== =========== ======== ======== ===============================================
2997
+ Element Type Units Constraints Required Default Notes
2998
+ =============================== ================= ===== =========== ======== ======== ===============================================
2999
+ ``SystemIdentifier`` id Yes Unique identifier
3000
+ ``WaterFixtureType`` string See [#]_ Yes Bathroom faucet or shower
3001
+ ``Count`` integer > 0 No See [#]_ Number of similar water fixtures
3002
+ ``LowFlow`` and/or ``FlowRate`` boolean or double gpm > 0 Yes Whether the fixture is considered low-flow and/or the flow rate [#]_
3003
+ =============================== ================= ===== =========== ======== ======== ===============================================
2727
3004
 
2728
3005
  .. [#] WaterFixtureType choices are "shower head" or "faucet".
2729
3006
  If the shower stall has multiple shower heads that operate simultaneously, combine them as a single entry.
2730
- .. [#] LowFlow should be true if the fixture's flow rate (gpm) is <= 2.0.
2731
- Where a shower stall has multiple shower heads that operate simultaneously, the sum of their flows must be <= 2.0.
3007
+ .. [#] A WaterFixture is considered low-flow if the fixture's flow rate (gpm) is <= 2.0.
3008
+ Where a shower stall has multiple shower heads that operate simultaneously, use the sum of their flows.
3009
+ .. [#] If Count not provided for any water fixture, assumes that 60% of all fixtures are faucets and 40% are shower heads.
2732
3010
 
2733
3011
  Additional information can be entered in ``/HPXML/Building/BuildingDetails/Systems/WaterHeating/``.
2734
3012
 
@@ -2744,6 +3022,8 @@ Additional information can be entered in ``/HPXML/Building/BuildingDetails/Syste
2744
3022
  .. [#] If WaterFixturesWeekdayScheduleFractions or WaterFixturesWeekendScheduleFractions not provided (and :ref:`detailedschedules` not used), default values from Figures 9-11 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used: "0.012, 0.006, 0.004, 0.005, 0.010, 0.034, 0.078, 0.087, 0.080, 0.067, 0.056, 0.047, 0.040, 0.035, 0.033, 0.031, 0.039, 0.051, 0.060, 0.060, 0.055, 0.048, 0.038, 0.026".
2745
3023
  .. [#] If WaterFixturesMonthlyScheduleMultipliers not provided (and :ref:`detailedschedules` not used), default values are used: "1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0".
2746
3024
 
3025
+ Water fixture hot water use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_.
3026
+
2747
3027
  HPXML Solar Thermal
2748
3028
  *******************
2749
3029
 
@@ -2760,6 +3040,8 @@ If not entered, the simulation will not include solar hot water.
2760
3040
  .. [#] SystemType only choice is "hot water".
2761
3041
 
2762
3042
  Solar hot water systems can be described with either simple or detailed inputs.
3043
+ It is recommended to use detailed inputs and allow EnergyPlus to calculate the solar contribution to the hot water load;
3044
+ the simple inputs are provided if equivalent calculations are performed in another software tool.
2763
3045
 
2764
3046
  Simple Inputs
2765
3047
  ~~~~~~~~~~~~~
@@ -2779,6 +3061,10 @@ To define a simple solar hot water system, additional information is entered in
2779
3061
  The referenced water heater cannot be a space-heating boiler nor attached to a desuperheater.
2780
3062
  .. [#] If ConnectedTo not provided, solar fraction will apply to all water heaters in the building.
2781
3063
 
3064
+ .. warning::
3065
+
3066
+ The solar fraction will reduce the hot water load equally for every EnergyPlus timestep (even during nights and cloudy events).
3067
+
2782
3068
  Detailed Inputs
2783
3069
  ~~~~~~~~~~~~~~~
2784
3070
 
@@ -2834,20 +3120,33 @@ Many of the inputs are adopted from the `PVWatts model <https://pvwatts.nrel.gov
2834
3120
  .. [#] ModuleType choices are "standard", "premium", or "thin film".
2835
3121
  .. [#] Tracking choices are "fixed", "1-axis", "1-axis backtracked", or "2-axis".
2836
3122
  .. [#] ArrayOrientation choices are "northeast", "east", "southeast", "south", "southwest", "west", "northwest", or "north"
2837
- .. [#] | SystemLossesFraction default is derived from the `PVWatts documentation <https://www.nrel.gov/docs/fy14osti/62641.pdf>`_, which breaks down the losses as follows.
2838
- | Note that the total loss (14%) is not the sum of the individual losses but is calculated by multiplying the reduction due to each loss.
2839
- | - **Soiling**: 2%
2840
- | - **Shading**: 3%
2841
- | - **Snow**: 0%
2842
- | - **Mismatch**: 2%
2843
- | - **Wiring**: 2%
2844
- | - **Connections**: 0.5%
2845
- | - **Light-induced degradation**: 1.5%
2846
- | - **Nameplate rating**: 1%
2847
- | - **Age**: 0%
2848
- | - **Availability**: 3%
2849
- | If YearModulesManufactured provided but not SystemLossesFraction, calculated as:
2850
- | SystemLossesFraction = 1.0 - (1.0 - 0.14) * (1.0 - (1.0 - 0.995^(CurrentYear - YearModulesManufactured))).
3123
+ .. [#] SystemLossesFraction default is derived from the `PVWatts documentation <https://www.nrel.gov/docs/fy14osti/62641.pdf>`_, which breaks down the losses as follows.
3124
+ Note that the total loss (14%) is not the sum of the individual losses but is calculated by multiplying the reduction due to each loss.
3125
+
3126
+ \- **Soiling**: 2%
3127
+
3128
+ \- **Shading**: 3%
3129
+
3130
+ \- **Snow**: 0%
3131
+
3132
+ \- **Mismatch**: 2%
3133
+
3134
+ \- **Wiring**: 2%
3135
+
3136
+ \- **Connections**: 0.5%
3137
+
3138
+ \- **Light-induced degradation**: 1.5%
3139
+
3140
+ \- **Nameplate rating**: 1%
3141
+
3142
+ \- **Age**: 0%
3143
+
3144
+ \- **Availability**: 3%
3145
+
3146
+ If YearModulesManufactured provided but not SystemLossesFraction, calculated as:
3147
+
3148
+ SystemLossesFraction = 1.0 - (1.0 - 0.14) * (1.0 - (1.0 - 0.995^(CurrentYear - YearModulesManufactured))).
3149
+
2851
3150
  .. [#] System losses due to soiling, shading, snow, mismatch, wiring, degradation, etc.
2852
3151
  .. [#] AttachedToInverter must reference an ``Inverter``.
2853
3152
  .. [#] NumberofBedroomsServed only required if IsSharedSystem is true, in which case it must be > NumberofBedrooms.
@@ -2883,7 +3182,7 @@ If not entered, the simulation will not include batteries.
2883
3182
  ``RoundTripEfficiency`` double frac 0 - 1 No 0.925 Round trip efficiency
2884
3183
  ==================================================== ======= ========= ======================= ======== ======== ============================================
2885
3184
 
2886
- .. [#] Location choices are "living space", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", "attic - vented", "attic - unvented", "garage", or "outside".
3185
+ .. [#] Location choices are "conditioned space", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", "attic - vented", "attic - unvented", "garage", or "outside".
2887
3186
  .. [#] If Location not provided, defaults to "garage" if a garage is present, otherwise "outside".
2888
3187
  .. [#] BatteryType only choice is "Li-ion".
2889
3188
  .. [#] If NominalCapacity not provided, defaults to UsableCapacity / 0.9 if UsableCapacity provided, else (RatedPowerOutput / 1000) / 0.5 if RatedPowerOutput provided, else 10 kWh.
@@ -2894,7 +3193,7 @@ If not entered, the simulation will not include batteries.
2894
3193
 
2895
3194
  An unscheduled battery in a home with photovoltaics (PV) will be controlled using a simple control strategy designed to maximize on site consumption of energy. The battery will charge if PV production is greater than the building load and the battery is below its maximum capacity, while the battery will discharge if the building load is greater than PV production and the battery is above its minimum capacity.
2896
3195
 
2897
- A battery can alternatively be controlled using :ref:`detailedschedules`, where charging and discharging schedules are defined. Positive schedule values control timing and magnitude of charging storage. Negative schedule values control timing and magnitude of discharging storage. Simultaneous charging and discharging of the battery is not allowed. The round trip efficiency affects charging; the reported charging rate will be larger than the schedule value by an amount equal to the losses due to the round trip efficiency.
3196
+ A battery can alternatively be controlled using :ref:`detailedschedules`, where charging and discharging schedules are defined. Positive schedule values control timing and magnitude of charging storage. Negative schedule values control timing and magnitude of discharging storage. Simultaneous charging and discharging of the battery is not allowed. The round trip efficiency affects charging and discharging; the reported charging and discharging rates will be larger than the schedule value by an amount equal to the losses due to the round trip efficiency.
2898
3197
 
2899
3198
  A battery in a home without PV or charging/discharging schedules is assumed to operate as backup and is not modeled.
2900
3199
 
@@ -2935,22 +3234,22 @@ HPXML Clothes Washer
2935
3234
  A single clothes washer can be entered as a ``/HPXML/Building/BuildingDetails/Appliances/ClothesWasher``.
2936
3235
  If not entered, the simulation will not include a clothes washer.
2937
3236
 
2938
- ====================================================================== ======= =========== =========== ======== ============ ==============================================
2939
- Element Type Units Constraints Required Default Notes
2940
- ====================================================================== ======= =========== =========== ======== ============ ==============================================
2941
- ``SystemIdentifier`` id Yes Unique identifier
2942
- ``IsSharedAppliance`` boolean No false Whether it serves multiple dwelling units [#]_
2943
- ``Location`` string See [#]_ No living space Location
2944
- ``IntegratedModifiedEnergyFactor`` or ``ModifiedEnergyFactor`` double ft3/kWh/cyc > 0 No See [#]_ Efficiency [#]_
2945
- ``AttachedToWaterHeatingSystem`` or ``AttachedToHotWaterDistribution`` idref See [#]_ See [#]_ ID of attached water heater or distribution system
2946
- ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on energy & hot water usage
2947
- ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
2948
- ``extension/WeekendScheduleFractions`` array No 24 comma-separated weekend fractions
2949
- ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
2950
- ====================================================================== ======= =========== =========== ======== ============ ==============================================
3237
+ ====================================================================== ======= =========== =========== ======== ================= ==============================================
3238
+ Element Type Units Constraints Required Default Notes
3239
+ ====================================================================== ======= =========== =========== ======== ================= ==============================================
3240
+ ``SystemIdentifier`` id Yes Unique identifier
3241
+ ``IsSharedAppliance`` boolean No false Whether it serves multiple dwelling units [#]_
3242
+ ``Location`` string See [#]_ No conditioned space Location
3243
+ ``IntegratedModifiedEnergyFactor`` or ``ModifiedEnergyFactor`` double ft3/kWh/cyc > 0 No See [#]_ Efficiency [#]_
3244
+ ``AttachedToWaterHeatingSystem`` or ``AttachedToHotWaterDistribution`` idref See [#]_ See [#]_ ID of attached water heater or distribution system
3245
+ ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on energy & hot water usage
3246
+ ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
3247
+ ``extension/WeekendScheduleFractions`` array No 24 comma-separated weekend fractions
3248
+ ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
3249
+ ====================================================================== ======= =========== =========== ======== ================= ==============================================
2951
3250
 
2952
3251
  .. [#] For example, a clothes washer in a shared laundry room of a MF building.
2953
- .. [#] Location choices are "living space", "basement - conditioned", "basement - unconditioned", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
3252
+ .. [#] Location choices are "conditioned space", "basement - conditioned", "basement - unconditioned", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
2954
3253
  See :ref:`hpxmllocations` for descriptions.
2955
3254
  .. [#] If neither IntegratedModifiedEnergyFactor nor ModifiedEnergyFactor provided, the following default values representing a standard clothes washer from 2006 will be used:
2956
3255
  IntegratedModifiedEnergyFactor = 1.0,
@@ -2989,24 +3288,24 @@ HPXML Clothes Dryer
2989
3288
  A single clothes dryer can be entered as a ``/HPXML/Building/BuildingDetails/Appliances/ClothesDryer``.
2990
3289
  If not entered, the simulation will not include a clothes dryer.
2991
3290
 
2992
- ============================================ ======= ====== =========== ======== ============ ==============================================
2993
- Element Type Units Constraints Required Default Notes
2994
- ============================================ ======= ====== =========== ======== ============ ==============================================
2995
- ``SystemIdentifier`` id Yes Unique identifier
2996
- ``IsSharedAppliance`` boolean No false Whether it serves multiple dwelling units [#]_
2997
- ``Location`` string See [#]_ No living space Location
2998
- ``FuelType`` string See [#]_ Yes Fuel type
2999
- ``CombinedEnergyFactor`` or ``EnergyFactor`` double lb/kWh > 0 No See [#]_ Efficiency [#]_
3000
- ``Vented`` boolean No true Whether dryer is vented
3001
- ``VentedFlowRate`` double cfm >= 0 No 100 [#]_ Exhaust flow rate during operation
3002
- ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on energy use
3003
- ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
3004
- ``extension/WeekendScheduleFractions`` array No 24 comma-separated weekend fractions
3005
- ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
3006
- ============================================ ======= ====== =========== ======== ============ ==============================================
3291
+ ============================================ ======= ====== =========== ======== ================= ==============================================
3292
+ Element Type Units Constraints Required Default Notes
3293
+ ============================================ ======= ====== =========== ======== ================= ==============================================
3294
+ ``SystemIdentifier`` id Yes Unique identifier
3295
+ ``IsSharedAppliance`` boolean No false Whether it serves multiple dwelling units [#]_
3296
+ ``Location`` string See [#]_ No conditioned space Location
3297
+ ``FuelType`` string See [#]_ Yes Fuel type
3298
+ ``CombinedEnergyFactor`` or ``EnergyFactor`` double lb/kWh > 0 No See [#]_ Efficiency [#]_
3299
+ ``Vented`` boolean No true Whether dryer is vented
3300
+ ``VentedFlowRate`` double cfm >= 0 No 100 [#]_ Exhaust flow rate during operation
3301
+ ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on energy use
3302
+ ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
3303
+ ``extension/WeekendScheduleFractions`` array No 24 comma-separated weekend fractions
3304
+ ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
3305
+ ============================================ ======= ====== =========== ======== ================= ==============================================
3007
3306
 
3008
3307
  .. [#] For example, a clothes dryer in a shared laundry room of a MF building.
3009
- .. [#] Location choices are "living space", "basement - conditioned", "basement - unconditioned", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
3308
+ .. [#] Location choices are "conditioned space", "basement - conditioned", "basement - unconditioned", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
3010
3309
  See :ref:`hpxmllocations` for descriptions.
3011
3310
  .. [#] 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", "electricity", "wood", or "wood pellets".
3012
3311
  .. [#] If neither CombinedEnergyFactor nor EnergyFactor provided, the following default values representing a standard clothes dryer from 2006 will be used:
@@ -3026,22 +3325,22 @@ HPXML Dishwasher
3026
3325
  A single dishwasher can be entered as a ``/HPXML/Building/BuildingDetails/Appliances/Dishwasher``.
3027
3326
  If not entered, the simulation will not include a dishwasher.
3028
3327
 
3029
- ====================================================================== ======= =========== =========== ======== ============ ==============================================
3030
- Element Type Units Constraints Required Default Notes
3031
- ====================================================================== ======= =========== =========== ======== ============ ==============================================
3032
- ``SystemIdentifier`` id Yes Unique identifier
3033
- ``IsSharedAppliance`` boolean No false Whether it serves multiple dwelling units [#]_
3034
- ``Location`` string See [#]_ No living space Location
3035
- ``RatedAnnualkWh`` or ``EnergyFactor`` double kWh/yr or # > 0 No See [#]_ EnergyGuide label consumption/efficiency [#]_
3036
- ``AttachedToWaterHeatingSystem`` or ``AttachedToHotWaterDistribution`` idref See [#]_ See [#]_ ID of attached water heater or distribution system
3037
- ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on energy & hot water usage
3038
- ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
3039
- ``extension/WeekendScheduleFractions`` array No 24 comma-separated weekend fractions
3040
- ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
3041
- ====================================================================== ======= =========== =========== ======== ============ ==============================================
3328
+ ====================================================================== ======= =========== =========== ======== ================= ==============================================
3329
+ Element Type Units Constraints Required Default Notes
3330
+ ====================================================================== ======= =========== =========== ======== ================= ==============================================
3331
+ ``SystemIdentifier`` id Yes Unique identifier
3332
+ ``IsSharedAppliance`` boolean No false Whether it serves multiple dwelling units [#]_
3333
+ ``Location`` string See [#]_ No conditioned space Location
3334
+ ``RatedAnnualkWh`` or ``EnergyFactor`` double kWh/yr or # > 0 No See [#]_ EnergyGuide label consumption/efficiency [#]_
3335
+ ``AttachedToWaterHeatingSystem`` or ``AttachedToHotWaterDistribution`` idref See [#]_ See [#]_ ID of attached water heater or distribution system
3336
+ ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on energy & hot water usage
3337
+ ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
3338
+ ``extension/WeekendScheduleFractions`` array No 24 comma-separated weekend fractions
3339
+ ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
3340
+ ====================================================================== ======= =========== =========== ======== ================= ==============================================
3042
3341
 
3043
3342
  .. [#] For example, a dishwasher in a shared mechanical room of a MF building.
3044
- .. [#] Location choices are "living space", "basement - conditioned", "basement - unconditioned", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
3343
+ .. [#] Location choices are "conditioned space", "basement - conditioned", "basement - unconditioned", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
3045
3344
  See :ref:`hpxmllocations` for descriptions.
3046
3345
  .. [#] If neither RatedAnnualkWh nor EnergyFactor provided, the following default values representing a standard dishwasher from 2006 will be used:
3047
3346
  RatedAnnualkWh = 467,
@@ -3090,10 +3389,10 @@ If not entered, the simulation will not include a refrigerator.
3090
3389
  ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
3091
3390
  ===================================================== ======= ====== =========== ======== ======== ======================================
3092
3391
 
3093
- .. [#] Location choices are "living space", "basement - conditioned", "basement - unconditioned", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
3392
+ .. [#] Location choices are "conditioned space", "basement - conditioned", "basement - unconditioned", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
3094
3393
  See :ref:`hpxmllocations` for descriptions.
3095
- .. [#] If Location not provided and is the *primary* refrigerator, defaults to "living space".
3096
- If Location not provided and is a *secondary* refrigerator, defaults to the first present space type: "garage", "basement - unconditioned", "basement - conditioned", or "living space".
3394
+ .. [#] If Location not provided and is the *primary* refrigerator, defaults to "conditioned space".
3395
+ If Location not provided and is a *secondary* refrigerator, defaults to the first present space type: "garage", "basement - unconditioned", "basement - conditioned", or "conditioned space".
3097
3396
  .. [#] 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 <https://codes.iccsafe.org/content/RESNETICC3012019>`_:
3098
3397
  RatedAnnualkWh = 637.0 + 18.0 * NumberofBedrooms.
3099
3398
  .. [#] If multiple refrigerators are specified, there must be exactly one refrigerator described with PrimaryIndicator=true.
@@ -3122,9 +3421,9 @@ If not entered, the simulation will not include a standalone freezer.
3122
3421
  ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
3123
3422
  ===================================================== ====== ====== =========== ======== ========== ======================================
3124
3423
 
3125
- .. [#] Location choices are "living space", "basement - conditioned", "basement - unconditioned", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
3424
+ .. [#] Location choices are "conditioned space", "basement - conditioned", "basement - unconditioned", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
3126
3425
  See :ref:`hpxmllocations` for descriptions.
3127
- .. [#] If Location not provided, defaults to "garage" if present, otherwise "basement - unconditioned" if present, otherwise "basement - conditioned" if present, otherwise "living space".
3426
+ .. [#] If Location not provided, defaults to "garage" if present, otherwise "basement - unconditioned" if present, otherwise "basement - conditioned" if present, otherwise "conditioned space".
3128
3427
  .. [#] RatedAnnualkWh default based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_.
3129
3428
  .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided (and :ref:`detailedschedules` not used), default values from Figure 16 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used: "0.040, 0.039, 0.038, 0.037, 0.036, 0.036, 0.038, 0.040, 0.041, 0.041, 0.040, 0.040, 0.042, 0.042, 0.042, 0.041, 0.044, 0.048, 0.050, 0.048, 0.047, 0.046, 0.044, 0.041".
3130
3429
  .. [#] If MonthlyScheduleMultipliers not provided (and :ref:`detailedschedules` not used), default values from Figure 24 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used: "0.837, 0.835, 1.084, 1.084, 1.084, 1.096, 1.096, 1.096, 1.096, 0.931, 0.925, 0.837".
@@ -3152,14 +3451,14 @@ If not entered, the simulation will not include a dehumidifier.
3152
3451
  ============================================== ========== ========== =========== ======== ======= ========================================
3153
3452
 
3154
3453
  .. [#] Type choices are "portable" or "whole-home".
3155
- .. [#] Location only choice is "living space".
3454
+ .. [#] Location only choice is "conditioned space".
3156
3455
  .. [#] If multiple dehumidifiers are entered, they must all have the same setpoint or an error will be generated.
3157
3456
  .. [#] The sum of all ``FractionDehumidificationLoadServed`` (across all Dehumidifiers) must be less than or equal to 1.
3158
3457
 
3159
3458
  .. note::
3160
3459
 
3161
3460
  Dehumidifiers are currently modeled as located within conditioned space; the model is not suited for a dehumidifier in, e.g., a wet unconditioned basement or crawlspace.
3162
- Therefore the dehumidifier Location is currently restricted to "living space".
3461
+ Therefore the dehumidifier Location is currently restricted to "conditioned space".
3163
3462
 
3164
3463
  HPXML Cooking Range/Oven
3165
3464
  ************************
@@ -3167,20 +3466,20 @@ HPXML Cooking Range/Oven
3167
3466
  A single cooking range can be entered as a ``/HPXML/Building/BuildingDetails/Appliances/CookingRange``.
3168
3467
  If not entered, the simulation will not include a cooking range/oven.
3169
3468
 
3170
- ======================================== ======= ====== =========== ======== ============ ======================================
3171
- Element Type Units Constraints Required Default Notes
3172
- ======================================== ======= ====== =========== ======== ============ ======================================
3173
- ``SystemIdentifier`` id Yes Unique identifier
3174
- ``Location`` string See [#]_ No living space Location
3175
- ``FuelType`` string See [#]_ Yes Fuel type
3176
- ``IsInduction`` boolean No false Induction range?
3177
- ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on energy use
3178
- ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
3179
- ``extension/WeekendScheduleFractions`` array No 24 comma-separated weekend fractions
3180
- ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
3181
- ======================================== ======= ====== =========== ======== ============ ======================================
3182
-
3183
- .. [#] Location choices are "living space", "basement - conditioned", "basement - unconditioned", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
3469
+ ======================================== ======= ====== =========== ======== ================= ======================================
3470
+ Element Type Units Constraints Required Default Notes
3471
+ ======================================== ======= ====== =========== ======== ================= ======================================
3472
+ ``SystemIdentifier`` id Yes Unique identifier
3473
+ ``Location`` string See [#]_ No conditioned space Location
3474
+ ``FuelType`` string See [#]_ Yes Fuel type
3475
+ ``IsInduction`` boolean No false Induction range?
3476
+ ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on energy use
3477
+ ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
3478
+ ``extension/WeekendScheduleFractions`` array No 24 comma-separated weekend fractions
3479
+ ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
3480
+ ======================================== ======= ====== =========== ======== ================= ======================================
3481
+
3482
+ .. [#] Location choices are "conditioned space", "basement - conditioned", "basement - unconditioned", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
3184
3483
  See :ref:`hpxmllocations` for descriptions.
3185
3484
  .. [#] 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", "electricity", "wood", or "wood pellets".
3186
3485
  .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided (and :ref:`detailedschedules` not used), default values from Figure 22 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used: "0.007, 0.007, 0.004, 0.004, 0.007, 0.011, 0.025, 0.042, 0.046, 0.048, 0.042, 0.050, 0.057, 0.046, 0.057, 0.044, 0.092, 0.150, 0.117, 0.060, 0.035, 0.025, 0.016, 0.011".
@@ -3310,8 +3609,8 @@ Ceiling fan energy use is calculated per the Energy Rating Rated Home in `ANSI/R
3310
3609
  A reduced cooling setpoint can be specified for months when ceiling fans are operating.
3311
3610
  See :ref:`hvac_control` for more information.
3312
3611
 
3313
- HPXML Pools & Hot Tubs
3314
- ----------------------
3612
+ HPXML Pools & Permanent Spas
3613
+ ----------------------------
3315
3614
 
3316
3615
  HPXML Pools
3317
3616
  ***********
@@ -3332,8 +3631,8 @@ If not entered, the simulation will not include a pool.
3332
3631
  Pool Pump
3333
3632
  ~~~~~~~~~
3334
3633
 
3335
- If a pool is specified, a single pool pump can be entered as a ``Pool/PoolPumps/PoolPump``.
3336
- If not entered, the simulation will not include a pool heater.
3634
+ If a pool is specified, a single pool pump can be entered as a ``Pool/Pumps/Pump``.
3635
+ If not entered, the simulation will not include a pool pump.
3337
3636
 
3338
3637
  ======================================== ======= ====== =========== ======== ============ ======================================
3339
3638
  Element Type Units Constraints Required Default Notes
@@ -3374,80 +3673,90 @@ If not entered, the simulation will not include a pool heater.
3374
3673
 
3375
3674
  .. [#] Type choices are "none, "gas fired", "electric resistance", or "heat pump".
3376
3675
  If "none" is entered, the simulation will not include a pool heater.
3377
- .. [#] | If Value not provided, defaults as follows:
3378
- | - **gas fired [therm/year]**: 3.0 / 0.014 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920) (based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3379
- | - **electric resistance [kWh/year]**: 8.3 / 0.004 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920) (based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3380
- | - **heat pump [kWh/year]**: (electric resistance) / 5.0 (based on an average COP of 5 from `Energy Saver <https://www.energy.gov/energysaver/heat-pump-swimming-pool-heaters>`_)
3381
- | If NumberofResidents provided, this value will be adjusted using the :ref:`buildingoccupancy`.
3676
+ .. [#] If Value not provided, defaults as follows:
3677
+
3678
+ \- **gas fired [therm/year]**: 3.0 / 0.014 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920) (based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3679
+
3680
+ \- **electric resistance [kWh/year]**: 8.3 / 0.004 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920) (based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3681
+
3682
+ \- **heat pump [kWh/year]**: (electric resistance) / 5.0 (based on an average COP of 5 from `Energy Saver <https://www.energy.gov/energysaver/heat-pump-swimming-pool-heaters>`_)
3683
+
3684
+ If NumberofResidents provided, this value will be adjusted using the :ref:`buildingoccupancy`.
3685
+
3382
3686
  .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided (and :ref:`detailedschedules` not used), default values from Figure 23 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used: "0.003, 0.003, 0.003, 0.004, 0.008, 0.015, 0.026, 0.044, 0.084, 0.121, 0.127, 0.121, 0.120, 0.090, 0.075, 0.061, 0.037, 0.023, 0.013, 0.008, 0.004, 0.003, 0.003, 0.003".
3383
3687
  .. [#] If MonthlyScheduleMultipliers not provided (and :ref:`detailedschedules` not used), default values from Figure 24 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used: "1.154, 1.161, 1.013, 1.010, 1.013, 0.888, 0.883, 0.883, 0.888, 0.978, 0.974, 1.154".
3384
3688
 
3385
- HPXML Hot Tubs
3386
- **************
3689
+ HPXML Permanent Spas
3690
+ ********************
3387
3691
 
3388
- A single hot tub can be entered as a ``/HPXML/Building/BuildingDetails/HotTubs/HotTub``.
3389
- If not entered, the simulation will not include a hot tub.
3692
+ A single permanent spa can be entered as a ``/HPXML/Building/BuildingDetails/Spas/PermanentSpa``.
3693
+ If not entered, the simulation will not include a permanent spa.
3390
3694
 
3391
3695
  ==================== ======= ====== =========== ======== ============ =================
3392
3696
  Element Type Units Constraints Required Default Notes
3393
3697
  ==================== ======= ====== =========== ======== ============ =================
3394
3698
  ``SystemIdentifier`` id Yes Unique identifier
3395
- ``Type`` string See [#]_ Yes Hot tub type
3699
+ ``Type`` string See [#]_ Yes Permanent spa type
3396
3700
  ==================== ======= ====== =========== ======== ============ =================
3397
3701
 
3398
3702
  .. [#] Type choices are "in ground", "on ground", "above ground", "other", "unknown", or "none".
3399
- If "none" is entered, the simulation will not include a hot tub.
3703
+ If "none" is entered, the simulation will not include a permanent spa.
3400
3704
 
3401
- Hot Tub Pump
3402
- ~~~~~~~~~~~~
3705
+ Permanent Spa Pump
3706
+ ~~~~~~~~~~~~~~~~~~
3403
3707
 
3404
- If a hot tub is specified, a single hot tub pump can be entered as a ``HotTub/HotTubPumps/HotTubPump``.
3405
- If not entered, the simulation will not include a hot tub pump.
3708
+ If a permanent spa is specified, a single permanent spa pump can be entered as a ``PermanentSpa/Pumps/Pump``.
3709
+ If not entered, the simulation will not include a permanent spa pump.
3406
3710
 
3407
3711
  ======================================== ======= ====== =========== ======== ============ ======================================
3408
3712
  Element Type Units Constraints Required Default Notes
3409
3713
  ======================================== ======= ====== =========== ======== ============ ======================================
3410
3714
  ``SystemIdentifier`` id Yes Unique identifier
3411
- ``Type`` string See [#]_ Yes Hot tub pump type
3412
- ``Load[Units="kWh/year"]/Value`` double kWh/yr >= 0 No See [#]_ Hot tub pump energy use
3413
- ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on hot tub pump energy use
3715
+ ``Type`` string See [#]_ Yes Permanent spa pump type
3716
+ ``Load[Units="kWh/year"]/Value`` double kWh/yr >= 0 No See [#]_ Permanent spa pump energy use
3717
+ ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on permanent spa pump energy use
3414
3718
  ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
3415
3719
  ``extension/WeekendScheduleFractions`` array No 24 comma-separated weekend fractions
3416
3720
  ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
3417
3721
  ======================================== ======= ====== =========== ======== ============ ======================================
3418
3722
 
3419
3723
  .. [#] Type choices are "single speed", "multi speed", "variable speed", "variable flow", "other", "unknown", or "none".
3420
- If "none" is entered, the simulation will not include a hot tub pump.
3724
+ If "none" is entered, the simulation will not include a permanent spa pump.
3421
3725
  .. [#] If Value not provided, defaults based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_: 59.5 / 0.059 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920).
3422
3726
  If NumberofResidents provided, this value will be adjusted using the :ref:`buildingoccupancy`.
3423
3727
  .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided (and :ref:`detailedschedules` not used), default values from Figure 23 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used: "0.024, 0.029, 0.024, 0.029, 0.047, 0.067, 0.057, 0.024, 0.024, 0.019, 0.015, 0.014, 0.014, 0.014, 0.024, 0.058, 0.126, 0.122, 0.068, 0.061, 0.051, 0.043, 0.024, 0.024".
3424
3728
  .. [#] If MonthlyScheduleMultipliers not provided (and :ref:`detailedschedules` not used), default values from Figure 24 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used: "0.921, 0.928, 0.921, 0.915, 0.921, 1.160, 1.158, 1.158, 1.160, 0.921, 0.915, 0.921".
3425
3729
 
3426
- Hot Tub Heater
3427
- ~~~~~~~~~~~~~~
3730
+ Permanent Spa Heater
3731
+ ~~~~~~~~~~~~~~~~~~~~
3428
3732
 
3429
- If a hot tub is specified, a hot tub heater can be entered as a ``HotTub/Heater``.
3430
- If not entered, the simulation will not include a hot tub heater.
3733
+ If a permanent spa is specified, a permanent spa heater can be entered as a ``PermanentSpa/Heater``.
3734
+ If not entered, the simulation will not include a permanent spa heater.
3431
3735
 
3432
3736
  ====================================================== ======= ================== =========== ======== ======== =======================================
3433
3737
  Element Type Units Constraints Required Default Notes
3434
3738
  ====================================================== ======= ================== =========== ======== ======== =======================================
3435
3739
  ``SystemIdentifier`` id Yes Unique identifier
3436
- ``Type`` string See [#]_ Yes Hot tub heater type
3437
- ``Load[Units="kWh/year" or Units="therm/year"]/Value`` double kWh/yr or therm/yr >= 0 No See [#]_ Hot tub heater energy use
3438
- ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on hot tub heater energy use
3740
+ ``Type`` string See [#]_ Yes Permanent spa heater type
3741
+ ``Load[Units="kWh/year" or Units="therm/year"]/Value`` double kWh/yr or therm/yr >= 0 No See [#]_ Permanent spa heater energy use
3742
+ ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on permanent spa heater energy use
3439
3743
  ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
3440
3744
  ``extension/WeekendScheduleFractions`` array No 24 comma-separated weekend fractions
3441
3745
  ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
3442
3746
  ====================================================== ======= ================== =========== ======== ======== =======================================
3443
3747
 
3444
3748
  .. [#] Type choices are "none, "gas fired", "electric resistance", or "heat pump".
3445
- If "none" is entered, the simulation will not include a hot tub heater.
3446
- .. [#] | If Value not provided, defaults as follows:
3447
- | - **gas fired [therm/year]**: 0.87 / 0.011 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920) (based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3448
- | - **electric resistance [kWh/year]**: 49.0 / 0.048 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920) (based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3449
- | - **heat pump [kWh/year]** = (electric resistance) / 5.0 (based on an average COP of 5 from `Energy Saver <https://www.energy.gov/energysaver/heat-pump-swimming-pool-heaters>`_)
3450
- | If NumberofResidents provided, this value will be adjusted using the :ref:`buildingoccupancy`.
3749
+ If "none" is entered, the simulation will not include a permanent spa heater.
3750
+ .. [#] If Value not provided, defaults as follows:
3751
+
3752
+ \- **gas fired [therm/year]**: 0.87 / 0.011 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920) (based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3753
+
3754
+ \- **electric resistance [kWh/year]**: 49.0 / 0.048 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920) (based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3755
+
3756
+ \- **heat pump [kWh/year]** = (electric resistance) / 5.0 (based on an average COP of 5 from `Energy Saver <https://www.energy.gov/energysaver/heat-pump-swimming-pool-heaters>`_)
3757
+
3758
+ If NumberofResidents provided, this value will be adjusted using the :ref:`buildingoccupancy`.
3759
+
3451
3760
  .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided (and :ref:`detailedschedules` not used), default values from Figure 23 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used: "0.024, 0.029, 0.024, 0.029, 0.047, 0.067, 0.057, 0.024, 0.024, 0.019, 0.015, 0.014, 0.014, 0.014, 0.024, 0.058, 0.126, 0.122, 0.068, 0.061, 0.051, 0.043, 0.024, 0.024".
3452
3761
  .. [#] If MonthlyScheduleMultipliers not provided (and :ref:`detailedschedules` not used), default values from Figure 24 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used: "0.837, 0.835, 1.084, 1.084, 1.084, 1.096, 1.096, 1.096, 1.096, 0.931, 0.925, 0.837".
3453
3762
 
@@ -3481,38 +3790,68 @@ If not entered, the simulation will not include that type of plug load.
3481
3790
  ======================================== ======= ====== =========== ======== ======== =============================================================
3482
3791
 
3483
3792
  .. [#] PlugLoadType choices are "other", "TV other", "well pump", or "electric vehicle charging".
3484
- .. [#] | If Value not provided, defaults as:
3485
- | - **other**: 0.91 * ConditionedFloorArea (based on `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_)
3486
- | - **TV other**: 413.0 + 69.0 * NumberofBedrooms (based on `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_)
3487
- | - **well pump**: 50.8 / 0.127 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920) (based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3488
- | - **electric vehicle charging**: 1666.67 (calculated using AnnualMiles * kWhPerMile / (ChargerEfficiency * BatteryEfficiency) where AnnualMiles=4500, kWhPerMile=0.3, ChargerEfficiency=0.9, and BatteryEfficiency=0.9)
3489
- | If NumberofResidents provided, this value will be adjusted using the :ref:`buildingoccupancy`.
3490
- .. [#] | If FracSensible not provided, defaults as:
3491
- | - **other**: 0.855
3492
- | - **TV other**: 1.0
3493
- | - **well pump**: 0.0
3494
- | - **electric vehicle charging**: 0.0
3793
+ .. [#] If Value not provided, defaults as:
3794
+
3795
+ \- **other**: 0.91 * ConditionedFloorArea (based on `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_)
3796
+
3797
+ \- **TV other**: 413.0 + 69.0 * NumberofBedrooms (based on `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_)
3798
+
3799
+ \- **well pump**: 50.8 / 0.127 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920) (based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3800
+
3801
+ \- **electric vehicle charging**: 1666.67 (calculated using AnnualMiles * kWhPerMile / (ChargerEfficiency * BatteryEfficiency) where AnnualMiles=4500, kWhPerMile=0.3, ChargerEfficiency=0.9, and BatteryEfficiency=0.9)
3802
+
3803
+ If NumberofResidents provided, this value will be adjusted using the :ref:`buildingoccupancy`.
3804
+
3805
+ .. [#] If FracSensible not provided, defaults as:
3806
+
3807
+ \- **other**: 0.855
3808
+
3809
+ \- **TV other**: 1.0
3810
+
3811
+ \- **well pump**: 0.0
3812
+
3813
+ \- **electric vehicle charging**: 0.0
3814
+
3495
3815
  .. [#] The remaining fraction (i.e., 1.0 - FracSensible - FracLatent) must be > 0 and is assumed to be heat gain outside conditioned space and thus lost.
3496
- .. [#] | If FracLatent not provided, defaults as:
3497
- | - **other**: 0.045
3498
- | - **TV other**: 0.0
3499
- | - **well pump**: 0.0
3500
- | - **electric vehicle charging**: 0.0
3501
- .. [#] | If WeekdayScheduleFractions not provided (and :ref:`detailedschedules` not used), defaults as:
3502
- | - **other**: "0.035, 0.033, 0.032, 0.031, 0.032, 0.033, 0.037, 0.042, 0.043, 0.043, 0.043, 0.044, 0.045, 0.045, 0.044, 0.046, 0.048, 0.052, 0.053, 0.05, 0.047, 0.045, 0.04, 0.036" (based on Figure 23 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3503
- | - **TV other**: "0.037, 0.018, 0.009, 0.007, 0.011, 0.018, 0.029, 0.040, 0.049, 0.058, 0.065, 0.072, 0.076, 0.086, 0.091, 0.102, 0.127, 0.156, 0.210, 0.294, 0.363, 0.344, 0.208, 0.090" (based on the `American Time Use Survey <https://www.bls.gov/tus>`_)
3504
- | - **well pump**: "0.044, 0.023, 0.019, 0.015, 0.016, 0.018, 0.026, 0.033, 0.033, 0.032, 0.033, 0.033, 0.032, 0.032, 0.032, 0.033, 0.045, 0.057, 0.066, 0.076, 0.081, 0.086, 0.075, 0.065" (based on Figure 23 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3505
- | - **electric vehicle charging**: "0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042"
3506
- .. [#] | If WeekdendScheduleFractions not provided (and :ref:`detailedschedules` not used), defaults as:
3507
- | - **other**: "0.035, 0.033, 0.032, 0.031, 0.032, 0.033, 0.037, 0.042, 0.043, 0.043, 0.043, 0.044, 0.045, 0.045, 0.044, 0.046, 0.048, 0.052, 0.053, 0.05, 0.047, 0.045, 0.04, 0.036" (based on Figure 23 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3508
- | - **TV other**: "0.044, 0.022, 0.012, 0.008, 0.011, 0.014, 0.024, 0.043, 0.071, 0.094, 0.112, 0.123, 0.132, 0.156, 0.178, 0.196, 0.206, 0.213, 0.251, 0.330, 0.388, 0.358, 0.226, 0.103" (based on the `American Time Use Survey <https://www.bls.gov/tus>`_)
3509
- | - **well pump**: "0.044, 0.023, 0.019, 0.015, 0.016, 0.018, 0.026, 0.033, 0.033, 0.032, 0.033, 0.033, 0.032, 0.032, 0.032, 0.033, 0.045, 0.057, 0.066, 0.076, 0.081, 0.086, 0.075, 0.065" (based on Figure 23 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3510
- | - **electric vehicle charging**: "0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042"
3511
- .. [#] | If MonthlyScheduleMultipliers not provided (and :ref:`detailedschedules` not used), defaults as:
3512
- | - **other**: "1.248, 1.257, 0.993, 0.989, 0.993, 0.827, 0.821, 0.821, 0.827, 0.99, 0.987, 1.248" (based on Figure 24 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3513
- | - **TV other**: "1.137, 1.129, 0.961, 0.969, 0.961, 0.993, 0.996, 0.96, 0.993, 0.867, 0.86, 1.137" (based on the `American Time Use Survey <https://www.bls.gov/tus>`_)
3514
- | - **well pump**: "1.154, 1.161, 1.013, 1.010, 1.013, 0.888, 0.883, 0.883, 0.888, 0.978, 0.974, 1.154" (based on Figure 24 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3515
- | - **electric vehicle charging**: "1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0"
3816
+ .. [#] If FracLatent not provided, defaults as:
3817
+
3818
+ \- **other**: 0.045
3819
+
3820
+ \- **TV other**: 0.0
3821
+
3822
+ \- **well pump**: 0.0
3823
+
3824
+ \- **electric vehicle charging**: 0.0
3825
+
3826
+ .. [#] If WeekdayScheduleFractions not provided (and :ref:`detailedschedules` not used), defaults as:
3827
+
3828
+ \- **other**: "0.035, 0.033, 0.032, 0.031, 0.032, 0.033, 0.037, 0.042, 0.043, 0.043, 0.043, 0.044, 0.045, 0.045, 0.044, 0.046, 0.048, 0.052, 0.053, 0.05, 0.047, 0.045, 0.04, 0.036" (based on Figure 23 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3829
+
3830
+ \- **TV other**: "0.037, 0.018, 0.009, 0.007, 0.011, 0.018, 0.029, 0.040, 0.049, 0.058, 0.065, 0.072, 0.076, 0.086, 0.091, 0.102, 0.127, 0.156, 0.210, 0.294, 0.363, 0.344, 0.208, 0.090" (based on the `American Time Use Survey <https://www.bls.gov/tus>`_)
3831
+
3832
+ \- **well pump**: "0.044, 0.023, 0.019, 0.015, 0.016, 0.018, 0.026, 0.033, 0.033, 0.032, 0.033, 0.033, 0.032, 0.032, 0.032, 0.033, 0.045, 0.057, 0.066, 0.076, 0.081, 0.086, 0.075, 0.065" (based on Figure 23 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3833
+
3834
+ \- **electric vehicle charging**: "0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042"
3835
+
3836
+ .. [#] If WeekdendScheduleFractions not provided (and :ref:`detailedschedules` not used), defaults as:
3837
+
3838
+ \- **other**: "0.035, 0.033, 0.032, 0.031, 0.032, 0.033, 0.037, 0.042, 0.043, 0.043, 0.043, 0.044, 0.045, 0.045, 0.044, 0.046, 0.048, 0.052, 0.053, 0.05, 0.047, 0.045, 0.04, 0.036" (based on Figure 23 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3839
+
3840
+ \- **TV other**: "0.044, 0.022, 0.012, 0.008, 0.011, 0.014, 0.024, 0.043, 0.071, 0.094, 0.112, 0.123, 0.132, 0.156, 0.178, 0.196, 0.206, 0.213, 0.251, 0.330, 0.388, 0.358, 0.226, 0.103" (based on the `American Time Use Survey <https://www.bls.gov/tus>`_)
3841
+
3842
+ \- **well pump**: "0.044, 0.023, 0.019, 0.015, 0.016, 0.018, 0.026, 0.033, 0.033, 0.032, 0.033, 0.033, 0.032, 0.032, 0.032, 0.033, 0.045, 0.057, 0.066, 0.076, 0.081, 0.086, 0.075, 0.065" (based on Figure 23 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3843
+
3844
+ \- **electric vehicle charging**: "0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042, 0.042"
3845
+
3846
+ .. [#] If MonthlyScheduleMultipliers not provided (and :ref:`detailedschedules` not used), defaults as:
3847
+
3848
+ \- **other**: "1.248, 1.257, 0.993, 0.989, 0.993, 0.827, 0.821, 0.821, 0.827, 0.99, 0.987, 1.248" (based on Figure 24 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3849
+
3850
+ \- **TV other**: "1.137, 1.129, 0.961, 0.969, 0.961, 0.993, 0.996, 0.96, 0.993, 0.867, 0.86, 1.137" (based on the `American Time Use Survey <https://www.bls.gov/tus>`_)
3851
+
3852
+ \- **well pump**: "1.154, 1.161, 1.013, 1.010, 1.013, 0.888, 0.883, 0.883, 0.888, 0.978, 0.974, 1.154" (based on Figure 24 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
3853
+
3854
+ \- **electric vehicle charging**: "1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0"
3516
3855
 
3517
3856
  HPXML Fuel Loads
3518
3857
  ****************
@@ -3538,23 +3877,35 @@ If not entered, the simulation will not include that type of fuel load.
3538
3877
  ======================================== ======= ======== =========== ======== ======== =============================================================
3539
3878
 
3540
3879
  .. [#] FuelLoadType choices are "grill", "fireplace", or "lighting".
3541
- .. [#] | If Value not provided, calculated as based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_:
3542
- | - **grill**: 0.87 / 0.029 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920)
3543
- | - **fireplace**: 1.95 / 0.032 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920)
3544
- | - **lighting**: 0.22 / 0.012 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920)
3545
- | If NumberofResidents provided, this value will be adjusted using the :ref:`buildingoccupancy`.
3880
+ .. [#] If Value not provided, calculated as based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_:
3881
+
3882
+ \- **grill**: 0.87 / 0.029 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920)
3883
+
3884
+ \- **fireplace**: 1.95 / 0.032 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920)
3885
+
3886
+ \- **lighting**: 0.22 / 0.012 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.25 * ConditionedFloorArea / 1920)
3887
+
3888
+ If NumberofResidents provided, this value will be adjusted using the :ref:`buildingoccupancy`.
3889
+
3546
3890
  .. [#] 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".
3547
3891
  .. [#] If FracSensible not provided, defaults to 0.5 for fireplace and 0.0 for all other types.
3548
3892
  .. [#] The remaining fraction (i.e., 1.0 - FracSensible - FracLatent) must be > 0 and is assumed to be heat gain outside conditioned space and thus lost.
3549
3893
  .. [#] If FracLatent not provided, defaults to 0.1 for fireplace and 0.0 for all other types.
3550
- .. [#] | If WeekdayScheduleFractions or WeekendScheduleFractions not provided (and :ref:`detailedschedules` not used), default values from Figure 23 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used:
3551
- | - **grill**: "0.004, 0.001, 0.001, 0.002, 0.007, 0.012, 0.029, 0.046, 0.044, 0.041, 0.044, 0.046, 0.042, 0.038, 0.049, 0.059, 0.110, 0.161, 0.115, 0.070, 0.044, 0.019, 0.013, 0.007";
3552
- | - **fireplace**: "0.044, 0.023, 0.019, 0.015, 0.016, 0.018, 0.026, 0.033, 0.033, 0.032, 0.033, 0.033, 0.032, 0.032, 0.032, 0.033, 0.045, 0.057, 0.066, 0.076, 0.081, 0.086, 0.075, 0.065";
3553
- | - **lighting**: "0.044, 0.023, 0.019, 0.015, 0.016, 0.018, 0.026, 0.033, 0.033, 0.032, 0.033, 0.033, 0.032, 0.032, 0.032, 0.033, 0.045, 0.057, 0.066, 0.076, 0.081, 0.086, 0.075, 0.065".
3554
- .. [#] | If MonthlyScheduleMultipliers not provided (and :ref:`detailedschedules` not used), default values from Figure 24 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used:
3555
- | - **grill**: "1.097, 1.097, 0.991, 0.987, 0.991, 0.890, 0.896, 0.896, 0.890, 1.085, 1.085, 1.097";
3556
- | - **fireplace**: "1.154, 1.161, 1.013, 1.010, 1.013, 0.888, 0.883, 0.883, 0.888, 0.978, 0.974, 1.154";
3557
- | - **lighting**: "1.154, 1.161, 1.013, 1.010, 1.013, 0.888, 0.883, 0.883, 0.888, 0.978, 0.974, 1.154".
3894
+ .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided (and :ref:`detailedschedules` not used), default values from Figure 23 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used:
3895
+
3896
+ \- **grill**: "0.004, 0.001, 0.001, 0.002, 0.007, 0.012, 0.029, 0.046, 0.044, 0.041, 0.044, 0.046, 0.042, 0.038, 0.049, 0.059, 0.110, 0.161, 0.115, 0.070, 0.044, 0.019, 0.013, 0.007";
3897
+
3898
+ \- **fireplace**: "0.044, 0.023, 0.019, 0.015, 0.016, 0.018, 0.026, 0.033, 0.033, 0.032, 0.033, 0.033, 0.032, 0.032, 0.032, 0.033, 0.045, 0.057, 0.066, 0.076, 0.081, 0.086, 0.075, 0.065";
3899
+
3900
+ \- **lighting**: "0.044, 0.023, 0.019, 0.015, 0.016, 0.018, 0.026, 0.033, 0.033, 0.032, 0.033, 0.033, 0.032, 0.032, 0.032, 0.033, 0.045, 0.057, 0.066, 0.076, 0.081, 0.086, 0.075, 0.065".
3901
+
3902
+ .. [#] If MonthlyScheduleMultipliers not provided (and :ref:`detailedschedules` not used), default values from Figure 24 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used:
3903
+
3904
+ \- **grill**: "1.097, 1.097, 0.991, 0.987, 0.991, 0.890, 0.896, 0.896, 0.890, 1.085, 1.085, 1.097";
3905
+
3906
+ \- **fireplace**: "1.154, 1.161, 1.013, 1.010, 1.013, 0.888, 0.883, 0.883, 0.888, 0.978, 0.974, 1.154";
3907
+
3908
+ \- **lighting**: "1.154, 1.161, 1.013, 1.010, 1.013, 0.888, 0.883, 0.883, 0.888, 0.978, 0.974, 1.154".
3558
3909
 
3559
3910
  .. _hpxmllocations:
3560
3911
 
@@ -3563,29 +3914,31 @@ HPXML Locations
3563
3914
 
3564
3915
  The various locations used in an HPXML file are defined as follows:
3565
3916
 
3566
- ============================== ======================================================= ======================================= =============
3567
- Value Description Temperature Building Type
3568
- ============================== ======================================================= ======================================= =============
3569
- outside Ambient environment Weather data Any
3570
- ground EnergyPlus calculation Any
3571
- living space Above-grade conditioned space maintained at setpoint EnergyPlus calculation Any
3572
- attic - vented EnergyPlus calculation Any
3573
- attic - unvented EnergyPlus calculation Any
3574
- basement - conditioned Below-grade conditioned space maintained at setpoint EnergyPlus calculation Any
3575
- basement - unconditioned EnergyPlus calculation Any
3576
- crawlspace - vented EnergyPlus calculation Any
3577
- crawlspace - unvented EnergyPlus calculation Any
3578
- crawlspace - conditioned Below-grade conditioned space maintained at setpoint EnergyPlus calculation Any
3579
- garage Single-family garage (not shared parking) EnergyPlus calculation Any
3580
- other housing unit E.g., conditioned adjacent unit or conditioned corridor Same as living space SFA/MF only
3581
- other heated space E.g., shared laundry/equipment space Avg of living space/outside; min of 68F SFA/MF only
3582
- other multifamily buffer space E.g., enclosed unconditioned stairwell Avg of living space/outside; min of 50F SFA/MF only
3583
- other non-freezing space E.g., shared parking garage ceiling Floats with outside; minimum of 40F SFA/MF only
3584
- other exterior Water heater outside Weather data Any
3585
- exterior wall Ducts in exterior wall Avg of living space/outside Any
3586
- under slab Ducts under slab (ground) EnergyPlus calculation Any
3587
- roof deck Ducts on roof deck (outside) Weather data Any
3588
- ============================== ======================================================= ======================================= =============
3917
+ ============================== ======================================================= ============================================ =================
3918
+ Value Description Temperature Building Type
3919
+ ============================== ======================================================= ============================================ =================
3920
+ outside Ambient environment Weather data Any
3921
+ ground EnergyPlus calculation Any
3922
+ conditioned space Above-grade conditioned space maintained at setpoint EnergyPlus calculation Any
3923
+ attic - vented EnergyPlus calculation Any
3924
+ attic - unvented EnergyPlus calculation Any
3925
+ basement - conditioned Below-grade conditioned space maintained at setpoint EnergyPlus calculation Any
3926
+ basement - unconditioned EnergyPlus calculation Any
3927
+ crawlspace - vented EnergyPlus calculation Any
3928
+ crawlspace - unvented EnergyPlus calculation Any
3929
+ crawlspace - conditioned Below-grade conditioned space maintained at setpoint EnergyPlus calculation Any
3930
+ garage Single-family garage (not shared parking) EnergyPlus calculation Any
3931
+ manufactured home underbelly Underneath the belly, ambient environment Weather data Manufactured only
3932
+ manufactured home belly Within the belly Same as conditioned space Manufactured only
3933
+ other housing unit E.g., conditioned adjacent unit or conditioned corridor Same as conditioned space SFA/MF only
3934
+ other heated space E.g., shared laundry/equipment space Avg of conditioned space/outside; min of 68F SFA/MF only
3935
+ other multifamily buffer space E.g., enclosed unconditioned stairwell Avg of conditioned space/outside; min of 50F SFA/MF only
3936
+ other non-freezing space E.g., shared parking garage ceiling Floats with outside; minimum of 40F SFA/MF only
3937
+ other exterior Water heater outside Weather data Any
3938
+ exterior wall Ducts in exterior wall Avg of conditioned space/outside Any
3939
+ under slab Ducts under slab (ground) EnergyPlus calculation Any
3940
+ roof deck Ducts on roof deck (outside) Weather data Any
3941
+ ============================== ======================================================= ============================================ =================
3589
3942
 
3590
3943
  Validating & Debugging Errors
3591
3944
  -----------------------------