# Custom changes for the MediumOffice prototype. # These are changes that are inconsistent with other prototype building types. module MediumOfficeDetailed # hvac adjustments specific to the prototype model # # @param model [OpenStudio::Model::Model] OpenStudio model object # @param building_type [String the building type # @param climate_zone [String] ASHRAE climate zone, e.g. 'ASHRAE 169-2013-4A' # @param prototype_input [Hash] hash of prototype inputs # @return [Boolean] returns true if successful, false if not def model_custom_hvac_tweaks(model, building_type, climate_zone, prototype_input) OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Model', 'Started building type specific adjustments') model.getSpaces.sort.each do |space| if space.name.get.to_s == 'Lobby_Bot' model_add_elevator(model, space, prototype_input['number_of_elevators'], prototype_input['elevator_type'], prototype_input['elevator_schedule'], prototype_input['elevator_fan_schedule'], prototype_input['elevator_fan_schedule'], building_type) end end OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Model', 'Finished building type specific adjustments') # add extra infiltration for entry door add_door_infiltration(climate_zone, model) OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Model', 'Added door infiltration') return true end # add door infiltration # # @param climate_zone [String] ASHRAE climate zone, e.g. 'ASHRAE 169-2013-4A' # @param model [OpenStudio::Model::Model] OpenStudio model object # @return [Boolean] returns true if successful, false if not def add_door_infiltration(climate_zone, model) # add extra infiltration for entry door in m3/s (there is no attic in 'DOE Ref Pre-1980') return false if template == 'DOE Ref 1980-2004' || template == 'DOE Ref Pre-1980' entry_space = model.getSpaceByName('Lounge_Bot').get infiltration_entrydoor = OpenStudio::Model::SpaceInfiltrationDesignFlowRate.new(model) infiltration_entrydoor.setName('entry door Infiltration') infiltration_per_zone_entrydoor = 0 if template == '90.1-2004' infiltration_per_zone_entrydoor = 1.04300287 infiltration_entrydoor.setSchedule(model_add_schedule(model, 'OfficeMedium INFIL_Door_Opening_SCH')) elsif template == '90.1-2007' || template == '90.1-2010' || template == '90.1-2013' || template == '90.1-2016' || template == '90.1-2019' case climate_zone when 'ASHRAE 169-2006-1A', 'ASHRAE 169-2006-2A', 'ASHRAE 169-2006-1B', 'ASHRAE 169-2006-2B' infiltration_per_zone_entrydoor = 1.04300287 infiltration_entrydoor.setSchedule(model_add_schedule(model, 'OfficeMedium INFIL_Door_Opening_SCH')) else infiltration_per_zone_entrydoor = 0.678659786 infiltration_entrydoor.setSchedule(model_add_schedule(model, 'OfficeMedium INFIL_Door_Opening_SCH')) end end infiltration_entrydoor.setDesignFlowRate(infiltration_per_zone_entrydoor) infiltration_entrydoor.setSpace(entry_space) return true end # # daylighting adjustments specific to the prototype model # # # # @param model [OpenStudio::Model::Model] OpenStudio model object # # @param building_type [String the building type # # @param climate_zone [String] ASHRAE climate zone, e.g. 'ASHRAE 169-2013-4A' # # @param prototype_input [Hash] hash of prototype inputs # # @return [Boolean] returns true if successful, false if not # def model_custom_daylighting_tweaks(model, building_type, climate_zone, prototype_input) # OpenStudio.logFree(OpenStudio::Info, 'openstudio.model.Model', 'Adjusting daylight sensor positions and fractions') # # adjustments = [ # { 'stds_spc_type' => 'WholeBuilding - Md Office', # 'sensor_1_frac' => 0.3835, # 'sensor_2_frac' => 0.1395 } # ] # # # Adjust daylight sensors in each space # model.getSpaces.each do |space| # 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 # adjustments.each do |adj| # next unless adj['stds_spc_type'] == stds_spc_type # # 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 # end # end # end # return true # end # update water heater loss coefficient # # @param model [OpenStudio::Model::Model] OpenStudio model object # @return [Boolean] returns true if successful, false if not 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(7.561562668) water_heater.setOnCycleLossCoefficienttoAmbientTemperature(7.561562668) end end return true end # swh adjustments specific to the prototype model # # @param model [OpenStudio::Model::Model] OpenStudio model object # @param building_type [String the building type # @param climate_zone [String] ASHRAE climate zone, e.g. 'ASHRAE 169-2013-4A' # @param prototype_input [Hash] hash of prototype inputs # @return [Boolean] returns true if successful, false if not def model_custom_swh_tweaks(model, building_type, climate_zone, prototype_input) update_waterheater_loss_coefficient(model) return true end # geometry adjustments specific to the prototype model # # @param model [OpenStudio::Model::Model] OpenStudio model object # @param building_type [String the building type # @param climate_zone [String] ASHRAE climate zone, e.g. 'ASHRAE 169-2013-4A' # @param prototype_input [Hash] hash of prototype inputs # @return [Boolean] returns true if successful, false if not 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 # @!group AirTerminalSingleDuctVAVReheat # 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 # # @param air_terminal_single_duct_vav_reheat [OpenStudio::Model::AirTerminalSingleDuctVAVReheat] the air terminal object # @param zone_oa_per_area [Double] the zone outdoor air per area in m^3/s*m^2 # @return [Boolean] returns true if successful, false if not 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 end