urbanopt-cli 0.10.0 → 0.11.0

data/example_files/resources/hpxml-measures/BuildResidentialHPXML/measure.xml

@@ -1,10 +1,10 @@
 <?xml version="1.0"?>
 <measure>
-  <schema_version>3.0</schema_version>
+  <schema_version>3.1</schema_version>
   <name>build_residential_hpxml</name>
   <uid>a13a8983-2b01-4930-8af2-42030b6e4233</uid>
-  <version_id>61a17495-a6d8-4328-a2c6-341c8ef4300c</version_id>
-  <version_modified>20230519T183248Z</version_modified>
+  <version_id>73f05c97-2d2b-4e1e-8709-67b264ec605e</version_id>
+  <version_modified>2023-11-13T20:11:04Z</version_modified>
   <xml_checksum>2C38F48B</xml_checksum>
   <class_name>BuildResidentialHPXML</class_name>
   <display_name>HPXML Builder</display_name>
@@ -19,6 +19,14 @@
       <required>true</required>
       <model_dependent>false</model_dependent>
     </argument>
+    <argument>
+      <name>existing_hpxml_path</name>
+      <display_name>Existing HPXML File Path</display_name>
+      <description>Absolute/relative path of the existing HPXML file. If not provided, a new HPXML file with one Building element is created. If provided, a new Building element will be appended to this HPXML file (e.g., to create a multifamily HPXML file describing multiple dwelling units).</description>
+      <type>String</type>
+      <required>false</required>
+      <model_dependent>false</model_dependent>
+    </argument>
     <argument>
       <name>software_info_program_used</name>
       <display_name>Software Info: Program Used</display_name>
@@ -84,7 +92,7 @@
     <argument>
       <name>simulation_control_timestep</name>
       <display_name>Simulation Control: Timestep</display_name>
-      <description>Value must be a divisor of 60. If not provided, the OS-HPXML default is used.</description>
+      <description>Value must be a divisor of 60. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-simulation-control'&gt;HPXML Simulation Control&lt;/a&gt;) is used.</description>
       <type>Integer</type>
       <units>min</units>
       <required>false</required>
@@ -93,7 +101,7 @@
     <argument>
       <name>simulation_control_run_period</name>
       <display_name>Simulation Control: Run Period</display_name>
-      <description>Enter a date like "Jan 1 - Dec 31". If not provided, the OS-HPXML default is used.</description>
+      <description>Enter a date like 'Jan 1 - Dec 31'. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-simulation-control'&gt;HPXML Simulation Control&lt;/a&gt;) is used.</description>
       <type>String</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -101,7 +109,7 @@
     <argument>
       <name>simulation_control_run_period_calendar_year</name>
       <display_name>Simulation Control: Run Period Calendar Year</display_name>
-      <description>This numeric field should contain the calendar year that determines the start day of week. If you are running simulations using AMY weather files, the value entered for calendar year will not be used; it will be overridden by the actual year found in the AMY weather file. If not provided, the OS-HPXML default is used.</description>
+      <description>This numeric field should contain the calendar year that determines the start day of week. If you are running simulations using AMY weather files, the value entered for calendar year will not be used; it will be overridden by the actual year found in the AMY weather file. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-simulation-control'&gt;HPXML Simulation Control&lt;/a&gt;) is used.</description>
       <type>Integer</type>
       <units>year</units>
       <required>false</required>
@@ -110,7 +118,7 @@
     <argument>
       <name>simulation_control_daylight_saving_enabled</name>
       <display_name>Simulation Control: Daylight Saving Enabled</display_name>
-      <description>Whether to use daylight saving. If not provided, the OS-HPXML default is used.</description>
+      <description>Whether to use daylight saving. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-building-site'&gt;HPXML Building Site&lt;/a&gt;) is used.</description>
       <type>Boolean</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -128,7 +136,7 @@
     <argument>
       <name>simulation_control_daylight_saving_period</name>
       <display_name>Simulation Control: Daylight Saving Period</display_name>
-      <description>Enter a date like "Mar 15 - Dec 15". If not provided, the OS-HPXML default is used.</description>
+      <description>Enter a date like 'Mar 15 - Dec 15'. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-building-site'&gt;HPXML Building Site&lt;/a&gt;) is used.</description>
       <type>String</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -136,7 +144,7 @@
     <argument>
       <name>simulation_control_temperature_capacitance_multiplier</name>
       <display_name>Simulation Control: Temperature Capacitance Multiplier</display_name>
-      <description>Affects the transient calculation of indoor air temperatures. If not provided, the OS-HPXML default is used.</description>
+      <description>Affects the transient calculation of indoor air temperatures. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-simulation-control'&gt;HPXML Simulation Control&lt;/a&gt;) is used.</description>
       <type>String</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -144,7 +152,7 @@
     <argument>
       <name>site_type</name>
       <display_name>Site: Type</display_name>
-      <description>The type of site. If not provided, the OS-HPXML default is used.</description>
+      <description>The type of site. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-site'&gt;HPXML Site&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -166,7 +174,7 @@
     <argument>
       <name>site_shielding_of_home</name>
       <display_name>Site: Shielding of Home</display_name>
-      <description>Presence of nearby buildings, trees, obstructions for infiltration model. If not provided, the OS-HPXML default is used.</description>
+      <description>Presence of nearby buildings, trees, obstructions for infiltration model. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-site'&gt;HPXML Site&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -188,7 +196,7 @@
     <argument>
       <name>site_ground_conductivity</name>
       <display_name>Site: Ground Conductivity</display_name>
-      <description>Conductivity of the ground soil. If not provided, the OS-HPXML default is used.</description>
+      <description>Conductivity of the ground soil. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-site'&gt;HPXML Site&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Btu/hr-ft-F</units>
       <required>false</required>
@@ -532,6 +540,14 @@
       <required>false</required>
       <model_dependent>false</model_dependent>
     </argument>
+    <argument>
+      <name>unit_multiplier</name>
+      <display_name>Building Construction: Unit Multiplier</display_name>
+      <description>The number of similar dwelling units. EnergyPlus simulation results will be multiplied this value. If not provided, defaults to 1.</description>
+      <type>Integer</type>
+      <required>false</required>
+      <model_dependent>false</model_dependent>
+    </argument>
     <argument>
       <name>geometry_unit_type</name>
       <display_name>Geometry: Unit Type</display_name>
@@ -553,6 +569,10 @@
           <value>apartment unit</value>
           <display_name>apartment unit</display_name>
         </choice>
+        <choice>
+          <value>manufactured home</value>
+          <display_name>manufactured home</display_name>
+        </choice>
       </choices>
     </argument>
     <argument>
@@ -684,7 +704,7 @@
     <argument>
       <name>geometry_unit_num_bathrooms</name>
       <display_name>Geometry: Unit Number of Bathrooms</display_name>
-      <description>The number of bathrooms in the unit. If not provided, the OS-HPXML default is used.</description>
+      <description>The number of bathrooms in the unit. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-building-construction'&gt;HPXML Building Construction&lt;/a&gt;) is used.</description>
       <type>Integer</type>
       <units>#</units>
       <required>false</required>
@@ -741,7 +761,7 @@
     <argument>
       <name>geometry_garage_protrusion</name>
       <display_name>Geometry: Garage Protrusion</display_name>
-      <description>The fraction of the garage that is protruding from the living space. Only applies to single-family detached units.</description>
+      <description>The fraction of the garage that is protruding from the conditioned space. Only applies to single-family detached units.</description>
       <type>Double</type>
       <units>Frac</units>
       <required>true</required>
@@ -808,6 +828,14 @@
           <value>AboveApartment</value>
           <display_name>AboveApartment</display_name>
         </choice>
+        <choice>
+          <value>BellyAndWingWithSkirt</value>
+          <display_name>BellyAndWingWithSkirt</display_name>
+        </choice>
+        <choice>
+          <value>BellyAndWingNoSkirt</value>
+          <display_name>BellyAndWingNoSkirt</display_name>
+        </choice>
       </choices>
     </argument>
     <argument>
@@ -1001,7 +1029,7 @@
     <argument>
       <name>neighbor_front_height</name>
       <display_name>Neighbor: Front Height</display_name>
-      <description>The height of the neighboring building to the front. If not provided, the OS-HPXML default is used.</description>
+      <description>The height of the neighboring building to the front. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-site'&gt;HPXML Site&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>ft</units>
       <required>false</required>
@@ -1010,7 +1038,7 @@
     <argument>
       <name>neighbor_back_height</name>
       <display_name>Neighbor: Back Height</display_name>
-      <description>The height of the neighboring building to the back. If not provided, the OS-HPXML default is used.</description>
+      <description>The height of the neighboring building to the back. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-site'&gt;HPXML Site&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>ft</units>
       <required>false</required>
@@ -1019,7 +1047,7 @@
     <argument>
       <name>neighbor_left_height</name>
       <display_name>Neighbor: Left Height</display_name>
-      <description>The height of the neighboring building to the left. If not provided, the OS-HPXML default is used.</description>
+      <description>The height of the neighboring building to the left. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-site'&gt;HPXML Site&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>ft</units>
       <required>false</required>
@@ -1028,7 +1056,7 @@
     <argument>
       <name>neighbor_right_height</name>
       <display_name>Neighbor: Right Height</display_name>
-      <description>The height of the neighboring building to the right. If not provided, the OS-HPXML default is used.</description>
+      <description>The height of the neighboring building to the right. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-site'&gt;HPXML Site&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>ft</units>
       <required>false</required>
@@ -1084,7 +1112,7 @@
     <argument>
       <name>foundation_wall_type</name>
       <display_name>Foundation Wall: Type</display_name>
-      <description>The material type of the foundation wall. If not provided, the OS-HPXML default is used.</description>
+      <description>The material type of the foundation wall. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-foundation-walls'&gt;HPXML Foundation Walls&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -1126,7 +1154,7 @@
     <argument>
       <name>foundation_wall_thickness</name>
       <display_name>Foundation Wall: Thickness</display_name>
-      <description>The thickness of the foundation wall. If not provided, the OS-HPXML default is used.</description>
+      <description>The thickness of the foundation wall. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-foundation-walls'&gt;HPXML Foundation Walls&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>in</units>
       <required>false</required>
@@ -1165,7 +1193,7 @@
     <argument>
       <name>foundation_wall_insulation_distance_to_top</name>
       <display_name>Foundation Wall: Insulation Distance To Top</display_name>
-      <description>The distance from the top of the foundation wall to the top of the foundation wall insulation. Only applies to basements/crawlspaces. If not provided, the OS-HPXML default is used.</description>
+      <description>The distance from the top of the foundation wall to the top of the foundation wall insulation. Only applies to basements/crawlspaces. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-foundation-walls'&gt;HPXML Foundation Walls&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>ft</units>
       <required>false</required>
@@ -1174,7 +1202,7 @@
     <argument>
       <name>foundation_wall_insulation_distance_to_bottom</name>
       <display_name>Foundation Wall: Insulation Distance To Bottom</display_name>
-      <description>The distance from the top of the foundation wall to the bottom of the foundation wall insulation. Only applies to basements/crawlspaces. If not provided, the OS-HPXML default is used.</description>
+      <description>The distance from the top of the foundation wall to the bottom of the foundation wall insulation. Only applies to basements/crawlspaces. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-foundation-walls'&gt;HPXML Foundation Walls&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>ft</units>
       <required>false</required>
@@ -1241,7 +1269,7 @@
     <argument>
       <name>slab_thickness</name>
       <display_name>Slab: Thickness</display_name>
-      <description>The thickness of the slab. Zero can be entered if there is a dirt floor instead of a slab. If not provided, the OS-HPXML default is used.</description>
+      <description>The thickness of the slab. Zero can be entered if there is a dirt floor instead of a slab. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-slabs'&gt;HPXML Slabs&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>in</units>
       <required>false</required>
