# ******************************************************************************* # Honeybee OpenStudio Gem, Copyright (c) 2020, Alliance for Sustainable # Energy, LLC, Ladybug Tools LLC and other contributors. All rights reserved. # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # (1) Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # (2) Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # (3) Neither the name of the copyright holder nor the names of any contributors # may be used to endorse or promote products derived from this software without # specific prior written permission from the respective party. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) AND ANY CONTRIBUTORS # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, # THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S), ANY CONTRIBUTORS, THE # UNITED STATES GOVERNMENT, OR THE UNITED STATES DEPARTMENT OF ENERGY, NOR ANY OF # THEIR EMPLOYEES, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, # EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT # OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, # STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY # OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. # ******************************************************************************* require 'honeybee/geometry/room' require 'to_openstudio/model_object' module Honeybee class Room attr_reader :unique_space_type def find_existing_openstudio_object(openstudio_model) model_space = openstudio_model.getSpaceByName(@hash[:identifier]) return model_space.get unless model_space.empty? nil end def get_unique_space_type(openstudio_model, os_space) # get a space type that is unique to the room if @unique_space_type.nil? space_type = os_space.spaceType unless space_type.empty? # copy the space type that is already assigned to the room space_type_object = space_type.get space_type_mod_obj = space_type_object.clone(openstudio_model) new_space_type = space_type_mod_obj.to_SpaceType.get # give the space type a new unique name and assign it to the room st_name = space_type_object.name unless space_type.empty? st_name = st_name.get else st_name = 'CustomSpaceType' end else # create a new space type as there is currently none assigned to the room new_space_type = OpenStudio::Model::SpaceType.new(openstudio_model) st_name = 'CustomSpaceType' end new_space_type.setName(st_name + '_' + @hash[:identifier]) os_space.setSpaceType(new_space_type) @unique_space_type = new_space_type end @unique_space_type end def to_openstudio(openstudio_model) # create the space and thermal zone os_space = OpenStudio::Model::Space.new(openstudio_model) os_space.setName(@hash[:identifier]) os_thermal_zone = OpenStudio::Model::ThermalZone.new(openstudio_model) os_thermal_zone.setName(@hash[:identifier]) os_space.setThermalZone(os_thermal_zone) # assign the programtype if @hash[:properties][:energy][:program_type] space_type = openstudio_model.getSpaceTypeByName(@hash[:properties][:energy][:program_type]) unless space_type.empty? space_type_object = space_type.get os_space.setSpaceType(space_type_object) end end # assign the constructionset if @hash[:properties][:energy][:construction_set] construction_set_identifier = @hash[:properties][:energy][:construction_set] # gets default construction set assigned to room from openstudio_model construction_set = openstudio_model.getDefaultConstructionSetByName(construction_set_identifier) unless construction_set.empty? default_construction_set = construction_set.get os_space.setDefaultConstructionSet(default_construction_set) end end # assign the multiplier if @hash[:multiplier] and @hash[:multiplier] != 1 os_thermal_zone.setMultiplier(@hash[:multiplier]) end # assign the story if @hash[:story] # the users has specified the name of the story story = openstudio_model.getBuildingStoryByName(@hash[:story]) if story.empty? # first time that this story has been referenced story = OpenStudio::Model::BuildingStory.new(openstudio_model) story.setName(@hash[:story]) else story = story.get end else # give the room a dummy story so that it works with David's measures story = openstudio_model.getBuildingStoryByName('UndefiniedStory') if story.empty? # first time that this story has been referenced story = OpenStudio::Model::BuildingStory.new(openstudio_model) story.setName('UndefiniedStory') else story = story.get end end os_space.setBuildingStory(story) # keep track of all window ventilation objects window_vent = {} # assign all of the faces to the room @hash[:faces].each do |face| ladybug_face = Face.new(face) os_surface = ladybug_face.to_openstudio(openstudio_model) os_surface.setSpace(os_space) # assign face-level shades if they exist if face[:outdoor_shades] os_shd_group = make_shade_group(openstudio_model, os_surface, os_space) face[:outdoor_shades].each do |outdoor_shade| add_shade_to_group(openstudio_model, os_shd_group, outdoor_shade) end end # assign aperture-level shades if they exist if face[:apertures] face[:apertures].each do |aperture| if aperture[:properties][:energy][:vent_opening] window_vent[aperture[:identifier]] = \ [aperture[:properties][:energy][:vent_opening], aperture[:boundary_condition][:type]] end if aperture[:outdoor_shades] unless os_shd_group os_shd_group = make_shade_group(openstudio_model, os_surface, os_space) end aperture[:outdoor_shades].each do |outdoor_shade| add_shade_to_group(openstudio_model, os_shd_group, outdoor_shade) end end end end # assign door-level shades if they exist if face[:doors] face[:doors].each do |door| if door[:properties][:energy][:vent_opening] window_vent[door[:identifier]] = \ [door[:properties][:energy][:vent_opening], door[:boundary_condition][:type]] end if door[:outdoor_shades] unless os_shd_group os_shd_group = make_shade_group(openstudio_model, os_surface, os_space) end door[:outdoor_shades].each do |outdoor_shade| add_shade_to_group(openstudio_model, os_shd_group, outdoor_shade) end end end end if !face[:properties][:energy][:construction] if face[:boundary_condition][:type] == 'Adiabatic' # assign default interior construciton for Adiabatic Faces if face[:face_type] != 'Wall' interior_construction = closest_interior_construction(openstudio_model, os_space, face[:face_type]) unless interior_construction.nil? os_surface.setConstruction(interior_construction) end end elsif face[:face_type] == 'AirBoundary' # assign default air boundary construciton for AirBoundary face types air_construction = closest_air_construction(openstudio_model, os_space) unless air_construction.nil? os_surface.setConstruction(air_construction) end # add air mixing properties to the global list that tracks them if $use_simple_vent # only use air mixing objects when simple ventilation is requested air_hash = $air_boundary_hash[air_construction.name.to_s] if air_hash[:air_mixing_per_area] air_mix_area = air_hash[:air_mixing_per_area] else air_default = @@schema[:components][:schemas][:AirBoundaryConstructionAbridged] air_mix_area = air_default[:properties][:air_mixing_per_area][:default] end flow_rate = os_surface.netArea * air_mix_area flow_sch_id = air_hash[:air_mixing_schedule] adj_zone_id = face[:boundary_condition][:boundary_condition_objects][-1] $air_mxing_array << [os_thermal_zone, flow_rate, flow_sch_id, adj_zone_id] end end end end # assign any room-level outdoor shades if they exist if @hash[:outdoor_shades] os_shd_group = OpenStudio::Model::ShadingSurfaceGroup.new(openstudio_model) os_shd_group.setSpace(os_space) os_shd_group.setShadingSurfaceType("Space") @hash[:outdoor_shades].each do |outdoor_shade| add_shade_to_group(openstudio_model, os_shd_group, outdoor_shade) end end #check whether there are any load objects on the room overriding the programtype if @hash[:properties][:energy][:people] unique_program = get_unique_space_type(openstudio_model, os_space) unique_program_ppl = unique_program.people unless unique_program_ppl.empty? # remove the previous load definition unique_program_ppl[0].remove() end custom_people = PeopleAbridged.new(@hash[:properties][:energy][:people]) os_custom_people = custom_people.to_openstudio(openstudio_model) os_custom_people.setSpaceType(unique_program) # assign the new load definition end # assign lighting if it exists if @hash[:properties][:energy][:lighting] unique_program = get_unique_space_type(openstudio_model, os_space) unique_program_lght = unique_program.lights unless unique_program_lght.empty? # remove the previous load definition unique_program_lght[0].remove() end custom_lighting = LightingAbridged.new(@hash[:properties][:energy][:lighting]) os_custom_lighting = custom_lighting.to_openstudio(openstudio_model) os_custom_lighting.setSpaceType(unique_program) # assign the new load definition end # assign electric equipment if it exists if @hash[:properties][:energy][:electric_equipment] unique_program = get_unique_space_type(openstudio_model, os_space) unique_program_ele = unique_program.electricEquipment unless unique_program_ele.empty? # remove the previous load definition unique_program_ele[0].remove() end custom_electric_equipment = ElectricEquipmentAbridged.new(@hash[:properties][:energy][:electric_equipment]) os_custom_electric_equipment = custom_electric_equipment.to_openstudio(openstudio_model) os_custom_electric_equipment.setSpaceType(unique_program) # assign the new load definition end # assign gas equipment if it exists if @hash[:properties][:energy][:gas_equipment] unique_program = get_unique_space_type(openstudio_model, os_space) unique_program_gas = unique_program.gasEquipment unless unique_program_gas.empty? # remove the previous load definition unique_program_gas[0].remove() end custom_gas_equipment = GasEquipmentAbridged.new(@hash[:properties][:energy][:gas_equipment]) os_custom_gas_equipment = custom_gas_equipment.to_openstudio(openstudio_model) os_custom_gas_equipment.setSpaceType(unique_program) # assign the new load definition end # assign service hot water if it exists if @hash[:properties][:energy][:service_hot_water] shw_space = ServiceHotWaterAbridged.new(@hash[:properties][:energy][:service_hot_water]) os_shw_space = shw_space.to_openstudio(openstudio_model, os_space) $shw_for_plant = shw_space end # assign infiltration if it exists if @hash[:properties][:energy][:infiltration] && $use_simple_vent # only use infiltration with simple ventilation unique_program = get_unique_space_type(openstudio_model, os_space) unique_program_inf = unique_program.spaceInfiltrationDesignFlowRates unless unique_program_inf.empty? # remove the previous load definition unique_program_inf[0].remove() end custom_infiltration = InfiltrationAbridged.new(@hash[:properties][:energy][:infiltration]) os_custom_infiltration = custom_infiltration.to_openstudio(openstudio_model) os_custom_infiltration.setSpaceType(unique_program) # assign the new load definition end # assign ventilation if it exists if @hash[:properties][:energy][:ventilation] unique_program = get_unique_space_type(openstudio_model, os_space) unique_program.resetDesignSpecificationOutdoorAir() custom_ventilation = VentilationAbridged.new(@hash[:properties][:energy][:ventilation]) os_custom_ventilation = custom_ventilation.to_openstudio(openstudio_model) unique_program.setDesignSpecificationOutdoorAir(os_custom_ventilation) end # assign setpoint if it exists if @hash[:properties][:energy][:setpoint] # thermostat object is created because heating and cooling schedule are required setpoint_thermostat_space = SetpointThermostat.new(@hash[:properties][:energy][:setpoint]) os_setpoint_thermostat_space = setpoint_thermostat_space.to_openstudio(openstudio_model) #set thermostat to thermal zone os_thermal_zone.setThermostatSetpointDualSetpoint(os_setpoint_thermostat_space) # humidistat object is created if humidifying or dehumidifying schedule is specified if @hash[:properties][:energy][:setpoint][:humidifying_schedule] or @hash[:properties][:energy][:setpoint][:dehumidifying_schedule] setpoint_humidistat_space = SetpointHumidistat.new(@hash[:properties][:energy][:setpoint]) os_setpoint_humidistat_space = setpoint_humidistat_space.to_openstudio(openstudio_model) os_thermal_zone.setZoneControlHumidistat(os_setpoint_humidistat_space) end end # assign daylight control if it exists if @hash[:properties][:energy][:daylighting_control] dl_control = DaylightingControl.new(@hash[:properties][:energy][:daylighting_control]) os_dl_control = dl_control.to_openstudio(openstudio_model, os_thermal_zone, os_space) end # assign window ventilation objects if they exist if $use_simple_vent && !window_vent.empty? # write simple WindAndStack ventilation window_vent.each do |sub_f_id, open_prop| opening = open_prop[0] bc = open_prop[1] if bc == 'Outdoors' opt_sub_f = openstudio_model.getSubSurfaceByName(sub_f_id) unless opt_sub_f.empty? sub_f = opt_sub_f.get vent_open = VentilationOpening.new(opening) os_vent_open = vent_open.to_openstudio( openstudio_model, sub_f, @hash[:properties][:energy][:window_vent_control]) os_vent_open.addToThermalZone(os_thermal_zone) end end end elsif !$use_simple_vent # we're using the AFN! # write an AirflowNetworkZone object in for the Room os_afn_room_node = os_thermal_zone.getAirflowNetworkZone os_afn_room_node.setVentilationControlMode('NoVent') # write the opening objects for each Aperture / Door operable_subfs = [] # collect the sub-face objects for the EMS opening_factors = [] # collect the maximum opening factors for the EMS window_vent.each do |sub_f_id, open_prop| opening = open_prop[0] opt_sub_f = openstudio_model.getSubSurfaceByName(sub_f_id) unless opt_sub_f.empty? sub_f = opt_sub_f.get if sub_f.adjacentSubSurface.empty? # not an interior window that's already in the AFN vent_open = VentilationOpening.new(opening) open_fac = vent_open.to_openstudio_afn(openstudio_model, sub_f) operable_subfs << sub_f opening_factors << open_fac end end end # add the control startegy of the ventilation openings using the EMS if @hash[:properties][:energy][:window_vent_control] vent_control = VentilationControlAbridged.new(@hash[:properties][:energy][:window_vent_control]) vent_control.to_openstudio( openstudio_model, os_thermal_zone, operable_subfs, opening_factors) end end os_space end # method to make a space-assigned Shade group for shades assigned to parent objects def make_shade_group(openstudio_model, os_surface, os_space) os_shd_group = OpenStudio::Model::ShadingSurfaceGroup.new(openstudio_model) os_shd_group.setShadedSurface(os_surface) os_shd_group.setSpace(os_space) os_shd_group.setShadingSurfaceType("Space") os_shd_group end # method to create a Shade and add it to a shade group def add_shade_to_group(openstudio_model, os_shd_group, outdoor_shade) hb_outdoor_shade = Shade.new(outdoor_shade) os_outdoor_shade = hb_outdoor_shade.to_openstudio(openstudio_model) os_outdoor_shade.setShadingSurfaceGroup(os_shd_group) end # method to check for the closest-assigned interior ceiling or floor construction def closest_interior_construction(openstudio_model, os_space, surface_type) # first check the space-assigned construction set constr_set_space = os_space.defaultConstructionSet unless constr_set_space.empty? constr_set_space_object = constr_set_space.get default_interior_srf_set = constr_set_space_object.defaultInteriorSurfaceConstructions unless default_interior_srf_set.empty? default_interior_srf_set = default_interior_srf_set.get if surface_type == 'RoofCeiling' interior_construction = default_interior_srf_set.roofCeilingConstruction else interior_construction = default_interior_srf_set.floorConstruction end unless interior_construction.empty? return interior_construction.get end end end # if no construction was found, check the building-assigned construction set building = openstudio_model.building unless building.empty? building = building.get construction_set_bldg = building.defaultConstructionSet unless construction_set_bldg.empty? construction_set_bldg_object = construction_set_bldg.get default_interior_srf_set = construction_set_bldg_object.defaultInteriorSurfaceConstructions unless default_interior_srf_set.empty? default_interior_srf_set = default_interior_srf_set.get if surface_type == 'RoofCeiling' interior_construction = default_interior_srf_set.roofCeilingConstruction else interior_construction = default_interior_srf_set.floorConstruction end unless interior_construction.empty? return interior_construction.get end end end end nil # no construction was found end # method to check for the closest-assigned air boundary construction def closest_air_construction(openstudio_model, os_space) # first check the space-assigned construction set constr_set_ref = os_space.defaultConstructionSet unless constr_set_ref.empty? constr_set_space = constr_set_ref.get air_constr_ref = constr_set_space.interiorPartitionConstruction unless air_constr_ref.empty? return air_constr_ref.get end end # if no construction was found, check the building-assigned construction set building_ref = openstudio_model.building unless building_ref.empty? building = building_ref.get constr_set_bldg_ref = building.defaultConstructionSet unless constr_set_bldg_ref.empty? constr_set_bldg = constr_set_bldg_ref.get air_constr_ref = constr_set_bldg.interiorPartitionConstruction unless air_constr_ref.empty? return air_constr_ref.get end end end end end #Room end #Honeybee