module HighriseApartment

Custom changes for the HighriseApartment prototype. These are changes that are inconsistent with other prototype building types.

Public Instance Methods

add_door_infiltration(climate_zone, model) click to toggle source

add extra infiltration for ground floor corridor

@param climate_zone [String] ASHRAE climate zone, e.g. ‘ASHRAE 169-2013-4A’ @param model [OpenStudio::Model::Model] OpenStudio model object @return [Boolean] returns true if successful, false if not

# File lib/openstudio-standards/prototypes/common/buildings/Prototype.HighRiseApartment.rb, line 97
def add_door_infiltration(climate_zone, model)
  return false if template == 'DOE Ref 1980-2004' || template == 'DOE Ref Pre-1980'

  g_corridor = model.getSpaceByName('G Corridor').get
  infiltration_g_corridor_door = OpenStudio::Model::SpaceInfiltrationDesignFlowRate.new(model)
  infiltration_g_corridor_door.setName('G Corridor door Infiltration')
  infiltration_g_corridor_door.setSpace(g_corridor)
  case template
    when '90.1-2004'
      infiltration_g_corridor_door.setDesignFlowRate(1.523916863)
      infiltration_g_corridor_door.setSchedule(model_add_schedule(model, 'ApartmentHighRise INFIL_Door_Opening_SCH_0.144'))
    when '90.1-2007', '90.1-2010', '90.1-2013', '90.1-2016', '90.1-2019'
      case climate_zone
        when 'ASHRAE 169-2006-0A',
             'ASHRAE 169-2006-1A',
             'ASHRAE 169-2006-2A',
             'ASHRAE 169-2006-2B',
             'ASHRAE 169-2013-0A',
             'ASHRAE 169-2013-1A',
             'ASHRAE 169-2013-2A',
             'ASHRAE 169-2013-2B'
          infiltration_g_corridor_door.setDesignFlowRate(1.523916863)
          infiltration_g_corridor_door.setSchedule(model_add_schedule(model, 'ApartmentHighRise INFIL_Door_Opening_SCH_0.144'))
        else
          infiltration_g_corridor_door.setDesignFlowRate(1.008078792)
          infiltration_g_corridor_door.setSchedule(model_add_schedule(model, 'ApartmentHighRise INFIL_Door_Opening_SCH_0.131'))
      end
  end
  return true
end
add_extra_equip_corridor(model) click to toggle source

add elevator and lights&fans for the top floor corridor

@param model [OpenStudio::Model::Model] OpenStudio model object @return [Boolean] returns true if successful, false if not

# File lib/openstudio-standards/prototypes/common/buildings/Prototype.HighRiseApartment.rb, line 54
def add_extra_equip_corridor(model)
  corridor_top_space = model.getSpaceByName('T Corridor').get
  elec_equip_def1 = OpenStudio::Model::ElectricEquipmentDefinition.new(model)
  elec_equip_def2 = OpenStudio::Model::ElectricEquipmentDefinition.new(model)
  elec_equip_def1.setName('T Corridor Electric Equipment Definition1')
  elec_equip_def2.setName('T Corridor Electric Equipment Definition2')
  elec_equip_def1.setFractionLatent(0)
  elec_equip_def1.setFractionRadiant(0)
  elec_equip_def1.setFractionLost(0.95)
  elec_equip_def2.setFractionLatent(0)
  elec_equip_def2.setFractionRadiant(0)
  elec_equip_def2.setFractionLost(0.95)
  elec_equip_def1.setDesignLevel(20_370)
  case template
    when '90.1-2013', '90.1-2016', '90.1-2019'
      elec_equip_def2.setDesignLevel(63)
    when '90.1-2010'
      elec_equip_def2.setDesignLevel(105.9)
    when '90.1-2004', '90.1-2007'
      elec_equip_def2.setDesignLevel(161.9)
  end
  # Create the electric equipment instance and hook it up to the space type
  elec_equip1 = OpenStudio::Model::ElectricEquipment.new(elec_equip_def1)
  elec_equip2 = OpenStudio::Model::ElectricEquipment.new(elec_equip_def2)
  elec_equip1.setName('T Corridor_Elevators_Equip')
  elec_equip2.setName('Elevators_Lights_Fan')
  elec_equip1.setSpace(corridor_top_space)
  elec_equip2.setSpace(corridor_top_space)
  elec_equip1.setSchedule(model_add_schedule(model, 'ApartmentMidRise BLDG_ELEVATORS'))
  case template
    when '90.1-2004', '90.1-2007'
      elec_equip2.setSchedule(model_add_schedule(model, 'ApartmentMidRise ELEV_LIGHT_FAN_SCH_24_7'))
    when '90.1-2010', '90.1-2013', '90.1-2016', '90.1-2019'
      elec_equip2.setSchedule(model_add_schedule(model, 'ApartmentMidRise ELEV_LIGHT_FAN_SCH_ADD_DF'))
  end
  return true
