Module: RetailStandalone

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

Overview

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

Instance Method Summary collapse

Instance Method Details

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



108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
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
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.RetailStandalone.rb', line 108

def model_custom_daylighting_tweaks(building_type, climate_zone, prototype_input, model)
  OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Model', 'Adjusting daylight sensor positions and fractions')

  adjustments = case climate_zone
  when 'ASHRAE 169-2006-6A',
      'ASHRAE 169-2006-6B',
      'ASHRAE 169-2006-7A',
      'ASHRAE 169-2006-8A',
      'ASHRAE 169-2013-6A',
      'ASHRAE 169-2013-6B',
      'ASHRAE 169-2013-7A',
      'ASHRAE 169-2013-8A'
    [
      { '90.1-2010' => { 'Core_Retail' => { 'sensor_1_frac' => 0.1724,
                                            'sensor_1_xyz' => [9.144, 24.698, 0] } },
        '90.1-2013' => { 'Core_Retail' => { 'sensor_1_frac' => 0.1724,
                                            'sensor_1_xyz' => [9.144, 24.698, 0] } },
        '90.1-2016' => { 'Core_Retail' => { 'sensor_1_frac' => 0.1724,
                                            'sensor_1_xyz' => [9.144, 24.698, 0] } },
        '90.1-2019' => { 'Core_Retail' => { 'sensor_1_frac' => 0.1724,
                                            'sensor_1_xyz' => [9.144, 24.698, 0] } } }
    ]
  else
    [
      { '90.1-2010' => { 'Core_Retail' => { 'sensor_1_frac' => 0.25,
                                            'sensor_2_frac' => 0.25,
                                            'sensor_1_xyz' => [14.2, 14.2, 0],
                                            'sensor_2_xyz' => [3.4, 14.2, 0] } },
        '90.1-2013' => { 'Core_Retail' => { 'sensor_1_frac' => 0.25,
                                            'sensor_2_frac' => 0.25,
                                            'sensor_1_xyz' => [14.2, 14.2, 0],
                                            'sensor_2_xyz' => [3.4, 14.2, 0] } },
        '90.1-2016' => { 'Core_Retail' => { 'sensor_1_frac' => 0.25,
                                            'sensor_2_frac' => 0.25,
                                            'sensor_1_xyz' => [14.2, 14.2, 0],
                                            'sensor_2_xyz' => [3.4, 14.2, 0] } },
        '90.1-2019' => { 'Core_Retail' => { 'sensor_1_frac' => 0.25,
                                            'sensor_2_frac' => 0.25,
                                            'sensor_1_xyz' => [14.2, 14.2, 0],
                                            'sensor_2_xyz' => [3.4, 14.2, 0] } } }
    ]
      end

  # Adjust daylight sensors in each space
  model.getSpaces.each do |space|
    if adjustments[0].keys.include? template
      if adjustments[0][template].keys.include? space.name.to_s
        adj = adjustments[0][template][space.name.to_s]
        next if space.thermalZone.empty?

        zone = space.thermalZone.get
        next if space.spaceType.empty?

        spc_type = space.spaceType.get
        next if spc_type.standardsSpaceType.empty?

        stds_spc_type = spc_type.standardsSpaceType.get
        # Adjust the primary sensor
        if adj['sensor_1_frac'] && zone.primaryDaylightingControl.is_initialized
          OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Model', "For #{zone.name}: Adjusting primary daylight sensor to control #{adj['sensor_1_frac']} of the lighting.")
          zone.setFractionofZoneControlledbyPrimaryDaylightingControl(adj['sensor_1_frac'])
          pri_ctrl = zone.primaryDaylightingControl.get
          if adj['sensor_1_xyz']
            x = adj['sensor_1_xyz'][0]
            y = adj['sensor_1_xyz'][1]
            z = adj['sensor_1_xyz'][2]
            OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Model', "For #{zone.name}: Adjusting primary daylight sensor position to [#{x}, #{y}, #{z}].")
            pri_ctrl.setPositionXCoordinate(x)
            pri_ctrl.setPositionYCoordinate(y)
            pri_ctrl.setPositionZCoordinate(z)
          end
        end
        # Adjust the secondary sensor
        if adj['sensor_2_frac'] && zone.secondaryDaylightingControl.is_initialized
          OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Model', "For #{zone.name}: Adjusting secondary daylight sensor to control #{adj['sensor_2_frac']} of the lighting.")
          zone.setFractionofZoneControlledbySecondaryDaylightingControl(adj['sensor_2_frac'])
          sec_ctrl = zone.secondaryDaylightingControl.get
          if adj['sensor_2_xyz']
            x = adj['sensor_2_xyz'][0]
            y = adj['sensor_2_xyz'][1]
            z = adj['sensor_2_xyz'][2]
            OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Model', "For #{zone.name}: Adjusting secondary daylight sensor position to [#{x}, #{y}, #{z}].")
            sec_ctrl.setPositionXCoordinate(x)
            sec_ctrl.setPositionYCoordinate(y)
            sec_ctrl.setPositionZCoordinate(z)
          end
        elsif zone.secondaryDaylightingControl.is_initialized
          sec_ctrl = zone.secondaryDaylightingControl.get
          sec_ctrl.remove
          zone.resetFractionofZoneControlledbySecondaryDaylightingControl
          zone.resetSecondaryDaylightingControl
        end
      end
    end
  end
