openstudio-standards 0.2.10 → 0.2.11.rc1

data/lib/openstudio-standards/hvac_sizing/Siz.ControllerOutdoorAir.rb

@@ -44,12 +44,12 @@ class OpenStudio::Model::ControllerOutdoorAir
 
     # Get the airloop connected to this controller
     if airLoopHVACOutdoorAirSystem.empty?
-      OpenStudio.logFree(OpenStudio::Warn, 'openstudio.Siz.ControllerOutdoorAir', "#{name} is not connected to an airLoopHVACOutdoorAirSystem, cannot determine autosizedMinimumOutdoorAirFlowRate accuractely.")
+      OpenStudio.logFree(OpenStudio::Warn, 'openstudio.Siz.ControllerOutdoorAir', "#{name} is not connected to an airLoopHVACOutdoorAirSystem, cannot determine autosizedMinimumOutdoorAirFlowRate accurately.")
       return oa
     end
     oa_sys = airLoopHVACOutdoorAirSystem.get
     if oa_sys.airLoop.empty?
-      OpenStudio.logFree(OpenStudio::Warn, 'openstudio.Siz.ControllerOutdoorAir', "#{name}'s airLoopHVACOutdoorAirSystem is not assigned to an AirLoop, cannot determine autosizedMinimumOutdoorAirFlowRate accuractely.")
+      OpenStudio.logFree(OpenStudio::Warn, 'openstudio.Siz.ControllerOutdoorAir', "#{name}'s airLoopHVACOutdoorAirSystem is not assigned to an AirLoop, cannot determine autosizedMinimumOutdoorAirFlowRate accurately.")
       return oa
     end
     air_loop = oa_sys.airLoop.get

data/lib/openstudio-standards/prototypes/ashrae_90_1/ashrae_90_1_2004/ashrae_90_1_2004.AirTerminalSingleDuctVAVReheat.rb

@@ -9,14 +9,6 @@ class ASHRAE9012004 < ASHRAE901
   def air_terminal_single_duct_vav_reheat_apply_initial_prototype_damper_position(air_terminal_single_duct_vav_reheat, zone_oa_per_area)
     min_damper_position = 0.3
 
-    # High OA zones
-    # Determine whether or not to use the high minimum guess.
-    # Cutoff was determined by correlating apparent minimum guesses
-    # to OA rates in prototypes since not well documented in papers.
-    if zone_oa_per_area > 0.001 # 0.001 m^3/s*m^2 = .196 cfm/ft2
-      min_damper_position = 0.7
-    end
-
     # Set the minimum flow fraction
     air_terminal_single_duct_vav_reheat.setConstantMinimumAirFlowFraction(min_damper_position)
 

data/lib/openstudio-standards/prototypes/ashrae_90_1/ashrae_90_1_2007/ashrae_90_1_2007.AirTerminalSingleDuctVAVReheat.rb

@@ -9,14 +9,6 @@ class ASHRAE9012007 < ASHRAE901
   def air_terminal_single_duct_vav_reheat_apply_initial_prototype_damper_position(air_terminal_single_duct_vav_reheat, zone_oa_per_area)
     min_damper_position = 0.3
 
-    # High OA zones
-    # Determine whether or not to use the high minimum guess.
-    # Cutoff was determined by correlating apparent minimum guesses
-    # to OA rates in prototypes since not well documented in papers.
-    if zone_oa_per_area > 0.001 # 0.001 m^3/s*m^2 = .196 cfm/ft2
-      min_damper_position = 0.7
-    end
-
     # Set the minimum flow fraction
     air_terminal_single_duct_vav_reheat.setConstantMinimumAirFlowFraction(min_damper_position)
 

data/lib/openstudio-standards/prototypes/ashrae_90_1/ashrae_90_1_2010/ashrae_90_1_2010.AirTerminalSingleDuctVAVReheat.rb

@@ -14,14 +14,6 @@ class ASHRAE9012010 < ASHRAE901
                             0.3
                           end
 
