openstudio-standards 0.7.0 → 0.8.0.rc1

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

@@ -105,9 +105,8 @@ class Standard
   # @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)
+  def space_type_apply_internal_loads(space_type, set_people, set_lights, set_electric_equipment, set_gas_equipment, set_ventilation)
     # Skip plenums
     # Check if the space type name
     # contains the word plenum.
@@ -437,50 +436,6 @@ class Standard
 
     end
 
-    # Infiltration
-    infiltration_have_info = false
-    infiltration_per_area_ext = space_type_properties['infiltration_per_exterior_area'].to_f
-    infiltration_per_area_ext_wall = space_type_properties['infiltration_per_exterior_wall_area'].to_f
-    infiltration_ach = space_type_properties['infiltration_air_changes'].to_f
-    unless infiltration_per_area_ext.zero? && infiltration_per_area_ext_wall.zero? && infiltration_ach.zero?
-      infiltration_have_info = true
-    end
-
-    if set_infiltration && infiltration_have_info
-      # Remove all but the first instance
-      instances = space_type.spaceInfiltrationDesignFlowRates.sort
-      if instances.empty?
-        instance = OpenStudio::Model::SpaceInfiltrationDesignFlowRate.new(space_type.model)
-        instance.setName("#{space_type.name} Infiltration")
-        instance.setSpaceType(space_type)
-        OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.SpaceType', "#{space_type.name} had no infiltration objects, one has been created.")
-        instances << instance
-      elsif instances.size > 1
-        instances.each_with_index do |inst, i|
-          next if i.zero?
-
-          OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.SpaceType', "Removed #{inst.name} from #{space_type.name}.")
-          inst.remove
-        end
-      end
-
-      # Modify each instance
-      space_type.spaceInfiltrationDesignFlowRates.sort.each do |inst|
-        unless infiltration_per_area_ext.zero?
-          inst.setFlowperExteriorSurfaceArea(OpenStudio.convert(infiltration_per_area_ext.to_f, 'ft^3/min*ft^2', 'm^3/s*m^2').get.round(13))
-          OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.SpaceType', "#{space_type.name} set infiltration to #{ventilation_ach} per ft^2 exterior surface area.")
-        end
-        unless infiltration_per_area_ext_wall.zero?
-          inst.setFlowperExteriorWallArea(OpenStudio.convert(infiltration_per_area_ext_wall.to_f, 'ft^3/min*ft^2', 'm^3/s*m^2').get)
-          OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.SpaceType', "#{space_type.name} set infiltration to #{infiltration_per_area_ext_wall} per ft^2 exterior wall area.")
-        end
-        unless infiltration_ach.zero?
-          inst.setAirChangesperHour(infiltration_ach)
-          OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.SpaceType', "#{space_type.name} set infiltration to #{ventilation_ach} ACH.")
-        end
-      end
-    end
-
     return true
   end
 
@@ -612,12 +567,11 @@ class Standard
   # @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 [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)
+  def space_type_apply_internal_load_schedules(space_type, set_people, set_lights, set_electric_equipment, set_gas_equipment, set_ventilation, make_thermostat)
     # Get the standards data
     space_type_properties = space_type_get_standards_data(space_type)
 
@@ -673,15 +627,6 @@ class Standard
       end
     end
 
-    # Infiltration
-    if set_infiltration
-      infiltration_sch = space_type_properties['infiltration_schedule']
-      unless infiltration_sch.nil?
-        default_sch_set.setInfiltrationSchedule(model_add_schedule(space_type.model, infiltration_sch))
-        OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.SpaceType', "#{space_type.name} set infiltration schedule to #{infiltration_sch}.")
-      end
-    end
-
     # Thermostat
     if make_thermostat
       thermostat = OpenStudio::Model::ThermostatSetpointDualSetpoint.new(space_type.model)

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

@@ -268,9 +268,9 @@ class Standard
   # @return [Double] UA product in W/K
   def surface_subsurface_ua(surface)
     # Compute the surface UA product
+    cons = surface.construction.get
+    fc_obj_type = cons.iddObjectType.valueName.to_s
     if surface.outsideBoundaryCondition.to_s == 'GroundFCfactorMethod' && surface.construction.is_initialized
-      cons = surface.construction.get
-      fc_obj_type = cons.iddObjectType.valueName.to_s
       case fc_obj_type
         when 'OS_Construction_FfactorGroundFloor'
           cons = surface.construction.get.to_FFactorGroundFloorConstruction.get
