openstudio-standards 0.1.9 → 0.1.10

data/lib/openstudio-standards/prototypes/Prototype.secondary_school.rb

@@ -1,7 +1,8 @@
 
-# Extend the class to add Secondary School specific stuff
-class OpenStudio::Model::Model
-  def define_space_type_map(building_type, template, climate_zone)
+# Modules for building-type specific methods
+module PrototypeBuilding
+module SecondarySchool
+  def self.define_space_type_map(building_type, template, climate_zone)
     space_type_map = nil
 
     case template
@@ -25,7 +26,7 @@ class OpenStudio::Model::Model
       space_type_map = {
         'Audience - auditorium' => ['Auditorium_ZN_1_FLR_1'],
         'Gym - play' => ['Aux_Gym_ZN_1_FLR_1', 'Gym_ZN_1_FLR_1'],
-        'Washroom' => ['Bathrooms_ZN_1_FLR_1', 'Bathrooms_ZN_1_FLR_2'],
+        "Washroom-sch-#{sch}" => ['Bathrooms_ZN_1_FLR_1', 'Bathrooms_ZN_1_FLR_2'],
         'Conf./meet./multi-purpose' => ['Cafeteria_ZN_1_FLR_1'],
         'Classroom/lecture/training' => ['Corner_Class_1_Pod_1_ZN_1_FLR_1', 'Corner_Class_1_Pod_1_ZN_1_FLR_2', 'Corner_Class_1_Pod_2_ZN_1_FLR_1', 'Corner_Class_1_Pod_2_ZN_1_FLR_2', 'Corner_Class_1_Pod_3_ZN_1_FLR_1', 'Corner_Class_1_Pod_3_ZN_1_FLR_2', 'Corner_Class_2_Pod_1_ZN_1_FLR_1', 'Corner_Class_2_Pod_1_ZN_1_FLR_2', 'Corner_Class_2_Pod_2_ZN_1_FLR_1', 'Corner_Class_2_Pod_2_ZN_1_FLR_2', 'Corner_Class_2_Pod_3_ZN_1_FLR_1', 'Corner_Class_2_Pod_3_ZN_1_FLR_2', 'Mult_Class_1_Pod_1_ZN_1_FLR_1', 'Mult_Class_1_Pod_1_ZN_1_FLR_2', 'Mult_Class_1_Pod_2_ZN_1_FLR_1', 'Mult_Class_1_Pod_2_ZN_1_FLR_2', 'Mult_Class_1_Pod_3_ZN_1_FLR_1', 'Mult_Class_1_Pod_3_ZN_1_FLR_2', 'Mult_Class_2_Pod_1_ZN_1_FLR_1', 'Mult_Class_2_Pod_1_ZN_1_FLR_2', 'Mult_Class_2_Pod_2_ZN_1_FLR_1', 'Mult_Class_2_Pod_2_ZN_1_FLR_2', 'Mult_Class_2_Pod_3_ZN_1_FLR_1', 'Mult_Class_2_Pod_3_ZN_1_FLR_2'],
         "Corr. >= 2.4m wide-sch-#{sch}" => ['Corridor_Pod_1_ZN_1_FLR_1', 'Corridor_Pod_1_ZN_1_FLR_2', 'Corridor_Pod_2_ZN_1_FLR_1', 'Corridor_Pod_2_ZN_1_FLR_2', 'Corridor_Pod_3_ZN_1_FLR_1', 'Corridor_Pod_3_ZN_1_FLR_2', 'Main_Corridor_ZN_1_FLR_1', 'Main_Corridor_ZN_1_FLR_2'],
@@ -54,7 +55,7 @@ class OpenStudio::Model::Model
     return space_type_map
   end
 
-  def define_hvac_system_map(building_type, template, climate_zone)
+  def self.define_hvac_system_map(building_type, template, climate_zone)
     system_to_space_map = nil
 
     case template
@@ -337,12 +338,12 @@ class OpenStudio::Model::Model
     return system_to_space_map
   end
 
-  def custom_hvac_tweaks(building_type, template, climate_zone, prototype_input)
+  def self.custom_hvac_tweaks(building_type, template, climate_zone, prototype_input, model)
     OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Model', 'Started building type specific adjustments')
 
-    getSpaces.each do |space|
+    model.getSpaces.each do |space|
       if space.name.get.to_s == 'Mech_ZN_1_FLR_1'
-        add_elevator(template,
+        model.add_elevator(template,
                      space,
                      prototype_input['number_of_elevators'],
                      prototype_input['elevator_type'],
@@ -358,7 +359,8 @@ class OpenStudio::Model::Model
     return true
   end
 
-  def custom_swh_tweaks(building_type, template, climate_zone, prototype_input)
+  def self.custom_swh_tweaks(building_type, template, climate_zone, prototype_input, model)
     return true
   end
 end
+end

data/lib/openstudio-standards/prototypes/Prototype.small_hotel.rb

@@ -1,7 +1,8 @@
 
-# Extend the class to add Small Hotel specific stuff
-class OpenStudio::Model::Model
-  def define_space_type_map(building_type, template, climate_zone)
+# Modules for building-type specific methods
+module PrototypeBuilding
+module SmallHotel
+  def self.define_space_type_map(building_type, template, climate_zone)
     space_type_map = nil
 
     case template
@@ -90,7 +91,7 @@ class OpenStudio::Model::Model
     return space_type_map
   end
 
-  def define_hvac_system_map(building_type, template, climate_zone)
+  def self.define_hvac_system_map(building_type, template, climate_zone)
     system_to_space_map = nil
 
     case template
@@ -469,7 +470,7 @@ class OpenStudio::Model::Model
     return system_to_space_map
   end
 
-  def define_building_story_map(building_type, template, climate_zone)
+  def self.define_building_story_map(building_type, template, climate_zone)
     building_story_map = nil
 
     building_story_map = {
@@ -486,14 +487,14 @@ class OpenStudio::Model::Model
     return building_story_map
   end
 
-  def custom_hvac_tweaks(building_type, template, climate_zone, prototype_input)
+  def self.custom_hvac_tweaks(building_type, template, climate_zone, prototype_input, model)
     OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Model', 'Started building type specific adjustments')
 
     # add extra infiltration for corridor1 door
-    corridor_space = getSpaceByName('CorridorFlr1')
+    corridor_space = model.getSpaceByName('CorridorFlr1')
     corridor_space = corridor_space.get
     unless template == 'DOE Ref 1980-2004' || template == 'DOE Ref Pre-1980'
-      infiltration_corridor = OpenStudio::Model::SpaceInfiltrationDesignFlowRate.new(self)
+      infiltration_corridor = OpenStudio::Model::SpaceInfiltrationDesignFlowRate.new(model)
       infiltration_corridor.setName('Corridor1 door Infiltration')
       infiltration_per_zone = 0
       infiltration_per_zone = if template == '90.1-2010' || template == '90.1-2007'
@@ -502,13 +503,13 @@ class OpenStudio::Model::Model
                                 0.91557718
                               end
       infiltration_corridor.setDesignFlowRate(infiltration_per_zone)
-      infiltration_corridor.setSchedule(add_schedule('HotelSmall INFIL_Door_Opening_SCH'))
+      infiltration_corridor.setSchedule(model.add_schedule('HotelSmall INFIL_Door_Opening_SCH'))
       infiltration_corridor.setSpace(corridor_space)
     end
 
     # hardsize corridor1. put in standards in the future  #TODO
     unless template == 'DOE Ref 1980-2004' || template == 'DOE Ref Pre-1980'
-      getZoneHVACPackagedTerminalAirConditioners.sort.each do |ptac|
+      model.getZoneHVACPackagedTerminalAirConditioners.sort.each do |ptac|
         zone = ptac.thermalZone.get
         if zone.spaces.include?(corridor_space)
           ptac.setSupplyAirFlowRateDuringCoolingOperation(0.13)
@@ -528,7 +529,8 @@ class OpenStudio::Model::Model
     return true
   end
 
-  def custom_swh_tweaks(building_type, template, climate_zone, prototype_input)
+  def self.custom_swh_tweaks(building_type, template, climate_zone, prototype_input, model)
     return true
   end
 end
+end

data/lib/openstudio-standards/prototypes/Prototype.small_office.rb

@@ -1,7 +1,8 @@
 
 # Extend the class to add Small Office specific stuff
-class OpenStudio::Model::Model
-  def define_space_type_map(building_type, template, climate_zone)
+module PrototypeBuilding
+module SmallOffice
+  def self.define_space_type_map(building_type, template, climate_zone)
     space_type_map = nil
 
     space_type_map = case template
@@ -20,7 +21,7 @@ class OpenStudio::Model::Model
     return space_type_map
   end
 
-  def define_hvac_system_map(building_type, template, climate_zone)
+  def self.define_hvac_system_map(building_type, template, climate_zone)
     system_to_space_map = [
       {
         'type' => 'PSZ-AC',
@@ -67,11 +68,12 @@ class OpenStudio::Model::Model
     return system_to_space_map
   end
 
-  def custom_hvac_tweaks(building_type, template, climate_zone, prototype_input)
+  def self.custom_hvac_tweaks(building_type, template, climate_zone, prototype_input, model)
     return true
   end
 
-  def custom_swh_tweaks(building_type, template, climate_zone, prototype_input)
+  def self.custom_swh_tweaks(building_type, template, climate_zone, prototype_input, model)
     return true
   end
 end
+end

data/lib/openstudio-standards/prototypes/Prototype.utilities.rb

@@ -145,14 +145,8 @@ end
 # @param [Double] COP
 # @return [Double] Seasonal Energy Efficiency Ratio
 def cop_to_seer(cop)
-  seer = nil
-
-  # First convert COP to EER
-  eer = cop_to_eer(cop)
-
-  # Next convert from EER to SEER
-  delta = 1.1088**2 - 4.0 * 0.0182 * eer
-  seer = (-delta**0.5 + 1.1088) / (2.0 * 0.0182)
+  delta = 0.3796**2 - 4.0 * 0.0076 * cop
+  seer = (-delta**0.5 + 0.3796) / (2.0 * 0.0076)
 
   return seer
 end
@@ -202,14 +196,25 @@ end
 #
 # @param [Double] COP
 # @return [Double] Energy Efficiency Ratio (EER)
-def cop_to_eer(cop)
+def cop_to_eer(cop, capacity_w = nil)
   eer = nil
 
-  # r is the ratio of supply fan power to total equipment power at the rating condition,
-  # assumed to be 0.12 for the reference buildngs per PNNL.
-  r = 0.12
+  if capacity_w.nil?
+    # The PNNL Method.
+    # r is the ratio of supply fan power to total equipment power at the rating condition,
+    # assumed to be 0.12 for the reference buildngs per PNNL.
+    r = 0.12
+
+    eer = 3.413 * (cop * (1 - r) - r)
 
-  eer = 3.413 * (cop * (1 - r) - r)
+  else
+
+    # The 90.1-2013 method
+
+    # Convert the capacity to Btu/hr
+    capacity_btu_per_hr = OpenStudio.convert(capacity_w, 'W', 'Btu/hr').get
+    eer = cop / (7.84E-8 * capacity_btu_per_hr + 0.338)
+  end
 
   return eer
 end

data/lib/openstudio-standards/prototypes/Prototype.warehouse.rb

@@ -1,7 +1,8 @@
 
-# Extend the class to add Medium Office specific stuff
-class OpenStudio::Model::Model
-  def define_space_type_map(building_type, template, climate_zone)
+# Modules for building-type specific methods
+module PrototypeBuilding
+module Warehouse
+  def self.define_space_type_map(building_type, template, climate_zone)
     space_type_map = nil
 
     space_type_map = case template
@@ -23,7 +24,7 @@ class OpenStudio::Model::Model
     return space_type_map
   end
 
-  def define_hvac_system_map(building_type, template, climate_zone)
+  def self.define_hvac_system_map(building_type, template, climate_zone)
     case template
     when 'DOE Ref Pre-1980', 'DOE Ref 1980-2004'
       system_to_space_map = [
@@ -90,23 +91,24 @@ class OpenStudio::Model::Model
     return system_to_space_map
   end
 
-  def custom_hvac_tweaks(building_type, template, climate_zone, prototype_input)
+  def self.custom_hvac_tweaks(building_type, template, climate_zone, prototype_input, model)
     return true
   end
 
-  def update_waterheater_loss_coefficient(template)
+  def self.update_waterheater_loss_coefficient(template, model)
     case template
     when '90.1-2004', '90.1-2007', '90.1-2010', '90.1-2013', 'NECB 2011'
-      getWaterHeaterMixeds.sort.each do |water_heater|
+      model.getWaterHeaterMixeds.sort.each do |water_heater|
         water_heater.setOffCycleLossCoefficienttoAmbientTemperature(0.798542707)
         water_heater.setOnCycleLossCoefficienttoAmbientTemperature(0.798542707)
       end
     end
   end
 
-  def custom_swh_tweaks(building_type, template, climate_zone, prototype_input)
-    update_waterheater_loss_coefficient(template)
+  def self.custom_swh_tweaks(building_type, template, climate_zone, prototype_input, model)
+    PrototypeBuilding::Warehouse.update_waterheater_loss_coefficient(template, model)
 
     return true
   end
 end
+end

data/lib/openstudio-standards/standards/Standards.AirLoopHVAC.rb

@@ -44,7 +44,7 @@ class OpenStudio::Model::AirLoopHVAC
   def apply_standard_controls(template, climate_zone)
     # Energy Recovery Ventilation
     if energy_recovery_ventilator_required?(template, climate_zone)
-      apply_energy_recovery_ventilator
+      apply_energy_recovery_ventilator(template)
     end
 
     # Economizers
@@ -1787,7 +1787,7 @@ class OpenStudio::Model::AirLoopHVAC
   # @param (see #economizer_required?)
   # @return [Bool] Returns true if required, false if not.
   # @todo Add exception logic for systems serving parking garage, warehouse, or multifamily
-  def apply_energy_recovery_ventilator
+  def apply_energy_recovery_ventilator(template)
     # Get the oa system
     oa_system = nil
     if airLoopHVACOutdoorAirSystem.is_initialized
@@ -1800,14 +1800,25 @@ class OpenStudio::Model::AirLoopHVAC
     # Create an ERV
     erv = OpenStudio::Model::HeatExchangerAirToAirSensibleAndLatent.new(model)
     erv.setName("#{name} ERV")
-    erv.setSensibleEffectivenessat100HeatingAirFlow(0.7)
-    erv.setLatentEffectivenessat100HeatingAirFlow(0.6)
-    erv.setSensibleEffectivenessat75HeatingAirFlow(0.7)
-    erv.setLatentEffectivenessat75HeatingAirFlow(0.6)
-    erv.setSensibleEffectivenessat100CoolingAirFlow(0.75)
-    erv.setLatentEffectivenessat100CoolingAirFlow(0.6)
-    erv.setSensibleEffectivenessat75CoolingAirFlow(0.75)
-    erv.setLatentEffectivenessat75CoolingAirFlow(0.6)
+    if template == 'NECB 2011'
+      erv.setSensibleEffectivenessat100HeatingAirFlow(0.5)
+      erv.setLatentEffectivenessat100HeatingAirFlow(0.5)
+      erv.setSensibleEffectivenessat75HeatingAirFlow(0.5)
+      erv.setLatentEffectivenessat75HeatingAirFlow(0.5)
+      erv.setSensibleEffectivenessat100CoolingAirFlow(0.5)
+      erv.setLatentEffectivenessat100CoolingAirFlow(0.5)
+      erv.setSensibleEffectivenessat75CoolingAirFlow(0.5)
+      erv.setLatentEffectivenessat75CoolingAirFlow(0.5)
+    else
+      erv.setSensibleEffectivenessat100HeatingAirFlow(0.7)
+      erv.setLatentEffectivenessat100HeatingAirFlow(0.6)
+      erv.setSensibleEffectivenessat75HeatingAirFlow(0.7)
+      erv.setLatentEffectivenessat75HeatingAirFlow(0.6)
+      erv.setSensibleEffectivenessat100CoolingAirFlow(0.75)
+      erv.setLatentEffectivenessat100CoolingAirFlow(0.6)
+      erv.setSensibleEffectivenessat75CoolingAirFlow(0.75)
+      erv.setLatentEffectivenessat75CoolingAirFlow(0.6)
+    end
     erv.setSupplyAirOutletTemperatureControl(true)
     erv.setHeatExchangerType('Rotary')
     erv.setFrostControlType('ExhaustOnly')
@@ -2599,9 +2610,9 @@ class OpenStudio::Model::AirLoopHVAC
   def apply_vav_damper_action(template)
     damper_action = nil
     case template
-    when 'DOE Ref Pre-1980', 'DOE Ref 1980-2004', '90.1-2004', 'NECB 2011'
+    when 'DOE Ref Pre-1980', 'DOE Ref 1980-2004', '90.1-2004'
       damper_action = 'Single Maximum'
-    when '90.1-2007', '90.1-2010', '90.1-2013'
+    when '90.1-2007', '90.1-2010', '90.1-2013', 'NECB 2011'
       damper_action = 'Dual Maximum'
     end
 

data/lib/openstudio-standards/standards/Standards.Fan.rb

@@ -73,10 +73,10 @@ module Fan
     # Get design supply air flow rate (whether autosized or hard-sized)
     dsn_air_flow_m3_per_s = 0
     dsn_air_flow_m3_per_s = if to_FanZoneExhaust.empty?
-                              if autosizedMaximumFlowRate.is_initialized
-                                autosizedMaximumFlowRate.get
-                              else
+                              if maximumFlowRate.is_initialized
                                 maximumFlowRate.get
+                              else
+                                autosizedMaximumFlowRate.get
                               end
                             else
                               maximumFlowRate.get
@@ -190,7 +190,7 @@ module Fan
     # TODO check COMNET and T24 ACM and PNNL 90.1 doc
     fan_impeller_eff = 0.65
 
-    if small_fan?
+    if small_fan? && template != 'NECB 2011'
       fan_impeller_eff = 0.55
     end
 
@@ -225,6 +225,7 @@ module Fan
     # Assuming all fan motors are 4-pole ODP
     template_mod = template.dup
     if template == 'NECB 2011'
+
       if self.class.name == 'OpenStudio::Model::FanConstantVolume'
         template_mod += '-CONSTANT'
       elsif self.class.name == 'OpenStudio::Model::FanVariableVolume'
@@ -247,6 +248,8 @@ module Fan
         setFanPowerCoefficient2(power_vs_flow_curve.coefficient2x)
         setFanPowerCoefficient3(power_vs_flow_curve.coefficient3xPOW2)
         setFanPowerCoefficient4(power_vs_flow_curve.coefficient4xPOW3)
+      else
+        raise("")
       end
     end
 

data/lib/openstudio-standards/standards/Standards.Model.rb

@@ -156,7 +156,7 @@ class OpenStudio::Model::Model
     # Run a sizing run to calculate VLT for layer-by-layer windows.
     # Only necessary for 90.1-2010 daylighting control determination.
     if template == '90.1-2010'
-      if runSizingRun("#{sizing_run_dir}/SizingRunVLT") == false
+      if runSizingRun("#{sizing_run_dir}/SRVLT") == false
         return false
       end
     end
@@ -249,7 +249,7 @@ class OpenStudio::Model::Model
     apply_prm_sizing_parameters    
 
     # Run sizing run with the HVAC equipment
-    if runSizingRun("#{sizing_run_dir}/SizingRun1") == false
+    if runSizingRun("#{sizing_run_dir}/SR1") == false
       return false
     end
 
@@ -286,7 +286,7 @@ class OpenStudio::Model::Model
 
     # Run sizing run with the new chillers, boilers, and
     # cooling towers to determine capacities
-    if runSizingRun("#{sizing_run_dir}/SizingRun2") == false
+    if runSizingRun("#{sizing_run_dir}/SR2") == false
       return false
     end
 
@@ -3899,7 +3899,7 @@ class OpenStudio::Model::Model
           surface.subSurfaces.sort.each do |ss|
             # Reduce the size of the subsurface
             red = 1.0 - mult
-            ss.reduce_area_by_percent_by_shrinking_x(red)
+            ss.reduce_area_by_percent_by_shrinking_toward_centroid(red)
           end
         end
       end

data/lib/openstudio-standards/standards/Standards.WaterHeaterMixed.rb

@@ -96,7 +96,7 @@ class OpenStudio::Model::WaterHeaterMixed
 
       when 'NECB 2011'
         volume_l_per_s = volume_m3 * 1000
-        if capacity_btu_per_hr <= OpenStudio.convert(12, 'kW', 'Btu/hr')
+        if capacity_btu_per_hr <= OpenStudio.convert(12, 'kW', 'Btu/hr').get
           # Fixed water heater efficiency per PNNL
           water_heater_eff = 1
           # Calculate the max allowable standby loss (SL)
@@ -129,7 +129,7 @@ class OpenStudio::Model::WaterHeaterMixed
           base_ef, vol_drt = case template
                              when '90.1-2004', '90.1-2007'
                                [0.62, 0.0019]
-                             when '90.1-2010'
+                             when '90.1-2010', 'NECB 2011'
                                [0.67, 0.0019]
                              when '90.1-2013'
                                [0.67, 0.0005]
@@ -152,12 +152,11 @@ class OpenStudio::Model::WaterHeaterMixed
           et = 0.8
           # Calculate the max allowable standby loss (SL)
           cap_adj, vol_drt = case template
-                   when '90.1-2004', '90.1-2007', '90.1-2010'
+                   when '90.1-2004', '90.1-2007', '90.1-2010', 'NECB 2011'
                      [800, 110]
                    when '90.1-2013'
                      [799, 16.6]
                    end
-
           sl_btu_per_hr = (capacity_btu_per_hr / cap_adj + vol_drt * Math.sqrt(volume_gal))
           # Calculate the skin loss coefficient (UA)
           ua_btu_per_hr_per_f = (sl_btu_per_hr * et) / 70
@@ -186,6 +185,12 @@ class OpenStudio::Model::WaterHeaterMixed
     # self.setOffCycleParasiticFuelConsumptionRate(??)
     setOffCycleParasiticHeatFractiontoTank(0.8)
 
+    # set part-load performance curve
+    if template == 'NECB 2011' && fuel_type == 'NaturalGas'
+      plf_vs_plr_curve = model.add_curve('SWH-EFFFPLR-NECB2011')
+      setPartLoadFactorCurve(plf_vs_plr_curve)
+    end
+
     # Append the name with standards information
     setName("#{name} #{water_heater_eff.round(3)} Therm Eff")
     OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.WaterHeaterMixed', "For #{template}: #{name}; thermal efficiency = #{water_heater_eff.round(3)}, skin-loss UA = #{ua_btu_per_hr_per_f.round}Btu/hr")

data/lib/openstudio-standards/utilities/simulation.rb

@@ -82,7 +82,12 @@ class OpenStudio::Model::Model
       OpenStudio.logFree(OpenStudio::Debug, 'openstudio.model.Model', 'Running with OS 2.x WorkflowJSON.')
 
       # Copy the weather file to this directory
-      FileUtils.copy(epw_path.to_s, run_dir)
+      begin
+        FileUtils.copy(epw_path.to_s, "#{run_dir}/in.epw")
+      rescue
+        OpenStudio.logFree(OpenStudio::Error, 'openstudio.model.Model', "Due to limitations on Windows file path lengths, this measure won't work unless your project is located in a directory whose filepath is less than 90 characters long, including slashes.")
+        return false
+      end
 
       workflow.setSeedFile(File.absolute_path(osm_path.to_s))
       workflow.setWeatherFile(epw_path)