openstudio-standards 0.2.12.rc4 → 0.2.13.rc3

data/lib/openstudio-standards/standards/ashrae_90_1/ashrae_90_1_2019/ashrae_90_1_2019.AirTerminalSingleDuctVAVReheat.rb

@@ -0,0 +1,24 @@
+class ASHRAE9012019 < ASHRAE901
+  # @!group AirTerminalSingleDuctVAVReheat
+
+  # Specifies the minimum damper position for VAV dampers.
+  # For terminals with hot water heat and DDC, the minimum is 20%,
+  # otherwise the minimum is 30%.
+  #
+  # @param has_ddc [Bool] whether or not there is DDC control of the VAV terminal in question
+  def air_terminal_single_duct_vav_reheat_minimum_damper_position(air_terminal_single_duct_vav_reheat, has_ddc = false)
+    min_damper_position = nil
+    case air_terminal_single_duct_vav_reheat_reheat_type(air_terminal_single_duct_vav_reheat)
+    when 'HotWater'
+      min_damper_position = if has_ddc
+                              0.2
+                            else
+                              0.3
+                            end
+    when 'Electricity', 'NaturalGas'
+      min_damper_position = 0.3
+    end
+
+    return min_damper_position
+  end
+end

data/lib/openstudio-standards/standards/ashrae_90_1/ashrae_90_1_2019/ashrae_90_1_2019.CoolingTower.rb

@@ -0,0 +1,19 @@
+# A variety of cooling tower methods that are the same regardless of type.
+# These methods are available to CoolingTowerSingleSpeed, CoolingTowerTwoSpeed, and CoolingTowerVariableSpeed
+module ASHRAE9012019CoolingTower
+  # @!group CoolingTower
+
+  # Above this point, centrifugal fan cooling towers must meet the limits
+  # of propeller or axial cooling towers instead.
+  # 90.1 6.5.5.3 Limit on Centrifugal Fan Open Circuit Cooling Towers.
+  # is 1,100 gallons per minute.
+  #
+  # @param cooling_tower [OpenStudio::Model::CoolingTowerSingleSpeed,
+  # OpenStudio::Model::CoolingTowerTwoSpeed,
+  # OpenStudio::Model::CoolingTowerVariableSpeed] the cooling tower
+  # @return [Double] the limit, in gallons per minute.  Return nil for no limit.
+  def cooling_tower_apply_minimum_power_per_flow_gpm_limit(cooling_tower)
+    gpm_limit = 1100
+    return gpm_limit
+  end
+end

data/lib/openstudio-standards/standards/ashrae_90_1/ashrae_90_1_2019/ashrae_90_1_2019.CoolingTowerSingleSpeed.rb

@@ -0,0 +1,5 @@
+class ASHRAE9012019 < ASHRAE901
+  # @!group CoolingTowerSingleSpeed
+
+  include ASHRAE9012019CoolingTower
+end

data/lib/openstudio-standards/standards/ashrae_90_1/ashrae_90_1_2019/ashrae_90_1_2019.CoolingTowerTwoSpeed.rb

@@ -0,0 +1,5 @@
+class ASHRAE9012019 < ASHRAE901
+  # @!group CoolingTowerTwoSpeed
+
+  include ASHRAE9012019CoolingTower
+end

data/lib/openstudio-standards/standards/ashrae_90_1/ashrae_90_1_2019/ashrae_90_1_2019.CoolingTowerVariableSpeed.rb

@@ -0,0 +1,16 @@
+class ASHRAE9012019 < ASHRAE901
+  # @!group CoolingTowerVariableSpeed
+
+  include ASHRAE9012019CoolingTower
+
+  # Apply the efficiency, plus Multicell heat rejection with VSD
+  #
+  # @param cooling_tower_variable_speed [OpenStudio::Model::CoolingTowerVariableSpeed] the cooling tower
+  def cooling_tower_variable_speed_apply_efficiency_and_curves(cooling_tower_variable_speed)
+    cooling_tower_apply_minimum_power_per_flow(cooling_tower_variable_speed)
+
+    cooling_tower_variable_speed.setCellControl('MaximalCell')
+
+    return true
+  end
+end

data/lib/openstudio-standards/standards/ashrae_90_1/ashrae_90_1_2019/ashrae_90_1_2019.FanVariableVolume.rb

