honeybee-openstudio 2.16.1 → 2.16.6

data/lib/honeybee/hvac/template.rb

@@ -36,7 +36,7 @@ module Honeybee
     attr_reader :errors, :warnings
 
     @@all_air_types = ['VAV', 'PVAV', 'PSZ', 'PTAC', 'ForcedAirFurnace']
-    @@doas_types = ['FCUwithDOAS', 'WSHPwithDOAS', 'VRFwithDOAS']
+    @@doas_types = ['FCUwithDOASAbridged', 'WSHPwithDOASAbridged', 'VRFwithDOASAbridged']
     @@heat_cool_types = ['FCU', 'WSHP', 'VRF', 'Baseboard',  'EvaporativeCooler',
                          'Residential', 'WindowAC', 'GasUnitHeater']
     @@types = @@all_air_types + @@doas_types + @@heat_cool_types

data/lib/honeybee/model_object.rb

@@ -100,7 +100,7 @@ module Honeybee
 
     # remove illegal characters in identifier
     def self.clean_identifier(str)
-      str.gsub(/[^.A-Za-z0-9_-] /, '_')
+      str.gsub(/[^.A-Za-z0-9_-] /, '_').gsub(' ', '_')
     end
 
 

data/lib/measures/from_honeybee_model/README.md

@@ -2,7 +2,7 @@
 
 ###### (Automatically generated documentation)
 
-# From Energy Model
+# From Honeybee Model
 
 ## Description
 Translate a JSON file of a Honeybee Model into an OpenStudio Model.

data/lib/measures/from_honeybee_model_to_gbxml/LICENSE.md

@@ -0,0 +1,23 @@
+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.

data/lib/measures/from_honeybee_model_to_gbxml/README.md

@@ -0,0 +1,32 @@
+
+
+###### (Automatically generated documentation)
+
+# From Honeybee Model To gbXML
+
+## Description
+Translate a JSON file of a Honeybee Model into a gbXML Model.
+
+## Modeler Description
+Translate a JSON file of a Honeybee Model into a gbXML Model.
+
+## Measure Type
+ModelMeasure
+
+## Taxonomy
+
+
+## Arguments
+
+
+### Path to the Honeybee Model JSON file
+
+**Name:** model_json,
+**Type:** String,
+**Units:** ,
+**Required:** true,
+**Model Dependent:** false
+
+
+
+

data/lib/measures/from_honeybee_model_to_gbxml/measure.rb

