urbanopt-cli 0.6.2 → 0.7.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (1061) hide show
  1. checksums.yaml +4 -4
  2. data/.gitignore +1 -0
  3. data/CHANGELOG.md +32 -0
  4. data/CMakeLists.txt +23 -23
  5. data/FindOpenStudioSDK.cmake +6 -6
  6. data/Gemfile +5 -5
  7. data/example_files/Gemfile +10 -7
  8. data/example_files/base_workflow_res.osw +10 -0
  9. data/example_files/example_project_combined.json +13 -3
  10. data/example_files/example_project_with_PV.json +751 -0
  11. data/example_files/mappers/Baseline.rb +51 -30
  12. data/example_files/mappers/CreateBar.rb +37 -0
  13. data/example_files/mappers/FlexibleHotWater.rb +69 -0
  14. data/example_files/mappers/Floorspace.rb +30 -0
  15. data/example_files/mappers/HighEfficiency.rb +5 -4
  16. data/example_files/mappers/base_workflow.osw +5 -0
  17. data/example_files/mappers/createbar_workflow.osw +3 -1
  18. data/example_files/mappers/floorspace_workflow.osw +2 -1
  19. data/example_files/measures/BuildResidentialModel/measure.rb +109 -76
  20. data/example_files/osm_building/7.osm +0 -307
  21. data/example_files/osm_building/8.osm +0 -419
  22. data/example_files/osm_building/9.osm +0 -664
  23. data/example_files/reopt/base_assumptions.json +3 -3
  24. data/example_files/reopt/multiPV_assumptions.json +2 -2
  25. data/example_files/residential/enclosure.tsv +102 -102
  26. data/example_files/resources/hpxml-measures/.github/workflows/config.yml +22 -16
  27. data/example_files/resources/hpxml-measures/.gitignore +3 -7
  28. data/example_files/resources/hpxml-measures/.rubocop.yml +67 -8
  29. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/measure.rb +1752 -1455
  30. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/measure.xml +3229 -5431
  31. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/resources/geometry.rb +386 -553
  32. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/build_residential_hpxml_test.rb +1075 -363
  33. data/example_files/resources/hpxml-measures/BuildResidentialScheduleFile/measure.rb +212 -0
  34. data/example_files/resources/hpxml-measures/BuildResidentialScheduleFile/measure.xml +898 -0
  35. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules.rb +109 -188
  36. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_README.md +0 -0
  37. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML/resources/schedules_clothes_dryer_power_consumption_dist.csv → BuildResidentialScheduleFile/resources/schedules_clothes_dryer_consumption_dist.csv} +0 -0
  38. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML/resources/schedules_clothes_dryer_power_duration_dist.csv → BuildResidentialScheduleFile/resources/schedules_clothes_dryer_duration_dist.csv} +0 -0
  39. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML/resources/schedules_clothes_washer_power_consumption_dist.csv → BuildResidentialScheduleFile/resources/schedules_clothes_washer_consumption_dist.csv} +0 -0
  40. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML/resources/schedules_clothes_washer_power_duration_dist.csv → BuildResidentialScheduleFile/resources/schedules_clothes_washer_duration_dist.csv} +0 -0
  41. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_config.json +2 -2
  42. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_config.md +0 -0
  43. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML/resources/schedules_cooking_power_consumption_dist.csv → BuildResidentialScheduleFile/resources/schedules_cooking_consumption_dist.csv} +0 -0
  44. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML/resources/schedules_cooking_power_duration_dist.csv → BuildResidentialScheduleFile/resources/schedules_cooking_duration_dist.csv} +0 -0
  45. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML/resources/schedules_dishwasher_power_consumption_dist.csv → BuildResidentialScheduleFile/resources/schedules_dishwasher_consumption_dist.csv} +0 -0
  46. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML/resources/schedules_dishwasher_power_duration_dist.csv → BuildResidentialScheduleFile/resources/schedules_dishwasher_duration_dist.csv} +0 -0
  47. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML/resources/schedules_clothes_washer_cluster_size_probability.csv → BuildResidentialScheduleFile/resources/schedules_hot_water_clothes_washer_cluster_size_probability.csv} +0 -0
  48. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML/resources/schedules_clothes_washer_event_duration_probability.csv → BuildResidentialScheduleFile/resources/schedules_hot_water_clothes_washer_event_duration_probability.csv} +0 -0
  49. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML/resources/schedules_dishwasher_cluster_size_probability.csv → BuildResidentialScheduleFile/resources/schedules_hot_water_dishwasher_cluster_size_probability.csv} +0 -0
  50. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML/resources/schedules_dishwasher_event_duration_probability.csv → BuildResidentialScheduleFile/resources/schedules_hot_water_dishwasher_event_duration_probability.csv} +0 -0
  51. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_shower_cluster_size_probability.csv +0 -0
  52. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_shower_event_duration_probability.csv +0 -0
  53. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_0_cooking_evening_duration_probability.csv +0 -0
  54. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_0_cooking_midday_duration_probability.csv +0 -0
  55. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_0_cooking_morning_duration_probability.csv +0 -0
  56. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_0_dishwashing_evening_duration_probability.csv +0 -0
  57. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_0_dishwashing_midday_duration_probability.csv +0 -0
  58. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_0_dishwashing_morning_duration_probability.csv +0 -0
  59. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_0_laundry_evening_duration_probability.csv +0 -0
  60. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_0_laundry_midday_duration_probability.csv +0 -0
  61. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_0_laundry_morning_duration_probability.csv +0 -0
  62. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_0_shower_evening_duration_probability.csv +0 -0
  63. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_0_shower_midday_duration_probability.csv +0 -0
  64. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_0_shower_morning_duration_probability.csv +0 -0
  65. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_1_cooking_evening_duration_probability.csv +0 -0
  66. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_1_cooking_midday_duration_probability.csv +0 -0
  67. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_1_cooking_morning_duration_probability.csv +0 -0
  68. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_1_dishwashing_evening_duration_probability.csv +0 -0
  69. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_1_dishwashing_midday_duration_probability.csv +0 -0
  70. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_1_dishwashing_morning_duration_probability.csv +0 -0
  71. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_1_laundry_evening_duration_probability.csv +0 -0
  72. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_1_laundry_midday_duration_probability.csv +0 -0
  73. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_1_laundry_morning_duration_probability.csv +0 -0
  74. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_1_shower_evening_duration_probability.csv +0 -0
  75. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_1_shower_midday_duration_probability.csv +0 -0
  76. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_1_shower_morning_duration_probability.csv +0 -0
  77. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_2_cooking_evening_duration_probability.csv +0 -0
  78. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_2_cooking_midday_duration_probability.csv +0 -0
  79. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_2_cooking_morning_duration_probability.csv +0 -0
  80. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_2_dishwashing_evening_duration_probability.csv +0 -0
  81. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_2_dishwashing_midday_duration_probability.csv +0 -0
  82. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_2_dishwashing_morning_duration_probability.csv +0 -0
  83. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_2_laundry_evening_duration_probability.csv +0 -0
  84. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_2_laundry_midday_duration_probability.csv +0 -0
  85. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_2_laundry_morning_duration_probability.csv +0 -0
  86. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_2_shower_evening_duration_probability.csv +0 -0
  87. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_2_shower_midday_duration_probability.csv +0 -0
  88. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_2_shower_morning_duration_probability.csv +0 -0
  89. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_3_cooking_evening_duration_probability.csv +0 -0
  90. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_3_cooking_midday_duration_probability.csv +0 -0
  91. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_3_cooking_morning_duration_probability.csv +0 -0
  92. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_3_dishwashing_evening_duration_probability.csv +0 -0
  93. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_3_dishwashing_midday_duration_probability.csv +0 -0
  94. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_3_dishwashing_morning_duration_probability.csv +0 -0
  95. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_3_laundry_evening_duration_probability.csv +0 -0
  96. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_3_laundry_midday_duration_probability.csv +0 -0
  97. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_3_laundry_morning_duration_probability.csv +0 -0
  98. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_3_shower_evening_duration_probability.csv +0 -0
  99. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_3_shower_midday_duration_probability.csv +0 -0
  100. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_duration_probability_cluster_3_shower_morning_duration_probability.csv +0 -0
  101. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_mkv_chain_initial_prob_cluster_0.csv +0 -0
  102. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_mkv_chain_initial_prob_cluster_1.csv +0 -0
  103. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_mkv_chain_initial_prob_cluster_2.csv +0 -0
  104. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_mkv_chain_initial_prob_cluster_3.csv +0 -0
  105. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_mkv_chain_transition_prob_cluster_0.csv +0 -0
  106. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_mkv_chain_transition_prob_cluster_1.csv +0 -0
  107. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_mkv_chain_transition_prob_cluster_2.csv +0 -0
  108. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_mkv_chain_transition_prob_cluster_3.csv +0 -0
  109. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekday_state_and_monthly_schedule_shift.csv +0 -0
  110. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_0_cooking_evening_duration_probability.csv +0 -0
  111. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_0_cooking_midday_duration_probability.csv +0 -0
  112. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_0_cooking_morning_duration_probability.csv +0 -0
  113. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_0_dishwashing_evening_duration_probability.csv +0 -0
  114. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_0_dishwashing_midday_duration_probability.csv +0 -0
  115. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_0_dishwashing_morning_duration_probability.csv +0 -0
  116. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_0_laundry_evening_duration_probability.csv +0 -0
  117. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_0_laundry_midday_duration_probability.csv +0 -0
  118. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_0_laundry_morning_duration_probability.csv +0 -0
  119. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_0_shower_evening_duration_probability.csv +0 -0
  120. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_0_shower_midday_duration_probability.csv +0 -0
  121. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_0_shower_morning_duration_probability.csv +0 -0
  122. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_1_cooking_evening_duration_probability.csv +0 -0
  123. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_1_cooking_midday_duration_probability.csv +0 -0
  124. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_1_cooking_morning_duration_probability.csv +0 -0
  125. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_1_dishwashing_evening_duration_probability.csv +0 -0
  126. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_1_dishwashing_midday_duration_probability.csv +0 -0
  127. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_1_dishwashing_morning_duration_probability.csv +0 -0
  128. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_1_laundry_evening_duration_probability.csv +0 -0
  129. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_1_laundry_midday_duration_probability.csv +0 -0
  130. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_1_laundry_morning_duration_probability.csv +0 -0
  131. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_1_shower_evening_duration_probability.csv +0 -0
  132. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_1_shower_midday_duration_probability.csv +0 -0
  133. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_1_shower_morning_duration_probability.csv +0 -0
  134. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_2_cooking_evening_duration_probability.csv +0 -0
  135. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_2_cooking_midday_duration_probability.csv +0 -0
  136. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_2_cooking_morning_duration_probability.csv +0 -0
  137. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_2_dishwashing_evening_duration_probability.csv +0 -0
  138. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_2_dishwashing_midday_duration_probability.csv +0 -0
  139. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_2_dishwashing_morning_duration_probability.csv +0 -0
  140. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_2_laundry_evening_duration_probability.csv +0 -0
  141. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_2_laundry_midday_duration_probability.csv +0 -0
  142. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_2_laundry_morning_duration_probability.csv +0 -0
  143. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_2_shower_evening_duration_probability.csv +0 -0
  144. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_2_shower_midday_duration_probability.csv +0 -0
  145. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_2_shower_morning_duration_probability.csv +0 -0
  146. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_3_cooking_evening_duration_probability.csv +0 -0
  147. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_3_cooking_midday_duration_probability.csv +0 -0
  148. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_3_cooking_morning_duration_probability.csv +0 -0
  149. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_3_dishwashing_evening_duration_probability.csv +0 -0
  150. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_3_dishwashing_midday_duration_probability.csv +0 -0
  151. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_3_dishwashing_morning_duration_probability.csv +0 -0
  152. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_3_laundry_evening_duration_probability.csv +0 -0
  153. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_3_laundry_midday_duration_probability.csv +0 -0
  154. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_3_laundry_morning_duration_probability.csv +0 -0
  155. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_3_shower_evening_duration_probability.csv +0 -0
  156. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_3_shower_midday_duration_probability.csv +0 -0
  157. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_duration_probability_cluster_3_shower_morning_duration_probability.csv +0 -0
  158. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_mkv_chain_initial_prob_cluster_0.csv +0 -0
  159. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_mkv_chain_initial_prob_cluster_1.csv +0 -0
  160. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_mkv_chain_initial_prob_cluster_2.csv +0 -0
  161. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_mkv_chain_initial_prob_cluster_3.csv +0 -0
  162. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_mkv_chain_transition_prob_cluster_0.csv +0 -0
  163. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_mkv_chain_transition_prob_cluster_1.csv +0 -0
  164. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_mkv_chain_transition_prob_cluster_2.csv +0 -0
  165. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_mkv_chain_transition_prob_cluster_3.csv +0 -0
  166. data/example_files/resources/hpxml-measures/{BuildResidentialHPXML → BuildResidentialScheduleFile}/resources/schedules_weekend_state_and_monthly_schedule_shift.csv +0 -0
  167. data/example_files/resources/hpxml-measures/BuildResidentialScheduleFile/tests/build_residential_schedule_file_test.rb +526 -0
  168. data/example_files/resources/hpxml-measures/Changelog.md +84 -8
  169. data/example_files/resources/hpxml-measures/Gemfile +3 -0
  170. data/example_files/resources/hpxml-measures/Gemfile.lock +3 -11
  171. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/measure.rb +387 -387
  172. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/measure.xml +167 -251
  173. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/BaseElements.xsd +275 -59
  174. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/EPvalidator.xml +471 -247
  175. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/HPXML.xsd +1 -1
  176. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/HPXMLDataTypes.xsd +171 -79
  177. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/HPXMLvalidator.xml +155 -78
  178. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/airflow.rb +188 -141
  179. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/battery.rb +83 -0
  180. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/constants.rb +99 -11
  181. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/constructions.rb +558 -342
  182. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/energyplus.rb +2 -0
  183. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/geometry.rb +64 -72
  184. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/hotwater_appliances.rb +96 -93
  185. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/hpxml.rb +965 -350
  186. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/hpxml_defaults.rb +887 -216
  187. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/hvac.rb +664 -760
  188. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/hvac_sizing.rb +306 -287
  189. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/lighting.rb +20 -29
  190. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/location.rb +0 -20
  191. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/lu_hvac_equipment_efficiency.csv +493 -0
  192. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/lu_water_heater_efficiency.csv +157 -0
  193. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/materials.rb +156 -108
  194. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/meta_measure.rb +41 -3
  195. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/minitest_helper.rb +14 -2
  196. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/misc_loads.rb +18 -18
  197. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/pv.rb +14 -7
  198. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/schedule_files/smooth.csv +8761 -0
  199. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/schedule_files/stochastic-vacancy.csv +8761 -0
  200. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/schedule_files/stochastic.csv +8761 -0
  201. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/schedules.rb +431 -428
  202. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/validator.rb +21 -12
  203. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/version.rb +3 -3
  204. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/waterheater.rb +245 -234
  205. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/weather.rb +10 -5
  206. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/xmlhelper.rb +19 -8
  207. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_airflow.rb +44 -23
  208. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_battery.rb +241 -0
  209. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_defaults.rb +1374 -297
  210. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_enclosure.rb +702 -55
  211. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_generator.rb +0 -1
  212. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_hotwater_appliance.rb +1 -1
  213. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_hvac.rb +238 -40
  214. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_lighting.rb +2 -2
  215. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_pv.rb +0 -2
  216. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_schedules.rb +186 -0
  217. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_validation.rb +955 -176
  218. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/test_water_heater.rb +47 -61
  219. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/tests/util.rb +1 -1
  220. data/example_files/resources/hpxml-measures/LICENSE.md +1 -1
  221. data/example_files/resources/hpxml-measures/README.md +12 -9
  222. data/example_files/resources/hpxml-measures/Rakefile +1 -1
  223. data/example_files/resources/hpxml-measures/ReportHPXMLOutput/measure.rb +448 -0
  224. data/example_files/resources/hpxml-measures/ReportHPXMLOutput/measure.xml +81 -0
  225. data/example_files/resources/hpxml-measures/ReportHPXMLOutput/resources/constants.rb +71 -0
  226. data/example_files/resources/hpxml-measures/ReportHPXMLOutput/tests/hpxml_output_report_test.rb +232 -0
  227. data/example_files/resources/hpxml-measures/ReportSimulationOutput/measure.rb +1977 -0
  228. data/example_files/resources/hpxml-measures/{SimulationOutputReport → ReportSimulationOutput}/measure.xml +682 -31
  229. data/example_files/resources/hpxml-measures/{SimulationOutputReport → ReportSimulationOutput}/resources/constants.rb +20 -2
  230. data/example_files/resources/hpxml-measures/{SimulationOutputReport → ReportSimulationOutput}/tests/output_report_test.rb +83 -218
  231. data/example_files/resources/hpxml-measures/docs/source/index.rst +1 -2
  232. data/example_files/resources/hpxml-measures/docs/source/intro.rst +6 -3
  233. data/example_files/resources/hpxml-measures/docs/source/usage_instructions.rst +73 -0
  234. data/example_files/resources/hpxml-measures/docs/source/workflow_inputs.rst +915 -494
  235. data/example_files/resources/hpxml-measures/docs/source/workflow_outputs.rst +263 -111
  236. data/example_files/resources/hpxml-measures/tasks.rb +3830 -6981
  237. data/example_files/resources/hpxml-measures/weather/ZAF_Cape.Town.688160_IWEC-cache.csv +35 -0
  238. data/example_files/resources/hpxml-measures/weather/ZAF_Cape.Town.688160_IWEC.epw +8768 -0
  239. data/example_files/resources/hpxml-measures/workflow/run_simulation.rb +25 -5
  240. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-coal.xml +102 -91
  241. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-dehumidifier-ief-portable.xml +93 -83
  242. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-dehumidifier-ief-whole-home.xml +93 -83
  243. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-dehumidifier-multiple.xml +93 -83
  244. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-dehumidifier.xml +93 -83
  245. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-gas.xml +102 -91
  246. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-modified.xml +103 -97
  247. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-none.xml +96 -85
  248. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-oil.xml +102 -91
  249. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-propane.xml +102 -91
  250. data/example_files/resources/hpxml-measures/workflow/sample_files/base-appliances-wood.xml +102 -91
  251. data/example_files/resources/hpxml-measures/workflow/sample_files/base-atticroof-cathedral.xml +96 -125
  252. data/example_files/resources/hpxml-measures/workflow/sample_files/base-atticroof-conditioned.xml +119 -104
  253. data/example_files/resources/hpxml-measures/workflow/sample_files/base-atticroof-flat.xml +94 -89
  254. data/example_files/resources/hpxml-measures/workflow/sample_files/base-atticroof-radiant-barrier.xml +93 -83
  255. data/example_files/resources/hpxml-measures/workflow/sample_files/base-atticroof-unvented-insulated-roof.xml +104 -95
  256. data/example_files/resources/hpxml-measures/workflow/sample_files/base-atticroof-vented.xml +104 -95
  257. data/example_files/resources/hpxml-measures/workflow/sample_files/base-battery-outside.xml +584 -0
  258. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-adjacent-to-multifamily-buffer-space.xml +99 -68
  259. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-adjacent-to-multiple.xml +119 -79
  260. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-adjacent-to-non-freezing-space.xml +99 -68
  261. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-adjacent-to-other-heated-space.xml +99 -68
  262. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-adjacent-to-other-housing-unit.xml +99 -68
  263. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-boiler-chiller-baseboard.xml +97 -66
  264. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-boiler-chiller-fan-coil-ducted.xml +97 -66
  265. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-boiler-chiller-fan-coil.xml +97 -66
  266. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-boiler-chiller-water-loop-heat-pump.xml +100 -69
  267. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-boiler-cooling-tower-water-loop-heat-pump.xml +100 -69
  268. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-boiler-only-baseboard.xml +94 -65
  269. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-boiler-only-fan-coil-ducted.xml +94 -65
  270. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-boiler-only-fan-coil-eae.xml +94 -65
  271. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-boiler-only-fan-coil.xml +94 -65
  272. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-boiler-only-water-loop-heat-pump.xml +97 -68
  273. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-chiller-only-baseboard.xml +94 -65
  274. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-chiller-only-fan-coil-ducted.xml +94 -65
  275. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-chiller-only-fan-coil.xml +94 -65
  276. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-chiller-only-water-loop-heat-pump.xml +97 -68
  277. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-cooling-tower-only-water-loop-heat-pump.xml +97 -68
  278. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-generator.xml +98 -67
  279. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-ground-loop-ground-to-air-heat-pump.xml +96 -64
  280. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-laundry-room.xml +105 -84
  281. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-mechvent-multiple.xml +108 -77
  282. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-mechvent-preconditioning.xml +100 -69
  283. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-mechvent.xml +100 -69
  284. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-pv.xml +98 -67
  285. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-water-heater-recirc.xml +97 -66
  286. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily-shared-water-heater.xml +97 -66
  287. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-multifamily.xml +97 -66
  288. data/example_files/resources/hpxml-measures/workflow/sample_files/{invalid_files/invalid-facility-type-surfaces.xml → base-bldgtype-single-family-attached-2stories.xml} +152 -167
  289. data/example_files/resources/hpxml-measures/workflow/sample_files/base-bldgtype-single-family-attached.xml +124 -114
  290. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-combi-tankless-outside.xml +102 -95
  291. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-combi-tankless.xml +102 -95
  292. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-desuperheater-2-speed.xml +102 -95
  293. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-desuperheater-gshp.xml +104 -94
  294. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-desuperheater-hpwh.xml +105 -96
  295. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-desuperheater-tankless.xml +102 -95
  296. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-desuperheater-var-speed.xml +102 -95
  297. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-desuperheater.xml +102 -95
  298. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-dwhr.xml +104 -95
  299. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-indirect-dse.xml +102 -95
  300. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-indirect-outside.xml +102 -95
  301. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-indirect-standbyloss.xml +102 -95
  302. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-indirect-with-solar-fraction.xml +104 -97
  303. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-indirect.xml +102 -95
  304. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-jacket-electric.xml +104 -95
  305. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-jacket-gas.xml +104 -95
  306. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-jacket-hpwh.xml +104 -95
  307. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-jacket-indirect.xml +102 -95
  308. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-low-flow-fixtures.xml +104 -95
  309. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-multiple.xml +108 -101
  310. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-none.xml +96 -85
  311. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-recirc-demand.xml +104 -95
  312. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-recirc-manual.xml +104 -95
  313. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-recirc-nocontrol.xml +104 -95
  314. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-recirc-temperature.xml +104 -95
  315. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-recirc-timer.xml +104 -95
  316. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-solar-direct-evacuated-tube.xml +106 -97
  317. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-solar-direct-flat-plate.xml +106 -97
  318. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-solar-direct-ics.xml +106 -97
  319. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-solar-fraction.xml +106 -97
  320. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-solar-indirect-flat-plate.xml +106 -97
  321. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-solar-thermosyphon-flat-plate.xml +106 -97
  322. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-coal.xml +104 -95
  323. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-elec-uef.xml +105 -96
  324. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-gas-outside.xml +104 -95
  325. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-gas-uef-fhr.xml +574 -0
  326. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-gas-uef.xml +105 -96
  327. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-gas.xml +104 -95
  328. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-heat-pump-outside.xml +104 -95
  329. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-heat-pump-uef.xml +105 -97
  330. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-heat-pump-with-solar-fraction.xml +106 -97
  331. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-heat-pump-with-solar.xml +106 -97
  332. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-heat-pump.xml +104 -95
  333. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-oil.xml +104 -95
  334. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tank-wood.xml +104 -95
  335. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-electric-outside.xml +104 -95
  336. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-electric-uef.xml +104 -95
  337. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-electric.xml +104 -95
  338. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-gas-uef.xml +104 -95
  339. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-gas-with-solar-fraction.xml +106 -97
  340. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-gas-with-solar.xml +106 -97
  341. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-gas.xml +104 -95
  342. data/example_files/resources/hpxml-measures/workflow/sample_files/base-dhw-tankless-propane.xml +104 -95
  343. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-2stories-garage.xml +131 -119
  344. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-2stories.xml +120 -99
  345. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-beds-1.xml +104 -95
  346. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-beds-2.xml +104 -95
  347. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-beds-4.xml +104 -95
  348. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-beds-5.xml +104 -95
  349. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-garage.xml +131 -118
  350. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-infil-ach-house-pressure.xml +104 -95
  351. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-infil-cfm-house-pressure.xml +104 -95
  352. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-infil-cfm50.xml +104 -95
  353. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-infil-flue.xml +104 -95
  354. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-infil-natural-ach.xml +104 -95
  355. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-orientations.xml +579 -0
  356. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-overhangs.xml +110 -101
  357. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-rooftypes.xml +213 -95
  358. data/example_files/resources/hpxml-measures/workflow/sample_files/{invalid_files/invalid-id.xml → base-enclosure-skylights-physical-properties.xml} +123 -105
  359. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-skylights-shading.xml +114 -105
  360. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-skylights.xml +112 -103
  361. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-split-level.xml +92 -82
  362. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-split-surfaces.xml +533 -547
  363. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-split-surfaces2.xml +545 -559
  364. data/example_files/resources/hpxml-measures/workflow/sample_files/{invalid_files/generator-output-greater-than-consumption.xml → base-enclosure-thermal-mass.xml} +117 -111
  365. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-walltypes.xml +239 -109
  366. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-windows-none.xml +88 -79
  367. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-windows-physical-properties.xml +584 -0
  368. data/example_files/resources/hpxml-measures/workflow/sample_files/base-enclosure-windows-shading.xml +115 -106
  369. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-ambient.xml +89 -79
  370. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-basement-garage.xml +123 -110
  371. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-complex.xml +119 -172
  372. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-conditioned-basement-slab-insulation.xml +104 -95
  373. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-conditioned-basement-wall-interior-insulation.xml +107 -95
  374. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-conditioned-crawlspace.xml +572 -0
  375. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-multiple.xml +119 -128
  376. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-slab.xml +92 -82
  377. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-unconditioned-basement-above-grade.xml +117 -110
  378. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-unconditioned-basement-assembly-r.xml +106 -91
  379. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-unconditioned-basement-wall-insulation.xml +107 -98
  380. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-unconditioned-basement.xml +105 -97
  381. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-unvented-crawlspace.xml +108 -98
  382. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-vented-crawlspace.xml +108 -98
  383. data/example_files/resources/hpxml-measures/workflow/sample_files/base-foundation-walkout-basement.xml +115 -110
  384. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-1-speed-cooling-only.xml +101 -94
  385. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-1-speed-heating-only.xml +103 -95
  386. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-1-speed.xml +104 -94
  387. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-2-speed.xml +104 -94
  388. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-var-speed-backup-boiler-switchover-temperature.xml +590 -0
  389. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-var-speed-backup-boiler.xml +589 -0
  390. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-air-to-air-heat-pump-var-speed.xml +104 -94
  391. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-1-speed-cooling-only.xml +104 -94
  392. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-1-speed-heating-only.xml +105 -94
  393. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-1-speed-manual-s-oversize-allowances.xml +103 -93
  394. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-1-speed.xml +106 -93
  395. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-2-speed-manual-s-oversize-allowances.xml +103 -93
  396. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-2-speed.xml +106 -93
  397. data/example_files/resources/hpxml-measures/workflow/sample_files/{invalid_files/hvac-invalid-distribution-system-type.xml → base-hvac-autosize-air-to-air-heat-pump-var-speed-backup-boiler.xml} +587 -570
  398. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-var-speed-manual-s-oversize-allowances.xml +103 -93
  399. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-air-to-air-heat-pump-var-speed.xml +106 -93
  400. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-boiler-elec-only.xml +102 -95
  401. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-boiler-gas-central-ac-1-speed.xml +103 -94
  402. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-boiler-gas-only.xml +101 -94
  403. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-central-ac-only-1-speed.xml +101 -94
  404. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-central-ac-only-2-speed.xml +101 -94
  405. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-central-ac-only-var-speed.xml +101 -94
  406. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-central-ac-plus-air-to-air-heat-pump-heating.xml +108 -95
  407. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-dual-fuel-air-to-air-heat-pump-1-speed.xml +106 -93
  408. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-dual-fuel-mini-split-heat-pump-ducted.xml +106 -93
  409. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-elec-resistance-only.xml +99 -92
  410. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-evap-cooler-furnace-gas.xml +103 -94
  411. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-floor-furnace-propane-only.xml +99 -92
  412. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-furnace-elec-only.xml +102 -95
  413. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-furnace-gas-central-ac-2-speed.xml +104 -95
  414. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-furnace-gas-central-ac-var-speed.xml +104 -95
  415. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-furnace-gas-only.xml +101 -94
  416. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-furnace-gas-room-ac.xml +103 -94
  417. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-ground-to-air-heat-pump-cooling-only.xml +104 -94
  418. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-ground-to-air-heat-pump-heating-only.xml +105 -94
  419. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-ground-to-air-heat-pump-manual-s-oversize-allowances.xml +103 -93
  420. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-ground-to-air-heat-pump.xml +106 -93
  421. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-mini-split-air-conditioner-only-ducted.xml +101 -94
  422. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-mini-split-heat-pump-ducted-cooling-only.xml +104 -94
  423. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-mini-split-heat-pump-ducted-heating-only.xml +105 -94
  424. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-mini-split-heat-pump-ducted-manual-s-oversize-allowances.xml +103 -93
  425. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-mini-split-heat-pump-ducted.xml +106 -93
  426. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-mini-split-heat-pump-ductless-backup-stove.xml +541 -0
  427. data/example_files/resources/hpxml-measures/workflow/sample_files/{invalid_files/invalid-relatedhvac-dhw-indirect.xml → base-hvac-autosize-ptac-with-heating.xml} +528 -517
  428. data/example_files/resources/hpxml-measures/workflow/sample_files/{invalid_files/boiler-invalid-afue.xml → base-hvac-autosize-ptac.xml} +109 -113
  429. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-pthp.xml +531 -0
  430. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-room-ac-only.xml +99 -92
  431. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-stove-oil-only.xml +99 -92
  432. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize-wall-furnace-elec-only.xml +100 -93
  433. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-autosize.xml +104 -95
  434. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-boiler-coal-only.xml +101 -94
  435. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-boiler-elec-only.xml +102 -95
  436. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-boiler-gas-central-ac-1-speed.xml +103 -94
  437. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-boiler-gas-only.xml +101 -94
  438. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-boiler-oil-only.xml +101 -94
  439. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-boiler-propane-only.xml +101 -94
  440. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-boiler-wood-only.xml +101 -94
  441. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-central-ac-only-1-speed.xml +101 -94
  442. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-central-ac-only-2-speed.xml +101 -94
  443. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-central-ac-only-var-speed.xml +101 -94
  444. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-central-ac-plus-air-to-air-heat-pump-heating.xml +106 -96
  445. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-dse.xml +104 -95
  446. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-dual-fuel-air-to-air-heat-pump-1-speed-electric.xml +104 -94
  447. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-dual-fuel-air-to-air-heat-pump-1-speed.xml +104 -94
  448. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-dual-fuel-air-to-air-heat-pump-2-speed.xml +104 -94
  449. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-dual-fuel-air-to-air-heat-pump-var-speed.xml +104 -94
  450. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-dual-fuel-mini-split-heat-pump-ducted.xml +104 -94
  451. data/example_files/resources/hpxml-measures/workflow/sample_files/{invalid_files/unattached-solar-thermal-system.xml → base-hvac-ducts-area-fractions.xml} +596 -577
  452. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-install-quality-none-furnace-gas-central-ac-1-speed.xml → base-hvac-ducts-leakage-cfm50.xml} +108 -106
  453. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-ducts-leakage-percent.xml +104 -95
  454. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-elec-resistance-only.xml +99 -92
  455. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-evap-cooler-furnace-gas.xml +103 -94
  456. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-evap-cooler-only-ducted.xml +101 -94
  457. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-evap-cooler-only.xml +99 -92
  458. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-fireplace-wood-only.xml +99 -92
  459. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-fixed-heater-gas-only.xml +99 -92
  460. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-floor-furnace-propane-only.xml +99 -92
  461. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-coal-only.xml +101 -94
  462. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-elec-central-ac-1-speed.xml +104 -95
  463. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-elec-only.xml +102 -95
  464. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-gas-central-ac-2-speed.xml +104 -95
  465. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-gas-central-ac-var-speed.xml +104 -95
  466. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-gas-only.xml +101 -94
  467. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-gas-room-ac.xml +103 -94
  468. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-oil-only.xml +101 -94
  469. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-propane-only.xml +101 -94
  470. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-wood-only.xml +101 -94
  471. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-furnace-x3-dse.xml +104 -95
  472. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-ground-to-air-heat-pump-cooling-only.xml +101 -94
  473. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-ground-to-air-heat-pump-heating-only.xml +102 -94
  474. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-ground-to-air-heat-pump.xml +103 -93
  475. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-install-quality-all-air-to-air-heat-pump-1-speed.xml → base-hvac-install-quality-air-to-air-heat-pump-1-speed.xml} +104 -94
  476. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-install-quality-all-air-to-air-heat-pump-2-speed.xml → base-hvac-install-quality-air-to-air-heat-pump-2-speed.xml} +104 -94
  477. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-install-quality-all-air-to-air-heat-pump-var-speed.xml → base-hvac-install-quality-air-to-air-heat-pump-var-speed.xml} +104 -94
  478. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-install-quality-all-furnace-gas-central-ac-1-speed.xml → base-hvac-install-quality-furnace-gas-central-ac-1-speed.xml} +104 -95
  479. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-install-quality-all-furnace-gas-central-ac-2-speed.xml → base-hvac-install-quality-furnace-gas-central-ac-2-speed.xml} +104 -95
  480. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-install-quality-all-furnace-gas-central-ac-var-speed.xml → base-hvac-install-quality-furnace-gas-central-ac-var-speed.xml} +104 -95
  481. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-install-quality-all-furnace-gas-only.xml → base-hvac-install-quality-furnace-gas-only.xml} +101 -94
  482. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-install-quality-all-ground-to-air-heat-pump.xml → base-hvac-install-quality-ground-to-air-heat-pump.xml} +104 -94
  483. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-install-quality-all-mini-split-air-conditioner-only-ducted.xml → base-hvac-install-quality-mini-split-air-conditioner-only-ducted.xml} +101 -94
  484. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-install-quality-all-mini-split-heat-pump-ducted.xml → base-hvac-install-quality-mini-split-heat-pump-ducted.xml} +104 -94
  485. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-air-conditioner-only-ducted.xml +101 -94
  486. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-air-conditioner-only-ductless.xml +99 -92
  487. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-heat-pump-ducted-cooling-only.xml +101 -94
  488. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-heat-pump-ducted-heating-only.xml +103 -95
  489. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-heat-pump-ducted.xml +104 -94
  490. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-heat-pump-ductless-backup-stove.xml +542 -0
  491. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-mini-split-heat-pump-ductless.xml +101 -92
  492. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-multiple.xml +124 -100
  493. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-none.xml +94 -89
  494. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-portable-heater-gas-only.xml +99 -92
  495. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-programmable-thermostat-detailed.xml +104 -95
  496. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-programmable-thermostat.xml +104 -95
  497. data/example_files/resources/hpxml-measures/workflow/sample_files/{invalid_files/cfis-with-hydronic-distribution.xml → base-hvac-ptac-with-heating.xml} +530 -532
  498. data/example_files/resources/hpxml-measures/workflow/sample_files/{invalid_files/hvac-distribution-return-duct-leakage-missing.xml → base-hvac-ptac.xml} +515 -528
  499. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-pthp.xml +531 -0
  500. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-room-ac-only-33percent.xml +99 -92
  501. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-room-ac-only-ceer.xml +516 -0
  502. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-room-ac-only.xml +99 -92
  503. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-seasons.xml +584 -0
  504. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-setpoints.xml +104 -95
  505. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-stove-oil-only.xml +99 -92
  506. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-stove-wood-pellets-only.xml +99 -92
  507. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-undersized-allow-increased-fixed-capacities.xml +104 -95
  508. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-undersized.xml +104 -95
  509. data/example_files/resources/hpxml-measures/workflow/sample_files/base-hvac-wall-furnace-elec-only.xml +100 -93
  510. data/example_files/resources/hpxml-measures/workflow/sample_files/base-lighting-ceiling-fans.xml +110 -96
  511. data/example_files/resources/hpxml-measures/workflow/sample_files/base-lighting-holiday.xml +586 -0
  512. data/example_files/resources/hpxml-measures/workflow/sample_files/base-lighting-none.xml +95 -86
  513. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-AMY-2012.xml +104 -95
  514. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-baltimore-md.xml +108 -98
  515. data/example_files/resources/hpxml-measures/workflow/sample_files/{invalid_files/invalid-foundation-wall-properties.xml → base-location-capetown-zaf.xml} +134 -127
  516. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-dallas-tx.xml +92 -82
  517. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-duluth-mn.xml +105 -98
  518. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-helena-mt.xml +104 -95
  519. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-honolulu-hi.xml +92 -82
  520. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-miami-fl.xml +92 -82
  521. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-phoenix-az.xml +92 -82
  522. data/example_files/resources/hpxml-measures/workflow/sample_files/base-location-portland-or.xml +108 -98
  523. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-balanced.xml +106 -97
  524. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-bath-kitchen-fans.xml +106 -97
  525. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-cfis-dse.xml +107 -98
  526. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-cfis-evap-cooler-only-ducted.xml +104 -97
  527. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-cfis.xml +107 -98
  528. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-erv-atre-asre.xml +106 -97
  529. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-erv.xml +106 -97
  530. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-exhaust-rated-flow-rate.xml +105 -96
  531. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-exhaust.xml +106 -97
  532. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-hrv-asre.xml +106 -97
  533. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-hrv.xml +106 -97
  534. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-multiple.xml +141 -114
  535. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-supply.xml +106 -97
  536. data/example_files/resources/hpxml-measures/workflow/sample_files/base-mechvent-whole-house-fan.xml +105 -96
  537. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-defaults.xml +101 -101
  538. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-generators.xml +105 -96
  539. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-loads-large-uncommon.xml +157 -112
  540. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-loads-large-uncommon2.xml +157 -112
  541. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-loads-none.xml +96 -87
  542. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-neighbor-shading.xml +108 -99
  543. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-shielding-of-home.xml +104 -95
  544. data/example_files/resources/hpxml-measures/workflow/sample_files/base-misc-usage-multiplier.xml +113 -102
  545. data/example_files/resources/hpxml-measures/workflow/sample_files/base-multiple-buildings.xml +318 -291
  546. data/example_files/resources/hpxml-measures/workflow/sample_files/base-pv-battery-ah.xml +608 -0
  547. data/example_files/resources/hpxml-measures/workflow/sample_files/{invalid_files/enclosure-garage-missing-roof-ceiling.xml → base-pv-battery-garage.xml} +678 -626
  548. data/example_files/resources/hpxml-measures/workflow/sample_files/{invalid_files/multifamily-reference-surface.xml → base-pv-battery-outside-degrades.xml} +610 -575
  549. data/example_files/resources/hpxml-measures/workflow/sample_files/base-pv-battery-outside.xml +608 -0
  550. data/example_files/resources/hpxml-measures/workflow/sample_files/base-pv.xml +105 -96
  551. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-install-quality-airflow-defect-furnace-gas-central-ac-1-speed.xml → base-schedules-detailed-smooth.xml} +105 -101
  552. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-install-quality-charge-defect-furnace-gas-central-ac-1-speed.xml → base-schedules-detailed-stochastic-vacancy.xml} +105 -98
  553. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-hvac-install-quality-blower-efficiency-furnace-gas-central-ac-1-speed.xml → base-schedules-detailed-stochastic.xml} +105 -101
  554. data/example_files/resources/hpxml-measures/workflow/sample_files/{base-lighting-detailed.xml → base-schedules-simple.xml} +625 -585
  555. data/example_files/resources/hpxml-measures/workflow/sample_files/base-simcontrol-calendar-year-custom.xml +104 -95
  556. data/example_files/resources/hpxml-measures/workflow/sample_files/base-simcontrol-daylight-saving-custom.xml +104 -95
  557. data/example_files/resources/hpxml-measures/workflow/sample_files/base-simcontrol-daylight-saving-disabled.xml +104 -95
  558. data/example_files/resources/hpxml-measures/workflow/sample_files/base-simcontrol-runperiod-1-month.xml +104 -95
  559. data/example_files/resources/hpxml-measures/workflow/sample_files/base-simcontrol-timestep-10-mins.xml +104 -95
  560. data/example_files/resources/hpxml-measures/workflow/sample_files/base.xml +104 -95
  561. data/example_files/resources/hpxml-measures/workflow/template-build-hpxml-and-stocastic-schedules.osw +129 -0
  562. data/example_files/resources/hpxml-measures/workflow/template-stochastic-schedules.osw +53 -0
  563. data/example_files/resources/hpxml-measures/workflow/template.osw +7 -2
  564. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L100AC.xml +75 -44
  565. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L100AL.xml +75 -44
  566. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L110AC.xml +75 -44
  567. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L110AL.xml +75 -44
  568. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L120AC.xml +75 -44
  569. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L120AL.xml +75 -44
  570. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L130AC.xml +75 -44
  571. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L130AL.xml +75 -44
  572. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L140AC.xml +63 -32
  573. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L140AL.xml +63 -32
  574. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L150AC.xml +66 -35
  575. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L150AL.xml +66 -35
  576. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L155AC.xml +66 -35
  577. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L155AL.xml +66 -35
  578. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L160AC.xml +69 -38
  579. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L160AL.xml +69 -38
  580. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L170AC.xml +75 -44
  581. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L170AL.xml +75 -44
  582. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L200AC.xml +75 -44
  583. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L200AL.xml +75 -44
  584. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L202AC.xml +75 -44
  585. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L202AL.xml +75 -44
  586. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L302XC.xml +78 -47
  587. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L304XC.xml +78 -47
  588. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L322XC.xml +114 -103
  589. data/example_files/resources/hpxml-measures/workflow/tests/ASHRAE_Standard_140/L324XC.xml +126 -103
  590. data/example_files/resources/hpxml-measures/workflow/tests/base_results/results.csv +321 -294
  591. data/example_files/resources/hpxml-measures/workflow/tests/base_results/results_ashrae_140.csv +26 -26
  592. data/example_files/resources/hpxml-measures/workflow/tests/base_results/results_hvac_sizing.csv +320 -293
  593. data/example_files/resources/hpxml-measures/workflow/tests/compare.py +351 -0
  594. data/example_files/resources/hpxml-measures/workflow/tests/hpxml_translator_test.rb +253 -260
  595. data/example_files/visualization/input_visualization_feature.html +14 -5
  596. data/example_files/visualization/input_visualization_scenario.html +12 -6
  597. data/example_files/weather/USA_NY_Buffalo-Greater.Buffalo.Intl.AP.725280_TMY3.ddy +17 -17
  598. data/lib/uo_cli/version.rb +1 -1
  599. data/lib/uo_cli.rb +66 -17
  600. data/uo_cli.gemspec +6 -6
  601. metadata +219 -639
  602. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/resources/constants.rb +0 -59
  603. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-appliances-coal.osw +0 -337
  604. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-appliances-dehumidifier-ief-portable.osw +0 -337
  605. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-appliances-dehumidifier-ief-whole-home.osw +0 -337
  606. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-appliances-dehumidifier.osw +0 -337
  607. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-appliances-gas.osw +0 -337
  608. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-appliances-modified.osw +0 -337
  609. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-appliances-none.osw +0 -337
  610. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-appliances-oil.osw +0 -337
  611. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-appliances-propane.osw +0 -337
  612. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-appliances-wood.osw +0 -337
  613. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-atticroof-flat.osw +0 -337
  614. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-atticroof-radiant-barrier.osw +0 -337
  615. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-atticroof-unvented-insulated-roof.osw +0 -337
  616. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-atticroof-vented.osw +0 -337
  617. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-bldgtype-multifamily-shared-boiler-only-baseboard.osw +0 -341
  618. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-bldgtype-multifamily-shared-boiler-only-fan-coil.osw +0 -341
  619. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-bldgtype-multifamily-shared-mechvent-preconditioning.osw +0 -348
  620. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-bldgtype-multifamily-shared-mechvent.osw +0 -342
  621. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-bldgtype-multifamily-shared-pv.osw +0 -341
  622. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-bldgtype-multifamily-shared-water-heater.osw +0 -341
  623. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-bldgtype-multifamily.osw +0 -341
  624. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-bldgtype-single-family-attached.osw +0 -339
  625. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-combi-tankless-outside.osw +0 -337
  626. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-combi-tankless.osw +0 -337
  627. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-dwhr.osw +0 -337
  628. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-indirect-outside.osw +0 -337
  629. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-indirect-standbyloss.osw +0 -337
  630. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-indirect-with-solar-fraction.osw +0 -337
  631. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-indirect.osw +0 -337
  632. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-jacket-electric.osw +0 -337
  633. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-jacket-gas.osw +0 -337
  634. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-jacket-hpwh.osw +0 -337
  635. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-jacket-indirect.osw +0 -337
  636. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-low-flow-fixtures.osw +0 -337
  637. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-none.osw +0 -337
  638. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-recirc-demand.osw +0 -337
  639. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-recirc-manual.osw +0 -337
  640. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-recirc-nocontrol.osw +0 -337
  641. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-recirc-temperature.osw +0 -337
  642. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-recirc-timer.osw +0 -337
  643. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-solar-direct-evacuated-tube.osw +0 -337
  644. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-solar-direct-flat-plate.osw +0 -337
  645. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-solar-direct-ics.osw +0 -337
  646. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-solar-fraction.osw +0 -337
  647. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-solar-indirect-flat-plate.osw +0 -337
  648. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-solar-thermosyphon-flat-plate.osw +0 -337
  649. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tank-coal.osw +0 -337
  650. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tank-elec-uef.osw +0 -338
  651. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tank-gas-outside.osw +0 -337
  652. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tank-gas-uef.osw +0 -338
  653. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tank-gas.osw +0 -337
  654. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tank-heat-pump-outside.osw +0 -337
  655. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tank-heat-pump-uef.osw +0 -338
  656. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tank-heat-pump-with-solar-fraction.osw +0 -337
  657. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tank-heat-pump-with-solar.osw +0 -337
  658. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tank-heat-pump.osw +0 -337
  659. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tank-oil.osw +0 -337
  660. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tank-wood.osw +0 -337
  661. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tankless-electric-outside.osw +0 -337
  662. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tankless-electric-uef.osw +0 -337
  663. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tankless-electric.osw +0 -337
  664. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tankless-gas-uef.osw +0 -337
  665. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tankless-gas-with-solar-fraction.osw +0 -337
  666. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tankless-gas-with-solar.osw +0 -337
  667. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tankless-gas.osw +0 -337
  668. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-dhw-tankless-propane.osw +0 -337
  669. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-enclosure-2stories-garage.osw +0 -337
  670. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-enclosure-2stories.osw +0 -337
  671. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-enclosure-beds-1.osw +0 -337
  672. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-enclosure-beds-2.osw +0 -337
  673. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-enclosure-beds-4.osw +0 -337
  674. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-enclosure-beds-5.osw +0 -337
  675. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-enclosure-garage.osw +0 -337
  676. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-enclosure-infil-ach-house-pressure.osw +0 -337
  677. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-enclosure-infil-cfm-house-pressure.osw +0 -337
  678. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-enclosure-infil-cfm50.osw +0 -337
  679. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-enclosure-infil-flue.osw +0 -337
  680. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-enclosure-infil-natural-ach.osw +0 -337
  681. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-enclosure-overhangs.osw +0 -337
  682. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-enclosure-windows-none.osw +0 -337
  683. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-foundation-ambient.osw +0 -337
  684. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-foundation-conditioned-basement-slab-insulation.osw +0 -337
  685. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-foundation-slab.osw +0 -337
  686. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-foundation-unconditioned-basement-assembly-r.osw +0 -338
  687. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-foundation-unconditioned-basement-wall-insulation.osw +0 -337
  688. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-foundation-unconditioned-basement.osw +0 -337
  689. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-foundation-unvented-crawlspace.osw +0 -337
  690. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-foundation-vented-crawlspace.osw +0 -337
  691. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-air-to-air-heat-pump-1-speed-cooling-only.osw +0 -337
  692. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-air-to-air-heat-pump-1-speed-heating-only.osw +0 -337
  693. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-air-to-air-heat-pump-1-speed.osw +0 -337
  694. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-air-to-air-heat-pump-2-speed.osw +0 -337
  695. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-air-to-air-heat-pump-var-speed.osw +0 -337
  696. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-boiler-coal-only.osw +0 -337
  697. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-boiler-elec-only.osw +0 -337
  698. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-boiler-gas-central-ac-1-speed.osw +0 -337
  699. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-boiler-gas-only.osw +0 -337
  700. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-boiler-oil-only.osw +0 -337
  701. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-boiler-propane-only.osw +0 -337
  702. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-boiler-wood-only.osw +0 -337
  703. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-central-ac-only-1-speed.osw +0 -337
  704. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-central-ac-only-2-speed.osw +0 -337
  705. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-central-ac-only-var-speed.osw +0 -337
  706. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-central-ac-plus-air-to-air-heat-pump-heating.osw +0 -337
  707. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-dual-fuel-air-to-air-heat-pump-1-speed-electric.osw +0 -338
  708. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-dual-fuel-air-to-air-heat-pump-1-speed.osw +0 -338
  709. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-dual-fuel-air-to-air-heat-pump-2-speed.osw +0 -338
  710. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-dual-fuel-air-to-air-heat-pump-var-speed.osw +0 -338
  711. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-dual-fuel-mini-split-heat-pump-ducted.osw +0 -338
  712. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-ducts-leakage-percent.osw +0 -337
  713. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-elec-resistance-only.osw +0 -337
  714. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-evap-cooler-furnace-gas.osw +0 -335
  715. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-evap-cooler-only-ducted.osw +0 -335
  716. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-evap-cooler-only.osw +0 -335
  717. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-fireplace-wood-only.osw +0 -337
  718. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-fixed-heater-gas-only.osw +0 -337
  719. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-floor-furnace-propane-only.osw +0 -337
  720. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-furnace-coal-only.osw +0 -337
  721. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-furnace-elec-central-ac-1-speed.osw +0 -337
  722. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-furnace-elec-only.osw +0 -337
  723. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-furnace-gas-central-ac-2-speed.osw +0 -337
  724. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-furnace-gas-central-ac-var-speed.osw +0 -337
  725. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-furnace-gas-only.osw +0 -337
  726. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-furnace-gas-room-ac.osw +0 -336
  727. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-furnace-oil-only.osw +0 -337
  728. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-furnace-propane-only.osw +0 -337
  729. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-furnace-wood-only.osw +0 -337
  730. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-ground-to-air-heat-pump-cooling-only.osw +0 -336
  731. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-ground-to-air-heat-pump-heating-only.osw +0 -336
  732. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-ground-to-air-heat-pump.osw +0 -336
  733. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-install-quality-airflow-defect-furnace-gas-central-ac-1-speed.osw +0 -339
  734. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-install-quality-all-air-to-air-heat-pump-1-speed.osw +0 -339
  735. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-install-quality-all-air-to-air-heat-pump-2-speed.osw +0 -339
  736. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-install-quality-all-air-to-air-heat-pump-var-speed.osw +0 -339
  737. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-install-quality-all-furnace-gas-central-ac-1-speed.osw +0 -340
  738. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-install-quality-all-furnace-gas-central-ac-2-speed.osw +0 -340
  739. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-install-quality-all-furnace-gas-central-ac-var-speed.osw +0 -340
  740. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-install-quality-all-furnace-gas-only.osw +0 -338
  741. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-install-quality-all-ground-to-air-heat-pump.osw +0 -338
  742. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-install-quality-all-mini-split-air-conditioner-only-ducted.osw +0 -338
  743. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-install-quality-all-mini-split-heat-pump-ducted.osw +0 -339
  744. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-install-quality-charge-defect-furnace-gas-central-ac-1-speed.osw +0 -338
  745. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-install-quality-none-furnace-gas-central-ac-1-speed.osw +0 -340
  746. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-mini-split-air-conditioner-only-ducted.osw +0 -336
  747. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-mini-split-air-conditioner-only-ductless.osw +0 -336
  748. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-mini-split-heat-pump-ducted-cooling-only.osw +0 -337
  749. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-mini-split-heat-pump-ducted-heating-only.osw +0 -337
  750. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-mini-split-heat-pump-ducted.osw +0 -337
  751. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-mini-split-heat-pump-ductless.osw +0 -337
  752. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-none.osw +0 -337
  753. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-portable-heater-gas-only.osw +0 -337
  754. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-programmable-thermostat-detailed.osw +0 -337
  755. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-room-ac-only-33percent.osw +0 -336
  756. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-room-ac-only.osw +0 -336
  757. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-setpoints.osw +0 -337
  758. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-stove-oil-only.osw +0 -337
  759. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-stove-wood-pellets-only.osw +0 -337
  760. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-undersized.osw +0 -337
  761. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-hvac-wall-furnace-elec-only.osw +0 -337
  762. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-lighting-ceiling-fans.osw +0 -337
  763. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-lighting-detailed.osw +0 -337
  764. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-location-AMY-2012.osw +0 -337
  765. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-location-baltimore-md.osw +0 -337
  766. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-location-dallas-tx.osw +0 -337
  767. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-location-duluth-mn.osw +0 -337
  768. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-location-helena-mt.osw +0 -337
  769. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-location-honolulu-hi.osw +0 -337
  770. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-location-miami-fl.osw +0 -337
  771. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-location-phoenix-az.osw +0 -337
  772. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-location-portland-or.osw +0 -337
  773. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-mechvent-balanced.osw +0 -337
  774. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-mechvent-bath-kitchen-fans.osw +0 -345
  775. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-mechvent-cfis-evap-cooler-only-ducted.osw +0 -335
  776. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-mechvent-cfis.osw +0 -337
  777. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-mechvent-erv-atre-asre.osw +0 -337
  778. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-mechvent-erv.osw +0 -337
  779. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-mechvent-exhaust-rated-flow-rate.osw +0 -337
  780. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-mechvent-exhaust.osw +0 -337
  781. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-mechvent-hrv-asre.osw +0 -337
  782. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-mechvent-hrv.osw +0 -337
  783. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-mechvent-supply.osw +0 -337
  784. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-mechvent-whole-house-fan.osw +0 -337
  785. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-misc-defaults.osw +0 -324
  786. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-misc-loads-large-uncommon.osw +0 -337
  787. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-misc-loads-large-uncommon2.osw +0 -337
  788. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-misc-neighbor-shading.osw +0 -337
  789. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-misc-shielding-of-home.osw +0 -337
  790. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-misc-usage-multiplier.osw +0 -337
  791. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-pv.osw +0 -337
  792. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-schedules-stochastic-vacant.osw +0 -341
  793. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-schedules-stochastic.osw +0 -337
  794. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-schedules-user-specified.osw +0 -338
  795. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-simcontrol-calendar-year-custom.osw +0 -338
  796. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-simcontrol-daylight-saving-custom.osw +0 -342
  797. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-simcontrol-daylight-saving-disabled.osw +0 -338
  798. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-simcontrol-runperiod-1-month.osw +0 -341
  799. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base-simcontrol-timestep-10-mins.osw +0 -337
  800. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/base.osw +0 -337
  801. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-auto.osw +0 -337
  802. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-double-exterior.osw +0 -341
  803. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-double-loaded-interior.osw +0 -341
  804. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-eaves.osw +0 -341
  805. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-single-exterior-front.osw +0 -341
  806. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-double-loaded-interior.osw +0 -341
  807. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-left-bottom-double-loaded-interior.osw +0 -341
  808. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-left-bottom.osw +0 -341
  809. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-left-middle-double-loaded-interior.osw +0 -341
  810. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-left-middle.osw +0 -341
  811. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-left-top-double-loaded-interior.osw +0 -341
  812. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-left-top.osw +0 -341
  813. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-middle-bottom-double-loaded-interior.osw +0 -341
  814. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-middle-bottom.osw +0 -341
  815. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-middle-middle-double-loaded-interior.osw +0 -341
  816. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-middle-middle.osw +0 -341
  817. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-middle-top-double-loaded-interior.osw +0 -341
  818. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-middle-top.osw +0 -341
  819. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-right-bottom-double-loaded-interior.osw +0 -341
  820. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-right-bottom.osw +0 -341
  821. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-right-middle-double-loaded-interior.osw +0 -341
  822. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-right-middle.osw +0 -341
  823. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-right-top-double-loaded-interior.osw +0 -341
  824. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab-right-top.osw +0 -341
  825. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-slab.osw +0 -341
  826. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-double-loaded-interior.osw +0 -341
  827. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-left-bottom-double-loaded-interior.osw +0 -341
  828. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-left-bottom.osw +0 -341
  829. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-left-middle-double-loaded-interior.osw +0 -341
  830. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-left-middle.osw +0 -341
  831. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-left-top-double-loaded-interior.osw +0 -341
  832. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-left-top.osw +0 -341
  833. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-middle-bottom-double-loaded-interior.osw +0 -341
  834. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-middle-bottom.osw +0 -341
  835. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-middle-middle-double-loaded-interior.osw +0 -341
  836. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-middle-middle.osw +0 -341
  837. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-middle-top-double-loaded-interior.osw +0 -341
  838. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-middle-top.osw +0 -341
  839. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-right-bottom-double-loaded-interior.osw +0 -341
  840. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-right-bottom.osw +0 -341
  841. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-right-middle-double-loaded-interior.osw +0 -341
  842. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-right-middle.osw +0 -341
  843. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-right-top-double-loaded-interior.osw +0 -341
  844. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace-right-top.osw +0 -341
  845. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-unvented-crawlspace.osw +0 -341
  846. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-double-loaded-interior.osw +0 -341
  847. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-left-bottom-double-loaded-interior.osw +0 -341
  848. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-left-bottom.osw +0 -341
  849. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-left-middle-double-loaded-interior.osw +0 -341
  850. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-left-middle.osw +0 -341
  851. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-left-top-double-loaded-interior.osw +0 -341
  852. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-left-top.osw +0 -341
  853. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-middle-bottom-double-loaded-interior.osw +0 -341
  854. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-middle-bottom.osw +0 -341
  855. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-middle-middle-double-loaded-interior.osw +0 -341
  856. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-middle-middle.osw +0 -341
  857. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-middle-top-double-loaded-interior.osw +0 -341
  858. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-middle-top.osw +0 -341
  859. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-right-bottom-double-loaded-interior.osw +0 -341
  860. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-right-bottom.osw +0 -341
  861. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-right-middle-double-loaded-interior.osw +0 -341
  862. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-right-middle.osw +0 -341
  863. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-right-top-double-loaded-interior.osw +0 -341
  864. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace-right-top.osw +0 -341
  865. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-multifamily-vented-crawlspace.osw +0 -341
  866. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-atticroof-conditioned-eaves-gable.osw +0 -339
  867. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-atticroof-conditioned-eaves-hip.osw +0 -339
  868. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-atticroof-flat.osw +0 -339
  869. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-double-exterior.osw +0 -339
  870. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-double-loaded-interior.osw +0 -339
  871. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-single-exterior-front.osw +0 -339
  872. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-slab-middle.osw +0 -339
  873. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-slab-right.osw +0 -339
  874. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-slab.osw +0 -339
  875. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-unconditioned-basement-middle.osw +0 -339
  876. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-unconditioned-basement-right.osw +0 -339
  877. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-unconditioned-basement.osw +0 -339
  878. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-unvented-crawlspace-middle.osw +0 -339
  879. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-unvented-crawlspace-right.osw +0 -339
  880. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-unvented-crawlspace.osw +0 -339
  881. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-vented-crawlspace-middle.osw +0 -339
  882. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-vented-crawlspace-right.osw +0 -339
  883. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-bldgtype-single-family-attached-vented-crawlspace.osw +0 -339
  884. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-dhw-solar-latitude.osw +0 -337
  885. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-enclosure-atticroof-conditioned-eaves-gable.osw +0 -337
  886. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-enclosure-atticroof-conditioned-eaves-hip.osw +0 -337
  887. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-enclosure-garage-atticroof-conditioned.osw +0 -337
  888. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-enclosure-garage-partially-protruded.osw +0 -337
  889. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-enclosure-windows-shading.osw +0 -339
  890. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-gas-hot-tub-heater-with-zero-kwh.osw +0 -337
  891. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-gas-pool-heater-with-zero-kwh.osw +0 -337
  892. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-pv-roofpitch.osw +0 -337
  893. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-schedules-random-seed.osw +0 -338
  894. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-second-heating-system-boiler-to-heat-pump.osw +0 -336
  895. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-second-heating-system-boiler-to-heating-system.osw +0 -337
  896. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-second-heating-system-fireplace-to-heat-pump.osw +0 -337
  897. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-second-heating-system-fireplace-to-heating-system.osw +0 -337
  898. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-second-heating-system-portable-heater-to-heat-pump.osw +0 -337
  899. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-second-heating-system-portable-heater-to-heating-system.osw +0 -337
  900. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-second-refrigerator.osw +0 -337
  901. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-zero-clothes-washer-kwh.osw +0 -337
  902. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-zero-dishwasher-kwh.osw +0 -337
  903. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-zero-extra-refrigerator-kwh.osw +0 -337
  904. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-zero-freezer-kwh.osw +0 -337
  905. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/extra-zero-refrigerator-kwh.osw +0 -337
  906. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/conditioned-attic-with-floor-insulation.osw +0 -337
  907. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/conditioned-attic-with-one-floor-above-grade.osw +0 -337
  908. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/conditioned-basement-with-ceiling-insulation.osw +0 -337
  909. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/cooling-system-and-heat-pump.osw +0 -337
  910. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/dhw-indirect-without-boiler.osw +0 -337
  911. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/ducts-location-and-areas-not-same-type.osw +0 -337
  912. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/foundation-wall-insulation-greater-than-height.osw +0 -337
  913. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/heating-system-and-heat-pump.osw +0 -337
  914. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/multifamily-bottom-crawlspace-zero-foundation-height.osw +0 -341
  915. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/multifamily-bottom-slab-non-zero-foundation-height.osw +0 -341
  916. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/multifamily-no-building-orientation.osw +0 -338
  917. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/multipliers-without-fuel-loads.osw +0 -337
  918. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/multipliers-without-other-plug-loads.osw +0 -337
  919. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/multipliers-without-tv-plug-loads.osw +0 -337
  920. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/multipliers-without-vehicle-plug-loads.osw +0 -337
  921. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/multipliers-without-well-pump-plug-loads.osw +0 -337
  922. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/non-electric-heat-pump-water-heater.osw +0 -337
  923. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/non-integer-ceiling-fan-quantity.osw +0 -337
  924. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/non-integer-geometry-num-bathrooms.osw +0 -337
  925. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/second-heating-system-but-no-primary-heating.osw +0 -337
  926. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/second-heating-system-serves-majority-heat.osw +0 -337
  927. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/second-heating-system-serves-total-heat-load.osw +0 -337
  928. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/single-family-attached-ambient.osw +0 -339
  929. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/single-family-attached-no-building-orientation.osw +0 -337
  930. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/single-family-detached-finished-basement-zero-foundation-height.osw +0 -337
  931. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/single-family-detached-slab-non-zero-foundation-height.osw +0 -337
  932. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/single-family-detached-with-shared-system.osw +0 -337
  933. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/slab-non-zero-foundation-height-above-grade.osw +0 -337
  934. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/unconditioned-basement-with-wall-and-ceiling-insulation.osw +0 -337
  935. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/unvented-attic-with-floor-and-roof-insulation.osw +0 -337
  936. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/unvented-crawlspace-with-wall-and-ceiling-insulation.osw +0 -337
  937. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/vented-attic-with-floor-and-roof-insulation.osw +0 -337
  938. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/vented-crawlspace-with-wall-and-ceiling-insulation.osw +0 -337
  939. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/invalid_files/zero-number-of-bedrooms.osw +0 -337
  940. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/schedules/stochastic.csv +0 -8761
  941. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/schedules/user-specified.csv +0 -8761
  942. data/example_files/resources/hpxml-measures/BuildResidentialHPXML/tests/schedules/vacant.csv +0 -8761
  943. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_bath_schedule_1bed.csv +0 -369
  944. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_bath_schedule_2bed.csv +0 -465
  945. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_bath_schedule_3bed.csv +0 -611
  946. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_bath_schedule_4bed.csv +0 -685
  947. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_bath_schedule_5bed.csv +0 -767
  948. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_clotheswasher_schedule_1bed.csv +0 -637
  949. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_clotheswasher_schedule_2bed.csv +0 -744
  950. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_clotheswasher_schedule_3bed.csv +0 -929
  951. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_clotheswasher_schedule_4bed.csv +0 -1044
  952. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_clotheswasher_schedule_5bed.csv +0 -1250
  953. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_dishwasher_schedule_1bed.csv +0 -754
  954. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_dishwasher_schedule_2bed.csv +0 -961
  955. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_dishwasher_schedule_3bed.csv +0 -1102
  956. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_dishwasher_schedule_4bed.csv +0 -1293
  957. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_dishwasher_schedule_5bed.csv +0 -1508
  958. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_fixtures_schedule_1bed.csv +0 -13097
  959. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_fixtures_schedule_2bed.csv +0 -15977
  960. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_fixtures_schedule_3bed.csv +0 -18624
  961. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_fixtures_schedule_4bed.csv +0 -22075
  962. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_fixtures_schedule_5bed.csv +0 -25005
  963. data/example_files/resources/hpxml-measures/HPXMLtoOpenStudio/resources/data_hot_water_max_flows.csv +0 -6
  964. data/example_files/resources/hpxml-measures/SimulationOutputReport/measure.rb +0 -2444
  965. data/example_files/resources/hpxml-measures/docs/source/build_residential_hpxml.rst +0 -110
  966. data/example_files/resources/hpxml-measures/docs/source/getting_started.rst +0 -57
  967. data/example_files/resources/hpxml-measures/workflow/sample_files/base-schedules-stochastic-vacant.xml +0 -564
  968. data/example_files/resources/hpxml-measures/workflow/sample_files/base-schedules-stochastic.xml +0 -564
  969. data/example_files/resources/hpxml-measures/workflow/sample_files/base-schedules-user-specified.xml +0 -564
  970. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/clothes-dryer-location.xml +0 -563
  971. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/clothes-washer-location.xml +0 -563
  972. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/cooking-range-location.xml +0 -563
  973. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/dehumidifier-fraction-served.xml +0 -535
  974. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/dehumidifier-setpoints.xml +0 -535
  975. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/dhw-frac-load-served.xml +0 -576
  976. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/dhw-invalid-ef-tank.xml +0 -563
  977. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/dhw-invalid-uef-tank-heat-pump.xml +0 -564
  978. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/dishwasher-location.xml +0 -563
  979. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/duct-leakage-cfm25.xml +0 -563
  980. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/duct-leakage-percent.xml +0 -563
  981. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/duct-location-unconditioned-space.xml +0 -563
  982. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/duct-location.xml +0 -563
  983. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/duplicate-id.xml +0 -563
  984. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/enclosure-attic-missing-roof.xml +0 -547
  985. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/enclosure-basement-missing-exterior-foundation-wall.xml +0 -544
  986. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/enclosure-basement-missing-slab.xml +0 -547
  987. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/enclosure-floor-area-exceeds-cfa.xml +0 -563
  988. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/enclosure-floor-area-exceeds-cfa2.xml +0 -448
  989. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/enclosure-garage-missing-exterior-wall.xml +0 -614
  990. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/enclosure-garage-missing-slab.xml +0 -611
  991. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/enclosure-living-missing-ceiling-roof.xml +0 -551
  992. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/enclosure-living-missing-exterior-wall.xml +0 -473
  993. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/enclosure-living-missing-floor-slab.xml +0 -489
  994. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/frac-sensible-fuel-load.xml +0 -760
  995. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/frac-sensible-plug-load.xml +0 -759
  996. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/frac-total-fuel-load.xml +0 -761
  997. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/frac-total-plug-load.xml +0 -759
  998. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/furnace-invalid-afue.xml +0 -563
  999. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/generator-number-of-bedrooms-served.xml +0 -460
  1000. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/heat-pump-mixed-fixed-and-autosize-capacities.xml +0 -560
  1001. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/hvac-distribution-multiple-attached-cooling.xml +0 -921
  1002. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/hvac-distribution-multiple-attached-heating.xml +0 -921
  1003. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/hvac-dse-multiple-attached-cooling.xml +0 -547
  1004. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/hvac-dse-multiple-attached-heating.xml +0 -547
  1005. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/hvac-frac-load-served.xml +0 -921
  1006. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/hvac-inconsistent-fan-powers.xml +0 -569
  1007. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/hvac-shared-negative-seer-eq.xml +0 -407
  1008. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-assembly-effective-rvalue.xml +0 -563
  1009. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-datatype-boolean.xml +0 -563
  1010. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-datatype-float.xml +0 -563
  1011. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-datatype-integer.xml +0 -563
  1012. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-daylight-saving.xml +0 -570
  1013. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-distribution-cfa-served.xml +0 -563
  1014. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-epw-filepath.xml +0 -563
  1015. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-facility-type-equipment.xml +0 -466
  1016. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-id2.xml +0 -591
  1017. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-infiltration-volume.xml +0 -563
  1018. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-input-parameters.xml +0 -565
  1019. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-neighbor-shading-azimuth.xml +0 -576
  1020. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-number-of-bedrooms-served.xml +0 -465
  1021. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-number-of-conditioned-floors.xml +0 -563
  1022. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-number-of-units-served.xml +0 -451
  1023. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-relatedhvac-desuperheater.xml +0 -551
  1024. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-runperiod.xml +0 -565
  1025. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-schema-version.xml +0 -563
  1026. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-shared-vent-in-unit-flowrate.xml +0 -473
  1027. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-timestep.xml +0 -563
  1028. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/invalid-window-height.xml +0 -583
  1029. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/lighting-fractions.xml +0 -563
  1030. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/missing-duct-location.xml +0 -917
  1031. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/missing-elements.xml +0 -561
  1032. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/multifamily-reference-appliance.xml +0 -563
  1033. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/multifamily-reference-duct.xml +0 -563
  1034. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/multifamily-reference-water-heater.xml +0 -563
  1035. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/multiple-buildings-without-building-id.xml +0 -1657
  1036. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/multiple-buildings-wrong-building-id.xml +0 -1657
  1037. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/multiple-shared-cooling-systems.xml +0 -432
  1038. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/multiple-shared-heating-systems.xml +0 -434
  1039. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/net-area-negative-roof.xml +0 -591
  1040. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/net-area-negative-wall.xml +0 -563
  1041. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/num-bedrooms-exceeds-limit.xml +0 -563
  1042. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/orphaned-hvac-distribution.xml +0 -547
  1043. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/refrigerator-location.xml +0 -563
  1044. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/refrigerators-multiple-primary.xml +0 -569
  1045. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/refrigerators-no-primary.xml +0 -569
  1046. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/repeated-relatedhvac-desuperheater.xml +0 -564
  1047. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/repeated-relatedhvac-dhw-indirect.xml +0 -527
  1048. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/solar-fraction-one.xml +0 -571
  1049. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/solar-thermal-system-with-combi-tankless.xml +0 -532
  1050. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/solar-thermal-system-with-desuperheater.xml +0 -566
  1051. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/solar-thermal-system-with-dhw-indirect.xml +0 -532
  1052. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/unattached-cfis.xml +0 -576
  1053. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/unattached-door.xml +0 -563
  1054. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/unattached-hvac-distribution.xml +0 -563
  1055. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/unattached-shared-clothes-washer-water-heater.xml +0 -466
  1056. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/unattached-shared-dishwasher-water-heater.xml +0 -466
  1057. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/unattached-skylight.xml +0 -591
  1058. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/unattached-window.xml +0 -563
  1059. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/water-heater-location-other.xml +0 -563
  1060. data/example_files/resources/hpxml-measures/workflow/sample_files/invalid_files/water-heater-location.xml +0 -563
  1061. data/example_files/resources/hpxml-measures/workflow/tests/compare.rb +0 -130