@@ -0,0 +1,37 @@
+class ASHRAE9012019 < ASHRAE901
+  # @!group FanVariableVolume
+
+  # The threhold horsepower below which part load control is not required.
+  # Per 90.1-2019, table 6.5.3.2.1: the fan motor size for chiller-water
+  # and evaporative cooling is 0.25 hp as of 1/1/2014 instead of 5 hp
+  #
+  # @param fan_variable_volume [OpenStudio::Model::FanVariableVolume] the fan
+  # @return [Double] the limit, in horsepower. Return nil for no limit by default.
+  def fan_variable_volume_part_load_fan_power_limitation_hp_limit(fan_variable_volume)
+    hp_limit = case fan_variable_volume_cooling_system_type(fan_variable_volume)
+               when 'dx'
+                 0.0
+               when 'chw'
+                 0.25
+               when 'evap'
+                 0.25
+               end
+
+    return hp_limit
+  end
+
+  # The threhold capacity below which part load control is not required.
+  # Per 90.1-2019, table 6.5.3.2.1: the cooling capacity threshold is 75000
+  # instead of 110000 as of 1/1/2014
+  #
+  # @param fan_variable_volume [OpenStudio::Model::FanVariableVolume] the fan
+  # @return [Double] the limit, in Btu/hr. Return nil for no limit by default.
+  def fan_variable_volume_part_load_fan_power_limitation_capacity_limit(fan_variable_volume)
+    cap_limit_btu_per_hr = case fan_variable_volume_cooling_system_type(fan_variable_volume)
+                           when 'dx'
+                             65_000
+                           end
+
+    return cap_limit_btu_per_hr
+  end
+end

data/lib/openstudio-standards/standards/ashrae_90_1/ashrae_90_1_2019/ashrae_90_1_2019.Space.rb

