openstudio-extension 0.1.2 → 0.1.3

data/lib/openstudio/extension/core/check_schedules.rb

@@ -1,311 +1,311 @@
-# *******************************************************************************
-# OpenStudio(R), Copyright (c) 2008-2019, 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_QAQC
-  # include any general notes about QAQC method here
-
-  # checks the number of unmet hours in the model
-  def check_schedules(category, target_standard, min_pass, max_pass, name_only = false)
-    # summary of the check
-    check_elems = OpenStudio::AttributeVector.new
-    check_elems << OpenStudio::Attribute.new('name', 'Schedules')
-    check_elems << OpenStudio::Attribute.new('category', category)
-    check_elems << OpenStudio::Attribute.new('description', 'Check schedules for lighting, ventilation, occupant density, plug loads, and equipment based on DOE reference building schedules in terms of full load hours per year.')
-
-    # stop here if only name is requested this is used to populate display name for arguments
-    if name_only == true
-      results = []
-      check_elems.each do |elem|
-        results << elem.valueAsString
-      end
-      return results
-    end
-
-    # Versions of OpenStudio greater than 2.4.0 use a modified version of
-    # openstudio-standards with different method calls.  These methods
-    # require a "Standard" object instead of the standard being passed into method calls.
-    # This Standard object is used throughout the QAQC check.
-    if OpenStudio::VersionString.new(OpenStudio.openStudioVersion) < OpenStudio::VersionString.new('2.4.3')
-      use_old_gem_code = true
-    else
-      use_old_gem_code = false
-      std = Standard.build(target_standard)
-    end
-
-    begin
-      # loop through all space types used in the model
-      @model.getSpaceTypes.each do |space_type|
-        next if space_type.floorArea <= 0
-
-        # load in standard info for this space type
-        if use_old_gem_code
-          data = space_type.get_standards_data(target_standard)
-        else
-          data = std.space_type_get_standards_data(space_type)
-        end
-
-        if data.nil? || data.empty?
-
-          # skip if all spaces using this space type are plenums
-          all_spaces_plenums = true
-          space_type.spaces.each do |space|
-            if use_old_gem_code
-              if !space.plenum?
-                all_spaces_plenums = false
-                next
-              end
-            else
-              if !std.space_plenum?(space)
-                all_spaces_plenums = false
-                next
-              end
-            end
-          end
-
-          if !all_spaces_plenums
-            check_elems << OpenStudio::Attribute.new('flag', "Unexpected standards type for #{space_type.name}, can't validate schedules.")
-          end
-
-          next
-        end
-
-        # temp model to hold schedules to check
-        model_temp = OpenStudio::Model::Model.new
-
-        # check lighting schedules
-        data['lighting_per_area'].nil? ? (target_ip = 0.0) : (target_ip = data['lighting_per_area'])
-        if target_ip.to_f > 0
-          if use_old_gem_code
-            schedule_target = model_temp.add_schedule(data['lighting_schedule'])
-          else
-            schedule_target = std.model_add_schedule(model_temp, data['lighting_schedule'])
-          end
-          if !schedule_target
-            check_elems << OpenStudio::Attribute.new('flag', "Didn't find schedule named #{data['lighting_schedule']} in standards json.")
-          else
-            # loop through and test individual load instances
-            if use_old_gem_code
-              target_hrs = schedule_target.annual_equivalent_full_load_hrs
-            else
-              target_hrs = std.schedule_ruleset_annual_equivalent_full_load_hrs(schedule_target)
-            end
-            space_type.lights.each do |load_inst|
-              inst_sch_check = generate_load_insc_sch_check_attribute(target_hrs, load_inst, space_type, check_elems, min_pass, max_pass)
-              if inst_sch_check then check_elems << inst_sch_check end
-            end
-
-          end
-        end
-
-        # check electric equipment schedules
-        data['electric_equipment_per_area'].nil? ? (target_ip = 0.0) : (target_ip = data['electric_equipment_per_area'])
-        if target_ip.to_f > 0
-          if use_old_gem_code
-            schedule_target = model_temp.add_schedule(data['electric_equipment_schedule'])
-          else
-            schedule_target = std.model_add_schedule(model_temp, data['electric_equipment_schedule'])
-          end
-          if !schedule_target
-            check_elems << OpenStudio::Attribute.new('flag', "Didn't find schedule named #{data['electric_equipment_schedule']} in standards json.")
-          else
-            # loop through and test individual load instances
-            if use_old_gem_code
-              target_hrs = schedule_target.annual_equivalent_full_load_hrs
-            else
-              target_hrs = std.schedule_ruleset_annual_equivalent_full_load_hrs(schedule_target)
-            end
-
-            space_type.electricEquipment.each do |load_inst|
-              inst_sch_check = generate_load_insc_sch_check_attribute(target_hrs, load_inst, space_type, check_elems, min_pass, max_pass)
-              if inst_sch_check then check_elems << inst_sch_check end
-            end
-          end
-        end
-
-        # check gas equipment schedules
-        # todo - update measure test to with space type to check this
-        data['gas_equipment_per_area'].nil? ? (target_ip = 0.0) : (target_ip = data['gas_equipment_per_area'])
-        if target_ip.to_f > 0
-          if use_old_gem_code
-            schedule_target = model_temp.add_schedule(data['gas_equipment_schedule'])
-          else
-            schedule_target = std.model_add_schedule(model_temp, data['gas_equipment_schedule'])
-          end
-          if !schedule_target
-            check_elems << OpenStudio::Attribute.new('flag', "Didn't find schedule named #{data['gas_equipment_schedule']} in standards json.")
-          else
-            # loop through and test individual load instances
-            if use_old_gem_code
-              target_hrs = schedule_target.annual_equivalent_full_load_hrs
-            else
-              target_hrs = std.schedule_ruleset_annual_equivalent_full_load_hrs(schedule_target)
-            end
-            space_type.gasEquipment.each do |load_inst|
-              inst_sch_check = generate_load_insc_sch_check_attribute(target_hrs, load_inst, space_type, check_elems, min_pass, max_pass)
-              if inst_sch_check then check_elems << inst_sch_check end
-            end
-          end
-        end
-
-        # check occupancy schedules
-        data['occupancy_per_area'].nil? ? (target_ip = 0.0) : (target_ip = data['occupancy_per_area'])
-        if target_ip.to_f > 0
-          if use_old_gem_code
-            schedule_target = model_temp.add_schedule(data['occupancy_schedule'])
-          else
-            schedule_target = std.model_add_schedule(model_temp, data['occupancy_schedule'])
-          end
-          if !schedule_target
-            check_elems << OpenStudio::Attribute.new('flag', "Didn't find schedule named #{data['occupancy_schedule']} in standards json.")
-          else
-            # loop through and test individual load instances
-            if use_old_gem_code
-              target_hrs = schedule_target.annual_equivalent_full_load_hrs
-            else
-              target_hrs = std.schedule_ruleset_annual_equivalent_full_load_hrs(schedule_target)
-            end
-            space_type.people.each do |load_inst|
-              inst_sch_check = generate_load_insc_sch_check_attribute(target_hrs, load_inst, space_type, check_elems, min_pass, max_pass)
-              if inst_sch_check then check_elems << inst_sch_check end
-            end
-
-          end
-        end
-
-        # TODO: - check ventilation schedules
-        # if objects are in the model should they just be always on schedule, or have a 8760 annual equiv value
-        # oa_schedule should not exist, or if it does shoudl be always on or have 8760 annual equiv value
-        if space_type.designSpecificationOutdoorAir.is_initialized
-          oa = space_type.designSpecificationOutdoorAir.get
-          if oa.outdoorAirFlowRateFractionSchedule.is_initialized
-            # TODO: - update measure test to check this
-            target_hrs = 8760
-            inst_sch_check = generate_load_insc_sch_check_attribute(target_hrs, oa, space_type, check_elems, min_pass, max_pass)
-            if inst_sch_check then check_elems << inst_sch_check end
-          end
-        end
-
-        # notes
-        # current logic only looks at 8760 values and not design days
-        # when multiple instances of a type currently check every schedule by itself. In future could do weighted avg. merge
-        # not looking at infiltration schedules
-        # not looking at luminaires
-        # not looking at space loads, only loads at space type
-        # only checking schedules where standard shows non zero load value
-        # model load for space type where standards doesn't have one wont throw flag about mis-matched schedules
-      end
-
-      # warn if there are spaces in model that don't use space type unless they appear to be plenums
-      @model.getSpaces.each do |space|
-        if use_old_gem_code
-          next if space.plenum?
-        else
-          next if std.space_plenum?(space)
-        end
-        if !space.spaceType.is_initialized
-          check_elems << OpenStudio::Attribute.new('flag', "#{space.name} doesn't have a space type assigned, can't validate schedules.")
-        end
-      end
-    rescue StandardError => e
-      # brief description of ruby error
-      check_elems << OpenStudio::Attribute.new('flag', "Error prevented QAQC check from running (#{e}).")
-
-      # backtrace of ruby error for diagnostic use
-      if @error_backtrace then check_elems << OpenStudio::Attribute.new('flag', e.backtrace.join("\n").to_s) end
-    end
-
-    # add check_elms to new attribute
-    check_elem = OpenStudio::Attribute.new('check', check_elems)
-
-    return check_elem
-    # note: registerWarning and registerValue will be added for checks downstream using os_lib_reporting_qaqc.rb
-  end
-
-  # code for each load instance for different load types will pass through here
-  # will return nill or a single attribute
-  def generate_load_insc_sch_check_attribute(target_hrs, load_inst, space_type, check_elems, min_pass, max_pass)
-    # Versions of OpenStudio greater than 2.4.0 use a modified version of
-    # openstudio-standards with different method calls.  These methods
-    # require a "Standard" object instead of the standard being passed into method calls.
-    # This Standard object is used throughout the QAQC check.
-    if OpenStudio::VersionString.new(OpenStudio.openStudioVersion) < OpenStudio::VersionString.new('2.4.3')
-      use_old_gem_code = true
-    else
-      use_old_gem_code = false
-      std = Standard.build('90.1-2013')
-    end
-
-    schedule_inst = nil
-    inst_hrs = nil
-
-    # get schedule
-    if (load_inst.class.to_s == 'OpenStudio::Model::People') && load_inst.numberofPeopleSchedule.is_initialized
-      schedule_inst = load_inst.numberofPeopleSchedule.get
-    elsif (load_inst.class.to_s == 'OpenStudio::Model::DesignSpecificationOutdoorAir') && load_inst.outdoorAirFlowRateFractionSchedule.is_initialized
-      schedule_inst = load_inst.outdoorAirFlowRateFractionSchedule .get
-    elsif load_inst.schedule.is_initialized
-      schedule_inst = load_inst.schedule.get
-    else
-      return OpenStudio::Attribute.new('flag', "#{load_inst.name} in #{space_type.name} doesn't have a schedule assigned.")
-    end
-
-    # get annual equiv for model schedule
-    if schedule_inst.to_ScheduleRuleset.is_initialized
-      if use_old_gem_code
-        inst_hrs = schedule_inst.to_ScheduleRuleset.get.annual_equivalent_full_load_hrs
-      else
-        inst_hrs = std.schedule_ruleset_annual_equivalent_full_load_hrs(schedule_inst.to_ScheduleRuleset.get)
-      end
-    elsif schedule_inst.to_ScheduleConstant.is_initialized
-      if use_old_gem_code
-        inst_hrs = schedule_inst.to_ScheduleConstant.get.annual_equivalent_full_load_hrs
-      else
-        inst_hrs = std.schedule_constant_annual_equivalent_full_load_hrs(schedule_inst.to_ScheduleConstant.get)
-      end
-    else
-      return OpenStudio::Attribute.new('flag', "#{schedule_inst.name} isn't a Ruleset or Constant schedule. Can't calculate annual equivalent full load hours.")
-    end
-
-    # check instance against target
-    if inst_hrs < target_hrs * (1.0 - min_pass)
-      return OpenStudio::Attribute.new('flag', "#{inst_hrs.round} annual equivalent full load hours for #{schedule_inst.name} in #{space_type.name} is more than #{min_pass * 100} (%) below the typical value of #{target_hrs.round} hours from the DOE Prototype building.")
-    elsif inst_hrs > target_hrs * (1.0 + max_pass)
-      return OpenStudio::Attribute.new('flag', "#{inst_hrs.round} annual equivalent full load hours for #{schedule_inst.name} in #{space_type.name}  is more than #{max_pass * 100} (%) above the typical value of #{target_hrs.round} hours DOE Prototype building.")
-    end
-
-    # will get to this if no flag was thrown
-    return false
-  end
-end
+# *******************************************************************************
+# OpenStudio(R), Copyright (c) 2008-2019, 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_QAQC
+  # include any general notes about QAQC method here
+
+  # checks the number of unmet hours in the model
+  def check_schedules(category, target_standard, min_pass, max_pass, name_only = false)
+    # summary of the check
+    check_elems = OpenStudio::AttributeVector.new
+    check_elems << OpenStudio::Attribute.new('name', 'Schedules')
+    check_elems << OpenStudio::Attribute.new('category', category)
+    check_elems << OpenStudio::Attribute.new('description', 'Check schedules for lighting, ventilation, occupant density, plug loads, and equipment based on DOE reference building schedules in terms of full load hours per year.')
+
+    # stop here if only name is requested this is used to populate display name for arguments
+    if name_only == true
+      results = []
+      check_elems.each do |elem|
+        results << elem.valueAsString
+      end
+      return results
+    end
+
+    # Versions of OpenStudio greater than 2.4.0 use a modified version of
+    # openstudio-standards with different method calls.  These methods
+    # require a "Standard" object instead of the standard being passed into method calls.
+    # This Standard object is used throughout the QAQC check.
+    if OpenStudio::VersionString.new(OpenStudio.openStudioVersion) < OpenStudio::VersionString.new('2.4.3')
+      use_old_gem_code = true
+    else
+      use_old_gem_code = false
+      std = Standard.build(target_standard)
+    end
+
+    begin
+      # loop through all space types used in the model
+      @model.getSpaceTypes.each do |space_type|
+        next if space_type.floorArea <= 0
+
+        # load in standard info for this space type
+        if use_old_gem_code
+          data = space_type.get_standards_data(target_standard)
+        else
+          data = std.space_type_get_standards_data(space_type)
+        end
+
+        if data.nil? || data.empty?
+
+          # skip if all spaces using this space type are plenums
+          all_spaces_plenums = true
+          space_type.spaces.each do |space|
+            if use_old_gem_code
+              if !space.plenum?
+                all_spaces_plenums = false
+                next
+              end
+            else
+              if !std.space_plenum?(space)
+                all_spaces_plenums = false
+                next
+              end
+            end
+          end
+
+          if !all_spaces_plenums
+            check_elems << OpenStudio::Attribute.new('flag', "Unexpected standards type for #{space_type.name}, can't validate schedules.")
+          end
+
+          next
+        end
+
+        # temp model to hold schedules to check
+        model_temp = OpenStudio::Model::Model.new
+
+        # check lighting schedules
+        data['lighting_per_area'].nil? ? (target_ip = 0.0) : (target_ip = data['lighting_per_area'])
+        if target_ip.to_f > 0
+          if use_old_gem_code
+            schedule_target = model_temp.add_schedule(data['lighting_schedule'])
+          else
+            schedule_target = std.model_add_schedule(model_temp, data['lighting_schedule'])
+          end
+          if !schedule_target
+            check_elems << OpenStudio::Attribute.new('flag', "Didn't find schedule named #{data['lighting_schedule']} in standards json.")
+          else
+            # loop through and test individual load instances
+            if use_old_gem_code
+              target_hrs = schedule_target.annual_equivalent_full_load_hrs
+            else
+              target_hrs = std.schedule_ruleset_annual_equivalent_full_load_hrs(schedule_target)
+            end
+            space_type.lights.each do |load_inst|
+              inst_sch_check = generate_load_insc_sch_check_attribute(target_hrs, load_inst, space_type, check_elems, min_pass, max_pass)
+              if inst_sch_check then check_elems << inst_sch_check end
+            end
+
+          end
+        end
+
+        # check electric equipment schedules
+        data['electric_equipment_per_area'].nil? ? (target_ip = 0.0) : (target_ip = data['electric_equipment_per_area'])
+        if target_ip.to_f > 0
+          if use_old_gem_code
+            schedule_target = model_temp.add_schedule(data['electric_equipment_schedule'])
+          else
+            schedule_target = std.model_add_schedule(model_temp, data['electric_equipment_schedule'])
+          end
+          if !schedule_target
+            check_elems << OpenStudio::Attribute.new('flag', "Didn't find schedule named #{data['electric_equipment_schedule']} in standards json.")
+          else
+            # loop through and test individual load instances
+            if use_old_gem_code
+              target_hrs = schedule_target.annual_equivalent_full_load_hrs
+            else
+              target_hrs = std.schedule_ruleset_annual_equivalent_full_load_hrs(schedule_target)
+            end
+
+            space_type.electricEquipment.each do |load_inst|
+              inst_sch_check = generate_load_insc_sch_check_attribute(target_hrs, load_inst, space_type, check_elems, min_pass, max_pass)
+              if inst_sch_check then check_elems << inst_sch_check end
+            end
+          end
+        end
+
+        # check gas equipment schedules
+        # todo - update measure test to with space type to check this
+        data['gas_equipment_per_area'].nil? ? (target_ip = 0.0) : (target_ip = data['gas_equipment_per_area'])
+        if target_ip.to_f > 0
+          if use_old_gem_code
+            schedule_target = model_temp.add_schedule(data['gas_equipment_schedule'])
+          else
+            schedule_target = std.model_add_schedule(model_temp, data['gas_equipment_schedule'])
+          end
+          if !schedule_target
+            check_elems << OpenStudio::Attribute.new('flag', "Didn't find schedule named #{data['gas_equipment_schedule']} in standards json.")
+          else
+            # loop through and test individual load instances
+            if use_old_gem_code
+              target_hrs = schedule_target.annual_equivalent_full_load_hrs
+            else
+              target_hrs = std.schedule_ruleset_annual_equivalent_full_load_hrs(schedule_target)
+            end
+            space_type.gasEquipment.each do |load_inst|
+              inst_sch_check = generate_load_insc_sch_check_attribute(target_hrs, load_inst, space_type, check_elems, min_pass, max_pass)
+              if inst_sch_check then check_elems << inst_sch_check end
+            end
+          end
+        end
+
+        # check occupancy schedules
+        data['occupancy_per_area'].nil? ? (target_ip = 0.0) : (target_ip = data['occupancy_per_area'])
+        if target_ip.to_f > 0
+          if use_old_gem_code
+            schedule_target = model_temp.add_schedule(data['occupancy_schedule'])
+          else
+            schedule_target = std.model_add_schedule(model_temp, data['occupancy_schedule'])
+          end
+          if !schedule_target
+            check_elems << OpenStudio::Attribute.new('flag', "Didn't find schedule named #{data['occupancy_schedule']} in standards json.")
+          else
+            # loop through and test individual load instances
+            if use_old_gem_code
+              target_hrs = schedule_target.annual_equivalent_full_load_hrs
+            else
+              target_hrs = std.schedule_ruleset_annual_equivalent_full_load_hrs(schedule_target)
+            end
+            space_type.people.each do |load_inst|
+              inst_sch_check = generate_load_insc_sch_check_attribute(target_hrs, load_inst, space_type, check_elems, min_pass, max_pass)
+              if inst_sch_check then check_elems << inst_sch_check end
+            end
+
+          end
+        end
+
+        # TODO: - check ventilation schedules
+        # if objects are in the model should they just be always on schedule, or have a 8760 annual equiv value
+        # oa_schedule should not exist, or if it does shoudl be always on or have 8760 annual equiv value
+        if space_type.designSpecificationOutdoorAir.is_initialized
+          oa = space_type.designSpecificationOutdoorAir.get
+          if oa.outdoorAirFlowRateFractionSchedule.is_initialized
+            # TODO: - update measure test to check this
+            target_hrs = 8760
+            inst_sch_check = generate_load_insc_sch_check_attribute(target_hrs, oa, space_type, check_elems, min_pass, max_pass)
+            if inst_sch_check then check_elems << inst_sch_check end
+          end
+        end
+
+        # notes
+        # current logic only looks at 8760 values and not design days
+        # when multiple instances of a type currently check every schedule by itself. In future could do weighted avg. merge
+        # not looking at infiltration schedules
+        # not looking at luminaires
+        # not looking at space loads, only loads at space type
+        # only checking schedules where standard shows non zero load value
+        # model load for space type where standards doesn't have one wont throw flag about mis-matched schedules
+      end
+
+      # warn if there are spaces in model that don't use space type unless they appear to be plenums
+      @model.getSpaces.each do |space|
+        if use_old_gem_code
+          next if space.plenum?
+        else
+          next if std.space_plenum?(space)
+        end
+        if !space.spaceType.is_initialized
+          check_elems << OpenStudio::Attribute.new('flag', "#{space.name} doesn't have a space type assigned, can't validate schedules.")
+        end
+      end
+    rescue StandardError => e
+      # brief description of ruby error
+      check_elems << OpenStudio::Attribute.new('flag', "Error prevented QAQC check from running (#{e}).")
+
+      # backtrace of ruby error for diagnostic use
+      if @error_backtrace then check_elems << OpenStudio::Attribute.new('flag', e.backtrace.join("\n").to_s) end
+    end
+
+    # add check_elms to new attribute
+    check_elem = OpenStudio::Attribute.new('check', check_elems)
+
+    return check_elem
+    # note: registerWarning and registerValue will be added for checks downstream using os_lib_reporting_qaqc.rb
+  end
+
+  # code for each load instance for different load types will pass through here
+  # will return nill or a single attribute
+  def generate_load_insc_sch_check_attribute(target_hrs, load_inst, space_type, check_elems, min_pass, max_pass)
+    # Versions of OpenStudio greater than 2.4.0 use a modified version of
+    # openstudio-standards with different method calls.  These methods
+    # require a "Standard" object instead of the standard being passed into method calls.
+    # This Standard object is used throughout the QAQC check.
+    if OpenStudio::VersionString.new(OpenStudio.openStudioVersion) < OpenStudio::VersionString.new('2.4.3')
+      use_old_gem_code = true
+    else
+      use_old_gem_code = false
+      std = Standard.build('90.1-2013')
+    end
+
+    schedule_inst = nil
+    inst_hrs = nil
+
+    # get schedule
+    if (load_inst.class.to_s == 'OpenStudio::Model::People') && load_inst.numberofPeopleSchedule.is_initialized
+      schedule_inst = load_inst.numberofPeopleSchedule.get
+    elsif (load_inst.class.to_s == 'OpenStudio::Model::DesignSpecificationOutdoorAir') && load_inst.outdoorAirFlowRateFractionSchedule.is_initialized
+      schedule_inst = load_inst.outdoorAirFlowRateFractionSchedule .get
+    elsif load_inst.schedule.is_initialized
+      schedule_inst = load_inst.schedule.get
+    else
+      return OpenStudio::Attribute.new('flag', "#{load_inst.name} in #{space_type.name} doesn't have a schedule assigned.")
+    end
+
+    # get annual equiv for model schedule
+    if schedule_inst.to_ScheduleRuleset.is_initialized
+      if use_old_gem_code
+        inst_hrs = schedule_inst.to_ScheduleRuleset.get.annual_equivalent_full_load_hrs
+      else
+        inst_hrs = std.schedule_ruleset_annual_equivalent_full_load_hrs(schedule_inst.to_ScheduleRuleset.get)
+      end
+    elsif schedule_inst.to_ScheduleConstant.is_initialized
+      if use_old_gem_code
+        inst_hrs = schedule_inst.to_ScheduleConstant.get.annual_equivalent_full_load_hrs
+      else
+        inst_hrs = std.schedule_constant_annual_equivalent_full_load_hrs(schedule_inst.to_ScheduleConstant.get)
+      end
+    else
+      return OpenStudio::Attribute.new('flag', "#{schedule_inst.name} isn't a Ruleset or Constant schedule. Can't calculate annual equivalent full load hours.")
+    end
+
+    # check instance against target
+    if inst_hrs < target_hrs * (1.0 - min_pass)
+      return OpenStudio::Attribute.new('flag', "#{inst_hrs.round} annual equivalent full load hours for #{schedule_inst.name} in #{space_type.name} is more than #{min_pass * 100} (%) below the typical value of #{target_hrs.round} hours from the DOE Prototype building.")
+    elsif inst_hrs > target_hrs * (1.0 + max_pass)
+      return OpenStudio::Attribute.new('flag', "#{inst_hrs.round} annual equivalent full load hours for #{schedule_inst.name} in #{space_type.name}  is more than #{max_pass * 100} (%) above the typical value of #{target_hrs.round} hours DOE Prototype building.")
+    end
+
+    # will get to this if no flag was thrown
+    return false
+  end
+end