@@ -1250,7 +1278,7 @@
     <argument>
       <name>slab_carpet_fraction</name>
       <display_name>Slab: Carpet Fraction</display_name>
-      <description>Fraction of the slab floor area that is carpeted. If not provided, the OS-HPXML default is used.</description>
+      <description>Fraction of the slab floor area that is carpeted. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-slabs'&gt;HPXML Slabs&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -1259,7 +1287,7 @@
     <argument>
       <name>slab_carpet_r</name>
       <display_name>Slab: Carpet R-value</display_name>
-      <description>R-value of the slab carpet. If not provided, the OS-HPXML default is used.</description>
+      <description>R-value of the slab carpet. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-slabs'&gt;HPXML Slabs&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>h-ft^2-R/Btu</units>
       <required>false</required>
@@ -1278,7 +1306,7 @@
     <argument>
       <name>roof_material_type</name>
       <display_name>Roof: Material Type</display_name>
-      <description>The material type of the roof. If not provided, the OS-HPXML default is used.</description>
+      <description>The material type of the roof. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-roofs'&gt;HPXML Roofs&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -1324,7 +1352,7 @@
     <argument>
       <name>roof_color</name>
       <display_name>Roof: Color</display_name>
-      <description>The color of the roof. If not provided, the OS-HPXML default is used.</description>
+      <description>The color of the roof. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-roofs'&gt;HPXML Roofs&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -1383,11 +1411,10 @@
     <argument>
       <name>roof_radiant_barrier_grade</name>
       <display_name>Roof: Radiant Barrier Grade</display_name>
-      <description>The grade of the radiant barrier. If not provided, the OS-HPXML default is used.</description>
+      <description>The grade of the radiant barrier. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-roofs'&gt;HPXML Roofs&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
-      <default_value>1</default_value>
       <choices>
         <choice>
           <value>1</value>
@@ -1461,7 +1488,7 @@
     <argument>
       <name>wall_siding_type</name>
       <display_name>Wall: Siding Type</display_name>
-      <description>The siding type of the walls. Also applies to rim joists. If not provided, the OS-HPXML default is used.</description>
+      <description>The siding type of the walls. Also applies to rim joists. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-walls'&gt;HPXML Walls&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -1515,7 +1542,7 @@
     <argument>
       <name>wall_color</name>
       <display_name>Wall: Color</display_name>
-      <description>The color of the walls. Also applies to rim joists. If not provided, the OS-HPXML default is used.</description>
+      <description>The color of the walls. Also applies to rim joists. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-walls'&gt;HPXML Walls&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -1645,7 +1672,7 @@
     <argument>
       <name>window_fraction_operable</name>
       <display_name>Windows: Fraction Operable</display_name>
-      <description>Fraction of windows that are operable. If not provided, the OS-HPXML default is used.</description>
+      <description>Fraction of windows that are operable. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-windows'&gt;HPXML Windows&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -1654,7 +1681,7 @@
     <argument>
       <name>window_natvent_availability</name>
       <display_name>Windows: Natural Ventilation Availability</display_name>
-      <description>For operable windows, the number of days/week that windows can be opened by occupants for natural ventilation. If not provided, the OS-HPXML default is used.</description>
+      <description>For operable windows, the number of days/week that windows can be opened by occupants for natural ventilation. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-windows'&gt;HPXML Windows&lt;/a&gt;) is used.</description>
       <type>Integer</type>
       <units>Days/week</units>
       <required>false</required>
@@ -1682,7 +1709,7 @@
     <argument>
       <name>window_interior_shading_winter</name>
       <display_name>Windows: Winter Interior Shading</display_name>
-      <description>Interior shading coefficient for the winter season. 1.0 indicates no reduction in solar gain, 0.85 indicates 15% reduction, etc. If not provided, the OS-HPXML default is used.</description>
+      <description>Interior shading coefficient for the winter season. 1.0 indicates no reduction in solar gain, 0.85 indicates 15% reduction, etc. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-windows'&gt;HPXML Windows&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -1691,7 +1718,7 @@
     <argument>
       <name>window_interior_shading_summer</name>
       <display_name>Windows: Summer Interior Shading</display_name>
-      <description>Interior shading coefficient for the summer season. 1.0 indicates no reduction in solar gain, 0.85 indicates 15% reduction, etc. If not provided, the OS-HPXML default is used.</description>
+      <description>Interior shading coefficient for the summer season. 1.0 indicates no reduction in solar gain, 0.85 indicates 15% reduction, etc. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-windows'&gt;HPXML Windows&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -1700,7 +1727,7 @@
     <argument>
       <name>window_exterior_shading_winter</name>
       <display_name>Windows: Winter Exterior Shading</display_name>
-      <description>Exterior shading coefficient for the winter season. 1.0 indicates no reduction in solar gain, 0.85 indicates 15% reduction, etc. If not provided, the OS-HPXML default is used.</description>
+      <description>Exterior shading coefficient for the winter season. 1.0 indicates no reduction in solar gain, 0.85 indicates 15% reduction, etc. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-windows'&gt;HPXML Windows&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -1709,7 +1736,7 @@
     <argument>
       <name>window_exterior_shading_summer</name>
       <display_name>Windows: Summer Exterior Shading</display_name>
-      <description>Exterior shading coefficient for the summer season. 1.0 indicates no reduction in solar gain, 0.85 indicates 15% reduction, etc. If not provided, the OS-HPXML default is used.</description>
+      <description>Exterior shading coefficient for the summer season. 1.0 indicates no reduction in solar gain, 0.85 indicates 15% reduction, etc. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-windows'&gt;HPXML Windows&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -1718,7 +1745,7 @@
     <argument>
       <name>window_shading_summer_season</name>
       <display_name>Windows: Shading Summer Season</display_name>
-      <description>Enter a date like "May 1 - Sep 30". Defines the summer season for purposes of shading coefficients; the rest of the year is assumed to be winter. If not provided, the OS-HPXML default is used.</description>
+      <description>Enter a date like 'May 1 - Sep 30'. Defines the summer season for purposes of shading coefficients; the rest of the year is assumed to be winter. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-windows'&gt;HPXML Windows&lt;/a&gt;) is used.</description>
       <type>String</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -2029,7 +2056,7 @@
     <argument>
       <name>air_leakage_has_flue_or_chimney_in_conditioned_space</name>
       <display_name>Air Leakage: Has Flue or Chimney in Conditioned Space</display_name>
-      <description>Presence of flue or chimney with combustion air from conditioned space; used for infiltration model. If not provided, the OS-HPXML default is used.</description>
+      <description>Presence of flue or chimney with combustion air from conditioned space; used for infiltration model. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#flue-or-chimney'&gt;Flue or Chimney&lt;/a&gt;) is used.</description>
       <type>Boolean</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -2082,17 +2109,13 @@
           <display_name>Stove</display_name>
         </choice>
         <choice>
-          <value>PortableHeater</value>
-          <display_name>PortableHeater</display_name>
+          <value>SpaceHeater</value>
+          <display_name>SpaceHeater</display_name>
         </choice>
         <choice>
           <value>Fireplace</value>
           <display_name>Fireplace</display_name>
         </choice>
-        <choice>
-          <value>FixedHeater</value>
-          <display_name>FixedHeater</display_name>
-        </choice>
         <choice>
           <value>Shared Boiler w/ Baseboard</value>
           <display_name>Shared Boiler w/ Baseboard</display_name>
@@ -2155,7 +2178,7 @@
     <argument>
       <name>heating_system_heating_capacity</name>
       <display_name>Heating System: Heating Capacity</display_name>
-      <description>The output heating capacity of the heating system. If not provided, the OS-HPXML autosized default is used.</description>
+      <description>The output heating capacity of the heating system. If not provided, the OS-HPXML autosized default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-heating-systems'&gt;HPXML Heating Systems&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Btu/hr</units>
       <required>false</required>
@@ -2263,7 +2286,7 @@
     <argument>
       <name>cooling_system_cooling_compressor_type</name>
       <display_name>Cooling System: Cooling Compressor Type</display_name>
-      <description>The compressor type of the cooling system. Only applies to central air conditioner. If not provided, the OS-HPXML default is used.</description>
+      <description>The compressor type of the cooling system. Only applies to central air conditioner and mini-split. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#central-air-conditioner'&gt;Central Air Conditioner&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#mini-split-air-conditioner'&gt;Mini-Split Air Conditioner&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -2285,7 +2308,7 @@
     <argument>
       <name>cooling_system_cooling_sensible_heat_fraction</name>
       <display_name>Cooling System: Cooling Sensible Heat Fraction</display_name>
-      <description>The sensible heat fraction of the cooling system. Ignored for evaporative cooler. If not provided, the OS-HPXML default is used.</description>
+      <description>The sensible heat fraction of the cooling system. Ignored for evaporative cooler. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#central-air-conditioner'&gt;Central Air Conditioner&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#room-air-conditioner'&gt;Room Air Conditioner&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#packaged-terminal-air-conditioner'&gt;Packaged Terminal Air Conditioner&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#mini-split-air-conditioner'&gt;Mini-Split Air Conditioner&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -2294,7 +2317,7 @@
     <argument>
       <name>cooling_system_cooling_capacity</name>
       <display_name>Cooling System: Cooling Capacity</display_name>
-      <description>The output cooling capacity of the cooling system. If not provided, the OS-HPXML autosized default is used.</description>
+      <description>The output cooling capacity of the cooling system. If not provided, the OS-HPXML autosized default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#central-air-conditioner'&gt;Central Air Conditioner&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#room-air-conditioner'&gt;Room Air Conditioner&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#packaged-terminal-air-conditioner'&gt;Packaged Terminal Air Conditioner&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#evaporative-cooler'&gt;Evaporative Cooler&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#mini-split-air-conditioner'&gt;Mini-Split Air Conditioner&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Btu/hr</units>
       <required>false</required>
@@ -2350,7 +2373,7 @@
     <argument>
       <name>cooling_system_crankcase_heater_watts</name>
       <display_name>Cooling System: Crankcase Heater Power Watts</display_name>
-      <description>Cooling system crankcase heater power consumption in Watts. Applies only to central air conditioner, mini-split, packaged terminal air conditioner and room air conditioner. If not provided, the OS-HPXML default is used.</description>
+      <description>Cooling system crankcase heater power consumption in Watts. Applies only to central air conditioner, room air conditioner, packaged terminal air conditioner and mini-split. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#central-air-conditioner'&gt;Central Air Conditioner&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#room-air-conditioner'&gt;Room Air Conditioner&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#packaged-terminal-air-conditioner'&gt;Packaged Terminal Air Conditioner&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#mini-split-air-conditioner'&gt;Mini-Split Air Conditioner&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>W</units>
       <required>false</required>
@@ -2406,7 +2429,7 @@
     <argument>
       <name>cooling_system_integrated_heating_system_capacity</name>
       <display_name>Cooling System: Integrated Heating System Heating Capacity</display_name>
-      <description>The output heating capacity of the heating system integrated into cooling system. If not provided, the OS-HPXML autosized default is used. Only used for packaged terminal air conditioner and room air conditioner.</description>
+      <description>The output heating capacity of the heating system integrated into cooling system. If not provided, the OS-HPXML autosized default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#room-air-conditioner'&gt;Room Air Conditioner&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#packaged-terminal-air-conditioner'&gt;Packaged Terminal Air Conditioner&lt;/a&gt;) is used. Only used for room air conditioner and packaged terminal air conditioner.</description>
       <type>Double</type>
       <units>Btu/hr</units>
       <required>false</required>
@@ -2527,7 +2550,7 @@
     <argument>
       <name>heat_pump_cooling_compressor_type</name>
       <display_name>Heat Pump: Cooling Compressor Type</display_name>
