From 417d877a7a7037ea87440f5b5318fb63e5b59559 Mon Sep 17 00:00:00 2001
From: Chris Mackey <chris@ladybug.tools>
Date: Tue, 5 Apr 2022 12:08:12 -0400
Subject: [PATCH] fix(serialize): Do not triangulate sub-faces by default in
 gbXML export

---
 .../icon/HB Dump gbXML.png                    | Bin 1543 -> 1543 bytes
 .../json/HB_Dump_gbXML.json                   |  11 +++++++++--
 .../src/HB Dump gbXML.py                      |  12 ++++++++++--
 .../user_objects/HB Dump gbXML.ghuser         | Bin 6790 -> 7095 bytes
 4 files changed, 19 insertions(+), 4 deletions(-)

diff --git a/honeybee_grasshopper_core/icon/HB Dump gbXML.png b/honeybee_grasshopper_core/icon/HB Dump gbXML.png
index 309b2cd5071365145be189ce495d3ee8754ff035..6d3f7520d8633bae0acec589c42b2e476b21dae8 100644
GIT binary patch
delta 1466
zcmV;r1x5OY42KMmUw?T_lV=>qpJ_BZ;)N3gIRvI0QD6dvaR}qK1xh(YP!W%L1mzIL
z0YahWD2J9)kSUawmU0ROIn;QfZW6pEf&ykJx@Ga2na85;y9an<h}oPb`(vNvm*#!j
z-{;%+_dM@I{;#Of;?kNvcJ&`Jlh!U%Q<D*2Zw_Wmn^rx3`+q~>6LlhSWEmXYID@%E
z$Rx6Jp}zh|c-U%Wi87IsErPbTb|3v_>i7@dhy9LrM9Ho5KFxoe(Ib5xekSJ!t(LWN
zvei^-$Ff0gPByZ$L=dE=(10wktSmvh7K}Il8x`)6(^a9!8LUO=^+s5=N5S++1Z;YC
zLoba3KQGQ$Kz~XKpH>P)nHg9^pXSr4AD1wOcOdh&p47-g>Xk}V_BO+&Z99@Le22RJ
zb{zZldu-xwg};yQ*l3bd1W4iwAQYq`m7k2cb2W}JmUkfYD%U=~1r7Zj*m5=xC0Fav
zbmIu**IUqZ?-T+eLa-`06lobEbmzKbP;3j4FbRpV@qd`@r27YH;3hDpzk$!6L?mAQ
zW=Eq@-FJ9QUfbUW8I@PjYPfS8ULhQ8UcV8k!VKKav%t$DU1SS)BPli!YR*O=?ExTi
zzeL9P7IMxkBJ+G?(iVYw`UImPqvEmZYlU*C1J2$qh>eN?UyzQU#8!A(Xh;JRk+3rX
z=B_NvYJXY@(#!*q`35r92}pVBq{{8d=S^XdUROaeAwbc87?P`pVDDm&-SG)@{=zo_
zS%O5w#l^$J%N62F3d~f|5QX<cQWH3bF*DQzenRBl_eiZD(t9LmxY7A0pn9MkMO`x3
zIerCUDqY;S0^+|-guSZ+4)t|Fcu|7MhnIs$*?+l=c>;33)1=-9?ne^PI&cg!IvNQL
zs=d_-QA-gV9qf@U%0hZ(Hg4y$@U*}H;;dBqKBU3!Ydajg+<^9>6JVdoplcEMbZ3{?
zh%qzBeUnLR5T+>nu;+>r^;F*6eE`b4U5Kv`!rjG%Zc72!9A8{YHpGikV|=rEIaaL<
zgMZsHS31T<D27g=n)Xa@2}bA{@kz$aAon*Q2R&X91qa5hkr+9&1~2opaQ4SCtS?A~
zr;97BmMnpr$1)7&THvvGK9<^8Kz)t|boAyy*inI&zFNHAzZgyVI@s2ehrDa5wTzuX
z&OJ!lR)AFbKwP>Q*sG2|t1J+;jSX`vM}OF|tdT1&z;K>5p6^?T^yFR8)YO8Zkr|v_
ztnpZC3*^o~SIHuTb!8y!vivuaXQ|8BDGDDABK3Jd8UsP918|_s5-8Nfh(H4#Hb(FZ
zUISrz=GY>S1|-ErLR;SiD}wydn_>tQso{yz3o+*k!9J0W(qYx;wq3{A87jGK(tkt)
z>gbD8?T^}0bD&rgPfE;?FG|9WBoT&bz>DIAh>MMep1}fKNm~R+b#NhC4e4b9L|>C4
z_Ixq&Z#B{Y?<~eV0U37_Q3Zk22hv67p>uRxh3fb@-weW(WZc|qi{Fckkhp6H+GFTH
zuh7CT`KE9%GX^hqBVv0GpoX3V+kfdNk+_N(>swTD!%2hZE7BZ{&*WU3D={4l84|N_
zC+|x<%r{2wUMHYj2lvH>*c8Hssi`%*Hv2<*y91qrC&4-!4^r+N#Tfqv8P}22^9D$J
zC}u0UxLRxs6lmc^;e0$V)Ccy>!!wZ{VglUY>Fy5)b1V3Ua&i8_MZ{hx!GA|JT#!n(
z31j;Q#7;Abl2=IT*{`)*0&r`;5e?DB>jFJIE71oh$pH&C@ZhxG7na^jVHf6w4c+;e
z(iuwU&yg~g_dv-rC-uSQM%A8=?n_MQXubfa))S;91VlwQMAK-|bsMc#|Ist)6lq#F
zjp_aXnj<yJDy+lzNLW?$3^VH@)!du(m>DJtzX783>n05WDpJRbAhki0#~TRw3#~+D
UiF@0b`Tzg`07*qoM6N<$f`J>mC;$Ke

delta 1466
zcmV;r1x5OY42KMmUw?N@lxG~rpK3H6abX2P5P>RiQJ?|`We8;ma=>v65mdxcM^J_+
z77z~Z7{|~%mLOF)?zq8}B}0u9wUywi2nv{@Xq(1WQ%9rr+Xr}Kh-s}R{iC1cm&^O!
z{XXA&f6wzi<o}8WEiSF8qgVeS(`oHuu}p`3y*ZdRWr}L-_J4=MCz?d+$TmE>aT;@n
zkO^ex0t18L@UYd$5@jMMTLfKQ-Cp|5<gp*T5BnYMh?-mDeVYF`qg(bo{7lXdI?Zbp
zWGhQ%$F@OkPByZ$L=dE=(10wktt>&i=8rZ18|ChiQ=3AOGf<6^>-Df|ivsIN1Z=u@
zLqClJKTpnRKz~XKpH>P)nHg9^pXSra9~U!*cOdt+o>0$2>Xiyq^fbbzbvu$Te21F8
zHXQr)du-xwg};yQ=xCBt1W4iwAQYq`m7k2+v$c*fmUkfcEYm%{1$BMx*m72a;;S`i
zxN!uE>&<AmcM1U!Ay^e0inI(7x^mqyAhv}_n1saGcz?`vGW>(oaT6HR-@xZjAX3jh
zv!l^a^&TFTSNF9-PUV%f>h2teX9x$I*Kb6sFavib7I;}W7umwyNQzB_hO;q9TL6f{
zFOf06g@QAK$UPpJwnm_qKEX)Hh<LPmTc93nhqJc}VxwZf7o_7Su@#;c7}0=4B<xIp
zxhoqp8h=)TH1a^?zJZK&95S9JsdRhtc|#av*PEam7ohAr4C&QFuy?V??)U^cf8m>e
zEI}gT;^MK?(-q=NN=$E}AxiIuq$+S0V`iud{DdgH?~!Uhq<2eEccbG?fU3U@g`INP
zIerCUDqY;S0^+|-guSZ+4)wM}cu|UphnIuMynk{T^EecKr%A03+>a!nrT-Y@bTm>L
zRDG)hqUJ(4I@lvyl!f%nY~0Rc<7vJj#968IeMp1d*LFB~xejfEC*XA^gRVv3)194S
zW5&#&@J%KyL71fU!=5W@)KYn4*8!;Sb|Su92zM73x-A9p;`riHvJqaCnBbe$%du)@
z7=PTBxzaJ#LpgX7D%vx(IT)d5#3vaugTmjCRCv82N)Aj~A~Aeu4PHugaQ4Sitj|w{
zhl?w$7B7a|(q$OPwZLQXJS?%XfaWYM=;_aau)Q43z14WVe-Rq;^sud40?D<ewTzuX
z!97S?SAbOdKwPp2*sF;@D=iSU%?svMj(@OaTO(JTk0FUQp6^?L^yFR8*4BZMu^F6Q
ztnpZ83*=5iXYoRWb!H&#vf?))v7F1;DM}wLBJ+7b>H|Sk0XR@<2^45!SfGWaHpcJ^
zUISrz=IA1i1SG{pLf60)D}wydlVSuEYT$|56EWus;B_J$B|}Xk+jbpeXQ<$Mk$(mn
zP(xoFl|QOW%z+|pJSjFqo+t@Bl0+Dy0WXRcATBl<`iApyC2b)f)5C>m4WyR}5PeOC
z*z-lmyH!sEyt5edION<-q$vobHjpkl4;>@pD$vBwd1er%B;)2@Tl`*VjKp0#&=y1g
zdASaL$z#F6%mlpHjfm|zfGT<tY=5VpMCvMLtZz}t4JUP+SEMl*pDDOFSIim>85FZ|
zNAe{e=9!>puM<$Fhx=k9YzpxLi)9VZ&Hj+xZb!$!NwCkxgOoW(F~+|^&UGZUynfOa
zikWIIt`?a9`8s$}Fb~fQ41j%e@JytSm;g6;xckGw+zP&-T%3P!5wRDF@qbYj7j$Qu
zGPZv}>@=OIc?G1__qA?w0B-F!rXh3jI$s~piVeU?a=`ozJUFfQg{Air*oApwLsuRq
zb%fISb7YL=Jy7$^No{bMvC8AoeW@uO%@^QQdw?{DfHct!(J)eU-A1a#f8<O$MH<#k
zVY)wn#z?Kwa_jItQg$Uh!!tUGihGkDGebn_*H6@bU8F9ciPZ2SNOjP}u?9l^0`CxI
Uoryo=Z~y=R07*qoM6N<$g2bh{RR910

diff --git a/honeybee_grasshopper_core/json/HB_Dump_gbXML.json b/honeybee_grasshopper_core/json/HB_Dump_gbXML.json
index d7a2e94..acb4f84 100644
--- a/honeybee_grasshopper_core/json/HB_Dump_gbXML.json
+++ b/honeybee_grasshopper_core/json/HB_Dump_gbXML.json
@@ -1,5 +1,5 @@
 {
-  "version": "1.4.0", 
+  "version": "1.4.1", 
   "nickname": "DumpGBXML", 
   "outputs": [
     [
@@ -34,6 +34,13 @@
       "type": "string", 
       "default": null
     }, 
+    {
+      "access": "item", 
+      "name": "triangulate_", 
+      "description": "Boolean to note whether sub-faces (including Apertures and Doors)\nshould be triangulated if they have more than 4 sides (True) or\nwhether they should be left as they are (False). This triangulation\nis necessary when exporting directly to EnergyPlus since it cannot\naccept sub-faces with more than 4 vertices. However, it is not a\ngeneral requirement of gbXML or all of the simulation engines that\ngbXML can import to/from. (Default: False).", 
+      "type": "bool", 
+      "default": null
+    }, 
     {
       "access": "item", 
       "name": "full_geo_", 
@@ -50,7 +57,7 @@
     }
   ], 
   "subcategory": "3 :: Serialize", 
-  "code": "\nimport os\nimport json\n\ntry:  # import the core honeybee dependencies\n    from honeybee.model import Model\n    from honeybee.config import folders\nexcept ImportError as e:\n    raise ImportError('\\nFailed to import honeybee:\\n\\t{}'.format(e))\n\ntry:  # import the honeybee_energy dependencies\n    from honeybee_energy.run import to_gbxml_osw, run_osw, add_gbxml_space_boundaries\nexcept ImportError as e:\n    raise ImportError('\\nFailed to import honeybee_energy:\\n\\t{}'.format(e))\n\ntry:\n    from lbt_recipes.version import check_openstudio_version\nexcept ImportError as e:\n    raise ImportError('\\nFailed to import lbt_recipes:\\n\\t{}'.format(e))\n\ntry:  # import the core ladybug_{{cad}} dependencies\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\nif all_required_inputs(ghenv.Component) and _dump:\n    # check the presence of openstudio and check that the version is compatible\n    check_openstudio_version()\n\n    # check the input and set the component defaults\n    assert isinstance(_model, Model), \\\n        'Excpected Honeybee Model object. Got {}.'.format(type(_model))\n    name = _name_ if _name_ is not None else _model.identifier\n    lower_name = name.lower()\n    gbxml_file = name if lower_name.endswith('.xml') or lower_name.endswith('.gbxml') \\\n        else '{}.xml'.format(name)\n    folder = _folder_ if _folder_ is not None else folders.default_simulation_folder\n    gbxml = os.path.join(folder, gbxml_file)\n\n    # duplicate model to avoid mutating it as we edit it for energy simulation\n    _model = _model.duplicate()\n    # remove colinear vertices using the Model tolerance to avoid E+ tolerance issues\n    for room in _model.rooms:\n        room.remove_colinear_vertices_envelope(_model.tolerance)\n    # scale the model if the units are not meters\n    if _model.units != 'Meters':\n        _model.convert_to_units('Meters')\n\n    # write out the HBJSON and OpenStudio Workflow (OSW) that translates models to gbXML\n    out_directory = os.path.join(folders.default_simulation_folder, 'temp_translate')\n    if not os.path.isdir(out_directory):\n        os.makedirs(out_directory)\n    model_dict = _model.to_dict(included_prop=['energy'], triangulate_sub_faces=True)\n    _model.properties.energy.add_autocal_properties_to_dict(model_dict)\n    _model.properties.energy.simplify_window_constructions_in_dict(model_dict)\n    hb_file = os.path.join(out_directory, '{}.hbjson'.format(_model.identifier))\n    with open(hb_file, 'w') as fp:\n        json.dump(model_dict, fp)\n    osw = to_gbxml_osw(hb_file, gbxml, out_directory)\n\n    # run the measure to translate the model JSON to an openstudio measure\n    osm, idf = run_osw(osw, silent=True)\n    if idf is None:\n        raise Exception('Running OpenStudio CLI failed.')\n\n    # add in the space boundary geometry if the user has requested it\n    if full_geo_:\n        add_gbxml_space_boundaries(gbxml, _model)\n", 
+  "code": "\nimport os\nimport json\n\ntry:  # import the core honeybee dependencies\n    from honeybee.model import Model\n    from honeybee.config import folders\nexcept ImportError as e:\n    raise ImportError('\\nFailed to import honeybee:\\n\\t{}'.format(e))\n\ntry:  # import the honeybee_energy dependencies\n    from honeybee_energy.run import to_gbxml_osw, run_osw, add_gbxml_space_boundaries\nexcept ImportError as e:\n    raise ImportError('\\nFailed to import honeybee_energy:\\n\\t{}'.format(e))\n\ntry:\n    from lbt_recipes.version import check_openstudio_version\nexcept ImportError as e:\n    raise ImportError('\\nFailed to import lbt_recipes:\\n\\t{}'.format(e))\n\ntry:  # import the core ladybug_{{cad}} dependencies\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\nif all_required_inputs(ghenv.Component) and _dump:\n    # check the presence of openstudio and check that the version is compatible\n    check_openstudio_version()\n\n    # check the input and set the component defaults\n    assert isinstance(_model, Model), \\\n        'Excpected Honeybee Model object. Got {}.'.format(type(_model))\n    name = _name_ if _name_ is not None else _model.identifier\n    lower_name = name.lower()\n    gbxml_file = name if lower_name.endswith('.xml') or lower_name.endswith('.gbxml') \\\n        else '{}.xml'.format(name)\n    folder = _folder_ if _folder_ is not None else folders.default_simulation_folder\n    gbxml = os.path.join(folder, gbxml_file)\n\n    # duplicate model to avoid mutating it as we edit it for energy simulation\n    _model = _model.duplicate()\n    # remove colinear vertices using the Model tolerance to avoid E+ tolerance issues\n    for room in _model.rooms:\n        room.remove_colinear_vertices_envelope(_model.tolerance)\n    # scale the model if the units are not meters\n    if _model.units != 'Meters':\n        _model.convert_to_units('Meters')\n\n    # write out the HBJSON and OpenStudio Workflow (OSW) that translates models to gbXML\n    out_directory = os.path.join(folders.default_simulation_folder, 'temp_translate')\n    if not os.path.isdir(out_directory):\n        os.makedirs(out_directory)\n    triangulate_ = False if triangulate_ is None else triangulate_\n    model_dict = _model.to_dict(included_prop=['energy'], triangulate_sub_faces=triangulate_)\n    _model.properties.energy.add_autocal_properties_to_dict(model_dict)\n    _model.properties.energy.simplify_window_constructions_in_dict(model_dict)\n    hb_file = os.path.join(out_directory, '{}.hbjson'.format(_model.identifier))\n    with open(hb_file, 'w') as fp:\n        json.dump(model_dict, fp)\n    osw = to_gbxml_osw(hb_file, gbxml, out_directory)\n\n    # run the measure to translate the model JSON to an openstudio measure\n    osm, idf = run_osw(osw, silent=True)\n    if idf is None:\n        raise Exception('Running OpenStudio CLI failed.')\n\n    # add in the space boundary geometry if the user has requested it\n    if full_geo_:\n        add_gbxml_space_boundaries(gbxml, _model)\n", 
   "category": "Honeybee", 
   "name": "HB Dump gbXML", 
   "description": "Dump a Honyebee Model to a gbXML file.\n_\nThe gbXML format is a common open standard used to transfer energy model geometry\nand (some) energy simulation properties from one simulation environment to another.\n_\nThe forward translators within the OpenStudio SDK are used to export all Honeybee\nmodel geometry and properties.\n-"
diff --git a/honeybee_grasshopper_core/src/HB Dump gbXML.py b/honeybee_grasshopper_core/src/HB Dump gbXML.py
index 7e146b5..8e575af 100644
--- a/honeybee_grasshopper_core/src/HB Dump gbXML.py	
+++ b/honeybee_grasshopper_core/src/HB Dump gbXML.py	
@@ -24,6 +24,13 @@
             If unspecified, it will be derived from the model identifier.
         _folder_: An optional directory into which the honeybee objects will be
             written.  The default is set to the default simulation folder.
+        triangulate_: Boolean to note whether sub-faces (including Apertures and Doors)
+            should be triangulated if they have more than 4 sides (True) or
+            whether they should be left as they are (False). This triangulation
+            is necessary when exporting directly to EnergyPlus since it cannot
+            accept sub-faces with more than 4 vertices. However, it is not a
+            general requirement of gbXML or all of the simulation engines that
+            gbXML can import to/from. (Default: False).
         full_geo_: Boolean to note whether space boundaries and shell geometry should
             be included in the exported gbXML vs. just the minimal required
             non-manifold geometry. Setting to True to include the full geometry
@@ -40,7 +47,7 @@
 
 ghenv.Component.Name = 'HB Dump gbXML'
 ghenv.Component.NickName = 'DumpGBXML'
-ghenv.Component.Message = '1.4.0'
+ghenv.Component.Message = '1.4.1'
 ghenv.Component.Category = 'Honeybee'
 ghenv.Component.SubCategory = '3 :: Serialize'
 ghenv.Component.AdditionalHelpFromDocStrings = '4'
@@ -97,7 +104,8 @@
     out_directory = os.path.join(folders.default_simulation_folder, 'temp_translate')
     if not os.path.isdir(out_directory):
         os.makedirs(out_directory)
-    model_dict = _model.to_dict(included_prop=['energy'], triangulate_sub_faces=True)
+    triangulate_ = False if triangulate_ is None else triangulate_
+    model_dict = _model.to_dict(included_prop=['energy'], triangulate_sub_faces=triangulate_)
     _model.properties.energy.add_autocal_properties_to_dict(model_dict)
     _model.properties.energy.simplify_window_constructions_in_dict(model_dict)
     hb_file = os.path.join(out_directory, '{}.hbjson'.format(_model.identifier))
diff --git a/honeybee_grasshopper_core/user_objects/HB Dump gbXML.ghuser b/honeybee_grasshopper_core/user_objects/HB Dump gbXML.ghuser
index 32e48b830b0784346cbaee12120f702af4dd35ba..a9ac23382778c68b0936f82c85092e4eece3467b 100644
GIT binary patch
literal 7095
zcmV;o8%X3`Sp`rWU9-jAEkFoa7Wd%p?m<Hc4hw9MCA+x0ySpwHAh-t$4grF@L(pJB
zf<N-T`riNEyER?6y8Cp`nV!0JrfRTsVIZi6`A3k2)6?_9Liq26CT#`-Darl~VLrPx
zy695MKx$PudMEdt+<^~<jF}V28Ul6yw+2HI;sA0t2Z69<K`;v_*wG0Lariemj3n!9
z?+7phJcHap&me#r#1do&aDqI?tj+b+Q~_3CI}ishmI*GFjt%JF7zAo><^%x4o>3MM
zdwYlj0OAO80KlBg94yVCmH=lM$ntL!C#abN%nAerfE++jYj=SCKi#cC5POgl)EyV=
z84h5AJ$uamB4A*9XFIdM9088d=cZ66FbD>)f<o*8&(HC{(;x>IFcjio4{~t&hpz*~
z$p!@d57lRqu7A1w!{NCG0)+uw!A>?{2f#BBpz%yt+sWAy3;}4%ssPNOp#NbFa&v@0
zod9Nbc7T6}hl}-psRRBp{|~|EyRu`*J(t0pp`gFRMSdPG!Ly+#S^W33NuC{aGz5h3
zx9SSGSd@Q<kE^68tM$B-|22%~9KyP**q`SO5vHXejqqiRYX5HsYbiCU=l2|oeQ$>P
z>|;7AzK0<o;Pw19!~saDB?1C!mXfTLj-twFlDlf6HPt{am{(*om>5L}rI<?76e;)<
z##SS$vXJas!dQ2d9fCeY>HHn0&=l=B=A@JqC>E;Fv|E7#(N~55BrB#?&{;<MK*4bv
zx|>DVLKefFMecU$Pw%C*-KFbm(G!`+s?v$g$qaFq%h%kAvmDymiG(H)JS){qJu#m<
znGIrR;3rE8sujV&7MVf1T3CL^qoUjVN6T>T_(b-A#zvRd4^{_%@K-}0Vq9d0Du0WQ
z`esegdQ<x_?4nnuG(c--bUqH$N;#<W*Vf4rz>9zQu~k>FNwtwh2|T?dJ&vE!%^#$w
zklVkM*KbhhzEDK5^Kg;jj7FB=9MhLn#>&;hl1-=3m&yG(RrWgdO^7StcVo`<pv*zC
zvd$HMPqDp70;gAK>!S<R-KD49CM38s_GI2BK^sMJ6B|GR2PWr6wZQmdxKf@AS?0t$
zP;nn#%|rR|>E9jxaN5Gyp8N2_>4XFcC|%7WNCKt+I_<VvytTuQe}frbbC&iCeuoZT
zXLwWG=|7$;OK1FGrBJB3;_9YqytIZ!k^FArV>67(n1;&ExRbE#8_x1*UDpWE$P(L?
zmYJXM<Cr|)7a{=KDck>t3_8XJ{Ox5qN#^fyi&98axLI>x8w@Q)9$V!Ii;h4viHphY
z)pIkjQA8$+ujWDg`GxKKM+3~s@5u2tXxy`yitY#S;a@|$YG!f9@1(eBBqw~y6UswP
zPt0Ri&M=)GzX>3|50LHc>+9(mA>CBL`mQrU5PU78MJyP~#WRiKBfY(PtyuYb(v!}n
zdE$m4&m-@ZoDuiDkPoUEi_vlu(q^YxP<uHt-lemon`XdJXlkJ1LQ9l860~y)zKVXV
zK=eb{5r<ot5)=1x`wXV03L(|2qj>gVX%8!Yhuyl<`Ywdc3Y}YVc=xfb2-VkRzpH#=
z)7+svTf#q1)~WMhTs(u`iAuHv#Z33ryAec}I;+dx2*YhgVO0d*R{DY+R1oK>ObnIz
zdn2_hyy`rJ^eS-zm$=^v_scVds25~hsX{R2_bASk`o9CN1pw$`#)PQo{gv_LLiK2z
zzv~^Z2DmFY6@yD6Su0Z5{4)o*aef-C*SLwNEb2>o$Dlb~{FIv4^iSz9_`2Fju683l
zKbsi()%J5kRJPQZnBt<IpU#b>VJrE3d5lCk8$m-fE{s)SzP2Ksm7~ishcD;kL)gW(
z(U0lrfc$uhETf7u{g2q&W0LQNfI-e6z^~eSfduQak$GmU*SNq-cS%ZQsn5ucdEbec
zrhCIAk*WFRPqB@W%{+e217p$X`sAcPtf8<5+)rehV~~_>gim5~?P7I{$Hz>X&FnQA
z4a`%pwAf9`A|LEUYX6E|)Pm*d6Kg1ckK<JS7DGoE0`7|33=WHo4$0|8GF1A2qUh{M
zV}QF4LXtH}1YUV@okRF05l-0pMG+}ni8WFEr_m?ncJpCQhQSAagw}ArC0Q;n+eWTM
zM#VMTqAyzPNmTv##(7ih_=X3K(}mXD6F)B`2W4rWF}^v1;_!pcryixiUDipesPS#X
zELN^p*c3!{j*KTNqTdDNPmCG!4AHOqLgq=ng_M=?edWKC@n}QN4rJ^Weu=MjOw~vJ
zghnwJKm8j`(UZxFwWZm>4u`~MLvF)Mlye&WYP5$Zp4uE~d42yFA05W}Cj|QGv0JX!
zn5kQV&oEB85!2!hy;q$lJmH<<!9rET2P8+^PD0#?zC$E2QPv4`#vw#({?qmP)fXwN
zDrPT!2IH>Wq)k#N?~ccFr(8=8@i1O?@5s;O#2%}t?%8x8l*|&t=}~0m1Z1adCY)bZ
z>OD>H?2~{E1fusJ5i)4`hFL0lt`+rlFK`ZlGs~G5X%q}tornb&hYYxgELsDRfCj0=
zftMIJ*p;%NaL=Xm+rR3qB&RO>McOm~N6F!@SXzJ-oWYj=YB@X9MP=wsvuYR@%gTFa
z4?YxiGkeg#QjM!94fsc_|B+w}b+Co)|4t*I{pVBRuhw)DBOv@Tz;q*?SyWf~&`RD&
zhMlze14+sLr5>qrxzQwU>qN>3i&=(hLjI6yT2W-O@&Zb?G&YMNA!>UVHk2^9wyIV~
zjto^t)&=nfk@FG5ZQ?GQC(&{emE?A9_ssqAG>OjoX6(9sO<c&o$30?%JwuWrcx|Id
zuS{q4^hMmaj8fHpn#~DG@)inWCCh3YU1M3zPqIYu*2L_*GHLH)6hX>1F`y$7+Bkk-
zIF0>|=qT~x#n%cZXHz;&n_!65qCDa0F+j-Qbd<wDSl^$ls5%B3)2NRsZ5su=z1*MU
z3>gHf?Z_1bGg-cW8B0b~s2{&xSz*INs8<^V6dYEZpic@1VA2vu2BEUb!FO>O6TVwT
zScE%8<O`azYOvK#$O9w!wQw|O4B*iqHd$tNeWUL<4BVqAJy={Q8k(|SbqT0GwR@(f
zq#UqCm0Ad?Kr-udPaf!gqCe0NTgVb&P%W9vF{bR8+ruS45us8mp5kez?>@>$=IWpq
z_!1Hl9!R#^xcVt}=?S6Q5iaE6zND#sW5rCFo*g`af`)U@B~9>-+CoT#84yKC?jkZm
zP!VX3VGN)k9!kfEN6+&M>x#$0UnjtzR1q>8m}V!jEkXHW_zGhLlO2DpAdA&)kpn4_
zH_pjXGKts*OJ}&o1u0HjUEAS9*F932UIeTTOEm>({06@|bjPg%=?y)++0e9El0c1D
zg=8<3h)$uUxp<h0Ee#J`*D_s%cVU?=nbk%Sq-{Y6NBNo{i2a(;Tb2`fHSB0!Nu@un
z?~C6UYeAS+3>k`KHP<PJFb=o`Ck*e_uN^VmKl+tRvH`e|G*&-*KoK2~FGX-oft9g`
zYQ@C;HIRGKDucU^pniSPv_R1AjNDt+;F}*m;<gQ6iRJkBMN=_z0t)0wg64p5v?j#u
z5zLGm8C8$-pWA7GIBB({bQ1gdBR4E$MkaaE6q=d>Q}uP5gql2XkSX^cK{@k^ZYzWr
ztif!d>wN|KJYW>q)MV5IS}~$}W)LqM^i3G=7whhb0@3uOK$P_&!G75vg5pUk-92Lg
z?wERlP6%&4N-K~+f%;-2d~y0eQ6bLSjha@~3dWT3#h=w^?L|q85`j5)rUYw=fbZM{
zEp9m|^a#%KjSh5~@K+y%q=BSuuY(K_UcgJ@UXd%IA)Lb%D5H~P-kJs%W@vQ~Z4<pI
zL=NOET7TKd+>4IQ?WR>XNRwE|5YdHm1;VIEK=uo!eUXG*8M-SYo<~4wiF^!??h=q%
zs=>#$gIKl;OP8k}(Z$5Y!yvqo{F#VUcMioH2=Bvzda@hQDbfB-TKsadarHYx_@(OH
z^p*r#%kk@>Cqz~Bep4v%FX)~MC>D=H3K6+NK<2;bWN3f8yeg-~VnVbfc9Z81Uftm-
zLZDepBAn})j~nkchyl6_C7fRHkmxb92Gpv~qaFbT*=3TyY4O<Z(!JvCU+vWrEtE1N
z-b){rdP~`xP}JZ3-JXDHdjvt!G*8e@85dsk_Kp1PFKKd{nk-Crbk+gmYNHsapDVCO
zN|<ZnYmYpCT%rYyPjWT?L`=mwM~dkiDgG##umV~jK^Ea2aje%ot=&SVQX)~M7nU?y
z;di7idK<AA#T~&g02hiS16p;kMv|$HqbWN#K>3s4`htETO5+idzKm&tA+l8n$@b6n
zQVhEcC#d;5bc3!X6(?pkHzedgd(gM5iU3}UA(XM(v`=cphc*^9Fm{8qoaKvFI}%+s
zxA!J12u5oRDR4=q`n=QFnB)a}^Y{MxaKnY%Fd1dPJS$|Fow+v=d2x~%H&Z4pE|uXp
zB{l#HsUWNi0XM+}50UNUR?uHzL-Q3zKZycC{1*VCDWxU~jOJrOp0FRUH9XrY9F_+&
zW@MBGi>U9aRdUxxr8f$uD!s=X)C36zS#6rx5ir$j*ETrP;f|H2O@Hj?2Gf;N&oOXw
z?NWTQNUxFZql;E&8LHRO(cwW7b|v4IKBNW?k2qzOh83ZyXr`}Nnchs2BQe173Fx;!
zQPJZbGcD8>3{$PhnFo_M0=p50qFww3WO_H^UkqJD=?&}KNnWzVjz|QGu5mB3;5}}&
zcK2H+8W13(ld>#jd5Dtjvr!GnEPj%tb4mz|0y`GtBS$ZOCesQW7#a;ji?MQuK(<Fl
zkNH+(5Yb44AD>|GhEhv3)C=2eyprK-UrSh$BMh9PU>}AY0E$=Rpvj!7<sYViCo7oq
z7s1tqbb-GQ*xrEH5!T<Xb%pZ=w!We*O2)b;XU383Bd}PRFibSC3L2&a-7!S^zKX}=
z)9j<m##YQ<-hh+S&!tC^L=@e=PEH=v(2`3ITm)hfr7wf`mUmj}*U*$wc?NZUWa7oz
zfX)*RH>ZJWg|y3_PNu=4EEx5auh^#Z5*pIMs+eR<2wh%aNlD(VB*I^b_^IZ=1a*hk
z)m~r5ap{v}O4aqkyN!s4JxPFwnkjSsYWmK^`WX|-*ybeXENtC$!g)p^ByhzedN%uj
zMFqeoXSuE0HWG5K{EvEFxcY@Tx&@5PNJ{kJUb&TUce-h0mqwKL>9{QK6JVsHKLR%m
z#tx2q?cdVSLLASMC@aZ}+>M>&FibJ$gx@j^DHK*wJ7ajwDTThw`g_R)vFF=Wj37CG
zu`u-dEk7yG>?u{oO-MoMAvm1|2$pIHA%3+OaKTKNIO`O8krlnm7oB05^oEcVZIIWk
zVYWplpJkd@+J=B$U{tZc5C7ayPDUbNCt}nT9>m{dDw{;bxjlg3$0Z)6;I~PnSb#%<
zd+gGnwAB*1(MLe(Un_$1MVnWX<A#t<{Ua~FwT;+Vgw{I3$dM&i8u@^LK3%0Ie{B~n
zhiMI7($+e^L#pPOB5(DD<N{MOI|+gUvVnD-x#W)XH}Yu9^^6h=(LKrE)?K8Y0Z?9L
z@V#(f9brp?q%#sT*4wE?oa6U_zik9QTmw<o10~W&aEo{?%vHK$Xh>iMgk^!DQByc#
zE%gqi2KZ?fj@7kf`O*`lRg`_Y)|UO1oXT7V>HKz_!3Y@s-;UnekZMllTb7uzprs62
z=0zYCC(R^hQd39JP%Z|rMulm4f<p1sx0&W>1>gk1sphY{#|M)zbyv47zu|ee4&h`C
zCTEkqa}}-b#=!go4jw6(5MCHgszIG2ENh;XOxH`~<Srf3^srLaV=(J43Rd5rHhnp!
zK2bQs@s8IQ3irQI(ML4XF@G!SGYM=ahc%r$G-gz3G;p^<J9N>}_L)})C(^ukr}jKf
zo_u8&wPF>Q;L_)oEo?1Sas;l(Vb}&`I=?o=-ez$472~TBzR^L|Zu8Rl?1y7;#_Ip#
zyBlgjzM<yZs50u|Ak#Q(p`bt^-bG?G$lYh1x^w8{jK5Kw^h`R%t(V(L(Bu8X`cq;N
zrohJNKtfVBT&ptY<ppH&#RK=oAbDT8j(uaHL{)3X=96Zb*9+@|L@b^VpN>3UTmPcN
zoH<4uj9kTAhK6#FX|5yOli4JR2G`uVoQ~VCSNj`E*{RX0RQlFO8QcOag%+2l#rO@J
zCsC`bb;lFTt0N6-Y`K4CQqkWnw`@2UXiw~2bNhDYwKyM}d{A!kIU5N-se*j;v^}ha
zFYNcFa(G=X8=GD9$8&`aDR>;FSaTZ8g0`}Y9(g=xdc8|?M%Y%pzqSqC9bPUqM!zPf
z6`egv9P_+(RixlDUtvvt7~yQ{XszS+KCS(2lH7jf=ruNzO1y}d<7@qK>~f;RWNyx<
zeNi0pXgjqwejvjBaSZ`DPbPNJh29jE`;^nzVLq2SvXs6^*5Q7Y9(3IqK2JTDKU)5-
zLnO}AVSrVnXNE!u|1~+cg{h_6S#ZyI|BA47{hdK(-Bt{WNo#VAc;`VdJ$OLed=g)+
zGsE@I9?sV6aLa<Wo^hK`A<WI?G4z*}yX)KuhWkioqekB%t+(q_`RGF5Lx%_t!^z&n
zfj+jx(L(IQw1y6&`ttJo2bHm_l1-6z0ebh<HD@sGXY{*E{UryN&<vOEan9kEhvl!$
zpU(Q1%*3^kE-qi(;U8~`+#i&g?G(`5+HEv{zy5NRyO&n`IA1(G==IRo`Yy8EIDKsH
z;{Io!5w>>)a!;|3lkMlLg>`l7ew)MFaZ#V*5Dsd=4fE41FwCmBvuW&l@+!ff^f27`
zq17$Xh{aYRr=WbXoQLSCz0+=^AOEgH>FRr!m#i<n+tQ%e$~eg!-un{whj8!^eJ1h&
zqsI(nK?q_Ppdn||w{x%nF~MJ<suqC1IQz3@AA)ylx;lSfU>z{ilcTi9wQQ?a^2prN
z1imQgZ3*s_ub}$<Eu`9Uw(T^=$kV-h>_I|q{ClUPhsuCU=X^V-#H(Zd8V;|8qx*_K
zYDSm4FMb&|Tkkgn9bsl_=w9uSd0OM2U1joxt~T>Bd|e^V7r}El;XiPi{gAY;qtsNr
ze0XqtSDRw2=6-RW(je00%VN;8+1|0|s~L7_4Ba^oP=6TpnSzP@Ky354FT9Sf=~?w^
z5x29*>{U7pV9bduUD9{$qUKYB)nBqUz`n3A?fibY+xi@;P?BYEx1cgp-Zlft&2@Dg
z63Jz}!H=M-hnVfg4O2k8U5dBf#E4GkALuBbHTcjPe8`Es*}m$O89q30QT<a^%5k+%
zp=%VlY4T`i9a;@Ie3a2nxu13ZDUeGoD*m&turq|?SI*Ma60Vn8pR(|*%~0EH@s*;&
zW)bmkvR=2fG{@UW8Yz#TxAm8ta*G|}wM{=OG(GD_UUc>{#E8S|$ex<*PijK14r7w~
zD$aINIE}Pt#oSLfGOXnvNE%PJ`f{lwDZlm08&;`)oo1;yZSr>~Mv|`Rk7q4@+B#dA
zn=br-`?CE`y4Nt5x^0Rm)&V>Gssm=)G0JH9ZRovku8041JDCYjq09a`<z4^5%ma2+
zpLL^FmHuK|Ysas5V&janq8)VGGsi8F)*<689((KCKc@3s%(^=gT~<Grul#UW?b9B@
zzQ@B&7l+AIC5=1CWj!3PG`07$XK1e`i%cB84fFNUH{Y{`mD@77)aN|XbUb}uyutI)
zwF8|Xf<?qJn#PPD?}}?Gn{tf2p<fr;&g<%pBwW>w(g>=r936uGXywu#>Sbjc6E{iR
zzAXWp1od*p@OKJs<<krt{CrxhTe^{h=<A{Gvim;H;l($0y%euwzV!L6?V0Wjq13n%
zv=U0x?-Z>4oqiJj8f_-#i&q5RV$SoiB&@4rka*dl)OLFF+Uudwo<e8#Q1MpbL(gXH
znvhV=nRmNU(}Tv$s3G~q&?qTq{g{N@-0Qnh+gUTSg_|Glg;gZJ);`C71nl&NZ>Ba=
z7*m~aGVc$9hnl`Q2+Nz;^Ev5``=VvP%;hfl!1-y>|AQ#suA%hm<v7nT_ej0DTp_{z
z?9$V58I8wE^K-vhZFDM~*GGw*Ua42dj7JL<&C?tTwL`cXYOB9G&k3%#B#6&dJQ$9m
zGB2g~?;RerFJ5$xK0rsNAivgx4@Yc8c={6C^zP`Nezv>6()HdqdJs&);?{;;yrzrI
zB?_vOXUIh-%>`-<u6VX8X8y22!09mJFMF49vYr+FK2Ro5WZrhk@?5EysD3y|tHTzy
zWS6j23CD%vFOIcwC*XU0Jg9g%O&$CGAsb&edkXOjW4XT)QqqJR(22o@=z$@|*k`Cz
zy;~-JPh>(|SI(<6lr6nLYen^Hv`|Gq>kqY5oj0|*Znk07yWM!I@Fh+$=D4xCdrgPF
zH*f^CuVtjdh>r#;duar?LEUwHO(m}m8yP&W$|AO8R5{sUW1cG(t9R7DE04KOV6pCN
zRzCybNL?}<y^)=~$7F2Qx8aP~SNCaxzoudt?w*qFifsM0Yc-48XN*4}U%dPhWK~`m
zh_C2pCQ67KL~F3fKZF(yqEXOPlE0|SP`Oc?iHTiXi|tS|*u7f~aS%BWu+)o<F!nlL
zxq^q*+$ho8(Xzr~c84VfTbu1o{M`FCTTsFDOF6AwSllThr8pUcBtWuipfy~ytAAcF
z)#@O78Etn?l;6}14AnK7Kcl~&mht^DNZdU*KuepORiV`$KixH`fL8K(Rlo3^P5+?}
zpZ3lSQD>pV56G_CN1=lDY_ZjcfqZR+&WDH39i$~MZ73veY^6sg|M(h>AWM6S)$A%8
zA1{(RqgS0!>fAHddz}}yfz$QNr)#etKDtjLugbYq-=V9qxb2LW;FY;PWr#kc9?>k}
z?{!?ht?v9iVNFZgX8owFOx=0><%?m74z&DE_dG?9-7$a5pYv1wU|)1fbH&;E3todw
zt^VBRunBnP*Tiefiw&9=7b*eroW}FEZpopUqHwRH`9WP#>!-ux^G?b&+H&!Zc%Bh6
zx0@z-PT`}fs-f>(TC?Uphxqj&2WzHls>G+E9e>Wo`aw_%dS}-pQmP*HX~D1<M+xu#
zE0{5#oRzPmi1kCn`yLhHr(b;dCm4=mDE7-v%_Wb@K3qOiMpJ`UMJ9h%t4wfOPd-Sf
zeYRP_Q#;&3pWWNNH`H>6l^+L%MtGfRtVK`L;y)$pz@Q^WGPC^c%XuxgOcL(})XLU3
ziXjSo;U{Ohy67Wl*MsRsTQBB!;yDCFPwi31)|!=5j!pRj-p#OS`Brn`Cwr11nL6^?
zeIIcBHd8@_R^{16;QHj+nGtkwupgKEajUGi%=PL)(C#XEA*VRZ7a439F?srgswX(Y
h7fI^&+ZO>_+u8j8|INeW0SF5Nv_Vj?nH|^z^j{Nw1nmF-

literal 6790
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