honeybee-openstudio 2.30.5 → 2.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c093a7ba23305db86e618c8480375e646242ff00c18d51a68d1452a2811116ce
-  data.tar.gz: 6fe7d668d07db8a0104d14f964e08b65b166bdffe66170bb88352d5390de1197
+  metadata.gz: e468a9bfb50550224bd130a49e06f492331f0d0770e7099e884454628da250f5
+  data.tar.gz: a7c066b0cd26e9193f3fbadc9687ae59f74a96dd24a3ecbb216fb64fc682509d
 SHA512:
-  metadata.gz: 4014954666bee170a8cd83ff13468f907529fa4ddef7709cc307d9a1262f3eeb893487480697a897f5649dacc8eef5514c2d20e96b15a913c0129b32c3fc6005
-  data.tar.gz: 8300e8718f8f28bbec2366935651cedc1bb145653dec3ea7cce508f4ca01c9117a49498101d5bc41fcc652ad848a8bc19ddb1b4c82e158113ae0e11dfeb2d112
+  metadata.gz: 7c02241cca2adcbce09295d25b9ddf9bf9aa684b0f08426924f2bc1564b84143fd4032dcdbcb24a9efe214dbfca16f5bfa424ddbe1d4b02ba5a1d769265028f5
+  data.tar.gz: 28f59d45b148e6a7be923e82834d796df8da4290ecebbb14371e756eca43e0ccb21f98512a59ac8eee53f7c19637a39abd2f9b9c0106e9bad07f13b05249e537

data/honeybee-openstudio.gemspec

@@ -4,7 +4,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name          = 'honeybee-openstudio'
-  spec.version       = '2.30.5'
+  spec.version       = '2.31.0'
   spec.authors       = ['Tanushree Charan', 'Dan Macumber', 'Chris Mackey', 'Mostapha Sadeghipour Roudsari']
   spec.email         = ['tanushree.charan@nrel.gov', 'chris@ladybug.tools']
 

data/lib/honeybee/_defaults/model.json

@@ -3,7 +3,7 @@
   "servers": [],
   "info": {
     "description": "Honeybee model schema.",
-    "version": "1.48.1",
+    "version": "1.48.2",
     "title": "Honeybee Model Schema",
     "contact": {
       "name": "Ladybug Tools",
@@ -574,6 +574,31 @@
       "x-displayName": "RadianceSubFaceStateAbridged",
       "description": "<SchemaDefinition schemaRef=\"#/components/schemas/RadianceSubFaceStateAbridged\" />\n"
     },
+    {
+      "name": "radiant_model",
+      "x-displayName": "Radiant",
+      "description": "<SchemaDefinition schemaRef=\"#/components/schemas/Radiant\" />\n"
+    },
+    {
+      "name": "radiantequipmenttype_model",
+      "x-displayName": "RadiantEquipmentType",
+      "description": "<SchemaDefinition schemaRef=\"#/components/schemas/RadiantEquipmentType\" />\n"
+    },
+    {
+      "name": "radiantfacetypes_model",
+      "x-displayName": "RadiantFaceTypes",
+      "description": "<SchemaDefinition schemaRef=\"#/components/schemas/RadiantFaceTypes\" />\n"
+    },
+    {
+      "name": "radiantwithdoasabridged_model",
+      "x-displayName": "RadiantwithDOASAbridged",
+      "description": "<SchemaDefinition schemaRef=\"#/components/schemas/RadiantwithDOASAbridged\" />\n"
+    },
+    {
+      "name": "radiantwithdoasequipmenttype_model",
+      "x-displayName": "RadiantwithDOASEquipmentType",
+      "description": "<SchemaDefinition schemaRef=\"#/components/schemas/RadiantwithDOASEquipmentType\" />\n"
+    },
     {
       "name": "residential_model",
       "x-displayName": "Residential",
@@ -1054,6 +1079,11 @@
         "pvavequipmenttype_model",
         "radianceshadestateabridged_model",
         "radiancesubfacestateabridged_model",
+        "radiant_model",
+        "radiantequipmenttype_model",
+        "radiantfacetypes_model",
+        "radiantwithdoasabridged_model",
+        "radiantwithdoasequipmenttype_model",
         "residential_model",
         "residentialequipmenttype_model",
         "roofceilingconstructionset_model",
@@ -8199,6 +8229,151 @@
         ],
         "additionalProperties": false
       },
