openstudio-standards 0.7.1 → 0.8.0.rc1

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

@@ -84,28 +84,55 @@ module CoolingTower
     # per method used in PNNL prototype buildings.
     # Assumes that the fan brake horsepower is 90%
     # of the fan nameplate rated motor power.
-    fan_motor_nameplate_hp = design_water_flow_gpm / min_gpm_per_hp
-    fan_bhp = 0.9 * fan_motor_nameplate_hp
-
-    # Lookup the minimum motor efficiency
+    # Source: Thornton et al. (2011), Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010, Section 4.5.4
+    nominal_hp = design_water_flow_gpm / min_gpm_per_hp
+    fan_bhp = 0.9 * nominal_hp
     fan_motor_eff = 0.85
-    motors = standards_data['motors']
 
-    # Assuming all fan motors are 4-pole Enclosed
-    search_criteria = {
-      'template' => template,
-      'number_of_poles' => 4.0,
-      'type' => 'Enclosed'
-    }
+    if nominal_hp <= 0.75
+      motor_type = motor_type(nominal_hp)
+      motor_properties = motor_fractional_hp_efficiencies(nominal_hp, motor_type = motor_type)
+    else
+      # Lookup the minimum motor efficiency
+      motors = standards_data['motors']
+
+      # Assuming all fan motors are 4-pole Enclosed
+      search_criteria = {
+        'template' => template,
+        'number_of_poles' => 4.0,
+        'type' => 'Enclosed'
+      }
+
+      # Use the efficiency largest motor efficiency when BHP is greater than the largest size for which a requirement is provided
+      data = model_find_objects(motors, search_criteria)
+      if data.empty?
+        search_criteria = {
+          'template' => template,
+          'type' => nil
+        }
+        data = model_find_objects(motors, search_criteria)
+      end
+      maximum_capacity = model_find_maximum_value(data, 'maximum_capacity')
+      if fan_bhp > maximum_capacity
+        fan_bhp = maximum_capacity
+      end
+
+      motor_properties = model_find_object(motors, search_criteria, capacity = nil, date = Date.today, area = nil, num_floors = nil, fan_motor_bhp = fan_bhp)
+
+      if motor_properties.nil?
+        # Retry without the date
+        motor_properties = model_find_object(motors, search_criteria, capacity = nil, date = nil, area = nil, num_floors = nil, fan_motor_bhp = fan_bhp)
+      end
+    end
 
-    motor_properties = model_find_object(motors, search_criteria, fan_motor_nameplate_hp)
     if motor_properties.nil?
-      OpenStudio.logFree(OpenStudio::Error, 'openstudio.standards.CoolingTower', "For #{cooling_tower.name}, could not find motor properties using search criteria: #{search_criteria}, motor_hp = #{fan_motor_nameplate_hp} hp.")
-      return false
+      OpenStudio.logFree(OpenStudio::Error, 'openstudio.standards.CoolingTower', "For #{cooling_tower.name}, could not find motor properties using search criteria: #{search_criteria}, motor_hp = #{nominal_hp} hp. Using a default value of #{fan_motor_eff}.")
     end
 
-    fan_motor_eff = motor_properties['nominal_full_load_efficiency']
-    nominal_hp = motor_properties['maximum_capacity'].to_f.round(1)
+    unless motor_properties.nil?
+      fan_motor_eff = motor_properties['nominal_full_load_efficiency']
+      nominal_hp = motor_properties['maximum_capacity'].to_f.round(1)
+    end
     # Round to nearest whole HP for niceness
     if nominal_hp >= 2
       nominal_hp = nominal_hp.round
@@ -116,7 +143,7 @@ module CoolingTower
     # Convert to W
     fan_motor_actual_power_w = fan_motor_actual_power_hp * 745.7 # 745.7 W/HP
 
-    OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.CoolingTower', "For #{cooling_tower.name}, allowed fan motor nameplate hp = #{fan_motor_nameplate_hp.round(1)} hp, fan brake horsepower = #{fan_bhp.round(1)}, and fan motor actual power = #{fan_motor_actual_power_hp.round(1)} hp (#{fan_motor_actual_power_w.round} W) at #{fan_motor_eff} motor efficiency.")
+    OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.CoolingTower', "For #{cooling_tower.name}, allowed fan motor nameplate hp = #{nominal_hp.round(1)} hp, fan brake horsepower = #{fan_bhp.round(1)}, and fan motor actual power = #{fan_motor_actual_power_hp.round(1)} hp (#{fan_motor_actual_power_w.round} W) at #{fan_motor_eff} motor efficiency.")
 
     # Append the efficiency to the name
     cooling_tower.setName("#{cooling_tower.name} #{min_gpm_per_hp.to_f.round(1)} gpm/hp")

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

