openstudio-standards 0.4.0 → 0.5.0.rc1

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

@@ -4,7 +4,7 @@ class Standard
   # Returns standards data for selected space type and template
   #
   # @param space_type [OpenStudio::Model::SpaceType] space type object
-  # @return [hash] hash of internal loads for different load types
+  # @return [Hash] hash of internal loads for different load types
   def space_type_get_standards_data(space_type)
     standards_building_type = if space_type.standardsBuildingType.is_initialized
                                 space_type.standardsBuildingType.get
@@ -48,7 +48,13 @@ class Standard
     interior_lighting_properties = model_find_object(standards_data['prm_interior_lighting'], search_criteria)
 
     if interior_lighting_properties.nil?
-      OpenStudio.logFree(OpenStudio::Warn, 'openstudio.standards.SpaceType', "Interior lighting PRM properties lookup failed: #{search_criteria}.")
+      OpenStudio.logFree(OpenStudio::Warn, 'openstudio.standards.SpaceType', "Interior lighting PRM properties lookup failed: #{search_criteria}. Trying to search with primary_space_type. It is highly recommended to update the standard space type to one of the lighting types listed in: https://pnnl.github.io/BEM-for-PRM/user_guide/model_requirements/standards_space_type/")
+      search_criteria = {
+        'template' => template,
+        'primary_space_type' => standards_space_type
+      }
+      interior_lighting_properties = model_find_object(standards_data['prm_interior_lighting'], search_criteria)
+      OpenStudio.logFree(OpenStudio::Error, 'openstudio.standards.SpaceType', "Interior Lighting PRM properties lookup failed: #{search_criteria}")
       interior_lighting_properties = {}
     end
 
@@ -58,7 +64,7 @@ class Standard
   # Sets the color for the space types as shown in the SketchUp plugin using render by space type.
   #
   # @param space_type [OpenStudio::Model::SpaceType] space type object
-  # @return [Bool] returns true if successful, false if not
+  # @return [Boolean] returns true if successful, false if not
   def space_type_apply_rendering_color(space_type)
     # Get the standards data
     space_type_properties = space_type_get_standards_data(space_type)
@@ -91,16 +97,16 @@ class Standard
   # loads directly assigned to spaces.  This method skips plenums.
   #
   # @param space_type [OpenStudio::Model::SpaceType] space type object
-  # @param set_people [Bool] if true, set the people density.
+  # @param set_people [Boolean] if true, set the people density.
   #   Also, assign reasonable clothing, air velocity, and work efficiency inputs
   #   to allow reasonable thermal comfort metrics to be calculated.
-  # @param set_lights [Bool] if true, set the lighting density, lighting fraction
+  # @param set_lights [Boolean] if true, set the lighting density, lighting fraction
   #   to return air, fraction radiant, and fraction visible.
-  # @param set_electric_equipment [Bool] if true, set the electric equipment density
-  # @param set_gas_equipment [Bool] if true, set the gas equipment density
-  # @param set_ventilation [Bool] if true, set the ventilation rates (per-person and per-area)
-  # @param set_infiltration [Bool] if true, set the infiltration rates
-  # @return [Bool] returns true if successful, false if not
+  # @param set_electric_equipment [Boolean] if true, set the electric equipment density
+  # @param set_gas_equipment [Boolean] if true, set the gas equipment density
+  # @param set_ventilation [Boolean] if true, set the ventilation rates (per-person and per-area)
+  # @param set_infiltration [Boolean] if true, set the infiltration rates
+  # @return [Boolean] returns true if successful, false if not
   def space_type_apply_internal_loads(space_type, set_people, set_lights, set_electric_equipment, set_gas_equipment, set_ventilation, set_infiltration)
     # Skip plenums
     # Check if the space type name
@@ -478,8 +484,9 @@ class Standard
   # Initially, only lighting power density will be set
   # Possibly infiltration will also be set from here
   #
-  # @param model [OpenStudio::Model::SpaceType] OpenStudio space type object
+  # @param space_type [OpenStudio::Model::SpaceType] OpenStudio space type object
   # @param model [OpenStudio::Model::Model] OpenStudio model object
+  # @return [Boolean] returns true if successful, false if not
   def space_type_apply_int_loads_prm(space_type, model)
     # Skip plenums
     # Check if the space type name
@@ -522,14 +529,14 @@ class Standard
       else
         lighting_per_area_hash = {}
         multiple_lpd_value_check = true
