openstudio-standards 0.2.16 → 0.2.17.rc1

data/lib/openstudio-standards/standards/ashrae_90_1_prm/ashrae_90_1_prm_2019/ashrae_90_1_prm_2019.Model.rb

@@ -0,0 +1,176 @@
+class ASHRAE901PRM2019 < ASHRAE901PRM
+  # @!group Model
+
+  # Determine if there is a need for a proposed model sizing run.
+  # A typical application of such sizing run is to determine space
+  # conditioning type.
+  #
+  # @param model [OpenStudio::Model::Model] OpenStudio model object
+  #
+  # @return [Boolean] Returns true if a sizing run is required
+  def model_create_prm_baseline_building_requires_proposed_model_sizing_run(model)
+    return true
+  end
+
+  # Determines the area of the building above which point
+  # the non-dominant area type gets it's own HVAC system type.
+  # @return [Double] the minimum area (m^2)
+  def model_prm_baseline_system_group_minimum_area(model, custom)
+    exception_min_area_ft2 = 20_000
+    # Customization - Xcel EDA Program Manual 2014
+    # 3.2.1 Mechanical System Selection ii
+    if custom == 'Xcel Energy CO EDA'
+      exception_min_area_ft2 = 5000
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.Model', "Customization; per Xcel EDA Program Manual 2014 3.2.1 Mechanical System Selection ii, minimum area for non-predominant conditions reduced to #{exception_min_area_ft2} ft2.")
+    end
+    exception_min_area_m2 = OpenStudio.convert(exception_min_area_ft2, 'ft^2', 'm^2').get
+    return exception_min_area_m2
+  end
+
+  # Determines which system number is used
+  # for the baseline system.
+  # @return [String] the system number: 1_or_2, 3_or_4,
+  # 5_or_6, 7_or_8, 9_or_10
+  def model_prm_baseline_system_number(model, climate_zone, area_type, fuel_type, area_ft2, num_stories, custom)
+    sys_num = nil
+
+    # Customization - Xcel EDA Program Manual 2014
+    # Table 3.2.2 Baseline HVAC System Types
+    if custom == 'Xcel Energy CO EDA'
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.Model', 'Custom; per Xcel EDA Program Manual 2014 Table 3.2.2 Baseline HVAC System Types, the 90.1-2010 lookup for HVAC system types shall be used.')
+
+      # Set the area limit
+      limit_ft2 = 25_000
+
+      case area_type
+      when 'residential'
+        sys_num = '1_or_2'
+      when 'nonresidential'
+        # nonresidential and 3 floors or less and <25,000 ft2
+        if num_stories <= 3 && area_ft2 < limit_ft2
+          sys_num = '3_or_4'
+          # nonresidential and 4 or 5 floors or 5 floors or less and 25,000 ft2 to 150,000 ft2
+        elsif ((num_stories == 4 || num_stories == 5) && area_ft2 < limit_ft2) || (num_stories <= 5 && (area_ft2 >= limit_ft2 && area_ft2 <= 150_000))
+          sys_num = '5_or_6'
+          # nonresidential and more than 5 floors or >150,000 ft2
+        elsif num_stories >= 5 || area_ft2 > 150_000
+          sys_num = '7_or_8'
+        end
+      when 'heatedonly'
+        sys_num = '9_or_10'
+      when 'retail'
+        # Should only be hit by Xcel EDA
+        sys_num = '3_or_4'
+      end
+
+    else
+
+      # Set the area limit
+      limit_ft2 = 25_000
+
+      case area_type
+      when 'residential'
+        sys_num = '1_or_2'
+      when 'nonresidential'
+        # nonresidential and 3 floors or less and <25,000 ft2
+        if num_stories <= 3 && area_ft2 < limit_ft2
+          sys_num = '3_or_4'
+        # nonresidential and 4 or 5 floors or 5 floors or less and 25,000 ft2 to 150,000 ft2
+        elsif ((num_stories == 4 || num_stories == 5) && area_ft2 < limit_ft2) || (num_stories <= 5 && (area_ft2 >= limit_ft2 && area_ft2 <= 150_000))
+          sys_num = '5_or_6'
+        # nonresidential and more than 5 floors or >150,000 ft2
+        elsif num_stories >= 5 || area_ft2 > 150_000
+          sys_num = '7_or_8'
+        end
+      when 'heatedonly'
+        sys_num = '9_or_10'
+      when 'retail'
+        sys_num = '3_or_4'
+      end
+
+    end
+
+    return sys_num
+  end
+
+  # Change the fuel type based on climate zone, depending on the standard.
+  # For 90.1-2013, fuel type is based on climate zone, not the proposed model.
+  # @return [String] the revised fuel type
+  def model_prm_baseline_system_change_fuel_type(model, fuel_type, climate_zone, custom = nil)
+    if custom == 'Xcel Energy CO EDA'
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.Model', 'Custom; per Xcel EDA Program Manual 2014 Table 3.2.2 Baseline HVAC System Types, the 90.1-2010 rules for heating fuel type (based on proposed model) rules apply.')
+      return fuel_type
+    end
+
+    # For 90.1-2013 the fuel type is determined based on climate zone.
+    # Don't change the fuel if it purchased heating or cooling.
+    if fuel_type == 'electric' || fuel_type == 'fossil'
+      case climate_zone
+      when 'ASHRAE 169-2006-1A',
+           'ASHRAE 169-2006-2A',
+           'ASHRAE 169-2006-3A',
+           'ASHRAE 169-2013-1A',
+           'ASHRAE 169-2013-2A',
+           'ASHRAE 169-2013-3A'
+        fuel_type = 'electric'
+      else
+        fuel_type = 'fossil'
+      end
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.Model', "Heating fuel is #{fuel_type} for 90.1-2013, climate zone #{climate_zone}.  This is independent of the heating fuel type in the proposed building, per G3.1.1-3.  This is different than previous versions of 90.1.")
+    end
+
+    return fuel_type
+  end
+
+  # Determines the fan type used by VAV_Reheat and VAV_PFP_Boxes systems.
+  # Variable speed fan for 90.1-2013
+  # @return [String] the fan type: TwoSpeed Fan, Variable Speed Fan
+  def model_baseline_system_vav_fan_type(model)
+    fan_type = 'Variable Speed Fan'
+    return fan_type
+  end
+
+  # Determines the skylight to roof ratio limit for a given standard
+  # 3% for 90.1-PRM-2019
+  # @return [Double] the skylight to roof ratio, as a percent: 5.0 = 5%
+  def model_prm_skylight_to_roof_ratio_limit(model)
+    srr_lim = 3.0
+    return srr_lim
+  end
+
+  # Determine the surface range of a baseline model.
+  # The method calculates the window to wall ratio (assuming all spaces are conditioned)
+  # and select the range based on the calculated window to wall ratio
+  # @param model [OpenStudio::Model::Model] OpenStudio model object
+  # @param wwr_parameter [Hash] parameters to choose min and max percent of surfaces,
+  #            could be different set in different standard
+  def model_get_percent_of_surface_range(model, wwr_parameter)
+    wwr_range = { 'minimum_percent_of_surface' => nil, 'maximum_percent_of_surface' => nil }
+    intended_surface_type = wwr_parameter['intended_surface_type']
+    if intended_surface_type == 'ExteriorWindow' || intended_surface_type == 'GlassDoor'
+      if wwr_parameter.key?('wwr_building_type')
+        wwr_building_type = wwr_parameter['wwr_building_type']
+        wwr_info = wwr_parameter['wwr_info']
+        if wwr_info[wwr_building_type] <= 10
+          wwr_range['minimum_percent_of_surface'] = 0
+          wwr_range['maximum_percent_of_surface'] = 10
+        elsif wwr_info[wwr_building_type] <= 20
+          wwr_range['minimum_percent_of_surface'] = 10.1
+          wwr_range['maximum_percent_of_surface'] = 20
+        elsif wwr_info[wwr_building_type] <= 30
+          wwr_range['minimum_percent_of_surface'] = 20.1
+          wwr_range['maximum_percent_of_surface'] = 30
+        elsif wwr_info[wwr_building_type] <= 40
+          wwr_range['minimum_percent_of_surface'] = 30.1
+          wwr_range['maximum_percent_of_surface'] = 40
+        else
+          wwr_range['minimum_percent_of_surface'] = nil
+          wwr_range['maximum_percent_of_surface'] = nil
+        end
+      else
+        OpenStudio.logFree(OpenStudio::Error, 'openstudio.model.Model', 'No wwr_building_type found for ExteriorWindow or GlassDoor')
+      end
+    end
+    return wwr_range
+  end
+end