-    # High OA zones
-    # Determine whether or not to use the high minimum guess.
-    # Cutoff was determined by correlating apparent minimum guesses
-    # to OA rates in prototypes since not well documented in papers.
-    if zone_oa_per_area > 0.001 # 0.001 m^3/s*m^2 = .196 cfm/ft2
-      min_damper_position = 0.7
-    end
-
     # Set the minimum flow fraction
     air_terminal_single_duct_vav_reheat.setConstantMinimumAirFlowFraction(min_damper_position)
 

data/lib/openstudio-standards/prototypes/ashrae_90_1/ashrae_90_1_2013/ashrae_90_1_2013.AirTerminalSingleDuctVAVReheat.rb

@@ -14,14 +14,6 @@ class ASHRAE9012013 < ASHRAE901
                             0.3
                           end
 
-    # High OA zones
-    # Determine whether or not to use the high minimum guess.
-    # Cutoff was determined by correlating apparent minimum guesses
-    # to OA rates in prototypes since not well documented in papers.
-    if zone_oa_per_area > 0.001 # 0.001 m^3/s*m^2 = .196 cfm/ft2
-      min_damper_position = 0.7
-    end
-
     # Set the minimum flow fraction
     air_terminal_single_duct_vav_reheat.setConstantMinimumAirFlowFraction(min_damper_position)
 

data/lib/openstudio-standards/prototypes/ashrae_90_1/nrel_nze_ready_2017/nrel_zne_ready_2017.AirTerminalSingleDuctVAVReheat.rb

@@ -7,9 +7,14 @@ class NRELZNEReady2017 < ASHRAE901
   # @param zone_oa_per_area [Double] the zone outdoor air per area, m^3/s
   # @return [Bool] returns true if successful, false if not
   def air_terminal_single_duct_vav_reheat_apply_initial_prototype_damper_position(air_terminal_single_duct_vav_reheat, zone_oa_per_area)
+    min_damper_position = case air_terminal_single_duct_vav_reheat_reheat_type(air_terminal_single_duct_vav_reheat)
+                          when 'HotWater'
+                            0.2
+                          when 'Electricity', 'NaturalGas'
+                            0.3
+                          end
 
     # Set the minimum flow fraction
-    min_damper_position = 0.1
     air_terminal_single_duct_vav_reheat.setConstantMinimumAirFlowFraction(min_damper_position)
 
     return true

data/lib/openstudio-standards/prototypes/ashrae_90_1/nrel_nze_ready_2017/nrel_zne_ready_2017.HeatExchangerAirToAirSensibleAndLatent.rb

@@ -0,0 +1,9 @@
+class NRELZNEReady2017 < ASHRAE901
+  # @!group HeatExchangerAirToAirSensibleAndLatent
+
+  # Default fan efficiency assumption for the prm added fan power
+  def heat_exchanger_air_to_air_sensible_and_latent_prototype_default_fan_efficiency
+    default_fan_efficiency  = 0.55
+    return default_fan_efficiency
+  end
+end

data/lib/openstudio-standards/prototypes/ashrae_90_1/nrel_nze_ready_2017/nrel_zne_ready_2017.Model.rb

@@ -16,10 +16,12 @@ class NRELZNEReady2017 < ASHRAE901
   # 'DifferentialDryBulbAndEnthalpy'
   def model_economizer_type(model, climate_zone)
     economizer_type = case climate_zone
-                      when 'ASHRAE 169-2006-1A',
+                      when 'ASHRAE 169-2006-0A',
+                          'ASHRAE 169-2006-1A',
                           'ASHRAE 169-2006-2A',
                           'ASHRAE 169-2006-3A',
                           'ASHRAE 169-2006-4A',
+                          'ASHRAE 169-2013-0A',
                           'ASHRAE 169-2013-1A',
                           'ASHRAE 169-2013-2A',
                           'ASHRAE 169-2013-3A',

data/lib/openstudio-standards/prototypes/ashrae_90_1/ze_aedg_multifamily/ze_aedg_multifamily.AirTerminalSingleDuctVAVReheat.rb