-        space_type.spaces.each do |space|
+        space_type.spaces.each do |space_type_space|
           # Space height
-          space_volume = space.volume
-          space_area = space.floorArea
+          space_volume = space_type_space.volume
+          space_area = space_type_space.floorArea
           space_height = space_volume / space_area
           # New lpd values
           lighting_per_area_new = lighting_per_area + lighting_per_length * space_height
-          lighting_per_area_hash[space.name.to_s] = lighting_per_area_new
+          lighting_per_area_hash[space_type_space.name.to_s] = lighting_per_area_new
         end
       end
     end
@@ -564,10 +571,10 @@ class Standard
           end
         end
       else
-        space_type.spaces.each do |space|
+        space_type.spaces.each do |space_type_space|
           new_space_type = space_type.clone.to_SpaceType.get
-          space.setSpaceType(new_space_type)
-          lighting_per_area = lighting_per_area_hash[space.name.to_s]
+          space_type_space.setSpaceType(new_space_type)
+          lighting_per_area = lighting_per_area_hash[space_type_space.name.to_s]
           new_space_type.lights.sort.each do |inst|
             definition = inst.lightsDefinition
             unless lighting_per_area.zero?
@@ -580,11 +587,13 @@ class Standard
         space_type.remove
       end
     end
+    return true
   end
 
   # Modify the lighting schedules for Appendix G PRM for 2016 and later
   #
   # @param model [OpenStudio::Model::Model] OpenStudio model object
+  # @return [Boolean] returns true if successful, false if not
   def space_type_light_sch_change(model)
     return true
   end
@@ -597,15 +606,15 @@ class Standard
   # does not inherit from the default schedule set.
   #
   # @param space_type [OpenStudio::Model::SpaceType] space type object
-  # @param set_people [Bool] if true, set the occupancy and activity schedules
-  # @param set_lights [Bool] if true, set the lighting schedule
-  # @param set_electric_equipment [Bool] if true, set the electric schedule schedule
-  # @param set_gas_equipment [Bool] if true, set the gas equipment density
-  # @param set_infiltration [Bool] if true, set the infiltration schedule
-  # @param make_thermostat [Bool] if true, makes a thermostat for this space type from the
+  # @param set_people [Boolean] if true, set the occupancy and activity schedules
+  # @param set_lights [Boolean] if true, set the lighting schedule
+  # @param set_electric_equipment [Boolean] if true, set the electric schedule schedule
+  # @param set_gas_equipment [Boolean] if true, set the gas equipment density
+  # @param set_infiltration [Boolean] if true, set the infiltration schedule
+  # @param make_thermostat [Boolean] if true, makes a thermostat for this space type from the
   #   schedules listed for the space type.  This thermostat is not hooked to any zone by this method,
   #   but may be found and used later.
-  # @return [Bool] returns true if successful, false if not
+  # @return [Boolean] returns true if successful, false if not
   def space_type_apply_internal_load_schedules(space_type, set_people, set_lights, set_electric_equipment, set_gas_equipment, set_ventilation, set_infiltration, make_thermostat)
     # Get the standards data
     space_type_properties = space_type_get_standards_data(space_type)
@@ -697,7 +706,7 @@ class Standard
   # @param space_type [OpenStudio::Model::SpaceType] space type object
   # @param space_type_properties [Hash] hash of space type properties
   # @param default_sch_set [OpenStudio::Model::DefaultScheduleSet] default schedule set
-  # @return [Bool] returns true if successful, false if not
+  # @return [Boolean] returns true if successful, false if not
   def apply_lighting_schedule(space_type, space_type_properties, default_sch_set)
     lighting_sch = space_type_properties['lighting_schedule']
     return false if lighting_sch.nil?
@@ -710,9 +719,9 @@ class Standard
   # Returns standards data for selected construction
   #
   # @param space_type [OpenStudio::Model::SpaceType] space type object
-  # @param intended_surface_type [string] the type of surface
-  # @param standards_construction_type [string] the type of construction
-  # @return [hash] hash of construction properties
+  # @param intended_surface_type [String] the type of surface
+  # @param standards_construction_type [String] the type of construction
+  # @return [Hash] hash of construction properties
   def space_type_get_construction_properties(space_type, intended_surface_type, standards_construction_type)
     # get building_category value
     building_category = if !space_type_get_standards_data(space_type).nil? && space_type_get_standards_data(space_type)['is_residential'] == 'Yes'

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