data/lib/openstudio-standards/standards/ashrae_90_1_prm/ashrae_90_1_prm_2019/ashrae_90_1_prm_2019.rb

@@ -0,0 +1,25 @@
+# This class holds methods that apply ASHRAE 90.1-2013
+# to a given model.
+# @ref [References::ASHRAE9012013]
+class ASHRAE901PRM2019 < ASHRAE901PRM
+  register_standard '90.1-PRM-2019'
+  attr_reader :template
+
+  def initialize
+    @template = '90.1-PRM-2019'
+    load_standards_database
+  end
+
+  def load_standards_database(data_directories = [])
+    super([__dir__] + data_directories)
+  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
+    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_prm/ashrae_90_1_prm_2019/data/ashrae_90_1_prm_2019.boilers.json

@@ -0,0 +1,52 @@
+{
+  "boilers": [
+    {
+      "template": "90.1-PRM-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.8,
+      "minimum_thermal_efficiency": null,
+      "minimum_combustion_efficiency": null,
+      "efffplr": "Boiler with Minimum Turndown",
+      "notes": "From Table G3.5.6"
+    },
+    {
+      "template": "90.1-PRM-2019",
+      "fluid_type": "Hot Water",
+      "fuel_type": "Gas",
+      "condensing": null,
+      "condensing_control": null,
+      "minimum_capacity": 300000.0,
+      "maximum_capacity": 2500000.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.75,
+      "minimum_combustion_efficiency": null,
+      "efffplr": "Boiler with Minimum Turndown",
+      "notes": "From Table G3.5.6"
+    },
+    {
+      "template": "90.1-PRM-2019",
+      "fluid_type": "Hot Water",
+      "fuel_type": "Gas",
+      "condensing": null,
+      "condensing_control": null,
+      "minimum_capacity": 2500001.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.8,
+      "efffplr": "Boiler with Minimum Turndown",
+      "notes": "From Table G3.5.6"
+    }
+  ]
+}