-      <description>The compressor type of the heat pump. Only applies to air-to-air. If not provided, the OS-HPXML default is used.</description>
+      <description>The compressor type of the heat pump. Only applies to air-to-air and mini-split. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#air-to-air-heat-pump'&gt;Air-to-Air Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#mini-split-heat-pump'&gt;Mini-Split Heat Pump&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -2549,7 +2572,7 @@
     <argument>
       <name>heat_pump_cooling_sensible_heat_fraction</name>
       <display_name>Heat Pump: Cooling Sensible Heat Fraction</display_name>
-      <description>The sensible heat fraction of the heat pump. If not provided, the OS-HPXML default is used.</description>
+      <description>The sensible heat fraction of the heat pump. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#air-to-air-heat-pump'&gt;Air-to-Air Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#mini-split-heat-pump'&gt;Mini-Split Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#packaged-terminal-heat-pump'&gt;Packaged Terminal Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#room-air-conditioner-w-reverse-cycle'&gt;Room Air Conditioner w/ Reverse Cycle&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#ground-to-air-heat-pump'&gt;Ground-to-Air Heat Pump&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -2558,7 +2581,7 @@
     <argument>
       <name>heat_pump_heating_capacity</name>
       <display_name>Heat Pump: Heating Capacity</display_name>
-      <description>The output heating capacity of the heat pump. If not provided, the OS-HPXML autosized default is used.</description>
+      <description>The output heating capacity of the heat pump. If not provided, the OS-HPXML autosized default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#air-to-air-heat-pump'&gt;Air-to-Air Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#mini-split-heat-pump'&gt;Mini-Split Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#packaged-terminal-heat-pump'&gt;Packaged Terminal Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#room-air-conditioner-w-reverse-cycle'&gt;Room Air Conditioner w/ Reverse Cycle&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#ground-to-air-heat-pump'&gt;Ground-to-Air Heat Pump&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Btu/hr</units>
       <required>false</required>
@@ -2567,7 +2590,7 @@
     <argument>
       <name>heat_pump_heating_capacity_retention_fraction</name>
       <display_name>Heat Pump: Heating Capacity Retention Fraction</display_name>
-      <description>The output heating capacity of the heat pump at a user-specified temperature (e.g., 17F or 5F) divided by the above nominal heating capacity. Applies to all heat pump types except ground-to-air. If not provided, the OS-HPXML default is used.</description>
+      <description>The output heating capacity of the heat pump at a user-specified temperature (e.g., 17F or 5F) divided by the above nominal heating capacity. Applies to all heat pump types except ground-to-air. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#air-to-air-heat-pump'&gt;Air-to-Air Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#mini-split-heat-pump'&gt;Mini-Split Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#packaged-terminal-heat-pump'&gt;Packaged Terminal Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#room-air-conditioner-w-reverse-cycle'&gt;Room Air Conditioner w/ Reverse Cycle&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -2585,7 +2608,7 @@
     <argument>
       <name>heat_pump_cooling_capacity</name>
       <display_name>Heat Pump: Cooling Capacity</display_name>
-      <description>The output cooling capacity of the heat pump. If not provided, the OS-HPXML autosized default is used.</description>
+      <description>The output cooling capacity of the heat pump. If not provided, the OS-HPXML autosized default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#air-to-air-heat-pump'&gt;Air-to-Air Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#mini-split-heat-pump'&gt;Mini-Split Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#packaged-terminal-heat-pump'&gt;Packaged Terminal Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#room-air-conditioner-w-reverse-cycle'&gt;Room Air Conditioner w/ Reverse Cycle&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#ground-to-air-heat-pump'&gt;Ground-to-Air Heat Pump&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Btu/hr</units>
       <required>false</required>
@@ -2614,7 +2637,7 @@
     <argument>
       <name>heat_pump_compressor_lockout_temp</name>
       <display_name>Heat Pump: Compressor Lockout Temperature</display_name>
-      <description>The temperature below which the heat pump compressor is disabled. If both this and Backup Heating Lockout Temperature are provided and use the same value, it essentially defines a switchover temperature (for, e.g., a dual-fuel heat pump). Applies to all heat pump types other than ground-to-air. If not provided, the OS-HPXML default is used.</description>
+      <description>The temperature below which the heat pump compressor is disabled. If both this and Backup Heating Lockout Temperature are provided and use the same value, it essentially defines a switchover temperature (for, e.g., a dual-fuel heat pump). Applies to all heat pump types other than ground-to-air. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#air-to-air-heat-pump'&gt;Air-to-Air Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#mini-split-heat-pump'&gt;Mini-Split Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#packaged-terminal-heat-pump'&gt;Packaged Terminal Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#room-air-conditioner-w-reverse-cycle'&gt;Room Air Conditioner w/ Reverse Cycle&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>deg-F</units>
       <required>false</required>
@@ -2682,7 +2705,7 @@
     <argument>
       <name>heat_pump_backup_heating_capacity</name>
       <display_name>Heat Pump: Backup Heating Capacity</display_name>
-      <description>The backup output heating capacity of the heat pump. If not provided, the OS-HPXML autosized default is used. Only applies if Backup Type is 'integrated'.</description>
+      <description>The backup output heating capacity of the heat pump. If not provided, the OS-HPXML autosized default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#backup'&gt;Backup&lt;/a&gt;) is used. Only applies if Backup Type is 'integrated'.</description>
       <type>Double</type>
       <units>Btu/hr</units>
       <required>false</required>
@@ -2691,7 +2714,7 @@
     <argument>
       <name>heat_pump_backup_heating_lockout_temp</name>
       <display_name>Heat Pump: Backup Heating Lockout Temperature</display_name>
-      <description>The temperature above which the heat pump backup system is disabled. If both this and Compressor Lockout Temperature are provided and use the same value, it essentially defines a switchover temperature (for, e.g., a dual-fuel heat pump). Applies for both Backup Type of 'integrated' and 'separate'. If not provided, the OS-HPXML default is used.</description>
+      <description>The temperature above which the heat pump backup system is disabled. If both this and Compressor Lockout Temperature are provided and use the same value, it essentially defines a switchover temperature (for, e.g., a dual-fuel heat pump). Applies for both Backup Type of 'integrated' and 'separate'. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#backup'&gt;Backup&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>deg-F</units>
       <required>false</required>
@@ -2700,7 +2723,7 @@
     <argument>
       <name>heat_pump_sizing_methodology</name>
       <display_name>Heat Pump: Sizing Methodology</display_name>
-      <description>The auto-sizing methodology to use when the heat pump capacity is not provided. If not provided, the OS-HPXML default is used.</description>
+      <description>The auto-sizing methodology to use when the heat pump capacity is not provided. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-hvac-sizing-control'&gt;HPXML HVAC Sizing Control&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -2758,7 +2781,7 @@
     <argument>
       <name>heat_pump_crankcase_heater_watts</name>
       <display_name>Heat Pump: Crankcase Heater Power Watts</display_name>
-      <description>Heat Pump crankcase heater power consumption in Watts. Applies only to air-to-air, mini-split, packaged terminal heat pump and room air conditioner with reverse cycle. If not provided, the OS-HPXML default is used.</description>
+      <description>Heat Pump crankcase heater power consumption in Watts. Applies only to air-to-air, mini-split, packaged terminal heat pump and room air conditioner with reverse cycle. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#air-to-air-heat-pump'&gt;Air-to-Air Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#mini-split-heat-pump'&gt;Mini-Split Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#packaged-terminal-heat-pump'&gt;Packaged Terminal Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#room-air-conditioner-w-reverse-cycle'&gt;Room Air Conditioner w/ Reverse Cycle&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>W</units>
       <required>false</required>
@@ -2802,17 +2825,13 @@
           <display_name>Stove</display_name>
         </choice>
         <choice>
-          <value>PortableHeater</value>
-          <display_name>PortableHeater</display_name>
+          <value>SpaceHeater</value>
+          <display_name>SpaceHeater</display_name>
         </choice>
         <choice>
           <value>Fireplace</value>
           <display_name>Fireplace</display_name>
         </choice>
-        <choice>
-          <value>FixedHeater</value>
-          <display_name>FixedHeater</display_name>
-        </choice>
       </choices>
     </argument>
     <argument>
@@ -2867,7 +2886,7 @@
     <argument>
       <name>heating_system_2_heating_capacity</name>
       <display_name>Heating System 2: Heating Capacity</display_name>
-      <description>The output heating capacity of the second heating system. If not provided, the OS-HPXML autosized default is used.</description>
+      <description>The output heating capacity of the second heating system. If not provided, the OS-HPXML autosized default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-heating-systems'&gt;HPXML Heating Systems&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Btu/hr</units>
       <required>false</required>
@@ -2922,7 +2941,7 @@
     <argument>
       <name>hvac_control_heating_season_period</name>
       <display_name>HVAC Control: Heating Season Period</display_name>
-      <description>Enter a date like 'Nov 1 - Jun 30'. If not provided, the OS-HPXML default is used. Can also provide 'BuildingAmerica' to use automatic seasons from the Building America House Simulation Protocols.</description>
+      <description>Enter a date like 'Nov 1 - Jun 30'. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-hvac-control'&gt;HPXML HVAC Control&lt;/a&gt;) is used. Can also provide 'BuildingAmerica' to use automatic seasons from the Building America House Simulation Protocols.</description>
       <type>String</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -2930,7 +2949,7 @@
     <argument>
       <name>hvac_control_cooling_season_period</name>
       <display_name>HVAC Control: Cooling Season Period</display_name>
-      <description>Enter a date like 'Jun 1 - Oct 31'. If not provided, the OS-HPXML default is used. Can also provide 'BuildingAmerica' to use automatic seasons from the Building America House Simulation Protocols.</description>
+      <description>Enter a date like 'Jun 1 - Oct 31'. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-hvac-control'&gt;HPXML HVAC Control&lt;/a&gt;) is used. Can also provide 'BuildingAmerica' to use automatic seasons from the Building America House Simulation Protocols.</description>
       <type>String</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -2979,14 +2998,14 @@
     <argument>
       <name>ducts_supply_location</name>
       <display_name>Ducts: Supply Location</display_name>
-      <description>The location of the supply ducts. If not provided, the OS-HPXML default is used.</description>
+      <description>The location of the supply ducts. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#air-distribution'&gt;Air Distribution&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
       <choices>
         <choice>
-          <value>living space</value>
-          <display_name>living space</display_name>
+          <value>conditioned space</value>
+          <display_name>conditioned space</display_name>
         </choice>
         <choice>
           <value>basement - conditioned</value>
@@ -2996,6 +3015,10 @@
           <value>basement - unconditioned</value>
           <display_name>basement - unconditioned</display_name>
         </choice>
+        <choice>
+          <value>crawlspace</value>
+          <display_name>crawlspace</display_name>
+        </choice>
         <choice>
           <value>crawlspace - vented</value>
           <display_name>crawlspace - vented</display_name>
@@ -3008,6 +3031,10 @@
           <value>crawlspace - conditioned</value>
           <display_name>crawlspace - conditioned</display_name>
         </choice>
+        <choice>
+          <value>attic</value>
+          <display_name>attic</display_name>
+        </choice>
         <choice>
           <value>attic - vented</value>
           <display_name>attic - vented</display_name>
@@ -3052,6 +3079,10 @@
           <value>other non-freezing space</value>
           <display_name>other non-freezing space</display_name>
         </choice>
+        <choice>
+          <value>manufactured home belly</value>
+          <display_name>manufactured home belly</display_name>
+        </choice>
       </choices>
     </argument>
     <argument>
@@ -3093,23 +3124,32 @@
     <argument>
       <name>ducts_supply_surface_area</name>
       <display_name>Ducts: Supply Surface Area</display_name>
-      <description>The surface area of the supply ducts. If not provided, the OS-HPXML default is used.</description>
+      <description>The supply ducts surface area in the given location. If neither Surface Area nor Area Fraction provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#air-distribution'&gt;Air Distribution&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>ft^2</units>
       <required>false</required>
       <model_dependent>false</model_dependent>
     </argument>