@@ -0,0 +1,113 @@
+# *******************************************************************************
+# 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.
+# *******************************************************************************
+
+# see the URL below for information on how to write OpenStudio measures
+# http://nrel.github.io/OpenStudio-user-documentation/reference/measure_writing_guide/
+
+require 'to_openstudio'
+require 'openstudio'
+
+# start the measure
+class FromHoneybeeModelToGbxml < OpenStudio::Measure::ModelMeasure
+  # human readable name
+  def name
+    return 'From Honeybee Model to gbXML'
+  end
+
+  # human readable description
+  def description
+    return 'Translate a JSON file of a Honeybee Model into a gbXML Model.'
+  end
+
+  # human readable description of modeling approach
+  def modeler_description
+    return 'Translate a JSON file of a Honeybee Model into a gbXML Model.'
+  end
+
+  # define the arguments that the user will input
+  def arguments(model)
+    args = OpenStudio::Measure::OSArgumentVector.new
+
+    # Make an argument for the honyebee model json
+    model_json = OpenStudio::Measure::OSArgument.makeStringArgument('model_json', true)
+    model_json.setDisplayName('Path to the Honeybee Model JSON file')
+    args << model_json
+
+    # Make an argument for the output file path
+    output_file_path = OpenStudio::Measure::OSArgument.makeStringArgument('output_file_path', false)
+    output_file_path.setDisplayName('Output file path')
+    output_file_path.setDescription('If set, the output gbXML file will be exported to this path. Othervise The file will be exported to the same path as the input model.')
+    output_file_path.setDefaultValue('')
+    args << output_file_path
+
+    return args
+  end
+
+  # define what happens when the measure is run
+  def run(model, runner, user_arguments)
+    super(model, runner, user_arguments)
+    STDOUT.flush
+    if !runner.validateUserArguments(arguments(model), user_arguments)
+      return false
+    end
+
+    # convert the Honeybee model into an OpenStudio Model
+    model_json = runner.getStringArgumentValue('model_json', user_arguments)
+    if !File.exist?(model_json)
+      runner.registerError("Cannot find file '#{model_json}'")
+      return false
+    end
+    honeybee_model = Honeybee::Model.read_from_disk(model_json)
+    STDOUT.flush
+    os_model = honeybee_model.to_openstudio_model(model)
+    STDOUT.flush
+
+    # convert the OpenStudio model into a gbXML Model
+    output_file_path = runner.getStringArgumentValue('output_file_path', user_arguments)
+    if output_file_path && !output_file_path.empty?
+      unless File.exist?(output_file_path)
+        output_folder = File.split(output_file_path)[0]
+        FileUtils.mkdir_p(output_folder)
+      end
+    else
+      model_path, model_name = File.split(model_json)
+      gbxml_model_name = model_name.split('.')[0] + '.gbxml'
+      output_file_path = File.join(model_path, gbxml_model_name)
+    end
+    translator = OpenStudio::GbXML::GbXMLForwardTranslator.new
+    translator.modelToGbXML(os_model, output_file_path)
+
+    return true
+  end
+end
+
+# register the measure to be used by the application
+FromHoneybeeModelToGbxml.new.registerWithApplication

data/lib/measures/from_honeybee_model_to_gbxml/measure.xml

@@ -0,0 +1,88 @@
+<?xml version="1.0"?>
+<measure>
+  <schema_version>3.0</schema_version>
+  <name>from_honeybee_model</name>
+  <uid>a5f500d5-97ff-4048-a6f4-6b0b0a92d0f0</uid>
+  <version_id>1171d409-32be-4b94-baae-56d59a7e3b1d</version_id>
+  <version_modified>20201124T031956Z</version_modified>
+  <xml_checksum>D8922A73</xml_checksum>
+  <class_name>FromHoneybeeModelToGbxml</class_name>
+  <display_name>From Honeybee Model to gbXML</display_name>
+  <description>Translate a JSON file of a Honeybee Model into a gbXML Model.</description>
+  <modeler_description>Translate a JSON file of a Honeybee Model into a gbXML Model.</modeler_description>
+  <arguments>
+    <argument>
+      <name>model_json</name>
+      <display_name>Path to the Honeybee Model JSON file</display_name>
+      <type>String</type>
+      <required>true</required>
+      <model_dependent>false</model_dependent>
+    </argument>
+    <argument>
+      <name>output_file_path</name>
+      <display_name>Output file path</display_name>
+      <type>String</type>
+      <required>false</required>
+      <model_dependent>false</model_dependent>
+      <default_value></default_value>
+    </argument>
+  </arguments>
+  <outputs />
+  <provenances />
+  <tags>
+    <tag>Whole Building.Space Types</tag>
+  </tags>
+  <attributes>
+    <attribute>
+      <name>Measure Type</name>
+      <value>ModelMeasure</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Software Tool</name>
+      <value>Apply Measure Now</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Software Tool</name>
+      <value>OpenStudio Application</value>
+      <datatype>string</datatype>
+    </attribute>
+    <attribute>
+      <name>Intended Software Tool</name>
+      <value>Parametric Analysis Tool</value>
+      <datatype>string</datatype>
+    </attribute>
+  </attributes>
+  <files>
+    <file>
+      <filename>LICENSE.md</filename>
+      <filetype>md</filetype>
+      <usage_type>license</usage_type>
+      <checksum>1E0EDDB0</checksum>
+    </file>
+    <file>
+      <filename>README.md</filename>
+      <filetype>md</filetype>
+      <usage_type>readme</usage_type>
+      <checksum>782C496D</checksum>
+    </file>
+    <file>
+      <version>
+        <software_program>OpenStudio</software_program>
+        <identifier>2.0.0</identifier>
+        <min_compatible>2.0.0</min_compatible>
+      </version>
+      <filename>measure.rb</filename>
+      <filetype>rb</filetype>
+      <usage_type>script</usage_type>
+      <checksum>8B48C43C</checksum>
+    </file>
+    <file>
+      <filename>from_honeybee_model_to_gbxml_test.rb</filename>
+      <filetype>rb</filetype>
+      <usage_type>test</usage_type>
+      <checksum>A800695A</checksum>
+    </file>
+  </files>
+</measure>

