Add new optional window inputs to lookup.

NREL · Sep 25, 2024 · 7d51288 · 7d51288
1 parent 17a5006
commit 7d51288
Show file tree

Hide file tree

Showing 3 changed files with 194 additions and 46 deletions.
diff --git a/measures/ResStockArguments/README.md b/measures/ResStockArguments/README.md
@@ -1102,9 +1102,22 @@ Full-assembly NFRC solar heat gain coefficient.
 
 <br/>
 
-**Windows: Winter Interior Shading**
+**Windows: Interior Shading Type**
 
-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 <a href='https://openstudio-hpxml.readthedocs.io/en/v1.8.1/workflow_inputs.html#hpxml-windows'>HPXML Windows</a>) is used.
+Type of window interior shading. Summer/winter shading coefficients can be provided below instead. If neither is provided, the OS-HPXML default (see <a href='https://openstudio-hpxml.readthedocs.io/en/v1.8.1/workflow_inputs.html#hpxml-interior-shading'>HPXML Interior Shading</a>) is used.
+
+- **Name:** ``window_interior_shading_type``
+- **Type:** ``Choice``
+
+- **Required:** ``false``
+
+- **Choices:** `auto`, `light curtains`, `light shades`, `light blinds`, `medium curtains`, `medium shades`, `medium blinds`, `dark curtains`, `dark shades`, `dark blinds`, `none`
+
+<br/>
+
+**Windows: Winter Interior Shading Coefficient**
+
+Interior shading coefficient for the winter season, which if provided overrides the shading type input. 1.0 indicates no reduction in solar gain, 0.85 indicates 15% reduction, etc. If not provided, the OS-HPXML default (see <a href='https://openstudio-hpxml.readthedocs.io/en/v1.8.1/workflow_inputs.html#hpxml-interior-shading'>HPXML Interior Shading</a>) is used.
 
 - **Name:** ``window_interior_shading_winter``
 - **Type:** ``String``
@@ -1113,9 +1126,9 @@ Interior shading coefficient for the winter season. 1.0 indicates no reduction i
 
 <br/>
 
-**Windows: Summer Interior Shading**
+**Windows: Summer Interior Shading Coefficient**
 
-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 <a href='https://openstudio-hpxml.readthedocs.io/en/v1.8.1/workflow_inputs.html#hpxml-windows'>HPXML Windows</a>) is used.
+Interior shading coefficient for the summer season, which if provided overrides the shading type input. 1.0 indicates no reduction in solar gain, 0.85 indicates 15% reduction, etc. If not provided, the OS-HPXML default (see <a href='https://openstudio-hpxml.readthedocs.io/en/v1.8.1/workflow_inputs.html#hpxml-interior-shading'>HPXML Interior Shading</a>) is used.
 
 - **Name:** ``window_interior_shading_summer``
 - **Type:** ``String``
@@ -1124,9 +1137,22 @@ Interior shading coefficient for the summer season. 1.0 indicates no reduction i
 
 <br/>
 
-**Windows: Winter Exterior Shading**
+**Windows: Exterior Shading Type**
+
+Type of window exterior shading. Summer/winter shading coefficients can be provided below instead. If neither is provided, the OS-HPXML default (see <a href='https://openstudio-hpxml.readthedocs.io/en/v1.8.1/workflow_inputs.html#hpxml-exterior-shading'>HPXML Exterior Shading</a>) is used.
+
+- **Name:** ``window_exterior_shading_type``
+- **Type:** ``Choice``
+
+- **Required:** ``false``
 
-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 <a href='https://openstudio-hpxml.readthedocs.io/en/v1.8.1/workflow_inputs.html#hpxml-windows'>HPXML Windows</a>) is used.
+- **Choices:** `auto`, `solar film`, `solar screens`, `none`
+
+<br/>
+
+**Windows: Winter Exterior Shading Coefficient**
+
+Exterior shading coefficient for the winter season, which if provided overrides the shading type input. 1.0 indicates no reduction in solar gain, 0.85 indicates 15% reduction, etc. If not provided, the OS-HPXML default (see <a href='https://openstudio-hpxml.readthedocs.io/en/v1.8.1/workflow_inputs.html#hpxml-exterior-shading'>HPXML Exterior Shading</a>) is used.
 
 - **Name:** ``window_exterior_shading_winter``
 - **Type:** ``String``
@@ -1135,9 +1161,9 @@ Exterior shading coefficient for the winter season. 1.0 indicates no reduction i
 
 <br/>
 