data/lib/openstudio-standards/standards/ashrae_90_1_prm/ashrae_90_1_prm_2019/data/ashrae_90_1_prm_2019.chillers.json

@@ -0,0 +1,112 @@
+{
+  "chillers": [
+    {
+      "template": "90.1-PRM-2019",
+      "cooling_type": "WaterCooled",
+      "condenser_type": null,
+      "compressor_type": "Centrifugal",
+      "absorption_type": null,
+      "variable_speed_drive": null,
+      "minimum_capacity": 0.0,
+      "maximum_capacity": 149.99,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "minimum_full_load_efficiency": 0.703,
+      "minimum_integrated_part_load_value": 0.67,
+      "capft": null,
+      "eirft": null,
+      "eirfplr": null,
+      "notes": "Path A Efficiencies"
+    },
+    {
+      "template": "90.1-PRM-2019",
+      "cooling_type": "WaterCooled",
+      "condenser_type": null,
+      "compressor_type": "Centrifugal",
+      "absorption_type": null,
+      "variable_speed_drive": null,
+      "minimum_capacity": 150.0,
+      "maximum_capacity": 299.99,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "minimum_full_load_efficiency": 0.634,
+      "minimum_integrated_part_load_value": 0.596,
+      "capft": null,
+      "eirft": null,
+      "eirfplr": null,
+      "notes": "Path A Efficiencies"
+    },
+    {
+      "template": "90.1-PRM-2019",
+      "cooling_type": "WaterCooled",
+      "condenser_type": null,
+      "compressor_type": "Centrifugal",
+      "absorption_type": null,
+      "variable_speed_drive": null,
+      "minimum_capacity": 300.0,
+      "maximum_capacity": 9999.0,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "minimum_full_load_efficiency": 0.576,
+      "minimum_integrated_part_load_value": 0.549,
+      "capft": null,
+      "eirft": null,
+      "eirfplr": null,
+      "notes": "Path A Efficiencies"
+    },
+    {
+      "template": "90.1-PRM-2019",
+      "cooling_type": "WaterCooled",
+      "condenser_type": null,
+      "compressor_type": "Rotary Screw and Scroll",
+      "absorption_type": null,
+      "variable_speed_drive": null,
+      "minimum_capacity": 0.0,
+      "maximum_capacity": 149.99,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "minimum_full_load_efficiency": 0.79,
+      "minimum_integrated_part_load_value": 0.676,
+      "capft": null,
+      "eirft": null,
+      "eirfplr": null,
+      "notes": "Path A Efficiencies"
+    },
+    {
+      "template": "90.1-PRM-2019",
+      "cooling_type": "WaterCooled",
+      "condenser_type": null,
+      "compressor_type": "Rotary Screw and Scroll",
+      "absorption_type": null,
+      "variable_speed_drive": null,
+      "minimum_capacity": 150.0,
+      "maximum_capacity": 299.99,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "minimum_full_load_efficiency": 0.718,
+      "minimum_integrated_part_load_value": 0.629,
+      "capft": null,
+      "eirft": null,
+      "eirfplr": null,
+      "notes": "Path A Efficiencies"
+    },
+    {
+      "template": "90.1-PRM-2019",
+      "cooling_type": "WaterCooled",
+      "condenser_type": null,
+      "compressor_type": "Rotary Screw and Scroll",
+      "absorption_type": null,
+      "variable_speed_drive": null,
+      "minimum_capacity": 300.0,
+      "maximum_capacity": 9999.0,
+      "start_date": "1919-09-09T00:00:00+00:00",
+      "end_date": "2999-09-09T00:00:00+00:00",
+      "minimum_full_load_efficiency": 0.639,
+      "minimum_integrated_part_load_value": 0.572,
+      "capft": null,
+      "eirft": null,
+      "eirfplr": null,
+      "notes": "Path A Efficiencies"
+    }
+  ]
+}