@@ -78,7 +78,7 @@ class Standard
   #
   # @param sub_surface [OpenStudio::Model::SubSurface] sub surface object
   # @param percent_reduction [Double] the fractional amount to reduce the area
-  # @return [Bool] returns true if successful, false if not
+  # @return [Boolean] returns true if successful, false if not
   def sub_surface_reduce_area_by_percent_by_shrinking_toward_centroid(sub_surface, percent_reduction)
     # if percent_reduction > 1=> percent increase instead of reduction
     mult = percent_reduction <= 1 ? 1 - percent_reduction : percent_reduction
@@ -113,7 +113,7 @@ class Standard
   #
   # @param sub_surface [OpenStudio::Model::SubSurface] sub surface object
   # @param percent_reduction [Double] the fractional amount to reduce the area.
-  # @return [Bool] returns true if successful, false if not
+  # @return [Boolean] returns true if successful, false if not
   def sub_surface_reduce_area_by_percent_by_raising_sill(sub_surface, percent_reduction)
     mult = 1 - percent_reduction
 
@@ -162,7 +162,7 @@ class Standard
   # meaning a rectangle where the bottom is parallel to the ground.
   #
   # @param sub_surface [OpenStudio::Model::SubSurface] sub surface object
-  # @return [Bool] returns true if the surface is a vertical rectangle, false if not
+  # @return [Boolean] returns true if the surface is a vertical rectangle, false if not
   def sub_surface_vertical_rectangle?(sub_surface)
     # Get the vertices once
     verts = sub_surface.vertices
@@ -195,7 +195,7 @@ class Standard
   #
   # @param surface [OpenStudio::Model::Surface] surface object
   # @param area_fraction [Double] fraction of area of the larger surface
-  # @return [Bool] returns true if successful, false if not
+  # @return [Boolean] returns true if successful, false if not
   def sub_surface_create_centered_subsurface_from_scaled_surface(surface, area_fraction)
     # Get rid of all existing subsurfaces.
     remove_all_subsurfaces(surface: surface)
@@ -245,7 +245,7 @@ class Standard
   # @param surface [OpenStudio::Model::Surface] surface object
   # @param area_fraction [Double] fraction of area of the larger surface
   # @param construction [OpenStudio::Model::Construction] construction to use for the new surface
-  # @return [Bool] returns true if successful, false if not
+  # @return [Boolean] returns true if successful, false if not
   def sub_surface_create_scaled_subsurfaces_from_surface(surface:, area_fraction:, construction:)
     # Set geometry tolerences:
     geometry_tolerence = 12
@@ -334,7 +334,7 @@ class Standard
   # @param surface [OpenStudio::Model::Surface] surface object
   # @param area_fraction [Double] fraction of area of the larger surface
   # @param construction [OpenStudio::Model::Construction] construction to use for the new surface
-  # @return [Bool] returns true if successful, false if not
+  # @return [Boolean] returns true if successful, false if not
   def set_window_to_wall_ratio_set_name(surface:, area_fraction:, construction:)
     surface.setWindowToWallRatio(area_fraction)
     surface.subSurfaces.sort.each do |sub_surf|
@@ -350,7 +350,7 @@ class Standard
   # Is a preparation for replaceing windows or clearing doors before adding windows.
   #
   # @param surface [OpenStudio::Model::Surface] surface object
-  # @return [Bool] returns true if successful, false if not
+  # @return [Boolean] returns true if successful, false if not
   def remove_all_subsurfaces(surface:)
     surface.subSurfaces.sort.each(&:remove)
     return true

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

@@ -50,7 +50,8 @@ class Standard
       when 'Floor'
         infil_rate_cfm_per_ft2 = component_infil_rates_cfm_per_ft2[type]['slab_on_grade']
       end
-    when 'TODO Surface'
+    when 'Surface'
+      # @todo edit
       case surface_type
       when 'Floor'
         infil_rate_cfm_per_ft2 = component_infil_rates_cfm_per_ft2[type]['floor_over_unconditioned']
@@ -89,7 +90,7 @@ class Standard
   # @param sill_height_m [Double] sill height in meters
   # @param window_height_m [Double] window height in meters
   # @param fdwr [Double] fdwr
-  # @return [Bool] returns true if successful, false if not
+  # @return [Boolean] returns true if successful, false if not
   def surface_replace_existing_subsurfaces_with_centered_subsurface(model, sill_height_m, window_height_m, fdwr)
     vertical_surfaces = find_exposed_conditioned_vertical_surfaces(model)
     vertical_surfaces.each do |vertical_surface|