+      "RadiantwithDOASEquipmentType": {
+        "title": "RadiantwithDOASEquipmentType",
+        "description": "An enumeration.",
+        "enum": [
+          "DOAS_Radiant_Chiller_Boiler",
+          "DOAS_Radiant_Chiller_ASHP",
+          "DOAS_Radiant_Chiller_DHW",
+          "DOAS_Radiant_ACChiller_Boiler",
+          "DOAS_Radiant_ACChiller_ASHP",
+          "DOAS_Radiant_ACChiller_DHW",
+          "DOAS_Radiant_DCW_Boiler",
+          "DOAS_Radiant_DCW_ASHP",
+          "DOAS_Radiant_DCW_DHW"
+        ],
+        "type": "string"
+      },
+      "RadiantFaceTypes": {
+        "title": "RadiantFaceTypes",
+        "description": "An enumeration.",
+        "enum": [
+          "Floor",
+          "Ceiling",
+          "FloorWithCarpet"
+        ],
+        "type": "string"
+      },
+      "RadiantwithDOASAbridged": {
+        "title": "RadiantwithDOASAbridged",
+        "description": "Low Temperature Radiant with DOAS HVAC system.",
+        "type": "object",
+        "properties": {
+          "identifier": {
+            "title": "Identifier",
+            "description": "Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \\n \\t).",
+            "maxLength": 100,
+            "minLength": 1,
+            "pattern": "^[^,;!\\n\\t]+$",
+            "type": "string"
+          },
+          "display_name": {
+            "title": "Display Name",
+            "description": "Display name of the object with no character restrictions.",
+            "type": "string"
+          },
+          "user_data": {
+            "title": "User Data",
+            "description": "Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).",
+            "type": "object"
+          },
+          "vintage": {
+            "description": "Text for the vintage of the template system. This will be used to set efficiencies for various pieces of equipment within the system. Further information about these defaults can be found in the version of ASHRAE 90.1 corresponding to the selected vintage. Read-only versions of the standard can be found at: https://www.ashrae.org/technical-resources/standards-and-guidelines/read-only-versions-of-ashrae-standards",
+            "default": "ASHRAE_2019",
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Vintages"
+              }
+            ]
+          },
+          "sensible_heat_recovery": {
+            "title": "Sensible Heat Recovery",
+            "description": "A number between 0 and 1 for the effectiveness of sensible heat recovery within the system.",
+            "default": 0,
+            "minimum": 0,
+            "maximum": 1,
+            "type": "number",
+            "format": "double"
+          },
+          "latent_heat_recovery": {
+            "title": "Latent Heat Recovery",
+            "description": "A number between 0 and 1 for the effectiveness of latent heat recovery within the system.",
+            "default": 0,
+            "minimum": 0,
+            "maximum": 1,
+            "type": "number",
+            "format": "double"
+          },
+          "demand_controlled_ventilation": {
+            "title": "Demand Controlled Ventilation",
+            "description": "Boolean to note whether demand controlled ventilation should be used on the system, which will vary the amount of ventilation air according to the occupancy schedule of the Rooms.",
+            "default": false,
+            "type": "boolean"
+          },
+          "doas_availability_schedule": {
+            "title": "Doas Availability Schedule",
+            "description": "An optional On/Off discrete schedule to set when the dedicated outdoor air system (DOAS) shuts off. This will not only prevent any outdoor air from flowing thorough the system but will also shut off the fans, which can result in more energy savings when spaces served by the DOAS are completely unoccupied. If None, the DOAS will be always on.",
+            "maxLength": 100,
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": {
+            "title": "Type",
+            "default": "RadiantwithDOASAbridged",
+            "pattern": "^RadiantwithDOASAbridged$",
+            "type": "string",
+            "readOnly": true
+          },
+          "equipment_type": {
+            "description": "Text for the specific type of system equipment from the RadiantwithDOASEquipmentType enumeration.",
+            "default": "DOAS_Radiant_Chiller_Boiler",
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/RadiantwithDOASEquipmentType"
+              }
+            ]
+          },
+          "proportional_gain": {
+            "title": "Proportional Gain",
+            "description": "A fractional number for the proportional gain constant. Recommended values are 0.3 or less.",
+            "default": 0.3,
+            "minimum": 0,
+            "maximum": 1,
+            "type": "number",
+            "format": "double"
+          },
+          "minimum_operation_time": {
+            "title": "Minimum Operation Time",
+            "description": "A number for the minimum number of hours of operation for the radiant system before it shuts off.",
+            "default": 1.0,
+            "exclusiveMinimum": 0,
+            "type": "number",
+            "format": "double"
+          },
+          "switch_over_time": {
+            "title": "Switch Over Time",
+            "description": "A number for the minimum number of hours for when the system can switch between heating and cooling.",
+            "default": 24.0,
+            "exclusiveMinimum": 0,
+            "type": "number",
+            "format": "double"
+          },
+          "radiant_face_type": {
+            "description": "Text to indicate which faces are thermally active by default. Note that this property has no effect when the rooms to which the HVAC system is assigned have constructions with internal source materials. In this case, those constructions will dictate the thermally active surfaces.",
+            "default": "Floor",
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/RadiantFaceTypes"
+              }
+            ]
+          }
+        },
+        "required": [
+          "identifier"
+        ],
+        "additionalProperties": false
+      },
       "FCUEquipmentType": {
         "title": "FCUEquipmentType",
         "description": "An enumeration.",
@@ -8738,6 +8913,110 @@
         ],
         "additionalProperties": false
       },