@@ -295,6 +295,9 @@ class Standard
 
           ua = u_eff * surface.netArea
       end
+    elsif fc_obj_type == 'OS_Construction_AirBoundary'
+      # Air boundary meant for lighting and air exchanges, no heat transfer happen in this surface.
+      ua = 0.0
     else
       ua = surface.uFactor.get * surface.netArea if surface.uFactor.is_initialized
     end
@@ -302,10 +305,15 @@ class Standard
     surface.subSurfaces.sort.each do |subsurface|
       subsurface_construction = subsurface.construction.get
       u_factor = OpenstudioStandards::SqlFile.construction_calculated_fenestration_u_factor(subsurface_construction)
+      if !u_factor && subsurface.uFactor.is_initialized
+        OpenStudio.logFree(OpenStudio::Warn, 'openstudio.standards.surface', "Failed to search subsurface construction: #{subsurface_construction.name.get} u factor from simulation output file (SQL). It is likely due to the model is not simulated.")
+        u_factor = subsurface.uFactor.get
+      end
+      prm_raise(u_factor, @sizing_run_dir, "Failed to calculate subsurface #{subsurface_construction.name.get} u-factor. It is likely the subsurface construction is not defined or the model is not simulated")
       ua += u_factor * subsurface.netArea
     end
 
-    return ua
+    ua
   end
 
   # Adjust the fenestration area to the values specified by the reduction value in a surface

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

@@ -673,125 +673,6 @@ class Standard
     return [min_area_m2, min_area_per_occ]
   end
 
