Electric panel

docs/read_the_docs/source/workflow_inputs/characteristics.rst

@@ -5406,6 +5406,12 @@ Arguments
      - Type
      - Choices
      - Description
+   * - ``electric_panel_load_cooking_range_power``
+     - false
+     - W
+     - Double
+     - auto
+     - Specifies the panel load cooking range/oven power. If not provided, the OS-HPXML default (see `Panel Loads <https://openstudio-hpxml.readthedocs.io/en/v1.10.0/workflow_inputs.html#panel-loads>`_) is used.
    * - ``cooking_range_oven_present``
      - true
      - 
@@ -5449,6 +5455,7 @@ From ``project_national`` the list of options, option stock sturation, and optio
 
    * - Option name
      - Stock saturation
+     - ``electric_panel_load_cooking_range_power``
      - ``cooking_range_oven_present``
      - ``cooking_range_oven_location``
      - ``cooking_range_oven_fuel_type``
@@ -5457,34 +5464,39 @@ From ``project_national`` the list of options, option stock sturation, and optio
 
    * - Electric Induction
      - 2.8%
+     - 10000
      - true
      - auto
      - electricity
      - true
      - auto
    * - Electric Resistance
      - 60%
+     - 12000
      - true
      - auto
      - electricity
      - false
      - auto
    * - Gas
      - 33%
+     - 0
      - true
      - auto
      - natural gas
      - false
      - auto
    * - None
      - 0.096%
+     - 0
      - false
      - auto
      - natural gas
      - false
      - auto
    * - Propane
      - 4.9%
+     - 0
      - true
      - auto
      - propane
@@ -5497,6 +5509,7 @@ From ``project_national`` the list of options, option stock sturation, and optio
      - 
      - 
      - 
+     - 
 
 .. _cooking_range_usage_level:
 

docs/read_the_docs/source/workflow_outputs/csv_tables/other_outputs.csv

@@ -50,6 +50,8 @@ build_existing_model.weather_file_latitude,Latitude from the EPW weather file.
 build_existing_model.weather_file_longitude,Longitude from the EPW weather file.
 build_existing_model.heating_unavailable_period,Heating unavailable period.
 build_existing_model.cooling_unavailable_period,Cooling unavailable period.
+build_existing_model.electric_panel_service_rating,TODO
+build_existing_model.electric_panel_service_rating_bin,TODO
 build_existing_model.unit_height_above_grade,Height of the lowest conditioned floor above grade for the unit.
 apply_upgrade.applicable,The measure was applied to the workflow.
 apply_upgrade.upgrade_name,User-specificed name that describes the upgrade.
@@ -71,6 +73,7 @@ report_simulation_output.include_annual_peak_loads,Generates annual peak loads f
 report_simulation_output.include_annual_component_loads,Generates annual heating and cooling loads disaggregated by component type.
 report_simulation_output.include_annual_hot_water_uses,Generates annual hot water usages for each end use.
 report_simulation_output.include_annual_hvac_summary,"Generates HVAC capacities, design temperatures, and design loads."
+report_simulation_output.include_annual_panel_summary,"Generates electric panel loads, capacities, and breaker spaces."
 report_simulation_output.include_annual_resilience,Generates annual resilience outputs.
 report_simulation_output.include_timeseries_total_consumptions,Generates timeseries energy consumptions for the total building.
 report_simulation_output.include_timeseries_fuel_consumptions,Generates timeseries energy consumptions for each fuel type.

measures/ApplyUpgrade/measure.rb

@@ -496,6 +496,22 @@ def run(model, runner, user_arguments)
       measures['BuildResidentialHPXML'][0]['utility_bill_pv_monthly_grid_connection_fee_units'] = values['utility_bill_pv_monthly_grid_connection_fee_units']
       measures['BuildResidentialHPXML'][0]['utility_bill_pv_monthly_grid_connection_fees'] = values['utility_bill_pv_monthly_grid_connection_fees']
 
