honeybee-openstudio 0

data/lib/to_openstudio/simulation/design_day.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 'honeybee/simulation/design_day'
+
+require 'to_openstudio/model_object'
+
+module Honeybee
+  class DesignDay
+
+    def find_existing_openstudio_object(openstudio_model)
+      object = openstudio_model.getDesignDayByName(@hash[:name])
+      return object.get if object.is_initialized
+      nil
+    end
+
+    def to_openstudio(openstudio_model)
+      # create the DesignDay object
+      os_des_day = OpenStudio::Model::DesignDay.new(openstudio_model)
+      os_des_day.setName(@hash[:name])
+      os_des_day.setDayType(@hash[:day_type])
+
+      # set the DryBulbCondition properties
+      os_des_day.setMaximumDryBulbTemperature(@hash[:dry_bulb_condition][:dry_bulb_max])
+      os_des_day.setDailyDryBulbTemperatureRange(@hash[:dry_bulb_condition][:dry_bulb_range])
+
+      # set the HumidityCondition properties
+      os_des_day.setHumidityIndicatingType(@hash[:humidity_condition][:humidity_type])
+      os_des_day.setHumidityIndicatingConditionsAtMaximumDryBulb(@hash[:humidity_condition][:humidity_value])
+      if @hash[:humidity_condition][:barometric_pressure]
+        os_des_day.setBarometricPressure(@hash[:humidity_condition][:barometric_pressure])
+      end
+      if @hash[:humidity_condition][:rain]
+        os_des_day.setRainIndicator(@hash[:humidity_condition][:rain])
+      end
+      if @hash[:humidity_condition][:snow_on_ground]
+        os_des_day.setSnowIndicator(@hash[:humidity_condition][:snow_on_ground])
+      end
+
+      # set the WindCondition properties
+      os_des_day.setWindSpeed(@hash[:wind_condition][:wind_speed])
+      if @hash[:wind_condition][:wind_direction]
+        os_des_day.setWindDirection(@hash[:wind_condition][:wind_direction])
+      end
+
+      # set the SkyCondition properties
+      os_des_day.setMonth(@hash[:sky_condition][:date][0])
+      os_des_day.setDayOfMonth(@hash[:sky_condition][:date][1])
+      os_des_day.setSolarModelIndicator(@hash[:sky_condition][:type])
+      if @hash[:sky_condition][:daylight_savings]
+        os_des_day.setDaylightSavingTimeIndicator(@hash[:sky_condition][:daylight_savings])
+      end
+
+      # ASHRAEClearSky SkyCondition
+      if @hash[:sky_condition][:type] == "ASHRAEClearSky"
+        os_des_day.setSkyClearness(@hash[:sky_condition][:clearness])
+      end
+
+      # ASHRAETau SkyCondition
+      if @hash[:sky_condition][:type] == "ASHRAETau"
+        os_des_day.setAshraeTaub(@hash[:sky_condition][:tau_b])
+        os_des_day.setAshraeTaud(@hash[:sky_condition][:tau_d])
+      end
+
+      os_des_day
+    end
+  end # DesignDay
+end # Honeybee

data/lib/to_openstudio/simulation/parameter_model.rb