end
model_custom_geometry_tweaks(model, building_type, climate_zone, prototype_input) click to toggle source

geometry adjustments specific to the prototype model

@param model [OpenStudio::Model::Model] OpenStudio model object @param building_type [String] the building type @param climate_zone [String] ASHRAE climate zone, e.g. ‘ASHRAE 169-2013-4A’ @param prototype_input [Hash] hash of prototype inputs @return [Boolean] returns true if successful, false if not

# File lib/openstudio-standards/prototypes/common/buildings/Prototype.HighRiseApartment.rb, line 160
def model_custom_geometry_tweaks(model, building_type, climate_zone, prototype_input)
  # Set original building North axis
  OpenstudioStandards::Geometry.model_set_building_north_axis(model, 0.0)
  return true
end
model_custom_hvac_tweaks(model, building_type, climate_zone, prototype_input) click to toggle source

hvac adjustments specific to the prototype model

@param model [OpenStudio::Model::Model] OpenStudio model object @param building_type [String] the building type @param climate_zone [String] ASHRAE climate zone, e.g. ‘ASHRAE 169-2013-4A’ @param prototype_input [Hash] hash of prototype inputs @return [Boolean] returns true if successful, false if not

# File lib/openstudio-standards/prototypes/common/buildings/Prototype.HighRiseApartment.rb, line 11
def model_custom_hvac_tweaks(model, building_type, climate_zone, prototype_input)
  OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Model', 'Started building type specific HVAC adjustments')

  # add elevator and lights&fans for the ground floor corridor
  add_extra_equip_corridor(model)
  # add extra infiltration for ground floor corridor
  add_door_infiltration(climate_zone, model)

  # add transformer
  # efficiency based on a 75 kVA transformer
  case template
  when '90.1-2004', '90.1-2007'
    transformer_efficiency = 0.966
  when '90.1-2010', '90.1-2013'
    transformer_efficiency = 0.98
  when '90.1-2016', '90.1-2019'
    transformer_efficiency = 0.986
  else
    transformer_efficiency = nil
  end
  return true if transformer_efficiency.nil?

  # Change to output variable name in E+ 9.4 (OS 3.1.0)
  excluded_interiorequip_variable = if model.version < OpenStudio::VersionString.new('3.1.0')
                                      'Electric Equipment Electric Energy'
                                    else
                                      'Electric Equipment Electricity Energy'
                                    end

  model_add_transformer(model,
                        wired_lighting_frac: 0.0015,
                        transformer_size: 75000,
                        transformer_efficiency: transformer_efficiency,
                        excluded_interiorequip_key: 'T Corridor_Elevators_Equip',
                        excluded_interiorequip_meter: excluded_interiorequip_variable)

  return true
end
model_custom_swh_tweaks(model, building_type, climate_zone, prototype_input) click to toggle source

swh adjustments specific to the prototype model

@param model [OpenStudio::Model::Model] OpenStudio model object @param building_type [String] the building type @param climate_zone [String] ASHRAE climate zone, e.g. ‘ASHRAE 169-2013-4A’ @param prototype_input [Hash] hash of prototype inputs @return [Boolean] returns true if successful, false if not

# File lib/openstudio-standards/prototypes/common/buildings/Prototype.HighRiseApartment.rb, line 149
def model_custom_swh_tweaks(model, building_type, climate_zone, prototype_input)
  return true
end
model_update_fan_efficiency(model) click to toggle source

update fan efficiency

@param model [OpenStudio::Model::Model] OpenStudio model object @return [Boolean] returns true if successful, false if not

# File lib/openstudio-standards/prototypes/common/buildings/Prototype.HighRiseApartment.rb, line 132
def model_update_fan_efficiency(model)
  model.getFanOnOffs.sort.each do |fan_onoff|
    next if fan_onoff.name.get.to_s.include?('ERV')

    fan_onoff.setFanEfficiency(0.53625)
    fan_onoff.setMotorEfficiency(0.825)
  end
  return true
end