@@ -0,0 +1,22 @@
+class ZEAEDGMultifamily < ASHRAE901
+  # @!group AirTerminalSingleDuctVAVReheat
+  # Set the initial minimum damper position based on OA rate of the space and the template.
+  # Zones with low OA per area get lower initial guesses.
+  # Final position will be adjusted upward as necessary by Standards.AirLoopHVAC.apply_minimum_vav_damper_positions
+  #
+  # @param zone_oa_per_area [Double] the zone outdoor air per area, m^3/s
+  # @return [Bool] returns true if successful, false if not
+  def air_terminal_single_duct_vav_reheat_apply_initial_prototype_damper_position(air_terminal_single_duct_vav_reheat, zone_oa_per_area)
+    min_damper_position = case air_terminal_single_duct_vav_reheat_reheat_type(air_terminal_single_duct_vav_reheat)
+                          when 'HotWater'
+                            0.2
+                          when 'Electricity', 'NaturalGas'
+                            0.3
+                          end
+
+    # Set the minimum flow fraction
+    air_terminal_single_duct_vav_reheat.setConstantMinimumAirFlowFraction(min_damper_position)
+
+    return true
+  end
+end

data/lib/openstudio-standards/prototypes/ashrae_90_1/ze_aedg_multifamily/ze_aedg_multifamily.FanConstantVolume.rb

@@ -0,0 +1,32 @@
+class ZEAEDGMultifamily < ASHRAE901
+  # @!group FanConstantVolume
+
+  # Determine the prototype fan pressure rise for a constant volume
+  # fan on an AirLoopHVAC based on the airflow of the system.
+  # @return [Double] the pressure rise (in H2O).  Defaults
+  # to the logic from ASHRAE 90.1-2004 prototypes.
+  def fan_constant_volume_airloop_fan_pressure_rise(fan_constant_volume)
+    # Get the max flow rate from the fan.
+    maximum_flow_rate_m3_per_s = nil
+    if fan_constant_volume.maximumFlowRate.is_initialized
+      maximum_flow_rate_m3_per_s = fan_constant_volume.maximumFlowRate.get
+    elsif fan_constant_volume.autosizedMaximumFlowRate.is_initialized
+      maximum_flow_rate_m3_per_s = fan_constant_volume.autosizedMaximumFlowRate.get
+    else
+      OpenStudio.logFree(OpenStudio::Warn, 'openstudio.prototype.FanConstantVolume', "For #{fan_constant_volume.name} max flow rate is not available, cannot apply prototype assumptions.")
+      return false
+    end
+
+    # Convert max flow rate to cfm
+    maximum_flow_rate_cfm = OpenStudio.convert(maximum_flow_rate_m3_per_s, 'm^3/s', 'cfm').get
+
+    # Determine the pressure rise
+    pressure_rise_in_h2o = if maximum_flow_rate_cfm < 7437
+                             2.5
+                           else # Over 7,437 cfm
+                             4.09
+                           end
+
+    return pressure_rise_in_h2o
+  end
+end

data/lib/openstudio-standards/prototypes/ashrae_90_1/ze_aedg_multifamily/ze_aedg_multifamily.FanOnOff.rb

@@ -0,0 +1,33 @@
+class ZEAEDGMultifamily < ASHRAE901
+  # @!group FanOnOff
+
+  # Determine the prototype fan pressure rise for an on off
+  # fan on an AirLoopHVAC or inside a unitary system
+  # based on the airflow of the system.
+  # @return [Double] the pressure rise (in H2O).  Defaults
+  # to the logic from ASHRAE 90.1-2004 prototypes.
+  def fan_on_off_airloop_or_unitary_fan_pressure_rise(fan_on_off)
+    # Get the max flow rate from the fan.
+    maximum_flow_rate_m3_per_s = nil
+    if fan_on_off.maximumFlowRate.is_initialized
+      maximum_flow_rate_m3_per_s = fan_on_off.maximumFlowRate.get
+    elsif fan_on_off.autosizedMaximumFlowRate.is_initialized
+      maximum_flow_rate_m3_per_s = fan_on_off.autosizedMaximumFlowRate.get
+    else
+      OpenStudio.logFree(OpenStudio::Warn, 'openstudio.prototype.FanOnOff', "For #{fan_on_off.name} max flow rate is not available, cannot apply prototype assumptions.")
+      return false
+    end
+
+    # Convert max flow rate to cfm
+    maximum_flow_rate_cfm = OpenStudio.convert(maximum_flow_rate_m3_per_s, 'm^3/s', 'cfm').get
+
+    # Determine the pressure rise
+    pressure_rise_in_h2o = if maximum_flow_rate_cfm < 7437
+                             2.5
+                           else # Over 7,437 cfm
+                             4.09
+                           end
+
+    return pressure_rise_in_h2o
+  end
+end