@@ -381,9 +382,8 @@ class Standard
 
   # Returns the surface and subsurface UA product
   #
-  # @param [OpenStudio::Model::Surface] OpenStudio model surface object
-  #
-  # @retrun [Double] UA product in W/K
+  # @param surface [OpenStudio::Model::Surface] OpenStudio model surface object
+  # @return [Double] UA product in W/K
   def surface_subsurface_ua(surface)
     # Compute the surface UA product
     if surface.outsideBoundaryCondition.to_s == 'GroundFCfactorMethod' && surface.construction.is_initialized
@@ -489,9 +489,9 @@ class Standard
 
   # Calculate the wwr of a surface
   #
-  # @param surface [OpenStudio::Model::Surface]
-  # @return [Float] window to wall ratio of a surface
-  def surface_get_wwr_of_a_surface(surface)
+  # @param surface [OpenStudio::Model::Surface] OpenStudio Surface object
+  # @return [Double] window to wall ratio of a surface
+  def surface_get_wwr(surface)
     surface_area = surface.grossArea
     surface_fene_area = 0.0
     surface.subSurfaces.sort.each do |ss|
@@ -505,9 +505,9 @@ class Standard
   # Adjust the fenestration area to the values specified by the reduction value in a surface
   #
   # @param surface [OpenStudio::Model:Surface] openstudio surface object
-  # @param reduction [Float] ratio of adjustments
+  # @param reduction [Double] ratio of adjustments
   # @param model [OpenStudio::Model::Model] openstudio model
-  # @return [Bool] return true if successful, false if not
+  # @return [Boolean] returns true if successful, false if not
   def surface_adjust_fenestration_in_a_surface(surface, reduction, model)
     # Subsurfaces in this surface
     # Default case only handles reduction
@@ -527,9 +527,9 @@ class Standard
 
   # Calculate the door ratio of a surface
   #
-  # @param surface [OpenStudio::Model::Surface]
-  # @return [Float] window to wall ratio of a surface
-  def surface_get_door_ratio_of_a_surface(surface)
+  # @param surface [OpenStudio::Model::Surface] OpenStudio Surface object
+  # @return [Double] window to wall ratio of a surface
+  def surface_get_door_ratio(surface)
     surface_area = surface.grossArea
     surface_door_area = 0.0
     surface.subSurfaces.sort.each do |ss|

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

@@ -96,7 +96,7 @@ class Standard
   # Convert total minimum OA requirement to a per-area value.
   #
   # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
-  # @return [Bool] returns true if successful, false if not
+  # @return [Boolean] returns true if successful, false if not
   def thermal_zone_convert_oa_req_to_per_area(thermal_zone)
     # For each space in the zone, convert
     # all design OA to per-area
@@ -561,7 +561,7 @@ class Standard
   # In the event that they are equal, it will be assumed nonresidential.
   #
   # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
-  # return [Bool] true if residential, false if nonresidential
+  # return [Boolean] true if residential, false if nonresidential
   def thermal_zone_residential?(thermal_zone)
     # Determine the respective areas
     res_area_m2 = 0
@@ -591,7 +591,7 @@ class Standard
   # This is as-defined by 90.1 Appendix G.
   #
   # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
-  # @return [Bool] true if Fossil Fuel, Fossil/Electric Hybrid, and Purchased Heat zone,
+  # @return [Boolean] true if Fossil Fuel, Fossil/Electric Hybrid, and Purchased Heat zone,
   #   false if Electric or Other.
   # @todo It's not doing it properly right now.
   #   If you have a zone with a VRF + a DOAS (via an ATU SingleDUct Uncontrolled)
@@ -603,19 +603,30 @@ class Standard
     # Get an array of the heating fuels
     # used by the zone.  Possible values are
     # Electricity, NaturalGas, Propane, PropaneGas, FuelOilNo1, FuelOilNo2,