data/lib/measures/from_honeybee_model_to_gbxml/tests/from_honeybee_model_to_gbxml_test.rb

@@ -0,0 +1,105 @@
+# *******************************************************************************
+# 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 'openstudio'
+require 'openstudio/ruleset/ShowRunnerOutput'
+require 'minitest/autorun'
+require_relative '../measure.rb'
+require 'fileutils'
+
+class FromHoneybeeModelToGbxml_Test < Minitest::Test
+  # method to apply arguments, run measure, and assert results (only populate args hash with non-default argument values)
+  def apply_measure_to_model(test_name, args, model_name = nil, result_value = 'Success', warnings_count = 0, info_count = nil)
+    # create an instance of the measure
+    measure = FromHoneybeeModelToGbxml.new
+
+    # create an instance of a runner
+    runner = OpenStudio::Measure::OSRunner.new(OpenStudio::WorkflowJSON.new)
+
+    if model_name.nil?
+      # make an empty model
+      model = OpenStudio::Model::Model.new
+    else
+      # load the test model
+      translator = OpenStudio::OSVersion::VersionTranslator.new
+      path = OpenStudio::Path.new(File.dirname(__FILE__) + '/' + model_name)
+      model = translator.loadModel(path)
+      assert(!model.empty?)
+      model = model.get
+    end
+
+    # get arguments
+    arguments = measure.arguments(model)
+    argument_map = OpenStudio::Measure.convertOSArgumentVectorToMap(arguments)
+
+    # populate argument with specified hash value if specified
+    arguments.each do |arg|
+      temp_arg_var = arg.clone
+      if args.key?(arg.name)
+        assert(temp_arg_var.setValue(args[arg.name]), "could not set #{arg.name} to #{args[arg.name]}.")
+      end
+      argument_map[arg.name] = temp_arg_var
+    end
+
+    # run the measure
+    measure.run(model, runner, argument_map)
+    result = runner.result
+
+    # show the output
+    puts "measure results for #{test_name}"
+    show_output(result)
+
+    # assert that it ran correctly
+    if result_value.nil? then result_value = 'Success' end
+    assert_equal(result_value, result.value.valueName)
+
+    # check count of warning and info messages
+    unless info_count.nil? then assert(result.info.size == info_count) end
+    unless warnings_count.nil? then assert(result.warnings.size == warnings_count, "warning count (#{result.warnings.size}) did not match expectation (#{warnings_count})") end
+
+    # if 'Fail' passed in make sure at least one error message (while not typical there may be more than one message)
+    if result_value == 'Fail' then assert(result.errors.size >= 1) end
+
+  end
+
+  def test_shoe_box
+    args = {}
+    args['model_json'] = File.join(File.dirname(__FILE__) + "/../../../../spec/samples/model/model_energy_shoe_box.json")
+    apply_measure_to_model(__method__.to_s.gsub('test_',''),args, nil)
+  end
+
+  def test_office_floor
+    args = {}
+    args['model_json'] = File.join(File.dirname(__FILE__) + "/../../../../spec/samples/model/model_complete_office_floor.json")
+    apply_measure_to_model(__method__.to_s.gsub('test_',''),args, nil)
+  end
+
+end

data/lib/to_openstudio/construction/opaque.rb

@@ -50,8 +50,12 @@ module Honeybee
       # create material vector
       os_materials = OpenStudio::Model::MaterialVector.new
       # loop through each layer and add to material vector
