Adding flexibility to specify location of the radiant barrier

.gitignore

@@ -1009,7 +1009,7 @@
 /workflow/tests/run
 /workflow/tests/test*
 /workflow/sample_files/results
-/workflow/sample_files/run
+/workflow/sample_files/run*/
 /files
 /BuildResidentialHPXML/tests/extra_files
 /ReportUtilityBills/resources/detailed_rates/*.json

BuildResidentialHPXML/README.md

@@ -1039,22 +1039,24 @@ Assembly R-value of the roof.
 
 <br/>
 
-**Roof: Has Radiant Barrier**
+**Attic: Radiant Barrier Location**
 
-Presence of a radiant barrier in the attic.
+The location of the radiant barrier in the attic.
 
-- **Name:** ``roof_radiant_barrier``
-- **Type:** ``Boolean``
+- **Name:** ``radiant_barrier_attic_location``
+- **Type:** ``Choice``
 
-- **Required:** ``true``
+- **Required:** ``false``
+
+- **Choices:** `none`, `Attic roof only`, `Attic roof and gable walls`, `Attic floor`
 
 <br/>
 
-**Roof: Radiant Barrier Grade**
+**Attic: Radiant Barrier Grade**
 
-The grade of the radiant barrier. If not provided, the OS-HPXML default (see <a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-roofs'>HPXML Roofs</a>) is used.
+The grade of the radiant barrier in the attic. If not provided, the OS-HPXML default (see <a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-roofs'>HPXML Roofs</a>) is used.
 
-- **Name:** ``roof_radiant_barrier_grade``
+- **Name:** ``radiant_barrier_grade``
 - **Type:** ``Choice``
 
 - **Required:** ``false``

BuildResidentialHPXML/measure.rb

@@ -656,20 +656,25 @@ def arguments(model) # rubocop:disable Lint/UnusedMethodArgument
     arg.setDefaultValue(2.3)
     args << arg
 
-    arg = OpenStudio::Measure::OSArgument::makeBoolArgument('roof_radiant_barrier', true)
-    arg.setDisplayName('Roof: Has Radiant Barrier')
-    arg.setDescription('Presence of a radiant barrier in the attic.')
-    arg.setDefaultValue(false)
+    radiant_barrier_attic_location_choices = OpenStudio::StringVector.new
+    radiant_barrier_attic_location_choices << 'none'
+    radiant_barrier_attic_location_choices << HPXML::RadiantBarrierLocationAtticRoofOnly
+    radiant_barrier_attic_location_choices << HPXML::RadiantBarrierLocationAtticRoofAndGableWalls
+    radiant_barrier_attic_location_choices << HPXML::RadiantBarrierLocationAtticFloor
+
+    arg = OpenStudio::Measure::OSArgument::makeChoiceArgument('radiant_barrier_attic_location', radiant_barrier_attic_location_choices, false)
+    arg.setDisplayName('Attic: Radiant Barrier Location')
+    arg.setDescription('The location of the radiant barrier in the attic.')
     args << arg
 
-    roof_radiant_barrier_grade_choices = OpenStudio::StringVector.new
-    roof_radiant_barrier_grade_choices << '1'
-    roof_radiant_barrier_grade_choices << '2'
-    roof_radiant_barrier_grade_choices << '3'
+    radiant_barrier_grade_choices = OpenStudio::StringVector.new
+    radiant_barrier_grade_choices << '1'
+    radiant_barrier_grade_choices << '2'
+    radiant_barrier_grade_choices << '3'
 
-    arg = OpenStudio::Measure::OSArgument::makeChoiceArgument('roof_radiant_barrier_grade', roof_radiant_barrier_grade_choices, false)
-    arg.setDisplayName('Roof: Radiant Barrier Grade')
-    arg.setDescription("The grade of the radiant barrier. If not provided, the OS-HPXML default (see <a href='#{docs_base_url}#hpxml-roofs'>HPXML Roofs</a>) is used.")
+    arg = OpenStudio::Measure::OSArgument::makeChoiceArgument('radiant_barrier_grade', radiant_barrier_grade_choices, false)
+    arg.setDisplayName('Attic: Radiant Barrier Grade')
+    arg.setDescription("The grade of the radiant barrier in the attic. If not provided, the OS-HPXML default (see <a href='#{docs_base_url}#hpxml-roofs'>HPXML Roofs</a>) is used.")
     args << arg
 
     wall_type_choices = OpenStudio::StringVector.new
@@ -4325,11 +4330,6 @@ def self.set_roofs(hpxml_bldg, args, sorted_surfaces)
         roof_color = args[:roof_color].get
       end
 
-      radiant_barrier = args[:roof_radiant_barrier]
-      if args[:roof_radiant_barrier] && args[:roof_radiant_barrier_grade].is_initialized
-        radiant_barrier_grade = args[:roof_radiant_barrier_grade].get
-      end
-
       if args[:geometry_attic_type] == HPXML::AtticTypeFlatRoof
         azimuth = nil
       else
@@ -4343,10 +4343,16 @@ def self.set_roofs(hpxml_bldg, args, sorted_surfaces)
                            roof_type: roof_type,
                            roof_color: roof_color,
                            pitch: args[:geometry_roof_pitch],
-                           radiant_barrier: radiant_barrier,
-                           radiant_barrier_grade: radiant_barrier_grade,
                            insulation_assembly_r_value: args[:roof_assembly_r])
       @surface_ids[surface.name.to_s] = hpxml_bldg.roofs[-1].id
+
+      next unless [HPXML::RadiantBarrierLocationAtticRoofOnly, HPXML::RadiantBarrierLocationAtticRoofAndGableWalls].include?(args[:radiant_barrier_attic_location].to_s)
+      next unless [HPXML::LocationAtticUnvented, HPXML::LocationAtticVented].include?(hpxml_bldg.roofs[-1].interior_adjacent_to)
+
+      hpxml_bldg.roofs[-1].radiant_barrier = true
+      if args[:radiant_barrier_grade].is_initialized
+        hpxml_bldg.roofs[-1].radiant_barrier_grade = args[:radiant_barrier_grade].get
+      end
     end
   end
 
@@ -4481,6 +4487,14 @@ def self.set_walls(hpxml_bldg, model, args, sorted_surfaces)
       else
         hpxml_bldg.walls[-1].insulation_assembly_r_value = 4.0 # Uninsulated
       end
+
+      next unless hpxml_bldg.walls[-1].attic_wall_type == HPXML::AtticWallTypeGable && args[:radiant_barrier_attic_location].to_s == HPXML::RadiantBarrierLocationAtticRoofAndGableWalls
+      next unless [HPXML::LocationAtticUnvented, HPXML::LocationAtticVented].include?(hpxml_bldg.walls[-1].interior_adjacent_to)
+
+      hpxml_bldg.walls[-1].radiant_barrier = true
+      if args[:radiant_barrier_grade].is_initialized
+        hpxml_bldg.walls[-1].radiant_barrier_grade = args[:radiant_barrier_grade].get
+      end
     end
   end
 
@@ -4638,6 +4652,14 @@ def self.set_floors(hpxml_bldg, args, sorted_surfaces)
       else
         hpxml_bldg.floors[-1].insulation_assembly_r_value = 2.1 # Uninsulated
       end
+
+      next unless args[:radiant_barrier_attic_location].to_s == HPXML::RadiantBarrierLocationAtticFloor
+      next unless [HPXML::LocationAtticUnvented, HPXML::LocationAtticVented].include?(hpxml_bldg.floors[-1].exterior_adjacent_to) && hpxml_bldg.floors[-1].interior_adjacent_to == HPXML::LocationConditionedSpace
+
+      hpxml_bldg.floors[-1].radiant_barrier = true
+      if args[:radiant_barrier_grade].is_initialized
+        hpxml_bldg.floors[-1].radiant_barrier_grade = args[:radiant_barrier_grade].get
+      end
     end
   end
 

BuildResidentialHPXML/measure.xml

@@ -3,8 +3,8 @@
   <schema_version>3.1</schema_version>
   <name>build_residential_hpxml</name>
   <uid>a13a8983-2b01-4930-8af2-42030b6e4233</uid>
-  <version_id>131fc59f-57f8-4530-804b-d1c5e9ccc166</version_id>
-  <version_modified>2023-12-20T20:22:01Z</version_modified>
+  <version_id>5c120a24-790f-45d1-8928-39587e156f33</version_id>
+  <version_modified>2023-12-21T21:32:12Z</version_modified>
   <xml_checksum>2C38F48B</xml_checksum>
   <class_name>BuildResidentialHPXML</class_name>
   <display_name>HPXML Builder</display_name>
@@ -1481,28 +1481,35 @@
       <default_value>2.3</default_value>
     </argument>
     <argument>
-      <name>roof_radiant_barrier</name>
-      <display_name>Roof: Has Radiant Barrier</display_name>
-      <description>Presence of a radiant barrier in the attic.</description>
-      <type>Boolean</type>
-      <required>true</required>
+      <name>radiant_barrier_attic_location</name>
+      <display_name>Attic: Radiant Barrier Location</display_name>
+      <description>The location of the radiant barrier in the attic.</description>
+      <type>Choice</type>
+      <required>false</required>
       <model_dependent>false</model_dependent>
-      <default_value>false</default_value>
       <choices>
         <choice>
-          <value>true</value>
-          <display_name>true</display_name>
+          <value>none</value>
+          <display_name>none</display_name>
         </choice>
         <choice>
-          <value>false</value>
-          <display_name>false</display_name>
+          <value>Attic roof only</value>
+          <display_name>Attic roof only</display_name>
+        </choice>
+        <choice>
+          <value>Attic roof and gable walls</value>
+          <display_name>Attic roof and gable walls</display_name>
+        </choice>
+        <choice>
+          <value>Attic floor</value>
+          <display_name>Attic floor</display_name>
         </choice>
       </choices>
     </argument>
     <argument>
-      <name>roof_radiant_barrier_grade</name>
-      <display_name>Roof: Radiant Barrier Grade</display_name>
-      <description>The grade of the radiant barrier. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-roofs'&gt;HPXML Roofs&lt;/a&gt;) is used.</description>
+      <name>radiant_barrier_grade</name>
+      <display_name>Attic: Radiant Barrier Grade</display_name>
+      <description>The grade of the radiant barrier in the attic. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-roofs'&gt;HPXML Roofs&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -6998,7 +7005,7 @@
       <filename>README.md</filename>
       <filetype>md</filetype>
       <usage_type>readme</usage_type>
-      <checksum>CCBF3E74</checksum>
+      <checksum>58036A34</checksum>
     </file>
     <file>
       <filename>README.md.erb</filename>
@@ -7015,7 +7022,7 @@
       <filename>measure.rb</filename>
       <filetype>rb</filetype>
       <usage_type>script</usage_type>
-      <checksum>000C8235</checksum>
+      <checksum>17ACCED3</checksum>
     </file>
     <file>
       <filename>geometry.rb</filename>
@@ -7027,7 +7034,7 @@
       <filename>test_build_residential_hpxml.rb</filename>
       <filetype>rb</filetype>
       <usage_type>test</usage_type>
-      <checksum>544C00A5</checksum>
+      <checksum>EDC4A88B</checksum>
     </file>
   </files>
 </measure>

BuildResidentialHPXML/tests/test_build_residential_hpxml.rb

@@ -422,8 +422,8 @@ def _set_measure_argument_values(hpxml_file, args)
       args['roof_material_type'] = HPXML::RoofTypeAsphaltShingles
       args['roof_color'] = HPXML::ColorMedium
       args['roof_assembly_r'] = 2.3
-      args['roof_radiant_barrier'] = false
-      args['roof_radiant_barrier_grade'] = 1
+      args['radiant_barrier_attic_location'] = 'none'
+      args['radiant_barrier_grade'] = 1
       args['neighbor_front_distance'] = 0
       args['neighbor_back_distance'] = 0
       args['neighbor_left_distance'] = 0

Changelog.md

@@ -2,12 +2,14 @@
 
 __New Features__
 - Replaces `BuildingSummary/Site/extension/GroundConductivity` with `BuildingSummary/Site/Soil/Conductivity`.
+- Allows radiant barriers for additional locations (attic gable walls and floor); reduced emissivity due to dust assumed for radiant barriers on attic floor.
 - Ground source heat pump enhancements:
   - Allows optional detailed inputs related to geothermal loop (`HVACPlant/GeothermalLoop`).
   - Allows optional ground diffusivity input.
   - Updates to using G-Functions from the [G-Function Library for Modeling Vertical Bore Ground Heat Exchanger](https://gdr.openei.org/submissions/1325).
   - Updated heating/cooling performance curves to reflect newer equipment.
 - BuildResidentialHPXML measure:
+  - **Breaking change**: Replaces `roof_radiant_barrier`/`roof_radiant_barrier_grade` arguments with `radiant_barrier_attic_location`/`radiant_barrier_grade`.
   - Add soil and moisture type arguments (for determining ground conductivity and diffusivity) and optional geothermal loop arguments for ground source heat pumps.
 - Adds more error-checking for inappropriate inputs (e.g., HVAC SHR=0 or clothes washer IMEF=0).
 

HPXMLtoOpenStudio/measure.rb

@@ -734,7 +734,10 @@ def add_walls(runner, model, spaces)
       # Apply construction
       # The code below constructs a reasonable wall construction based on the
       # wall type while ensuring the correct assembly R-value.
-
+      has_radiant_barrier = wall.radiant_barrier
+      if has_radiant_barrier
+        radiant_barrier_grade = wall.radiant_barrier_grade
+      end
       inside_film = Material.AirFilmVertical
       if wall.is_exterior
         outside_film = Material.AirFilmOutside
@@ -750,7 +753,8 @@ def add_walls(runner, model, spaces)
       mat_int_finish = Material.InteriorFinishMaterial(wall.interior_finish_type, wall.interior_finish_thickness)
 
       Constructions.apply_wall_construction(runner, model, surfaces, wall.id, wall.wall_type, wall.insulation_assembly_r_value,
-                                            mat_int_finish, inside_film, outside_film, mat_ext_finish, wall.solar_absorptance,
+                                            mat_int_finish, has_radiant_barrier, inside_film, outside_film,
+                                            radiant_barrier_grade, mat_ext_finish, wall.solar_absorptance,
                                             wall.emittance)
     end
   end
@@ -876,6 +880,10 @@ def add_floors(runner, model, spaces)
           outside_film = Material.AirFilmFloorAverage
         end
         mat_int_finish_or_covering = Material.InteriorFinishMaterial(floor.interior_finish_type, floor.interior_finish_thickness)
+        has_radiant_barrier = floor.radiant_barrier
+        if has_radiant_barrier
+          radiant_barrier_grade = floor.radiant_barrier_grade
+        end
       else # Floor
         if @apply_ashrae140_assumptions
           # Raised floor
@@ -897,7 +905,7 @@ def add_floors(runner, model, spaces)
       end
 
       Constructions.apply_floor_ceiling_construction(runner, model, [surface], floor.id, floor.floor_type, floor.is_ceiling, floor.insulation_assembly_r_value,
-                                                     mat_int_finish_or_covering, inside_film, outside_film)
+                                                     mat_int_finish_or_covering, has_radiant_barrier, inside_film, outside_film, radiant_barrier_grade)
     end
   end
 
@@ -1000,8 +1008,20 @@ def add_foundation_walls_slabs(runner, model, weather, spaces)
         end
         mat_ext_finish = nil
 
-        Constructions.apply_wall_construction(runner, model, [surface], fnd_wall.id, wall_type, assembly_r,
-                                              mat_int_finish, inside_film, outside_film, mat_ext_finish, nil, nil)
+        Constructions.apply_wall_construction(runner,
+                                              model,
+                                              [surface],
+                                              fnd_wall.id,
+                                              wall_type,
+                                              assembly_r,
+                                              mat_int_finish,
+                                              false,
+                                              inside_film,
+                                              outside_film,
+                                              nil,
+                                              mat_ext_finish,
+                                              nil,
+                                              nil)
       end
     end
   end
@@ -1458,12 +1478,12 @@ def apply_adiabatic_construction(model, surfaces, type)
       mat_int_finish = Material.InteriorFinishMaterial(HPXML::InteriorFinishGypsumBoard, 0.5)
       mat_ext_finish = Material.ExteriorFinishMaterial(HPXML::SidingTypeWood)
       Constructions.apply_wood_stud_wall(model, surfaces, 'AdiabaticWallConstruction',
-                                         0, 1, 3.5, true, 0.1, mat_int_finish, 0, 99, mat_ext_finish,
-                                         Material.AirFilmVertical, Material.AirFilmVertical)
+                                         0, 1, 3.5, true, 0.1, mat_int_finish, 0, 99, mat_ext_finish, false,
+                                         Material.AirFilmVertical, Material.AirFilmVertical, nil)
     elsif type == 'floor'
       Constructions.apply_wood_frame_floor_ceiling(model, surfaces, 'AdiabaticFloorConstruction', false,
-                                                   0, 1, 0.07, 5.5, 0.75, 99, Material.CoveringBare,
-                                                   Material.AirFilmFloorReduced, Material.AirFilmFloorReduced)
+                                                   0, 1, 0.07, 5.5, 0.75, 99, Material.CoveringBare, false,
+                                                   Material.AirFilmFloorReduced, Material.AirFilmFloorReduced, nil)
     elsif type == 'roof'
       Constructions.apply_open_cavity_roof(model, surfaces, 'AdiabaticRoofConstruction',
                                            0, 1, 7.25, 0.07, 7.25, 0.75, 99,