+      # Electric Panel
+      measures['BuildResidentialHPXML'][0]['electric_panel_service_rating'] = hpxml_bldg.electric_panels[0].max_current_rating
+      measures['BuildResidentialHPXML'][0]['electric_panel_breaker_spaces_type'] = 'total'
+      measures['BuildResidentialHPXML'][0]['electric_panel_breaker_spaces'] = hpxml_bldg.electric_panels[0].breaker_spaces_total
+
+      panel_system_additions = {}
+      options.each do |_option_num, option|
+        parameter_name, option_name = option.split('|')
+
+        options_measure_args, _errors = get_measure_args_from_option_names(lookup_csv_data, [option_name], parameter_name, lookup_file, runner)
+        options_measure_args[option_name].each do |_measure_subdir, args_hash|
+          panel_system_additions = get_panel_system_additions(panel_system_additions, args_hash)
+        end
+      end
+      measures['BuildResidentialHPXML'][0].update(panel_system_additions)
+
       # Specify measures to run
       measures['BuildResidentialHPXML'][0]['apply_defaults'] = true
       measures['BuildResidentialHPXML'][0]['apply_validation'] = true
@@ -707,6 +723,53 @@ def get_hvac_system_values(hpxml_bldg, hvac_system_upgrades)
 
     return capacities, autosizing_factors, defect_ratios
   end
+
+  def get_panel_system_additions(panel_system_additions, args_hash)
+    args_hash.each do |arg_name, _value|
+      if arg_name.start_with?('heating_system_') && (not arg_name.start_with?('heating_system_2_'))
+        panel_system_additions['electric_panel_load_heating_system_addition'] = true
+      elsif arg_name.start_with?('cooling_system_')
+        panel_system_additions['electric_panel_load_cooling_system_addition'] = true
+      elsif arg_name.start_with?('heat_pump_')
+        panel_system_additions['electric_panel_load_heat_pump_addition'] = true
+      elsif arg_name.start_with?('heating_system_2_')
+        panel_system_additions['electric_panel_load_heating_system_2_addition'] = true
+      elsif arg_name.start_with?('mech_vent_') && (not arg_name.start_with?('mech_vent_2_'))
+        panel_system_additions['electric_panel_load_mech_vent_fan_addition'] = true
+      elsif arg_name.start_with?('mech_vent_2_')
+        panel_system_additions['electric_panel_load_mech_vent_2_addition'] = true
+      elsif arg_name.start_with?('whole_house_fan_')
+        panel_system_additions['electric_panel_load_whole_house_fan_addition'] = true
+      elsif arg_name.start_with?('kitchen_fans_')
+        panel_system_additions['electric_panel_load_kitchen_fans_addition'] = true
+      elsif arg_name.start_with?('bathroom_fans_')
+        panel_system_additions['electric_panel_load_bathroom_fans_addition'] = true
+      elsif arg_name.start_with?('water_heater_')
+        panel_system_additions['electric_panel_load_water_heater_addition'] = true
+      elsif arg_name.start_with?('clothes_dryer_')
+        panel_system_additions['electric_panel_load_clothes_dryer_addition'] = true
+      elsif arg_name.start_with?('dishwasher_')
+        panel_system_additions['electric_panel_load_dishwasher_addition'] = true
+      elsif arg_name.start_with?('cooking_range_oven_')
+        panel_system_additions['electric_panel_load_cooking_range_addition'] = true
+      elsif arg_name.start_with?('misc_plug_loads_well_pump_')
+        panel_system_additions['electric_panel_load_misc_plug_loads_well_pump_addition'] = true
+      elsif arg_name.start_with?('misc_plug_loads_vehicle_')
+        panel_system_additions['electric_panel_load_misc_plug_loads_vehicle_addition'] = true
+      elsif arg_name.start_with?('pool_pump_')
+        panel_system_additions['electric_panel_load_pool_pump_addition'] = true
+      elsif arg_name.start_with?('pool_heater_')
+        panel_system_additions['electric_panel_load_pool_heater_addition'] = true
+      elsif arg_name.start_with?('permanent_spa_pump_')
+        panel_system_additions['electric_panel_load_permanent_spa_pump_addition'] = true
+      elsif arg_name.start_with?('permanent_spa_heater_')
+        panel_system_additions['electric_panel_load_permanent_spa_heater_addition'] = true
+        # else
+        # panel_system_additions['electric_panel_load_other_addition'] = true
+      end
+    end
+    return panel_system_additions
+  end
 end
 
 # register the measure to be used by the application

