Enable rim joists

CHANGELOG.md

@@ -1,6 +1,7 @@
 ## ResStock v2.6.0 (pending)
 
 Features
+- Enable rim joists for homes with basements/crawlspaces; assumes a height of 9.25 inches and calculates rim joist assembly R-value from new insulation arguments ([#831](https://github.com/NREL/resstock/pull/831))
 - Enable the HEScore workflow to be run with BuildExistingModel ([#782](https://github.com/NREL/resstock/pull/782))
 
 Fixes

measures/ResStockArguments/measure.rb

@@ -48,7 +48,7 @@ def arguments(model)
     measure.arguments(model).each do |arg|
       next if Constants.build_residential_hpxml_excludes.include? arg.name
 
-      # Following are arguments with the same namber but different options
+      # Following are arguments with the same name but different options
       next if arg.name == 'geometry_unit_cfa'
 
       args << arg
@@ -140,6 +140,27 @@ def arguments(model)
     arg.setDefaultValue(10.0)
     args << arg
 
+    arg = OpenStudio::Measure::OSArgument::makeDoubleArgument('rim_joist_continuous_exterior_r', true)
+    arg.setDisplayName('Rim Joist: Continuous Exterior Insulation Nominal R-value')
+    arg.setUnits('h-ft^2-R/Btu')
+    arg.setDescription('Nominal R-value for the rim joist continuous exterior insulation. Only applies to basements/crawlspaces.')
+    arg.setDefaultValue(0)
+    args << arg
+
+    arg = OpenStudio::Measure::OSArgument::makeDoubleArgument('rim_joist_continuous_interior_r', true)
+    arg.setDisplayName('Rim Joist: Continuous Interior Insulation Nominal R-value')
+    arg.setUnits('h-ft^2-R/Btu')
+    arg.setDescription('Nominal R-value for the rim joist continuous interior insulation that runs parallel to floor joists. Only applies to basements/crawlspaces.')
+    arg.setDefaultValue(0)
+    args << arg
+
+    arg = OpenStudio::Measure::OSArgument::makeDoubleArgument('rim_joist_assembly_interior_r', true)
+    arg.setDisplayName('Rim Joist: Interior Assembly R-value')
+    arg.setUnits('h-ft^2-R/Btu')
+    arg.setDescription('Assembly R-value for the rim joist assembly interior insulation that runs perpendicular to floor joists. Only applies to basements/crawlspaces.')
+    arg.setDefaultValue(0)
+    args << arg
+
     arg = OpenStudio::Measure::OSArgument::makeDoubleArgument('misc_plug_loads_other_2_usage_multiplier', true)
     arg.setDisplayName('Plug Loads: Other Usage Multiplier 2')
     arg.setDescription('Additional multiplier on the other energy usage that can reflect, e.g., high/low usage occupants.')
@@ -693,6 +714,32 @@ def run(model, runner, user_arguments)
     # Wall Assembly R-Value
     args['wall_assembly_r'] += args['exterior_finish_r']
 
+    # Rim Joist Assembly R-Value
+    rim_joist_assembly_r = 0
+    if args['geometry_rim_joist_height'].get > 0
+      drywall_assembly_r = 0.9
+      uninsulated_wall_assembly_r = 3.4
+
+      assembly_exterior_r = args['exterior_finish_r'] + args['rim_joist_continuous_exterior_r']
+
+      if args['rim_joist_continuous_interior_r'] > 0 && args['rim_joist_assembly_interior_r'] > 0
+        # rim joist assembly = siding + half continuous interior insulation + half rim joist assembly - drywall
+        # (rim joist assembly = nominal cavity + 1/2 in sheathing + 1/2 in drywall)
+        assembly_interior_r = (args['rim_joist_continuous_interior_r'] + uninsulated_wall_assembly_r - drywall_assembly_r) / 2.0 # parallel to floor joists
+        assembly_interior_r += (args['rim_joist_assembly_interior_r']) / 2.0 # derated
+      elsif args['rim_joist_continuous_interior_r'] > 0 || args['rim_joist_assembly_interior_r'] > 0
+        runner.registerError('ResStockArguments: For rim joist interior insulation, must provide both continuous and assembly R-values.')
+        return false
+      else
+        # rim joist assembly = siding + continuous foundation insulation + uninsulated wall - drywall
+        # (uninsulated wall is nominal cavity + 1/2 in sheating + 1/2 in drywall)
+        assembly_interior_r = uninsulated_wall_assembly_r - drywall_assembly_r
+      end
+
+      rim_joist_assembly_r = assembly_exterior_r + assembly_interior_r
+    end
+    args['rim_joist_assembly_r'] = rim_joist_assembly_r
+
     args.each do |arg_name, arg_value|
       begin
         if arg_value.is_initialized

measures/ResStockArguments/measure.xml

@@ -3,8 +3,8 @@
   <schema_version>3.0</schema_version>
   <name>res_stock_arguments</name>
   <uid>c984bb9e-4ac4-4930-a399-9d23f8f6936a</uid>
-  <version_id>4b0ad06d-584e-4976-a9f9-301c25696a10</version_id>
-  <version_modified>20220204T200355Z</version_modified>
+  <version_id>85eaed03-08a2-49b8-b6a7-915d1ef44205</version_id>
+  <version_modified>20220216T004847Z</version_modified>
   <xml_checksum>2C38F48B</xml_checksum>
   <class_name>ResStockArguments</class_name>
   <display_name>ResStock Arguments</display_name>
@@ -5627,25 +5627,6 @@
       <model_dependent>false</model_dependent>
       <default_value>1</default_value>
     </argument>
-    <argument>
-      <name>apply_defaults</name>
-      <display_name>Apply default values</display_name>
-      <description>Sets OS-HPXML default values in the HPXML output file</description>
-      <type>Boolean</type>
-      <required>false</required>
-      <model_dependent>false</model_dependent>
-      <default_value>false</default_value>
-      <choices>
-        <choice>
-          <value>true</value>
-          <display_name>true</display_name>
-        </choice>
-        <choice>
-          <value>false</value>
-          <display_name>false</display_name>
-        </choice>
-      </choices>
-    </argument>
     <argument>
       <name>emissions_scenario_names</name>
       <display_name>Emissions: Scenario Names</display_name>
@@ -5750,6 +5731,44 @@
       <required>false</required>
       <model_dependent>false</model_dependent>
     </argument>
+    <argument>
+      <name>apply_defaults</name>
+      <display_name>Apply Default Values?</display_name>
+      <description>If true, applies OS-HPXML default values to the HPXML output file.</description>
+      <type>Boolean</type>
+      <required>false</required>
+      <model_dependent>false</model_dependent>
+      <default_value>false</default_value>
+      <choices>
+        <choice>
+          <value>true</value>
+          <display_name>true</display_name>
+        </choice>
+        <choice>
+          <value>false</value>
+          <display_name>false</display_name>
+        </choice>
+      </choices>
+    </argument>
+    <argument>
+      <name>apply_validation</name>
+      <display_name>Apply Validation?</display_name>
+      <description>If true, validates the HPXML output file. Set to false for faster performance. Note that validation is not needed if the HPXML file will be validated downstream (e.g., via the HPXMLtoOpenStudio measure).</description>
+      <type>Boolean</type>
+      <required>false</required>
+      <model_dependent>false</model_dependent>
+      <default_value>false</default_value>
+      <choices>
+        <choice>
+          <value>true</value>
+          <display_name>true</display_name>
+        </choice>
+        <choice>
+          <value>false</value>
+          <display_name>false</display_name>
+        </choice>
+      </choices>
+    </argument>
     <argument>
       <name>schedules_type</name>
       <display_name>Schedules: Type</display_name>
@@ -5917,6 +5936,36 @@
       <model_dependent>false</model_dependent>
       <default_value>10</default_value>
     </argument>
+    <argument>
+      <name>rim_joist_continuous_exterior_r</name>
+      <display_name>Rim Joist: Continuous Exterior Insulation Nominal R-value</display_name>
+      <description>Nominal R-value for the rim joist continuous exterior insulation. Only applies to basements/crawlspaces.</description>
+      <type>Double</type>
+      <units>h-ft^2-R/Btu</units>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+      <default_value>0</default_value>
+    </argument>
+    <argument>
+      <name>rim_joist_continuous_interior_r</name>
+      <display_name>Rim Joist: Continuous Interior Insulation Nominal R-value</display_name>
+      <description>Nominal R-value for the rim joist continuous interior insulation that runs parallel to floor joists. Only applies to basements/crawlspaces.</description>
+      <type>Double</type>
+      <units>h-ft^2-R/Btu</units>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+      <default_value>0</default_value>
+    </argument>
+    <argument>
+      <name>rim_joist_assembly_interior_r</name>
+      <display_name>Rim Joist: Interior Assembly R-value</display_name>
+      <description>Assembly R-value for the rim joist assembly interior insulation that runs perpendicular to floor joists. Only applies to basements/crawlspaces.</description>
+      <type>Double</type>
+      <units>h-ft^2-R/Btu</units>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+      <default_value>0</default_value>
+    </argument>
     <argument>
       <name>misc_plug_loads_other_2_usage_multiplier</name>
       <display_name>Plug Loads: Other Usage Multiplier 2</display_name>
@@ -6218,7 +6267,7 @@
       <filename>measure.rb</filename>
       <filetype>rb</filetype>
       <usage_type>script</usage_type>
-      <checksum>6C7A2B71</checksum>
+      <checksum>3CF47895</checksum>
     </file>
   </files>
 </measure>