<?xml version="1.0"?>
<measure>
  <schema_version>3.1</schema_version>
  <name>add_simple_pv_to_shading_surfaces_by_type</name>
  <uid>27627c16-75d4-4fc3-add9-2d7d538c0130</uid>
  <version_id>17051d34-b75e-442a-9901-d5c81f4cf54b</version_id>
  <version_modified>2024-11-16T23:54:16Z</version_modified>
  <xml_checksum>92C8C204</xml_checksum>
  <class_name>AddSimplePvToShadingSurfacesByType</class_name>
  <display_name>Add Simple PV to Specified Shading Surfaces</display_name>
  <description>This measure will add Simple PV objects to site, building or space/zone shading surfaces. This will not create any new geometry, but will just make PV objects out of existing shading geometry. Optionally a cost can be added for the PV.</description>
  <modeler_description>This measure will add PV objects for all site, building, or zone shading surfaces. Site and Building surfaces exist in both OpenStudio and EnergyPlus. Space shading surfaces in OpenStudio are translated to zone shading surfaces in EnergyPlus. The necessary PV objects will be added for each surface, as well as a number of shared PV resources.  A number of arguments will expose various PV settings. The recurring cost objects added are not directly associated with the PV objects. If the PV objects are removed the cost will remain.</modeler_description>
  <arguments>
    <argument>
      <name>shading_type</name>
      <display_name>Choose the Type of Shading Surfaces to add PV to</display_name>
      <type>Choice</type>
      <required>true</required>
      <model_dependent>false</model_dependent>
      <default_value>Building Shading</default_value>
      <choices>
        <choice>
          <value>Site Shading</value>
          <display_name>Site Shading</display_name>
        </choice>
        <choice>
          <value>Building Shading</value>
          <display_name>Building Shading</display_name>
        </choice>
        <choice>
          <value>Space/Zone Shading</value>
          <display_name>Space/Zone Shading</display_name>
        </choice>
      </choices>
    </argument>
    <argument>
      <name>fraction_surfacearea_with_pv</name>
      <display_name>Fraction of Included Surface Area with PV</display_name>
      <type>Double</type>
      <required>true</required>
      <model_dependent>false</model_dependent>
      <default_value>0.5</default_value>
    </argument>
    <argument>
      <name>value_for_cell_efficiency</name>
      <display_name>Fractional Value for Cell Efficiency</display_name>
      <type>Double</type>
      <required>true</required>
      <model_dependent>false</model_dependent>
      <default_value>0.12</default_value>
    </argument>
    <argument>
      <name>material_cost</name>
      <display_name>Material and Installation Costs for the PV</display_name>
      <type>Double</type>
      <units>$</units>
      <required>true</required>
      <model_dependent>false</model_dependent>
      <default_value>0</default_value>
    </argument>
    <argument>
      <name>expected_life</name>
      <display_name>Expected Life</display_name>
      <type>Integer</type>
      <units>whole years</units>
      <required>true</required>
      <model_dependent>false</model_dependent>
      <default_value>20</default_value>
    </argument>
    <argument>
      <name>om_cost</name>
      <display_name>O &amp; M Costs for the PV.</display_name>
      <type>Double</type>
      <units>$</units>
      <required>true</required>
      <model_dependent>false</model_dependent>
      <default_value>0</default_value>
    </argument>
    <argument>
      <name>om_frequency</name>
      <display_name>O &amp; M Frequency</display_name>
      <type>Integer</type>
      <units>whole years</units>
      <required>true</required>
      <model_dependent>false</model_dependent>
      <default_value>1</default_value>
    </argument>
  </arguments>
  <outputs />
  <provenances />
  <tags>
    <tag>Onsite Power Generation.Photovoltaic</tag>
  </tags>
  <attributes>
    <attribute>
      <name>Measure Type</name>
      <value>EnergyPlusMeasure</value>
      <datatype>string</datatype>
    </attribute>
    <attribute>
      <name>Measure Function</name>
      <value>Measure</value>
      <datatype>string</datatype>
    </attribute>
    <attribute>
      <name>Requires EnergyPlus Results</name>
      <value>false</value>
      <datatype>boolean</datatype>
    </attribute>
    <attribute>
      <name>Uses SketchUp API</name>
      <value>false</value>
      <datatype>boolean</datatype>
    </attribute>
  </attributes>
  <files>
    <file>
      <filename>LICENSE.md</filename>
      <filetype>md</filetype>
      <usage_type>license</usage_type>
      <checksum>8696A072</checksum>
    </file>
    <file>
      <filename>README.md</filename>
      <filetype>md</filetype>
      <usage_type>readme</usage_type>
      <checksum>0A15907B</checksum>
    </file>
    <file>
      <filename>README.md.erb</filename>
      <filetype>erb</filetype>
      <usage_type>readmeerb</usage_type>
      <checksum>703C9964</checksum>
    </file>
    <file>
      <version>
        <software_program>OpenStudio</software_program>
        <identifier>2.0.0</identifier>
        <min_compatible>2.0.0</min_compatible>
      </version>
      <filename>measure.rb</filename>
      <filetype>rb</filetype>
      <usage_type>script</usage_type>
      <checksum>83450B00</checksum>
    </file>
    <file>
      <filename>AddSimplePvToShadingSurfacesByType_Test.rb</filename>
      <filetype>rb</filetype>
      <usage_type>test</usage_type>
      <checksum>D86CF5F6</checksum>
    </file>
    <file>
      <filename>PV_test_model.osm</filename>
      <filetype>osm</filetype>
      <usage_type>test</usage_type>
      <checksum>DA2775F4</checksum>
    </file>
  </files>
</measure>