data/lib/openstudio-standards/prototypes/ashrae_90_1/ze_aedg_multifamily/ze_aedg_multifamily.FanVariableVolume.rb

@@ -0,0 +1,32 @@
+class ZEAEDGMultifamily < ASHRAE901
+  # @!group FanVariableVolume
+
+  # Determine the prototype fan pressure rise for a variable volume
+  # fan on an AirLoopHVAC based on the airflow of the system.
+  # @return [Double] the pressure rise (in H2O).  Defaults
+  # to the logic from ASHRAE 90.1-2004 prototypes.
+  def fan_variable_volume_airloop_fan_pressure_rise(fan_variable_volume)
+    # Get the max flow rate from the fan.
+    maximum_flow_rate_m3_per_s = nil
+    if fan_variable_volume.maximumFlowRate.is_initialized
+      maximum_flow_rate_m3_per_s = fan_variable_volume.maximumFlowRate.get
+    elsif fan_variable_volume.autosizedMaximumFlowRate.is_initialized
+      maximum_flow_rate_m3_per_s = fan_variable_volume.autosizedMaximumFlowRate.get
+    else
+      OpenStudio.logFree(OpenStudio::Warn, 'openstudio.prototype.FanVariableVolume', "For #{fan_variable_volume.name} max flow rate is not available, cannot apply prototype assumptions.")
+      return false
+    end
+
+    # Convert max flow rate to cfm
+    maximum_flow_rate_cfm = OpenStudio.convert(maximum_flow_rate_m3_per_s, 'm^3/s', 'cfm').get
+
+    # Determine the pressure rise
+    pressure_rise_in_h2o = if maximum_flow_rate_cfm < 4648
+                             4.0
+                           else # Over 7,437 cfm
+                             5.58
+                           end
+
+    return pressure_rise_in_h2o
+  end
+end

data/lib/openstudio-standards/prototypes/ashrae_90_1/ze_aedg_multifamily/ze_aedg_multifamily.HeatExchangerAirToAirSensibleAndLatent.rb

@@ -0,0 +1,9 @@
+class ZEAEDGMultifamily < ASHRAE901
+  # @!group HeatExchangerAirToAirSensibleAndLatent
+
+  # Default fan efficiency assumption for the prm added fan power
+  def heat_exchanger_air_to_air_sensible_and_latent_prototype_default_fan_efficiency
+    default_fan_efficiency  = 0.55
+    return default_fan_efficiency
+  end
+end

data/lib/openstudio-standards/prototypes/ashrae_90_1/ze_aedg_multifamily/ze_aedg_multifamily.Model.elevators.rb

@@ -0,0 +1,25 @@
+class ZEAEDGMultifamily < ASHRAE901
+  # @!group elevators
+
+  # Determines the percentage of the elevator cab
+  # lighting that is incandescent.  The remainder
+  # is assumed to be LED.  Defaults to 0% incandescent
+  # (100% LED), representing newer elevators.
+  def model_elevator_lighting_pct_incandescent(model)
+    pct_incandescent = 0.0 # 100% LED
+    return pct_incandescent
+  end
+
+  # Determines the power of the elevator ventilation fan.
+  # Same as 90.1-2013, which has a requirement
+  # for ventilation fan efficiency.
+  # @return [Double] the ventilaton fan power (W)
+  def model_elevator_fan_pwr(model, vent_rate_cfm)
+    vent_pwr_per_flow_w_per_cfm = 0.33
+    vent_pwr_w = vent_pwr_per_flow_w_per_cfm * vent_rate_cfm
+    # addendum 90.1-2007 aj has requirement on efficiency
+    vent_pwr_w = vent_pwr_w * 0.29 / 0.70
+
+    return vent_pwr_w
+  end
+end