+      "RadiantEquipmentType": {
+        "title": "RadiantEquipmentType",
+        "description": "An enumeration.",
+        "enum": [
+          "Radiant_Chiller_Boiler",
+          "Radiant_Chiller_ASHP",
+          "Radiant_Chiller_DHW",
+          "Radiant_ACChiller_Boiler",
+          "Radiant_ACChiller_ASHP",
+          "Radiant_ACChiller_DHW",
+          "Radiant_DCW_Boiler",
+          "Radiant_DCW_ASHP",
+          "Radiant_DCW_DHW"
+        ],
+        "type": "string"
+      },
+      "Radiant": {
+        "title": "Radiant",
+        "description": "Low Temperature Radiant system.",
+        "type": "object",
+        "properties": {
+          "identifier": {
+            "title": "Identifier",
+            "description": "Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \\n \\t).",
+            "maxLength": 100,
+            "minLength": 1,
+            "pattern": "^[^,;!\\n\\t]+$",
+            "type": "string"
+          },
+          "display_name": {
+            "title": "Display Name",
+            "description": "Display name of the object with no character restrictions.",
+            "type": "string"
+          },
+          "user_data": {
+            "title": "User Data",
+            "description": "Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).",
+            "type": "object"
+          },
+          "vintage": {
+            "description": "Text for the vintage of the template system. This will be used to set efficiencies for various pieces of equipment within the system. Further information about these defaults can be found in the version of ASHRAE 90.1 corresponding to the selected vintage. Read-only versions of the standard can be found at: https://www.ashrae.org/technical-resources/standards-and-guidelines/read-only-versions-of-ashrae-standards",
+            "default": "ASHRAE_2019",
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Vintages"
+              }
+            ]
+          },
+          "type": {
+            "title": "Type",
+            "default": "Radiant",
+            "pattern": "^Radiant$",
+            "type": "string",
+            "readOnly": true
+          },
+          "equipment_type": {
+            "description": "Text for the specific type of system equipment from the RadiantEquipmentType enumeration.",
+            "default": "Radiant_Chiller_Boiler",
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/RadiantEquipmentType"
+              }
+            ]
+          },
+          "proportional_gain": {
+            "title": "Proportional Gain",
+            "description": "A fractional number for the proportional gain constant. Recommended values are 0.3 or less.",
+            "default": 0.3,
+            "minimum": 0,
+            "maximum": 1,
+            "type": "number",
+            "format": "double"
+          },
+          "minimum_operation_time": {
+            "title": "Minimum Operation Time",
+            "description": "A number for the minimum number of hours of operation for the radiant system before it shuts off.",
+            "default": 1.0,
+            "exclusiveMinimum": 0,
+            "type": "number",
+            "format": "double"
+          },
+          "switch_over_time": {
+            "title": "Switch Over Time",
+            "description": "A number for the minimum number of hours for when the system can switch between heating and cooling.",
+            "default": 24.0,
+            "exclusiveMinimum": 0,
+            "type": "number",
+            "format": "double"
+          },
+          "radiant_face_type": {
+            "description": "Text to indicate which faces are thermally active by default. Note that this property has no effect when the rooms to which the HVAC system is assigned have constructions with internal source materials. In this case, those constructions will dictate the thermally active surfaces.",
+            "default": "Floor",
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/RadiantFaceTypes"
+              }
+            ]
+          }
+        },
+        "required": [
+          "identifier"
+        ],
+        "additionalProperties": false
+      },
       "SHWEquipmentType": {
         "title": "SHWEquipmentType",
         "description": "An enumeration.",
@@ -10575,6 +10854,9 @@
                 {
                   "$ref": "#/components/schemas/VRFwithDOASAbridged"
                 },
+                {
+                  "$ref": "#/components/schemas/RadiantwithDOASAbridged"
+                },
                 {
                   "$ref": "#/components/schemas/FCU"
                 },
@@ -10598,6 +10880,9 @@
                 },
                 {
                   "$ref": "#/components/schemas/GasUnitHeater"
+                },
+                {
+                  "$ref": "#/components/schemas/Radiant"
                 }
               ]
             }