@@ -231,7 +231,7 @@ module Fan
 
   # Determines the minimum fan motor efficiency and nominal size for a given motor bhp.
   # This should be the total brake horsepower with any desired safety factor already included.
-  # This method picks the next nominal motor catgory larger than the required brake horsepower,
+  # This method picks the next nominal motor category larger than the required brake horsepower,
   # and the efficiency is based on that size.
   # For example, if the bhp = 6.3, the nominal size will be 7.5HP and the efficiency
   # for 90.1-2010 will be 91.7% from Table 10.8B.
@@ -243,7 +243,12 @@ module Fan
   # @return [Array<Double>] minimum motor efficiency (0.0 to 1.0), nominal horsepower
   def fan_standard_minimum_motor_efficiency_and_size(fan, motor_bhp)
     fan_motor_eff = 0.85
-    nominal_hp = motor_bhp
+    # Calculate the allowed fan brake horsepower
+    # per method used in PNNL prototype buildings.
+    # Assumes that the fan brake horsepower is 90%
+    # of the fan nameplate rated motor power.
+    # Source: Thornton et al. (2011), Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010, Section 4.5.4
+    nominal_hp = motor_bhp * 1.1
 
     # Don't attempt to look up motor efficiency
     # for zero-hp fans, which may occur when there is no
@@ -267,34 +272,40 @@ module Fan
     # In this case, use the 0.5 HP for the lookup.
     if fan_small_fan?(fan)
       nominal_hp = 0.5
-    else
-      motor_properties = model_find_object(motors, search_criteria, motor_bhp)
+
+      # Get the efficiency based on the nominal horsepower
+      motor_type = motor_type(nominal_hp)
+      motor_properties = motor_fractional_hp_efficiencies(nominal_hp, motor_type = motor_type)
+
       if motor_properties.nil?
-        OpenStudio.logFree(OpenStudio::Error, 'openstudio.standards.Fan', "For #{fan.name}, could not find motor properties using search criteria: #{search_criteria}, motor_bhp = #{motor_bhp} hp.")
+        OpenStudio.logFree(OpenStudio::Error, 'openstudio.standards.Fan', "For #{fan.name}, could not find nominal motor properties using search criteria: #{search_criteria}, motor_hp = #{nominal_hp} hp.")
         return [fan_motor_eff, nominal_hp]
       end
-
-      nominal_hp = motor_properties['maximum_capacity'].to_f.round(1)
-      # If the biggest fan motor size is hit, use the highest category efficiency
-      if nominal_hp > 9998.0
-        OpenStudio.logFree(OpenStudio::Warn, 'openstudio.standards.Fan', "For #{fan.name}, there is no greater nominal HP.  Use the efficiency of the largest motor category.")
-        nominal_hp = motor_bhp
+    else
+      # Use the efficiency largest motor efficiency when BHP is greater than the largest size for which a requirement is provided
+      data = model_find_objects(motors, search_criteria)
+      maximum_capacity = model_find_maximum_value(data, 'maximum_capacity')
+      if motor_bhp > maximum_capacity
+        motor_bhp = maximum_capacity
       end
 
-      # Round to nearest whole HP for niceness
-      if nominal_hp >= 2
-        nominal_hp = nominal_hp.round
+      motor_properties = model_find_object(motors, search_criteria, capacity = nil, date = Date.today, area = nil, num_floors = nil, fan_motor_bhp = motor_bhp)
+      if motor_properties.nil?
+        # Retry without the date
+        motor_properties = model_find_object(motors, search_criteria, capacity = nil, date = nil, area = nil, num_floors = nil, fan_motor_bhp = motor_bhp)
+        if motor_properties.nil?
+          OpenStudio.logFree(OpenStudio::Error, 'openstudio.standards.Fan', "For #{fan.name}, could not find motor properties using search criteria: #{search_criteria}, motor_bhp = #{motor_bhp} hp.")
+          return [fan_motor_eff, nominal_hp]
+        end
       end
     end
 
-    # Get the efficiency based on the nominal horsepower
-    # Add 0.01 hp to avoid search errors.
-    motor_properties = model_find_object(motors, search_criteria, nominal_hp + 0.01)
-
-    if motor_properties.nil?
-      OpenStudio.logFree(OpenStudio::Error, 'openstudio.standards.Fan', "For #{fan.name}, could not find nominal motor properties using search criteria: #{search_criteria}, motor_hp = #{nominal_hp} hp.")
-      return [fan_motor_eff, nominal_hp]
+    nominal_hp = motor_properties['maximum_capacity'].to_f.round(1)
+    # Round to nearest whole HP for niceness
+    if nominal_hp >= 2
+      nominal_hp = nominal_hp.round
     end
