Electric panel

docs/technical_development_guide/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. Only applies to electric cooking range/oven. 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/technical_development_guide/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 breaker spaces and loads.
 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.

docs/technical_reference_guide/3c_ResStockInputs.tex

@@ -1706,7 +1706,10 @@ \subsubsection{Misc Pool Heater}
 The heating fuel of the pool heater if there is a pool.
 
 \paragraph{Distribution Data Source(s)}
-Constructed using U.S. EIA 2020 Residential Energy Consumption Survey (RECS) microdata.
+\begin{itemize}
+    \item Constructed using U.S. EIA 2020 Residential Energy Consumption Survey (RECS) microdata.
+    \item Constructed using the California Energy Commission 2019 Residential Appliance Saturation Study (RASS) microdata 
+\end{itemize} 
 
 \paragraph{Direct Conditional Dependencies}
 \begin{itemize}
@@ -1716,7 +1719,7 @@ \subsubsection{Misc Pool Heater}
 
 \paragraph{Options}
 
-The options for pool heaters are based on the fuel they use: electricity, natural gas, none, and other fuel. The characteristic assigns the \texttt{pool\_heater\_type}, \texttt{pool\_heater\_annual\_kwh}, \texttt{pool\_heater\_annual\_therm}, and \texttt{pool\_heater\_usage\_multiplier} ResStock arguments (Table \ref{table:opt_def_pool_heat}).
+There are five options for pool heaters: Electricity, Electric Heat Pump, Natural Gas, None, and Other Fuel. The Electricity option defines a traditional electric resistance pool heater, whereas the Electric Heat Pump option uses heat pump technology for heating the pool. The “Other Fuel” pool heater option currently is currently not modeled in ResStock. The ResStock arguments assigned for each of these options is given in  Table \ref{table:opt_def_pool_heat}. 
 
 \begin{customLongTable}{ |p{2.5cm}|p{3cm}|p{3cm}|p{3cm}|p{3cm}| }
 {Pool Heater options and arguments that vary for each option} {table:opt_def_pool_heat} 
@@ -1725,6 +1728,7 @@ \subsubsection{Misc Pool Heater}
 \texttt{pool\_heater\_annual\_therm} &
 \texttt{pool\_heater\_usage\_multiplier}} 
 Electricity & electric resistance & auto & 0 & 1.0 \\
+Electric Heat Pump & heat pump & auto & 0 & 1.0 \\ 
 Natural Gas & gas fired & 0 & auto & 1.0 \\
 None & none & 0 & 0 & 0 \\
 Other Fuel & none & 0 & 0 & 0 \\
@@ -1758,7 +1762,7 @@ \subsubsection{Misc Pool Heater}
 \end{longtable}
 
 \paragraph{Distribution Assumption(s)}
-None.
+Within electric pool heaters, the proportion of heat pump electric pool heating versus non-heat pump electric pool heating was derived from RASS.
 
 \subsubsection{Misc Pool Pump}
 \paragraph{Description}
@@ -1921,17 +1925,20 @@ \subsubsection{Misc Hot Tub Spa}
 
 \subsection{Well Pump}
 \subsubsection{Modeling Approach}
-Well pumps are used to extract potable water from a well. Well pumps are not well characterized in existing studies. The 2014 Building America House Simulation Protocols (\cite{Wilson2014}) estimated that 13\% of U.S.~homes have a well pump, and the study is used to construct the characteristic distribution, which has no dependency. This means a well pump is randomly assigned to housing units in ResStock where it is modeled as a type of plug load that does not provide any latent or sensible heat to the housing units. The annual energy for well pumping is estimated based on conditioned floor area and number of bedrooms converted from occupants using an equation from 2014 Building America House Simulation Protocols (\cite{Wilson2014}) and can be adjusted by a usage multiplier. The annual energy is then multiplied by a default simple schedule to produce the end-use load profile.
+Well pumps are used to extract potable water from a well. The 2017-2019 American Housing Surveys estimated that 11\% of US homes have a well pump, and that data is used to construct the characteristic distribution, which has a dependency to Census Division, PUMA Metro Status, and Geometry Building Type Height. Well pumps are also more common outside the metro areas than in metro areas, particularly within a principal city. A well pump in ResStock is modeled as a type of plug load that does not provide any latent or sensible heat to the housing units. The annual energy for well pumping is estimated based on conditioned floor area and number of bedrooms converted from occupants using an equation from 2014 Building America House Simulation Protocols (BAHSP) (\cite{Wilson2014}) and can be adjusted by a usage multiplier. The annual energy is then multiplied by a default simple schedule to produce the end-use load profile. 
 
 \subsubsection{Misc Well Pump}
 \paragraph{Description}
 Presence and efficiency of well pump.
 
 \paragraph{Distribution Data Source(s)}
-Wilson et al. 'Building America House Simulation Protocols' 2014, national average fraction used for saturation.
-
+2017 - 2019 American Housing Survey
 \paragraph{Direct Conditional Dependencies}
-None.
+\begin{itemize}
+    \item Census Division
+    \item PUMA Metro Status
+    \item GEometry Building Type Height
+\end{itemize}
 
 \paragraph{Options}
 The options for the Misc Well Pump characteristic are Typical Efficiency if there is a well pump and None if there is no well pump. The characteristic sets the \texttt{misc\_plug\_loads\_well\_pump\_present}, \texttt{misc\_plug\_loads\_well\_pump\_usage\_multiplier}, \texttt{misc\_plug\_loads\_well\_pump\_2\_usage\_multiplier}, and \texttt{misc\_plug\_loads\_well\_pump\_annual\_kwh} ResStock arguments (Table \ref{table:hc_opt_def_well_pump}). 

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>b13107fd-04b8-4c79-948d-52b75ccc94a3</version_id>
-  <version_modified>2024-12-09T16:49:56Z</version_modified>
+  <version_id>a9610e0a-c95e-41e0-999b-c53e981b844f</version_id>
+  <version_modified>2025-01-27T16:55:35Z</version_modified>
   <xml_checksum>9339BE01</xml_checksum>
   <class_name>ApplyUpgrade</class_name>
   <display_name>Apply Upgrade</display_name>
@@ -25017,7 +25017,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. Only applies to electric cooking range/oven. 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_service_feeders_load_calculation_types] = "#{HPXML::ElectricPanelLoadCalculationType2023ExistingDwellingLoadBased}, #{HPXML::ElectricPanelLoadCalculationType2023ExistingDwellingMeterBased}"
+
+    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