Module: SmallDataCenterLowITE

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

Overview

Custom changes for the SmallDataCenterLowITE 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.SmallDataCenterLowITE.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(10.21) # This is under fully open configuration assumption, based on the lookup table in scorecard
      it_equipment_def.setReturnTemperatureDifference(-7.04) # 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, 'SmallDataCenterLowITE SupplyApproachTemp_SCH')) # This is under fully open configuration assumption, based on the lookup table in scorecard
      it_equipment_def.setReturnTemperatureDifferenceSchedule(model_add_schedule(model, 'SmallDataCenterLowITE 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_crac_supply_temp_sch(model) ⇒ OpenStudio::Model::Schedule

get CRAC supply air temperature schedule

Parameters:

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

    OpenStudio model object

Returns:

  • (OpenStudio::Model::Schedule) —

    supply temperature schedule object



91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.SmallDataCenterLowITE.rb', line 91

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

    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



150
151
152
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.SmallDataCenterLowITE.rb', line 150

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

    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
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.SmallDataCenterLowITE.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 CRAC supply air setpoint manager
  # modify_crac_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) —

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

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

#modify_crac_sa_stpt_manager(model) ⇒ Boolean

modify CRAC supply air setpoint manager

Parameters:

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

    OpenStudio model object

Returns:

  • (Boolean) —

    returns true if successful, false if not



77
78
79
80
81
82
83
84
85
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.SmallDataCenterLowITE.rb', line 77

def modify_crac_sa_stpt_manager(model)
  supply_temp_sch = get_crac_supply_temp_sch(model)
  model.getSetpointManagerScheduleds.each do |stpt_manager|
    next unless stpt_manager.name.to_s.downcase == 'crac supply air setpoint manager'

    stpt_manager.setSchedule(supply_temp_sch)
  end
  return true
end