openstudio-calibration 0.1.2

data/lib/measures/RValueOfInsulationForConstructionMultiplier/measure.xml

@@ -0,0 +1,132 @@
+<measure>
+  <schema_version>3.0</schema_version>
+  <name>r_value_of_insulation_for_construction_multiplier</name>
+  <uid>3c7a6751-bb54-4600-9410-8f042e1a513b</uid>
+  <version_id>3cb88e64-6164-4990-ad56-46c630b22722</version_id>
+  <version_modified>20200325T030943Z</version_modified>
+  <xml_checksum>0BF71A3E</xml_checksum>
+  <class_name>RValueOfInsulationForConstructionMultiplier</class_name>
+  <display_name>Change R-value of Insulation Layer for Construction By a Multiplier</display_name>
+  <description>Change R-value of Insulation Layer for Construction By a Multiplier</description>
+  <modeler_description>Change R-value of Insulation Layer for Construction By a Multiplier</modeler_description>
+  <arguments>
+    <argument>
+      <name>construction</name>
+      <display_name>Choose a Construction to Alter.</display_name>
+      <type>Choice</type>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+    </argument>
+    <argument>
+      <name>r_value_multplier</name>
+      <display_name>Multiplier for R-value for Insulation Layer of Construction.</display_name>
+      <type>Double</type>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+      <default_value>1</default_value>
+    </argument>
+  </arguments>
+  <outputs/>
+  <provenances/>
+  <tags>
+    <tag>Envelope.Opaque</tag>
+  </tags>
+  <attributes>
+    <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>
+    <attribute>
+      <name>Measure Type</name>
+      <value>ModelMeasure</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Software Tool</name>
+      <value>Apply Measure Now</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Software Tool</name>
+      <value>OpenStudio Application</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Software Tool</name>
+      <value>Parametric Analysis Tool</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Software Tool</name>
+      <value>Analysis Spreadsheet</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Use Case</name>
+      <value>Model Articulation</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Use Case</name>
+      <value>Calibration</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Use Case</name>
+      <value>Sensitivity Analysis</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Use Case</name>
+      <value>New Construction EE</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Use Case</name>
+      <value>Retrofit EE</value>
+      <datatype>string</datatype>
+    </attribute>
+  </attributes>
+  <files>
+    <file>
+      <filename>LICENSE.md</filename>
+      <filetype>md</filetype>
+      <usage_type>license</usage_type>
+      <checksum>E0468DD6</checksum>
+    </file>
+    <file>
+      <filename>README.md.erb</filename>
+      <filetype>erb</filetype>
+      <usage_type>readmeerb</usage_type>
+      <checksum>703C9964</checksum>
+    </file>
+    <file>
+      <filename>README.md</filename>
+      <filetype>md</filetype>
+      <usage_type>readme</usage_type>
+      <checksum>CE5C5F28</checksum>
+    </file>
+    <file>
+      <version>
+        <software_program>OpenStudio</software_program>
+        <identifier>0.11.5</identifier>
+        <min_compatible>0.11.5</min_compatible>
+      </version>
+      <filename>measure.rb</filename>
+      <filetype>rb</filetype>
+      <usage_type>script</usage_type>
+      <checksum>2D96FDE5</checksum>
+    </file>
+  </files>
+</measure>

data/lib/measures/RValueOfInsulationForConstructionPercentageChange/LICENSE.md

@@ -0,0 +1,27 @@
+OpenStudio(R), Copyright (c) 2008-2020, Alliance for Sustainable Energy, LLC. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted 
+provided that the following conditions are met:
+
+(1) Redistributions of source code must retain the above copyright notice, this list of conditions 
+and the following disclaimer.
+
+(2) Redistributions in binary form must reproduce the above copyright notice, this list of conditions
+and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+(3) Neither the name of the copyright holder nor the names of any contributors may be used to endorse 
+or promote products derived from this software without specific prior written permission from the 
+respective party.
+
+(4) Other than as required in clauses (1) and (2), distributions in any form of modifications or other 
+derivative works may not use the "OpenStudio" trademark, "OS", "os", or any other confusingly similar 
+designation without specific prior written permission from Alliance for Sustainable Energy, LLC.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED 
+WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER, THE UNITED STATES GOVERNMENT, 
+OR ANY CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, 
+OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 
+STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/lib/measures/RValueOfInsulationForConstructionPercentageChange/README.md