-**Windows: Summer Exterior Shading**
+**Windows: Summer Exterior Shading Coefficient**
 
-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 <a href='https://openstudio-hpxml.readthedocs.io/en/v1.8.1/workflow_inputs.html#hpxml-windows'>HPXML Windows</a>) is used.
+Exterior shading coefficient for the summer season, which if provided overrides the shading type input. 1.0 indicates no reduction in solar gain, 0.85 indicates 15% reduction, etc. If not provided, the OS-HPXML default (see <a href='https://openstudio-hpxml.readthedocs.io/en/v1.8.1/workflow_inputs.html#hpxml-exterior-shading'>HPXML Exterior Shading</a>) is used.
 
 - **Name:** ``window_exterior_shading_summer``
 - **Type:** ``String``
@@ -1157,6 +1183,19 @@ Enter a date range like 'May 1 - Sep 30'. Defines the summer season for purposes
 
 <br/>
 
+**Windows: Insect Screens**
+
+The type of insect screens, if present. If not provided, assumes there are no insect screens.
+
+- **Name:** ``window_insect_screens``
+- **Type:** ``Choice``
+
+- **Required:** ``false``
+
+- **Choices:** `auto`, `none`, `exterior`, `interior`
+
+<br/>
+
 **Windows: Storm Type**
 
 The type of storm, if present. If not provided, assumes there is no storm.

diff --git a/measures/ResStockArguments/measure.xml b/measures/ResStockArguments/measure.xml
@@ -3,8 +3,8 @@
  <schema_version>3.1</schema_version>
  <name>res_stock_arguments</name>
  <uid>c984bb9e-4ac4-4930-a399-9d23f8f6936a</uid>
- <version_id>c67c3ec7-a83c-4bd4-8599-16b9ba319fef</version_id>
- <version_modified>2024-09-20T03:03:46Z</version_modified>
+ <version_id>c8f1fc2e-0738-4f9a-a018-ba219022dc1b</version_id>
+ <version_modified>2024-09-25T03:17:40Z</version_modified>
  <xml_checksum>2C38F48B</xml_checksum>
  <class_name>ResStockArguments</class_name>
  <display_name>ResStock Arguments</display_name>
@@ -1722,37 +1722,119 @@
  <model_dependent>false</model_dependent>
  <default_value>0.3</default_value>
  </argument>