@@ -0,0 +1,189 @@
+class ASHRAE9012019 < ASHRAE901
+  # @!group Space
+
+  # Determines the method used to extend the daylighted area horizontally
+  # next to a window.  If the method is 'fixed', 2 ft is added to the
+  # width of each window.  If the method is 'proportional', a distance
+  # equal to half of the head height of the window is added.  If the method is 'none',
+  # no additional width is added.
+  #
+  # @return [String] returns 'fixed' or 'proportional'
+  def space_daylighted_area_window_width(space)
+    method = 'proportional'
+    return method
+  end
+
+  # Determine if the space requires daylighting controls for
+  # toplighting, primary sidelighting, and secondary sidelighting.
+  # Defaults to false for all types.
+  #
+  # @param space [OpenStudio::Model::Space] the space in question
+  # @param areas [Hash] a hash of daylighted areas
+  # @return [Array<Bool>] req_top_ctrl, req_pri_ctrl, req_sec_ctrl
+  def space_daylighting_control_required?(space, areas)
+    req_top_ctrl = true
+    req_pri_ctrl = true
+    req_sec_ctrl = true
+
+    # Get the LPD of the space
+    space_lpd_w_per_m2 = space.lightingPowerPerFloorArea
+
+    # Primary Sidelighting
+    # Check if the primary sidelit area contains less than 150W of lighting
+    if areas['primary_sidelighted_area'] == 0.0
+      OpenStudio.logFree(OpenStudio::Debug, 'openstudio.model.Space', "For #{space.name}, primary sidelighting control not required because primary sidelighted area = 0ft2 per 9.4.1.1(e).")
+      req_pri_ctrl = false
+    elsif areas['primary_sidelighted_area'] * space_lpd_w_per_m2 < 150.0
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Space', "For #{space.name}, primary sidelighting control not required because less than 150W of lighting are present in the primary daylighted area per 9.4.1.1(e).")
+      req_pri_ctrl = false
+    else
+      # Check the size of the windows
+      if areas['total_window_area'] < OpenStudio.convert(20.0, 'ft^2', 'm^2').get
+        OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Space', "For #{space.name}, primary sidelighting control not required because there are less than 20ft2 of window per 9.4.1.1(e) Exception 2.")
+        req_pri_ctrl = false
+      end
+    end
+
+    # Secondary Sidelighting
+    # Check if the primary and secondary sidelit areas contains less than 300W of lighting
+    if areas['secondary_sidelighted_area'] == 0.0
+      OpenStudio.logFree(OpenStudio::Debug, 'openstudio.model.Space', "For #{space.name}, secondary sidelighting control not required because secondary sidelighted area = 0ft2 per 9.4.1.1(e).")
+      req_sec_ctrl = false
+    elsif (areas['primary_sidelighted_area'] + areas['secondary_sidelighted_area']) * space_lpd_w_per_m2 < 300
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Space', "For #{space.name}, secondary sidelighting control not required because less than 300W of lighting are present in the combined primary and secondary daylighted areas per 9.4.1.1(e).")
+      req_sec_ctrl = false
+    else
+      # Check the size of the windows
+      if areas['total_window_area'] < OpenStudio.convert(20.0, 'ft^2', 'm^2').get
+        OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Space', "For #{space.name}, secondary sidelighting control not required because there are less than 20ft2 of window per 9.4.1.1(e) Exception 2.")
+        req_sec_ctrl = false
+      end
+    end
+
+    # Toplighting
+    # Check if the toplit area contains less than 150W of lighting
+    if areas['toplighted_area'] == 0.0
+      OpenStudio.logFree(OpenStudio::Debug, 'openstudio.model.Space', "For #{space.name}, toplighting control not required because toplighted area = 0ft2 per 9.4.1.1(f).")
+      req_top_ctrl = false
+    elsif areas['toplighted_area'] * space_lpd_w_per_m2 < 150
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Space', "For #{space.name}, toplighting control not required because less than 150W of lighting are present in the toplighted area per 9.4.1.1(f).")
+      req_top_ctrl = false
+    end
+
+    # Exceptions
+    if space.spaceType.is_initialized
+      case space.spaceType.get.standardsSpaceType.to_s
+      # Retail spaces exception (c) to Section 9.4.1.4
+      # req_sec_ctrl set to true to create a second reference point
+      when 'Core_Retail'
+        req_pri_ctrl = false
+        req_sec_ctrl = true
+      when 'Entry', 'Front_Retail', 'Point_of_Sale'
+        req_pri_ctrl = false
+        req_sec_ctrl = false
+      # Strip mall
+      when 'Strip mall - type 1', 'Strip mall - type 2', 'Strip mall - type 3'
+        req_pri_ctrl = false
+        req_sec_ctrl = false
+      # Residential apartments
+      when 'Apartment', 'Apartment_topfloor_NS', 'Apartment_topfloor_WE'
+        req_top_ctrl = false
+        req_pri_ctrl = false
+        req_sec_ctrl = false
+      end
+    end
+
+    return [req_top_ctrl, req_pri_ctrl, req_sec_ctrl]
+  end
+
+  # Determine the fraction controlled by each sensor and which
+  # window each sensor should go near.
+  #
+  # @param space [OpenStudio::Model::Space] the space with the daylighting
+  # @param sorted_windows [Hash] a hash of windows, sorted by priority
+  # @param sorted_skylights [Hash] a hash of skylights, sorted by priority
+  # @param req_top_ctrl [Bool] if toplighting controls are required
+  # @param req_pri_ctrl [Bool] if primary sidelighting controls are required
+  # @param req_sec_ctrl [Bool] if secondary sidelighting controls are required
+  def space_daylighting_fractions_and_windows(space,
+                                              areas,
+                                              sorted_windows,
+                                              sorted_skylights,
+                                              req_top_ctrl,
+                                              req_pri_ctrl,
+                                              req_sec_ctrl)
+    sensor_1_frac = 0.0
+    sensor_2_frac = 0.0
+    sensor_1_window = nil
+    sensor_2_window = nil
+
+    # Get the area of the space
+    space_area_m2 = space.floorArea
+
+    # get the climate zone
+    climate_zone = model_standards_climate_zone(space.model)
+
+    if req_top_ctrl && req_pri_ctrl && req_sec_ctrl
+      # Sensor 1 controls toplighted area
+      sensor_1_frac = areas['toplighted_area'] / space_area_m2
+      sensor_1_window = sorted_skylights[0]
+      # Sensor 2 controls primary + secondary area
+      sensor_2_frac = (areas['primary_sidelighted_area'] + areas['secondary_sidelighted_area']) / space_area_m2
+      sensor_2_window = sorted_windows[0]
+    elsif !req_top_ctrl && req_pri_ctrl && req_sec_ctrl
+      # Sensor 1 controls primary area
+      sensor_1_frac = areas['primary_sidelighted_area'] / space_area_m2
+      sensor_1_window = sorted_windows[0]
+      # Sensor 2 controls secondary area
+      sensor_2_frac = (areas['secondary_sidelighted_area'] / space_area_m2)
+      sensor_2_window = sorted_windows[0]
+    elsif req_top_ctrl && !req_pri_ctrl && req_sec_ctrl
+      # Sensor 1 controls toplighted area
+      sensor_1_frac = areas['toplighted_area'] / space_area_m2
+      sensor_1_window = sorted_skylights[0]
+      # Sensor 2 controls secondary area
+      sensor_2_frac = (areas['secondary_sidelighted_area'] / space_area_m2)
+      # sorted_skylights[0] assigned to sensor_2_window so a second reference point is added for top daylighting
+      sensor_2_window = sorted_skylights[0]
+    elsif req_top_ctrl && !req_pri_ctrl && !req_sec_ctrl
+      case climate_zone
+        when 'ASHRAE 169-2006-6A',
+             'ASHRAE 169-2006-6B',
+             'ASHRAE 169-2006-7A',
+             'ASHRAE 169-2006-8A',
+             'ASHRAE 169-2013-6A',
+             'ASHRAE 169-2013-6B',
+             'ASHRAE 169-2013-7A',
+             'ASHRAE 169-2013-8A'
+          # Sensor 1 controls toplighted area
+          sensor_1_frac = areas['toplighted_area'] / space_area_m2
+          sensor_1_window = sorted_skylights[0]
+        else
+          # Sensor 1 controls toplighted area
+          sensor_1_frac = areas['toplighted_area'] / space_area_m2
+          sensor_1_window = sorted_skylights[0]
+          sensor_2_frac = sensor_1_frac
+          sensor_2_window = sensor_1_window
+      end
+    elsif !req_top_ctrl && req_pri_ctrl && !req_sec_ctrl
+      # Sensor 1 controls primary area
+      sensor_1_frac = areas['primary_sidelighted_area'] / space_area_m2
+      sensor_1_window = sorted_windows[0]
+    elsif !req_top_ctrl && !req_pri_ctrl && req_sec_ctrl
+      # Sensor 1 controls secondary area
+      sensor_1_frac = areas['secondary_sidelighted_area'] / space_area_m2
+      sensor_1_window = sorted_windows[0]
+    end
+
+    return [sensor_1_frac, sensor_2_frac, sensor_1_window, sensor_2_window]
+  end
+
+  # Determine the base infiltration rate at 75 PA.
+  #
+  # @return [Double] the baseline infiltration rate, in cfm/ft^2
+  # defaults to no infiltration.
+  def space_infiltration_rate_75_pa(space)
+    basic_infil_rate_cfm_per_ft2 = 1.0
+    return basic_infil_rate_cfm_per_ft2
+  end
+end

