honeybee-openstudio 1.8.1

data/lib/from_honeybee/hvac/ideal_air.rb

@@ -0,0 +1,150 @@
+# *******************************************************************************
+# 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/extension'
+require 'from_honeybee/model_object'
+
+module FromHoneybee
+  class IdealAirSystemAbridged < ModelObject
+    attr_reader :errors, :warnings
+
+    def initialize(hash = {})
+      super(hash)
+      raise "Incorrect model type '#{@type}'" unless @type == 'IdealAirSystemAbridged'
+    end
+  
+    def defaults
+      @@schema[:components][:schemas][:IdealAirSystemAbridged][:properties]
+    end
+
+    def to_openstudio(openstudio_model)
+      # create the ideal air system and set the identifier
+      os_ideal_air = OpenStudio::Model::ZoneHVACIdealLoadsAirSystem.new(openstudio_model)
+      os_ideal_air.setName(@hash[:identifier])
+      
+      # assign the economizer type
+      if @hash[:economizer_type]
+        os_ideal_air.setOutdoorAirEconomizerType(@hash[:economizer_type])
+      else
+        os_ideal_air.setOutdoorAirEconomizerType(
+          defaults[:economizer_type][:default])
+      end
+
+      # set the sensible heat recovery
+      if @hash[:sensible_heat_recovery] != 0
+        os_ideal_air.setSensibleHeatRecoveryEffectiveness(@hash[:sensible_heat_recovery])
+        os_ideal_air.setHeatRecoveryType('Sensible')
+      else
+        os_ideal_air.setSensibleHeatRecoveryEffectiveness(
+          defaults[:sensible_heat_recovery][:default])
+      end
+
+      # set the latent heat recovery
+      if @hash[:latent_heat_recovery] != 0
+        os_ideal_air.setLatentHeatRecoveryEffectiveness(@hash[:latent_heat_recovery])
+        os_ideal_air.setHeatRecoveryType('Enthalpy')
+      else
+        os_ideal_air.setLatentHeatRecoveryEffectiveness(
+          defaults[:latent_heat_recovery][:default])
+      end
+
+      # assign the demand controlled ventilation
+      if @hash[:demand_controlled_ventilation]
+        os_ideal_air.setDemandControlledVentilationType('OccupancySchedule')
+      else 
+        os_ideal_air.setDemandControlledVentilationType('None')
+      end
+      
+      # set the maximum heating supply air temperature
+      if @hash[:heating_air_temperature]
+        os_ideal_air.setMaximumHeatingSupplyAirTemperature(@hash[:heating_air_temperature])
+      else
+        os_ideal_air.setMaximumHeatingSupplyAirTemperature(
+          defaults[:heating_air_temperature][:default])
+      end
+
+      # set the maximum cooling supply air temperature
+      if @hash[:cooling_air_temperature]
+        os_ideal_air.setMinimumCoolingSupplyAirTemperature(@hash[:cooling_air_temperature])
+      else
+        os_ideal_air.setMinimumCoolingSupplyAirTemperature(
+          defaults[:cooling_air_temperature][:default])
+      end
+
+      # assign limits to the system's heating capacity
+      if @hash[:heating_limit] == {'type': 'NoLimit'}
+        os_ideal_air.setHeatingLimit('NoLimit')
+      else
+        os_ideal_air.setHeatingLimit('LimitCapacity')
+        if @hash[:heating_limit].is_a? Numeric
+          os_ideal_air.setMaximumSensibleHeatingCapacity(@hash[:heating_limit])
+        else
+          os_ideal_air.autosizeMaximumSensibleHeatingCapacity()
+        end
+      end
+
+      # assign limits to the system's cooling capacity
+      if @hash[:cooling_limit] == {'type': 'NoLimit'}
+        os_ideal_air.setCoolingLimit('NoLimit')
+      else
+        os_ideal_air.setCoolingLimit('LimitFlowRateAndCapacity')
+        if @hash[:cooling_limit].is_a? Numeric
+          os_ideal_air.setMaximumTotalCoolingCapacity(@hash[:cooling_limit])
+          os_ideal_air.autosizeMaximumCoolingAirFlowRate()
+        else
+          os_ideal_air.autosizeMaximumTotalCoolingCapacity()
+          os_ideal_air.autosizeMaximumCoolingAirFlowRate()
+        end
+      end
+
+      # assign heating availability schedules
+      if @hash[:heating_availability]
+        schedule = openstudio_model.getScheduleByName(@hash[:heating_availability])
+        unless schedule.empty?
+          os_schedule = schedule.get
+          os_ideal_air.setHeatingAvailabilitySchedule(os_schedule)
+        end
+      end
+
+      # assign cooling availability schedules
+      if @hash[:cooling_availability]
+        schedule = openstudio_model.getScheduleByName(@hash[:cooling_availability])
+        unless schedule.empty?
+          os_schedule = schedule.get
+          os_ideal_air.setCoolingAvailabilitySchedule(os_schedule)
+        end
+      end
+
+      os_ideal_air
+    end
+
+  end #IdealAirSystemAbridged
+end #FromHoneybee