measures/ApplyUpgrade/measure.xml

@@ -3,8 +3,8 @@
   <schema_version>3.1</schema_version>
   <name>apply_upgrade</name>
   <uid>33f1654c-f734-43d1-b35d-9d2856e41b5a</uid>
-  <version_id>bdafc4c0-e705-4aec-bcd1-4e662b31f968</version_id>
-  <version_modified>2024-10-04T15:40:22Z</version_modified>
+  <version_id>df138392-2e02-42d1-b692-546b0d63b28f</version_id>
+  <version_modified>2024-12-05T00:07:21Z</version_modified>
   <xml_checksum>9339BE01</xml_checksum>
   <class_name>ApplyUpgrade</class_name>
   <display_name>Apply Upgrade</display_name>
@@ -6342,7 +6342,7 @@
       <filename>measure.rb</filename>
       <filetype>rb</filetype>
       <usage_type>script</usage_type>
-      <checksum>F73DDD7C</checksum>
+      <checksum>D982A17C</checksum>
     </file>
     <file>
       <filename>constants.rb</filename>

measures/ResStockArguments/README.md

@@ -3795,6 +3795,17 @@ Maximum power output of the second PV system. For a shared system, this is the t
 
 <br/>
 
+**Electric Panel: Cooking Range/Oven Power**
+
+Specifies the panel load cooking range/oven power. If not provided, the OS-HPXML default (see <a href='https://openstudio-hpxml.readthedocs.io/en/v1.10.0/workflow_inputs.html#panel-loads'>Panel Loads</a>) is used.
+
+- **Name:** ``electric_panel_load_cooking_range_power``
+- **Type:** ``String``
+
+- **Required:** ``false``
+
+<br/>
+
 **Battery: Present**
 
 Whether there is a lithium ion battery present.

measures/ResStockArguments/measure.rb

@@ -5,6 +5,7 @@
 
 require 'openstudio'
 require_relative 'resources/constants'
+require_relative 'resources/electrical_panel'
 require_relative '../../resources/hpxml-measures/HPXMLtoOpenStudio/resources/meta_measure'
 
 # start the measure
@@ -848,6 +849,60 @@ def run(model, runner, user_arguments)
     end
     args[:rim_joist_assembly_r] = rim_joist_assembly_r
 