data/lib/openstudio-standards/standards/ashrae_90_1/ashrae_90_1_2019/ashrae_90_1_2019.ThermalZone.rb

@@ -0,0 +1,57 @@
+class ASHRAE9012019 < ASHRAE901
+  # @!group ThermalZone
+
+  # Determine the thermal zone's occupancy type category.
+  # Options are: residential, nonresidential, publicassembly, retail
+  #
+  # @return [String] the occupancy type category
+  # @todo Add public assembly building types
+  def thermal_zone_occupancy_type(thermal_zone)
+    occ_type = if thermal_zone_residential?(thermal_zone)
+                 'residential'
+               else
+                 'nonresidential'
+               end
+
+    # Based on the space type that
+    # represents a majority of the zone.
+    space_type = thermal_zone_majority_space_type(thermal_zone)
+    if space_type.is_initialized
+      space_type = space_type.get
+      bldg_type = space_type.standardsBuildingType
+      if bldg_type.is_initialized
+        bldg_type = bldg_type.get
+        case bldg_type
+        when 'Retail', 'StripMall', 'SuperMarket'
+          occ_type = 'retail'
+          # when 'SomeBuildingType' # TODO add publicassembly building types
+          # occ_type = 'publicassembly'
+        end
+      end
+    end
+
+    # OpenStudio::logFree(OpenStudio::Info, "openstudio.Standards.ThermalZone", "For #{self.name}, occupancy type = #{occ_type}.")
+
+    return occ_type
+  end
+
+  # Determine the area and occupancy level limits for
+  # demand control ventilation.
+  #
+  # @param thermal_zone [OpenStudio::Model::ThermalZone] the thermal zone
+  # @return [Array<Double>] the minimum area, in m^2
+  # and the minimum occupancy density in m^2/person.  Returns nil
+  # if there is no requirement.
+  def thermal_zone_demand_control_ventilation_limits(thermal_zone)
+    min_area_ft2 = 500
+    min_occ_per_1000_ft2 = 25
+
+    # Convert to SI
+    min_area_m2 = OpenStudio.convert(min_area_ft2, 'ft^2', 'm^2').get
+    min_occ_per_ft2 = min_occ_per_1000_ft2 / 1000.0
+    min_ft2_per_occ = 1.0 / min_occ_per_ft2
+    min_m2_per_occ = OpenStudio.convert(min_ft2_per_occ, 'ft^2', 'm^2').get
+
+    return [min_area_m2, min_m2_per_occ]
+  end
+end

