Split out Other and TV plug loads

docs/read_the_docs/source/workflow_inputs/characteristics.rst

@@ -7146,6 +7146,12 @@ Arguments
      - Type
      - Choices
      - Description
+   * - ``misc_plug_loads_television_2_usage_multiplier``
+     - true
+     - 
+     - Double
+     -
+     - Additional multiplier on the television energy usage that can reflect, e.g., high/low usage occupants.
    * - ``misc_plug_loads_other_2_usage_multiplier``
      - true
      - 
@@ -7198,6 +7204,18 @@ Arguments
      - Boolean
      - "true", "false"
      - Whether there are televisions.
+   * - ``misc_plug_loads_television_annual_kwh``
+     - false
+     - kWh/yr
+     - Double
+     - "auto"
+     - The annual energy consumption of the television plug loads. If not provided, the OS-HPXML default (see `HPXML Plug Loads <https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-plug-loads>`_) is used.
+   * - ``misc_plug_loads_television_usage_multiplier``
+     - false
+     - 
+     - Double
+     - "auto"
+     - Multiplier on the television energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default (see `HPXML Plug Loads <https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-plug-loads>`_) is used.
    * - ``misc_plug_loads_other_annual_kwh``
      - false
      - kWh/yr

measures/ResStockArguments/README.md

@@ -4449,6 +4449,28 @@ Whether there are televisions.
 
 <br/>
 
