Module: LargeDataCenterHighITE

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

Overview

Custom changes for the LargeDataCenterHighITE 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
72
73
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.LargeDataCenterHighITE.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')
      if 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.43) # This is under fully open configuration assumption, based on the lookup table in scorecard
        it_equipment_def.setReturnTemperatureDifference(-7.55) # 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, 'LargeDataCenterHighITE SupplyApproachTemp_SCH'))   # This is under fully open configuration assumption, based on the lookup table in scorecard
        it_equipment_def.setReturnTemperatureDifferenceSchedule(model_add_schedule(model, 'LargeDataCenterHighITE ReturnApproachTemp_SCH'))   # This is under fully open configuration assumption, based on the lookup table in scorecard

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



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

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|
    ## This should be added as a retrofit measure coupled with water-side economizer or free cooling with cooling tower
    # 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 schedule_ruleset_annual_min_max_value(supply_temp_diff_sch)['max'] <= supply_temp_diff_max
    #       next
    #     else
    #       supply_temp_diff_max = schedule_ruleset_annual_min_max_value(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 = model_add_constant_schedule_ruleset(model,
                                                            it_equip.designEnteringAirTemperature - supply_temp_diff_max,
                                                            name = 'AHU Supply Temp Sch updated')
    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



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

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.LargeDataCenterHighITE.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



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

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



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

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