+
     fan_motor_eff = motor_properties['nominal_full_load_efficiency']
 
     return [fan_motor_eff, nominal_hp]

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

@@ -76,27 +76,54 @@ class Standard
     # per method used in PNNL prototype buildings.
     # Assumes that the fan brake horsepower is 90%
     # of the fan nameplate rated motor power.
-    fan_motor_nameplate_hp = design_water_flow_gpm / min_gpm_per_hp
-    fan_bhp = 0.9 * fan_motor_nameplate_hp
-
-    # Lookup the minimum motor efficiency
-    motors = standards_data['motors']
-
-    # Assuming all fan motors are 4-pole Enclosed
-    search_criteria = {
-      'template' => template,
-      'number_of_poles' => 4.0,
-      'type' => 'Enclosed'
-    }
+    # Source: Thornton et al. (2011), Achieving the 30% Goal: Energy and Cost Savings Analysis of ASHRAE Standard 90.1-2010, Section 4.5.4
+    nominal_hp = design_water_flow_gpm / min_gpm_per_hp
+    fan_bhp = 0.9 * nominal_hp
+    fan_motor_eff = 0.85
+
+    if nominal_hp <= 0.75
+      motor_type = motor_type(nominal_hp)
+      motor_properties = motor_fractional_hp_efficiencies(nominal_hp, motor_type = motor_type)
+    else
+      # Lookup the minimum motor efficiency
+      motors = standards_data['motors']
+
+      # Assuming all fan motors are 4-pole Enclosed
+      search_criteria = {
+        'template' => template,
+        'number_of_poles' => 4.0,
+        'type' => 'Enclosed'
+      }
+
+      # Use the efficiency largest motor efficiency when BHP is greater than the largest size for which a requirement is provided
+      data = model_find_objects(motors, search_criteria)
+      if data.empty?
+        search_criteria = {
+          'template' => template,
+          'type' => nil
+        }
+        data = model_find_objects(motors, search_criteria)
+      end
+      maximum_capacity = model_find_maximum_value(data, 'maximum_capacity')
+      if fan_bhp > maximum_capacity
+        fan_bhp = maximum_capacity
+      end
+
+      motor_properties = model_find_object(motors, search_criteria, capacity = nil, date = Date.today, area = nil, num_floors = nil, fan_motor_bhp = fan_bhp)
+      if motor_properties.nil?
+        # Retry without the date
+        motor_properties = model_find_object(motors, search_criteria, capacity = nil, date = nil, area = nil, num_floors = nil, fan_motor_bhp = fan_bhp)
+      end
+    end
 
-    motor_properties = model_find_object(motors, search_criteria, fan_motor_nameplate_hp)
     if motor_properties.nil?
-      OpenStudio.logFree(OpenStudio::Error, 'openstudio.standards.FluidCooler', "For #{fluid_cooler.name}, could not find motor properties using search criteria: #{search_criteria}, motor_hp = #{motor_hp} hp.")
-      return false
+      OpenStudio.logFree(OpenStudio::Error, 'openstudio.standards.FluidCooler', "For #{fluid_cooler.name}, could not find motor properties using search criteria: #{search_criteria}, motor_hp = #{norminal_hp} hp. Using a default value of #{fan_motor_eff}.")
     end
 
-    fan_motor_eff = motor_properties['nominal_full_load_efficiency']
-    nominal_hp = motor_properties['maximum_capacity'].to_f.round(1)
+    unless motor_properties.nil?
+      fan_motor_eff = motor_properties['nominal_full_load_efficiency']
+      nominal_hp = motor_properties['maximum_capacity'].to_f.round(1)
+    end
     # Round to nearest whole HP for niceness
     if nominal_hp >= 2
       nominal_hp = nominal_hp.round
@@ -107,7 +134,7 @@ class Standard
     # Convert to W
     fan_motor_actual_power_w = fan_motor_actual_power_hp * 745.7 # 745.7 W/HP
 
-    OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.FluidCooler', "For #{fluid_cooler.name}, allowed fan motor nameplate hp = #{fan_motor_nameplate_hp.round(1)} hp, fan brake horsepower = #{fan_bhp.round(1)}, and fan motor actual power = #{fan_motor_actual_power_hp.round(1)} hp (#{fan_motor_actual_power_w.round} W) at #{fan_motor_eff} motor efficiency.")
+    OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.FluidCooler', "For #{fluid_cooler.name}, allowed fan motor nameplate hp = #{nominal_hp.round(1)} hp, fan brake horsepower = #{fan_bhp.round(1)}, and fan motor actual power = #{fan_motor_actual_power_hp.round(1)} hp (#{fan_motor_actual_power_w.round} W) at #{fan_motor_eff} motor efficiency.")
 
     # Append the efficiency to the name
     fluid_cooler.setName("#{fluid_cooler.name} #{min_gpm_per_hp.to_f.round(1)} gpm/hp")

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

