openstudio-common-measures 0.2.1 → 0.3.0

data/lib/measures/ReduceLightingLoadsByPercentage/measure.xml

@@ -0,0 +1,191 @@
+<measure>
+  <schema_version>3.0</schema_version>
+  <name>reduce_lighting_loads_by_percentage</name>
+  <uid>791f3404-a28b-4a80-ba3f-e15b339e39ea</uid>
+  <version_id>01e31b73-acc4-47cd-b6cb-8c54238964fc</version_id>
+  <version_modified>20200229T024320Z</version_modified>
+  <xml_checksum>293730A7</xml_checksum>
+  <class_name>ReduceLightingLoadsByPercentage</class_name>
+  <display_name>Reduce Lighting Loads by Percentage</display_name>
+  <description>The lighting system in this building uses more power per area than is required with the latest lighting technologies.  Replace the lighting system with a newer, more efficient lighting technology.  Newer technologies provide the same amount of light but use less energy in the process.</description>
+  <modeler_description>This measure supports models which have a mixture of lighting assigned to spaces and space types.  The lighting may be specified as individual luminaires, lighting equipment level, lighting power per area, or lighting power per person. Loop through all lights and luminaires in the specified space type or the entire building. Clone the definition if it is shared by other lights, rename and adjust the power based on the specified percentage. Link the new definition to the existing lights or luminaire instance.  Adjust the power for lighting equipment assigned to a particular space but only if that space is part of the selected space type by  looping through the objects first in space types and then in spaces, but again only for spaces that are in the specified space type (unless the entire building has been chosen).  Material and installation cost increases will be applied to all costs related to both the definition and instance of the lighting object.  If this measure includes baseline costs, then the material and installation costs of the lighting objects in the baseline model will be summed together and added as a capital cost on the building object.</modeler_description>
+  <arguments>
+    <argument>
+      <name>space_type</name>
+      <display_name>Apply the Measure to a Specific Space Type or to the Entire Model</display_name>
+      <type>Choice</type>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+      <default_value>*Entire Building*</default_value>
+      <choices>
+        <choice>
+          <value>{ba5b25d6-8c19-43e3-abc8-bb5666d4cc52}</value>
+          <display_name>*Entire Building*</display_name>
+        </choice>
+      </choices>
+    </argument>
+    <argument>
+      <name>lighting_power_reduction_percent</name>
+      <display_name>Lighting Power Reduction</display_name>
+      <type>Double</type>
+      <units>%</units>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+      <default_value>30</default_value>
+    </argument>
+    <argument>
+      <name>material_and_installation_cost</name>
+      <display_name>Increase in Material and Installation Cost for Lighting per Floor Area</display_name>
+      <type>Double</type>
+      <units>%</units>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+      <default_value>0</default_value>
+    </argument>
+    <argument>
+      <name>demolition_cost</name>
+      <display_name>Increase in Demolition Costs for Lighting per Floor Area</display_name>
+      <type>Double</type>
+      <units>%</units>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+      <default_value>0</default_value>
+    </argument>
+    <argument>
+      <name>years_until_costs_start</name>
+      <display_name>Years Until Costs Start</display_name>
+      <type>Integer</type>
+      <units>whole years</units>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+      <default_value>0</default_value>
+    </argument>
+    <argument>
+      <name>demo_cost_initial_const</name>
+      <display_name>Demolition Costs Occur During Initial Construction</display_name>
+      <type>Boolean</type>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+      <default_value>false</default_value>
+      <choices>
+        <choice>
+          <value>true</value>
+          <display_name>true</display_name>
+        </choice>
+        <choice>
+          <value>false</value>
+          <display_name>false</display_name>
+        </choice>
+      </choices>
+    </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>15</default_value>
+    </argument>
+    <argument>
+      <name>om_cost</name>
+      <display_name>Increase O &amp; M Costs for Lighting per Floor Area</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>Electric Lighting.Lighting Equipment</tag>
+  </tags>
+  <attributes>
+    <attribute>
+      <name>Measure Type</name>
+      <value>ModelMeasure</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>EC_QAQC.osm</filename>
+      <filetype>osm</filetype>
+      <usage_type>test</usage_type>
+      <checksum>A0F6342F</checksum>
+    </file>
+    <file>
+      <filename>EnvelopeAndLoadTestModel_01.osm</filename>
+      <filetype>osm</filetype>
+      <usage_type>test</usage_type>
+      <checksum>10AA8866</checksum>
+    </file>
+    <file>
+      <filename>EnvelopeAndLoadTestModel_01_FullyCosted.osm</filename>
+      <filetype>osm</filetype>
+      <usage_type>test</usage_type>
+      <checksum>824A4C53</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>9169535E</checksum>
+    </file>
+    <file>
+      <filename>ReduceLightingLoadsByPercentage_Test.rb</filename>
+      <filetype>rb</filetype>
+      <usage_type>test</usage_type>
+      <checksum>F5BAA5CC</checksum>
+    </file>
+    <file>
+      <filename>LICENSE.md</filename>
+      <filetype>md</filetype>
+      <usage_type>license</usage_type>
+      <checksum>E0468DD6</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>BD37BF51</checksum>
+    </file>
+  </files>
+</measure>