-  # Add Exhaust Fans based on space type lookup.
-  # This measure doesn't look if DCV is needed.
-  # Others methods can check if DCV needed and add it.
-  #
-  # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
-  # @param exhaust_makeup_inputs [Hash] has of makeup exhaust inputs
-  # @return [Hash] Hash of newly made exhaust fan objects along with secondary exhaust and zone mixing objects
-  # @todo combine availability and fraction flow schedule to make zone mixing schedule
-  def thermal_zone_add_exhaust(thermal_zone, exhaust_makeup_inputs = {})
-    exhaust_fans = {} # key is primary exhaust value is hash of arrays of secondary objects
-
-    # hash to store space type information
-    space_type_hash = {} # key is space type value is floor_area_si
-
-    # get space type ratio for spaces in zone, making more than one exhaust fan if necessary
-    thermal_zone.spaces.each do |space|
-      next unless space.spaceType.is_initialized
-      next unless space.partofTotalFloorArea
-
-      space_type = space.spaceType.get
-      if space_type_hash.key?(space_type)
-        space_type_hash[space_type] += space.floorArea # excluding space.multiplier since used to calc loads in zone
-      else
-        next unless space_type.standardsBuildingType.is_initialized
-        next unless space_type.standardsSpaceType.is_initialized
-
-        space_type_hash[space_type] = space.floorArea # excluding space.multiplier since used to calc loads in zone
-      end
-    end
-
-    # loop through space type hash and add exhaust as needed
-    space_type_hash.each do |space_type, floor_area|
-      # get floor custom or calculated floor area for max flow rate calculation
-      makeup_target = [space_type.standardsBuildingType.get, space_type.standardsSpaceType.get]
-      if exhaust_makeup_inputs.key?(makeup_target) && exhaust_makeup_inputs[makeup_target].key?(:target_effective_floor_area)
-        # pass in custom floor area
-        floor_area_si = exhaust_makeup_inputs[makeup_target][:target_effective_floor_area] / thermal_zone.multiplier.to_f
-        floor_area_ip = OpenStudio.convert(floor_area_si, 'm^2', 'ft^2').get
-      else
-        floor_area_ip = OpenStudio.convert(floor_area, 'm^2', 'ft^2').get
-      end
-
-      space_type_properties = space_type_get_standards_data(space_type)
-      exhaust_per_area = space_type_properties['exhaust_per_area']
-      next if exhaust_per_area.nil?
-
-      maximum_flow_rate_ip = exhaust_per_area * floor_area_ip
-      maximum_flow_rate_si = OpenStudio.convert(maximum_flow_rate_ip, 'cfm', 'm^3/s').get
-      if space_type_properties['exhaust_availability_schedule'].nil?
-        exhaust_schedule = thermal_zone.model.alwaysOnDiscreteSchedule
-        exhaust_flow_schedule = exhaust_schedule
-      else
-        sch_name = space_type_properties['exhaust_availability_schedule']
-        exhaust_schedule = model_add_schedule(thermal_zone.model, sch_name)
-        flow_sch_name = space_type_properties['exhaust_flow_fraction_schedule']
-        exhaust_flow_schedule = model_add_schedule(thermal_zone.model, flow_sch_name)
-        unless exhaust_schedule
-          OpenStudio.logFree(OpenStudio::Warn, 'openstudio.Standards.ThermalZone', "Could not find an exhaust schedule called #{sch_name}, exhaust fans will run continuously.")
-          exhaust_schedule = thermal_zone.model.alwaysOnDiscreteSchedule
-        end
-      end
-
-      # add exhaust fans
-      zone_exhaust_fan = OpenStudio::Model::FanZoneExhaust.new(thermal_zone.model)
-      zone_exhaust_fan.setName("#{thermal_zone.name} Exhaust Fan")
-      zone_exhaust_fan.setAvailabilitySchedule(exhaust_schedule)
-      zone_exhaust_fan.setFlowFractionSchedule(exhaust_flow_schedule)
-      # not using zone_exhaust_fan.setFlowFractionSchedule. Exhaust fans are on when available
-      zone_exhaust_fan.setMaximumFlowRate(maximum_flow_rate_si)
-      zone_exhaust_fan.setEndUseSubcategory('Zone Exhaust Fans')
-      zone_exhaust_fan.addToThermalZone(thermal_zone)
-      exhaust_fans[zone_exhaust_fan] = {} # keys are :zone_mixing and :transfer_air_source_zone_exhaust
-
-      # set fan pressure rise
-      fan_zone_exhaust_apply_prototype_fan_pressure_rise(zone_exhaust_fan)
-
-      # update efficiency and pressure rise
-      prototype_fan_apply_prototype_fan_efficiency(zone_exhaust_fan)
-
-      # add and alter objectxs related to zone exhaust makeup air
-      if exhaust_makeup_inputs.key?(makeup_target) && exhaust_makeup_inputs[makeup_target][:source_zone]
-
-        # add balanced schedule to zone_exhaust_fan
-        balanced_sch_name = space_type_properties['balanced_exhaust_fraction_schedule']
-        balanced_exhaust_schedule = model_add_schedule(thermal_zone.model, balanced_sch_name).to_ScheduleRuleset.get
-        zone_exhaust_fan.setBalancedExhaustFractionSchedule(balanced_exhaust_schedule)
-
-        # use max value of balanced exhaust fraction schedule for maximum flow rate
-        max_sch_val = OpenstudioStandards::Schedules.schedule_ruleset_get_min_max(balanced_exhaust_schedule)['max']
-        transfer_air_zone_mixing_si = maximum_flow_rate_si * max_sch_val
-
-        # add dummy exhaust fan to a transfer_air_source_zones
-        transfer_air_source_zone_exhaust = OpenStudio::Model::FanZoneExhaust.new(thermal_zone.model)
-        transfer_air_source_zone_exhaust.setName("#{thermal_zone.name} Transfer Air Source")
-        transfer_air_source_zone_exhaust.setAvailabilitySchedule(exhaust_schedule)
-        # not using zone_exhaust_fan.setFlowFractionSchedule. Exhaust fans are on when available
-        transfer_air_source_zone_exhaust.setMaximumFlowRate(transfer_air_zone_mixing_si)
-        transfer_air_source_zone_exhaust.setFanEfficiency(1.0)
-        transfer_air_source_zone_exhaust.setPressureRise(0.0)
-        transfer_air_source_zone_exhaust.setEndUseSubcategory('Zone Exhaust Fans')
-        transfer_air_source_zone_exhaust.addToThermalZone(exhaust_makeup_inputs[makeup_target][:source_zone])
-        exhaust_fans[zone_exhaust_fan][:transfer_air_source_zone_exhaust] = transfer_air_source_zone_exhaust
-
-        # @todo make zone mixing schedule by combining exhaust availability and fraction flow
-        zone_mixing_schedule = exhaust_schedule
-
-        # add zone mixing
-        zone_mixing = OpenStudio::Model::ZoneMixing.new(thermal_zone)
-        zone_mixing.setSchedule(zone_mixing_schedule)
-        zone_mixing.setSourceZone(exhaust_makeup_inputs[makeup_target][:source_zone])
-        zone_mixing.setDesignFlowRate(transfer_air_zone_mixing_si)
-        exhaust_fans[zone_exhaust_fan][:zone_mixing] = zone_mixing
-
-      end
-    end
-
-    return exhaust_fans
-  end
-
   # returns true if DCV is required for exhaust fan for specified tempate
   #
   # @param thermal_zone [OpenStudio::Model::ThermalZone] thermal zone