end

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



209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.RetailStandalone.rb', line 209

def model_custom_geometry_tweaks(building_type, climate_zone, prototype_input, model)
  # Set original building North axis
  model_set_building_north_axis(model, 0.0)

  OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Model', 'Adjusting geometry input')
  case template
  when '90.1-2010', '90.1-2013', '90.1-2016', '90.1-2019'
    case climate_zone
    when 'ASHRAE 169-2006-6A',
        'ASHRAE 169-2006-6B',
        'ASHRAE 169-2006-7A',
        'ASHRAE 169-2006-8A',
        'ASHRAE 169-2013-6A',
        'ASHRAE 169-2013-6B',
        'ASHRAE 169-2013-7A',
        'ASHRAE 169-2013-8A'
      # Remove existing skylights
      model.getSubSurfaces.each do |subsurf|
        if subsurf.subSurfaceType.to_s == 'Skylight'
          subsurf.remove
        end
      end
      # Load older geometry corresponding to older code versions
      old_geo = load_geometry_osm('geometry/ASHRAE90120042007RetailStandalone.osm')
      # Clone the skylights from the older geometry
      old_geo.getSubSurfaces.each do |subsurf|
        if subsurf.subSurfaceType.to_s == 'Skylight'
          new_skylight = subsurf.clone(model).to_SubSurface.get
          old_roof = subsurf.surface.get
          # Assign surfaces to skylights
          model.getSurfaces.each do |model_surf|
            if model_surf.name.to_s == old_roof.name.to_s
              new_skylight.setSurface(model_surf)
            end
          end
        end
      end
    end
  end
  return true
end

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

TODO: The ElectricEquipment schedules are wrong in OpenStudio Standards… It needs to be ‘RetailStandalone BLDG_EQUIP_SCH’ for 90.1-2010 at least but probably all TODO: There is an OpenStudio bug where two heat exchangers are on the equipment list and it references the same single heat exchanger for both. This doubles the heat recovery energy. TODO: The HeatExchangerAirToAir is not calculating correctly. It does not equal the legacy IDF and has higher energy usage due to that. TODO: Need to determine if WaterHeater can be alone or if we need to ‘fake’ it.



10
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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.RetailStandalone.rb', line 10