data/lib/measures/ReduceSpaceInfiltrationByPercentage/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/ReduceSpaceInfiltrationByPercentage/README.md

@@ -0,0 +1,104 @@
+
+
+###### (Automatically generated documentation)
+
+# ReduceSpaceInfiltrationByPercentage
+
+## Description
+This measure will reduce space infiltration rates by the requested percentage. A cost per square foot of building area can be added to the model.
+
+## Modeler Description
+This can be run across a space type or the entire building. Costs will be associated with the building. If infiltration objects are removed at a later date, the costs will remain.
+
+## Measure Type
+ModelMeasure
+
+## Taxonomy
+
+
+## Arguments
+
+
+### Apply the Measure to a Specific Space Type or to the Entire Model.
+
+**Name:** space_type,
+**Type:** Choice,
+**Units:** ,
+**Required:** true,
+**Model Dependent:** false
+
+### Space Infiltration Power Reduction
+
+**Name:** space_infiltration_reduction_percent,
+**Type:** Double,
+**Units:** %,
+**Required:** true,
+**Model Dependent:** false
+
+### Constant Coefficient
+
+**Name:** constant_coefficient,
+**Type:** Double,
+**Units:** ,
+**Required:** true,
+**Model Dependent:** false
+
+### Temperature Coefficient
+
+**Name:** temperature_coefficient,
+**Type:** Double,
+**Units:** ,
+**Required:** true,
+**Model Dependent:** false
+
+### Wind Speed Coefficient
+
+**Name:** wind_speed_coefficient,
+**Type:** Double,
+**Units:** ,
+**Required:** true,
+**Model Dependent:** false
+
+### Wind Speed Squared Coefficient
+
+**Name:** wind_speed_squared_coefficient,
+**Type:** Double,
+**Units:** ,
+**Required:** true,
+**Model Dependent:** false
+
+### Alter constant temperature and wind speed coefficients.
+Setting this to false will result in infiltration objects that maintain the coefficients from the initial model. Setting this to true replaces the existing coefficients with the values entered for the coefficient arguments in this measure
+**Name:** alter_coef,
+**Type:** Boolean,
+**Units:** ,
+**Required:** true,
+**Model Dependent:** false
+
+### Increase in Material and Installation Costs for Building per Affected Floor Area
+
+**Name:** material_and_installation_cost,
+**Type:** Double,
+**Units:** $/ft^2,
+**Required:** true,
+**Model Dependent:** false
+
+### O & M Costs for Construction per Affected Floor Area
+
+**Name:** om_cost,
+**Type:** Double,
+**Units:** $/ft^2,
+**Required:** true,
+**Model Dependent:** false
+
+### O & M Frequency
+
+**Name:** om_frequency,
+**Type:** Integer,
+**Units:** whole years,
+**Required:** true,
+**Model Dependent:** false
+
+
+
+

data/lib/measures/ReduceSpaceInfiltrationByPercentage/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/ReduceSpaceInfiltrationByPercentage/measure.rb