-    # Coal, Diesel, Gasoline, DistrictHeating,
-    # and SolarEnergy.
-    htg_fuels = thermal_zone.heating_fuels
-
-    if htg_fuels.include?('NaturalGas') ||
-       htg_fuels.include?('Propane') ||
-       htg_fuels.include?('PropaneGas') ||
-       htg_fuels.include?('FuelOilNo1') ||
-       htg_fuels.include?('FuelOilNo2') ||
-       htg_fuels.include?('Coal') ||
-       htg_fuels.include?('Diesel') ||
-       htg_fuels.include?('Gasoline') ||
-       htg_fuels.include?('DistrictHeating')
+    # Coal, Diesel, Gasoline, SolarEnergy,
+    # DistrictHeating, DistrictHeatingWater, and DistrictHeatingSteam.
+
+    # error if HVACComponent heating fuels method is not available
+    if thermal_zone.model.version < OpenStudio::VersionString.new('3.6.0')
+      OpenStudio.logFree(OpenStudio::Error, 'openstudio.Standards.ThermalZone', 'Required HVACComponent method .heatingFuelTypes is not available in pre-OpenStudio 3.6.0 versions. Use a more recent version of OpenStudio.')
+    end
+
+    htg_fuels = thermal_zone.heatingFuelTypes.map(&:valueName)
+
+    if htg_fuels.include?('Gas')
+      htg_fuels.include?('NaturalGas') ||
+        htg_fuels.include?('Propane') ||
+        htg_fuels.include?('PropaneGas') ||
+        htg_fuels.include?('FuelOil_1') ||
+        htg_fuels.include?('FuelOilNo1') ||
+        htg_fuels.include?('FuelOil_2') ||
+        htg_fuels.include?('FuelOilNo2') ||
+        htg_fuels.include?('Coal') ||
+        htg_fuels.include?('Diesel') ||
+        htg_fuels.include?('Gasoline') ||
+        htg_fuels.include?('DistrictHeating') ||
+        htg_fuels.include?('DistrictHeatingWater') ||
+        htg_fuels.include?('DistrictHeatingSteam')
 
       is_fossil = true
     end
@@ -626,10 +637,10 @@ class Standard
   end
 
   # for 2013 and prior, baseline fuel = proposed fuel
-  # @param themal_zone
-  # @return [string] with applicable DistrictHeating and/or DistrictCooling
-  def thermal_zone_get_zone_fuels_for_occ_and_fuel_type(zone)
-    zone_fuels = thermal_zone_fossil_or_electric_type(zone, '')
+  # @param thermal_zone
+  # @return [String with applicable DistrictHeating and/or DistrictCooling
+  def thermal_zone_get_zone_fuels_for_occ_and_fuel_type(thermal_zone)
+    zone_fuels = thermal_zone_fossil_or_electric_type(thermal_zone, '')
     return zone_fuels
   end
 
@@ -647,17 +658,27 @@ class Standard
     fossil = false
     electric = false
 
+    # error if HVACComponent heating fuels method is not available
+    if thermal_zone.model.version < OpenStudio::VersionString.new('3.6.0')
+      OpenStudio.logFree(OpenStudio::Error, 'openstudio.Standards.ThermalZone', 'Required HVACComponent methods .heatingFuelTypes and .coolingFuelTypes are not available in pre-OpenStudio 3.6.0 versions. Use a more recent version of OpenStudio.')
+    end
+
     # Fossil heating
-    htg_fuels = thermal_zone.heating_fuels
-    if htg_fuels.include?('NaturalGas') ||
-       htg_fuels.include?('Propane') ||
-       htg_fuels.include?('PropaneGas') ||
-       htg_fuels.include?('FuelOilNo1') ||
-       htg_fuels.include?('FuelOilNo2') ||
-       htg_fuels.include?('Coal') ||
-       htg_fuels.include?('Diesel') ||
-       htg_fuels.include?('Gasoline') ||
-       htg_fuels.include?('DistrictHeating')
+    htg_fuels = thermal_zone.heatingFuelTypes.map(&:valueName)
+    if htg_fuels.include?('Gas')
+      htg_fuels.include?('NaturalGas') ||
+        htg_fuels.include?('Propane') ||
+        htg_fuels.include?('PropaneGas') ||
+        htg_fuels.include?('FuelOil_1') ||
+        htg_fuels.include?('FuelOilNo1') ||
+        htg_fuels.include?('FuelOil_2') ||
+        htg_fuels.include?('FuelOilNo2') ||
+        htg_fuels.include?('Coal') ||
+        htg_fuels.include?('Diesel') ||
+        htg_fuels.include?('Gasoline') ||
+        htg_fuels.include?('DistrictHeating') ||
+        htg_fuels.include?('DistrictHeatingWater') ||
+        htg_fuels.include?('DistrictHeatingSteam')
       fossil = true
     end
 