+    # Electric Panel
+    args[:electric_panel_load_calculation_types] = "#{HPXML::ElectricPanelLoadCalculationType2023LoadBased}, #{HPXML::ElectricPanelLoadCalculationType2023MeterBased}"
+
+    panel_sampler = ElectricalPanelSampler.new(runner: runner, **args)
+    cap_bin, cap_val = panel_sampler.assign_rated_capacity(args: args)
+
+    args[:electric_panel_service_rating_bin] = cap_bin
+    args[:electric_panel_service_rating] = cap_val
+
+    breaker_spaces_headroom = panel_sampler.assign_breaker_space_headroom(args: args)
+    args[:electric_panel_breaker_spaces_type] = 'headroom'
+    args[:electric_panel_breaker_spaces] = breaker_spaces_headroom
+
+    # Assign miscellaneous permanently connected appliance loads
+    if args[:electric_panel_load_other_power].nil?
+      args[:electric_panel_load_other_power] = 0
+    end
+    # Assume all homes have a microwave
+    if args[:geometry_unit_num_bedrooms] <= 2
+      microwave_power = 900 # W, small, <= 0.9 cu ft, 1-2 ppl
+    elsif args[:geometry_unit_num_bedrooms] <= 4
+      microwave_power = 1100 # W, medium, <= 1.6 cu ft, 3-4 ppl
+    else
+      microwave_power = 1250 # W, large, 1.7-2.2 cu ft, 5+ ppl
+    end
+
+    garbage_disposal_ownership = 0.52 # AHS 2013
+    if Random.new(args[:building_id]).rand > garbage_disposal_ownership
+      garbage_disposal_power = 0
+    else
+      # Power estimated from avg load amp not HP rating, from InSinkErators
+      if args[:geometry_unit_num_bedrooms] <= 1
+        garbage_disposal_power = 672 # W, 1/3 HP, avg load 5.6A, 1-2 ppl
+      elsif args[:geometry_unit_num_bedrooms] <= 3
+        garbage_disposal_power = 756 # W, 1/2 HP, avg load 6.3A, 2-4 ppl
+      elsif args[:geometry_unit_num_bedrooms] <= 4
+        garbage_disposal_power = 1140 # W, 3/4 HP, avg load 9.5A, 3-5 ppl
+      else
+        garbage_disposal_power = 1224 # W, 1 HP, avg load 10.2A, 4+ ppl
+      end
+    end
+
+    if args[:geometry_garage_width] == 0
+      garage_door_power = 0
+    else
+      # Assume one automatic door opener if has garage, regardless of no. garages
+      garage_door_power = 373 # W, 1/2 HP (1 mech HP = 745.7 W)
+    end
+
+    args[:electric_panel_load_other_power] += microwave_power
+    args[:electric_panel_load_other_power] += garbage_disposal_power
+    args[:electric_panel_load_other_power] += garage_door_power
+
+    # Register values to runner
     args.each do |arg_name, arg_value|
       if args_to_delete.include?(arg_name) || (arg_value == Constants::Auto)
         arg_value = '' # don't assign these to BuildResidentialHPXML or BuildResidentialScheduleFile

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>efbceea8-4232-46e9-89ab-d72a5efe020e</version_id>
-  <version_modified>2024-12-03T03:31:19Z</version_modified>
+  <version_id>02145022-2148-4f02-a2e2-f4307f0dfc71</version_id>
+  <version_modified>2024-12-04T19:27:20Z</version_modified>
   <xml_checksum>2C38F48B</xml_checksum>
   <class_name>ResStockArguments</class_name>
   <display_name>ResStock Arguments</display_name>
@@ -5293,6 +5293,15 @@
       <model_dependent>false</model_dependent>
       <default_value>4000</default_value>
     </argument>
+    <argument>
+      <name>electric_panel_load_cooking_range_power</name>
+      <display_name>Electric Panel: Cooking Range/Oven Power</display_name>
+      <description>Specifies the panel load cooking range/oven power. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.10.0/workflow_inputs.html#panel-loads'&gt;Panel Loads&lt;/a&gt;) is used.</description>
+      <type>String</type>
+      <units>W</units>
+      <required>false</required>
+      <model_dependent>false</model_dependent>
+    </argument>
     <argument>
       <name>battery_present</name>
       <display_name>Battery: Present</display_name>
@@ -7684,7 +7693,7 @@
       <filename>README.md</filename>
       <filetype>md</filetype>
       <usage_type>readme</usage_type>
-      <checksum>AB96C457</checksum>
+      <checksum>88A13ADB</checksum>
     </file>
     <file>
       <filename>README.md.erb</filename>
@@ -7701,13 +7710,37 @@
       <filename>measure.rb</filename>
       <filetype>rb</filetype>
       <usage_type>script</usage_type>
-      <checksum>C85AA9D8</checksum>
+      <checksum>78F14364</checksum>
     </file>
     <file>
       <filename>constants.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>67C6AB5F</checksum>
+      <checksum>E4976995</checksum>
+    </file>
+    <file>
+      <filename>electrical_panel.rb</filename>
+      <filetype>rb</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>F8555523</checksum>
+    </file>
+    <file>
+      <filename>electrical_panel_resources/electrical_panel_breaker_space.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>DF922E1E</checksum>
+    </file>
+    <file>
+      <filename>electrical_panel_resources/electrical_panel_rated_capacity__electric_heating.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>E977F59E</checksum>
+    </file>
+    <file>
+      <filename>electrical_panel_resources/electrical_panel_rated_capacity__nonelectric_heating.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>FBEBCE30</checksum>
     </file>
     <file>
       <filename>resstock_arguments_test.rb</filename>