@@ -46,45 +46,40 @@ Input Defaults
46
46
  A large number of elements in the HPXML file are optional and can be defaulted.
47
47
  Default values, equations, and logic are described throughout this documentation.
48
48
 
49
- Defaults can also be seen in the ``in.xml`` file generated in the run directory, where additional fields are populated for inspection.
50
-
51
- For example, suppose a HPXML file has a window defined as follows:
49
+ For example, suppose a HPXML file has a refrigerator defined as follows:
52
50
 
53
51
  .. code-block:: XML
54
52
 
55
- <Window>
56
- <SystemIdentifier id='Window'/>
57
- <Area>108.0</Area>
58
- <Azimuth>0</Azimuth>
59
- <UFactor>0.33</UFactor>
60
- <SHGC>0.45</SHGC>
61
- <AttachedToWall idref='Wall'/>
62
- </Window>
53
+ <Refrigerator>
54
+ <SystemIdentifier id='Refrigerator1'/>
55
+ </Refrigerator>
63
56
 
64
- In the ``in.xml`` file, the window would have additional elements like so:
57
+ Default values would be used for the refrigerator energy use, location, and schedule:
65
58
 
66
59
  .. code-block:: XML
67
60
 
68
- <Window>
69
- <SystemIdentifier id='Window'/>
70
- <Area>108.0</Area>
71
- <Azimuth>0</Azimuth>
72
- <UFactor>0.33</UFactor>
73
- <SHGC>0.45</SHGC>
74
- <InteriorShading>
75
- <SystemIdentifier id='WindowInteriorShading'/>
76
- <SummerShadingCoefficient dataSource='software'>0.7</SummerShadingCoefficient>
77
- <WinterShadingCoefficient dataSource='software'>0.85</WinterShadingCoefficient>
78
- </InteriorShading>
79
- <FractionOperable dataSource='software'>0.67</FractionOperable>
80
- <AttachedToWall idref='Wall'/>
81
- </Window>
61
+ <Refrigerator>
62
+ <SystemIdentifier id='Refrigerator1'/>
63
+ <Location dataSource='software'>living space</Location>
64
+ <RatedAnnualkWh dataSource='software'>691.0</RatedAnnualkWh>
65
+ <PrimaryIndicator dataSource='software'>true</PrimaryIndicator>
66
+ <extension>
67
+ <UsageMultiplier dataSource='software'>1.0</UsageMultiplier>
68
+ <WeekdayScheduleFractions dataSource='software'>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</WeekdayScheduleFractions>
69
+ <WeekendScheduleFractions dataSource='software'>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</WeekendScheduleFractions>
70
+ <MonthlyScheduleMultipliers dataSource='software'>0.837, 0.835, 1.084, 1.084, 1.084, 1.096, 1.096, 1.096, 1.096, 0.931, 0.925, 0.837</MonthlyScheduleMultipliers>
71
+ </extension>
72
+ </Refrigerator>
82
73
 