@@ -668,7 +689,7 @@ class Standard
 
     # Cooling fuels, for determining
     # unconditioned zones
-    clg_fuels = thermal_zone.cooling_fuels
+    clg_fuels = thermal_zone.coolingFuelTypes
 
     # Categorize
     fuel_type = nil
@@ -707,33 +728,42 @@ class Standard
   # Determine if the thermal zone is Fossil/Purchased Heat/Electric Hybrid
   #
   # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
-  # @return [Bool] true if mixed Fossil/Electric Hybrid, and Purchased Heat zone, false if not
+  # @return [Boolean] true if mixed Fossil/Electric Hybrid, and Purchased Heat zone, false if not
   def thermal_zone_mixed_heating_fuel?(thermal_zone)
     is_mixed = false
 
+    # error if HVACComponent heating fuels method is not available
+    if thermal_zone.model.version < OpenStudio::VersionString.new('3.6.0')
+      OpenStudio.logFree(OpenStudio::Error, 'openstudio.Standards.ThermalZone', 'Required HVACComponent method .heatingFuelTypes is not available in pre-OpenStudio 3.6.0 versions. Use a more recent version of OpenStudio.')
+    end
+
     # Get an array of the heating fuels
     # used by the zone.  Possible values are
     # Electricity, NaturalGas, Propane, PropaneGas, FuelOilNo1, FuelOilNo2,
-    # Coal, Diesel, Gasoline, DistrictHeating,
-    # and SolarEnergy.
-    htg_fuels = thermal_zone.heating_fuels
+    # Coal, Diesel, Gasoline, SolarEnergy,
+    # DistrictHeating, DistrictHeatingWater, and DistrictHeatingSteam.
+    htg_fuels = thermal_zone.heatingFuelTypes.map(&:valueName)
 
     # Includes fossil
     fossil = false
-    if htg_fuels.include?('NaturalGas') ||
-       htg_fuels.include?('Propane') ||
-       htg_fuels.include?('PropaneGas') ||
-       htg_fuels.include?('FuelOilNo1') ||
-       htg_fuels.include?('FuelOilNo2') ||
-       htg_fuels.include?('Coal') ||
-       htg_fuels.include?('Diesel') ||
-       htg_fuels.include?('Gasoline')
+    if htg_fuels.include?('Gas')
+      htg_fuels.include?('NaturalGas') ||
+        htg_fuels.include?('Propane') ||
+        htg_fuels.include?('PropaneGas') ||
+        htg_fuels.include?('FuelOil_1') ||
+        htg_fuels.include?('FuelOilNo1') ||
+        htg_fuels.include?('FuelOil_2') ||
+        htg_fuels.include?('FuelOilNo2') ||
+        htg_fuels.include?('Coal') ||
+        htg_fuels.include?('Diesel') ||
+        htg_fuels.include?('Gasoline')
 
       fossil = true
     end
 
     # Electric and fossil and district
-    if htg_fuels.include?('Electricity') && htg_fuels.include?('DistrictHeating') && fossil
+    has_district_heating = (htg_fuels.include?('DistrictHeating') || htg_fuels.include?('DistrictHeatingWater') || htg_fuels.include?('DistrictHeatingSteam'))
+    if htg_fuels.include?('Electricity') && has_district_heating && fossil
       is_mixed = true
       OpenStudio.logFree(OpenStudio::Debug, 'openstudio.Standards.ThermalZone', "For #{thermal_zone.name}, heating mixed electricity, fossil, and district.")
     end
@@ -745,13 +775,13 @@ class Standard
     end
 
     # Electric and district
-    if htg_fuels.include?('Electricity') && htg_fuels.include?('DistrictHeating')
+    if htg_fuels.include?('Electricity') && has_district_heating
       is_mixed = true
       OpenStudio.logFree(OpenStudio::Debug, 'openstudio.Standards.ThermalZone', "For #{thermal_zone.name}, heating mixed electricity and district.")
     end
 
     # Fossil and district
-    if fossil && htg_fuels.include?('DistrictHeating')
+    if fossil && has_district_heating
       is_mixed = true
       OpenStudio.logFree(OpenStudio::Debug, 'openstudio.Standards.ThermalZone', "For #{thermal_zone.name}, heating mixed fossil and district.")
     end
@@ -837,9 +867,14 @@ class Standard
       end
     end
 