+    <argument>
+      <name>ducts_supply_surface_area_fraction</name>
+      <display_name>Ducts: Supply Area Fraction</display_name>
+      <description>The fraction of supply ducts surface area in the given location. Only used if Surface Area is not provided. If the fraction is less than 1, the remaining duct area is assumed to be in conditioned space. If neither Surface Area nor Area Fraction provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#air-distribution'&gt;Air Distribution&lt;/a&gt;) is used.</description>
+      <type>Double</type>
+      <units>frac</units>
+      <required>false</required>
+      <model_dependent>false</model_dependent>
+    </argument>
     <argument>
       <name>ducts_return_location</name>
       <display_name>Ducts: Return Location</display_name>
-      <description>The location of the return ducts. If not provided, the OS-HPXML default is used.</description>
+      <description>The location of the return ducts. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#air-distribution'&gt;Air Distribution&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
       <choices>
         <choice>
-          <value>living space</value>
-          <display_name>living space</display_name>
+          <value>conditioned space</value>
+          <display_name>conditioned space</display_name>
         </choice>
         <choice>
           <value>basement - conditioned</value>
@@ -3119,6 +3159,10 @@
           <value>basement - unconditioned</value>
           <display_name>basement - unconditioned</display_name>
         </choice>
+        <choice>
+          <value>crawlspace</value>
+          <display_name>crawlspace</display_name>
+        </choice>
         <choice>
           <value>crawlspace - vented</value>
           <display_name>crawlspace - vented</display_name>
@@ -3131,6 +3175,10 @@
           <value>crawlspace - conditioned</value>
           <display_name>crawlspace - conditioned</display_name>
         </choice>
+        <choice>
+          <value>attic</value>
+          <display_name>attic</display_name>
+        </choice>
         <choice>
           <value>attic - vented</value>
           <display_name>attic - vented</display_name>
@@ -3175,6 +3223,10 @@
           <value>other non-freezing space</value>
           <display_name>other non-freezing space</display_name>
         </choice>
+        <choice>
+          <value>manufactured home belly</value>
+          <display_name>manufactured home belly</display_name>
+        </choice>
       </choices>
     </argument>
     <argument>
@@ -3216,16 +3268,25 @@
     <argument>
       <name>ducts_return_surface_area</name>
       <display_name>Ducts: Return Surface Area</display_name>
-      <description>The surface area of the return ducts. If not provided, the OS-HPXML default is used.</description>
+      <description>The return ducts surface area in the given location. If neither Surface Area nor Area Fraction provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#air-distribution'&gt;Air Distribution&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>ft^2</units>
       <required>false</required>
       <model_dependent>false</model_dependent>
     </argument>
+    <argument>
+      <name>ducts_return_surface_area_fraction</name>
+      <display_name>Ducts: Return Area Fraction</display_name>
+      <description>The fraction of return ducts surface area in the given location. Only used if Surface Area is not provided. If the fraction is less than 1, the remaining duct area is assumed to be in conditioned space. If neither Surface Area nor Area Fraction provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#air-distribution'&gt;Air Distribution&lt;/a&gt;) is used.</description>
+      <type>Double</type>
+      <units>frac</units>
+      <required>false</required>
+      <model_dependent>false</model_dependent>
+    </argument>
     <argument>
       <name>ducts_number_of_return_registers</name>
       <display_name>Ducts: Number of Return Registers</display_name>
-      <description>The number of return registers of the ducts. Only used to calculate default return duct surface area. If not provided, the OS-HPXML default is used.</description>
+      <description>The number of return registers of the ducts. Only used to calculate default return duct surface area. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#air-distribution'&gt;Air Distribution&lt;/a&gt;) is used.</description>
       <type>Integer</type>
       <units>#</units>
       <required>false</required>
@@ -3273,7 +3334,7 @@
     <argument>
       <name>mech_vent_flow_rate</name>
       <display_name>Mechanical Ventilation: Flow Rate</display_name>
-      <description>The flow rate of the mechanical ventilation. If not provided, the OS-HPXML default is used.</description>
+      <description>The flow rate of the mechanical ventilation. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#whole-ventilation-fan'&gt;Whole Ventilation Fan&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>CFM</units>
       <required>false</required>
@@ -3282,7 +3343,7 @@
     <argument>
       <name>mech_vent_hours_in_operation</name>
       <display_name>Mechanical Ventilation: Hours In Operation</display_name>
-      <description>The hours in operation of the mechanical ventilation. If not provided, the OS-HPXML default is used.</description>
+      <description>The hours in operation of the mechanical ventilation. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#whole-ventilation-fan'&gt;Whole Ventilation Fan&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>hrs/day</units>
       <required>false</required>
@@ -3330,7 +3391,7 @@
     <argument>
       <name>mech_vent_fan_power</name>
       <display_name>Mechanical Ventilation: Fan Power</display_name>
-      <description>The fan power of the mechanical ventilation. If not provided, the OS-HPXML default is used.</description>
+      <description>The fan power of the mechanical ventilation. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#whole-ventilation-fan'&gt;Whole Ventilation Fan&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>W</units>
       <required>false</required>
@@ -3550,7 +3611,7 @@
     <argument>
       <name>kitchen_fans_quantity</name>
       <display_name>Kitchen Fans: Quantity</display_name>
-      <description>The quantity of the kitchen fans. If not provided, the OS-HPXML default is used.</description>
+      <description>The quantity of the kitchen fans. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#local-ventilation-fan'&gt;Local Ventilation Fan&lt;/a&gt;) is used.</description>
       <type>Integer</type>
       <units>#</units>
       <required>false</required>
@@ -3559,7 +3620,7 @@
     <argument>
       <name>kitchen_fans_flow_rate</name>
       <display_name>Kitchen Fans: Flow Rate</display_name>
-      <description>The flow rate of the kitchen fan. If not provided, the OS-HPXML default is used.</description>
+      <description>The flow rate of the kitchen fan. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#local-ventilation-fan'&gt;Local Ventilation Fan&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>CFM</units>
       <required>false</required>
@@ -3568,7 +3629,7 @@
     <argument>
       <name>kitchen_fans_hours_in_operation</name>
       <display_name>Kitchen Fans: Hours In Operation</display_name>
-      <description>The hours in operation of the kitchen fan. If not provided, the OS-HPXML default is used.</description>
+      <description>The hours in operation of the kitchen fan. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#local-ventilation-fan'&gt;Local Ventilation Fan&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>hrs/day</units>
       <required>false</required>
@@ -3577,7 +3638,7 @@
     <argument>
       <name>kitchen_fans_power</name>
       <display_name>Kitchen Fans: Fan Power</display_name>
-      <description>The fan power of the kitchen fan. If not provided, the OS-HPXML default is used.</description>
+      <description>The fan power of the kitchen fan. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#local-ventilation-fan'&gt;Local Ventilation Fan&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>W</units>
       <required>false</required>
@@ -3586,7 +3647,7 @@
     <argument>
       <name>kitchen_fans_start_hour</name>
       <display_name>Kitchen Fans: Start Hour</display_name>
-      <description>The start hour of the kitchen fan. If not provided, the OS-HPXML default is used.</description>
+      <description>The start hour of the kitchen fan. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#local-ventilation-fan'&gt;Local Ventilation Fan&lt;/a&gt;) is used.</description>
       <type>Integer</type>
       <units>hr</units>
       <required>false</required>
@@ -3595,7 +3656,7 @@
     <argument>
       <name>bathroom_fans_quantity</name>
       <display_name>Bathroom Fans: Quantity</display_name>
-      <description>The quantity of the bathroom fans. If not provided, the OS-HPXML default is used.</description>
+      <description>The quantity of the bathroom fans. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#local-ventilation-fan'&gt;Local Ventilation Fan&lt;/a&gt;) is used.</description>
       <type>Integer</type>
       <units>#</units>
       <required>false</required>
@@ -3604,7 +3665,7 @@
     <argument>
       <name>bathroom_fans_flow_rate</name>
       <display_name>Bathroom Fans: Flow Rate</display_name>
-      <description>The flow rate of the bathroom fans. If not provided, the OS-HPXML default is used.</description>
+      <description>The flow rate of the bathroom fans. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#local-ventilation-fan'&gt;Local Ventilation Fan&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>CFM</units>
       <required>false</required>
@@ -3613,7 +3674,7 @@
     <argument>
       <name>bathroom_fans_hours_in_operation</name>
       <display_name>Bathroom Fans: Hours In Operation</display_name>
-      <description>The hours in operation of the bathroom fans. If not provided, the OS-HPXML default is used.</description>
+      <description>The hours in operation of the bathroom fans. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#local-ventilation-fan'&gt;Local Ventilation Fan&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>hrs/day</units>
       <required>false</required>
@@ -3622,7 +3683,7 @@
     <argument>
       <name>bathroom_fans_power</name>
       <display_name>Bathroom Fans: Fan Power</display_name>
-      <description>The fan power of the bathroom fans. If not provided, the OS-HPXML default is used.</description>
+      <description>The fan power of the bathroom fans. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#local-ventilation-fan'&gt;Local Ventilation Fan&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>W</units>
       <required>false</required>
@@ -3631,7 +3692,7 @@
     <argument>
       <name>bathroom_fans_start_hour</name>
       <display_name>Bathroom Fans: Start Hour</display_name>
-      <description>The start hour of the bathroom fans. If not provided, the OS-HPXML default is used.</description>
+      <description>The start hour of the bathroom fans. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#local-ventilation-fan'&gt;Local Ventilation Fan&lt;/a&gt;) is used.</description>
       <type>Integer</type>
       <units>hr</units>
       <required>false</required>
@@ -3659,7 +3720,7 @@
     <argument>
       <name>whole_house_fan_flow_rate</name>
       <display_name>Whole House Fan: Flow Rate</display_name>
-      <description>The flow rate of the whole house fan. If not provided, the OS-HPXML default is used.</description>
+      <description>The flow rate of the whole house fan. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#whole-house-fan'&gt;Whole House Fan&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>CFM</units>
       <required>false</required>
@@ -3668,7 +3729,7 @@
     <argument>
       <name>whole_house_fan_power</name>
       <display_name>Whole House Fan: Fan Power</display_name>
-      <description>The fan power of the whole house fan. If not provided, the OS-HPXML default is used.</description>
+      <description>The fan power of the whole house fan. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#whole-house-fan'&gt;Whole House Fan&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>W</units>
       <required>false</required>
@@ -3747,14 +3808,14 @@
     <argument>
       <name>water_heater_location</name>
       <display_name>Water Heater: Location</display_name>
-      <description>The location of water heater. If not provided, the OS-HPXML default is used.</description>
+      <description>The location of water heater. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-water-heating-systems'&gt;HPXML Water Heating Systems&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
       <choices>
         <choice>
-          <value>living space</value>
-          <display_name>living space</display_name>
+          <value>conditioned space</value>
+          <display_name>conditioned space</display_name>
         </choice>
         <choice>
           <value>basement - conditioned</value>
@@ -3768,6 +3829,10 @@
           <value>garage</value>
           <display_name>garage</display_name>
         </choice>
+        <choice>
+          <value>attic</value>
+          <display_name>attic</display_name>
+        </choice>
         <choice>
           <value>attic - vented</value>
           <display_name>attic - vented</display_name>
@@ -3776,6 +3841,10 @@
           <value>attic - unvented</value>
           <display_name>attic - unvented</display_name>
         </choice>
+        <choice>
+          <value>crawlspace</value>
+          <display_name>crawlspace</display_name>
+        </choice>
         <choice>
           <value>crawlspace - vented</value>
           <display_name>crawlspace - vented</display_name>
@@ -3813,7 +3882,7 @@
     <argument>
       <name>water_heater_tank_volume</name>
       <display_name>Water Heater: Tank Volume</display_name>