data/lib/openstudio-standards/standards/ashrae_90_1/ashrae_90_1_2019/ashrae_90_1_2019.ZoneHVACComponent.rb

@@ -0,0 +1,22 @@
+class ASHRAE9012019 < ASHRAE901
+  # @!group ZoneHVACComponent
+
+  # Determine if vestibule heating control is required.
+  # Required for 90.1-2019 per 6.4.3.9.
+  #
+  # @ref [References::ASHRAE9012019] 6.4.3.9
+  # @return [Bool] returns true if successful, false if not
+  def zone_hvac_component_vestibule_heating_control_required?(zone_hvac_component)
+    # Ensure that the equipment is assigned to a thermal zone
+    if zone_hvac_component.thermalZone.empty?
+      OpenStudio.logFree(OpenStudio::Warn, 'openstudio.model.ZoneHVACComponent', "For #{zone_hvac_component.name}: equipment is not assigned to a thermal zone, cannot apply vestibule heating control.")
+      return false
+    end
+
+    # Only applies to equipment that is in vestibule zones
+    return true if thermal_zone_vestibule?(zone_hvac_component.thermalZone.get)
+
+    # If here, vestibule heating control not required
+    return false
+  end
+end

data/lib/openstudio-standards/standards/ashrae_90_1/ashrae_90_1_2019/ashrae_90_1_2019.rb

@@ -0,0 +1,16 @@
+# This class holds methods that apply ASHRAE 90.1-2019
+# to a given model.
+# @ref [References::ASHRAE9012019]
+class ASHRAE9012019 < ASHRAE901
+  register_standard '90.1-2019'
+  attr_reader :template
+
+  def initialize
+    @template = '90.1-2019'
+    load_standards_database
+  end
+
+  def load_standards_database(data_directories = [])
+    super([__dir__] + data_directories)
+  end
+end

data/lib/openstudio-standards/standards/ashrae_90_1/ashrae_90_1_2019/data/ashrae_90_1_2019.boilers.json

@@ -0,0 +1,68 @@
+{
+  "boilers": [
+    {
+      "template": "90.1-2019",
+      "fluid_type": "Hot Water",
+      "fuel_type": "Gas",
+      "condensing": null,
+      "condensing_control": null,
+      "minimum_capacity": 0.0,
+      "maximum_capacity": 299999.0,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "minimum_annual_fuel_utilization_efficiency": 0.82,
+      "minimum_thermal_efficiency": null,
+      "minimum_combustion_efficiency": null,
+      "efffplr": "Boiler with No Minimum Turndown",
+      "notes": "From 90.1-2019"
+    },
+    {
+      "template": "90.1-2019",
+      "fluid_type": "Hot Water",
+      "fuel_type": "Gas",
+      "condensing": null,
+      "condensing_control": null,
+      "minimum_capacity": 300000.0,
+      "maximum_capacity": 999999.0,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "minimum_annual_fuel_utilization_efficiency": null,
+      "minimum_thermal_efficiency": 0.8,
+      "minimum_combustion_efficiency": null,
+      "efffplr": "Boiler with No Minimum Turndown",
+      "notes": "From 90.1-2019"
+    },
+    {
+      "template": "90.1-2019",
+      "fluid_type": "Hot Water",
+      "fuel_type": "Gas",
+      "condensing": null,
+      "condensing_control": null,
+      "minimum_capacity": 1000000.0,
+      "maximum_capacity": 249999999.0,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "minimum_annual_fuel_utilization_efficiency": null,
+      "minimum_thermal_efficiency": 0.8,
+      "minimum_combustion_efficiency": null,
+      "efffplr": "Boiler with Minimum Turndown",
+      "notes": "From 90.1-2019"
+    },
+    {
+      "template": "90.1-2019",
+      "fluid_type": "Hot Water",
+      "fuel_type": "Gas",
+      "condensing": null,
+      "condensing_control": null,
+      "minimum_capacity": 250000000.0,
+      "maximum_capacity": 9999999999.0,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "minimum_annual_fuel_utilization_efficiency": null,
+      "minimum_thermal_efficiency": null,
+      "minimum_combustion_efficiency": 0.82,
+      "efffplr": "Boiler with Minimum Turndown",
+      "notes": "From 90.1-2019"
+    }
+  ]
+}