@@ -0,0 +1,40 @@
+
+
+###### (Automatically generated documentation)
+
+# Change R-value of Insulation Layer for Construction By a Specified Percentage
+
+## Description
+Change R-value of Insulation Layer for Construction By a Specified Percentage
+
+## Modeler Description
+Change R-value of Insulation Layer for Construction By a Specified Percentage
+
+## Measure Type
+ModelMeasure
+
+## Taxonomy
+
+
+## Arguments
+
+
+### Choose a Construction to Alter.
+
+**Name:** construction,
+**Type:** Choice,
+**Units:** ,
+**Required:** true,
+**Model Dependent:** false
+
+### Percentage Change of R-value for Insulation Layer of Construction.
+
+**Name:** r_value_prct_inc,
+**Type:** Double,
+**Units:** ,
+**Required:** true,
+**Model Dependent:** false
+
+
+
+

data/lib/measures/RValueOfInsulationForConstructionPercentageChange/README.md.erb

@@ -0,0 +1,42 @@
+<%#= README.md.erb is used to auto-generate README.md. %>
+<%#= To manually maintain README.md throw away README.md.erb and manually edit README.md %>
+###### (Automatically generated documentation)
+
+# <%= name %>
+
+## Description
+<%= description %>
+
+## Modeler Description
+<%= modelerDescription %>
+
+## Measure Type
+<%= measureType %>
+
+## Taxonomy
+<%= taxonomy %>
+
+## Arguments
+
+<% arguments.each do |argument| %>
+### <%= argument[:display_name] %>
+<%= argument[:description] %>
+**Name:** <%= argument[:name] %>,
+**Type:** <%= argument[:type] %>,
+**Units:** <%= argument[:units] %>,
+**Required:** <%= argument[:required] %>,
+**Model Dependent:** <%= argument[:model_dependent] %>
+<% end %>
+
+<% if arguments.size == 0 %>
+<%= "This measure does not have any user arguments" %>
+<% end %>
+
+<% if outputs.size > 0 %>
+## Outputs
+<% output_names = [] %>
+<% outputs.each do |output| %>
+<% output_names << output[:display_name] %>
+<% end %>
+<%= output_names.join(", ") %>
+<% end %>

data/lib/measures/RValueOfInsulationForConstructionPercentageChange/measure.rb

