Electric panel

HPXMLtoOpenStudio/README.md

@@ -68,6 +68,17 @@ The name of the file w/ additional HVAC design load details. If not provided, de
 
 <br/>
 
+**Electric Panel Output File Name**
+
+The name of the file w/ additional electric panel loads. If not provided, defaults to 'results_panel.csv' (or '.json' or '.msgpack').
+
+- **Name:** ``electric_panel_output_file_name``
+- **Type:** ``String``
+
+- **Required:** ``false``
+
+<br/>
+
 **Add component loads?**
 
 If true, adds the calculation of heating/cooling component loads (not enabled by default for faster performance).

HPXMLtoOpenStudio/measure.rb

@@ -68,6 +68,12 @@ def arguments(model) # rubocop:disable Lint/UnusedMethodArgument
     arg.setDefaultValue('results_design_load_details')
     args << arg
 
+    arg = OpenStudio::Measure::OSArgument::makeStringArgument('electric_panel_output_file_name', false)
+    arg.setDisplayName('Electric Panel Output File Name')
+    arg.setDescription("The name of the file w/ additional electric panel loads. If not provided, defaults to 'results_panel.csv' (or '.json' or '.msgpack').")
+    arg.setDefaultValue('results_panel')
+    args << arg
+
     arg = OpenStudio::Measure::OSArgument.makeBoolArgument('add_component_loads', false)
     arg.setDisplayName('Add component loads?')
     arg.setDescription('If true, adds the calculation of heating/cooling component loads (not enabled by default for faster performance).')
@@ -164,6 +170,13 @@ def run(model, runner, user_arguments)
 
       # Write design load details output file
       HVACSizing.write_detailed_output(design_loads_results_out, args[:output_format], args[:design_load_details_output_file_path])
+
+      # Write electric panel load output file
+      if hpxml.buildings.map { |hpxml_bldg| hpxml_bldg.electric_panels.size }.sum > 0
+        electric_panel_results_out = []
+        Outputs.append_panel_results(hpxml.header, hpxml.buildings, nil, electric_panel_results_out)
+        Outputs.write_results_out_to_file(electric_panel_results_out, args[:output_format], args[:electric_panel_output_file_path])
+      end
     rescue Exception => e
       runner.registerError("#{e.message}\n#{e.backtrace.join("\n")}")
       return false
@@ -198,6 +211,11 @@ def set_file_paths(args)
     end
     args[:design_load_details_output_file_path] = File.join(args[:output_dir], args[:design_load_details_output_file_name])
 
+    if File.extname(args[:electric_panel_output_file_name]).length == 0
+      args[:electric_panel_output_file_name] = "#{args[:electric_panel_output_file_name]}.#{args[:output_format]}"
+    end
+    args[:electric_panel_output_file_path] = File.join(args[:output_dir], args[:electric_panel_output_file_name])
+
     args[:hpxml_defaults_path] = File.join(args[:output_dir], 'in.xml')
   end
 

HPXMLtoOpenStudio/measure.xml

@@ -3,8 +3,8 @@
   <schema_version>3.1</schema_version>
   <name>hpxm_lto_openstudio</name>
   <uid>b1543b30-9465-45ff-ba04-1d1f85e763bc</uid>
-  <version_id>a96e00a3-319b-4f82-a104-9013094367f5</version_id>
-  <version_modified>2024-12-09T23:44:23Z</version_modified>
+  <version_id>fc2b64b7-68d3-4e91-a258-2c2b0e133b7f</version_id>
+  <version_modified>2024-12-12T16:04:53Z</version_modified>
   <xml_checksum>D8922A73</xml_checksum>
   <class_name>HPXMLtoOpenStudio</class_name>
   <display_name>HPXML to OpenStudio Translator</display_name>
@@ -68,6 +68,15 @@
       <model_dependent>false</model_dependent>
       <default_value>results_design_load_details</default_value>
     </argument>
+    <argument>
+      <name>electric_panel_output_file_name</name>
+      <display_name>Electric Panel Output File Name</display_name>
+      <description>The name of the file w/ additional electric panel loads. If not provided, defaults to 'results_panel.csv' (or '.json' or '.msgpack').</description>
+      <type>String</type>
+      <required>false</required>
+      <model_dependent>false</model_dependent>
+      <default_value>results_panel</default_value>
+    </argument>
     <argument>
       <name>add_component_loads</name>
       <display_name>Add component loads?</display_name>
@@ -166,7 +175,7 @@
       <filename>README.md</filename>
       <filetype>md</filetype>
       <usage_type>readme</usage_type>
-      <checksum>F05E039B</checksum>
+      <checksum>D5E21C55</checksum>
     </file>
     <file>
       <filename>README.md.erb</filename>
@@ -183,7 +192,7 @@
       <filename>measure.rb</filename>
       <filetype>rb</filetype>
       <usage_type>script</usage_type>
-      <checksum>D7F18DFB</checksum>
+      <checksum>BFDC86D0</checksum>
     </file>
     <file>
       <filename>airflow.rb</filename>
@@ -257,6 +266,12 @@
       <usage_type>resource</usage_type>
       <checksum>FC171B98</checksum>
     </file>
+    <file>
+      <filename>data/default_panels.csv</filename>
+      <filetype>csv</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>43F408B5</checksum>
+    </file>
     <file>
       <filename>data/default_schedules.csv</filename>
       <filetype>csv</filetype>
