# ******************************************************************************* # 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 'from_honeybee/model_object' require 'from_honeybee/geometry/face' require 'from_honeybee/geometry/shade' require 'from_honeybee/load/people' require 'from_honeybee/load/lighting' require 'from_honeybee/load/electric_equipment' require 'from_honeybee/load/gas_equipment' require 'from_honeybee/load/infiltration' require 'from_honeybee/load/ventilation' require 'from_honeybee/load/setpoint_thermostat' require 'from_honeybee/load/setpoint_humidistat' require 'openstudio' module FromHoneybee class Room < ModelObject attr_reader :errors, :warnings def initialize(hash = {}) super(hash) raise "Incorrect model type '#{@type}'" unless @type == 'Room' end def defaults @@schema[:components][:schemas][:RoomEnergyPropertiesAbridged][:properties] end 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 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) # 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[: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[: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 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 # 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] people = openstudio_model.getPeopleByName(@hash[:properties][:energy][:people][:identifier]) unless people.empty? people_object = people.get people_object.setSpace(os_space) else people_space = PeopleAbridged.new(@hash[:properties][:energy][:people]) os_people_space = people_space.to_openstudio(openstudio_model) os_people_space.setSpace(os_space) end end # assign lighting if it exists if @hash[:properties][:energy][:lighting] lighting = openstudio_model.getLightsByName(@hash[:properties][:energy][:lighting][:identifier]) unless lighting.empty? lighting_object = lighting.get lighting_object.setSpace(os_space) else lighting_space = LightingAbridged.new(@hash[:properties][:energy][:lighting]) os_lighting_space = lighting_space.to_openstudio(openstudio_model) os_lighting_space.setSpace(os_space) end end # assign electric equipment if it exists if @hash[:properties][:energy][:electric_equipment] electric_equipment = openstudio_model.getElectricEquipmentByName( @hash[:properties][:energy][:electric_equipment][:identifier]) unless electric_equipment.empty? electric_equipment_object = electric_equipment.get electric_equipment_object.setSpace(os_space) else electric_equipment_space = ElectricEquipmentAbridged.new(@hash[:properties][:energy][:electric_equipment]) os_electric_equipment_space = electric_equipment_space.to_openstudio(openstudio_model) os_electric_equipment_space.setSpace(os_space) end end # assign gas equipment if it exists if @hash[:properties][:energy][:gas_equipment] gas_equipment = openstudio_model.getGasEquipmentByName( @hash[:properties][:energy][:gas_equipment][:identifier]) unless gas_equipment.empty? gas_equipment_object = gas_equipment.get gas_equipment_object.setSpace(os_space) else gas_equipment_space = GasEquipmentAbridged.new(@hash[:properties][:energy][:gas_equipment]) os_gas_equipment_space = gas_equipment_space.to_openstudio(openstudio_model) os_gas_equipment_space.setSpace(os_space) end end # assign infiltration if it exists if @hash[:properties][:energy][:infiltration] infiltration = openstudio_model.getSpaceInfiltrationDesignFlowRateByName( @hash[:properties][:energy][:infiltration][:identifier]) unless infiltration.empty? infiltration_object = infiltration.get infiltration_object.setSpace(os_space) else infiltration_space = InfiltrationAbridged.new(@hash[:properties][:energy][:infiltration]) os_infiltration_space = infiltration_space.to_openstudio(openstudio_model) os_infiltration_space.setSpace(os_space) end end # assign ventilation if it exists if @hash[:properties][:energy][:ventilation] ventilation = openstudio_model.getDesignSpecificationOutdoorAirByName( @hash[:properties][:energy][:ventilation][:identifier]) unless ventilation.empty? ventilation_object = ventilation.get ventilation_object.setSpace(os_space) else ventilation_space = VentilationAbridged.new(@hash[:properties][:energy][:ventilation]) os_ventilation_space = ventilation_space.to_openstudio(openstudio_model) os_space.setDesignSpecificationOutdoorAir(os_ventilation_space) end end # assign setpoint if it exists if @hash[:properties][:energy][:setpoint] #thermostat object is created because heating and cooling schedule are required #fields. 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 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 #FromHoneybee