@@ -13833,7 +14118,7 @@
           "version": {
             "title": "Version",
             "description": "Text string for the current version of the schema.",
-            "default": "1.48.1",
+            "default": "1.48.2",
             "pattern": "([0-9]+)\\.([0-9]+)\\.([0-9]+)",
             "type": "string",
             "readOnly": true

data/lib/honeybee/hvac/template.rb

@@ -36,9 +36,10 @@ module Honeybee
     attr_reader :errors, :warnings
 
     @@all_air_types = ['VAV', 'PVAV', 'PSZ', 'PTAC', 'ForcedAirFurnace']
-    @@doas_types = ['FCUwithDOASAbridged', 'WSHPwithDOASAbridged', 'VRFwithDOASAbridged']
+    @@doas_types = ['FCUwithDOASAbridged', 'WSHPwithDOASAbridged',
+                    'VRFwithDOASAbridged', 'RadiantwithDOASAbridged']
     @@heat_cool_types = ['FCU', 'WSHP', 'VRF', 'Baseboard',  'EvaporativeCooler',
-                         'Residential', 'WindowAC', 'GasUnitHeater']
+                         'Residential', 'WindowAC', 'GasUnitHeater', 'Radiant']
     @@types = @@all_air_types + @@doas_types + @@heat_cool_types
 
     def allowable_types

data/lib/to_openstudio/hvac/Model.hvac.rb

@@ -29,9 +29,10 @@
 # OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 # *******************************************************************************
 
-# Note: This file is copied directly from the "Create Typical DOE Building from Model" measure
+# Note: This file is copied from the "Create Typical DOE Building from Model" measure
 # https://bcl.nrel.gov/node/85019
-# It is intended that this file be re-copied if new system types are added
+# https://github.com/NREL/openstudio-model-articulation-gem/tree/develop/lib/measures/create_typical_doe_building_from_model
+# It is intended that this file be updated if new system types are added to the original file
 
 class OpenStudio::Model::Model
   # Adds the HVAC system as derived from the combinations of CBECS 2012 MAINHT and MAINCL fields.
@@ -49,7 +50,7 @@ class OpenStudio::Model::Model
     system_zones = heated_and_cooled_zones + cooled_only_zones
 
     # system type naming convention:
-    # [ventilation strategy] [ cooling system and plant] [heating system and plant]
+    # [ventilation strategy] [cooling system and plant] [heating system and plant]
 
     case system_type
 

data/lib/to_openstudio/hvac/radiant.rb