83
- .. note::
74
+ These defaults will be reflected in the EnergyPlus simulation results.
75
+
76
+ .. note::
84
77
 
85
- The OpenStudio-HPXML workflow generally treats missing elements differently than missing values.
86
- For example, if there is a ``Window`` with no ``Overhangs`` element defined, the window will be interpreted as having no overhangs and modeled this way.
87
- On the other hand, if there is a ``Window`` with no ``FractionOperable`` value defined, it is assumed that the operable property of the window is unknown and will be defaulted in the model according to :ref:`windowinputs`.
78
+ The OpenStudio-HPXML workflow generally treats missing *elements* differently than missing *values*.
79
+ For example, if there is no ``Refrigerator`` element defined, the model will proceed without refrigerator energy use.
80
+ On the other hand, if there is a ``Refrigerator`` element but with no values defined (i.e., no ``Location`` or ``RatedAnnualkWh``), it is assumed that a refrigerator exists but its properties are unknown, so they will be defaulted in the model.
81
+
82
+ See :ref:`hpxml_defaults` for information on how default values can be inspected.
88
83
 
89
84
  HPXML Software Info
90
85
  -------------------
@@ -137,6 +132,74 @@ HVAC equipment sizing controls are entered in ``/HPXML/SoftwareInfo/extension/HV
137
132
  .. [#] 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.
138
133
  .. [#] If UseMaxLoadForHeatPumps is true, autosized heat pumps are sized based on the maximum of heating/cooling design loads; otherwise sized per ACCA Manual J/S based on cooling design loads with some oversizing allowances for heating design loads.
139
134
 
135
+ HPXML Schedules
136
+ ***************
137
+
138
+ Schedules for a variety of building features can be 1) specified via simple inputs, 2) specified via detailed inputs, or 3) defaulted.
139
+
140
+ Simple Schedule Inputs
141
+ ~~~~~~~~~~~~~~~~~~~~~~
142
+
143
+ Simple schedule inputs are available as weekday/weekend fractions and monthly multipliers.
144
+ For example, see the ``WeekdayScheduleFractions``, ``WeekendScheduleFractions``, and ``MonthlyScheduleMultipliers`` inputs for :ref:`buildingoccupancy`.
145
+
146
+ .. _detailedschedules:
147
+
148
+ Detailed Schedule Inputs
149
+ ~~~~~~~~~~~~~~~~~~~~~~~~
150
+
151
+ Detailed schedule inputs allow schedule values for every hour or timestep of the simulation.
152
+ They can be smooth schedules, or they can reflect real-world or stochastic occupancy.
153
+ Note that if detailed schedule inputs are used, they must be used for *all* building features; you cannot use detailed schedules for some features and simple/default schedules for other features.
154
+
155
+ Detailed schedule inputs are provided via a CSV file that should be referenced in the HPXML file at ``/HPXML/SoftwareInfo/extension/SchedulesFilePath``.
156
+ Each column must be normalized to MAX=1; that is, the schedules only define *when* energy is used, not *how much* energy is used.
157
+ The columns in the schedule CSV are:
158
+
159
+ ============================= ======== ======================================================== ===================
160
+ Column Name Required Description Affected by Vacancy
161
+ ============================= ======== ======================================================== ===================
162
+ ``occupants`` Yes Occupant heat gain schedule. Yes
163
+ ``lighting_interior`` Yes Interior lighting energy use schedule. Yes
164
+ ``lighting_exterior`` Yes Exterior lighting energy use schedule. Yes
165
+ ``lighting_garage`` Yes Garage lighting energy use schedule. Yes
166
+ ``lighting_exterior_holiday`` Yes Exterior holiday lighting energy use schedule. Yes
167
+ ``cooking_range`` Yes Cooking range & oven energy use schedule. Yes
168
+ ``refrigerator`` Yes Primary refrigerator energy use schedule. No
169
+ ``extra_refrigerator`` Yes Non-primary refrigerator energy use schedule. No
170
+ ``freezer`` Yes Freezer energy use schedule. No
171
+ ``dishwasher`` Yes Dishwasher energy use schedule. Yes
172
+ ``clothes_washer`` Yes Clothes washer energy use schedule. Yes
173
+ ``clothes_dryer`` Yes Clothes dryer energy use schedule. Yes
174
+ ``ceiling_fan`` Yes Ceiling fan energy use schedule. Yes
175
+ ``plug_loads_other`` Yes Other plug load energy use schedule. Yes
176
+ ``plug_loads_tv`` Yes Television plug load energy use schedule. Yes
177
+ ``plug_loads_vehicle`` Yes Electric vehicle plug load energy use schedule. Yes
178
+ ``plug_loads_well_pump`` Yes Well pump plug load energy use schedule. Yes
179
+ ``fuel_loads_grill`` Yes Grill fuel load energy use schedule. Yes
180
+ ``fuel_loads_lighting`` Yes Lighting fuel load energy use schedule. Yes
181
+ ``fuel_loads_fireplace`` Yes Fireplace fuel load energy use schedule. Yes
182
+ ``pool_pump`` Yes Pool pump energy use schedule. No
183
+ ``pool_heater`` Yes Pool heater energy use schedule. No
184
+ ``hot_tub_pump`` Yes Hot tub pump energy use schedule. No
185
+ ``hot_tub_heater`` Yes Hot tub heater energy use schedule. No
186
+ ``hot_water_dishwasher`` Yes Dishwasher hot water use schedule. Yes
187
+ ``hot_water_clothes_washer`` Yes Clothes washer hot water use schedule. Yes
188
+ ``hot_water_fixtures`` Yes Fixtures (sinks, showers, baths) hot water use schedule. Yes
189
+ ``vacancy`` No 1=Home is vacant. Automatically overrides other columns. N/A
190
+ ============================= ======== ======================================================== ===================
191
+
192
+ A couple schedule CSV file examples are provided in the ``HPXMLtoOpenStudio/resources/schedule_files`` directory.
193
+
194
+ A detailed stochastic or smooth schedule CSV file can also be automatically generated for you; see the :ref:`usage_instructions` for the commands.
195
+
196
+ Default Schedules
197
+ ~~~~~~~~~~~~~~~~~
198
+
199
+ If neither simple nor detailed inputs are provided, then schedules are defaulted.
200
+ Default schedules are typically smooth, averaged schedules.
201
+ These default schedules are described elsewhere in the documentation (e.g., see :ref:`buildingoccupancy`).
202
+
140
203
  HPXML Building Summary
141
204
  ----------------------
142
205
 
@@ -160,29 +223,40 @@ Building site information is entered in ``/HPXML/Building/BuildingDetails/Buildi
160
223
 
161
224
  For each neighboring building defined, additional information is entered in a ``extension/Neighbors/NeighborBuilding``.
162
225
 