data/lib/from_honeybee/load/electric_equipment.rb

@@ -0,0 +1,96 @@
+# *******************************************************************************
+# 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/extension'
+require 'from_honeybee/model_object'
+
+module FromHoneybee
+  class ElectricEquipmentAbridged < ModelObject
+    attr_reader :errors, :warnings
+
+    def initialize(hash = {})
+      super(hash)
+      raise "Incorrect model type '#{@type}'" unless @type == 'ElectricEquipmentAbridged'
+    end
+  
+    def defaults
+      @@schema[:components][:schemas][:ElectricEquipmentAbridged][:properties]
+    end
+  
+    def find_existing_openstudio_object(openstudio_model)
+      model_electric_equipment = openstudio_model.getElectricEquipmentDefinitionByName(@hash[:identifier])
+      return model_electric_equipment.get unless model_electric_equipment.empty?
+      nil
+    end
+  
+    def to_openstudio(openstudio_model)
+      # create electrical equipment and set identifier
+      os_electric_equip_def = OpenStudio::Model::ElectricEquipmentDefinition.new(openstudio_model)
+      os_electric_equip = OpenStudio::Model::ElectricEquipment.new(os_electric_equip_def)
+      os_electric_equip_def.setName(@hash[:identifier])
+      os_electric_equip.setName(@hash[:identifier])
+
+      # assign watts per area 
+      os_electric_equip_def.setWattsperSpaceFloorArea(@hash[:watts_per_area])
+
+      # assign schedule
+      electric_equipment_schedule = openstudio_model.getScheduleByName(@hash[:schedule])
+      unless electric_equipment_schedule.empty?
+        electric_equipment_schedule_object = electric_equipment_schedule.get
+        os_electric_equip.setSchedule(electric_equipment_schedule_object)
+      end
+
+      # assign radiant fraction if it exists
+      if @hash[:radiant_fraction]
+        os_electric_equip_def.setFractionRadiant(@hash[:radiant_fraction])
+      else 
+        os_electric_equip_def.setFractionRadiant(defaults[:radiant_fraction][:default])
+      end
+
+      # assign latent fraction if it exists
+      if @hash[:latent_fraction]
+        os_electric_equip_def.setFractionLatent(@hash[:latent_fraction])
+      else
+        os_electric_equip_def.setFractionLatent(defaults[:latent_fraction][:default])
+      end
+
+      # assign lost fraction if it exists
+      if @hash[:lost_fraction]
+        os_electric_equip_def.setFractionLost(@hash[:lost_fraction])
+      else 
+        os_electric_equip_def.setFractionLost(defaults[:lost_fraction][:default])
+      end
+
+      os_electric_equip
+    end
+
+  end #ElectricEquipmentAbridged
+end #FromHoneybee