@@ -0,0 +1,164 @@
+# *******************************************************************************
+# 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.
+# *******************************************************************************
+
+# Note: This file is derived from the "Radiant Slab with DOAS" measure
+# https://github.com/NREL/openstudio-model-articulation-gem/tree/develop/lib/measures/radiant_slab_with_doas
+# It is intended that this file be updated if changes are made to the original measure
+
+class OpenStudio::Model::Model
+  # Adds a radiant HVAC system to the model
+  def add_radiant_hvac_system(std, system_type, zones, rad_props)
+    # the 'zones' argument includes zones that have heating, cooling, or both
+    conditioned_zones = zones.select { |zone| std.thermal_zone_heated?(zone) && std.thermal_zone_cooled?(zone) }
+
+    # get the climate zone from the model, which will help set water temerpatures
+    climate_zone_obj = self.getClimateZones.getClimateZone('ASHRAE', 2006)
+    if climate_zone_obj.empty
+      climate_zone_obj = self.getClimateZones.getClimateZone('ASHRAE', 2013)
+    end
+    if climate_zone_obj.empty || climate_zone_obj.value == ''
+        climate_zone = ''
+      else
+        climate_zone = climate_zone_obj.value
+      end
+    
+    # get the radiant hot water temperature based on the climate zone
+    case climate_zone
+    when '0', '1'
+      radiant_htg_dsgn_sup_wtr_temp_f = 90.0
+    when '2', '2A', '2B'
+      radiant_htg_dsgn_sup_wtr_temp_f = 100.0
+    when '3', '3A', '3B', '3C'
+      radiant_htg_dsgn_sup_wtr_temp_f = 100.0
+    when '4', '4A', '4B', '4C'
+      radiant_htg_dsgn_sup_wtr_temp_f = 100.0
+    when '5', '5A', '5B', '5C'
+      radiant_htg_dsgn_sup_wtr_temp_f = 110.0
+    when '6', '6A', '6B'
+      radiant_htg_dsgn_sup_wtr_temp_f = 120.0
+    when '7', '8'
+      radiant_htg_dsgn_sup_wtr_temp_f = 120.0
+    else  # unrecognized climate zone; default to climate zone 4
+      radiant_htg_dsgn_sup_wtr_temp_f = 100.0
+    end
+
+    # create the hot water loop
+    if system_type.include? 'ASHP'
+      boiler_fuel_type = 'ASHP'
+    elsif system_type.include? 'Boiler'
+      boiler_fuel_type = 'NaturalGas'
+    elsif system_type.include? 'DHW'
+      boiler_fuel_type = 'DistrictHeating'
+    end
+    hot_water_loop = std.model_add_hw_loop(
+      self,
+      boiler_fuel_type,
+      dsgn_sup_wtr_temp: radiant_htg_dsgn_sup_wtr_temp_f,
+      dsgn_sup_wtr_temp_delt: 10.0)
+
+    # create the chilled water loop
+    if system_type.include? 'Radiant_Chiller'  # water-cooled chiller
+      # make condenser water loop
+      fan_type = std.model_cw_loop_cooling_tower_fan_type(self)
+      condenser_water_loop = std.model_add_cw_loop(
+        self,
+        cooling_tower_type: 'Open Cooling Tower',
+        cooling_tower_fan_type: 'Propeller or Axial',
+        cooling_tower_capacity_control: fan_type,
+        number_of_cells_per_tower: 1,
+        number_cooling_towers: 1)
+      # make chilled water loop
+      chilled_water_loop = std.model_add_chw_loop(
+        self,
+        chw_pumping_type: 'const_pri_var_sec',
+        dsgn_sup_wtr_temp: 55.0,
+        dsgn_sup_wtr_temp_delt: 5.0,
+        chiller_cooling_type: 'WaterCooled',
+        condenser_water_loop: condenser_water_loop)
+    elsif system_type.include? 'Radiant_ACChiller'  # air-cooled chiller
+      chilled_water_loop = std.model_add_chw_loop(
+        self,
+        chw_pumping_type: 'const_pri_var_sec',
+        dsgn_sup_wtr_temp: 55.0,
+        dsgn_sup_wtr_temp_delt: 5.0,
+        chiller_cooling_type: 'AirCooled')
+    else  # district chilled water cooled
+        chilled_water_loop = std.model_add_chw_loop(
+          self,
+          cooling_fuel: 'DistrictCooling',
+          chw_pumping_type: 'const_pri_var_sec',
+          dsgn_sup_wtr_temp: 55.0,
+          dsgn_sup_wtr_temp_delt: 5.0)
+    end
+
+    # get the various controls for the radiant system
+    if rad_props[:proportional_gain]
+      proportional_gain = rad_props[:proportional_gain]
+    else
+      proportional_gain = 0.3
+    end
+    if rad_props[:minimum_operation_time]
+      minimum_operation = rad_props[:minimum_operation_time]
+    else
+      minimum_operation = 1
+    end
+    if rad_props[:switch_over_time]
+      switch_over_time = rad_props[:switch_over_time]
+    else
+      switch_over_time = 24
+    end
+
+    # add radiant system to the conditioned zones
+    include_carpet = false
+    if rad_props[:radiant_face_type]
+      radiant_type = rad_props[:radiant_face_type].downcase
+      if radiant_type == 'floorwithcarpet'
+        radiant_type = 'floor'
+        include_carpet = true
+      end
+    else
+      radiant_type = 'floor'
+    end
+    radiant_loops = std.model_add_low_temp_radiant(
+      self, conditioned_zones, hot_water_loop, chilled_water_loop,
+      radiant_type: radiant_type,
+      include_carpet: include_carpet,
+      proportional_gain: proportional_gain,
+      minimum_operation: minimum_operation,
+      switch_over_time: switch_over_time)
+
+    # if the equipment includes a DOAS, then add it
+    if system_type.include? 'DOAS_'
+      std.model_add_doas(self, conditioned_zones)
+    end
+
+  end
+end