-      @hash[:layers].each do |layer|
-        material_identifier = layer
+      if @hash.key?(:layers)
+        mat_key = :layers
+      else
+        mat_key = :materials
+      end
+      @hash[mat_key].each do |material_identifier|
         material = openstudio_model.getMaterialByName(material_identifier)
         unless material.empty?
           os_material = material.get

data/lib/to_openstudio/construction/window.rb

@@ -50,8 +50,12 @@ module Honeybee
       # create material vector
       os_materials = OpenStudio::Model::MaterialVector.new
       # loop through each layer and add to material vector
-      @hash[:layers].each do |layer|
-        material_identifier = layer
+      if @hash.key?(:layers)
+        mat_key = :layers
+      else
+        mat_key = :materials
+      end
+      @hash[mat_key].each do |material_identifier|
         material = openstudio_model.getMaterialByName(material_identifier)
         unless material.empty?
           os_material = material.get

data/lib/to_openstudio/construction/windowshade.rb

@@ -62,8 +62,12 @@ module Honeybee
 
       # create the layers of the unshaded construction into which we will insert the shade
       os_materials = []
-      @hash[:window_construction][:layers].each do |layer|
-        material_identifier = layer
+      if @hash.key?(:layers)
+        mat_key = :layers
+      else
+        mat_key = :materials
+      end
+      @hash[:window_construction][mat_key].each do |material_identifier|
         material = openstudio_model.getMaterialByName(material_identifier)
         unless material.empty?
           os_material = material.get

data/lib/to_openstudio/hvac/template.rb

@@ -91,6 +91,7 @@ module Honeybee
             os_air_loop = os_air_loop_opt.get
             loop_name = os_air_loop.name
             unless loop_name.empty?
+              # set the name of the air loop to align with the HVAC name
               if @hash[:display_name]
                 clean_name = @hash[:display_name].to_s.gsub(/[^.A-Za-z0-9_-] /, " ")
                 os_air_loop.setName(clean_name + ' - ' + loop_name.get)
@@ -101,17 +102,17 @@ module Honeybee
       end
 
       # assign the economizer type if there's an air loop and the economizer is specified
-      if @hash[:economizer_type] && @hash[:economizer_type] != 'Inferred' && os_air_loop
+      if @hash[:economizer_type] && os_air_loop
         oasys = os_air_loop.airLoopHVACOutdoorAirSystem
         unless oasys.empty?
-            os_oasys = oasys.get
-            oactrl = os_oasys.getControllerOutdoorAir
-            oactrl.setEconomizerControlType(@hash[:economizer_type])
+          os_oasys = oasys.get
+          oactrl = os_oasys.getControllerOutdoorAir
+          oactrl.setEconomizerControlType(@hash[:economizer_type])
         end
       end
 
       # set the sensible heat recovery if there's an air loop and the heat recovery is specified
-      if @hash[:sensible_heat_recovery] && @hash[:sensible_heat_recovery] != {:type => 'Autosize'} && os_air_loop
+      if @hash[:sensible_heat_recovery] && @hash[:sensible_heat_recovery] != 0 && os_air_loop
         erv = get_existing_erv(os_air_loop)
         unless erv
           erv = create_erv(openstudio_model, os_air_loop)
@@ -124,7 +125,7 @@ module Honeybee
       end
 
       # set the latent heat recovery if there's an air loop and the heat recovery is specified
-      if @hash[:latent_heat_recovery] && @hash[:latent_heat_recovery] != {:type => 'Autosize'} && os_air_loop
+      if @hash[:latent_heat_recovery] && @hash[:latent_heat_recovery] != 0 && os_air_loop
         erv = get_existing_erv(os_air_loop)
         unless erv
           erv = create_erv(openstudio_model, os_air_loop)
@@ -136,6 +137,60 @@ module Honeybee
         erv.setLatentEffectivenessat75HeatingAirFlow(@hash[:latent_heat_recovery])
       end
 