@@ -0,0 +1,349 @@
+# *******************************************************************************
+# 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.
+# *******************************************************************************
+
+# see the URL below for information on how to write OpenStudio measures
+# http://openstudio.nrel.gov/openstudio-measure-writing-guide
+
+# see the URL below for information on using life cycle cost objects in OpenStudio
+# http://openstudio.nrel.gov/openstudio-life-cycle-examples
+
+# see the URL below for access to C++ documentation on model objects (click on "model" in the main window to view model objects)
+# http://openstudio.nrel.gov/sites/openstudio.nrel.gov/files/nv_data/cpp_documentation_it/model/html/namespaces.html
+
+# start the measure
+class ReduceSpaceInfiltrationByPercentage < OpenStudio::Measure::ModelMeasure
+  # define the name that a user will see, this method may be deprecated as
+  # the display name in PAT comes from the name field in measure.xml
+  def name
+    return 'ReduceSpaceInfiltrationByPercentage'
+  end
+
+  # human readable description
+  def description
+    return 'This measure will reduce space infiltration rates by the requested percentage. A cost per square foot of building area can be added to the model.'
+  end
+
+  # human readable description of modeling approach
+  def modeler_description
+    return 'This can be run across a space type or the entire building. Costs will be associated with the building. If infiltration objects are removed at a later date, the costs will remain.'
+  end
+
+  # define the arguments that the user will input
+  def arguments(model)
+    args = OpenStudio::Measure::OSArgumentVector.new
+
+    # make a choice argument for model objects
+    space_type_handles = OpenStudio::StringVector.new
+    space_type_display_names = OpenStudio::StringVector.new
+
+    # putting model object and names into hash
+    space_type_args = model.getSpaceTypes
+    space_type_args_hash = {}
+    space_type_args.each do |space_type_arg|
+      space_type_args_hash[space_type_arg.name.to_s] = space_type_arg
+    end
+
+    # looping through sorted hash of model objects
+    space_type_args_hash.sort.map do |key, value|
+      # only include if space type is used in the model
+      if !value.spaces.empty?
+        space_type_handles << value.handle.to_s
+        space_type_display_names << key
+      end
+    end
+
+    # add building to string vector with space type
+    building = model.getBuilding
+    space_type_handles << building.handle.to_s
+    space_type_display_names << '*Entire Building*'
+
+    # make a choice argument for space type
+    space_type = OpenStudio::Measure::OSArgument.makeChoiceArgument('space_type', space_type_handles, space_type_display_names)
+    space_type.setDisplayName('Apply the Measure to a Specific Space Type or to the Entire Model.')
+    space_type.setDefaultValue('*Entire Building*') # if no space type is chosen this will run on the entire building
+    args << space_type
+
+    # make an argument for reduction percentage
+    space_infiltration_reduction_percent = OpenStudio::Measure::OSArgument.makeDoubleArgument('space_infiltration_reduction_percent', true)
+    space_infiltration_reduction_percent.setDisplayName('Space Infiltration Power Reduction')
+    space_infiltration_reduction_percent.setDefaultValue(30.0)
+    space_infiltration_reduction_percent.setUnits('%')
+    args << space_infiltration_reduction_percent
+
+    # make an argument for constant_coefficient
+    constant_coefficient = OpenStudio::Measure::OSArgument.makeDoubleArgument('constant_coefficient', true)
+    constant_coefficient.setDisplayName('Constant Coefficient')
+    constant_coefficient.setDefaultValue(1.0)
+    args << constant_coefficient
+
+    # make an argument for temperature_coefficient
+    temperature_coefficient = OpenStudio::Measure::OSArgument.makeDoubleArgument('temperature_coefficient', true)
+    temperature_coefficient.setDisplayName('Temperature Coefficient')
+    temperature_coefficient.setDefaultValue(0.0)
+    args << temperature_coefficient
+
+    # make an argument for wind_speed_coefficient
+    wind_speed_coefficient = OpenStudio::Measure::OSArgument.makeDoubleArgument('wind_speed_coefficient', true)
+    wind_speed_coefficient.setDisplayName('Wind Speed Coefficient')
+    wind_speed_coefficient.setDefaultValue(0.0)
+    args << wind_speed_coefficient
+
+    # make an argument for wind_speed_squared_coefficient
+    wind_speed_squared_coefficient = OpenStudio::Measure::OSArgument.makeDoubleArgument('wind_speed_squared_coefficient', true)
+    wind_speed_squared_coefficient.setDisplayName('Wind Speed Squared Coefficient')
+    wind_speed_squared_coefficient.setDefaultValue(0.0)
+    args << wind_speed_squared_coefficient
+
+    # make an argument for alter_coef
+    alter_coef = OpenStudio::Measure::OSArgument.makeBoolArgument('alter_coef', true)
+    alter_coef.setDisplayName('Alter constant temperature and wind speed coefficients.')
+    alter_coef.setDescription('Setting this to false will result in infiltration objects that maintain the coefficients from the initial model. Setting this to true replaces the existing coefficients with the values entered for the coefficient arguments in this measure')
+    alter_coef.setDefaultValue(true)
+    args << alter_coef
+
+    # make an argument for material and installation cost
+    material_and_installation_cost = OpenStudio::Measure::OSArgument.makeDoubleArgument('material_and_installation_cost', true)
+    material_and_installation_cost.setDisplayName('Increase in Material and Installation Costs for Building per Affected Floor Area')
+    material_and_installation_cost.setDefaultValue(0.0)
+    material_and_installation_cost.setUnits('$/ft^2')
+    args << material_and_installation_cost
+
+    # make an argument for O & M cost
+    om_cost = OpenStudio::Measure::OSArgument.makeDoubleArgument('om_cost', true)
+    om_cost.setDisplayName('O & M Costs for Construction per Affected Floor Area')
+    om_cost.setDefaultValue(0.0)
+    om_cost.setUnits('$/ft^2')
+    args << om_cost
+
+    # make an argument for O & M frequency
+    om_frequency = OpenStudio::Measure::OSArgument.makeIntegerArgument('om_frequency', true)
+    om_frequency.setDisplayName('O & M Frequency')
+    om_frequency.setDefaultValue(1)
+    om_frequency.setUnits('whole years')
+    args << om_frequency
+
+    return args
+  end
+
+  # 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
+    if !runner.validateUserArguments(arguments(model), user_arguments)
+      return false
+    end
+
+    # assign the user inputs to variables
+    object = runner.getOptionalWorkspaceObjectChoiceValue('space_type', user_arguments, model)
+    space_infiltration_reduction_percent = runner.getDoubleArgumentValue('space_infiltration_reduction_percent', user_arguments)
+    constant_coefficient = runner.getDoubleArgumentValue('constant_coefficient', user_arguments)
+    temperature_coefficient = runner.getDoubleArgumentValue('temperature_coefficient', user_arguments)
+    wind_speed_coefficient = runner.getDoubleArgumentValue('wind_speed_coefficient', user_arguments)
+    wind_speed_squared_coefficient = runner.getDoubleArgumentValue('wind_speed_squared_coefficient', user_arguments)
+    alter_coef = runner.getBoolArgumentValue('alter_coef', user_arguments)
+    material_and_installation_cost = runner.getDoubleArgumentValue('material_and_installation_cost', user_arguments)
+    om_cost = runner.getDoubleArgumentValue('om_cost', user_arguments)
+    om_frequency = runner.getIntegerArgumentValue('om_frequency', user_arguments)
+
+    # check the space_type for reasonableness and see if measure should run on space type or on the entire building
+    apply_to_building = false
+    space_type = nil
+    if object.empty?
+      handle = runner.getStringArgumentValue('space_type', user_arguments)
+      if handle.empty?
+        runner.registerError('No space type was chosen.')
+      else
+        runner.registerError("The selected space type with handle '#{handle}' was not found in the model. It may have been removed by another measure.")
+      end
+      return false
+    else
+      if !object.get.to_SpaceType.empty?
+        space_type = object.get.to_SpaceType.get
+      elsif !object.get.to_Building.empty?
+        apply_to_building = true
+      else
+        runner.registerError('Script Error - argument not showing up as space type or building.')
+        return false
+      end
+    end
+
+    # check the space_infiltration_reduction_percent and for reasonableness
+    if space_infiltration_reduction_percent > 100
+      runner.registerError('Please enter a value less than or equal to 100 for the Space Infiltration reduction percentage.')
+      return false
+    elsif space_infiltration_reduction_percent == 0
+      runner.registerInfo('No Space Infiltration adjustment requested, but infiltration coefficients or life cycle costs may still be affected.')
+    elsif (space_infiltration_reduction_percent < 1) && (space_infiltration_reduction_percent > -1)
+      runner.registerWarning("A Space Infiltration reduction percentage of #{space_infiltration_reduction_percent} percent is abnormally low.")
+    elsif space_infiltration_reduction_percent > 90
+      runner.registerWarning("A Space Infiltration reduction percentage of #{space_infiltration_reduction_percent} percent is abnormally high.")
+    elsif space_infiltration_reduction_percent < 0
+      runner.registerInfo('The requested value for Space Infiltration reduction percentage was negative. This will result in an increase in Space Infiltration.')
+    end
+
+    # TODO: - currently not checking for negative $/ft^2 for material_and_installation_cost and om_cost, confirm if E+ will allow negative cost
+
+    if om_frequency < 1
+      runner.registerError('Choose an integer greater than 0 for O & M Frequency.')
+    end
+
+    # helper to make numbers pretty (converts 4125001.25641 to 4,125,001.26 or 4,125,001). The definition be called through this measure.
+    def neat_numbers(number, roundto = 2) # round to 0 or 2)
+      if roundto == 2
+        number = format '%.2f', number
+      else
+        number = number.round
+      end
+      # regex to add commas
+      number.to_s.reverse.gsub(/([0-9]{3}(?=([0-9])))/, '\\1,').reverse
+    end
+
+    # get space infiltration objects used in the model
+    space_infiltration_objects = model.getSpaceInfiltrationDesignFlowRates
+    # TODO: - it would be nice to give ranges for different calculation methods but would take some work.
+
+    # counters needed for measure
+    altered_instances = 0
+    affected_area_si = 0
+
+    # reporting initial condition of model
+    if !space_infiltration_objects.empty?
+      runner.registerInitialCondition("The initial model contained #{space_infiltration_objects.size} space infiltration objects.")
+    else
+      runner.registerInitialCondition('The initial model did not contain any space infiltration objects.')
+    end
+
+    # get space types in model
+    building = model.building.get
+    if apply_to_building
+      space_types = model.getSpaceTypes
+      affected_area_si = building.floorArea
+    else
+      space_types = []
+      space_types << space_type # only run on a single space type
+      affected_area_si = space_type.floorArea
+    end
+
+    # def to alter performance and life cycle costs of objects
+    def alter_performance(object, space_infiltration_reduction_percent, constant_coefficient, temperature_coefficient, wind_speed_coefficient, wind_speed_squared_coefficient, alter_coef, runner)
+      # edit instance based on percentage reduction
+      instance = object
+      if !instance.designFlowRate.empty?
+        new_infiltration_design_flow_rate = instance.setDesignFlowRate(instance.designFlowRate.get - instance.designFlowRate.get * space_infiltration_reduction_percent * 0.01)
+      elsif !instance.flowperSpaceFloorArea.empty?
+        new_infiltration_flow_floor_area = instance.setFlowperSpaceFloorArea(instance.flowperSpaceFloorArea.get - instance.flowperSpaceFloorArea.get * space_infiltration_reduction_percent * 0.01)
+      elsif !instance.flowperExteriorSurfaceArea.empty?
+        new_infiltration_flow_ext_area = instance.setFlowperExteriorSurfaceArea(instance.flowperExteriorSurfaceArea.get - instance.flowperExteriorSurfaceArea.get * space_infiltration_reduction_percent * 0.01)
+      elsif !instance.flowperExteriorWallArea.empty?
+        new_infiltration_flow_ext_area = instance.setFlowperExteriorWallArea(instance.flowperExteriorWallArea.get - instance.flowperExteriorWallArea.get * space_infiltration_reduction_percent * 0.01)
+      elsif !instance.airChangesperHour.empty?
+        new_infiltration_ach = instance.setAirChangesperHour(instance.airChangesperHour.get - instance.airChangesperHour.get * space_infiltration_reduction_percent * 0.01)
+      else
+        runner.registerWarning("'#{instance.name}' is used by one or more instances and has no load values.")
+      end
+
+      # only alter coefficients if requested
+      if alter_coef
+        instance.setConstantTermCoefficient(constant_coefficient)
+        instance.setTemperatureTermCoefficient(temperature_coefficient)
+        instance.setVelocityTermCoefficient(wind_speed_coefficient)
+        instance.setVelocitySquaredTermCoefficient(wind_speed_squared_coefficient)
+      end
+    end
+
+    # loop through space types
+    space_types.each do |space_type|
+      next if space_type.spaces.size <= 0
+      space_type_infiltration_objects = space_type.spaceInfiltrationDesignFlowRates
+      space_type_infiltration_objects.each do |space_type_infiltration_object|
+        # call def to alter performance and life cycle costs
+        alter_performance(space_type_infiltration_object, space_infiltration_reduction_percent, constant_coefficient, temperature_coefficient, wind_speed_coefficient, wind_speed_squared_coefficient, alter_coef, runner)
+
+        # rename
+        updated_instance_name = space_type_infiltration_object.setName("#{space_type_infiltration_object.name} #{space_infiltration_reduction_percent} percent reduction")
+        altered_instances += 1
+      end
+    end
+
+    # getting spaces in the model
+    spaces = model.getSpaces
+
+    # get space types in model
+    if apply_to_building
+      spaces = model.getSpaces
+    else
+      if !space_type.spaces.empty?
+        spaces = space_type.spaces # only run on a single space type
+      end
+    end
+
+    spaces.each do |space|
+      space_infiltration_objects = space.spaceInfiltrationDesignFlowRates
+      space_infiltration_objects.each do |space_infiltration_object|
+        # call def to alter performance and life cycle costs
+        alter_performance(space_infiltration_object, space_infiltration_reduction_percent, constant_coefficient, temperature_coefficient, wind_speed_coefficient, wind_speed_squared_coefficient, alter_coef, runner)
+
+        # rename
+        updated_instance_name = space_infiltration_object.setName("#{space_infiltration_object.name} #{space_infiltration_reduction_percent} percent reduction")
+        altered_instances += 1
+      end
+    end
+
+    if (altered_instances == 0) && (material_and_installation_cost == 0) && (om_cost == 0)
+      runner.registerAsNotApplicable('No space infiltration objects were found in the specified space type(s) and no life cycle costs were requested.')
+    end
+
+    # only add LifeCyCyleCostItem if the user entered some non 0 cost values
+    affected_area_ip = OpenStudio.convert(affected_area_si, 'm^2', 'ft^2').get
+    if (material_and_installation_cost != 0) || (om_cost != 0)
+      lcc_mat = OpenStudio::Model::LifeCycleCost.createLifeCycleCost('LCC_Mat - Cost to Adjust Infiltration', building, affected_area_ip * material_and_installation_cost, 'CostPerEach', 'Construction', 0, 0) # 0 for expected life will result infinite expected life
+      lcc_om = OpenStudio::Model::LifeCycleCost.createLifeCycleCost('LCC_OM - Cost to Adjust Infiltration', building, affected_area_ip * om_cost, 'CostPerEach', 'Maintenance', om_frequency, 0) # o&m costs start after at sane time that material and installation costs occur
+      runner.registerInfo("Costs related to the change in infiltration are attached to the building object. Any subsequent measures that may affect infiltration won't affect these costs.")
+      final_cost = lcc_mat.get.totalCost
+    else
+      runner.registerInfo('Cost arguments were not provided, no cost objects were added to the model.')
+      final_cost = 0
+    end
+
+    # report final condition
+    runner.registerFinalCondition("#{altered_instances} space infiltration objects in the model were altered affecting #{neat_numbers(affected_area_ip, 0)}(ft^2) at a total cost of $#{neat_numbers(final_cost, 0)}.")
+
+    return true
+  end
+end
+
+# this allows the measure to be use by the application
+ReduceSpaceInfiltrationByPercentage.new.registerWithApplication