+    # error if HVACComponent heating fuels method is not available
+    if thermal_zone.model.version < OpenStudio::VersionString.new('3.6.0')
+      OpenStudio.logFree(OpenStudio::Error, 'openstudio.Standards.ThermalZone', 'Required HVACComponent methods .heatingFuelTypes and .coolingFuelTypes are not available in pre-OpenStudio 3.6.0 versions. Use a more recent version of OpenStudio.')
+    end
+
     # Get the zone heating and cooling fuels
-    htg_fuels = thermal_zone.heating_fuels
-    clg_fuels = thermal_zone.cooling_fuels
+    htg_fuels = thermal_zone.heatingFuelTypes.map(&:valueName)
+    clg_fuels = thermal_zone.coolingFuelTypes.map(&:valueName)
     is_fossil = thermal_zone_fossil_hybrid_or_purchased_heat?(thermal_zone)
 
     # Infer the HVAC type
@@ -944,7 +979,7 @@ class Standard
   #
   # @author Andrew Parker, Julien Marrec
   # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
-  # @return [Bool] returns true if heated, false if not
+  # @return [Boolean] returns true if heated, false if not
   def thermal_zone_heated?(thermal_zone)
     temp_f = 41
     temp_c = OpenStudio.convert(temp_f, 'F', 'C').get
@@ -1094,7 +1129,7 @@ class Standard
   #
   # @author Andrew Parker, Julien Marrec
   # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
-  # @return [Bool] returns true if cooled, false if not
+  # @return [Boolean] returns true if cooled, false if not
   def thermal_zone_cooled?(thermal_zone)
     temp_f = 91
     temp_c = OpenStudio.convert(temp_f, 'F', 'C').get
@@ -1235,7 +1270,7 @@ class Standard
   # Determine if the thermal zone is a plenum based on whether a majority of the spaces in the zone are plenums or not.
   #
   # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
-  # @return [Bool] returns true if majority plenum, false if not
+  # @return [Boolean] returns true if majority plenum, false if not
   def thermal_zone_plenum?(thermal_zone)
     plenum_status = false
 
@@ -1261,7 +1296,7 @@ class Standard
   # Zone must be less than 200 ft^2 and also have an infiltration object specified using Flow/Zone.
   #
   # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
-  # @return [Bool] returns true if vestibule, false if not
+  # @return [Boolean] returns true if vestibule, false if not
   def thermal_zone_vestibule?(thermal_zone)
     is_vest = false
 
@@ -1286,24 +1321,31 @@ class Standard
   # Logic to detect indirectly-conditioned spaces cannot be implemented
   # as part of this measure as it would need to call itself.
   # It is implemented as part of space_conditioning_category().
-  # TODO: Add addendum db rules to 90.1-2019 for 90.1-2022 (use stable baseline value for zones designated as semiheated using proposed sizing run)
+  # @todo Add addendum db rules to 90.1-2019 for 90.1-2022 (use stable baseline value for zones designated as semiheated using proposed sizing run)
   #
   # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
   # @param climate_zone [String] ASHRAE climate zone, e.g. 'ASHRAE 169-2013-4A'
   # @return [String] NonResConditioned, ResConditioned, Semiheated, Unconditioned
   def thermal_zone_conditioning_category(thermal_zone, climate_zone)
+    # error if zone design load methods are not available
+    if thermal_zone.model.version < OpenStudio::VersionString.new('3.6.0')
+      OpenStudio.logFree(OpenStudio::Error, 'openstudio.Standards.ThermalZone', 'Required ThermalZone methods .autosizedHeatingDesignLoad and .autosizedCoolingDesignLoad are not available in pre-OpenStudio 3.6.0 versions. Use a more recent version of OpenStudio.')
+    end
+
     # Get the heating load
     htg_load_btu_per_ft2 = 0.0
-    htg_load_w_per_m2 = thermal_zone.heatingDesignLoad
-    if htg_load_w_per_m2.is_initialized
-      htg_load_btu_per_ft2 = OpenStudio.convert(htg_load_w_per_m2.get, 'W/m^2', 'Btu/hr*ft^2').get
+    htg_load_w = thermal_zone.autosizedHeatingDesignLoad
+    if htg_load_w.is_initialized
+      htg_load_w_per_m2 = thermal_zone.autosizedHeatingDesignLoad.get / thermal_zone.floorArea
+      htg_load_btu_per_ft2 = OpenStudio.convert(htg_load_w_per_m2, 'W/m^2', 'Btu/hr*ft^2').get
     end
 
     # Get the cooling load
     clg_load_btu_per_ft2 = 0.0