data/lib/to_openstudio/hvac/template.rb

@@ -51,6 +51,7 @@ module Honeybee
       # only load openstudio-standards when needed
       require 'openstudio-standards'
       require_relative 'Model.hvac'
+      require_relative 'radiant'
 
       # get the defaults for the specific system type
       hvac_defaults = defaults(@hash[:type])
@@ -79,120 +80,139 @@ module Honeybee
         end
       end
 
-      # create the HVAC system and assign the display name to the air loop name if it exists
-      os_hvac = openstudio_model.add_cbecs_hvac_system(standard, equipment_type, zones)
-      os_air_loop = nil
+      # create the HVAC system
+      if equipment_type.to_s.include? 'Radiant'
+        os_hvac = openstudio_model.add_radiant_hvac_system(standard, equipment_type.to_s, zones, @hash)
+      else
+        os_hvac = openstudio_model.add_cbecs_hvac_system(standard, equipment_type, zones)
+      end
+
+      # Get the air loops and assign the display name to the air loop name if it exists
+      os_air_loops = []
       air_loops = openstudio_model.getAirLoopHVACs
       unless air_loops.length == $air_loop_count  # check if any new loops were added
         $air_loop_count = air_loops.length
-        os_air_terminal = []
         zones.each do |zon|
           os_air_terminal = zon.airLoopHVACTerminal
-          break if !os_air_terminal.empty?
-        end
-        unless os_air_terminal.empty?
-          os_air_terminal = os_air_terminal.get
-          os_air_loop_opt = os_air_terminal.airLoopHVAC
-          unless os_air_loop_opt.empty?
-            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)
+          unless os_air_terminal.empty?
+            os_air_terminal = os_air_terminal.get
+            os_air_loop_opt = os_air_terminal.airLoopHVAC
+            unless os_air_loop_opt.empty?
+              os_air_loop = os_air_loop_opt.get
+              os_air_loops << os_air_loop
+              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)
+                end
               end
+              break if !equipment_type.include? 'PSZ'  # multiple air loops have been added
             end
           end
         end
       end
 
       # assign the economizer type if there's an air loop and the economizer is specified
-      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])
+      if @hash[:economizer_type] && !os_air_loops.empty?
+        os_air_loops.each do |os_air_loop|
+          oasys = os_air_loop.airLoopHVACOutdoorAirSystem
+          unless oasys.empty?
+            os_oasys = oasys.get
+            oactrl = os_oasys.getControllerOutdoorAir
+            oactrl.setEconomizerControlType(@hash[:economizer_type])
+          end
         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] != 0 && os_air_loop