data/lib/openstudio-standards/standards/ashrae_90_1_prm/ashrae_90_1_prm_2019/data/ashrae_90_1_prm_2019.climate_zone_sets.json

@@ -0,0 +1,210 @@
+{
+  "climate_zone_sets": [
+    {
+      "name": "ClimateZone 0",
+      "climate_zones": [
+        "ASHRAE 169-2006-0A",
+        "ASHRAE 169-2006-0B",
+        "ASHRAE 169-2013-0A",
+        "ASHRAE 169-2013-0B"
+      ]
+    },
+    {
+      "name": "ClimateZone 0A",
+      "climate_zones": [
+        "ASHRAE 169-2006-0A",
+        "ASHRAE 169-2013-0A"
+      ]
+    },
+    {
+      "name": "ClimateZone 0B",
+      "climate_zones": [
+        "ASHRAE 169-2006-0B",
+        "ASHRAE 169-2013-0B"
+      ]
+    },
+    {
+      "name": "ClimateZone 1",
+      "climate_zones": [
+        "ASHRAE 169-2006-1A",
+        "ASHRAE 169-2006-1B",
+        "ASHRAE 169-2013-1A",
+        "ASHRAE 169-2013-1B"
+      ]
+    },
+    {
+      "name": "ClimateZone 1A",
+      "climate_zones": [
+        "ASHRAE 169-2006-1A",
+        "ASHRAE 169-2013-1A"
+      ]
+    },
+    {
+      "name": "ClimateZone 1B",
+      "climate_zones": [
+        "ASHRAE 169-2006-1B",
+        "ASHRAE 169-2013-1B"
+      ]
+    },
+    {
+      "name": "ClimateZone 2",
+      "climate_zones": [
+        "ASHRAE 169-2006-2A",
+        "ASHRAE 169-2006-2B",
+        "ASHRAE 169-2013-2A",
+        "ASHRAE 169-2013-2B"
+      ]
+    },
+    {
+      "name": "ClimateZone 2A",
+      "climate_zones": [
+        "ASHRAE 169-2006-2A",
+        "ASHRAE 169-2013-2A"
+      ]
+    },
+    {
+      "name": "ClimateZone 2B",
+      "climate_zones": [
+        "ASHRAE 169-2006-2B",
+        "ASHRAE 169-2013-2B"
+      ]
+    },
+    {
+      "name": "ClimateZone 3",
+      "climate_zones": [
+        "ASHRAE 169-2006-3A",
+        "ASHRAE 169-2006-3B",
+        "ASHRAE 169-2006-3C",
+        "ASHRAE 169-2013-3A",
+        "ASHRAE 169-2013-3B",
+        "ASHRAE 169-2013-3C"
+      ]
+    },
+    {
+      "name": "ClimateZone 3A",
+      "climate_zones": [
+        "ASHRAE 169-2006-3A",
+        "ASHRAE 169-2013-3A"
+      ]
+    },
+    {
+      "name": "ClimateZone 3B",
+      "climate_zones": [
+        "ASHRAE 169-2006-3B",
+        "ASHRAE 169-2013-3B"
+      ]
+    },
+    {
+      "name": "ClimateZone 3C",
+      "climate_zones": [
+        "ASHRAE 169-2006-3C",
+        "ASHRAE 169-2013-3C"
+      ]
+    },
+    {
+      "name": "ClimateZone 4",
+      "climate_zones": [
+        "ASHRAE 169-2006-4A",
+        "ASHRAE 169-2006-4B",
+        "ASHRAE 169-2006-4C",
+        "ASHRAE 169-2013-4A",
+        "ASHRAE 169-2013-4B",
+        "ASHRAE 169-2013-4C"
+      ]
+    },
+    {
+      "name": "ClimateZone 4A",
+      "climate_zones": [
+        "ASHRAE 169-2006-4A",
+        "ASHRAE 169-2013-4A"
+      ]
+    },
+    {
+      "name": "ClimateZone 4B",
+      "climate_zones": [
+        "ASHRAE 169-2006-4B",
+        "ASHRAE 169-2013-4B"
+      ]
+    },
+    {
+      "name": "ClimateZone 4C",
+      "climate_zones": [
+        "ASHRAE 169-2006-4C",
+        "ASHRAE 169-2013-4C"
+      ]
+    },
+    {
+      "name": "ClimateZone 5",
+      "climate_zones": [
+        "ASHRAE 169-2006-5A",
+        "ASHRAE 169-2006-5B",
+        "ASHRAE 169-2006-5C",
+        "ASHRAE 169-2013-5A",
+        "ASHRAE 169-2013-5B",
+        "ASHRAE 169-2013-5C"
+      ]
+    },
+    {
+      "name": "ClimateZone 5A",
+      "climate_zones": [
+        "ASHRAE 169-2006-5A",
+        "ASHRAE 169-2013-5A"
+      ]
+    },
+    {
+      "name": "ClimateZone 5B",
+      "climate_zones": [
+        "ASHRAE 169-2006-5B",
+        "ASHRAE 169-2013-5B"
+      ]
+    },
+    {
+      "name": "ClimateZone 5C",
+      "climate_zones": [
+        "ASHRAE 169-2006-5C",
+        "ASHRAE 169-2013-5C"
+      ]
+    },
+    {
+      "name": "ClimateZone 6",
+      "climate_zones": [
+        "ASHRAE 169-2006-6A",
+        "ASHRAE 169-2006-6B",
+        "ASHRAE 169-2013-6A",
+        "ASHRAE 169-2013-6B"
+      ]
+    },
+    {
+      "name": "ClimateZone 6A",
+      "climate_zones": [
+        "ASHRAE 169-2006-6A",
+        "ASHRAE 169-2013-6A"
+      ]
+    },
+    {
+      "name": "ClimateZone 6B",
+      "climate_zones": [
+        "ASHRAE 169-2006-6B",
+        "ASHRAE 169-2013-6B"
+      ]
+    },
+    {
+      "name": "ClimateZone 7",
+      "climate_zones": [
+        "ASHRAE 169-2006-7A",
+        "ASHRAE 169-2006-7B",
+        "ASHRAE 169-2013-7A",
+        "ASHRAE 169-2013-7B"
+      ]
+    },
+    {
+      "name": "ClimateZone 8",
+      "climate_zones": [
+        "ASHRAE 169-2006-8A",
+        "ASHRAE 169-2006-8B",
+        "ASHRAE 169-2013-8A",
+        "ASHRAE 169-2013-8B"
+      ]
+    }
+  ]
+}