def model_custom_hvac_tweaks(building_type, climate_zone, prototype_input, model)
  OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Model', 'Started building type specific adjustments')

  # Add the door infiltration for template 2004,2007,2010,2013,2016,2019
  case template
  when '90.1-2004'
    entry_space = model.getSpaceByName('Front_Entry').get
    infiltration_entry = OpenStudio::Model::SpaceInfiltrationDesignFlowRate.new(model)
    infiltration_entry.setName('Entry door Infiltration')
    infiltration_per_zone = 1.418672682
    infiltration_entry.setDesignFlowRate(infiltration_per_zone)
    infiltration_entry.setSchedule(model_add_schedule(model, 'RetailStandalone INFIL_Door_Opening_SCH'))
    infiltration_entry.setSpace(entry_space)

    # temporal solution for CZ dependent door infiltration rate.  In fact other standards need similar change as well
  when '90.1-2007', '90.1-2010', '90.1-2013', '90.1-2016', '90.1-2019'
    entry_space = model.getSpaceByName('Front_Entry').get
    infiltration_entry = OpenStudio::Model::SpaceInfiltrationDesignFlowRate.new(model)
    infiltration_entry.setName('Entry door Infiltration')
    case climate_zone
    when 'ASHRAE 169-2006-0A',
        'ASHRAE 169-2006-1A',
        'ASHRAE 169-2006-0B',
        'ASHRAE 169-2006-1B',
        'ASHRAE 169-2006-2A',
        'ASHRAE 169-2006-2B',
        'ASHRAE 169-2013-0A',
        'ASHRAE 169-2013-1A',
        'ASHRAE 169-2013-0B',
        'ASHRAE 169-2013-1B',
        'ASHRAE 169-2013-2A',
        'ASHRAE 169-2013-2B'
      infiltration_per_zone = 1.418672682
      infiltration_entry.setSchedule(model_add_schedule(model, 'RetailStandalone INFIL_Door_Opening_SCH'))
    else
      infiltration_per_zone = 0.937286742
      infiltration_entry.setSchedule(model_add_schedule(model, 'RetailStandalone INFIL_Door_Opening_SCH_2013'))
    end
    infiltration_entry.setDesignFlowRate(infiltration_per_zone)
    infiltration_entry.setSpace(entry_space)
  end

  # add these additional coefficient inputs
  if infiltration_entry
    infiltration_entry.setConstantTermCoefficient(1.0)
    infiltration_entry.setTemperatureTermCoefficient(0.0)
    infiltration_entry.setVelocityTermCoefficient(0.0)
    infiltration_entry.setVelocitySquaredTermCoefficient(0.0)
  end

  case template
  when '90.1-2013', '90.1-2016', '90.1-2019'
    # Add EMS for controlling the system serving the front entry zone
    oa_sens = OpenStudio::Model::EnergyManagementSystemSensor.new(model, 'Site Outdoor Air Drybulb Temperature')
    oa_sens.setName('OAT_F')
    oa_sens.setKeyName('Environment')

    model.getFanConstantVolumes.each do |fan|
      if fan.name.to_s.include?('Front') && fan.name.to_s.include?('Entry')
        frt_entry_avail_fan_sch = fan.availabilitySchedule
        frt_entry_fan = OpenStudio::Model::EnergyManagementSystemActuator.new(frt_entry_avail_fan_sch, 'Schedule:Year', 'Schedule Value')
        frt_entry_fan.setName('FrontEntry_Fan')
      end
    end

    model.getCoilHeatingGass.each do |coil|
      if coil.name.to_s.include?('Front') && coil.name.to_s.include?('Entry')
        frt_entry_avail_coil_sch = coil.availabilitySchedule
        frt_entry_coil = OpenStudio::Model::EnergyManagementSystemActuator.new(frt_entry_avail_coil_sch, 'Schedule:Year', 'Schedule Value')
        frt_entry_coil.setName('FrontEntry_Coil')
      end
    end

    frt_entry_prg = OpenStudio::Model::EnergyManagementSystemProgram.new(model)
    frt_entry_prg.setName('FrontEntry_HeaterControl')
    frt_entry_prg_body = <<-EMS
    SET OAT_F = (OAT_F*1.8)+32
    IF OAT_F > 45
      SET FrontEntry_Coil = 0
      SET FrontEntry_Fan = 0
    ELSE
    SET FrontEntry_Coil = 1
    SET FrontEntry_Fan = 1
    ENDIF
    EMS
    frt_entry_prg.setBody(frt_entry_prg_body)

    prg_mgr = OpenStudio::Model::EnergyManagementSystemProgramCallingManager.new(model)
    prg_mgr.setName('FrontEntry_HeaterManager')
    prg_mgr.setCallingPoint('BeginTimestepBeforePredictor')
    prg_mgr.addProgram(frt_entry_prg)
  end

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



205
206
207
 
# File 'lib/openstudio-standards/prototypes/common/buildings/Prototype.RetailStandalone.rb', line 205

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