@@ -0,0 +1,243 @@
+# *******************************************************************************
+# 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/simulation/parameter_model'
+
+require 'openstudio'
+
+module Honeybee
+  class SimulationParameter
+
+    # convert to openstudio model, clears errors and warnings
+    def to_openstudio_model(openstudio_model=nil, log_report=false)
+      @errors = []
+      @warnings = []
+
+      if log_report
+        puts 'Starting SimulationParameter translation from Honeybee to OpenStudio'
+      end
+      @openstudio_model = if openstudio_model
+                            openstudio_model
+                          else
+                            OpenStudio::Model::Model.new
+                          end
+
+      create_openstudio_objects
+
+      if log_report
+        puts 'Done with SimulationParameter translation!'
+      end
+
+      @openstudio_model
+    end
+
+    def create_openstudio_objects
+      # get the defaults for each sub-object
+      simct_defaults = defaults[:SimulationControl][:properties]
+      shdw_defaults = defaults[:ShadowCalculation][:properties]
+      siz_defaults = defaults[:SizingParameter][:properties]
+      out_defaults = defaults[:SimulationOutput][:properties]
+      runper_defaults = defaults[:RunPeriod][:properties]
+      simpar_defaults = defaults[:SimulationParameter][:properties]
+
+      # set defaults for the Model's SimulationControl object
+      os_sim_control = @openstudio_model.getSimulationControl
+      os_sim_control.setDoZoneSizingCalculation(simct_defaults[:do_zone_sizing][:default])
+      os_sim_control.setDoSystemSizingCalculation(simct_defaults[:do_system_sizing][:default])
+      os_sim_control.setDoPlantSizingCalculation(simct_defaults[:do_plant_sizing][:default])
+      os_sim_control.setRunSimulationforWeatherFileRunPeriods(simct_defaults[:run_for_run_periods][:default])
+      os_sim_control.setRunSimulationforSizingPeriods(simct_defaults[:run_for_sizing_periods][:default])
+      os_sim_control.setSolarDistribution(shdw_defaults[:solar_distribution][:default])
+
+      # override any SimulationControl defaults with lodaded JSON
+      if @hash[:simulation_control]
+        unless @hash[:simulation_control][:do_zone_sizing].nil?
+          os_sim_control.setDoZoneSizingCalculation(@hash[:simulation_control][:do_zone_sizing])
+        end
+        unless @hash[:simulation_control][:do_system_sizing].nil?
+          os_sim_control.setDoSystemSizingCalculation(@hash[:simulation_control][:do_system_sizing])
+        end
+        unless @hash[:simulation_control][:do_plant_sizing].nil?
+          os_sim_control.setDoPlantSizingCalculation(@hash[:simulation_control][:do_plant_sizing])
+        end
+        unless @hash[:simulation_control][:run_for_run_periods].nil?
+          os_sim_control.setRunSimulationforWeatherFileRunPeriods(@hash[:simulation_control][:run_for_run_periods])
+        end
+        unless @hash[:simulation_control][:run_for_sizing_periods].nil?
+          os_sim_control.setRunSimulationforSizingPeriods(@hash[:simulation_control][:run_for_sizing_periods])
+        end
+      end
+
+      # set defaults for the Model's ShadowCalculation object
+      os_shadow_calc = @openstudio_model.getShadowCalculation
+      os_shadow_calc.setShadingCalculationMethod(
+        shdw_defaults[:calculation_method][:default])
+      os_shadow_calc.setShadingCalculationUpdateFrequencyMethod(
+        shdw_defaults[:calculation_update_method][:default])
+      os_shadow_calc.setShadingCalculationUpdateFrequency(
+        shdw_defaults[:calculation_frequency][:default])
+      os_shadow_calc.setMaximumFiguresInShadowOverlapCalculations(
+        shdw_defaults[:maximum_figures][:default])
+
+      # override any ShadowCalculation defaults with lodaded JSON
+      if @hash[:shadow_calculation]
+        if @hash[:shadow_calculation][:calculation_method]
+          os_shadow_calc.setShadingCalculationMethod(
+            @hash[:shadow_calculation][:calculation_method])
+        end
+        if @hash[:shadow_calculation][:calculation_update_method]
+          os_shadow_calc.setShadingCalculationUpdateFrequencyMethod(
+            @hash[:shadow_calculation][:calculation_update_method])
+        end
+        if @hash[:shadow_calculation][:calculation_frequency]
+          os_shadow_calc.setShadingCalculationUpdateFrequency(
+            @hash[:shadow_calculation][:calculation_frequency])
+        end
+        if @hash[:shadow_calculation][:maximum_figures]
+          os_shadow_calc.setMaximumFiguresInShadowOverlapCalculations(
+            @hash[:shadow_calculation][:maximum_figures])
+        end
+        if @hash[:shadow_calculation][:solar_distribution]
+          os_sim_control.setSolarDistribution(
+            @hash[:shadow_calculation][:solar_distribution])
+        end
+      end
+
+      # set defaults for the Model's SizingParameter object
+      os_sizing_par = @openstudio_model.getSizingParameters
+      os_sizing_par.setHeatingSizingFactor(siz_defaults[:heating_factor][:default])
+      os_sizing_par.setCoolingSizingFactor(siz_defaults[:cooling_factor][:default])
+
+      # override any SizingParameter defaults with lodaded JSON
+      if @hash[:sizing_parameter]
+        if @hash[:sizing_parameter][:heating_factor]
+          os_sizing_par.setHeatingSizingFactor(@hash[:sizing_parameter][:heating_factor])
+        end
+        if @hash[:sizing_parameter][:cooling_factor]
+          os_sizing_par.setCoolingSizingFactor(@hash[:sizing_parameter][:cooling_factor])
+        end
+        # set any design days
+        if @hash[:sizing_parameter][:design_days]
+          @hash[:sizing_parameter][:design_days].each do |des_day|
+            des_day_object = DesignDay.new(des_day)
+            os_des_day = des_day_object.to_openstudio(@openstudio_model)
+          end
+        end
+      end
+
+      # set Outputs for the simulation
+      if @hash[:output]
+        if @hash[:output][:outputs]
+          @hash[:output][:outputs].each do |output|
+            os_output = OpenStudio::Model::OutputVariable.new(output, @openstudio_model)
+            if @hash[:output][:reporting_frequency]
+              os_output.setReportingFrequency(@hash[:output][:reporting_frequency])
+            else
+              os_output.setReportingFrequency(out_defaults[:reporting_frequency][:default])
+            end
+          end
+        end
+        if @hash[:output][:summary_reports]
+          os_report = @openstudio_model.getOutputTableSummaryReports
+          @hash[:output][:summary_reports].each do |report|
+            os_report.addSummaryReport(report)
+          end
+        end
+      end
+
+      # set defaults for the year description
+      year_description = @openstudio_model.getYearDescription
+      year_description.setDayofWeekforStartDay(runper_defaults[:start_day_of_week][:default])
+
+      # set up the simulation RunPeriod
+      if @hash[:run_period]
+        # set the leap year
+        if @hash[:run_period][:leap_year]
+          year_description.setIsLeapYear(@hash[:run_period][:leap_year])
+        end
+
+        # set the start day of the week
+        if @hash[:run_period][:start_day_of_week]
+          year_description.setDayofWeekforStartDay(@hash[:run_period][:start_day_of_week])
+        end
+
+        # set the run preiod start and end dates
+        openstudio_runperiod = @openstudio_model.getRunPeriod
+        openstudio_runperiod.setBeginMonth(@hash[:run_period][:start_date][0])
+        openstudio_runperiod.setBeginDayOfMonth(@hash[:run_period][:start_date][1])
+        openstudio_runperiod.setEndMonth(@hash[:run_period][:end_date][0])
+        openstudio_runperiod.setEndDayOfMonth(@hash[:run_period][:end_date][1])
+
+        # set the daylight savings time
+        if @hash[:run_period][:daylight_saving_time]
+          os_dl_saving = @openstudio_model.getRunPeriodControlDaylightSavingTime
+          os_dl_saving.setStartDate(
+            OpenStudio::MonthOfYear.new(@hash[:run_period][:daylight_saving_time][:start_date][0]),
+            @hash[:run_period][:daylight_saving_time][:start_date][1])
+          os_dl_saving.setEndDate(
+            OpenStudio::MonthOfYear.new(@hash[:run_period][:daylight_saving_time][:end_date][0]),
+            @hash[:run_period][:daylight_saving_time][:end_date][1])
+        end
+
+        # Set the holidays
+        if @hash[:run_period][:holidays]
+          @hash[:run_period][:holidays].each do |hol|
+            os_hol = OpenStudio::Model::RunPeriodControlSpecialDays.new(
+              OpenStudio::MonthOfYear.new(hol[0]), hol[1], @openstudio_model)
+            os_hol.setDuration(1)
+            os_hol.setSpecialDayType('Holiday')
+          end
+        end
+      end
+
+      # set the simulation timestep
+      os_timestep = @openstudio_model.getTimestep
+      if @hash[:timestep]
+        os_timestep.setNumberOfTimestepsPerHour(@hash[:timestep])
+      else
+        os_timestep.setNumberOfTimestepsPerHour(simpar_defaults[:timestep][:default])
+      end
+
+      # assign the north
+      if @hash[:north_angle]
+        @openstudio_model.getBuilding.setNorthAxis(-@hash[:north_angle])
+      end
+
+      # assign the terrain
+      os_site = @openstudio_model.getSite
+      os_site.setTerrain(simpar_defaults[:terrain_type][:default])
+      if @hash[:terrain_type]
+        os_site.setTerrain(@hash[:terrain_type])
+      end
+    end
+
+  end #SimulationParameter
+end #Honeybee

