Module: LargeOffice

Defined in:
lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeOffice.rb

Overview

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

AirTerminalSingleDuctVAVReheat collapse

Instance Method Summary collapse

Instance Method Details

#air_loop_hvac_supply_air_temperature_reset_type(air_loop_hvac) ⇒ String

Type of SAT reset for this building type

Parameters:

  • air_loop_hvac (OpenStudio::Model::AirLoopHVAC) —

    air loop

Returns:

  • (String) —

    Returns type of SAT reset



139
140
141
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeOffice.rb', line 139

def air_loop_hvac_supply_air_temperature_reset_type(air_loop_hvac)
  return 'oa'
end

#air_terminal_single_duct_vav_reheat_apply_initial_prototype_damper_position(air_terminal_single_duct_vav_reheat, zone_oa_per_area) ⇒ Boolean

Set the initial minimum damper position based on OA rate of the space and the template. Zones with low OA per area get lower initial guesses. Final position will be adjusted upward as necessary by Standards.AirLoopHVAC.apply_minimum_vav_damper_positions

Parameters:

  • air_terminal_single_duct_vav_reheat (OpenStudio::Model::AirTerminalSingleDuctVAVReheat) —

    the air terminal object

  • zone_oa_per_area (Double) —

    the zone outdoor air per area in m^3/s*m^2

Returns:

  • (Boolean) —

    returns true if successful, false if not



126
127
128
129
130
131
132
133
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeOffice.rb', line 126

def air_terminal_single_duct_vav_reheat_apply_initial_prototype_damper_position(air_terminal_single_duct_vav_reheat, zone_oa_per_area)
  min_damper_position = template == '90.1-2010' || template == '90.1-2013' || template == '90.1-2016' || template == '90.1-2019' ? 0.2 : 0.3

  # Set the minimum flow fraction

  air_terminal_single_duct_vav_reheat.setConstantMinimumAirFlowFraction(min_damper_position)

  return true
end

#model_custom_daylighting_tweaks(building_type, climate_zone, prototype_input, model) ⇒ Object 



90
91
92
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeOffice.rb', line 90

def model_custom_daylighting_tweaks(building_type, climate_zone, prototype_input, model)
  return true
end

#model_custom_geometry_tweaks(model, building_type, climate_zone, prototype_input) ⇒ Boolean

geometry adjustments specific to the prototype model

Parameters:

  • model (OpenStudio::Model::Model) —

    OpenStudio model object

  • building_type (String) —

    the building type

  • climate_zone (String) —

    ASHRAE climate zone, e.g. ‘ASHRAE 169-2013-4A’

  • prototype_input (Hash) —

    hash of prototype inputs

Returns:

  • (Boolean) —

    returns true if successful, false if not



112
113
114
115
116
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeOffice.rb', line 112

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) ⇒ Boolean

hvac adjustments specific to the prototype model

Parameters:

  • model (OpenStudio::Model::Model) —

    OpenStudio model object

  • building_type (String) —

    the building type

  • climate_zone (String) —

    ASHRAE climate zone, e.g. ‘ASHRAE 169-2013-4A’

  • prototype_input (Hash) —

    hash of prototype inputs

Returns:

  • (Boolean) —

    returns true if successful, false if not



11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeOffice.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 transformer

  # efficiency based on a 500 kVA transformer

  case template
  when '90.1-2004', '90.1-2007'
    transformer_efficiency = 0.979
  when '90.1-2010', '90.1-2013'
    transformer_efficiency = 0.987
  when '90.1-2016', '90.1-2019'
    transformer_efficiency = 0.991
  else
    transformer_efficiency = nil
  end
  return true if transformer_efficiency.nil?

  # rename datacenter plug loads sub categories, there should be 2 data center plug load objects in large office

  model.getElectricEquipments.sort.each do |item|
    if item.nameString.include? 'Data Center'
      item.setEndUseSubcategory('DataCenterPlugLoads')
    end
  end

  model_add_transformer(model,
                        wired_lighting_frac: 0.0281,
                        transformer_size: 500000,
                        transformer_efficiency: transformer_efficiency,
                        excluded_interiorequip_meter: 'DataCenterPlugLoads:InteriorEquipment:Electricity')

  system_to_space_map = define_hvac_system_map(building_type, climate_zone)

  system_to_space_map.each do |system|
    # find all zones associated with these spaces

    thermal_zones = []
    system['space_names'].each do |space_name|
      space = model.getSpaceByName(space_name)
      if space.empty?
        OpenStudio.logFree(OpenStudio::Error, 'openstudio.model.Model', "No space called #{space_name} was found in the model")
        return false
      end
      space = space.get
      zone = space.thermalZone
      if zone.empty?
        OpenStudio.logFree(OpenStudio::Error, 'openstudio.model.Model', "No thermal zone was created for the space called #{space_name}")
        return false
      end
      thermal_zones << zone.get
    end

    return_plenum = nil
    unless system['return_plenum'].nil?
      return_plenum_space = model.getSpaceByName(system['return_plenum'])
      if return_plenum_space.empty?
        OpenStudio.logFree(OpenStudio::Error, 'openstudio.model.Model', "No space called #{system['return_plenum']} was found in the model")
        return false
      end
      return_plenum_space = return_plenum_space.get
      return_plenum = return_plenum_space.thermalZone
      if return_plenum.empty?
        OpenStudio.logFree(OpenStudio::Error, 'openstudio.model.Model', "No thermal zone was created for the space called #{system['return_plenum']}")
        return false
      end
      return_plenum = return_plenum.get
    end
  end

  hp_loop = model.getPlantLoopByName('Heat Pump Loop')
  if hp_loop.is_initialized
    hp_loop = hp_loop.get

    # set working fluid to ethylene glycol

    hp_loop.setFluidType('EthyleneGlycol')
    hp_loop.setGlycolConcentration(40)
  end

  return true
end

#model_custom_swh_tweaks(model, building_type, climate_zone, prototype_input) ⇒ Boolean

swh adjustments specific to the prototype model

Parameters:

  • model (OpenStudio::Model::Model) —

    OpenStudio model object

  • building_type (String) —

    the building type

  • climate_zone (String) —

    ASHRAE climate zone, e.g. ‘ASHRAE 169-2013-4A’

  • prototype_input (Hash) —

    hash of prototype inputs

Returns:

  • (Boolean) —

    returns true if successful, false if not



101
102
103
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeOffice.rb', line 101

def model_custom_swh_tweaks(model, building_type, climate_zone, prototype_input)
  return true
end