@@ -327,7 +342,13 @@
       <filename>defaults.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>CCB18256</checksum>
+      <checksum>3E0973AF</checksum>
+    </file>
+    <file>
+      <filename>electric_panel.rb</filename>
+      <filetype>rb</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>6A2F167F</checksum>
     </file>
     <file>
       <filename>energyplus.rb</filename>
@@ -357,7 +378,7 @@
       <filename>hpxml.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>270F2EEB</checksum>
+      <checksum>19824A87</checksum>
     </file>
     <file>
       <filename>hpxml_schema/HPXML.xsd</filename>
@@ -375,7 +396,7 @@
       <filename>hpxml_schematron/EPvalidator.xml</filename>
       <filetype>xml</filetype>
       <usage_type>resource</usage_type>
-      <checksum>105F837D</checksum>
+      <checksum>7EAC0908</checksum>
     </file>
     <file>
       <filename>hpxml_schematron/iso-schematron.xsd</filename>
@@ -387,7 +408,7 @@
       <filename>hvac.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>0F2DDAA0</checksum>
+      <checksum>2A977A4B</checksum>
     </file>
     <file>
       <filename>hvac_sizing.rb</filename>
@@ -453,7 +474,7 @@
       <filename>output.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>573B31F4</checksum>
+      <checksum>C5B1BE37</checksum>
     </file>
     <file>
       <filename>psychrometrics.rb</filename>
@@ -627,7 +648,7 @@
       <filename>waterheater.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>B6FE7ABC</checksum>
+      <checksum>7B54F6B1</checksum>
     </file>
     <file>
       <filename>weather.rb</filename>
@@ -663,7 +684,13 @@
       <filename>test_defaults.rb</filename>
       <filetype>rb</filetype>
       <usage_type>test</usage_type>
-      <checksum>1004443C</checksum>
+      <checksum>46D37474</checksum>
+    </file>
+    <file>
+      <filename>test_electric_panel.rb</filename>
+      <filetype>rb</filetype>
+      <usage_type>test</usage_type>
+      <checksum>0048E935</checksum>
     </file>
     <file>
       <filename>test_enclosure.rb</filename>
@@ -735,7 +762,7 @@
       <filename>test_validation.rb</filename>
       <filetype>rb</filetype>
       <usage_type>test</usage_type>
-      <checksum>95476C6B</checksum>
+      <checksum>9E786B5D</checksum>
     </file>
     <file>
       <filename>test_water_heater.rb</filename>

HPXMLtoOpenStudio/resources/data/default_panels.csv

@@ -0,0 +1,29 @@
+Load Name,Voltage,Power Rating,Breaker Spaces,Units,Load Type,Notes
+lighting,120/240,3,0,W/sqft,lighting,Multiplier for conditioned floor area to account  for capacity impacts of general lighting.
+kitchen,120/240,3000,0,W,kitchen,Two kitchen small appliance circuits at 1.5 kVA.
+laundry,120/240,1500,1,W,laundry,One laundry circuit at 1.5 kVA.
+ev_level,120,1650,1,W,electric vehicle charging,Level 1 - 120 V EV charger.
+ev_level,240,7680,2,W,electric vehicle charging,Level 2 - 240 V EV charger.
+wellpump_large,120/240,1119,2,W,well pump,Well pump capacity - 4 or larger bedroom home.
+wellpump_small,120/240,746,2,W,well pump,Well pump capacity - 3 or fewer bedroom home.
+poolpump,120/240,1491,2,W,pool pump,2 HP pool pump capacity.
+poolheater,120/240,27000,2,W,pool heater,Electric resistance pool heater.
+poolheater_hp,120/240,5100,2,W,pool heater,Heat pump pool heater.
+spaheater,120/240,4000,2,W,permanent spa heater,Hot tub heater.
+spapump,120/240,1491,2,W,permanent spa pump,Hot tub pump.
+dryer,120/240,5760,2,W,clothes dryer,Electric clothes dryer.
+dryer_hp,120,996,1,W,clothes dryer,120V heat pump clothes dryer.
+dryer_hp,240,860,2,W,clothes dryer,240V heat pump clothes dryer.
+dishwasher,120/240,1200,1,W,dishwasher,Dishwasher.
+rangeoven,120,1800,1,W,range/oven,120V range-oven.
+rangeoven,240,12000,2,W,range/oven,240V range-oven.
+wh_tankless1,120/240,18000,2,W,hot water,Tankless water heater - one bathroom.
+wh_tankless2,120/240,24000,2,W,hot water,Tankless water heater - two bathrooms.
+wh_tankless3,120/240,36000,2,W,hot water,Tankless water heater - three or more bathrooms.
+mechvent,120/240,3000,1,W,mech vent,Using autosized values for ventilation capacity unless unavailable.
+other,120/240,373,1,W,other,Default other only assumes 1 default garage door opener if a garage is present and does not account for other permanent appliances (e.g. garbage disposal).
+wh_tank,120/240,auto,2,W,hot water,Storage water heater.
+wh_hp,120,auto,1,W,hot water,120V heat pump water heater.
+wh_hp,240,auto,2,W,hot water,240V heat pump water heater.
+heating,120/240,auto,auto,W,heating,Using autosize values for capacity of all heating.
+cooling,120/240,auto,auto,W,cooling,Using autosize values for capacity of all cooling.