openstudio-common-measures 0.2.0 → 0.4.0

data/lib/measures/create_variable_speed_rtu/measure.xml

@@ -1,207 +0,0 @@
-<measure>
-  <schema_version>3.0</schema_version>
-  <name>create_variable_speed_rtu</name>
-  <uid>7fb36b3a-5591-4627-a2b0-7709fbeae593</uid>
-  <version_id>b4784727-b8f2-46e2-92ad-219ecd2e1c5a</version_id>
-  <version_modified>20200229T024317Z</version_modified>
-  <xml_checksum>A9D5932A</xml_checksum>
-  <class_name>CreateVariableSpeedRTU</class_name>
-  <display_name>Create Variable Speed RTU</display_name>
-  <description>This measure examines the existing HVAC system(s) present in the current OpenStudio model. If a constant-speed system is found, the user can opt to have the measure replace that system with a variable-speed RTU. 'Variable speed' in this case means that the compressor will be operated using either two or four stages (user's choice). The user can choose between using a gas heating coil, or a direct-expansion (DX) heating coil. Additionally, the user is able to enter the EER (cooling) and COP (heating) values for each DX stage. This measure allows users to easily identify the impact of improved part-load efficiency.</description>
-  <modeler_description>This measure loops through the existing airloops, looking for loops that have a constant speed fan. (Note that if an object such as an AirloopHVAC:UnitarySystem is present in the model, that the measure will NOT identify that loop as either constant- or variable-speed, since the fan is located inside the UnitarySystem object.) The user can designate which constant-speed airloop they'd like to apply the measure to, or opt to apply the measure to all airloops. The measure then replaces the supply components on the airloop with an AirloopHVAC:UnitarySystem object. Any DX coils added to the UnitarySystem object are of the type CoilCoolingDXMultiSpeed / CoilHeatingDXMultiSpeed, with the number of stages set to either two or four, depending on user input. If the user opts for a gas furnace, an 80% efficient CoilHeatingGas object is added. Fan properties (pressure rise and total efficiency) are transferred automatically from the existing (but deleted) constant speed fan to the new variable-speed fan. Currently, this measure is only applicable to the Standalone Retail DOE Prototype building model, but it has been structured to facilitate expansion to other models with a minimum of effort.</modeler_description>
-  <arguments>
-    <argument>
-      <name>object</name>
-      <display_name>Choose an Air Loop to change from CAV to VAV.</display_name>
-      <type>Choice</type>
-      <required>true</required>
-      <model_dependent>false</model_dependent>
-      <default_value>*All CAV Air Loops*</default_value>
-      <choices>
-        <choice>
-          <value>{42167619-c2eb-4812-a9e5-9b286d7beef8}</value>
-          <display_name>*All CAV Air Loops*</display_name>
-        </choice>
-      </choices>
-    </argument>
-    <argument>
-      <name>cooling_coil_type</name>
-      <display_name>Choose the type of cooling coil.</display_name>
-      <type>Choice</type>
-      <required>true</required>
-      <model_dependent>false</model_dependent>
-      <default_value>Two-Stage Compressor</default_value>
-      <choices>
-        <choice>
-          <value>Two-Stage Compressor</value>
-          <display_name>Two-Stage Compressor</display_name>
-        </choice>
-        <choice>
-          <value>Four-Stage Compressor</value>
-          <display_name>Four-Stage Compressor</display_name>
-        </choice>
-      </choices>
-    </argument>
-    <argument>
-      <name>rated_cc_eer</name>
-      <display_name>Rated Cooling Coil EER</display_name>
-      <type>Double</type>
-      <required>false</required>
-      <model_dependent>false</model_dependent>
-    </argument>
-    <argument>
-      <name>three_quarter_cc_eer</name>
-      <display_name>Cooling Coil EER at 75% Capacity</display_name>
-      <type>Double</type>
-      <required>false</required>
-      <model_dependent>false</model_dependent>
-    </argument>
-    <argument>
-      <name>half_cc_eer</name>
-      <display_name>Cooling Coil EER at 50% Capacity</display_name>
-      <type>Double</type>
-      <required>false</required>
-      <model_dependent>false</model_dependent>
-    </argument>
-    <argument>
-      <name>quarter_cc_eer</name>
-      <display_name>Cooling Coil EER at 25% Capacity</display_name>
-      <type>Double</type>
-      <required>false</required>
-      <model_dependent>false</model_dependent>
-    </argument>
-    <argument>
-      <name>heating_coil_type</name>
-      <display_name>Choose the type of heating coil.</display_name>
-      <type>Choice</type>
-      <required>true</required>
-      <model_dependent>false</model_dependent>
-      <default_value>Gas Heating Coil</default_value>
-      <choices>
-        <choice>
-          <value>Gas Heating Coil</value>
-          <display_name>Gas Heating Coil</display_name>
-        </choice>
-        <choice>
-          <value>Heat Pump</value>
-          <display_name>Heat Pump</display_name>
-        </choice>
-      </choices>
-    </argument>
-    <argument>
-      <name>rated_hc_gas_efficiency</name>
-      <display_name>Rated Gas Heating Coil Efficiency (0-1.00)</display_name>
-      <type>Double</type>
-      <required>false</required>
-      <model_dependent>false</model_dependent>
-    </argument>
-    <argument>
-      <name>rated_hc_cop</name>
-      <display_name>Rated Heating Coil COP</display_name>
-      <type>Double</type>
-      <required>false</required>
-      <model_dependent>false</model_dependent>
-    </argument>
-    <argument>
-      <name>three_quarter_hc_cop</name>
-      <display_name>Heating Coil COP at 75% Capacity</display_name>
-      <type>Double</type>
-      <required>false</required>
-      <model_dependent>false</model_dependent>
-    </argument>
-    <argument>
-      <name>half_hc_cop</name>
-      <display_name>Heating Coil COP at 50% Capacity</display_name>
-      <type>Double</type>
-      <required>false</required>
-      <model_dependent>false</model_dependent>
-    </argument>
-    <argument>
-      <name>quarter_hc_cop</name>
-      <display_name>Heating Coil COP at 25% Capacity</display_name>
-      <type>Double</type>
-      <required>false</required>
-      <model_dependent>false</model_dependent>
-    </argument>
-  </arguments>
-  <outputs/>
-  <provenances/>
-  <tags>
-    <tag>HVAC.Whole System</tag>
-  </tags>
-  <attributes>
-    <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 Use Case</name>
-      <value>Model Articulation</value>
-      <datatype>string</datatype>
-    </attribute>
-    <attribute>
-      <name>Intended Use Case</name>
-      <value>New Construction EE</value>
-      <datatype>string</datatype>
-    </attribute>
-  </attributes>
-  <files>
-    <file>
-      <filename>example_model.osm</filename>
-      <filetype>osm</filetype>
-      <usage_type>test</usage_type>
-      <checksum>69467654</checksum>
-    </file>
-    <file>
-      <filename>README.md</filename>
-      <filetype>md</filetype>
-      <usage_type>readme</usage_type>
-      <checksum>839520ED</checksum>
-    </file>
-    <file>
-      <filename>README.md.erb</filename>
-      <filetype>erb</filetype>
-      <usage_type>readmeerb</usage_type>
-      <checksum>703C9964</checksum>
-    </file>
-    <file>
-      <filename>LICENSE.md</filename>
-      <filetype>md</filetype>
-      <usage_type>license</usage_type>
-      <checksum>E0468DD6</checksum>
-    </file>
-    <file>
-      <filename>create_variable_speed_rtu_test.rb</filename>
-      <filetype>rb</filetype>
-      <usage_type>test</usage_type>
-      <checksum>B199E2FA</checksum>
-    </file>
-    <file>
-      <version>
-        <software_program>OpenStudio</software_program>
-        <identifier>1.12.2</identifier>
-        <min_compatible>2.7.0</min_compatible>
-      </version>
-      <filename>measure.rb</filename>
-      <filetype>rb</filetype>
-      <usage_type>script</usage_type>
-      <checksum>13C7C1EA</checksum>
-    </file>
-  </files>
-</measure>

data/lib/measures/generic_qaqc/resources/os_lib_helper_methods.rb

@@ -1,399 +0,0 @@
-# *******************************************************************************
-# 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.
-# *******************************************************************************
-
-module OsLib_HelperMethods
-  # populate choice argument from model objects
-  def self.populateChoiceArgFromModelObjects(model, modelObject_args_hash, includeBuilding = nil)
-    # populate choice argument for constructions that are applied to surfaces in the model
-    modelObject_handles = OpenStudio::StringVector.new
-    modelObject_display_names = OpenStudio::StringVector.new
-
-    # looping through sorted hash of constructions
-    modelObject_args_hash.sort.map do |key, value|
-      modelObject_handles << value.handle.to_s
-      modelObject_display_names << key
-    end
-
-    unless includeBuilding.nil?
-      # add building to string vector with space type
-      building = model.getBuilding
-      modelObject_handles << building.handle.to_s
-      modelObject_display_names << includeBuilding
-    end
-
-    result = { 'modelObject_handles' => modelObject_handles, 'modelObject_display_names' => modelObject_display_names }
-    return result
-  end
-
-  # create variables in run from user arguments
-  def self.createRunVariables(runner, model, user_arguments, arguments)
-    result = {}
-
-    error = false
-    # use the built-in error checking
-    unless runner.validateUserArguments(arguments, user_arguments)
-      error = true
-      runner.registerError('Invalid argument values.')
-    end
-
-    user_arguments.each do |argument|
-      # get argument info
-      arg = user_arguments[argument]
-      arg_type = arg.print.lines($/)[1]
-
-      # create argument variable
-      if arg_type.include? 'Double, Required'
-        eval("result[\"#{arg.name}\"] = runner.getDoubleArgumentValue(\"#{arg.name}\", user_arguments)")
-      elsif arg_type.include? 'Integer, Required'
-        eval("result[\"#{arg.name}\"] = runner.getIntegerArgumentValue(\"#{arg.name}\", user_arguments)")
-      elsif arg_type.include? 'String, Required'
-        eval("result[\"#{arg.name}\"] = runner.getStringArgumentValue(\"#{arg.name}\", user_arguments)")
-      elsif arg_type.include? 'Boolean, Required'
-        eval("result[\"#{arg.name}\"] = runner.getBoolArgumentValue(\"#{arg.name}\", user_arguments)")
-      elsif arg_type.include? 'Choice, Required'
-        eval("result[\"#{arg.name}\"] = runner.getStringArgumentValue(\"#{arg.name}\", user_arguments)")
-      else
-        puts 'not setup to handle all argument types yet, or any optional arguments'
-      end
-    end
-
-    if error
-      return false
-    else
-      return result
-    end
-  end
-
-  # check choice argument made from model objects
-  def self.checkChoiceArgFromModelObjects(object, variableName, to_ObjectType, runner, user_arguments)
-    apply_to_building = false
-    modelObject = nil
-    if object.empty?
-      handle = runner.getStringArgumentValue(variableName, user_arguments)
-      if handle.empty?
-        runner.registerError("No #{variableName} was chosen.") # this logic makes this not work on an optional model object argument
-      else
-        runner.registerError("The selected #{variableName} with handle '#{handle}' was not found in the model. It may have been removed by another measure.")
-      end
-      return false
-    else
-      if !eval("object.get.#{to_ObjectType}").empty?
-        modelObject = eval("object.get.#{to_ObjectType}").get
-      elsif !object.get.to_Building.empty?
-        apply_to_building = true
-      else
-        runner.registerError("Script Error - argument not showing up as #{variableName}.")
-        return false
-      end
-    end
-
-    result = { 'modelObject' => modelObject, 'apply_to_building' => apply_to_building }
-  end
-
-  # check choice argument made from model objects
-  def self.checkOptionalChoiceArgFromModelObjects(object, variableName, to_ObjectType, runner, user_arguments)
-    apply_to_building = false
-    modelObject = nil
-    if object.empty?
-      handle = runner.getOptionalStringArgumentValue(variableName, user_arguments)
-      if handle.empty?
-        # do nothing, this is a valid option
-        puts 'hello'
-        modelObject = nil
-        apply_to_building = false
-      else
-        runner.registerError("The selected #{variableName} with handle '#{handle}' was not found in the model. It may have been removed by another measure.")
-        return false
-      end
-    else
-      if !eval("object.get.#{to_ObjectType}").empty?
-        modelObject = eval("object.get.#{to_ObjectType}").get
-      elsif !object.get.to_Building.empty?
-        apply_to_building = true
-      else
-        runner.registerError("Script Error - argument not showing up as #{variableName}.")
-        return false
-      end
-    end
-
-    result = { 'modelObject' => modelObject, 'apply_to_building' => apply_to_building }
-  end
-
-  # check value of double arguments
-  def self.checkDoubleAndIntegerArguments(runner, user_arguments, arg_check_hash)
-    error = false
-
-    # get hash values
-    min = arg_check_hash['min']
-    max = arg_check_hash['max']
-    min_eq_bool = arg_check_hash['min_eq_bool']
-    max_eq_bool = arg_check_hash['max_eq_bool']
-
-    arg_check_hash['arg_array'].each do |argument|
-      argument = user_arguments[argument]
-
-      # get arg values
-      arg_value = nil
-      if argument.hasValue
-        arg_value = argument.valueDisplayName.to_f # instead of valueAsDouble so it allows integer arguments as well
-      elsif argument.hasDefaultValue
-        arg_value = argument.defaultValueDisplayName.to_f
-      end
-      arg_display = argument.displayName
-
-      unless min.nil?
-        if min_eq_bool
-          if arg_value < min
-            runner.registerError("Please enter value greater than or equal to #{min} for #{arg_display}.") # add in argument display name
-            error = true
-          end
-        else
-          if arg_value <= min
-            runner.registerError("Please enter value greater than #{min} for #{arg_display}.") # add in argument display name
-            error = true
-          end
-        end
-      end
-      unless max.nil?
-        if max_eq_bool
-          if arg_value > max
-            runner.registerError("Please enter value less than or equal to #{max} for #{arg_display}.") # add in argument display name
-            error = true
-          end
-        else
-          if arg_value >= max
-            runner.registerError("Please enter value less than #{max} for #{arg_display}.") # add in argument display name
-            error = true
-          end
-        end
-      end
-    end
-
-    # check for any errors
-    if error
-      return false
-    else
-      return true
-    end
-  end
-
-  # open channel to log info/warning/error messages
-  def self.setup_log_msgs(runner, debug = false)
-    # Open a channel to log info/warning/error messages
-    @msg_log = OpenStudio::StringStreamLogSink.new
-    if debug
-      @msg_log.setLogLevel(OpenStudio::Debug)
-    else
-      @msg_log.setLogLevel(OpenStudio::Info)
-    end
-    @start_time = Time.new
-    @runner = runner
-  end
-
-  # Get all the log messages and put into output
-  # for users to see.
-  def self.log_msgs
-    @msg_log.logMessages.each do |msg|
-      # DLM: you can filter on log channel here for now
-      if /openstudio.*/.match(msg.logChannel) # /openstudio\.model\..*/
-        # Skip certain messages that are irrelevant/misleading
-        next if msg.logMessage.include?('Skipping layer') || # Annoying/bogus "Skipping layer" warnings
-                msg.logChannel.include?('runmanager') || # RunManager messages
-                msg.logChannel.include?('setFileExtension') || # .ddy extension unexpected
-                msg.logChannel.include?('Translator') || # Forward translator and geometry translator
-                msg.logMessage.include?('UseWeatherFile') # 'UseWeatherFile' is not yet a supported option for YearDescription
-
-        # Report the message in the correct way
-        if msg.logLevel == OpenStudio::Info
-          @runner.registerInfo(msg.logMessage)
-        elsif msg.logLevel == OpenStudio::Warn
-          @runner.registerWarning("[#{msg.logChannel}] #{msg.logMessage}")
-        elsif msg.logLevel == OpenStudio::Error
-          @runner.registerError("[#{msg.logChannel}] #{msg.logMessage}")
-        elsif msg.logLevel == OpenStudio::Debug && @debug
-          @runner.registerInfo("DEBUG - #{msg.logMessage}")
-        end
-      end
-    end
-    @runner.registerInfo("Total Time = #{(Time.new - @start_time).round}sec.")
-  end
-
-  def self.check_upstream_measure_for_arg(runner, arg_name)
-    # 2.x methods (currently setup for measure display name but snake_case arg names)
-    arg_name_value = {}
-    runner.workflow.workflowSteps.each do |step|
-      if step.to_MeasureStep.is_initialized
-        measure_step = step.to_MeasureStep.get
-
-        measure_name = measure_step.measureDirName
-        if measure_step.name.is_initialized
-          measure_name = measure_step.name.get # this is instance name in PAT
-        end
-        if measure_step.result.is_initialized
-          result = measure_step.result.get
-          result.stepValues.each do |arg|
-            name = arg.name
-            value = arg.valueAsVariant.to_s
-            if name == arg_name
-              arg_name_value[:value] = value
-              arg_name_value[:measure_name] = measure_name
-              return arg_name_value # stop after find first one
-            end
-          end
-        else
-          # puts "No result for #{measure_name}"
-        end
-      else
-        # puts "This step is not a measure"
-      end
-    end
-
-    return arg_name_value
-  end
-
-  # populate choice argument from model objects. areaType should be string like "floorArea" or "exteriorArea"
-  # note: it seems like spaceType.floorArea does account for multiplier, so I don't have to call this method unless I have a custom collection of spaces.
-  def self.getAreaOfSpacesInArray(model, spaceArray, areaType = 'floorArea')
-    # find selected floor spaces, make array and get floor area.
-    totalArea = 0
-    spaceAreaHash = {}
-    spaceArray.each do |space|
-      spaceArea = eval("space.#{areaType}*space.multiplier")
-      spaceAreaHash[space] = spaceArea
-      totalArea += spaceArea
-    end
-
-    result = { 'totalArea' => totalArea, 'spaceAreaHash' => spaceAreaHash }
-    return result
-  end
-
-  # runs conversion and neat string, and returns value with units in string, optionally before or after the value
-  def self.neatConvertWithUnitDisplay(double, fromString, toString, digits, unitBefore = false, unitAfter = true, space = true, parentheses = true)
-    # convert units
-    doubleConverted = OpenStudio.convert(double, fromString, toString)
-    if !doubleConverted.nil?
-      doubleConverted = doubleConverted.get
-    else
-      puts "Couldn't convert values, check string choices passed in. From: #{fromString}, To: #{toString}"
-    end
-
-    # get neat version of converted
-    neatConverted = OpenStudio.toNeatString(doubleConverted, digits, true)
-
-    # add prefix
-    if unitBefore
-      if space == true && parentheses == true
-        prefix = "(#{toString}) "
-      elsif space == true && parentheses == false
-        prefix = "(#{toString})"
-      elsif space == false && parentheses == true
-        prefix = "#{toString} "
-      else
-        prefix = toString.to_s
-      end
-    else
-      prefix = ''
-    end
-
-    # add suffix
-    if unitAfter
-      if space == true && parentheses == true
-        suffix = " (#{toString})"
-      elsif space == true && parentheses == false
-        suffix = "(#{toString})"
-      elsif space == false && parentheses == true
-        suffix = " #{toString}"
-      else
-        suffix = toString.to_s
-      end
-    else
-      suffix = ''
-    end
-
-    finalString = "#{prefix}#{neatConverted}#{suffix}"
-
-    return finalString
-  end
-
-  # helper that loops through lifecycle costs getting total costs under "Construction" and add to counter if occurs during year 0
-  def self.getTotalCostForObjects(objectArray, category = 'Construction', onlyYearFromStartZero = true)
-    counter = 0
-    objectArray.each do |object|
-      object_LCCs = object.lifeCycleCosts
-      object_LCCs.each do |object_LCC|
-        if object_LCC.category == category
-          if onlyYearFromStartZero == false || object_LCC.yearsFromStart == 0
-            counter += object_LCC.totalCost
-          end
-        end
-      end
-    end
-
-    return counter
-  end
-
-  # helper that loops through lifecycle costs getting total costs under "Construction" and add to counter if occurs during year 0
-  def self.getSpaceTypeStandardsInformation(spaceTypeArray)
-    # hash of space types
-    spaceTypeStandardsInfoHash = {}
-
-    spaceTypeArray.each do |spaceType|
-      # get standards building
-      if !spaceType.standardsBuildingType.empty?
-        standardsBuilding = spaceType.standardsBuildingType.get
-      else
-        standardsBuilding = nil
-      end
-
-      # get standards space type
-      if !spaceType.standardsSpaceType.empty?
-        standardsSpaceType = spaceType.standardsSpaceType.get
-      else
-        standardsSpaceType = nil
-      end
-
-      # populate hash
-      spaceTypeStandardsInfoHash[spaceType] = [standardsBuilding, standardsSpaceType]
-    end
-
-    return spaceTypeStandardsInfoHash
-  end
-
-  # OpenStudio has built in toNeatString method
-  # OpenStudio::toNeatString(double,2,true)# double,decimals, show commas
-
-  # OpenStudio has built in helper for unit conversion. That can be done using OpenStudio::convert() as shown below.
-  # OpenStudio::convert(double,"from unit string","to unit string").get
-end