data/lib/from_honeybee/load/gas_equipment.rb

@@ -0,0 +1,97 @@
+# *******************************************************************************
+# 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/extension'
+require 'from_honeybee/model_object'
+
+module FromHoneybee
+  class GasEquipmentAbridged < ModelObject
+    attr_reader :errors, :warnings
+
+    def initialize(hash = {})
+      super(hash)
+      raise "Incorrect model type '#{@type}'" unless @type == 'GasEquipmentAbridged'
+    end
+  
+    def defaults
+      @@schema[:components][:schemas][:GasEquipmentAbridged][:properties]
+    end
+  
+    def find_existing_openstudio_object(openstudio_model)
+      model_gas_equipment = openstudio_model.getGasEquipmentDefinitionByName(@hash[:identifier])
+      return model_gas_equipment.get unless model_gas_equipment.empty?
+      nil
+    end
+  
+    def to_openstudio(openstudio_model)
+
+      # create gas equipment and set identifier
+      os_gas_equip_def = OpenStudio::Model::GasEquipmentDefinition.new(openstudio_model)
+      os_gas_equip = OpenStudio::Model::GasEquipment.new(os_gas_equip_def)
+      os_gas_equip_def.setName(@hash[:identifier])
+      os_gas_equip.setName(@hash[:identifier])
+
+      # assign watts per space floor area
+      os_gas_equip_def.setWattsperSpaceFloorArea(@hash[:watts_per_area])
+
+      # assign schedule
+      gas_equipment_schedule = openstudio_model.getScheduleByName(@hash[:schedule])
+      unless gas_equipment_schedule.empty?
+        gas_equipment_schedule_object = gas_equipment_schedule.get
+        os_gas_equip.setSchedule(gas_equipment_schedule_object)
+      end
+
+      # assign radiant fraction if it exists
+      if @hash[:radiant_fraction]
+        os_gas_equip_def.setFractionRadiant(@hash[:radiant_fraction])
+      else 
+        os_gas_equip_def.setFractionRadiant(defaults[:radiant_fraction][:default])
+      end
+      
+      # assign latent fraction if it exists
+      if @hash[:latent_fraction]
+        os_gas_equip_def.setFractionLatent(@hash[:latent_fraction])
+      else
+        os_gas_equip_def.setFractionLatent(defaults[:latent_fraction][:default])
+      end
+      
+      # assign lost fraction if it exists
+      if @hash[:lost_fraction]
+        os_gas_equip_def.setFractionLost(@hash[:lost_fraction])
+      else 
+        os_gas_equip_def.setFractionLost(defaults[:lost_fraction][:default])
+      end
+
+      os_gas_equip
+    end
+
+  end #GasEquipmentAbridged
+end #FromHoneybee

data/lib/from_honeybee/load/infiltration.rb