-      <description>Nominal volume of water heater tank. Only applies to storage water heater, heat pump water heater, and space-heating boiler with storage tank. If not provided, the OS-HPXML default is used.</description>
+      <description>Nominal volume of water heater tank. Only applies to storage water heater, heat pump water heater, and space-heating boiler with storage tank. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#conventional-storage'&gt;Conventional Storage&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#heat-pump'&gt;Heat Pump&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#combi-boiler-w-storage'&gt;Combi Boiler w/ Storage&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>gal</units>
       <required>false</required>
@@ -3850,7 +3919,7 @@
     <argument>
       <name>water_heater_usage_bin</name>
       <display_name>Water Heater: Usage Bin</display_name>
-      <description>The usage of the water heater. Only applies if Efficiency Type is UniformEnergyFactor and Type is not instantaneous water heater. Does not apply to space-heating boilers. If not provided, the OS-HPXML default is used.</description>
+      <description>The usage of the water heater. Only applies if Efficiency Type is UniformEnergyFactor and Type is not instantaneous water heater. Does not apply to space-heating boilers. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#conventional-storage'&gt;Conventional Storage&lt;/a&gt;, &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#heat-pump'&gt;Heat Pump&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -3876,7 +3945,7 @@
     <argument>
       <name>water_heater_recovery_efficiency</name>
       <display_name>Water Heater: Recovery Efficiency</display_name>
-      <description>Ratio of energy delivered to water heater to the energy content of the fuel consumed by the water heater. Only used for non-electric storage water heaters. If not provided, the OS-HPXML default is used.</description>
+      <description>Ratio of energy delivered to water heater to the energy content of the fuel consumed by the water heater. Only used for non-electric storage water heaters. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#conventional-storage'&gt;Conventional Storage&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -3885,7 +3954,7 @@
     <argument>
       <name>water_heater_heating_capacity</name>
       <display_name>Water Heater: Heating Capacity</display_name>
-      <description>Heating capacity. Only applies to storage water heater. If not provided, the OS-HPXML default is used.</description>
+      <description>Heating capacity. Only applies to storage water heater. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#conventional-storage'&gt;Conventional Storage&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Btu/hr</units>
       <required>false</required>
@@ -3894,7 +3963,7 @@
     <argument>
       <name>water_heater_standby_loss</name>
       <display_name>Water Heater: Standby Loss</display_name>
-      <description>The standby loss of water heater. Only applies to space-heating boilers. If not provided, the OS-HPXML default is used.</description>
+      <description>The standby loss of water heater. Only applies to space-heating boilers. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#combi-boiler-w-storage'&gt;Combi Boiler w/ Storage&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>deg-F/hr</units>
       <required>false</required>
@@ -3912,7 +3981,7 @@
     <argument>
       <name>water_heater_setpoint_temperature</name>
       <display_name>Water Heater: Setpoint Temperature</display_name>
-      <description>The setpoint temperature of water heater. If not provided, the OS-HPXML default is used.</description>
+      <description>The setpoint temperature of water heater. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-water-heating-systems'&gt;HPXML Water Heating Systems&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>deg-F</units>
       <required>false</required>
@@ -3949,7 +4018,7 @@
     <argument>
       <name>water_heater_tank_model_type</name>
       <display_name>Water Heater: Tank Type</display_name>
-      <description>Type of tank model to use. The 'stratified' tank generally provide more accurate results, but may significantly increase run time. Applies only to storage water heater. If not provided, the OS-HPXML default is used.</description>
+      <description>Type of tank model to use. The 'stratified' tank generally provide more accurate results, but may significantly increase run time. Applies only to storage water heater. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#conventional-storage'&gt;Conventional Storage&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -3967,7 +4036,7 @@
     <argument>
       <name>water_heater_operating_mode</name>
       <display_name>Water Heater: Operating Mode</display_name>
-      <description>The water heater operating mode. The 'heat pump only' option only uses the heat pump, while 'hybrid/auto' allows the backup electric resistance to come on in high demand situations. This is ignored if a scheduled operating mode type is selected. Applies only to heat pump water heater. If not provided, the OS-HPXML default is used.</description>
+      <description>The water heater operating mode. The 'heat pump only' option only uses the heat pump, while 'hybrid/auto' allows the backup electric resistance to come on in high demand situations. This is ignored if a scheduled operating mode type is selected. Applies only to heat pump water heater. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#heat-pump'&gt;Heat Pump&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -4004,7 +4073,7 @@
     <argument>
       <name>hot_water_distribution_standard_piping_length</name>
       <display_name>Hot Water Distribution: Standard Piping Length</display_name>
-      <description>If the distribution system is Standard, the length of the piping. If not provided, the OS-HPXML default is used.</description>
+      <description>If the distribution system is Standard, the length of the piping. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#standard'&gt;Standard&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>ft</units>
       <required>false</required>
@@ -4044,7 +4113,7 @@
     <argument>
       <name>hot_water_distribution_recirc_piping_length</name>
       <display_name>Hot Water Distribution: Recirculation Piping Length</display_name>
-      <description>If the distribution system is Recirculation, the length of the recirculation piping. If not provided, the OS-HPXML default is used.</description>
+      <description>If the distribution system is Recirculation, the length of the recirculation piping. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#recirculation'&gt;Recirculation&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>ft</units>
       <required>false</required>
@@ -4053,7 +4122,7 @@
     <argument>
       <name>hot_water_distribution_recirc_branch_piping_length</name>
       <display_name>Hot Water Distribution: Recirculation Branch Piping Length</display_name>
-      <description>If the distribution system is Recirculation, the length of the recirculation branch piping. If not provided, the OS-HPXML default is used.</description>
+      <description>If the distribution system is Recirculation, the length of the recirculation branch piping. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#recirculation'&gt;Recirculation&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>ft</units>
       <required>false</required>
@@ -4062,7 +4131,7 @@
     <argument>
       <name>hot_water_distribution_recirc_pump_power</name>
       <display_name>Hot Water Distribution: Recirculation Pump Power</display_name>
-      <description>If the distribution system is Recirculation, the recirculation pump power. If not provided, the OS-HPXML default is used.</description>
+      <description>If the distribution system is Recirculation, the recirculation pump power. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#recirculation'&gt;Recirculation&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>W</units>
       <required>false</required>
@@ -4071,7 +4140,7 @@
     <argument>
       <name>hot_water_distribution_pipe_r</name>
       <display_name>Hot Water Distribution: Pipe Insulation Nominal R-Value</display_name>
-      <description>Nominal R-value of the pipe insulation. If not provided, the OS-HPXML default is used.</description>
+      <description>Nominal R-value of the pipe insulation. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-hot-water-distribution'&gt;HPXML Hot Water Distribution&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>h-ft^2-R/Btu</units>
       <required>false</required>
@@ -4170,7 +4239,7 @@
     <argument>
       <name>water_fixtures_usage_multiplier</name>
       <display_name>Hot Water Fixtures: Usage Multiplier</display_name>
-      <description>Multiplier on the hot water usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the hot water 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-water-fixtures'&gt;HPXML Water Fixtures&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -4297,7 +4366,7 @@
     <argument>
       <name>solar_thermal_storage_volume</name>
       <display_name>Solar Thermal: Storage Volume</display_name>
-      <description>The storage volume of the solar thermal system. If not provided, the OS-HPXML default is used.</description>
+      <description>The storage volume of the solar thermal system. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#detailed-inputs'&gt;Detailed Inputs&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>gal</units>
       <required>false</required>
@@ -4335,7 +4404,7 @@
     <argument>
       <name>pv_system_module_type</name>
       <display_name>PV System: Module Type</display_name>
-      <description>Module type of the PV system. If not provided, the OS-HPXML default is used.</description>
+      <description>Module type of the PV system. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-photovoltaics'&gt;HPXML Photovoltaics&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -4357,7 +4426,7 @@
     <argument>
       <name>pv_system_location</name>
       <display_name>PV System: Location</display_name>
-      <description>Location of the PV system. If not provided, the OS-HPXML default is used.</description>
+      <description>Location of the PV system. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-photovoltaics'&gt;HPXML Photovoltaics&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -4375,7 +4444,7 @@
     <argument>
       <name>pv_system_tracking</name>
       <display_name>PV System: Tracking</display_name>
-      <description>Type of tracking for the PV system. If not provided, the OS-HPXML default is used.</description>
+      <description>Type of tracking for the PV system. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-photovoltaics'&gt;HPXML Photovoltaics&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -4431,7 +4500,7 @@
     <argument>
       <name>pv_system_inverter_efficiency</name>
       <display_name>PV System: Inverter Efficiency</display_name>
-      <description>Inverter efficiency of the PV system. If there are two PV systems, this will apply to both. If not provided, the OS-HPXML default is used.</description>
+      <description>Inverter efficiency of the PV system. If there are two PV systems, this will apply to both. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-photovoltaics'&gt;HPXML Photovoltaics&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -4440,7 +4509,7 @@
     <argument>
       <name>pv_system_system_losses_fraction</name>
       <display_name>PV System: System Losses Fraction</display_name>
-      <description>System losses fraction of the PV system. If there are two PV systems, this will apply to both. If not provided, the OS-HPXML default is used.</description>
+      <description>System losses fraction of the PV system. If there are two PV systems, this will apply to both. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-photovoltaics'&gt;HPXML Photovoltaics&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -4477,7 +4546,7 @@
     <argument>
       <name>pv_system_2_module_type</name>
       <display_name>PV System 2: Module Type</display_name>
-      <description>Module type of the second PV system. If not provided, the OS-HPXML default is used.</description>
+      <description>Module type of the second PV system. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-photovoltaics'&gt;HPXML Photovoltaics&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -4499,7 +4568,7 @@
     <argument>
       <name>pv_system_2_location</name>
       <display_name>PV System 2: Location</display_name>
-      <description>Location of the second PV system. If not provided, the OS-HPXML default is used.</description>
+      <description>Location of the second PV system. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-photovoltaics'&gt;HPXML Photovoltaics&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -4517,7 +4586,7 @@
     <argument>
       <name>pv_system_2_tracking</name>
       <display_name>PV System 2: Tracking</display_name>
-      <description>Type of tracking for the second PV system. If not provided, the OS-HPXML default is used.</description>
+      <description>Type of tracking for the second PV system. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-photovoltaics'&gt;HPXML Photovoltaics&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -4592,14 +4661,14 @@
     <argument>
       <name>battery_location</name>
       <display_name>Battery: Location</display_name>
-      <description>The space type for the lithium ion battery location. If not provided, the OS-HPXML default is used.</description>
+      <description>The space type for the lithium ion battery location. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-batteries'&gt;HPXML Batteries&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
       <choices>
         <choice>
-          <value>living space</value>
-          <display_name>living space</display_name>
+          <value>conditioned space</value>
+          <display_name>conditioned space</display_name>
         </choice>
         <choice>
           <value>basement - conditioned</value>
@@ -4609,6 +4678,10 @@
           <value>basement - unconditioned</value>
           <display_name>basement - unconditioned</display_name>
         </choice>
+        <choice>
+          <value>crawlspace</value>
+          <display_name>crawlspace</display_name>
+        </choice>
         <choice>
           <value>crawlspace - vented</value>
           <display_name>crawlspace - vented</display_name>
@@ -4621,6 +4694,10 @@
           <value>crawlspace - conditioned</value>
           <display_name>crawlspace - conditioned</display_name>
         </choice>
+        <choice>
+          <value>attic</value>
+          <display_name>attic</display_name>
+        </choice>
         <choice>
           <value>attic - vented</value>
           <display_name>attic - vented</display_name>
@@ -4642,7 +4719,7 @@
     <argument>
       <name>battery_power</name>
       <display_name>Battery: Rated Power Output</display_name>