data/lib/openstudio-standards/prototypes/ashrae_90_1/ze_aedg_multifamily/ze_aedg_multifamily.Model.rb

@@ -0,0 +1,35 @@
+class ZEAEDGMultifamily < ASHRAE901
+  # @!group Model
+
+  # Determine the prototypical economizer type for the model.
+  #
+  # @param model [OpenStudio::Model::Model] the model
+  # @param climate_zone [String] the climate zone
+  # @return [String] the economizer type.  Possible values are:
+  # 'NoEconomizer'
+  # 'FixedDryBulb'
+  # 'FixedEnthalpy'
+  # 'DifferentialDryBulb'
+  # 'DifferentialEnthalpy'
+  # 'FixedDewPointAndDryBulb'
+  # 'ElectronicEnthalpy'
+  # 'DifferentialDryBulbAndEnthalpy'
+  def model_economizer_type(model, climate_zone)
+    economizer_type = case climate_zone
+                      when 'ASHRAE 169-2006-0A',
+                          'ASHRAE 169-2006-1A',
+                          'ASHRAE 169-2006-2A',
+                          'ASHRAE 169-2006-3A',
+                          'ASHRAE 169-2006-4A',
+                          'ASHRAE 169-2013-0A',
+                          'ASHRAE 169-2013-1A',
+                          'ASHRAE 169-2013-2A',
+                          'ASHRAE 169-2013-3A',
+                          'ASHRAE 169-2013-4A'
+                        'DifferentialEnthalpy'
+                      else
+                        'DifferentialDryBulb'
+                      end
+    return economizer_type
+  end
+end

data/lib/openstudio-standards/prototypes/ashrae_90_1/ze_aedg_multifamily/ze_aedg_multifamily.hvac_systems.rb

@@ -0,0 +1,11 @@
+class ZEAEDGMultifamily < ASHRAE901
+  # @!group hvac_systems
+
+  # Determine which type of fan the cooling tower
+  # will have.  Variable Speed Fan for NREL ZNE Ready 2017.
+  # @return [String] the fan type: TwoSpeed Fan, Variable Speed Fan
+  def model_cw_loop_cooling_tower_fan_type(model)
+    fan_type = 'Variable Speed Fan'
+    return fan_type
+  end
+end

data/lib/openstudio-standards/prototypes/common/buildings/Prototype.Hospital.rb

@@ -255,16 +255,21 @@ module Hospital
           # Cutoff was determined by correlating apparent minimum guesses
           # to OA rates in prototypes since not well documented in papers.
           zone_oa_per_area = thermal_zone_outdoor_airflow_rate_per_area(zone)
+          airlp = air_terminal.airLoopHVAC.get
           case template
           when 'DOE Ref Pre-1980', 'DOE Ref 1980-2004'
             if vav_name.include?('PatRoom') || vav_name.include?('OR') || vav_name.include?('ICU') || vav_name.include?('Lab') || vav_name.include?('ER') || vav_name.include?('Kitchen')
               air_terminal.setConstantMinimumAirFlowFraction(1.0)
             end
+          # Minimum damper position for Outpatient prototype
+          # Based on AIA 2001 ventilation requirements
+          # See Section 5.2.2.16 in Thornton et al. 2010
+          # https://www.energycodes.gov/sites/default/files/documents/BECP_Energy_Cost_Savings_STD2010_May2011_v00.pdf
           when '90.1-2004', '90.1-2007'
-            air_terminal.setConstantMinimumAirFlowFraction(1.0) if zone_oa_per_area > 0.001 # 0.001 m^3/s*m^2 = .196 cfm/ft2
+            air_terminal.setConstantMinimumAirFlowFraction(1.0) unless airlp.name.to_s.include?('VAV_1') || airlp.name.to_s.include?('VAV_2')
           when '90.1-2010', '90.1-2013'