-    clg_load_w_per_m2 = thermal_zone.coolingDesignLoad
-    if clg_load_w_per_m2.is_initialized
-      clg_load_btu_per_ft2 = OpenStudio.convert(clg_load_w_per_m2.get, 'W/m^2', 'Btu/hr*ft^2').get
+    clg_load_w = thermal_zone.autosizedCoolingDesignLoad
+    if clg_load_w.is_initialized
+      clg_load_w_per_m2 = thermal_zone.autosizedCoolingDesignLoad.get / thermal_zone.floorArea
+      clg_load_btu_per_ft2 = OpenStudio.convert(clg_load_w_per_m2, 'W/m^2', 'Btu/hr*ft^2').get
     end
 
     # Determine the heating limit based on climate zone
@@ -1523,7 +1565,7 @@ class Standard
   # This value determines zone air flows, which will be summed during system design airflow calculation.
   #
   # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
-  # @return [Bool] returns true if successful, false if not
+  # @return [Boolean] returns true if successful, false if not
   def thermal_zone_apply_prm_baseline_supply_temperatures(thermal_zone)
     # Skip spaces that aren't heated or cooled
     return true unless thermal_zone_heated?(thermal_zone) || thermal_zone_cooled?(thermal_zone)
@@ -1553,7 +1595,7 @@ class Standard
   # or cooled by thermal_zone_cooled?() and thermal_zone_heated?()
   #
   # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
-  # @return [Bool] returns true if successful, false if not
+  # @return [Boolean] returns true if successful, false if not
   def thermal_zone_add_unconditioned_thermostat(thermal_zone)
     # Heated to 0F (below thermal_zone_heated?(thermal_zone)  threshold)
     htg_t_f = 0
@@ -1767,7 +1809,7 @@ class Standard
   #
   # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
   # @param climate_zone [String] ASHRAE climate zone, e.g. 'ASHRAE 169-2013-4A'
-  # @return [Bool] Returns true if required, false if not
+  # @return [Boolean] Returns true if required, false if not
   # @todo Add exception logic for 90.1-2013
   #   for cells, sickrooms, labs, barbers, salons, and bowling alleys
   def thermal_zone_demand_control_ventilation_required?(thermal_zone, climate_zone)
@@ -1778,6 +1820,7 @@ class Standard
 
     # Not required if both limits nil
     if min_area_m2.nil? && min_area_m2_per_occ.nil?
+      OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.ThermalZone', "For #{thermal_zone.name}: DCV is not required due to lack of minimum area requirements.")
       return dcv_required
     end
 
@@ -1964,7 +2007,7 @@ class Standard
   # returns adjacent zones that share a wall with the zone
   #
   # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
-  # @param same_floor [Bool] only valid option for now is true
+  # @param same_floor [Boolean] only valid option for now is true
   # @return [Array<OpenStudio::Model::ThermalZone>] array of adjacent thermal zones
   def thermal_zone_get_adjacent_zones_with_shared_wall_areas(thermal_zone, same_floor = true)
     adjacent_zones = []
@@ -1988,16 +2031,16 @@ class Standard
   # returns true if DCV is required for exhaust fan for specified tempate
   #
   # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
-  # @return [Bool] returns true if DCV is required for exhaust fan for specified template, false if not
+  # @return [Boolean] returns true if DCV is required for exhaust fan for specified template, false if not
   def thermal_zone_exhaust_fan_dcv_required?(thermal_zone); end
 
   # Add DCV to exhaust fan and if requsted to related objects
   #
   # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
-  # @param change_related_objects [Bool] change related objects
+  # @param change_related_objects [Boolean] change related objects
   # @param zone_mixing_objects [Array<OpenStudio::Model::ZoneMixing>] array of zone mixing objects
   # @param transfer_air_source_zones [Array<OpenStudio::Model::ThermalZone>] array thermal zones that transfer air
-  # @return [Bool] returns true if successful, false if not
+  # @return [Boolean] returns true if successful, false if not
   # @todo this method is currently empty
   def thermal_zone_add_exhaust_fan_dcv(thermal_zone, change_related_objects = true, zone_mixing_objects = [], transfer_air_source_zones = [])
     # set flow fraction schedule for all zone exhaust fans and then set zone mixing schedule to the intersection of exhaust availability and exhaust fractional schedule