-      <description>The rated power output of the lithium ion battery. If not provided, the OS-HPXML default is used.</description>
+      <description>The rated power output of the lithium ion battery. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-batteries'&gt;HPXML Batteries&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>W</units>
       <required>false</required>
@@ -4651,7 +4728,7 @@
     <argument>
       <name>battery_capacity</name>
       <display_name>Battery: Nominal Capacity</display_name>
-      <description>The nominal capacity of the lithium ion battery. If not provided, the OS-HPXML default is used.</description>
+      <description>The nominal capacity of the lithium ion battery. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-batteries'&gt;HPXML Batteries&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>kWh</units>
       <required>false</required>
@@ -4660,7 +4737,7 @@
     <argument>
       <name>battery_usable_capacity</name>
       <display_name>Battery: Usable Capacity</display_name>
-      <description>The usable capacity of the lithium ion battery. If not provided, the OS-HPXML default is used.</description>
+      <description>The usable capacity of the lithium ion battery. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-batteries'&gt;HPXML Batteries&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>kWh</units>
       <required>false</required>
@@ -4669,7 +4746,7 @@
     <argument>
       <name>battery_round_trip_efficiency</name>
       <display_name>Battery: Round Trip Efficiency</display_name>
-      <description>The round trip efficiency of the lithium ion battery. If not provided, the OS-HPXML default is used.</description>
+      <description>The round trip efficiency of the lithium ion battery. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-batteries'&gt;HPXML Batteries&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -4724,7 +4801,7 @@
     <argument>
       <name>lighting_interior_usage_multiplier</name>
       <display_name>Lighting: Interior Usage Multiplier</display_name>
-      <description>Multiplier on the lighting energy usage (interior) that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the lighting energy usage (interior) 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-lighting'&gt;HPXML Lighting&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -4759,7 +4836,7 @@
     <argument>
       <name>lighting_exterior_usage_multiplier</name>
       <display_name>Lighting: Exterior Usage Multiplier</display_name>
-      <description>Multiplier on the lighting energy usage (exterior) that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the lighting energy usage (exterior) 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-lighting'&gt;HPXML Lighting&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -4794,7 +4871,7 @@
     <argument>
       <name>lighting_garage_usage_multiplier</name>
       <display_name>Lighting: Garage Usage Multiplier</display_name>
-      <description>Multiplier on the lighting energy usage (garage) that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the lighting energy usage (garage) 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-lighting'&gt;HPXML Lighting&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -4821,7 +4898,7 @@
     <argument>
       <name>holiday_lighting_daily_kwh</name>
       <display_name>Holiday Lighting: Daily Consumption</display_name>
-      <description>The daily energy consumption for holiday lighting (exterior). If not provided, the OS-HPXML default is used.</description>
+      <description>The daily energy consumption for holiday lighting (exterior). If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-lighting'&gt;HPXML Lighting&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>kWh/day</units>
       <required>false</required>
@@ -4830,7 +4907,7 @@
     <argument>
       <name>holiday_lighting_period</name>
       <display_name>Holiday Lighting: Period</display_name>
-      <description>Enter a date like "Nov 25 - Jan 5". If not provided, the OS-HPXML default is used.</description>
+      <description>Enter a date like 'Nov 25 - Jan 5'. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-lighting'&gt;HPXML Lighting&lt;/a&gt;) is used.</description>
       <type>String</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -4939,14 +5016,14 @@
     <argument>
       <name>clothes_washer_location</name>
       <display_name>Clothes Washer: Location</display_name>
-      <description>The space type for the clothes washer location. If not provided, the OS-HPXML default is used.</description>
+      <description>The space type for the clothes washer location. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-clothes-washer'&gt;HPXML Clothes Washer&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
       <choices>
         <choice>
-          <value>living space</value>
-          <display_name>living space</display_name>
+          <value>conditioned space</value>
+          <display_name>conditioned space</display_name>
         </choice>
         <choice>
           <value>basement - conditioned</value>
@@ -5000,7 +5077,7 @@
     <argument>
       <name>clothes_washer_efficiency</name>
       <display_name>Clothes Washer: Efficiency</display_name>
-      <description>The efficiency of the clothes washer. If not provided, the OS-HPXML default is used.</description>
+      <description>The efficiency of the clothes washer. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-clothes-washer'&gt;HPXML Clothes Washer&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>ft^3/kWh-cyc</units>
       <required>false</required>
@@ -5009,7 +5086,7 @@
     <argument>
       <name>clothes_washer_rated_annual_kwh</name>
       <display_name>Clothes Washer: Rated Annual Consumption</display_name>
-      <description>The annual energy consumed by the clothes washer, as rated, obtained from the EnergyGuide label. This includes both the appliance electricity consumption and the energy required for water heating. If not provided, the OS-HPXML default is used.</description>
+      <description>The annual energy consumed by the clothes washer, as rated, obtained from the EnergyGuide label. This includes both the appliance electricity consumption and the energy required for water heating. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-clothes-washer'&gt;HPXML Clothes Washer&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>kWh/yr</units>
       <required>false</required>
@@ -5018,7 +5095,7 @@
     <argument>
       <name>clothes_washer_label_electric_rate</name>
       <display_name>Clothes Washer: Label Electric Rate</display_name>
-      <description>The annual energy consumed by the clothes washer, as rated, obtained from the EnergyGuide label. This includes both the appliance electricity consumption and the energy required for water heating. If not provided, the OS-HPXML default is used.</description>
+      <description>The annual energy consumed by the clothes washer, as rated, obtained from the EnergyGuide label. This includes both the appliance electricity consumption and the energy required for water heating. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-clothes-washer'&gt;HPXML Clothes Washer&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>$/kWh</units>
       <required>false</required>
@@ -5027,7 +5104,7 @@
     <argument>
       <name>clothes_washer_label_gas_rate</name>
       <display_name>Clothes Washer: Label Gas Rate</display_name>
-      <description>The annual energy consumed by the clothes washer, as rated, obtained from the EnergyGuide label. This includes both the appliance electricity consumption and the energy required for water heating. If not provided, the OS-HPXML default is used.</description>
+      <description>The annual energy consumed by the clothes washer, as rated, obtained from the EnergyGuide label. This includes both the appliance electricity consumption and the energy required for water heating. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-clothes-washer'&gt;HPXML Clothes Washer&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>$/therm</units>
       <required>false</required>
@@ -5036,7 +5113,7 @@
     <argument>
       <name>clothes_washer_label_annual_gas_cost</name>
       <display_name>Clothes Washer: Label Annual Cost with Gas DHW</display_name>
-      <description>The annual cost of using the system under test conditions. Input is obtained from the EnergyGuide label. If not provided, the OS-HPXML default is used.</description>
+      <description>The annual cost of using the system under test conditions. Input is obtained from the EnergyGuide label. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-clothes-washer'&gt;HPXML Clothes Washer&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>$</units>
       <required>false</required>
@@ -5045,7 +5122,7 @@
     <argument>
       <name>clothes_washer_label_usage</name>
       <display_name>Clothes Washer: Label Usage</display_name>
-      <description>The clothes washer loads per week. If not provided, the OS-HPXML default is used.</description>
+      <description>The clothes washer loads per week. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-clothes-washer'&gt;HPXML Clothes Washer&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>cyc/wk</units>
       <required>false</required>
@@ -5054,7 +5131,7 @@
     <argument>
       <name>clothes_washer_capacity</name>
       <display_name>Clothes Washer: Drum Volume</display_name>
-      <description>Volume of the washer drum. Obtained from the EnergyStar website or the manufacturer's literature. If not provided, the OS-HPXML default is used.</description>
+      <description>Volume of the washer drum. Obtained from the EnergyStar website or the manufacturer's literature. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-clothes-washer'&gt;HPXML Clothes Washer&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>ft^3</units>
       <required>false</required>
@@ -5063,7 +5140,7 @@
     <argument>
       <name>clothes_washer_usage_multiplier</name>
       <display_name>Clothes Washer: Usage Multiplier</display_name>
-      <description>Multiplier on the clothes washer energy and hot water usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the clothes washer energy and hot water 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-clothes-washer'&gt;HPXML Clothes Washer&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -5090,14 +5167,14 @@
     <argument>
       <name>clothes_dryer_location</name>
       <display_name>Clothes Dryer: Location</display_name>
-      <description>The space type for the clothes dryer location. If not provided, the OS-HPXML default is used.</description>
+      <description>The space type for the clothes dryer location. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-clothes-dryer'&gt;HPXML Clothes Dryer&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
       <choices>
         <choice>
-          <value>living space</value>
-          <display_name>living space</display_name>
+          <value>conditioned space</value>
+          <display_name>conditioned space</display_name>
         </choice>
         <choice>
           <value>basement - conditioned</value>
@@ -5186,7 +5263,7 @@
     <argument>
       <name>clothes_dryer_efficiency</name>
       <display_name>Clothes Dryer: Efficiency</display_name>
-      <description>The efficiency of the clothes dryer. If not provided, the OS-HPXML default is used.</description>
+      <description>The efficiency of the clothes dryer. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-clothes-dryer'&gt;HPXML Clothes Dryer&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>lb/kWh</units>
       <required>false</required>
@@ -5195,7 +5272,7 @@
     <argument>
       <name>clothes_dryer_vented_flow_rate</name>
       <display_name>Clothes Dryer: Vented Flow Rate</display_name>
-      <description>The exhaust flow rate of the vented clothes dryer. If not provided, the OS-HPXML default is used.</description>
+      <description>The exhaust flow rate of the vented clothes dryer. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-clothes-dryer'&gt;HPXML Clothes Dryer&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>CFM</units>
       <required>false</required>
@@ -5204,7 +5281,7 @@
     <argument>
       <name>clothes_dryer_usage_multiplier</name>
       <display_name>Clothes Dryer: Usage Multiplier</display_name>
-      <description>Multiplier on the clothes dryer energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the clothes dryer 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-clothes-dryer'&gt;HPXML Clothes Dryer&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -5231,14 +5308,14 @@
     <argument>
       <name>dishwasher_location</name>
       <display_name>Dishwasher: Location</display_name>
-      <description>The space type for the dishwasher location. If not provided, the OS-HPXML default is used.</description>
+      <description>The space type for the dishwasher location. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-dishwasher'&gt;HPXML Dishwasher&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
       <choices>
         <choice>
-          <value>living space</value>
-          <display_name>living space</display_name>
+          <value>conditioned space</value>
+          <display_name>conditioned space</display_name>
         </choice>
         <choice>
           <value>basement - conditioned</value>
@@ -5292,7 +5369,7 @@
     <argument>
       <name>dishwasher_efficiency</name>
       <display_name>Dishwasher: Efficiency</display_name>
-      <description>The efficiency of the dishwasher. If not provided, the OS-HPXML default is used.</description>
+      <description>The efficiency of the dishwasher. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-dishwasher'&gt;HPXML Dishwasher&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>RatedAnnualkWh or EnergyFactor</units>
       <required>false</required>
@@ -5301,7 +5378,7 @@
     <argument>
       <name>dishwasher_label_electric_rate</name>
       <display_name>Dishwasher: Label Electric Rate</display_name>
-      <description>The label electric rate of the dishwasher. If not provided, the OS-HPXML default is used.</description>
+      <description>The label electric rate of the dishwasher. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-dishwasher'&gt;HPXML Dishwasher&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>$/kWh</units>
       <required>false</required>
@@ -5310,7 +5387,7 @@
     <argument>
       <name>dishwasher_label_gas_rate</name>
       <display_name>Dishwasher: Label Gas Rate</display_name>
-      <description>The label gas rate of the dishwasher. If not provided, the OS-HPXML default is used.</description>
+      <description>The label gas rate of the dishwasher. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-dishwasher'&gt;HPXML Dishwasher&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>$/therm</units>
       <required>false</required>
