fix(to_honeybee): Correct the to_honeybee methods to expose add_plenum

dragonfly_grasshopper/src/DF Model To Honeybee.py

@@ -28,7 +28,13 @@
             simulation will be run once for each unique room and then results
             will be multiplied. If False, full geometry objects will be written
             for each and every story in the building such that all resulting
-            multipliers will be 1. Default: True.
+            multipliers will be 1. (Default: True).
+        add_plenum_: Boolean to indicate whether ceiling/floor plenums should
+            be auto-generated for the Rooms. The height of ceiling plenums
+            will be autocalculated as the difference between the Room2D
+            ceiling height and Story ceiling height. The height of the floor
+            plenum will be autocalculated as the difference between the Room2D
+            floor height and Story floor height. (Default: False).
         shade_dist_: An optional number to note the distance beyond which other
             buildings' shade should not be exported into a given Model. This is
             helpful for reducing the simulation run time of each Model when other
@@ -49,7 +55,7 @@
 
 ghenv.Component.Name = 'DF Model To Honeybee'
 ghenv.Component.NickName = 'ToHoneybee'
-ghenv.Component.Message = '0.1.2'
+ghenv.Component.Message = '0.2.0'
 ghenv.Component.Category = 'Dragonfly'
 ghenv.Component.SubCategory = '2 :: Serialize'
 ghenv.Component.AdditionalHelpFromDocStrings = '3'
@@ -71,12 +77,14 @@
 if all_required_inputs(ghenv.Component) and _run:
     # set default inputs if not specified
     use_multiplier_ = use_multiplier_ if use_multiplier_ is not None else True
+    add_plenum_ = add_plenum_ if add_plenum_ is not None else False
     _obj_per_model_ = 'Building' if _obj_per_model_ is None else _obj_per_model_
 
     # check the _model input
     assert isinstance(_model, Model), \
         'Expected Dragonfly Model object. Got {}.'.format(type(_model))
 
     # create the model objects
-    hb_models = _model.to_honeybee(_obj_per_model_, shade_dist_,
-                                   use_multiplier_, tolerance)
+    hb_models = _model.to_honeybee(
+        _obj_per_model_, shade_dist_, use_multiplier_, add_plenum_,
+        tolerance=tolerance)

dragonfly_grasshopper/src/DF Model To geoJSON.py

@@ -26,6 +26,12 @@
             will be multiplied. If False, full geometry objects will be written
             for each and every story in the building such that all resulting
             multipliers will be 1. Default: True.
+        add_plenum_: Boolean to indicate whether ceiling/floor plenums should
+            be auto-generated for the Rooms. The height of ceiling plenums
+            will be autocalculated as the difference between the Room2D
+            ceiling height and Story ceiling height. The height of the floor
+            plenum will be autocalculated as the difference between the Room2D
+            floor height and Story floor height. (Default: False).
         shade_dist_: An optional number to note the distance beyond which other
             buildings' shade should not be exported into a given Model. This is
             helpful for reducing the simulation run time of each Model when other
@@ -59,7 +65,7 @@
 
 ghenv.Component.Name = 'DF Model To geoJSON'
 ghenv.Component.NickName = 'ToGeoJSON'
-ghenv.Component.Message = '0.1.1'
+ghenv.Component.Message = '0.2.0'
 ghenv.Component.Category = 'Dragonfly'
 ghenv.Component.SubCategory = '2 :: Serialize'
 ghenv.Component.AdditionalHelpFromDocStrings = '3'
@@ -92,6 +98,7 @@
     # set default inputs if not specified
     point = to_point2d(_point_) if _point_ is not None else Point2D(0, 0)
     use_multiplier_ = use_multiplier_ if use_multiplier_ is not None else True
+    add_plenum_ = add_plenum_ if add_plenum_ is not None else False
 
     # check the _model and _location input
     assert isinstance(_model, Model), \
@@ -104,5 +111,5 @@
     else:
         # create the geoJSON and honeybee Model JSONs
         geojson, hb_jsons, hb_models = _model.to.urbanopt(
-            _model, _location, point, shade_dist_, use_multiplier_, _folder_,
-            tolerance)
+            _model, _location, point, shade_dist_, use_multiplier_, add_plenum_,
+            _folder_, tolerance=tolerance)

dragonfly_grasshopper/src/DF Story.py

@@ -18,6 +18,10 @@
             this Story to the floor of the story above this one (if it exists).
             If None, this value will be the maximum floor_to_ceiling_height of the
             input _room_2ds.
+        _flr_height_: A number for the absolute floor height of the Story.
+            If None, this will be the minimum floor height of all the Story's
+            room_2ds, which is suitable for cases where there are no floor
+            plenums. (Default: None).
         _name_: Text to set the name for the Story, which will also be incorporated
             into unique Story identifier. If the name is not provided a random
             one will be assigned.
@@ -38,7 +42,7 @@
 
 ghenv.Component.Name = "DF Story"
 ghenv.Component.NickName = 'Story'
-ghenv.Component.Message = '0.1.3'
+ghenv.Component.Message = '0.2.0'
 ghenv.Component.Category = "Dragonfly"
 ghenv.Component.SubCategory = '0 :: Create'
 ghenv.Component.AdditionalHelpFromDocStrings = "3"
@@ -84,7 +88,7 @@
     multiplier_ = multiplier_ if multiplier_ is not None else 1
 
     # create the Story
-    story = Story(name, room2ds, _flr_to_flr_, multiplier_)
+    story = Story(name, room2ds, _flr_to_flr_, _flr_height_, multiplier_)
     if _name_ is not None:
         story.display_name = _name_