163
- ============ ======== ======= =========== ======== ======== =============================================
164
- Element Type Units Constraints Required Default Notes
165
- ============ ======== ======= =========== ======== ======== =============================================
166
- ``Azimuth`` integer deg 0 - 359 Yes Direction of neighbors (clockwise from North)
167
- ``Distance`` double ft > 0 Yes Distance of neighbor from the dwelling unit
168
- ``Height`` double ft > 0 No See [#]_ Height of neighbor
169
- ============ ======== ======= =========== ======== ======== =============================================
226
+ ============================== ================= ================ =================== ======== ======== =============================================
227
+ Element Type Units Constraints Required Default Notes
228
+ ============================== ================= ================ =================== ======== ======== =============================================
229
+ ``Azimuth`` or ``Orientation`` integer or string deg or direction 0 - 359 or See [#]_ Yes Direction of neighbors (clockwise from North)
230
+ ``Distance`` double ft > 0 Yes Distance of neighbor from the dwelling unit
231
+ ``Height`` double ft > 0 No See [#]_ Height of neighbor
232
+ ============================== ================= ================ =================== ======== ======== =============================================
170
233
 
234
+ .. [#] Orientation choices are "northeast", "east", "southeast", "south", "southwest", "west", "northwest", or "north"
171
235
  .. [#] If Height not provided, assumed to be same height as the dwelling unit.
172
236
 
237
+ .. _buildingoccupancy:
238
+
173
239
  HPXML Building Occupancy
174
240
  ************************
175
241
 
176
242
  Building occupancy is entered in ``/HPXML/Building/BuildingDetails/BuildingSummary/BuildingOccupancy``.
177
243
 
178
- ===================== ======== ===== =========== ======== ==================== ========================
179
- Element Type Units Constraints Required Default Notes
180
- ===================== ======== ===== =========== ======== ==================== ========================
181
- ``NumberofResidents`` integer >= 0 No <number of bedrooms> Number of occupants [#]_
182
- ===================== ======== ===== =========== ======== ==================== ========================
244
+ ======================================== ======== ===== =========== ======== ==================== ========================
245
+ Element Type Units Constraints Required Default Notes
246
+ ======================================== ======== ===== =========== ======== ==================== ========================
247
+ ``NumberofResidents`` integer >= 0 No <number of bedrooms> Number of occupants
248
+ ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
249
+ ``extension/WeekendScheduleFractions`` array No 24 comma-separated weekend fractions
250
+ ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
251
+ ======================================== ======== ===== =========== ======== ==================== ========================
252
+
253
+ .. [#] 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".
254
+ .. [#] 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".
255
+
256
+ .. note::
183
257
 
184
- .. [#] NumberofResidents is only used for occupant heat gain.
185
- Most occupancy assumptions (e.g., usage of plug loads, appliances, hot water, etc.) are driven by the number of bedrooms, not number of occupants.
258
+ The above inputs are only used to define heat gain from occupants.
259
+ Usages of plug loads, appliances, hot water, etc. are driven by number of bedrooms, not number of occupants.
186
260
 
187
261
  HPXML Building Construction
188
262
  ***************************
@@ -193,21 +267,19 @@ Building construction is entered in ``/HPXML/Building/BuildingDetails/BuildingSu
193
267
  Element Type Units Constraints Required Default Notes
194
268
  ========================================================= ======== ========= ================================= ======== ======== =======================================================================
195
269
  ``ResidentialFacilityType`` string See [#]_ Yes Type of dwelling unit
196
- ``NumberofConditionedFloors`` double > 0 Yes Number of conditioned floors (including a basement)
270
+ ``NumberofConditionedFloors`` double > 0 Yes Number of conditioned floors (including a conditioned basement; excluding a conditioned crawlspace)
197
271
  ``NumberofConditionedFloorsAboveGrade`` double > 0, <= NumberofConditionedFloors Yes Number of conditioned floors above grade (including a walkout basement)
198
- ``NumberofBedrooms`` integer > 0 [#]_ Yes Number of bedrooms [#]_
272
+ ``NumberofBedrooms`` integer > 0 Yes Number of bedrooms
199
273
  ``NumberofBathrooms`` integer > 0 No See [#]_ Number of bathrooms
200
- ``ConditionedFloorArea`` double ft2 > 0 Yes Floor area within conditioned space boundary
201
- ``ConditionedBuildingVolume`` or ``AverageCeilingHeight`` double ft3 or ft > 0 No See [#]_ Volume/ceiling height within conditioned space boundary
274
+ ``ConditionedFloorArea`` double ft2 > 0 Yes Floor area within conditioned space boundary (excluding conditioned crawlspace floor area)
275
+ ``ConditionedBuildingVolume`` or ``AverageCeilingHeight`` double ft3 or ft > 0 No See [#]_ Volume/ceiling height within conditioned space boundary (including a conditioned basement/crawlspace)
202
276
  ``extension/HasFlueOrChimney`` boolean No See [#]_ Presence of flue or chimney for infiltration model
203
277
  ========================================================= ======== ========= ================================= ======== ======== =======================================================================
204
278
 
205
279
  .. [#] ResidentialFacilityType choices are "single-family detached", "single-family attached", "apartment unit", or "manufactured home".
206
- .. [#] NumberofBedrooms must also be <= (ConditionedFloorArea-120)/70.
207
- .. [#] NumberofBedrooms is currently used to determine usage of plug loads, appliances, hot water, etc.
208
280
  .. [#] 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>`_.
209
- .. [#] If neither ConditionedBuildingVolume nor AverageCeilingHeight provided, AverageCeilingHeight defaults to 8.0.
210
- If needed, additional defaulting is performed using the following relationship: ConditionedBuildingVolume = ConditionedFloorArea * AverageCeilingHeight.
281
+ .. [#] If neither ConditionedBuildingVolume nor AverageCeilingHeight provided, AverageCeilingHeight defaults to the lesser of 8.0 and InfiltrationVolume / ConditionedFloorArea.
282
+ If needed, additional defaulting is performed using the following relationship: ConditionedBuildingVolume = ConditionedFloorArea * AverageCeilingHeight + ConditionedCrawlspaceVolume.
211
283
  .. [#] If HasFlueOrChimney not provided, assumed to be true if any of the following conditions are met:
212
284
 
213
285
  - heating system is non-electric Furnace, Boiler, WallFurnace, FloorFurnace, Stove, PortableHeater, or FixedHeater and AFUE/Percent is less than 0.89,
@@ -248,8 +320,8 @@ For example, a foundation wall between the unit's vented crawlspace and the neig
248
320
  It is the software tool's responsibility to provide the appropriate building surfaces.
249
321
  While some error-checking is in place, it is not possible to know whether some surfaces are incorrectly missing.
250
322
 
251
- Also note that wall and roof surfaces do not require an azimuth to be specified.
252
- Rather, only the windows/skylights themselves require an azimuth.
323
+ Also note that wall and roof surfaces do not require an azimuth/orientation to be specified.
324
+ Rather, only the windows/skylights themselves require an azimuth/orientation.
253
325
  Thus, software tools can choose to use a single wall (or roof) surface to represent multiple wall (or roof) surfaces for the entire building if all their other properties (construction type, interior/exterior adjacency, etc.) are identical.
254
326
 
255
327
  HPXML Air Infiltration
@@ -308,36 +380,45 @@ Each pitched or flat roof surface that is exposed to ambient conditions is enter
308
380
 
309
381
  For a multifamily building where the dwelling unit has another dwelling unit above it, the surface between the two dwelling units should be considered a ``FrameFloor`` and not a ``Roof``.
310
382
 
311
- ====================================== ================ ============ ================= ========= ============================== ==================================
312
- Element Type Units Constraints Required Default Notes
313
- ====================================== ================ ============ ================= ========= ============================== ==================================
314
- ``SystemIdentifier`` id Yes Unique identifier
315
- ``InteriorAdjacentTo`` string See [#]_ Yes Interior adjacent space type
316
- ``Area`` double ft2 > 0 Yes Gross area (including skylights)
317
- ``Azimuth`` integer deg 0 - 359 No See [#]_ Azimuth (clockwise from North)
318
- ``RoofType`` string See [#]_ No asphalt or fiberglass shingles Roof type
319
- ``SolarAbsorptance`` or ``RoofColor`` double or string 0 - 1 or See [#]_ Yes See [#]_ Solar absorptance or color
320
- ``Emittance`` double 0 - 1 No 0.90 Emittance
321
- ``Pitch`` integer ?:12 >= 0 Yes Pitch
322
- ``RadiantBarrier`` boolean No false Presence of radiant barrier
323
- ``RadiantBarrierGrade`` integer 1 - 3 See [#]_ Radiant barrier installation grade
324
- ``Insulation/SystemIdentifier`` id Yes Unique identifier
325
- ``Insulation/AssemblyEffectiveRValue`` double F-ft2-hr/Btu > 0 Yes Assembly R-value [#]_
326
- ====================================== ================ ============ ================= ========= ============================== ==================================
383
+ ====================================== ================= ================ ===================== ========= ============================== ==================================
384
+ Element Type Units Constraints Required Default Notes
385
+ ====================================== ================= ================ ===================== ========= ============================== ==================================
386
+ ``SystemIdentifier`` id Yes Unique identifier
387
+ ``InteriorAdjacentTo`` string See [#]_ Yes Interior adjacent space type
388
+ ``Area`` double ft2 > 0 Yes Gross area (including skylights)
389
+ ``Azimuth`` or ``Orientation`` integer or string deg or direction 0 - 359 or See [#]_ No See [#]_ Direction (clockwise from North)
390
+ ``RoofType`` string See [#]_ No asphalt or fiberglass shingles Roof type
391
+ ``RoofColor`` or ``SolarAbsorptance`` string or double See [#]_ or 0 - 1 No medium Roof color or solar absorptance [#]_
392
+ ``Emittance`` double 0 - 1 No 0.90 Emittance
393
+ ``InteriorFinish/Type`` string See [#]_ No See [#]_ Interior finish material
394
+ ``InteriorFinish/Thickness`` double in >= 0 No 0.5 Interior finish thickness
395
+ ``Pitch`` integer ?:12 >= 0 Yes Pitch
396
+ ``RadiantBarrier`` boolean No false Presence of radiant barrier
397
+ ``RadiantBarrierGrade`` integer 1 - 3 No 1 Radiant barrier installation grade
398
+ ``Insulation/SystemIdentifier`` id Yes Unique identifier
399
+ ``Insulation/AssemblyEffectiveRValue`` double F-ft2-hr/Btu > 0 Yes Assembly R-value [#]_
400
+ ====================================== ================= ================ ===================== ========= ============================== ==================================
327
401
 
328
402
  .. [#] InteriorAdjacentTo choices are "attic - vented", "attic - unvented", "living space", or "garage".
329
403
  See :ref:`hpxmllocations` for descriptions.
330
- .. [#] If Azimuth not provided, modeled as four surfaces of equal area facing every direction.
331
- .. [#] RoofType choices are "asphalt or fiberglass shingles", "wood shingles or shakes", "slate or tile shingles", or "metal surfacing".
404
+ .. [#] Orientation choices are "northeast", "east", "southeast", "south", "southwest", "west", "northwest", or "north"
405
+ .. [#] If neither Azimuth nor Orientation provided, modeled as four surfaces of equal area facing every direction.
406
+ .. [#] 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".
332
407
  .. [#] RoofColor choices are "light", "medium", "medium dark", "dark", or "reflective".
333
- .. [#] If SolarAbsorptance not provided, defaults based on RoofColor/RoofType:
408
+ .. [#] If SolarAbsorptance not provided, defaults based on RoofType and RoofColor:
334
409
 
335
410
  - **asphalt or fiberglass shingles**: dark=0.92, medium dark=0.89, medium=0.85, light=0.75, reflective=0.50
336
411
  - **wood shingles or shakes**: dark=0.92, medium dark=0.89, medium=0.85, light=0.75, reflective=0.50
412
+ - **shingles**: dark=0.92, medium dark=0.89, medium=0.85, light=0.75, reflective=0.50
337
413
  - **slate or tile shingles**: dark=0.90, medium dark=0.83, medium=0.75, light=0.60, reflective=0.30
338
414
  - **metal surfacing**: dark=0.90, medium dark=0.83, medium=0.75, light=0.60, reflective=0.30
415
+ - **plastic/rubber/synthetic sheeting**: dark=0.90, medium dark=0.83, medium=0.75, light=0.60, reflective=0.30
416
+ - **expanded polystyrene sheathing**: dark=0.92, medium dark=0.89, medium=0.85, light=0.75, reflective=0.50
417
+ - **concrete**: dark=0.90, medium dark=0.83, medium=0.75, light=0.65, reflective=0.50
418
+ - **cool roof**: 0.30
339
419
 
340
- .. [#] RadiantBarrierGrade only required if RadiantBarrier is provided.
420
+ .. [#] InteriorFinish/Type choices are "gypsum board", "gypsum composite board", "plaster", "wood", "other", or "none".
421
+ .. [#] InteriorFinish/Type defaults to "gypsum board" if InteriorAdjacentTo is living space, otherwise "none".
341
422
  .. [#] AssemblyEffectiveRValue includes all material layers, interior/exterior air films, and insulation installation grade.
342
423
 
343
424
  HPXML Rim Joists
@@ -345,27 +426,28 @@ HPXML Rim Joists
345
426
 
346
427
  Each rim joist surface (i.e., the perimeter of floor joists typically found between stories of a building or on top of a foundation wall) is entered as an ``/HPXML/Building/BuildingDetails/Enclosure/RimJoists/RimJoist``.
347
428
 
348
- ====================================== ================ ============ ================= ======== =========== ==============================
349
- Element Type Units Constraints Required Default Notes
350
- ====================================== ================ ============ ================= ======== =========== ==============================
351
- ``SystemIdentifier`` id Yes Unique identifier
352
- ``ExteriorAdjacentTo`` string See [#]_ Yes Exterior adjacent space type
353
- ``InteriorAdjacentTo`` string See [#]_ Yes Interior adjacent space type
354
- ``Area`` double ft2 > 0 Yes Gross area
355
- ``Azimuth`` integer deg 0 - 359 No See [#]_ Azimuth (clockwise from North)
356
- ``Siding`` string See [#]_ No wood siding Siding material
357
- ``SolarAbsorptance`` or ``Color`` double or string 0 - 1 or See [#]_ Yes See [#]_ Solar absorptance or color
358
- ``Emittance`` double 0 - 1 No 0.90 Emittance
359
- ``Insulation/SystemIdentifier`` id Yes Unique identifier
360
- ``Insulation/AssemblyEffectiveRValue`` double F-ft2-hr/Btu > 0 Yes Assembly R-value [#]_
361
- ====================================== ================ ============ ================= ======== =========== ==============================
362
-
363
- .. [#] ExteriorAdjacentTo choices are "outside", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
429
+ ====================================== ================= ================ ===================== ======== =========== ==============================
430
+ Element Type Units Constraints Required Default Notes
431
+ ====================================== ================= ================ ===================== ======== =========== ==============================
432
+ ``SystemIdentifier`` id Yes Unique identifier
433
+ ``ExteriorAdjacentTo`` string See [#]_ Yes Exterior adjacent space type
434
+ ``InteriorAdjacentTo`` string See [#]_ Yes Interior adjacent space type
435
+ ``Area`` double ft2 > 0 Yes Gross area
436
+ ``Azimuth`` or ``Orientation`` integer or string deg or direction 0 - 359 or See [#]_ No See [#]_ Direction (clockwise from North)
437
+ ``Siding`` string See [#]_ No wood siding Siding material
438
+ ``Color`` or ``SolarAbsorptance`` string or double See [#]_ or 0 - 1 No medium Color or solar absorptance [#]_
439
+ ``Emittance`` double 0 - 1 No 0.90 Emittance
440
+ ``Insulation/SystemIdentifier`` id Yes Unique identifier
441
+ ``Insulation/AssemblyEffectiveRValue`` double F-ft2-hr/Btu > 0 Yes Assembly R-value [#]_
442
+ ====================================== ================= ================ ===================== ======== =========== ==============================
443
+
444
+ .. [#] 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".
364
445
  See :ref:`hpxmllocations` for descriptions.
365
- .. [#] InteriorAdjacentTo choices are "living space", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", or "garage".
446
+ .. [#] InteriorAdjacentTo choices are "living space", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", or "garage".
366
447
  See :ref:`hpxmllocations` for descriptions.
367
- .. [#] If Azimuth not provided, modeled as four surfaces of equal area facing every direction.
368
- .. [#] Siding choices are "wood siding", "vinyl siding", "stucco", "fiber cement siding", "brick veneer", or "aluminum siding".
448
+ .. [#] Orientation choices are "northeast", "east", "southeast", "south", "southwest", "west", "northwest", or "north"
449
+ .. [#] If neither Azimuth nor Orientation provided, modeled as four surfaces of equal area facing every direction.
450
+ .. [#] 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".
369
451
  .. [#] Color choices are "light", "medium", "medium dark", "dark", or "reflective".
370
452
  .. [#] If SolarAbsorptance not provided, defaults based on Color:
371
453
 
@@ -382,29 +464,32 @@ HPXML Walls
382
464
 
383
465
  Each wall that has no contact with the ground and bounds a space type is entered as an ``/HPXML/Building/BuildingDetails/Enclosure/Walls/Wall``.
384
466
 
385
- ====================================== ================ ============ ================= ============= =========== ====================================
386
- Element Type Units Constraints Required Default Notes
387
- ====================================== ================ ============ ================= ============= =========== ====================================
388
- ``SystemIdentifier`` id Yes Unique identifier
389
- ``ExteriorAdjacentTo`` string See [#]_ Yes Exterior adjacent space type
390
- ``InteriorAdjacentTo`` string See [#]_ Yes Interior adjacent space type
391
- ``WallType`` element 1 [#]_ Yes Wall type (for thermal mass)
392
- ``Area`` double ft2 > 0 Yes Gross area (including doors/windows)
393
- ``Azimuth`` integer deg 0 - 359 No See [#]_ Azimuth (clockwise from North)
394
- ``Siding`` string See [#]_ No wood siding Siding material
395
- ``SolarAbsorptance`` or ``Color`` double or string 0 - 1 or See [#]_ Yes See [#]_ Solar absorptance or color
396
- ``Emittance`` double 0 - 1 No 0.90 Emittance
397
- ``Insulation/SystemIdentifier`` id Yes Unique identifier
398
- ``Insulation/AssemblyEffectiveRValue`` double F-ft2-hr/Btu > 0 Yes Assembly R-value [#]_
399
- ====================================== ================ ============ ================= ============= =========== ====================================
400
-
401
- .. [#] ExteriorAdjacentTo choices are "outside", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
467
+ ====================================== ================= ================ ===================== ============= =========== ====================================
468
+ Element Type Units Constraints Required Default Notes
469
+ ====================================== ================= ================ ===================== ============= =========== ====================================
470
+ ``SystemIdentifier`` id Yes Unique identifier
471
+ ``ExteriorAdjacentTo`` string See [#]_ Yes Exterior adjacent space type
472
+ ``InteriorAdjacentTo`` string See [#]_ Yes Interior adjacent space type
473
+ ``WallType`` element 1 [#]_ Yes Wall type (for thermal mass)
474
+ ``Area`` double ft2 > 0 Yes Gross area (including doors/windows)
475
+ ``Azimuth`` or ``Orientation`` integer or string deg or direction 0 - 359 or See [#]_ No See [#]_ Direction (clockwise from North)
476
+ ``Siding`` string See [#]_ No wood siding Siding material
477
+ ``Color`` or ``SolarAbsorptance`` string or double See [#]_ or 0 - 1 No medium Color or solar absorptance [#]_
478
+ ``Emittance`` double 0 - 1 No 0.90 Emittance
479
+ ``InteriorFinish/Type`` string See [#]_ No See [#]_ Interior finish material
480
+ ``InteriorFinish/Thickness`` double in >= 0 No 0.5 Interior finish thickness
481
+ ``Insulation/SystemIdentifier`` id Yes Unique identifier
482
+ ``Insulation/AssemblyEffectiveRValue`` double F-ft2-hr/Btu > 0 Yes Assembly R-value [#]_
483
+ ====================================== ================= ================ ===================== ============= =========== ====================================
484
+
485
+ .. [#] 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".
402
486
  See :ref:`hpxmllocations` for descriptions.
403
- .. [#] InteriorAdjacentTo choices are "living space", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", or "garage".
487
+ .. [#] InteriorAdjacentTo choices are "living space", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", or "garage".
404
488
  See :ref:`hpxmllocations` for descriptions.
405
489
  .. [#] WallType child element choices are ``WoodStud``, ``DoubleWoodStud``, ``ConcreteMasonryUnit``, ``StructurallyInsulatedPanel``, ``InsulatedConcreteForms``, ``SteelFrame``, ``SolidConcrete``, ``StructuralBrick``, ``StrawBale``, ``Stone``, ``LogWall``, or ``Adobe``.
406
- .. [#] If Azimuth not provided, modeled as four surfaces of equal area facing every direction.
407
- .. [#] Siding choices are "wood siding", "vinyl siding", "stucco", "fiber cement siding", "brick veneer", or "aluminum siding".
490
+ .. [#] Orientation choices are "northeast", "east", "southeast", "south", "southwest", "west", "northwest", or "north"
491
+ .. [#] If neither Azimuth nor Orientation provided, modeled as four surfaces of equal area facing every direction.
492
+ .. [#] 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".
408
493
  .. [#] Color choices are "light", "medium", "medium dark", "dark", or "reflective".
409
494
  .. [#] If SolarAbsorptance not provided, defaults based on Color:
410
495
 
@@ -414,6 +499,8 @@ Each wall that has no contact with the ground and bounds a space type is entered
414
499
  - **light**: 0.50
415
500
  - **reflective**: 0.30
416
501
 
502
+ .. [#] InteriorFinish/Type choices are "gypsum board", "gypsum composite board", "plaster", "wood", "other", or "none".
503
+ .. [#] InteriorFinish/Type defaults to "gypsum board" if InteriorAdjacentTo is living space or basement - conditioned, otherwise "none".
417
504
  .. [#] AssemblyEffectiveRValue includes all material layers, interior/exterior air films, and insulation installation grade.
418
505
 
419
506
  HPXML Foundation Walls
@@ -423,33 +510,40 @@ Each wall that is in contact with the ground should be specified as an ``/HPXML/
423
510
 
424
511
  Other walls (e.g., wood framed walls) that are connected to a below-grade space but have no contact with the ground should be specified as a ``Wall`` and not a ``FoundationWall``.
425
512
 
426
- ============================================================== ======== ============ =========== ========= ======== ====================================
427
- Element Type Units Constraints Required Default Notes
428
- ============================================================== ======== ============ =========== ========= ======== ====================================
429
- ``SystemIdentifier`` id Yes Unique identifier
430
- ``ExteriorAdjacentTo`` string See [#]_ Yes Exterior adjacent space type [#]_
431
- ``InteriorAdjacentTo`` string See [#]_ Yes Interior adjacent space type
432
- ``Height`` double ft > 0 Yes Total height
433
- ``Area`` double ft2 > 0 Yes Gross area (including doors/windows)
434
- ``Azimuth`` integer deg 0 - 359 No See [#]_ Azimuth (clockwise from North)
435
- ``Thickness`` double inches > 0 No 8.0 Thickness excluding interior framing
436
- ``DepthBelowGrade`` double ft 0 - Height Yes Depth below grade [#]_
437
- ``Insulation/SystemIdentifier`` id Yes Unique identifier
438
- ``Insulation/Layer[InstallationType="continuous - interior"]`` element 0 - 1 See [#]_ Interior insulation layer
439
- ``Insulation/Layer[InstallationType="continuous - exterior"]`` element 0 - 1 See [#]_ Exterior insulation layer
440
- ``Insulation/AssemblyEffectiveRValue`` double F-ft2-hr/Btu > 0 See [#]_ Assembly R-value [#]_
441
- ============================================================== ======== ============ =========== ========= ======== ====================================
442
-
443
- .. [#] ExteriorAdjacentTo choices are "ground", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
513
+ ============================================================== ================= ================ =================== ========= ============== ====================================
514
+ Element Type Units Constraints Required Default Notes
515
+ ============================================================== ================= ================ =================== ========= ============== ====================================
516
+ ``SystemIdentifier`` id Yes Unique identifier
517
+ ``ExteriorAdjacentTo`` string See [#]_ Yes Exterior adjacent space type [#]_
518
+ ``InteriorAdjacentTo`` string See [#]_ Yes Interior adjacent space type
519
+ ``Type`` string See [#]_ No solid concrete Type of material
520
+ ``Height`` double ft > 0 Yes Total height
521
+ ``Area`` or ``Length`` double ft2 or ft > 0 Yes Gross area (including doors/windows) or length
522
+ ``Azimuth`` or ``Orientation`` integer or string deg or direction 0 - 359 or See [#]_ No See [#]_ Direction (clockwise from North)
523
+ ``Thickness`` double inches > 0 No 8.0 Thickness excluding interior framing
524
+ ``DepthBelowGrade`` double ft 0 - Height Yes Depth below grade [#]_
525
+ ``InteriorFinish/Type`` string See [#]_ No See [#]_ Interior finish material
526
+ ``InteriorFinish/Thickness`` double in >= 0 No 0.5 Interior finish thickness
527
+ ``Insulation/SystemIdentifier`` id Yes Unique identifier
528
+ ``Insulation/Layer[InstallationType="continuous - interior"]`` element 0 - 1 See [#]_ Interior insulation layer
529
+ ``Insulation/Layer[InstallationType="continuous - exterior"]`` element 0 - 1 See [#]_ Exterior insulation layer
530
+ ``Insulation/AssemblyEffectiveRValue`` double F-ft2-hr/Btu > 0 See [#]_ Assembly R-value [#]_
531
+ ============================================================== ================= ================ =================== ========= ============== ====================================
532
+
533
+ .. [#] ExteriorAdjacentTo choices are "ground", "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".
444
534
  See :ref:`hpxmllocations` for descriptions.
445
- .. [#] InteriorAdjacentTo choices are "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", or "garage".
535
+ .. [#] InteriorAdjacentTo choices are "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", or "garage".
446
536
  See :ref:`hpxmllocations` for descriptions.
447
537
  .. [#] Interior foundation walls (e.g., between basement and crawlspace) should **not** use "ground" even if the foundation wall has some contact with the ground due to the difference in below-grade depths of the two adjacent spaces.
448
- .. [#] If Azimuth not provided, modeled as four surfaces of equal area facing every direction.
538
+ .. [#] Type choices are "solid concrete", "concrete block", "concrete block foam core", "concrete block vermiculite core", "concrete block perlite core", "concrete block solid core", "double brick", or "wood".
539
+ .. [#] Orientation choices are "northeast", "east", "southeast", "south", "southwest", "west", "northwest", or "north"
540
+ .. [#] If neither Azimuth nor Orientation provided, modeled as four surfaces of equal area facing every direction.
449
541
  .. [#] For exterior foundation walls, depth below grade is relative to the ground plane.
450
542
  For interior foundation walls, depth below grade is the vertical span of foundation wall in contact with the ground.
451
543
  For example, an interior foundation wall between an 8 ft conditioned basement and a 3 ft crawlspace has a height of 8 ft and a depth below grade of 5 ft.
452
544
  Alternatively, an interior foundation wall between an 8 ft conditioned basement and an 8 ft unconditioned basement has a height of 8 ft and a depth below grade of 0 ft.
545
+ .. [#] InteriorFinish/Type choices are "gypsum board", "gypsum composite board", "plaster", "wood", "other", or "none".
546
+ .. [#] InteriorFinish/Type defaults to "gypsum board" if InteriorAdjacentTo is basement - conditioned, otherwise "none".
453
547
  .. [#] Layer[InstallationType="continuous - interior"] only required if AssemblyEffectiveRValue is not provided.
454
548
  .. [#] Layer[InstallationType="continuous - exterior"] only required if AssemblyEffectiveRValue is not provided.
455
549
  .. [#] AssemblyEffectiveRValue only required if Layer elements are not provided.
@@ -458,34 +552,40 @@ Other walls (e.g., wood framed walls) that are connected to a below-grade space
458
552
 
459
553
  If insulation layers are provided, additional information is entered in each ``FoundationWall/Insulation/Layer``.
460
554
 
461
- ========================================== ======== ============ ================================== ======== ======= =====================================================================
462
- Element Type Units Constraints Required Default Notes
463
- ========================================== ======== ============ ================================== ======== ======= =====================================================================
464
- ``NominalRValue`` double F-ft2-hr/Btu >= 0 Yes R-value of the foundation wall insulation; use zero if no insulation
465
- ``extension/DistanceToTopOfInsulation`` double ft >= 0 Yes Vertical distance from top of foundation wall to top of insulation
466
- ``extension/DistanceToBottomOfInsulation`` double ft DistanceToTopOfInsulation - Height Yes Vertical distance from top of foundation wall to bottom of insulation
467
- ========================================== ======== ============ ================================== ======== ======= =====================================================================
555
+ ========================================== ======== ============ =========== ======== ======= =====================================================================
556
+ Element Type Units Constraints Required Default Notes
557
+ ========================================== ======== ============ =========== ======== ======= =====================================================================
558
+ ``NominalRValue`` double F-ft2-hr/Btu >= 0 Yes R-value of the foundation wall insulation; use zero if no insulation
559
+ ``DistanceToTopOfInsulation`` double ft >= 0 No 0 Vertical distance from top of foundation wall to top of insulation
560
+ ``DistanceToBottomOfInsulation`` double ft See [#]_ No Height Vertical distance from top of foundation wall to bottom of insulation
561
+ ========================================== ======== ============ =========== ======== ======= =====================================================================
562
+
563
+ .. [#] When NominalRValue is non-zero, DistanceToBottomOfInsulation must be greater than DistanceToTopOfInsulation and less than or equal to FoundationWall/Height.
468
564
 
469
565
  HPXML Frame Floors
470
566
  ******************
471
567
 
472
- Each horizontal floor/ceiling surface that is not in contact with the ground (Slab) nor adjacent to ambient conditions above (Roof) is entered as an ``/HPXML/Building/BuildingDetails/Enclosure/FrameFloors/FrameFloor``.
473
-
474
- ====================================== ======== ============ =========== ======== ======= ============================
475
- Element Type Units Constraints Required Default Notes
476
- ====================================== ======== ============ =========== ======== ======= ============================
477
- ``SystemIdentifier`` id Yes Unique identifier
478
- ``ExteriorAdjacentTo`` string See [#]_ Yes Exterior adjacent space type
479
- ``InteriorAdjacentTo`` string See [#]_ Yes Interior adjacent space type
480
- ``Area`` double ft2 > 0 Yes Gross area
481
- ``Insulation/SystemIdentifier`` id Yes Unique identifier
482
- ``Insulation/AssemblyEffectiveRValue`` double F-ft2-hr/Btu > 0 Yes Assembly R-value [#]_
483
- ====================================== ======== ============ =========== ======== ======= ============================
484
-
485
- .. [#] ExteriorAdjacentTo choices are "outside", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "garage", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
568
+ Each floor/ceiling surface that is not in contact with the ground (Slab) nor adjacent to ambient conditions above (Roof) is entered as an ``/HPXML/Building/BuildingDetails/Enclosure/FrameFloors/FrameFloor``.
569
+
570
+ ====================================== ======== ============ =========== ======== ======== ============================
571
+ Element Type Units Constraints Required Default Notes
572
+ ====================================== ======== ============ =========== ======== ======== ============================
573
+ ``SystemIdentifier`` id Yes Unique identifier
574
+ ``ExteriorAdjacentTo`` string See [#]_ Yes Exterior adjacent space type
575
+ ``InteriorAdjacentTo`` string See [#]_ Yes Interior adjacent space type
576
+ ``Area`` double ft2 > 0 Yes Gross area
577
+ ``InteriorFinish/Type`` string See [#]_ No See [#]_ Interior finish material
578
+ ``InteriorFinish/Thickness`` double in >= 0 No 0.5 Interior finish thickness
579
+ ``Insulation/SystemIdentifier`` id Yes Unique identifier
580
+ ``Insulation/AssemblyEffectiveRValue`` double F-ft2-hr/Btu > 0 Yes Assembly R-value [#]_
581
+ ====================================== ======== ============ =========== ======== ======== ============================
582
+
583
+ .. [#] 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".
486
584
  See :ref:`hpxmllocations` for descriptions.
487
- .. [#] InteriorAdjacentTo choices are "living space", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", or "garage".
585
+ .. [#] InteriorAdjacentTo choices are "living space", "attic - vented", "attic - unvented", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", or "garage".
488
586
  See :ref:`hpxmllocations` for descriptions.
587
+ .. [#] InteriorFinish/Type choices are "gypsum board", "gypsum composite board", "plaster", "wood", "other", or "none".
588
+ .. [#] InteriorFinish/Type defaults to "gypsum board" if InteriorAdjacentTo is living space and the surface is a ceiling, otherwise "none".
489
589
  .. [#] AssemblyEffectiveRValue includes all material layers, interior/exterior air films, and insulation installation grade.
490
590
 
491
591
  For frame floors adjacent to "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space", additional information is entered in ``FrameFloor``.
@@ -503,36 +603,36 @@ HPXML Slabs
503
603
 
504
604
  Each space type that borders the ground (i.e., basements, crawlspaces, garages, and slab-on-grade foundations) should have a slab entered as an ``/HPXML/Building/BuildingDetails/Enclosure/Slabs/Slab``.
505
605
 
506
- =========================================== ======== ============ =========== ========= ======== ====================================================
507
- Element Type Units Constraints Required Default Notes
508
- =========================================== ======== ============ =========== ========= ======== ====================================================
509
- ``SystemIdentifier`` id Yes Unique identifier
510
- ``InteriorAdjacentTo`` string See [#]_ Yes Interior adjacent space type
511
- ``Area`` double ft2 > 0 Yes Gross area
512
- ``Thickness`` double inches >= 0 No See [#]_ Thickness [#]_
513
- ``ExposedPerimeter`` double ft >= 0 Yes Perimeter exposed to ambient conditions [#]_
514
- ``PerimeterInsulationDepth`` double ft >= 0 Yes Depth from grade to bottom of vertical insulation
515
- ``UnderSlabInsulationWidth`` double ft >= 0 See [#]_ Width from slab edge inward of horizontal insulation
516
- ``UnderSlabInsulationSpansEntireSlab`` boolean See [#]_ Whether horizontal insulation spans entire slab
517
- ``DepthBelowGrade`` double ft >= 0 See [#]_ Depth from the top of the slab surface to grade
518
- ``PerimeterInsulation/SystemIdentifier`` id Yes Unique identifier
519
- ``PerimeterInsulation/Layer/NominalRValue`` double F-ft2-hr/Btu >= 0 Yes R-value of vertical insulation
520
- ``UnderSlabInsulation/SystemIdentifier`` id Yes Unique identifier
521
- ``UnderSlabInsulation/Layer/NominalRValue`` double F-ft2-hr/Btu >= 0 Yes R-value of horizontal insulation
522
- ``extension/CarpetFraction`` double frac 0 - 1 No See [#]_ Fraction of slab covered by carpet
523
- ``extension/CarpetRValue`` double F-ft2-hr/Btu >= 0 No See [#]_ Carpet R-value
524
- =========================================== ======== ============ =========== ========= ======== ====================================================
525
-
526
- .. [#] InteriorAdjacentTo choices are "living space", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", or "garage".
606
+ ======================================================= ======== ============ =========== ========= ======== ====================================================
607
+ Element Type Units Constraints Required Default Notes
608
+ ======================================================= ======== ============ =========== ========= ======== ====================================================
609
+ ``SystemIdentifier`` id Yes Unique identifier
610
+ ``InteriorAdjacentTo`` string See [#]_ Yes Interior adjacent space type
611
+ ``Area`` double ft2 > 0 Yes Gross area
612
+ ``Thickness`` double inches >= 0 No See [#]_ Thickness [#]_
613
+ ``ExposedPerimeter`` double ft >= 0 Yes Perimeter exposed to ambient conditions [#]_
614
+ ``DepthBelowGrade`` double ft >= 0 See [#]_ Depth from the top of the slab surface to grade
615
+ ``PerimeterInsulation/SystemIdentifier`` id Yes Unique identifier
616
+ ``PerimeterInsulation/Layer/NominalRValue`` double F-ft2-hr/Btu >= 0 Yes R-value of vertical insulation
617
+ ``PerimeterInsulation/Layer/InsulationDepth`` double ft >= 0 Yes Depth from grade to bottom of vertical insulation
618
+ ``UnderSlabInsulation/SystemIdentifier`` id Yes Unique identifier
619
+ ``UnderSlabInsulation/Layer/NominalRValue`` double F-ft2-hr/Btu >= 0 Yes R-value of horizontal insulation
620
+ ``UnderSlabInsulation/Layer/InsulationWidth`` double ft >= 0 See [#]_ Width from slab edge inward of horizontal insulation
621
+ ``UnderSlabInsulation/Layer/InsulationSpansEntireSlab`` boolean See [#]_ Whether horizontal insulation spans entire slab
622
+ ``extension/CarpetFraction`` double frac 0 - 1 No See [#]_ Fraction of slab covered by carpet
623
+ ``extension/CarpetRValue`` double F-ft2-hr/Btu >= 0 No See [#]_ Carpet R-value
624
+ ======================================================= ======== ============ =========== ========= ======== ====================================================
625
+
626
+ .. [#] InteriorAdjacentTo choices are "living space", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", or "garage".
527
627
  See :ref:`hpxmllocations` for descriptions.
528
628
  .. [#] If Thickness not provided, defaults to 0 when adjacent to crawlspace and 4 inches for all other cases.
529
629
  .. [#] For a crawlspace with a dirt floor, enter a thickness of zero.
530
630
  .. [#] ExposedPerimeter includes any slab length that falls along the perimeter of the building's footprint (i.e., is exposed to ambient conditions).
531
631
  So a basement slab edge adjacent to a garage or crawlspace, for example, should not be included.
532
- .. [#] UnderSlabInsulationWidth only required if UnderSlabInsulationSpansEntireSlab=true is not provided.
533
- .. [#] UnderSlabInsulationSpansEntireSlab=true only required if UnderSlabInsulationWidth is not provided.
534
632
  .. [#] DepthBelowGrade only required if the attached foundation has no ``FoundationWalls``.
535
633
  For foundation types with walls, the the slab's position relative to grade is determined by the ``FoundationWall/DepthBelowGrade`` value.
634
+ .. [#] InsulationWidth only required if InsulationSpansEntireSlab=true is not provided.
635
+ .. [#] InsulationSpansEntireSlab=true only required if InsulationWidth is not provided.
536
636
  .. [#] If CarpetFraction not provided, defaults to 0.8 when adjacent to conditioned space, otherwise 0.0.
537
637
  .. [#] If CarpetRValue not provided, defaults to 2.0 when adjacent to conditioned space, otherwise 0.0.
538
638
 
@@ -543,23 +643,25 @@ HPXML Windows
543
643
 
544
644
  Each window or glass door area is entered as an ``/HPXML/Building/BuildingDetails/Enclosure/Windows/Window``.
545
645
 
546
- ============================================ ======== ============ =========== ======== ========= =============================================================
547
- Element Type Units Constraints Required Default Notes
548
- ============================================ ======== ============ =========== ======== ========= =============================================================
549
- ``SystemIdentifier`` id Yes Unique identifier
550
- ``Area`` double ft2 > 0 Yes Total area
551
- ``Azimuth`` integer deg 0 - 359 Yes Azimuth (clockwise from North)
552
- ``UFactor`` double Btu/F-ft2-hr > 0 Yes Full-assembly NFRC U-factor
553
- ``SHGC`` double 0 - 1 Yes Full-assembly NFRC solar heat gain coefficient
554
- ``ExteriorShading/SummerShadingCoefficient`` double frac 0 - 1 No 1.00 Exterior summer shading coefficient (1=transparent, 0=opaque)
555
- ``ExteriorShading/WinterShadingCoefficient`` double frac 0 - 1 No 1.00 Exterior winter shading coefficient (1=transparent, 0=opaque)
556
- ``InteriorShading/SummerShadingCoefficient`` double frac 0 - 1 No 0.70 [#]_ Interior summer shading coefficient (1=transparent, 0=opaque)
557
- ``InteriorShading/WinterShadingCoefficient`` double frac 0 - 1 No 0.85 [#]_ Interior winter shading coefficient (1=transparent, 0=opaque)
558
- ``Overhangs`` element 0 - 1 No <none> Presence of overhangs (including roof eaves)
559
- ``FractionOperable`` double frac 0 - 1 No 0.67 Operable fraction [#]_
560
- ``AttachedToWall`` idref See [#]_ Yes ID of attached wall
561
- ============================================ ======== ============ =========== ======== ========= =============================================================
562
-
646
+ ============================================ ================= ================ =================== ======== ========= =============================================================
647
+ Element Type Units Constraints Required Default Notes
648
+ ============================================ ================= ================ =================== ======== ========= =============================================================
649
+ ``SystemIdentifier`` id Yes Unique identifier
650
+ ``Area`` double ft2 > 0 Yes Total area
651
+ ``Azimuth`` or ``Orientation`` integer or string deg or direction 0 - 359 or See [#]_ Yes Direction (clockwise from North)
652
+ ``UFactor`` and/or ``GlassLayers`` double or string Btu/F-ft2-hr > 0 or See [#]_ Yes Full-assembly NFRC U-factor (including any storm window) or glass layers description
653
+ ``SHGC`` and/or ``GlassLayers`` double or string 0 - 1 Yes Full-assembly NFRC solar heat gain coefficient (including any storm window) or glass layers description
654
+ ``ExteriorShading/SummerShadingCoefficient`` double frac 0 - 1 No 1.00 Exterior summer shading coefficient (1=transparent, 0=opaque)
655
+ ``ExteriorShading/WinterShadingCoefficient`` double frac 0 - 1 No 1.00 Exterior winter shading coefficient (1=transparent, 0=opaque)
656
+ ``InteriorShading/SummerShadingCoefficient`` double frac 0 - 1 No 0.70 [#]_ Interior summer shading coefficient (1=transparent, 0=opaque)
657
+ ``InteriorShading/WinterShadingCoefficient`` double frac 0 - 1 No 0.85 [#]_ Interior winter shading coefficient (1=transparent, 0=opaque)
658
+ ``Overhangs`` element 0 - 1 No <none> Presence of overhangs (including roof eaves)
659
+ ``FractionOperable`` double frac 0 - 1 No 0.67 Operable fraction [#]_
660
+ ``AttachedToWall`` idref See [#]_ Yes ID of attached wall
661
+ ============================================ ================= ================ =================== ======== ========= =============================================================
662
+
663
+ .. [#] Orientation choices are "northeast", "east", "southeast", "south", "southwest", "west", "northwest", or "north".
664
+ .. [#] GlassLayers choices are "single-pane", "double-pane", "triple-pane", or "glass block".
563
665
  .. [#] InteriorShading/SummerShadingCoefficient default value indicates 30% reduction in solar heat gain, based on `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_.
564
666
  .. [#] InteriorShading/WinterShadingCoefficient default value indicates 15% reduction in solar heat gain, based on `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_.
565
667
  .. [#] FractionOperable reflects whether the windows are operable (can be opened), not how they are used by the occupants.
@@ -568,56 +670,190 @@ Each window or glass door area is entered as an ``/HPXML/Building/BuildingDetail
568
670
  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.
569
671
  .. [#] AttachedToWall must reference a ``Wall`` or ``FoundationWall``.
570
672
 
673
+ If UFactor and SHGC are not provided and GlassLayers is not "glass block", additional information is entered in ``Window``.
674
+
675
+ ============================ ======== ====== ======================= ======== ======== ========================================================
676
+ Element Type Units Constraints Required Default Notes
677
+ ============================ ======== ====== ======================= ======== ======== ========================================================
678
+ ``FrameType`` element See [#]_ Yes Type of frame
679
+ ``FrameType/*/ThermalBreak`` boolean See [#]_ No false Whether the Aluminum or Metal frame has a thermal break
680
+ ``GlassType`` string See [#]_ No <none> Type of glass
681
+ ``GasFill`` string See [#]_ No See [#]_ Type of gas inside double/triple-pane windows
682
+ ============================ ======== ====== ======================= ======== ======== ========================================================
683
+
684
+ .. [#] FrameType child element choices are ``Aluminum``, ``Fiberglass``, ``Metal``, ``Vinyl``, or ``Wood``.
685
+ .. [#] ThermalBreak is only valid if FrameType is ``Aluminum`` or ``Metal``.
686
+ .. [#] GlassType choices are "clear", "low-e", "tinted", "tinted/reflective", or "reflective".
687
+ Do not specify this element if the window has clear glass.
688
+ .. [#] GasFill choices are "air", "argon", "krypton", "xenon", "nitrogen", or "other".
689
+ .. [#] If GasFill not provided, defaults to "air" for double-pane windows and "argon" for triple-pane windows.
690
+
691
+ If UFactor and SHGC are not provided, they are defaulted as follows:
692
+
693
+ =========== ======================= ============ ========================= ============= ======= ====
694
+ GlassLayers FrameType ThermalBreak GlassType GasFill UFactor SHGC
695
+ =========== ======================= ============ ========================= ============= ======= ====
696
+ single-pane Aluminum, Metal false clear -- 1.27 0.75
697
+ single-pane Fiberglass, Vinyl, Wood -- clear -- 0.89 0.64
698
+ single-pane Aluminum, Metal false tinted, tinted/reflective -- 1.27 0.64
699
+ single-pane Fiberglass, Vinyl, Wood -- tinted, tinted/reflective -- 0.89 0.54
700
+ double-pane Aluminum, Metal false clear air 0.81 0.67
701
+ double-pane Aluminum, Metal true clear air 0.60 0.67
702
+ double-pane Fiberglass, Vinyl, Wood -- clear air 0.51 0.56
703
+ double-pane Aluminum, Metal false tinted, tinted/reflective air 0.81 0.55
704
+ double-pane Aluminum, Metal true tinted, tinted/reflective air 0.60 0.55
705
+ double-pane Fiberglass, Vinyl, Wood -- tinted, tinted/reflective air 0.51 0.46
706
+ double-pane Fiberglass, Vinyl, Wood -- low-e air 0.42 0.52
707
+ double-pane Aluminum, Metal true low-e <any but air> 0.47 0.62
708
+ double-pane Fiberglass, Vinyl, Wood -- low-e <any but air> 0.39 0.52
709
+ double-pane Aluminum, Metal false reflective air 0.67 0.37
710
+ double-pane Aluminum, Metal true reflective air 0.47 0.37
711
+ double-pane Fiberglass, Vinyl, Wood -- reflective air 0.39 0.31
712
+ double-pane Fiberglass, Vinyl, Wood -- reflective <any but air> 0.36 0.31
713
+ triple-pane Fiberglass, Vinyl, Wood -- low-e <any but air> 0.27 0.31
714
+ glass block -- -- -- -- 0.60 0.60
715
+ =========== ======================= ============ ========================= ============= ======= ====
716
+
717
+ .. warning::
718
+
719
+ OpenStudio-HPXML will return an error if the combination of window properties is not in the above table.
720
+
571
721
  If overhangs are specified, additional information is entered in ``Overhangs``.
572
722
 
573
- ============================ ======== ====== ======================= ======== ======= ========================================================
574
- Element Type Units Constraints Required Default Notes
575
- ============================ ======== ====== ======================= ======== ======= ========================================================
576
- ``Depth`` double inches >= 0 Yes Depth of overhang
577
- ``DistanceToTopOfWindow`` double ft >= 0 Yes Vertical distance from overhang to top of window
578
- ``DistanceToBottomOfWindow`` double ft > DistanceToTopOfWindow Yes Vertical distance from overhang to bottom of window [#]_
579
- ============================ ======== ====== ======================= ======== ======= ========================================================
723
+ ============================ ======== ====== =========== ======== ======= ========================================================
724
+ Element Type Units Constraints Required Default Notes
725
+ ============================ ======== ====== =========== ======== ======= ========================================================
726
+ ``Depth`` double inches >= 0 Yes Depth of overhang
727
+ ``DistanceToTopOfWindow`` double ft >= 0 Yes Vertical distance from overhang to top of window
728
+ ``DistanceToBottomOfWindow`` double ft See [#]_ Yes Vertical distance from overhang to bottom of window [#]_
729
+ ============================ ======== ====== =========== ======== ======= ========================================================
580
730
 
581
731
  .. [#] The difference between DistanceToBottomOfWindow and DistanceToTopOfWindow defines the height of the window.
732
+ .. [#] When Depth is non-zero, DistanceToBottomOfWindow must be greater than DistanceToTopOfWindow.
582
733
 
583
734
  HPXML Skylights
584
735
  ***************
585
736
 
586
737
  Each skylight is entered as an ``/HPXML/Building/BuildingDetails/Enclosure/Skylights/Skylight``.
587
738
 
588
- ============================================ ======== ============ =========== ======== ========== =============================================================
589
- Element Type Units Constraints Required Default Notes
590
- ============================================ ======== ============ =========== ======== ========== =============================================================
591
- ``SystemIdentifier`` id Yes Unique identifier
592
- ``Area`` double ft2 > 0 Yes Total area
593
- ``Azimuth`` integer deg 0 - 359 Yes Azimuth (clockwise from North)
594
- ``UFactor`` double Btu/F-ft2-hr > 0 Yes Full-assembly NFRC U-factor
595
- ``SHGC`` double 0 - 1 Yes Full-assembly NFRC solar heat gain coefficient
596
- ``ExteriorShading/SummerShadingCoefficient`` double frac 0 - 1 No 1.00 Exterior summer shading coefficient (1=transparent, 0=opaque)
597
- ``ExteriorShading/WinterShadingCoefficient`` double frac 0 - 1 No 1.00 Exterior winter shading coefficient (1=transparent, 0=opaque)
598
- ``InteriorShading/SummerShadingCoefficient`` double frac 0 - 1 No 1.00 Interior summer shading coefficient (1=transparent, 0=opaque)
599
- ``InteriorShading/WinterShadingCoefficient`` double frac 0 - 1 No 1.00 Interior winter shading coefficient (1=transparent, 0=opaque)
600
- ``AttachedToRoof`` idref See [#]_ Yes ID of attached roof
601
- ============================================ ======== ============ =========== ======== ========== =============================================================
602
-
739
+ ============================================ ================= ================ =================== ======== ========= =============================================================
740
+ Element Type Units Constraints Required Default Notes
741
+ ============================================ ================= ================ =================== ======== ========= =============================================================
742
+ ``SystemIdentifier`` id Yes Unique identifier
743
+ ``Area`` double ft2 > 0 Yes Total area
744
+ ``Azimuth`` or ``Orientation`` integer or string deg or direction 0 - 359 or See [#]_ Yes Direction (clockwise from North)
745
+ ``UFactor`` and/or ``GlassLayers`` double or string Btu/F-ft2-hr > 0 or See [#]_ Yes Full-assembly NFRC U-factor or glass layers description
746
+ ``SHGC`` and/or ``GlassLayers`` double or string 0 - 1 Yes Full-assembly NFRC solar heat gain coefficient or glass layers description
747
+ ``ExteriorShading/SummerShadingCoefficient`` double frac 0 - 1 No 1.00 Exterior summer shading coefficient (1=transparent, 0=opaque)
748
+ ``ExteriorShading/WinterShadingCoefficient`` double frac 0 - 1 No 1.00 Exterior winter shading coefficient (1=transparent, 0=opaque)
749
+ ``InteriorShading/SummerShadingCoefficient`` double frac 0 - 1 No 1.00 Interior summer shading coefficient (1=transparent, 0=opaque)
750
+ ``InteriorShading/WinterShadingCoefficient`` double frac 0 - 1 No 1.00 Interior winter shading coefficient (1=transparent, 0=opaque)
751
+ ``AttachedToRoof`` idref See [#]_ Yes ID of attached roof
752
+ ============================================ ================= ================ =================== ======== ========= =============================================================
753
+
754
+ .. [#] Orientation choices are "northeast", "east", "southeast", "south", "southwest", "west", "northwest", or "north"
755
+ .. [#] GlassLayers choices are "single-pane", "double-pane", or "triple-pane".
603
756
  .. [#] AttachedToRoof must reference a ``Roof``.
604
757
 
758
+ If UFactor and SHGC are not provided and GlassLayers is not "glass block", additional information is entered in ``Skylight``.
759
+
760
+ ============================ ======== ====== ======================= ======== ======== ========================================================
761
+ Element Type Units Constraints Required Default Notes
762
+ ============================ ======== ====== ======================= ======== ======== ========================================================
763
+ ``FrameType`` element See [#]_ Yes Type of frame
764
+ ``FrameType/*/ThermalBreak`` boolean See [#]_ No false Whether the Aluminum or Metal frame has a thermal break
765
+ ``GlassType`` string See [#]_ No <none> Type of glass
766
+ ``GasFill`` string See [#]_ No See [#]_ Type of gas inside double/triple-pane skylights
767
+ ============================ ======== ====== ======================= ======== ======== ========================================================
768
+
769
+ .. [#] FrameType child element choices are ``Aluminum``, ``Fiberglass``, ``Metal``, ``Vinyl``, or ``Wood``.
770
+ .. [#] ThermalBreak is only valid if FrameType is ``Aluminum`` or ``Metal``.
771
+ .. [#] GlassType choices are "clear", "low-e", "tinted", "tinted/reflective", or "reflective".
772
+ Do not specify this element if the skylight has clear glass.
773
+ .. [#] GasFill choices are "air", "argon", "krypton", "xenon", "nitrogen", or "other".
774
+ .. [#] If GasFill not provided, defaults to "air" for double-pane skylights and "argon" for triple-pane skylights.
775
+
776
+ If UFactor and SHGC are not provided, they are defaulted as follows:
777
+
778
+ =========== ======================= ============ ========================= ============= ======= ====
779
+ GlassLayers FrameType ThermalBreak GlassType GasFill UFactor SHGC
780
+ =========== ======================= ============ ========================= ============= ======= ====
781
+ single-pane Aluminum, Metal false clear -- 1.98 0.75
782
+ single-pane Fiberglass, Vinyl, Wood -- clear -- 1.47 0.64
783
+ single-pane Aluminum, Metal false tinted, tinted/reflective -- 1.98 0.64
784
+ single-pane Fiberglass, Vinyl, Wood -- tinted, tinted/reflective -- 1.47 0.54
785
+ double-pane Aluminum, Metal false clear air 1.30 0.67
786
+ double-pane Aluminum, Metal true clear air 1.10 0.67
787
+ double-pane Fiberglass, Vinyl, Wood -- clear air 0.84 0.56
788
+ double-pane Aluminum, Metal false tinted, tinted/reflective air 1.30 0.55
789
+ double-pane Aluminum, Metal true tinted, tinted/reflective air 1.10 0.55
790
+ double-pane Fiberglass, Vinyl, Wood -- tinted, tinted/reflective air 0.84 0.46
791
+ double-pane Fiberglass, Vinyl, Wood -- low-e air 0.74 0.52
792
+ double-pane Aluminum, Metal true low-e <any but air> 0.95 0.62
793
+ double-pane Fiberglass, Vinyl, Wood -- low-e <any but air> 0.68 0.52
794
+ double-pane Aluminum, Metal false reflective air 1.17 0.37
795
+ double-pane Aluminum, Metal true reflective air 0.98 0.37
796
+ double-pane Fiberglass, Vinyl, Wood -- reflective air 0.71 0.31
797
+ double-pane Fiberglass, Vinyl, Wood -- reflective <any but air> 0.65 0.31
798
+ triple-pane Fiberglass, Vinyl, Wood -- low-e <any but air> 0.47 0.31
799
+ glass block -- -- -- -- 0.60 0.60
800
+ =========== ======================= ============ ========================= ============= ======= ====
801
+
802
+ .. warning::
803
+
804
+ OpenStudio-HPXML will return an error if the combination of skylight properties is not in the above table.
805
+
605
806
  HPXML Doors
606
807
  ***********
607
808
 
608
809
  Each opaque door is entered as an ``/HPXML/Building/BuildingDetails/Enclosure/Doors/Door``.
609
810
 
610
- ============================================ ======== ============ =========== ======== ========= ==============================
611
- Element Type Units Constraints Required Default Notes
612
- ============================================ ======== ============ =========== ======== ========= ==============================
613
- ``SystemIdentifier`` id Yes Unique identifier
614
- ``AttachedToWall`` idref See [#]_ Yes ID of attached wall
615
- ``Area`` double ft2 > 0 Yes Total area
616
- ``Azimuth`` integer deg 0 - 359 Yes Azimuth (clockwise from North)
617
- ``RValue`` double F-ft2-hr/Btu > 0 Yes R-value
618
- ============================================ ======== ============ =========== ======== ========= ==============================
811
+ ============================================ ================= ============ =================== ======== ========= ==============================
812
+ Element Type Units Constraints Required Default Notes
813
+ ============================================ ================= ============ =================== ======== ========= ==============================
814
+ ``SystemIdentifier`` id Yes Unique identifier
815
+ ``AttachedToWall`` idref See [#]_ Yes ID of attached wall
816
+ ``Area`` double ft2 > 0 Yes Total area
817
+ ``Azimuth`` or ``Orientation`` integer or string deg 0 - 359 or See [#]_ No See [#]_ Direction (clockwise from North)
818
+ ``RValue`` double F-ft2-hr/Btu > 0 Yes R-value (including any storm door)
819
+ ============================================ ================= ============ =================== ======== ========= ==============================
619
820
 
620
821
  .. [#] AttachedToWall must reference a ``Wall`` or ``FoundationWall``.
822
+ .. [#] Orientation choices are "northeast", "east", "southeast", "south", "southwest", "west", "northwest", or "north"
823
+ .. [#] If neither Azimuth nor Orientation nor AttachedToWall azimuth provided, defaults to the azimuth with the largest surface area defined in the HPXML file.
824
+
825
+ HPXML Partition Wall Mass
826
+ *************************
827
+
828
+ Partition wall mass in the conditioned space is entered as ``/HPXML/Building/BuildingDetails/Enclosure/extension/PartitionWallMass``.
829
+
830
+ ============================================ ====== ============ =========== ======== ============ =================================================
831
+ Element Type Units Constraints Required Default Notes
832
+ ============================================ ====== ============ =========== ======== ============ =================================================
833
+ ``AreaFraction`` double frac >= 0 No 1.0 Fraction of both sides of wall area to conditioned floor area
834
+ ``InteriorFinish/Type`` string See [#]_ No gypsum board Interior finish material
835
+ ``InteriorFinish/Thickness`` double in >= 0 No 0.5 Interior finish thickness
836
+ ============================================ ====== ============ =========== ======== ============ =================================================
837
+
838
+ .. [#] InteriorFinish/Type choices are "gypsum board", "gypsum composite board", "plaster", "wood", "other", or "none".
839
+
840
+ HPXML Furniture Mass
841
+ ********************
842
+
843
+ Furniture mass in the conditioned space is entered as ``/HPXML/Building/BuildingDetails/Enclosure/extension/FurnitureMass``.
844
+
845
+ ============================================ ====== ============ =========== ======== ============ =================================================
846
+ Element Type Units Constraints Required Default Notes
847
+ ============================================ ====== ============ =========== ======== ============ =================================================
848
+ ``AreaFraction`` double frac >= 0 No 0.4 Fraction of conditioned floor area covered by furniture
849
+ ``Type`` string See [#]_ No light-weight Type of furniture
850
+ ============================================ ====== ============ =========== ======== ============ =================================================
851
+
852
+ .. [#] Type choices are "light-weight" and "heavy-weight".
853
+
854
+ .. note::
855
+
856
+ Light-weight furniture is modeled with a weight of 8 lb/ft2 of floor area and a density of 40 lb/ft3 while heavy-weight furniture is modeled with a weight of 16 lb/ft2 of floor area and a density of 80 lb/ft3.
621
857
 
622
858
  HPXML Systems
623
859
  -------------
@@ -637,14 +873,16 @@ Each heating system (other than a heat pump) is entered as an ``/HPXML/Building/
637
873
  ``SystemIdentifier`` id Yes Unique identifier
638
874
  ``HeatingSystemType`` element 1 [#]_ Yes Type of heating system
639
875
  ``HeatingSystemFuel`` string See [#]_ Yes Fuel type
640
- ``HeatingCapacity`` double Btu/hr >= 0 No autosized Input heating capacity
641
- ``FractionHeatLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of heating load served
876
+ ``HeatingCapacity`` double Btu/hr >= 0 No autosized Heating output capacity
877
+ ``FractionHeatLoadServed`` double frac 0 - 1 [#]_ See [#]_ Fraction of heating load served
642
878
  ================================= ======== ====== =========== ======== ========= ===============================
643
879
 
644
- .. [#] HeatingSystemType child element choices are ``ElectricResistance``, ``Furnace``, ``WallFurnace``, ``FloorFurnace``, ``Boiler``, ``Stove``, ``PortableHeater``, ``FixedHeater``, or ``Fireplace``.
880
+ .. [#] HeatingSystemType child element choices are ``ElectricResistance``, ``Furnace``, ``WallFurnace``, ``FloorFurnace``, ``Boiler``, ``Stove``, ``PortableHeater``, ``FixedHeater``, ``Fireplace``, or ``PackagedTerminalAirConditionerHeating``.
645
881
  .. [#] 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".
646
882
  For ``ElectricResistance``, "electricity" is required.
883
+ For ``PackagedTerminalAirConditionerHeating``, "electricity" is currently the only choice.
647
884
  .. [#] The sum of all ``FractionHeatLoadServed`` (across both HeatingSystems and HeatPumps) must be less than or equal to 1.
885
+ .. [#] 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.
648
886
 
649
887
  Electric Resistance
650
888
  ~~~~~~~~~~~~~~~~~~~
@@ -654,24 +892,38 @@ If electric resistance heating is specified, additional information is entered i
654
892
  ================================================== ====== ===== =========== ======== ======= ==========
655
893
  Element Type Units Constraints Required Default Notes
656
894
  ================================================== ====== ===== =========== ======== ======= ==========
657
- ``AnnualHeatingEfficiency[Units="Percent"]/Value`` double frac 0 - 1 Yes Efficiency
895
+ ``AnnualHeatingEfficiency[Units="Percent"]/Value`` double frac 0 - 1 No 1.0 Efficiency
658
896
  ================================================== ====== ===== =========== ======== ======= ==========
659
897
 
898
+ PTAC Heating
899
+ ~~~~~~~~~~~~
900
+
901
+ If a PTAC with non-heat pump (e.g., electric resistance) heating is specified, additional information is entered in ``HeatingSystem``.
902
+
903
+ ================================================== ====== ========= =========== ======== ======= ==================================
904
+ Element Type Units Constraints Required Default Notes
905
+ ================================================== ====== ========= =========== ======== ======= ==================================
906
+ ``AnnualHeatingEfficiency[Units="Percent"]/Value`` double frac 0 - 1 No 1.0 Efficiency
907
+ ================================================== ====== ========= =========== ======== ======= ==================================
908
+
909
+ .. [#] A cooling system of type "packaged terminal air conditioner" must be specified in ``/HPXML/Building/BuildingDetails/Systems/HVAC/HVACPlant/CoolingSystem``.
910
+
660
911
  Furnace
661
912
  ~~~~~~~
662
913
 
663
914
  If a furnace is specified, additional information is entered in ``HeatingSystem``.
664
915
 
665
- =============================================== ====== ===== =========== ======== ========= ================================================
666
- Element Type Units Constraints Required Default Notes
667
- =============================================== ====== ===== =========== ======== ========= ================================================
668
- ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
669
- ``AnnualHeatingEfficiency[Units="AFUE"]/Value`` double frac 0 - 1 Yes Rated efficiency
670
- ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Fan power [#]_
671
- ``extension/AirflowDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed airflows [#]_
672
- =============================================== ====== ===== =========== ======== ========= ================================================
916
+ ==================================================================== ================= ========= =============== ======== ======== ================================================
917
+ Element Type Units Constraints Required Default Notes
918
+ ==================================================================== ================= ========= =============== ======== ======== ================================================
919
+ ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
920
+ ``AnnualHeatingEfficiency[Units="AFUE"]/Value`` or ``YearInstalled`` double or integer frac or # 0 - 1 or > 1600 Yes See [#]_ Rated efficiency or Year installed
921
+ ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Fan efficiency at maximum airflow rate [#]_
922
+ ``extension/AirflowDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed airflows [#]_
923
+ ==================================================================== ================= ========= =============== ======== ======== ================================================
673
924
 
674
925
  .. [#] HVACDistribution type must be AirDistribution (type: "regular velocity" or "gravity") or DSE.
926
+ .. [#] If AnnualHeatingEfficiency[Units="AFUE"]/Value not provided, defaults to 0.98 if FuelType is "electricity", else AFUE from the lookup table that can be found at ``HPXMLtoOpenStudio\resources\lu_hvac_equipment_efficiency.csv`` based on YearInstalled.
675
927
  .. [#] If FanPowerWattsPerCFM not provided, defaulted to 0 W/cfm if gravity distribution system, else 0.5 W/cfm if AFUE <= 0.9, else 0.375 W/cfm.
676
928
  .. [#] If there is a cooling system attached to the DistributionSystem, the heating and cooling systems cannot have different values for FanPowerWattsPerCFM.
677
929
  .. [#] AirflowDefectRatio is defined as (InstalledAirflow - DesignAirflow) / DesignAirflow; a value of zero means no airflow defect.
@@ -682,12 +934,14 @@ Wall/Floor Furnace
682
934
 
683
935
  If a wall furnace or floor furnace is specified, additional information is entered in ``HeatingSystem``.
684
936
 
685
- =============================================== ====== ===== =========== ======== ======= ===================
686
- Element Type Units Constraints Required Default Notes
687
- =============================================== ====== ===== =========== ======== ======= ===================
688
- ``AnnualHeatingEfficiency[Units="AFUE"]/Value`` double frac 0 - 1 Yes Rated efficiency
689
- ``extension/FanPowerWatts`` double W >= 0 No 0 Fan power
690
- =============================================== ====== ===== =========== ======== ======= ===================
937
+ ==================================================================== ================= ========= =============== ======== ======== ==================================
938
+ Element Type Units Constraints Required Default Notes
939
+ ==================================================================== ================= ========= =============== ======== ======== ==================================
940
+ ``AnnualHeatingEfficiency[Units="AFUE"]/Value`` or ``YearInstalled`` double or integer frac or # 0 - 1 or > 1600 Yes See [#]_ Rated efficiency or Year installed
941
+ ``extension/FanPowerWatts`` double W >= 0 No 0 Fan power
942
+ ==================================================================== ================= ========= =============== ======== ======== ==================================
943
+
944
+ .. [#] If AnnualHeatingEfficiency[Units="AFUE"]/Value not provided, defaults to 0.98 if FuelType is "electricity", else AFUE from the lookup table that can be found at ``HPXMLtoOpenStudio\resources\lu_hvac_equipment_efficiency.csv`` based on YearInstalled.
691
945
 
692
946
  .. _hvac_heating_boiler:
693
947
 
@@ -696,17 +950,19 @@ Boiler
696
950
 
697
951
  If a boiler is specified, additional information is entered in ``HeatingSystem``.
698
952
 
699
- ========================================================================== ======== ====== =========== ======== ======== =========================================
700
- Element Type Units Constraints Required Default Notes
701
- ========================================================================== ======== ====== =========== ======== ======== =========================================
702
- ``IsSharedSystem`` boolean No false Whether it serves multiple dwelling units
703
- ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
704
- ``AnnualHeatingEfficiency[Units="AFUE"]/Value`` double frac 0 - 1 Yes Rated efficiency
705
- ========================================================================== ======== ====== =========== ======== ======== =========================================
953
+ ==================================================================== ================= ========= =============== ======== ======== =========================================
954
+ Element Type Units Constraints Required Default Notes
955
+ ==================================================================== ================= ========= =============== ======== ======== =========================================
956
+ ``IsSharedSystem`` boolean No false Whether it serves multiple dwelling units
957
+ ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
958
+ ``AnnualHeatingEfficiency[Units="AFUE"]/Value`` or ``YearInstalled`` double or integer frac or # 0 - 1 or > 1600 Yes See [#]_ Rated efficiency or Year installed
959
+ ==================================================================== ================= ========= =============== ======== ======== =========================================
706
960
 
707
- .. [#] For in-unit boilers, HVACDistribution type must be HydronicDistribution (type: "radiator", "baseboard", "radiant floor", "radiant ceiling", or "water loop") or DSE.
961
+ .. [#] For in-unit boilers, HVACDistribution type must be HydronicDistribution (type: "radiator", "baseboard", "radiant floor", or "radiant ceiling") or DSE.
708
962
  For shared boilers, HVACDistribution type must be HydronicDistribution (type: "radiator", "baseboard", "radiant floor", "radiant ceiling", or "water loop") or AirDistribution (type: "fan coil").
709
963
  If the shared boiler has "water loop" distribution, a :ref:`hvac_heatpump_wlhp` must also be specified.
964
+ .. [#] If AnnualHeatingEfficiency[Units="AFUE"]/Value not provided, defaults to 0.98 if FuelType is "electricity", else AFUE from the lookup table that can be found at ``HPXMLtoOpenStudio\resources\lu_hvac_equipment_efficiency.csv`` based on YearInstalled.
965
+
710
966
 
711
967
  If an in-unit boiler if specified, additional information is entered in ``HeatingSystem``.
712
968
 
@@ -747,10 +1003,12 @@ If a stove is specified, additional information is entered in ``HeatingSystem``.
747
1003
  ================================================== ====== ===== =========== ======== ========= ===================
748
1004
  Element Type Units Constraints Required Default Notes
749
1005
  ================================================== ====== ===== =========== ======== ========= ===================
750
- ``AnnualHeatingEfficiency[Units="Percent"]/Value`` double frac 0 - 1 Yes Efficiency
1006
+ ``AnnualHeatingEfficiency[Units="Percent"]/Value`` double frac 0 - 1 No See [#]_ Efficiency
751
1007
  ``extension/FanPowerWatts`` double W >= 0 No 40 Fan power
752
1008
  ================================================== ====== ===== =========== ======== ========= ===================
753
1009
 
1010
+ .. [#] Defaulted to 1.0 if FuelType is "electricity", 0.60 if FuelType is "wood", 0.78 if FuelType is "wood pellets", otherwise 0.81.
1011
+
754
1012
  Portable/Fixed Heater
755
1013
  ~~~~~~~~~~~~~~~~~~~~~
756
1014
 
@@ -759,10 +1017,12 @@ If a portable heater or fixed heater is specified, additional information is ent
759
1017
  ================================================== ====== ===== =========== ======== ========= ===================
760
1018
  Element Type Units Constraints Required Default Notes
761
1019
  ================================================== ====== ===== =========== ======== ========= ===================
762
- ``AnnualHeatingEfficiency[Units="Percent"]/Value`` double frac 0 - 1 Yes Efficiency
1020
+ ``AnnualHeatingEfficiency[Units="Percent"]/Value`` double frac 0 - 1 No See [#]_ Efficiency
763
1021
  ``extension/FanPowerWatts`` double W >= 0 No 0 Fan power
764
1022
  ================================================== ====== ===== =========== ======== ========= ===================
765
1023
 
1024
+ .. [#] Defaulted to 1.0 if FuelType is "electricity", 0.60 if FuelType is "wood", 0.78 if FuelType is "wood pellets", otherwise 0.81.
1025
+
766
1026
  Fireplace
767
1027
  ~~~~~~~~~
768
1028
 
@@ -771,10 +1031,12 @@ If a fireplace is specified, additional information is entered in ``HeatingSyste
771
1031
  ================================================== ====== ===== =========== ======== ========= ===================
772
1032
  Element Type Units Constraints Required Default Notes
773
1033
  ================================================== ====== ===== =========== ======== ========= ===================
774
- ``AnnualHeatingEfficiency[Units="Percent"]/Value`` double frac 0 - 1 Yes Efficiency
1034
+ ``AnnualHeatingEfficiency[Units="Percent"]/Value`` double frac 0 - 1 No See [#]_ Efficiency
775
1035
  ``extension/FanPowerWatts`` double W >= 0 No 0 Fan power
776
1036
  ================================================== ====== ===== =========== ======== ========= ===================
777
1037
 
1038
+ .. [#] Defaulted to 1.0 if FuelType is "electricity", 0.60 if FuelType is "wood", 0.78 if FuelType is "wood pellets", otherwise 0.81.
1039
+
778
1040
  .. _hvac_cooling:
779
1041
 
780
1042
  HPXML Cooling Systems
@@ -791,7 +1053,7 @@ Each cooling system (other than a heat pump) is entered as an ``/HPXML/Building/
791
1053
  ``FractionCoolLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of cooling load served
792
1054
  ========================== ======== ====== =========== ======== ======= ===============================
793
1055
 
794
- .. [#] CoolingSystemType choices are "central air conditioner", "room air conditioner", "evaporative cooler", "mini-split", "chiller", or "cooling tower".
1056
+ .. [#] CoolingSystemType choices are "central air conditioner", "room air conditioner", "evaporative cooler", "mini-split", "chiller", "cooling tower", or "packaged terminal air conditioner".
795
1057
  .. [#] CoolingSystemFuel only choice is "electricity".
796
1058
  .. [#] The sum of all ``FractionCoolLoadServed`` (across both CoolingSystems and HeatPumps) must be less than or equal to 1.
797
1059
 
@@ -800,20 +1062,21 @@ Central Air Conditioner
800
1062
 
801
1063
  If a central air conditioner is specified, additional information is entered in ``CoolingSystem``.
802
1064
 
803
- =============================================== ======== ====== =========== ======== ========= ================================================
804
- Element Type Units Constraints Required Default Notes
805
- =============================================== ======== ====== =========== ======== ========= ================================================
806
- ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
807
- ``AnnualCoolingEfficiency[Units="SEER"]/Value`` double Btu/Wh > 0 Yes Rated efficiency
808
- ``CoolingCapacity`` double Btu/hr >= 0 No autosized Cooling capacity
809
- ``SensibleHeatFraction`` double frac 0 - 1 No Sensible heat fraction
810
- ``CompressorType`` string See [#]_ No See [#]_ Type of compressor
811
- ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Fan power [#]_
812
- ``extension/AirflowDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed airflows [#]_
813
- ``extension/ChargeDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed charges [#]_
814
- =============================================== ======== ====== =========== ======== ========= ================================================
1065
+ ==================================================================== ================= =========== =============== ======== ========= ================================================
1066
+ Element Type Units Constraints Required Default Notes
1067
+ ==================================================================== ================= =========== =============== ======== ========= ================================================
1068
+ ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
1069
+ ``AnnualCoolingEfficiency[Units="SEER"]/Value`` or ``YearInstalled`` double or integer Btu/Wh or # > 0 or > 1600 Yes See [#]_ Rated efficiency or Year installed
1070
+ ``CoolingCapacity`` double Btu/hr >= 0 No autosized Cooling output capacity
1071
+ ``SensibleHeatFraction`` double frac 0 - 1 No Sensible heat fraction
1072
+ ``CompressorType`` string See [#]_ No See [#]_ Type of compressor
1073
+ ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Fan efficiency at maximum airflow rate [#]_
1074
+ ``extension/AirflowDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed airflows [#]_
1075
+ ``extension/ChargeDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed charges [#]_
1076
+ ==================================================================== ================= =========== =============== ======== ========= ================================================
815
1077
 
816
1078
  .. [#] HVACDistribution type must be AirDistribution (type: "regular velocity") or DSE.
1079
+ .. [#] If AnnualCoolingEfficiency[Units="SEER"]/Value not provided, defaults to SEER from the lookup table that can be found at ``HPXMLtoOpenStudio\resources\lu_hvac_equipment_efficiency.csv`` based on YearInstalled.
817
1080
  .. [#] CompressorType choices are "single stage", "two stage", or "variable speed".
818
1081
  .. [#] If CompressorType not provided, defaults to "single stage" if SEER <= 15, else "two stage" if SEER <= 21, else "variable speed".
819
1082
  .. [#] 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.
@@ -821,6 +1084,7 @@ If a central air conditioner is specified, additional information is entered in
821
1084
  .. [#] AirflowDefectRatio is defined as (InstalledAirflow - DesignAirflow) / DesignAirflow; a value of zero means no airflow defect.
822
1085
  See ANSI/RESNET/ACCA 310-2020 Standard for Grading the Installation of HVAC Systems for more information.
823
1086
  .. [#] ChargeDefectRatio is defined as (InstalledCharge - DesignCharge) / DesignCharge; a value of zero means no refrigerant charge defect.
1087
+ A non-zero charge defect should typically only be applied for systems that are pre-charged on site.
824
1088
  See ANSI/RESNET/ACCA 310-2020 Standard for Grading the Installation of HVAC Systems for more information.
825
1089
 
826
1090
  Room Air Conditioner
@@ -828,13 +1092,28 @@ Room Air Conditioner
828
1092
 
829
1093
  If a room air conditioner is specified, additional information is entered in ``CoolingSystem``.
830
1094
 
831
- ============================================== ======== ====== =========== ======== ========= ======================
832
- Element Type Units Constraints Required Default Notes
833
- ============================================== ======== ====== =========== ======== ========= ======================
834
- ``AnnualCoolingEfficiency[Units="EER"]/Value`` double Btu/Wh > 0 Yes Rated efficiency
835
- ``CoolingCapacity`` double Btu/hr >= 0 No autosized Cooling capacity
836
- ``SensibleHeatFraction`` double frac 0 - 1 No Sensible heat fraction
837
- ============================================== ======== ====== =========== ======== ========= ======================
1095
+ =================================================================================== ================= =========== =============== ======== ========= ==================================
1096
+ Element Type Units Constraints Required Default Notes
1097
+ =================================================================================== ================= =========== =============== ======== ========= ==================================
1098
+ ``AnnualCoolingEfficiency[Units="EER" or Units="CEER"]/Value`` or ``YearInstalled`` double or integer Btu/Wh or # > 0 or > 1600 Yes See [#]_ Rated efficiency or Year installed
1099
+ ``CoolingCapacity`` double Btu/hr >= 0 No autosized Cooling output capacity
1100
+ ``SensibleHeatFraction`` double frac 0 - 1 No Sensible heat fraction
1101
+ =================================================================================== ================= =========== =============== ======== ========= ==================================
1102
+
1103
+ .. [#] If AnnualCoolingEfficiency[Units="EER" or Units="CEER"]/Value not provided, defaults to EER from the lookup table that can be found at ``HPXMLtoOpenStudio\resources\lu_hvac_equipment_efficiency.csv`` based on YearInstalled.
1104
+
1105
+ Packaged Terminal Air Conditioner
1106
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1107
+
1108
+ If a PTAC is specified, additional information is entered in ``CoolingSystem``.
1109
+
1110
+ =================================================================== ================= =========== =============== ======== ========= ==================================
1111
+ Element Type Units Constraints Required Default Notes
1112
+ =================================================================== ================= =========== =============== ======== ========= ==================================
1113
+ ``AnnualCoolingEfficiency[Units="EER" or Units="CEER"]/Value`` integer or double # or Btu/Wh > 1600 or > 0 Yes Rated efficiency
1114
+ ``CoolingCapacity`` double Btu/hr >= 0 No autosized Cooling output capacity
1115
+ ``SensibleHeatFraction`` double frac 0 - 1 No Sensible heat fraction
1116
+ =================================================================== ================= =========== =============== ======== ========= ==================================
838
1117
 
839
1118
  Evaporative Cooler
840
1119
  ~~~~~~~~~~~~~~~~~~
@@ -845,7 +1124,7 @@ If an evaporative cooler is specified, additional information is entered in ``Co
845
1124
  Element Type Units Constraints Required Default Notes
846
1125
  ================================= ======== ====== =========== ======== ========= ==================================
847
1126
  ``DistributionSystem`` idref See [#]_ No ID of attached distribution system
848
- ``CoolingCapacity`` double Btu/hr >= 0 No autosized Cooling capacity
1127
+ ``CoolingCapacity`` double Btu/hr >= 0 No autosized Cooling output capacity
849
1128
  ================================= ======== ====== =========== ======== ========= ==================================
850
1129
 
851
1130
  .. [#] If provided, HVACDistribution type must be AirDistribution (type: "regular velocity") or DSE.
@@ -860,25 +1139,20 @@ If a mini-split is specified, additional information is entered in ``CoolingSyst
860
1139
  =============================================== ======== ====== =========== ======== ========= ===============================================
861
1140
  ``DistributionSystem`` idref See [#]_ No ID of attached distribution system
862
1141
  ``AnnualCoolingEfficiency[Units="SEER"]/Value`` double Btu/Wh > 0 Yes Rated cooling efficiency
863
- ``CoolingCapacity`` double Btu/hr >= 0 No autosized Cooling capacity
1142
+ ``CoolingCapacity`` double Btu/hr >= 0 No autosized Cooling output capacity
864
1143
  ``SensibleHeatFraction`` double frac 0 - 1 No Sensible heat fraction
1144
+ ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Fan efficiency at maximum airflow rate
1145
+ ``extension/AirflowDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed airflows [#]_
865
1146
  ``extension/ChargeDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed charges [#]_
866
1147
  =============================================== ======== ====== =========== ======== ========= ===============================================
867
1148
 
868
1149
  .. [#] If provided, HVACDistribution type must be AirDistribution (type: "regular velocity") or DSE.
869
- .. [#] ChargeDefectRatio is defined as (InstalledCharge - DesignCharge) / DesignCharge; a value of zero means no refrigerant charge defect.
870
- See ANSI/RESNET/ACCA 310-2020 Standard for Grading the Installation of HVAC Systems for more information.
871
-
872
- If a ducted mini-split is specified (i.e., a ``DistributionSystem`` has been entered), additional information is entered in ``CoolingSystem``.
873
-
874
- ================================= ======== ====== =========== ======== ========= ===============================================
875
- Element Type Units Constraints Required Default Notes
876
- ================================= ======== ====== =========== ======== ========= ===============================================
877
- ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No 0.18 Fan power
878
- ``extension/AirflowDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed airflows [#]_
879
- ================================= ======== ====== =========== ======== ========= ===============================================
880
-
1150
+ .. [#] FanPowerWattsPerCFM defaults to 0.07 W/cfm for ductless systems and 0.18 W/cfm for ducted systems.
881
1151
  .. [#] AirflowDefectRatio is defined as (InstalledAirflow - DesignAirflow) / DesignAirflow; a value of zero means no airflow defect.
1152
+ A non-zero airflow defect should typically only be applied for systems attached to ducts.
1153
+ See ANSI/RESNET/ACCA 310-2020 Standard for Grading the Installation of HVAC Systems for more information.
1154
+ .. [#] ChargeDefectRatio is defined as (InstalledCharge - DesignCharge) / DesignCharge; a value of zero means no refrigerant charge defect.
1155
+ A non-zero charge defect should typically only be applied for systems that are pre-charged on site.
882
1156
  See ANSI/RESNET/ACCA 310-2020 Standard for Grading the Installation of HVAC Systems for more information.
883
1157
 
884
1158
  .. _hvac_cooling_chiller:
@@ -894,7 +1168,7 @@ If a chiller is specified, additional information is entered in ``CoolingSystem`
894
1168
  ``IsSharedSystem`` boolean true Yes Whether it serves multiple dwelling units
895
1169
  ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
896
1170
  ``NumberofUnitsServed`` integer > 1 Yes Number of dwelling units served
897
- ``CoolingCapacity`` double Btu/hr >= 0 Yes Total cooling capacity
1171
+ ``CoolingCapacity`` double Btu/hr >= 0 Yes Total cooling output capacity
898
1172
  ``AnnualCoolingEfficiency[Units="kW/ton"]/Value`` double kW/ton > 0 Yes Rated efficiency
899
1173
  ``extension/SharedLoopWatts`` double W >= 0 Yes Pumping and fan power serving the system
900
1174
  ``extension/FanCoilWatts`` double W >= 0 See [#]_ Fan coil power
@@ -944,58 +1218,85 @@ Each heat pump is entered as an ``/HPXML/Building/BuildingDetails/Systems/HVAC/H
944
1218
  ``SystemIdentifier`` id Yes Unique identifier
945
1219
  ``HeatPumpType`` string See [#]_ Yes Type of heat pump
946
1220
  ``HeatPumpFuel`` string See [#]_ Yes Fuel type
947
- ``BackupSystemFuel`` string See [#]_ No Fuel type of backup heating, if present
1221
+ ``BackupType`` string See [#]_ No <none> Type of backup heating
948
1222
  ================================= ======== ====== =========== ======== ========= ===============================================
949
1223
 
950
- .. [#] HeatPumpType choices are "air-to-air", "mini-split", "ground-to-air", or "water-loop-to-air".
1224
+ .. [#] HeatPumpType choices are "air-to-air", "mini-split", "ground-to-air", "water-loop-to-air", or "packaged terminal heat pump".
951
1225
  .. [#] HeatPumpFuel only choice is "electricity".
952
- .. [#] BackupSystemFuel 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".
1226
+ .. [#] BackupType choices are "integrated" or "separate".
1227
+ 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).
1228
+ Use "separate" if the backup system has its own distribution system (e.g., electric baseboard or a boiler).
953
1229
 
954
- If a backup system fuel is provided, additional information is entered in ``HeatPump``.
1230
+ If a backup type of "integrated" is provided, additional information is entered in ``HeatPump``.
955
1231
 
956
1232
  ======================================================================== ======== ====== =========== ======== ========= ==========================================
957
1233
  Element Type Units Constraints Required Default Notes
958
1234
  ======================================================================== ======== ====== =========== ======== ========= ==========================================
959
- ``BackupAnnualHeatingEfficiency[Units="Percent" or Units="AFUE"]/Value`` double frac 0 - 1 Yes Backup heating efficiency
960
- ``BackupHeatingCapacity`` double Btu/hr >= 0 No autosized Backup heating capacity
961
- ``BackupHeatingSwitchoverTemperature`` double F No <none> Backup heating switchover temperature [#]_
1235
+ ``BackupSystemFuel`` string See [#]_ Yes Integrated backup heating fuel type
1236
+ ``BackupAnnualHeatingEfficiency[Units="Percent" or Units="AFUE"]/Value`` double frac 0 - 1 Yes Integrated backup heating efficiency
1237
+ ``BackupHeatingCapacity`` double Btu/hr >= 0 No autosized Integrated backup heating output capacity
1238
+ ``BackupHeatingSwitchoverTemperature`` double F No <none> Integrated backup heating switchover temperature [#]_
962
1239
  ======================================================================== ======== ====== =========== ======== ========= ==========================================
963
1240
 
964
- .. [#] Provide BackupHeatingSwitchoverTemperature for, e.g., a dual-fuel heat pump, in which there is a discrete outdoor temperature when the heat pump stops operating and the backup heating system starts operating.
965
- If not provided, the backup heating system will operate as needed when the heat pump has insufficient capacity.
1241
+ .. [#] BackupSystemFuel 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".
1242
+ .. [#] Provide BackupHeatingSwitchoverTemperature for a situation in which there is a discrete outdoor temperature when the heat pump stops operating and the backup heating system starts operating.
1243
+ If not provided, the backup heating system will operate as needed for hours when the heat pump has insufficient capacity.
1244
+
1245
+ If a backup type of "separate" is provided, additional information is entered in ``HeatPump``.
1246
+
1247
+ ====================================== ======== ====== =========== ======== ========= ==========================================
1248
+ Element Type Units Constraints Required Default Notes
1249
+ ====================================== ======== ====== =========== ======== ========= ==========================================
1250
+ ``BackupSystem`` idref See [#]_ Yes ID of separate backup heating system
1251
+ ``BackupHeatingSwitchoverTemperature`` double F No <none> Separate backup heating system switchover temperature [#]_
1252
+ ====================================== ======== ====== =========== ======== ========= ==========================================
1253
+
1254
+ .. [#] HeatingSystem must be of type ``ElectricResistance``, ``WallFurnace``, ``FloorFurnace``, ``Boiler``, ``Stove``, ``PortableHeater``, ``FixedHeater``, or ``Fireplace``.
1255
+ .. [#] Provide BackupHeatingSwitchoverTemperature for a situation in which there is a discrete outdoor temperature when the heat pump stops operating and the backup heating system starts operating.
1256
+ If not provided, the backup heating system will operate as needed for hours when the heat pump has insufficient capacity.
1257
+
1258
+ .. note::
1259
+
1260
+ Due to how the separate backup heating system is modeled in EnergyPlus, there are a few restrictions:
1261
+
1262
+ - The conditioned space cannot be partially heated (i.e., the sum of all ``FractionHeatLoadServed`` must be 1).
1263
+ - There cannot be multiple backup heating systems.
966
1264
 
967
1265
  Air-to-Air Heat Pump
968
1266
  ~~~~~~~~~~~~~~~~~~~~
969
1267
 
970
1268
  If an air-to-air heat pump is specified, additional information is entered in ``HeatPump``.
971
1269
 
972
- =============================================== ======== ====== =========== ======== ========= ================================================
973
- Element Type Units Constraints Required Default Notes
974
- =============================================== ======== ====== =========== ======== ========= ================================================
975
- ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
976
- ``CompressorType`` string See [#]_ No See [#]_ Type of compressor
977
- ``HeatingCapacity`` double Btu/hr >= 0 No autosized Heating capacity (excluding any backup heating)
978
- ``HeatingCapacity17F`` double Btu/hr >= 0 No Heating capacity at 17F, if available
979
- ``CoolingCapacity`` double Btu/hr >= 0 No autosized Cooling capacity
980
- ``CoolingSensibleHeatFraction`` double frac 0 - 1 No Sensible heat fraction
981
- ``FractionHeatLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of heating load served
982
- ``FractionCoolLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of cooling load served
983
- ``AnnualCoolingEfficiency[Units="SEER"]/Value`` double Btu/Wh > 0 Yes Rated cooling efficiency
984
- ``AnnualHeatingEfficiency[Units="HSPF"]/Value`` double Btu/Wh > 0 Yes Rated heating efficiency
985
- ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Fan power
986
- ``extension/AirflowDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed airflows [#]_
987
- ``extension/ChargeDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed charges [#]_
988
- =============================================== ======== ====== =========== ======== ========= ================================================
1270
+ ==================================================================== ================= =========== ======================== ======== ========= =================================================
1271
+ Element Type Units Constraints Required Default Notes
1272
+ ==================================================================== ================= =========== ======================== ======== ========= =================================================
1273
+ ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
1274
+ ``CompressorType`` string See [#]_ No See [#]_ Type of compressor
1275
+ ``HeatingCapacity`` double Btu/hr >= 0 No autosized Heating output capacity (excluding any backup heating)
1276
+ ``HeatingCapacity17F`` double Btu/hr >= 0, <= HeatingCapacity No Heating output capacity at 17F, if available
1277
+ ``CoolingCapacity`` double Btu/hr >= 0 No autosized Cooling output capacity
1278
+ ``CoolingSensibleHeatFraction`` double frac 0 - 1 No Sensible heat fraction
1279
+ ``FractionHeatLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of heating load served
1280
+ ``FractionCoolLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of cooling load served
1281
+ ``AnnualCoolingEfficiency[Units="SEER"]/Value`` or ``YearInstalled`` double or integer Btu/Wh or # > 0 or > 1600 Yes See [#]_ Rated cooling efficiency or Year installed
1282
+ ``AnnualHeatingEfficiency[Units="HSPF"]/Value`` or ``YearInstalled`` double or integer Btu/Wh or # > 0 or > 1600 Yes See [#]_ Rated heating efficiency or Year installed
1283
+ ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Fan efficiency at maximum airflow rate
1284
+ ``extension/AirflowDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed airflows [#]_
1285
+ ``extension/ChargeDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed charges [#]_
1286
+ ==================================================================== ================= =========== ======================== ======== ========= =================================================
989
1287
 
990
1288
  .. [#] HVACDistribution type must be AirDistribution (type: "regular velocity") or DSE.
991
1289
  .. [#] CompressorType choices are "single stage", "two stage", or "variable speed".
992
1290
  .. [#] If CompressorType not provided, defaults to "single stage" if SEER <= 15, else "two stage" if SEER <= 21, else "variable speed".
993
1291
  .. [#] The sum of all ``FractionHeatLoadServed`` (across both HeatingSystems and HeatPumps) must be less than or equal to 1.
994
1292
  .. [#] The sum of all ``FractionCoolLoadServed`` (across both CoolingSystems and HeatPumps) must be less than or equal to 1.
1293
+ .. [#] If AnnualCoolingEfficiency[Units="SEER"]/Value not provided, defaults to SEER from the lookup table that can be found at ``HPXMLtoOpenStudio\resources\lu_hvac_equipment_efficiency.csv`` based on YearInstalled.
1294
+ .. [#] If AnnualHeatingEfficiency[Units="HSPF"]/Value not provided, defaults to HSPF from the lookup table that can be found at ``HPXMLtoOpenStudio\resources\lu_hvac_equipment_efficiency.csv`` based on YearInstalled.
995
1295
  .. [#] If FanPowerWattsPerCFM not provided, defaulted to 0.5 W/cfm if HSPF <= 8.75, else 0.375 W/cfm.
996
1296
  .. [#] AirflowDefectRatio is defined as (InstalledAirflow - DesignAirflow) / DesignAirflow; a value of zero means no airflow defect.
997
1297
  See ANSI/RESNET/ACCA 310-2020 Standard for Grading the Installation of HVAC Systems for more information.
998
1298
  .. [#] ChargeDefectRatio is defined as (InstalledCharge - DesignCharge) / DesignCharge; a value of zero means no refrigerant charge defect.
1299
+ A non-zero charge defect should typically only be applied for systems that are pre-charged on site.
999
1300
  See ANSI/RESNET/ACCA 310-2020 Standard for Grading the Installation of HVAC Systems for more information.
1000
1301
 
1001
1302
  Mini-Split Heat Pump
@@ -1003,38 +1304,53 @@ Mini-Split Heat Pump
1003
1304
 
1004
1305
  If a mini-split heat pump is specified, additional information is entered in ``HeatPump``.
1005
1306
 
1006
- =============================================== ======== ====== =========== ======== ========= ==============================================
1007
- Element Type Units Constraints Required Default Notes
1008
- =============================================== ======== ====== =========== ======== ========= ==============================================
1009
- ``DistributionSystem`` idref See [#]_ No ID of attached distribution system, if present
1010
- ``HeatingCapacity`` double Btu/hr >= 0 No autosized Heating capacity (excluding any backup heating)
1011
- ``HeatingCapacity17F`` double Btu/hr >= 0 No Heating capacity at 17F, if available
1012
- ``CoolingCapacity`` double Btu/hr >= 0 No autosized Cooling capacity
1013
- ``CoolingSensibleHeatFraction`` double frac 0 - 1 No Sensible heat fraction
1014
- ``FractionHeatLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of heating load served
1015
- ``FractionCoolLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of cooling load served
1016
- ``AnnualCoolingEfficiency[Units="SEER"]/Value`` double Btu/Wh > 0 Yes Rated cooling efficiency
1017
- ``AnnualHeatingEfficiency[Units="HSPF"]/Value`` double Btu/Wh > 0 Yes Rated heating efficiency
1018
- ``extension/ChargeDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed charges [#]_
1019
- =============================================== ======== ====== =========== ======== ========= ==============================================
1307
+ =============================================== ======== ====== ======================== ======== ========= ==============================================
1308
+ Element Type Units Constraints Required Default Notes
1309
+ =============================================== ======== ====== ======================== ======== ========= ==============================================
1310
+ ``DistributionSystem`` idref See [#]_ No ID of attached distribution system, if present
1311
+ ``HeatingCapacity`` double Btu/hr >= 0 No autosized Heating output capacity (excluding any backup heating)
1312
+ ``HeatingCapacity17F`` double Btu/hr >= 0, <= HeatingCapacity No Heating output capacity at 17F, if available
1313
+ ``CoolingCapacity`` double Btu/hr >= 0 No autosized Cooling output capacity
1314
+ ``CoolingSensibleHeatFraction`` double frac 0 - 1 No Sensible heat fraction
1315
+ ``FractionHeatLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of heating load served
1316
+ ``FractionCoolLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of cooling load served
1317
+ ``AnnualCoolingEfficiency[Units="SEER"]/Value`` double Btu/Wh > 0 Yes Rated cooling efficiency
1318
+ ``AnnualHeatingEfficiency[Units="HSPF"]/Value`` double Btu/Wh > 0 Yes Rated heating efficiency
1319
+ ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Fan efficiency at maximum airflow rate
1320
+ ``extension/AirflowDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed airflows [#]_
1321
+ ``extension/ChargeDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed charges [#]_
1322
+ =============================================== ======== ====== ======================== ======== ========= ==============================================
1020
1323
 
1021
1324
  .. [#] If provided, HVACDistribution type must be AirDistribution (type: "regular velocity") or DSE.
1022
1325
  .. [#] The sum of all ``FractionHeatLoadServed`` (across both HeatingSystems and HeatPumps) must be less than or equal to 1.
1023
1326
  .. [#] The sum of all ``FractionCoolLoadServed`` (across both CoolingSystems and HeatPumps) must be less than or equal to 1.
1327
+ .. [#] FanPowerWattsPerCFM defaults to 0.07 W/cfm for ductless systems and 0.18 W/cfm for ducted systems.
1328
+ .. [#] AirflowDefectRatio is defined as (InstalledAirflow - DesignAirflow) / DesignAirflow; a value of zero means no airflow defect.
1329
+ A non-zero airflow defect should typically only be applied for systems attached to ducts.
1330
+ See ANSI/RESNET/ACCA 310-2020 Standard for Grading the Installation of HVAC Systems for more information.
1024
1331
  .. [#] ChargeDefectRatio is defined as (InstalledCharge - DesignCharge) / DesignCharge; a value of zero means no refrigerant charge defect.
1332
+ A non-zero charge defect should typically only be applied for systems that are pre-charged on site.
1025
1333
  See ANSI/RESNET/ACCA 310-2020 Standard for Grading the Installation of HVAC Systems for more information.
1026
1334
 
1027
- If a ducted mini-split is specified (i.e., a ``DistributionSystem`` has been entered), additional information is entered in ``HeatPump``.
1335
+ Packaged Terminal Heat Pump
1336
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
1028
1337
 
1029
- ================================= ======== ====== =========== ======== ========= ===============================================
1030
- Element Type Units Constraints Required Default Notes
1031
- ================================= ======== ====== =========== ======== ========= ===============================================
1032
- ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No 0.18 Fan power
1033
- ``extension/AirflowDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed airflows [#]_
1034
- ================================= ======== ====== =========== ======== ========= ===============================================
1338
+ If a packaged terminal heat pump is specified, additional information is entered in ``HeatPump``.
1035
1339
 
1036
- .. [#] AirflowDefectRatio is defined as (InstalledAirflow - DesignAirflow) / DesignAirflow; a value of zero means no airflow defect.
1037
- See ANSI/RESNET/ACCA 310-2020 Standard for Grading the Installation of HVAC Systems for more information.
1340
+ =============================================================== ======== ====== =========== ======== ========= ==============================================
1341
+ Element Type Units Constraints Required Default Notes
1342
+ =============================================================== ======== ====== =========== ======== ========= ==============================================
1343
+ ``HeatingCapacity`` double Btu/hr >= 0 No autosized Heating output capacity (excluding any backup heating)
1344
+ ``CoolingCapacity`` double Btu/hr >= 0 No autosized Cooling output capacity
1345
+ ``CoolingSensibleHeatFraction`` double frac 0 - 1 No Sensible heat fraction
1346
+ ``FractionHeatLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of heating load served
1347
+ ``FractionCoolLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of cooling load served
1348
+ ``AnnualCoolingEfficiency[Units="EER" or Units="CEER"]/Value`` double Btu/Wh > 0 Yes Rated cooling efficiency
1349
+ ``AnnualHeatingEfficiency[Units="COP"]/Value`` double Btu/Wh > 0 Yes Rated heating efficiency
1350
+ =============================================================== ======== ====== =========== ======== ========= ==============================================
1351
+
1352
+ .. [#] The sum of all ``FractionHeatLoadServed`` (across both HeatingSystems and HeatPumps) must be less than or equal to 1.
1353
+ .. [#] The sum of all ``FractionCoolLoadServed`` (across both CoolingSystems and HeatPumps) must be less than or equal to 1.
1038
1354
 
1039
1355
  Ground-to-Air Heat Pump
1040
1356
  ~~~~~~~~~~~~~~~~~~~~~~~
@@ -1046,8 +1362,8 @@ If a ground-to-air heat pump is specified, additional information is entered in
1046
1362
  =============================================== ======== ====== =========== ======== ========= ==============================================
1047
1363
  ``IsSharedSystem`` boolean No false Whether it has a shared hydronic circulation loop [#]_
1048
1364
  ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
1049
- ``HeatingCapacity`` double Btu/hr >= 0 No autosized Heating capacity (excluding any backup heating)
1050
- ``CoolingCapacity`` double Btu/hr >= 0 No autosized Cooling capacity
1365
+ ``HeatingCapacity`` double Btu/hr >= 0 No autosized Heating output capacity (excluding any backup heating)
1366
+ ``CoolingCapacity`` double Btu/hr >= 0 No autosized Cooling output capacity
1051
1367
  ``CoolingSensibleHeatFraction`` double frac 0 - 1 No Sensible heat fraction
1052
1368
  ``FractionHeatLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of heating load served
1053
1369
  ``FractionCoolLoadServed`` double frac 0 - 1 [#]_ Yes Fraction of cooling load served
@@ -1056,9 +1372,9 @@ If a ground-to-air heat pump is specified, additional information is entered in
1056
1372
  ``NumberofUnitsServed`` integer > 0 See [#]_ Number of dwelling units served
1057
1373
  ``extension/PumpPowerWattsPerTon`` double W/ton >= 0 No See [#]_ Pump power [#]_
1058
1374
  ``extension/SharedLoopWatts`` double W >= 0 See [#]_ Shared pump power [#]_
1059
- ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Fan power
1375
+ ``extension/FanPowerWattsPerCFM`` double W/cfm >= 0 No See [#]_ Fan efficiency at maximum airflow rate
1060
1376
  ``extension/AirflowDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed airflows [#]_
1061
- ``extension/ChargeDefectRatio`` double frac 0.0 [#]_ No 0.0 Deviation between design/installed charges [#]_
1377
+ ``extension/ChargeDefectRatio`` double frac > -1 No 0.0 Deviation between design/installed charges [#]_
1062
1378
  =============================================== ======== ====== =========== ======== ========= ==============================================
1063
1379
 
1064
1380
  .. [#] IsSharedSystem should be true if the SFA/MF building has multiple ground source heat pumps connected to a shared hydronic circulation loop.
@@ -1074,8 +1390,8 @@ If a ground-to-air heat pump is specified, additional information is entered in
1074
1390
  .. [#] If FanPowerWattsPerCFM not provided, defaulted to 0.5 W/cfm if COP <= 8.75/3.2, else 0.375 W/cfm.
1075
1391
  .. [#] AirflowDefectRatio is defined as (InstalledAirflow - DesignAirflow) / DesignAirflow; a value of zero means no airflow defect.
1076
1392
  See ANSI/RESNET/ACCA 310-2020 Standard for Grading the Installation of HVAC Systems for more information.
1077
- .. [#] ChargeDefectRatio currently constrained to zero for ground-to-air heat pumps due to an EnergyPlus limitation; this constraint will be relaxed in the future.
1078
1393
  .. [#] ChargeDefectRatio is defined as (InstalledCharge - DesignCharge) / DesignCharge; a value of zero means no refrigerant charge defect.
1394
+ A non-zero charge defect should typically only be applied for systems that are pre-charged on site.
1079
1395
  See ANSI/RESNET/ACCA 310-2020 Standard for Grading the Installation of HVAC Systems for more information.
1080
1396
 
1081
1397
  .. _hvac_heatpump_wlhp:
@@ -1089,8 +1405,8 @@ If a water-loop-to-air heat pump is specified, additional information is entered
1089
1405
  Element Type Units Constraints Required Default Notes
1090
1406
  =============================================== ======== ====== =========== ======== ========= ==============================================
1091
1407
  ``DistributionSystem`` idref See [#]_ Yes ID of attached distribution system
1092
- ``HeatingCapacity`` double Btu/hr > 0 No autosized Heating capacity
1093
- ``CoolingCapacity`` double Btu/hr > 0 See [#]_ Cooling capacity
1408
+ ``HeatingCapacity`` double Btu/hr > 0 No autosized Heating output capacity
1409
+ ``CoolingCapacity`` double Btu/hr > 0 See [#]_ Cooling output capacity
1094
1410
  ``AnnualCoolingEfficiency[Units="EER"]/Value`` double Btu/Wh > 0 See [#]_ Rated cooling efficiency
1095
1411
  ``AnnualHeatingEfficiency[Units="COP"]/Value`` double W/W > 0 See [#]_ Rated heating efficiency
1096
1412
  =============================================== ======== ====== =========== ======== ========= ==============================================
@@ -1111,15 +1427,32 @@ HPXML HVAC Control
1111
1427
 
1112
1428
  If any HVAC systems are specified, a single thermostat is entered as a ``/HPXML/Building/BuildingDetails/Systems/HVAC/HVACControl``.
1113
1429
 
1114
- ======================================================= ======== ======= =========== ======== ========= ========================================
1115
- Element Type Units Constraints Required Default Notes
1116
- ======================================================= ======== ======= =========== ======== ========= ========================================
1117
- ``SystemIdentifier`` id Yes Unique identifier
1118
- ``extension/CeilingFanSetpointTempCoolingSeasonOffset`` double F >= 0 No 0 Cooling setpoint temperature offset [#]_
1119
- ======================================================= ======== ======= =========== ======== ========= ========================================
1120
-
1430
+ ======================================================= ======== ===== =========== ======== ========= ========================================
1431
+ Element Type Units Constraints Required Default Notes
1432
+ ======================================================= ======== ===== =========== ======== ========= ========================================
1433
+ ``SystemIdentifier`` id Yes Unique identifier
1434
+ ``HeatingSeason`` element No See [#]_ Heating season
1435
+ ``CoolingSeason`` element No See [#]_ Cooling season
1436
+ ``extension/CeilingFanSetpointTempCoolingSeasonOffset`` double F >= 0 No 0 Cooling setpoint temperature offset [#]_
1437
+ ======================================================= ======== ===== =========== ======== ========= ========================================
1438
+
1439
+ .. [#] If HeatingSeason not provided, defaults to year-round.
1440
+ .. [#] If CoolingSeason not provided, defaults to year-round.
1121
1441
  .. [#] CeilingFanSetpointTempCoolingSeasonOffset should only be used if there are sufficient ceiling fans present to warrant a reduced cooling setpoint.
1122
1442
 
1443
+ If a heating and/or cooling season is defined, additional information is entered in ``HVACControl/HeatingSeason`` and/or ``HVACControl/CoolingSeason``.
1444
+
1445
+ =================== ======== ===== =========== ======== ======= ===========
1446
+ Element Type Units Constraints Required Default Description
1447
+ =================== ======== ===== =========== ======== ======= ===========
1448
+ ``BeginMonth`` integer 1 - 12 Yes Begin month
1449
+ ``BeginDayOfMonth`` integer 1 - 31 Yes Begin day
1450
+ ``EndMonth`` integer 1 - 12 Yes End month
1451
+ ``EndDayOfMonth`` integer 1 - 31 Yes End day
1452
+ =================== ======== ===== =========== ======== ======= ===========
1453
+
1454
+ Heating and cooling seasons, when combined, must span the entire year.
1455
+
1123
1456
  Thermostat setpoints are additionally entered using either simple inputs or detailed inputs.
1124
1457
 
1125
1458
  Simple Inputs
@@ -1130,30 +1463,37 @@ To define simple thermostat setpoints, additional information is entered in ``HV
1130
1463
  ============================= ======== ======= =========== ======== ========= ============================
1131
1464
  Element Type Units Constraints Required Default Notes
1132
1465
  ============================= ======== ======= =========== ======== ========= ============================
1133
- ``SetpointTempHeatingSeason`` double F Yes Heating setpoint temperature
1134
- ``SetpointTempCoolingSeason`` double F Yes Cooling setpoint temperature
1466
+ ``SetpointTempHeatingSeason`` double F See [#]_ Heating setpoint temperature
1467
+ ``SetpointTempCoolingSeason`` double F See [#]_ Cooling setpoint temperature
1135
1468
  ============================= ======== ======= =========== ======== ========= ============================
1136
1469
 
1470
+ .. [#] SetpointTempHeatingSeason only required if there is heating equipment (i.e., sum of all ``FractionHeatLoadServed`` is greater than 0).
1471
+ .. [#] SetpointTempCoolingSeason only required if there is cooling equipment (i.e., sum of all ``FractionCoolLoadServed`` is greater than 0).
1472
+
1137
1473
  If there is a heating temperature setback, additional information is entered in ``HVACControl``.
1138
1474
 
1139
1475
  ===================================== ======== ======== =========== ======== ========= =========================================
1140
1476
  Element Type Units Constraints Required Default Notes
1141
1477
  ===================================== ======== ======== =========== ======== ========= =========================================
1142
1478
  ``SetbackTempHeatingSeason`` double F Yes Heating setback temperature
1143
- ``TotalSetbackHoursperWeekHeating`` integer hrs/week > 0 Yes Hours/week of heating temperature setback
1479
+ ``TotalSetbackHoursperWeekHeating`` integer hrs/week > 0 Yes Hours/week of heating temperature setback [#]_
1144
1480
  ``extension/SetbackStartHourHeating`` integer 0 - 23 No 23 (11pm) Daily setback start hour
1145
1481
  ===================================== ======== ======== =========== ======== ========= =========================================
1146
1482
 
1483
+ .. [#] TotalSetbackHoursperWeekHeating is converted to hrs/day and modeled as a temperature setback every day starting at SetbackStartHourHeating.
1484
+
1147
1485
  If there is a cooling temperature setup, additional information is entered in ``HVACControl``.
1148
1486
 
1149
1487
  ===================================== ======== ======== =========== ======== ========= =========================================
1150
1488
  Element Type Units Constraints Required Default Notes
1151
1489
  ===================================== ======== ======== =========== ======== ========= =========================================
1152
1490
  ``SetupTempCoolingSeason`` double F Yes Cooling setup temperature
1153
- ``TotalSetupHoursperWeekCooling`` integer hrs/week > 0 Yes Hours/week of cooling temperature setup
1491
+ ``TotalSetupHoursperWeekCooling`` integer hrs/week > 0 Yes Hours/week of cooling temperature setup [#]_
1154
1492
  ``extension/SetupStartHourCooling`` integer 0 - 23 No 9 (9am) Daily setup start hour
1155
1493
  ===================================== ======== ======== =========== ======== ========= =========================================
1156
1494
 
1495
+ .. [#] TotalSetupHoursperWeekCooling is converted to hrs/day and modeled as a temperature setup every day starting at SetupStartHourCooling.
1496
+
1157
1497
  Detailed Inputs
1158
1498
  ~~~~~~~~~~~~~~~
1159
1499
 
@@ -1162,12 +1502,17 @@ To define detailed thermostat setpoints, additional information is entered in ``
1162
1502
  =============================================== ===== ======= =========== ======== ========= ============================================
1163
1503
  Element Type Units Constraints Required Default Notes
1164
1504
  =============================================== ===== ======= =========== ======== ========= ============================================
1165
- ``extension/WeekdaySetpointTempsHeatingSeason`` array F Yes 24 comma-separated weekday heating setpoints
1166
- ``extension/WeekendSetpointTempsHeatingSeason`` array F Yes 24 comma-separated weekend heating setpoints
1167
- ``extension/WeekdaySetpointTempsCoolingSeason`` array F Yes 24 comma-separated weekday cooling setpoints
1168
- ``extension/WeekendSetpointTempsCoolingSeason`` array F Yes 24 comma-separated weekend cooling setpoints
1505
+ ``extension/WeekdaySetpointTempsHeatingSeason`` array F See [#]_ 24 comma-separated weekday heating setpoints
1506
+ ``extension/WeekendSetpointTempsHeatingSeason`` array F See [#]_ 24 comma-separated weekend heating setpoints
1507
+ ``extension/WeekdaySetpointTempsCoolingSeason`` array F See [#]_ 24 comma-separated weekday cooling setpoints
1508
+ ``extension/WeekendSetpointTempsCoolingSeason`` array F See [#]_ 24 comma-separated weekend cooling setpoints
1169
1509
  =============================================== ===== ======= =========== ======== ========= ============================================
1170
1510
 
1511
+ .. [#] WeekdaySetpointTempsHeatingSeason only required if there is heating equipment (i.e., sum of all ``FractionHeatLoadServed`` is greater than 0).
1512
+ .. [#] WeekendSetpointTempsHeatingSeason only required if there is heating equipment (i.e., sum of all ``FractionHeatLoadServed`` is greater than 0).
1513
+ .. [#] WeekdaySetpointTempsCoolingSeason only required if there is cooling equipment (i.e., sum of all ``FractionCoolLoadServed`` is greater than 0).
1514
+ .. [#] WeekendSetpointTempsCoolingSeason only required if there is cooling equipment (i.e., sum of all ``FractionCoolLoadServed`` is greater than 0).
1515
+
1171
1516
  HPXML HVAC Distribution
1172
1517
  ***********************
1173
1518
 
@@ -1223,24 +1568,30 @@ Additional information is entered in each ``DuctLeakageMeasurement``.
1223
1568
  ``DuctLeakage/TotalOrToOutside`` string See [#]_ Yes Type of duct leakage (outside conditioned space vs total)
1224
1569
  ================================ ======= ======= =========== ======== ========= =========================================================
1225
1570
 
1226
- .. [#] Units choices are "CFM25" or "Percent".
1571
+ .. [#] Units choices are "CFM25", "CFM50", or "Percent".
1227
1572
  .. [#] Value also must be < 1 if Units is Percent.
1228
1573
  .. [#] If the HVAC system has no return ducts (e.g., a ducted evaporative cooler), use zero for the Value.
1229
1574
  .. [#] TotalOrToOutside only choice is "to outside".
1230
1575
 
1231
1576
  Additional information is entered in each ``Ducts``.
1232
1577
 
1233
- ======================== ======= ============ =========== ======== ========= ===============================
1234
- Element Type Units Constraints Required Default Notes
1235
- ======================== ======= ============ =========== ======== ========= ===============================
1236
- ``DuctInsulationRValue`` double F-ft2-hr/Btu >= 0 Yes R-value of duct insulation [#]_
1237
- ``DuctSurfaceArea`` double ft2 >= 0 See [#]_ See [#]_ Duct surface area
1238
- ``DuctLocation`` string See [#]_ See [#]_ See [#]_ Duct location
1239
- ======================== ======= ============ =========== ======== ========= ===============================
1578
+ =============================================== ======= ============ ================ ======== ========= ======================================
1579
+ Element Type Units Constraints Required Default Notes
1580
+ =============================================== ======= ============ ================ ======== ========= ======================================
1581
+ ``DuctInsulationRValue`` double F-ft2-hr/Btu >= 0 Yes R-value of duct insulation [#]_
1582
+ ``DuctLocation`` string See [#]_ No See [#]_ Duct location
1583
+ ``FractionDuctArea`` and/or ``DuctSurfaceArea`` double frac or ft2 0-1 [#]_ or >= 0 See [#]_ See [#]_ Duct fraction/surface area in location
1584
+ =============================================== ======= ============ ================ ======== ========= ======================================
1240
1585
 
1241
1586
  .. [#] DuctInsulationRValue should not include air films (i.e., use 0 for an uninsulated duct).
1242
- .. [#] DuctSurfaceArea and DuctLocation are either both required or both disallowed.
1243
- .. [#] If DuctSurfaceArea not provided, duct areas will be calculated based on `ASHRAE Standard 152 <https://www.energy.gov/eere/buildings/downloads/ashrae-standard-152-spreadsheet>`_:
1587
+ .. [#] 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".
1588
+ See :ref:`hpxmllocations` for descriptions.
1589
+ .. [#] 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".
1590
+ If NumberofConditionedFloorsAboveGrade > 1, secondary ducts will be located in "living space".
1591
+ .. [#] The sum of all ``[DuctType="supply"]/FractionDuctArea`` and ``[DuctType="return"]/FractionDuctArea`` must each equal to 1.
1592
+ .. [#] Either FractionDuctArea or DuctSurfaceArea (or both) are required if DuctLocation is provided.
1593
+ .. [#] If DuctSurfaceArea not provided, duct surface areas will be calculated based on FractionDuctArea if provided.
1594
+ If FractionDuctArea also not provided, duct surface areas will be calculated based on `ASHRAE Standard 152 <https://www.energy.gov/eere/buildings/downloads/ashrae-standard-152-spreadsheet>`_:
1244
1595
 
1245
1596
  - **Primary supply ducts**: 0.27 * F_out * ConditionedFloorAreaServed
1246
1597
  - **Secondary supply ducts**: 0.27 * (1 - F_out) * ConditionedFloorAreaServed
@@ -1248,11 +1599,6 @@ Additional information is entered in each ``Ducts``.
1248
1599
  - **Secondary return ducts**: b_r * (1 - F_out) * ConditionedFloorAreaServed
1249
1600
 
1250
1601
  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.
1251
- .. [#] DuctLocation choices are "living space", "basement - conditioned", "basement - unconditioned", "crawlspace - unvented", "crawlspace - vented", "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".
1252
- See :ref:`hpxmllocations` for descriptions.
1253
- .. [#] DuctLocation and DuctSurfaceArea are either both required or both disallowed.
1254
- .. [#] If DuctLocation not provided, defaults to the first present space type: "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "attic - vented", "attic - unvented", "garage", or "living space".
1255
- Any secondary ducts (i.e., when NumberofConditionedFloorsAboveGrade > 1) will always be located in "living space".
1256
1602
 
1257
1603
  Hydronic Distribution
1258
1604
  ~~~~~~~~~~~~~~~~~~~~~
@@ -1292,22 +1638,29 @@ HPXML Whole Ventilation Fan
1292
1638
  Each mechanical ventilation system that provides ventilation to the whole dwelling unit is entered as a ``/HPXML/Building/BuildingDetails/Systems/MechanicalVentilation/VentilationFans/VentilationFan``.
1293
1639
  If not entered, the simulation will not include mechanical ventilation.
1294
1640
 
1295
- ======================================= ======== ======= =========== ======== ========= =========================================
1296
- Element Type Units Constraints Required Default Notes
1297
- ======================================= ======== ======= =========== ======== ========= =========================================
1298
- ``SystemIdentifier`` id Yes Unique identifier
1299
- ``UsedForWholeBuildingVentilation`` boolean true Yes Must be set to true
1300
- ``IsSharedSystem`` boolean See [#]_ No false Whether it serves multiple dwelling units
1301
- ``FanType`` string See [#]_ Yes Type of ventilation system
1302
- ``TestedFlowRate`` or ``RatedFlowRate`` double cfm >= 0 Yes Flow rate [#]_
1303
- ``HoursInOperation`` double hrs/day 0 - 24 No See [#]_ Hours per day of operation
1304
- ``FanPower`` double W >= 0 Yes Fan power
1305
- ======================================= ======== ======= =========== ======== ========= =========================================
1641
+ ============================================================================================= ======== ======= =========== ======== ========= =========================================
1642
+ Element Type Units Constraints Required Default Notes
1643
+ ============================================================================================= ======== ======= =========== ======== ========= =========================================
1644
+ ``SystemIdentifier`` id Yes Unique identifier
1645
+ ``UsedForWholeBuildingVentilation`` boolean true Yes Must be set to true
1646
+ ``IsSharedSystem`` boolean See [#]_ No false Whether it serves multiple dwelling units
1647
+ ``FanType`` string See [#]_ Yes Type of ventilation system
1648
+ ``RatedFlowRate`` or ``TestedFlowRate`` or ``CalculatedFlowRate`` or ``DeliveredVentilation`` double cfm >= 0 No See [#]_ Flow rate [#]_
1649
+ ``HoursInOperation`` double hrs/day 0 - 24 No See [#]_ Hours per day of operation
1650
+ ``FanPower`` double W >= 0 No See [#]_ Fan power
1651
+ ============================================================================================= ======== ======= =========== ======== ========= =========================================
1306
1652
 
1307
1653
  .. [#] For central fan integrated supply systems, IsSharedSystem must be false.
1308
1654
  .. [#] FanType choices are "energy recovery ventilator", "heat recovery ventilator", "exhaust only", "supply only", "balanced", or "central fan integrated supply".
1655
+ .. [#] 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>`_, including adjustments for A) infiltration credit, B) balanced vs imbalanced systems, and C) adiabatic surfaces for SFA/MF buildings.
1309
1656
  .. [#] For a central fan integrated supply system, the flow rate should equal the amount of outdoor air provided to the distribution system.
1310
1657
  .. [#] 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.
1658
+ .. [#] If FanPower not provided, defaults based on `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_:
1659
+
1660
+ - "energy recovery ventilator", "heat recovery ventilator", or shared system: 1.0 W/cfm
1661
+ - "balanced": 0.7 W/cfm
1662
+ - "central fan integrated supply": 0.5 W/cfm
1663
+ - "exhaust only" or "supply only": 0.35 W/cfm
1311
1664
 
1312
1665
  Exhaust/Supply Only
1313
1666
  ~~~~~~~~~~~~~~~~~~~
@@ -1371,7 +1724,7 @@ If the specified system is a shared system (i.e., serving multiple dwelling unit
1371
1724
 
1372
1725
  .. [#] 1-FractionRecirculation is assumed to be the fraction of supply air that is provided from outside.
1373
1726
  The value must be 0 for exhaust only systems.
1374
- .. [#] InUnitFlowRate must also be < TestedFlowRate (or RatedFlowRate).
1727
+ .. [#] InUnitFlowRate must also be < (RatedFlowRate or TestedFlowRate or CalculatedFlowRate or DeliveredVentilation).
1375
1728
  .. [#] PreHeating not allowed for exhaust only systems.
1376
1729
  .. [#] PreCooling not allowed for exhaust only systems.
1377
1730
 
@@ -1405,24 +1758,24 @@ HPXML Local Ventilation Fan
1405
1758
  Each kitchen range fan or bathroom fan that provides local ventilation is entered as a ``/HPXML/Building/BuildingDetails/Systems/MechanicalVentilation/VentilationFans/VentilationFan``.
1406
1759
  If not entered, the simulation will not include kitchen/bathroom fans.
1407
1760
 
1408
- =========================== ======= ======= =========== ======== ======== =============================
1409
- Element Type Units Constraints Required Default Notes
1410
- =========================== ======= ======= =========== ======== ======== =============================
1411
- ``SystemIdentifier`` id Yes Unique identifier
1412
- ``UsedForLocalVentilation`` boolean true Yes Must be set to true
1413
- ``Quantity`` integer >= 0 No See [#]_ Number of identical fans
1414
- ``RatedFlowRate`` double cfm >= 0 No See [#]_ Flow rate
1415
- ``HoursInOperation`` double hrs/day 0 - 24 No See [#]_ Hours per day of operation
1416
- ``FanLocation`` string See [#]_ Yes Location of the fan
1417
- ``FanPower`` double W >= 0 No See [#]_ Fan power
1418
- ``extension/StartHour`` integer 0 - 23 No See [#]_ Daily start hour of operation
1419
- =========================== ======= ======= =========== ======== ======== =============================
1761
+ ============================================================================================= ======= ======= =========== ======== ======== =============================
1762
+ Element Type Units Constraints Required Default Notes
1763
+ ============================================================================================= ======= ======= =========== ======== ======== =============================
1764
+ ``SystemIdentifier`` id Yes Unique identifier
1765
+ ``UsedForLocalVentilation`` boolean true Yes Must be set to true
1766
+ ``Quantity`` integer >= 0 No See [#]_ Number of identical fans
1767
+ ``RatedFlowRate`` or ``TestedFlowRate`` or ``CalculatedFlowRate`` or ``DeliveredVentilation`` double cfm >= 0 No See [#]_ Flow rate
1768
+ ``HoursInOperation`` double hrs/day 0 - 24 No See [#]_ Hours per day of operation
1769
+ ``FanLocation`` string See [#]_ Yes Location of the fan
1770
+ ``FanPower`` double W >= 0 No See [#]_ Fan power
1771
+ ``extension/StartHour`` integer 0 - 23 No See [#]_ Daily start hour of operation
1772
+ ============================================================================================= ======= ======= =========== ======== ======== =============================
1420
1773
 
1421
1774
  .. [#] If Quantity not provided, defaults to 1 for kitchen fans and NumberofBathrooms for bath fans based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_.
1422
- .. [#] If RatedFlowRate not provided, defaults to 100 cfm for kitchen fans and 50 cfm for bath fans based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_.
1775
+ .. [#] If flow rate not provided, defaults to 100 cfm for kitchen fans and 50 cfm for bath fans based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_.
1423
1776
  .. [#] If HoursInOperation not provided, defaults to 1 based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_.
1424
1777
  .. [#] FanLocation choices are "kitchen" or "bath".
1425
- .. [#] If FanPower not provided, defaults to 0.3 W/cfm * RatedFlowRate based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_.
1778
+ .. [#] If FanPower not provided, defaults to 0.3 W/cfm based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_.
1426
1779
  .. [#] If StartHour not provided, defaults to 18 for kitchen fans and 7 for bath fans based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_.
1427
1780
 
1428
1781
  HPXML Whole House Fan
@@ -1431,14 +1784,16 @@ HPXML Whole House Fan
1431
1784
  Each whole house fan that provides cooling load reduction is entered as a ``/HPXML/Building/BuildingDetails/Systems/MechanicalVentilation/VentilationFans/VentilationFan``.
1432
1785
  If not entered, the simulation will not include whole house fans.
1433
1786
 
1434
- ======================================= ======= ======= =========== ======== ======== ==========================
1435
- Element Type Units Constraints Required Default Notes
1436
- ======================================= ======= ======= =========== ======== ======== ==========================
1437
- ``SystemIdentifier`` id Yes Unique identifier
1438
- ``UsedForSeasonalCoolingLoadReduction`` boolean true Yes Must be set to true
1439
- ``RatedFlowRate`` double cfm >= 0 Yes Flow rate
1440
- ``FanPower`` double W >= 0 Yes Fan power
1441
- ======================================= ======= ======= =========== ======== ======== ==========================
1787
+ ============================================================================================= ======= ======= =========== ======== ====================== ==========================
1788
+ Element Type Units Constraints Required Default Notes
1789
+ ============================================================================================= ======= ======= =========== ======== ====================== ==========================
1790
+ ``SystemIdentifier`` id Yes Unique identifier
1791
+ ``UsedForSeasonalCoolingLoadReduction`` boolean true Yes Must be set to true
1792
+ ``RatedFlowRate`` or ``TestedFlowRate`` or ``CalculatedFlowRate`` or ``DeliveredVentilation`` double cfm >= 0 No ConditionedFloorArea*2 Flow rate
1793
+ ``FanPower`` double W >= 0 No See [#]_ Fan power
1794
+ ============================================================================================= ======= ======= =========== ======== ====================== ==========================
1795
+
1796
+ .. [#] If FanPower not provided, defaults to 0.1 W/cfm.
1442
1797
 
1443
1798
  .. note::
1444
1799
 
@@ -1464,7 +1819,7 @@ If not entered, the simulation will not include water heating.
1464
1819
  ========================= ======= ======= =========== ======== ======== ================================================================
1465
1820
 
1466
1821
  .. [#] 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".
1467
- .. [#] Location choices are "living space", "basement - unconditioned", "basement - conditioned", "attic - unvented", "attic - vented", "garage", "crawlspace - unvented", "crawlspace - vented", "other exterior", "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space".
1822
+ .. [#] 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".
1468
1823
  See :ref:`hpxmllocations` for descriptions.
1469
1824
  .. [#] If Location not provided, defaults to the first present space type:
1470
1825
 
@@ -1481,22 +1836,26 @@ Conventional Storage
1481
1836
 
1482
1837
  If a conventional storage water heater is specified, additional information is entered in ``WaterHeatingSystem``.
1483
1838
 
1484
- ============================================= ======= ============ =========== ======== ======== ==========================================
1485
- Element Type Units Constraints Required Default Notes
1486
- ============================================= ======= ============ =========== ======== ======== ==========================================
1487
- ``FuelType`` string See [#]_ Yes Fuel type
1488
- ``TankVolume`` double gal > 0 No See [#]_ Tank volume
1489
- ``HeatingCapacity`` double Btuh > 0 No See [#]_ Heating capacity
1490
- ``UniformEnergyFactor`` or ``EnergyFactor`` double frac < 1 Yes EnergyGuide label rated efficiency
1491
- ``FirstHourRating`` double gal/hr > 0 See [#]_ EnergyGuide label first hour rating
1492
- ``RecoveryEfficiency`` double frac 0 - 1 No See [#]_ Recovery efficiency
1493
- ``WaterHeaterInsulation/Jacket/JacketRValue`` double F-ft2-hr/Btu >= 0 No 0 R-value of additional tank insulation wrap
1494
- ============================================= ======= ============ =========== ======== ======== ==========================================
1839
+ ================================================================ ================= ============= =============== ======== ======== ====================================================
1840
+ Element Type Units Constraints Required Default Notes
1841
+ ================================================================ ================= ============= =============== ======== ======== ====================================================
1842
+ ``FuelType`` string See [#]_ Yes Fuel type
1843
+ ``TankVolume`` double gal > 0 No See [#]_ Tank volume
1844
+ ``HeatingCapacity`` double Btuh > 0 No See [#]_ Heating capacity
1845
+ ``UniformEnergyFactor`` or ``EnergyFactor`` or ``YearInstalled`` double or integer frac or # < 1 or > 1600 Yes See [#]_ EnergyGuide label rated efficiency or Year installed
1846
+ ``UsageBin`` or ``FirstHourRating`` string or double str or gal/hr See [#]_ or > 0 No See [#]_ EnergyGuide label usage bin/first hour rating
1847
+ ``RecoveryEfficiency`` double frac 0 - 1 No See [#]_ Recovery efficiency
1848
+ ``WaterHeaterInsulation/Jacket/JacketRValue`` double F-ft2-hr/Btu >= 0 No 0 R-value of additional tank insulation wrap
1849
+ ================================================================ ================= ============= =============== ======== ======== ====================================================
1495
1850
 
1496
1851
  .. [#] 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".
1497
1852
  .. [#] If TankVolume not provided, defaults based on Table 8 in the `2014 BAHSP <https://www.energy.gov/sites/prod/files/2014/03/f13/house_simulation_protocols_2014.pdf>`_.
1498
1853
  .. [#] If HeatingCapacity not provided, defaults based on Table 8 in the `2014 BAHSP <https://www.energy.gov/sites/prod/files/2014/03/f13/house_simulation_protocols_2014.pdf>`_.
1499
- .. [#] FirstHourRating only required if UniformEnergyFactor provided.
1854
+ .. [#] If UniformEnergyFactor and EnergyFactor not provided, defaults to EnergyFactor from the lookup table that can be found at ``HPXMLtoOpenStudio\resources\lu_water_heater_efficiency.csv`` based on YearInstalled.
1855
+ .. [#] UsageBin choices are "very small", "low", "medium", or "high".
1856
+ .. [#] UsageBin/FirstHourRating are only used for water heaters that use UniformEnergyFactor.
1857
+ If neither UsageBin nor FirstHourRating provided, UsageBin defaults to "medium".
1858
+ If FirstHourRating provided and UsageBin not provided, UsageBin is determined based on the FirstHourRating value.
1500
1859
  .. [#] 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>`_:
1501
1860
 
1502
1861
  - **Electric**: 0.98
@@ -1524,18 +1883,21 @@ Heat Pump
1524
1883
 
1525
1884
  If a heat pump water heater is specified, additional information is entered in ``WaterHeatingSystem``.
1526
1885
 
1527
- ============================================= ======= ============ =========== ======== ======== ==========================================
1528
- Element Type Units Constraints Required Default Notes
1529
- ============================================= ======= ============ =========== ======== ======== ==========================================
1530
- ``FuelType`` string See [#]_ Yes Fuel type
1531
- ``TankVolume`` double gal > 0 Yes Tank volume
1532
- ``UniformEnergyFactor`` or ``EnergyFactor`` double frac > 1 Yes EnergyGuide label rated efficiency
1533
- ``FirstHourRating`` double gal/hr > 0 See [#]_ EnergyGuide label first hour rating
1534
- ``WaterHeaterInsulation/Jacket/JacketRValue`` double F-ft2-hr/Btu >= 0 No 0 R-value of additional tank insulation wrap
1535
- ============================================= ======= ============ =========== ======== ======== ==========================================
1886
+ ============================================= ================ ============= =============== ======== ======== =============================================
1887
+ Element Type Units Constraints Required Default Notes
1888
+ ============================================= ================ ============= =============== ======== ======== =============================================
1889
+ ``FuelType`` string See [#]_ Yes Fuel type
1890
+ ``TankVolume`` double gal > 0 Yes Tank volume
1891
+ ``UniformEnergyFactor`` or ``EnergyFactor`` double frac > 1 Yes EnergyGuide label rated efficiency
1892
+ ``UsageBin`` or ``FirstHourRating`` string or double str or gal/hr See [#]_ or > 0 No See [#]_ EnergyGuide label usage bin/first hour rating
1893
+ ``WaterHeaterInsulation/Jacket/JacketRValue`` double F-ft2-hr/Btu >= 0 No 0 R-value of additional tank insulation wrap
1894
+ ============================================= ================ ============= =============== ======== ======== =============================================
1536
1895
 
1537
1896
  .. [#] FuelType only choice is "electricity".
1538
- .. [#] FirstHourRating only required if UniformEnergyFactor provided.
1897
+ .. [#] UsageBin choices are "very small", "low", "medium", or "high".
1898
+ .. [#] UsageBin/FirstHourRating are only used for water heaters that use UniformEnergyFactor.
1899
+ If neither UsageBin nor FirstHourRating provided, UsageBin defaults to "medium".
1900
+ If FirstHourRating provided and UsageBin not provided, UsageBin is determined based on the FirstHourRating value.
1539
1901
 
1540
1902
  Combi Boiler w/ Storage
1541
1903
  ~~~~~~~~~~~~~~~~~~~~~~~
@@ -1698,8 +2060,19 @@ Each water fixture is entered as a ``/HPXML/Building/BuildingDetails/Systems/Wat
1698
2060
  .. [#] WaterFixtureType choices are "shower head" or "faucet".
1699
2061
  .. [#] LowFlow should be true if the fixture's flow rate (gpm) is <= 2.0.
1700
2062
 
1701
- In addition, a ``/HPXML/Building/BuildingDetails/Systems/WaterHeating/extension/WaterFixturesUsageMultiplier`` can be optionally provided that scales hot water usage.
1702
- if not provided, it is assumed to be 1.0.
2063
+ Additional information can be entered in ``/HPXML/Building/BuildingDetails/Systems/WaterHeating/``.
2064
+
2065
+ ===================================================== ======= ===== =========== ======== ======== ===============================================
2066
+ Element Type Units Constraints Required Default Notes
2067
+ ===================================================== ======= ===== =========== ======== ======== ===============================================
2068
+ ``extension/WaterFixturesUsageMultiplier`` double >= 0 No 1.0 Multiplier on hot water usage
2069
+ ``extension/WaterFixturesWeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
2070
+ ``extension/WaterFixturesWeekendScheduleFractions`` array No 24 comma-separated weekend fractions
2071
+ ``extension/WaterFixturesMonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
2072
+ ===================================================== ======= ===== =========== ======== ======== ===============================================
2073
+
2074
+ .. [#] 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".
2075
+ .. [#] 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".
1703
2076
 
1704
2077
  HPXML Solar Thermal
1705
2078
  *******************
@@ -1741,22 +2114,23 @@ Detailed Inputs
1741
2114
 
1742
2115
  To define a detailed solar hot water system, additional information is entered in ``SolarThermalSystem``.
1743
2116
 
1744
- =================================== ======= ============ =========== ======== ======== ==============================
1745
- Element Type Units Constraints Required Default Notes
1746
- =================================== ======= ============ =========== ======== ======== ==============================
1747
- ``CollectorArea`` double ft2 > 0 Yes Area
1748
- ``CollectorLoopType`` string See [#]_ Yes Loop type
1749
- ``CollectorType`` string See [#]_ Yes System type
1750
- ``CollectorAzimuth`` integer deg 0 - 359 Yes Azimuth (clockwise from North)
1751
- ``CollectorTilt`` double deg 0 - 90 Yes Tilt relative to horizontal
1752
- ``CollectorRatedOpticalEfficiency`` double frac 0 - 1 Yes Rated optical efficiency [#]_
1753
- ``CollectorRatedThermalLosses`` double Btu/hr-ft2-R > 0 Yes Rated thermal losses [#]_
1754
- ``StorageVolume`` double gal > 0 No See [#]_ Hot water storage volume
1755
- ``ConnectedTo`` idref See [#]_ Yes Connected water heater
1756
- =================================== ======= ============ =========== ======== ======== ==============================
2117
+ ================================================ ================= ================ =================== ======== ======== ==============================
2118
+ Element Type Units Constraints Required Default Notes
2119
+ ================================================ ================= ================ =================== ======== ======== ==============================
2120
+ ``CollectorArea`` double ft2 > 0 Yes Area
2121
+ ``CollectorLoopType`` string See [#]_ Yes Loop type
2122
+ ``CollectorType`` string See [#]_ Yes System type
2123
+ ``CollectorAzimuth`` or ``CollectorOrientation`` integer or string deg or direction 0 - 359 or See [#]_ Yes Direction panels face (clockwise from North)
2124
+ ``CollectorTilt`` double deg 0 - 90 Yes Tilt relative to horizontal
2125
+ ``CollectorRatedOpticalEfficiency`` double frac 0 - 1 Yes Rated optical efficiency [#]_
2126
+ ``CollectorRatedThermalLosses`` double Btu/hr-ft2-R > 0 Yes Rated thermal losses [#]_
2127
+ ``StorageVolume`` double gal > 0 No See [#]_ Hot water storage volume
2128
+ ``ConnectedTo`` idref See [#]_ Yes Connected water heater
2129
+ ================================================ ================= ================ =================== ======== ======== ==============================
1757
2130
 
1758
2131
  .. [#] CollectorLoopType choices are "liquid indirect", "liquid direct", or "passive thermosyphon".
1759
2132
  .. [#] CollectorType choices are "single glazing black", "double glazing black", "evacuated tube", or "integrated collector storage".
2133
+ .. [#] CollectorOrientation choices are "northeast", "east", "southeast", "south", "southwest", "west", "northwest", or "north"
1760
2134
  .. [#] CollectorRatedOpticalEfficiency is FRTA (y-intercept) from the `Directory of SRCC OG-100 Certified Solar Collector Ratings <https://solar-rating.org/programs/og-100-program/>`_.
1761
2135
  .. [#] CollectorRatedThermalLosses is FRUL (slope) from the `Directory of SRCC OG-100 Certified Solar Collector Ratings <https://solar-rating.org/programs/og-100-program/>`_.
1762
2136
  .. [#] If StorageVolume not provided, calculated as 1.5 gal/ft2 * CollectorArea.
@@ -1770,31 +2144,58 @@ If not entered, the simulation will not include photovoltaics.
1770
2144
 
1771
2145
  Many of the inputs are adopted from the `PVWatts model <https://pvwatts.nrel.gov>`_.
1772
2146
 
1773
- ======================================================= ================= ========= =============== ======== ======== ============================================
1774
- Element Type Units Constraints Required Default Notes
1775
- ======================================================= ================= ========= =============== ======== ======== ============================================
1776
- ``SystemIdentifier`` id Yes Unique identifier
1777
- ``IsSharedSystem`` boolean No false Whether it serves multiple dwelling units
1778
- ``Location`` string See [#]_ No roof Mounting location
1779
- ``ModuleType`` string See [#]_ No standard Type of module
1780
- ``Tracking`` string See [#]_ No fixed Type of tracking
1781
- ``ArrayAzimuth`` integer deg 0 - 359 Yes Direction panels face (clockwise from North)
1782
- ``ArrayTilt`` double deg 0 - 90 Yes Tilt relative to horizontal
1783
- ``MaxPowerOutput`` double W >= 0 Yes Peak power
1784
- ``InverterEfficiency`` double frac 0 - 1 No 0.96 Inverter efficiency
1785
- ``SystemLossesFraction`` or ``YearModulesManufactured`` double or integer frac or # 0 - 1 or > 1600 No 0.14 System losses [#]_
1786
- ``extension/NumberofBedroomsServed`` integer > 1 See [#]_ Number of bedrooms served
1787
- ======================================================= ================= ========= =============== ======== ======== ============================================
2147
+ ======================================================= ================= ================ =================== ======== ======== ============================================
2148
+ Element Type Units Constraints Required Default Notes
2149
+ ======================================================= ================= ================ =================== ======== ======== ============================================
2150
+ ``SystemIdentifier`` id Yes Unique identifier
2151
+ ``IsSharedSystem`` boolean No false Whether it serves multiple dwelling units
2152
+ ``Location`` string See [#]_ No roof Mounting location
2153
+ ``ModuleType`` string See [#]_ No standard Type of module
2154
+ ``Tracking`` string See [#]_ No fixed Type of tracking
2155
+ ``ArrayAzimuth`` or ``ArrayOrientation`` integer or string deg or direction 0 - 359 or See [#]_ Yes Direction panels face (clockwise from North)
2156
+ ``ArrayTilt`` double deg 0 - 90 Yes Tilt relative to horizontal
2157
+ ``MaxPowerOutput`` double W >= 0 Yes Peak power
2158
+ ``InverterEfficiency`` double frac 0 - 1 [#]_ No 0.96 Inverter efficiency
2159
+ ``SystemLossesFraction`` or ``YearModulesManufactured`` double or integer frac or # 0 - 1 or > 1600 No 0.14 System losses [#]_
2160
+ ``extension/NumberofBedroomsServed`` integer > 1 See [#]_ Number of bedrooms served
2161
+ ======================================================= ================= ================ =================== ======== ======== ============================================
1788
2162
 
1789
2163
  .. [#] Location choices are "ground" or "roof" mounted.
1790
2164
  .. [#] ModuleType choices are "standard", "premium", or "thin film".
1791
2165
  .. [#] Tracking choices are "fixed", "1-axis", "1-axis backtracked", or "2-axis".
2166
+ .. [#] ArrayOrientation choices are "northeast", "east", "southeast", "south", "southwest", "west", "northwest", or "north"
2167
+ .. [#] For homes with multiple PV arrays, all InverterEfficiency elements must have the same value.
1792
2168
  .. [#] System losses due to soiling, shading, snow, mismatch, wiring, degradation, etc.
1793
2169
  If YearModulesManufactured provided but not SystemLossesFraction, system losses calculated as:
1794
2170
  SystemLossesFraction = 1.0 - (1.0 - 0.14) * (1.0 - (1.0 - 0.995^(CurrentYear - YearModulesManufactured))).
1795
2171
  .. [#] NumberofBedroomsServed only required if IsSharedSystem is true, in which case it must be > NumberofBedrooms.
1796
2172
  PV generation will be apportioned to the dwelling unit using its number of bedrooms divided by the total number of bedrooms served by the PV system.
1797
2173
 
2174
+ HPXML Batteries
2175
+ ***************
2176
+
2177
+ A single battery can be entered as a ``/HPXML/Building/BuildingDetails/Systems/Batteries/Battery``.
2178
+ If not entered, the simulation will not include batteries.
2179
+
2180
+ ==================================================== ======= ========= =========== ======== ======== ============================================
2181
+ Element Type Units Constraints Required Default Notes
2182
+ ==================================================== ======= ========= =========== ======== ======== ============================================
2183
+ ``SystemIdentifier`` id Yes Unique identifier
2184
+ ``Location`` string See [#]_ No outside Location
2185
+ ``BatteryType`` string See [#]_ Yes Battery type
2186
+ ``NominalCapacity[Units="kWh" or Units="Ah"]/Value`` double kWh or Ah >= 0 No See [#]_ Nominal (not usable) capacity
2187
+ ``RatedPowerOutput`` double W >= 0 No See [#]_ Rated power output
2188
+ ``NominalVoltage`` double V >= 0 No 50 Nominal voltage
2189
+ ``extension/LifetimeModel`` string See [#]_ No None Lifetime model [#]_
2190
+ ==================================================== ======= ========= =========== ======== ======== ============================================
2191
+
2192
+ .. [#] Location choices are "living space", "basement - conditioned", "basement - unconditioned", "crawlspace - vented", "crawlspace - unvented", "crawlspace - conditioned", "attic - vented", "attic - unvented", "garage", or "outside".
2193
+ .. [#] BatteryType choices are "Li-ion".
2194
+ .. [#] NominalCapacity is defaulted to 10 kWh if RatedPowerOutput is not specified; otherwise it is calculated as (RatedPowerOutput / 1000) / 0.5.
2195
+ .. [#] RatedPowerOutput is defaulted to 5000 W if NominalCapacity is not specified; otherwise it is calculated as NominalCapacity * 1000 * 0.5.
2196
+ .. [#] LifetimeModel choices are "None" or "KandlerSmith".
2197
+ .. [#] See the "Lifetime Model" `EnergyPlus documentation <https://bigladdersoftware.com/epx/docs/9-6/input-output-reference/group-electric-load-center-generator.html#liion-lifetime-model>`_ for more information.
2198
+
1798
2199
  HPXML Generators
1799
2200
  ****************
1800
2201
 
@@ -1841,6 +2242,9 @@ If not entered, the simulation will not include a clothes washer.
1841
2242
  ``IntegratedModifiedEnergyFactor`` or ``ModifiedEnergyFactor`` double ft3/kWh/cyc > 0 No See [#]_ EnergyGuide label efficiency [#]_
1842
2243
  ``AttachedToWaterHeatingSystem`` idref See [#]_ See [#]_ ID of attached water heater
1843
2244
  ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on energy & hot water usage
2245
+ ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
2246
+ ``extension/WeekendScheduleFractions`` array No 24 comma-separated weekend fractions
2247
+ ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
1844
2248
  ============================================================== ======= =========== =========== ======== ============ ==============================================
1845
2249
 
1846
2250
  .. [#] For example, a clothes washer in a shared laundry room of a MF building.
@@ -1858,6 +2262,8 @@ If not entered, the simulation will not include a clothes washer.
1858
2262
  IMEF = (MEF - 0.503) / 0.95.
1859
2263
  .. [#] AttachedToWaterHeatingSystem must reference a ``WaterHeatingSystem``.
1860
2264
  .. [#] AttachedToWaterHeatingSystem only required if IsSharedAppliance is true.
2265
+ .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided (and :ref:`detailedschedules` not used), default values from Figure 17 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used: "0.009, 0.007, 0.004, 0.004, 0.007, 0.011, 0.022, 0.049, 0.073, 0.086, 0.084, 0.075, 0.067, 0.060, 0.049, 0.052, 0.050, 0.049, 0.049, 0.049, 0.049, 0.047, 0.032, 0.017".
2266
+ .. [#] 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.011, 1.002, 1.022, 1.020, 1.022, 0.996, 0.999, 0.999, 0.996, 0.964, 0.959, 1.011".
1861
2267
 
1862
2268
  If IntegratedModifiedEnergyFactor or ModifiedEnergyFactor is provided, a complete set of EnergyGuide label information is entered in ``ClothesWasher``.
1863
2269
 
@@ -1888,9 +2294,12 @@ If not entered, the simulation will not include a clothes dryer.
1888
2294
  ``Location`` string See [#]_ No living space Location
1889
2295
  ``FuelType`` string See [#]_ Yes Fuel type
1890
2296
  ``CombinedEnergyFactor`` or ``EnergyFactor`` double lb/kWh > 0 No See [#]_ EnergyGuide label efficiency [#]_
2297
+ ``Vented`` boolean No true Whether dryer is vented
2298
+ ``VentedFlowRate`` double cfm >= 0 No 100 [#]_ Exhaust flow rate during operation
1891
2299
  ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on energy use
1892
- ``extension/IsVented`` boolean No true Whether dryer is vented
1893
- ``extension/VentedFlowRate`` double cfm >= 0 See [#]_ 100 [#]_ Exhust flow rate during operation
2300
+ ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
2301
+ ``extension/WeekendScheduleFractions`` array No 24 comma-separated weekend fractions
2302
+ ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
1894
2303
  ============================================ ======= ====== =========== ======== ============ ==============================================
1895
2304
 
1896
2305
  .. [#] For example, a clothes dryer in a shared laundry room of a MF building.
@@ -1901,8 +2310,9 @@ If not entered, the simulation will not include a clothes dryer.
1901
2310
  CombinedEnergyFactor = 3.01.
1902
2311
  .. [#] If EnergyFactor (EF) provided instead of CombinedEnergyFactor (CEF), it will be converted using the following equation based on the `Interpretation on ANSI/RESNET/ICC 301-2014 Clothes Dryer CEF <https://www.resnet.us/wp-content/uploads/No.-301-2014-10-Section-4.2.2.5.2.8-Clothes-Dryer-CEF-Rating.pdf>`_:
1903
2312
  CEF = EF / 1.15.
1904
- .. [#] VentedFlowRate only required if IsVented is true.
1905
2313
  .. [#] VentedFlowRate default based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_.
2314
+ .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided (and :ref:`detailedschedules` not used), default values from Figure 18 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used: "0.010, 0.006, 0.004, 0.002, 0.004, 0.006, 0.016, 0.032, 0.048, 0.068, 0.078, 0.081, 0.074, 0.067, 0.057, 0.061, 0.055, 0.054, 0.051, 0.051, 0.052, 0.054, 0.044, 0.024".
2315
+ .. [#] 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".
1906
2316
 
1907
2317
  Clothes dryer energy use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2019 Addendum A <https://www.resnet.us/wp-content/uploads/ANSI_RESNET_ICC-301-2019-Addendum-A-2019_7.16.20-1.pdf>`_.
1908
2318
 
@@ -1921,6 +2331,9 @@ If not entered, the simulation will not include a dishwasher.
1921
2331
  ``RatedAnnualkWh`` or ``EnergyFactor`` double kWh/yr or # > 0 No See [#]_ EnergyGuide label consumption/efficiency [#]_
1922
2332
  ``AttachedToWaterHeatingSystem`` idref See [#]_ See [#]_ ID of attached water heater
1923
2333
  ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on energy & hot water usage
2334
+ ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
2335
+ ``extension/WeekendScheduleFractions`` array No 24 comma-separated weekend fractions
2336
+ ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
1924
2337
  ============================================ ======= =========== =========== ======== ============ ==============================================
1925
2338
 
1926
2339
  .. [#] For example, a dishwasher in a shared mechanical room of a MF building.
@@ -1937,6 +2350,8 @@ If not entered, the simulation will not include a dishwasher.
1937
2350
  RatedAnnualkWh = 215.0 / EF.
1938
2351
  .. [#] AttachedToWaterHeatingSystem must reference a ``WaterHeatingSystem``.
1939
2352
  .. [#] AttachedToWaterHeatingSystem only required if IsSharedAppliance is true.
2353
+ .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided (and :ref:`detailedschedules` not used), default values from Figure 21 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used: "0.015, 0.007, 0.005, 0.003, 0.003, 0.010, 0.020, 0.031, 0.058, 0.065, 0.056, 0.048, 0.041, 0.046, 0.036, 0.038, 0.038, 0.049, 0.087, 0.111, 0.090, 0.067, 0.044, 0.031".
2354
+ .. [#] 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.097, 1.097, 0.991, 0.987, 0.991, 0.890, 0.896, 0.896, 0.890, 1.085, 1.085, 1.097".
1940
2355
 
1941
2356
  If the RatedAnnualkWh or EnergyFactor is provided, a complete set of EnergyGuide label information is entered in ``Dishwasher``.
1942
2357
 
@@ -1963,7 +2378,7 @@ If not entered, the simulation will not include a refrigerator.
1963
2378
  ===================================================== ======= ====== =========== ======== ======== ======================================
1964
2379
  ``SystemIdentifier`` id Yes Unique identifier
1965
2380
  ``Location`` string See [#]_ No See [#]_ Location
1966
- ``RatedAnnualkWh`` or ``extension/AdjustedAnnualkWh`` double kWh/yr > 0 No See [#]_ Annual consumption
2381
+ ``RatedAnnualkWh`` double kWh/yr > 0 No See [#]_ Annual consumption
1967
2382
  ``PrimaryIndicator`` boolean See [#]_ Primary refrigerator?
1968
2383
  ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on energy use
1969
2384
  ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
@@ -1975,11 +2390,11 @@ If not entered, the simulation will not include a refrigerator.
1975
2390
  See :ref:`hpxmllocations` for descriptions.
1976
2391
  .. [#] If Location not provided and is the *primary* refrigerator, defaults to "living space".
1977
2392
  If Location not provided and is a *secondary* refrigerator, defaults to the first present space type: "garage", "basement - unconditioned", "basement - conditioned", or "living space".
1978
- .. [#] If neither RatedAnnualkWh nor AdjustedAnnualkWh 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>`_:
2393
+ .. [#] 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>`_:
1979
2394
  RatedAnnualkWh = 637.0 + 18.0 * NumberofBedrooms.
1980
2395
  .. [#] If multiple refrigerators are specified, there must be exactly one refrigerator described with PrimaryIndicator=true.
1981
- .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided, 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".
1982
- .. [#] If MonthlyScheduleMultipliers not provided, 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".
2396
+ .. [#] 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".
2397
+ .. [#] 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".
1983
2398
 
1984
2399
  HPXML Freezers
1985
2400
  **************
@@ -1992,7 +2407,7 @@ If not entered, the simulation will not include a standalone freezer.
1992
2407
  ===================================================== ====== ====== =========== ======== ========== ======================================
1993
2408
  ``SystemIdentifier`` id Yes Unique identifier
1994
2409
  ``Location`` string See [#]_ No See [#]_ Location
1995
- ``RatedAnnualkWh`` or ``extension/AdjustedAnnualkWh`` double kWh/yr > 0 No 319.8 [#]_ Annual consumption
2410
+ ``RatedAnnualkWh`` double kWh/yr > 0 No 319.8 [#]_ Annual consumption
1996
2411
  ``extension/UsageMultiplier`` double >= 0 No 1.0 Multiplier on energy use
1997
2412
  ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
1998
2413
  ``extension/WeekendScheduleFractions`` array No 24 comma-separated weekend fractions
@@ -2003,8 +2418,8 @@ If not entered, the simulation will not include a standalone freezer.
2003
2418
  See :ref:`hpxmllocations` for descriptions.
2004
2419
  .. [#] If Location not provided, defaults to "garage" if present, otherwise "basement - unconditioned" if present, otherwise "basement - conditioned" if present, otherwise "living space".
2005
2420
  .. [#] RatedAnnualkWh default based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_.
2006
- .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided, 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".
2007
- .. [#] If MonthlyScheduleMultipliers not provided, 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".
2421
+ .. [#] 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".
2422
+ .. [#] 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".
2008
2423
 
2009
2424
  HPXML Dehumidifier
2010
2425
  ******************
@@ -2056,8 +2471,8 @@ If not entered, the simulation will not include a cooking range/oven.
2056
2471
  .. [#] 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".
2057
2472
  See :ref:`hpxmllocations` for descriptions.
2058
2473
  .. [#] 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".
2059
- .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided, 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".
2060
- .. [#] If MonthlyScheduleMultipliers not provided, 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.097, 1.097, 0.991, 0.987, 0.991, 0.890, 0.896, 0.896, 0.890, 1.085, 1.085, 1.097".
2474
+ .. [#] 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".
2475
+ .. [#] 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.097, 1.097, 0.991, 0.987, 0.991, 0.890, 0.896, 0.896, 0.890, 1.085, 1.085, 1.097".
2061
2476
 
2062
2477
  If a cooking range is specified, a single oven is also entered as a ``/HPXML/Building/BuildingDetails/Appliances/Oven``.
2063
2478
 
@@ -2120,9 +2535,9 @@ Additional information is entered in ``Lighting``.
2120
2535
  ``extension/ExteriorHolidayLighting`` element 0 - 1 No <none> Presence of additional holiday lighting?
2121
2536
  ================================================ ======= ====== =========== ======== ======== ===============================================
2122
2537
 
2123
- .. [#] If *interior* schedule values not provided, they will be calculated using Lighting Calculation Option 2 (location-dependent lighting profile) of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_.
2124
- .. [#] If *garage* schedule values not provided, they will be defaulted using Appendix C Table 8 of the `Title 24 2016 Res. ACM Manual <https://ww2.energy.ca.gov/2015publications/CEC-400-2015-024/CEC-400-2015-024-CMF-REV2.pdf>`_.
2125
- .. [#] If *exterior* schedule values not provided, they will be defaulted using Appendix C Table 8 of the `Title 24 2016 Res. ACM Manual <https://ww2.energy.ca.gov/2015publications/CEC-400-2015-024/CEC-400-2015-024-CMF-REV2.pdf>`_.
2538
+ .. [#] If *interior* schedule values not provided (and :ref:`detailedschedules` not used), they will be calculated using Lighting Calculation Option 2 (location-dependent lighting profile) of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_.
2539
+ .. [#] If *garage* schedule values not provided (and :ref:`detailedschedules` not used), they will be defaulted using Appendix C Table 8 of the `Title 24 2016 Res. ACM Manual <https://ww2.energy.ca.gov/2015publications/CEC-400-2015-024/CEC-400-2015-024-CMF-REV2.pdf>`_.
2540
+ .. [#] If *exterior* schedule values not provided (and :ref:`detailedschedules` not used), they will be defaulted using Appendix C Table 8 of the `Title 24 2016 Res. ACM Manual <https://ww2.energy.ca.gov/2015publications/CEC-400-2015-024/CEC-400-2015-024-CMF-REV2.pdf>`_.
2126
2541
 
2127
2542
  If exterior holiday lighting is specified, additional information is entered in ``extension/ExteriorHolidayLighting``.
2128
2543
 
@@ -2139,7 +2554,7 @@ If exterior holiday lighting is specified, additional information is entered in
2139
2554
  =============================== ======= ======= =========== ======== ============= ============================================
2140
2555
 
2141
2556
  .. [#] If Value not provided, defaults to 1.1 for single-family detached and 0.55 for others.
2142
- .. [#] If WeekdayScheduleFractions not provided, defaults to "0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0.008, 0.098, 0.168, 0.194, 0.284, 0.192, 0.037, 0.019".
2557
+ .. [#] If WeekdayScheduleFractions not provided (and :ref:`detailedschedules` not used), defaults to "0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0.008, 0.098, 0.168, 0.194, 0.284, 0.192, 0.037, 0.019".
2143
2558
 
2144
2559
  Interior, exterior, and garage lighting energy use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_.
2145
2560
 
@@ -2155,10 +2570,15 @@ If not entered, the simulation will not include a ceiling fan.
2155
2570
  ``SystemIdentifier`` id Yes Unique identifier
2156
2571
  ``Airflow[FanSpeed="medium"]/Efficiency`` double cfm/W > 0 No See [#]_ Efficiency at medium speed
2157
2572
  ``Quantity`` integer > 0 No See [#]_ Number of similar ceiling fans
2573
+ ``extension/WeekdayScheduleFractions`` array No See [#]_ 24 comma-separated weekday fractions
2574
+ ``extension/WeekendScheduleFractions`` array No 24 comma-separated weekend fractions
2575
+ ``extension/MonthlyScheduleMultipliers`` array No See [#]_ 12 comma-separated monthly multipliers
2158
2576
  ========================================= ======= ======= =========== ======== ======== ==============================
2159
2577
 
2160
2578
  .. [#] If Efficiency not provided, defaults to 3000 / 42.6 based on `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_.
2161
2579
  .. [#] If Quantity not provided, defaults to NumberofBedrooms + 1 based on `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_.
2580
+ .. [#] 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.057, 0.057, 0.057, 0.057, 0.057, 0.057, 0.057, 0.024, 0.024, 0.024, 0.024, 0.024, 0.024, 0.024, 0.024, 0.024, 0.024, 0.024, 0.057, 0.057, 0.057, 0.057, 0.057, 0.057".
2581
+ .. [#] If MonthlyScheduleMultipliers not provided (and :ref:`detailedschedules` not used), defaults based on monthly average outdoor temperatures per `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_
2162
2582
 
2163
2583
  Ceiling fan energy use is calculated per the Energy Rating Rated Home in `ANSI/RESNET/ICC 301-2019 <https://codes.iccsafe.org/content/RESNETICC3012019>`_.
2164
2584
 
@@ -2207,8 +2627,8 @@ If not entered, the simulation will not include a pool heater.
2207
2627
  .. [#] Type choices are "single speed", "multi speed", "variable speed", "variable flow", "other", "unknown", or "none".
2208
2628
  If "none" is entered, the simulation will not include a pool pump.
2209
2629
  .. [#] If Value not provided, defaults based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_: 158.5 / 0.070 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.35 * ConditionedFloorArea / 1920).
2210
- .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided, 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".
2211
- .. [#] If MonthlyScheduleMultipliers not provided, 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".
2630
+ .. [#] 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".
2631
+ .. [#] 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".
2212
2632
 
2213
2633
  Pool Heater
2214
2634
  ~~~~~~~~~~~
@@ -2236,8 +2656,8 @@ If not entered, the simulation will not include a pool heater.
2236
2656
  - **electric resistance**: 8.3 / 0.004 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.35 * ConditionedFloorArea / 1920) (based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
2237
2657
  - **heat pump**: (electric resistance) / 5.0 (based on an average COP of 5 from `Energy Saver <https://www.energy.gov/energysaver/heat-pump-swimming-pool-heaters>`_)
2238
2658
 
2239
- .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided, 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".
2240
- .. [#] If MonthlyScheduleMultipliers not provided, 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".
2659
+ .. [#] 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".
2660
+ .. [#] 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".
2241
2661
 
2242
2662
  HPXML Hot Tubs
2243
2663
  **************
@@ -2276,8 +2696,8 @@ If not entered, the simulation will not include a hot tub pump.
2276
2696
  .. [#] Type choices are "single speed", "multi speed", "variable speed", "variable flow", "other", "unknown", or "none".
2277
2697
  If "none" is entered, the simulation will not include a hot tub pump.
2278
2698
  .. [#] 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.35 * ConditionedFloorArea / 1920).
2279
- .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided, 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".
2280
- .. [#] If MonthlyScheduleMultipliers not provided, 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".
2699
+ .. [#] 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".
2700
+ .. [#] 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".
2281
2701
 
2282
2702
  Hot Tub Heater
2283
2703
  ~~~~~~~~~~~~~~
@@ -2305,8 +2725,8 @@ If not entered, the simulation will not include a hot tub heater.
2305
2725
  - **electric resistance [kWh/year]**: 49.0 / 0.048 * (0.5 + 0.25 * NumberofBedrooms / 3 + 0.35 * ConditionedFloorArea / 1920) (based on the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_)
2306
2726
  - **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>`_)
2307
2727
 
2308
- .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided, 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".
2309
- .. [#] If MonthlyScheduleMultipliers not provided, 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".
2728
+ .. [#] 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".
2729
+ .. [#] 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".
2310
2730
 
2311
2731
  HPXML Misc Loads
2312
2732
  ----------------
@@ -2360,21 +2780,21 @@ If not entered, the simulation will not include that type of plug load.
2360
2780
  - **well pump**: 0.0
2361
2781
  - **electric vehicle charging**: 0.0
2362
2782
 
2363
- .. [#] If WeekdayScheduleFractions not provided, defaults as:
2783
+ .. [#] If WeekdayScheduleFractions not provided (and :ref:`detailedschedules` not used), defaults as:
2364
2784
 
2365
2785
  - **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>`_)
2366
2786
  - **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>`_)
2367
2787
  - **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>`_)
2368
2788
  - **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"
2369
2789
 
2370
- .. [#] If WeekdendScheduleFractions not provided, defaults as:
2790
+ .. [#] If WeekdendScheduleFractions not provided (and :ref:`detailedschedules` not used), defaults as:
2371
2791
 
2372
2792
  - **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>`_)
2373
2793
  - **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>`_)
2374
2794
  - **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>`_)
2375
2795
  - **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"
2376
2796
 
2377
- .. [#] If MonthlyScheduleMultipliers not provided, defaults as:
2797
+ .. [#] If MonthlyScheduleMultipliers not provided (and :ref:`detailedschedules` not used), defaults as:
2378
2798
 
2379
2799
  - **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>`_)
2380
2800
  - **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>`_)
@@ -2415,13 +2835,13 @@ If not entered, the simulation will not include that type of fuel load.
2415
2835
  .. [#] If FracSensible not provided, defaults to 0.5 for fireplace and 0.0 for all other types.
2416
2836
  .. [#] 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.
2417
2837
  .. [#] If FracLatent not provided, defaults to 0.1 for fireplace and 0.0 for all other types.
2418
- .. [#] If WeekdayScheduleFractions or WeekendScheduleFractions not provided, default values from Figure 23 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used:
2838
+ .. [#] 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:
2419
2839
 
2420
2840
  - **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";
2421
2841
  - **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";
2422
2842
  - **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".
2423
2843
 
2424
- .. [#] If MonthlyScheduleMultipliers not provided, default values from Figure 24 of the `2010 BAHSP <https://www1.eere.energy.gov/buildings/publications/pdfs/building_america/house_simulation.pdf>`_ are used:
2844
+ .. [#] 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:
2425
2845
 
2426
2846
  - **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";
2427
2847
  - **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";
@@ -2439,13 +2859,14 @@ The various locations used in an HPXML file are defined as follows:
2439
2859
  ============================== ======================================================= ======================================= =============
2440
2860
  outside Ambient environment Weather data Any
2441
2861
  ground EnergyPlus calculation Any
2442
- living space Above-grade conditioned floor area EnergyPlus calculation Any
2862
+ living space Above-grade conditioned space maintained at setpoint EnergyPlus calculation Any
2443
2863
  attic - vented EnergyPlus calculation Any
2444
2864
  attic - unvented EnergyPlus calculation Any
2445
- basement - conditioned Below-grade conditioned floor area EnergyPlus calculation Any
2865
+ basement - conditioned Below-grade conditioned space maintained at setpoint EnergyPlus calculation Any
2446
2866
  basement - unconditioned EnergyPlus calculation Any
2447
2867
  crawlspace - vented EnergyPlus calculation Any
2448
2868
  crawlspace - unvented EnergyPlus calculation Any
2869
+ crawlspace - conditioned Below-grade conditioned space maintained at setpoint EnergyPlus calculation Any
2449
2870
  garage Single-family garage (not shared parking) EnergyPlus calculation Any
2450
2871
  other housing unit E.g., conditioned adjacent unit or conditioned corridor Same as living space SFA/MF only
2451
2872
  other heated space E.g., shared laundry/equipment space Avg of living space/outside; min of 68F SFA/MF only