@@ -5319,7 +5396,7 @@
     <argument>
       <name>dishwasher_label_annual_gas_cost</name>
       <display_name>Dishwasher: Label Annual Gas Cost</display_name>
-      <description>The label annual gas cost of the dishwasher. If not provided, the OS-HPXML default is used.</description>
+      <description>The label annual gas cost of the dishwasher. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-dishwasher'&gt;HPXML Dishwasher&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>$</units>
       <required>false</required>
@@ -5328,7 +5405,7 @@
     <argument>
       <name>dishwasher_label_usage</name>
       <display_name>Dishwasher: Label Usage</display_name>
-      <description>The dishwasher loads per week. If not provided, the OS-HPXML default is used.</description>
+      <description>The dishwasher loads per week. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-dishwasher'&gt;HPXML Dishwasher&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>cyc/wk</units>
       <required>false</required>
@@ -5337,7 +5414,7 @@
     <argument>
       <name>dishwasher_place_setting_capacity</name>
       <display_name>Dishwasher: Number of Place Settings</display_name>
-      <description>The number of place settings for the unit. Data obtained from manufacturer's literature. If not provided, the OS-HPXML default is used.</description>
+      <description>The number of place settings for the unit. Data obtained from manufacturer's literature. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-dishwasher'&gt;HPXML Dishwasher&lt;/a&gt;) is used.</description>
       <type>Integer</type>
       <units>#</units>
       <required>false</required>
@@ -5346,7 +5423,7 @@
     <argument>
       <name>dishwasher_usage_multiplier</name>
       <display_name>Dishwasher: Usage Multiplier</display_name>
-      <description>Multiplier on the dishwasher energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the dishwasher 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-dishwasher'&gt;HPXML Dishwasher&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -5373,14 +5450,14 @@
     <argument>
       <name>refrigerator_location</name>
       <display_name>Refrigerator: Location</display_name>
-      <description>The space type for the refrigerator location. If not provided, the OS-HPXML default is used.</description>
+      <description>The space type for the refrigerator location. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-refrigerators'&gt;HPXML Refrigerators&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
       <choices>
         <choice>
-          <value>living space</value>
-          <display_name>living space</display_name>
+          <value>conditioned space</value>
+          <display_name>conditioned space</display_name>
         </choice>
         <choice>
           <value>basement - conditioned</value>
@@ -5415,7 +5492,7 @@
     <argument>
       <name>refrigerator_rated_annual_kwh</name>
       <display_name>Refrigerator: Rated Annual Consumption</display_name>
-      <description>The EnergyGuide rated annual energy consumption for a refrigerator. If not provided, the OS-HPXML default is used.</description>
+      <description>The EnergyGuide rated annual energy consumption for a refrigerator. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-refrigerators'&gt;HPXML Refrigerators&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>kWh/yr</units>
       <required>false</required>
@@ -5424,7 +5501,7 @@
     <argument>
       <name>refrigerator_usage_multiplier</name>
       <display_name>Refrigerator: Usage Multiplier</display_name>
-      <description>Multiplier on the refrigerator energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the refrigerator 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-refrigerators'&gt;HPXML Refrigerators&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -5451,14 +5528,14 @@
     <argument>
       <name>extra_refrigerator_location</name>
       <display_name>Extra Refrigerator: Location</display_name>
-      <description>The space type for the extra refrigerator location. If not provided, the OS-HPXML default is used.</description>
+      <description>The space type for the extra refrigerator location. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-refrigerators'&gt;HPXML Refrigerators&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
       <choices>
         <choice>
-          <value>living space</value>
-          <display_name>living space</display_name>
+          <value>conditioned space</value>
+          <display_name>conditioned space</display_name>
         </choice>
         <choice>
           <value>basement - conditioned</value>
@@ -5493,7 +5570,7 @@
     <argument>
       <name>extra_refrigerator_rated_annual_kwh</name>
       <display_name>Extra Refrigerator: Rated Annual Consumption</display_name>
-      <description>The EnergyGuide rated annual energy consumption for an extra rrefrigerator. If not provided, the OS-HPXML default is used.</description>
+      <description>The EnergyGuide rated annual energy consumption for an extra rrefrigerator. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-refrigerators'&gt;HPXML Refrigerators&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>kWh/yr</units>
       <required>false</required>
@@ -5502,7 +5579,7 @@
     <argument>
       <name>extra_refrigerator_usage_multiplier</name>
       <display_name>Extra Refrigerator: Usage Multiplier</display_name>
-      <description>Multiplier on the extra refrigerator energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the extra refrigerator 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-refrigerators'&gt;HPXML Refrigerators&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -5529,14 +5606,14 @@
     <argument>
       <name>freezer_location</name>
       <display_name>Freezer: Location</display_name>
-      <description>The space type for the freezer location. If not provided, the OS-HPXML default is used.</description>
+      <description>The space type for the freezer location. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-freezers'&gt;HPXML Freezers&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
       <choices>
         <choice>
-          <value>living space</value>
-          <display_name>living space</display_name>
+          <value>conditioned space</value>
+          <display_name>conditioned space</display_name>
         </choice>
         <choice>
           <value>basement - conditioned</value>
@@ -5571,7 +5648,7 @@
     <argument>
       <name>freezer_rated_annual_kwh</name>
       <display_name>Freezer: Rated Annual Consumption</display_name>
-      <description>The EnergyGuide rated annual energy consumption for a freezer. If not provided, the OS-HPXML default is used.</description>
+      <description>The EnergyGuide rated annual energy consumption for a freezer. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-freezers'&gt;HPXML Freezers&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>kWh/yr</units>
       <required>false</required>
@@ -5580,7 +5657,7 @@
     <argument>
       <name>freezer_usage_multiplier</name>
       <display_name>Freezer: Usage Multiplier</display_name>
-      <description>Multiplier on the freezer energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the freezer 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-freezers'&gt;HPXML Freezers&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -5607,14 +5684,14 @@
     <argument>
       <name>cooking_range_oven_location</name>
       <display_name>Cooking Range/Oven: Location</display_name>
-      <description>The space type for the cooking range/oven location. If not provided, the OS-HPXML default is used.</description>
+      <description>The space type for the cooking range/oven location. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-cooking-range-oven'&gt;HPXML Cooking Range/Oven&lt;/a&gt;) is used.</description>
       <type>Choice</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
       <choices>
         <choice>
-          <value>living space</value>
-          <display_name>living space</display_name>
+          <value>conditioned space</value>
+          <display_name>conditioned space</display_name>
         </choice>
         <choice>
           <value>basement - conditioned</value>
@@ -5684,7 +5761,7 @@
     <argument>
       <name>cooking_range_oven_is_induction</name>
       <display_name>Cooking Range/Oven: Is Induction</display_name>
-      <description>Whether the cooking range is induction. If not provided, the OS-HPXML default is used.</description>
+      <description>Whether the cooking range is induction. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-cooking-range-oven'&gt;HPXML Cooking Range/Oven&lt;/a&gt;) is used.</description>
       <type>Boolean</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -5702,7 +5779,7 @@
     <argument>
       <name>cooking_range_oven_is_convection</name>
       <display_name>Cooking Range/Oven: Is Convection</display_name>
-      <description>Whether the oven is convection. If not provided, the OS-HPXML default is used.</description>
+      <description>Whether the oven is convection. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-cooking-range-oven'&gt;HPXML Cooking Range/Oven&lt;/a&gt;) is used.</description>
       <type>Boolean</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -5720,7 +5797,7 @@
     <argument>
       <name>cooking_range_oven_usage_multiplier</name>
       <display_name>Cooking Range/Oven: Usage Multiplier</display_name>
-      <description>Multiplier on the cooking range/oven energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the cooking range/oven 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-cooking-range-oven'&gt;HPXML Cooking Range/Oven&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -5747,7 +5824,7 @@
     <argument>
       <name>ceiling_fan_efficiency</name>
       <display_name>Ceiling Fan: Efficiency</display_name>
-      <description>The efficiency rating of the ceiling fan(s) at medium speed. If not provided, the OS-HPXML default is used.</description>
+      <description>The efficiency rating of the ceiling fan(s) at medium speed. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-ceiling-fans'&gt;HPXML Ceiling Fans&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>CFM/W</units>
       <required>false</required>
@@ -5756,7 +5833,7 @@
     <argument>
       <name>ceiling_fan_quantity</name>
       <display_name>Ceiling Fan: Quantity</display_name>
-      <description>Total number of ceiling fans. If not provided, the OS-HPXML default is used.</description>
+      <description>Total number of ceiling fans. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-ceiling-fans'&gt;HPXML Ceiling Fans&lt;/a&gt;) is used.</description>
       <type>Integer</type>
       <units>#</units>
       <required>false</required>
@@ -5765,7 +5842,7 @@
     <argument>
       <name>ceiling_fan_cooling_setpoint_temp_offset</name>
       <display_name>Ceiling Fan: Cooling Setpoint Temperature Offset</display_name>
-      <description>The cooling setpoint temperature offset during months when the ceiling fans are operating. Only applies if ceiling fan quantity is greater than zero. If not provided, the OS-HPXML default is used.</description>
+      <description>The cooling setpoint temperature offset during months when the ceiling fans are operating. Only applies if ceiling fan quantity is greater than zero. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-ceiling-fans'&gt;HPXML Ceiling Fans&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>deg-F</units>
       <required>false</required>
@@ -5793,7 +5870,7 @@
     <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 is used.</description>
+      <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>Double</type>
       <units>kWh/yr</units>
       <required>false</required>
@@ -5802,7 +5879,7 @@
     <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 is used.</description>
+      <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>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -5810,7 +5887,7 @@
     <argument>
       <name>misc_plug_loads_other_annual_kwh</name>
       <display_name>Misc Plug Loads: Other Annual kWh</display_name>
-      <description>The annual energy consumption of the other residual plug loads. If not provided, the OS-HPXML default is used.</description>
+      <description>The annual energy consumption of the other residual 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>Double</type>
       <units>kWh/yr</units>
       <required>false</required>
@@ -5819,7 +5896,7 @@
     <argument>
       <name>misc_plug_loads_other_frac_sensible</name>
       <display_name>Misc Plug Loads: Other Sensible Fraction</display_name>
-      <description>Fraction of other residual plug loads' internal gains that are sensible. If not provided, the OS-HPXML default is used.</description>
+      <description>Fraction of other residual plug loads' internal gains that are sensible. 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>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -5828,7 +5905,7 @@
     <argument>
       <name>misc_plug_loads_other_frac_latent</name>
       <display_name>Misc Plug Loads: Other Latent Fraction</display_name>
-      <description>Fraction of other residual plug loads' internal gains that are latent. If not provided, the OS-HPXML default is used.</description>
+      <description>Fraction of other residual plug loads' internal gains that are latent. 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>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -5837,7 +5914,7 @@
     <argument>
       <name>misc_plug_loads_other_usage_multiplier</name>
       <display_name>Misc Plug Loads: Other Usage Multiplier</display_name>
-      <description>Multiplier on the other energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the other 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>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -5864,7 +5941,7 @@
     <argument>
       <name>misc_plug_loads_well_pump_annual_kwh</name>
       <display_name>Misc Plug Loads: Well Pump Annual kWh</display_name>
-      <description>The annual energy consumption of the well pump plug loads. If not provided, the OS-HPXML default is used.</description>
+      <description>The annual energy consumption of the well pump 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>Double</type>
       <units>kWh/yr</units>
       <required>false</required>
@@ -5873,7 +5950,7 @@
     <argument>
       <name>misc_plug_loads_well_pump_usage_multiplier</name>
       <display_name>Misc Plug Loads: Well Pump Usage Multiplier</display_name>
-      <description>Multiplier on the well pump energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the well pump 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>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -5900,7 +5977,7 @@
     <argument>
       <name>misc_plug_loads_vehicle_annual_kwh</name>
       <display_name>Misc Plug Loads: Vehicle Annual kWh</display_name>
