From 816691c33e591303ad509151d72fdf8113246c7a Mon Sep 17 00:00:00 2001
From: Chris Mackey <chris@ladybug.tools>
Date: Wed, 10 Jul 2024 15:49:11 -0700
Subject: [PATCH] fix(create): Add secret option to turn off all rect split in
 Ap by Ratio

---
 .../icon/HB Apertures by Ratio.png            | Bin 1296 -> 1298 bytes
 .../json/HB_Apertures_by_Ratio.json           |   8 ++---
 .../src/HB Apertures by Ratio.py              |  28 ++++++++++++------
 .../user_objects/HB Apertures by Ratio.ghuser | Bin 6924 -> 7253 bytes
 4 files changed, 23 insertions(+), 13 deletions(-)

diff --git a/honeybee_grasshopper_core/icon/HB Apertures by Ratio.png b/honeybee_grasshopper_core/icon/HB Apertures by Ratio.png
index 670b1db8c309a27c5886d3e485f892105b2a2deb..8540d1c8687827cf0d95f68d58729527e88a1bb5 100644
GIT binary patch
delta 1228
zcmV;-1T*`P3X%$tR)42SL_t(YOWjp#P*qhF-e=$8KETW4it;kJ@)#5X<dMVx^0+)N
z5fGwi>3}6#h>SL+7!5rzLW_uDoXHt&B&m3*=#UDCD4IB=r8(v_O#{{#+4T6OrNGzP
z=N#{qWcpFlpVrJbd#%0C{=U1{+IwC0zcV9Y7J;jyfQF#GFMk$hAPC<{j_hlCg81H5
z9jBS&Tvz?I4SBxb*FI^!vMRx2e6_`MympoUwdz9iH^LWaULX9$2J5`*!e5u=b)%^)
z_|m<#@*JPh?Ir$K;{#lNCcYwt)^3LNxxU}wycIZ+4jfAbjwAuyN%*5J4(PD}9gBhX
zXrL_$I1q>1?SBctN0CZ=IFa^c0K-{0w=)_Bt>ys%UCj#f6`8!xf)`eXz}xHxcV{hJ
zJUrm-<^XSt6<%2d@XA>V@3;gw8}*o-mIsgQr3i{xfFJh80w>dPa!2%}$wil@^4iS!
zMBMD3(4PkMTkup)Fc^0RE2#(Tx(R0T1zXnyb`oHx34ifLU|D5~KS;=4i_wM!z)%J{
zw}gWDRw}f1vkMHQqa<aH_y~OWmtf}sP4Y7E*c`A=0p55P8lx-NzA?m{xdZEE638sY
zSmQ$AGzn~-SwL4+Xuc|^hy+S4UW!2T2-qbejY<PgS`PLZ`4LIr1(jd}fMfTsa6SR(
ztZNj3L4Qh7ebl7MNt3S7+D*SH&-ZJbpcC|^ptL9w%qtW;Bo4gnO>hS-q{bmgO~c?u
zH%M*cVEy#Vj}!U;Lymd^5*XONXwp%uv8uc_v!|#x8KwClU^_;@^DDrkGr(W&fF#nh
zFcy5pHYHWB9)k27)ur<n7z!&e_72s+o}v{Bt$*F73*-cVHGicPu$M4Igs&Y2cX5Yw
z{CDuuTKObAED_8%6poK(Vr&;(*}tiQ!`n{>U6gAe1Re_nYrG70<TlvB-$-N%JRkym
zO&tl`0oNHIRkcE*ny|2B(9_1)`}8j8nqFuOx;xKZzeMG=nd92bIoE9`xL<%yz+d_p
z+<)W&>62TK_FRMHpo6sQf}ARrR|)D77~2~UoXWt5HQ`fQ4J%N2Z8mG!61N|x3G5yP
zJ4FO^OZfaSNSpV7jZoY}DKdFNs%{6nNO6o6dah9fC`AXV<P;Svw03h^o$7f*7U)k!
zvBeLpxB+Zy7g+9#w7~$ju?4KM6>JO51%JeY>E?n(<|%7)=413dY9%DlT^%L_9%vN~
zbtV3viyBP!q++Du5$rGbL+i5-VPBaKS~i8CwcISnGM*2`2O9&?@{A|;liyJlj$577
zyLv4csR^0zbk!%Ryf&M)EJ;bx#KC0XC^b9rCd7%vD2gwi?k{sPl)0&H+DGHTZGR8X
zm?C3wqUomiVB%2nKZe-frPSbocVMW<_WAZ-3-qO-y(VIc+I6nVYcp+qY2alHX9LHn
z_mhwe$|-tPUqGx8$+Y;MFXqo=;K~~z6LV*3*JeMLyT|HcaJD{L&ZEF!T@?CXUu27i
z--<y`O}Olf+j4Ga4EbSleDswFoJDzeF*fJZ4P<PcLTfkiKm53g6vA>9;+JIK7bg(%
qRbO1iMAa7%dy`e)hwxt;V}Al$#al4V{G=-Y0000<MNUMnLSTaa;!#-u

delta 1226
zcmV;*1U37T3XlqrR)3{QL_t(YOWjp{OqEp_KkvEYegGE``NrT1IursFNMe9oxO`qR
zFa*)kfhAgqPFpEPBMXP95i#bLn>J0B0*dHJ`4qnrM_Ljy*IEN>Mz%iw(o*2pbKdv$
zUJ2G8wf^bZeml=|&U=2pd!FZ<=d%Bu841n=u8sm4g7&dkn16vFd?z`wujvWmdpC8Q
zWR6~L`db@v0=}<$-ZZo-!FzPI#b>l?RnV=9JkvMA7id@?^2G-0tlPq0m+5<_z9i(v
zqqWj(|KXiQK{w-rU4JINe1+C-hV@GVzQa{3(31w7O#x0P0c}b6<5(QfZULGX0Zq}s
zu_)j~9PT$I0Dm7ZRN_;Kv@ad#&%~8I(J*K=Qv`ICD@;Q&d6xyRtqg^qDG(kmTDW?9
z!*7NI{47@ZW-f(q_A>azCBVg~$IR3mcxNrc+{k(O;b1IqE)C~)M~}O^>QYr+n;D;r
zoB0#EQ-N*^UdRps<1S!DHDJf@g1HBPt*Zw+2e1o-_<ww`%o4@#BV?_`aP2(cVmey3
zhJpB2DztX93-qR;DA`kd1it@Eu&aQ^TmT-M4fZL(>n=lMbOSpyf|yGWU>ziZjAD$`
z%?B=!z_#fHbme)bn{tXspxEN82s8|U-5}DaRPdzbV4sm6nFPLc6Id_c*!C-2dH|hu
zjUv!TDSxVo8h3Znq$#v^({IiR_!>QQg05r~=Pv~F4FeC2125SH?x2NKcM(#3Ke%xQ
zq+_FC-So>l2wi|7TRi~@^zK|R?x@vRRbHFfQ`Bijac(Hs?g8-JGVthh@Hd+wiS*2m
z1z)jUN!5;%kY1s>wEO}?UKvK-qZ-&#v_he^+ka$%>|n5luap9I5-t+q+o!-?Js@@b
z4qjX(pM-}ef(3-Z@#zeV?4v9DH#Km0_r<x_<r)ZqXXb#_4T7D%57zn{iA;b8M}n`Z
zCV>awIs>HgMo3f>7H$STZH#<K?}D!BwYrdpvpn>RRbHDpuFdegZ9Bo^0(1iY#!+y0
zZ+}Ri+=F!B79<B9q<z=qRI!{*pdNvdgYm%mbR4aWn9yq2QkB<c&IOBS{5VNq|1j8j
zBA{EsXNN=DasX_A;&w`ryAPy_Ca~)i$5^4~8byFobfR2NQK3R>H>cGpK6hk+?i3VS
z0>KJv!L}U-Tk<+>Fo11547RBeY%9$L$A5$AyucRbC~KaxG5i6w5)x>u2p0lVT7^S(
zQPAh22IK817^r;;M@j?H`0^7tRN{}rn?uo9YLa6auZH2HjdO7LB_A9izqvdD_gbiT
zby_g6BXrEiO`oLl+RV8iNlDRIs~I>$%}%@taUwB_;>)M|%bW~lZlaC$(b&5E$$x26
zWGqZ{zbif%J8AyM5c`iSHJI`a3}spV-~MZXu2i&CMov(>UZV2aOj}btXAu2aKnL}H
z5|TkVMW^Zuh&3Xa6hHFC{H1gZ?Ft?9nyy_31-d>wTOEVTHPLb&1^TL^(EZK=Tim}l
z2JMv*vM+ASl|3=!hs*Jqw<2-r{X<3Al1n#`v2_Zq-NgU!vnrAa%T<V9lJ!`eK*&{n
oaTOC)UqI|NtG++szc$AH1bF9LJk)^%CIA2c07*qoM6N<$f_BVHYybcN

diff --git a/honeybee_grasshopper_core/json/HB_Apertures_by_Ratio.json b/honeybee_grasshopper_core/json/HB_Apertures_by_Ratio.json
index 3fb92a3..3402c31 100644
--- a/honeybee_grasshopper_core/json/HB_Apertures_by_Ratio.json
+++ b/honeybee_grasshopper_core/json/HB_Apertures_by_Ratio.json
@@ -1,5 +1,5 @@
 {
-  "version": "1.8.0", 
+  "version": "1.8.1", 
   "nickname": "AperturesByRatio", 
   "outputs": [
     [
@@ -30,8 +30,8 @@
     {
       "access": "list", 
       "name": "_subdivide_", 
-      "description": "Boolean to note whether to generate a single window in the\ncenter of each Face (False) or to generate a series of rectangular\nwindows using the other inputs below (True). The latter is often more\nrealistic and is important to consider for detailed daylight and\nthermal comfort simulations but the former is likely better when the\nonly concern is building energy use since energy use doesn't change\nmuch while the glazing ratio remains constant. (Default: True).", 
-      "type": "bool", 
+      "description": "Boolean to note whether to generate only one or two windows\nfor each Face (False) or to generate a series of repeating rectangular\nwindows using the other inputs below (True). The latter is often more\nrealistic and distributes the windows across the parent Face\nfor better daylight but the former is likely more useful when\nmodeling building energy use since energy use doesn't change\nsignifcantly while the glazing ratio remains constant. (Default: True).\n_\nNote that this input can also be the integer -1 to completely turn\noff all spltting of the base face into underling rectangles. By\ndefault, a False value here will result in two windows generated\nfor and input pentagonal gabled geometry - one rectangle and one\ntriangle. This is better for engines like EnergyPlus that cannot\nmodel windows with more than 4 vertices. However, if a single\npentagonal window is desired for such a shape, setting this\ninput to -1 will produce such a result.", 
+      "type": "int", 
       "default": null
     }, 
     {
@@ -71,7 +71,7 @@
     }
   ], 
   "subcategory": "0 :: Create", 
-  "code": "\ntry:  # import the core honeybee dependencies\n    from honeybee.boundarycondition import Outdoors\n    from honeybee.facetype import Wall\n    from honeybee.face import Face\n    from honeybee.room import Room\n    from honeybee.model import Model\n    from honeybee.orientation import check_matching_inputs, angles_from_num_orient, \\\n        face_orient_index, inputs_by_index\nexcept ImportError as e:\n    raise ImportError('\\nFailed to import honeybee:\\n\\t{}'.format(e))\n\ntry:  # import the ladybug_{{cad}} dependencies\n    from ladybug_{{cad}}.config import tolerance, conversion_to_meters\n    from ladybug_{{cad}}.{{plugin}} import all_required_inputs\nexcept ImportError as e:\n    raise ImportError('\\nFailed to import ladybug_{{cad}}:\\n\\t{}'.format(e))\n\n\ndef can_host_apeture(face):\n    \"\"\"Test if a face is intended to host apertures (according to this component).\"\"\"\n    return isinstance(face.boundary_condition, Outdoors) and \\\n        isinstance(face.type, Wall)\n\n\ndef assign_apertures(face, sub, rat, hgt, sil, hor, vert, op):\n    \"\"\"Assign apertures to a Face based on a set of inputs.\"\"\"\n    if sub:\n        face.apertures_by_ratio_rectangle(rat, hgt, sil, hor, vert, tolerance)\n    else:\n        face.apertures_by_ratio(rat, tolerance)\n\n    # try to assign the operable property\n    if op:\n        for ap in face.apertures:\n            ap.is_operable = op\n\n\nif all_required_inputs(ghenv.Component):\n    # duplicate the initial objects\n    hb_objs = [obj.duplicate() for obj in _hb_objs]\n    \n    # set defaults for any blank inputs\n    conversion = conversion_to_meters()\n    _subdivide_ = _subdivide_ if len(_subdivide_) != 0 else [True]\n    _win_height_ = _win_height_ if len(_win_height_) != 0 else [2.0 / conversion]\n    _sill_height_ = _sill_height_ if len(_sill_height_) != 0 else [0.8 / conversion]\n    _horiz_separ_ = _horiz_separ_ if len(_horiz_separ_) != 0 else [3.0 / conversion]\n    vert_separ_ = vert_separ_ if len(vert_separ_) != 0 else [0.0]\n    operable_ = operable_ if len(operable_) != 0 else [False]\n\n    # gather all of the inputs together\n    all_inputs = [_subdivide_, _ratio, _win_height_, _sill_height_, _horiz_separ_,\n                  vert_separ_, operable_]\n\n    # ensure matching list lengths across all values\n    all_inputs, num_orient = check_matching_inputs(all_inputs)\n\n    # get a list of angles used to categorize the faces\n    angles = angles_from_num_orient(num_orient)\n\n    # loop through the input objects and add apertures\n    for obj in hb_objs:\n        if isinstance(obj, Model):\n            for room in obj.rooms:\n                for face in room.faces:\n                    if can_host_apeture(face):\n                        orient_i = face_orient_index(face, angles)\n                        sub, rat, hgt, sil, hor, vert, op = \\\n                            inputs_by_index(orient_i, all_inputs)\n                        assign_apertures(face, sub, rat, hgt, sil, hor, vert, op)\n        elif isinstance(obj, Room):\n            for face in obj.faces:\n                if can_host_apeture(face):\n                    orient_i = face_orient_index(face, angles)\n                    sub, rat, hgt, sil, hor, vert, op = inputs_by_index(orient_i, all_inputs)\n                    assign_apertures(face, sub, rat, hgt, sil, hor, vert, op)\n        elif isinstance(obj, Face):\n            if can_host_apeture(obj):\n                orient_i = face_orient_index(obj, angles)\n                sub, rat, hgt, sil, hor, vert, op = inputs_by_index(orient_i, all_inputs)\n                assign_apertures(obj, sub, rat, hgt, sil, hor, vert, op)\n        else:\n            raise TypeError(\n                'Input _hb_objs must be a Model Room or Face. Not {}.'.format(type(obj)))", 
+  "code": "\ntry:  # import the core honeybee dependencies\n    from honeybee.boundarycondition import Outdoors\n    from honeybee.facetype import Wall\n    from honeybee.face import Face\n    from honeybee.room import Room\n    from honeybee.model import Model\n    from honeybee.orientation import check_matching_inputs, angles_from_num_orient, \\\n        face_orient_index, inputs_by_index\nexcept ImportError as e:\n    raise ImportError('\\nFailed to import honeybee:\\n\\t{}'.format(e))\n\ntry:  # import the ladybug_{{cad}} dependencies\n    from ladybug_{{cad}}.config import tolerance, conversion_to_meters\n    from ladybug_{{cad}}.{{plugin}} import all_required_inputs\nexcept ImportError as e:\n    raise ImportError('\\nFailed to import ladybug_{{cad}}:\\n\\t{}'.format(e))\n\n\ndef can_host_apeture(face):\n    \"\"\"Test if a face is intended to host apertures (according to this component).\"\"\"\n    return isinstance(face.boundary_condition, Outdoors) and \\\n        isinstance(face.type, Wall)\n\n\ndef assign_apertures(face, sub, rat, hgt, sil, hor, vert, op):\n    \"\"\"Assign apertures to a Face based on a set of inputs.\"\"\"\n    if sub > 0:\n        face.apertures_by_ratio_rectangle(rat, hgt, sil, hor, vert, tolerance)\n    else:\n        rect = True if sub == 0 else False\n        face.apertures_by_ratio(rat, tolerance, rect)\n\n    # try to assign the operable property\n    if op:\n        for ap in face.apertures:\n            ap.is_operable = op\n\n\nif all_required_inputs(ghenv.Component):\n    # duplicate the initial objects\n    hb_objs = [obj.duplicate() for obj in _hb_objs]\n    \n    # set defaults for any blank inputs\n    conversion = conversion_to_meters()\n    _subdivide_ = _subdivide_ if len(_subdivide_) != 0 else [True]\n    _win_height_ = _win_height_ if len(_win_height_) != 0 else [2.0 / conversion]\n    _sill_height_ = _sill_height_ if len(_sill_height_) != 0 else [0.8 / conversion]\n    _horiz_separ_ = _horiz_separ_ if len(_horiz_separ_) != 0 else [3.0 / conversion]\n    vert_separ_ = vert_separ_ if len(vert_separ_) != 0 else [0.0]\n    operable_ = operable_ if len(operable_) != 0 else [False]\n\n    # gather all of the inputs together\n    all_inputs = [_subdivide_, _ratio, _win_height_, _sill_height_, _horiz_separ_,\n                  vert_separ_, operable_]\n\n    # ensure matching list lengths across all values\n    all_inputs, num_orient = check_matching_inputs(all_inputs)\n\n    # get a list of angles used to categorize the faces\n    angles = angles_from_num_orient(num_orient)\n\n    # loop through the input objects and add apertures\n    for obj in hb_objs:\n        if isinstance(obj, Model):\n            for room in obj.rooms:\n                for face in room.faces:\n                    if can_host_apeture(face):\n                        orient_i = face_orient_index(face, angles)\n                        sub, rat, hgt, sil, hor, vert, op = \\\n                            inputs_by_index(orient_i, all_inputs)\n                        assign_apertures(face, sub, rat, hgt, sil, hor, vert, op)\n        elif isinstance(obj, Room):\n            for face in obj.faces:\n                if can_host_apeture(face):\n                    orient_i = face_orient_index(face, angles)\n                    sub, rat, hgt, sil, hor, vert, op = inputs_by_index(orient_i, all_inputs)\n                    assign_apertures(face, sub, rat, hgt, sil, hor, vert, op)\n        elif isinstance(obj, Face):\n            if can_host_apeture(obj):\n                orient_i = face_orient_index(obj, angles)\n                sub, rat, hgt, sil, hor, vert, op = inputs_by_index(orient_i, all_inputs)\n                assign_apertures(obj, sub, rat, hgt, sil, hor, vert, op)\n        else:\n            raise TypeError(\n                'Input _hb_objs must be a Model Room or Face. Not {}.'.format(type(obj)))", 
   "category": "Honeybee", 
   "name": "HB Apertures by Ratio", 
   "description": "Add apertures to a Honeybee Face or Room given a ratio of aperture area to face area.\n_\nNote that this component will only add Apertures to Faces that are Walls and have\nan Outdoors boundary condition.\n-"
diff --git a/honeybee_grasshopper_core/src/HB Apertures by Ratio.py b/honeybee_grasshopper_core/src/HB Apertures by Ratio.py
index 14d50fa..60bce7a 100644
--- a/honeybee_grasshopper_core/src/HB Apertures by Ratio.py	
+++ b/honeybee_grasshopper_core/src/HB Apertures by Ratio.py	
@@ -22,13 +22,22 @@
             the apertures and the area of the parent face. If an array of values
             are input here, different ratios will be assigned based on
             cardinal direction, starting with north and moving clockwise.
-        _subdivide_: Boolean to note whether to generate a single window in the
-            center of each Face (False) or to generate a series of rectangular
+        _subdivide_: Boolean to note whether to generate only one or two windows
+            for each Face (False) or to generate a series of repeating rectangular
             windows using the other inputs below (True). The latter is often more
-            realistic and is important to consider for detailed daylight and
-            thermal comfort simulations but the former is likely better when the
-            only concern is building energy use since energy use doesn't change
-            much while the glazing ratio remains constant. (Default: True).
+            realistic and distributes the windows across the parent Face
+            for better daylight but the former is likely more useful when
+            modeling building energy use since energy use doesn't change
+            signifcantly while the glazing ratio remains constant. (Default: True).
+            _
+            Note that this input can also be the integer -1 to completely turn
+            off all spltting of the base face into underling rectangles. By
+            default, a False value here will result in two windows generated
+            for and input pentagonal gabled geometry - one rectangle and one
+            triangle. This is better for engines like EnergyPlus that cannot
+            model windows with more than 4 vertices. However, if a single
+            pentagonal window is desired for such a shape, setting this
+            input to -1 will produce such a result.
         _win_height_: A number for the target height of the output apertures.
             Note that, if the ratio is too large for the height, the ratio will
             take precedence and the actual aperture height will be larger
@@ -64,7 +73,7 @@
 
 ghenv.Component.Name = 'HB Apertures by Ratio'
 ghenv.Component.NickName = 'AperturesByRatio'
-ghenv.Component.Message = '1.8.0'
+ghenv.Component.Message = '1.8.1'
 ghenv.Component.Category = 'Honeybee'
 ghenv.Component.SubCategory = '0 :: Create'
 ghenv.Component.AdditionalHelpFromDocStrings = '4'
@@ -95,10 +104,11 @@ def can_host_apeture(face):
 
 def assign_apertures(face, sub, rat, hgt, sil, hor, vert, op):
     """Assign apertures to a Face based on a set of inputs."""
-    if sub:
+    if sub > 0:
         face.apertures_by_ratio_rectangle(rat, hgt, sil, hor, vert, tolerance)
     else:
-        face.apertures_by_ratio(rat, tolerance)
+        rect = True if sub == 0 else False
+        face.apertures_by_ratio(rat, tolerance, rect)
 
     # try to assign the operable property
     if op:
diff --git a/honeybee_grasshopper_core/user_objects/HB Apertures by Ratio.ghuser b/honeybee_grasshopper_core/user_objects/HB Apertures by Ratio.ghuser
index f39dc9054c5cc2f1aacebcf296491578dd6cab1a..867359d523706495255e159a231600fecafe060f 100644
GIT binary patch
literal 7253
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

literal 6924
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
S-@!1s03SaBB%C3y>;DHYjGQb0