-        erv = get_existing_erv(os_air_loop)
-        unless erv
-          erv = create_erv(openstudio_model, os_air_loop)
+      if @hash[:sensible_heat_recovery] && @hash[:sensible_heat_recovery] != 0 && !os_air_loops.empty?
+        os_air_loops.each do |os_air_loop|
+          erv = get_existing_erv(os_air_loop)
+          unless erv
+            erv = create_erv(openstudio_model, os_air_loop)
+          end
+          eff_at_max = @hash[:sensible_heat_recovery] * (0.76 / 0.81)  # taken from OpenStudio defaults
+          erv.setSensibleEffectivenessat100CoolingAirFlow(eff_at_max)
+          erv.setSensibleEffectivenessat100HeatingAirFlow(eff_at_max)
+          erv.setSensibleEffectivenessat75CoolingAirFlow(@hash[:sensible_heat_recovery])
+          erv.setSensibleEffectivenessat75HeatingAirFlow(@hash[:sensible_heat_recovery])
         end
-        eff_at_max = @hash[:sensible_heat_recovery] * (0.76 / 0.81)  # taken from OpenStudio defaults
-        erv.setSensibleEffectivenessat100CoolingAirFlow(eff_at_max)
-        erv.setSensibleEffectivenessat100HeatingAirFlow(eff_at_max)
-        erv.setSensibleEffectivenessat75CoolingAirFlow(@hash[:sensible_heat_recovery])
-        erv.setSensibleEffectivenessat75HeatingAirFlow(@hash[:sensible_heat_recovery])
       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] != 0 && os_air_loop
-        erv = get_existing_erv(os_air_loop)
-        unless erv
-          erv = create_erv(openstudio_model, os_air_loop)
+      if @hash[:latent_heat_recovery] && @hash[:latent_heat_recovery] != 0 && !os_air_loops.empty?
+        os_air_loops.each do |os_air_loop|
+          erv = get_existing_erv(os_air_loop)
+          unless erv
+            erv = create_erv(openstudio_model, os_air_loop)
+          end
+          eff_at_max = @hash[:latent_heat_recovery] * (0.68 / 0.73)  # taken from OpenStudio defaults
+          erv.setLatentEffectivenessat100CoolingAirFlow(eff_at_max)
+          erv.setLatentEffectivenessat100HeatingAirFlow(eff_at_max)
+          erv.setLatentEffectivenessat75CoolingAirFlow(@hash[:latent_heat_recovery])
+          erv.setLatentEffectivenessat75HeatingAirFlow(@hash[:latent_heat_recovery])
         end
-        eff_at_max = @hash[:latent_heat_recovery] * (0.68 / 0.73)  # taken from OpenStudio defaults
-        erv.setLatentEffectivenessat100CoolingAirFlow(eff_at_max)
-        erv.setLatentEffectivenessat100HeatingAirFlow(eff_at_max)
-        erv.setLatentEffectivenessat75CoolingAirFlow(@hash[:latent_heat_recovery])
-        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
+      if @hash[:demand_controlled_ventilation] && !os_air_loops.empty?
+        os_air_loops.each do |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
       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)
+      if @hash[:doas_availability_schedule] && !os_air_loops.empty?
+        os_air_loops.each do |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
       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
+      if !os_air_loops.empty?
+        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
-          if oa_sch
-            oactrl.resetMinimumFractionofOutdoorAirSchedule
-            oactrl.setMinimumOutdoorAirSchedule(oa_sch)
+        end
+
+        if oa_sch
+          os_air_loops.each do |os_air_loop|
+            oasys = os_air_loop.airLoopHVACOutdoorAirSystem
+            unless oasys.empty?
+              os_oasys = oasys.get
+              oactrl = os_oasys.getControllerOutdoorAir
+              oactrl.resetMinimumFractionofOutdoorAirSchedule
+              oactrl.setMinimumOutdoorAirSchedule(oa_sch)
+            end
           end
         end
       end
@@ -234,7 +254,7 @@ module Honeybee
       end
 
       # assign an electric humidifier if there's an air loop and the zones have a humidistat
-      if os_air_loop
+      if !os_air_loops.empty?
         humidistat_exists = false
         zones.each do |zone|
           h_stat = zone.zoneControlHumidistat
@@ -243,7 +263,9 @@ module Honeybee
           end
         end
         if humidistat_exists
-          humidifier = create_humidifier(openstudio_model, os_air_loop)
+          os_air_loops.each do |os_air_loop|
+            humidifier = create_humidifier(openstudio_model, os_air_loop)
+          end
         end
       end
 
@@ -253,7 +275,6 @@ module Honeybee
         sizing.setSizingOption('NonCoincident')
       end
 
-      os_hvac
     end
 
   private