@@ -8,21 +8,26 @@ class Standard
   def heat_exchanger_air_to_air_sensible_and_latent_apply_effectiveness(heat_exchanger_air_to_air_sensible_and_latent)
     # Assumed to be sensible and latent at all flow
     full_htg_sens_eff, full_htg_lat_eff, part_htg_sens_eff, part_htg_lat_eff, full_cool_sens_eff, full_cool_lat_eff, part_cool_sens_eff, part_cool_lat_eff = heat_exchanger_air_to_air_sensible_and_latent_minimum_effectiveness(heat_exchanger_air_to_air_sensible_and_latent)
-
-    heat_exchanger_air_to_air_sensible_and_latent.setSensibleEffectivenessat100HeatingAirFlow(full_htg_sens_eff)
-    heat_exchanger_air_to_air_sensible_and_latent.setLatentEffectivenessat100HeatingAirFlow(full_htg_lat_eff)
-    heat_exchanger_air_to_air_sensible_and_latent.setSensibleEffectivenessat100CoolingAirFlow(full_cool_sens_eff)
-    heat_exchanger_air_to_air_sensible_and_latent.setLatentEffectivenessat100CoolingAirFlow(full_cool_lat_eff)
     if heat_exchanger_air_to_air_sensible_and_latent.model.version < OpenStudio::VersionString.new('3.8.0')
+      heat_exchanger_air_to_air_sensible_and_latent.setSensibleEffectivenessat100HeatingAirFlow(full_htg_sens_eff)
+      heat_exchanger_air_to_air_sensible_and_latent.setLatentEffectivenessat100HeatingAirFlow(full_htg_lat_eff)
+      heat_exchanger_air_to_air_sensible_and_latent.setSensibleEffectivenessat100CoolingAirFlow(full_cool_sens_eff)
+      heat_exchanger_air_to_air_sensible_and_latent.setLatentEffectivenessat100CoolingAirFlow(full_cool_lat_eff)
       heat_exchanger_air_to_air_sensible_and_latent.setSensibleEffectivenessat75HeatingAirFlow(part_htg_sens_eff)
       heat_exchanger_air_to_air_sensible_and_latent.setLatentEffectivenessat75HeatingAirFlow(part_htg_lat_eff)
       heat_exchanger_air_to_air_sensible_and_latent.setSensibleEffectivenessat75CoolingAirFlow(part_cool_sens_eff)
       heat_exchanger_air_to_air_sensible_and_latent.setLatentEffectivenessat75CoolingAirFlow(part_cool_lat_eff)
     else
-      heat_exchanger_air_to_air_sensible_and_latent.setSensibleEffectivenessat75HeatingAirFlow(part_htg_sens_eff) unless part_htg_sens_eff.zero?
-      heat_exchanger_air_to_air_sensible_and_latent.setLatentEffectivenessat75HeatingAirFlow(part_htg_lat_eff) unless part_htg_lat_eff.zero?
-      heat_exchanger_air_to_air_sensible_and_latent.setSensibleEffectivenessat75CoolingAirFlow(part_cool_sens_eff) unless part_cool_sens_eff.zero?
-      heat_exchanger_air_to_air_sensible_and_latent.setLatentEffectivenessat75CoolingAirFlow(part_cool_lat_eff) unless part_cool_lat_eff.zero?
+      values = Hash.new{|hash, key| hash[key] = Hash.new}
+      values['Sensible Heating'][0.75] = part_htg_sens_eff
+      values['Sensible Heating'][1.0] = full_htg_sens_eff
+      values['Latent Heating'][0.75] = part_htg_lat_eff
+      values['Latent Heating'][1.0] = full_htg_lat_eff
+      values['Sensible Cooling'][0.75] = part_cool_sens_eff
+      values['Sensible Cooling'][1.0] = full_cool_sens_eff
+      values['Latent Cooling'][0.75] = part_cool_lat_eff
+      values['Latent Cooling'][1.0] = full_cool_lat_eff
+      OpenstudioStandards::HVAC.heat_exchanger_air_to_air_set_effectiveness_values(heat_exchanger_air_to_air_sensible_and_latent, defaults: false, values: values)
     end
 
     OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.HeatExchangerSensLat', "For #{heat_exchanger_air_to_air_sensible_and_latent.name}: Set sensible and latent effectiveness.")