-            air_terminal.setConstantMinimumAirFlowFraction(1.0) if zone_oa_per_area > 0.001 # 0.001 m^3/s*m^2 = .196 cfm/ft2
-            air_terminal.setConstantMinimumAirFlowFraction(0.5) if vav_name.include? "PatRoom"
+            air_terminal.setConstantMinimumAirFlowFraction(1.0) unless airlp.name.to_s.include?('VAV_1') || airlp.name.to_s.include?('VAV_2')
+            air_terminal.setConstantMinimumAirFlowFraction(0.5) if vav_name.include? 'PatRoom'
           end
         end
       end
@@ -301,4 +306,13 @@ module Hospital
 
     return true
   end
+
+  def air_terminal_single_duct_vav_reheat_apply_initial_prototype_damper_position(air_terminal_single_duct_vav_reheat, zone_oa_per_area)
+    min_damper_position = template == '90.1-2010' || template == '90.1-2013' ? 0.2 : 0.3
+
+    # Set the minimum flow fraction
+    air_terminal_single_duct_vav_reheat.setConstantMinimumAirFlowFraction(min_damper_position)
+
+    return true
+  end
 end

data/lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeHotel.rb

@@ -184,4 +184,13 @@ module LargeHotel
 
     return true
   end
+
+  def air_terminal_single_duct_vav_reheat_apply_initial_prototype_damper_position(air_terminal_single_duct_vav_reheat, zone_oa_per_area)
+    min_damper_position = template == '90.1-2010' || template == '90.1-2013' ? 0.2 : 0.3
+
+    # Set the minimum flow fraction
+    air_terminal_single_duct_vav_reheat.setConstantMinimumAirFlowFraction(min_damper_position)
+
+    return true
+  end
 end

data/lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeOffice.rb

@@ -79,4 +79,13 @@ module LargeOffice
 
     return true
   end
+
+  def air_terminal_single_duct_vav_reheat_apply_initial_prototype_damper_position(air_terminal_single_duct_vav_reheat, zone_oa_per_area)
+    min_damper_position = template == '90.1-2010' || template == '90.1-2013' ? 0.2 : 0.3
+
+    # Set the minimum flow fraction
+    air_terminal_single_duct_vav_reheat.setConstantMinimumAirFlowFraction(min_damper_position)
+
+    return true
+  end
 end

data/lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeOfficeDetailed.rb

@@ -1,4 +1,3 @@
-
 # Custom changes for the LargeOffice prototype.
 # These are changes that are inconsistent with other prototype
 # building types.
@@ -43,7 +42,8 @@ module LargeOfficeDetailed
 
     # replace EvaporativeFluidCoolerSingleSpeed with CoolingTowerTwoSpeed
     model.getPlantLoops.each do |plant_loop|
-      next unless plant_loop.name.to_s.include? "Heat Pump Loop"
+      next unless plant_loop.name.to_s.include? 'Heat Pump Loop'
+
       sup_wtr_high_temp_f = 65.0
       sup_wtr_low_temp_f = 41.0
       sup_wtr_high_temp_c = OpenStudio.convert(sup_wtr_high_temp_f, 'F', 'C').get
@@ -75,9 +75,20 @@ module LargeOfficeDetailed
       end
     end
 
+    remove_basement_infiltration(model)
+
     return true
   end
-  
+
+  def remove_basement_infiltration(model)
+    space_infltrations = model.getSpaceInfiltrationDesignFlowRates
+    space_infltrations.each do |space_inf|
+      if space_inf.name.to_s.include? 'Basement'
+        space_inf = nil
+      end
+    end
+  end
+
   def update_waterheater_loss_coefficient(model)
     case template
       when '90.1-2004', '90.1-2007', '90.1-2010', '90.1-2013', 'NECB2011'
@@ -94,6 +105,14 @@ module LargeOfficeDetailed
   end
 
   def model_custom_geometry_tweaks(building_type, climate_zone, prototype_input, model)
+    return true
+  end
+
+  def air_terminal_single_duct_vav_reheat_apply_initial_prototype_damper_position(air_terminal_single_duct_vav_reheat, zone_oa_per_area)
+    min_damper_position = template == '90.1-2010' || template == '90.1-2013' ? 0.2 : 0.3
+
+    # Set the minimum flow fraction
+    air_terminal_single_duct_vav_reheat.setConstantMinimumAirFlowFraction(min_damper_position)
 
     return true
   end