Module: LargeOfficeDetailed

Defined in:
lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeOfficeDetailed.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_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



153
154
155
156
157
158
159
160
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeOfficeDetailed.rb', line 153

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_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) —

    uilding_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



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

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) —

    uilding_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
89
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeOfficeDetailed.rb', line 11

def model_custom_hvac_tweaks(model, building_type, climate_zone, prototype_input)
  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

  # replace EvaporativeFluidCoolerSingleSpeed with CoolingTowerTwoSpeed
  model.getPlantLoops.each do |plant_loop|
    next unless plant_loop.name.to_s.include? 'Heat Pump Loop'

    sup_wtr_high_temp_f = 65.0
    sup_wtr_low_temp_f = 41.0
    sup_wtr_high_temp_c = OpenStudio.convert(sup_wtr_high_temp_f, 'F', 'C').get
    sup_wtr_low_temp_c = OpenStudio.convert(sup_wtr_low_temp_f, 'F', 'C').get
    hp_high_temp_sch = OpenstudioStandards::Schedules.create_constant_schedule_ruleset(model,
                                                                                       sup_wtr_high_temp_c,
                                                                                       name: "#{plant_loop.name} High Temp - #{sup_wtr_high_temp_f.round(0)}F",
                                                                                       schedule_type_limit: 'Temperature')
    hp_low_temp_sch = OpenstudioStandards::Schedules.create_constant_schedule_ruleset(model,
                                                                                      sup_wtr_low_temp_c,
                                                                                      name: "#{plant_loop.name} Low Temp - #{sup_wtr_low_temp_f.round(0)}F",
                                                                                      schedule_type_limit: 'Temperature')

    # add cooling tower object
    cooling_tower = OpenStudio::Model::CoolingTowerTwoSpeed.new(model)
    cooling_tower.setName("#{plant_loop.name} Central Tower")
    plant_loop.addSupplyBranchForComponent(cooling_tower)
    #### Add SPM Scheduled Dual Setpoint to outlet of Fluid Cooler so correct Plant Operation Scheme is generated
    cooling_tower_stpt_manager = OpenStudio::Model::SetpointManagerScheduledDualSetpoint.new(model)
    cooling_tower_stpt_manager.setName("#{plant_loop.name} Fluid Cooler Scheduled Dual Setpoint")
    cooling_tower_stpt_manager.setHighSetpointSchedule(hp_high_temp_sch)
    cooling_tower_stpt_manager.setLowSetpointSchedule(hp_low_temp_sch)
    cooling_tower_stpt_manager.addToNode(cooling_tower.outletModelObject.get.to_Node.get)

    # remove EvaporativeFluidCoolerSingleSpeed object
    model.getEvaporativeFluidCoolerSingleSpeeds.each do |fluid_cooler|
      if fluid_cooler.plantLoop.get.name.to_s == plant_loop.name.to_s
        fluid_cooler.remove
        break
      end
    end
  end

  remove_basement_infiltration(model)

  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) —

    uilding_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



127
128
129
130
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeOfficeDetailed.rb', line 127

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

#remove_basement_infiltration(model) ⇒ Boolean

remove basement infiltration

Parameters:

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

    OpenStudio model object

Returns:

  • (Boolean) —

    returns true if successful, false if not



95
96
97
98
99
100
101
102
103
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeOfficeDetailed.rb', line 95

def remove_basement_infiltration(model)
  space_infltrations = model.getSpaceInfiltrationDesignFlowRates
  space_infltrations.each do |space_inf|
    if space_inf.name.to_s.include? 'Basement'
      space_inf = nil
    end
  end
  return true
end

#update_waterheater_loss_coefficient(model) ⇒ Boolean

update water heater loss coefficient

Parameters:

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

    OpenStudio model object

Returns:

  • (Boolean) —

    returns true if successful, false if not



109
110
111
112
113
114
115
116
117
118
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeOfficeDetailed.rb', line 109

def update_waterheater_loss_coefficient(model)
  case template
    when '90.1-2004', '90.1-2007', '90.1-2010', '90.1-2013', '90.1-2016', '90.1-2019', 'NECB2011'
      model.getWaterHeaterMixeds.sort.each do |water_heater|
        water_heater.setOffCycleLossCoefficienttoAmbientTemperature(11.25413987)
        water_heater.setOnCycleLossCoefficienttoAmbientTemperature(11.25413987)
      end
  end
  return true
end