@@ -811,7 +692,7 @@ class Standard
 
     # are there associated zone mixing or dummy exhaust objects that need to change when this changes?
     # How are these objects identified?
-    # If this is run directly after thermal_zone_add_exhaust(thermal_zone)  it will return a hash where each key is an exhaust object and hash is a hash of related zone mixing and dummy exhaust from the source zone
+    # If this is run directly after create_exhaust_fan(thermal_zone)  it will return a hash where each key is an exhaust object and hash is a hash of related zone mixing and dummy exhaust from the source zone
     return true
   end
 

data/lib/openstudio-standards/standards/ashrae_90_1/ashrae_90_1_2004/data/ashrae_90_1_2004.computer_room_acs.json

@@ -0,0 +1,142 @@
+{
+    "computer_room_acs": [
+      {
+        "template": "90.1-2004",
+        "cooling_type": "AirCooled",
+        "heating_type": "Electric Resistance or None",
+        "subcategory": "CRAC",
+        "minimum_capacity": 0,
+        "maximum_capacity": 64999,
+        "start_date": "1919-09-09T00:00:00+00:00",
+        "end_date": "2999-09-09T00:00:00+00:00",
+        "minimum_seasonal_energy_efficiency_ratio": null,
+        "minimum_energy_efficiency_ratio": null,
+        "minimum_integrated_part_load_value": null,
+        "minimum_integrated_energy_efficiency_ratio": null,
+        "ptac_eer_coefficient_1": null,
+        "ptac_eer_coefficient_2": null,
+        "minimum_scop": 2.2,
+        "cool_cap_ft": "PSZ-Fine Storage DX Coil Cap-FT",
+        "cool_cap_fflow": "DX Coil Cap-FF",
+        "cool_eir_ft": "PSZ-AC DX Coil EIR-FT",
+        "cool_eir_fflow": "Split DX Coil EIR-FF",
+        "cool_plf_fplr": "HPACCOOLPLFFPLR",
+        "notes": "2004 not specified, follow ASHRAE 90.1-2013 Table 6.8.1-11. capacity here is sensible only. SCOP for downflow units"
+      },
+      {
+        "template": "90.1-2004",
+        "cooling_type": "AirCooled",
+        "heating_type": "Electric Resistance or None",
+        "subcategory": "CRAC",
+        "minimum_capacity": 65000,
+        "maximum_capacity": 239999,
+        "start_date": "1919-09-09T00:00:00+00:00",
+        "end_date": "2999-09-09T00:00:00+00:00",
+        "minimum_seasonal_energy_efficiency_ratio": null,
+        "minimum_energy_efficiency_ratio": null,
+        "minimum_integrated_part_load_value": null,
+        "minimum_integrated_energy_efficiency_ratio": null,
+        "ptac_eer_coefficient_1": null,
+        "ptac_eer_coefficient_2": null,
+        "minimum_scop": 2.1,
+        "cool_cap_ft": "PSZ-Fine Storage DX Coil Cap-FT",
+        "cool_cap_fflow": "DX Coil Cap-FF",
+        "cool_eir_ft": "PSZ-AC DX Coil EIR-FT",
+        "cool_eir_fflow": "Split DX Coil EIR-FF",
+        "cool_plf_fplr": "HPACCOOLPLFFPLR",
+        "notes": "2004 not specified, follow ASHRAE 90.1-2013 Table 6.8.1-11. capacity here is sensible only. SCOP for downflow units"
+      },
+      {
+        "template": "90.1-2004",
+        "cooling_type": "AirCooled",
+        "heating_type": "Electric Resistance or None",
+        "subcategory": "CRAC",
+        "minimum_capacity": 240000,
+        "maximum_capacity": 9999999,
+        "start_date": "1919-09-09T00:00:00+00:00",
+        "end_date": "2999-09-09T00:00:00+00:00",
+        "minimum_seasonal_energy_efficiency_ratio": null,
+        "minimum_energy_efficiency_ratio": null,
+        "minimum_integrated_part_load_value": null,
+        "minimum_integrated_energy_efficiency_ratio": null,
+        "ptac_eer_coefficient_1": null,
+        "ptac_eer_coefficient_2": null,
+        "minimum_scop": 1.9,
+        "cool_cap_ft": "PSZ-Fine Storage DX Coil Cap-FT",
+        "cool_cap_fflow": "DX Coil Cap-FF",
+        "cool_eir_ft": "PSZ-AC DX Coil EIR-FT",
+        "cool_eir_fflow": "Split DX Coil EIR-FF",
+        "cool_plf_fplr": "HPACCOOLPLFFPLR",
+        "notes": "2004 not specified, follow ASHRAE 90.1-2013 Table 6.8.1-11. capacity here is sensible only. SCOP for downflow units"
+      },
+      {
+        "template": "90.1-2004",
+        "cooling_type": "WaterCooled",
+        "heating_type": "All Other",
+        "subcategory": "CRAC",
+        "minimum_capacity": 0.0,
+        "maximum_capacity": 64999.0,
+        "start_date": "1919-09-09T00:00:00+00:00",
+        "end_date": "2999-09-09T00:00:00+00:00",
+        "minimum_seasonal_energy_efficiency_ratio": null,
+        "minimum_energy_efficiency_ratio": null,
+        "minimum_integrated_part_load_value": null,
+        "minimum_integrated_energy_efficiency_ratio": null,
+        "ptac_eer_coefficient_1": null,
+        "ptac_eer_coefficient_2": null,
+        "minimum_scop": 2.6,
+        "cool_cap_ft": "PSZ-Fine Storage DX Coil Cap-FT",
+        "cool_cap_fflow": "DX Coil Cap-FF",
+        "cool_eir_ft": "PSZ-AC DX Coil EIR-FT",
+        "cool_eir_fflow": "Split DX Coil EIR-FF",
+        "cool_plf_fplr": "HPACCOOLPLFFPLR",
+        "notes": "2004 not specified, follow ASHRAE 90.1-2010 Table 6.8.1K. capacity here is sensible only. SCOP for water cooled downflow units"
+      },
+      {
+        "template": "90.1-2004",
+        "cooling_type": "WaterCooled",
+        "heating_type": "All Other",
+        "subcategory": "CRAC",
+        "minimum_capacity": 65000.0,
+        "maximum_capacity": 239999.0,
+        "start_date": "1919-09-09T00:00:00+00:00",
+        "end_date": "2999-09-09T00:00:00+00:00",
+        "minimum_seasonal_energy_efficiency_ratio": null,
+        "minimum_energy_efficiency_ratio": null,
+        "minimum_integrated_part_load_value": null,
+        "minimum_integrated_energy_efficiency_ratio": null,
+        "ptac_eer_coefficient_1": null,
+        "ptac_eer_coefficient_2": null,
+        "minimum_scop": 2.5,
+        "cool_cap_ft": "PSZ-Fine Storage DX Coil Cap-FT",
+        "cool_cap_fflow": "DX Coil Cap-FF",
+        "cool_eir_ft": "PSZ-AC DX Coil EIR-FT",
+        "cool_eir_fflow": "Split DX Coil EIR-FF",
+        "cool_plf_fplr": "HPACCOOLPLFFPLR",
+        "notes": "2004 not specified, follow ASHRAE 90.1-2010 Table 6.8.1K. capacity here is sensible only. SCOP for water cooled downflow units"
+      },
+      {
+        "template": "90.1-2004",
+        "cooling_type": "WaterCooled",
+        "heating_type": "All Other",
+        "subcategory": "CRAC",
+        "minimum_capacity": 240000.0,
+        "maximum_capacity": 9999999.0,
+        "start_date": "1919-09-09T00:00:00+00:00",
+        "end_date": "2999-09-09T00:00:00+00:00",
+        "minimum_seasonal_energy_efficiency_ratio": null,
+        "minimum_energy_efficiency_ratio": null,
+        "minimum_integrated_part_load_value": null,
+        "minimum_integrated_energy_efficiency_ratio": null,
+        "ptac_eer_coefficient_1": null,
+        "ptac_eer_coefficient_2": null,
+        "minimum_scop": 2.4,
+        "cool_cap_ft": "PSZ-Fine Storage DX Coil Cap-FT",
+        "cool_cap_fflow": "DX Coil Cap-FF",
+        "cool_eir_ft": "PSZ-AC DX Coil EIR-FT",
+        "cool_eir_fflow": "Split DX Coil EIR-FF",
+        "cool_plf_fplr": "HPACCOOLPLFFPLR",
+        "notes": "2004 not specified, follow ASHRAE 90.1-2010 Table 6.8.1K. capacity here is sensible only. SCOP for water cooled downflow units"
+      }
+    ]
+}