data/lib/to_openstudio/ventcool/control.rb

@@ -0,0 +1,185 @@
+# *******************************************************************************
+# 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/ventcool/opening'
+
+require 'to_openstudio/model_object'
+
+module Honeybee
+  class VentilationControlAbridged
+    @@outdoor_node = nil
+    @@program_manager = nil
+    @@sensor_count = 1
+    @@actuator_count = 1
+    @@program_count = 1
+
+    def get_outdoor_node(openstudio_model)
+      # get the EMS sensor for the outdoor node if it exists or generate it if it doesn't
+      if @@outdoor_node.nil?
+        out_var = OpenStudio::Model::OutputVariable.new(
+          'Site Outdoor Air Drybulb Temperature', openstudio_model)
+        out_var.setReportingFrequency('Timestep')
+        out_var.setKeyValue('Environment')
+        @@outdoor_node = OpenStudio::Model::EnergyManagementSystemSensor.new(
+          openstudio_model, out_var)
+        @@outdoor_node.setName('Outdoor_Sensor')
+      end
+      @@outdoor_node
+    end
+
+    def get_program_manager(openstudio_model)
+      # get the EMS Program Manager for all window opening if it exists or generate it if it doesn't
+      if @@program_manager.nil?
+        @@program_manager = OpenStudio::Model::EnergyManagementSystemProgramCallingManager.new(
+          openstudio_model)
+        @@program_manager.setName('Temperature_Controlled_Window_Opening')
+        @@program_manager.setCallingPoint('BeginTimestepBeforePredictor')
+      end
+      @@program_manager
+      end
+
+    def replace_ems_special_characters(ems_variable_name)
+      # remove special characters from an name to be used as an EMS variable
+      new_name = ems_variable_name.to_s
+      new_name.gsub!(/[^A-Za-z]/, '')
+      new_name
+    end
+
+    def to_openstudio(openstudio_model, parent_zone, vent_opening_surfaces, vent_opening_factors)
+      # Get the outdoor temperature sensor and the room air temperature sensor
+      out_air_temp = get_outdoor_node(openstudio_model)
+      in_var = OpenStudio::Model::OutputVariable.new('Zone Air Temperature', openstudio_model)
+      in_var.setReportingFrequency('Timestep')
+      zone_name = parent_zone.name
+      os_zone_name = 'Indoor'
+      unless zone_name.empty?
+        os_zone_name = zone_name.get
+        in_var.setKeyValue(os_zone_name)
+      end
+      in_air_temp = OpenStudio::Model::EnergyManagementSystemSensor.new(openstudio_model, in_var)
+      in_sensor_name = replace_ems_special_characters(os_zone_name) + '_Sensor' + @@sensor_count.to_s
+      @@sensor_count = @@sensor_count + 1
+      in_air_temp.setName(in_sensor_name)
+
+      # set up a schedule sensor if there's a schedule specified
+      if @hash[:schedule]
+        vent_sch = openstudio_model.getScheduleByName(@hash[:schedule])
+        unless vent_sch.empty?  # schedule not specified
+          sch_var = OpenStudio::Model::OutputVariable.new('Schedule Value', openstudio_model)
+          sch_var.setReportingFrequency('Timestep')
+          sch_var.setKeyValue(@hash[:schedule])
+          sch_sens = OpenStudio::Model::EnergyManagementSystemSensor.new(openstudio_model, sch_var)
+          sch_sensor_name = replace_ems_special_characters(os_zone_name) + '_Sensor' + @@sensor_count.to_s
+          @@sensor_count = @@sensor_count + 1
+          sch_sens.setName(sch_sensor_name)
+        end
+      end
+
+      # create the actuators for each of the operaable windows
+      actuator_names = []
+      vent_opening_surfaces.each do |vent_srf|
+        window_act = OpenStudio::Model::EnergyManagementSystemActuator.new(
+            vent_srf, 'AirFlow Network Window/Door Opening', 'Venting Opening Factor')
+        vent_srf_name = vent_srf.name
+        unless vent_srf_name.empty?
+          act_name = replace_ems_special_characters(vent_srf_name.get) + \
+            '_OpenFactor' + @@actuator_count.to_s
+            @@actuator_count = @@actuator_count + 1
+          window_act.setName(act_name)
+          actuator_names << act_name
+        end
+      end
+
+      # create the first line of the EMS Program to open each window according to the control logic
+      logic_statements = []
+      # check the minimum indoor tempertaure for ventilation
+      min_in = @hash[:min_indoor_temperature]
+      if min_in && min_in != defaults[:min_indoor_temperature][:default]
+        logic_statements << '(' + in_sensor_name + ' > ' + min_in.to_s + ')'
+      end
+      # check the maximum indoor tempertaure for ventilation
+      max_in = @hash[:max_indoor_temperature]
+      if max_in && max_in != defaults[:max_indoor_temperature][:default]
+        logic_statements << '(' + in_sensor_name + ' < ' + max_in.to_s + ')'
+      end
+      # check the minimum outdoor tempertaure for ventilation
+      min_out = @hash[:min_outdoor_temperature]
+      if min_out && min_out != defaults[:min_outdoor_temperature][:default]
+        logic_statements << '(Outdoor_Sensor > ' + min_out.to_s + ')'
+      end
+      # check the maximum outdoor tempertaure for ventilation
+      max_out = @hash[:max_outdoor_temperature]
+      if max_out && max_out != defaults[:max_outdoor_temperature][:default]
+        logic_statements << '(Outdoor_Sensor < ' + max_out.to_s + ')'
+      end
+      # check the delta tempertaure for ventilation
+      delta_in_out = @hash[:delta_temperature]
+      if delta_in_out && delta_in_out != defaults[:delta_temperature][:default]
+        logic_statements << '((' + in_sensor_name + ' - Outdoor_Sensor) > ' + delta_in_out.to_s + ')'
+      end
+      # check the schedule for ventilation
+      if sch_sensor_name
+        logic_statements << '(' + sch_sensor_name + ' > 0)'
+      end
+      # create the complete logic statement for opening windows
+      if logic_statements.empty?
+        complete_logic = 'IF (Outdoor_Sensor < 100)'  # no logic has been provided; always open windows
+      else
+        complete_logic = 'IF ' + logic_statements.join(' && ')
+      end
+
+      # initialize the program and add the complete logic
+      ems_program = OpenStudio::Model::EnergyManagementSystemProgram.new(openstudio_model)
+      prog_name = replace_ems_special_characters(os_zone_name) + '_WindowOpening' + @@program_count.to_s
+      @@program_count = @@program_count + 1
+      ems_program.setName(prog_name)
+      ems_program.addLine(complete_logic)
+
+      # loop through each of the actuators and open each window
+      actuator_names.zip(vent_opening_factors).each do |act_name, open_factor|
+        ems_program.addLine('SET ' + act_name + ' = ' + open_factor.to_s)
+      end
+      # loop through each of the actuators and close each window
+      ems_program.addLine('ELSE')
+      actuator_names.each do |act_name|
+        ems_program.addLine('SET ' + act_name + ' = 0')
+      end
+      ems_program.addLine('ENDIF')
+
+      # add the program object the the global program manager for all window opening
+      prog_manager = get_program_manager(openstudio_model)
+      prog_manager.addProgram(ems_program)
+
+      ems_program
+    end
+
+    end #VentilationControl
+end #Honeybee