@@ -0,0 +1,189 @@
+# *******************************************************************************
+# OpenStudio(R), Copyright (c) 2008-2020, Alliance for Sustainable Energy, LLC.
+# All rights reserved.
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# (1) Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer.
+#
+# (2) Redistributions in binary form must reproduce the above copyright notice,
+# this list of conditions and the following disclaimer in the documentation
+# and/or other materials provided with the distribution.
+#
+# (3) Neither the name of the copyright holder nor the names of any contributors
+# may be used to endorse or promote products derived from this software without
+# specific prior written permission from the respective party.
+#
+# (4) Other than as required in clauses (1) and (2), distributions in any form
+# of modifications or other derivative works may not use the "OpenStudio"
+# trademark, "OS", "os", or any other confusingly similar designation without
+# specific prior written permission from Alliance for Sustainable Energy, LLC.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) AND ANY CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S), ANY CONTRIBUTORS, THE
+# UNITED STATES GOVERNMENT, OR THE UNITED STATES DEPARTMENT OF ENERGY, NOR ANY OF
+# THEIR EMPLOYEES, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
+# OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+# STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+# *******************************************************************************
+
+# start the measure
+class RValueOfInsulationForConstructionPercentageChange < OpenStudio::Measure::ModelMeasure
+  # define the name that a user will see
+  def name
+    'Change R-value of Insulation Layer for Construction By a Specified Percentage'
+  end
+
+  # human readable description
+  def description
+    'Change R-value of Insulation Layer for Construction By a Specified Percentage'
+  end
+
+  # human readable description of modeling approach
+  def modeler_description
+    'Change R-value of Insulation Layer for Construction By a Specified Percentage'
+  end
+
+  # define the arguments that the user will input
+  def arguments(model)
+    args = OpenStudio::Measure::OSArgumentVector.new
+
+    # populate choice argument for constructions that are applied to surfaces in the model
+    construction_handles = OpenStudio::StringVector.new
+    construction_display_names = OpenStudio::StringVector.new
+
+    # putting space types and names into hash
+    construction_args = model.getConstructions
+    construction_args_hash = {}
+    construction_args.each do |construction_arg|
+      construction_args_hash[construction_arg.name.to_s] = construction_arg
+    end
+
+    # looping through sorted hash of constructions
+    construction_args_hash.sort.map do |key, value|
+      # only include if construction is used on surface
+      if value.getNetArea > 0
+        construction_handles << value.handle.to_s
+        construction_display_names << key
+      end
+    end
+
+    # make an argument for construction
+    construction = OpenStudio::Measure::OSArgument.makeChoiceArgument('construction', construction_handles, construction_display_names, true)
+    construction.setDisplayName('Choose a Construction to Alter.')
+    args << construction
+
+    # make an argument insulation R-value
+    r_value_prct_inc = OpenStudio::Measure::OSArgument.makeDoubleArgument('r_value_prct_inc', true)
+    r_value_prct_inc.setDisplayName('Percentage Change of R-value for Insulation Layer of Construction.')
+    r_value_prct_inc.setDefaultValue(0.0)
+    args << r_value_prct_inc
+
+    args
+  end # end the arguments method
+
+  # define what happens when the measure is run
+  def run(model, runner, user_arguments)
+    super(model, runner, user_arguments)
+
+    # use the built-in error checking
+    unless runner.validateUserArguments(arguments(model), user_arguments)
+      return false
+    end
+
+    # assign the user inputs to variables
+    construction = runner.getOptionalWorkspaceObjectChoiceValue('construction', user_arguments, model) # model is passed in because of argument type
+    r_value_prct_inc = runner.getDoubleArgumentValue('r_value_prct_inc', user_arguments)
+
+    # check the construction for reasonableness
+    if construction.empty?
+      handle = runner.getStringArgumentValue('construction', user_arguments)
+      if handle.empty?
+        runner.registerError('No construction was chosen.')
+      else
+        runner.registerError("The selected construction with handle '#{handle}' was not found in the model. It may have been removed by another measure.")
+      end
+      return false
+    else
+      if !construction.get.to_Construction.empty?
+        construction = construction.get.to_Construction.get
+      else
+        runner.registerError('Script Error - argument not showing up as construction.')
+        return false
+      end
+    end # end of if construction.empty?
+
+    # set limit for minimum insulation. This is used to limit input and for inferring insulation layer in construction.
+    min_expected_r_value_prct_inc_ip = 1 # ip units
+
+    # report initial condition
+    initial_r_value_ip = OpenStudio.convert(1.0 / construction.thermalConductance.to_f, 'm^2*K/W', 'ft^2*h*R/Btu')
+    runner.registerInitialCondition("The Initial R-value of #{construction.name} is #{initial_r_value_ip} (ft^2*h*R/Btu).")
+    runner.registerValue('initial_r_value_ip', initial_r_value_ip.to_f, 'ft^2*h*R/Btu')
+
+    # TODO: - find and test insulation
+    construction_layers = construction.layers
+    max_thermal_resistance_material = construction_layers[0]
+    max_thermal_resistance_material_index = 0
+    counter = 0
+    thermal_resistance_values = []
+
+    # loop through construction layers and infer insulation layer/material
+    construction_layers.each do |construction_layer|
+      construction_layer_r_value = construction_layer.to_OpaqueMaterial.get.thermalResistance
+      unless thermal_resistance_values.empty?
+        if construction_layer_r_value > thermal_resistance_values.max
+          max_thermal_resistance_material = construction_layer
+          max_thermal_resistance_material_index = counter
+        end
+      end
+      thermal_resistance_values << construction_layer_r_value
+      counter += 1
+    end
+    if thermal_resistance_values.max <= OpenStudio.convert(min_expected_r_value_prct_inc_ip, 'ft^2*h*R/Btu', 'm^2*K/W').get
+      runner.registerAsNotApplicable("Construction '#{construction.name}' does not appear to have an insulation layer and was not altered.")
+      return true
+    end
+
+    # clone insulation material
+    new_material = max_thermal_resistance_material.clone(model)
+    new_material = new_material.to_OpaqueMaterial.get
+    new_material.setName("#{max_thermal_resistance_material.name} (R #{r_value_prct_inc.round(2)} percent change)") if r_value_prct_inc != 0
+    construction.eraseLayer(max_thermal_resistance_material_index)
+    construction.insertLayer(max_thermal_resistance_material_index, new_material)
+    runner.registerInfo("For construction'#{construction.name}', '#{max_thermal_resistance_material.name}' was altered.")
+
+    # edit clone material
+    new_material_matt = new_material.to_Material
+    unless new_material_matt.empty?
+      starting_thickness = new_material_matt.get.thickness
+      target_thickness = starting_thickness * (1 + r_value_prct_inc / 100)
+      final_thickness = new_material_matt.get.setThickness(target_thickness)
+    end
+    new_material_massless = new_material.to_MasslessOpaqueMaterial
+    unless new_material_massless.empty?
+      starting_thermal_resistance = new_material_massless.get.thermalResistance
+      final_thermal_resistance = new_material_massless.get.setThermalResistance(starting_thermal_resistance * (1 + r_value_prct_inc / 100))
+    end
+    new_material_airgap = new_material.to_AirGap
+    unless new_material_airgap.empty?
+      starting_thermal_resistance = new_material_airgap.get.thermalResistance
+      final_thermal_resistance = new_material_airgap.get.setThermalResistance(starting_thermal_resistance * (1 + r_value_prct_inc / 100))
+    end
+
+    # report initial condition
+    final_r_value_ip = OpenStudio.convert(1 / construction.thermalConductance.to_f, 'm^2*K/W', 'ft^2*h*R/Btu')
+    runner.registerFinalCondition("The Final R-value of #{construction.name} is #{final_r_value_ip} (ft^2*h*R/Btu).")
+    runner.registerValue('final_r_value_ip', final_r_value_ip.to_f, 'ft^2*h*R/Btu')
+    true
+  end # end the run method
+end # end the measure
+
+# this allows the measure to be used by the application
+RValueOfInsulationForConstructionPercentageChange.new.registerWithApplication

