honeybee-openstudio 2.4.0 → 2.6.0

data/lib/from_honeybee/ventcool/opening.rb

@@ -46,8 +46,8 @@ module FromHoneybee
     end
 
     def defaults_control
-        @@schema[:components][:schemas][:VentilationControlAbridged][:properties]
-      end
+      @@schema[:components][:schemas][:VentilationControlAbridged][:properties]
+    end
 
     def to_openstudio(openstudio_model, parent, vent_control_hash)
       # create wind and stack object and set identifier
@@ -140,6 +140,48 @@ module FromHoneybee
       os_opening
     end
 
+    def to_openstudio_afn(openstudio_model, parent)
+      # process the flow_coefficient_closed and set it to a very small number if it's 0
+      if @hash[:flow_coefficient_closed] and @hash[:flow_coefficient_closed] != 0
+        flow_coefficient = @hash[:flow_coefficient_closed]
+      else
+        flow_coefficient = 1.0e-09  # set it to a very small number
+      end
+
+      # create the simple opening object for the Aperture or Door using default values
+      flow_exponent = defaults[:flow_exponent_closed][:default].to_f
+      two_way_thresh= defaults[:two_way_threshold][:default].to_f
+      discharge_coeff = defaults[:discharge_coefficient][:default].to_f
+      os_opening = OpenStudio::Model::AirflowNetworkSimpleOpening.new(
+        openstudio_model, flow_coefficient, flow_exponent, two_way_thresh, discharge_coeff)
+
+      # assign the flow exponent when the opening is closed
+      if @hash[:flow_exponent_closed]
+        os_opening.setAirMassFlowExponentWhenOpeningisClosed(@hash[:flow_exponent_closed])
+      end
+      # assign the minimum difference for two-way flow
+      if @hash[:two_way_threshold]
+        os_opening.setMinimumDensityDifferenceforTwoWayFlow(@hash[:two_way_threshold])
+      end
+      # assign the discharge coefficient
+      if @hash[:discharge_coefficient]
+        os_opening.setDischargeCoefficient(@hash[:discharge_coefficient])
+      end
+
+      # create the AirflowNetworkSurface 
+      os_afn_srf = parent.getAirflowNetworkSurface(os_opening)
+
+      # assign the opening area
+      if @hash[:fraction_area_operable]
+        open_fac = @hash[:fraction_area_operable]
+      else
+        open_fac = defaults[:fraction_area_operable][:default]
+      end
+      os_afn_srf.setWindowDoorOpeningFactorOrCrackFactor(open_fac)
+
+      open_fac
+    end
+
     def compute_height(surface)
       # derive the height (difference in z values) of a surface
       verts = surface.vertices
@@ -152,7 +194,8 @@ module FromHoneybee
           max_pt = v.z
         end
       end
-      max_pt - min_pt
+      # quarter the window height to get the height from midpoint of lower opening to neutral pressure level
+      (max_pt - min_pt) / 4
     end
 
   end #VentilationOpening

data/lib/from_honeybee/ventcool/simulation.rb

@@ -0,0 +1,110 @@
+# *******************************************************************************
+# 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 'openstudio'
+
+module FromHoneybee
+  class VentilationSimulationControl < ModelObject
+    attr_reader :errors, :warnings
+
+    def initialize(hash = {})
+      super(hash)
+    end
+
+    def defaults
+      @@schema[:components][:schemas][:VentilationSimulationControl][:properties]
+    end
+
+    def to_openstudio(openstudio_model)
+      # create the AirflowNetworkSimulationControl object
+      os_vsim_control = openstudio_model.getAirflowNetworkSimulationControl
+      os_vsim_control.setName('Window Based Ventilative Cooling')
+
+      # assign the control type
+      if @hash[:vent_control_type]
+        os_vsim_control.setAirflowNetworkControl(@hash[:vent_control_type])
+      else
+        os_vsim_control.setAirflowNetworkControl('MultizoneWithoutDistribution')
+      end
+
+      # assign the building type
+      if @hash[:building_type]
+        os_vsim_control.setBuildingType(@hash[:building_type])
+      else
+        os_vsim_control.setBuildingType(defaults[:building_type][:default])
+      end
+
+      # assign the long axis azimth angle of the building
+      if @hash[:long_axis_angle]
+        os_vsim_control.setAzimuthAngleofLongAxisofBuilding(@hash[:long_axis_angle])
+      else
+        os_vsim_control.setAzimuthAngleofLongAxisofBuilding(defaults[:long_axis_angle][:default])
+      end
+
+      # assign the aspect ratio of the building
+      if @hash[:aspect_ratio]
+        os_vsim_control.setBuildingAspectRatio(@hash[:aspect_ratio])
+      else
+        os_vsim_control.setBuildingAspectRatio(defaults[:aspect_ratio][:default])
+      end
+
+      # create the AirflowNetworkReferenceCrackConditions object that all other cracks reference
+      os_ref_crack = OpenStudio::Model::AirflowNetworkReferenceCrackConditions.new(openstudio_model)
+      os_ref_crack.setName('Reference Crack Conditions')
+
+      # assign the reference temperature
+      if @hash[:reference_temperature]
+        os_ref_crack.setTemperature(@hash[:reference_temperature])
+      else
+        os_ref_crack.setTemperature(defaults[:reference_temperature][:default])
+      end
+
+      # assign the reference pressure
+      if @hash[:reference_pressure]
+        os_ref_crack.setBarometricPressure(@hash[:reference_pressure])
+      else
+        os_ref_crack.setBarometricPressure(defaults[:reference_pressure][:default])
+      end
+
+      # assign the reference humidity ratio
+      if @hash[:reference_humidity_ratio]
+        os_ref_crack.setHumidityRatio(@hash[:reference_humidity_ratio])
+      else
+        os_ref_crack.setHumidityRatio(defaults[:reference_humidity_ratio][:default])
+      end
+
+      os_ref_crack
+    end
+
+  end #VentilationSimulationControl
+end #FromHoneybee

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: honeybee-openstudio
 version: !ruby/object:Gem::Version
-  version: 2.4.0
+  version: 2.6.0
 platform: ruby
 authors:
 - Tanushree Charan
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-07-20 00:00:00.000000000 Z
+date: 2020-09-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -181,7 +181,9 @@ files:
 - lib/from_honeybee/geometry/face.rb
 - lib/from_honeybee/geometry/room.rb
 - lib/from_honeybee/geometry/shade.rb
+- lib/from_honeybee/hvac/Model.hvac.rb
 - lib/from_honeybee/hvac/ideal_air.rb
+- lib/from_honeybee/hvac/template.rb
 - lib/from_honeybee/load/electric_equipment.rb
 - lib/from_honeybee/load/gas_equipment.rb
 - lib/from_honeybee/load/infiltration.rb
@@ -208,7 +210,9 @@ files:
 - lib/from_honeybee/simulation/designday.rb
 - lib/from_honeybee/simulation/extension.rb
 - lib/from_honeybee/simulation/parameter.rb
+- lib/from_honeybee/ventcool/control.rb
 - lib/from_honeybee/ventcool/opening.rb
+- lib/from_honeybee/ventcool/simulation.rb
 - lib/measures/.gitkeep
 - lib/measures/from_honeybee_model/LICENSE.md
 - lib/measures/from_honeybee_model/README.md