-      <description>The annual energy consumption of the electric vehicle plug loads. If not provided, the OS-HPXML default is used.</description>
+      <description>The annual energy consumption of the electric vehicle 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>Double</type>
       <units>kWh/yr</units>
       <required>false</required>
@@ -5909,7 +5986,7 @@
     <argument>
       <name>misc_plug_loads_vehicle_usage_multiplier</name>
       <display_name>Misc Plug Loads: Vehicle Usage Multiplier</display_name>
-      <description>Multiplier on the electric vehicle energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the electric vehicle 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>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -5967,7 +6044,7 @@
     <argument>
       <name>misc_fuel_loads_grill_annual_therm</name>
       <display_name>Misc Fuel Loads: Grill Annual therm</display_name>
-      <description>The annual energy consumption of the fuel loads grill. If not provided, the OS-HPXML default is used.</description>
+      <description>The annual energy consumption of the fuel loads grill. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-fuel-loads'&gt;HPXML Fuel Loads&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>therm/yr</units>
       <required>false</required>
@@ -5976,7 +6053,7 @@
     <argument>
       <name>misc_fuel_loads_grill_usage_multiplier</name>
       <display_name>Misc Fuel Loads: Grill Usage Multiplier</display_name>
-      <description>Multiplier on the fuel loads grill energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the fuel loads grill 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-fuel-loads'&gt;HPXML Fuel Loads&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -6034,7 +6111,7 @@
     <argument>
       <name>misc_fuel_loads_lighting_annual_therm</name>
       <display_name>Misc Fuel Loads: Lighting Annual therm</display_name>
-      <description>The annual energy consumption of the fuel loads lighting. If not provided, the OS-HPXML default is used.</description>
+      <description>The annual energy consumption of the fuel loads lighting. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-fuel-loads'&gt;HPXML Fuel Loads&lt;/a&gt;)is used.</description>
       <type>Double</type>
       <units>therm/yr</units>
       <required>false</required>
@@ -6043,7 +6120,7 @@
     <argument>
       <name>misc_fuel_loads_lighting_usage_multiplier</name>
       <display_name>Misc Fuel Loads: Lighting Usage Multiplier</display_name>
-      <description>Multiplier on the fuel loads lighting energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the fuel loads lighting 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-fuel-loads'&gt;HPXML Fuel Loads&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -6101,7 +6178,7 @@
     <argument>
       <name>misc_fuel_loads_fireplace_annual_therm</name>
       <display_name>Misc Fuel Loads: Fireplace Annual therm</display_name>
-      <description>The annual energy consumption of the fuel loads fireplace. If not provided, the OS-HPXML default is used.</description>
+      <description>The annual energy consumption of the fuel loads fireplace. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-fuel-loads'&gt;HPXML Fuel Loads&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>therm/yr</units>
       <required>false</required>
@@ -6110,7 +6187,7 @@
     <argument>
       <name>misc_fuel_loads_fireplace_frac_sensible</name>
       <display_name>Misc Fuel Loads: Fireplace Sensible Fraction</display_name>
-      <description>Fraction of fireplace residual fuel loads' internal gains that are sensible. If not provided, the OS-HPXML default is used.</description>
+      <description>Fraction of fireplace residual fuel loads' internal gains that are sensible. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-fuel-loads'&gt;HPXML Fuel Loads&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -6119,7 +6196,7 @@
     <argument>
       <name>misc_fuel_loads_fireplace_frac_latent</name>
       <display_name>Misc Fuel Loads: Fireplace Latent Fraction</display_name>
-      <description>Fraction of fireplace residual fuel loads' internal gains that are latent. If not provided, the OS-HPXML default is used.</description>
+      <description>Fraction of fireplace residual fuel loads' internal gains that are latent. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#hpxml-fuel-loads'&gt;HPXML Fuel Loads&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>Frac</units>
       <required>false</required>
@@ -6128,7 +6205,7 @@
     <argument>
       <name>misc_fuel_loads_fireplace_usage_multiplier</name>
       <display_name>Misc Fuel Loads: Fireplace Usage Multiplier</display_name>
-      <description>Multiplier on the fuel loads fireplace energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the fuel loads fireplace 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-fuel-loads'&gt;HPXML Fuel Loads&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -6155,7 +6232,7 @@
     <argument>
       <name>pool_pump_annual_kwh</name>
       <display_name>Pool: Pump Annual kWh</display_name>
-      <description>The annual energy consumption of the pool pump. If not provided, the OS-HPXML default is used.</description>
+      <description>The annual energy consumption of the pool pump. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#pool-pump'&gt;Pool Pump&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>kWh/yr</units>
       <required>false</required>
@@ -6164,7 +6241,7 @@
     <argument>
       <name>pool_pump_usage_multiplier</name>
       <display_name>Pool: Pump Usage Multiplier</display_name>
-      <description>Multiplier on the pool pump energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the pool pump 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#pool-pump'&gt;Pool Pump&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -6199,7 +6276,7 @@
     <argument>
       <name>pool_heater_annual_kwh</name>
       <display_name>Pool: Heater Annual kWh</display_name>
-      <description>The annual energy consumption of the electric resistance pool heater. If not provided, the OS-HPXML default is used.</description>
+      <description>The annual energy consumption of the electric resistance pool heater. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#pool-heater'&gt;Pool Heater&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>kWh/yr</units>
       <required>false</required>
@@ -6208,7 +6285,7 @@
     <argument>
       <name>pool_heater_annual_therm</name>
       <display_name>Pool: Heater Annual therm</display_name>
-      <description>The annual energy consumption of the gas fired pool heater. If not provided, the OS-HPXML default is used.</description>
+      <description>The annual energy consumption of the gas fired pool heater. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#pool-heater'&gt;Pool Heater&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>therm/yr</units>
       <required>false</required>
@@ -6217,15 +6294,15 @@
     <argument>
       <name>pool_heater_usage_multiplier</name>
       <display_name>Pool: Heater Usage Multiplier</display_name>
-      <description>Multiplier on the pool heater energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <description>Multiplier on the pool heater 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#pool-heater'&gt;Pool Heater&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
     </argument>
     <argument>
-      <name>hot_tub_present</name>
-      <display_name>Hot Tub: Present</display_name>
-      <description>Whether there is a hot tub.</description>
+      <name>permanent_spa_present</name>
+      <display_name>Permanent Spa: Present</display_name>
+      <description>Whether there is a permanent spa.</description>
       <type>Boolean</type>
       <required>true</required>
       <model_dependent>false</model_dependent>
@@ -6242,26 +6319,26 @@
       </choices>
     </argument>
     <argument>
-      <name>hot_tub_pump_annual_kwh</name>
-      <display_name>Hot Tub: Pump Annual kWh</display_name>
-      <description>The annual energy consumption of the hot tub pump. If not provided, the OS-HPXML default is used.</description>
+      <name>permanent_spa_pump_annual_kwh</name>
+      <display_name>Permanent Spa: Pump Annual kWh</display_name>
+      <description>The annual energy consumption of the permanent spa pump. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#permanent-spa-pump'&gt;Permanent Spa Pump&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>kWh/yr</units>
       <required>false</required>
       <model_dependent>false</model_dependent>
     </argument>
     <argument>
-      <name>hot_tub_pump_usage_multiplier</name>
-      <display_name>Hot Tub: Pump Usage Multiplier</display_name>
-      <description>Multiplier on the hot tub pump energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <name>permanent_spa_pump_usage_multiplier</name>
+      <display_name>Permanent Spa: Pump Usage Multiplier</display_name>
+      <description>Multiplier on the permanent spa pump 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#permanent-spa-pump'&gt;Permanent Spa Pump&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
     </argument>
     <argument>
-      <name>hot_tub_heater_type</name>
-      <display_name>Hot Tub: Heater Type</display_name>
-      <description>The type of hot tub heater. Use 'none' if there is no hot tub heater.</description>
+      <name>permanent_spa_heater_type</name>
+      <display_name>Permanent Spa: Heater Type</display_name>
+      <description>The type of permanent spa heater. Use 'none' if there is no permanent spa heater.</description>
       <type>Choice</type>
       <required>true</required>
       <model_dependent>false</model_dependent>
@@ -6286,27 +6363,27 @@
       </choices>
     </argument>
     <argument>
-      <name>hot_tub_heater_annual_kwh</name>
-      <display_name>Hot Tub: Heater Annual kWh</display_name>
-      <description>The annual energy consumption of the electric resistance hot tub heater. If not provided, the OS-HPXML default is used.</description>
+      <name>permanent_spa_heater_annual_kwh</name>
+      <display_name>Permanent Spa: Heater Annual kWh</display_name>
+      <description>The annual energy consumption of the electric resistance permanent spa heater. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#permanent-spa-heater'&gt;Permanent Spa Heater&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>kWh/yr</units>
       <required>false</required>
       <model_dependent>false</model_dependent>
     </argument>
     <argument>
-      <name>hot_tub_heater_annual_therm</name>
-      <display_name>Hot Tub: Heater Annual therm</display_name>
-      <description>The annual energy consumption of the gas fired hot tub heater. If not provided, the OS-HPXML default is used.</description>
+      <name>permanent_spa_heater_annual_therm</name>
+      <display_name>Permanent Spa: Heater Annual therm</display_name>
+      <description>The annual energy consumption of the gas fired permanent spa heater. If not provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.7.0/workflow_inputs.html#permanent-spa-heater'&gt;Permanent Spa Heater&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <units>therm/yr</units>
       <required>false</required>
       <model_dependent>false</model_dependent>
     </argument>
     <argument>
-      <name>hot_tub_heater_usage_multiplier</name>
-      <display_name>Hot Tub: Heater Usage Multiplier</display_name>
-      <description>Multiplier on the hot tub heater energy usage that can reflect, e.g., high/low usage occupants. If not provided, the OS-HPXML default is used.</description>
+      <name>permanent_spa_heater_usage_multiplier</name>
+      <display_name>Permanent Spa: Heater Usage Multiplier</display_name>
+      <description>Multiplier on the permanent spa heater 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#permanent-spa-heater'&gt;Permanent Spa Heater&lt;/a&gt;) is used.</description>
       <type>Double</type>
       <required>false</required>
       <model_dependent>false</model_dependent>
@@ -6671,16 +6748,16 @@
   </attributes>
   <files>
     <file>
-      <filename>geometry.rb</filename>
-      <filetype>rb</filetype>
-      <usage_type>resource</usage_type>
-      <checksum>E8F9FEA0</checksum>
+      <filename>README.md</filename>
+      <filetype>md</filetype>
+      <usage_type>readme</usage_type>
+      <checksum>92C872C5</checksum>
     </file>
     <file>
-      <filename>build_residential_hpxml_test.rb</filename>
-      <filetype>rb</filetype>
-      <usage_type>test</usage_type>
-      <checksum>010244DB</checksum>
+      <filename>README.md.erb</filename>
+      <filetype>erb</filetype>
+      <usage_type>readmeerb</usage_type>
+      <checksum>513F28E9</checksum>
     </file>
     <file>
       <version>
@@ -6691,7 +6768,19 @@
       <filename>measure.rb</filename>
       <filetype>rb</filetype>
       <usage_type>script</usage_type>
-      <checksum>AE26AEE7</checksum>
+      <checksum>DEA666BB</checksum>
+    </file>
+    <file>
+      <filename>geometry.rb</filename>
+      <filetype>rb</filetype>
+      <usage_type>resource</usage_type>
+      <checksum>84CB0D65</checksum>
+    </file>
+    <file>
+      <filename>test_build_residential_hpxml.rb</filename>
+      <filetype>rb</filetype>
+      <usage_type>test</usage_type>
+      <checksum>5018D51F</checksum>
     </file>
   </files>
 </measure>