Module: LargeDataCenterLowITE

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

Overview

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

Instance Method Summary collapse

Instance Method Details

#add_data_center_load(model) ⇒ Boolean

add IT equipment (ITE object) for data center building types Normal electric equipment has been added in model_add_load prior to this will replace with ITE object here

Parameters:

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

    OpenStudio model object

Returns:

  • (Boolean) —

    returns true if successful, false if not



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
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeDataCenterLowITE.rb', line 31

def add_data_center_load(model)
  model.getSpaceTypes.each do |space_type|
    # Get the standards data
    space_type_properties = space_type_get_standards_data(space_type)

    elec_equip_have_info = false
    elec_equip_per_area = space_type_properties['electric_equipment_per_area'].to_f
    elec_equip_sch = space_type_properties['electric_equipment_schedule']
    elec_equip_have_info = true unless elec_equip_per_area.zero?

    it_fan_power_ratio = 0.4 / (1 + 0.4) # assuming IT fan power is 0.4 of total CPU load

    if (space_type.name.get.downcase.include?('computer') || space_type.name.get.downcase.include?('datacenter')) && elec_equip_have_info
      it_equipment_def = OpenStudio::Model::ElectricEquipmentITEAirCooledDefinition.new(model)
      it_equipment_def.setName('IT equipment def')
      it_equipment_def.setWattsperZoneFloorArea(OpenStudio.convert(elec_equip_per_area.to_f, 'W/ft^2', 'W/m^2').get)
      it_equipment_def.setDesignFanAirFlowRateperPowerInput(0.0001)
      it_equipment_def.setDesignFanPowerInputFraction(it_fan_power_ratio)
      it_equipment_def.setDesignEnteringAirTemperature(22.5) # recommended SAT 18-27C, use the middle T as design
      it_equipment_def.setAirFlowCalculationMethod('FlowControlWithApproachTemperatures')
      # Set the approach temperatures based on CFD simulation results
      it_equipment_def.setSupplyTemperatureDifference(9.67) # This is under fully open configuration assumption, based on the lookup table in scorecard
      it_equipment_def.setReturnTemperatureDifference(-7.36) # This is under fully open configuration assumption, based on the lookup table in scorecard
      # after the bug in OpenStudio core is fixed, this temperature schedules was enabled
      it_equipment_def.setSupplyTemperatureDifferenceSchedule(model_add_schedule(model, 'LargeDataCenterLowITE SupplyApproachTemp_SCH')) # This is under fully open configuration assumption, based on the lookup table in scorecard
      it_equipment_def.setReturnTemperatureDifferenceSchedule(model_add_schedule(model, 'LargeDataCenterLowITE ReturnApproachTemp_SCH'))

      it_equipment = OpenStudio::Model::ElectricEquipmentITEAirCooled.new(it_equipment_def)
      it_equipment.setSpaceType(space_type)
      it_equipment.setName("#{space_type.name} IT equipment")
      unless elec_equip_sch.nil?
        it_equipment.setDesignPowerInputSchedule(model_add_schedule(model, elec_equip_sch))
        OpenStudio.logFree(OpenStudio::Info, 'openstudio.standards.SpaceType', "#{space_type.name} set Design Power Input Schedule to #{elec_equip_sch}.")
      end
      it_equipment.setCPULoadingSchedule(model.alwaysOnDiscreteSchedule)
    end
  end
  # remove normal electric equipment
  model.getElectricEquipments.each(&:remove)
  return true
end

#get_crah_supply_temp_sch(model) ⇒ OpenStudio::Model::Schedule

get CRAH supply air temperature schedule

Parameters:

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

    OpenStudio model object

Returns:

  • (OpenStudio::Model::Schedule) —

    supply temperature schedule object



138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeDataCenterLowITE.rb', line 138

def get_crah_supply_temp_sch(model)
  supply_temp_diff_max = 0
  supply_temp_diff_sch = nil
  supply_temp_sch = nil
  model.getElectricEquipmentITEAirCooledDefinitions.each do |it_equip|
    # if it_equip.supplyTemperatureDifferenceSchedule.is_initialized
    #   # only if supply temperature difference schedule is defined
    #   supply_temp_diff_sch = it_equip.supplyTemperatureDifferenceSchedule.get
    #   if supply_temp_diff_sch.to_ScheduleRuleset.is_initialized
    #     # use the largest supply approach temperature schedule if multiple IT equips are using different schedules
    #     if OpenstudioStandards::Schedules.schedule_ruleset_get_min_max(supply_temp_diff_sch)['max'] <= supply_temp_diff_max
    #       next
    #     else
    #       supply_temp_diff_max = OpenstudioStandards::Schedules.schedule_ruleset_get_min_max(supply_temp_diff_sch)['max']
    #       supply_temp_diff_sch = supply_temp_diff_sch.to_ScheduleRuleset.get
    #       supply_temp_sch = supply_temp_diff_sch.clone(model).to_ScheduleRuleset.get
    #       supply_temp_sch.setName('AHU Supply Temp Sch updated')
    #       supply_temp_sch.scheduleRules.each do |rule|
    #         day_rule = rule.daySchedule()
    #         day_rule.times().each do |time|
    #           supply_temp_diff = day_rule.getValue(time)
    #           day_rule.addValue(time, it_equip.designEnteringAirTemperature-supply_temp_diff)
    #         end
    #       end
    #       next   # skip supply approach temperature if schedule is defined
    #     end
    #   end
    # end

    # Take the supply approach temperature at fully open air management scenario
    supply_temp_diff_max = it_equip.supplyTemperatureDifference if it_equip.supplyTemperatureDifference > supply_temp_diff_max
    if supply_temp_diff_max > 0
      supply_temp_sch = OpenstudioStandards::Schedules.create_constant_schedule_ruleset(model,
                                                                                        it_equip.designEnteringAirTemperature - supply_temp_diff_max,
                                                                                        name: 'AHU Supply Temp Sch updated',
                                                                                        schedule_type_limit: 'Temperature')
    end
  end
  return supply_temp_sch
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



197
198
199
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeDataCenterLowITE.rb', line 197

def model_custom_geometry_tweaks(model, building_type, climate_zone, prototype_input)
  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
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeDataCenterLowITE.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 adjustments')

  # add IT equipment (ITE object) for data center building types
  add_data_center_load(model)

  # This should be added as a retrofit measure instead of being in the prototype
  # modify CRAH supply air setpoint manager
  # modify_crah_sa_stpt_manager(model)

  OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Model', 'Finished building type specific adjustments')

  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



186
187
188
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeDataCenterLowITE.rb', line 186

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

#modify_crah_sa_stpt_manager(model) ⇒ Boolean

modify CRAH supply air setpoint manager

Parameters:

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

    OpenStudio model object

Returns:

  • (Boolean) —

    returns true if successful, false if not



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

def modify_crah_sa_stpt_manager(model)
  supply_temp_sch = get_crah_supply_temp_sch(model)
  model.getSetpointManagerScheduleds.each do |stpt_manager|
    next unless stpt_manager.name.to_s.downcase == 'crah supply air setpoint manager'

    stpt_manager.setSchedule(supply_temp_sch)
  end
  return true
end