data/lib/to_openstudio/model.rb

@@ -564,7 +564,7 @@ module Honeybee
             end
           elsif TemplateHVAC.types.include?(system_type)
             template_system = TemplateHVAC.new(hvac)
-            os_template_system = template_system.to_openstudio(@openstudio_model, hvac['rooms'])
+            template_system.to_openstudio(@openstudio_model, hvac['rooms'])
           end
         end
       end

data/lib/to_openstudio/simulation/parameter_model.rb

@@ -154,6 +154,7 @@ module Honeybee
           end
         end
       end
+
       # use the average of design day temperatures to set the water mains temperature
       os_water_mains = @openstudio_model.getSiteWaterMainsTemperature 
       os_water_mains.setCalculationMethod('Correlation')
@@ -164,6 +165,62 @@ module Honeybee
       end
       os_water_mains.setMaximumDifferenceInMonthlyAverageOutdoorAirTemperatures(4)
 
+      # set the climate zone from design days assuming 0.4% extremes and normal distribution
+      climate_zone_objs = @openstudio_model.getClimateZones
+      ashrae_zones = climate_zone_objs.getClimateZones('ASHRAE')
+      if ashrae_zones.empty? && db_temps.length > 0
+        # generate temperatures according to a normal distribution
+        mean_temp = (db_temps.max + db_temps.min) / 2
+        dist_to_mean = db_temps.max - mean_temp
+        st_dev = dist_to_mean / 2.65
+        vals = []
+        for i in 0..4379
+          step_seed = i.to_f / 4380
+          add_val1, add_val2 = gaussian(mean_temp, st_dev, step_seed)
+          vals << add_val1
+          vals << add_val2
+        end
+
+        # compute the number of heating and cooling degree days
+        cooling_deg_days, heating_deg_days = 0, 0
+        vals.each do |temp|
+          if temp > 10
+            cdd = (temp - 10) / 24
+            cooling_deg_days += cdd
+          end
+          if temp < 18
+            hdd = (18 - temp) / 24
+            heating_deg_days += hdd
+          end
+        end
+
+        # determine the climate zone from the degree-day distribution
+        if cooling_deg_days > 5000
+          cz = '1'
+        elsif cooling_deg_days > 3500
+          cz = '2A'
+        elsif cooling_deg_days > 2500
+          cz = '3A'
+        elsif cooling_deg_days <= 2500 and heating_deg_days <= 2000
+          cz = '3C'
+        elsif cooling_deg_days <= 2500 and heating_deg_days <= 3000
+          cz = '4A'
+        elsif heating_deg_days <= 3000
+          cz = '4C'
+        elsif heating_deg_days <= 4000
+          cz = '5A'
+        elsif heating_deg_days <= 5000
+          cz = '6A'
+        elsif heating_deg_days <= 7000
+          cz = '7'
+        else
+            cz = '8'
+        end
+
+        # set the climate zone
+        climate_zone_objs.setClimateZone('ASHRAE', cz)
+      end
+
       # set Outputs for the simulation
       if @hash[:output]
         if @hash[:output][:outputs]
@@ -251,5 +308,15 @@ module Honeybee
 
     end
 
+    def gaussian(mean, stddev, seed)
+      # generate a gaussian distribution of values
+      theta = 2 * Math::PI * seed
+      rho = Math.sqrt(-2 * Math.log(1 - seed))
+      scale = stddev * rho
+      x = mean + scale * Math.cos(theta)
+      y = mean + scale * Math.sin(theta)
+      return x, y
+    end
+
   end #SimulationParameter
 end #Honeybee

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: honeybee-openstudio
 version: !ruby/object:Gem::Version
-  version: 2.30.5
+  version: 2.31.0
 platform: ruby
 authors:
 - Tanushree Charan
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-03-09 00:00:00.000000000 Z
+date: 2022-03-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -302,6 +302,7 @@ files:
 - lib/to_openstudio/geometry/shade.rb
 - lib/to_openstudio/hvac/Model.hvac.rb
 - lib/to_openstudio/hvac/ideal_air.rb
+- lib/to_openstudio/hvac/radiant.rb
 - lib/to_openstudio/hvac/template.rb
 - lib/to_openstudio/internalmass.rb
 - lib/to_openstudio/load/daylight.rb