+ <argument>
+ <name>window_interior_shading_type</name>
+ <display_name>Windows: Interior Shading Type</display_name>
+ <description>Type of window interior shading. Summer/winter shading coefficients can be provided below instead. If neither is provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.8.1/workflow_inputs.html#hpxml-interior-shading'&gt;HPXML Interior Shading&lt;/a&gt;) is used.</description>
+ <type>Choice</type>
+ <units></units>
+ <required>false</required>
+ <model_dependent>false</model_dependent>
+ <choices>
+ <choice>
+ <value>auto</value>
+ <display_name>auto</display_name>
+ </choice>
+ <choice>
+ <value>light curtains</value>
+ <display_name>light curtains</display_name>
+ </choice>
+ <choice>
+ <value>light shades</value>
+ <display_name>light shades</display_name>
+ </choice>
+ <choice>
+ <value>light blinds</value>
+ <display_name>light blinds</display_name>
+ </choice>
+ <choice>
+ <value>medium curtains</value>
+ <display_name>medium curtains</display_name>
+ </choice>
+ <choice>
+ <value>medium shades</value>
+ <display_name>medium shades</display_name>
+ </choice>
+ <choice>
+ <value>medium blinds</value>
+ <display_name>medium blinds</display_name>
+ </choice>
+ <choice>
+ <value>dark curtains</value>
+ <display_name>dark curtains</display_name>
+ </choice>
+ <choice>
+ <value>dark shades</value>
+ <display_name>dark shades</display_name>
+ </choice>
+ <choice>
+ <value>dark blinds</value>
+ <display_name>dark blinds</display_name>
+ </choice>
+ <choice>
+ <value>none</value>
+ <display_name>none</display_name>
+ </choice>
+ </choices>
+ </argument>
  <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 (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.8.1/workflow_inputs.html#hpxml-windows'&gt;HPXML Windows&lt;/a&gt;) is used.</description>
+ <display_name>Windows: Winter Interior Shading Coefficient</display_name>
+ <description>Interior shading coefficient for the winter season, which if provided overrides the shading type input. 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.8.1/workflow_inputs.html#hpxml-interior-shading'&gt;HPXML Interior Shading&lt;/a&gt;) is used.</description>
  <type>String</type>
  <units>Frac</units>
  <required>false</required>
  <model_dependent>false</model_dependent>
  </argument>
  <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 (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.8.1/workflow_inputs.html#hpxml-windows'&gt;HPXML Windows&lt;/a&gt;) is used.</description>
+ <display_name>Windows: Summer Interior Shading Coefficient</display_name>
+ <description>Interior shading coefficient for the summer season, which if provided overrides the shading type input. 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.8.1/workflow_inputs.html#hpxml-interior-shading'&gt;HPXML Interior Shading&lt;/a&gt;) is used.</description>
  <type>String</type>
  <units>Frac</units>
  <required>false</required>
  <model_dependent>false</model_dependent>
  </argument>
+ <argument>
+ <name>window_exterior_shading_type</name>
+ <display_name>Windows: Exterior Shading Type</display_name>
+ <description>Type of window exterior shading. Summer/winter shading coefficients can be provided below instead. If neither is provided, the OS-HPXML default (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.8.1/workflow_inputs.html#hpxml-exterior-shading'&gt;HPXML Exterior Shading&lt;/a&gt;) is used.</description>
+ <type>Choice</type>
+ <units></units>
+ <required>false</required>
+ <model_dependent>false</model_dependent>
+ <choices>
+ <choice>
+ <value>auto</value>
+ <display_name>auto</display_name>
+ </choice>
+ <choice>
+ <value>solar film</value>
+ <display_name>solar film</display_name>
+ </choice>
+ <choice>
+ <value>solar screens</value>
+ <display_name>solar screens</display_name>
+ </choice>
+ <choice>
+ <value>none</value>
+ <display_name>none</display_name>
+ </choice>
+ </choices>
+ </argument>
  <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 (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.8.1/workflow_inputs.html#hpxml-windows'&gt;HPXML Windows&lt;/a&gt;) is used.</description>
+ <display_name>Windows: Winter Exterior Shading Coefficient</display_name>
+ <description>Exterior shading coefficient for the winter season, which if provided overrides the shading type input. 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.8.1/workflow_inputs.html#hpxml-exterior-shading'&gt;HPXML Exterior Shading&lt;/a&gt;) is used.</description>
  <type>String</type>
  <units>Frac</units>
  <required>false</required>
  <model_dependent>false</model_dependent>
  </argument>
  <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 (see &lt;a href='https://openstudio-hpxml.readthedocs.io/en/v1.8.1/workflow_inputs.html#hpxml-windows'&gt;HPXML Windows&lt;/a&gt;) is used.</description>
+ <display_name>Windows: Summer Exterior Shading Coefficient</display_name>
+ <description>Exterior shading coefficient for the summer season, which if provided overrides the shading type input. 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.8.1/workflow_inputs.html#hpxml-exterior-shading'&gt;HPXML Exterior Shading&lt;/a&gt;) is used.</description>
  <type>String</type>
  <units>Frac</units>
  <required>false</required>
@@ -1767,6 +1849,33 @@
  <required>false</required>
  <model_dependent>false</model_dependent>
  </argument>
+ <argument>
+ <name>window_insect_screens</name>
+ <display_name>Windows: Insect Screens</display_name>
+ <description>The type of insect screens, if present. If not provided, assumes there are no insect screens.</description>
+ <type>Choice</type>
+ <units></units>
+ <required>false</required>
+ <model_dependent>false</model_dependent>
+ <choices>
+ <choice>
+ <value>auto</value>
+ <display_name>auto</display_name>
+ </choice>
+ <choice>
+ <value>none</value>
+ <display_name>none</display_name>
+ </choice>
+ <choice>
+ <value>exterior</value>
+ <display_name>exterior</display_name>
+ </choice>
+ <choice>
+ <value>interior</value>
+ <display_name>interior</display_name>
+ </choice>
+ </choices>
+ </argument>
  <argument>
  <name>window_storm_type</name>
  <display_name>Windows: Storm Type</display_name>
@@ -7551,7 +7660,7 @@
  <filename>README.md</filename>
  <filetype>md</filetype>
  <usage_type>readme</usage_type>
- <checksum>1253D6EE</checksum>
+ <checksum>18542198</checksum>
  </file>
  <file>
  <filename>README.md.erb</filename>