+      # assign demand controlled ventilation if there's an air loop
+      if @hash[:demand_controlled_ventilation] && os_air_loop
+        oasys = os_air_loop.airLoopHVACOutdoorAirSystem
+        unless oasys.empty?
+          os_oasys = oasys.get
+          oactrl = os_oasys.getControllerOutdoorAir
+          vent_ctrl = oactrl.controllerMechanicalVentilation
+          vent_ctrl.setDemandControlledVentilationNoFail(true)
+          oactrl.resetMinimumFractionofOutdoorAirSchedule
+        end
+      end
+
+      # assign the DOAS availability schedule if there's an air loop and it is specified
+      if @hash[:doas_availability_schedule] && os_air_loop
+        schedule = openstudio_model.getScheduleByName(@hash[:doas_availability_schedule])
+        unless schedule.empty?
+          avail_sch = schedule.get
+          os_air_loop.setAvailabilitySchedule(avail_sch)
+        end
+      end
+
+      # set the outdoor air controller to respect room-level ventilation schedules if they exist
+      if os_air_loop
+        oasys = os_air_loop.airLoopHVACOutdoorAirSystem
+        unless oasys.empty?
+          os_oasys = oasys.get
+          oactrl = os_oasys.getControllerOutdoorAir
+          oa_sch, oa_sch_name = nil, nil
+          zones.each do |zone|
+            oa_spec = zone.spaces[0].designSpecificationOutdoorAir
+            unless oa_spec.empty?
+              oa_spec = oa_spec.get
+              space_oa_sch = oa_spec.outdoorAirFlowRateFractionSchedule
+              unless space_oa_sch.empty?
+                space_oa_sch = space_oa_sch.get
+                space_oa_sch_name = space_oa_sch.name
+                unless space_oa_sch_name.empty?
+                  space_oa_sch_name = space_oa_sch_name.get
+                  if oa_sch_name.nil? || space_oa_sch_name == oa_sch_name
+                    oa_sch, oa_sch_name = space_oa_sch, space_oa_sch_name
+                  else
+                    oa_sch = nil
+                  end
+                end
+              end
+            end
+          end
+          if oa_sch
+            oactrl.resetMinimumFractionofOutdoorAirSchedule
+            oactrl.setMinimumOutdoorAirSchedule(oa_sch)
+          end
+        end
+      end
+
       # if the systems are PTAC and there is ventilation, ensure the system includes it
       if equipment_type.include?('PTAC') || equipment_type.include?('PTHP')
         always_on = openstudio_model.getScheduleByName('Always On').get
@@ -172,6 +227,20 @@ module Honeybee
         end
       end
 
+      # assign an electric humidifier if there's an air loop and the zones have a humidistat
+      if os_air_loop
+        humidistat_exists = false
+        zones.each do |zone|
+          h_stat = zone.zoneControlHumidistat
+          unless h_stat.empty?
+            humidistat_exists = true
+          end
+        end
+        if humidistat_exists
+          humidifier = create_humidifier(openstudio_model, os_air_loop)
+        end
+      end
+
       # set all plants to non-coincident sizing to avoid simualtion control issues on design days
       openstudio_model.getPlantLoops.each do |loop|
         sizing = loop.sizingPlant
@@ -217,5 +286,20 @@ module Honeybee
       heat_ex
     end
 
+    def create_humidifier(model, os_air_loop)
+      # create an electric humidifier
+      humidifier = OpenStudio::Model::HumidifierSteamElectric.new(model)
+      humidifier.setName(@hash[:identifier] + '_Humidifier Unit')
+      humid_controller = OpenStudio::Model::SetpointManagerMultiZoneHumidityMinimum.new(model)
+      humid_controller.setName(@hash[:identifier] + '_Humidifier Controller')
+
+      # add the humidifier to the air loop
+      supply_node = os_air_loop.supplyOutletNode
+      humidifier.addToNode(supply_node)
+      humid_controller.addToNode(supply_node)
+
+      humidifier
+    end
+
   end #TemplateHVAC
 end #Honeybee