@@ -0,0 +1,95 @@
+# *******************************************************************************
+# 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/extension'
+require 'from_honeybee/model_object'
+
+module FromHoneybee
+  class InfiltrationAbridged < ModelObject
+    attr_reader :errors, :warnings
+
+    def initialize(hash = {})
+      super(hash)
+      raise "Incorrect model type '#{@type}'" unless @type == 'InfiltrationAbridged'
+    end
+  
+    def defaults
+      @@schema[:components][:schemas][:InfiltrationAbridged][:properties]
+    end
+  
+    def find_existing_openstudio_object(openstudio_model)
+      model_infiltration = openstudio_model.getSpaceInfiltrationDesignFlowRateByName(@hash[:identifier])
+      return model_infiltration.get unless model_infiltration.empty?
+      nil
+    end
+  
+    def to_openstudio(openstudio_model)    
+      
+      # create infiltration OpenStudio object and set identifier
+      os_infilt = OpenStudio::Model::SpaceInfiltrationDesignFlowRate.new(openstudio_model)
+      os_infilt.setName(@hash[:identifier])
+
+      # assign flow per surface
+      os_infilt.setFlowperExteriorSurfaceArea(@hash[:flow_per_exterior_area])
+
+      # assign schedule
+      infiltration_schedule = openstudio_model.getScheduleByName(@hash[:schedule])
+      unless infiltration_schedule.empty?
+        infiltration_schedule_object = infiltration_schedule.get
+        os_infilt.setSchedule(infiltration_schedule_object)
+      end
+
+      # assign constant coefficient if it exists
+      if @hash[:constant_coefficient]
+        os_infilt.setConstantTermCoefficient(@hash[:constant_coefficient])
+      else 
+        os_infilt.setConstantTermCoefficient(defaults[:constant_coefficient][:default])
+      end
+      
+      # assign temperature coefficient
+      if @hash[:temperature_coefficient]
+        os_infilt.setTemperatureTermCoefficient(@hash[:temperature_coefficient])
+      else
+        os_infilt.setTemperatureTermCoefficient(defaults[:temperature_coefficient][:default])
+      end
+      
+      # assign velocity coefficient
+      if @hash[:velocity_coefficient]
+        os_infilt.setVelocityTermCoefficient(@hash[:velocity_coefficient])
+      else 
+        os_infilt.setVelocityTermCoefficient(defaults[:velocity_coefficient][:default])
+      end
+
+      os_infilt
+    end
+    
+  end #InfiltrationAbridged
+end #Ladybug

data/lib/from_honeybee/load/lighting.rb

@@ -0,0 +1,98 @@
+# *******************************************************************************
+# 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/extension'
+require 'from_honeybee/model_object'
+
+module FromHoneybee
+  class LightingAbridged < ModelObject
+    attr_reader :errors, :warnings
+
+    def initialize(hash = {})
+      super(hash)
+      raise "Incorrect model type '#{@type}'" unless @type == 'LightingAbridged'
+    end
+  
+    def defaults
+      @@schema[:components][:schemas][:LightingAbridged][:properties]
+    end
+  
+    def find_existing_openstudio_object(openstudio_model)
+      model_lights = openstudio_model.getLightsDefinitionByName(@hash[:identifier])
+      return model_lights.get unless model_lights.empty?
+      nil
+    end
+  
+    def to_openstudio(openstudio_model)
+
+      # create lights OpenStudio object and set identifier
+      os_lights_def = OpenStudio::Model::LightsDefinition.new(openstudio_model)
+      os_lights = OpenStudio::Model::Lights.new(os_lights_def)
+      os_lights_def.setName(@hash[:identifier])
+      os_lights.setName(@hash[:identifier])
+
+      # assign watts per space floor area
+      os_lights_def.setWattsperSpaceFloorArea(@hash[:watts_per_area])
+
+      # assign lighting schedule
+      lighting_schedule = openstudio_model.getScheduleByName(@hash[:schedule])
+      unless lighting_schedule.empty?
+        lighting_schedule_object = lighting_schedule.get
+        os_lights.setSchedule(lighting_schedule_object)
+      end
+
+      # assign visible fraction if it exists
+      if @hash[:visible_fraction]
+        os_lights_def.setFractionVisible(@hash[:visible_fraction])
+      else
+        os_lights_def.setFractionVisible(defaults[:visible_fraction][:default])
+      end
+
+      # assign radiant fraction if it exists
+      if @hash[:radiant_fraction]
+        os_lights_def.setFractionRadiant(@hash[:radiant_fraction])
+      else
+        os_lights_def.setFractionRadiant(defaults[:radiant_fraction][:default])
+      end
+
+      # assign return air fraction if it exists
+      if @hash[:return_air_fraction]
+        os_lights_def.setReturnAirFraction(@hash[:return_air_fraction])
+      else 
+        os_lights_def.setReturnAirFraction(defaults[:return_air_fraction][:default])
+      end
+
+      os_lights
+    end
+
+  end #LightingAbridged
+end #FromHoneybee
+