data/lib/measures/RValueOfInsulationForConstructionPercentageChange/measure.xml

@@ -0,0 +1,132 @@
+<measure>
+  <schema_version>3.0</schema_version>
+  <name>r_value_of_insulation_for_construction_percentage_change</name>
+  <uid>7ee248fd-052a-48d6-a8eb-b1fc6a0dc348</uid>
+  <version_id>d3e7d8ca-283c-4a2d-ba56-d012b3615261</version_id>
+  <version_modified>20200325T030945Z</version_modified>
+  <xml_checksum>0BF71A3E</xml_checksum>
+  <class_name>RValueOfInsulationForConstructionPercentageChange</class_name>
+  <display_name>Change R-value of Insulation Layer for Construction By a Specified Percentage</display_name>
+  <description>Change R-value of Insulation Layer for Construction By a Specified Percentage</description>
+  <modeler_description>Change R-value of Insulation Layer for Construction By a Specified Percentage</modeler_description>
+  <arguments>
+    <argument>
+      <name>construction</name>
+      <display_name>Choose a Construction to Alter.</display_name>
+      <type>Choice</type>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+    </argument>
+    <argument>
+      <name>r_value_prct_inc</name>
+      <display_name>Percentage Change of R-value for Insulation Layer of Construction.</display_name>
+      <type>Double</type>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+      <default_value>0</default_value>
+    </argument>
+  </arguments>
+  <outputs/>
+  <provenances/>
+  <tags>
+    <tag>Envelope.Opaque</tag>
+  </tags>
+  <attributes>
+    <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>
+    <attribute>
+      <name>Measure Type</name>
+      <value>ModelMeasure</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Software Tool</name>
+      <value>Apply Measure Now</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Software Tool</name>
+      <value>OpenStudio Application</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Software Tool</name>
+      <value>Parametric Analysis Tool</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Software Tool</name>
+      <value>Analysis Spreadsheet</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Use Case</name>
+      <value>Model Articulation</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Use Case</name>
+      <value>Calibration</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Use Case</name>
+      <value>Sensitivity Analysis</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Use Case</name>
+      <value>New Construction EE</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Use Case</name>
+      <value>Retrofit EE</value>
+      <datatype>string</datatype>
+    </attribute>
+  </attributes>
+  <files>
+    <file>
+      <filename>LICENSE.md</filename>
+      <filetype>md</filetype>
+      <usage_type>license</usage_type>
+      <checksum>E0468DD6</checksum>
+    </file>
+    <file>
+      <filename>README.md.erb</filename>
+      <filetype>erb</filetype>
+      <usage_type>readmeerb</usage_type>
+      <checksum>703C9964</checksum>
+    </file>
+    <file>
+      <filename>README.md</filename>
+      <filetype>md</filetype>
+      <usage_type>readme</usage_type>
+      <checksum>49A7DFFE</checksum>
+    </file>
+    <file>
+      <version>
+        <software_program>OpenStudio</software_program>
+        <identifier>0.11.5</identifier>
+        <min_compatible>0.11.5</min_compatible>
+      </version>
+      <filename>measure.rb</filename>
+      <filetype>rb</filetype>
+      <usage_type>script</usage_type>
+      <checksum>6F9D31D5</checksum>
+    </file>
+  </files>
+</measure>