+**Misc Plug Loads: Television Annual kWh**
+
+The annual energy consumption of the television plug loads. If not provided, the OS-HPXML default (see <a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-plug-loads'>HPXML Plug Loads</a>) is used.
+
+- **Name:** ``misc_plug_loads_television_annual_kwh``
+- **Type:** ``String``
+
+- **Required:** ``false``
+
+<br/>
+
+**Misc Plug Loads: Television Usage Multiplier**
+
+Multiplier on the television energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default (see <a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-plug-loads'>HPXML Plug Loads</a>) is used.
+
+- **Name:** ``misc_plug_loads_television_usage_multiplier``
+- **Type:** ``String``
+
+- **Required:** ``false``
+
+<br/>
+
 **Misc Plug Loads: Other Annual kWh**
 
 The annual energy consumption of the other residual plug loads. If not provided, the OS-HPXML default (see <a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-plug-loads'>HPXML Plug Loads</a>) is used.
@@ -5064,6 +5086,17 @@ Reduction (%) on the air exchange rate value.
 
 <br/>
 
+**Plug Loads: Television Usage Multiplier 2**
+
+Additional multiplier on the television energy usage that can reflect, e.g., high/low usage occupants.
+
+- **Name:** ``misc_plug_loads_television_2_usage_multiplier``
+- **Type:** ``Double``
+
+- **Required:** ``true``
+
+<br/>
+
 **Plug Loads: Other Usage Multiplier 2**
 
 Additional multiplier on the other energy usage that can reflect, e.g., high/low usage occupants.

measures/ResStockArguments/measure.rb

@@ -188,6 +188,12 @@ def arguments(model)
     arg.setDescription('Reduction (%) on the air exchange rate value.')
     args << arg
 
+    arg = OpenStudio::Measure::OSArgument::makeDoubleArgument('misc_plug_loads_television_2_usage_multiplier', true)
+    arg.setDisplayName('Plug Loads: Television Usage Multiplier 2')
+    arg.setDescription('Additional multiplier on the television energy usage that can reflect, e.g., high/low usage occupants.')
+    arg.setDefaultValue(1.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.')
@@ -452,19 +458,30 @@ def run(model, runner, user_arguments)
     end
 
     # Plug Loads
-    args[:misc_plug_loads_television_annual_kwh] = 0.0 # "other" now accounts for television
-    args[:misc_plug_loads_television_usage_multiplier] = 0.0 # "other" now accounts for television
+    args[:misc_plug_loads_television_usage_multiplier] = Float(args[:misc_plug_loads_television_usage_multiplier].to_s) * args[:misc_plug_loads_television_2_usage_multiplier]
     args[:misc_plug_loads_other_usage_multiplier] = Float(args[:misc_plug_loads_other_usage_multiplier].to_s) * args[:misc_plug_loads_other_2_usage_multiplier]
     args[:misc_plug_loads_well_pump_usage_multiplier] = Float(args[:misc_plug_loads_well_pump_usage_multiplier].to_s) * args[:misc_plug_loads_well_pump_2_usage_multiplier]
     args[:misc_plug_loads_vehicle_usage_multiplier] = Float(args[:misc_plug_loads_vehicle_usage_multiplier].to_s) * args[:misc_plug_loads_vehicle_2_usage_multiplier]
 
+    # Television
+    if args[:misc_plug_loads_television_annual_kwh].to_s == Constants.Auto
+      if [HPXML::ResidentialTypeSFD].include?(args[:geometry_unit_type])
+        args[:misc_plug_loads_television_annual_kwh] = 309.9 + 96.11 * args[:geometry_unit_num_occupants] + 0.06 * args[:geometry_unit_cfa] # RECS 2020
+      elsif [HPXML::ResidentialTypeSFA].include?(args[:geometry_unit_type])
+        args[:misc_plug_loads_television_annual_kwh] = 272.66 + 74.16 * args[:geometry_unit_num_occupants] + 0.08 * args[:geometry_unit_cfa] # RECS 2020
+      elsif [HPXML::ResidentialTypeApartment].include?(args[:geometry_unit_type])
+        args[:misc_plug_loads_television_annual_kwh] = 171.97 + 76.09 * args[:geometry_unit_num_occupants] + 0.11 * args[:geometry_unit_cfa] # RECS 2020
+      end
+    end
+
+    # Other
     if args[:misc_plug_loads_other_annual_kwh].to_s == Constants.Auto
       if [HPXML::ResidentialTypeSFD].include?(args[:geometry_unit_type])
-        args[:misc_plug_loads_other_annual_kwh] = 1146.95 + 296.94 * args[:geometry_unit_num_occupants] + 0.3 * args[:geometry_unit_cfa] # RECS 2015
+        args[:misc_plug_loads_other_annual_kwh] = 863.26 + 219.26 * args[:geometry_unit_num_occupants] + 0.33 * args[:geometry_unit_cfa] # RECS 2020
       elsif [HPXML::ResidentialTypeSFA].include?(args[:geometry_unit_type])
-        args[:misc_plug_loads_other_annual_kwh] = 1395.84 + 136.53 * args[:geometry_unit_num_occupants] + 0.16 * args[:geometry_unit_cfa] # RECS 2015
+        args[:misc_plug_loads_other_annual_kwh] = 654.92 + 206.52 * args[:geometry_unit_num_occupants] + 0.21 * args[:geometry_unit_cfa] # RECS 2020
       elsif [HPXML::ResidentialTypeApartment].include?(args[:geometry_unit_type])
-        args[:misc_plug_loads_other_annual_kwh] = 875.22 + 184.11 * args[:geometry_unit_num_occupants] + 0.38 * args[:geometry_unit_cfa] # RECS 2015
+        args[:misc_plug_loads_other_annual_kwh] = 706.6 + 149.27 * args[:geometry_unit_num_occupants] + 0.1 * args[:geometry_unit_cfa] # RECS 2020
       end
     end
 

measures/ResStockArguments/measure.xml

@@ -3,8 +3,8 @@
   <schema_version>3.1</schema_version>
   <name>res_stock_arguments</name>
   <uid>c984bb9e-4ac4-4930-a399-9d23f8f6936a</uid>
-  <version_id>bff8d5c1-2e23-47a2-9c76-c464640e462e</version_id>
-  <version_modified>2024-02-22T20:58:56Z</version_modified>
+  <version_id>45a36b1d-ecc0-4f8b-ac4e-47153f1ae8c1</version_id>
+  <version_modified>2024-02-27T22:40:20Z</version_modified>
   <xml_checksum>2C38F48B</xml_checksum>
   <class_name>ResStockArguments</class_name>
   <display_name>ResStock Arguments</display_name>
@@ -6265,6 +6265,24 @@
         </choice>
       </choices>
     </argument>
+    <argument>
+      <name>misc_plug_loads_television_annual_kwh</name>
+      <display_name>Misc Plug Loads: Television Annual kWh</display_name>
+      <description>The annual energy consumption of the television plug loads. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-plug-loads'&gt;HPXML Plug Loads&lt;/a&gt;) is used.</description>
+      <type>String</type>
+      <units>kWh/yr</units>
+      <required>false</required>
+      <model_dependent>false</model_dependent>
+    </argument>
+    <argument>
+      <name>misc_plug_loads_television_usage_multiplier</name>
+      <display_name>Misc Plug Loads: Television Usage Multiplier</display_name>
+      <description>Multiplier on the television energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-plug-loads'&gt;HPXML Plug Loads&lt;/a&gt;) is used.</description>
+      <type>String</type>
+      <units></units>
+      <required>false</required>
+      <model_dependent>false</model_dependent>
+    </argument>
     <argument>
       <name>misc_plug_loads_other_annual_kwh</name>
       <display_name>Misc Plug Loads: Other Annual kWh</display_name>
@@ -6967,6 +6985,15 @@
       <required>false</required>
       <model_dependent>false</model_dependent>
     </argument>
+    <argument>
+      <name>misc_plug_loads_television_2_usage_multiplier</name>
+      <display_name>Plug Loads: Television Usage Multiplier 2</display_name>
+      <description>Additional multiplier on the television energy usage that can reflect, e.g., high/low usage occupants.</description>
+      <type>Double</type>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+      <default_value>1</default_value>
+    </argument>
     <argument>
       <name>misc_plug_loads_other_2_usage_multiplier</name>
       <display_name>Plug Loads: Other Usage Multiplier 2</display_name>
@@ -7283,7 +7310,7 @@
       <filename>README.md</filename>
       <filetype>md</filetype>
       <usage_type>readme</usage_type>
-      <checksum>03241F20</checksum>
+      <checksum>71128EEA</checksum>
     </file>
     <file>
       <filename>README.md.erb</filename>
@@ -7300,13 +7327,13 @@
       <filename>measure.rb</filename>
       <filetype>rb</filetype>
       <usage_type>script</usage_type>
-      <checksum>17245E1E</checksum>
+      <checksum>96C4DF8E</checksum>
     </file>
     <file>
       <filename>constants.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>0A5D6766</checksum>
+      <checksum>D9BFB98C</checksum>
     </file>
     <file>
       <filename>resstock_arguments_test.rb</filename>

measures/ResStockArguments/resources/constants.rb

@@ -30,8 +30,6 @@ def self.build_residential_hpxml_excludes
             'cooling_system_charge_defect_ratio',
             'heat_pump_airflow_defect_ratio',
             'heat_pump_charge_defect_ratio',
-            'misc_plug_loads_television_annual_kwh',
-            'misc_plug_loads_television_usage_multiplier',
             'pv_system_num_bedrooms_served',
             'battery_num_bedrooms_served',
             'occupancy_calculation_type',