From f9b77b8d58aa8f7df0d05b0b12cec592eabb7b75 Mon Sep 17 00:00:00 2001
From: Karn Kaul <karnkaul@gmail.com>
Date: Fri, 28 Mar 2025 17:41:41 -0700
Subject: [PATCH 01/11] VMA

---
 ext/CMakeLists.txt         |  24 ++++++++++++++
 ext/src.zip                | Bin 4304736 -> 4494751 bytes
 ext/vk_mem_alloc.cpp       |   3 ++
 guide/src/SUMMARY.md       |   5 +++
 guide/src/memory/README.md |   5 +++
 guide/src/memory/vma.md    |  65 +++++++++++++++++++++++++++++++++++++
 src/app.cpp                |   4 +++
 src/app.hpp                |   5 ++-
 src/vma.cpp                |  29 +++++++++++++++++
 src/vma.hpp                |  16 +++++++++
 10 files changed, 155 insertions(+), 1 deletion(-)
 create mode 100644 ext/vk_mem_alloc.cpp
 create mode 100644 guide/src/memory/README.md
 create mode 100644 guide/src/memory/vma.md
 create mode 100644 src/vma.cpp
 create mode 100644 src/vma.hpp

diff --git a/ext/CMakeLists.txt b/ext/CMakeLists.txt
index 94c6e10..a4204b1 100644
--- a/ext/CMakeLists.txt
+++ b/ext/CMakeLists.txt
@@ -27,6 +27,10 @@ target_compile_definitions(glm PUBLIC
 message(STATUS "[Vulkan-Headers]")
 add_subdirectory(src/Vulkan-Headers)
 
+# add VulkanMemoryAllocator to build tree
+message(STATUS "[VulkanMemoryAllocator]")
+add_subdirectory(src/VulkanMemoryAllocator)
+
 # setup Dear ImGui library
 message(STATUS "[Dear ImGui]")
 add_library(imgui)
@@ -55,6 +59,25 @@ target_sources(imgui PRIVATE
   src/imgui/backends/imgui_impl_vulkan.h
 )
 
+# setup vma library (source file with VMA interface)
+message(STATUS "[vma]")
+add_library(vma)
+add_library(vma::vma ALIAS vma)
+target_link_libraries(vma PUBLIC
+  Vulkan::Headers
+  GPUOpen::VulkanMemoryAllocator
+)
+target_compile_definitions(vma PUBLIC
+  VMA_STATIC_VULKAN_FUNCTIONS=0
+  VMA_DYNAMIC_VULKAN_FUNCTIONS=1
+)
+target_sources(vma PRIVATE
+  vk_mem_alloc.cpp
+)
+
+# ignore compiler warnings
+target_compile_options(vma PRIVATE -w)
+
 # declare ext library target
 add_library(${PROJECT_NAME} INTERFACE)
 add_library(learn-vk::ext ALIAS ${PROJECT_NAME})
@@ -63,6 +86,7 @@ add_library(learn-vk::ext ALIAS ${PROJECT_NAME})
 target_link_libraries(${PROJECT_NAME} INTERFACE
   glm::glm
   imgui::imgui
+  vma::vma
 )
 
 # setup preprocessor defines
diff --git a/ext/src.zip b/ext/src.zip
index 032ad24b364fffb0fd72184530ffa3b60b94010d..a308392e08b43e1f84676794f736c1f78f0ea70b 100644
GIT binary patch
delta 191634
zcmaHxLwKGIw60^@wr$(C(O8Y`yulYYX>6NK(%5$6G`4LvI{z7*!P$d7TZ8qC*ShZe
z+1ZMK$gfU<2nK<JAV82HC=fIV1_TR&1Hpq3K!_kD5Hbh_gbG3fp@T3$m>?_=HV6lV
z3&I28g9t!`AR-Vkhy+9mA_I|wC_t1TDiAe@21E;@1JQ#RK#U+J5HpAc#0p{qv4c23
zoFFa`H;4zs3*rOug9Jc=AR&-2NCYI>BxdD>4he+?1_lNPMim!e@ZSIikzRL;hYcuO
zIXb)fiaR(sTbOw`yRkxosVV-yRpO`sgZH%vhI$+@FmpaIFv|a8?rs*WI-U;pW={Vz
zsUa;cr7X?jXjyA`?zZ2O^jTNlr&2Y&#!127k}SWss1@%pPGS=fYb7|IsW6TOFCXQD
zC=Mv-OkY7>x?jXzE+gMqPbTMV)@orSLe0kY1Z@WQqCHzRJz%<$?{jTOiDQ+9n3VX|
z@!mbkU{$KglOMO6jD5Fti1=q+p@4~AX?Jx@*t+ch;g<np#grV{OVks@9DnCgTPl|<
zM}4Oj;1{w}Cm35a_E2~{)yOerxtF1xx(EbeoViqPwlm-yE^1fWEU_srGWx_)#CI7t
zaHdC7MM$zwF6bdGj3R&I?^u!2fU;A%u)9zU(2z$<Equ_Kg!kg!Wp0l(@owqe-YiAV
zs}`d%m|tR<b~0v9(+Cg{6(li^mvy?;d+%8A+rb}26wREZ%UvKM33@kk@f8s06#zW<
zZ<cePFjd>87wVA^5?|fR?vwtIX}S6ZdPCa@W9G-k`MHbgjBkwp@!N_?cl`lD+>1km
zDa@dag@8PqN+9JgEc;%Pgf<a2|9PqT<}S&k_AB3tv0dJs=EP<KvU%H5&2|RqsmDlK
zTqKZjzqD@tgXy+liAv9>p$;(<r~`EGpQXP|Y^LirGx`OcjK)7LGw3ml{*>$_Z_KwA
z%zg9@?^Bu9)(~lVVh{R_n&2M0VM2cy%s1EM<~hyCNJO>k^P=wDDvaCtvNap%eERvt
zjPe+K+m9e4oL;2XK-K%FRHZl-s~)k`lO9<(LDK-c0kw6wm&4LeQ#42Mrwx#Dkp30B
zc^TyNp&<UX_IvMd{^col%V&77pb{nivmfpZ1*!z3D#N{4Os*Y&_IQp-72f$(3|YE0
zS=XjO;yi^`V<y5x1)AWF2xR$q&RDs6)G3_TssywF(ytj0(tbz!;TzMoR@y!e$Logx
z-9I;misqsakUc7xfpRSFIy=DavqlL0ZY&+MlmO;}mNdr<1wxTH!9>qX?P9oo=F$ol
z;+~jHR5EvQAbV<v$$WKaM%mvb70@mEwM*d<B5g81U$mKb(u!w)|E0uH5-q5(s5?xO
z6EUZ+u-~AsL0@QtHPS8I#roi1U-AzJbirnj=?&vr2HSTjcpmo4C}`kgXZIK%{$B_`
z1CAS|`P!<M`3!Zp!ZAjjySYOK<3%&cjX%8^d10burj?zFmZO`#oajPVMWDI^N2M{l
zmK5G?_FkTz{7|_OV#c;Yc+%tdo;#N<mtBHdQ|A>v*e^8<i$|Sdt*K*ECcTvLBwB5J
zl!L(9ze3_v(}<s-sUd(X^IHP^tFI$ak8QF5#u#+M8*yeD(C}5U$AKe{uPR<q$Oa9o
zn6-~f5$q_z)C^(7@qszk1r_q`+AD<HvFNY?5#I^|oMfHmlHy1bV+UzOjOCF@@%&fg
zVjlZuFnLs*R<$ORYy`Ety<H=RnLYXWmiw^$qpgoMi5RC|NhLtDK0V%+p_bKOY39fL
z5nWkF?)Nk@P*J!zRGnB&eD(xFi*IB9hLyBn)eaT*5X@HfU3$?U)OSb;V>hKZuOg5Q
zSBm16dg~>K;w(A9ba%XVc`3SX;z&Up_$VL4am*);5gw6eFgDG(?I)?R^t%tW_EXFj
z!gmdlNT}6Nq!m~*R)F6h)d{0!UTHhPWKmdSX;7ni=cLUL?~_U9L?aDk4;!^#!46<~
ziVfaZ^5%Orp;&fQ+(oud89Zff%uG*or4tPmMGG~bpxN^ya-?^mIY6%p#z4)3PyUfs
zJ3Zu`wU_z&VG~MImO@>qWE*{M3Zaf}7?olNQ9S7UG657sdvTs~5hVag>IWd46!T@3
zQGy>ngp4*Z1TIuN*i~Z~7?Jc+tuRpG&2ResTO;cV{Fn$~0-Yl=)#I|F(-fF5$^j8b
z5`7t&Ogxdz^YqN}G2AqK%BAY8IPr-UVrka9(5#d&;CslOovdS9l<^R3t?_YDYtB0d
z$}U_IynsLRLGkJ-$~ZpbqZzG!1Zn3`(iYg<fgMCF@~XW%9N$_SHdeERvd7^e<S7)~
z2T>o9YYq)3H><lQaug=CS$XDPOubwTQni7>z>DR!os75xrp!{*I2OK>H9k_Za573_
zN@$NkBLvL}jU&z0kIv$)6vwC}Lnb@2`*Fr9QGh^8JyrO@p~)#~!V+Z#QYiqrU7-!P
zh9A;G|JO>;2brp8_A2sTt=zKZEn8RzSCta#olRj(CTRs64U%#FQ6Yz07sCOko)}M(
zFF1DUETKb^4@%TmgM7gSud6Kg$8pRl-EZM!jVK5o<(RQQbr#cwFCp_@mt{<ePd)UY
zEC6K3j9Fu-oMEJR^kz9%{)5&I0ta_Q?lPfV+!80%Z@1DioDYi!d=MKoBhY~sl`NfI
z>8XE(I+6n+m3m9^1^oIQ{#Jn9+$>*nOa-A0<8}3Fp^%`ZxU?R{LL$O9T)N<nD!9w^
zHJCQ$VC#3UlTN=uBhe$7Ki@E1wLsOIDNqd}hFHz8`QTTk#M^0zD}8t1l0XM-bhA4(
zP;R!za^2W!&|6^42ZvM9;5O{#fp(gh2*ASs$wQniI<=(wX(4BokAcUo9MC|TuCh&<
zf^(Lio#3;;TfHF{k-(4KB1THhmUnRKJxOPzRX|nI&J)o04FuJ6^<9*&{bo0v0RqoE
zuJYav7p@P2$1<e6BKNsnU~6I>>gNfSio`%X%HZ+iDQuSmjBW&fwuHI#-#_;c_9L_5
zVHl>@lC3S4VlDR;SR8@|zm~9Ys-w0W=4sXYE)&QgbMPE5y?b4JVK@>t(^-RFtDIXG
z!5_UrV=8cHm%OfcoTOQvGNRiC!0%+c=z-sSSl%6&Iv@!b!&ipAxPdSDi|iVb6#lnX
z@gNw<S%P1D+2jydQ(YqK$Z3#4<aAPIROn(H3@u~Lp~<yHA;<=ziI~m~<`@T1R_Nr?
zRFnw%sCe$|9c>-2Rvdhyy#gc~@ic>TAFH>v9C#?sGW)j&Cl_gH?1$>I0KeXZ<vFvd
z|CFZ~MIzNeZIR>-6|Z;&9wfGi)=yOCu~Ec^KPw-r*ZFHm;u9>oFkrY^tcxw1E^KXh
zI!P7gmnD#0wX;=SS`D2#<NYG(u5J-o-N~aBIFv0}AS5Hmp0!s-87}Oo6_K3|W@P1?
z{j6d`RM*X8R>vy`L<<H)Ach2K4>Fd$B0a1oJmy2qNEts?SzUix&aH6Bol1Fs0tw?Y
zMS}45Xfy@Q@DY#SbbD_<sM^S$%qP4%KhWaI61@#=S4g3}Bu2z)vBmSr*S<Dg3kSbY
zMR9`41*~zg5YILjCdaV$AE{0yf=Mh=PZ}!u7%U;5-4P_4UA%KT0QZJUL!d}H*J2i5
z@y^!Mfn|no(_9b$p@+1Cai7`=FP*AfbCb}leBUR5jZx+x`xCAxkRnz@UhnYlKX|+a
z>o<3X%fhkd6nIE~L@abUM2i;ge5oWdr?T%zZ5ka?LZ5>KvZ<f#wFU`cKIQuG9s)xT
z{-wa?>fL-NK5_&uK>59OX&|4FUW?kn5p6LPo06~rbBB{+OWbAVj1w|G7_}ly@hJ;!
zKY@nXNVm&MgVjcZ(^nEXjv)!>SnHr5rX7Ld{NCmOX+!)w?=XQmn+I(!|3>T_wtv$w
z2V+Z#f({!u#(U*n%BUbaGb@3A-5tb$^I$M%7Q_jIFF2+jASTxGY6m9XdA>)RJ@K2K
z=>ZxtRcX8rD@$v=FauPt^zNn1sOILc3^`=Wa6Q72#ozMZ8H(TTs-#3wT1%5bWXL5m
z#cO0_S%7hm<R})A!azIY@dQURkbubp1;sxq8QIrPU=JbrGr`~BBZ1u)lj;1;eIV9+
z>N)TU{n>g9Xs5!}%;NI4w%YvoW^4S4H}+?bOaaf%%-YO(8B9>ErAqn-G4Zpn$>I|{
zo*4oBIYOKordp0CBXZW$5ppfxgnPm;%3#z~H-XIr^1^t%?T*a%f_YeSUj*%3g2XuZ
zx({Ua8o|^Jv+7KTziT5zE&07SFqFLo!TVridddZDKqiHNE_3ZHPGtvM=2o8EO6oN~
z4jDKZLMh8|f&{gd!I{cq1d_hBL*8EpgJe}GBS@onx$>reWbp1oD?M#DVb!j^#>@sP
z+=jbjDG%LS=nUZnn?v6pPi~TlH5*gZe@8M(7@Jwplw4Qgjd*)mLvgQD!8;P1E{z1k
zYJP7H1Nf&y6Ptvs5V_k3b;aEge^{I_DlC*%l1GmZe!Je?B_I3!4f>6s#>VD$=6Nq4
z1Uu5o>pj})&09Qv$+}!TKDRkOeq!zRgASp|!^_u=`t!c?8|M@?QbhZ8&%d)B<KwWz
zMSp_@7B^m!oOqh&;_UUgnZJTyEVraHBO6;tEWqdkAJO)F!nI$w3|oSkJuHz$6>@O%
zzjm`7bG3ev#(z6kPcb@8d-W18zZ8qG7kkcY&9@V{IK2#*qk6dwM<kWIKh?SqQsES(
z)O8Lzw-Yt|y7TEye$%VN)qF?0a?hl3SO})2Y+M?+oU}2PU4S`zcm$tf)bazXRy^}6
z$N|=w7QWXm-B)|{nAOCOp%TC1Mdj#Wat}MPRI*Rf{=!yRQqHdKCh$CU#Ow;>nXR%~
z4a&bv9L#JA$uy|BC?=ifex5sNt6T2;E)lurg(IeYR=$rokW=n$Q=2RoTIiHD)7_;+
z$90G3oK6srPMauEdlCiuSgPv?4u3d7!U0%T;MI@F!iN-xqRm7wZEO}1*#euy53*l9
zIIJ?jZ}hXQ5g1gy@2!1LUR*Rbz~42a6h2btv)F~0A;m|Bvl){CJiNU`a(=+#E*}@)
zzEw|tuOECTuxr4UFh81Y+WXb~y_t@Wgz>wJsa1tIr9b?-bfHnKmTt5(tF|=@CK=Ey
zlQ^ZQCRXthRcSqlQjy_R@mNPPRcs?l0MlFHspNl^c_XhfAZr&h_ypP9OG}5H79a<0
z?<Y3JGk3U16xQ(J5?lsj`1@jME#P3jw)RJ@-9-1sGFNI^jUQyux24)75OQ-<_qXiq
z+)LS_QQdS}oAN#DhyBgfDciPnMmPWh8*|S|V>@c)6<R|i-0(*mA^k7s=_~Zu>PfK3
zNY)(6#vPRkY)Ld_b&wKfwo+VwEu6t^nuY)+v{3Ckg@eh($`Sbp_lewCak7fBPs$Rh
zaYvds3S{{0t{|y6+qiZD^KthU>yq3~o_xx`!pmL)$rYBes*&*JJBr$K)FU7XE?2>X
z?rgZMabTal6M18OMe{e&n)n>!(Sa~}_`0Y`#IM4e60#=30@&s3GP@A-(HSC6Bo+&i
z8;f%SWvk)MI_p-}joE^I(brHqyl%+Y)$k@g2-TRR%{ajlF|S7)u+sN7r>^82dW=FW
zdLATocj$-IqpVJLsx5{sH6DNixj(^PRIf#qz0tEk680&;Akt$ba)&LXw=A8Dy~zhw
z4v*d;fe-@=LwkV6St>zM5_hr>v0Z4KFU7{FLdEU|Cc^;6s{awwDnVDq#o}pHcd;ct
zMfv1BTq4z>zumfk-XnT%pxI{Rao!NEd<E$2-Ig6H-dWH2*V?hyJP0IlEZOxq;7--C
zj69Dn`<wK54$}Gkh0Px2^-gcK!7aw!Qhs`Itj!*S<td1-im72j(u=gkJ0h!hW2+$`
z@sOHy)gMyB$w$`Xc6#hmjr+UesM+lnmQWj)n-EM0z0MiH`^&oFSIC>9W9YzVs|oP&
zbQuD>M2tz6^KWCD-3sW&<ilq4!|nWf-Au1zz_he)6Q>^SuU;;W`FcE89lSI<{ql*v
zc(kYC9pPDmS}+vm&L*jNfqE^DqEI-0TJ!7nDnFu@maegc`P7>g#u<<{4BUGzBJn+t
zHOu_!#3{Fwu(7e(9NzcnD6{~KH*b=*wsf7h1Mh2j52M#IEr7h@l)IgrLWZVRp4rj2
zyd-_?i3~+u?74kp3JDzw=&Rn3f9Im*ZC_Jc{er9&*8E)OCWX(9VSB80nKQ-7bBHwR
zKM5uvp!Hqp;>SiyU(_g^oO{n;B&RWd)<ipXg<BW7&(>HWT4F*!=uqdR!;zMM6Ew2@
zBfDuxJNVOsAPZPJY~cwrQr|?tf;{lX<HPOzRT$uRcaQv{`bYohm~O`Ar!VJx!V|Q2
zJzo;L#{=h8cxERo8o}oFiIIUh*5Xn06+M9t%(#NIA-~V<8ICG@O@f7exdz=VlTt{L
z!Fi4q<6lhd*Mnk1_?ZO{5_xCqQ9OlJ^Wthuv~4Zg19brD66t_E$+O$3A#htvXI=CN
zBM<$VKG~(#i2-G}=dA@pv0*$ahfGO25CwC<N_-V`y@FRY1#>3I%c3NfKECl!=0Mbm
zC@Ta!@1r-2;X4W&S8+uCJ2EtaWYGkhDx2(&yc*F#Majl<^m4lloEaJKp=faHve!%e
z=sSFi;!fa$T=CR&Wot|4Ft_@(NKf%!-Alj8D^u~mwSnnZRneThYcEKdrcXx_b{eiG
zW`U*0#7bt4Y908~q%@~FQ3BNbh2F0=&q?vD!E5?rruTqT=_%0PdA3=<Vfh~~Q70K4
zB1A%H=Q-15_q7~tD$5+bz347cwM3Q=fvJM2xPCyo5v~f`7Mqw<z7J}2kDI}d#xjNF
zQ!R6Wr*%Gj*3>V4UWvj(Lz~(T$v5u8_`bmnlVldBLyI}wa*W$%vR+<C)}E#E&QA+I
zGQ0>3^PbK3lYvMk1kbz1$Pg6N4FVy8$X|nFHbf7f`>lrK;IT}Pyw^ejyjl@P!Qw63
zS&~4J#HtR@UP;Ya1cTNG<Xx~*Mh1100ZQF37L*nY!Zd>M!$JOo{Z-e9ie?I#y#OLF
zmXm5eG+Ekmb4wPQ=0#sWU)iwlNup^LIZv(gMrBd1pYzo)_@RuV>J>%My_jz>@7na^
zd-dsKt7fuLo^|e`bSaKoCM9U8ScCs~c6ERV7+&1?min=+-n`kz-}2VWS*Eq}f9#dB
zvZIH1*D;Qqxi7NM_iw!#?r~XXARLF059;yPx1K^0q8xr~yihr8-I{jZ{|!1EUEaTa
zeAHox4ZxiK5PJBnbk1Z?XQy~dAaR(q$BG_cLH}72N<F`91HqHjo_`{mcE&q{#A5*<
zL$X<BU+WFK63p9a5cB$VtKxdZn`bXR?FoPB2Q!GIEYw1ACur2ad_F&WU<Cl)pRO*i
z2XOCa)_1$k9$c@Vcu-T1Xd-2fCcKA&!C8pp{&l4_s8SUq+@k;tFGpHh65%Bd-$LBk
z$IJ)zm`N~A*T@15>}0KHbTRS$*$GhJ+DlAQOMSg?Va~|OnEIaP(}RD42U`(rpq3>n
zSou>@aFYA4sfkwELU&4ab<|C|ApzNYSEU(IZROUV+lcOaUD--6_62xkRj9LovEQ{_
z?|W}wE8nE%QfRKV<+s6BaOPwnM@OA=y9HKEoUd464CRlKe(hDrvaZ*dXCDK<cq<%|
z83LUPIq2BQM6pEWL|sR|K1{$;!jqzcf33XwH}73>!fj88R8xCewv=x+8_dEx9%PEE
zI59>L_8figEism<xC6VRVD;9iwMJ^1r44haJ>L}060({N)&0x_Vy^~%n1We%#<9Me
zjh`<E8q8nVoPQozl-;Omoe2Ykm)#WU^PjF$v6B*Ds;}=q&}7t0)HcS6sz1q>{Z1u0
znJ41h;BW<Cr(LB0Jas$TC)zTU>=PG%*JQ~33cf9$&4!4%+ncUKtobF6#Zh0cverf(
z8_p<D<qV)^_7fV^ePUvKP(6dVj!Y_|z2VsM@f=fI+feZx+6~i1@C8^^8zxey<7|SI
z|MqSuyacma!5Cj<ucck*e68<Op-+M#PeuR_t$pC#d4X8BFZKob|KoAv?(C^MTrjXw
z889%K{}qo*%89GUN-L?#{zu50jSRgB<dcG)>wt>Hnbn44u-aH*r}LaZv0%%Vc3bfA
zecup_RI%n5hBB6chq`T63XbaE1!8Bbo9-RV)pt1f`1rTO)E`^z-;H=!a!}Kc)AP@d
z(;x3=NVmJ~Yd2gflg_=b&!%g?G=1X<1)P#9_&ncdGrMaxb!s-WxWmY@I_<D#a-?yl
zH33nCIWv;shOF}bY5lgKok&HSPL0C*4CtARW9eb|$4=V-xA&oO45hE#kMbE45gto^
z8}#A$-YqFt1&jM=8`c?bhHjHf4B!gJ@o{fP+oZPG$D34^aQ3MB!0qV$t|h)VkZ=n0
zYt^Ec-|-8N>uq!C;kNME(4DP25U+`56WBEsa$mX<ijUI3?obUu^LL#dLRm<S$!#VL
z-GP2d305UZB#~wPUOT{L$3<|x)onwQ&zUUxmzCvQ_t?~J;XYtZcdsNdEIOwTh}rZx
z=DP0u<LlA)UA~1}g-w$Sw!dA*^UYb)!M-Y}i~(iSwBtxwwKd4c^K^DOf!`#Z8Q}Hr
zHml~xk1wlLFXunKS(z54$(<`$&3+R6*gYA2@b`A{<nKOJaTy5dthwC{>l~Q5=DO!~
z5Ks$;TFgLX$smNDfd9L6TjVQq;qpp!%;*gXLHtZVL8eO2{;)ue_fO@8Uo@e|1KMs-
zXER*En=gh+lZgX203ncfgC89=5SU1lMF~Avvc40#)2da{Lq@FOC0pHe_^x7qDZ)sb
zIr>Rc%YRNs?mHrXD$m~U7iOl4<}%y#xR83kHxiUWy>S4G=3cgU^+`S_;gX2h|9brI
z5EriB61qP|yI@0#Uoo90k!Zbt?J;HFirqMd`_h*<{FK492wDfpRhPqH1JGn;h~nWI
zing4w$ITvX8GL2f9#2+$j{n8zs;RSXDGp}-8NS^>w08CWVEDA?(^wPw0~h-rLr%33
z0fsv6oHZ>4XLQrN*m_MGFAgbfqDKxkM-Okhj&M(QFgEY1dEuTSr*>s+r&l@x1G#a#
zDa@n$(P9YSiG<$CB&&!g1#sIpr6KwuW#I01U~4=D#_M7&ZHOuwwrieP(G+Unt{qeB
zIVdfaLSvURwZNp)7G>|<YdjW*EdY8N5HZ+qMx*wQY;qH6ld1AZgf0@1+^Dyu9Gcwh
zQ>Sj@*6scFH|JS5Un=a>eUM4@>OFJZu3Gwn<=#-7%h<#jXBV088Q7Q?=1y$-#}ndE
z7`=ic^&<J9b^oIhWQl?5v^bCYTn61sRE|%Deu+l)=gJvYQ=l(3OZ58jFx8n`_q5=r
zhJMj4_*2zo+0{kK?~+OI;i$<%k#2R_r|ixC5>8tbgIv|{?^IhsA9uI4v4NlWv4Jei
zPp5lD1~%W%l_@Ui=Yc4XR#$G^PmWmWfR(bs*09o1LR+?v@B<n*jAqw4b-T%xcHg$_
zrwDJ(yoz^6KS83$Y_hY#H^nWXDZ2G#&WY)f{b^f{OV6y{+t*#pk8Uo>o->O0B^9|M
zl9l4AzN+TBo&f5?&&PXmXpX2qYX!o2dqgA2bCQZOfl2${r2+j67zX(*Q_(Rem;Joc
z7ZZXgg8nkHdza_~t)ZLR!raquQ(KCS6RDC((DVYq44F#P+QY7vNasxOy!F_p<}lV}
zXyLv)BSrVgwzW(YebKRsQ~cd5`bgraDjn;6C<9W_8t!3MSQec2Y4%0Nat7@y?r>fJ
zVLa`EPUB<k0+6@rzG%v2sxIsF+ZQ5N@OY~{^(&|{?&VsYWu%FD{qwsi9kO>e5=>EU
zE$`2u`IU=15eM@b?u>3r%(v&C*B6D~^zE?x`Mbqx(wvlJ_oHg{=z(?xdHZQjvjA`y
zclav)Ihx1iPtpzY$`ASIiB@-~7I*F5|NaJQ9Z3!B1fZG`0e3Q3Q$*i5%LNniHYuZj
z@6~-98L2OLH#!F!jjaaC5?hRXOS+KZXi{%wrDvalrgC=V`PSi*hK=5aKYr!c`)iD8
z1EIsF@c>2g9)PZ}tS^JEMaC0mCI4x=M0bPq?#$Qfv4sxKQXy{CL-2wSdqPWKN<~je
z$c+BG8%UpoxgE-6t0IqP-;&CxCD-o4#^1Yj(#*qjGZ_mAqCIb4osV5~@spsNO%$b#
zl^0xrmj;V;Qz>ABRlh%GmMV5SLdKd_mhuJ90Y}WYeS6v+`bWwPC+(8CR61G8N(?uY
z2vIeA+03%YZ3t0o#%%=P@m>oo91U99E*^>x0uMop?Uz3aWJx<~r>i$l1hQ4u#QIq|
zaAH{f8~>jD7+r8Z?j;onlgFJNd{)Pev#j0Xa$6*7iu`DOE?>G{fRBia9=b9WI^|jy
z>e)q-AKM5PV`j`5ycD-njttvEUCCL5J=m1FZ5;FlGm31(xSpCz`>8|)8j6-8P;qJ+
z0pf<+xfNjB>TFKLR%to@l|?jU_vL1v%iu!tHthaLU6YK&7Aq%!cr4VbGQ8UD&^*6w
zuy~i7)e8NUTCZ&CMf*@iST!<xCp+p&>FQh}l=`ALPul*jiAyvm<V)C_WWTk}N1Eo0
z69b?3CO$}|u-W%-ZKsYmvlXg<wN3mU0Z92O+lb@JCT?y*S34XpeG9~bhTXnLPp!p!
zJQ=k+g5d>wni-WPJ=KQW%e*o(0>MofGE%R+DnnToHo%J^8o|m5R89=sj+b)pF4P;y
zvD(NZG?JakaRpQysqF{z&HfP3*mb>-eok6o2;gteZC|i<mUC`FCd88M)Ic<$0xmyC
zVp<HJ3gIpta&1a^+GcM8*whdF0e7BuK{7TR0nw3V@Fs!j?g4kg^*loF>N%OQ2_iqo
z8{r3~R?zg%lln;Z)6Jt2en;eM01e|3<qB$XumWu}FSKg3sYu;G%;9t3_=S)Q{Rf}%
zPlsek`IaueI0}O@{Cs!)3@3|Q;1-HY8>$1TO9TgQ-P_QLdOwYtA2VE5UOWHXKK_rV
z<c34W{TpAFh0>pLWn_%1MiIm@w7|~8S&*ts!k`y~j>-a(y-?^ycLKPGmA^7AynZe;
z+jUwO?d!1JfiON+B7?cA|L*kP#|BO3kdkZ_`<3fH`w(<NyQ2#C-d95#Kp-a|tbPUZ
zE_)u*7gjt)WQW5prHH&RsKXP(>R#JdiF{C<={|-`Qn>C`*9iA1)<ZYzpH|%nIqta7
zK=5be$<-!3jRxK+pL90*3<y!4!YSoB`lko1^ZUaMrF^A+4q+5q%ro?-5bRyq;Hu`4
zFIne}&)G^$nNaWH^Pt%bK(sX_+4%t(>BkH8`AQQU0Y(lR1<#)|lK-~#cA+Lzz;UyG
z6)6Rd5u5sOu8z(%SoXp4YqY|58CETsgtnBO^f{0(lx)jOasF+ESeYdF=`-%}z}y)>
zN3&kV)lwZo+ZRoxC4-QQSGO0IKsc_ckX7P?20=>pv;J1D^hlfrV78jLavn|hXkFLS
z_GZUPmP)_b`a>aY+jLlAsVxJ>574a}H9U8Djwcq;J^!+V^zgB9^dI%#lDM)BrgKc?
zZL2|p5d;h05}C0(ZzfPR#c%#F>`9Cx3_@O1U4pe2W%8Ou3SNVoA&za#EE%>!28?ol
z{FImTVyHJmn4vENDt-{t8D3;BQy6&NyBNN3FIaa9Q<#Wf?Idywer04(jl<w@({MeE
z{I#ukVz`nu?zj<ca#)9{H`R=;^{b`q;C2>K@NV4ZQOc4%*o&y#8Z{g*$LA_HkkljC
zP;JcR7)2qU$#cu=!@fNEksK9E1v>G+^V1WGX*Sfr$6BrhMm4}&#nbexr-Bch;9zH;
zW1y&8+3%P16aM8K&>Ij<pn(0<tIh#)wJgl;c5*jqQh38ek$2h?bddc^T{)3PbcFPT
znO>(<5SUs;G=7UUUZck4P~{-KPzr~v9uG~sUa?jDjv;oKRAl~eo5tajy!G;AQF?FM
z>EvsPfbu&Q2ty<NmF*@64K}Rrl2Cb6VOdP)2CW*}umzFDr|PerlLJ{qoz6%A^7h2-
zG?RfN;EmSlGf7v#a)-OwJ3VQ`rcRsXKzVi&gHc?^Mj-WoT{_-_G6+P`IGfZ@-}YxS
zk*EBKUPq`~_&xV5hN|-=<8;|wtWlktDyeR><`HiTJiQ3*1=maCdy%xQ^}0*8*<_h{
z!0zaP6yvaAP`kg~m!*$}zzo6zlfd$&EuPZ)=53(+{68J;9oxunHf)z$IGC7mU)&@p
zM68C+MDlj4uAOdDJpu&I;giH0h<Tvl0wOnI^w3DTGA^dMRdiy+I&CR4{v$c{mDswJ
zF3~UGVQ%O}X>ZBcMPz-Io|ne^&vZY;=;g4Auk?QOByCa>`1FZ9?VmX18OOH6HDfN8
z?@z~o6~gy?&uqP5S`@W|kTJ<cHM?9^x=-grm2c{AtU|xqZ%L`a1UUzL4NFNf{-*dW
zdeEhP7+oa({+Gy7$+jdqN~bBfq!tV*`p}dLG*;o${hkJ2BYulcNc2pZxX41_gJ96p
zTA!!<vrkzx%Zghk=HyYcRljt!*mE{LC~Fl~CaQTsAe7;L##3ly_+DfS8$Htu>-8rV
zf+&8EOhg_d*xU!tUBPX7`@*f;U{>J~TdOmae!1q?{ZQ}LjY2zNB%9qpmJc#;BF}CD
z1guLcdZFz$dv#2X$+K#Kp#r-XML*E*s#oAy7L0Aosd=bJeWcC;i23PEy-ulA^e(Sm
z#tMcm5Al37!!<NiN-#fm)_5i$P&>04YYZZt!<?svm<qel>_~t2WmOFJxu1WAP>OOI
z?qwhmB@Vr~l6ny-XWMzm5S~u0_?OH8lYhcT<Q_lz<>h-W8w9VCrX7ilvqQJKk3>7W
zNh1VP@~aChyk^h2EbF>bmrKL=-Doa%gX7I-TjKL8;k2^q;ar;|lK8$=8c7zNN}obD
zjK&W1mZ8i^jzTxYxfoUJhL_|x*|>pR(+OtM$&ZnbaD}MH{%GaRdPfi+x%XfLTkw!s
z!_&Wx$<81Z=BW*K|L|Ox_6P14VDOL6!Znc_by%SJFqv5s7c@c4yq7A0veiJjSeTpU
z5aO`kECySqn!0#qrAU2OlCXy>=uH3q61J}*(33Va7jhDwQG&XLe!~w3=P_R<A0i?>
zP>T!kR^Ea9{r56?QKdr|A#v{~pyF<sLi>5oVWp7RGOJf~aHOx4hi3i6JlmoBav0;I
zhCu8v`vWvp=DcP)rk@#=fE~`f+;BT&)FXXr2H)ft1mQ%}@%nLG=le3sGZ<KPP!$hz
zuv8KSv8WWIy+a}^Q_##29dvJ`vnBLXK7#09Yw}}`<2Pxn#L<XaCG){{KpgSUF$Lo1
z-g|IK0)9aP<GKVrINQIFR89HQgt#R;;8I~)D)Lj?&mCvQeM3kWi8xW6=-H0eZdKCp
zkyjnIN&JqPeprXN9#d;HZGORyWHLg)2wdDgR(VJ&&Bh*jxX{8s<(8{JJE(lo<`u>l
zOMxnt>JZC`MMO=eJqjBa&@vpTRXieeDQ|EPlTAYSkd}BVs_esej#QL9tV-DGL(Lb@
z&x^N5gj!~pSylCtQthqw&9b#9(5AqD`LS>e1^i%3z|=nO^2<Y?$BpSqDmmy@=MViY
z^2fO0{WwAmwneEv>@t3C78j5Gwoz$C8KR%7i#v$P4m-IU_7OJ@FtM+ZX^J+(%dufs
z$}G>urQnE~Mif*i_)lZ>_j;5Xsu_cl-yo5V#}XTnMa(_LBTq!8m033U+vE*83XNfm
zul;Ws+mUc}WsM@bIi|lPd(A|l<5ok!?gEG-TO4V-J3Nvb>j`;Pm^ig|b&wWyivKD%
zg$t%Zznz;HTItsTN3E==Kdyqr$*eN(iOec1G5t6@VQPpVh5Iq_o1E)sOH;kg;xg20
z{31~8$6Fx>-{|*!|LurT8KGE7HbI`yC;8#Qq3<p0&f1ARLudU^{R?A@rMBRiek*b_
z3BH#{;iSc}b$7*};ZfTxOWiK;or-g;@HpMvX&H}%xvD4xXkY4CN@deJY}Lt#l+b?k
z>;Fk(9GyqX5#K=Q^DVb$m%nm|a;B4?bW4Lx{cb*nrSa$AOkJ~;erEdrs(IN8b4$za
z66K6#KVcc3AKXa5s@X+Xlt{Mp2L#k{X0SE&JM?IN*A@SO>U-!eI*9yerkEWsf<vRG
z<FIDZ)R#b}2MW;&I)1?jAGV!~H-pFHVzGGF*|a(dM9No*W-kiNeYF@~)fJYIW)m%~
z-#P1Kd^~d7^_8pxr5R_b0fy9Y+=ZjG&2A>|bW3z2F5L;3g0pa=09WYf!^(x{`tLr+
z#`W{2@$%(syZMYk8a(Trs5w);5UYc(G=Hxe3#g$?fF|feQY8<oE^?yJea7TG<EOg{
zhec(Yq}3PkZ`J10HY_fZ3<aYkQFsNBd>CruVl+nwm)b$9l<8{cLV><uCT-FC`E>|~
zcVI88l@cGZZ?P%O+CJ~+Vu&5Z09Z~e(M}FfYcd-~lYEpW9pm&!3+7HgS-RCbF_{iP
zqUiSmx@JW~5Ym4tHM~+<wJ|@#WTKe{?HOZ)RJGknVASOcHeTc=26Hv(Q%tPrz8CSp
zvw_v$pY!$sBS%gKxW*`cM>AM4(|J@>a=qxSa#aTtQJua^f-1xMkBy9kXhe97w~fy=
zf7NU6U4U(TV)-V5oQa9Bb1@7*J*=2(`Jic_-;hEB&kg-lt<)A&pK3(I7~+^}AGKio
z+I68cAyP9wZFx=UeveGy>%JR}ubQmCk2vaqDSHrqS!-dB%Q-TOR2hFX&YBuXXn$Qp
zPT!V+Dc2H&SX}Sq)=Lf7iA&Y->kkR>O!ArXG#j9(x(&LCFU+}TXwJBI55U1+V~Yof
zmw(%8ODL8V|HRbF3ywwKW~>Bb9IHH0HwRf>-E|@}n-{5(B$O^H9bc;z>e#ku)I62!
zG}%2JZV@f*aQYX^CPiINmn={ai4X{HER^!!*u9i$A}-hvp3A*3;zD6DJL~-tJki+o
ze9k96&x_}mKZ&eo+BqkU$%nsN2ulJgRUa^U`-ZVjgs5{_6?Md+?B{~qJ(h_xaDRJt
zR9|%Ykc4CHmDafvY3L%4$78}%#k8PqXr$%}5&9HSs0wmc#c}AcKqN!RQUwn+EdN1m
z>)^$Aw{<@XAk#f5h!9i*=4Olxcs!0{G;%)+52eRm#T8p?g<0TPV)17mXp?~8Mpc{S
z^3%Fp&LygYcDc%&@}RuG1q}`7ky5FmB6{XlJUyh2%-`cNT%TfxOU#Yu#?9(Nq$uL^
zP5(9yQOtFjFpME`+WyWL;R*c+{Bt4>PphinTAZL7%5YeCT1+JzB8`8SqL9I~G#}4M
ztfwi1{4r2&bB6vC@y2Wz85Ik_e$Gd6iJLACWCHosZm7jVB#wY<2%tz9U!dJ#CCOFu
z_gY|TY&&qcQP_Rc(y$P3dN@9ka{||U#MI~emsNW4=XMhPj#VKX9cns_{ao1B+-Ujs
z-1ReNHDmm|3kv)ji*NL9PVx0op^sDOn^Q-}loGXbQ|a<QC?wB0ZkA<0wR)q+EH_6g
z(ggUICTa3EoDE4{uJGs@vrP%hcl-Ou$aqPfd|dJ}4ccCjwwlu!@%Tat<Moe<ib35k
zDq99SL0+((m_Q6O+tj2`M{j;qYrCaPA&klu8_tKlvFA^$`qpZEA?le`58JVb`ka%k
zDzbuno1gqtkrbPWsE2NV6B$3FuuNmai!b<U-5IXQ={DJHYB)@UBHKsbBwvNrFeue*
z)O!zOI5B-{3g?M(iSZW-W=P@AOV$+vm*0gXAUDuHk9<g1n@weY$k++uv;IC!`cvc_
zFKwDZH2Zt`as^hLUPX3}Ug)Kj!B0old6i)7YmT5A={ML9snb>97bmtGHT%n4VGi%d
zIV@g{?oyrUl1tQ7Z=>rE`=-AQ;RO7nN_0dk?E8Pl3}ERqyANJzDi3D4zW;WWASU~E
z`rX}_z;8qFgm;&u$-T9&tmwgq>SzA#h5<jJhz_=#0jz~?(>Pn>{Rj2)f2NfvxHD)Y
zQc_}~A*#@e4$3tRNG<F(9j1iH#B~VYjrc34jly3n90#@uPVGA5i)FNlcwh6lr}*(6
zt3{RxTit~7e~WYO%imXjhB%^mE)k$Ob$X*xijdoE>^`I0<h;kdtd`wxne?$S(d9Wp
z5%&&sFGfk)Omd|$V&RmF>7uDst*-+xCAS!e)jC}V+XvZz0B`m`|BukEvn>v(jlRop
z<3)wa+biIIwD9#Y)#-R6z`)8sz`-c~SIr>h?Bi=~=U{c%ZSTFVlSKC~w-;jc%$=!}
zUZEw~V=uljD~&FjSY9hOB{}Do3m1@+pfJZU1ylRYQGM;)`?!G$7BHqW&-v_ED}@1n
zA*+44_V_DzhwsA&Af74O(LY}`JFlNxfrnY(Lp^DfPx;yCgLNp*9v3Ra5X09VB06u1
z1wAR01y$_-?|V{w`aK=}0EJ32S?^4&EefTw=}k5ryw~;BmBF1X<CN1==sCcJIAEGs
z+AFnR^mipBa=lSsO^P&@tc!)>-7ASjwm!-(Lp5wOH@6!sjawyIC{GGsiFkn2J%<Y}
z89t~rBi!OeNX4}NoGF}j-riud;DaU#(T^&22YqEIhTi>ULZv-uq!VuohHr>h9$~u$
z&JF#_fn?8;^%gSYRojJdIt@_2A$=&uZ!)O;0@bO2K{WEQ-qF-BXAMf3VSpNQObJ<V
z)Hy=v)7vPBPiGh-{2~GJc++osPUs`SVbEZdsCRZ9Im#|_A=7jWR}^C7b(2lO*WTNr
z@LQs*7A`r1vaF}A)j}L&kPd?_xMn!$Z19(Clb!*MfAF@Y7`<KDO95C@PBvZiezw1(
z-vqQ8zSv(-gZ7|$UT3!54g8plal~=RiNMMpR8lrZ#OOft>uj--1+7A0LqxgZq^4tU
z&?uwVQlFZiG7<6!7O(4e7Z;*iq8XQ=sEACkt@<!B9et#)`zlp`3gDcB3yNF=h!I(%
zl3Zhsqi!Y2@l^(W2mtF{ym$?i@`Sv5oakeWL~)Q`?zHu(aqRRTst%NNPJu$*u;dTt
z&`vv{yuEx6G948-$oX4h=^OBcanGDXmz&XjtF(SW^n0)^$=Ehxb0nDY-G?}Hy=}*O
z#Nz%=Hi9o<gORojC^@t|e9l%1g2@4@W6!40Ads_Cta)Ou5Wpvf;+@Qt*hzeF>gfs#
z@-N^d%0Ryv+E2o<%Nrfr^e}0^Lk)+{_b{bIO42EI-FQ1aPQJ3US>YEwBle!zhI+Wh
z7M)FaW@YgQu8EK%jxQTg$WaO_eq6Fl(KH#qQ2q0)1RMAnq6;=QPu-9^C!EN8w;gzd
zHD#I!wtCzj2y`IbsA1Sp1aA%ZhOb)woMS+O<+IipT7HJmHG6=98F74E3igEfUW63g
zIqZ=Ra)$!n&!I<9C&A@3coKp(&GHVF_JPzZodn~vb0OY@rteB*KR1NjY4jI10<%I5
zdfKku8Sgy2fV??rw9T`A_VF&+ua|42{Z9qwc3&A`02hhn=i2a#Q2uc_{;2%QIGZE<
zPNMqLvg#v*v?MeE{s@E}HlZ^k3okmp>6@*nGCpiQD0f(7-iWY?KZ&;x^aYZ$^~KMw
z(v}^(*2$b|+)p*@SUYnu*YvWan)p}7nRf^ZScvFy=DZvE)NjoSWw*QUGWBk<5JU7q
z(4=)9K!|OeL;<Q4&8`OA8BI?(^6(rn1e(m7C;m@SvdnOCK8fjgNTxJ=q8hpDKy21f
z(jwb_EE`=Aqz%h}ue%6b(Bir@sla9TsV|smiw~+`b}28t1gXf7<c#2tM9g>_MLw;u
zZ%GWBoUl2Or2DUKBud3E*59FU2{gbGN~F;O0V3Jpo4TF>N^IbVwbE5MXP>c92(|9E
zZ;%gNogRxE#veZ89W&kq>_5)nC5XXiR4~!-QSV#eSpBA$1s$^8_kLovU_T+s;bi5$
zyceRrf&}>lxzPr3O`W~vr)YE>!148`Xlw&ZmB}dlbi-n+`)}I(;Z+}503DnvS-sW}
z0P|vA`v)l6mh|w{L0`&WtYbJO0r{t)b?aGI6`pVUur&Cd>ufiSIS1vwDYz??ImsN<
zu=IVBuTqN=Q?v|pkBwDjCt9Bl2;X(-iW`Y1_Sf!OPWU)%PuXdU$E>3@nut1htlMxe
zac(nkg7ns1Jz0zr^wkQvViLb|!GTT+7<;Wj`s|%?2dwM*gmQ$$ezq@+Mq+eoN!Z|k
zmxLZdkiOpCtk;<}1@Nye9~NT$Mtry<dU8di>c-t^PW_AVYnSd0dh(d9AaR%0g*Ge=
zvW<}(AsibG*4fuGMfvi*wjeo}Y>X)BX7GK+>~(n(Kl#>EN+5F80#7M@Z1czkSfAIQ
zS+L@X_vxY8M^SxAdSFhfnTSmqOxlM&C5uxLHum#&jXy?#CMIH-u-*3AhSUYw6Jw#I
z%FEI0XBT2O(e4(}?K=3Z`7ZNA8}aeN_l)V{IQGd-pH)9~!47E^!TAs8JtsKD`@{r%
z5d9HLQOY!@fpR7?hn#8-)uhS+cF@A#kkqoVd~Yu7ar>1i(0mv=%kM*fLe@>_p_;B%
zbV*%%;^92S!$DcXqj#Q1{=Kh=Z!_c*8$6ABslLc1lh>7*N)&5AI+$UL1}uWAj*CyD
zMucqmIuWnkwLH`{LjA$(XgkqKv7)9M`5F*?@QHXnsJoGR?EalZs2cnNJ`+N^;3W~Z
zG8VQ|&<`mqmFOiR<><Hhkjeu6*4|uwJW-fF+9cf!kw>ycBH`6vgWuR!ou7Yp7*jb^
zclHr7WuCB0@^i_yrNoo7+h^`~EgNy?VbH^o?n3bM<#nA{z#-UUA&Gi@LlO<TNBVr5
z-|u)>)P_hugh~v2JjRU#OoG~XE&qlL@as=Qd#{NA?tg<8^u2rgA6*)y_?c8dQu@bt
ztZazMbKT$^KWtgJuFE2PQ_M!-@6Cyzte0H%lA(-S;1UHnmT{!Ot|4@+aUy2h)RfQC
zYRO#SzQJ6cGkv0k{$4^_(}z>Q`vg&sn$079v)OgN{Q($HJE;`|s##-P0~9&C<+7Ry
z-|olWe~XR{$p4vV4#+62xAwbgwH0!N8Fkrldv9mDnL)8NxZy==LtK$;djQu^?}0S|
z_Ye<fnzwd=aC0WQ_*M`_LUXezpL4@TThTf&!;8-0@RBJ#2Wzyw&X+kfwR6dl$PK$`
z39+X=-8;B<n%)};#3rQI^<Eakt9+4Z!u_C`L<;`xu9ag7FB*&yM|q>_7YkT1DozoW
zo4GR13Wm$3kxRZHDJ#=|1?5?L&mn&>WFvdo-QWC^7AR&m38w1l(%&mGE1C3Q**9Ww
z-!c-Nkhx-glYPcl!`y2YRdgOieaEDO3({v3F)jHdHtOO7`b{$f3rv2ASepF^!}Jft
zm4(i|w0&$(GB(5?%OP@iq#t2cq%b!3SrRY(?z3@9>S!rP0Ru~E+E%bCGZuYYp&w3-
z%Sdeu`_O%(VfkjOThGC@dD7N@%k<}dB6@Rb-&Y9o35N02--mFZ)!%joO(fzAw!Sbk
zHva7U3S06oz)5EZ!bFg*{lW;0)7xXrb0=64pSj?HB4j8M`fg9HAb8;Ukpq9>IG)-T
z1Dm|hY_GcT`_YhgoR|i}mRE@8w_MWacuT~<P$N%GIP1veM&{7DL$mQHD*C%;imc5+
z>25K4%2u5{?fQq{0|Qd1v?GBy*BkzEW^%egGm`5tU;w>8vrYW9<TuN#s*J6@SZw&&
zH@3Xrfd@n8G9PjqILNuD9JB)z_gb^!<OI}KX|`h(5!*a-TP|@Clvq{z5t-8D@?Bh6
zbd9Oh+{hI!T5T@0wk@rbX!yimmikrnv|vsl>|&a=nBEH>IHwv1G|8SI_=-Ls-ssYL
z><2AAz-ftf0^dyZ2yyF7A;z=Cc<=pbez(=@tAwZ8MZd(SJ#JT^Q<v~=Xs!CR{lP%X
zxhW0%*`GC$#|KWJW2!F*EbBvAt1W+reUzE^FH$n)0%ycpnE<35o;Evfa8yxkC{B39
zaviJSbqAeoyT>zwkA}fi@=hS7-s82rZ|S-S5Z9^q#sua*)!OmsIit7!m=%eocb@0k
z6wa+0Zr`i46d3z(sL&$X0$f49;Wu@b=kA;Jx=Z;mHfqp_ncGlzuia|Qnl(zK9scwk
z>cYedgPL&@Z-ET<%lb20uRRFx#uWbbgw;Vx-SnJM?L5vkdwzF3{w)|hny~KFg+Kca
zP`cUX^eM;>%)cf4f-d@NU`W_V@sKn}*+*sDX%`=9FxnO?7YFf)9jY*;I^oT{s2rlt
ztj<26zRM2Ocfcr}Mr_DiqKe6tcQNd7o3X&sCmBLqx{rO16*ZHTJoYh!Jsg}pc=*hb
zbZu%NyVb3pQwR06Ft*FAF7**jB{Gcx(d1rU?=A=%Br9%l3RLe&O0{5&E!OBTN4v1<
z`F3(y7MVl6ER?G7Yc9rV&x~I==Nt(C!X~eVZw`KY%cw4`9-e-JPlWU~24*0Z1bNU}
z9$gK1QilHXP@hAl8-;{+DWP~LM`diy9CL&}zznrUJN@fpd{L}UI>m8FZ`<z)AW9WI
zJB0c|Q!>+pC0Wf7M4mWVaZk_9|F+WT;lh`<y&!MX+h(&sAr{LM*G0<z&16Y3WeO!g
zh|l^i&Fc$pyUlFKHud*9qfv;`+QBg+`x3!wfQ}GnLaGp?Dao~YU#v<)G~gP-pc(o;
zs&Incf^`<oier&*;D#P};zGXx<TOSgsx_0#jG|_WX=*fBwI#g|P#LC*Y=|EcXzj+l
z{s$kt4k=}mDAsI#hM|jI2|JhnN}?a4V}`H#q9bNbpjBCniVNkep`yIiT5i}z{$;Zp
z_fsH@KsvX+|8sro&{Pq})@kU~O$b{h6}pr1jwoRilRbE1HqT1CosTXMuy9t|n)}0D
z0dX=<r<#Xj`OA>W^uaW3AaA9FD^`^3C3OE=e$x>RG%3;b;1SOT>=jNfQ2MrWed+DE
z=&+_6wuLZUJ@OtOBL$-?S-8hSh%#5&+6g6*$A2^=Z*al>5ku3SkNYeogF&BMH@`bE
z!f8;)8*vk52Y0cXPR+avK$1jdQ!~_k(LF^=^EV#$JFy!d4PcIWp_osN4l|LAO5gC}
zJl*Pdb*+%<x7K$*7Sus_5}%l~&ddxGb_s7thVslI8EmR)3cd_{jZQ4l%|mj;IL(Ga
z0k!=j$>_FH>Q5ywPi$L~1<qtDZeqI=oEL9<xjs7m$W+FmD+o!z=je`mMP?<A>J!X&
zm@@<AF)I!ksaKH0w{5vWPbejESx>6>AZmC~P_QtXjxTJFua~F5Nz#z7hb#NV6LDkQ
zjS%h;eY87|2VyS!L1}(5tYyAw;KQ-#{U+Kpl9Ftr$2<8-oS{16vp4|$fQs^od)FTp
z1__xiECS`3ZKVR#@ZQPAiFUb%2IN>X=~K_;V%me!O{!v<S^t_)w9B6%DVXzEgz-qo
zia}tIPsodTEuW>AxS)JPp8XF&@0Ktb$b+m3z!e1u<TdW;ln(9=To}MCBj!+^=#tja
zP|4-gPLVr91`b3r!q|FuZ)(Nb=7-Mx@Arm<ZIygRMi_vtJ!6sR`(dUo8+wdZ<+4Db
zFCx=Sr4*sOBL-?X>OOCe<QSfzd1$4I*|rzon-*^osHI@tuUA6VX11^;6gx|9ZmL2L
z$$E^+^@}2ND(azQnjNs#(ud1YX9qQPhW`UuK&HQ|FR3U-879S!o?FG%U_Z-5CpTKJ
zs=>K|h`S9EtC0q(fA6ss5Q$~qS`#;I$6Ke%JN)hRI~VOsv?z%M^`iZzP8O?S*NZHj
zEXOFp!f7S>`6gnA8QLFt>2;z*jYKW`R8<4za@5POjox%X((M7sVi+$QxFNKF`(l$2
zR=Z1&kq+9ghyCvV?bK=yawj=HZjRce__ZP&8Q&ROYI9}`f4qnyRih$>%-}U^-$tJy
zpgz1YI4${apH=*~&%UlWaKD5tn)UntUIkxz=IHXyOjMNJ8@i`*)ziW;-KgfQQqXn<
zjjf=a@O$K`CbR)x!Pr~G*(+LSgJY@HpBhdke4L+P*miV%4a(%JzX9%pJ_f3F=!5*_
zKmYkewNUm2e<Qnwl`kZeOt0AYb`%Pn{G0uI&xRy=t5zM324~APW3;R#hBsNbn6gQD
z$`*56x3^9Z)hentGD=+Mdt`f}P%=@d>KO{y_=*Esj^J}RPk6m?=!~_hlgLP3*1cBn
zvncmC{6GI$9h}dP4(|*e>hNM!3xmb<K1b`f`2wSme`LTki$PiqXAO=BZUsLgAHeM;
z5e3@MVi4Nk-Ty*C;9vN^=K7uD%cvfQ91O*-c6@%0Cxh=!VhW=W*!qkD{NL|2`9$H4
z(PhCw=gBn)TLlH7sj=SB>HGhptK|K^G<pW^UrsFuC%3UsKl`{%{AKVrdI`q+8|{Sk
zbIERye}(S8*OA}<YYz>m-FDyC?2L}v7p~E}7<A9zWDdnIdD6Qa9#v(K%!FK0CPU75
z-;u-|QQ%TCyDxd^i7gw=SbXpru{S3V8;C-f_CRnrYT*$ixgWju<EY62sKRPl*EMQC
zF$rbLlNbmcW6xMZQ;Pu`c#TO`9!}>NQZQ)-e^D{sz?$o!V_5SlAfgVkEeugz3TWFR
z5(!8@51@@5AuWs#(l`g=a2B}c!m^+dzl6wNK;!74M|aS#OE@2FjU1;7ePfoUA1v%Y
z1)v0}H2_6`!+(Rz_W8B|g-v3FJ&K16$%g>ZBS;x(+by|k-Ap6z-X5QByCr<~5%z<_
ze>@OBw93t!>7RCwI@|814~#Lg+j#`ef#0Au{)vP>2U(F~CNWjVJVWX@-me@If$Awv
ze3PZiMgA$Y&OkD-)D7p+4DV<$nrFE+zfQ=lLN_a4TA%|(Np4(F>RO2l_5$Qc8xlh;
z5|x_S*{38Tg+B|c{}>sMXU0rnF~Z?}f0WL$54Yz$B;N&F=XHDxZ_QBRAQ`HN$eiPt
zUNv=QFm-a<@X1$-G>KRZC~|<~31`lZn{xTtXtLb(mhhHxwT^lQqnAPV__RrkmjB-;
zy_<ry@@beYg59GXxWtc|sIxbN)97O}IBo_PZ!bW;odmmQVfJAH+8aF68zDIZf2{W5
zX=d0>CTJWEPfJtTMzBi}k-A;^^rilCf?qa4yp9wixN3ch#Zh_=9>BDj4+-jz)h7*?
z3c5@rnAep7Qbc@U$e;+v@vdorAyPR)8%^&bm`n(uykLxk@mGc4i;xo=1yP9JVU%=!
zm?ro9Gq}RI(~6TZKhJhZ9f!$!f7eOq0$l8IEN$yrzJ}+Iyl3R?y(a59FVSJ}$_)AH
z$VpG6#qltj(`V0?(lj29Bpuo>=p2x;G)-p{P#{Z&7X-z4nHQido0lZj2~95~l#0Se
z8CVzX!Ju<_-nX&VqQ1xm$+=OG=fJgpvY0E%5gspZkvN?sZh#U41Ad_%e-Up^XYF|u
z*$`nBoeX-tQ>cd@l)*;lr$Ohu-|d|b&)OFkHj&KH-_P2YKOFadJRkP2E-v6^RMkDg
zp!aCv>+Qgj_a!C=H$O85J|d3sn4IZ1x*0u_LZwX`TAJQ*P&#pI^}3X`D@wdGX?K$l
zjW^eE7L8zlRuUBla&hGce{-3Lv+vk?XY3ntGhr5)uEz;0!V|U3=#=TkTtuRHtHg$4
zYW&fDgZU~<??0WLTE&4>iPF{!$|F3MP&@L?kseGO09J;o%3YXEI1#ppM=_{H$O_^-
zU#^R?XH!iDhb2?ZkD6jL=pCUe?eyxnGkn`=V`^d9RufWe^KVg>e+H6!jA$06H4l~x
zF{VyUR6CvlKL)BM(}(l;)F{`~5EMR42yQw?q|{;F5FCs`QZ-tJA#l1nFr{T?5?L^A
zWwDsWBBS8a4D5B$TSc{h`)$Q4^3@jZ=L+b{{^wedBW@0j1zv~f9uND2pHJ&8NRG2L
zoZWz0T}<ctEevD?e=*6&jPa(`ypJkG1fm^GdT?HmP(g~$SQ&DS*{N?j=c3*6ee@Iw
zph(BV`Q)jF4sz@qAE%HcHOWI2OA-0_$?s7FhjfnKbO&#*UK_0%-<Dfa6>JnGFey}3
zcC>c_S1H7*XM*ow%BTBJY0w2mj4s(&=!EKL(HsP#HDQ{vf6d3BfhvaOe99c=j4IQ$
zSFp$fvpD%6$-82?1nSQhX+p$dExyQ8IPQoX%#KveJUPysS2<J3=eXpB<ms5@u^@iS
zf;gOK3{Ag{Crh-yla&uZZSt3b{~eGF8z+8U2FgYz1^Q-|j)+H$tl1x3RHxnZAM6#B
zl61bF=~dpUf7+*!aU(JH2d5?+i+xaeF?sot>9omz+)^kC>kNA&Hw#a?3n|FU3BlM6
z3GH<4!V%kJJ2=dt+7g++04PnqJ)P@5ulFH2F&(q0FzBafA`|kA!5Od%b_wMoYuk7Y
z6c^D+6lOO|_7Z7@2ygpQ3vMDDa@T>u-d|xTJY&nefBIeUU;o+@-y6H9sA9r2Qg;Li
zj}(Ir2R<C7rUbwwM!V-+NH$Jx)7h<$47&d{e3}F6FrPmxHaW3gUv*ChT{v-rQy2e^
z2U&4{7LT(O^YowQs5%@RopuAO&(xqs)BB9e6E!Y6mn5en!HNd6Df#W<VhFR9=(D1y
z_q!LKf9$n|cAm$e4}nOCDu`Q_AOoc*8->XS1nH854*1PhDS-D5VobT)t5@vRPEPs=
zn^eh(&EY%bEyaVuwseq8=90oA*hFwImLt%#)a}Ve<OQsYt|o_GC|xp1t-~AkSx9*5
zhv=Rd2A6R`8^9*-j03_NH#aI0E*W&uszZt_e~K=cX>=2@;}U;IVbKU5V)&kbU_%8*
z;6Y04Pl#Ud*Ey(Y=_I#F?~5oa?#WwhJ-j|i5&ZBJS+Az&<e6e>YN3;u8Sol46Vzvz
z>s>`NkURu{{2-yeW+2=(><Lw!8(AeRUb!)rkiY|pEDChR7Ap#@Rw6$nWi-UFdUy%X
ze-AQ96T0Zllic5h_f0X_uRdm*c|BlkcyZag=v)qdb};SodT{}g=|=>6r<g>^X{b)(
z<1V^tUtbM6!#9_`s|$2?3Txivz04vNQ)&W_ZS;xp+%j5mb#MitH{;$`8{y&=PH3}v
zw&nQaQN=>SaU-C4z&VDSj3U?btLF+%fA{*cQwIW{lcEU+)Kn@iLP5}oc#ak%eSz1&
zAhme4Dx}<kcz56yKw?WG%3<O$ko0(1@~up4cp&9GSHR%Tf{ut>Q<&KIkE@-s!wLp7
zQvpN7#Fg9uOmG{A!F!+;nqfVZ7&PadJ_ckT_0BGOSLet5Dlfl!O;1wng5~A7e-?5*
zx-sTrr8Kd`xLK(~w0rH^Wfa25NtwGEiC|9xVTflDf|eumuvlEl;KSFx&7HsCfliEQ
zA*lh99TqzYVj}%DcFf?U%(iF1{Su1ko!vX$H6la60cLOVc1>s}4Dmimol#V2-gNw3
zu-1hl82wga=jmZY)M>llua68he^N5j9!Ix<;zN~{I0KA=L1L;2<{Vy=AxnBIvr^G^
z1<15rrK>&hm7#qo#j`{OdDvvl5f6lHs(pb=I762#<y<mP<{OcoISmKVPYq6$x*VMB
zl}%fPs~%%8DvPgl0broOd=w{IiGpJPYl9lL%T6dmSPw!O6aDVl#VPz4e_UQ24Qde~
z@OLocVS=<gy2*t0Ct-m~XEd8I>!7=eh#Xd|Uzl_=!6A92>mv`$`9q&s4R+Ow&w2wT
zVo6W}DOPj~GG%zf?wM3AVT&?;?l5T$Zei^L!&}w?!y(E|RD|}94RqvE(H8hF;nBzU
z;AbF(&dCrHEc^0I$&A><e=rxp5nWuo(<bk&$+}^bEayIi0xD-xdXk?jr`NGI&Qkyr
zONH~{gmS$M;LkoNGxW<qauWUY|B{qouRNthnvC8T6R){@oaw!hX%Nj{y%wKIm4qaS
zzb%4^ELrIopPldqoOpDYP7H4336t1#a?^{uAhA9MDXNA=$~Z*<f0jO`banC9voUue
z>7DFmqndoYsi)?CmBa$wET)!3<Xs*ko|8zbs1OC<!Z%P@E%o@JReAiI&AGXsk5YDP
z!<ie0<7wmusxtRI?e%_u`}(MT^tMAmO}5$=z2JnAf`UP6DUX}8lTAz|gl!VT@$dpw
z#pEZkR~>O<6e-a3e|{UO37G+PT|`dp7Fo9z!lEEl;#~3ERC&SmksC)P%@0wuK>FcT
zlPVSM%Zewu<d&N9&EAR>r180yaBzgyQ8dPAjhrlN_3zEX3>D)!*FHmCBFv>uTV&uz
z2#FO~R2noU6$rK!z6_rKbNAWTf36^5k9~`P|9BE)po2#&f4?2JTHi`&pY;?SHcOT&
zk~N*_0UFQ$`RwagUw`%03o09=&}g$P77-4x!qT!Lx>I(B-TE>&HOQ7Xz%vWEC{W0p
zlcCGZ%2AeRj>X8XG-ewYmMh!N%3LurAHor+KuYBsV<SGlIzt8MXgGL#*=d91=@)6V
zv3JE3-6=MLf0c|jY=&iDGLpoS?6cMjqV6ibmJdrb6Xtq{iHqCJM)Zp2(C{{lXJjJL
zaz#>PNTbYh7AhU#o6yOufJlzqpHq1BkV}LVY8>J!L|U5(mNO%%Sj(FpU0eY(2q&t)
z%a$5Dj3Xfj3Q3?aZ^OUHLg%`IT<MkBh#pc}8o|}$e*u)IMy#HBKo-;8F*8C~iKGR-
z&yf4Gl)>SJBtq*=l2g3kY!=Nt1YOJ`<m5uSs6?@ANR(?VF1f_?hgR^0JppXoEdq)>
zBnD%~<yyB0)|n~ni@^>(st#yLj12-?(e;bx6~cZ7gk2$9CG2O82XfFo1HGz!cHxSL
zCSr+Ce;h}FCmb5=7lI@zZR{9pCjp&8QZoKYnrS?bY^6DVE%eGzdiEMJ`oWw?64Pk5
z;8(dyt)}5PensWwz-jW8ZWEGrQOG+6ksJ3+3&TG)U62MorNCUeARn^|>`w4{8P6tv
zaN$`YgU(Nb%l6S=*gieoT-3=LAE}-Kxk{6=e*>B2cOy(1rz6@OOQrcjhljyoV}qqS
zQ;f-lZU}sZBO)qMi_>^A!J4yNKb23FZtLQ*`wno8^2WlPdHoX5JLn$S1b^3i<as|O
zj5&Afwje2I3Fl`}fy|oJ0UMNwlBdbW<OqB&rWX9zzC0)IWXXNCmN;Fkt;rH7L!k!2
ze<7s=u%);r%U@3U$kDe~n?N@%SJzRp6xXbF_^x|7xN5JUNdsnG`E8sP%aB7_*$P_P
z!(;BitZnrU+DAV)wZF>nwgg;EHI|g>$|hvo!ELbK`lu_HHLZueJrZ>bms9A`iIo4=
zz`(~?sw`r|QcrtF?b9ucO~EcR5YqAYf7G%7<6$vRj+^ibL~aRnKSid&Vcup=wO_=E
zSG~crT%iL<%taD`aWA4tgJYB_09r#^HyG>cp;9Vrgc;tZvVx<yI<b4C3b~sjP!g#0
zY*|6dwbTfZOs12xDi9M0I<Rn~`V><7HM(7xH$DW^ym~$78wT8x;uvaYox$7Qe{sJ=
zaSq&Ekg&_e9)u)K?&nz1sTxz;px{vofnb4oqxr*TOd*L9wLUd749&Oyg+%qQry3yY
z9>to9NK_xiFHB&|#hauo3U#S&#`6W#d@tr(zKgfLz0P~*!}C6HrcS?n&euR)O;41r
z$2J-ivVkJl<rBId`-UxrF~JAse?+X(R-+V@VVwHjW@V1Xj-7?#SWxQK`8Dl^gwxG6
z$ojq0cUTk+%L^P2(Hwl%uUy_Wh0`_(Xj3W`PB(U~G$Lko=Nsi$>B{mle(jzWtWm3(
zp}vS(dES&0?-Ms(Y{C%YYBhRsVWArdUDTWt26Ce->{#381{$k@Ud>(Ne>}D3BH0SY
z3dw5q4J<(KDCsPeOk>!4HlE&B&CvvOzmU;3Aorly*l~nbTC%rT&cFthdQng|nZk56
zB9NzkJ}S(;v;q|;m)*{}>+0JU8=$Yok%Z>hXq}ooR!Sal;(1npx2)7`v&G8dYq!`v
zAHMD#|GXj*xpsTWeMQHTf9z>03+Q^wM(N~U<T7zG*1`ZqdLBXdZ#v?L7g%3^nmc*<
z)g^2L7jMTN>IdYq!l-MweGNbipC;1uCpFnSXa?7|Lg?XC+1VtP#<?SC2?Bg@t97Gt
z2RnC0^ihYf4qEXoYh0QUKXCSk5RJd{in#luO^(d4Vv`9KL5C)vf6$|LzccK2&ih)6
zxMX&wP#LzDk7kl;P)NP}akvOgz_VES$x}U}$a%UA#GKf*4vof+^9`A_@QWM`@l<7s
z{dE8*3D(Nj)l(-qGR;l>XR7x_7AWzdU>sc2*n~02UP3PX;usvAGow=y0TM{!p~^01
za$Wy@N%kUhWXmQ!e@IawapG&9L1~lDf^7dMhp6m|?0Qf^kOKLvWN`In62H|6Ld0DQ
zg{Bs&;oz0KwBbgaChDpp_G-dxIKD-`;o?^zN3PPXAQ)=wSVt1YZ}`a{SWtuA0B$UF
z^br%xiI~`i%jVKvLUao^%^hVy;{n0%kM3{o;$%-;?PDy)f3)PJBnF>#sg>fC?4?K&
zZb-)P(>PgvM2Uqrc$LH-QC7UgQh;$$9n&BOMibLYt*Nm8bAQk|Lu(-|bgdPJpT%&)
z@)4}nS&0w!k9rsN_0yFTRSPk?rUI7P<BTf_N{K~Ss8tpu19g)UrIK{T&ajpAUfIj)
z9qUy%yzHEGe=a-cM`e=;Y+Un{_NpMj6G+z*6&;Y0EL84<+!$z2hU<wU)9nEvN)IlT
zq@8^;`h}&k%hi(pC%~Y(yAllgZ+kyd_Ce<oGmKURxK(vPj%w86(v})n>*gwHQ8dXV
z4#~(aPHsGVwl`=Z<ptKGlAh9J3Vd$MLL*DAvqf1`e~!NCh{$H)6l6*JT3c3>Y8h;^
zCx5kdrcruK<7rSsz;{;d%geyU_%^MV0^?B>iY@wrX*41jptX#<S%^$ks$xOaq{Xel
zRS1n?WmEY<Ykb&T#;#_Ym9nNiY%aq_5CPqGI411MB2_ft>sQJzNE^gjtbz#6X_i_5
zpHogpe_1&G5Us0}Lp!To^XeM7C%u(bf9Q+<;Bck?WVsPbZmiS=0*(`;=q4>(yMZX(
zWvsE+_p#=n)<j=ZsK~!3#H$X&?5e1~S3N*}&3fxxnJuOvNQ!z_-rL&v6h%@~3CJ@B
zSaHfxtC(0fp49Sg*8qjf#XlG(b>#<hg@%*<fBpvp#)c0PU-UdoadJK5ge{Wc=+ujN
zt|kG`kf5b$*D-+-1Xr+mi;n&fn^5(K&-#N0lOPw6qk3ekiO~mjo*EmZSMQneW<Rlg
z7%0xWYOC@`s79KRtgDVdhOIT#1BT0h!d;Z9)Vc;?_VNoQk<N?DmOi#D@u!@Fr{pP@
ze@8`o^e1x9$^&O2P>LGAYO+lfRHcnN3X+)Z`r5GTj;gVUH7I?BqdQqMq#6_Mfz)$U
zAprL+M}#yK5N8J88+er6x4Wa&C+GFgj!;}@*zu374VKlS40wNnV1K`FE6UJ5nt@fM
ztZ$)?|CB~&zpac<YUN1lt>ZXNameV{e`;E1hKTi_N?veFVE7{Cuxer6>#BxRac5UY
zDyI<pd*JoS$1d{Gb+;|k^N>=9y1`|a+`7F%Z+O-o9KFS8_ewH_TVFA_#yodU02M{Q
zA@TkcBe*mL@;IkUT?U?2&Xjb`BFZxh#WExDRU$59c2-Iwt4?2XueoLT%+TdNe*@~9
zlunV8SmSiKuvR*{B||bxp7sH()iq7gJVS~3l%#|jBZq!VwlS@m-6a$mfuGgG)Iaov
zoXs(spv${2?Yp#Rbk{CvrTNBAc=b#1?2m6c=N$^iAM}oUr(L=6Dvf2yfVK;yOp)Ch
z2C{qJ<2=+Nouo>aOyevX=caR>f0MBL9-nq=^F72<&azW=)xPZH@2t}weEQBJspq@h
z&aex?BkfFAy=G^xuikv}#zxDV?e_%_Khm~z$?LXt+_|{y9KmnLpRzk)9uw@PGNzqu
zxk=}ZO@$-3-L1b9Z?~QE_G@WgGU)cs`)js2Mh~sne^xjY^ClG<;T^pPfA064d@-EC
zy)pYfXti3wdn_8o!s&Y)v-}VYr;pLs>?1*sb$P9VJzGrTCs6LXgKqn@`+q@1Lv63(
z%pes(0yu5x@Jzl7Re~lTG;EY%N*o@2eO$~VgAvAA8XSli!?BVWJ#x(qy+|t}Z`BUS
zmT#IS{tYw6oGfRG|22zBf1GX`(l*s;k1Mva;EHNem<3ZTF}bdsNph!Qmxi_TN<-5|
zKC)vt1rK!hZ0)4|=LP^yPJk0#E7@RZG;{X}AbOAM^7k(OqIz9Fi*CYfLXm~q>HZ-R
zy3Y>bUnNNQ#UYiasG}L+2rmx3<VLjMT=jwYtm&<&wvn^-iP#8Zf1`CnjjJD}1r}hk
zm6>aFvPi=%DOzfU(b&qb(s!e5+oKjgdWKDnlm~N>^47~d(*w~4=*TLZ)U%VA!@h4K
zlcpjP8I~w<9)aa*dl&rhAJiGWn@pmQ1S|8!36;JI23R5NT};K5G3VGEpfyQf&VIeE
zuGue1*&I6afK8tpe+8nk<Lte%bNk%3+i&bt0Prc>ceYh`MN*}%cc6u0buIW~Agv!(
z)<*_W602cQIv!bo)a;`2sJM%;PR55wlORYFk)GXJ1jp3KCQI6`^)Dd=<cR6Bnm@t*
z#Jy4tN1cl$d|Dn{TG7X7Ow}WT-P;%??FFb7$?o2sdMxH#f9*rr6<pi<Y{uf~FURri
zaZ<reJ>Z&wKbXGl#8`3027Rfym8e;IRoCEnYo>_q2pyd4P{f4l36|N?UbB8XBpkW1
zqo8A7ETwjEy=kn$R>L_ObsKW8<kR-gJ*-RHU0>NL3})edsvC3)OOK>LV0p7Rw)@K1
z?WWCjc7%Ome=dqv6;N(mb_2&$b>3^8PDLUp7$d<lICxp6+OfUxCnu`Ieg(E|o~_p}
z#|)bjdZ}0vRj@x3HP@sIHMGY%dtwcMYy&adAT^Z^lh~Pyiv}x+pVIPLALlbCjKamY
zn>p(2h3n3-XIf&!o*aPya%0oj<!MaF!yMZuVu&|ge~!zk+0rD!-M%D}*&bL<J0{tw
ziMXt6sNCF*>a~D4<d<P{)Nhvv8>YYo^^1z;i{c)W&>S*#dA^eIQ5SWF?rZ0MTS3WG
z^HYlZjpC6InBAYSDC_ZbiWtc)py3t9Z5Oo6NKE<ocf+ZLN||on_Dvv>B@G$fDdR;e
zEZ_zyf6{cuPJZ%Z0;`zKINC;NK@07`(YuR3#EWPWhpjZbIl#XTUdJQMsy0Opkr-MH
zu06vE*EkoqfYC02@n{yOl%I94pe##{Fv2P5EI$$8sdN|}LhY?>GR;gub=eIi!$sMw
zl9@+(3K}=14V~HE`!R4yL&pKtaxtgf#${lje}PX3E}=YTX3!3{V63JendBr`o#ee}
z>fa4^-Zf3DA3aYAsqP<F-A=6<3|PRt{DbsbYwhqVtc%&o!P0Thzl&VX4zey!R5n?o
zNqx?yN=HvKbA`m`uQ!;Yc<9PM*A!(^fwtJGBB8S5#*VjVyW=R!fXuMQ82q+Z-g$i*
zf0DYV%G-BxpK$ZSc?a?0CAI=j?AIw(cEFnz!~wN3KS&8M3oFCT_Y&e`!|n;knO>cB
z&Ig_2t^5xPEWE9B)p#E30;ma6r5M<1G>3$)>-FceM=HsmZwQ;UJFjeM_0BQAwsU#e
ztLcTdswJPhVG=m8OeoqOh*s(iT{hB2e?O+$Y?$Eg7`w@A6uOb-#ynlz#ZrC29l&{)
zh-{K3Pcd_u?jhT%5N$kIfWVY}&C=v%U9}}2lom!6BGN~?=NQ*>+Ck%0?`SO?5qy&T
z7bj}nAUBR|)utt^O=$6xEZHQ^{i*<}4KMG2Og+^^N(t5zd~OSk(pLRkA$sV%f5+Jg
z__a7igfE#w#jG%SN5_^<bmA!8jL^}tSg{kS%@t>!=Olyc2N@u$3AmTF0OSH}7Bxg7
zcDS;Ir)hGN_;K<!jq*s0QdPwH=fAPDngeV)|3(aeLF#d`{z|E!sN$XUSje!0iQ(_s
zr;dMX3)*g!5*@G(j9L{qd~yqVf8KJCKY+Jd$W`G|at_i{?fxpRT63Ai^EnErXyb&7
zH{}d=;)Hr%lTT5q1~`%F>!vzscTb0)<myexf_!Oa6k+3JN!jo$ol*4sx^WRz+=eyu
zYIiWp*V5x$TBTIUgQO8I1#AmfW4zlkZ*2#^@}@Ae_I%)PjN3ZqWO4iue^p+ggR8OK
zz)5Jj)7~4>rD7Y{;jJAGIuZ{WC+g*>I5BQWEf6T*P!Udjaqa+(0~V;{Nz*JST)Cdw
zX>F?DD8g(GZ9S@2u)NDrT&OviI$J*SWEGqYFDl=vg#d}{2U3{V7mHC!gkPltSI80Y
zYDU&3i)u5(M7S`wmIcjIe<<T?W#BauB5|M!hEc_+r<83DxFNlj(l&ObIcpE<JT+pB
zN!N+n6H~yIdU|nQKP$@O9~bMQTP5R9Y_$6m`dHZf_9u>M4sUAvciY<9YAvIeDEv^|
zNKWf<cd^n1jLl9OL7-paoUNc|4L;7M=b<r-1b-64oZEGcBTLFle{-va>q^lA9HU2A
zvLw<G4hrwEiL=Itw?~F<Ci0g;x)?jjm|BT-g6c~G>PrTwQh}h@(;c2vAAdrOUr<B{
zal6O6BN;<0nKBnj(X4=3rJc<hAsZ&d3O?p08K#I6nH8wAGnVNI^O!??e_75K9QlG1
z%s9Pv7Y-!ld685?e}u=TVN9hU0u+~EsI4}hjF-ie;2?Oiz+zHQgeLLiblAB1QUwnO
z!U&zGw=n}W_%ng%>60o_HsB+ahSv1Hi9h`lM{qYPlN!XVdGCpLa+RO0we4ygwUDl3
zxF8M3)#7a?kEG_5d%Kg_(^#-If5*|V(Jtoc*k0z8bS*dDe^lF$70vt-t><XTRv)$N
z^=%F{OW?<(uvEy&SIFZ{OIVuPWdjcwn>UY?D7S+_q@cn#Up}TCXbY<p`?QT^{dciL
zb<Z!ZOhjy5j|eI9kW3CJCWDR4#&9Am)zLt(oSaj7f=%(reet`@THd9T{rsNJ&v>z5
zo!Fg$9ynO$f7wBvjSuGcQo$UR45?UY7g$=HBo}F5p)pSSt$2`9DxGZ_PK>H)t%Wi!
znzubSnl-tT5QxT56w@0F(;B<jlfNCEwSVXg`@JiS^gr%i{_Q|g4GwNU4Cm2&h&9&6
zt?83(TBXujv=If#;1fxvB$>s*f_hbq3@rV_x{~BMe>0XdZ5kT|SA&!NZ_KFH--i#7
z{5p!U1|+pOB}%2gsB;)cx55)+TbddhGvzu~KT-!j4^oLys4Gf;lPt+hZmQ7h+Xr?Q
zHS(J)OxI6Byyf?VBC<P!s&v#lX1v$)eFB7{)jaN?l^*yb5N1!Tzw|Y8q99i@Bj$)K
z^f)fCfAJS+KO?xU%MAy)RGB?#4bBx{(U^S4`nFU75wXim<<u-LEO=2c@xZy~hIeZ8
zB+H%E^)o}aE*-vGsL!u1=apH&F0qj>T8ru8Rkz>U|K^*ozTJPe$3!^3z8MmW9qRKi
z&=Y@YPs9Sm&7B<Q9D>pIpmQj#QHLXSfptq^e?f)Eg-y{ChnqFME@h7M+b}W-m#Fib
z0Tw4?yz2xoxd90BTuw>&qBY%<JXr*@+KiYW_q}vyXIa~IM8oDWsq#v+Ay|M_+omCP
zIgQh*UB~pCJIxUbX{YAiR-EMA*r~KrbC+E0e+K+}{6SSx1Fv~}Gu1kRHfY3V0dDM`
zf40L|F9}}U)rbwnG7}v%sx$u*(9=X5@&7-5lppgZp$kyg<R5c>ihp23L;68~{z5$v
zzi7oV{h!B(`OTOgjguJ<7*A&S_k@3>{9{W0<Nx#9Q+|6YZ}W%r>^P_Qc{Dg`P5$wv
z{QQc47V{ZTOWUGVYA-eVeM0}I&jDk>e=a$=Mm9==ZS>5Zj<jXm9*up^|G&c@*WVuU
z51RJ+@CE<)hF5p}>>K)<{)e4<zG&S}C-Q^Vw;a=#zvdiR2@4)a8lPd#oO1!d_JjA0
z>Wwe|5J4Nh|M+pk18`Q?Kk(;2uYUlkVf_<vyy5#zi;OodGTyXEpvMglOg20)f7$dv
zy6J)GhOak$zX?jyO;DO{g3>tO0E6{k!*SgBz?U1J_-fM=aMm{=d&8-iZ}?i9(XD@K
z12pCvW<fr*ey8`FzQ0@l0C1~K4{QK7aJWqme6!(!4PRrJ@wx|!@djiAYu)(3h9Q6}
zuYUmewW_t3oujMEe)rv4V~Tdge-#lWUyfWAlC39v|EO{&VJ$Y;4UNRnY_`F4Yggm_
zb4|CMpD5pZ-E!A!;>OrRu}o5gz(^}BVET$VN6CU_uF@r1>oD4j-{#aP3zPe5q*;Ms
zv0U#aOH(dQZA>!8cy5H-vcO2D4ytw^7E_jf%tu;Zz@MCrUbZATN_fkJf9mfs_)7m?
zmB2gf|9pn6{_3O7s5f_+D%8ACvQ3z19IkW|kEzumR_2uIEo2(wnnDs=wMWk@Zct%S
z>~P7R^)yu3flot^qgCi6pQcz~cFRXCoG^|uGPX1PWUELiYcvS5;>oZ~52Oa7+;@Y^
zFRay(J#`~WPGkb24!hiBe@_V*o6BSNmWw!wd6qz2tvjJA>=y_4_`w$z+9hePj-Fok
zPPYzXl-><w|3a&yO@4JcwU}4~?IG!(@9ODpXauhKY3wArrjYY+13wQJd#PZ5Jc?Y2
zRgE@y{X$KGP3{LJwsy6&17WsJOnozGb3G;)z<&DjrF`mr_Qe46fA1P)5LQ9lrdBb4
zg16hkx6T%*rWE!5DDtVX$#oXqaF5Gs1(#io(|&Kufrz7Ij}D}>z7or+JB`)-Y<(!r
ziw{1OkEiUHG*~VdSyKVn1B`cef-k(1$NZ3gQP%_`lx}6~R9<-}bL1_NiMfLmg_JKf
zp}+$ETf?qkz&LX&e<{>p&|B+9c3s|I<;w4#wck8GdB<}<TC`M8skUs5QhEcc4&wVR
zojc2{y;_Z}YwN@n&$4O6ESs((lxeb4EOJ+8oya>fMPsL$eo~u!@{(?#@A&QSgYRtG
z$oKRO=b@PIYZ6f^`)3EZJCeMnrqgl`N@-I>^?Eajch207f4mS3pxcy_LI;*tWly3j
zpf!zm!|}~aosGJSSs+XS^%Pq+nQ#~zWmr*q<zK~t%vBKZvbs()r7UhFh5gIIB+-yL
zYAmM}!(_Aipi@k@t4XC~_nol#WG3gvkO0*2)D%e(N2Iv(rQRe(ReBrq0%=SiPV5XP
zVM0<UVXgDfe>D%=Rx3?5XA=ZqHB?nFnqj+BV#$*T6R=G|Ejrdq&do8Qpu1E&hyAS-
z2&07vN8HbuBWFN_=a#vDivR#Y@8o2!>8S&&7ym!Oglh^<T8y{`-G+DmYWP$646N6%
zI6AY=J%T)C3kS(o?h(E^skrwluZOOs;^`>)ISfZ|e{T9$^ZOzE81i@G>hR#S#-lM!
z@67UedIXaR>#GB&@s6?_nWTx6rf2QwrckSaQ`29SWgY)tAj~qPY6L`iMEt=k3K2H_
zKmeo~%0ks9b;g$_(MC??Er-VC%~DK(l@sVW37V&<FHLRm8cCoukpTzNvbe;%W%;i!
zdq4IWe~WhUo7zIwL7*fj`HyUKj_s0(hV>*{Vr&I%b1*r=`ZmfktvIdGen=2L5^cw2
zmZjyoLr~kGDVwnDtwTo)oyaL!f}-(@7SP@+V*48Z4yVK<^3hp#-ONt<nOxHNX&p#Q
zrHdLXVCvH5RlhSlJ0_n;yAOv1XiOWxP(WC&e>NH;)C9&NYnm`Ls4t%zc1Fb41junB
zA6<PWJC$#1$-bv3OiYVJ=7t%hA6sZt-g6pPGVY~b6CQN#I%0a=o63gL0r^c_yj_kY
zbWq!k+Xmd!(jG`(G97LtXha!<3JZF7HdcVhUOm8!GAuZux31f4Pq^B3{E-jdJfxgc
ze|?9fAl9;s16=GVKx&lZ82shABjQuViwTBcqg7ITV@T-uE7cY8QXC6yB|S@%8#o{=
zUs;LG2BPa&xQ(pHwbF%&iS1nuF5Bl=I~EgqhV2t%<(3C&ETA7%=*`NRx}(VDq+2Yc
zQK?q(mo2MR{N*{9+pJkQu%5p>|Knr5e}q*Kb0uc*nDaNBx^5n;URgg><&C;7LX90)
zG(UDTAf$tuo@Xp;lJDE5u0|ivBc}<F3Ah??;tlX&tu-doYY$r7fz1TuW7uQ@%ehS=
z=jI^Uz3W`QZV$R=QViHHFSxPLng^w_z20{Cv+b$r4P%-?NQ#DPE9z?_18d*Ie_%~)
z`M1x7SE&q4lM+ctwvke_TG(acl#MYW4@FuP5AN<zTK2jfV!^QsI3!#i8c#~yHl@$7
zvPi9#!;Kz@?MWj8JiprN0hyV_r;BW3m&3xM*mNW~YEp|2zIQE?oX_nIBC3$Y?@N!8
zjU_s2wii@W5=}wuW30e;**R@vf7PT_2gsN%Y*ZxjUpyc8MA$W1gtq%Jg-zL#L|h<r
zql>9_eI@sRd8+>@TQEzdGv;l=9DOb|aInlZh#s#wO&<KT9XV^QIy{`G&@CbqU9%}J
ze7b`BHFio#Sy3>(N8z4)Iz*=yO+Z_9Yh%h>frlB@qLKpB7yy*IvNbm-f9tv0#=T}G
zxQ{<5%XkH3T*4N340^rOLHDBXR)^emg7u`1{S<{{7Df$loMHgZ>9ytELn?<*#0zoQ
z*rNBY)~V^Yrbr@kMy|T+R5{ihkq<`lwB;V8nx&W6XdCRRfs1Yme3AOwlaR_SgL&vQ
z)NoAtR29Bpge@4T({)q2f8?U<nJx;yIFYTQumLq2CHQp;mA#$}+6?pdSr$sCZwKu+
zD~s0RLw=)-G7?c^qSn*`aDtoV*pekP#XO(gXM2QeH{jD`y<t%BK81<9at@Ze9q9Y=
zvQ-w|oL@c7P5Bvq4IZT8DePE9y#OuOYlDP&0QsQ`1jeMZnGh`kf0E?`!+qKMru8*m
zz0>$+N~LrWSzIO~#@o%0+`|av{h-S=J~%2cB!{DuH^dXugB>pYSHdomo<)@w!uI4v
zQC|0hGe^`>|1KfO90~Hn`vJx1rKh(qovJa^2n#P(+G3qmow2gZNmgN@-*MRndFBS6
z*<;VEG+{zCI%QW(f7KA<?ABZ(l6j=Lj<nLT^+fgr^hBXKoS~QHKw_Vee4><1vf)HI
zMjekzfJJ!(ZhJA)_SaugpL>oi)@#E;<QP{3S@$%<_v>pwP!tD{;|M5e4m)4mD*&A)
zp7yfmTE&#N!|gC_?*~8QhPy}AlxT}fk@kJ5eDr>+_8pbYf7XKJ=(K(Q22}2Tw?E)+
zgME#H-;~a5-Kwx2PNGNhaq|s;lhAjq+3a>s%w*4&;|a&(CBYS6q{~oBtEH?kf%=V&
zkdbjl8QpNnIPxtP$l&7f67Cp~-?1q;+Aml$isp+MmB~Tab4R;LBvv^u_T_1An5u4J
z7NSf|2AK$zf9Mbcbg<yCUrx#ttu}`fJ7(RRQjn5J&-J>b+KCqsW55~at|sV|;W`E&
z4>9`#q4)}<9~l#Yc!Vr$gXFgYy`M@1nkFhQ93Nvv0&-|l-uV_pgRZW^i$(%yIj%{g
zg6UbIl1QH^1gzL!nTgcwsw@mJrNimtP6JB0j<lyie+Lq0t$ca`ydh)63fE?VG%^+p
zS~0$TNA4!mAQF!m*@o$&P*qZgEO(2DJir-k4ukhiuPe*ejXll;#FhNvr5H56Ch;-t
zp@UF*Yz*`++%me3o&OV|?{X(ST5Q0cR)gbKm3&i(57njE`Xx^jQykPSkH}B5ynzl-
zYOTATe=UN%ogchS?*=K{1<S<%Zhlw+=;o)V@6K4%a#zM1P|D%>3>8CtI}`fDh`kBp
zL|6fW-~@5&A%o+4rL6shG8sxxX6T_PVr%=*XZw`mL1Jfas94nlI{3t(b1hLdm6C}-
zvhC#FEWSix9tAkwbn;ZYF{1x1c&`xbaeL5ye~qo)G_>R2l;P?%!C?7=jQzit3ABBB
z@wWZCGw5=grQ^;|wY}jJe_^yFF-x+Gp1Q4BTc=|Z6*-^FjPa!EkT5Y{A*h>@KV$;`
zq(m{6x={C~X#&1ca;n*ucMssZ-8bjGOF;N#=cN17rdS=&tv^z7r?m$2hf&V;*u9`c
ze{ImhrO~uXubfT>9t)gOb<tajT*G&1_JM`ZN-QMT$>y#Q6g0`Bh()dBKQaa0Jq*$&
zs2!+W9vS>S<A$Ol63cMp(2@vcG$rC$<2s=fZ=$<mXl!wh)S#w(hxnNB?vTek1zR3T
zQu8&u<uT{Cr_hwsr@6K+@8+#+yL$cfe~P1AIp+bt8uqRRYf|7j0L%aduRKd`5@m%d
zmKV#;mphe1qE}747|(@?-yLi@^s_q@YQdl+C&CrtN<g@qZvHaB>vap-^TALiI~M?+
z28yG5P~u!xjhWb#<XlRHbbAY$JBt=XPS#x~Ci`W8f<rUl9Ku$ZFV;j5v>p!#f2I8q
z5Ly)|uvWUBb7Jk1eXU1C6P7e>^aP;pPy>o`TW2TWcC~hIyvsa~F<PN74PX_^_+_1+
z>j|^mjZ*ZzR1?>7`B-2!pGHwpNk*qeomxDHiZ5wx=d{jx<w<<IQHw%n3n$LP_D8ww
zbl!D4KVq2?imX609B30j_vGlAf0+88Ss@1HhRwf~&1o=&u6F;9s2Ns$Hxvk&zpqme
z$eh1v*R<)@m}*V^400*6%oDc3i87f4^K{}-dujN(+RwIv0-ze}&y<QiOY{{NAapwn
z_#5<bAsSa>hYB<JLZ-Zc1iu`S{DGBtu>v(p+@yEdn(q`kLE#YY<W=~Rf6TsI++=Jm
zCwUt-58pUePg94LN}sz{{Kk&nwk9Bex}0!-Ja!FAfshq-(jViv%R#P-7i4zO>un5Y
zt{!wIrw#1x;b+_}$0HO=)aCBPs~5e7o<gSrgDjU~VMv;D+_V&b>TW%z=n}Di+cijJ
z-3l6iD24OL6@KGb74k=7fA@^vmH4L$+5NYj`WnqEXkZ-XV?GqbM-VK?N`%u21H`y=
z<o+%_6y*tUy!~RCNST5({a_moJ0egyDPtA=D0m&F?iy)77kf3kU5Pp=twZoAv30Z=
z5%8&Gri%j4^v|dV4UKX(Xdoi|EFGcKff=;W$8HIkd)AAAbiAaJf9E4y2AL)>oh&M%
z$00Fi{k0@k+2uMyvwl;T;>Z)}(VX1aK{cDnHaf7;X#O4V^v^Qv`zmK`#~LT3<sL^&
zF458?iGDm<NEtNtl%hkAe2gdy<2zFIxD2A4oVDa*i?|!3)Z$b3a?PRx+Z#mU>^(w|
zltIDra)B)XX<?=Kf9=J+rD7S_1iLyuAtQeKcdXaW7DV1GtQje$R!i|5qmwBRk;EYJ
z7*aDj_Z=Zm*184ExhFB{4Vp#V=rB!8(pH0;8SU9ssvn%UD6hkPoX%#WFk>z+C9U9~
zY6Ul$SG4ILqtS=BI5?VS={#P}o8E9HtOGfbw6k!zx>C~^e@#2c#@w7H2V_FKB#4Z#
zTB+-8O3{>JR*mFJ;o$Lap%(rHAtOdAi?I^3rh%~uF8a8b#p4(gKvpzkY1GC~eJ&5E
zobg&7@Sr{z3@^#@B4vVWy80GW63wl328cYaRqq|DCTh{Em%O=t*k5T7vJbBq>B>0S
z{sek4YQ+B(e<4q4+ZA0Tqusri&H2Na4C7jsy!Ea#gacZxL8_s=HWdSlXSaej-gAkY
z(A3ze-(Q&T$N68GsYtZHm58WYok*+d+I~z@aXVr7q;k|d?OoD#*HKDbYR*$Km{^L)
z@Y>DPbPOT_?22O!vDgueF^^Ujw>|B?c{|W(J0l73f17i3SZZYEar^QIdCrlAc`on4
z_SK*_lwrO4*Xrb^r^E3WxGgIkA`DTX(1i(NVf;HQp==cA0foI6-b6{uxB_19b_-ZJ
zJ#rGW!Bz9)%{Az~c>~zwC~TI0s8nhWDDnE{@_xwAWd_EC#t>8Jigl4-7Osy&qz(}p
zQ<0rxe+9h`-(Gc0!n5fsHBM)#xi>wT_Slpl7U%0P%e=7fnC#@TBrpocAFx?A_1ERH
zpJjqUCp?bP3f?Xwzg$I_lg&T5!M-{e0!<I@gSH!?6Ny4-)_3l~A?wsIzH&?sf-wlf
zfQN3Ms|*tvzdpoe-A70i&EVN{`tv4>Fq-Are>e2k_&$U`o_|Syj9{Q<@Z#_geS^zv
zF_Qw!FL<C#YbR{g+VRC#-&R89pFcl*Y}z4$AliY!R}oFWJ*W~5><|s~=#|JZ(vIM}
zr&Pq`L2mdeRk0z$ZRlx5I};gllZE&DAW+Ywg*V(AjUD^a^RK>=K3QBBTQ~y-d|_u#
ze_6m*poXC;pni7v_@M4{CE`~&_$pApX`h|7tH8bq;nLI8S=-!PB>-eh%Xyp-QIkI`
zArs(r%~AC*@s6*OQG|T&8Bs18la|D9O^BwThIk(aUXmdm4yj&5Bg{I6x65w``_<S&
z#vL_YWz_~>5tny3F0dIZ?^8BMv25SCf9Dd7e)0^`P3xPcGcXXadxV__pSPa#NyG_N
zscGz}`ON^hhFZR?A(t<!Ni5$yKD96<0JVH`==f^rspFr|+h^UQ;aTVWYHdWRFME{b
zYTMd@YV3287yAcE5&^Y?-E~QL8{hCN@bc1cymF6eaeP6m)`}P6-$5qplcA9;e<RvC
zgS8cBK%GxqxlX5G%*H^iU>4m*GwzQYj@)WLg>8yAA4L->ser8_?{&Xy)H!zJf^BSq
zq^N4#qN%!1dKYOvb`#Bpw28pw|D&K-F%vnv-u?9$bm3#XF2dM*%xil62(+PHumkDV
zkl6Oj?4jUR5o*>Dz?15STEnLNe}cz^knN#eicypEb&N&fPmkBcD7u}BZKi?g1ML$0
zHMXSXssy0chKW<vqa^mb*#*Bpxp>=LO)f{hi=T%_r`?O!z4qntR^fM?Nsv&5Y3tm_
zUNjj=#&AU?Y=hyXNwffBw}WzVAC#$bE4QOBBwgH-711Q4s$@T&#fwoIe`XUCs}|?d
zhl!#T&=_H|%_R<Aj;8ez1$WVisgkys-3p%yk+{()MU#FkYRg^Uy&%zYaCyKF@5{sa
z!CsSFoGfz<Md0^>lwEr`5~WhWCH#jV-ovPic(t_UMVe76#W-CqxN)VJvM4*7LgNxn
zXLBLRbz8(^I8M_Kag^`1e}dQdW;<-BFk?x91xjtT7WUkW4tHFGlyH~R!xEq)aV4~`
zi_6~M;b6o5dOvjQwQk&&@6604#Kh(xn{4k7(Y-{Y83>p3$J}W}LSqA$lT!EE5bkr4
zRoaxA8GgjOmmZ+_lp(f{>YNWQyKo@Y;;S8?#quaNUFp|?0kQD4e*|C>YZhE$(jwX@
zsaT+CBaA$25|7DjNePa#`@dR{P&GngZgQA_l4s!}k8~1`BVz1IhAkU?%PtSVz`?mW
zZjhn@`F<C+P_PJ3NHpqTWm|OpOHN_1Ynl;hWi?&kgy+)W)#&3Go#o6v!Z|j{+9P9T
z?qpb+xf(lWwr9Sgf5Fp~XBnA;&<YN@f{6O?RKqmFDR;&|y%Yf+)ol>{fZPBHGcKr+
zGf%7c43c_j-feW9Z{gqXr|eV-)+jsWSfk_KQNJ^&-Z@P_F%5;ol^M^TIHFCUrJ@G#
z-!^cd=xHAOL|4%Z3gElp7bi$_=>l&gLiBB%r3vN3mf62Ne+g0^GPI}#+SS2F9FSPQ
z6e&>KU9bNW?6>t*uzMP%z$_+MAR#sW9H(WaB-=&Bs_3ea5{x)1*eY&~of;GGrSxPY
z?W>{_W0;gWGD0_UiBELqzAP=0Z6dMeQkg;EjsNH1G#+JPc7JfJusP^Y;Ydynj@{ki
zUww2UP(~6=fBln9_5s2t=RnB*mM|-p3wC0!gZoV8#nhzuHad_LzX>IA0F4|V&tU?g
zxekW5R7Jfx==T&$%cNe)pD|;XI)k|l%mwV%5xQO4<z|+cFDG&8#Qu^1_(&E3Tat^9
zT@OZ)s?c7pWn@u!nVHh=RKZ9?wL`9|lu$t-rYkJZe+z7DPfs2i`WEYCe7y?n!NrX|
z1i%8qGKl%(;Yp`+4AQ@22z^pN<&$-Qzq&mA9}M@$f+Iqq<Rq7&ZNZdK`_H+7$IB%C
zb%~uRV+=pjcr0)44en+-0w~Qi5zD$ku(=tAE#XUOirA-<AeLpCuW9Aad24<z0BW7x
zGp8xZe;nK@K4=LtoeDXtDHWvrmbyqUq{Y#rf%o;*`SEFI*gZC6S~Hy*2IZZLtJkO9
z{@czazV<0t5RurY!Nqbki}NWP=C(xwacYZ(RY=$}G2Yv{S<a)u+Jjpa);i%zXcIdj
z;e_EB3zJv{$Cdm1UH8UJ?^WRKr!K1dZRhl2f0KT%tP&T+Y08cy#y6Z5$6f|<wPI+n
z{yJtWtN!^x%M+PLSuR#>%!a-SL(>j1XE7>+>2(3Z8%_Kct!+P|vOi516ttk_7mW*g
z6y3xu$)Lga@cA=43ML;(gFS9pIU`lHsh!EfR@xHe-X-Maraa{)jC4&IcE)T@R=+!0
ze+Op%80BJ)occZr)#rg{2lQw%$fJ``65XkfqRz5nSd*Q77g2dE7Itz}jwHREiH}RF
zl3}xy8wM}7<TZAQMWch~htIw~g#R6W{o?soUmeJkx|Y^lfklEAe@ql`aCp!@`1ati
z{q2iyJ11Z7cV0X@+W+#!;mLmc#qr7hfALAX^OtYGK0N;F>n{&b&ceO4U};X)col_i
z?v2T9G?ajS#G<UQh6CeGsLL$pvODH3mEklBl)8kr#?v_<;K==|;Z{t>+;i0*5b|2v
z^V@G2H!LtVUA4>vL<K38%+*(%=V9XMY_Uf!On671z_em~z<6XhDvH;aQOPYBf6pvm
zYT6kyy_n3g5I7^BY;9b<jaR5SjFQ7IDa$F=ajz>mY|Si|2HhzUNw+aY74uMIvrcD~
ze~c(?cv(r5j)J4NXTwb$J4?YR%qLmHM#h0;B4lAtE9M)Al1XBdLhMknJBnVU9Jtl+
z%Du8}5EPNR7`BH%hxT7deAVsyfB$UU%G;yiY46CE8CnCPSvr<l)Lv2lhUQdL^+W~Z
zo)<Sj)NfAoE?f!B3-D6HPTo|SwCR}rIN38JLm{Z5t42!8Ms;(gDBaP5Y^+%+E0jzp
zHWU0af$aga2H0kVqqkjZC~uv)ShLa?5|QF!=T`M9Eu%7kMLUC3SYzzvfB2P(h?DOQ
z30PR(d2d6t&qn}*w@o)=$v>5B6f(W{oWw3_(+Bv5Q$g1QLjtJg!(P)k0g#CH#PsM%
z4)VaG9iP%VJ&eBYp0_W59u9g(C46d9Fjgi?sLVr|C$B_mC=uB;uORvqvj(ZH;DoCL
zvlW94S6qS)pS#ciR0PyHe|j=FBI!{%b1m>3-~=n^0KOY`e!6I%9}E1L`?#WLN~~5w
zDvM~&*{7uAO15ckW6i1{t8gJ-jGaS}CNR5&ds@@BZQHgvZQHi-wQbwBZQHhO_q6WZ
zfAg<y)y*Q6$|9?i%3H}fc@)Vnoh)JJ-1EO~{2W}np%}hy@|;$BFbX!hiLT>CLHG1x
z`~!;N6A{kC#aMl}q<GaF{Y)-sh`E1^)7K|}kmKwYKH8B*6amCc9LK<j287|SidO=B
z7Cu?CPgkDMb*2)N<>IflXk|8b*+q0|SlqsK7~YpMw?)3WNlat|@#nSuv)nc9dD@*)
zc;gDb-`eNH!w&Bq6x3Ef?pmd#3KBX{uNdC4QhGlHK1+zubiObD2{Ys-%%TsvH-_0v
z()1}$pD!x|-USS~R5cfW{5RHW-J6cGS*T5zzY6U|)RErex0`)&<)h>NJVfy4$($HT
z#zE{|D4?)>9$sVXNjXwR3#)xQJh}cuEAm)o7rj?D!R!T!EEE@?akzQeu~L<b;ke!r
z1Onf5z#ugyq7oI#TlHK^(poHuNg#(%V9!&s13eJ{MC|if^Rj{Zq(Zg~(SkY2e~o3H
zbO-i5(O6z7>#&@+JzLF3D7nBK{q9Bk&}-@O$Cs$xsKhD0#cjM`eV8}X{AKk|YK!^3
ztYm!|fnSp90yYc5C#6RFI#~v3x*(N3M35)Bp^;j6wz=n=dVz>IFNh3(0?3SjMqbqW
zhVRY*6}70JxWf7~G^})%41KJtoUkPZSW<N|kCc9V3-NMAw%=y`>8s83tZ%L5TD^z~
zs0hgzp&ve83~`Dce0y7BSOyBlj1X1vQjW0GRDXXk88FrP7#K^gk^L!2)l7cd2ST&3
zPA6slJ+8*8V{8g&!M$qS8$rI^Z03bJtH^Tz2)>@UHF+$J3HPKI&W!ZKy*6N|)Y~@s
zX49$jy;&o4Ygm+1MCRZ|VPCpk=zzgPP67#1b{jOWp$s;J2q6{TjEh7ZSo|*hcnEW8
z8MgL7CP!j6ID}_#NbcER5MCJSTVZZa4jQr~;UWa5cA5&98X(fvFsrKGHbsk8`Zl%(
z)GOP8h&C)qDlHD&HcWIWXT_bGD$G9KTq>DUMAcI-M+jD}hc=<(2*E4|Fgs)97e>;_
z6s5BT9~erI-iR7x*?%fc^q@g?-feOtyv^BRnF8VjS4p|3V_Jt}ExPT}%URT=8TcK2
zgo!YekRy7OeoB9ly&i0Znfr5M4z%L{emf~X;Qz*L#p=Ajyp(?80dG(|%U&P2CA04k
zpb_p6A;boorDM0t51~Oi9mx+#Vvwt1>T*Mhw5qT?a_2h5fZNKulPm?V(8^Y|iYMG!
z&P9@@#Y`g<J}duy-?nMjE4JHSj;MBUtPII13%6i3?a@!g(XJU0s56DTRtQxOxDxED
zN%A${JSuq1G1F|k9O`|eRGu`U*Z#~qCUH|L2*5G()!1e~0rE<LL?vORF6i&~ksVD|
z0xiA*)An=Th#x={ZT5`K58S<{`DiO|c3iHqG6|<=EIs&sr92d(LfCLu3B~6+fhMBO
zEBMfdGK&UHsMp)vseV~lV-&ap*tPpfRniQQWGrJyb{*uHhF=`GrnE_iCy*JD$Tp27
zVgvcmmamX_T-TdZTZ69z&TuqQOMkM8d)Q}r-I$huj&g`Gb6hm$pK%pN@EVH}SSKu}
z7c9+7M(>z&P&3g?RrrpZ)X1I)*kb=OFzQyL9Cxz;*;-~FkCCHnfX~PWRPg)WLsLQN
zWdeFj`=`q2B|kc?9$Hc@t2s);#Jn7dP&Jag8u>mzTNcDF**AvU^MLeTSy9z4aL1Kq
zxR)(K4G{)`F8)ED^PWkQMrt%|H)tQ_T8<T6oM9iuSi_~d)!77pbs5-J@Eu#dgV>`!
ze<A6`nO1LDPYf}prWHQ{Li({2(lpB>#_*kHGXrn$!8=;U>oj~2B-eMt)mf)CXi1VG
zSvxBi7Y%y7wmi0bnu@h#-E%oC&dp<mDh601PwVesrAQUL^Njoo=n5FtOw{w3Lpmun
z(Q#0hnCZYeC`u7c`XE+r&y>dz7zmzsoig5s+6_-a3b~(jrwt4MjSNO6{qs!^Xkr<C
zb5CAVHs?(fP!;3qm5W2a^o7-6B3pME^OgeHr0o>_^tH_s8kEqY-i%Qe!>bO0g@C+=
z)T?q|Gj@1ci+8{UoqcRXGIqlkc%aI9gSjx$zH59um(Stp1@wkmq?<kSmoWc@MOXuN
zj`;p6Y#tRSMDU;hn3QwDR9oEGw|X*k#hT8|B1GegvdOSkER@|iaU`XPxK}q4(-pLZ
zHC1H+oib;ZrkAO?(dn9X#HKyYO@DYjZE0-}UX}xbJa0_?9f)r`%1@F^(0)jAu&%T)
zX!oP$DcEM9I!O@pF{{m=+^1FP)dDY9l^Hp%v%P;mgP^tnw|ApA^^3P3sBkx|cKCnf
z^ZBww-Jd?&UJLPh63h=3XkK<*HysH0C;zn0-kuUeDW^#b;g<O9TgtL~lKc9nZ{2#<
zT)wEeY(44bYCp$HpmSNd$y*`mO@83(&_6QX{F;PHjCEupoLw%tn8|I=osdGUW_?d5
z@1AU|Tx9zKSi@JCPutl^Z7w8mM~*)`y`{i`p4sYJ<zVk!O(KrI2fNwhqUEuVLwnEv
zQi&P_3q|Ehjq{D+o9CT<4K0{(3^`E3d)n=u&%lo%aCZ16OTDX4V3&sOo8*>5gE>yj
zhe;bUT7r!5n-I)vks#|(55TsBKBTEz?jruab|`oN(0WH0oiI`CB*I~xM;QNcj}xG%
zaggsbj#Yu4ALKv;hlvU556&_M*5XdWzyvQozPEFB%L)lRBacMXa;9rFcc}m4c$Fw2
zc3`somUVz@c!78EMDWU?MySblFKctn1CLBcLg;g@@X_Z2+iOnfYRpQu<s#~f90O`s
zKgPojSfRc=t93lLqtgCcNfqn+@=mj1c<DWN`@I{(IXNri1MhQG<>S0gY*$%gSHSA$
z@XQx}(}axt{mK`aCEv7zs%M)Z0lqsqS%RZ#pd~XJ?nYGa1A<xCzDj(o!OEhfS|RIN
zovgKUl#oau0^&85J-v~wuGCQ8KwllP8Q2N{*!>(~P`3@Kq_b(1@<2zP?+(VA*aj+K
z<o(D1Ao-aF_qDJh)eOZro^wP!b}R=*M8+D+IgH&A<bNA3^^~`<MnFeA)RjuhP}!nF
zXg0G-7$HcP%vu~8Hj*2vGyEQV_YG$qytxZvb?u5Fe!R<x=J0f0da16fFCR?^m=w(h
z1g|$10_#y{i8%KIv+)(RAOZY3PKkQOAWEl9byhlONRwYr8uD!?ZCB|Ff#y6%QYM<q
z3Uqc!dP<IL79XQ&KDmJN7x;)a7gLHs1^1{7M#RVQ<&h`KiDW(cwP%5P_6`6{dV|g;
zGqRj!PZ$Vl$+pzmI#F_D=or+pR-p?3*y^sEqxpTO0{E}XVN2^w^cI1R$Q7oE$ukxT
zc4Q1uJw`;e&FiwMnoAacIu!BSIyP#dGxKC~a03mwu2lYirVG?D@YzX8lp<4Zm@@(?
zINRLT?}k|)FnD8K+v-E0?Wnf`l!^vJ8B91Q7MbIcEo>jsg?pHr!gagVCBQ0RCyipY
zjMoB1K|^U`iOTTC$*A)k<sw<=#$&{)@sCAD?4%a4Z8@6a6;ReJ2~%bevbH-jM=3=K
zvp%Y|-;n=|oR%OxVs?si6nLs0f2u|fGZS^<Lz$@@ZE*Beckr*lr|X(0rH!UW^k;6b
zo9oD{yYCs4lPD(yS2cV_pQm_$Tv{^ZanSi&CR~~>Rr9wk`GR#dO3S@2BEeDLLy=SR
z;SNe=`XyNWaEtGF@w&fWW^K6`Hz(bWy?O5-Y@WK7dM2e>0zyS?b?Ahca1w@eW*uFy
z>ZO3ZIjrs%Ty9D<j%3qc2bRckpk+>bXO=x_8-TH+-`oA~3M0($G$Bp^vHN?`l9R}G
zY8#)w+#TA?BW;d(kLv@GbYi9@J~%3d5b%^tr}Rd=`iw52b~*f7$k)m>u6c)lx3p3C
zqzj#zlecaL<wzo^J-48{aWx4QT*9z6;YaIfCb(z)u>d{ZsWl~LT4S-!ioR{C-sJ5-
zlgiktg3N5fcZWT4Yd{@<lwdPI7@IE1lk40gg~A3bHQxFCF6>h1%_6xqS>#GqO`EV8
z*>x|~N8jz~eblFM$@{k0DJg5a7fQg8?_X@)!Tw8!MmieTt^9d4vUBcvm28;&Pze62
z0?v9lbQv1v^!+d{hPeWruX5LjwnjGGA|KoYq{;V}PY9-AUD!OpX=cZABB_2F;DP|d
zv-f~$xvZ@3Nc`AyhgB#sB+41|lHV}nB00Cfw6k*iGQKU;;@|3DS_t?q6TSYM{c=3N
zIrEOqdd;o2KM{kMMaC(`U&HvvA!<Hqz~U&FqFqp$pRx#UVa%@h7wOAI;iMmu!UUaq
zDM%@cGo#A;_;>{1tl}ucud7f6!fhLZ;SHzRmC7TIThHNwgFSMvD1NPk4jUp3+)lZU
zv_$cx!+SH+6eZm-hL&@3t3YSc74Z|tPv7N164E^5M>yF9TAXks`;|L2PZp-0@Zdg<
zQ3|W!<p^e(zFJklM&XDezQ}hzO4a@yVOt5ay_ZPgt04<O|Agg60R&sN8*IEaaM}z1
zjiZk~zRgXlbUUezO?QknxSD7TD@HrH@9l&QF<`%o3ri>8YX`pDEdP5K-+L5k={1P!
zDa5d+$mU*A6PMPoYszup5mzW?rNE1+-~0hj8nb=vA~WX5AY(#e4-)bKO`8icDhIGT
z@X56H;)V;jDt_Vp&@erd6mfG$oOZb06*Z<Uwi~4wnvP0`OkG$Ik&U2KZ*xI4sT;Ep
zrfM8*U%VMHM9pUuO7Iii59qy=KfFBn;O~rk*Oi(^?oSo`hqVhuv=d1UfmrfMaYY^Y
z)h^l+Z`vTt7Pk-?ogK}VGI~eg&NIW>5ca#@AY>Wfq<jz#mpwM#lp!Bgh11T?GpdZJ
zh$uRa>jY!<*^Y7irqKF%353|k_Y4$dI0e)-958fO!kjZnW)I4zt~^JmAg^}%(B(s=
zRS%BFsJV&MSjq7<ya_$edWO{KWZ}TgE-b|jiWp{0&LVGtYhu5EKr@s$+Anh;rUylR
zh$aHK@DwH&wym|UpB~_l=lUz525xq&6iSzF$v@e5s-TwqRDq%bcS;dxwoRL*uNHm;
zUU$pN2+Tw1YQ-QL6+c!JGDzsd3Hj<L2YYI5KKX(KH<DGs)^XZ~|BJ~0;nt)!3&CYJ
zMtMfTuH4O4g41|h4q`Nz?D$6`(Va_CWz7-5x(+E0o)(b3=pHX^2Z5bU5((pqnD;Q6
zBka&X*423jx!-q~sSbM%LCfdl*fT~-<6`;cBe~6raan4QI7l=R4upShlz>xwBOV_1
z^ATsC&SP~TLM4HW88(M)UylgSx5$$EhbdJUs~|Cg5T!uVjj`5@>ZdV$e-YwWb_5-O
z(i?7+YQLe1b*Y|3`wu1|C}EVclLzkz0Z|?K3xrXxt9I~Ym`taF6K9eJT*Eiohj<#{
zUDX=;mT4xISILWR;>|<2+FgOSdr{qxv<5*9d}9Ot?>bli6P))&9;mGO!887n<vFSK
z2?NDc#ykrN%Lg(__6}Xe$94xU{PJNyLQL{d`2&mDb!6ntdnR9Gc+j3<M)4%J)=q7`
z5i35NiJ4U)xw#QP$}(HqpBKYRhM&+nX4rdn)iBh~@(d!3t(dlgkE}E_2Gh)|vj9=3
zT8XfYvRk5UF9%&q?#Zt_v7?y%i!TaX1>y8?8zWJ+t%v1_796>@xjj**$i#pA?~j=b
zXT$)w5E_+VgBPJN-0<ko3eF6WwuJuQ$miE-iiAA%QP^7THUihBz7Q0(^}Ep&oL82H
zkrupgx`b$V9Q<Bj$UKX^Ifr_)fvT5?6osZM05xo<m(L$TpDFo$0KW~)FJ_|B&KB4T
ztwI*@>^Fg3>+Ojw@}Jwq$t)Q_7yP^eCW6Vuqu(A?IZF?GMPZ{+rfD~s_#(9Xer6nr
z2h_B{zPBP=Iq5vqAxD%AByAM>D7g?J9LijAkn|(Su|boI9Szy)C(`S6v`oGWU7*|y
ztgoMKHX}p?R!77MD*}>=jDS`M%*czfQiX2jZP5610&odbEi%i%<oN;s1C`BJ-<7_9
zjTAds;p%wEl6`YQCRP*_yqh{~uj)%U)Qa9l8o~r=E^%v)2dC>jT$4rOsCYX(N9-^p
ziE8tAlKKW#urB{js!-t$QMIxE^elD$4wh|S#HlUxi)J`3iz24ngxi)`U?+GSj4g90
z;O3K;7v==EG*ln+q{JQ&%g7p-6N~hR5Bkxf?!y<}r1_F#5;`h$e1H*q*6?!k4*Mr~
zV{`NvcuT^B*U`%1K!3=v9o*GLLRXOXnSF$~pasrAWod%feTlo%93PfVFR<l+`rU~_
z0Cb2t+D(a&9DN+q=1vBef;&;i^ycL<?&`|RRhr<7KyRWwpIHpBqV(1_^uni#qsiOl
zjj*J<h;AbzhVkiL&-U9Gk?zk@x8B+(?<j+W5aWh-Loy@Rero^CqgiPG=-zuP0P^Iq
z+mylRcKC+9x_0l-Y?eXH4eR)68djp`6Ab3<O8QGm6ULxl4F%lwXTekM*0A=MhcT<b
z;O}GmC6Fcm6#R7ny6<@<7SId+hF!~T{^Tg;*$qg^Qv7XZO`*L`v#`8jB9au3fCe@k
z13WS~sJDR-Tji{r4zNWz`q8UBt}l$tmxN}6hm`!#2PwGWgv=B|z51`YCLkuURo-A}
zy-pu8*|bccK1(pD8nsWVF6F<Uy=RdC!YHM~p*b0#wnIihG;J$2>?!B_mP>MRx)s?s
zJo5zLJGJYJ{)AMH-D_&UV8WZJ22~Z6HCNt{^e-dHiJs;{nR_+!_VpxP6I1j+IHmrj
z9;_I!-bNp~M;A(qNcAz)LQJaUKN=@kTBfys6cFJk9{+D&YM<E+scdo)anrzo%#!=*
zCah!O8s9|#nL1oYRq`htEOvA+fV{vAX&ctW{p*oS7W!0v^S%?TmrZ823Y2%*cVFAC
zDy3bZ+Cv^Tc@k$#B-+E4iP{v*k*V73k^Wjt^Zs64o7~A&zQ>jNu=j{ThzEr<Ymxw|
z@axwkcOpn?!ZD*GA(;ACZOA6KuHLT#?U=C%eJ2_KNyy~iKGwX|62hb+N6hH$cWCQ!
z%IpYXP(ts*e7d|Y3q){69DOsEks`=zGv?59a+X-337-~Ug>1XjhhE5bFM3XzKr|CY
zZrLx1?h2XTHqM$xo_<02K9-=Ps*X`v`})h6sWXT0yoX)))w69pJ%6J*zhDF%zqW|!
zLgg9&^gI$v&n4yD6fbj=2O76WJTCcg!mM;>IEoG_3IOMEo{G>{LUFZ~BRn09N&YTu
zxEh%Hi#;T-#KI4ZAc~-t1cXUe=#_+`>ewS&NCnxU(`3<qwhSB36r@a2j9b|A>WP9V
z157m!%FJEoFyTX?7Lgx;BnNnTEZU*t0uepH#g*)R0Z(UjLLX(WVSgpHmhHM(hAh#d
zP?l)$g#_dKCud{QQGt#n$pCm_mX_eU+ftHH@U$_zB7tDTS#r9?@gYli(-jn+hWouB
z>&S|NR4|eyB^WQEmUNHeMOx!tm|4A!PM58sZseAeDpE>>lBJ4EwROvBgAMEn`ItKZ
zwbQwbVK?@%H=<@{8i58r-z1$|2-=pH?hmH<%Ud{_mxDKxH}u~TQj?#R@_JR|vJ}<$
z3b!;i(qPrL${;et{<HoXlAz;R^h7JmMiR6(-X4NGOeLDs8>1c~4x0|;{b5LqEhi(R
zvg5LAs__bzU(bPm8gXc@u0`n5tSTS?;wqpNQBgy(;l2H&4)h`7k^fv)x9@YcpqP*e
z-iK%4ft{B02NG~j-Obk7-wlFo&WjjP4B<w<b*J%EP@^*y^z&h3X|Xa4OlV1dVZ&|K
zP9iKCm>*?az$8mIGzq}T_1`f@XB<v{&8*$`=^_K0zAs$9?44a}+^R#pjj-DT_$^cs
z!jc^_*0T)AaqxW>HBxHWtg>EZa64v>O>U9YjcyAhpJkq$GCIcj=SVmP6cZ)hF~+ls
zXpHg^c@N7l>*bv0Q|wocQ0>*>A?heibVHKz-*Ls2yk|$frJ_NL@7cSbR`v0mwDYtL
zAhZlomUI#yNbjclZxFu~bP)&vtgbRqWju8sIi5%cTXgS;6f^<76VPv#G1F^FH2_I*
zl7rYi&p|x&({3kVXj?u>f6^l89Ue$o2lvDx55!o(oLPmP2A#=)DqxtdSI*37b!Cl^
zQfs;y+u}SPcVc73=1)qry~QgI<)5<#H_wPm!@dV}P{NysDCyz`4w7`h-#TYMbUih}
zkVs~*-LXNtGZ1p)A}Wdrrvwt|;Ptb1vb~Q$5>jsLE>ZNK!{UaT&Vs9V%5;R_UlAC)
zyd|0(+l6w|vcnb5ly}vC=H-h}DUnC9#B4u+atJyv9hb?gYGU|IzqqMJXcx&16Mr7=
z^$)IFc0S%aJ~D!fWo^L#Xm3z#HtS5H#QGc#P@a#5p7hrzXv}S1$X5eFLFoQL=FXJS
zJiy^^bl(W{L>$^%Z&2S{?zpjWV-$_PI8Mz_l{VFs7k<cmSh$#e7+eMS(uzkKx3@Z@
z(VYWcQOvhkvkaE+ij8Q8AL9x#s|B=H$kU5@hP4AB&RRzNk5cpir^VNaBquQ5`^9)J
zpG`uerf&`U^yB%V2_%#s9Y*-nz(jtkgI}c^Ts!?W(vwyj^1z7cC--(l>^~3{I(OH4
zQBJ=#&`~)l7LuTGw;HcTHlSfd4WP|qC*b!;fHT-Zo!Po<mb|R?GOLBD?2~@@exYhO
zd?5^s45yB7tasf4y#4E~K7Fyn41!l<5nuTSPSt)ByFIe9kPrw-*s4-N`k^K_6oJXz
zqAP?{5R8e=TPL(8$z_96W3!Ho%&c%7s$voU!z9i~jH1t{6r4uJQ1}!r1DVF-t@Kqh
zKmm$4x!KK~V&-x6di{cL{&@$6Y9z5ZRx2pEz->NWMLZz^*(OD~hN-fbTYCh<X&$WG
zaa#e!vpxJcTT8l2i~s7vB((s{_8h7Z&(W<$f+>a0gvP*a5J_KEd4Cdb1dsy7QKy>4
zvWDhPmeLtg0m2#Yx#~YMR{vnQYqq$l!B(DHmp<>-Q5w`4kho-n@E2F!$sx>ZR%lLO
zCmDWl_r`tzb;>T?slVWf<{D-FCa`4nH%^Gt^^|7DiFMs;7a^NEk@Cq74WeU#*IwlC
zRqMS_B5dVrAoE62h+0sLPC&oz3;87yIIVK+=*Q0vnwqxU(G0=(=>ogjsVxRGn|1H}
z>{`%xt{lH9#z8U{u`NJK00z~aSM>J0{Lj3rSllxJywyl1hJN8NY=6yY1@2mO6Mbv+
zqZ6RHI5|qadwPj#(C*@H4#(Eb0>N<fWU}IOn8&Q5wT)kPbgTU{&w3gpd%FgG=++Gd
zVG|Ms-Q<)nf43JkNpz_%3S5PU@{?Ap$re^3NBvr}H~if$gQ0J}m#y;JxYSqKsu-4r
zZK!zwNDt5z8^nUa!{xsTvLV)K))VgtUA;R|EK+R>w3>>nq@|$vBuuoy@YXxUW8lmN
z#8o9CwK>|UR0}_%+lrUUN_4aNPKCtd4jD-x%o7kcdlQIC@R+<?*QpT*_?;lU*moD9
zGG^SZD~KUQwj}>nc*H+47QMl6Po09BU|o9vN_|U<mEWZ6#kd=3V6!#T)c0r6A5{0p
zQg5}%zS36bQ`8RR<)j}*vwBY0hRR!dV6%f(`<$J$^?iIDGBa*K%h|@$%6?~TNi(d0
za51rUsjTeg@Ta@xWZKQ<%6!EApm~0{aysI{Oe9@i?UZUuMj=}t8lk6lv!`A+F4_VB
ze$%1s``$v!)MKyFstfIHo#h*QHN#~htcnbnrr8!P#~jj+-g>MuF{Dft1G@Sda^FWN
zg7r1Vy^%oJw}Q|8*1-skaB)Qq61AFD*qdt#2~J|(H0bM8W2piYaj)B{Zx~@~X4#Fa
zBxdj*|13*0VrP-ZJ@tpqdP``-^$ZUH?<~48SXcCEQ`wuwlV)sBZLcpXf~BjQ-BFHM
zFY#KhZv1bGlk!EIX@S_qdkET0XD>DqsP>~S26#Q3T<b}E7ebY9ie2kzVwYeQzVQz|
zn+X6yu1IIB{Y134<AAg$L_HPH1gKU($Z;yuD85K@#@oCu+Br5sg3&13<L`KY?T6)D
zAb-ec_V2alau(6;g6@agG|j+zBO3GpT|v*m3QsRpdj`WmZ4h{LoUT6NDdkf>LD-vZ
zoxO&_*hq@V^JGjNDTbV<&Of4-ISCqOlS(H8SG%NmFM#Y}(Wir0qQq~0xz50uNUUjN
z6_yGbglk^|M8omlD>Y5mAjb@VPT6=zj<W*qI8IwF>$8Ol9{Ha2j8jUPY%r^EB4PqQ
z;7wxu&lhX@Qx)EzYf6a;>snBR$rs}orak@pRNRBYS~U-bf>;_@Dy-0st?@C@?o}u}
z*HiQ7s$j0-FUUE$%-nE%0Z(*O$dHqu;&~%2^B9ZB1c*f;CFlzKZ(~7#J+ik>8|T2D
zQO-OqSbii$VH$SS>{p;V7?<RX=O}!e?3N0ftEFwIyebtoH}y^E?!D{W*J=mY@nk3(
z9KlE02v`2HRHHDZa{D;Y(H3-z<mQ%&B(qXs1htAI*tna{A$F5sj7o<G&6i-mQaH#n
zLE}Vqg}jcoD|le8+CTo=#RcqbzbTC}W_<G>9x81My`o#uG>iNi{SFam6*5RA%@J+t
z4tE<&EN<=AM4=1LL?E3GO10!crlTu)($+JSocM}Gw#>ClE3xE`qUnhc*l9-ZNbTc<
zV!_#k)+Y28$OPduIYifF9~!<k$kYJRNNIA*q(*=uZTA<UBaQ<gxyX_SRpf%!^IuA$
zkp&GCCn(kyiu4XLsKb3oqhJoqK=-lpg_Q29=tBv!6yj;=JmL>?<>HAL^-KQxM%Jig
z29Kz_)o^f_9s9t?;+E|_WB!%h#qM#BusqmmyYTOIBf7qv?-|Z#;Gk$-?Uxv?uWvTA
zDv0sS8_b9bjtw_}8dU=ttC(@Qpw?-^Lc(RVz<nY%j?YF=jcK$>AOdSE=KtCeI(sr$
zJKx&!YIre(uwxpRNEo~>lQpM$K1D`6td*+Ryt;M|(p3wXh-{Mx<wa`8F{cHTPUP0}
zB`3bXg>9Cj92VR#TAgasnP8{>2J_;=d!3f@6QfAfdq)9w`kMW!GwyuqQaEGJP1H1q
zSy#%4NLyV7q#Rlb8fK*HBD!O8Pr|#h`~<ACOKx)9Vu~5csw%hfFHYNn_<`+N5z0Zb
zR@%7uxw^S(papFsKBhPs*%YL7u@%9*yZhSY&>k$3&fT7t)!~j#byc;ld%CJSpeMCH
zQ_|Hc#)knd*`;EZ?*vR1o;bDDs3MMz+3Q6#wF%~gCWJKX)TIU<(lP7zFwmN&oD5xL
zYP+t9TlyS-bZY26w%u@h3#pRXb~^r~ff-}Y?L<h~&gB*d_?dE^H5w~~pw~@dDQ!WS
zgNVwG7=-+`@GsB_L8FWa_$Xj427%*8kK}cwb94ZhTWk$lOn;Diy3DCXu$nTlHzv)r
z^cqeYwnp*pL>T}3nZFSXcc+20p6fLte{>{<wrw<<d%}&^N|DgzZp%d||E~SZD3Qif
zw*Hx6YucSg!_L4}cp}5XV!DeYNo2~(Bx^$im98{ZQ%#tMsMeZAt1fe|Wq?tYLc#Ue
zn>HB$9zb53Gbbp0styl*boXz}Yv5#%b}HTR1CC-BHI8401s=(aL@8Mq7RgNET!*v=
z_cdP0JZkMq@5UbN%=oF>Gw_KQSE^Xs!Rl+$>p>&r0MY*n+rw=IAG=X{)_c(fwZk5u
z@^cl~{jGnPc-q~6_xTTq^B8!CPy;v&ECpmg8oUm{ba6)}bXTV`4jq*p+Wr7PTD4@z
ztv=te@9JcK&+)ConbhXs;`MOw@N7M;IGnac`e^R&@bg~x+dbWswCcL;cko?i{e#N+
z_Pks8+Q0q1c#}1&8{ShRC(o8vU+=t8Fk9o}>j6F3@JxxEw7qTMe)D*Q=I`nTeFhYJ
z@c~Kk@n3kq@3Hr6e1??IQdWM{dwm;1hb8N7-UL4$e&21w4}R}GT$n#fp2Keh^6|lp
zx{jH>zb!YiN&%<VS4XT;m83BDL(Kr`YV8adwNPsUL;fs~#6XEJ?X_vbPDppfzogzg
zlR(onw;v_Is-oBCE>5njc1pE5y8viQQZ|X9reezEezyE-zTvkc_s5st5p&FK%{nM8
zZY^%~Y7(IGd~C|QTE#9CF^IF3UnHmEp%)<%_oHrJgXXgQhC&4oU@!RnglW<3m;V$I
z6?9VynktSs7W9XEu*8m@!&Iw(6>oM0n^{S8f+;nKb&>}xfG#Mv%>J4+ngH~Z9Ht#n
zYiFV@n3ohN;xII>U*VIyt>&NYn%1+EhSMhCZzly1;5O~@l=*@3k)7X=W3fTxYG`#U
zb*!nL>{Y*kMbRqd3uxAcFrMSLfOT1@iK{9y^Nm{|4M~c|PMhk^Tg{&RXs)*L67KqW
zXz|{digVztv#!8TBq!$H%>iodyH4eep<eJ8UL|&vl{NG=Q#mDlg)4epT|6u^?ene`
zkZI%&j{=n)Dt;d({^jCpfj?(jm7oZ04>4VK2K9nD;=~FmzDitbAw%?9?GQb;gZdZf
zn1GZ-f;I0T&rx75G0)iGU|g|n9H}gK=(OA~(4x{Jlf6-hl0Ha6CI`SKZ&eql^~tax
zQWwJp(){GocGJ7uTM*Y*Ry)w*7+ECyOO>#n2jNbLnrtgM+_W;;KfkmQjQSI_fj38I
z%Zt;QNV<>NB)uXi*AmCksg#woZUq^eCXu#7!jZkusNr9QRUWG!EgXIiYX0dS!O)N(
z;@XRaF-g|=l4Nt==>qutvy<|Qi{*GZt#@{;!T4p;=+I42*T1X~1%KFnq1D%;jMF6y
zK)7}Cn;V%Of=f5Qnp~TPnpBqXxEfp-)@<hEZ<yRsl55qH`d;K?HyaJwYY{Xw%|iDw
z9QK~FjSOIFaHz4P?BGx~Cwou1FuZtM{E-J&sX3s#YQ#kQ*aH+R)&mP}vE;bNvbPlx
zHA3|G+N;%Tsxwtd2Ex@2g}<5+!!=yR$?uWzDCmS#J|6BMzA%#pH|rIM8y{(Iyx4r;
zh8(~yxvJ@v2UOF0s}zCtXV8Ny!A^9P-ZLTGX7h{=C;C(N2%c??^s00W>yvL_zbAN&
z^m*v(gSR@w90NRjp^Jm$xjqmg*}Hh(_(5FD=|_R+Fz#GHD|v%IvWn4P&Z)kJ6kT*U
z`E;sRqAKL{sw<`513e2?8aY9R7idqxJPM`{t^f12GXCqdC^;lslEzRl0W_5{KiWgx
zD}y71OpG8|+(B{_Ht<}5mj{{6xN&zV-(NAD5ZufIz^y44lVYUM;nE9J$2xCah{t3a
zz`-4ek0QI#9mgn%J*C6IoM2Q0D<y{@RMSNAQ=tfcA+OM0tW<n+8(&A;p9jhDPh3^V
zwh9ojsf<}3=S-?o&Y6jQSpE|Jw!AKn-QPC<(3Ux2n4Jp2GQJiVA$Y{xw`+ylE10E(
z7k&G1fSpkdj1;hF{BWU3|9F^yHZshwa58pB9T4Y2jTyh$RAN)~0PaG=P}^r;s>Z%$
zJ0vAI`0ybva;%n}%4vQoHSCd9jpU)-KNd%Epr4Tgm{$vk_T(*yYISJ}IQ%2AzUbge
zfBbaM`=8-x>#9LeBH`@Ivap7I0d&J5TtL7XfLM2dxfc5cyx$_XySPES$jug=jt@7d
zlToixq52~J61H$iw)vEXm6veCu29l1xkF&w;<6f|mB=Pp)+IS90kap9x84FVaTM**
zjY*0fvSC2I#=3%z46}_GR~!^K%hg4NhmKkp8PZD?2u)#rvV0$oteI*eJ)YRpw!~F2
zfZZiEJ>C!N0=MxEgs;SBC%$>+c~0L&2RV@dE-}MENa@4Kfr#T7<Y^xCis4KXCdix+
zjg+1IpHtM8tpM&{KVk*WKP4(SEj^wazz;*xCeXmeuW3TDECo}mA(AEJAW(cz6Ao>D
ziT+RRNX*V{Rstq`01_Mx25$E0L>n`9z#7*rE<c8ry6YUpPvMi%5F1&;DPm*cG9RgV
zcfp33{C!;;J_^ARUv<B-C^*9!(i(Eh-zTqRiz*SQSr};>IpQf_U@4ECu1NA>6yMDf
zvhTm#1ATL%!+$w*+u&3-4S@t^Jb9Tq7>fg-yy!X^P{*qflH{w^!V4+tpJ&%A0R|4F
zth&&%SuGzva{(LZc2+Ru0-&F$pAUa4ytvMC)Q+b{Vz50X4syqXU4jf(%pWP2$6R4B
zkPwFe>a;0Eu*CKsoO@a|8NveEcjjhXiCd(dl+C8%I;7CI9HwyW#wF-FwqL;Z!Z%eL
zJ1Lhp<FbvO5dO|eI&k*nbcY)C0K1BN6vI*1N;{jOQy}Mll|S^9JgU=-grt7WL7Fr`
z_+x<}<?zVPA|*}X!As$*xKWV6m2Gm1%9i<>^q?6hg<E&GRta`INO7;6$xBVDM240X
zdk8U<0~|A@IAi`MD^A$UQ;_qw*$SBD?r@N-%fXXP@EG{uUa=EK+ceY{0DHFe5Wh4F
z%><QCy9G=gWv`1!yFreN{KsZDNvUJ0glfy!7a434--mL#=W3!}BozaRkuvFPE(WWL
zy<qu9Kwzo;77N*#lf3<0++RXl*2V{{LQltPW-yj@i0q|-nOK^g00AuS6wvPRphgZ7
z^;Qh6aZ_$8ajdHJ6J{TN0QGGe7sB!%!u9pH%j*g26&*^EF!Nih6~wGGV4aDIQ4Zd-
zg}v^)?D!j67cXmeSE{nSaLYRD<R}+y@UH=C#w$1*D5-fR?GO|eHg~_p!C;7X`-xjI
z2)s4b#=^?R#r^X@MK9?VZZ5eSO2kUTnhv7nfrr5oPcyrmlYW%}z`+`3Sl0sK-I7(>
z>-evHYJWplEjvTaU&!%_93(N7Z4UK45F&5kB4l&X*3zJuXldqsjs_D0ASbsjI8Q-m
z49Y+B?dZ6D5Zvl0aZyu;NmwJr{S-a%Rp>F7X56^6on9*@g_Dx4PM%TZn0d^yW{CoS
zvF|sk%4z5dJZx)`05`LwWFQT?`E0cNPLO#a6)T$sd*<X;S7F&9rxd>}Hb^BPht3W;
zB1i`JDhGeA!FT3?aH`Pq?ZPa#o|H~NYsQ!1ps3wl*I-hVneW%tpwzP>sRgWt&FT>+
zS3D3oyXH{<zmLVI1)+(VD`AM;U5s)JI8^!Bv6lW7bgDF#04<A}5MV3FwkRW#J+n}_
zUxfw!@_26G*S5pxCq+0?<B&9Frx@FB%G4TI^v_>HS9Vyd<`3%nH3HT4&(d=kX{<2d
zHmD*#-zX#jHJY0%k7@$;JLN|@1%N(#PC<T12Jg6bn&8uhs&wBy9G^i*3-^jAO~as)
z=dvFjMQXKCKxe@~N*&W~ryUFMl|ip$0jb|X41Z!}4ao#kl^VtkAgD9Uy8o-Sd+~3c
z4(FC<6iq7AG_4bxRshsL`uQu)-@v#GQIucCcku8=8cY{o43P=gGK0y;v)<D0zbzSk
z$5AW2cTC0v{jka>BF~lN3JVUg-|ty8P16W@W|}cy0l>!KJM!+CBZ>MRf#Bx0LWsfI
zBTm>W3WMC=5A7$RNN^akv)>1IF@mR82T4#=Sfi^@?{y>bYKY+4YIyaSv7XVdLX%=A
zSi?9@wam7EU)$dasR<PuSFs!fK;|V=ELTEx_8Y7e#ka~to78M*HPxQDYJ!Z4t&Onh
zvEew*0RxMtEIryrF;rL@gDfBF1_FD6I^|m+QhkykFTR3Y?rD^MrezZ+kn#S^UxOni
zAb!j*x1=^7d+L-nlSZS1tNZ{aPL0qD;`qe1xo>kvqNe4zB(NBPbk6UT4WHl=vceB0
z4FwoM7tCB!od@#w?DI)~*=`5OL=3*+5|k)TfJakRAoKkn?zBt|t^v<5EZj&k5yYrJ
z7}V&*chZ@X9DOBFW^4J$){)9&AS0JXktl!o>rC|1oYvBJW{7RSBL)9~(GXwr*kf$S
zhn^@ZQ>0=hwWCpQ?@0xFTk@Z21Wc#onLf|<dRJjj2)v_(BIRA^__G<xv@d_$7yRJ)
z0Kpsu)*v2dZMjkeO#Qc#MBwk#l0iK;1C4{N+cTs)Jgmdy7ZhNrG5+^w;ZgqP4fjbI
z6#MP-=HldFG$g5D5hv%TuP>TLpA|PHAvzfsqVOD8RKqFJCpDOe%+mK5cim@2V+oQ|
zelSXtDn`z7si?8#{WWNaY+#r&;11C^0N&-lOk(UWiaeK7wWOEidLw5Ml)p~<LtI~L
zSQ5P(-j`u$4<g*6qy~R<ja9%UH72kbWba!C8(-w}ko1<wl@d8Ef*ZI&YPgU=Ufi)}
z$?#w~voVo>yPCXYIi1%Rh;4eS&a>qLRF+v=ftD<h81E|j0$Al%>E?K?de33x0iLO5
z*Zo|TK&(0q?I<seUHdJlaW+n~CqV;O14Gi=_P-}Uu4id}MZ;=QOW-l=8`>I2uH3H(
z%xwP-GPzmT27@Fa)uW-=e+l_sYNOraROL9vF)zLG!15jvfYZimjx<4BU$g$W-GM-E
zi(aPzg?HudZw0`)rc)|dA(zfV0N7XethxGGZ(Qt(Z7kxqSOWFX?s_xdI>M>#4$SE7
z$o?*Va={(ah$hc{?gL2S-StKz*O^x1&)^y9Idactmq&5&zO@6x#j`xO47A%tsbbd{
zAxMHvDJ#;5o33>klPLQQBX*Mpn+Up0lB8A{XM6`4R`yz1vaLuDL?x0R09KI!>CvG}
z)C|%|Ku0kJ`ipdOseJ=?DH6<7kf@T1Kxz!L6d_1<#mE@fT*G3Xi!{UTW4`XVri|QS
zUTJ$a7C7)k$h+k8Es8C7Ur;u!0Xx=)AAO70AdBrm(YF%h*}Kvc13}yW&=YykyNAxy
z)_IwhRw%wGiKB*5?&BuHfQe_Uw&;$cx7F@*vna)&cQd>gMS?^~(}Zm#(|x!#E?7HR
zRz!aFRl7Hx$vn5@+TKvLd)dp^-IC<z4xde*<d^Du^AYO;@GlPzL@h{fk=K^6q+-q5
zQC}Q%2lyz3(N-u+9~O-mn^h&59epoYoMWK_C+fUEh>vZXEl=W~fIyHe>7!F;lqMF4
z$JhhVk2v5WfxQXRk#Gox4EnlW;F~GJz9u2Z5`HAqAw($aG?QwgBHIrINJ=>V^tgjM
zAqiMJkK$t`k&dR35MfQ4Q|9vBe;952yvd_m^%WThLnm>oH6f!>6PVth*8FI@qDLC!
zCSOSAmg(Y==^%h5;1%&JLliu*r6(m_dv8rm8yz>DiWWZkGmgqwHYHtsIcv+7Dnm~M
zI=4(`5_pAkxb&v2{`Z!@k#mnCz<CL?><sE^EbMQFr;tM^+2V%NrpEj<FNr!y5%7Iz
z-uc-PtXr(6nnj+%>P}ROq5WaiAWZu(m-QLd=}Lo=V1?8^090nKSXboj<VR5zw2wxj
z$Ou<?^tX5EA^c6pC$JbDx0{GZ)LJ!v6g96q%921ORHPzKp{j7wnB1&vtsPfIqlnO+
zzHJRmJh;v&>8Rr`9Oo)gvFMmc4>$)~q(X@a%<WAei4|D~+o;B&hB4%*W!FG#8C3<3
zVKUd0rdApzz=co>a6Os!%Ca?ii;GY87mMqKK}`<3?`jqhHi}e(0kydisA7Q?s^eTj
zW`3=u9z8P>h{35STC8X!QT8;Ae^YC<PO8f8v05%}y&gDN_`d|&#))+Dv8`}^9y_|y
zFuc`F^M$ci4hw3XUYKaWrE}hX93-o-US#TYC>JUbz}J}`^G!x;Xr{hOQN0fHG5CnX
zqZ9<vw!l6^fh4YA(imE^VL`3<Em69fjeXRT7=tko$_|aE)Gr--3N&}0lED!i%OJ%O
zH361we+}1|Tck!i2)*&pv4jgw-5%HvPsrujIMzgENWJKc3+0Zy+`D8@qBUFou?~P1
zzoMWI(0|zeE9Cw*w7z_v$BolOzv~R{LvO``Ivr!;R?43{f@dCYWpymv|2ud{$Fj%*
zZ%h6>W(z-UNp@Uo=@La4>4jswsh*fu!9f$}k}If_`*1`R=-q(?1#df<h1PQI<*RXp
zz1l3)tHKzuHT==^PmP2P(e1r5;}L*9xC-h7pxM}Z9<c4N7i&e+SNTcQct$40;f3@3
z8k>|-7z08gTWW<1E>Sv}<>W)s6OL4nB_q<hoCAuC3F`?4ljWCnM2Tx}Q8HmPahzn&
z)&(aWa+<;L^GvzUR>tfW@%e?9@_{6z%CSJHciObb*W0m%p-$EuJoXUUmu95&F@QAz
zh{pS4A#->zvo|yv;iwWHHSACFIZsvX9z#KvCZ%^|6yg4BPqF^7dg7*o`(=v*7-N~Y
zT^Ik4z8vKPryqXd6J<cfSn+h;FN6nRs79wO-8!Di0}PL=DnJmeAb5AqdEp5Kpfkp|
z)oj6?$0P+>H+>1yfJix=8voGAxPrn0(B5U)r4|+eUBSMFVo}mn#F*?um8?S89eUNL
zhzeY4a9KBkzVH43HNK<aDcsJwSf-jolFER{M8`4p9{lwy>H*i@Z0ID;W^|Vr`8$S_
z&G*yi4mbHv{w}Bas#c1nUrKZZA8`igdSNb2LMHk2o@CS5y|`~AU_agm>GaVaa1Uxn
z^qa|ri`Dxljf)lOiTq;e&QhiHCFPXv=LhVMGzcgP5D*Xq5N?>a<}~_EViYhCkTfU|
z5b3{JCr2ZCRTpb316x@W8#_l2L2GL}BLinUM|v4aVNp3HQ95ULXB|a7yA1{ez-%eU
z{gNc+C6#RAiz$*)6{*8f8WSEs*f6XVp>WOb@3kAcd8M3?P*3M>Zzsvk6W4|?`d<D!
zuzc(;z}Lsq`|q!+?j>O(%`qEhE{W-3wvkbS5L39STLWMZjA-`5;ig9ls%iJ89W8dh
z=ehLxE8TsD6=4P&n2&i3doS}2Po6Z4fIv_8;6zMb;4Qi(*Sf)9mgaK+#h}D|VXWJi
zea%?#P_43Vx9IA4c+J(USW^fWg6{6?=+MwP%rq6Zp{q%fg^Z5aE1-X`$^FYAGua^R
z@P#&E#Nga4U+tvucGo+2*E;@ttz(D@IlN>9xr{hER<BQXCF-S*HLX37`OPBT+`nl&
zsn|>jP)^=X#O_LNiH++3XI>M3_iZx>FUd8{+iJ&@jyKv5Pf1q9KOQ;qiqaXX2a{zZ
z0J6wsLWf?fuQyWjSnN$HNbh<IMfEDTTf;IMwz>U#z?$6}c_3MQHJ*0wH6tIlQ$7Y|
zR-s{1b`D|*ufO2!F7f1Sv!1?V!}X$c9m<Xr?a~eis3?-X5h>*X1|wA7vxaLB-3eB(
z9Qo?`tpurk5wxFZqF5k5N>sWk1S%vCOvpG^1riM|R1s$C1T}G3O!3gsMgJ~YcgjI)
z!)Q*aH1-o|MaZ7mVp4?AhuV{%Fp^{};;WcT^0X@zRdJ4$ifBdZmCFX4bk8{RXwdw7
z_n<3KCz%!^*08Pt)JzcJG_6uRwJcS}DULLB9GXUvQM*kHDhZ77qj3#cypNEi@uH$E
zu8qGlQA?4|89zxi#{wKl8s?yK8Ap`=;&vdS#`;q#%!{Q+oj8bmhy-OxAgJA8LtkU@
zWrK>Jb=SOc6BcEej0L|^@@?DUeS!Q}(<IT}0L_0o2KuMz|1_e1{r@fMf9X$a7h@B8
z5TO4qLH=)B%(C+*a}fgru@FH6G5o()aJAC2F|pAzu(tkp|3qhg)$OH+t(L&>$)8&=
z{fQ^u5DdeSI4*Rhff-Z{3!#eS+90VrF9G|cu4uK4l$L()`|_&1+^(ld+ZV%Z#6K%%
z{oKA%u2g#Se6_yOXg06Q)}39Ps`gmMR3^5WsRdYH+u8bdTEfsBO%!B`idpEViF`@C
zbdEb}E@K5?E)|ZLqZpL(WRQ9=b;^afuwg{GB}|Q2<dm+HNIjlWrIVhv&L7j{OeGr7
zcBGL?Ch3R-R=T^UFBN#84JU4zXG}S+5OU{^o|9y2i#f39Uk2Q(AHJhvQ_j+zu;0@d
zT!$)Tovsr^ugA?ZVAG6@8{^FyOhh^-9VwXjCW`<rb#{!pBOYNA-9bT05+V2^Yv*OT
zdjFxO*T%e4;Plh5tXME;L+X(3J(6OS_#mB2w+G#=&qQZhfT3$d53SR5`vAyWyUq@L
zQje9IEHVa9kHcACX@jwW#=zZcwmBw^6!Kzi9BdL3Y<`)lRzs!?^C*7Yr+X9oshO45
z);9q1VHF)3Q)D)Wfb9@W5d4{sR%3=xy}VITHY^kNx=}$k%#ylh@6cSsSfAM0#!Jvv
z(Kp8N6YJ$B6pr|EE{ku<-Uv*?EOH!g>j!7x!v0!AGiG%$KC`#DkwWu~X?tC-QQ%BZ
zy9|Zbx4hSyc?+>>TjvE%-^~rX8}Z9%x(~psC#~n|MK>qkwP=-S>HN(X4lce(^vmpg
zZ1syTt>w4#f`x16yu)uXE8J|HmW-=YRj=DS=iX&s+-^gi&C%|&I+vx3dIzsj4s!hJ
z<*NaA@#&cz?3dY*$`ymkS0~sJF7xLNhKGI!a!V2NXt~;EH_x>*5%SXP#6#OeT0=l?
z^p<TiJePIBi9+LcrMR`}i_wzz<Tt9zE(;vI0T)KC!^F$Hf3ld@C^^5IX6^1%0sCm^
zhwRH?C7G7~;j%$uiP7dJw{=sD<-G4<*?mWNcg(s#o3y#)Wz<f$#Xv2CRp8f8x9(*d
zEcOPs?JL(+E^EuKocxRL>IIvXLLp%B0@xgmYgD{V1&IFAIqI;k=9&x^G>=_AjMX2I
z>ze5}W!}5aVLVuWXt_xqQQGxV`eeu?Lsu{|@B4Foz8@Ry`cvlNy!GBb+vn7^sxN)j
ztMP$sl^~ZuTD_9P>w)yeWvXn9rAIcuIeg~B6CRV`z}5*?kqmp_!KS74u@Cq>)^ZI8
za?4$9z0~68;Rdv~yy!PE{B>z?l~D8kho}JixnY_>kA1Kv|7*fE83OH!=n!oUSt~CW
zTRMK!I<f4{H|>_g+nGhj^djsN7oDp!V&p2$?w)J5+EyIRXlp@?rsb(xUH!!*U80dQ
zV^GUr$pvWSSOqspvUZ3udH_JO!!15)@EE-|Fk-sC0;X~i`yh0Yw3k^y)ennI6gCY!
zvlnR1NRAy-XxDgv#?MmmI<EsiTPJXSw0bjQ#Z_>QT$m(HuMRRn>QD8#%ueftPwNot
zQ%Ye{=8pqp{rJV^#h$2%aUmLibczCBeZ)jfonC(NeK|5s#<d-fdjlB1svmNhLliU{
zzms}i@4Zx>EM*n*gwJ;!aC2<S=LKFaNjzH8ezB4eymQaGSN2${u(C6?O{|5>(tSAR
ze7#?@AUb88RDt0yuh#VXfo~+NEit=d3FMVlDKP~CbfOL>yUdd?Z&y=&{;r9`ZGAGB
z%%Xa^mZ^buLy60{{|0=Cvu^DW<u<ZM!m~{`DD3NlSkw6qoH&+!8K=R;LH_}w!?C8|
zGAB>a5+B%%Jv>ixNv$+3^5?Bc^ydp*Z-SRM(QApX<SCe)^o;!J0LcO>o;bZ~iLxa&
zA7PWp{vwube(|xK&Ci1)!~^=xpn0SgMt^>kLHHi$PgcijJ_}&uNS|$p2V)4iY@Gw=
zD0W`p*Mp%)_MrXoil4G|c)dC<mG=g>YyJLtc=1`u`6)q@U5wS|h~b02j(PiyQzi$D
zdelA7mantSGIPH7>~&$7uZ=3s^5x0k4wncIjJ)0BBWB=Lr30NY{?*+n6_<QKLwakj
zi#V&!UZs`mVg&e5T-uB4PQI7vM8B#{U61lNoeIS=i0t`H?=U<C87a0KdW??Z_4Hry
z**p5U?}E2!s@eA7amT+%92Bp<_Z{Id5XrO8C2Vo%a0NOzjf57f7veRuKUx~%vL2C|
zI*@+<<T&FoYYqJ$07yW$zdc(5mTmS@G08ytqA-sC(4SD7zWPZXf5m@w8Lu>4jHhm|
zzcDtx51*_Bs$=WN6Lz#>nK)iUo#_JJNOo&uKD5>kKK0>K)zfbhk0lA$`ryyjQm)h4
zd=ZcOlGCt3dA_*3v@e$=eRL&K-z)3y8G3M!n7o)u(i!MGrbZgUn9UYbVpWoPGFU$Q
zK=$a%9_mgd@q0B;e{_+=^TjM#vZfL1WR9glFJm$fL)mG{w$1pTY`Ug>r2f-*&b~|}
zGBVbU-Ancm2#Uq0H(U1^2ib>aa`Eh9UXrW_4;drIi|HtfhyLC<HKrGh8ftt-JUmwy
z*6KOqUlrB~-WhO_Ps)b&_l|jEMBKh?EC)LVcoA)ka|wBCe-HvHYt+X^RUM}6HMmGG
z7c+J5e>uqz_9#trdBJ|EsaK!Anh&&MXs)tcvPkl>c*%CG7;DbPfIMOKMYfpz9f0Y%
zs`8UL##Ite#XzXB;634YF+KiXB__N1fw2iF2IY$>2;-dBHc7zy{`;$$mwB?ACX@Jl
zr06c|1IuFPe>!C7ntKLLK1eokI!l3a-+Efb<DnR8kbzEVB6<bZ%7$gQz{nOK`zD<{
z-_{Y~lH?Fz4{|1A5JKbx%ia}Wag@gw$y~5l{`UPjHtkbWeiU4=L^T#;t(d&UP%}MG
zN9nTBu4PX~_J@6=rx={rG&r$Qe9JDwO+14R`I3=kf44q%>x*uD*hZL72#lydQ926&
z>;or^$jflNN`}S531W(jjO@c?#$VZEjiMz9nD{<KB)8fR3u}DNgxQM-B-Lb;zyl9L
z`3OY>uJtmz;0cZ62}22JE!0r#uS_IjHwdSxMM*wQ2CNq&yMKB+j-_NAWvEfByURrI
z2*rbTe_zThQ8llj)>8e;T`i|rgyuEQ5#_Zg9kWJxeeDRS(mCU32T?X*M{=I9Q{RcM
z$MGJ++<Ec}J5;JQ^-~MFR;r#&ab6&L%m1r*f->70Crr$rr1==u{VU*t!&@-ySs*VB
z?b%zLcp2C=e7+cevq3r`Chjg~(=1oIT+s`!e;_=SY_aU&<Y4mb40y6U>MGXHyP^42
zJdaR9VHAA^R0x^5g;Zb4jew?G3Ay+{)wuYB%IJ&5XoNhW=!tI-BUm^f{4+wfk?nLG
zGyDSOkymB1Ly%NFWqs|*vo%zzfljU8A558$2miN5G%;G=TaW&+_NQbrOfRrq^oWD8
zf5P=@Z~9gCJE?G^A4uWE^-lGxmw~QF4WX8M+w62($8CDFp^<F!qxja}>VGSkdDe!j
z_S`X|t<BAEH#awFsALox?0MP2o|hPGyX;`wB?j9nJJ^;sSe}&Zw5dAbndnC&mecPy
z+WVd3)_%WVjUGSNm)Sn<pLC9U$Gx9Vf0|wV2-9?Xjb3X{%yw|vMs05w=ixYXa?tKy
zzki*~TN6;_50aBvHfXR%KJxy$>+MS{i`mos&EN0j>XwnScqH3Sli3_>3x!|Hj78+S
zctpF6XI%a~@TQUdgQo`w+_JU$ho|LHJe3XQ-#zV4Cu6Op_AlS;pawcZJrT9(f5ekZ
z+<oASXN;CqAbAHW`s^9)RXQ2c%Otm8{}kwjkC)L&`^Ap~`lwuqO60!qtA8wQGIyxJ
zN6$$5+Z>ty^t9dw%Vl;en;ZWQj*hE|jDLm47LE0P`bHiPK~bs}uK#;iJ_sIS_VR^6
z1Xnqy?c#&l-VKfzIFRka;|h&ue<SF&2WgA?YSV4Is9Ug$V*0dQhKTXe>G_DBJu7ia
zX4}wXQ}CYPXX_2}FctgF{nlQi*W4F&K7+Mj1N``=(+5Q_m-J@FLDC%1Bq+VwudHvv
zXlu#S?ClhMnvD&<YPI*dDRbM|*g3-jzO!xb#Cq?gt27#yTOGHtzB=81f8FdE%WMAB
z6EG*n7JyyR4rIzvPDt)k4JZHk&tmlQb4|u#mhRSU?cFZJ-hD1YFs6Jf0#&*My-$M?
z(LeDHlHP=gB7kx1c>{3(Wfm@zZPmAhju2d7gsj3?`*aSTF)@>V8N2Qx#Oc97v%^s8
zZELUDZ|v`b2ZM_l-sKg+e|1|Yt_E88CR~n8-d-z#SwkVA{BZ$nf{w#B3_X78C!N-D
zr`7v8gtCURDS$a*jIx*}+pmmk;IP2<3q13;_l5urc+_aMd(C#Ez1RHKK^=WI?|$qN
zmIA=(a32W#`Jo~3=OPIFxy*+Cyeb6#?1w-h2rQlDy`jLcz1e9ue-1f%IzX`I^KQ!;
zV<{Ny_ABFoS8@B$py<DAwV%6>tzT(eVw*JHs=(pBia`X*p*)Gk@nDwa<i^O}7*G*`
zQysb&4wStD6<`s24A7e|2Cutef<9d5$weldCokAGqglcpCOm@MDL5ET;d!2cPvz*g
z9`(S%Zyeu(Gv6Xle=ZgyP({H&$p`e=<2pKRW;jI9Sf^;8XZwxfJc^?{nZ~$Yu1u{*
z%@6T-I!eIR&;ZXKW1SccZAMX_J!^vz=v*tq(THZO`kNnjd!Xck_R^6|A8gG&1o=Tg
z-08%I4D^C8z7s-NfoGV0KGQbCr)VmyOLQ`mD4uga&<J(Pe;2m`l!U}EE)%g917sUe
z;dqmhQzc?QxLaMPG4`Mt23L%j)s1}sqP6$CeTLWFUgvbr-H+3va{a!G(^gm5VcEUG
zP>emgWUYjvbT(ti#r}3nqrkZ71^oa{tYA5qEJmZc=8wup;8>YWz>yffZQxh1UBl?{
z1nqwjVBI(Ye@y2Nzwzu6)u#**^Esd^!dLEsNXlTuW*>$}Wt8Du4M_*J@>pUN{5v0m
zZs9nICjuWBN4ZD{Uh!N_4C6&yKhEa*AZ-?45v)fCz>m@eqn2>mhs}1sb-+ZeUcY^M
zcvx9~`@UEn+}R-#_$G;`d)Z<#U$550#DEHHnK@26e_4o~@J9;_jqKWA$LS~r-wqBb
zPQaDlHjRdegUGKNRnSI(mXA5MFp=BZjDy<tW*OQTI1NVu?cgK2)DmKAFABp&hG6|R
z!#~`EMcQ!Dd!u-AS;yO&Bs-Dtu^iyfqtW%ap3N?w4YNW1tRZei2mI?2#&e)Q<ew&d
zd}DWFe^ugb;!1oNw%_-@Dsmrk!AqVYa|-9(k?`RF48tdzz!p9kcxZSNI>w=wf{xgQ
zSne|57&AD)X<abVG}#!Y`81w0$_wam#U53NIsm#gOQzriJVBqtTv5n5z~}}p=_I;L
zukmi;Z-fMB;f<85Pww3{`%AmO-|C(;dV6nle<ab=FNY`JeG9r5CJ4$O8K3dpxA;><
zHT>}XcYSKg#P&z(_txRb^KJOq9OJ0}6CXo0O=I(?2%5DTPP;gs4X)f}^{3fQGMf(Y
zOW|QS8}}X6vJ(wJ&(VK4SMlEu?4gbO$j34&vohF0UDyS#q}6`iXVMhwvhNUiUn9nU
zf2*7Nuzx<qfb;@JATo9i8hg#PPczK}4+yL7CY<L7J3P80kYm}9F+ihuK)wkn1!L7B
zbXJ3wj0Z?Y*%ZHWgMA()^~*YbW!%hlGD+d%MK;3Fs}wy%fU#`tHx(1mM+UZideq-<
z?j1Hd4Khzc=*QZxO!k>)w!g^QfBpllf8x&|ZU=nZX+|`B3{8)Y`WkRzFipaE8-p()
zLkaYMmCp0Ee;`s~ya{&|kPHk;S?pyb?~q*1ggyZ&=jegOWzT4SI~iQfvPt@P3Zy^@
zbaY#b@+`W|7SVXYxYf%=j1hE+;*gnC#s@?IXUL|b-xA{%nS77}vpF+|7XmJ8e}8@p
zqu1AP6Q|tgg1zzJ`j0GjI)PO)(UY-+=!L)@X13lz4BmIrTVc%J?GOCzgAKu|>NqBY
zcf{FG6`-@%X*POIDF`3_-0%L}-h0zIZnyrYx!-@)>P0W2%@1VQ-rTC$AZ~(t8Ji9r
zD$xBUtlU@H0=~;0dc3pk-DI=(e>s5-gn#FVTa$}yXNMdf8q-t+3Z1=p0rNFZTAF=-
z^NhBOzT50*83@muMq6h!l9pk1)*`)}WDuJnz=<wLQnzsxgPRT;j!ER>j62Xso${7@
zW~wV9R=k*JV+Mi&9yA9Cu;3zC;+*~RKG&G`3-s!Z7|JoE;VwiJ7Jyzve{d1!fLW|Z
zzBt#MYw)_`Wnx=kn7BY`<UGB+OlU+t0iUtLcE%tMXf0wyMz@5?f6@>IfW|RJ*;Rx#
zzeU0<fU-)gCqaG2q|))21myEu5;|s#)0)+z)|@bU%m8|AA~ZNYvQ6WVuTM^M4&0yN
z;;}AyGS{w!z!+Hn1(S+~f4E^3&r~d>t*XMiLC_UmZ8d@b;_{FncXP#PCD94gp3rIY
zv8GIHLVl8NQ~+P8G5LtW_%|_#)i5~m>j-8=U<gPljmdR0JGA?arDnB?z00cE(R&{~
zoz&G)P=;7v@REW(0K3dEC1IC;GSDMdh5I5f+z3<H4%eW-nAet@e`Fnx6o#X_hk)US
z{nBHotyFg+_)U-N$oSP@1Ztbj$Bw?x?p&$jO(rs*kTWk^C&mvmjG?iX(@FrR&$?(6
z%WX+4@xLKTsT&mk#VO><mlzxQRL$z<;=uath1a~)-CcHXab)A}rt{*PD>bU>@YJe-
z)G_8M*EF<e9)ARee-dXn>zV6u0N-d?Y=?s@d`WIF3Z3l<BJ@G=2&i?2ipVpix6C<A
z&gll#`TDdQE`kolNx&J4VGPaP^*DAG&2AQZarhT~#o)AB=053maQhy8yZj!xmT&ta
z{kxzZdu>LU(D?`*Y0AC-)JEtuN_hs<II`(D!X{-4s<1Oxe|NklwXOyO1ZfF4O{f;%
z3v%N{Ie@$J>dv|d4&kp$D?;9ibw6j&Cu13d&lrs=gTVq7;_N8FqdZD-#(v8PEy<5?
zpi$J%O`0dAIAzn1!A95bm!m60%=?2UR>xb(A*_tQ2+>c2x*LoXC4=|KOR=?_+1l+r
zzH6cqB07PAe?<&qHaLTIGg3xK0HAP}s|+@gxsv-+ZWJB|82d4~)i_GwO2RQ1+JMIg
zn@Eq##;b^<!Xqmk6OK=so!-yFS!3_`O|#Q%BQgPc@FyVL;k3Qi*n2|~8g;-BaY5LX
zND79+ahA`y$bU0S5nSgWm=0!(@i{}U*?SN#HZaG_e|Vfh@WT8m8*&{1528bN{lP5G
zub#0>b@{Bf->DnyqJ?L`W^wF-L?`UN8c>1du}jHraDtJVF|y(3h`vcW<M#y^55}Zj
z#v{J744@66dn9QSv6;=lzn|0bVK(_@&INok1V9)!_${hQ!GFe}1T0OaWHSg-;Omu&
z34o6Ze*lKJ(B2l|92s%}WN?7ZPKQyC14cYfJ5AJmLIM<a)@RF!4G;<&LzLL1QJt;L
zB~)jfbIQW(L*7a20*7llN0B2OdC0TiRtSSN{+e!bg9dtX2JPYDoy9kZDZ=muKox8{
z=0N~fC7n~iBb_l<DnYWEAu!-85x%W@R5?%&e-RJZihclRuWEFFL^0OwUpm#Z>7)KE
zdfmA+#>xA{!FDZ=GwQNkFS!;$R2-V=fw~}^J3Hs@$Fq7VVUDA=&@tc@0kq}LWT)N6
z>t?_Erm^pMmH`T$@#r9iy^{3ESJhH`42QW+(Kxa<y`#=EVuAQ|99n7%<TS2<vtdjE
zf2N0Fq<xYkL(p|$Pe2J|1=0yc>|nH39tzr_n4RKS$>rD8>wst7)a_+AHQ<G(q1!~~
zT~_38{kZ347C0BG*hvQ^g^`+;D6o;OURbNer-;PRUgxx_1ep6X8$k?*SH7loX1mdQ
zOP~S_SgR98&VAnr07A9Pt~NlIf8<HQe-wrqaewvb9S?j<=QZvzbREx9I%`Y{M)EY@
zLL-uELiO@F(8G&ShS1p{hYWH*I8Wv`AZTym;<q3%8fta~4<yGi1K<F0F#0dO#)nQi
zPngk=9LWzM7u<|yq~%_*TLwNHeDpeAbVwq%7{&T@8g$_82CoNs**1pB6x4x}e>u(4
zLe+ywCHT>^6~g_#MI8<N>&%YXIfI8ju^D-yM#^1>p{$9dVh}iJhNx$XY7uxfE|IvO
zi+C}bE2y#sZ`S`@H)+f;nX_A!6MaEFr$J*lXqH{<m1Ga$*=kXjZ%a@Y$G!FUA}tR@
z1Ip+ZbXQmlWZ$n2vOkvrS<bHie`shy?T-ksKbrvC+GGGL1u?(p=pP<*Vb+2|s0;EP
zl!Lw3E7d%NZFvaZQ4S6puc1Sio#RhvnZ>SuIiNpl9}CQ=yJ(b!@a8{-8!4mg+xKL@
z^|xiCVFJMa{1~CR*J}{Q=SQ~)bK7ET!rdz+VrdVW<OyB-Fj0I=)~4Bnf7=<#{WzeZ
zSR&8JRG3Lm^CZ$;3-Or`uoB1<kYgnv=Pc5VGR|T1<0O{)wEbiI_+1;$#iT#K4#8uI
zc6fZAXQKo%lukt^LrU8f58mIzGb@z^O?ZMy<MJZq0bt7^GTOy!WO7{pxPACDTjbWm
zF7mZ7pZnMO=D6GIzio9}f8efy0zpU}f-QCJ$&xMYsV!~)zFVsClz<O%Qn0PwF&r4%
z*z+%WV{~9rcU1xd*}nF0U*CS3ivo(O2RZ`C6U!F*XLF&4@!wO;?myHLUqn~&wNMn<
z^B*?;r*)|0WF1`14{1Kng<cO7cG)?+Z&SwL!<&@Xxi<onk1^F&fBt@+O{0@NP-YQv
z1KT=@b(74|V@2F&lGI}t?5(wA3F-2{2<VPTs)Akz3{`UU8H(rgcyL9YN943n8Dt~y
z#gQL!$fhy{LxuV&O6G%lwI)4uq(Y)~gk%$8-Rm^k-4@*VMz6<k=}29E5~q|vqbdEk
z9RYKg+{Cxa3n<Pte_xCZG>J071!R~NoFJAXvVEWoQ@%4XrJIb<J?T8jjpUxDkmR-A
zDPIfp0fQtnT$wAAbLryp!gMf_+EemT$RMeuEk0JL&oz5sMd|{w`vrh>)HpdItgR|j
z8A`XP1Eg>PX=BcJLgOICXzcBQE~VT2?^AZxEp{W{G4Tfpe@?*?^sWqL_K%OGy9xv;
zh4cell`e!-P?HIv5XBxuDP_h*8^;KlRV9hOpJX>6ev;ZwjeZ8pWxu19RQtJxj(0d^
ziBv%N%K;Pp=^SL{O2(T~Cm6G^84g6Pq_q(!A?^)RLZt&w0yMenVsvku_Kq2P|K%>|
zO-rCRggcoaf4LIwDpi#<=qoyZMd#0j&S17t+Fgd+-#-{~1A9|}Y=vJ@`zvbyj;IZX
zz!3XCG}VI9wm_Mn$=tiTTQ})beF_%;Nd|nqW#h23ch}YyS(kz<l^DaFV7iCwW@1>C
zBukqJ^CV9(SOfQ2ncS7}tfTaOg8AZd#z2A#9kI6yf4)VHnH89+T&mOxEsc~klA^ad
zjagIrYnfPGS74vv=t|oS+Vm+fuIR-z&GI}w9|aYDOZZvK@4Fb>U{QekHYc}CX+}pQ
zeFD-7NjdLz!_k>A=OIR;J&#)>C&>-TB>Krfq!;_$$i_P1KKtnQjFIPHxEDDi#k@34
zP0#uWe*=PCqgg!3P=9>d>mMHo;g7&^MlJ@fhLStjuOcSEW^tH6pLX*tyNS{`iam&4
z<q)k3Q3Tw7`aS0JjB==HQR0j}1ACoSg9i*7jpfUx$3ag$>G0u9XUUumb)D$W0O_2A
z@kIS*WYCwRs(ARTS+=;mGRXnA)KT)X{dgX$e^-F58NH3gqSY?oR%`e(j)#en782iU
z+!{Hs;D~3shU2Vm3SJm8D12iv87NP%O?m~|8SlegySY;if5yRTjgi`FSz-an#YH+m
zS(<Nz3X|X<l`~yEaaJYIDD<b%83RVihA9&c=VYuABmqW}x&oY!C<(cSp>H3C0f7b<
zfAe$(-8j8mgx`D9P}rQ5QPV_wJSA-;85)L_3J2QkMli;P2SacKaPW2xG^M~83}sCK
zfwb^Yq+vK3M1yY3p{~*d*9|qJCI}fBfB`AFG4z7>MMEMZHWAD=qV(QGkp#I$%}h?{
zN9Ts<lj>OTO%Cq2Y=dWHYgOG0ev$~;e=I?p>1Bed9T~%|>1%|sb(Ckq2M+yp7wKpS
zNmlbNjvw~d)eic!3v6(s*Fb%ji1`b;IcVA#dAE)DD~5G!)mTpeVGs?qDg@|jCEfD0
zn}_cW`YUlH(u*^g>LVnzC&$N!Vh4w<cC!J*@HH4w-ypAv1DDx7!}3nRxkEF*e@1)U
zu_j{+pr`#AKI$SCO{NeApEq(^1Mh4RAVO!U8_GG|zz7>%0Ki^geaMs1g)A;M7Ot=&
z+dFstChk=j%AuJGj8VpL0c4*30Ok$y(>VY6t+17sOl1r+9SgTx9))1~M6_%<hjCr`
zg6DMrPQZXFC%E%er8kB)4quEze~TBTn7u+*e2u%Bpc>8QE0f8Poy}Ba5wqFKnxOe~
z_Ykmwr+=@}X1}%?U9URP!(JSt*0XKX-0xj1)YdBu_gYSxp^@%hdU?a80{0bYJh`n!
zH;AOkhXJEDIDyzFdS%zO<D{p18CO+ei%`(4)%JQ?qaAt$8NgyNP!15Ke`OSRuPe4?
zr9&KT3La;mpoUj+bj$hKW$1&qbrtpy{PRqMqynoTYD!tH??{BNF48$##);XnH&}ze
zvTI7=yuuK!C9yxmB=*Sg23_7lNNX9Wb@d1YVkKa-ARdJBD?GURqAtAQHIeI2e(j{R
zgq(T5KRM$MIS#0)L`;s7f8<+)w|6tzt*Ax3b`z4i2^2QLO!dx!X<0Jc%%4p0x@Nk%
z8N8<&pIbO2!<SA>_iLowU<$FgTfST3S1I9muKR~c9ApFj8mNE74`HA3?eMugJU&t)
z20ideXHO85WEhHI6-tP<)}E;|)@v|jNPsFCV63vK^kk=mHyh`-e;f2SIxrF^G5Q+1
zpl3dte#XF*jd?J4Y_R=Yca)<VPed-jvpd03TLfX4G}&NW>N%ut;2Zsw$38}H(`+O>
z@npgwA!^)W3}3{LeRN9?KLP?23Iq!DdCM73!z1({r3uD#AT1vAvTv|0IG#CHAf#}X
zVFvRe(9Sfe=$G`jf9UCp=)*4Q3SK2pk_Bkl6b>JK7O)Hq@?FHR3O_}%xhv48vQ8;K
zOTqAhi(U+d#;|kIDoR30L%#h=L%!0GFb&}s7A`|g(2$x4)}iapCZHS7PHHGf1K#{I
z%@5(sEEJckT8%5Bvr=3uB>vt;;+`R<eJ)Kpt$|(P9F7#Bf5}c|%BUIgdtkEw5`!g^
z2z(&HGL~Y)JlrCZNmE>)Q@%gCpP%ZhTi2?Ap*wWiv^?bffjVL+nMa|^eZ!_iyTZ#P
zeTnv*Frx5US0mWD)+$v}r=*Ztiib+jN{E?8scD^8<XYE)TL=Joj)7`2p#u3tT#!})
zACPDGE=l66e}y&?S*G+2sX^yzTt;NyAj}376vLsOB$8}1_?D2`$`0Z{rwO!Rb$i@V
zC)}pn*%Of%<ku}ifYBXJTwtZLMj>p)>jGcjsVQ6SZm-!eg&D{^?NuZ&v5c+Yk}D#y
zv?!wz`4~d_!EPmJ7M3@kK~)2h6vL4P8Ocp2={Wtnf0Te!z^PG{uqKAR6)IWCgfPhy
zEf4_pcc7zP4vH?@d9V5U=l)Tv?a{kqF_9Jaev!`dxyJn$Z9Li_CJAynCUDu=lMhlM
zTYCZ;L9RfT;LI*Az!{fE=ke4wTuI5~3uuDSit{=A9m?sX{5t61wO~{hp8vaumDg5z
zkoH<fe+EOby&^#Q^M|Iw>_!6v&>QK0oKIuH_HZRH=^=nk0%EF^xN;T%BV#E+GoE8$
z1;#yKxU3=vr*5FCRV1^96X~8maDKN_Pz(|ZuL`l_gM%&?vjxz;wSmUuNjTHM;}gK?
zRTlE9$tc7@OGx`G&2z_v3QSpLnFp=Ts_PWfe`u?W&hfF#-($qf2ZkYoImtz5qU#y7
z$+;zss-OW9vMZuR{FXf9M)$|)1!vDzB}@NYrJuZeEA>+N=Q_7*eOB>qcMQi~_jadM
zk$=0<IA3P%wqwfzc5c-yY~emNqy}z3;#5jnTuG?bGDcAqUSXsLi3PKhO(7w|NdCN-
ze@kr_1~;QwB8y0ayFtZfUTfiAob@v`wt@h%Z`qXV7I7j`+mBT2x^~xIzU0uB`c()A
z3^OcDx>Z1*xlol8>og%N3Cc(5TxPOSHS=IZ@CJe4-k7HV2CyKfrVB7R*f9|Xlxj2x
zC*i<?uO<gM+prCTJo7-n*%;qBPqkuxe-;2S7mhY`ec}9df=y0H2O@*xMcg5jflOxC
z7%3>0kGq6rh4v}p#{ncGU~VBWVsS3EY_VLG8(<WKAXf!z8h?6Y5OFzX!&pk`AHsDU
z@ZR`dGevUAxxn-aM8h<nC6{2Q4BiWVZ}g67#%l#5dqh$2Xqw?`awxcNscOA$e;;>b
zWHI?bzh)fs>0!eY{s(4!n`(&YtayaH1RQHk07+xAWGzQRR}L3pQ{^!(hR%Ybu8M|I
zSp_tA>zwQ7ZVbev6!@bUxU32B-oq@(;o8m;I2+`%=oQrak?AufyyCI3XzXN9DX1NU
zu7I^&jH&Q6y7r(h4Rq|<#&J@{e}I`@HDVK#;)>K~TE05yv;cN-1i3#{`aZ~^5f7DL
zLP+KXEa%K18y>;|GR)q6p;dgZktvjCmr!-qYaC9>TB;({jF{Adn0LEKdm%P@?WU%&
zU!vcuAZH`Hugco!OHpg^a5c-;tg#n*(^8Cu`%>@Tg#(Z*h&!H_`7oO;e`P!NO<AFk
z_psVJ42aHu;KfN$gaLA<-5wq;t&c<pcog5_qoc4qpK~Kru5{qs>Ikm~NRW^$6?18f
zr;9n=GWw!lerzyx1;hR3L8tK=f<lOI#B)^$aM0)~TcQkX6T95!A>Y<sbgCwt?C{}6
z3*RI&&{}5Nuq=7}m5R>ee-Y2#O2Pd0TwLPCZKLEqhLr!NSWK_o`R!b2M+JL>NwBUx
z%F88SdDS?Ca9^c>*|tG*LUfPU%C*)klb6!Gd+~%HGCU}dMjhmQeD{2Z>p51<Kw_W{
zr?DV0%T#tN96lr-7d!mcu^^vv13${{v+O)u7)Z|b6oV`${=u^oe^r2iZ31G5I3K}L
z0KHbE_5hKGh&l2SIxE5O=MpdcjMA8GF<PDi)-b{vr(+zL@!pF8v1trrE+-Uj1scd)
zAy;~V&gOHjwr4BT%-y&sX<@!#=a8d27IJXlaVQ_9n1@4^1n{Z{g9T8!t+z^N^SyXY
z7@;eYlvjICN-V|mf1;EnDgRuhmvQ4(>M5~!rCtVzwKve)ZP_~*cr{G<I?%}b!g<<?
zXYP2)%hC(hi_*3NKQ&4mN(9u8-dE+k<5|oRG+Xu<LL)i5coEr(Ug^F^GW+Q)ks*ci
z=xmtJd*i9n8l2V0)+(DLff&}JY&0~TnPiJ0Rd)p!(zARvf6&GfF32FUK|VI3{jzkA
z@P9(bXz71S$w~MFN5(<a>)xU-U~-vGtnHsLo<ewQ`7q_^m?0Cyt8xVm#lH%LAtD0z
z$f4PkXoudhU>>q<oo%t|NV<r6fhm0nQ3P<|!?_Ab+W|Iwf>G(6kldvOz6bX*WKaB%
zlE<Bct#M-Of7(SJPkENuKtJ!hZrVupY3<)gl6jtJm{b-7`^|2zbIc><eOKPN8)Xtb
zT&J@+<80jI{~iYREwz0GK6EAYXKwSb9_`K&F<-wCmGD(G{`VD)-?lovQ%DYQc)a&x
zSsB?AOY;dtW$)4oIh@j)(HIABpHkdI_`WWYri<x<e`Gwu<9m4zfAghMHt)7lL|dTG
z(kdpO+I`+2ZaxS4^4RY6q!-=GdDNHmy?5ldpj8(lk@BFie}&bC&GvURRj$7BWxfU_
z7q1z}?`FOHvMuPV14Ofbmja1yue49|AuPKbCXhT*Zk@b*z)R>noy7QlQ^*u(6X33D
zwa=+-e>z!W>bwK6@cAfXZuUGDcQoiOp_}ENjUq~Iza1;th70;wInbyg8WSjjWwVU3
zS{P^5`}w5VU8T5|V8Wwcc{Ni#J=+?`(T*sM2%%_DI0B1fNxPVckB1@Ccm(yT7)l<%
z6J*NOo{V|OePQlS5iFz(xUzYrin=p$s)M-De?7ayJ_#*W4=&13C~3>7HKfM;+k*4V
z*3Kx!5xVX2faEjYq_#H0bi%}Q^WX?{W0f$#t-VhY46bB9G3Io^F7HSbbT(59q8qrB
zyx6I{{So9Y_G<RuG}`-z&591d>dM*j%p(RPf#-C2WSmf(LL>Ve9XmzQ2|~-#ho>4F
zf9K}QqKFLnFMG~v^WQ4}iGITHu0Vcf?kNoC*!MUOSA&p-#Z*H#12jA?@VJu62_z%j
z<F${I6kU3)ie6ZX#g2K$2nKE#7%;@W<jV7ySLsq+C9bYbM+*o<NdFhTx#0<Av-hyv
z2D}7gi01*b3_Z8<SkU}Wh+SX%Sp*xSe|MgJ_&&l|FFGWC6uP5r!6|`LePaX}kuR@|
z<Qua3hpaX@NbCSZz8ikAET7Zbnsf)yB+Qf?65W8x+8U38^yEj@Q`Ku(7?4{ge}R0E
zP3=UK(38Ci$>^fKrg21^<WRjVtZ&T|LK}*{bI4|@*2KMPFtag}p%<|%QGrQKe}q(<
z(9v<kN#}aMH8zw;vpmAUW2?E7$PMB>`D)Ri1?ej(@nwqW|92jw3|`Noo{YqX`dTkj
zasG31`Pb5->Lmmm$7@PzLcZ1$xDxX<8T22(PQuG#I+|i3GwY69x~n}Z)h+IO13Z>u
zyj}zeM7)_s1?KULLhnpnGsE8jf98hwJ&YbBte>p<RIkekY;!X7_R;BV08)NvlzDz^
z9i9nghYebRpc2~iY7mx8&fv=vvp|9sK?+kqa!^&FYrPO)V_jZm7|AQc)2!#(Xr#sk
zA9$=rOwc(avzkbN7-I&2XX%78O6V8I0Igk9SA(?!lLrGcf<{324SAv=e-Sfec>|?U
z;?IQ_9G0r^syqd?5+5N$%>-hD<B^uWQlLE-G5oq2?NV@!pyDL-9yY?GEmrXnZc`o4
z?^N%BgGrP`#0)Pef^vvSNfhEWHuCr)i8l1qFXwvESNRB2bHH=>DV`+RB8PB4;b0di
z02{ok`o_zkj$L0D=muJJe<khUg%63zWlRE4FbMItbL=Zg=Q?A^UwQi@)CfH3b)G~g
z2kpM*gs8JP2Yi}pg+xD%zcmZMd;Z9i;9>LWWd3}+Kle3t{)}bjEb44BUQ5cCQ)jbd
z7oNUlf8c%OzNidFPmD_21>I!Uk?QV}Q{rO9_4|WaQu<t=?bkE8f7h9qSp~qIgP#!R
zN_8%lqQmfghMaM3tqNYyQ5_*<sy!jzmnT{fbPFQps1`Smfri3LG4fqG5V3ro4%i!b
z4%Autnye`zjy|vRYz{A>bQ>}sTM88+ewyCGp_ygROnyJr&rINHj`T|4q0VP{+G>XL
zW9}GU6HF_-uRJ01e{z~)9_936A{y_mFhS^YID<pOQUiO?Od`{+u$_9~V&WOkh=s2+
za@$<uQQ{DkXv-Jppe6K_F)VYGG~|KG4d^{YtCe<q9g!U5M&+hNHPz4U#!+jp|Mv9o
z$40w<aN6EOJ(UJ{C>_?~l_(kN51>w!2{Uh#-G`c+PM~0Bf3v}^+1spqq=H2~<Aj<P
zj%Wv=E*;nIppR~nAA2bCtKLu1C%cdOqPLf^^>%alL2rFJ8Hd_ypN#d47Wow=GoX(h
z@ZxY_6KJN7)SB=D)XDPUirVU9+GTL<aqRDQU#(ECudDXi!kkcnYY)zZnpz`jb1fM#
z&{7{y58bgxf6%|_eK?cv?__**XQC(!??m{?Gmp26{>_+WJlxBsfwdVQcR_d0eQVqT
z;n6?;Nrn)jQ@qx8^zuctMd7}Z(j6p__hY^A1h?101&%)vFb0(1y(rW1$2XmIgN7EA
zh_|X!Ek!{Xd<8Uw=DXf)2k>m^u0#DEV$%g<m%k~re`T@)Np#WcU*7>uoPykiQ1aCr
z_rWGqnLbPbeUR|A@f^8bIeh63titGb-+(pH5>o6vKBFM?s^^E=gY^<GycZ^53YX4O
zm|+eFP3J3&i{Rt#jG~s7D$`Z2On7}2<|c4smUnU>Zx?qf1pf0v;Ok{p-D~T>{&`8*
z7Y|zsfAo5_J}*;SFnW;BE#?dgAQYf$_XJR2)Q5pjc<>;2f_#pJfZk$l<{D^}cTfP1
zl(hbNea&FHQJ#c^%))-S%#R*%j%%D4yEB-jQ(+g1Bc&1|2MX>2R`&>q9^q0G63Hv#
zLKe;*DjgDObqgxXp`Tpc(Nbyd6y(;T(3Inxf1pi~UaJqJYp~LC)hka6P1!#|fpT+|
zp`R|pO9<uBQrl=N7QQi7^;=VMHZ{IEtNV0|@-1d)E#gEZv?6mJo;Ej#_;a$0oMcj8
zg!gp>WnrVMB%bEc%V;ZloxZ9|wTRkVm+}*B3M&H-I1t{#DL5p|W@Mk-{_}Uy5e#GP
ze+Tt^G7lHlqkY5XMI|_VQ+wm?0(+{amd43Rot<x;euWNI-H?%cH6DQm)Jv}n3(7t=
z=LTA<oQZR}A#kr|S4IfkU~Cg>vNcAYCTg24O+TnKk$!b!&DJ%R-@Li%fZEDlctE!$
zrV?)V<Rby|kQ0QSY@59gvssMx>QOqze?+<v{r@2yFUDF(ofhuMm#t8g+vuk;;}!-G
zL}!*{M!eNZ31ssKc2L7~WwPe7e@)maSpHftD5B~$AnG1yUeBV0${%B)vx^jyMB?@$
zo(bVWcZefuyKHEs5coQzzY0W{VqInSguZ)oeAw)FTmRFPQ6rG|8LJD3)v6@%e>j0k
z^#S)nk17&blEL+53Xp)?dI+POMK2KI>I~-S!2+Z3c@RkAg5gX%S~5oPfKcAB%IyQp
zBf|Fs$P@w(I_qHtmK7tiT{y}YgV3@qlJa#-*{dmA77y0M>5<sZ63D4fYFU{u7yz@g
z1K-bTGBbRn@-=b?JQ!J(Ly+T8f9iQn-XX^dH;<jDBSiU0AMv7q6lOuy+7ThREmQLx
zg+dLWhaHWmHVK$~0X7u>!8dA~7iu!4%H=GcUV)inI7=Z9tB6+-$;NJ}rr;#G!2xyS
zMX7QeJg^ucAhSVE;{k=u;+T}C8Un+(mln@S&CQ)?kwO2!JRR}E73t+nf2Q{{QesmC
z4f(}`ZvK`Xz&PqOj`%&`yOc31lHH|rD)U)}mOMNwdgXrXH;(p&gH*;kD-iVMF#gKm
z;z3dGq(zS5ABW9$zjYuPg39{Jv}?T@nb&vM30u+a6}G9Ojsf7(NMgs{kP}(a0K%Cp
zn_Q%qefrv$U#mWlIE=3Se@;1ku(cuOLLodqxh+CE(NV}3_yWPbKx%Uh#ZMRkd0yYF
zZ_?c&|0!}Gh#*1_NV|M*wf81Z=8p{b>-WO?Ve)fg9nOm7yDnBNRwGT6n5%%(xP>YL
z+0q|99?wXQGQ?(ppN-7&2t{26GkPqJ8b3CLSk0Xo5&V#)A97Fbe_$)HNApJgt^O8I
zHEI63d8X<OOfk{1SUi6XB@d?82A~Lf%0m3NjAzqHClJ6wy~#O#z$=Hy)C<r{w%B54
zRj+T=zs0t^?1{3carP7wE+<wti^GH}wgS!9oPrt7{5@eHf{cg;84d4S9Kjg(4)a=P
zsGIooV?=K}xn>@4e=74<TXK-hd8?rv!%7I65N{QGl^SYzG8D$s^ervpOgPfRW~5%7
zBP3;&rix_tm?1NmIXKmG=bNzBju0?zx^zCcMo=~6K)WG<{H|Q6aLiGKdWkk*3I*U#
zl9-*E$zj6BJ93!ixl3@SAnuahIhVsMTzV0QJePhNMg#><f5QIuee(n094$<U9HP>}
z3Owhg&1K30M@!})G)Z$4-b6#nu%iIFCI=4Z!w@v^d#>11&tn_vg$fC_w1<3x<pIMJ
zT)5<2Etn*P{vQMC8m<ItX^!3GQzEOT8A=-Y0v70kbS==zkE))b0P~K}qr{#enG8YD
zA*URe>Ej^Af3M%`Wp$Qq)22_fdQ*>N?O|mFRKb2e?KXzK<rk@{K02sWCZhm&MCFE)
zEbVqL9sz-)ie1uaN;yJNhG%rI!jM@RkD*gS6yj=nU8$P%ts=kqoZ>Gq6BhWcidpMx
z5KAVx)g3ONp#}?!<>Wl2B^W)}xLvu%N;Tk;qnfx^f2=LF2X3?p9xr$fnWSD+UKF|o
z|0|2FkQO=kq~<h(3+0U3(AZbj$T7q{EW^XlEuCTIBvGl6QE_}<G2y{*$T&7+KU7by
zUtw5zlYn|IkIvL$&-}ZwdKYYolrV<3T%dNPC;`GAu>?}M$LNs>Qp+Mo7vw3VElcp}
zzmd7^e{bM__<?{j4^yVDtM#p;rx)pg14oL}Qdavo=L<B+14?c1s>C0R=Tt(kimF)d
z3mmQEhSt%0?5I)W^-0-ZX@xkSvBcPa@=oZ4EVII6o$|%`hNW0mwLT$Ygu-4(2PE9~
zixSQ2Dq|ev6&#;)ygl@Zv^8znV6cEJJius!e@@qr&4Rn3fM(2R0W2VKG|2C&i8=P|
z^R!!x;GI>}S2$TYJpKZuRdOrMo8zyEU?PkmZ3KI%7ZV{NfNQ?F@Gyj|**WD^<i+$!
zJObq!3GF5=#a;i&=xNYIC}KlguA+))`=LC6=ZnirESgBJuDOq5N+Pb4$C~lQC7x?1
ze>1k%Y>`VbN+h#aYiIJ92s~q$589VYD2&C^+ussV;t8EFmEM|AY~g3Fmxavtqg%B-
z2sPeWTl;m84U@G1$l;%j>r2LJ3YcQ?#kyKt-8!G>S(&Dspc%6gde9&R^BJgFc2(Y~
z&_hn`P@mu4gw}yC{a41xBIE*I#j3aYe+oh_E_M(D?R=&6P_@>+DwB$$_o`Te&LoHg
zdb(N1d{NwOh_Sn(bb_X026b=U*0}S+COndJ)19mUlaA7fnh|Yez6m$)HAVcvv#De}
zo!|265~X&fb@0t;;g5G;?wroXR-6U4_R)`BCJ~HYLzVS-q|*>2$U;#BzstB#e<d?*
ztdSqS!E}NqEl1`;H%yU28b$PnBcnkg8sIVUg><f%7eHEM$1kWA{7E=KV6KASc9(Vq
zX4vZbrr9_t?uzi_r)I6zirFx@esNCbK|tD3nT3RkSPHJg5(l_Ztu)8)<M#tFr|+I}
z_8O{z(~RH&41a(9jV~s5ngT3`f2`y1TzR3wk(fP?m$P_W19lJ@C85LD*TM}U(&w)E
zQ%~45I5?H7PI@8ycQg$&=30QjWtE~7nJMq{bOuG;h&LonV>KEs5?%>Olrohy@;Kwh
z?MqCaKt}JD>|cqrSb@qq%5UQ7;3`gmT~DV8<o!Z@8u`aSSuD7rHAuBGf5xzKN;ePE
zps)=4>)Pv<TXYn#a%+g%s$p&o52fG?U6xT|w5Z(lJDp?&llQRM&oT2aHyT!@de}CE
z{sKU5O@_&b-_FFrUc>_ieqqq#T1|Ujlz>rc$}`GH2-S^oQ!Y2oceFvk^>E)BJ_&t*
zu*Zx25EHH&=S9RUv=}Ahf4m+w(F7?lj?YS_NRbyAYAph<Dm#S*8|=<W-z)x)yJQRD
zwmYMq7o;4t<p&7t7Y;90*=M{oWomTrih`gMhIcv?ZlnpOK6f(9V=T23@_1dwj8>-4
zn1TY-x2Gy{g7%GhfF-v4nY%7B5&qg&1M;-}WBd4BTlgpDJQbuAe|NP&3P`U*RsZ7K
zdi3i=7zxfmt#l?Ljln8Wvu%j7#)?Vp>HbimVn3DO$&j#eqB1y=!i$HU^stQI6=NMJ
z`D3heyBrFKxckk|v`dNmhI;&#_99ACA9znw+b?;J5#f<}a^>bVCEv2mOJ6oD2B=d8
zm557~i@e*GqryGQf6@J$W)}dnjDep)O!gm8nnCulobxjYR+ZH^4HX`zs!Fu(AfvYa
z7InXy9+T#2tKDPr598d<7!?KU78-Kkp6j!~pg0j|(8z}h+a}=Mg=k_Rk23e3^K`0u
zqEVng>;NtnGw6wf%^+SU<uoaqm~+EJ@&Ff2ih7FQrEFu?e=&d}LKxi*VCs3AW!Y2X
zX896ONarSeorN(Ab2$prB5i?IpYISKLJwLkIx{W`{9s}c{9<nC3^6%CYH)L=D+T+-
zfdTi#yd+_1gUck!;E9?~?#;wn&PcIpQg-Q%h$S*(tL_#zk%-V*N~XfIUrSG@uAX8>
zG?l(kt&31ef4I{w)W(E#Ymmko(%7}yuSHFEcm@qaE@gbeA%!hjx9sAN8&FL#op3V*
zWT&m8w*&oM!UD@wQ7&-Sm+lEK{3o;7k^x`&QOQydJTJ)wFT|`nz8c3^9HMNUWP?$+
z44J46$|z2DAfXW1M8IzWONlyt!QxCAGlQiI+zd&xe`G|yt8CSD_dPzdlAYuLr+kU%
z<)xq5aYq~(u&Mk-KIycMWkn=Ra(WZ<QHBcyH(ozYA?UMjN_PhP7Be;>hg!37t|j@(
zkZg!LucWgcP|88oi10Fib1F>GE|#d3d}ap^<~JL{v0=*rFwHPS4wP<!RN_Om5n0kZ
zK;`hXf92r2{t9}U)tEvD&XZi#h1K2EMOho4wb;xu=gPgVM*`7ugDR>zbwD4N5o{DH
z92`Hz{5Md@U1CM39FI#4m$R1LJ389O2vfT{nUvi$Pj2E*I5#%QCg^_z?ujU^5l+^W
zbC&S@Hw}Qw$B6q)YWac%<7c|@^IAM+0u09Ee`7i`+!D;hF3*BJ1`M=7iMW8<#Sf+j
z3SS3^Mb}cN(c*p{R1Xdj9}Zi2;&b;W?V34C&7gHi3m?$z9FSYrbi|hao_Ib+<+-6z
zB&`M<)`Tk~Z$bBROR7klhh+bQriBTXdRBu8bpfw~bE9^Q4y53PHcv)!P;GYrYQXh$
zfAT79sy%X@%=zBDUgk#qHwWLA#&(>60vLHizcaZxkm+UMsg`AIO+xS@{oqx8h)v)W
zg&{Rsi8~KG;|~S!eDK#XH(>rpc`KcF>P}CM4O>n1!mp$%Y&3U6aC9IVS<y8V=AOu#
z7Fnxs+^q@^v~-O8Du^+foF}K3ocE^Vf6;eC*J^%~N!Lz(t=M8Avle$l%lRv<wj}c%
zG8!xrT;AHMmb1bbdMVT-6F_%f2NWCw5F3UWx~l?1nN3NKI-Vwz*N0&;$sn&D|Ats=
z(OI2M+sTLdS%g|tK{My`7&VOO1^eE0={r+LNg}GoZ;j(&BIQ6YB?<&E8PbtBe<oQL
zC$?6aT__>bqK8XYA2@2Pp#iTlI2$lNJ?B+eb402#j+96q)v8FWP*O1$SaD;#z73@z
z#_W2c(v7V8?jwDP?$pHLc|wjV=*WVAz&Hp69iENqOlc|T3hV1<GzMM0c@ydKWABl0
z)P}UdG05%899t^f1&Lyf0)J%Qf7m(YLY0v%`7-fGcuThTyL~2tGkNcHuUGLMbv2rr
zKLQHv+T|e2`mEV1*)>xa>vuq@8OSLTt_ta5NrqLKELeER#yrObs6Guh30>(TW}IQf
zl|~UI&!6vDtA**dmnwPvjQ^3#@%z*%@KTv>G3qIt02$#5fqa=%u-rqEf4{nB><92G
z#s_gG`BgmQ!4e`9r1!ms=CnjEwcELbb1L5`o?^^Y=`E~jk!}t^9mn0AdPA+L8%-js
zGX$K@gze=V^3_gc7G>jvbYbPJqR&_3xvQ%XQjntT%oDldus$6mXyAp>&n@DOeRw`>
zQB0fX5A`N;7D=G#6|~?^e>VwfoVZRzIm*~Mtc=xUgGzW<L!PLDixKMK0&sNv+=x!n
z+m7`ijIcDG%r-i33^OwQ7GJHMg9VZ<Q>y2p#VFuNwFrcv-0E<*#k^0B<y@|Yxq~uy
z7$ZZZ0)HkaPL1~R_)X5C$tqxi!{u=eMv+cRHT?I4E2tTAW2JNPe;5lqh=k)NyJ&PU
zy3B)dp%91;FLy3CCF*?YK#Vb(F%_EpOq65O72-G-p|=V@!BfEj$Lvs3QAN&19`K1X
z2X(ih;u_Dad{}3aOGeR;Zms~4Kr=B|__%YQ#D1c*t;<Lf0D6q6+#;>)Sj$mTUd5<g
zMbAIpUTT#!sNhY|f7%i=<J3!XwS7m8lM`O;ld7EQ)dX`rRMK~YFuy3|xpwcjmOf8Z
zYvd!~HGj~H=u;$9o;<HAxs*`=m0nu47N6=-*ZTvDjX5yOsr-w98R+b{j4c5~P@~Sl
zpaFgYoP^vyY)4!`V?k}!>`ptOjs^C;#zfj`h1!ry1-P^ne|2AQEEMZl=3HcmxMe3@
z-Q)tR`DMR((rKc4{5MZj7K6gfhCgiDQD19{>!#p(rv}em=*oT<o_iaPY#9%{?J~jS
z%4#moF4zEF1OdAhMLjYe6$^S8k#VVP?FDZ&AKpY{8?cq&R;$<ocJN^i>%nEfvO0zH
z1cIjl5A|KEe~3QAU{BXaDTIZGmzF|7WxX)hTc-#24r*ht-7>jRI=ou1iDx;`<DhZa
zr7kHae%xN8bpJ6W+nJfHo`M1<sgbkSs1^|;^`vVpmcY-Hx(|hFQuc8zrN#7BAgr)V
zszjj4R{S!hs6!JO`HNL85Wixw^Yd*5Bq5e~?(a62f2@OP()sgMTukFCVLdsK8_XC(
zGD}t5BQL?iog$q=A2C+>=#n*`CzD_oClM!acOcyl5Y~A%mBZ37nt&{!;K|~?2kW(V
z@`@eSdzH?;=n=Bgm}_bVavrwc_@KjA7^uM<;7;8W&7G^*{uZnl&IymNN_fBox2JSm
zTqUXYf2^DrFUWq6MtI%PA}6x3V9&+uG7A@eG3jDSR|(T3llv3@aF+m%+1!i>2qc2D
z7~_Uay`}?)vKZ0@6UmB@Zq7E(97{}y;DP-EmUEKKpaOUai;}ShZ4U--scnIjvDQ+{
ztyJl9;tz^Q1lKC`#PZ%t3IbdtyPMNOy201<e<mh-jDGQ9fOEKx%jt%;{IYl3$wrS~
z1^wH#uan#+mY5fu8xXysZDXS>!0`KMi?IkN#l3UwIos9cC4ZpayYp`Is|j9fUb?iD
zzCayvqrw0eS49>BDoL$UW#}Bnt-p{GuX`WubAljcv_F+7oDRHfT{@4BvmqGh1rqz0
zf3Mb@se<ZaLmFR7ih1c#hPTV(`D%t(8-?NBu*hUQ%}~Rx!3D)LWC^Iujv&&yJ2aBV
zSwdy&t?KhaqjE!;r=tA~wOHu&<w)mDwqPvlj4)Rj93FwVgV_jpwc<HnX$sYJghqvt
z7Q<5MyMKC43u$r^HP^uR*{I1j7a1g+e{E|jLa$P-E)<3#gd&)!x<%YS`n>}`WwFxo
zU4(gXE2KW3_r_EG$bHun(5{d{NGAibFk;RF6RJ!mnC5q28Th>_#Wp}&Sfs^1sHi=e
zV1#EbI-5dsbY+~yw^pbgT$O-1U!-7xCb>g2wDNmmq9r^cQu#oZ7r6{QH(+)ne=NWd
zc&*$-i=kLkl|^~mARSZrw=k-n&rFgcQ4^kLZ>t{d2?e@yG5GH3!fRGZKW^>pFg)Zo
ziKj(vj(I^#n17qipG|Lx6v%j|P-o-L=xR<!4_VWGLZv;I_MX=nF9Q)kWbaCdCxsv%
zb_dc)nqOhQ;bgFwlV>%q=k>`ce|7&BUI@C(7<w`q8W0nfYA%~kq-0J*d+`SV3U4)M
zO2S8qDjcrS<8k~o`*}lhqmhyX50wruok+4mV~x<|6dX@R6qv+U3xpeAZW$G)tJcMq
zKw%R)r%Zp5%e<hi*X`p@vv6S)^@D%CiD`eDrxe9)Ti{SQzAq_oZXFm$f5PrV?q<K)
z?RAcSR`t9Y*hqI*^i=qc@;t#%Wk(z1S!aoiM3NSPeH&<>|Dn+7umEsCkH6sORHUIa
zk9c@DAtV8=Eh}7Eg3rUyaqT7WCv>3fpE81<3sI{HOs)n9h6W%EcUPN!mY`dOGJH^=
z9r*aLgG6=$gO)>yTS9Ar?7rGs+J9j|Os$1vvEYV1c~a~xYj1Dis>?yanpQUzqxYTI
zqz@?(7s_~B*o8D98@8cd)t#30Qj40&TctuHJ-e@Vr4N7o^)OwnFJY2y6Eg~U3fBYl
zo)yU_K0tmIUhRu#GMS<4+F}A!P140U#|)J4U-(VtMq~#tLAAcfkt@yvxqpNYF_2P8
zY|U^KbPSR#jqV||MG{W}?*WN?D%sbCuwly%%M5-tm;xFj7s?^eZGTItJ__iMR>&+)
z&waVH;^-?ZsCwzN;;tFw?y1E;hH-Sa=%#oI?RqYWS@t$5ydgfjk|!iyyC9A=YmXQe
zwhHirU(uE<E6XXzOm`mpoPUqFY1?rBB!_$koNFFECn7g;avX|L9F8HO)rL}X34cK~
zeX4>TG5E*8ya|<~jv!4d=37(@v_Iod$b+-^M%kyb<XZWfFICM-DG3|_^E_i<kXH01
z@K>If00izsj@7j%#+3reZ9`-hmx(g8?jpZJHj}|*kkVncg0=VK5`Sd&-X~ES9$9_o
zPSp(GU^3r1GYJ2_5;x0#r?|^k=vML1n6fM#I6hN1=vXl<pyW$Ebv%=HjhFyVRLB5b
z0Ag~RS@Ggqc(?=u@3%a|eL))Roi4ij!aecN^+;9uLi;GVfax6*wlE=O@327vOLq;D
z=}rKju$3sN3He#}n}3~d>B7^v`8*Ij03+`;4iEb$9VVW<?@&$z_3LrBr+6*dy`sN-
z-rSQ<thAWwOU+W8Wo9uyyQ6GXRZ(vsHEOj4{F}iPfX+sEZ)+#P)u>4<GhPR&LarA&
zFO#{IJvUc@6rha!G1S(xc!;Ql3q!tspCnVtneT>#@UemZQh$vnBfxvezk|57<|Ha4
zmvR1gTn&#0K!<g$hJ%nHsZ{!MkSm7=$|$<5__YMNizz<LGCuNCS_{^R#k4_s&J{CZ
zt4#DQ2Cc6N3j+E0VHjv4V&UPuaWtNbJif$m2ChlZZdQR&Xvr&rOR%G%;hq%UwrQxF
zAFy`v<S!V!PJdaBhXAWR=t{t~I|~qV3iCRJa7H~t2u9Efh9r+ff(o8-LpWTTS<po;
zVI&x_iqjY<r=&W)r8*_!ELnCA$t+~ei~u03E1v@F=FTS(3N02D>OI*z?1R7`-SYA|
zk9d&5Ib>hB0B*7D9@#K^)b9Yg;mYp1!3#M;^*&jcJAd3|PR~bHCUKs?9;q`_d1}{X
z#<g{{D6U^7^L1HwMnuYI(R>DZJ#)P9YciXHWnmO)6}Tfed#dJ?agS2$rSo8xJy4QB
z4mha#vY1mO675;rY0kzInYhjqu>*SA5W<ls@~yT88}a6kTWibMEG-yHF(U|B8GJIo
zf)pBgO@DV_SN9CIoQ}uI5V+mZEhIPvtq!AmL(17)4(WW^1y_D#twetIok3Nf%LH-E
za@n9@vOhh=pOt-)0ryw*x>U>KKm5Xm{4Em4KtjI?CqyL}<)(4XlI)y7?KxL|hpLg0
z`Z0C0%Twix@HIfR#|xlc2<;lAnE&<`k+kN=#DBFVm{><u;5d{3n4@VRzvLH)tJZ~D
z8BM99g`E#qY>BU{6v4&C=^=z7ge@6Ok^EhxlcDoWMVI)nn~8t$W&~Wj1p>ySO9=J6
z8msDSIDwf-3l4i{ZEYiJk%V-^qv4F{>g@X-rK+MFs917{G)2g@`PQ-V(#U57V;n)z
z9Dlt2dImT6@&*C~bILlmd|)##5(@Mg#nS*u;ND(B<dRj%4w{YLX{U)t&JeEKZ1*TZ
z*qrLw)LEB7lA^H*qkk#m-<pa{mv@?L?MYk`mrr*uml+gETZmT*xX?9DDMU^nkrKns
z!iCgHi$vnlvC@G?Sanf{1f)p@_vo_ULVv!8brC5{-n6E#Ixb8Mz_V+T^S~&+1>#&e
zKIyfN8i(j4yvU=&R=e5gQ~?a*bjs-EbuwbSBD)jrwGJx@4j48bnb>}R-VV^U=2bTs
zI24cyjW*^Sb`NXi7B^n%PP<WLOYXH3wvOHt=<P*GtAvV6^O_1I=rC7QhoJ?-1%K($
zxe_Rr?pwFDXt)@UZ$+>pVl>6$0rMst-tivY4+q%$MPRvu@GrzJ8?N@@+28*-7=wN=
ze<+0E{&}AgUl1twKo<+B_Q6@7e@A4I-f!GKms?6fVS5CFil)a!|8^M>Z}ZGr?sL(G
zH__CvmK8*}=hG~8lkLXoRA9caKz~x&it=Yolfz(lJ60QsOX!%LKmfZBG_cM>Dwr)u
zlUj9_1P-Yz1I&lN0~msV4G*s#z|wn~9{bJ+2mOrB4q~BTX=RF6Nl1BW6t5g3^K<<^
zVvJSw<Q``!u@TakiO*qCTtY1<j{79VFYHKH)NFiWV7o;QmID1w3BNJk1b@V$%XA?0
z5a0qD&n{6En_(T!*h;CzTIfO}9YG4-p7D%{H6TL_ve|4g<=!c4d-7k%7)ZSZj{wxN
zl%0|1<g3%y?0<XBy<UIsxYId3>0x16DmV+ZmAT;_v?r9~u(qakJ!*7bx7ug^mOKF_
zzpH7kyH?whE7XlXd&3UD|9`gCZM}j#ywIC|+B<&J>@XqkOw);ISGz{#jD36OWsIc`
zQDoIeakZ~t*Oxu8h7p%RMYs`iRyhjSXGKCNq+=cgPJptA&?(3qRob<np}VJhd(Cb)
zIFPCXC>`Xf9PNOY+cuWS6Qr*?8r6j5C#2z*z)}bma+BzRxg0U0(SPkWJH0cR?dT$%
ziS!*9n3kiS029{{WOt(GY?jSD$=G<(E4~zwDFcd^qyO3p90*)LWFq8t9*UF%X)%WJ
zV=S?m?W-a4Kw$2GvnhtnBfJu`IxZ?Ya~{N?c=QblSn#JfUehv>ixtQ_sM0;~DqWDE
z9kTcIu2fD4dKiKDP=9h`Bp2E>UQ=-o5T-KEWx@hqE@%LnNTRUP3yYl|l-!5%7C7cQ
znA&G03Z3W~KSALf>N&;YywqHWo!rnALN`Ri%ZNmXRLWIu>H$P*$m(h^j4-H(09Jk+
zsPBa=1seM!vypJ6_6laM&wDtL?=(a~D3Q*@@ze|(6r!oH6o2YT96fT9$=xWqPm_m)
zU+z#!0)aj#cd26WZq;9BB+Wk#o#CW$y==z0pJi+jl~+?$chvO+2XC2GC!3i+oj_GS
z9ID0rAt5w}w7py-c`eVL_mLVOo*2jZDl&GhT`y1TC30UN0YZI)(hZlV{N@tws8(<h
z#-<s*Hg`}jgnzxIWSC*GyA+x*ou1lM9-m~*f2Q;WLmK7Dw5RIN&KaM8G36^r7(OTp
zPY9z}g{%OtUwMzNV^1W~otnXwp}y)TN_ZRy?8uN72d{f>#2=!O(x|?0k)jn5iN5m8
zlI*d;RF$JB<>#Aveaej~ACh*w%Vxu9eG30x*W6KZ#($1OfG_#3%VdI*tm)b2r)e@U
z3PVni)#Y4t3|<C2n7GbK6`$nNLSh|z#YDm^i&4P7%#jL_ThdcOQ<rA!2*&B(WjzR#
zO_Ga?bdbt=YFa#@MUASSn#$mH2ZzwGWI^z-!nC|}1nAJN4zmuoigN>F3NztH3(t$-
z6141@$bZa<qK9mA7nFEe0}<o0^O_@)#v@R&+|p72qeNalBO?s1fVh9)JdiPwTAVe>
z=!;5RBp&Gk5Y$Xj*v?~$Nu<D3@D$7fH6JwGwoAF({hc5L{zQ+3&uDF-LG__tlyY;~
z&koPSZZ%x-Nh&wBMm5VlT&oW2dEJ!KonHp&pnm~0g)}ZQGvrwTFG(h}e?8{0H78Ax
zZhBD7>QHGNNUr`ch&+(IU=C*weMuUmYho+{Z)93R<(b%mc*%Uu)3&QXdFl6JFpvDr
z!fcoF#nNb*|J6dl7INHV6G-(n;Tn{?(hSA?t|%CBL^B$>se?IW|F}G5$y+D#0|YM}
zntvg`-nqg%hd}%!SB?v3U&@W6<*a()u-B6Nre%QsLteK7G*}95PwD#<=E^g&xl+IE
zt|WD0_d~)xDA41a5`oyY^&sW4!V=VZqLQ&5b-_=|<RJwopTAEbzin9+m4<P5v^EFM
zOT+IXSOZf%6sF`rGWxrVMR?g9kw`{cu74yDIpexJFnE7W{191~9MoA0@Y0m)l>F>u
zy7q?=stgiSC{XE!HC?_CNsB1GFPMeVvaI>?QA$FsNPH2BOBZBFIpmwhLVMPBCW2`0
zhw*ojTZ)+dWmn?9EPo)lPWX_!-sQ?{W+;32WPVRwyFomK_9_8@^@Q?g770B=G=G8k
zqsuGn>Ipy35#**o#8}M1or^T?DkmI8F-T;st!WQwjK?Q1HwDkmjIDE?OjJ0O$a74>
zy7L5R*@7vjip(C1p;5~B6A@TeQYfKrRVnj8*dzn>TxOt{@gz+efT<t^85!0pNDz44
za4QdurvM7tI+mqy=EWSa*t;s2qJQDU8sUV=dT8z+M5<t_q8!WHtH(16zU{67jq(~<
zEtfw19$vxo^owicgW2c0N4`|w;JHwA5Rmh3v>2KNHmIHhR==QR=JSN^4`U|rH7Swz
zxgPMJq&$0`(p+~$i0#ja5!)-F1lliE2)uMG(EtaI8|<o}NuF*jcPT|LL4VROpUEMR
zcav3fwQ;`5^;Uud$)@rDE)pb{dVX|>7|U+ZxFg-&H}GuMAdW!H3oIw&XS94zGfIP_
zVydBgb~E7>CQ2JK70_hh|0g@b6_Q2MakVKtbLmkD`?FabnHOPOr82U7FUZsk^ZD$|
z<a2^?lbGSiI(%GA9crk7KYxO%EJ6DT7Ey-F=&zQh?R;ZRCh-G?73Q}L*?eAI<k6BP
z>PwYygLfVc<m6Adl2@l&^x>1?Pbm|*8AWWQ`Ynne1~-mR9YAa=J))<f5bafbMbxPG
zjPzcG7_Ss;4Cy@Z8<e~2v>S(_5a_#B`}ub1LwlD_o^MNv2dt5hoPWSipW`<PSUm9`
zWhHBzw6p-rs~!|Kn4j>}fFg@h%rBuLsB>&5a|mWLRpBw6f0J|SGS{evSSf;t4<uY!
zWCDJXx7|>@aSh$^Vm@7H%m?jK>>q}qQTgj6=LH)O5FQ%lOgF3=+0Yj}RgAf{Iu6F0
z11az;?x+eVojV={&3{HUBj5QHTa=v>iSl5S(QAi;?y%DsWW!`_4}PX`DzpHGFTXOr
z3BO92K=uZ?0|;Y{?dAf6;*3|465_gBMnc-yg%<~=9vmba80CfVka9P}AGWh$c9Sd5
zYaKF1vPt;FQ_9`3rifbs3hEy&&Nq~bio|eHj01<|P>pZp3x9$M^@f}i%mNve)+!DM
zwX?$u;(_+{!bD}Xek!YCfy-xtzKd{RwP;GAdBbdRK4K6Cr^7Xb0-KvW8fCG#ot+>)
zX~Bp5;ZCta5%-4Vulu<$#*;hl&+W!hYp?(I^zg?<TjmVvo~>orbR18pjNg>&EkOFD
z0?mO$K07;8Yk$cMOkww1_AE_dsaU}3`hEZX)vOQl2cVYly1jvIuA=Vs0jTo81U(|f
zjYSy6&o)tiBW|fm<rJpuI!AW|k>+FJ$^zLV6Ty?X;?-m*sh-BWVe#%&#u0uEKsi*Q
zI`%8%R0NFWgiE>)*P^p0(<!m{0}&>yt>7Y^!E<ptSATW>WD;YMY~FvZRbid;^b+o}
zpJr&nyTbi7@IhuYY$S5+X_f4Zx^px34*(zA=;cJT;gj=v_qw!uI>7*0UIY&i5cGA|
z?`3&6D(s`YaBW2cFI?@d-bkD*Pavu})IgtjICSMXL5=97AK^)(yK|cBG}<NL$c*1k
z2JALZK!0h9LKb@url5$L#W&oSdQE@Hv<h}-BFVIPAQ5Y(q<<np4q&m4YfVMnfO?e)
z>F`55Ns!~N@f-+wd_jR@F@~BOf!8{w=4<AenXW3l&SqnPDf-Onu)@WO*9$~ufZ^zx
z@D-<`%<Ah15<<`qs2_I-zjhbY>kZ4lw(9($hJPM@fc|S5wxf}2tPam+3*gb_&$mcI
zY$H}YUxS~(keJWOHi&w&0(e^I!BeFp7&V*+9p75Pp0K@2lR;zg+_gOS#kEoYP`ZaM
zTc2^>M!Ckda^)Jq!m3Qib8rIU#~SlI2C&+?GE3%jz>T}^bIsakB*%rj;vZEjyNBYd
zFn_B6f~;?D%&*oZUZ5$(thmjUrzN3bCnw<y3kAs$u50kd>HJ|gupcY*#u;45?B;?m
zMvMFkV*n^p0G#y(P)j@y@OHQg&eCZs$@Qh!AwQ%*N9@vT4>Q=e<gAL2vO{==77<vQ
z{&NjZSEj?00VXp20)G<9vnC2RKBK<KiGNh^sE!aN%d!YHafdW*iLd4=XZ<L=Fei?W
zJu!n>N-;(34mlmZqELb2LMI%b0D)}#H0(uLs68ru(EZ0KMPI+i)>KoLyC7njW?&W2
z>zf;itz@k<;tWfpdM9YjRZ%{bkBh|Dn^`LA9mN7A`8?W`+DU^2!gJKX)WMUiiho21
zyc=={RJ&mIMs!Aemr|e3687+>*NK<6(|5%BV(ChuUjRw*-J9dXX209|A4W#OCy3I<
z#46zxBCnhi-z}7+hkmGO>%)LZnviU7SG+3PIZrZ8l_`3V**u;Z7Ih5VV=!g1{p8tV
ziaZ`M3{)3q0@m3pEK1N|@aa-P&VLP1_V5|m)!M8nH7jzZmlMXs40$`}X~CL6YAa`&
z>~CIF8S$CTIN#`8;3zQj+B*_D9(kceW-9YAL97wBdG2$jtr4jX@_mp*pLlqkS_<Ve
zmWtV=xy(Zc2?i(v)k~?b@zPt^!O)Y70`9q7`lCmWY^tg2zRtvBbjEQgcz;txZBr1P
z@Rrp`FL;yYiQ#3vQo;_49)3dQs*}Ll^8rrSqH>Cwm!)*7$LAt<obd-AdekoRm+U?i
z@8~PN`%3TrJ?LH0eFdVoM&NunqUU80zdXtp;_tX7TvN0>D4*wb4&mup{aWH-Hdv_o
zR3tSxjCO(Vx0(i>$=si1B!4e~FUJDI3?Io_1<7X345C_bK+!`g5-Euntgco}Bh?Ks
z;1IPJNCpK#6cfNTr79_WtvQw!D!)={?^!2^_$3x&U16D$)x?uO3MX>sJkl02E%A8d
zqunJMNrS5yDyDArU54fO^pHa$X05<h6%&|;VXq#B%J@b7ucYRWM}KOTF#!)wZ+xip
zmFRq0qJw5mOZ}%6pvH8++)RT`h`Cm?R{6GGWdg5-1+_*QjyS)h#Zt*?w^tMcMd^(%
zWQ<ZcpGbE$c*FXL5PU5ZUk*n_;Xz2?S?73)Ur}%%o61l$C?Bn1L8L{m+2By)<wm*e
zrK28#Umve6C2CCZP=D?-qv07C6lOR%Xy_8*@Co~=$<l`gaf!4)ZM!&U#uuf<qxt;G
zxa7)~aU(lv=NmicYF4yQ;yeXW1fA2)6DBpL;Gw~bl?|@Iy?$sF`qfm|wdjoD#9#`x
z(VAoAsfAe9o)rW?(WHJ1?Bk?QTuMC~nw!ZR-I#%3afgDF4u2H1?fu->B}lLaopE!J
za&S&2;Hf_(XA$Wof@UQ?*lD-%y4i1>_Kxv31T0QCQv=CmzuWxpQzn_V8i)ONomLNL
zX5wqebf<UiG}`;eN6?|Zb}VSI<v4~`T(Dr_dMHc@i(tPc!V7H<<6Dda0CyYkc@1Io
z8F?x#m4Zz~FMlHla|=Gn!pkLHexuBUuEH~lyb{RG?a?ZU%-B`n8D+COi=;%hHS<zY
z{0@qnHkDf{+8WUH2(h8lyR)W`S4a0!Z?tlieNHgtuKlE>#25vhmV(#8tdU-pnio6|
z#(+hH+-Rr~a!@@kq2ts2e7@{S69h|p)Rw(LpX+(BeSe^=_u?+kgI{{6t@Ls@Z-fdO
z`wY*-n$X>OTkbXX-jH{}=Xp=cJPP3Axzd}!V@c7_dy~!HQwbI*C?t}enrin+#HNbT
z*H?P6orUgK*=NPPcAxiI!CJTXd0EuTd)Y%9rwzdP$b10sjxR)s$I7H%<=&Ks$<Rv%
zn+lLrCVzNBBxDTG#z#fvjLfTrS$so}3C$r($GpPYS^4`KC+?Wk>>Q#|6JduTO6e9P
zA#VvRdZtk!fB?!mUtStvNgBO|v45}B!Bliw<3)6se9a{M88QjqIg4<h&W%NiUL{C!
ztT1X7ud+%?MGPA6%Bb6LDnM&CD?$f~MkOESk$?CvuZ%!pNTL$EUVpwh8Sa}SlFKZ+
z-D!U1nN0)_S?HTOE8~0#15thXt@3o|H;NZ*LVD*T4LnfV>g`i7^U#N#wO_0qOA=y-
z!<R=lL<Jj=cT8(y4dX44qNlB~+KZzva!BNDEPQ6T@G#gsD8NEVf&{}%W!t>~tXkMj
zb$<&)z9%f6pel6Ps2c4NUyR{!Yip<8EG=Fvhk<9ymsZY$&~w37=GBT$SoGpB5A{LN
z+3~2pA{AZOI|K?$E=LYfk#>9$r~r9gD0OT$o-XEA@&x47WR3)kV+_-+Nk&9voL%$e
zE;4~JIIT>icSSZ%xl4J7cEYN73Y|P1gMSwbIM9$h;gC{VNvpkgd~|Zim@-_<99cwM
zM1r}2__EA24r2Fb<nJ!rW%;X)$wh0@`8~8uKows40j@a&tY8JbIi?ok5vm~G;42h3
z7#ixnq!LH@J+1{ze8d3kBeDX>J}UXeUXN98hTt^9V{16g?*(JbvLUgwtQ)%>Y=6rl
zmr41{1#VTI3oxcis>TwmTe-G|XOK<?ly4R5!MX>*RfOX)*6$p-jc83|uhg!Tto*=T
zlu#<rOp1_dShfEp{jF~4@c8KstyaqU@5PHV(!T6B4?2z4M~np`70l7`+h!jWK3pSn
zeDX6x+{(>W%0$LA7w;U%s#O_Ng?|b&?v)J<AmxOv<C~7+0dnA)$p6{4u;1+VI>)dJ
zndKT%I8a1a0dfeMTR=a{lbiqr{DTl2NEDgNGLU)>7Y0T8sANplj7M3j<a1Vxi9fZ_
zYj8(!f<Ad{IZF7X-ja4$y)##$iE5}sw;-03XTIcZl`)q*E3xV{&zZ>v&3`T_VNjj`
zMT06BMs_YY-5w0XGwI1<1R2&CpA6&K5S$U*1h;3kHLVadDNmu`3ZS?ar^y*YEiE?N
zj{_f0w$q$~x*(97$N6ayhdDjTs0-&ydZMB`ff`x?pEul_cFI@*e+@M&o^wr63ZUwj
zF;<}>$-1yYgr4HdOhBds6n~+fO;(b_9l(D=ugn$l^OnA1#QbOxgIX^4GEPbEFS;?P
zp~h8F#bDkT!r@TnIF8v%9FA<S=6ckIHy@m=jl6f8l2NddVz+^kH9$yCCv<zbE<$+5
z$MZQU;Q@W$IyVXk7bMxxQit(89>Uu@v?MN|IYrzVZl@3nPRzD@gMVvm3v-P8o@LkR
z5MGeLF@d`{ZtzTK709LPPX-?HON?p~bYVA`FT?}gWOCdQ78ADZ{;O7dpW9isW%MT`
zb-;e1)D72oH5=3PEn6sT`|RZlsGr?9Y4zVWJ6(7|xB6S`G^O<=k`<{il=MD#@l&Qj
z)3x|s+`ng1ZBLRek$>Q!z2EHv7uxHb?)54`Osx{mdno}gp}XX*m94&<r*^{gA^*-#
zt&!LI>q}es(%NN|?(xv-VE=?yyL4LavUlrW_mMS|;NRtq)z0*DJh8^j{rbY*;f2*8
z_(eRhcS@qa;`8bvssDA|lU3_MNug@DsP`(DPgHI`T}7_FG=GXyV!~er-qa&=_JjXN
z7T)AI87w@Z>rzU0`W>oOm^a=CG6l8PpX7-UhgFB48tN#f@Ji28hmXK^M9x)Z3*oY$
z3a*QCRYW@3&64_~9Pd_5^o%DuYb0Z6IY4Ww5*1~-1ro#FT%^-_UbnL+{5-j9!4s=C
zl_Z2^vI&XI`hVyk;$P<tw+^hCxr2zg;tBXE3!K+K?phX`m(n&vYK<2Ynd7eCTkU9n
z*Je(A+E<u>?l<>a?8oN5?(`)HDIzeuCbczoxuLmC&fM2_jH#+~{(4xC54<A(y8vIV
z;Vgwz!94RbM0@gl9GIVyObxlzRVuL?-vpHuTH|*i6o2M6$!q8yhsI*J5#}%B`opzK
zz`L#8WK>`LPX5vS!GhgXG0aAkc9E0lX`{&8nC4Qcg^5=&LmAKN1Ig6_v#TTEE_vu#
zxAyA<k~mtP=>bv+wFqSDMJ{zr(PRe!OOu3>FiMFj7HRTzUKDdSUuGHPlZn}Mkcb{Q
zPAWl{4}aJ-m2BuJJ)gzA*u+5a6JXmy)jNaD`7NF#1K*4WzDh6Isc(#u>tw{P1^8*9
zwRH+(GPtbd#-S^t?pEi`ejIGAtNr~BwPbv4eDW=SN}c!Dzog%{E{%Gsb?UD1f8%t*
zM4~Z;_yaC5MD7~=q@_s&Ub2vpjLz7Y4KW<}LVu^c{3kgOlNf!=J@jg8&I&jejdTew
zBbYu!;x@jG6qAsuWTm=iW{pqD6ZY~vaG2)2bPD=%xcrU{A$R)6L~M=!)Q|072k&hb
zm6%ddSW`$XWtr4C%sa|UAshr17VG*J^Q}xZ=dl3)Tav}S6O$Nb{=i{tq}&}>-~#zW
zynh<kCpbO9_@((>m^^(W0j5r5h4!&y#Gh#TIP`<m2glr~`830$)cFa$%tA>nQR5gy
zwHB%~z(ri~bZbX?NsqPVP^c?23?KRpbf1$ni(T#*woVJ!Ud`XbH^iq-zJFKZcptL$
z$EPEoLw%<6^vjfI&LKr#3ERI5VH1I64u4%s?oQV3OSQfLb>0_4-u6Z1M4nw!Q;=L>
zl|@IFRjO1;1bPB?D~Oqw1sH6^q^PQz?N|bQD*NksJa`Xot)_lN9gf!AsN>Kwl3}9@
z8QeIKYSs3hWoCBra$dmZ^6yi4ICN@;jWo<Wn|oh-_Uu`7An8bf^j2T(;@qX)tAD_4
z>>EaH>+=IkHJY}(?EPpd<@x6oT9%!i#dDDajtmB@IA8Hd#b|db<-0lqcNZ+U`|;fY
zp4$%!&@bq1`5ho1epkp^{HdQ6!fElUm@X8b?op9@yVsj?@6y`A7bPu2*z5;|9p!(1
zjMxsSU>1`S=Go;eTTCPT-~M$vgMa!EYybI=HQvaUn1JO2yYX9U`D%o<Ex6yjr=Wav
zq5|a5y&X%fI-zmKa2?5k)32g}1{tW)Go9}dozlgS$kwk`3Z2%ePhK%!EdA3;<;sl>
z6}>fj!_ajL1N?-FB~7T#6qB(u2O-$Rfajy<j!Ocdnl}!Q1H~S*WDL#^i+>4K^5f}1
z-1;lrZYJt7j3Ej-WzsEGN0Pbk`I6yAqV-G$z3j17&kU$n*X$y>b51yJ#I8WdkrK}k
z($M27YM84c&y$&!wv^;BX!t%!rXp(v>8T;hhOQ}3<}v2Iu(Ri3EnpwO2rQ{l$g{Ra
z*>xF;Uy=|mfwLmTaFMYHn}5Utedr^iKIXH9j1YD(2?El`)A=n1CG%oMo8D~$nZKe!
zm00O8pT>-c$JgxAL0C23ZlDfYAKz7cm1U#n+nxk*xxTI@tf^r8;`)@>z8j7zQ_u`N
z8x^@BVw3vR$cl&?$EO<Pf31+K%wkiz<|5ye<rlEpmThtq;5yvbLw{pKyxo0NPH*JV
z%`49YR13I(<;ERK^<X2S(wyk#T&%~!Yr0SbKblMNZdv$O)1sJ<Pka62gZ_T=ZELT|
zt+{7<@x8T*sO@CvEJWUKtfecMnJA{3Nv}^%Ia|Zztuw=Ufr5W1lP5Zd+2!mJS-7I3
zMv+%q=19@)wAJo?_kV5wsPWU8dP}bjM9@*P#A|Dn?+f|M$Oo4{6P#F>x7qB?^^dZr
zSu)V<S(kn_HQ_Kr%ChngwTYm~ovw-fsF#sO!!LV)<66pBJF;as@goPaou?XE?YrDB
zdLXF|T%f`f6>HQ6eSr>n1~zX1&camzEWW}DVC9IO&JR2+oqr2*$u9qEKoR*7?-O4P
zN?FHBco4ae%s79931z&erLjyRh}Ynl)_9!*tt_eaC~1C?E3iQi!36;m1aIMT7Ko}_
z-z2{K?ne`sJG>Vkuy;iXkY(y10)jtTvb)n2YFInS>6AnNe6M<-_*Jl2I+LQIxTEm#
z6zPK@i$j{v(|<wEd8ZI($gNtK*heLF@?0Iq&G`bV336(rB^aVISy)?LETJY1pJK84
z*j?FfrP9}dA?|o$Y6P3^`_efCfbQA)Cxbp@c2m%YJRBETql_nPil&R%G|Lm7DtrW0
ztcy-24A9bNvg~m0cryEZ)g@1et4T!F@oult>w;T#tAG8v-)zHG+7IYZF!6~;gYs&T
zj)vwz$H)h5Fmg18cyI*ijG}j<|LPvMBa&Q*K)G^E=#-aoj+XL;cHX6_B}Yd~QOS=v
z{Gd_}#6lyNd(b%SGLC@Z59Su5iuDHC=0+Z=Qg>Gk-|L*x=xEsFqhEl6Zp2z!N%N&1
zk|cv%=6^j<U=>N0NWCHT6!6^ItKr}%kG6Qcp;7L{u3p8nC6x=cDWo-u#B1%er1qRR
z9svvMSPGYK8<_kMC<5cd03gzLY{xIT*UQAil9$bPxRA~rzRPkHMkoV*lH~fX(<%t&
zgK0?v-UFgjNo07)#d?ok5NV@~xR+FGZTiqi)PHvGziBr1o1HFF`XNK3et$3>Epqt3
zwU4})-n((MFY3c{FLCA0{{}DGgZ}vx1G4`QFm6F!7nvGl?bFQlzyre4fe(3`=J1$x
z=Zj&QMJ>kAk49-XnLskbKT*0mNPt<<PO}<4eysi8YWJFlhple2-EH>!)wMs-C&VBN
zGJg^Y2t#}=pir9k3+pr)j229m{9%yKhfMT%Y5g=x&#j*T!;PO<FHB3R|G1c^qjY|&
z{{(IN^I6Q~vX{iUJQDlG>v?jry;;TU1>ZE#L@!@N+nd{)o7;!cKmQr^kGgO7`iG77
zYyAU*{NB^2+nYE54x&K}$BwpW@MM%H1%ItJc`F2}1zR@t9z_1}Rf?T405G7`uU<y{
z`~^A9Nh{m$PqXP@GOtDbSLwVvh$pPk4TL-=^FduqB6vAmhBd=^3J0SW6Q(3)KRnb-
zt}CBR*+S=PUyMpU=%2N{<Mu)8^(iIriMq`_LbH8>GK%%m;|(*%=Av98Dk9{{g?}6B
zRT2*&fA|b&F4SQJlf@dju9E5i-OwoE7%DkMI$oLedzgr9XyjNni;@X@%`+Z%z$i2W
zC|(dGy~YjzLSpf_9?EvhSiUW+HyFPs6|D$#!4Nycp2JPi5+l}B%oFMCch*Q2#&*Jm
zAg^D)7s^Dk7Dq3l$M$c#eDUT*0)Mn<?TJ@Fyd+&DFsk8?>~Vtx;l1PD&nL|;zj)eh
z2n@q+kwTs?1~iqEgLdEky?Xtg$$O-}Jeg&K#&D>-zt-*6>+ov#GA(aG5@VP&<G(aV
z!kh;p5$-YJR1~ZP>--w9kmhQ4c5oG~38Xnt>!27scYTZ#TnmLGPpzT3dVdY1>vI69
zt-E$GWB=!N<H&~^&f$kzYNszQ4KzPxk5spJ*zdk+bRa(MwAcJ8Ov$(YviaOg$>{@8
z@~yvkX|!)9PS}CJqIWl^cbB^5#sVmF1jvFiy){p1>kBH{iJtw>U`OY<_(Uq+o2pU9
zqnr3PkGB5fKmM|{by$mp`F|#7jAAnEj~Dag1Lmv8?0<vA;t<%@{~Vo8u{8R2T|84d
zqW}-j0Vvhj>w`Dh_yxeX^&jjVeEuI>-{V(p%P(Gtb@6^K%vS|<_zm@T@;<2{>LFeL
zt`Fr8zy)LPDVZc_7J#x-&bnj>WjpY?f-m_n1>*tG4+y;C^n;yOi+>d6?CP$MZ~Kh@
z?+>!cMS8g)m+L+RAolspdHrgg_ms~O^r8jzNr}zcz__4{I{LZ4ciQb8AMsq)!JcE_
z5o9;xck9`XN0-@*?REUp`hbY^(%x3g_6=TT;GqOy5TR&dLqO~xwK)ajYTMJ9AN|>b
zW9&e3#lzG6X1D*QB!ASLK?xw0<im7Ub>KulJAIB??aK95ExO*WMp4CplK8!9f!Nv|
zey!J0oe26uhyet2AylGVfjs<}P{(9ia-Q!TC`1i%%3LJLi2F-qYqJCr4sy2=ZYbr+
z)O{qk5Uf?3TO-_hDNuy|8N>~VN$CWt-+W+;y<y_I7h}|om4Ba>F3(HqLEv5E)D{B}
z5Rx%>OcQPf5x?40QwQ%NHki(5wFri&LFMHN8UU)BNbz(WK$$xdJ-q8UU~+BmP3QRZ
z^_x%g(r6Pzzx;B+kZXQ51M~iGzb&DG&eANx_lyUx2zwZ)w;|&^9wvLBF4^ldPG;Zm
zq9-{cX6O(?;eRd@2HW$+Wn^5%x&a$Shq&C*#u5x`p0(On(b!e+DvLj~0ll}q(+1xn
z#@Fy9p1cwcR&L2I=E+1juMjmuJD--_29x?zbWAq;<+nNvdlbJ%)z};gNNkXY5U@YU
zb#f4*?Z5=gn`Yzf&#Qn(?@$6rZgadTen1C6B}1-e34i3SN4+qyxuYaz{KJOye=|Ip
z-1F}rHXA<%NHTttD|FVUt%?k^5LGmuvZqDGBe8$8xxupv)&F>rkgLVXQX-)jFa)pT
zPV`w*Ho{QjG|w^ki~WWv25`fQW{+Uq5K?`WjHWxVB8{|hg3q-HN_o;~?{|({`<SPv
zkKB^|V}JBRwDn!pr|LkZ?0}ml;mI>s56)Fs;ZsB`NBkG8Hna8*@iMEha-q~`bO+jG
z7o6&0%k-k6TK-@*pcem-Bt|u~M%u+DAL&i!HAxuCVEc--Qq~yMh9eVRCntxXWdcg+
zLXm#2s1NK+79TiZ)vvD)Td($h`icK8A3^#1n}5dJX1{URdfgUDM5^8cu+NgOO>5d9
zpDI)^9ia{Za6sVf10CQgn6u`K2~VbC3=&~Nx*Wwo%%2xS9RP9z!+a%h1Q;!;y@^a*
zt2E|ti5WhCLT(mqZPmZ6iU~0u7c?O?a#dua<uJ|BbrG2q=@XcI7$j7iWx;L>dqreA
zynk%8kXCD`y;A36`yq<=Li~Kx*y|s6`#-6?R-1ixLrjcloxC}2H~U-P_BX3lZEUCW
zQR62(;&;t`z<dAT_%4ev+2=rKV_E?$`d?6K0p0l)lHJUnaRhlrbm3WF&<D1I!6=@g
zKaD|&s>tJ+W6Fq4hFQnmpV$#?M&11%;eXxz2_q}FwzZtv=>5wi$J`tw0L>bB?g7t<
zUV?^eA4)*8_sP&4$aG)b+N^K=8R`nebDEr@D5sDy5({mhnhZ-^iRRxyn29+ibm{lc
z7wL%6+P<2>>iOro+3h6BAf@5W6{$#w-jiQ8x)+%@M1m2ALJ0DpWqnwNI~C7TDt}{u
zJ$0=`Dg5<$EqWqxPEbTn>&#Pi2_8pOq7TMDes^k(#;GTqLhOo3rdghT=t~m*n18R?
zRI3WIJ=d9Q@GyqszX`6|L;l~j+RwME4?;KjWU}j6_0<-yy+L>8*dK7U%h2Z|7oHws
zN{!Rn1p2$ahZhJKDw!6^x=BXld4E0P5fxM`jNd}=e8CKF>BM5zNT7hgexXm1)5ru+
zq<KM=@6X*{^GH6@NBBxd6=3Q-pAS0CrYfph<>qC$^NhuUfpIDMZ9Y%N_4R52Ix4e9
z0a6+u2L_n#Q^W*B0bTPmeDI!LXe85~tA@2kb7fJ4NdNf27GuTl6)=4Xseg$ujFAKU
zvFaVrdl2^M-bT({^I)pNarPonImJ@TfCCqzzxqmOKv@qmz~y+HQ0~uhdU>Vi>J(-F
zw4`5L2$Sb-jVnl7!M33p9!@0gm)0LY*b-am!5lOZqj{`@5@vhHr|ll3W`ly-J@LSZ
zV2_C^hl`;a<cPWj7q@cl>VLw_!B`7$QD7uvGKY$C-DD1(e5-&idyRJgu=`3Z0nCm$
zrlEr54V01!YD2QMT%@ynE=w^|UJ02v`Vbk`E&~H_pODD`YEo9%$W;t?g6foT{+nce
z6V5FVEbu+>a?Yl-wN;=qZi?GQ<!^<%I=cU^jxyh-j_$pwBhRLe3V%0s)N0!|+facr
zicw**(az2|om4CAceu2m1Pu&Fi!+96{Nx)h{!n7L?lISt=$D55Ryj|Y(9Sy4qQQ8|
z#>Fui13I_9ct@p*pohn=`v=FJqlPns{k=lIPc_i$;w^dhWTh?;kN1!0SHUQe5xl~i
zFaY%XZyB}jyzVlwXn)sfxBly7UHtr!lGao%Vn$GKDWLT&+M;V)6JOXlNcD@e{Pq8r
zuLE^vP5dwf4UPpuV;bwb36H>}qKys@Kb1RVTnt!{d6glHZ0TPsO!mt2HhUGS3bFv&
zYsRwdXg|Rp*|tK_F!JAz8L!J;iBU37c0+w0OD*AxqVAf%g@1oP@L#AzRJ<?I>htYS
z&Gh&I!BMKacVb;l7<L5UoT{|)@A#YrYaXAx`f^7X&eWw7R1=b?-#9+S0<67^4O7uP
z^@J~9wwQOp3?bO_`Rou>(6VeRd!ub(PWa7KWMAHC{r{~;C!N;f`F0Ka3E{4Iao>G=
zm&JYe?Hw2Q-G8@b7k4tBt-3Nj<+tRIN-b{6=o@j>v@GvyCOrud1!0XxV9?TL313Xn
znAS91oR8AMj$E1eTB)+9;iLQ+L2-yN-|Y8sAKTO^2z=LWcRCr_Ef*8F?Rl1sqTcLQ
z4l9(jyw7}g+c$d&@}b~}Pd2&{@Ln8jyRHEhZSE3M+J7bOB=K<LW(JN4IFu+Vz7C3+
zbqu#ae}yO>fHsL85;n#!$%g?G(jm(jeKai&op+YgN1;~;`~ej!lVgc((7hy(MMJr^
zuB>ZP_p3L3DZfkP=)6<tVIrb^{Ki=WV4U;r(_H3JT1W46q~i~E)iFW#4PZm@{4l~h
zIGrVUYJV-*?czgNd#S3|Qq1*Yuf$;Eqzy#Ykl99Pfn4?hd-YhlQG)#<+-1a1-Of8E
zB}3uJRu4Z=8_+Rre%SnObJIpp-ht5aT{>x;wCZ}BBc4ZCmYQbBn3CF$wH`wD;kPNH
zwh)3egSc(=dzXIL-rW4YeqU5p9q^c1V1Q$?>wn)9SU()l<8l8GgAYT<B+;=kz;x@p
zW0#Pyu)B2^Itl8i$_-F-BiPS{i-{h+h%m&b#0@bAY6@yrW@Bm)b7#v3DZE3@?%eUb
z8}!~Tfu_{)K37U}YGCMn2oZJ31rw4HsV{gkqaC~(6LMp~+k9^f4in?UWkk*Caaw|=
zg@4Gee5Y3+yGvK-b}6&OAldb<(Tf*~A-F%a6)`4-@4L~=<qyE^uXVwd(x5L!C2@8$
zu@uua<=YKLRizteg!Y_ga=;gb2`J-qV7PIk>a}+a{;Qy{dA`lL66ryOU0ynjlhH>X
z{Rbf%y!5MoRlo1PU45?azIEmTR^LAtiGS>k!*`9JyG}(2Qi?r6-AL3#{~9B4%xFZ~
zSWrCz$o2H~bbo~y2eO+#&=yUm)R=+X-d5rAqRM7a1x6}Z2uv|HapYv_r=UvR_oW8f
z)AQRogj7PGE-6(pN_&14Pl8*i%lNoyc0*d(`Auf-O~urRt?^}|7cf_Md+(94DSzJx
z9)cV0U)fr!d8Xly8lBgqQFMSfj%SyUIS4CMCl-46peS^wcgF-;P4M8U5%6Lyw$=Y>
zYE@6V#umcr1;ads1<CC!PuwX9lT>i~y8aa{)fkv^4#mpiIm93=*_MCBOSZY+>^1j#
zOhoN;PERnnq|^?1l|@`8IJ;@u?0?KXcyLjL;kecX<Tvyni=mPV_2SvJ3$X!UhU2g<
z=`fy?vt3PASmcxglC><R1V@nYH?oV3bMQRLapokiqO<KVnI{9xs$B?G2S7^z`ugzr
zRpU^TD+Mf(0stVF(XpDQpaSdVhzrK>KEaYPr^#r<Av%X0$GkM87TQve_J1hyVv#2o
zi;*=U7K5ZhkO;**Ux+&vgoM7cB|rc&@#^&806ce(8n2uE*PTZD^sv!s^?vqJ0d5F^
zD8=_DSGPIb9Ew3XOrhHS&JHC5#w3rgXYph)irHD-u1H*oI+UQWF3l*|5z@heD|X!O
z^_xHKHPIgWlNADswUof3#(&}B!4(m>1fE?JOtS^vR*VS=!D<|Tpzt9rTNBvlh|I`f
zZ=RZ6E7QpY35;P_Otnxb%Q%nTMeOSkq9Pzu`xV2#d@1&nghCLpx?oBMU)B@s-eqJC
zW_pHxw;xE_g&cG66bnjlmBdq3#T32bGIZy~%CYM?c!I1ue%_v$*nbIcZhs4Yb5A1p
z8~;z})DIe`hrK>S4u&T<&MOq}^)>JFfIzio%Gar~!N$3`{bt2j68ht49n1Z!<0hRw
z6s{qvZ2$SYg3T}_Jc_4Nj7|VYiCL11<n>hi3aRZVUQ7m85dQ+k$m?+|>(4%8|2UnD
z#XnVQC8%u~M^lJdV}HX==Im`8Lxozq=9#D<VZ4!14yey0yLmcJFrj1|&A^wsHOEX%
zMg^v)TR1W=(-21#U}x}_7#=qR-?up~56LQKty|M-={~!DuWx0Z!Cjo((jxTgO6-=*
zAO?f&4h>ciPleeZlhJgIbsO=p+YS^go9$<=ba2!-IRRV38-FnWcbeT+*NmSvjHjWd
zdMupQ;Vt6}_8Hd;HkTo{Jf;_wNA&NiZijT;f!^}xR%VOciPob(VNcyq!-)zSA;s?>
zZQJC-2lqDH`_b`%87{LX?VmDvffYe3TyMxy0OHN}{W<rKkre5m1<4s2JqBY@@NPc>
zo!tK3?&<^VH-Edm&hgKDh~~jAnWzRSs4KR&p8v<UTi<Pc_gyWz7-j5!wc|E~Ak62Z
zWCOMWuX#Fwpw;ibi<;j>-+vqZ<)H2^1I<OWW5Kd;CWic2Uqb|C<M6bJ%lON|_un?Z
z`|dl;cM|PoQ!M_0oF}K6%5y#kPV0toPMESxh`|&kLVw9!lMi^Y8R}!|YAk?=$q_FY
z_lrx6C-XeG=pV(aaMC$GVfgp6$VRz${Dz@9d7bnjn*^9taQ&P3=i5!sc`O<8w7u8Z
zd&6F%z?k0`jmcSo(=M<A-8Ya9LyX(l-)A?ni^J+eZo{AjLlRpd$||<H|8?Br8#WiV
z?Tq3K(tm3m0(IE$9B~_Z|LAzXb<kpqZ2lz2+hT)l{rUT%Rhiff=^r|6#sV@tW{Z6N
zGjc`82M66|57)OvklS389I(fZg<ky^(ev%1PH)*QKW41gKAaS5{q5#|d`~Fb<CVqH
z+iR8%-ZTD=W3F&cC(<PXZ;`K}ax}T-%8U`PFn=KLyj9;MhcS`gl->sRWDR8$nPM%#
zl{krKqm;__K=<wX*7Gfl3+g89S%CKzYKF4sEc(;-=3nZHK8p;jr|lox$M4#7K9!0{
z>{;E|dd>*vlC)ZIc}3kC%<&H#HO7S}6UG}snzhBbdS-jK)5N-m%Dmb=eWjn$&nL}(
zyMJ-i?Edmw^n$w|u7g+FIwhW2=L;AAq{|`xMJQ=Cp&uERHXByMV@9zU1IB**sBHOs
zop0Z346Vpu4_m{`$G&eb$R;bjC~GVK4K$L9zr&}b**-mDw|$Q>S6nNw7KE|pV(Wn_
zx+$`oQ!8r3K?gUsupNP&HQO$1W}F9Hynhm{>7d}=m1xXQkhT7EVQXNn0hIh5qCarz
z9GdWi0fp`Z-KJ+-Gp^&8gTvGAo0|1wt1Y-4HJDWYD<tXAWz-Id0w8I)-eLEE{zfJ@
zbP!!XWcM|mtw%E4m4u#C#>37aQ3BYfNzXYM9$#$bbM0T-lOf`?&6s$w$-p*7!GGU1
zI{Ri5(DO}WwgK_LF8C64ZHZVUijhp}narWqC>JWsw4}h&LhNP+dA^`@GLx(sU1DMc
zJ9#H(CeLbH5%7G2Yk*W06d@_?{ABj={0Mdq?+3Iluz}_YlRB9YfC+j)of-9BiuMiE
zN%v;)B##Hg@V6#RW&jy=NmtA^DSvW<W;1{5S|tB2Te2Y}4!unVtM!%sDQ#_(E=Zq6
zLuqYKnEbG0(fSq-85h=KZI+JPiEp6o-M|p+2~)$h>hZKnvPWyemI$^)c8}gCLq0&^
zyQaW}?pNrd1yLmO_y5YX2_nr*Js0w$E;nP6JOf4dMKx?i6a?gG>AU(!-hZ~ncn0y`
z4Sk^e)L_C~(&RNt!Lwj1SSKXFrlHmV{3uG&$^2k9ui41&w0QZ_nZwzmLqB&la3hG1
zcvj@y!0&w`qQTEVd7VM!Jy9!xJ7FJ}_IYnHgVYnR7Q@SAzK`o!^SlDbSQJFRTXxbr
zANjROw8%t*x|4El_4T#2V}He>LS5%MP~V)FC8toC+^9K78NG5y&BzlG83|j+#wwzn
zcy=!~)9%{qy}eqrH;N~hMjPU)`h%EZi!>%`p>Hq(s14Z|K-;-7Kt<-5fdHgWp|BpZ
zpHAoLnBnKp(jeB?UM=Q^C6z=-2A3HGkB+hKJlYo^8snQh+B-QFu74~!rRl1ndJGeH
zjiBZ`4>Zh4HbvEn=}f4k2`g4Xez=Cn8aLgUgw=3oM+3;Nmb^j^F<`9Bb+o~F_v?sV
zrmbr9n6Wm0=6|?PAvCH~2GC%e8a(HJs?pPkeK3A<`g{wm2Gnu$fc~G;=zG1<=D`8{
zpVJ5;X|-0+MzrFa9)C!Z`f<$z&+iGGT9kzJ2&Kq^f0*G@JWrh&qW!Mb{*K2RFBon^
zTnpCnjHX#GVh^K=m7?yuZz29LuhBeCtf7tA-veH=_GY-3jGNfyaewB)rx!dvqRilk
z9*7&WKG?#j>yr6I=uyA_x_!FW?`v_*5Q7N!wcjtgu-}{am4Ce&qY<B(Vd2)Pjihj3
z3=F_<@5&$XyuixH<O}+BNY*;#83QMP!6%QQp@N9EG<jO^2S)qh2RR;B0Y-2HPoG9V
zMBhCxfXu4+hBr^cx1pU9u{>IRMJg{+t&CE5B%c?ho^L$>N*#R;64n7TMxNZAgsp;C
z-#v%Q=f%i1GJlb4RWuSOxx(BEy9T4bOOh2vt?!=u$rY$)e)vIteh?&k`O=GI8ynHf
zXtOG@$&YF);MhZuEsjc`1CgF@{eFlPp4&jArD*hg%TJ<C5sRKbB&oVD7HMJxR-$8T
zpuz=Qs6b<^>AujDX(A-%hzL|6iOeGF1L(JTmdHsq5q~Ayscglj3^0WiAWJPo{m9TJ
za8yShQ4sR;lk8@@(u+P=DGe$g7zEk>uxF%7Ng`;g&!Pr6(&eI>3?*<w4+IbtL1B*W
zD$~&|Ioh$t)QT#fBp+gsFLp?<V;@ham94EBFv08)zC#r}I0j=nXfnbI4A5ejm^{&|
z2X<)Q>3^O+Q4dy9W522JbxliYq~21nQEkmft8xvdYt654gJg*RtC&9(z-<UFly`>Q
zKI^Su_x&dX9nSQizysKYLA9S=r@1WFHI5-wB01<qGw==LnL7p8=*FzDsSXUnCIP&M
z9o@Rf&xE_%=vh?hRks=bKZ|blwK1Xj{5JaL_J14l&w<gbJHYSk3TvWqJA8YHtl_mm
zF-x|zEn{VZ2BD`6EJBi;?dX!!Q$SUc{{<}s7@g_`Vs|_FFvk-#MQ&Kg^~MIB<#qH=
z5TQXjwSU;QfB4q^;d^I{@AxlIpPHx=c&QPa?Umw>pKYb`m*?9>YuC;O-GI!a!HPqr
z&wu4)mRyI<<r8fZe)#_)p(R=AY>d@fXY;v^WYzVHr?ESqwQ{P`s+(M=U6s~FFcj=3
zEF&nakc?}3B7Xel*UfK2TmoYS3@;~!2ZO-^ygC@GIN~l*Q>yLWN%Cwl8zc?MIiwT9
z9X<lDPl*O?(fCz;ZLJ|JOTdSm$6$J5lz(+yS<dUv|AUc}M$|Pd@D-%JF&e@zQ*<mF
z3IjU3amfIDK!d*oQ<+!S*BDr)b4o?`U9>J{j<^q2gBPJ=jUiY!p2e55czPABQx*FS
zDg>@MiLQI}f#OI|yPO|Sx{QpTsIudFf%%yLlU`ch-va(s@cmVA1UQkdKP8hjJtNh|
zbP<0OimmZMI5pcarW1Y?vv4LfypJY(eO}lbcV^xY_bfOFKvW+H#)UUpE@VSqA3wml
z^LRFooE<LhVol7)2~5rJoV##)0Qj|-J<oOH31^!IqOkbIC>_kH^c>u`879!3udV3u
z3^^HZ)o^TT?)^gT!N+oh78a^@kMqS7szranTcT#3y$sj@Q_H|g;mcz3e!@7j8WpNY
z)__bUvuhL!Ag&^Kk6QUF?{fF}I%O>*$3sHG4E`ZJ9G11)78eDCGh+aT+g3wprp5ka
z#P3Z!HM`ZUUPeN^oDr_Ul{Jw*FgQRL`FN=CH^WJCX<zQ8;dBS2Ti%--LhR0l{Azz}
zT0A&Qoksro&wC8Q-9wfy-<b1D+XeTC`J9lTDIX9JE6&fG7vb`dyxO&V7Md?{bvKO0
zA2p^)<o!Ua{t?6oVNQ3ESr2TvHIw!epQ79EjOZi&`Yj8366`O`k;9`S8R93^3MC(@
z;_U1p%tVoC1Re5n+{J?=M>H`;FWi5%JQI00#n^ldh*uHW8dKD!v;X{{kG2~<eVW$T
z|G?^Os`i90xs2bhN^K(4WK5cvWE<JkRh0|!&RxLu<1lipe6m9^eL;a&o}mfT`W+5P
zanxVNF|n1}#{{p{6Wqe1a%ZKqjsGw%x_kBLOvTCC+C{o)#JL=#5G^Ki*^_@pL{^tU
zmr-QMQ8&c73J@aC6O{&j4$fEX_k3-*z@m<?Pfmr@z=!~2$u)DoVj9HNh9$h7F80lq
z#6hUyLY24g?Vlb)#vk^h`b97TY;tzgmB;pXtm(iH)9K4k)&9MnBg27J+`GNb>0a-&
z)70No;ilbc9~=jUpt8a*9A|&=UZ>IS!auv6J@B1~{uyqv-$nO|&?4cMv8$lpy6V#4
zpIx}^O@6pAL><rq@Zy9bS8@?%kTV{VaXor*P;j%tI+ReT95WdvJOqBu(?2V%(3;df
zRNg1I)f%Me$!0>)hMD?jX%1o`WaMK~<=%K2<yXioYgh|+hNg;VmkWQKi%o-4D$1pK
z0)Z&<qh7$4G@?8UDCQm)%dNqvQ^tVfa1(4W$VQ_?mZ6`H;z2^0h}Ix<SL~CD&f~zi
zEwN%0o}p9%uest;(y{#=Vge)GQEsNY+5MQ@Doq}KB*PIL$3Z$79snHL89I+u=sV^$
zq`y*jLnLxA(Bp`$PyBzt=YCAt59!8mGKLys@IeNB;|u<4g$>3eBsMy~BHV_7jelS*
zZOUd4*KrEsBes3YUePHV3H|}9#qC`xRdvmfZIs<?<ncuU?J+$x#9?8bV|EAz&19>t
zJb@gJY&_POArrtpL>&2!U=>e=h^ojV{4wI&&CUn}*43q|8aaQZmB2hmR9zRyvS;l%
z<Sr)c;m;X<e@v%r{Nfxo;$+cr(^P2j3L@1Ha@~BnxXOw$ZOJT}V!H9Ps_c?5_zU>1
z^Tm}%czO`1jh(0x1N_FvV4tc^rg9GGbiV6CpG^>w!egzpfw<W5Y!=^Q$TyRMH?aBv
z(6q%Q{a>(ay^DXbEW)GcxH9?wwyQ{)M#%>hwZZm*HQ9I-7~3qNTiy7yc*0ca%k(s?
z38zJaKKOL_Hq&)NBR60lN=b_*S8?FIC$LSK8ydJ2*-+zC29iVZ-(Q9wC!k}5!G1}9
z+chpBeNsBfyYMFN>i))NOYxqvziKP|TWENFDX`4H{bqlfWX;y$1(}QTTyn`Xxo340
zrxX1$x04&k1S8WIPLdDvy(`w^WRYJT%(BV6g8iRFWA>je@?kX`;t6DlpdZ9h${#jf
zPQfez#7XwzztNtYpIKAc8}<RUDN@LSV6lGr#!JrcFzSzgNhhAs2C#*?Zh4Rx4+Tb0
zjRYy<@u7dMNtS^MKe`}<rRX3;kk~LJti+~IOjyEioJM+p`SyKR?2%MQ@W0ya;5`|C
z$)w)aL^ggB<x044zg7dFhd;Ss=`n*mj+667t`tylV7}xsRdh&H^TNkTE<#v|CsBOP
z&OGMK%{3bSk*m*ylJE@K)wAeg6kp~wvpTJckyC$4`nu+6tttLaVH8c``|(YONiz^P
z*lx7<nt#S+3P*KmzyUA=43IT_`~Cpd@ZGnXe5&_AqT%cDd|Uee<9X<zZJt#|Tn)5K
z&BcgRKaT(C>4u4~o?r~&3poUbfAV2EN(ZTTx{90tAzh7jXr>DPr^xo{>nhRF5{9D3
z15JO-!B>L`Xg^-f;6|{Mf*5q+bzHbMF#-PMAHT{$g0sjRydsCMXVAyd>?*Hv_{&^j
zRGkkL>sNW5K+QL94E*Sh13$6`RwM5*vdf^7t8)NUcZR9ZIFI?)NBDAnbcZ2{tAR;J
zD|{5|mW$ZbSu#p7^N1FbDI;}Ff$s_9BSe3>iX4byoNK}%kL?w0Rc<?b?f)nCSXm}n
z773qRKCN;n2sIsqQ3UUl=eM056>8|iJx~j-dHdb@DyZY~T!&@Ui4kXCFXwF8Yv(Rw
zXGeQ00V@z$WJBBo602?1hpnQf4?KrdFQh%dOdlzkjG#QnEb-2XjcXBB+tLlL`lx?Y
z-yBXGc0Jbirl`7>EztmTXxUGMc20fg0k`6h^JM?9Y|NJxgQx`+FodiJhmF_W{<f};
zf&Eo=#<ij?FZ9X+J>PiAiIcvcjhFb3UC)~wRJ*OYBTA}M9atJ7e56-K{~|)Is>L0}
zw`9|&qF%`H%`vyKD0=ClLtCK(=MH}b_ajE-vj=gR+{Cc(%7jun5wnqF@!OSQBgiOM
z<G@l?WGktiE*I%Aq0f0DbvRlcAhd3tgOdyvu$}0^uNyD}gDc~T<~hH2jG={4{dATL
zpG{{8TRi*?m|OWT;*{!!$OZ^bJ_;w;3=(1F6-ABGyahg7GYBJmeR5jUw9<cuq^PSq
zaix0}ZS#>{2ISWG68|pz3&dLBRh{4BS)u;4!}o^2ENgrsc3i4;JF_|nbhM`h8PnWa
zeWrhxI!|*rPq(SjK=yN1LLmyo8=^h8Vvj_um`3WQO^l}yA)@10B+uCp?{^D&u*2>j
zw-0~b(aF*y3mveYrMuzBz7&5ZZ;sjf{kGL@K`=Hv(pJqile)Qs{_{maVid6b9V)%E
zqHv}5y65cGIeP!>_MV70@wU>_!R)TKwB9kC#=RG}`)_cPuL)dx4+^fbJD_ux33^sM
zWyqjnEZU_8s{*bRxDFft(>jz%?V9^51I`{`#Wgfed&fIVzO%`i2Qq(MQQ6jT9y_ic
zLwj{lHCVv^hj7|WH|AT%6Cpi8Ff^)Ug*g(r6j{iHxR2{`Omv-AQ&T^XbD+o=3M|7g
zVNCic7aX$4JtsWBP;rb-QT264v$)QAEC^<X2<>IuEe2dL9^^8^Snx$IO7h`xA4|KU
zEtvos{B=F5`uI>+(Q1FO@yL4&HG!4Agxa~){W9&YZ<MPnpHqV_ME_49oj<y103T;R
zrx$|inMt4c7V&~N_VyrER=4@zr;MDp*qwXVY4tcERAOgv6&)rSF%jurlQVgD|M;l%
zl)$Fl^tk!E#ZzbAYXMkRSjpY3cDL7T>@QgmaXoZo9;Rp^Z{&Y+5>PPyn+&~5?lwB?
zaaSQDWT;|q<BX1s>a|20WGIP+LJ|`6&J&Da(Yy?h-v(J29#>?}8O$NU6KGY~pmm)j
z+1L@HJ5W6sH_1rK;3^qn!d&3-IUkCth0hbLs!gc|RE`G9fXCC8M-|*dC(ftmY^}G^
zNec05NfQ0(`FDTY)kk-F!JYTdv4J>T2Zp3-x19ZZ3EF}oP95|zGYSJ(8?cQ{p3X^x
zOeji)iDdeV&kJpWx*{Dz(uNpQebP*k{>0XOlN^s34uBd=A2UL^HKnSG6H5By?cJKt
zYc>}h^!XT1X$;E$NpP;oZB0|mXviK2Cc^sH2*cl`kcfW*b-~yTT!2Y$cavb1QHH9<
z>~UT&J!*MKe&r4evoS>aU7!d5EazSj*@S0#&gbsR?#~~>AG7v@VJi<}MuVaV_oN$;
zcX9XQ9nH0Uv?)t2pCroj%`PD%W@XPad}ZVWZo>wIfq^YUIV{y8#ylViz$3uE8-r|o
z4l$}~8vuU?lfGDQU;&|d2gN)~&B6gymS0^)CO$uvxGM@4h<hcFK^)NX#oZqT`I+vs
zQP@=ln2O3|UM#He7jAeviO1;x{0`u1ix+P(9U{L;$?h+}3$N--#|~0IG`E4fRlZ6p
z<$Z~X`_<)y+W-rH)#yBf^`!9polZpxc}Tm1DZYP`K{`yhWtY=$P-@kp!Bv*!`XzF&
zJ70GQbF5>zzksIyaZtgU?SZEH=)((u34_*<(4!1$Oc)Z3GGJ+RUrU|&;pf7Jc7f>K
z>+ggQMdTm;NPHm1wGbmdBRV`B@_j7xShWfCgc`>C5`IAnDZsO5c5|I7P4wv`IT~am
z(1m}`=j=@)ugWnRqBjJerah4M=!*&WzvL_y8*KyuM+zfUO>4xRNhV4L<XL^m(g6-T
zOWL&M{R(ch##2xWM`e53s5KYtK|YVMO2h!NUn74x<ZjLgEA$hcVO<1rmVhr{)go#g
zRj?ZOc>*<BG^ka<2iBT1j@BXc2r9xP>ok8Kc+$=iE@5b1)W)dlUR9lal)R<`%$b%i
z#)-~dVzN1xmfKuJ5fOi|`{TW(pGf0LKb8qs;p!A%anYm8%1AEmg7B|kat_b(EVw!b
zzKWwAn3-J25~D^ndMuY%Sv5<#m#-?yfnL>h(25YPe$L*}4X8TN2@m`SY<oOvSebwP
zj6frFD?7rE(z@zNB>g0sdVW=Phav7){KH9RLG#QonRlc)iE;FZDiz=0x<48C%qk4<
zwcdC+y_l%qjn1xbEni9HNr|DV72{F{dYm%agF!$><6Oo=i$4-L=Fec~hgud#x~{Ct
z@TJ*5e)V6?y`E7gT2czno-l+>4Ap;n-Nte=FlL1gNu7>9q8V=uBWVCct+d80Y1U(^
zhf!a5B8k}$yPlXfs3v|FJkv^9|Kq{Y1{PI_Fa>x5eXF6NB~lnAwF4*UIXDQNt>|67
z&bZ2Jl$=EQTJ8X6J1<J_NmWsYFagLeD!porYkJwr`^N|DhibrgIJ8`H@4kOK4MNZ9
z`|KckB7DldI}zmyuE%kIlH62cku#T^c&iaQD_67~;htZrhSh2XTRLO)(M8`LvBtOL
z4ve7Uqie(0z)co<sELZek9QJQFib|tUC^ZlC#c;?_ScP<|JM_?6LH=BT?wt1V2HIu
z4yQXW)Q>AbO4vt(0$6v`4tsy(Ui#_A#%>f+d$A#ZNq?&=c&OW77CQ3M3uj)cP$6u2
zloA|j))a#TF(enE5;RCY8+1)-O1~6A!H97hB@knj&u8o}ysvIE!%3)ve40Gi4y$5K
zYdG9fnUMniu*YV=c1FExe8Ikk)}y1q?DGdNOt${1z^wSB`Rp*6tO$SgRY6IUl!GQ;
zkPb{}@C*I^TO^Y0+y&Muk$4c`KK6jXT@us;WDAk+jKu~DJ7h;pn!9Kic$wWOILhM=
z1disH)f8G7Jjr9<c&o?JHU34Qls(GM4*CT2;ddSYC*WXgGG+4ohh9cg6otPjPM0RG
zLqhsWwdVhs?VtY}<}rVoVPKp5CkI0XQ|KB)$cI7)LPhM_Sht9tGZ;;yMd?sPc?dGl
z41ee_?)Ex)up{8}@<?Awt`EPvL&&J&;^0K*bk38@bmBQ4cJB&KL#;=PT!hd?c4zbf
zc$}ha?S?R_PkJPyb=^!HBp5@;+g#xS--o(-){)o<LBAHK)6jo@=KdicoyrEPYJpMB
z04P<f+iUH0^(Gdj+5?4O7k<mx&v^y2n~8s+D=7R^cmKqH*D)!XNV~APYkpLMRj37a
ze+31h3%hGATp6q}9EKO3PQ-9E<(jKE$RVo(C$<ycww}I#Hrg+{c4K>+yodF((@opE
zJ_r6%Fo)5@`q_U69z5B7bc#wWK)JuVC+)!vxu{(JR<(|9F#%t$PCU6xmLmrwIyg!v
zlw9H6o8!YKWi}{mAAj(SsZCpMP`iT|)r(~=xYT1F0;i6DMmm*T%MPcVvjVA&KO%4B
zvc?KO*bD`Dqygv%3&B^4ni0!aT{a%Vk1Cq}R4`urL5_b{64IyYpdJd;Hja7#?8he;
zTyDD%yu1kK0hrrvRfv@Vlcb2gh8ksbsH_(Wkqvi=LIKDH8MA+XNVGMmB>(wA@z|Xp
z{;>SuS3)HdM8Qqm3%NXV;66S&C6xROg~4-RQF*Z5{0J)hH^~Ts**c9@i&yTOXVD1D
zV@G4C6c>L{bRESeWiy`70b5X6POKVD-zwbC7kt&AwCy09CRIItS=OG@%L^Vhy4`;J
z7)=)N-=pKVSnp0YuC7fN=c9D6BM@GGsmKjIrq!z0Tx`Q&44hguQg)|te~O<fvdv$k
z$F$R(pdg2N>3K&8AQpe$c!{g1?nZiW`2QJ8g!X?01Dql(aR@NgOlRpelPPv2cyM=5
zWQSc03te(>op%p(b~RK-fe$E?lf4HC)dg2NOz03kQ22_6+Id%WuAlfoaTP^}N)52E
zck#K(k-TRsHu?J=FF44Aju*Y{RytqqpBFk{{9NXQ<x%Z?iW8<~6df^dQR0l%SSuZ}
znW}&9_2KcW#v!%DuA&aFAOX?kesaFJd_Bs};}IVQ+Ucd|-Jy`q8wbFU!W;&PlrwmZ
z2&Z1*qr^-iF4uaMv<Bu|)aV@_wf4v%zk#n68?M#f>okv=?H<plkzw6Hp7u->9~Gq-
zVk}Tf)uR*njiEpKtn+|e?H+I+g1u}!PUnB@c%eWwV-diEz}4sQ>Zhfup|VS&<NN|@
zzeZ4Pn=NYuBUX6tO0^CiXqBqS^YDK~!&W>QO~!rdVLFIxY*e1eFNWzKc~QAzKwxU6
z8_4+;=tXK~zN{x4#`Z$AQK*5VBoQq(US1^g!BsyV4l7EHY2Fk$nQw8bKD9)tC76F>
zt62_J;18Aw?;UQSPHBz~%F?doLxNyMTSNaD&>quAcJbwJN;3z`>qSbbr!t}Fvn(+|
zDT68zO8M`K{^=idy6)yqUlz@26)`=1Ns@;>6Y!_{4|2Xz!#=L!B|-O~U0=7yDhW#A
z2%tabFzh`MXPO9G+N7#wFtP2My_bI#eFHVtTHFY{Ji|l|2j)F#WWhm&dCeSQT9sK*
zf?yA3cyYk4@~~L9P+m1Px5)Y8V%-uf2<C;k-*O&>m*d`R^QxNH_-%6!@9z^Ru$t!-
zj)-}&E+B)XcA+Vq!r~lK=>xX|iO9JISW6>!a=b62jx;`s>cXlwBNqwn_)C95Y30$#
z#h#Bfm8cb}rSjJ*uSfpObL9$NTaSsKS{PrR$b_Nh2br@D|I$~DOmhf7Yqg}uiYVHq
z6LF)AtawE|MP3Q0pvLn>P!>?dy0Wk6;R<jR=a`Pt`7KYGJ4-h9o<80B);vl+xJ*7u
zLUO&ta_uaR{^dtI286J`_EmpTIRl9D-#@U^)()A7rv*$eaTA~5n(a!~luu%k965g7
zBtPt5NZP7qZl(k)qByyj#(k~|){-!3{&v9*l5KbraYLQff)*f~JO)SQ32`7!%_*?}
ztd?O9@yq6K+9<HWy9^?}ZbVyhIC(qx>YZJhdyu#zb|Tu}c|USQzN>#b4ruR<v`@m;
z$Bka$eaV(+jdR;UDp>QtO==Pi#1v%!sCA?H0-cu58kkfpCeX_}C#_`H;Fzb`w7&w%
zqWN&s<Qrg!^7x8Zjo&vcnPLpJ$glWvB+?)=_79#7xw2U!0%L9hy5SOxUc0IVx!fy0
zDY@B;r}2Q%UM`Y@&pdzk?0rENPOH0EHt&rNPg)BMSm0=dZ7m?>SF?2TzCX|U7a*W$
zJ^99TyRJsSoqga5=#7Ph)l*dVm*315zH`AZ(GLRqJogP-xR*FMN$^^)GL<DT$%iG<
zUV&Xfj^)kMX}P#g)^Gf{rCP$~xHMIAd5$LZ3Szdc5=;lKaYujOo9=#yU&S6PQU@e{
z$89n^lmF&hWIw^H{lMEO&kwD#DI6~Pt8grJ1eQ4P@^ep4O*3Xfg}ytG;oTk{Iu2Kp
zi((BXAV`XAgup?c_m%*~8pHyPHbwz}^i~d-^pBb&m{{2(Pc#SjhZ8#y%Mkw(U7slT
z;3ZDjD;~z<AV+_?v$KTx)OPro{TsFiG5DS+2cYXD<>~Z43?6d;FPON{xD-qTD)qmd
zf@0>_klSwngu-eYfL7o!^*O?^hp>gT{RQWsg)<rcOMX>;eUjjdZ{QKhMt|5Htnk=t
zX|Y8c&17lxREI9nMQ=dw8~+D6bm`NWs9;W~zfN?*at43B;Um4JJ)#hPVQ6A3Ul_Ce
zHJ}fYfUD`vb;5CHBo`}Da#}eAhd-;xewwmY1FE(gy~R`mj>bEzNQIUoppRWN>tqz;
zfH-{4JBJTGjJYcI0)Eke^CWr>l{0F>1;6@zwfZ|^o^`NG(a<14ypBrV%fO*rb7|n1
zR<pTvu|I#S;~nwY8s*DFYyHvZ-HAJXNPM@18<S-aYkw&zsEa@v>J*cmm*G>=$5;vB
z+}C``p?^LiX2>#2PWmAabh%6#s;kary%!c#jXRr-h5{cwY=iu&*aj@o!G%ci*~5UM
zXsjt#cpn%?ftvl3??=tFAw*aod#Zz-3#y-nX>org`z1iW1B`u;L^aHEXmY59;OjsW
zhYdp1K5VL<>-dyAviTB##~Q#bCq*M9!Z?Rm7bC8dK`ja(e#$17LD<Ql&aVk?hF?n{
z#nLr$FZ~tPs4t2mlF$tWKx!M0A*NZ`p4LQ)?3l+CL>2b8c$Pxhjt!W3NM(@N!DI1X
z{DptphbUj#4Wye;<&xM~`8bBsEo-g0%4CmODyZ5aSWLuo%67GZ71L@^C~Sa5zOx&2
zd6;KWjNrOT;;9~muO=MKp-`M})I2&**gzs#Cqu$3hJkgm-0(Rj*$iqKuj6vp*I+X_
zPoZ-W=TxyRTg;<ThTadC$%ILlXvKm3kK%vXCFDq-F6MctFq4-+$OCO_hO#cK;UTPL
z!XBdySk4-zcUaXV=5D<^8|b@d|MUQW{n~yRUa<M&4>Y7T5)NTl%s;_;OcGvW2j@59
z-)*t~XKmhaAix%%-PR>our}lA$NhcEKZcKih+qR{7kX(A?rRpK0q<oL<3rrZBzAx2
zt=`jm=4|_ZwzB{Th!qH0&Uh^061$lUTGUYI-_fq*k@QR1l*nRKqT!cjAmT{%>CHpV
zM5b}bXYc8mxAK?vZ&=dn6cc*`gTOvRNDdQF+JdBe8FK5^`$u8)!8Ir8tkfNhN;)5~
z?7cw?MA;`@S|e<`k-ksOQnQkk<X(TPzJqDWXXP>WG0+G&{e1^Y(mufU1h2kikDpSF
z&M(G&l<0TZQAt{-tA8{NW*b!E+QaH8fz_DY@-%!{-jvBkx0obvVjZrg4KZG31u&n&
z&(_A9(|d;Vn(UPXs}c_tZWSnvXRohk*$vwqlczJx1c><!4cY}V$3yJ9gzA4xTBSUU
zPR(4^DmE$?HUNy}c+f?_d!VB)kHDj?%-FPc8q0TWZO;n?Ip8v-pZ{z&KN~WxcCB=L
z+W_~^D_&21n4zztp#!^@68R1U$IBrJ@?yb<``;)nSJ?Pg2D0{+H$U}Wzc7ufH0l8U
zQwe81!$=v0EW^C0g_TZtPWyj>C~S|J{84QbkH{I8D~#CBT=9ryS<VyTflTN-x-CT}
zRYp^x#T1*cRF>-J)iuJr@7)!`cY1)oBo*<eJl{e>ug-S~mikeEpLGByK8+eXAQKd{
zvV@A0<6|Sb=gFEx4umjw$VabpC{Ebpu~{(|cEI9=0J=P?Oc^=Ns{nu0e3~RsZevX;
zQR`9L)taKRl%E%G%KD`_Mhl#?Z9{fr9%8U28Eou9#gC%#Vl+>uqa?xvBSF2Wruc-q
z_Hu`1LNkpHPGqL>^)C7DWTj{<n(+#@A&t~ZUuRAe(t_6O^$6-y<}U$(v3&*q{rE9_
zif5O(F43b2ktYV+wM2j5#RNhPT5JmIa?15W`B)eM1qF32Fl%X?LzYI!`9<Z9e~~!;
z8^>|(L`jihFb(e9nhSns%Y*-Dg~a6wTywSjgxQ#^)qUjJio!zzBb58QPUGYp<Nkqj
zWL9{>4{~QUClE+}dI>54`LCR>QvUEbqU3h%<Ocr@r|+l+%v*n4tQ<f&+CZouxXa-u
zMP?~s`?`9QD@ys>g>%I-foQEjSqa13KcW8UNo}AzJLCPg3Q}Tv!Rxujd@?&_rM?56
zu#FN}Du&+4c;|;|%@_-ET+&@~f44}Eu>{EghxWUK4tc@hCr+zEB(hlt?bhInV0C6&
zRm4KXRZ+vMnA?90F~>bvT=N~!%gJI!iC()as$j3WNoT;<=d{)Cu`6)Y_$efR5mlqx
zh3CN*`Iv^I<N3umwzhEi<DLEmjkobKK%3!DPs{HOZorRu7pg>WG=*HY)VA8IVB{D(
zn45Su{DBU)f@j7KuZl{{CQmGHM5YbUGOLg3Nlb~<ne%@>Yy4>1nRYPpOm;XigtcMS
zW=z@u$^c$tN<)ANCzx!bE(Hx9gy<#CVv_@2{=NdtOTb!#ar6K{cGG%$Z>$gt+<U3>
z1gbuFmr($+m5a>c#BX6u2*%7p^ZIAFy87MSi}N{GDIl{_H%8)Y1LMODjvdr8kHwc-
z^jM}EX3T$y_*rHa5EES`kPG2Lj!4DbqIfu*K{A9HWEG;QOhHXdQXxl<UcQL*i;m8`
z>gx~2M<zDVKP7E0$Y0E}IU5+FrEPF;p~cIjLQ9OoP@joa^B=^=muiI@=JHK)AzE2i
zA$s8@R;9>U>b4A(w1@w73bdYN7~dQXvm}Q)h~R&tK`4V~#c>$~7fg&FeBfjvP~Vl&
z5ZC+NCO(FuUY>xUFNTkvc6Wq1{;!(0$-|lKn7zo#S+^Z@4Nh1#*C?iSH_ar*A!Y*x
zsyQ3c@|)V9)R#?zLpQdd%pIb;xSvRv=8I_r0_o^>W0X$bGl5acrK6Gdm{T$n^MWF=
zQg?p<wQ=k}Ke&g%r0?D6>C?38>_xm2jES<*J_X6&dOdh+-vsUeikH~csk`TdJ(_`_
zNKn|$k}Eomcm2awx3?^@$036`3XA^`0+9HH5#p0sa=q*M9kwfstNcmi>6`X5CS~77
z+JOdAi%7A)6W_qdWdwTOwCeSG(pJbWFQR{R&qyx9d*7jC!>&NumMRR&HYqYAz*~m-
zNL4LY)Q{W<<=0{|NuXX-Ji8SmL9G8`9#cJOEH{e?0+>%oj~Xu6gi`8ocB(FQ3t~sE
z9}s`XUng_2iZ1i*L4|rNZ<g~Mk~|my_(^mieL7SOC;lczS503D-wo9gelk4<+>w9X
zKxt!qyW1<%FUFnATGa_7RD7yk&!<<h$$8qH%*+bmA-wI7p*zW@#{A+(F|))!V0F3L
zZL(mvvH|Xo<0NKCB&Mlb)021WtAvrvq@sRCa;9PSl96$F{-GNe?4b^fTy7b5a*9A_
z??j%y3WR&Q1qgrPezfjtO(j~n+(v&veUrmYi1}XHm)hQ`L~ZwXL|*-NOD`8ksU(Ph
z33U>uAwrRKcOrQYEs+6{K(&so?eA4&EL|2SjFs+7Fep0Y-hpt?-i{}c1s9Dz@MlUL
z3>QKflgQ;zYddw)mv9^u?KWQG+v=^<CCRWYXK9_`0rm#Q2;hKp%bOb?0YZO)Z^H1i
zr5iIm=3{pmCerH5Q2X?*CcM<APYoX~BfwR)zQ=hIX??ik^qxq1QR+0ksPOqulP|*{
zHQGdKldG-elOLt`6<&U_&a1CLfjljgfKlq62gkiTtygD79%i{hp=7L4vLhi=vf*j#
zUpS5+FOmOMlY9IiTB>dw-4uUaRLu%1&&WohYbArXw2MVObOpM)?^Hlau8Qw=V?#Z@
zs{z)aJ9mLA44}ZOZmQD|wlAP6I&r8->ZBSK!BjK~kvR!dK?6jGB9MwD-4CLi!_)i=
zl@#+rI8Iypv6w#}$-B8qM+sN(xu7wJTMB#!@QP~s0HXm#o`4w21gw98y@k`>mxLdV
z@0;e*L}RXU1Ob*hgyJqtcgx%biLv_SE<#$Zo%V7$l%=p%q_rLa-xra6NIE_7Okpn`
zS5so~&`x8a97I}a@pS&)wTpY}nV{eXuXcNvyo-fms=VHz8|k~;{3b5Dh<1lbIo1#U
zOl;O^>Riu>%^*(A?^AzsfQijKQDN)=i8gnR!#R}N8Br08f@<(9AwNeVaRCZuv{*s-
z!x<H$lZDn=Go1&z7oz!<7WcrjiN?b?6yU+|OdhJvviMQak7psQU|XI9*((=6CJvYN
zaCjD?Qyk4Wt@_khCMAPUK+hbVRe<?dC}NDJ17@;Z2AJGaVp)Gh`BrixG}ztuVHrX^
z>aIWwOHURukSt49T-IRWS}SM>c4d-To@iN#)i*m|vHivEt2GfnTEyyNmO}lD@B~gH
zzIZDFjtidJevo$Xp)dj#t|)2{l^PCyf|FA}i44L<Z$cG&dwS+|9G54NL(r<B`LBpk
zsOJ;IYvG4aierCeJ&dVlI?%9lSEDt(Cvy0Wmv<iju{(jB!JjK#fk&kz4@?V?(o&-%
z;Ow1g-|>!VJM<?<f9UxiIrBRRA{X)WX(h#!jp~zh)}iEg><Qq1G2Ln+7wy#XZ7dyi
zV<R-GGwfr1wSiz|A416UP&h|?gqhvXvysR8PK3Z@7&U*8T<Ns^iMUj|`gh|k5C`J!
zuwo5`1J#@X_?1-mSKM5Ab=9TCS9!O9PA(^Fe#&|;@@5ZN(RWjp$~lAB*XS#i^H4eW
zG5CF`-KSbd0oAjo^iV&iiH8bCOUPhw8buD5PQ%DzXqw<W4@n<Uo)6N;@XVi<PC7UK
zGtf(uwJU$3ma7mzbJRPLKWm5wA%2BpKQtRDk$*VLrhS}4_hb17Uj@2fng{)|qNXt$
z>F55kBB%XmTpTBf#;2g~GWX5zLgmc^{Jm)Wr&&b-g}2Hxxb)p>a0luhm_pI^B~z54
z>^9s!7vCG2w}`6C1YCu*UA9_6;k|^%Pv!kX25EnNX;QxmgS<M)e-O?$Fw}#R=~8n&
z)KlQ_LtmeSPxK^wDeV8JUCq)bqJ$_AXn5x*ql8#ca?0{g$nPg2ESvvxKPdqM_GzCM
z(q_{zg-OG3P~j&ke|8IDuE`4(Oi0N`sY{=Yl6fgbKjq(EB88!Z=3_ZPO&g0Fe3s@o
z^bUWcq2EU>LT7oQFpGyMw={cfe`T-m$V*rI=?aXw^ujqO2mAd%Av3UCi-!=I=T<mu
z2qMm?gIVE0-fiu{xe5;UVYU<8&CGk$As{=weO2Y$<acB<#KO!1GSa}$o%!v{DAH@o
ze>;^e%inmzsG82j3tZ#lSnF5S+|&pnzCeG^E6S$K6McbZ7w#>krmMPHEDb`h`g$Dw
zmpl0fOqqIMq(>^)*-@|HvKFeC61<Z}p@*ej6v4OJXQ3}}Z+gU^xs8{~-+I?S3pLXn
zY42S<X(=#W)}n07hX(Fl9N$(3uHjYv>7i?D0?M`finb*ITON7+?f;M{yd2P$he?02
z|B1)<q}A?qPP?tQP4=<<V{@O{JbSX%{4h-hm`+Pp_|7h*OHFSUr}KPAMDQNnnjbiL
zMNlk#mYr!oyugI`@d<>90`~HUS^b`ph@d^E4F2O=Xbb5X1h4KH4$i3TaL~43xW`dr
z0Kv1k!uzgG42J7lWo7K;^(H7Yp|5|r2(>2cfb#S@ImA$C?lI&GTn>yy=?UQ94|II?
z@S<BPn2`G%re|>MCI`pS*>yO|uAyK^jiRTs=`H+ARxbBI&5Uj?Xy^YKvPl@_$9-L;
z4DI>oRAC4-)9O3~S}b3Pw^&4(HT_=@b{@5fMgqmbeA;+%=%Fyj6E0plTKs=b!Qyv{
z6*oe~DIQyhCe|g`HJi{fylvEvT5PxTL2^&>$`BDR759zH2>6~RA5u)bLqd-FojX>l
zVDRM=YT@A8jJA(xxe5Jo**0jY0b@5RPO!G>#LwD^a?x9O!(hyaYM$KJ7Ph=EcA@lT
zzYhLe`h(RB1F_3fxW`syVZwhOGGE}|QR|23MnA$|t1@Y~ud=V!nbO$SLvYiI6NfV*
z-wh0p1H{h-S4qmN7xiWT4i)t+qL&)WXhO${f9Bv)u=B-RY2Z_zO9S6~0AYr;#KDO0
zu2N7B(Zf*SS0VoaZ-v+$JlTc(gx*-oP#g@kR?tl6X4Eo=tNnA?;Aww*l^UnY7aG}z
z@9%<p<2SSHGM%{UPjkfH_w3*PjP->^&h;<A3qg}TEAnsPZpW<4_N9(m9dK#nxPLJ7
zxgN`05X!7#_(BLKM$%9v95+|$a7FiOFx**0O&UReS|sEWOpr?svMZidg*$O_FB+7j
z_@4()?ww8G!bm1ikV}6+3&RVM7de)OE8*C;Qp8?#595joj?^Rf$|H+f^eWg=(2Jvs
zZ1E{LggeS1Av6(DWRI3UBm7WqTB|%ezV;f5=&QbC0CH%h`q0%<uZUW!C+4^SA+&z_
zq^0IGR_Tu+Eh4%mlvW_V4;EP}1DFHwwr^_L08>vOspO57sQZ7ZuGgwU_rKQdDnaj8
zx?T1yaU-qE-O5#Nm%GZ)?OG*7yX15AV7E(zZ5Ljym4mm-1ZjWDJLcC*1uN`$E|AOI
zpd3>uDBX=?EjV!;wpwsWQgvFZBo&b)H8oFLk<n5U7J)^RwC={7Efe4ZV9{(ND}zPc
z1qUh||4UD|>_~rCVFvvjmSt{vfZKygTTS`)C@936*UY0m;dz<tdsaFvQ<xXCA-n4x
zsPs9MxUR(=IRISl?xW|D`Eoj~mhQ>2S1(g_muZgL^XSnqxkx9;utMdmdYxALb^q0A
z>u|r>!7TdpbEDT4ADivQtHb8LR`Gs5WADkUMLHTLcFli#`*U&P(%Aix+*$XbM3`N3
z2C5*vtoZs!zuEtD<}b>{e3(ow=T|;!6U;A*Ea-+RSOXei_XAbQv8P#`8?R_%IBX|3
z>~bb(L1X`{eDmw%8>dkPYdsCF$V&}J(>(RAEGIbZpe=0L#R^o$tXM5fC1;;3#^Dy<
zed}$(v;Tkdso+<Ctt(Zo36|qlYQhtI$@k^4=$PoJ;kT^5r=Kmmy}s@H%J=5;89QuH
z-_K{GWKz-K1Qd{emW4<a)iOrWs_~g9qTOZu*)7^gGnhs1cs*BzFsz;EQp3H}%zmhA
z41>aV(gGNOROgF}U$(Y*6&C!*CR9cI=GV<{c4dDn2E+)e=+I~SeVAELd9twqt-jg(
z25R#`w`zsW7X80yORu5|KRtWFe&fp*&xJxTIKU|}ilz1?@zdVdw!W|J;(cv@A^Qs5
zs^H!rjrDxi%h*sA_CeNLVSlgI_=Oa+!*7OLRPhC~%N!c*d@sj;b&uQqcb!&m*|Wjx
zAl`pq3VpWK>tvE96DTBk4zP$~_TvmnOGYpxJCnfzY8pc8^CY^NrSmzvnpkKgS+n67
zP1&224EbletyHN63mD2L>%a1B@{SFalqyuHTARs&7<BUUXag=K)EGGDYhaVZG80^a
zw*Go_w7{6UaSTOnMvOVbLK)EP<|<<tGfICil6g8-HE*a!q;$Vg3%N@TIU87y+3K}Q
zh}z(qbHgj}GZzbq&TnyRu-o;2tk*@O)+A4dP%?_Qt3|ijA{xVPp#TFrm2`%ME^&NX
z1QwWz$(OqpCH2d?1nS@FIO{QvRbdARj^=->Yn?0Wjdk@KCkR_^t5<HTZTzJ<8S;PO
zm0QKTlr0rcZihX#Y=)g^s}`{_cA{<lRn`}Wjy6~&1sH8ej72F;<)CaLFZ4dHYwj7w
zYAncOWf-IDFFwG>R0<p54t^nofN_*3|GP*g<f0f)ZVB9Z-P#P+Xf3&y@Os2nXf$mn
z2>u*aLnn`mfKUNg`?}f<JaJTml(B!!ct_ZZ8|`ijX<s~GsL9YcoeV~cA&m3Q`Zrh=
z2g;cwQ8FLY*=1z6iLDKel97w)415n5ZAtP$JWYn$LUlaxuuRq|h|QXNkSm8<MonqN
zTC~TukWLm!=->5vy#~PImx0YOPvRjvCIe{vtDjN=-QcSMfB}(Vu$f^ASSWvhQj5m%
zFwusb#<O{@!Eb^$!oh|BP$EY$$c8-0ayBF=tZ;NfGw_m|@TF;kn;;1Bsig*udRGZw
zeuQO=8E|HEBK*T-fK`kY&V<*Xcq5&|^)w<zW2GgE5?LJEtyQYki6N=_@B06nuEVP^
zj^~JQ>~*=yZYEG%<|_FRi_L%0-Z|ZjHtEmzTibv6t})!)3~i+!X595F?nie0&a<0m
z-uY5E<In?sg4$hDSJUBM^%JsN*vBJh0GgJtlc61K5JijN(Ve+dzG97u3Z8q0LO;8}
zQhjc339yBG$A^ba<f;0-pHG?=e`$T~AHVu9_Rm`Id!y57{7j$CI=_G2IX5d8Pk_G6
zif@&$#a&r$PS$I1lnr@L5sS)Qk@X|z&YSK1X1k{%RxPGu-0!}U{3{m^)dpN4QGR+E
zfvAZ8<h(sBaondzkY>@V%OEksh;};EG^aKWB0*KK34hD8Npc9a2i4=p_UrD^;ForG
zXv?hAdK9hOQmn=rYaD;JHNvOi?r@_!2=WU1r>MAsFm&`O3ebTXzOo*S2Ji}j2?L6)
zE!j+^TLSozIhK}bT&ikuQKCklDM9IT74T%G=EW8o!swh2K(CGpntyyFno3w{-azoT
zI@~aZ2mYI_wNqD4Df;k(dF4PwA%ED_k55wrrP8|M1C7R9mWF?Xel3Xqwjl9QLc$!(
zI4&};&`-QxB7r9apQ^RPY}!{<_`>JzWnUlg*nhe6u_M9$y-uC;;SYD{zdi7wBXm|j
z^Fq#@?^b7IHRe)rDoapm$?z*7l^2%l-^icz?(F2Dxl%<U7iF0&;kREle}kVvsb%XZ
zE%sI0{>RXsm$855zUuA1U6)m|+Qp1{bx`V|)dSTOucQVClMC!#FE<Wgf-eA#U%v_2
znk4Age`SBxHT9ioQP+oCFE`rylF^Vw{k}i1vSDAoh@NjR9TgP&p%L?&bj}8XHlASy
zF>CV8ujk+F1lN16FBkrt&yrX(;_)Fa3Wm5SH^ii1h)I9BA!Y?b%*qWhFBoFJWC(65
zG6&GE0aZiZ6T%!t%`Ij#lGF3Wbee(0S9dX_>|N9Zpc1!G-yfHcCSg(+7IZ)HR6#*>
z#d*arB*TWE!h6s)`2Gn9v4MyMuK{u-#ZRFtDVOE6mvBDIPc<Nif8P0ZvHgK&uAE1I
zjn?5MUT1&e(>gX;UkV1zkK*17SO;}O!IVMaR(IsE#U~3tB{%yRX;w@4bm+{R^~~~S
zOZa$pHw=O)yJ`II|BJRU05$X$Y7n#pce+5Ia$S!K)}>B}A;uCe!ZZBKG9%X_`&rU?
z^Wda`ahLXe`qZ=1B^+Z&aZ-eTKr$a$vVkf1xKV#YoDv9E2`v{JXCDXB0#D=GCU`su
z0eV=0T&N#f8yf>t5vJf2;99A@S;RhYvZN>S@&cB{)vq*K<4QMiA}8!x%=eRdoQ@Lq
z$gyuZ`<$Cb%g52**x$8GbZ&>osLc~+2h9x=oB%t1Fb!;@Z15iOMPRII!^t;{T+iiH
z^>csO#pz*;`s#L`<g1N}U4o-(I<1u!9Gm@0jKA8_W3yjy{L{%IPlla%a+#Faz`|-R
z&XD|D3U|nE%9ec-i?-WkSK=r&7<&JjV!MmCM__{Z!^#uH9}Ip=Zrz4WxeaUZFTLZ1
z)2DFD_7r9IY)@fr8ao*V<|0~SsjiP2Cnta4yz%DeF8kQ*wipSLP83J+bjnu!<~C<U
zCdt#hj4y@LscQQRIxRdtdy?0Eoy?mb<}=aB=Ygkx*E5}<&GzOhnMCYkbQ9<3s~~K|
ztU(7y$Wb8!xI=<BneP%9G<v!fjcH&u-341MSlaP9ph56q1XCfKp&}3rd}sWyl|Fwm
z;=t33in;zmjtN}zkK(^&GsNjctF0o((m#VLV(<904KK`5tKDz@)a%GqRgJ#pJn+X}
zmI%`|+ZfYHg{Rdfoh)g?Pg3c{#2@uCTg(?bJQr?TMqfM?ZECm}>RPODMj}v;<TP50
zi(;pfu?NX0DG6H%e*P2~0)N7I@mYU?<pYbN*9aT*SGbsEWAtqpC*y2(8{x}t!Hbt*
zd?0vj-5*|?zYDxBW(gxl1pq5W#Wu=PF)S<l34s3T$e1ng!5_Q3O@p4=_)voS`6=6%
zMEyPif@-TXsh{BnVYms1XFGggFQUKLZ+r+!dIK-0wFb_4!9F*^5oD{rX3~Ea6D}54
zNa&|8=Lc*0LbTR87HAF}3=hBg5FQl1Ecmrx&X44BZ*qe^o=;!|JF8}=-8k$YHII%v
zKlk6Y+RwKYNBAzCJl}p3Pllt!jRVm>GB$0JB_9UKbdKH$SNvzKK!u3s`Y>f<q;q?K
zH;wlGVKd?#1H;L$VzmDYFXMk7Jmn?tV?-~pk5I`z%M;#DHiPgBK6WA3t4&&6vwese
z^N)ci$s`%lQ13gGrJr%P0y6LSlk1ex<sts37KtB@h~^XNuSF*Z?f&(9){lPI=Kb+a
zCz=L7)gl4WUOc;maJLKsp=w0@nSgP$m?s}Zt0&Ra2E27op6~|V2q%BG=N?-#dw|$X
z(G@kkNM|{JaOk3iP9ty=v>EpofHaH(Rm|O3IyFwa-u~F{p6=~6yIrq(Q62`9MPN6c
z*5HVH!Dt}pRBDV;<JJbVgsmV-wLMu1PA2LAP!HK_jY3@n?>5|h0<{2o)qVhVz`XDQ
z#+{3{3+vy*WmN<k3A}$P!i>inx(8n%-^rIa2UT>!;GIRrFhoBo)M=MhN_QR%0U^(L
zg4p@Avw6e@9H#^QQIcoNq4K$I+4B42VqLS-IqviinvLFRr^#qbuYbabGdkMos1csL
z%q4pJo_ew&w9c)`MFs<0$$$Mr_#cWt>Qg=MkuMC~lwRj_57&Q-N_hTgyl(dB;ph`I
z`mOfCai2{P9FjA(FZclj+tFXu{PuIj=Oc^2N#nmyn|vX!T0M6G1o|*Q<t2KomQa%?
z>wDi_Y={5llvmvrFDcetX|4O<@F=Ky7kAc2^W;}epDt$IBlESI7UQ4IUv&k$=*QMy
zK=W}?J3Dfd;)#DY$E~TA)$INM)&60}UMrl0TtzL~tVIWn!)~({?Vp|;w)PsmX207w
zYW5pQzpEuIPh{RdK+2B3<zo39>pXUS4a#aU;<yd6!~v(Bg_ynbu77meYyK4R#{jui
zw#j)inCDT9G0N;4=d?Zo?+%<}h!KNf*#M1KErvMbDI<S<=jkY&-%7rh(W6m3NUk!B
zU$T$SSdrFndzYpb++&zQw6u!*&9|*RNe*5e9`F4KVPTzQ%5DZbP7D=6yAa8;;9XC5
zO^CRaGm|o(RU;<WUV(g!abXZY8O7(>0?LX(o#IO-GUrhxe$Pf;oGUS!;mn^Hyp*cB
zT8kJA(@THGi(!Nkh}cX*=v}cFVz`mV7s>o~XKjP$sRo=F_oqk6JjN+8<mo&C!8(~u
zAP6JMZzqGRSvE=k4qBfLP&U>`9aM{6r4t7Gc$OHgD6u&9Hlx<`9ixe)jKbCF<S1P6
zSFwdB`hJuTw=+sbL5)4rSMsk~K$+V|ivehiZsLDi(uPGbq{vahdh8U8)V1lnqTWUS
ztTnyC39zhJCoxh6_ILGBxkw~8v@Uonz>4`n8^L_@WmC5WsN3N?{MR!{I`sS)k1jLD
z>|Kom!<{cKE|OVm9A74{XYph)idpMh6^@|8?Hn_Av8&;O+dll7-J0hVYsVyx7QqD>
zE+l`zd|Gr3o+3ou0u%(nYyb8RLZ8F{x)$F$4qtDpiEosar`pZ9-x}&s^%$-Xs(@q|
z3fiBl&)&7h(@t^`%*4$;%VgX|D!gYvTP(e&cKM_R?-U|h!S;+po3;_JUbOgX%EqY9
z3%3>1zl}#JTMxv*ustA|BYax`gT$lw^k{!o5Qe}H?ixDQI9zhl5osDlF|GjNt||NO
zT_s>9p3N3h09J{GPN#5SdRpwdIV4zNLIgw|@POj&5mlb>L3PlPuD;|r@}7w`prm&c
zU#0_e-ofl(>h%c^YY+*<q2r5-Jem8xz~8DCI0dvn&(!AJ@XWnJy2eR^Bz@8)p_qTD
z+s#1#eWm^$Af@W2F%df+@kMKGX-&};{nwt3Ge(dL#s(&A2ubvpwI5tkbcO#Z-c7MS
z&%B2y8tYoKRd;)5Y1t7mOx=|ASqarbE-J^I+8IkuD5}hO@L+%+ktOCbB*-&B<Ia;&
zHo2r+28{P(6nx4$)E)h_^>o?a*$aQ=ds5Yl$%)(({EsaOAQQ@4MtKIM02nof<$-4a
z#BGk*Nv6{g&}rafbH-l7Pw^zl7CA%;LmX*z{hm=s&g`&%*w>bJ)fllEreX!^wX2!$
zrf94&+QY=)yCJxHa0PA)>=7}zXtsDh0j++DC-F@#nN^A!+}Yvc5zWOoWdwgAsIZ0b
z6i*v$4{RSKMu{VKo>AY^>M=4*HP1M@P$sV+c`6N&rJQC-OF>D<l$9EX?8gQ<GK!)?
z2H`-<2F%Wd0nfU0iB2fPFq)MLMsS%5pnzTKOLyU22wNYmfLFCvZT6EP3e7{+SQJC0
zyjvV_7%_Wr*m&KwG#c<*|D=D}>9)GPX1fO_3ij)ZX!FD7R?TcBtQP>ccg=m?YFh@)
z8p01ws6*Hd(Y3xZ$*SF~1;646hClB&_fZY8ua<+?`dQQi{)s~@%>}7v=uc7MoGeM=
zDvwA9Klx#DQ!eIMNrsv@W;7LVv=p)MUTNHbE>Jmw+!K<^4XF$Ja%6vr)!&0}856M~
zQ9<B)?iZ=XL7{CNcXhcQb%443i)t@HB|!uXq;_Q{<{i-t?-0q4Z{m=24uEkC(Jn^u
zr6sm{@ID~P#_p?GPLK@)#C%Dv92s^+fN}moL8##1bZ)tv7;0S<5VBx;SGuZLEvw@`
zG_*xhTnZbcA<)bxr^$bhq2Ap<d1Lt9ktmszHVev=;$t9rTst0nCz`?sxjNs8!7A+^
zJy7%YWuS9@lOn7C*0b5TBF8AJE<<N}-22{37WK;N7PYDKUmjL5z>8p=Bs2D!LwXeS
z!gF9V?jNwLn@5j*&kQCt-LytLGDz(5A+0w_jj66lS3{tnAjW_1plC=b0p&lzR$=3r
z7#k5RIIa;E1x@t}3|fMs?p4Jnea}v;dlOIXw<IiC8WNB~#j51g^j8J%v;3#6HZZR)
z2}f3&B3+l4|CZ=ywkpsf8Tlt97!dJxeP6iapCw<K4@aTeBB-V?$0$@<RCkq!hc{;%
zhu$ltn>@`y)C7NeVEyK;)n>IZuoIaNY(V`*>I?dfq))J{MUMya@5(LV$E(><4Epj(
zJQ*Z^_SK3~S%2;2gYn$m)y~do`^Wb2yS8T9@pbm~t>|m?EKfK4$=&PS`R4H_|K7i#
zExOymcocTI7`=ehMio!OJ&Hz=*M$V4WgbSx?J$kg;j4cU@Msa*0>^i#q%F&KEzl?!
z*qgEo@8e0VA?NTd0%@P9_w5x=WQgYmen$RlSI8Ic8bOgP6ZJ*&s~9|Rax{}co+-XN
zixL{E_pr6@4jxR4;vvhLTEqs1DH1;so_{2rdmHzA&`MQ@4m8lJ8uJHl;_iDzY=A!&
zD!9DSZeV}(dz>Tu@f;##t95^sn|9w>orU&&MLyY7N=OC(fIxr0h1g(ZIRu|uT50w@
zekOhufZ`G0RWlEd3wY>Zh{a{;m`>2i3}JnZY9ql8JY)aFH&y&lx283fMe28C3~>pX
zw&PBZukT$&r&c!DV)A~%u%Ir<tEAA)NxqmR@=_GA1g^G!%FspGCVj5i&>LY=@>Z{T
z)bDi~tzLI+1(lFhDBHS`TFGTjnO3Q}?0G?*G7%dul?+Ocs6PMBPEfVuI=9hq-pf_j
zDbHOhJbzJJu`9o?QY!q5+Q_mqDJoO`MQubs5uf(C%%v@P(ZPeK%P2>ZLps*?$&mdg
z7Z0Fucj?K0%ImsQO|7g4jF)Vb^Mmnrb-ZB$?J7o1fnXzBty(esr%7Tz<^N**wfJBt
z7?fdLAFVMQ`UAav(cI~TF(2?lu8V|h2(xRj%hCr)CC0=o-INp<)u9lGBu-wl_vlGx
zAweO|#KT^F^1-h0beZ+cwJmj$OVI7iDsNp?f@!pWpB1+>*?R5S@fA`j^MJkdu~=%1
zU2S6qN~k~|uO}dWDI8fy0&-2B!V2M=ujLvD?~-ym1}{OV{E|X!JsACwz217T{*01!
z`-jcOkCZtDT{KT86bm;LYtnI#@o$UC@X@-IS3j<;(M>DZp<1l3fW$CiG-;M-^&hM~
zfXgg@ISA3Dyk9(+FXEAv0Z@+w=s*_ekr4=>&_mCj=0RiMI%Kta0YhqOxXTAS3)X`!
ziG3PRpK80&pGz3|ZR4=D&oHcF?D&NVIDrO6jGLBlBzQP?C5FO6nawKkVxDPri~?Yz
z1_rcvm%=+}RmSpH5pnD$ytXiM2VFajiQI&LKbOYSr={9rhKcCu3!Kjsczqz%l(=fp
zn!QS2cEO^fEA<EoBC^8W(5|WGZ^=4{`zCW_RhQmZ4TcKH05~<E(@>EdZ|i>n)GNXv
zFCaW^5lspijHNhKii5ZV0zrF~{6^L>_=0GzlbT0ME-Gi*cxmflIZI`X;*`KJ^M%NN
z-G8*yqTVB0{+`N5{f_6NnQi^dLb;ctkYV&J%@>*Htj$@JtS>9r%Q8z_!lORe;&{zW
zwY1V=VX!_>SSqv%dY!&f4V;({3eyPbOi9O?=261LjAUkpX%Ke6Kk_wBeb_(rga{Dp
zO~D*Ypj3(|LklQCtW(DfEr}leW^QSJHy4I#(`&7#^!vb#gG)Gs;!u<$5Eq(<$w`5=
zkwp_Sm+@6n)-@g|S*Z%!k=5;SG`h;Q++Wtm*;UR>F&3fW*Nt_q)5@YBpmALX$4AQ-
z%(LFtXe^rjPD_5d+LA$dgQHy;$aH_<?ZM-O<=YQ#agP#v+IWfYG@b(eUF_(8ffi~Y
zH=6`qxmQ?JSAXFhU6Xn9gFcR(=6|0yNtvXcFQ5q1Q9PL#Vx0&*hyxZDWR|9oAQlZv
zadgmWHcb~Nixwz4*@3c2O0N|3ZYv}UOMtI3$P@h_%a@`cGM}mp88WDgvsjbDgjM$f
z#O4{Gi%$Qj*=sPVtpV`gHzGZM$d&klLbBh#PZG?eVd{905>q;|Xa<hGcydI9*Pxt}
zi0ZTKc|2i_uIMvj(#oj!j1EqjHh;+sZhZtdznTo)%WeS8v;e*hUaE~YM;^<=6$`f+
ztGh#W5C0|g$BJ?1h%|qj&Or1QYB2g2sxQsuxarkITcyTyef&_B*(K3`A=ez@xT=m%
z?hVHhAMfgSCr<SfL?(%ydn1&T#zr(#wPUqYGvdMux`1a@hayv#^l<>R7(-_RPO_6H
z=M%z!xFF!4fL~^4J)kOU3_25tQ>CkkF=-Z&bO0lH?$Ck}aSW({zepuaNYNLJqlMY&
zG1$@3+hjRh8W#6aFk#_;(w~@vIi7h-hBMdbcVd$-0t#~lNAGk8=}^<lSPh^cHU7Ia
zGQoHX6%nU=`*e2*scWvX#b`MBW*&_*_S|q%zNd1B83=J#tz99OmDML1%U^2WFs3lF
z?1DGmGPfq0MK@qz%9}JnPUIrR%9j{PkMD?a-N=e^$zGfZ1ilD=7D%UNW`Z|H)AGe&
zkR(IMK68<dM!EioaPB~pl5(y1nVGs~89^kEG-vFJ|9QeanX%FC_l6q?Kqj*(<7L^|
z&WuPeuT+KqG`-bTpma9DN7>?m_Bu_>2GQ%V|GfUW{{*B%t4*uT-M_R};N+hxCmN|`
zWX}!*%;l{c5uw9>>51oDsy>ntih(sk`S1}ZKVaid9>wqBMMSl`&Mu$Fz?Wr^egtQ(
zM*=mF^@&GdjJ*XGXaLi4!5W`R-(7}*!=Zp`gOA00OHOg_2{%|sPiJF?K&^7?)<|st
zWR=3p!-aoRDtLBagg^Tzx@S({GaREPhIh}Bi^b?sw4VWgF~sP6h{A)XH(|^(q<AoO
zI@}1(+0FA?xmUo}!6*S6i9XdMcLRISs^UW+;r6}K6ISyB-5Ga3IbU2JX5jv=#?Q?c
zY)!`R?PyB*0LN=`PvUoPJcOrRh>3jVWsaA)Cu=Q3<Kp&@;+g(x%fa-<6`cwGYqS~d
zM5HQvbqXPW0iD;acGV05&>$;ccUKivbLCC<=!AD|2|NB+WitQ+-6^AcjHVqme&V4|
zi%C9B2I)m=X05f}#6Iyc!Iv@c29UIfRsz*R*h)>7+WGEeIJbTD-9>7UU3I0a13$bB
zEzS2`*Wv$|E1gZz{LRU51=nmdKsw~&S$M?*SJ&u&Xp9@UlUfH+{8I{(u9t(U(=cmq
z8X_>3-+T}m{Vwu3cHH5>tZd3Mo4#56l{rO^0L=^Jl#%5;C7n`h!g`*<VqwARp~;k1
zF+?MoKHm>;`sg1XzwRF#ca9pp%KB*=lzRKo+g7J{+Bno)fp;Sk0e7PRw;r8zT8r<#
zjn;R6BUp>|lXx20&(rmqTs<vVE>$;?$yzJkC=B_KKXM9YbLPi3?a*Ieutx;_-k1nC
z?+;?~Gg56|R<y+^7F0!lsj<+Es{#_$<a(sngozezFA7C0BO)z5l=~jWZUl>Ae`9Yv
zu!!_G3Sd#a6eWZ|{?n_`X8%h6*@@P#$8jHj)gbF;cSlprgT5O_&F(K2q&#t#znP=S
zl2}!%s~a>`$CNBpp2_WZgYRPfLBUyJyaRIOHUK=ZtJ>i=LBwN}sjLTqMY-<Av;-NJ
z5Tmk$LD8%17}Y;|**qQ<*N)MBZUUp6suc!@(RL9YNaOB<1Nl(gaP2CraZ+a7P#qh8
zcVGjl%%M$xj_}iV4~Fp}p1_cIM_|Kr>4Pw&Md+@U1<$JooNT$p)n`<wznDO7OaA%~
zgCMxG>`AMaUGhu;LzV1xzVG?VN?Omh(Z#3%EWU_*=<vUu=e=TjWK`w&g|0RqwS%)N
z@RUZt6-0${82I@x&O_iBrFT0EAFiT*w>R(+9>U)WD1wH<A@sff5tWgqba1ciTxHpE
zgJMl#JFjf?>h$2C+3B~A8n2uE*PRCARU4gF?`QB&c_p$-j*>ardMVOSSU73Nvt*nA
zG%<7&v|itcgdf#!ENiY`I00>VJhG|<2$MY7-|$Ic*ZPC)hfpY^;ZtCVn(zmI9+s`|
z`k;(uE5WWJ8?(yaRIuPm2@y}rx>Gcgz&>G9o5bfMUp|SDU>CiNjv7BP-tb-UAWa1m
znsQf{Y=aqIbS%MB*YM;vTaaQI(E`niDdh0t?f`O40$)~MmJuD(0T2HLH4|2evc>{^
zcVIF)UXVUAY`V}}NdtzN0fOv*C8WQfTrkX@H`uj@wx`odXe>9S-wNgwv<elDfGw;M
z3Ss0)YJuxKVR)E}s^%I<%RWJxZVL43G~DWaxdL2VTbo)yecRbw{d^z43#GDI%t1Y(
zsn|?c0cRDDqrv<`X~;MOAEc8sztT40pFo{dxcH8sd`pQ&^dj2+^LH|Tv=(VGS%<+6
zZxLY!3tUp`_{;~Q$%~YJT3k3SMH^17?TP#h|MC<IM3ex0^P!tVc<DCvGU!0rhqz<m
z<LLh?L8`nFZB?tjR7ULK4^17$g`(An<vb-HeweuA(#*BFBZr~0>!Ae|1@p)Ftkzt#
zs0J0ZAvE+TZ2j9(>f3vNJlRqUdp9MjhLoBLSHVTEZS-+%>4uiF4!+9uYBs$t43#i|
z_ZM8BsQjRjI$VFYAFX?M-_Rl-j-4=6z>*Jgt3hi}2DdY$Zlo#|xcn0RNz&_dm>^HU
zw#FV@61_ubTh#<X6N-@ap+8A(`WWEqRle6W@>4UHs1KWr!5>L~9~}!+m|J>+(8w;d
z`{WI-Dm<0DGgR6s=nJ)v0bqhsK~e}7bFV?bnD90$Pn6&EUHQM|ykA+q&j4PKU*FOz
z5(eA-@M7s3?G~nsDspe)`g<g1p7<&H=RXb2NSUs*hI<cie9~io36>!8K$znN14+g6
zwcuXw21e#?tEkg|A&%TS`7%SQ((N+%sSri)BMcM?0>wf=kpNJN`7cMBHBTtcU@`a_
z{Fc2jOLM5xfnVexztt7%2xSoMdY%xUpZftWAYIX43Ez%i7SD~KsA*tXj<~eJ5Q2&1
z`DL+|0Y{!&^n*Hm#`QT<Zs-VLR(^s%!CInEpUQ392yUEzZbBR^ovmPJ-L1(rT8AvU
zKYF3ziFKsLVek&W0~(k!mqr3FgmvYzSunNi^Y$Q8_e0&}%)Y-$4hY<&njr?1L@V9)
zXyK7s8p9;s*~Iq1lEkT+3!>90dloBeEIt|Bp}gxds<|?ib?b*OC67_?#RvWT?x#L)
z^9EW#@lX(dm%c8gIWABfz_<jXELc9Sh=5$}RmiR5^6n#Zl#o$fh1;?own7e<dItg0
ztBn&9v9qed{KG#&lBkf8c~VErM<WLY$+_UhvT^ImhEP&i6gsh`qM|u^(ZPu!m8b~+
z%O4sx%x-BGb(t2^<tR&<8CRlxOX=RzrzUWSDE+2?`B>=*Xk7ATvlF2=X*K%9X;ZlV
zx3y^2_BWFhg_jL&-9_63L_2nwN~hGhucl;H6(v!mfm$uoWQKY_6@ORe*fr&qb(bDl
z>MOM#j9P<R4azLG?0L#Q{XL=VPI6?-)*+8_N^i~PF8%EXONY#kW?Jx|7^h;LA^i0>
zcpZ#?)0$e(hjUc$$I+s|(5BI{7TH7~L^B*xWb09Us3GCA3_Vs+4|C+;bNMxNB0B#i
zF7s8Z*WGKh`$yeZLCr~Z1+C<2T4{yM@1Q#0fC|d;^ehmQ0uhsFy@Ueo5Y)lz%VpQe
zY?cm(?8kGg5{a!P+QWP{2NC`ApY8_|XCn1~^AaTr@D7^zVfWMRFl$72tQkESKT7N2
zSL#>njeXc^Hya%YG}rvhFyx2<I-M~L;#qhh_Dv>)w4!{YQI@@rM(KNsjN4gTOD`A_
zZBK?&BI+m`A}qVjz2o+N|7~-xciibWk4}0&S9cV-*o>ZT(4VK;)&HmX?;U>gkB2*d
zh4x$d{FiZ`{cn3Q8bR8L9DQ)`e13bFVWOwe*7BjEdcD5#%Gv+bbBaCQC^gB7U{oRC
zYP?bhi(WH?j%AKlZi)^2%jODjhxVTWxG*mJzfTI>(u?``#L+wB-v06Ft3wDWZS4K{
zm9~7bw59Z7?sOOLa^XviYZEFjk_OX%r}PigNfOVZorrww?w?<Uk62tuoHzQyvYm)k
zxk*pTB-!9hUt(k>QSGc8C}xrjx34#C$P2CB)C1(VaA!4`_o~(faNOfB=n?J3pgspE
zdtz$CBO(eCrG(lCv!tjFYQgu+Fk!CYF6kw-MJ>-UaktzOY6>Sq_8%rc!-FJ$POuPQ
z<*W%_1cGTkUs?m-5|-vA@L=hKr`mDnxO+|<bF9_!;VkRBVlo_Sxcg<o@tlK5$>8~P
z|8xwVL6_uW(9p}QT19oFdonl0{3f&VX<Q?#o7X7s8<W5x-`mDCn_NaWF|Q-U`eS|-
z%vh6xVkkn6k=SI^6k)a07+ubPfU^sAt2q7sKk#K#oq-d>&g?Hj12f4c8<fim6Ik7V
zeuj-AYG30g>V&Et=&64KZJNo`v$bGmR;r>jhM%$vo>VavIYfAwX{|y4jo=uS@t$?(
zs%Wp%;^oW8_%{ut>29z@kSS&y9q-#Eiap8=EfdZY)y{~IgEIw?&_N@A7KpO8BS_f^
z=~gG0;*Omawq~$p+|~k$O(nN-R5oOE6<;&fU<^kk5}B$bIUHc_N;PTyZtKN2D8jr*
z?3{)fV@5#(9qaYA7_!}}HS#2@(N%hRrM8&m3Ev+dUF)7rWyA}P%#&i6o6QL>d{jgu
z0vYzR#|#2Q7a`3G(RS8<1&!rgb3mog$S!}CqY=scY0L4iHg6)Iz(GR$_Q;433a<jF
zL59oRge+b9D@Cjr8;)g`V?--<tr_*7Fj7<3*}#w->X|dc+`y~MoM+?Y1}R}m_&!dD
zjQ$oZ;0POpRv_orur)BZH3#b;=g@P;2ToU1A+pYsYSk$D#3HPJe|0f{l24e3B1Djt
z=4KmMaqdme+*@Xq<U8!%iJ!V34DPTFg2d|U2*N|~KUOm214e9&pO$*=Blk{u`!ECb
zV6MT;Vr3?aY2$*u1;~;b(P{xnqkov)NU`97#g5M@TkJ01>8U0F{h@cdENu=MY6`OF
zaFvRiMCYCwpnK$h(s9!H1pG(>gR1dFAcw9D+SGnE?rvo%!{<-m6Buvn-s73%Mq9Y?
za#wuTF>MIX!>bJyco@ye%x8^#3+ES-*c4Dcshr$aTsF4XoHL9=6G@64mk1Y$Ek%}5
z{VDhc<n}AXCJeq$yQ`15jov81mqxIOx~qaSKt195$QLhvqOwL(QJGvH_>r?&IkFZM
z5T0IZWUt~;kws6h85UfE?PG$h8D?Wl#txGi<@gSQFc}Z1*eli^%z}uo)g%tXy3hhs
zN2h{E#rFN(!u5k|l3MxSAjo=}P5W^9MIqYdE3EV8<(Km@1b*#s%Ygs>%ZCZ?uzVMl
z3k+OA$_CMYIW9EwRI7w#&EXJ0cL-%^s`^B}d@(-FlOd;Mn>qpE(t{X|twn~%1s19I
zHf9;B)RyG>X5_l`=*%(^=&-5X&6TY57P@%1#D?>4NdZmW7v6Wm;jQ)ERE^L*jJHh5
zGc1jMa3%!Lur%ZrCRM{0M=l2Ot@fAH^7zwI8G`435k_e;;w(B6b}#V-(%jzgfQ<Zd
zG=W%<mBmI*W0tNFfAFR|DTDmbaIju&=LHW;!+jX#-}Sglx}m}0<Whz2*o#QIg}RFt
zlP_Cw@ecicoTYi}X_(_o)9cckYwzJ{v}FOnJH8r`n<Dk0EN4_dB;k)vL7rLz6rF;R
zj?NE%k*81X+hz}F{8JJQ7aqo{*uOP`q`Of1p9uHLzwj}i=4%k31VM$9q6jw8T7eP(
ze~^aUl~=j@b{v#*q4hX$bK@4B)Siv7vds&zFsO8rD#rgb0DNFF`Y<FkOk9fmi&rF@
zAD1AJhg^C)q|hYD4gK?<60SO&0<_lL-o0Lbkq4%&_oAyGt*cgso~k|u9kn9^>|5w1
zcK4y1p1Qp5%`ZTJ0(Q8%3hQS$$$c5TpUd>68ymaPSGMmf+gG^LuWa8RnC&x05cMrz
zM6a!i)|MP^=o7Wp(S{CZftq%>4W~Il#bekv&Wx!Esuh*1YLJfGpLDf`aybpE8TA=|
zJjTj$n+!ShsYslI#bkhF4E;J};lW{YF^ez3RKoo$Zm!b775H=v(;P$0cvZeMS2Yvm
zIr2a=5jV$y*=_w#6B3Jr6Mo92-_N(uP$T=wZ(D`8zjS@G8u5M#sJp!P#BYR)+~WvO
zpYASeXB8)R^;@GjpC5l39hWf=#Fuq{r|}?RqxLces3wAc6|J&f<QD!2UP$=Iv60E<
zY%oLY291)aqV4ks?_xsS5L{NMW;UUS%*h7%awtZG-A5=kt=2({m}f#0TsOw!>v31@
zD(7t37dP#2Ud~9r`DNqfZ=F3*;bRAIfs9l>n3y{TY$~(eWh=ZBU+O}~VypOnUbgDd
z$t(j}!0ST-dWalyoZkAkC$?x{n8g8<Wxt??9{K4Q%ea_jWBsPiGkXGeNgBl5<o=j!
zTNn*3W@SU0DZs=rUfcIl=!v`)O{&>*dbv8^nQW^wS$YCG<h09)UP;ytYbH15juqOU
z;$4jG*(|GXZO>sV$rN1r-~mT}VnSt-y}L1}@)B;+g=UGXY%T8{`N%5kmARx6ta5qG
z^%36^H>#LshZhEaO5FqR3-#q(23SpY0nxzICHUgoNa*}UUIjy8Dv*bD6%T5$dt%Xh
z&-(Q;wi0~r<-9AYQKG+kI3;cz<#%F7D@tDY;%m$C7;+!%rMF*s2})OgUmVhKE0)L^
zW!VewDBtV>yfSCG7u|Tx3%2!O+9f{(b{%fy?l1UiulIdu-_lq66TH|DOQ2jXu<R@S
zP%rdDzRs(?%y)m4ms~+@IR!6qfqwlCudhZ3m)wRh?es4O{;c-m>TksFi_F1S*8jq4
z3%Aen;{(|Y3Z&eS`T(PUTnhzYax)C#(&rI)!4r<_rar5ryRq?kC0%WwUq#%nBCY|7
zuOjZ<MBEa0*jnD_6mk79cW;nEg~JoWpK^GfVu_3|1-Z+MtVOoEQ0`El^<srQ27eHz
z_rTc~SyX<1Yek`n!e^JTny6`vc4(9{0z<LmzkxlYSp5QjKEIiNLoV;Dr9=GrLs&X~
z7k=aEQ}6ZGy)K<){)?;2zbbUUDs;apbPE)^pH-{40)bkAIDOF?!>_uo&&u_DRd;>m
zbG*y^7uT6QxE7!=>tL~pVC7VVUws-MSW5uZrPb;7qLW6qYjCNWmdT1~FtuK+5oraK
ze7{@+z~`_R%P07M!|MlrSAWN^ihw_+BH&-r9`y97O-H_TQ_Rz+21>ZgRTR$+Z}F|{
zU*6a7L45-s+HsM9a#tk$l9fXG8>+DjMyiglDx<F|qpv=I_j|^cQIFr>1&=>jTTU!D
z{3-oh{i`_NJ&42HLwfMhrdLIxuj;_B>Oenc{7a|<ze+oQ#wxx_JAV`v>b=~??(4G#
ze?EsaQ%3b05;JIZLMO-_h2&2(s;&6#Qw<K#^w#tNYL<BO)KnSP94)1$*QAGy6r0Wl
z|7Bc}zN#9(sv5sOz8b_H+V$KaRk~X)5iB*tAJ6mL*<M2q$ahyfqV`W&H|PuC48H0?
zJ%2uB-1TRFx+b4NA-lRJ_N#XDt9J8`s@?nqujYf2g5O`e`Warxud3I;xjlsH^;5+@
ze_}NMs{j3}|Mg?WSN-o-5%jAF`o)W&|CY+>hm4E<;zY{QT5)IPYz|y86u;v|)M4tN
z+w_u(VTD!KiwXiREe05<v|gq@V4yZ&>AHZT%$mx7oGTX}y^KT_UHfydbTuZer#rhC
zLMvMV|9sPIy!~19Qgzx?26|(SDw(rH3!e1%B4&4&cXB7+c*(uj<zTb|-dR76=&y3<
z)yhP|AB7C|*=uL1j?Z^U(azHO{RKH6XnxF^{Puk($rq!7q|bX-2}HclW{W94BSe;{
zy!jM=yWlI~qMVVWolfB)qX){CGO0y_W#0c->}2riDxAPmB44;NHO~rU!becEoZp_K
z_%a=^e=L%UItk~Ax1ZNiH33AzZN|Vy>qpI_<Ic~~-f^dMdIC$0_M1H><TUrA#zC*y
ziA0)p_HVhJN9&$vgI~k9KlYoQ4wI2i+dsB{kKeWXd&eg~mwFB!GFrqb9~43rE!5+o
zQDxgIF!2>t9t>5~0NvBQy=J#tCQUqSohYq5N{4bjW<%p&3Lf;ie9MVaN^UwFc9jX<
z$Sh95=c151DovqO0e*aA-1tpbVcb6=!Rw2$h}9Qss^My7x%!+*9)qi>A{xU-9nS}U
zah`bL0vq4i(cjD+>w0MDvP$t#TZ^#1*J<@ydyT^gQDZ0S&2FI}C}XGDo}v*RrjVuB
zC6DuHm@Up3;PQDqc+WK#={&lLLF8hO?~qq2VE>-MNK{+6uH)rHQXT}eLt>_j{E7-`
zYUii*a5PQ@3a8yQbsx^z2H)?NIXlLGTOVJr*ULV)hkCbth~U1;o>H^$hu@EvzK7g&
zmwy^=k(=TS6C9Ag0eZ>s;Ub;qN^wHPPMJJ|WoLn2)O{O}lj^t2E=UqMc34@_vES(c
z8J2vi1JvNwPHuE{g;pMxL2P?t8qenXU1D!dCO~_U&P0JD>Wp$ROn!|^^Mbj5pm4E8
z9)bt5y5G<zxc>?hIGwewweLm8Q}<MO-ZA!#I$j@S^Mt(<!^l1oEBS2bN^WZfg3X6_
z89~xWxY<!d=)m^0uFfW1<RaA>(Q!uNXY*tj++0EV<5d@_6WpE9e8d;6{$lCdD}1o@
zr>$;tQr0Gh$wkbhz3^g<>V$WHe5)Ly<;)rePpi$C#I}Hw+zwxhS;cANh0f@3)!|YW
z54y{mYMh_acq_r6JtW0^NY<eY%jmF*T*I<r>2;f!>_kWL>^-0%!#Y&>Vqd2)yGFhp
zK?q5|#+$A{l1(AW7)U()FJy(efLLVqqDp;5;?-_JZ)KvA>Mol+>e%{!^o7;mXH#CD
z4G;e8jgok>m^Lov36{*OSeKq8pMdR>9qeIjJ`(A~M^m91S2l&$9JOYgcdq2|m=Uau
ziIcqC`>KAwI$w7$BdUvCpkfXpmkO&iF-h-K8j+l{HAZod)<Z$FY2RMXeGWH#wl-r0
z#*cERhD^pi!LFF^-yQ6K$ZbC`*u5$M*7`#HAoR}{&SoRsH=P|_2bAaRx{Z_Zc{0o4
z!rkW4f|1m8p2j1#xgk5wc`|`1*ig5q!8%XoY{?P3q3mDdcrr-p@}dJ3Ar=q_^cd>}
z!VES>*b1z`gSE3m7Cts>3hReAHl4(?TW~GtX25n;mVh503C6O2+cjx5eeIGF5_k)1
z*4aqlnjh?QA@kEAXw$0}I;Lp12uv5$vduSMuKI{TpQTTS{Ss)U9+$i^DK~*UAa?sm
zg`=+Vl8OQp1ZKyU_Eti^m7bix+Gye6t>>*ERIPbvH{qaxcg46C?fhN~c#Wo|St)#%
zBmXY=zU|f|{oI&;?#Lxd%_5xSqDeMqbQj!)*wbnYZm7v#DuNirVq24otUw;YbLDn4
zv(w`!Tg>4vLS*6pte2GvI3|Wo6^Nbs*NQm>2d(%qx14g+;fNN~Q-uhQqlpCElai1V
zgB3}0z8bvlwh94NHCJd&R&J?>X+D3&pT6I(Uancmd)3{4w1o=}!OZG8oh8@!?=NkG
zy1cw>d#buIDsFvv^?Pn_vjlAc`p2j}U!PU>+Ro_*pY;b|vp%5i{?A+HXOK3M_!>k;
z<W}f0Cf`T~lq+x_0?%Le)C{vEpL{cq#xXFfbv}Br_7FJ=u@FD6sDd`bm9e!Z&I>~y
zm%_BWBGsvX1&n?x65C>`M4NJ`C>zNksNtRML$UV5?2>In?J%!=>OvA|d5;(DNlpEZ
z8Oz0l-KdabN9(*MMiR@zxtFpgb@-z}NSq6dBP^<d38@);j!^SIe1^+H$Z1TYA3T!5
z``y7qPmgsQ!a7^$Zg|w7f2`^!e;~a<SX&Sj)eu&H{jb^rkLW>o)E~t8{0HX>ysSJ)
zb))0M$>9%&BzHReuhRPGm)7r#Z$;AZaw)j<3PS2)_DDhMk*jPmg1Dt?Fi8vs3r2)K
zE_3RpPJ7vS8V}}3!aZ+;h{57SMKFXxUehK*j!w>-KUxeMd|Zqa)Er=D=a<p*ZGgYI
z(kIb>Hu%C+%(fe5t14^uyrk4%YE8aiGpHnnt-R?sUb-k{2rh0DxJyox<x+>+$}4$L
zvw-wrG$<zyeUxS#ulD|~`Okw_LmT1lx5J_+&e)oNjtoQByk$fH;}{%>Fjy~zX&mFT
z&%6PDc(h`0{dbA&4|@-hlJriVyJd~Q8yh8m0RFKw0J-B<Y0&A2{xaHJ3M}D(cMr&v
z+OdCfpVjaGXYWtf+c=VhQTRWuqNIL?FF=8iM7#U+p_cw25|l9JHY6ywUylz|1d3#}
z02BrVkm9u6*ZyThZjoCpASKH)s;Ao`s&b8tjEsnkr8aDQR~8C3?(Qyy3W@W3PpFiC
zsLrchK39i_vDrQYRDOPTuN_nYBA`>pF`p*j_3W~9?I>Uh1?P^-UK9t+kmNL*9a+qV
zLvywqqH8UspzVuM^#qFWP+y0!4#x8Ah5q%@86ap0<mWO^0I}pQk(5KNxuoHq;Cb>y
zHv7W){+sg#)=W(k_-IkLYH#kOWNW{Fcuknpl&cIbG?m{<NZKO7v)f)X$3(LV595{$
z@-Zfr(3_tTg%MZ=p-Gq-amFLIP`1s5dkt2|9g;r5Di29BLYRj&1ThAO(1<HAoaL)w
z6!lo^5y*i!P(Rk9f9wKoXSeYjfrpOg&{uSn-Qo(TxedcLSIQ3u6W2;<H$2sUxj79w
zvBI8+6z&SbA@o4pT^Q)_ROR;MQ<(>X$0atUQi!oa^g`$Vdqu;Kn5{cngRrk}spwwa
z74}}v*<a8L+vDnm&LsXTIZx>^=-3bA1;Y$peowzBsK(7W`_uR;dAnfJ{Ulzb%RAn}
z8}GN8g8J_x^j9-ljDG#~e#WJL5W!(_2UZ_qEJ=Z+qy=2M01Nc2eiP>jjg>2lRx!sm
zheX!-{wA34cn0XR%6#HlS+aKoD?>-|8MtEbdj!!G+Zpi$fNF>kIzmRL2$E`$_P9+o
zL3ci%+_6;?`&~C_wSxPY6*`|c=@;9f-cmwvcQLSbNV8RL0UFtC|K5UsmAjmzqh;Qq
z%^k)c*-lNbu9AfwGT_E6fvpfPEXF0Usb5FWfh7ohee}wj6O^rwdq}wbUF?d<K^QF_
zpMh4S!UsT3qLM%46?M#aN^fnwh}I3ZL>u$+?M`nV1|Akc9$xwJ?2Iv(Ckz%%T35x^
zF<$a}P!rYs&}>!Z9>idO`nezH<f@p1L)T<|)_FP$cZg_Eh5^gP$`iv!RX077=;QJ$
z?i(j^k9=U~3(u%*rZ?!E4bvZA$1@PKyYPOKlP$x<suU-H24Q~7(%1Tfrt@IwHFHr_
z(^sjyREm=^siX>il+3c#)isTQL{8Bdt{Z%m8X#}L?ulmb%%cZ?)W&qe1@Z4V<wn1y
zdr@uCT>nyijFL}jzLXL6`32c1p1~d2MG{S826cdk8&i&iy!p2f@n(#S0g6z;YBHhA
z@`SOMl5GH6G1;a;GMv&b+4gryP}(8iw9#O^yfX4FA@3vM9xi}K*r5$8+FqG-hi6I#
zQ%b_MY+?>)87AR>#T~<AhExiba*1&GZIC>N2U44G!*h>Q#Ek;UM7L<kBsS<Y&y(>E
zlUh&`G5hyLo5Dp9R(Y=?%O<d86S3zONoRfg8U<y0I~uL>Wi~~dJ|2&)d^FNFzcj#u
z&nDhFw{54v9~bd_D_-E8KV#tCI}t}-S_08)N4N2EbPb$;KDT#GWP^b#J8&)~VwNo%
zJg^8@kdLHN>;WUF#l3{T3VPACgg>9#BVY7y!rwRHuQKj^A>og55noRD1McCQ@K@F$
zqQN)e@9Po%Wb8V?R<4W<UnV@Tbk@|JhV?f<X{w8HN|baWKk3fwd!2Rra&<ql3l;h2
zk0nVyq#${JPq9!!(!b5!8sRmq*us-1pH;McE^?TB6D_ND49{06TH=QN-yl}5FB)#!
ziJk5vp_Yr4CX%duH|&OK{$F!9{J-^*x0>9}-4@JPYjZ#`v~f{x3&Q)>4yM-Dao0$E
zxr+oED~lHDl0U6UvGpV(DxwzD+Yoz6=syr00479#M$?)QeeAy`{F4O`-&mZD;86!?
zOx&`=saMfo*k<Vuptq=~vv7v%1DB^_i6f15me~rj0)<CFm$inPV-52VIX<o$p{4EY
z7-%O+zQ2|RZ~ru)XpHnFZE+m{>U9+@ZoP8VOTSsOu%wcJsI`~f&MK*Qig|iiQ6OE_
znfn@lx}7hp*U`(emOkgR-3V3FbKd&~=nJyvE>l{S9d~%}VttLD`@M&rCcp#R+%Em)
zWzB2pWUNkqGYC#qJ&a9ssuG1#4UA3d!wQs6h)O5o=7o)<Ad<1Zeh)g(REu#<Tv(s!
zBU=r^QHW50cue6QSn+)yjYl!T3<m!EW`gv8`)Z+ylEG0(*Vb&5D;L(*Ci^?BrAVkr
zK+S8j3QB{ARTvaV_>NS+mSTZQ=Z=7+kD-7{Kxg<Gf?)UN;CT0k;bCvk-Rlmz!-M`&
zuX{S&KR?<9`}?y>#T$)3rI&1PU3$w54$k%)K;tuXa?hEFIJ%BTtHlC%EQZy<(Je54
zNE9Hy6U+WKgFr_)EE<T2jBm_8rgKd7Hf6=2G6Y6~E<hYbNfbp^?M1MA+UpL$NavLO
z^Y*9VVgG2z6RQm0^amhzO05HU--j}oF)<OY?XMGv0#8Cw;g}Z5Drd3@6G{|OM{zH=
zLN$SaFjE6<h(v28V;%GldpJ^{x|d9U&PpVRqGdV-5j@XRCT4dUBPNCAuEGb_AlixM
zOcqZ^&S#QpYWILi`op7R%nAel9v;8%HNEY%8oaq3si<*_H08Oifw{|u4aaJ3XmQkA
z9YCalR;JCF?o_755}WXb|BC+QACr_(#NlOxmBYIo8QdVsZj!|!We4Uz<u00k^8Am&
zneR8N9Ubi~FK>vSHc&<Sdq02S(<6Y&N{1Y)*rd3mnGWIV3SW!Rjxv@!z)gAk7c@!g
z>yX0FLIc%+<dm^Ikf5j2W)nNyqyf5Gvild3tYP?t{w!UZk&7@LiE8wPo~(A7u{wT1
z+G9jjW=1@Ny`3-9Q4W)E-)=B}N|CLW@FI7cq%E2)Rc!%CYB&d@YTwT0*i;1I-}7wt
z;{t-lY($ve(dmMd_J)R0Vd_R_y)7-U|GT9LR$aMi90d_6RTRS$P!@|Osws?Z1W<|l
zD(2_&t~T_d!BsiqRdDW0W7<{_JTD5DWn=IS`=P_9divOm){Hc2wPlrmFOCUXTDM*V
zPP;ja_|=Pd>01X8YSQ=V-VqahjTQ$hr06wYq&IA%?I@+;Xp}9+;u0WRqzvfnz@5jC
z)*xlulE)ajKp3)v8^Uu&--8nV&#H;TPIMSE4sMpUqkbnkP3PHU(vG?vAVc|_y#==F
z-`SUhHT@Wl?wu&cEJ=HRce8lP_?W|Fnl0`kF?L{$*#DvU)&RJov%4IOHXh3!ub0dD
z&eNy2x3`_EH0`YBH=QJZx}4;fPcIqy%%3Ks#WH{P{SaPt=Hp9#yaT}=36KEc`75J4
z;_l?2_r7;9>>us*{?0h|Kfmx-c>WitamaW)altZ#Ea$Ak_MiWM5~za2t$)-X^t%Uw
zpGFpuv1R8+16K8Us3wd~u(q6+JA2pPhZ_G+QHAc`hqO}fj8*u{pQ9~LQ&Mk^=M0iV
zqTQezp|eM5ls)I88F-p=0JsBBuJ7`66i=LwAT;Wa29d<PDm?5G<13&Q_(6kZ6LC>h
z7{niwnOy_o$<oq)f^!m$b1*8_Mb&%cR>b|d5vjck{Wz|@k7UcO7b?T93_eQQ;t<$?
zgyA=8n${S6<t2&ockcE*6Xg}xWzYd@p?E<c4k8_}Nc4vJP57-F*YYv01Fq@7Dmh-t
z`#AOsz^{+^8KXr3-4j6o?9}*Z(mkSb6jHIt{TmFu(ne-~OGa{LD+uhTu9<{1cah|b
zB<4Jb%Y{OJ)ttrFTW#ii9~dnrpGK1v(o(BUV}ID(J#Sdiis_KA-kWqejpzE~U-26!
zl)JEHliaO2n=#pnRR7tf2fsMA;IyUD1fFi<Kbz6Bo#@%tchLmCBSl6rU5IeGDD?aZ
zlxlAOe`g1O{jKLMQhEk)5v}4+8+zF{S>G^J=wF@dCu~=$W8ftgd@Vty-oGHNP|-%U
zg1-WK*XfY_;%DqapprTi*s=^V0&AaWf)qmolb;P(@eGs7p^nn6*w(A5+jm;SrD3cH
zz=k*EsnymU=eo-ZZG~r}SqdKh2T=)tDMUGr)Gfk)dh};(gD%U<9VUw_PmwkyJW`++
zuOQHpZa4r*nB4|qojZFj3xO2Cn=pyph8Te>jHuR%1fn$rrm9j=WzpwF<F^;(Iy<5S
z^eR$zb{<scvyQ$8EABYDr>3`;V57P{J`#E+G@q%L7G?K-L9SnaphT6tHpnq~uSqI-
zDQR7QQ}Qlmw~D$2CLLrVRWphXx;?lgFK|=D_z50>+J`0~J)BTGa`PlPO?`85GmVGi
zWRfhCVZ2zxcTH1MC#MM3J-T|^0HX@K?@pw%$9BRZ3%6R7cZAO?pncM@>5WRFJQkq|
z1p5;EsH=!~#8^KJ1llrLRWxEZQKiH66bd?jmXZ+e(G-W_RRQV@0OTWO)}6dGMoG%K
z7njt0yyqj~W(yl3T(Vuxb38)GCFdX)ur*HYe3GiN^z7z`3_Ye_IQtu}l#D(ZNTa{8
z|L>UZAuj>rmYUDc52BYZJz^(>@@4~Rq54=MRRE_*|4*0*8ETWaV_fFhb-!15X3#Q!
zz%?@ZClbERZ3zP=k0;Bfhv#fZ&)PmYbQ5tgyKKs1wxw}gZhF=&5Q|xITS_T7kKm^g
za%`HGJTnXG!3Yg?QT!!wL|STRa@F#_d(dZxZLjHQ_<gCa4LZa2&4>|)Wil3at*)ZK
zs1nIv5~wJ|nOL2Jde4hbm+Im|hg#Er$-igI<O<nlDeEAAkA={1z~Gs9*hKv6r72iM
zPo7NFnV@Ar$_e5e<cj?arLDZCywoGT^FtO5#+qDkh-i_xv?!%Aq%*Uk2(xx!6R<M#
z2VaM}c5s|ks+!}b3^;uxtepnTqM;CG6c2&=D<dM$@xoiglpHr=_v|itU{23}p@>GJ
zVwZsqH@x*JQIwmC!lvMea@LdcEP=z%XFu)lh1PQWBt?xx&}y5-Qe8lH7Lki=@EY1Q
zUg8l|iHSP!PmKxj;>w7M|Kx1ME3(!EQ49p2)pZezz&&|I+9kR^SM=fryIN+|)vN>n
z{Dayz0h;jSiK26k8;2luRGAZhT_lric9pB#b}%lV>grO;r!M*O87Ub6*L5EmcxlwY
zGl}OD@H!EXvl5DfDWUZ!`2zUOiexw3^u#Gb=c@iLAR&@SKH}|eY($l2Y{CetS`B;7
zKMSwa5Y%4=6J(=CY-tYVLvaI@np(#R1~6bS@}Sru;H7HSI!p}M3T?`NeOJ&Ec-701
zRv4a_<}0R(oDXe-lC;UX+J~aoP)w5qm+-m6^bo*eQf>j($wK48CwP2#;IW_1()^kn
zf&?xtb#%BV9wo%DRD5ouh|Ou5oM}OE&11fDOjvw1DXaO)P{H_06Yf)qw^}tLNrPb$
zS0c>c&-6p8GSvG{u8MbmaQEZDo;-O`R_@Im+>AVNT-6+oBj;W>B!V*N|9rDJN29}2
zFp_KPp4%?(FX2WR3C&~&ISGfueqpnVMa+ca(S4`!I@7u^CL~*NY*Rzc5_^E+R)4F2
zQZ;OUTofwA8?6pjLb(=^-CHfY*&v$vdT<LzTh6A&9ad<xR0OMk+ICC=TtXVvpo&c5
zfktrNJ2_kr`_gFhwNAQJq!|<qaEHp5QmGJVQg{-g5?2qjt$VU85>vTx$Y{UlmQ=(2
zd21{EMb@Dr2yqEb<=G*D;%+H4I>;5&(9Fd{Y_XI8uAdys5?I7WnIX6R0UXhHB6$Ik
z-EzNLIA73?wg2pYk}FM|j3Wux@daDrmvo6Cd1Q%_L$68dQ*eZcrvoHPH4#)2A(S&#
zHS*~+Oz37=yXuEFhA;%&3TIt~d3jU|1!tbqU~e|YhFaQazF5^)Xgzr^|M`H$<QH_S
zC;MFuUSyt$9`ADRA~6t=9)d5iN?b={ztNds1AYtm^OKW*-s!Nrw|Ck*J45UDQ9J{i
zGISNk<j`KPb95V*ijsY0e{e-E^Lfy{)x3cJhR4fnpF-Ug2bEl6;)|o#HsBho;rApI
zd!CK^KUOK*_9GM{G0a~k+#S%}UX7bBhQnp6d6+IBvWxyD6Gsh8lyt_O`O!sz_l;n-
z>{9slv<_8&E1QStlH8(ilC5W|)eC?|JT=??n`}9oQ?aC=dI75=bSctfcCP6dVu1WA
zt`F1zJbH5kJN$LFOy+QdL_RiMv%aUs^-J`(=(+!vCEAI;ZxQC6E~V3|laJ4u0dRlM
z*)b1Y;WaMXE@!*lqv7G%8{IOnZJsM6gZ2WUFCPzooShUbt>DOBc`B>BD&th~%*p73
zSlb{)n~8!tZ<B43q>2KwQ(RP>wz5sB?J#c(iEh<j$W+gYT@_PXSwV)=Bv%WsT#q*D
zxB_{6N^P1UT&p+-fo@fX3YJd6w3)G1qHTiOQly$q5tb83JKg_AL95MskN}h4F+_d}
z9He%CO9qDJlARt%;ViNyC-k{#R>c7ysnIdQ4NOT}y3WaUU5!2_dP#*A(13DCe`Qbe
zi!6;ZTl&F9NaMF()o7*HLl{NzRh%;3k8gqtaFb&zZiC9+z$W&S=^Au{bS+?Qv{Mz<
zMkT9@F9U0P`o`}Nto47@2~m%5X@AS0JN&nQ^?JDVvS=SCA!1*A-Gq<hf}hAe(7E-$
zkXGvduDO4Y_xI0w1C+x&8~B7Lw3kN|hWJ6_f4H8f8tVJ$+(aYw^=^*5;!(fBLsW19
zy&*hbKpW>rL`&C$(Tu2ygh(<jLKUg?IC_{9<Z3Dx3|d>|4id|5sOfF`)mCykWM5r>
z@a<$=-s3xrvC;bcJL`{3GJm|z7(K%<2x12UyU3(_%s0$U@&eibK6Uu7C;j<1YFvyn
zJ|NWQT>n_8_Kj2fJe;*u9sHO<_>)nbv%y>fCWsUDI?j2fhiIJ5_&yb|dh*27gqSvz
z_E~MCE3q#zn)&5__5L*1<j5eTQ67(fC!Cx*;dWIJfzTa6wb%ke>;A>>;U5L>lH65(
z1bmpVGdYZ}(h>WyN}75W)(uef#JF0jVg+Obo#palw0nGddVT_2YP8oI^mYfmy{NlC
z=$%H=IE4LHoa`eSLe@f+_dg7Kr>DoK!}Fsbj*fpk!jLzW%vp5<XXm@Sy|c4_a_bUw
zxWLMlgF=)9gs}Yk-HRI0m`<)73@C-se6;qG@n8aRzyp7t&B3K#arCC;n!rvG%}MSt
zX&*0#fRo@CC>{lSrbD#K;^Hbtd+?HZ8GSu+OmhPz6&k*LB|4;DICh)V^j6`3?b}Ez
zdCl~z<QX=deA7HnXIDA`sT^y6v=#X#W5l9`n7E<=5+IeG8EDtb7nBi{5nfX=GI$%w
zg9I;htgZvs(a@G$WphM+UwyI~x~iole$1mk>Yx$8xH=Pwml77w9zCWan>5{f<H|<l
zHOfbiUR4RMtF8^Q$ynTBI5x$kRXbL^)#sB}&a#HhMPXI2)@YHTLk)U=MOaLhoU|O?
zqmuEJky?AiTV*5mZ3fkdhv3!*2|TukaHxX{fm7YcSVaS<Wc@3)16wc6Na0@rCp-Cs
z_YAToytN=gS&no5^75_IylN;^-fEtXHB?3T3l=Y@F0M$upPKnAk=PuT&9{vsvW{QY
zGW#q?b?@;JL>-^2i-3-QJl8n#yTQ2a6G;0{<f$8d-Z`&c1<tE~+GOU8@hx+tF&-Hc
zo;q%$o;nI0o)r`+L;>(-G)(cG>K0CiakRR}skeshdFm}x;92S|U*NIoM>=cVPS6T}
zEn~yTBDM<H!m1$KBy6wnA2_T}7TH|gD$5)W=x@;$M>qt#yi6f~PN#^^$@mQO$c7_N
zvmx39#pX6@kynQ(`S!boUKJ^mgO))W>&M4RB-Z>GB15G|fRB(wmfzHxB*Y{S{?n)a
zCaSP0>TbHq+X0?}Q{KOB70>O!0Y-~dI=}RP&1sQHQm;t7BXy#bB%bh}hTc4+53(D*
zEmz-v?r?vf-B_}Js^KOoU`@@PUV=S^?nUr;%^PtcA^LgVl)-~q_{V&?V1G(hMrW#O
z7wkM~b?Yvk7~_*CrmI4U8l^0_rBH$he3i;CPdr)2=u7L!+-0Y>tCoTcPei^cNJb+#
z(DZ><a{-`X4*v@ih!+m@wzf>@t*3#gKr3uv4`4))o&;%sf-h~yi(IY*e5G3n;ST@!
zz;5PunkF!~E4psNU-`n_`g&rvm$TFgxO##D6+svfmR}zM1dggr9slTl<a2h_toD|s
zfK>PP9BzRVn+(CYC9+$3;1zahk*Z(nC-u<bXKPY{vh6L*+piKMDt*d&;^Ej8_o|f5
zVjvxLrWreb*(@VYN3yxi?{j&~>q7eAR|Ipj5^SqS-TizZ1V$x-0fvAll<WSvS_7{#
zX(uYM5q3(GPrm{C`yY^O4BvH+_6~aY@Q-}JyBIP&J1@nB<`5i5Exe_|<>+6UK62p5
zfflhs1&hL4Ji8<KZZD4wmpW@xFY2<1ifB*t#==K`RmH_dUEV^;{%n*nrew4v=oegE
z+RE3nwgpQ;d4S@DfB{sCSY3f8RHFt#&=U(Mzd@8q8%&pb)y3cZ-;vPnNY#{R=~*eu
zDPnSq$(sa2he5-d)EUP2>C8}$nb83QG1UqKu8E_=^5CsZm)r&|0mYQ9Y3QPY%b_BM
zi~vM`OOCi|A%+p!peVmyj4q?5Kk}Fz$jlpdjE~>LvkN3CMW%a4aev@*StoMMouiq$
z^o^}E+BuvJ4MYhLilfedIn#$~#F&g$9#~<y%<tIB;34A-hVUY-8abFSFL|M_7$I^p
z2%qg2mJ63KH^zI*LnKw)!@@bN9mJS&WmaH+MBfP-j3*<;%){IdM{&M<DM$Xg*%V6P
z=dI{z^w%Qy=IYJ-<@=WBP%f(Y`n5U7C%%CFeowvV{{uh2KqyF!YIu7cKKIuT4_&%S
z6a>1qk!x2CFqNqSEm*<F*Zwe=1wk-rZ-rPQhR1t<5^mIzl|5CzuMhB&eZ59JQZXif
zqZea2-HpljBHe@KM^|BBZ`b%p5o9-ron6X^UTE`y<Z{3p!qF*a-4BTG`rQk=2U5JK
z2VKm%v2aEZ)UlAo4X>=L<&#zIEgAWO&l-o3?8s`!*nBqL2&AD~U)Lr}N9;zisb752
zBRz$RB1rnz{Z)DBPG1fKIhS9ejaSiszXa9vPfL-s!e&e&N4lnLyyy!Zu|43Yw>e^_
z&NYIMxiVRC(EC~vM?l)xvNTJj5v>cN@~^wei!?$hb|`qY<t-zOS{ht)yFAENS$~_*
z$T&W8Y-5cJt};FQz}-%A)dRcCp>+>JO@s8Uc>DYc5vQ#^NGXM}jeb?(sbvFyl*fWw
zqiXp7q#piP$~F<$2e$akg;$E~aD@T>IrA9&?xMLY%5$IQ-dHK_U4_}2*g2R;#}j*0
z?<PZNiF|Qa37~v|F};)Y1dDZ$&M$d+bu`wMCqXyA+Cbc{gi{ZQbqif5uAeDneSVFQ
z7PeWS`$JU!1a^;Xf*oT~^Iy+@IPYJLqm%3Ki1rk8zP?Vcu9^HlNp9HIM)^CwiPH(D
zZo`GhT_)m^j@~#1ajZNXi7DzlZ&?Taqf0t4`AFTS66akv3^hD64glz`C)q7JD8V-1
zyGs)qW2LA_e85CvITkX+daLB+m5eqX=}4O@oU=3Ne04#_9gJ>l@cH(CT#QwBNsBkI
ztSM6jV$YU@ytgyw;Gag;oKVJ`dj-j=5)JDfVXtubo#K0c4EC!@t~F#f+GMQaUgJ>M
ztMj>NTB?)Gx!Ljxzb|}AqexjzZ$-4dvLH~qDq0MUk2MlW=5>%7YQVrIPtI+hI+S}k
z@iw}%v7D$eP{aGn1c9D^De(g<jc0|c$n%8f`Q?fS$yzJHI^gk(V0EHpjoi%e8|2XP
z)fP&7y?$E(vkYHlZFK`Zqi(pR08}($;!lH}lXcJlJekBJ$x$$VLb>ll5(o4{V2F?|
z|4*(`v_VOQA(}`%G6O6rC-sizCA|?RJH;|~r%+@hU(J)m{_10YX*;%lz&9qZwV~a*
z$))=uc6&dwY7}uEWM;HM08T)$zteF|21Mpj4Pogk<Nzx#>`f{5zPCF#K5abRY@7i)
z&PJI35W|E5ZRAW6Qc}qD${4zwQN3KA@tpA>_YlaJMEN`!rI+cb@qRV=7|&#B*w~#$
z<LquWx?W^6w!6ldiexcke+`IefpIilEt5~3#^%$8iZP4*^Pm#){$Y`VKUK~^HCpoF
zUM}J*Aju-=Cu{f9ayZcED%ai~9ity1{Cjx(zSlHcZ#8I!RP!52v#lr-o9(sw)5!D&
z84siDlNjvk;BQYpIt~>e4Mkb$=9r;(k&JOD`oM)pM8lY-GyG^re>xRk<4?Y?Rr0y%
zZ3MGPKFt|u(xqo0YEFuj>2H^lEQSzoX=b)*dDhJ|Vf5tK6E3(M9Yx9HNE<Qz%UUZE
z?^Z9BwmX3mc5>M1P%ouS&MFs@)znMrt*SrEx*`+pE}jV$>Y3MLznPpE8^EE7F22^R
zB5D>^ChQXjrF@OKf2Bh0`BQTG+Vq$7&9*BM$=8hfXu$eiocC-L_0@I?$yPX~B7iuu
z`oY4#$x75k+%Rkc>^xa|5zT|gFSN8V$gC);c(V`3JzHTQj=<Bx*pqPw@)eJx@oEA0
z#AA~Nb{d2Vz%nT+;9VLd<;c~s-SfFd<2zV3)!>>kybqD&f88-k<r*=eI{k5Ycs}U;
zJ=%bc0;8fSm&HI|Xdf^U1%Nxb918N8OYQ<yP*tPDn^o4zQSgG&iylPhZJO_NL;}_l
zBXI1G-V8+RansE4s%9optLZ1Vxk0^MLC7S&9+!9yId0cEQh%4^M9sw;GcBrEb6wUx
zsA#{2G^j$2e<SpfvGNR6ozN);i!P3VuUe}S@cxAgKW!qH6-xs8Hu7`ZV`V3laR!-%
z@Q5%E8d88Hezp$*+Kid8+C$+<VaYxW4=H=$FF{$1f(`@ZpH#Tuvvf(cf3Er<Am2F|
zCzLuophGX)L9l95)brD9m;OjnBdKS9#&!qNK;Urme{6xqI_xhU37W~!`3MkbcBN>f
z2%zSrmTo*XZ?V@Z!M2-G90re{`eQ<8KzF7_d&Y(u89AeHTbw0Jt56f`-oz6ixV|QC
z;>ioI_w8;x8A;5cXSD(zsNHf5a<RbM?L4|lZ&bP_jCgT_fa>T0@_X>6|D2iAD=-}u
zFOR@qe|Q4obTWr1+ptb>gsD?88eAuLjFY}YvnzHULg*j4p0c(0lF<ZqGP3h<#Fm>3
z%D@5ui|4$-*LM;rGy`i>bnrd-15oua)eg>VpDifSONv&4%NUqxJs^0dzdwnugh-2j
zIzouN`CSVxfq?%tLAIMsrzznzja&v!TPl7He~#yr2C-Qa$X^2_>wpV~<GDt<P@=3j
z%vd`|!cC9f8Y}q%m^0o^3$wI)wJt)ZVyavAdi$r{w}-u>fr#OGe8dinL8DxSL6qG=
z9Y(0GqtFNytfAddgu`l!(+zOEAwqeuKZADz8);yLJyXH==sYB{G5u5hjmo^YlZ;^p
zfBtqEeBIUw<KDQNiQ5HyJ7lK@pTJc7r2+tX+k*5XHCi$`KZY*s;EQIf=>@poUlQgQ
z?}ypuf{V2ADnZ*{z*GeKB2Gd1c9C4dXU;Rovun<}<^ms@>k(cFE<ho3Gltzd8xD?#
z{kKQQr#%L~=YJ8_0&FM|=WvmSOBMjoe^t(aeS())eH>9cV$+U(lj)E+=I#ps2sYBv
z94mS^R<WYOG>2+LU(h~aG|8KI63<5By!~f@Fx_0aru@EAU8UfE6`l8w27mc}$Y2!g
zyZ33C%yPzkSe+BV9nX^m7dUn#*i|vp9Ll)Y<~(uRd^uoyWCidx-m)>9-n@Wnf4n|h
zBKRTdiC<26u!Eni=Iv-thL#f3Re$SAWa_V1`mJ>*FS^rE77_s_Gf<`A#=ZZ4dm;FW
zkqZ2W<Dh7PP0w=wp=6+$KSrBT#D8vG!hbD{H8wj89QQbz;6Hy;Q!9`*;!jA1Aazwp
zc;iKgj7tli>>mwprZGyE)?nVSf02LOU(HZC0E{dAmI0bIo4IL!IyVCocts0m)*xDt
zWs|b1CAc`%0+Nf{ylg+WP0fa!4vn#eT<`F(NJzdA{jiy5j(h<4fNV`(d5b~0Ie8(L
zNlC>0DMJj<&}g|>k2Y|~nTHu5RrE~mm2ee67f%Jb*a{p-#v&&hia0IYe@%!gXZF_T
z0&}f>eGLl()}i=I9G>Q3A~YiS%5tH&fIVR-y`;!gvHWR*yZlEsRiUo1u68zrtk^C(
zduWR|;r{G+d7Uf_?Id2hN`?_m;kE~S8+hQgBmW?j)faTcnECl?nON%^9KN9=eNooT
za6e{pL2wjhwdI*xX*6w_e+dm@j#e2O6Qb82nmUrJLQ1on=Qu)M+|<;1+cCJ04cs!u
z^yD@fWa`Z08e`|^5rH-wL8fT<=3#2y$!$bSegvQJi`lk#%kT57ml<HPc;}T~LL!PO
z$ebJ>9}KD70`yWzDbB?#d_{|>WilNw2394SED~pUlSQ|&COs!ae{!7SO|<D?&Psc}
z<oeL#9j+q;LCsRVN%4g)5tqa`sExI}5$lhA*EapJya!SGxp7n5Fpfc9GOWt_W04Rv
z;(xO;N^at<kFMhd-pL%rQ||>DytjMBvb6pj-c-`JKYd!FaX(wah0>c<IvIn~J-;9-
zcSEishrQHn^1+BPf19hl$yMMts9Cp-M~qT<m1ma%R<8)n#fAWG6ZVd3Fv23pgVGaN
zzTFfzv^N5p`hCj&BDY%bbL+L9f?N?_doY2j?a9f8+S`b_Xu^eKy!Ys2YdFGMV{_@3
zpiCyY+C4u#WfX1r=6vsMZ!iRF7_w};BJ$B{e3dLw_Nbt2e{m{lLZvEq2gir~-64pU
z-)&1`g}ltq?|%SMNG4o**Xy2~{qiDMkq9UCYX9YX*)0kjH7n|Fi)yRQEwe`<kb`qk
za%6s%va^%}a6eg&uDw?&{5!c&f&I+{b=cqBvgkaIuabh9ITd)5)oN(ib(dtQfyx>e
zU3f@};vkNxe+BD~$>F4l_;nJ`ML>Sn%9hIl`Vb+PAoptPw-@F6h*+QbCbzTWpE7kJ
zcL#=I68ZTu^1vH%+^8b9v7)irRH<J~eUQ7c!X?Qjs?walWO%3W`V^tVy%<<rWyB`x
zI)mb;C{+5bXfqdWU85!9z~jM(`ysd)<HHZ?C$Fqpe;g_*j-7YCixvlJ7Llz=^S<|f
zbnV>>q43&<f(njNP-)8#x<H@Ko_Vd@CREtF&j)Pl;4h|4<%KO$M>4G)zxnsx?m)ib
zhO&cea3|Qx<I5zvUBr+rJ7UYbkSv}S9F(6|n;XVzn-p$itD(f$!tCN7OqR(_%U50E
z7(c7Ff2;5*!OD(c6)Y(YYCe($6`I4`xN}o)wGH%+#y8fGuWUPd{%reu#^(w7gK>HD
z3FGEp0@FNW9DAqJiGU%@Ut2ak%DxG|ZfroocyVQzV;RvXsVR_iAA{KF+HctF`O;dl
z*K~sX$Sjya!yHNx)I~xP-~8mdPh%YD0qEDKfAX)U7{2W$q#EYoLtkQ}tjX8Sd^z6P
zVYqo4FUI`!>n8TYzM4S?3I-bnbe+-CVPcDFv7G&0v_Z|S{JwuWIPV^ai&?6*5biQ~
zQdYZTHEWoA$gp1WVEP%ih)<+c8s1g@`dU+AjzSx}(f59R1W_|sjW`$P{aL!C7L+8F
ze~xM0EUXoMrpR0o49>CAq>-u&B+fXoA_<k`7Dc)xtYbU$km9yZLN`idITiKj1az`S
z;BPcMq_%F!7@P=5WwkEDRGI3S0PPKB;-ofI@@`!hl;Jyzf#54(#_+W6#ud4;(XrIF
z$Xgcs(Leo)v`r{<EK>#1>4xogwH1L4e<d(RTLI;+Zo%s`R?V^$^;lSu>$SK6-B>HW
z+J2pv>cyw|^4!EI#PSGp7Fjd}Ig>b`6n77z)38_pFI8;n3LPJ#V1z?xJG`t${~GN?
ze~UKDitoTAk$ibMoqzf+ag_@UL@d|s<8`t~<!gdpWb^GFygfec58fRzY4_|0e{r99
zn}USZRBcjO7m^T0&vuB|Cs!P-E~oKumfQvt_PUpM=p)u@n&B!Lht@_TQ0jOG_s1{v
z5P~y0=pXgEr(|Mp`h$lX?m;?Z<g(^~*$#*q!P29kdF+hHIG-Pug323bC7iniX+&HC
z9zem~m%f8spd@3I_L55mplBM8e->H9Z+G6Dza1VNza8!$pB{DxkZcV7_0d}|o}fD(
z6g=p4e<0;#gUgJa?xQ5V;ocwUamvIP_<J=2NoP#Wn7H*Tx+Z&>ftCl<Tdza02bIO{
z0IX}-|Iq&=1E1IFJX<VdNI;fjteSL&ADIN6E?|@wi+FL@k@erDOSJ4wf5H7Op5@V9
zwu-J}Hm5wBs?Y`O9R3(>v1u(5_9ytX+;BL%Gt~HlaBF%ei|*)W(1E9&=oYf8fn6~N
zqOk57C!ALm(juA_%i4HXtsU6`KgVpO?EDR*s2&(cs6yt#gKfq9hQK>p;_woCMtC>8
zC4k)O>lH0}6b|K~I2xs0f70vc_EW^^Y1YU}G-?n3OE60zMo9}~x`r?amT9nvH4_iI
zMHo~Zic?cxn_8r+jb`!E($1i{huyzZLZ=OiBg4?6^}MAUQ4SiarDn+iO9Vx6CY_(0
z^w^QKw|B~f890zI)Y3ETWCg06?s&XN^4u8g+4&pN(%`3)o=i%re+P&6`#>`kMe;$V
z+8`P0$o_fz6LJFBg|rq|ZEh@#RJ;H5l2cr%=E64kt~jk_ct+N&lp!}cK@Fr7ffyXz
z4QC+b=+`8eOZ(nb@6iT0uw{9Prl$`wPEWE}emGa3gdO2qZXM6yje*;Cr*`7o<MYAr
zc%L2I@B6zwp)M^We~gu7A595R>?HLpzeEF}45vs^uwYR4m#nOzdfF)-a&d*<N=y_&
z^SYlLr{|>o3DKRf;0Q;<2dD+*I%v(#b#c_)-JLAnxeKeCqQ%GsKy(*4EHS&sI8_w`
zZ5kW)8l)Mh*^Z3HcnTW@7@K6deeq^<njP9VXCKXT%t(Zff2Pq+Z#Fht`Hjrl`1qT3
zvFk+<OFbEuu8Rvc8V&ReNEPqGSag0Z&>@;jr6#SWwj{+1be4>Q6V10{m(1@SyYuvY
zvd9@;66-gt`@{9ZV_=10!FJ;rc+3IGLkIHo($k*2=KY~JeBV1gW58-YM|tU4tK)X{
zCY_DB@#gktf9az4Nkm)Vw@>zDyVEh}P<AuOj64&CJuu<M`Mj`TEbLOMFVkJsXa-PX
znasfc@cZJ=fA)L^LrDm+!n^q~oqe}$YN7e~z`2<JWq$3mf1qjjF8_YvBG6}1dMlcy
z&2?!V?|W4%cw=GoW_{D)mU{8%I=WzjB9B0wwm|L#e-vZb^)89$z@8qYQ&xbzPq;fi
zUh`qJN4W50R4|K1JRGFh&<Pj0SrIO#LNPS-<S0mXoYBQ$oPSh0dKrO{&z|S|T&4*c
zg9kpn@K%+0M;c(S;CHUUu*Wqf(VQ)Ft{jvtlX=4w-ZGE@zEW8l)wR$Jw59j~`>tJC
z4TTM=e+;BSKL8%)V#x$+?U5yS1uv&BXD#Fcs_FzC$QD|D+l=PB_6>}A%~H4azpUO{
zFYbL?V4cSgD8=)$l?;#ZQAn4is|w@x*x0OhW#h7n8%MZ}<Y-Q5yzxeLF-rLT)k`DY
z_=hW{T|<DOG4*LDubWy`ci2CYc_aFV-M78rf7{b8gKGD*KlrI-N^{|z-<bgY$UFWB
zPbT-{MjHYm6pR=nX+>vhmMsomRJA!(_JuP%E5gMfdnc_+nl!kUD&SupYS=;wV?gN8
zSX{Z$TQ>ihw)jg&S-;Q?fr%4WNpy>uy+p(`8Y&IWm3PNy1I8wv^%<WTU96U<C&ZV#
zf5-27V8=pumwv7xa|D(*oI9xl6q(zq(zNCr%kK7tQUmnef>58F9-lDC{xqZ$0Ch|B
zYZNLaXM|cAh%0X@EXv!qpnI6k(&=id{Q{*Cj-h=`{lM>d_rHcOMh+3}t^wfCQkf0>
z%~9C^Au$zX_?A(M?m_?U5%_MjD^P=(f9|ro%%<2-v}5#E(u+Yj1orhA7kUMHs`1<T
zs*HvQhd9O;s7`~_0zV8--u-me-(_NwP=uhOik;@Yx1c548@@d`50WwNP^V%2hRxnb
ze0=2;;gR>soci-Zp!!U?hgwd<aqu$HwQ%btU)*{dfG_NY?bEa1WpWQgWEbVme<Z$=
zUPAz+|HTu)BGEPe^R*0LF--eP@Y8YdRFj^-im;3oBc7PnZ2sUU<oHKJUGTH&Pp|NA
zH^hgES7?(2&0JGiA4Jqk!P0chY0Db}-dxk3kaulv;H|Sd)fcB=ZQ3rrk7X$r?>R!L
z0ybiKplUUyzx;thlF7v#C&A@ae|AvzvX*u4nS4Q9G^O%0^{y!J=vS<PGpe$a6a!c*
zE>Y!8bJ5@(UM-2wZ4!4LTo&J<1Z-G3OCIWT$6yQFJrQj_2@BUYf$5L~B7OOr-mca5
zwy$w>$8%)HsG$K*Lqjxd%kS(h{6h!32N%iN9kwM(p)hYv2;Q3*qDl%ye>OoCS=g|*
zRftyBl&dthn$&HcB}*aW?=RwMVlnxb>Ybgu;jOQp=iGM+btYLnCN_9xI6qth9n$Z;
ziu0@C8I1oIIGzZ>01+C@EJV~~Ni7&DHxB?2DS0%?rt^4)DIyug{`fIT<~oR+eRl9h
z1*tI)4q3#+dx=<vB1D~Of7&D?JZeqbs*G5XLt~^Ks9CNO{G!>?*IZX0B`A|AX9spM
z?%VAj-kn;Ig(A`)2MW4T*+heU=%L8R_))~%cMsMJ>pZ35X6GaTa_JNa>!)W(UKUOe
z%RTJ;I9rfTJ;%B^J9A8M3>45>tjg-n$!#=u`JYXTYC8Sc>mLZMe`fUV2Y^1t57@tx
z;7U6pLujduF_IPhj6?Jb1?8)?KUwA1$BX{#h6&+g!**o-(aJOwMPdKoLae*{t~Uf#
z0opf2+1!R-!RT_2SW%B3BRU4Bq-mUk(_!qB?;}hruP`s`=*i}HLiEUd5H}X?Y%zM5
z<?Q^&Q2YTVHyY=qe+JoRnE)o)={4;`lZ{-rA(J$Pa3x=iN(W_>@eWGBVUMw_UO0Hh
zOb)D+nktsXAJ!Rm=kXG5<<#lFiT|7;Uy|ds(=^UM!c7EGO6B}+X~d{|zM6wkjvZw?
zV*h)4avsIpfN2R~OJz|MiiA0#5Cg~Jd_m3Fh{0Zm{StRQf16KToyvS=2W_(SD}=-E
z{e93oJ?b6^<(*h<^GcH2<Un=QB(j4Dx+yHPhRSU^gmR%)E#0P6DCrCP(1a{I{6K`|
zgLrY3pe!{}5sgI!>$<|Zi)hG=Z(n3Nylc2<*^=QE7%vSfMqwMfnx(UJDNKVq_g&I5
z`1^1ADlCAUe>9040Q`7P>={T9j{a=9SV7pJgLL+hEldhGFuwR5uOs<Raabpd48pJT
z5YDt0zE@;<`N@(=bodGgPSOzM%(~0+-EPV5xsp;7hwjnd78?uat!H<ZU;(V)IL+Z4
zx{XH3VhQR9N=%$9XRi{J(7Ha_0or$Up^H66Qmr?(f8@_F^!@q458WeeAp<Jk=OsN3
zQEnVHeL}y#0?)y*=1BK`I_e&-JJh|qSv(Dl^}XOaoXbyNelifQJ$XC)WH1zA`B3oU
zP|`S4wR|2v_Ns>h7KU&_iKj;W$5b17A-rzD;(+nPh8}y@$2PvVB7|M&9}lgxe3wkX
zpIr%$e`rs&)Hy)XS)Ps)g;8ok9JK<v2dk77!n`*6tr2b8zj$Fah=`SKq5`*cis#mw
zG?(Vj+<ejb%w$$jb3psIbQ=^!!451HSt&VO86p3QAyTr)qgirm3+VEKGlrn`!0IV<
z^EkAWEZ&z{xb^o+$&x?x8scZhkas6(EbeqGe=Kk~C)V#o81F$m3iJWH*T8cS*G)TL
zi;Y`8@hNtYUrURSL4q&yNzB;bJRm4i8lSC}zT3SrG9SijKj<96mJL-8=)R*hPgrsB
zXJe&%0$b9iQrJrpa!=tC8&v}6XAnNsfXhWtdVTDvUtktML$fk5)KL<h#xv{q@*?X!
zf0S1rf!N4Bf!!e@;9q)>;V?Qh#wm#xrI}DFPMOugQ`~eF7vHrFyNKY&w>d=iz&RV1
z<}_la+#fl~vY?s9mgzXCo7>P$K;S=*onc!v8IxSRzcuLapgAixi8VGstCkDm7>6~g
zbPv_AODE_{G<Yq?G1w#+5*&#IhUQ?if2BcT12em94q7~)G@9cKkN4S&x<lzM7V%x_
zs*RAA)gE26$!o4LN?bVN(Hb1#z*xBSvdMlKaRMwg5c|CK`d<U;HzHS?Hp^EPzW!Eo
zsKdAzq<p}B(3TIM5lNLE4<ZY2)5vsd>qTVx#<6yOPJijtovG!T;%s|6n+fqre-r*I
zMi2=n!ZyZ{aNdSD1dMBk=iTD2JxwP7gl!3=6<DfBf82bgeuzs!%Pn6wCv9DIjX9^p
zdq(&F<nH*M8UD*VMK^kzaupXnVnkka61Nz4p6M!ulpj2$B3|W#&IhwFa^Hh|nNE<W
zWh3n<2Q8;FF?(TDM*(2C?|G($e`e~EJbH0ke)MO(Rp&1gO{_IDy_LlXRWa9>8NQvV
z(~`tFwq96yXe%VU^~TsMf|*1rlEL*=<fP|wu#^>Y!SF(%D-XzQA}p;Ug9g_N3^Mmb
zv!J9P5Wj*Rf<d=LgZKmz3G-a=EmSk7GE=?gRy_elFqUt{I3l%YCqsvPfBE@Uk3aJD
zF4=DlYlI?hiP)N@<U|-GnWR6qS)s2igvq=lhROU75X8h3Rg_DU|G4l?SjRCTV5$+n
zWJ*po9lj)dR6X*LU8oUj9Cr+c9D>_6R|kCLF~MS66WEqZaBZJ{E?8-{G}b$jG_M+>
zyVo1j#Ir9>GI4)iCMCS5f8i7-B9dY}@6N{P7z>};ktx7P_g?KF&-GdF?m%gn<Z0f~
z-IwlQC|V>~J={PUUmO}M4!{Y2VI1FXMSicmh{cy?OC&>3^+m`N%9!bG{!fE&8tkEy
zKtMjtO^YNu*FBw^k7%7FaIt9uMEK;o*s4h}3M#0t2r%A4b72MRe?bp)CY$ZCGqzc{
z>)5_mT{iu@38SdA<d&wH&Sg<O3MWF2XUw+sWC^B88xG$}sGb-Ku#aFtMi0{G?P!CV
zivb2eNe%`P6vRd|F~LP*Iv?^LjA`2wkzHYVZk1+?#sVSsP!2BBEY1=<6;~`|a??mo
zNuW`4WZ}H)%jiT&e|eyNZUr33CS$Zu*ZYvjXVDWc{c^T83B+PI_sBCvgL2TF{m4*Y
z>)r1sORy4lF)?f@wHw5SuYxQ2yYyyrF7ewKpG^%4mka)zFuu;7JJ}-e&#P)=>rfLd
zW2AlxW)aV8`?drg9*Bu6NsSL|DnGtEKIjc0m7uQ<MpiQ3e{UFIvS_@VsJqEsz}LhK
zKD|oVp^8c@w-7{*wg^ew@xoJzEb#mmMjZ|xq6jNs2W;EgLh@6G-aIgovCj6_ujGi#
zzDbcSXGJVRwR|8dC5LCV_ebD96v#a2&M~7^Mtz73TtN%AnsHs1R)XEeISL^21*?{=
z^2wd84*RXbe;JAnMThZKI%2HKD(ONxcVgNZ#BbM>`q+2LgI@yK9Ej6@_w;T52(l>v
zB%JsE7JaXjh5F-OZva8icaKj`&rd)FOD|dlTlB?wAqFoCqMY|>Qy8&bqTy1=6p^0j
zu~xpUlJESsvJbVgs1gA)ItQ|4D_p>H@tw~v6e2y}e~3e%w-<Hy2ffp1|Fj2xtFVQS
z^bY?V$m4edaYME^%J4EnaIt39oG|=8BCh*|i+-d_B>!mnheEG0Gz?2>g@VLO9V+?R
zZHe0rXbiMF&c#F1JEQ2O(~yuLNmq}>b-N!ZooJ7J0;Shwwzy(VqG1ARm^kMMXT>6!
zuzEL`e?c8|X%`SWZU*Ov(D;$7dOSSf-R*TYNengB-yRzhO3<|lbpO`0MEJ>;+yVA9
zOnsm{<Fqa?&-lb{lW3gH{tuX5OeVr{3-f`@#!u0ci|uvzou^ZV$nh-UCt${Ph&kL@
zS_kUoBAZ4~IGs;G6$<%mbZn=4a#>=Z(K3#wf1Kw2P5&^3;L4w<+7@-ZpuYSLbzP*s
z?ay!f^N+Saxua)zdvf%qyEEXHG5oQA^xbx;mJe;)FeD*&1@S~fGdQx7{iET{M-_>O
z)C3okdGJ#^;;PK(dH|j{%acV0Sx4n-wn0T;V1{bRr%^Irx_fnQ#12*}PW~1IJ28ba
ze+jBxI8J+j{<UmJdNg*3QvXUgxt@y*ID+}mtW+T;g|c2WrL8S7oTceNgxS_Vqvz3Y
z(%=I2EoQM-78ufa_MbX&hyDmzeSIISD<Gpqc>7PDdGfErWy>b3N5@A!G9KGrnba%}
zp-l!O#Cc;B=oW=<v;~k4RHStD>nq*)fBr!iM2C|Th@1gK__4Pq6GfP-@-KT?>e!=@
zvr!7!O8j;&`a0@P58Tl~@eQ&<b~{TjBRCLuXa(;H?R&?jSWZ0qv{KERfefYvSI$U9
zh#)5^q(f;o`C*~#RIm=;K%DmTzrAO^;ocH3+w?>!pyn+_cJJy9FRS(pAb`gre?`W{
z@}aGJ!gI}utEQCggtq}w1X)<^)##N5$P2P%+522&jP#kjSa5kkQC_0DS1jyXmiOWk
zTD*h<Sw>f7ANiTe-f74_icawM8@yN8=R|TB=p|v&HeqdoQRTWQAr3dWTA9b_<0i~_
z@7{TAsQ3fh^8~^SpA8_S9owl?e+lLxEOap(+>n5^5WXYcu)4U?;bIiwUs04V*<l_h
z438z4z6_V&N({mL+r%5fqy82W9Jkhv2Da`4?5{FIh4Ov2*W2swLKr*WUVC=`J+>~U
zc^00b5vs1e3g=LbQuDY#HD!o#E$!ZlibIz9%0mL))hMi#TA{n0|2^ahf1chfUo8@~
z)Y{a=XtV@DfLS#!D4biU-@>G)nu!=#fB?&2j8HA6Ax#IjoxQdp6Q7dlwo0dTmMn3s
zLD7awKBMb+0qO!))I*;f4k`NeS6&$KRd7%e2nsyJT!JFItma-RDpm|*Y@>|E-QplT
zM>P|}NDhSoM8>>uVR9=1e<D;;#)rJZTrla69^R)CxkvV=NMi!{T~=9vnsC;Sj4Qq1
ziN5vPRb=Z{wDobYx?zLjPg`2TC$vq^JLnIy1?Ozh+`6<h^lp7_m2fZ*Ghm_SDi1Gc
zOvHAIv}a;{*RK4~k`4ncqhC`YOmJKd;>&F#GzO+!mbC5W2<8}ee|xb_8x*Sn6~gL8
zxIIN0oi=@Wj;b0o7c?R6W(jxZgO}3QeGyRkkkXf1sszlfwcz}0Ezmxr&=efF50IJ#
z`@+Dq`d$k(71+$rgO`FI^#N4eJA83q(t$lRI4RTpP@q&Eqb>xsm(@c;(R1_yztqo9
zAR|z|gv>o)o)R*#e-VNtLR=YB6|D%JhiQjHc{tr(*nUj9S|U5xB2}J5gckZtag=?H
zJ0Fse!n739wQX0N3aCV;)-0DBX#!>@Db<!ED9G#-0o4}U#n^hI{#*S)+Zj>n?kFpr
zN>IkoxQSDB8RJ5kD8Tc6#Uiec!G0M%`?SAri*-+)P!3Jwe|!~dG$M5f&G$0P*q^hz
zXqirv+`8B^ZO+OTN?6FPxl}#?ymqZAx3<=wJq{38nn+bOjqPmVo^GB(%XP1%dQ~84
z8UGK5)3yr6FTqzo+w}St>=v`21+jY(YV&NPrpfghHQRCbv`sfH^LLH-2J#oqn{R?W
zPrRgh#K0XIf6wtME?^J4C&T@2|3K=2^-#YmoBcv=@$*^o8{wScscXT%hPqN<=?kkJ
zV(b0fhgD_f^F^ev(2o8-)Nk!$!c$LP4L_>PM%SStg)SAf*YKfi;*IL?RM;#<Lk>Ig
z!GG(W%Dzx;RnF&1Igd?j#e5tXx+;N4a|P)*3?a@<fA0%eD+l9z4VYCNbq{-IKYOmT
zevt_7Nm-o!x2K;YO!C;|w`!qLJVsq#L1kMl*g*qm?l0em09tn#Gf{c8E%5KZd_P=v
z=zdi8Ekzej?&x?#Q>f?9ku1vD-*&SZ<26>InW2bvO^0FE=*`AvTffo4`>zm+1`aix
zA=482e-cBYYIO@UN3lRH%YsbinwDYlYMB*SauI{W0x}b*{Njt~kX-9KBRo(IBenTj
z>drzg*O^8I>R;Uyub7c}U;{mvMtvn3=MVRp^l*L(_6LLE$!YJ5q~5D*_ZOu00dj9I
zPYGkfNkXaJK$uumF**oDLeb^*jcl`A3|BX#f2C7XWXV35d0Z_)yQ<xcniP)DT-~=i
zsvgU3GhmBp8f<cN&iB3D0bmd{*d$?u(O#4Mevk-Hg@!$Nw=;KwSo1<6w%IhD;Rh0b
zRDOv+*<UJzbs|=E$*1`w9SN&JPY@|9W|S{Rt7%>iDL~~4cTGD%X@g`07Un(x@EHtX
ze>HF^;Zw27$W;mXI~e=S0=z2ci5c#$fNqsSziF%m36u7TmZ85?nLwW8K;$i1t7k7z
z(^)cAwksElguv2s=4;lJi$~|@S+b^oB}o)GXBnHmrB$<s(PG}Sv*koB?Mts=>g!5G
zqovx0j<6<1wu?k8I%8Y^%i7nHib0rFe;Pti4z!b_e}@rFkWyt{>gV(q2yMjeawzr^
zI!26VXo)s$B%~uWrocH9iH&)13eVV}dBSFjsxP7^Pf~|coBol!2ks){+a+zE7+T;o
zX?6yW?L5h6t^e!yN0bMZ0gmo?Z06I`zc!+DmaUdNbDk&c&S?^lm7fS_Oz6^BfBqqy
zeM3Ve0p$w?RS(AKHBm$q%S($ywmjtbOVSuDk^W?_m2v{{7;^J(b7}XgFiW@gi-xyz
z?bb5Cz3X+~|74b+foe!;`O&ZlFxQ1FgopF67t~FH*nICxjreVWf8Pc6tdoDCWdJ5)
zp;hR#d#@ZJ8ETah-u8=v?seoLe>RZ>CC}b0zL?;h2i4M8fh}Z=ZniYseDqb74D1!N
zyBo71F7l4IJ2#gz!cX}e>g@nkiaFrg%3ptttanu+Oxlf_E5qOdIm`2oX1wyB9k%S3
z&YUMUzvDpMaNvr%Tl=Ns_G%Ij!E-cSmQ;JB6gjcf%z{#Ad#}yzi&6*}e|=fGN2I9-
zsZO(5na4IgEx8tkn9F0_;_ly@db&ZDk1EBBH;GNUa&C%`Gh&UM&tFndzi#R{=h-D9
ztHx%5-|*LA_bsFp>K>f;C=oJd6Y7CXZ;ft5oCHIJRU`=&arJ1DIwADR@q>Z<eraO`
zoDTYXn1g~Pm*{S0jiJloe=6QRNr~j+%kiTc^X4Lv55-#PGfa~Y%cq1(bms{VF}#tF
z9i53p-zbgT@$@O0f5RZz|G|IwPR!gB;uIbpONT7t)|NSB47W%@@Ut%a3)N*LQ?N}k
zGK9dzo<vnj2_R0qg&8K676ifbl0=OoUkzCdlfIU5^2#(cb9P)Xf3|~78IZrJd+l6`
zBgAiDaDKuL+hKQa?-Wc7@cep&9z^cEFI8UV7hb;1$l0#EiwrVgopXcioh<4GV5KaX
zOdO9*i$7m6DVFNOEP<G2px@Bd+In<4#tS@pb^t$Jp|iqdI4?=poeTV@75&X9$lpd=
zkzKhJ?PxPwd+kQ?e{5e!?1M}j47`dSy^C{KwPCUsm6!Rb_a2s+zwhyNex*Fc%;9kC
zJxXo`FRi<~e}6W2WXKI%BsVleMsc!4uenzn@Mw?x5EM(RkTPE`*y}4;-O95#8=SI#
z-h!RQ*$>)988=%Li`@p9Z7|)L%you|6(<-gTst3OsvP)|f6my*XIEA{3LP}s+RGsh
z^-(o$lrymgOd03<++j~@+#g6N^x_4Z^df<9&^ySBCb@N=j7tPTFyQKA!NXom<4@^y
zH5Jj>umtb{Xeq_t-5_<=5WzA}+|XCAy?V;BnH`@GhR6G6AOm}9&pXi>TfNbBlzal=
z&9Gw2JJDc)f648{yF?Fl9eKe$g3r-9i~)BN=SzwovYSV?C>OM$C=!(+5v(mPcVHJ4
zSs|-Rb{Ui5mM81}BAaq;nadZcrks>KZD)%bZ**of^Wao_ylv&aquokAC}05O!caoM
zjw0WD3}1NaWrp?`d_^x<^rwG&9G#r@SKn>7$yD)Zf9j776@q;FGd4%eOf{L@on?!q
z)MC0t3oO;(aaln4ug5?Hx0fW0f}|9Y!T!;3&_5LPoM9@w5V6-VJs@6I25`~fS0H8f
z`!r84z_Hw!-h+wF6?6}h-!XBdX$-LpJ&dWDCZc|3%xM8<U2Xz;*87ihMvD90gW->i
zf+*!le`&?j?$O>cr#HR{!y~f0(Py76>MWaWfgupcwMKUOXoQhE5ZgtPw^&5<7bcFE
z=^|ftysg%0Q3@i(tzxvL+nDYB>-YvJHX2v*w%QPE=@!!6<jFh+bSDE~=W=k4PA}IC
zzb;ph4|9@EQ#={afEUesz?|0}JRfu$1SNKyf8ZFdlgS*+KPT*9Og|=!gfQe?>}4Z&
zQX-QbeMmwlVawI$g0uSdGTH_~S^jQ0O}Ge*>;Dv1<~Cl8*<NM?f@~7<SYS*ozy6c+
zLmnreGFY)gKZ>WwSg`2>ix%bcc$B!45u;Z(F@-8&=a$LU3s;*KJhhKOzt-4kw!*nc
ze;<QPU}0`{2wv{y31N6PJqlSQ(ua|(rp5>4wAp`~E;)K-_TBQsvKXE?`Pv7*{rpZ0
zfD5@&hM*o~5IPkZ2E|{l%QV<e4JN{VN|*}!`7QX>|HXZ4zA=9pX7=#7F#qfX>vIt+
zKl*$IB2|Y#t-qgt=Y3pb{}!AOUwXf;f3Z(1?$7G`%yepzwtf}){{WZI8hOJ+$U3_c
zwF8wlWpG0}8&H3BGhKSbyNBI+RkvN~mirxdR>fTvAZ1^2H`Uxp6?Reae$i^8ZKVm~
zkVij0OP%NFQ$6|~m0vo_=F60wQCcl#wTQsA@>(j*7viU@5YzLc2{qN{v+MMde*_JK
z$5Q7X^?nqlq2PKoJbTyQhtN-dXO+GaN>Mr6M;>dukZy`iTw;9m{OMoY>_6Ybf3_hB
zI0|`!N|-dj7qB<})DxIQfq`k>h34~&7^cX_G*BUSVW9~V12O-U0^{Rs$KuFbD`V*x
zGWqwQukLIAj5jvCJxNvhX0%;(fB#xo<!RNwx1Kz4Fsp2L!Q=3H;gNanJKZ+vj#Yn(
zV?z#5vvOo(8RWQWK;h*pdP7uj?GXLV7z;HRqz$&C4Pz*9M^r&a4UgV9DM^yZNe0>+
z{SC<y+evCq{S}J&h=Ze7uDpH4%`d>}C3o#}sY-Y&eGR+ll?dl(SNI+Fe*`=aiFNe(
z3>YY%-)SqC@Fq2`Kpei#fQZG~IYxtSpeJ!fD^ZJ_j__2!8u`Oti|h)c5yig{<}P|1
z0i0fm7k^<CO2SicdTnF3eW9xoc&cd~2=zraR!@@CUpAjChl_)|XuQHq1<u_i#-$X?
z>M9<p-&wlTFqqV84Ta2&f6;cQB;N(GQ1xsxzOF#1z`Ea!o{G9qZa2~UG)j^&Dnl`a
z^#4Q~6KAH5naS%{uAPZ}JAF3F=3F|^g298><<T~Ri|NUT!Kqlwk_D>RN4i_gV!~|O
z>u@$M({m)0w8Q<vNp|?g+aZeRNWYt{CSyq6F^%V9?+bGdw%c#Se_+{1Hd^?(N{ome
z)>&o@sd9V-2^t>$!JPhce`n+Z;yNCqi8(g%21D|r<=?9a%#PF-N>ROs9?}RKrub6^
zsr0m<@-PP+f~uL|8^wLc&^{&>M-pxA`&UHM;3En?h%wHKlQG9;LRc@ob{vW*%Pw}$
zMKS`HO|;vHV!&a}f4+|seeY;8<zBFRlF56dYkqIamRj`3H3`v=GV{zW<fCB-i%H;@
zw^<vK({N8Lk#}ciY2aW$%@FP|{?w#!7#_)lTNz8?oEZFtd#<0dMY~B{_YIEn7AW9c
z-+_70vRgh|h`vOC5^X`^`x{6L*@?Q*waQ0{c0PDI%JqS4e-xNch*tzo950a>7?#(a
zhC2qm_~R652E&0&;y{~$408eDsNz|+yk;n2j_fjJ&0`k;WxQH87KU}u#OrTZF{HQg
z1kRw<f_t8HG|*Aei!>*&h6M{&g|D6;#QD<MAU>laL~T{N9KEZei)zwE88x1HHXr)N
z<drrGc+CK3e*liGcz$yn4IEN6Ih6`0mr<a^=h7aru6ld{7Jcet$ENTtn;+TJnOs24
z5OXvYv}R9e93n;!(+Q_4bBG_(j<VG<PsbPpZ3-NSY>&%6z~9W11^Z_j&qfL32jX0k
zMokvg%9q65_e&|fu0b75CA86pPZ4dGSl83lY{ztVe>Ec<8yvc;;xwGIjJhh`mr!}F
z=hv%RkzO<Wh2g6kl8gP3xL*6!)*-rMsSP}?u`-BONURYjM-h{2I1X3yVXSZmY}(!V
z?vjAhoR^VZJ`XVq*-D#?#v41%4>Bv9NC;#>8c2e8Jem$kF(}k(_=aHH$yT&v_S~Di
zSzUm^e^$=A;`Xwf#_+oX2-B{QNE_LoOAl~o(b5p)jWtWzvHaYJ=&LCP_Rt(*(XOC{
z%T78ch`t<z&rQB)`Ss#cWC*Q1F7}-sCJ85Zc8sCf<QWg~qj;PW@g|vpDo6G7^Dlud
zck#R(%D%PTind-O`yE&mvE?tGmo3Fh)>ugyf3ibb)%=Dm6<!fVDa->_m^#dLEaKL!
z$dBTmM(hx!1eCR_cpEuh5)a~pq(``}`w{K`lzSLNqt#*||JM4Mprph><}{;~uBI!X
z#|6-wn11hf`!gX3&juNB$njz~n@-cEJ4#Zut<=IqAxw}U3hIAdt*;$QqC`6w4!98*
ze|B*7Hu#9;l-AiczsLTlwGpP$sI$rjfLx5dJ=+l7+*V@5JX%!Mjm6IN;a+zD9=<0(
z$<SRz-MDt^v>S!6U)V|=`=xp#1ig>HruGD=^U)?G#6icOIMA<jJaqMHpEte>{<BH2
z%TaC@32Jioj?u3esy|c(g45WP7WLS4f5}JFc*n%`P*P3ZEv2x!uTHErg@rWOsKl?u
z*m@sjOL<4e_WNkLiYJcynTV*VUC?IQSM3oIhb?)#jLZu}dZD<XY9T{}ho7;dHKy2b
zmC3(MBy5tDUoATVr*VVjX^&(@GUQLInSerroq-Rf&2UzfKuAmM{i8n65wIQ5f26~4
zTQ>)?pH3!ZloSSSn+Waq4-SSW-2sF^6clOCI3w#vdI%5`yo;%NePJ)0af1<poW#WS
zFD`EJzQ}iLQ51WsBperKkj<ETQpj%$vmDHHPi+yD0>g}#2KU@Df&%-Cv41$2!Rh%f
zx~pQyP~q{VoR9lQ`^S-B6II>Le_Z5q^u}qk3tM6Gu$qO^b`?#BgvE%OG|4pf=6ru2
z&S}nZ2{u@sX1$w)Ela*+)G?lbzM3x=_#4kNxE@MD8izxC8K<)-7NHEeQ7r?DX#D)F
z`xY#3x_eGfcrb6VLEpxAd6XbVqd(InTe#IisF>|VK#l<B2;piqk5FSpe;|+K8LrC^
z+8`{v=XUak>jjSs$Pq}e;r6aG$07XeXz(G`xeJ1!3Z0A7oyI3Kh6B6T45}xq{F+I5
zvt@HbEp0p6Fnd#b#0;A1UtG2J$}zDIN{*ilP|Hw+6z_X~AE>aB<*=5`n%e+^y_SHx
z_i1U4p&*T^j+qEryl0(Df1aC1y?ps9dfvID>QXZPj{G6)R{4*5>p<HJtbz^ZP+Vxm
zLoS!`i0z+`y-)LOv2^JVU@U85mOvcecyT8;Nm2R4{#LMny}zFvpANiKjP4e1lbvg1
zrO-dt;T_+?#T+|zX7Pkqd#4H`DhJIY08`4l(<v(dS!)fwEe96Ue_k^~IuurNj8;c>
zUS+|inJ2Re9l2yY+_p%MW(<@yOaLMb9|Q8dV(;}e$q^)ZF^8J3Mu0@zp;W}#>8J|3
z+Nhjb9Ayi*q%4q}E!#F3``F|#d{tXMu}bnUz~gJC-e`=zwL|>!*Fol*!PH{%J%=Z4
zi3Boz@`QfqnqhePe@lNr*_N3HHSf$BX7UR`<2sqAyEP1k3$B?qt)i}hz?RJY;aF!;
zcFG%(&oavJ#Wj`p5|9$uAC^&+dC3c)vfFn#QO{yBwJasqH(3ziST0t?l-6^<Bh169
zCZjOmh`A_aY(|jp!^tS_A2bu|>*NYtUN^#H`eM?CZX`6Ye`@AyXd0Ig?j5F^u)))l
zIe7KWNYcRId750J>5D&CgU*6sjEB@S4ST}3C(b(JlDTs-hy7c_|II#T{Ne7yat?$o
z&?2IFD^^c<tQ&{tet|(h*Y)P-j?n6tu<d0C+`)f=Xv|jd{XkrOGx+{qZ~wIW_K+>G
zP>&uT4H&y)f5ze8OD-4j72dG&(04Pom`lh>Q1G!rgnklO*Jy)>uuFj<!*V-3nA8cQ
znQ!iv3B<Go={Wv`zfO_`eBsek|7K?FVpV-*X?S?}tr;ENHhE|DaNa)}Fw_NKG~K*g
zTt`?3+W{FLowq-~oEdNZWtG;9*YSSSQ_(g*Mv(r3e>m;5D)Qm92}w?j;8J|LG<=zj
zKp<q3D|8aV43&^L5nwe6SQ@cKIi2(5FJodGYk`zupEp#?DxW+5Myt)qd)UGoPD=%y
zpdQmQHE1GJ&?>HFU1ifV!4n(FJ9%q0HD4=EuVUD^VLV(=m;~GSs;dQE7u`V@+BBFa
z*`^4+f5x?9v}bkzyViT6u!BGTuHd<;zJ5*>@8ZcP;QpX9A*r3?q(geP!)@3wbd^r#
z;gc-H3YKiNH{FBo(JsH!d*N#aLVzb)FdN2;MSN$Zroj?#;t3eOjoY3@r9K5#>gAdv
z-1#a;2y*_>S^s^{93nNA7dtSJGNgr34g*+Ue}AT+H<{(>O;R#dZ$@lx##eNB|EuWq
zHWMY;M5T~=S0S7rZk3V3KLojfr+~nadFr{6*vK|gI03vvw8SiSzdeX^P&T3h8!dLA
z!+@oDhc@FtF&W>SaiT-k`SPW)H8)?o6Dz@C3w!HKDzI%IY*uO;KFqY7<Z6hc{se2p
ze@>3df#E%^zaY1a)^TnH_y%y`jP_Lgwf2?|I)6Eo0GJmj$u0JLpEV2H3i*k7$ERJw
z1W#m=Vt975>72D?!J@h8wAGI28Yt(53VkvO!Rqvsd)WMlF?hKi&DUW;+YBMT6r~i2
zGA*K5ht~?Cg59W%3*PS)kfC_!6|llTe-GJY7-#IR+EH2%)vl7;IXnd0$|vKZTk&lC
z$mq_bsBb{Wd(Jb!H%mIyfj^|^lLN#@oEl3Ee=W$kR0|Qsxu*?J?r2qNj?M6kb!>2q
z!4LHWw5Fwhw0nGba?l&}UU&zsnli<$a^r=n#Jo2f*Cyrk*3=7`=x@#p$Zn5ze<H!a
z@Yb9p?zVrsokeb63{`koyyn_Hy{(Im<CbcYqoLhcyR^60Q95O_1Er_%95B0oh#t5_
zR;YPb2NtWpY)lCgacAZHIpZAM0N8Sz01P*m*<g0Xg#aYsmirDabXE(vRa0-MD%48Q
zpdDx;Z9fT*nh)oZiOq@_vWGJ_f0d>cI1v*L@Q~gjC+slc|AXouGe}*fUI4(Id@<6x
zHcMH<t<qY-!I(6cG#-u!;*n1199%I1#t6Zxg%z<ouOQQXc+41Vh-NJn#V0@Q1mFUT
z{#PC;SmkQ-0O#yBp4;}DQk1eXGD7Wfz8p-8Ly4#k70ve#5FWY_eZ9Jef0+M%fywWO
zvA$mLBZ0U;b=$;i*IBkaVI-AjQZg?h<%7h*qCOkKG;7BoLUs57tl#0Syn02aQa6&N
zF$EGy!}suB;iQe8yi!O~P~Oi|z*81=5+0bS9-e<<6oBMj{-0`eZDXB(a}<HbPbXRi
z6D`rr`I`HB|DQa{ZfE$Ve+E0PFWPQA($q~A5z20!68sy#NaI08o8EhOCq?^^XJ$y7
z3XdEP57<y)|9^4dS;u1~_*sZT`6!#el#kc*6#K78srzq_j!%0bTFuTt#zA6!$j${^
zkpXuwj<$lN%(rw~TeKN%M#CHP9e5=RYwPd)bax%1TZP~vvE`SOe?gLKah7GLji1^E
zNUfjDRwc1DMKC$KA`)p$)}WAtPtgIi913}FEZ*y#4Ni}PEXNl|<Nu8`KDfmmhQJ%m
z|1qh10Sq@^k)_x&+PCQ)m9ECQ4vP6ZgM<#{fA6txEi2<-4Y+JZO#^kdLa6f<auoG$
zCJZTEqxNfK8X*B)e`p*uFwvwcxIbuBN~6a%Uy$?YTTeoYL(*X@+$^3TswH#910e7v
zVXJd*MN{ta;aIoD6|^4UM}YRHtC{i>VC+qr<TP(wbbFo5(7szo%z+qA@lBjg;E*@k
zG;hE*5UjBK*SIPxP-*atV35=f!)O5LIUm7hjUjw12k#Y#e>F}oFDqkI;Rs&8!p5p{
zY2G%rcpH9xt!VDg!kYF_M>f^)x4jiTx9PL8l&*SBQGNc73eKM@&U*nMYL@BQr2>C6
zN#cdFCdRax7!(o4m5Y*ZC)q_j@pE~ok|^Z@%{EMO;U^@)dfs037hk;ss#k$H$`(~Y
z^ay$e9zGIgf6%j$EJFzZG*4L+k4D*IjM>OC%Z3S!{Vb_L1uS&#W5!v4qTQdaRuRmq
z(b{ku@St1?fpX?{Fj@PN@MSOqr$>gE3!Q#M0DTe9uKfG!-m+=&G~jtilCO1r1sTmW
z1yrhOB>YD6J3Ghn<Ic`5+vT&>eC;e^RV{)l4PUhAf4lcyo9is>%yHt-&Nl&`k<t6<
zuy3G+xJXJ3$DI2nAk!98<N!+XqMB$wihHTn6FfRNl~&+$l*e0a=Vcf;Po8+e;|pvR
znsz<*<$e>FeWuZq=s8<JU*FaGtJkOO*Uu>VY!S+yx=XmV<?FlZI>{%<y%atEuB&$(
z&Rkc&f0RCG{MSXkr{Ef;`T*{qeh(hRp<5CZ$M;kbW#v;*=V?nz^c==Wax=!vd~Q|n
z!yG=J{lIYpbq3FmkfOqWqJ*y_*F8DH1gtK3@lNu|lOp<ZkK0Ki1<AxV)FDATalctj
zK0>PCXq-UyCC(vnRuPL-!BY2*n3#^3u5AS1e>@yjtgqrVQhI|@6-9#a1$7}&Q>6!T
z*d8iijAw4B4Y8^+$V-&c&@NScGb)G}``xpFX>F_{>UoAZ+-K~vKtTb8`&n!k_a@D-
zn-UT!znvk*=#?i5(G2QLbTyf*H_?C<cX4-0Ixwdyx_0!L0bS<3p;_*0LCoC1BNuER
ze+tV3{bp6r`wzR2Mr1sCM#Mv4wAEoE)i|5cRQx3|-qZ6`w5&BN@T=oq!az7aBM4z@
zO4a%Lz4BD#<7!zg=laGV(35jLpvtPSY!w>l%Cb%?ONg*oVFY$mMyDYe;^!IhYAkHE
zAhU+m=&!Fzqcy&$+NT+cZ=FsbIJDvme<S#W#=x?TgC}sZ0A0W;FF78#CpMPPt<Ybf
zPm?<Wf}B9nXtc_g*)$qq{Dm|IxMFV5TtnG($mM~COn=^h&n|(uA}?enJ3GDESS#H6
zSF>zEm21%ZZ918-0YOp=NWG}jbB?n49T}qc=KBesGfxjfe5ZXe!BP6f5%4&Be-L7Z
zNvwQr&xV6zVMAhaU;b(Fb~J5uM6Cj7a8l~jvInPh!v3aUsudXu<*ii#YeH~-#f!a=
zOWBJTlRG&yylR29yJQ`V)tUjo!zyMTo8EOzhfF7dQP3LRWhN(Iv#{@1!M=@E42<Id
zkU($0l`{?u|EF?KF;HNp**Un=FRvN*cYmEt#*ZGmhq0Dx15sGYSJ&h15MmVrfxx-Q
z@lSaG2ToeaF&p<OVs9g7?mfHVH1Z#&2aE)9&n=o|gI9Xwk1<6`Sj|G@B4S@F&Sx7v
z3YY}eAZ11*<Du9LJpfI|X34D%EoEF8T-*UyMi<QE{9Jmzy(JMvQAC6UA0~AgiGN@;
zdU%rcH;;*GJc&1Y5OTI&^0!km6kkn70e5_a(p2#HYQknStKQ4wkVu7u7G@X-v;qqy
zBZj^(mQz%RD@{B^3$hoyGWo^=uU_4=jLg1pBDB*%Osj`ymya=&cKEX=c(8nsWEE6h
z8WDbt<#Bkcv%x9*=j~6!!~W6mcz=KYtcPN#TYY0;M1J>!(1nXZhr~)Q+@Q&j*nqES
zef3VKFnYW1S<tZUz6Ysq_;Zy-a>`!n5bnMQ2u_7o{A(+p4RbF!mQF=!QRNfXeaRbf
zZLDc@SD@0u=)(?cWbVphRlk>Z(Wi!L?0!sui0ya`3C@H)1Xl~;y{l3ZC4aMV+j9zT
zL_*W$<r|EEcrV0F?n`J3RG;{>T8yf(&R!-q3ANr>EG=R>_NOoNk<xJ)86_K2#-h~u
zMPx@V3Xj7yaa^+1#s%BUzpcjMt@O-8`o`<+D0e5hJ7`?6d;Gg*T(V;dcZx^1{9qfS
zNK;vi?(*UUlOJ6q%iAPT+J9(S;4NILEV9+rwZZ<SvuG0MOKIi+*#(z82>4~Xglm{7
zD}w3ScsiwQmJkg$xs9;4iN49j6icr|w-sAkKDWs*UvKZmwB=*+)c_xY(TAs;*(arH
zF#Il>KM3P5*8E|Zf4P<JD*(Xba^CPfkRad!v#LN49$F>A0G=S(sDCCPz~dn<UO@q#
zfUp3Md#lQoYi!}s{4&i}x!mutNzlwGpU0!bS#tNRe%6lCw!%nxVdo*G^`p41O(E5N
zK$Ux^Ha84gp%Ee>po~7UNiCuTqwN#DpG6Yke=`S;@iGFvE)YoM!o``%+Jz9|*-~bL
zPj(=IB{Ys^d?_R+nSWiWB(kiJX*x@%M80b#pGK3_Sj&50gQ{AGq_If#SvRmqNfg6|
z&z6j#LF>S)c%G{x0m*qYhorMAD{MPTK6Rp)%^LEK=e%b_?>Uod7YpwSjr0T|Hi8hz
z1(CtF>W3^cq6`Cq@?``8mNeaoZ&1%Z;(igYFh1m8zBg@txPKMudsU04$W>QLq&Ybk
z!<-qpz(ZmcYX-pJBQ)f7T-bO5+~6rYV(>1<8nomTqo>jKi_d?`h7@exWA+8DSx@h#
zDpGL34$`pj1S<G;et$c^zn$OfpWg<#f_i1tN<I&H@S6%ky8j^^gtPyheP@<1FS7}N
z`f$ibi!7V+dw(4`>1Osx%V`_;4!vb3JwH&xBfN)#Rf5q1yA5|Zw;n<d3y&)-E5u<V
z(V&<>V#1FMVUn50<WdgWS{dltIlin5DEW96woY}^MB!!lj9jz6VhpM(N^7dMDJ0iW
zZ+oZlFq+hW+S_TWSVekIHMo2N>Tvmlm8cJ{9xv}wc7MCBx?Db`YIFINsL$n7XYrjn
zCF*qf6sy&pR*P{*J`bU0mruE^{Q7El`P^UqE}v30ynOC&)?E}{!pnTSgxeL|rQCUx
z;hN{sJXx?4bqc|sSK6<S3sWG@3Lj5tQ;i1uN_w+}DBt<`NJ{EZNiTL-+#}N7eGLjt
z+h5YoLw~4s!7j5@t^0@4N)Q8!Kf1{JO$rsyH!1X+6bjG(94YjhxCoEe3#zW1a}OD(
zf_zhzy)BSyD)6NbAkP%YGGW`B2bW=rMW*}6E|uh#3NlMwd8Ll5QZA>|kWn5=J}H(>
z?kAT#j7(BV9=Wf?@p*3jw5L%WcQZ!)_tB7npMO_`&295jV4lra6Od!T{6RRPF4C#^
zinU_KI<pf=Rs&W%XMFlhNk{wAJApNz&Pv4+L9e3(kC|+>jIMOL8aOR4C+TRJL+_B_
zJ04x9jQ2;2b#}IXl-{spONX+XTCwQsc!^=9b#D4djEX8(eZ`R~<Xs;&k7xoIv05Zn
z(0|3YNO<nN##Qo0Xq2oXl_ISm%*6e$Ane6nHcK#Zl!%0_`QT)1gP!zX*6co;yK-pf
z%ezy*;(&u|jhc+s?O4K>6#5q`BnpV0tU^2b#|rW}azy}}C9(~im4dA?6)xQ)9w9_E
zs8N{1-;PjZ#9A^bsdw3;D)C87B3IW%lz)>k3nU~;Oq<7=6q8+W%PNK;s)nFQ`2JPd
z^ktli=x-qzdM66EK++83ZgwPK824e=unNW)w5?i;t1lF#>1aNaIPG-txkYN)Ve6Z$
z`qj&-L6H;oLaEg0y?}#rRS*NEDP_ZA(;nY>#VK<$J@Scw74cXwsbpXH*})<rgnu)4
z8N=Yp|K=l;6(rk&_=&sm3^kSVcu@e=#1>B&Bx6i$C#)IcxfaUHkB$cEuN%zIT|rxy
zi50o#l4vN4+mM}loZn1iBdWSAVBHH@_QLoowHCrZ8GhtRwXr<sb3<p6x20y9AN^o-
z#uoyagAg{=I)%--R>}=hf#>sATz{Kcqt6;F3#<!oE_WB&Lpj&y4If~jqP@>BQpJlt
zz$jT;l?J%ZA@tzD^TlDVOr~+8!k)Z}#*71PD|IGpLn(TS?aS5pZ4@{qos}}K+Tn01
z6i*X$6t2NU7smrJr)lI$t%4^McDB3%#7=T#gG>P{Z^9CuoxdSEzrjx@y?<f<u=^Im
z+Yi_u2a+VWD=tCX5=||U)D%U7ryUI0Y^Pcx<y!dWqXNMbe(go&Yv|1GktwOe^{xS#
zho7!j?t{nc$>VMzF7b+0$>pKO_6jnXd^&j$OYTeQy^0O9NLb0irzHP!!ai64fNinQ
zHpSrG>GAp7cQ2$KOE?YH+<%o~Huv3>Z_fAkd#AtOZZztB?#;+y_T~2CA7bZ;9cFJl
zknC{$53=_hw&3gBR35Ed-3_&W+Uxy(+vzi7+!x$U^cRGf0rMQrZ2^{!?~9bq-nj>p
zB-+xvEC|*79V8jx+JbR(kxa5%xW`yt$4enatI_7sG=>m5s~qJysej9jM%g&&M1yPA
z4h{p_11BVL?*Y39imzs}mt?k@MmO<fl|;Ak0)l%+&E4;x{bjq=@z1a!aVG%9>OrXu
zRd!d>kLWgAd=xA)T(BrTg3utqB%)<{b-iR|**K)=s~THh6-whp)3BYknzuAT^nEo8
z0av~C6gX>QJY1v{8h_eh8jZqx!hlCt=yuR@O+(8>6_k=M4T9B5dqDD}*k7bEqB2o;
zKT$iyXEY+w8pvQ6#yy0`G@0&`pmCd%^F~9$uB44gbElRIEW5U0&El!3LFv>aRRkJ)
z7oh2RyXB6o6+I=O39a?hR~ix(FSh*$_cV559!e|PfwEjExqtGu4sfgj<JoYJa(rtY
z==`O5T8sP8y421_ZcB9miq!j=d4d-9o1y17L(gxQXVF7lp6OU3!afFLwPxT&mS?NQ
zC_&5eZ05N>d&G87KldA?><Z%+y;5k2MTuLL`-g$HdN;h(m&R4RQ`3LBXG=Q%L${K}
zDLk&FM*zy}!hfoY^3pRl$8g5QI}l|bdRSb2;~9^w*YXd?sb-1grLiSSm{vHZ|CG$e
zY}O2~hQ5&4yT?a^-ronq{qv(;cyZQf{3*R;BH<-3e{y_$Fr=Ru@F0af9PjE+GhQ@i
zI48N($+;?Oa6?+it+gS@F#IhJe#?iRfpI}{;c-y!M1LZFK4%ZKb*J4e;s#hw0syX0
zV%Uc;0xjLB?mJUFjbWGa)Uv)Z7jhijK>2U}Z#$lWdz+gIafT=S_Lhi0`ARfN5i}m%
zh}3Ec3tt{USD>iaKyOdG?6B^h_6I*<rYbp$=WNItbUYn`cYicn6~KbPPCm`qMoM*_
zN?$!55P#YoyN=O**gg9J+jGxh($0L5!pA#3IB4;(`}d|bt3$QMhv`hm?ha!CBaP;I
z=|fjl_rqk)`;sBffa?(jr^EiZ`Aq#dil<3aSsO<G<ngKHCi|D(WhyQ#HC$xW;s(CU
zOl8mr4;l?U+F#62AMZaBu}7G6=9^J0gB}~3tbb!C^Dw0*SzUz&nZ_tOEEnvE<>?&Q
zF66Uq83M1I=^0}U0Tg^}qw9FF8O^b{!JGe%gI2m49G082O&{mH3S^R*#+=&mHg~i6
zooaV3n$=`o9SXjdjO2sAxuo48)g~nuXV>wmP0kg31WhNun~H3!mzs97)zLp%(T+f8
znSbG>*(9I0Uem3vha&bnWMViyVy}N1p8a&R`|kAksQ-U?{P`9Q2s9nOUrj#7v+g{7
z4<YWE_+WH$V||tMt+>z*2r=E0{_uV8^b8Kg=R@5go6Zl{i@ju=!Y&>Y!KKFhet37v
zPTsvfd&y=+xCljrt^VGmvoWV1+jaYS(|<qO8y@x!k57Nv_P5{rB<SFq)%Yq|)?6sj
zHal4M-g2iAw}<X@%un&%4AiAF(O;dOx`%rVWbgaCJ;tNF>zy)=MfDs48Xj4^<L-FO
z*r>ctkK&{hop$&3P9dK_F$7P<!Lud|Pfq*C=3#72=`aSf@)@Y`zORc2huuEo?SGCS
zm&^B6I{5QFI{0(21JH&pX7Pl>>&JBVU2Tk()Imb+$NtfGKGeSEOK-N$Q<Ca3eMZn=
zwq~hRyjA5qhs4=D8KswLGB&HuJw=V9p`ghME&WZM1e@iBcYsu5PF>Ge&p?hZ{=tq(
zeL!w_N2w~lOX4}OatG-&T^`2yM}NY_P>mLsD)qM$$qgUGi>m}$QCuM{b$ypJB0KS|
z;@tSAs=S@AEbXIa@ZO}$ya}%I3|Am9nqs#ETV(KHJlAcwvfw~4IjnsIfg>V2Kn}Y<
z^yCTBeBO@O|DHKf?+eZo_Zrr77?_3B?NO79c5lw#vi}Zxy8}iuPfyQJ;D3zqTn-&2
z$rx{(FOq1wnk>`#<POvyGHE%Fl6R4eVz>{x<uUiJGLd%o7IVKrkGd1lE&Rm<jsEWN
zefQwJ2c^@czW5@Hs~+%S_w;T5DEc?-G`nodL5PFjm?>$X06l>H_0Rz4wc7NGv-7R)
z%hJVVY*zG0%*Z|CwQ_*9|9`MNLqKIpbzztcqjvidxZqx_xO;56fO}1Tsf9V188VF1
z9O4;_L1W5f-T5Me<nK)GpT?s_mUkW-_HUd~C2*oV%6;Gy;C1c|7rWg8c)*qLTF?+b
z6if`Zs@13ukRsm9zJaI&32%cB1PUKg`1r4u-kCurZ@t+C**%y>!G9##TsV!0o_DsP
zELiWyH*q?_c%<npy31Co%yklv!O&pA2q9~BHJ@h-3}wQ`6kW#<x-^*?P>Vfq^Mehh
z_5S?ehwhOiO^jGQfA;MAXV0Fwih^o{?Ry|>2sB4b;>VmRCw*^1Nlf}i)ToFL6{hsv
zJ*M<sy(xY7g{HK9kAEp`*PGJz7n;)Zdrawhy(v9^;3*k2Sc+vP@o|K{ds9^^{*_Rj
z-;>U8*w`YaLz$_px*lkJQtKZLE`Kh9%by<vE`R<8mp>d_2w=SG3<o+My~+AO3TjZk
zR%pSmX)=XKF&ma{L24z~c@edR%or%rlBrZxOQw$DWC6x|%YQV1#@dl;EL6&Ek97#2
zt@`q9OG=iyf{}0CtYv(1yW$|<U(H6sn~B!7K4Qo6q_!5{Y8JE|Ca!VYAb4+eQdqR5
z&Qs7Zg!-0PZc6Xo#VfvE@mA@~rOi$BDyq;0doL@zC~x~x-u)$&Th~=8wGVesHQI*a
zhI*twh5cvYf`0{T8&d>^Ha8t4>fC&Mn=FHS!PzJ6s9=K$bgtNq<g-dTQ~S(~=z=yL
zC)w>b=j-}Mj4<}!9)aP5+*-lXLNCSYgf7nun+OA;GXceE-nsDJt>3fJ8JJ%3+m`M!
zo1(FVqCZ6{STGbdaipLuY7>Z3x^l%G9yfKwqvKF3kAK$!==<ICgTasin8Es8uX{3l
z!%ngvh7cu0&%>vvWfNc<V}wzSyo%g1YUmK8LP}Rin3Cyeepf~-+fj|~OfMEejNg9@
zmEQ*y5j*o+(Pm^AJP1=S>!__ytc^>6B3N8z3#H5jPGOD)72N(?|9q)O2`v*Va8)Lx
z&y)55#D8E2_ku%0jUoT6+Wp0}$YL{{s5$*G{PErKL62jfQOvd3^IVKTlJn=Q=;cd2
zQ`b{Rb@(#Uv`iSFK#MsUswcvse=vMNRayhLYUth_SXrDi{Kr^c){Qcm;VW#sdFe$(
zSY%qvb5p^WQP^s7_LA|DV3Vf}AVEtSAPgH(lYg&*(M_?I*n?HBHJ2bcC(eha(US>U
zi^cny7X1Y*zo+qVmfSYE!J26S-*O`u`Xd6G_SiwYH#H_Q2Dh;yGdB5n@*&E=PVSdV
zhGp^*QO*jD$@D1vMq=uF=g*f|M4F04P4)@|9Pr-~X2lR3K#Df`JQ=zBEo?$&tULDP
zH-8p$7fhLEK_wWWYdB_9;?AS91U5nzjlfg15VL;1(4X{M8P4=jm>_b;wzl1qyaY5X
z6#;C|Iu2O?!?lm6Ne+;-?TY%dbXmiiNLsqd=D;<bhNL71x^Y9{SJ-ho7n{5YcPd<N
zVF^=kIGWvHF=2#@aV@yfo-yTrS+-Pu^M5_IDf3Q0$4mRBV%UJV3a1i_wE77tEwr`u
zB66b1Gtx3nCdo1p)TIz(6c~t=p1GP{K|?LC^?@y|Ep;^hsn+idERlDmK3Q3&VRXl^
zR5L^exKUGUaTT{>l`LXW{7vt!a>hVA4e6_BIrP1sj=G0yjD7EJ7Ej&5zmF%WMt?~S
zS8gs@30^gpOF>Wv4psMB&jh#a71g8#4P!7ya03VO!^!^9(EG9Fefy%QeI?+yt(%`(
zo_B>UheRl&kDvrw__apAws2d}yCVlzC=(uuJW+TJ-L3h)WxohFxQ~I_%*OP)7X1-!
z<S?GwZKzi*@^`p}^V!sGgS>1Rzkdp*Gg;-=tiO38%xzBN*%e)%K!H~9OSrH8>_+VN
zq7I8nwTeH7y9RS2&V<=8v%j?5SH;aDSLbV$d}uju3il4}{FG~`fsHbEO{h?-@M~ee
zWPHJH17%u8AH$t;_J<EvcSGN{%%9<=_L6+L$nNa6jMpveciF&jKK8iqWq-@~RXQrG
zA^Nsu{wx^MbPT5S4zTF!mi7BZ!#U@khpw|<zcTK#AHeRf7IJU@@b0t{f^QdN`1Xsk
z5d^T*89=C9A+DEnZ_^gDQ|GIP8dd0k49#tyest;5w(kz__d}NAW8Yb^lHyfZiFyF|
zZXE!8R|5cikd+RE;-akzWq(R{4zFJ2m?$jSDlcNK0>}bNJbh4!KnOnd<T#XEh+S@x
z_yuD7IJrz`(th~lr(u78cyv6#@6AhA3!S2({|t$9Td!pyqh-%3sdBHJaqC9N&5<)2
zzd-Y%q=F@*loc<zFsoY8krWE6TO5C3S;Ej4meWjoVKK^=7xx=rwtovN6*A0)H67l!
zv^3>u%N8q0iOMR5s77HugJ&!(X>x=W8s%(Sl{PDsG}$$x)AQM-N5B4B;qa}$1aNS!
zy9}bPeLPb0@p}#1$05~1%)kH*W#)YWTh5nwMqr!z6%OLN@<Egw_|=GZc(Yl?uU>nq
zk}ilL7r(7F0Q096dVlKrsy8ZY9P6C*N(brFN>|hSp_h3T72d{%Vx}GsvIy=I3MZ4!
zAV!b0=FP!12@J~avQ;$8ZdF)(h}0ZC)=j${%g&B}<dC+-H_$i_+)nK5*epbc_KX2n
zKnZ^Vp*$hX^hFZQR+9;uwi!Ines8e*ZrDF!OdG>{oOF{{1b=p<9bJkJPBKg=gb}gS
zODMt}$q9$#u7PgP@ckE6{5&nKLkhyv^o*%h5lNcF<<dKk7ar&cpN#)$urZOXsT@`V
za8cXRhcbn{V>>F<X1Alqh2I|&l3B5ToAL)o;TH6b#V+NJh@y$j)5^~6w~y^tWzA~#
zS2juCJf=U(ntxIpvTTXGcuankwL@5F*^=?<vGKcff_^?*%{KJ;aqwGNk3~$n?6$bf
z<KhBk1F+dD*{S>fvHP-0<Ajl*Z5yv2JMYR`E?{EGUJDm_T=>00?*aaZbRI16xaf0P
z*HoU7otf_*n=i^5G{hd+qV@8z^`_b&afap?#jD50?|+ITG@3KtJvLvI4v)%OYJld;
z$JU$2R3`h(O3yWr9z=@@h`(Ki`P<Y#w?6t?!w8is*#ngZ;gbhL#B1A2y()KO36TLZ
zw(X;1st;FjyoTWUfS6UAg|U{lO5rN3jIjtL;$s3)KfxYt&Y8*Ra*<8(1rOytLoWCt
z&XaM(V1JOWz(@@YBFBsL29koUt{}c|0&&XoRTBN_`{&O(Uo#w7NsTM;UlF9SlKs}#
zJ)i&WOB<#EKINX?>B0CYU+};nvn(p}MUD+JmVzQ-Xj5IJ4P_EorYdx6oj`Kzz7G$4
z4$-cx_cm;(Ri^=+Z>Lmf3;)j|%@xdhztBZ@0e{sfR%jCll@)wkp;SdmR;VR+hEyU8
z78VM|JF)K#Y?4+Mgy8c+o1kN9!7mAOXI$ZOLCA;iJTMr3J-7A1WPNueWRCvNkAvUb
zx#(LKX9Vs?gLb)Q7wg=`1Wmjv-@*iKm`yv2bsDp2X8k5D3**}Li9vDgy4sGoc2#OX
zTz`Me0juHK4HcRM*KW<R@?EP1YS6n5f(4DW)@dwcYgM}~!_u~PZPU1R&Ca<I?7Drg
zS=+RlwGFfGZF^Ch2Zm;AN_^{~8yZKt;JO#u1==i@z`g(=ON6=_Bx8N3`3!HXfNEXA
z%auqtMD8n)-RJZyoAhVltBMEg<B<y21%H0=MB9-#n=l6Kb;3l!@d}MFe445p6L5=i
z@@`u;CKO;08weT$D~V{F<Z}orJIWRd)|fZiB8lzB_<M*a)R9e|X|>pQ|L^|;`5KdS
z5v_6{k|G!ptCh`R81W>EXLq;povbYzDF<JP{jm$k8m(44+t9<7IHud|Wxyxh>wl(i
zW>xS8YT)BhH3r!``O)X*?s1&I7I6`H?z9Rq31~~0UoOqhrtxF~g;^u2y_Xy;XNO&I
zb%$Ufhuyzpum;|OaLq;dq*t@^d6PEux2UOFdK&$;h52L(BBZpVCY@G`?Y$R;-p(c;
ze0&L@Qb}?!C&!%q$CL0TS1$I(>wj2!kLyf#Y|n@TQw>~J6z97tAg=esSI#@AkNh@K
zj*U3ypXWw7`-_#<hlC9;NbciBMAf;Q7BClYjJ$vzP66`NZRoM;54k^^An}Oj1!z7@
zodr@=)(vh(B=EY|{+)adaA-Wf(82NB;r{XIVRz7c97QI^?ATlH)xSNCPJd4OtM9g>
z$L*+V4)fK&{r9RJ0iwuafBC*`g4mfE&R7{4`PVPHOc}W(zh99B71J>t^nv~y@_tX^
zMLf-Q)C#LD9caKs1-T&lmo<6;OLp`xglMD!1L%+q)H`1mZ(5`1cmgV8RxBPmPqV^K
z<_YWU6`jddR4B@q(Tv@pw|~BWviQb9eEEctycnSH)SUid_vAz-VZppk_i60>41z6p
z2g1JfY;f8?dRw<`qYxJKclPf1Y%uI1LJZG(|8d?s8uS^5_2X$D0zdZ|YZ(|Nt$5l!
z+B-hPAwIzTce@yZta}!kv)!BuO;=LPNquEt38nqcM?(7p6>WMiAAc{Ql+QefnuP9>
z%uHbT2uT^13lg3R{_9DHL|B7SJahJ2^y)rqbkt))fqdW7*@vhBGd4SyX|;@CJ0NpB
zqEmbq=RG@ejgIjF52H!GX@p`EF^2M8vRd%O&pV3T=v9k2Zv~<Qg!4>tc!$BB*qbYa
z!vYeZ&!X#iatVgjDu2X}NI(mPJ4UB$jM&0!d-*(^CZrPHE{m7taxUHsiB1xF#yu_*
zWSyh<Do!y=7)%Moh$J3e({!0}PJnWIoy;JO#R5w)ks|ptg77)O1mc9BUZBwEM8CPc
zPFV%8=VmPV=;H*^!_Fa!N;Hi>aoTR3#XHenHv2zI0ah{wntx^%#}i*<H;LWhcTc~E
zMFG12)<Zg7P3fdY(1Wu$<)HyXgN<HBI>!lHx$kX6hsTrJr8CLmF<a}`PS%zheQ!qJ
zL6>VGOO^biO}A!QUz~}lbcoBxJ<R3f9_s2#@Njn~9i*i42_N?IdC)_D%|>e-{$+i5
z3uA@fj~Q4KE`Oy=fqW`52f^ZACP6-h%z{(M!!!gM3Na7zDP$t#6J{plQ<<rtkB}W+
z`DF+BxFiA|&^WC|aDpV`oe;TDdM`Fjwh&|XBAq}GY-OfD%a+%0bWI^A`7(>f8HQl%
zc>6TuMi3aa$T)_>&g%WKXUgzMy$A`UW)}$ue<adQE`PJl3%JX%m_*VgftDgeK0)CS
zTM3fO%3LUcM)|^fV5Ghai$0s*>d@xBeCftU^r+}S`lmI7S_hH;5b_^D#fML|gQxh=
zdGG`0b00Rf4w~Qjkog=3OpU{(`oU6qsFWQjH4c-~gQWNnseOQy(-8OI_|k{Q0~{D7
zhlL#%Sbxm2catpc_#iLibON(I<qa{C$7HWjHcm{-Wowv@8OeUPf6&{bBc!@LK7cCP
zcrP8Tu8{wn3hDyIIO;m4@tpihbGbvgv#9Y2j7Qiz=;Bu1321#u8s`F)@B<hrZAR9H
zzhvUwGBUUJ7rj+jQyWjOB*esE2k&0T>CB_4w||;v(ky0CvG@itKSPG)+HkBd^y2@-
zT{1X5-yNKv_J)I>PI^*jtkg;Uqy6LPH;%BXuAOflZpsJ>*roND#kHEgG}DD}))4hZ
z&HiCRYX~6N=#9{Tn`9Hc%OT?og~JGJJSChMrF~@Lt*v=4b{bgM48ZI|^kZSIxOgB6
zz<;tcfFPf_Q(Rr5ha9`$6^SGml&zt;m4VF7Bs!d|^6ULYHd{6~6xOt(4Yz|<kw#7$
zgj-Xo4HeJ4QV}B1Z2Gg$N(Qoa&BNE*HQEHomuu2XSulNr+)y|T^`;`3*+1yMJ@aj(
z8W}X@d9ll&$so&X{FpAUjarV@w%#5wF@K>-Z^2^&_m6wd?ChK${cv>rBP>;Q{<0&+
zkvG}M#mb$ZK?az!cila2%1|)kAy}m`s{S6S4;4!p`Ws!2()yu}P1F-o2B(@9zImX*
z@Xp*~RraabqXSK^_l|d4+16w-%c8O0WDZAqhOtFdTu=FiQ^_06!wVX*_FSFBk$);Z
z0V5;NI+w_h$X72JW$9cJ$k4$mQ49`#@h7p@tFQpHwQ^4x1=YgLI;>uIxrAF6$XEk$
zh+IYrs1$2rmOxIpSSnMB%P01?g7xbC{p9#`;AO`sh4ePrxh8pkF!+99-W{J=6vKk@
zroBm;E3BEf<$}fYrud=kHsLx8l7BD2XGl??tMH^R<o8RPeTQr>`nzjDQK0cUVKnn0
zZ79O}D-Bz-f)u~x<CnnnSDz53#_m_I7=}Yn2q<0UWx(Raq~I5eB>w19(FSS9qrlK@
zu=S1Zy}<6Ud@^w7G`V5|a<VY2r+(Ir{o*}bL$*{@(_t%Eh{2R?V)Z9wV}Io_m-1}v
zpp63CZ<xuCHKO!5+;Gac2G&ZD+v{|a5Lj<*1yk5l={Fj!77P3dG(P}2>mdF}FLR@7
z@$W0$)YfZdDBPr$3OKP%<L3Z0PdrDcnU0317?G)CNJ1T){%wwS!ynUmWVqg#*qdB}
zhKsrcb(|YsYtZO50~@Q^a(|P4_~8kUKPMrLQ%Xa136K>^Mw?H~p~4(^4+5~JZJs#|
zZbuR7XgcKf?QF|TvztUOdb6sruD?I08{P8p#Xpjf)QV<{4$MY_-q@My&neF@YG`Lj
zE>Q!GAyb{-!0$JIo}HR{K7D#Tw63o}YbTANUG`<eK4cz3!ROWEg@09LI=@nY9GKFH
zmmiRGG7#HfPD~6IXU<Cxqw_#IU<wIM3?fYlG+Q3e{S1ho7U<B%O>37(vS7TvrW#iH
zSobbQg2BR)8)PmnEATR$$j%E^?Ir0#6rK`Ng<B**n(PJPi$a!WlVBiv1cYgfx=*&z
zUG&+cZMC*uLwYff`hQO(yTbi$8AQuPGPgBF9AzWT!5ua2U8w<Y59cgdLMTVky$Gm2
zx{eo{Ewx8Q!-{_hv?GhlsaVz3dBEiPwGIPgjwJnU|ELc)n2^a&tGpa0aX+0*NVjzO
zZTm`czt0HDNp}Deh`68J^AdV0X@oM66*&6|S}!jwuFZ=Iw}1QwU<P}kiR^~Vg`RtG
ziWcKme!fyIegcp@XZQ50d~g*vp}!wPpaepWery~<1wyt^#Rwt$wD%w9{nH*~TNbLw
zZ7OOb;;I(47W>*r)I!%w&D)Ar0L{>ERWBTj0g911ojTs0e9YU$ofu6!(+&ysqG?EL
zZO(}D;KA(Kg@3WlDfhae!LEL6(=PZcehUTP#Ql^%Ge*HKfwR<_NvEhd7issq2WLG)
z!4=wHk*|ZI;%)~-etRf|zqzk!FPAB3$f%5BnOarhZs~)IVMq#x(>;crpe3#4YVB)!
z?fZ?=`Y3Gxj@1b*&qco$ot3w0*Wxzq8<nj`Ws8zPe19XdUmKAPC37%ntca!iMM-Q>
zf3dG3Hz)?Z>F60Uo!-2H3$7vc+Xl8i%N)jw^`}?F7Dx8IDQ(cS@Sq5<!0C);UdPK4
zUs86ZRfObDzQJw1w%YPtj=0@bYReEe^j#o2t=!=ij$HZizPR#y*492!<lQXO{!i+)
zHd@hZ$$v{Fvr$64Vf&2YFO#bUV9VS2ie^9GELbr-5A78q=*mZ857;wU=Va2NSMT)n
z_;k3>#516|kc8yqw0FkntO2`C8ynd4wJ*^N3vJWcZk8`SMc@+2t3~5L7H`<fvER>)
zLrs@_>CcI+3O{*bO8%tLmvE(Og92>4nXD~c>3^1>`(r=j(I}ZOA@BtJnJvZ`3L~>I
z@giML<NTvx5#A(SZdetlKe0Iuvbnv83MyEEd5%uoiMD{(jAoW^M#)KYrY^?^gOM<c
zFp<r1M{AlJXe0WU8YuUstY9e%e&nl3j1fWD{Np^Dtsn&l_{LoTlreg)wJjNv!>c@j
z1b_82yo8|RcTHp!;=up~g2K_WdwhO007C{a<%TPHqZ@NVPn=fa@wB2>Ys0f0UDGB8
zg;RE7;jHN@U}P0gg@HzijoF=+xER3+y_9>es&9*LU%Lj0MP0f}T-+l(72Hzb`OW)Q
zQx`dgI!-P6zhV$g7X*(e;c7*HBLj_gN`Gi((SaWbmk<o6k<PN!(moT4VruwrH~i+c
zBoBQ5(k6bex6o7JegCZg=AhS(#%YeUkh^bm<iXdp##qz&gF2u#>k~2P=Lc<}a(vP|
z9sD$;1J_R7jv=Xk;IE>8l?~lE80*6z9A(0QM!iOV><`}ck3=M`aNLRq3;rYUR(}NF
zf_B88Oo}6d89S-psc(66Ll<o8&YAFRUUcYE9Uj!_3HNDt?hT{Yr0dQFiA`)yn{0Qr
zdymft!{dEvOvabOy~r?YQZ;qqF4y~c{f%x${Sh+F*!PY2mpNANAw1HE_T?O$zI2~P
zBD%AAGD<J+fQ!4x*qO@Vu;xG@p?_SRp#V)yXCmBLhvsgP%T$+&(0<_SkHZ1$?hKUj
z5XZLH-6QcVh&gPqn=k6<)(Wo8eP*kqct$7kY~8hm5Og(Wq*jv=E*rKhWvr|XDY<EJ
z_k3^+s*id#fX&bru<O@{nRpy4?s=FOT}+oyqc4knzOWaMe}o_%t2~T@dVjjO{RO1`
zfZl9l_R8rBq#3})oMZTx#z}gVx!fKjN|X4%)5)DYSK09rF_|^L&Q_B#<g|<@xA7eb
zt)loo=Uk#RraDr-Jvkp9bpLPvKpX1rRb$kCeN}_KvN<-pNsR9kFw!@6h_B+->*<h0
zn+rq%a$*WS6w_E?*P)+VIe(G$^}%fwQPKiAdxRO|(ZC`aXGspBZ}Qa~jFSDaZ#uTY
zNoB>8MqM8g5bO6UYl6{>c#UT3YvkX3p{Tq@;t#W`%Zzc#kcSA>3sr{{P2-OVnt$fW
zEKfQf^Q_7WMZ@@{d+=lTr!!}$UjUvDO<XW~?rbYwEwczo90bx`F@K<?(>bHFgj{n5
zRK>LIvLhwWa8tQtQo1!s6I({38SP#{@+e$DvMqIsKVmQ|e(<Ct>`v8^dv_Wym&pPn
z=-z?B(u~n*^ySW@Y{tfW%MV4_kN>PwJz`qq+cbwZSbP6~({Ij$cySG0oaan-hlE#C
zZspYpQDlB(JPL761b;E=)wDRMd$&`Ullo$O&Z~l>p(fJ%`v@=?HHBr<?30VhrV`vV
zD7b;QhDkv+i-LkXyRSctZbkFtdj_?=zYVu7)Uqo5{3N^GZpvlrsDMB%axJL7qL#;}
ztg}xSWvwVo4bisMyzC3axYe-Thu9|7V%$3F9IKUfArclDvws-2(lsL6S_7!a!4||t
zHUOd9v=}Mpyf^nRjeIR1U#q6Yv$6bvPk}&EWxHBF-c9X%Tt7aljSt30E8dKK<=-+(
zhuzph>*JYyI1cOmB5D=+K*4P%T!q4=oe(gEE6@^s9?69&_?qE;o$g=XYXz(y7=kKn
z@LlrTRf}$_;eX+~+h>DeSzSaM&TbE51)7%ll;wEK2`two>k(2CM4)P5u%I_Dj2#<c
zB%K90^g1|H2CO39+PHr%pe20fuHpVT3yF~i$=I|=#&kF*U#+_u%N0$Z3$zW8VFrsk
zak&o6?P?|@N*&%7fb+<eB&l0Um;hnt23d4NLKTo8<9~C24DsQFEr@>owKAo`#rT4;
zv<fK~Jnl6keTu`&`Dv4hC2p<FAi094kYvFV2m}ZZ$XR+-av7h?WR5FEiYy8mD0<=^
zdr>wSo8$;3p-IXZKnTa2<#~FMPEw4aYc%1SJpHTrd=<TX>2ppc{q7@ynV{SHGQCNR
z;vLTx`hQ|H@HgT4>cZCyxp<U`EXj%<8rRbZ#gSA|UNS5gcg*Tbu|AxXvf=Z<&LuQd
zyRhCSIv^XyGy~csb)-yu9TDr2>i3FagKO>d+AQVdJ+ecsBoz|YV2b5L0$|wSczIJl
z<rk5Mr6gNQS1xo>riT@&QaMaYWzQvlb$BdKrhk~Q>qUM{d%d&4>G4m>lS!erx&8Co
zlwmGu6<u%fY-$yaY!v5-2~rf2^<cR34g2}Sjx!~{y^Vc<(*xV_mGo3b587+|FGUWV
z5R-=3SqR^n9+M_`;5PrHKsKp12Y9S;Z(y@Q@q|8pGa|zgui6kS>j{g=v|!_~`ToIq
zrhit0siF_v@3cXa!@7h>1%jNi^M^89UM{N`h_s`v*XSv(!Qg4hZN&;(fnct*36v_<
z-3Txa%PG8gSe`+QlgoHDS-Oo=4SZ>2u@J#m29IY;HYQB(0NRp4wu~qG72B-vBd4ZX
zGsY<}E>tFMV3l?!NxaxgmUvK+_ITZ`*MCcBwB@nCO?ixuG<wM$TK+E8oB-c52=9^V
zO<JKN%`^O*{!*($$mq3phhSjDJCr~=S!57fNUkB(ix(Oozo=wrY#A6A>sU4g(O7Sb
zgBP+<GZ^N=+=$)rxY{}y{hAkJ1di_Yf-&90)iU{Xz`8$W98(12fE*Q27{9c6s((uS
zn`{_Z2^ydQp@OwK+<S*XT4}Z9A!V0j3j{$gF+oc(lw+~ht5C}YPchXmQ|_2;88OuF
zvq);)3v@vD@4+@5&>PEl)%%4uSQVl2epA;IK3h$>yha3&Tzdha_2CzrxQmGIi2Y_I
z>se)UX;^Vq0TxnO+T}0p=-%K&@P7d~@r?4rk<O9BQNJN@gqJ29Rk2p}x#BqNiMdnv
z+;tc&baK^n$C9TUgFLgME)8ZQhw&%ygexqPN`@vlnAHq!a51rXl_8Mg!7<ona1aIV
z#MB5_nGJ77*=i}?wl!W~ri&aav`s^0Wwq|j9*mO-BnS4!5Ee$m)8X+vS$}XEa+b~@
z-z&V|Pni71@awy<eU0zngFk57{Ewnz&_Q{^B&k^=Yt&}{(EuxxZwoBF6@a5BQEKU}
z;L)9Iy(Wl^XO}>rh|W>HC)r(H9y`#gvps0jUGw8Q?c=E5+$~YlWse%)-*42Orn}}x
zqkX3X6Bqe~398XZHMUOWvwwT-pIvuJ5Sp}E)j^1MEKMFO3^*vImQQ4>-bAVhnO<4H
z`h1`H`fy%BvcC8RvotK@k4bdcKjKz1D(#%oFDAl1FnTA_5+6YFG+`t@SuyqsJlax^
zvlkuSh4i>UV%R_OXDo9Ti~l4LY*$RyTq5l{fHnbqJ|C;-VSEU1Qh$Th&}x~d;{>k_
zfjA-|HL6+%2t75(VWH267hL^5T4BHjhnrOc6=~1SvEGju``kHe6XAy^z@L-&K0M+5
ztVGwh!AqwQ9-rET)%H-d8T~bS8a;o8IQrLT|HhC)Civ_)m|DP5>G{H)jA@+{T^nJ!
z=qD#g00s~i`X%c%Wq<4;j7YbVg41baOhXQanhDm<E-!P0uU+pLKLqP>QzEApH^vUs
zF{21N110fBLk-AiZJz2Xuv@S)gpl)8#K>~R?6uj{b}ek!4x)pLWkyRI&J1F+8L{#B
zT}afl=S6Qrc!z7<emJARU3=zVek4B47HCZ7hfEA)M^fzIMSlQ`&A`Gs@`<iQ)W~b=
zunVVC0`ZQ{4pV&&gVS^W6dVn>NAq1A;Dnpq;q{QZwS-?ryb|K}D8I9}@DIJn^u>MF
z&F?tDomFh-=y97{TE8OUo=K;a$O&&$<LjmH*O%IMbNtaPxh20|MVq9up^&yS8Lwuk
zQss}KnJ8Z_R)3@AYJt}?7hsj$zl^Tp#RVFa0#S+Cw@Grj1oP@e(&i>q^Ng_<Xt$~Y
zk3_e4IX+s%`L(jJHfAMU-lg#j=uith4VrTKKE7dS-JhMwk#4q1TV<3O&kr=dw><z1
z=t1gW&B}PqKnu%95L#8+c>NaWB%P5;uZx<zml3L1`F}&laDg!o!0Im0);?PRzj=|4
z$H~mUQWkcCD#oWfG+aD|nMhGPEeK39^u_D(d&}2w?+AfiQ=_i5qJkV;1$d|JhpRN!
zGSN$-ED4D)cM_Nj`(96GbE`)SdM{*D9C0sxGmVF=h6vg!$i#5a5-*I#+MaRf#AAl-
zag%q@vVYx~cw>hGm2-J;g-!o7cwwaD1ag{-v57A95uhgJng#@7FoRju7;R+ay^Ou4
zL|69XB3&kxZ;3Pn&XQ#xbZeNTk-h4VpFAN2WzP`(?M=)YH|AA8;Ot()=y7(3hZnu3
zB6qREz>6!iA9~`lLEZ_!;4<doETkw>z$QYA=6{8=4v&sb2K44x7S{Ge;zE|Rut`b@
zuGZsx$8e)kozNXtuyX0`df9~Cn}DK;d+rS?1E5yj8kc$10K)dpF8AQvUodHc%WGQU
zuHGqEkfBq&le4yxCMo;E$-Gow6Yo_D2`mq$A`;yca-P@8=p(Xf*<!JpqluSc%Oqzi
zD1U;_n5ct|kOo>MaX+l$0Xudbi(j;ZId)HF&Ygnem2i{)Q_LGGST|U=E)r@0cmXxj
z_QA7iv;kq6C##nm;}tB4YaA4`W>P1PTgP1gU_h)oHcA4k<s{3jlx)QMgWG$6|D|Ms
z{l4Ii>Z(;5r_b#Mq2WWvYNW(&st_^#y??KPpzwGwiMAF*RCp>PYe6?bq=lytap5To
z>_&;Y9BVZXR3i&UIGu~umPwt3kyAy5O_gN6%XU&a8ZdD$k5K~<Px`YFckOwJvd-Z6
zu)jOxE=sQ>sx3v5tV+KiVhzyvzkEN$0Ejnxb`?yW8EU4Z{%URjt6`O6n5o0{f`86s
z@AwGvUGDb4>0O)bQ8!_Te5iz1?|@$87QVjA8DBHupG9y>aC?}*?N<)Mw*hY*sSer>
z%c6thV>Ys*pN7Y8{=K(5I5QcDh6T1dfzOPkc4cUNBzx}hqU7=t9p9y|8}zB;=1qr2
zokMV(+lU0&Qp0N%g>f@v+iTHU<$s$9VgW?kS@YTksQZf-WnoRd{d6yv$%3e>U(qo<
ziL5m+tzTZ)gg@NuYXzb*qFygjoJ*C=D}68EI-_hlj~B@>`NX3x3_;qQU6Jv(!yqbj
zA%Mq2di^mlJ)WFpLyw-ks<I}$ea1_c-c!mw#3O)5yNt3p`JiNuP)j@F3x5S}Ry4wY
zTa??l-(WK1<RV68N?Xxz?Qb1SpBNT_ocV_hjb0eEO27jKxtMYnu8|m>;pS;kZ#jX^
z{8FmNk}51UfU&e8smUs)h;0>5)+uS?NIMGlX(c@3xTO9pIM;TwDI=s>ehlFE)>iea
z^U}SrRdFv+wnXN&3wnYXoPUT%ifnrVy#`Xd8J+_nbSg$AOl|3)k%ng>`aorgI&=a$
z8&@r4_$@#zXwpbICYLhkQoan2VR|6Rz}mr6#V0X|st8yG`S?MunspejV%GOfIvY#f
z3;1x#>@Ef-@$q{C3{Qo}HC)46F;p&y-!g}qNYlqJn*OPnMfmMQE`Lc?gIOVD+K4y(
zBN>Zno6<&=*X50JZrxrZpNk!}&4*Ud1I_S*NlhxLGVGc%+x3O#eJBqX%->ALWhc6p
zkFV7ZUx8PAWh#_cxw|ez>aNlnQ+e0S|EOH!SQ>uNpJr_p!Mp0R82g^B@P@B{Z|>nh
zMw9jM^Pj$1D0UNac7Gp1b44-ng2!7em>BR7n^tak1MZcs`!zX1XYl(|6CQIZomz2|
z{)f{NlE|hWDIpctr6fkSsn1GCWOAyM=cXzx|9g@VYegQMihO-Ug3Q>ME#HgllZeB3
zUSynxJDY9oIr4mBZwtlfXEGnNHWJ(kYI22qmwCq#HY&5!{(sl;f=NSClj3)?w**?=
z!`5qn66cv2b~QOrS{uAAtDEv@C9Za0lfxG~6iSxne7Rsqc{yCRitQ}vW0b_9;|myl
zVY>8i;^4Kd=HxXV9g%s9s$nXytGbaJ=|Js2K_U;kCzjn$NU+2F@?qTnV<US26Zo8M
zk5z%>{G&i~FMqXs2y@B;jL-uhy+5e^qs?x4vOpO0&*h4=HsJuSM7+Y5k?=UkAz7qG
zA+iW9JKQ}!5lYPmMnUgxg&{c7XUH<V9RPz)naXGCUB%k_#JK8wfc@cw<-mX(FnLTx
z!PiiS7XqAEUdKxnqW2=1WIS{S1dT(TuoZZj9vu$K@qZ0woU-?T=5IB21|OWE@+#aZ
zgy(qRjpAmj{X=dOE>+dvB_iqNm)s-|wLQ3$@SwYcqFIg2Q4Yk<wKw)BtNi+S(VyMK
zlN8LQ^l<C%lT6GfkSYul*>!i{^@fm3izjH!=Hbm@2ETj%k^9JS=%RNxro6>JbYdvR
zvocI@rhkRSOcxV5TA?KtO*zRd#a4uY%2(vB6meV4YyaT<?44<RAa9e{pe$*q*#fmO
z4Ahxe?nr@Zc$REx-o;tN=^wrC9`yIv#;-Ld4YdawnAa{NzztLJlF6|kVeUl#4&mO@
zt68>4_=PvzGISma)pIK~uHL6*vGH_CGlMSK0e_nU(-<-EeFXH&t85T3^Jj46wzLy9
zwU?fa@jAkPRGAk}15-9|Za(Cz-?r+rrT&X(lLoONFSyGApcQ%9G+Su~??7nSKywj@
zeIfb%(hVf|<ca<suxN0D2^xXbtT2LBWtYx@YbRe=szr<bCg0NLq8;kz?P*eY6e2QM
z&41xLt1(6$e|&d*&>MnV3N^NHY2+-q#XoeZLK2Dn*u+t`5wwcqtKXTkCWo-7O;y9)
z*JadR4Dpd@GnvjIugcd)mKCP9#7J{=^J`0BjL{$St0LGBG32j-l<#KqJ8>(T*$j)p
zeV;8x@3MS(!rj<B*$Sd@zAWTvjPD-y-+$V}l34TpS!KiP*HqM5djOP3=4he~qXE+q
z$7?Vm0nbk5(fqF21V!Oy%N)j&@SGfgMIwr8%L>uJ)f+}T4qsfvT3YiA4@lS_m|J-*
zP8V=ScQVMr!eG7_6{3Xk-9ZU~d3*WN#k^u{VeQt#7IUD{hS5L`Y$;zatEV6YoPYJw
z6s=_(Km~eb^JEd2Y{N4WR<s<!O~^ed7+(ONHBK8<1Ej2~t&JTfG{}b-T3SL&iD1eE
zSN)490}zUp<^O=S$#k7yv&!CH#p$gQ!xt`7NrkecBJ9-IBc3Rlz*ULUcRpJrS82}h
z#f{Kflx$*GyC|sFdeA{9s^abp3V&c4QiVX?R7Sv?_|E`5vv~$>#**>C;c$3HT-6{0
z0ExsHkemzKy~QYa`Nwn~-F!qW=gniA7s(|Y#HN{(Tq%20BuGV>)s}npM|$>|NEz$0
z`IL{ru~?%E+_s^1Cb${hVuRy~uyx|@j)bfgSXPzofmWb*F%9}ncze>@0Dl@%=J?_t
zOj=UJqvHlTR%F2!sDJ}$99hIB9JHWqhxli>sVG6v+wtvu#Wvz1z5;Vd9GLC^Tv`}L
zAW>1;9Io&s@e9VQ>GY1hr7;Wy9f5f1ZU=S?O}7OJoN!u~XW9msR})(CjxkJl8QHYR
zd+r9AaNas^uGJ)jN+J4&JAeKnJK+sBrW%Jho8W(}61MQ*6W~p9LSg{<@}Hp!Ecve&
zWE%&j3aVCe4L}>QjedlNDETkyeQdAM)Sr0AJOpqL8H-mqMo~eohdrtSb4)_6#X)Zm
ztlEb0gg>x0350NfU~ajH%K;0ON=sUH=3@>cktqT!xn+u6!XbFWHGjOuXc#3MgQhJ~
zGB+9{b*EzvtKAF^oY_*E`#K2M`-B1ItN^y4LcfM!bzrT;ud+{0L8CSJN%}eL9>43I
z_KpUS>u=aS+|vvCxtvVRv5WaOE5)^)b7!KveVG)r^0e?qr<${$wLaAnvJ|_hdC(TK
z6?&Za1Ii$eaHJ2WHGeJuT=mojge>8jB4cYj1cS;J7}aX8F?nv(&vm&Y&>M2(HdqQr
z&E!$l&2(Mxzf*ouWgcjrdW9-MJxS4pm*4PSb_oUL%U4z-EkaZ!+&j4l!RA`+iKOHL
z*-yJiZ;7r^)tAP3t`(9hqU`I6*<5(4B{#8EeQV}(Py<vNU4LvTy_)T1x3i{1XV1#H
zmQpgkq@kKE+x2=8>?OuE-?B$oWclR8A$7ZRQRE5NJo_-EY^;TWK_wi|=NvFkBH5!e
zr<NbUZtg93$^cYo8|GEM-pk5~oq^9g(b<ymuNaOsorO~m8Zi955H5&kzbktE<_D5Q
zw0q-{n?G&46MuEbm_wS0#<$nmL^zF_%T-8~mGQ4dtNb>NUagL3;@|vdiVkX4FdiDg
z&l*VOc!UPf<;uNsrW&YVkpts>n~cx5SBti%MvD4Z4)6#rXt`J!UZc`~KW6xhJdxkY
z(r;(!i74Z0?YyyRlof-?Ch#(vSwN%wso+Ti#`Gueet$Y+r`dt&G%T6Xe(!9!EiLN{
z`sCx%J@@`Th%VH-ntgMi(IG%{ziCC`jPVG&*Ks<75L!GW$A+9Hin^*}38}E`Sq{Ob
z&5dy})M($ZGV;XH!oRA8+xH7E)P;{pF8XIUv4nQb4{5_ogQLHqi-;*X>>@9UTXZ6L
zdzy601b^Es53yb$5<q8?#p9-jil1du(C1uTCF5wkNN<uwuD1PkB8ClN&$GoM87(Jw
z?I`J7b(lPmEu!gabRAu!tTMz<h-W&Kx_Jorg6MmIR7J+C0_%qi^=uMEc;FPTIHT89
zBe#FKSr>5)m2w?ma*~aWni%?ejivQ$%zI=W@PCEFua;#*B^Ur}a_t@D9(aLkEHjg(
z?*_{-ssrlxR|p*wFCj-PaiJ^AsYyN948u+)x5x8&I=h0Gw+SNzv}j0$QyNgbl3wTC
z@!4SbzJJz#a{x|k1AoL6dFAW7wuQ%Yb!!E?wqg?0ydVX36Psv9O$Ps#0KUHM0B=B$
zzw`$xw>W>mqWfQCxX;?A%n`bumk+;KrT!>BcC8@017-Elg0~cxm<X24ARGJ`^u0@-
z&=*X4*+`VOGK(%jZX>eVV`pT)6)JlfD9i6f#1;r^VyDBhM$`c)ki%|*YI8lNAZB+p
zu5^gbzI=>4hNIb?&r-vqmXs{`*`PZ(1D3OY^mc#PJL<Asx96uzCkqBn8M0D1{{4HN
z&5&zbY()Ra^@Te8-N6rMOIGcw`B+>jW7s#j=2+@Ya+Qh;IXQa`Nw`?~Lb~aayt*}#
zxS|QYb6I`BIE4+JX%9cZJ8ZlBX5H3BR81u5o|_u#a&1r>=}Q!gMR%Fxkj_?eB@1-p
zs!D%vHWsBrB|NKMJZe?bz$!P;b12`fu6wkCXzWch$|T4*ZqVqK%>ai-!Xr0_dN(_B
zb`ox#%3b-8CDgHtZ=E-*bb=vgbJ3va-LC4UU6O0-UpIe5Dz{F6KyV9?n)G4q=#{X6
z9?2+_{k%slUd=Ax`K)Bf?G7HiHX5h-d=h`lge_XFLLZUyJyoM|O5o@}SE$bL48;1}
zCsiw5t+K?da3qHTTs%zK2Z6W0dT|r*)S#|TwR)7+sa{BR{bTGd7V%wKaT5!L7B5uT
zlSs|&Hca^CQvt{Z^?;;0m0(PlW{ovz%1E6p+;B$7df$TwHKMu7{1e73c#0<;8rFZ~
zXsZ;(LUrxo6}RHg8*j94;9<>mtbU-oZHR;2A{2Fw_3*fgk9Yadu4^6g;g0JZ_VOu=
zJ74wqmrr=Xi`jv2eGiGi<G7Ui$_~9$t1A0pt7N<akS;PrNtnyI5Sw<me}1%!5^n>A
zs2R9-VWE@rHwXP)CLRxZr~BRAUW0#&=m!T7&P6LE^xNaJ0c3sPrfJ$`3&(A1eKKN{
zXC_&a`hHbVM>NhBo~sg47X*7!_C-O_t=BhpY$QADaP$2SGDs2=ivRuiw75PV*w0}I
zv|j(Hyxz-K(f2JfT4kcyeC&c#?v+hFQIg-qOn2llPitFZaEn%vV<5UF_y>RUylAj)
zz3$J_rKcWOIYEt=9tD?92U1~>o6a)2bM{$U+Q#*4Fx;hsqAu44*k~)P{Vcqt(2{B%
zjfUF3S%|EKhUo6v+I><&`2M2@GSq2Ny?dnx22|2h?FCK#I?CpEc(*Z9E!<uwGbUQ$
zU>FJQ_*QMh({-DGM5~CaKwEzsPi6}%K_msViLPdRbN)N*^1#|L=mEi0^X1lS$aoe*
zVloSq*M0H9Uu|w&5So>pOGZ1dqHJXBsjN&*t0J${o4(8}!ei6lIMhP4xjCPQK9<5i
zTvHOVU<n444Ff8nf;GTo-}SBw9=jb33szjDE~uRP0f5=%9I(mTjoN=;0@kGts5}a4
z?q(s*6=S6Q(u9Ex|1Aa1zDRUv6|#ELe%)ddI*JPgMSf>v?YodIFYUv+_NfY0Z<3?x
zAa%1K`9S5mdb~Y2e$zb|9-a?+e;<M&8ZSU*?H!nrNU7Qc)vW-@|5Q3Z_HB?Y<B5^t
z%1mz+!U&q0s%XB}bbWuroRbVy)iwxC_+4d^yez2UWlHXn*~xOX=VuL0{(+ZnzP&*V
zNLuArDOJGZh-Bq77JM*)f|6P)j2M&tzT0N(i4r}_2`Oo&0s!Ukcm*7NvWW7FrU|Yh
zZx2I-%ONgoNAjOB;;Kqa@~+oCIV0B};g!3nwQzI*){crGXLx_^?b5dyHgd5UXp{P8
z3}w(NplLG@5{9-&U1n;DT&=;|WR@)AiLEFo)4;jPr!rn=Lqza5PSc7!NVUG~(^@8W
z3iqgwZ~qO30jcguKX~(H6y!E0k9`^(w{Wb))nMZ#ib$WP&JnO}*mrclK0TgSbJ(eR
z@#l!?zgO=k-NAqEyR~{R)=YY~(aCuw<Z#BqUw}fj5^nM0z%UheCp4TuZ_?3l6z9vA
zlHYk98U(7-s!cbPu&L6ZobJoAKve+@_dUc|ZEqLxj8R_p_3mEd@i$p%G#-=jdkv+6
z-F#r7%=4_$AZ)7Hu^OoafvG7S+^1vJNTFjwSjVi(l^uVEc)Hs|h5Jydp(p1#w9w`}
zKxYYc*Xs39g$}>}DQw<97g#x$uss2T=Wxg7aOKpX#o%?5k9g}o3+j|!Usk<83}2y{
zX#imw8v=Y7M!!h1wT)xL7bY$$px9e<X=7i=!cG6$m!oi(A}7_kbPO$lpO&r!aI0~E
zMwW#w`e%Pd+bEh`X}*Sg&*t#_V9+1-kC*^<wA)*EK4vS0GqRF<`5ua7Tyt_M^e6Ug
zN{9NdX36S(CeX|0*K&B5fvQS36>icw#9ZHQ-{YJ^mqa1vd&)05)xBely<c{P?F>_)
zM;>4Y!hLZ;xEi5(coPiXJ6hP+zq1#jKXE>|kWPPG^+thC01q~Z6}0w1m*aJi26&I6
z@mJ(t^wC8oRc|Ol{HA7k!HN%pSSGKtG!5;R)%DiE>nw|n!Kw`i9w0uXzk(n}x=Xm<
zE?~Cm4+5Sw&C87H7IU_&Xk%uyQQ6ka9e6o{(5D($R1fv|uJ9l$@nP$a6&~;Pj^Yx^
zZ&`nq!TXguqtM4{QIwS$jH3Ol&p56zT*rCn0ftN4{2arj5o{i8yt2{HGGK5!+I!gH
zVv`R%*n{r>?H{Pj<_|YwyWKj&ei)9tA^_MQgWm1~&RjKEYs%F{04xp=`T;{ZalP4a
zBy?oMsg9vo^{GbQ{6VB1j?}64S=$ec<f4Cv^CP`0KgSGI`!#1!MO3yQG22&$;2S)V
zey6Pm&#zUf&L3m11gBKAOCGcbFBX3;;1v$YW+Wc4RSL$3Y*wGj>k^o1iWU2*t!S~I
zVwVD^t4fNP@E|M8*!ELP<^~p>aOf4gsRoH^cK6lWEpXX+c;o+Sb<KL!uY}Z}=*@qn
zEntLS|KRl83fD!%tWt*!f5)QJO~Z(WhtT47+x!j0!mnxs0&Xij<g@&Bkj$=@*V5pq
zf=LksD6Vf&6d8s<Bo{NCT0s=*fQ6m<EXRdIsss#=WfGc9SMcFzJl$*zATr#gh-SpY
zcrPO+Eic&uCgbSh4%3WH!8ugL@=kx35k@J4D6n~yPT5xoYY;&!uTEq0X;r_DeU)8W
zdnuMKLm*^9FddTN72<nsHp>cGLn^clb4~Oeds1(w29CH@tRYyXvAA$aAUNU!rv;<{
z1h|Qry7fm5@y?FO0N8dR;_k6pi@cvLL~mfHU%v6gounOl8%-b0S6?v}IH7;Xi!tEy
zAkD~#)fa(JK+sRXfTR`mY!gX_Z5Qr~jwXgl9DrVEd(a==oemGX;16~L_hjG8y!2iH
z<U1*VFmj8%Z@tFIYka)H*xwcbhLG#=Ec!2uN}ewlae8$PrqJ2c7ao2`pM?@=p^hN9
z9TPFw=R=Gf4zcRoP<4Whe{+Anzu!|il}~&Bao#`e9Ws{p3}8aC&(jt=)G_Uqi~Q8Q
z(i2L3TZA<C56m}|Z8DJNW(}A(0f`{CJQ+O=x~^JX*tUtmBSAh>8kU`Q+NnnBjK(}<
zues?G6?21}=gAM(i^CXlzRbXt=g%!KiR33S{1>ALndk9(m~Wu*Asm0fBc47W=7|hQ
za$Sz#J57QTX7=QOznfkawca#|fVmianTr8dkV`;}gz!IgVoVjJ3m~aC<wLPIgtr21
zRa#&V!mfw34&v6r($9{men1(?3f%cvu&Qp@4o^YiqI<Cw2%UOd1y(WG1MAIK%u`q+
z{l-!}C`&=|Ca=v=*eieJVJHIK2!5hJy{f=Z^bfml{b#ttPN)WLcETDe5lX`txAl6N
zPNc~DgBZr3e*jYE-sz#p2sAuA-s|u88N<{2`v5hT;8WvijA-$BQ@f|V?tsm*fA;Uk
zeW6$7=_^FgOoJ>vX6pdrE6AuA@!W+!#6zz@KB72}`q4Op=zM=4XW4CZ3;9FXu{w|Q
z96pvT-p<Z^63>z@q`O*n43~&6!<vO~mvCkZ5&k%wnYEf<58tJ-wtLtv9JENMUYF^@
zN?xAJKBTI$Tv+dmb6f#*lnj?hHUHJ~Tb1yykel)>s9sbFhcC@b@fl%4#Hwr)kCj#y
zaRth-FYr&PhoyfNbOr19vdobXCQ#<FTPWa;=_<^~yy@sw=e5FoR0AIkGFQdx8dS@b
za#Hfy84CAcbdY**BLJgQo!5a8M3Z3UYr1hONU1l5Pq%Eb-18aQkw|q$T~X^y-kk#u
z&1|)%U;Bdq#l3F(^1unrr~-%z=+bpE`iOKUTP#*{4Eldu5Y?s9#*$O6JV_7nafhXL
zlZVK7Cb7=m!Ps+aAjn9kBnEeQ^th~w5_93782|(sS#@%<$y-&yEmc^(8c{DE2p&;o
zXoO*Kwhj#V%+JKkC6udg3^857QB~J<xEvURf$w!Sokuvv8Y^k&L_FUey-B6mOI{Y#
z!#?O{!%Kf>Lb3YlxzWtXcK0m}NBc0G;lZGxZICY({Cn<+P3S2-$KZ{Hg-yl*YpI~e
zoXM?J6q!?9vhc>x?LrqLAn|eFcw2q`#?E*qn^xtXV=uAkGOfOP5CB*y6Wgdd3$RA6
zXHiDm5O0o3$4!dz4sILFSxH2>s(b&00klTMsn35*07Rr^Yf;LGLtd9U7)ijf3zF%^
zW{JsKI^6LCkr)rh<fk#XTHgrGAB)g<vDu<A`NI+!NZBQ$mUFkRRJ(J@fq?r~8dB91
zk|{dypVMC)N)<hcQjdb+A?cPf0ja>kk#y*A)%2CJCgSSVxwd&2?nJ?>4)yTRv73*F
zw!VK3<LDRA0yCmHmJZVbv#^PU!E0BsuxfC6ixmuu?8D$_6s*=Eqz^tCT}Dp$4@n@o
z?aIS4Vt-8LOWqh&p<!J8kM{&$D+S}17@v=TAqc*9`c*{0Lbn)vRcjKAKOotv!QTmx
zd_7c)-zR?-De~(gUSVtZs@ftmlcI)A#ruDXnC!d<xwX(^U+dDso_hJRlfdM)+zD!l
z<VCWw=WH+~=Cvf@Qt>xT%dOencOC3W+oDw6i0^V2t&Q3bb%YY!H;+lNjcWtVog*2v
zr-L;ixBcLt+x`k+xBVc%JEP5>=g9&ck?sjUk*!rWR~=S$0h2<uRW=1Ra6L@Y{aSyp
z2;9h^^5b~G6(EH`@s(5%qW3mZp8{@7<|U3bOB@oNVc@Ez!Zxv^?0&wP2BO*<b*hE9
zx3&}wc+bHZ%GgK2=u0KX+o&1wzIwR(umE-#&+p5|kPQbHqV={LzZMmHq}s-FuY|#M
z(x621TAL127k^G>?tT;oX2`QE7qWj*1*YAQ^H~r2-ba%#)r2^6QFeKmCri%<o-}@a
zm?%!k9Q=LElZtX*Q}hvY!YTODURQ^_x2r!C_<b|@J=dUr^uBx0-|G%~_t^q<5~WlZ
zD0E5lx{s{OrkGek0hn>&LF5$;AMVz!`2NiX<Y&T#+!bjkbQKgiv>twwenWqdbrHl1
z&94qi)+8ekQbF);SsjYbmr=+hXN%FhEMJ~v;6~;p`Qx1M$sXcvd_Q3SPLA($4p<|C
zS4Iy6pP;!lk;t<7^Fs1o#>f7(vB7NtHw?>2M8mCz9lEVSwjN8FFGhunZ+v$aU*OnY
zzI1V{E?yWtA)=VgelEOlVR(OEyzs1w3Fa_V9aye`7hthUtW~QYEvB<Yy{uw}b*;y;
zb{$Y!6S0O@2PPQubT7GF#8+_VQ;UwGiMCNwI-1hUJ*x<WpiMr3)2R5Xlq#yrIawhH
zV&7yQ>)ipKc|04XmGR!^`3N9}I*ZjT0&1|D&$9(Yj)^B%*&<zDPji1&-fG%PY~Mk3
zi>TCWfg2#}_vHBaK)L}Q^pASo(_#1E?eS@U@b1tJ+Nig0@AUNebhyvzfgc^{P1pjT
z^^OLC4IQ*r7SJRqafv=DxNeXKmz3L_lY1Nwjj1O1_h#eTC>R_eASe7ADu(9zRWs*}
z%23W7di9NsXd{Lp7g~RGh}tRq)Z8?(_uc3;vt$|cFz>hXPvU$H{a;`mj9Mj&0v#V_
zH^N51)Cj`2fSz5n%H2F<v0CH-YSkviYLRqf&<?iG){Bg!`f|94^gnws{PTUNrC_bE
zyAW^E*_c{%-Cs{+nEBOH$zI4nA|aHv274c_!kIYL13hai<1T-7YTgH`_rI8<Ty*SZ
z8GYdQ$bm-{n2`Ie%Jyel7XQT6Qt`RfT_<7=bpKT%_F?saoC=5T0vMBl-WS4j&KBMa
zlb^NGo;3Xhu|8mzw>Hk#TaFqSUw=&kNH5l@KF+&wpsKi>e1WKavJ=(x7js8*0>+t^
z3)TlgVf_Y_U|4@<H@Ee=f}(;;I{l;mpx-^{|6gwNw%_d^^!8{l4A#D{1I*vUL#~LR
zbmwPaDR=g+yT^Wr_%hwSJtjS!k@zc*toSRB2vW+(Q@l666T9Q_BFUZLIRvuMT=W>n
z1`%aqX;F_MTPhDvhA>6#Yb1gK31dJ8CLu|Rwmj8uV_tuMl_z5(^=d7Ehjbfc2i5VI
zEsWSkO$R+iund#bpLZhOz1l7vv3azSDXZSxBn#<_zSJ=T!nL$foq+)&<`Xe6_3wJC
zVlZ@x-Huop5x(TLXNRykZ+D`?fNvd*hZT*D;i+eEtZGy?I(9)4^qi2W;WIwwNP8~>
zWC6zSI+1_)mIxIe+a9<_<tRI3o8;B(l;NpAXro{in`OFz3N4lq3o1KZVCe^o$ydqT
zna?DA3aVipR&v{br`QY@LF`8gXWPMJdZ2N<0sh1w<Q#uGMo~PPd=n!P!88?z8OgX{
z#~2grhzIp2=cIo~@HqJC$PK0`_OmuYAHv(xHh+J!XXC=gKNtoh)>o7-lX)KHtI;S)
z7#?(-ax%D`H;T7i7#?F1t*zJnSt^Lg`e^#X9hN_xM6nNK)ug(iL!q*{JbgR?`~x>V
zx<+6yK67&Ul<y~a%soZFlpN)>Xq9u?h~P=|(e!*K*j?cmcE(#8OO}8dqf)u>{oQ9$
zVHSV(4DKIoi+A}WBZ=KfdNqUN{40~Ghy*=NXKIvxD3Ocx*UwL~+wCTuLhG9}_Dvcq
z*ofamvu~o=A4D|Ujyq9*Hkz!)CY4rYWaph&eu_9RcG&%U)BV^sTKOgiev<<Qh`-5!
z-{in=a^N>P@S7a?uyP<fYhyS=gV$;$b}WAcQG6xU85kBFO~VyGE2yjk<n9HM!)hHt
zX#SJ#VD}xo@V6x;Isv7?%(tnXR%{Yp50TQW=KTQfyJ>zPh*!OX{{2^`o~*6q=GdlR
zUgrxk;pmCmrjV*%I!>nmH{73v;+wUcN^~pO%tAVeKDUG)eG~D2FA+Z=uKy2~wWEI$
zVY`$8FK37;Rrb@fViwsQq&ZM?(H(B=E8!H%kNm<k0aeXsy!LqajLajJ--*g&Sus6m
zu7SG74tkhw0xWA74~7O8YaoFfEP-3;fGbE3<&wjObL#$9n+K{GweE|hNE2PihQHWd
zf}I_z(0Yqo3Wl!>oNQLfCnhs5JGX!7n2}q|SM}?!ntq3hUniJ9taABrGOyJ9G@TzL
zH_0TgP&S6_@dxo;vdHhx3>C6(HDdyb6g&^7ZpY^C$pP?`N|hM^@7}TMRXG1?BByW?
zC&Ktm<FnO;CLZ7h7v<s&{%~`^sq}8I-1Kh8Cj<8TAo^Psr6aE?tL#*-!d-v9ES+}^
zHT2hgc@PRHDbV~gULAam>iHVsCE-y(T1PwYX7YMa-8<b^536dgl&Fp9+<8#fuUF+x
zjn_RI_rBv)KwI=G+yfBukLinQ-U~7Cn_B%3s#X`re@MbyE2keHZCT1l0_Xed)IY~G
z%BS%86zU-v=YjR<j%;KqTD^bFp7c7ZrLyf)*RYT-9Saqz(w)4aijlk*puZwL`tP$M
zwPZ{sN*c0!iG))wM{Qd{9KH#p52q{spCTw$(i0ajjipRnB`tB7t@}Nc#1DP+-BU%p
z*2z_cfKfMB4*`||b!+RDIl6pNwQ^0pks9PfDwPY-CS4C{{-_$|_vwFPxr!$k&ZkL_
z<7rGkg^y)Vx)WN_#8A63E$P8oJ9~*y+_|})(}M@^gI_aJ^df+d?(`o!WgVoH>PlmV
zI>3-Ig1HB2+BSF~+z?HNA%|d}ROZyVRN6F^h%eoffdtd3Ftkk{e7*Da2?h70odzBj
z;?Ru;XBY_R>+<~<q)&f7gs6lReAzsJrCV6Ndu2=m2#}}d3m^dR;+rH|W^7x|@1o^(
z5{*<Nx7W!m8uM{8e!k;d_YF_)Z4-uJ((xwCCf{wlYu3*xn0nLs^3K0za-;j!jO^T!
zwF_-w&oC<QVJV0itI*H+Tw2lJU<`xP^Io(Af9-b<&U!VX&x?O?S=yP(AhIcGK;m-w
z1j@tts{05yEflzXD_$Q;npG=?YAdvWAxKqTMRWOzb8c+9Gp!>#n*&YiE~b5|`mb7p
zM{5BxRF!(2Ygi-LuR&txoZ(*&6UdouWzeKryejBnf&6}ZTP>WCeJZjvrefk%x4IZ1
zuy8dHVvWW0@b-T-InKJ|ws1*c!nIFFb3G7d6&P4Q;CClUyeQ`xKJWSC3}Q{Xh3zye
zBi)&YYO1U-U-pdQ(UwfwQIHB}O*j`#cukP|a{<w*)z7J;Pc!TUqFSc;G9Be>EQ+pd
zlkrek&kB?otJXZ2t*NYkG81s<h@TZVdpsGfCYH2zFYtfvCCfOSB;(&1%q0_Bmz>B}
z-C3HTFT5MAvM_H}>11q=JwID6m^4zGL2?sB*=sT<&9}99G8WT3jOXhu7;U$3-2&j3
z7Z@H9ZnKi~7t%1j(Bxo&rt%Ej$s)=xnx0l$K3u>mbX5qj1T;{#X|qOKQoCWm;}!JJ
zIVS!F;+%i``iCYU6f{!Omi%>)%&wN#s4T0VkMZ-N6rCDjq=FdmpiESe=73LJ%(EJH
zw9VOQ21@Sh-ronk(<A7ycX)jI)9}as(RbTb<sFqh?8kKW-S)e9Hl84l`;ga!k=TUS
zgLrY3EKe5MD9LmA+TQ+r3^h}JiAwb(2i*ojpF)3t+|b&i)_t)hKobzq-vk#TvI=>r
zur4x$GAHM64*I*p{t;_$zq{MBn&=;%9P|!*M+3Y)Yc!s2ZZ`gN4(jv&TBW0p!+aSp
zmeGH}-x2=ZX#8iMpn{y17|s{jKiKOb6NOgu=!E}@@E6;|s929Uazq*(M%gsUqjVNs
zW{ZDmlwC$~^f+H$Y~{<lN%A;?8|O(9T_-V+uuDdRI*lK%*+0=;wu(lq#rbM7K@C?j
zTc(SIEyg^{(<Sthbgnv4oJVidWi-vkt4Y#^lB`e)`n5cZcBk>jB+5sNbiRz(_;1p2
zGHy4Z?Qu5yKg(#ABxBH{T>wRlSUaq_n9YA_9xvdcaFSjuV%C$GdZ+P|7*#wT<7lJD
zHy?-7WI99)=v+UJ#%z$I<>U@pW&JE<-H4$97?Mp{C+vTyyBizRnL!w7Su2ByL^=C&
zlwePJr_p$PM#07U%90#rF-_Qzme=tzN^X+H-SQd;7J~tViH_45n<86)-KV=xp0Iyo
zaWsLsrI-b1k}~kXXc)re2!{lUj^Z4Wd$B(!tafxMuS+7fpwP%Nna+WgU}Ng@-gDl4
z%HAg`v^5OjVg=Yg=C_ZS!s0R>VJER%e1s!F2Npw)g27@Dk0A2^HwK+EK=Ccb#xRXX
zi;VSs8R?ZAXD|_-iEwh)h99@-WFmiaIkOJgTs|_GCW}S30B8;}tI|%RvGpevf5BN<
z94BihiAUGb?#T&%af=8C<G77yxPB`JJV021Jg9&jT&J)Lu;tuX1l$vBoUE%0xDRJP
zjmkJ8296k!Dr3u`x*jK&xI7sf;Vl3O;liND_8JU9cZp+QOO?#x3x-O3bKrk!%;E`e
zC&ke)u>2?BW#dnxaSs9cQyPF!<3AZ1VQoZ<_zo5_j;^wdA>cTP5$X92yt2*Iv-!u0
zu}f^^eBkrdf^7`8p>dNxW+w+)+I2?r`D0i+C?j{Lf~z1SA70)dHG0bb>0H15&}QqD
zjsOEApydr!<-<z`xp8)zLn(hqdGVw8842t{3XwA^7UlC~lwPJI4(42df7}r8=1syf
zu=UI3Ce5QJZn6(Z-G>Lg?$MB)V~pl^k63?;27GwmJN<xD7oE4G4~%g*KkE%o4!VQ=
z<I_WaI1GPyCkk?M%MN=O;uIjqN7G<^PbCH*F^E3M_4>eZO9QS`x=equS}01Q%U9|8
zal3&80k`0V1P&)eE@@+L^CfE^2FMUj_9aQFv)*}hyGWOeXdzvD@&tT-meDn%-Md@t
zz?rk1b%A?Tked#xzslR{Opyo-L<e@Ov(=$lN$dcjc?Xy5C~8<F4(Zwlcb9w+n-SNB
z0RV;t95x&<IAX@Z;NO3p#u*^jC4=`0F6<Zx*!Sn(M=@JL@S?;~3hV4~C)zg)Za>on
zGt7&_CUM6vf#Ms+)We1seMpRCHQ9+i8^;T_{jhnMr-ZI-j?ejQaG;Kn1q0#fV9;+%
z&?KKm$(&O$sHOZq8vzaisZ2ac|C__EZ~R0#0FtJ`5cSqJPYi$H8rZopW%F79p7MRr
z=F5;>;6Zzh3>UP)_T8Thp0nM^my6Yi1CVWh#u!}S>B6Y-G+7GZ@OI=$#J9rO*Brg&
z1~BrY1u-TUTqCP^xyYvE4CUw92gzf9h?aNr1W_Dz!y@OL0-OQU7<LPv6z(Q^K+0jU
z&G0A6fa9iy!;*i|An=ZWhAg;?BStV(iWnTv!~v79Mhckub+%%h5$SLa6jojneBdmR
zC?%){uu*ubUNNY0mU1<3NAcy-sEWSAqSZD|TF|X{cE=V6%1DP0&C62|Ok+6NfQE@p
zCT=|w)e`9}&Glyn?XELGdHM@bB?7mguWPt%Wo`9muy21@Ye1kso?PGMj5bb04{h2T
zhaR5Z`#=Ke3X!W2g^f6UxWlCenWB8NMJTed)~Xx6c9MnoFn2~aR)3{(4!C6%U1_|_
zZsEM(L{hA0Izz6V@FU_F6`*0|b3mvuGOb8TFYZ7h01xzrf6hBQ{8aAF)Ayn}%$>K3
zHitQGlW~7K#zr~I($MV&V7aq{9u5qR;dr@Cb8e6p-QrAOXc@qW(pfQ!=bdM4%Pxe4
z+$<xbV1zSab4nP0g@+#3lOUJGSov}i$7H1m6q;QP`K*T$WM}e&1xro^Mc%F41@tW<
zBpY%Y2LwX@Ezog!?4^@*d8b%o%938ES8(o%rrLj+xmjkug^n+>6-X)_e)fVy6)kVG
zE%2>~1S`(q@bcpI8N7ME6YcUNE?TD3r1SFW#p~z|?BmOrQ8~UA;t<R^q*4A6GZkzT
zA7s94So6NjRx{)sI5iWzgon=)Vu;{yb^5Z4JCm#K3r>jr@A!vy<O+lgr5PDQNs8=^
z)C7O4m=Dg4(K7ZGaSXXdhBC>*UO%9C>Qrtw1dq)*1!N-LpCA0dI7G$}o*@(A=j0rQ
z<pYvIv1^f9F%cu3GTwf+nkEazv);s$RYK+P?wdDnc6WE%LV)Q;uh=;L0U8YU0e+-2
z_`!;RCt<vFc73O@&k&FaCcqH2DLCS*I7NTmr`%uLJ3g_(oNM&_*|Y6u&z_;yLRG9J
zY)Bm3-ic0EGmU<|8^#17C#1M9L_Dz*thFKQg1E{)d8tM$mR4;fAz7ffeVJaZ7SKpE
zUZL6$$u>E3{q&n|6zq_YrZg8!)gaRcIhQc?v54~$=#GTJJ4bWVLj)IoWK<{BOW1!F
zQ9K8cd6B|_goq^s0M6Q=;yVW3gG)Y4l<A)I<vI_a54S&Xy2=Rv;t!{>)#)nZ!a3ED
zbXD_LefddFUVUmHuL1&(1c6*JNEs8V)nURr><~CEzhgW2E*JCx2nc5yHa7*m1r>t`
zxWZe>K};A)y0f_%HMyk3N4@pD!@hq!CSqp`ooTnCpNa_*mci2vm<yqBfD@0=7eY-y
zdD!2T8*TsmXct72Gr<g@^opkmkVk=k9b-O7=%61~>M{WuFz0zlbIp7c)^>b1i>JVN
zOkk>l(Z#r+l5+yJD1@^4fC^#$jdLmLOVpH<8Bm<dG?8Fu6Lkm(y2J5CLT!JK6PMz-
zvw=Tr^D=us9d!>wg`NvApK!IIF>@~Av*VCV{w9s_;@q?_W_!pte__xcEN{X@jATIh
zFj#nZNq~do^0gjVDg_6r@R{71tL$&aSzVOCMvT>F;tbmco14b27l$4S?y&D+$Unc&
zCLe!kUN4vPeCO%YE4DFK7ae~_jGz8@vikJ&hJCHIbigQ<FWfV^aB-fCl~QwqMbb?7
zpIrD?Cqc-V0tF&WYfro*EM!BSCh>|v4#)vY=&)(E=1u^ca-MQ=ko7^ejyj=$V8ABe
z+$G3lg5j59697sx&%Ao$7WL{Q86b+vGtpC5cxg+n5V;%V23a%dLJofeIZeu!(^G+a
z8#9b4Vb&Y=#3SSR6+4Hrjjh7x*W%BCr@@Y<AKsk~l{Run?unrHKjD3n9sLTb?Dh8g
z>}79{I#a*t4`h=UjGhm<^tx?KDBL8vU-P@5ZQ9gShwJ>lVpE4*xC}b#9_{wN4>a}X
z`c3^=Hr4z4K+J7;u^NA0F+QTSDX1dux!#=bz3mMQV4;KlkR$If=Aq8QZ3Ux`Sz}|k
z2<eCKYK-mVv=7OMf0C_r5BKD-Mj5aHv!!S~*cwz3L)$%m*E{VU>6z;(1HuC>mSeqz
z+r;9P@ZJ|<n~k104UzRga*kT9if6T#I}Z@y=$TO}M2Ms31)P6-qtk(%@6g`p#`?_z
zdRT8e-UF4D-SB=0)He@URoi_1q7mSXHRny<@zHv|bT~ES1_af1hQA$$9Y+HLi@Ek!
zHB~|&(it!OmBzC0xS)_!D6wMl&%hAu<p!XeuPlITFtb&3^<o>IUfPj<3;twGn(T2s
zr%?AH?m?W0rBHu@j@yFMW``Y+vSqf@(4HT<H`=V0J*#pH$dnDayb+;_N{fqJKAZ~~
zMN1ou5T;zC?=MRjg5~uhTU}jyu1Uqsti1XV*F?^p6}fid>SxiOR*cUXJH`3$KlwKW
zXo`|MeYwKuPo4{nlvG0TyY1T<@mE1<HOrTlt`{fR{NR7JpZd^hH_QgS>SEpmxm#lL
zhBWx*h6<n%z4@qp?Vw@S8jezMx*xPjiMZ2YQr0wMAj2iixf*23p$YtwFk;D*WGDLn
zEs{%f?SgkB?8w6#G0K9Rig#o}jmD3l&@i-6@~%!q+GE2(cSSCnqWbxR8;@4-e3n=8
z2hAP(l-Ga8orhI)*U(;zz=$o@ixsC1wb`)I)Sx~*l>_-ey_A8Ak0-3=SgokI4ZGkx
zF<joaqxoc&TlX^h1_w}|T!y6V|Ewxp_TzoI@P-!0p9>@bQc2#?M|p61zB@QS?a}!A
zl9u<6_KzcW2<U1Z9)dRd%b)-J-Cv9kJaX(SCp3R6BjsRzB;G+x)nA=5gVXNO8S+49
z;<#vp7AaP~H{^UW2fz?q96-GF?)l&tS~O!;zA(EWI7x`JSaxC$wV|ghX|woS#%UzZ
zXzggWnoQ<Plg93u<XPV1@NFuP9?&9o5dgJ+vy2I*v#W&P9wlSN?>KQh$+)d3lH3`A
z7&w1i8oIP;Jjdfi)>7B<pkzb&h4OVI@Y1_uwt`)Bdmo<l{^Oi+i+#r8{m7Wm9xguH
z%@wLLeAqiaL}t(sx(r-UQkOnrrf}Cr&KW}Qaqqy90oT8aj2mH%t}~#sjFt*g3zwJT
zIu7rkxoLnwv0!P0PC}?r3uq=gi$^Pcy*_`sj^{8MNlLG?473fBYlhz2{F8XY7GjPn
zvWBp6^Hqs<#Y;MiM&rbkqPhGk^mszGdJ{95Vg;(+DU<ND1&?TlouKm^aIpa`=AGzW
zGMS6p4%y`>TP&nK7#!rFrKiBWln0QsH)+VD0d!(;KPyzp9}`nCZJ2gM(ozjh-E@Bm
z8oo<L%i&&*%IU=FsFcd1c2QiK;}t7vY?VbET)1$sux3}2WeNfb!=>wN41zw~t@1sC
zhCcG}x`Y4~bo%Uf@`)qgG)dSNMp!IJJU!f9a5%{6Nug#3ErnSF{4j@TZGC8sA=?{8
zghVinU`afOM8QC*W~)P{BWEIyD0Y7kFOn;v@;CVsKm^dEFit8PrNn@Q?LruovM}P&
z4YGwnPweT!=uCEo4J<+f9M(0ohZv!Xi^$##`LZbk<X9Z0t9*qDDfl+i@zR{ePguJ-
zJH2UpxaiWZ5;0e)mlO(6W{fRrHWN`%__c{JKVtK`TurcroY5e-NM>-yjjVqmEtvtl
z;G*mfnDijTlr@2OVKiF-{iMp!La<Y4s)X@UkX>ejm|XfH?}d-TGJ!bGSHb=ubb<bf
z8PW@P+DVS+?1b&+joV>b&?KFc-gLpWX|N*V-pAk6w!f`yKYDw(ObPb34PpUbVbsBz
z=g62$Swrj$zZT~z8iUQa?|Oe2#Z7)vZeD|<M3BC`cs(E&2T7c#i7=+2D1RF(VT2OQ
zM{r{(m}{=k{;mUa{JzsRuEn(uopJBUf_0%(D{!P~LY6o5?K3|V8S+~kdel@C{ZN=b
zt=am}Y6xq!oZk@Yg8*iNrwwu?jM<^&6d-z$C@r$0s<E)DHVG?lO<#YQ3Cs5nDiYH^
z<2-=(1^fGx)7}|lS3Yza>JXSDur*6h61<OvKm-$hD#?r4|4x{^N^FYRT<G|aV-Yk`
zK$T1t>#+sJ%msj7Kx?nAc{YOtqsjt}=@9wL#~TbeTg(H6qEVK_B!M}60C%!$V}NPS
z&opJv8)D0Mc6c`&)yRLLj@PMp9w)Qa6y+L@4&1O3=Ez0(9Itp8#BUO|c>upNz+7ll
zV8dAoS{Zr0{hei5j26;qZtM-QFaG3}2;eJQGpNSz9T;9|soi8<6vtxRc`(o$CIhxL
zg`_a6S&A1AVz(HEqyk+KZjI%FVF_+1z9U9>W-^u%7KJScd#Qg&yy8w5Fju^r=T;S$
z!0~dsf3ssnk{aAhoUfI>vjIT>FNbv^23U7cWxxd(>pX!SJLeZ?6i$Hb4cJsl>wJ8|
zq`se|-WWLj17PMq2-f;C&iPR`0@aSRW_f#ZE*OljOoTl@>Z8%}HyPHJ7X|CWV<;zp
zuz-^D)lykNX=Z<ah6~)}E8LO@1g5v}8dPTTWrIy6zsr}&RG3zcQ^ut;`Wjs=;yL59
zn7{%?Vz`rV2xwjkb>RS$?k>g|-0)KYp!)jqMM<Z@av-F3jC1vaxBTXZ=vMjtNQxk(
zYOVd@^W`2q$b2ee7D1H>DMh8C*fA*h?tC#JTo}zELAZYg5s<PFV44N`QM^*+n6OC3
zwm_ZCa<og~cI`f5fnC4vpY<U$1Q3fxo~acC(1G!uNpa!wJHCQdD4?xyM-E~%+$-}N
zBt=CV+#nr&q&SuWtR)rZh7q!9Eh(}&-hkB1D579T44Z0T!|-6kag>lwY2WvO&R$ps
z;469O_Mv|P=Ie0yi}&5#cfGw2Q4?4TfB<81;?Xq-3*bzUYzf(Q+~U4SP?3^jQj>4B
z=(Ky-Dk8iB)Nj_KzfNt747=Y$)L0SPv(w!YLMs~WTJ+X_T}F1D@}3K@8rzT3abwyx
zIj8+rpz00?^}8;i@kTMLNCCxHDlW16kf~GR@i>3I#1mi{eN4gkj(wAqKj(@tq56vc
z6SP|h@ZmgOg7hKGl7as11e9M~3m}-uAjJiKdXikl6Uq4@AB8$oO0Yi8vfI3&OhEJz
zb&)6&M{Z-w&K6->QuVrl-zv3%bS>fb=r&sj3p#yO4J2X5BMLflU`SzODS)D6Ia2mD
zN_2l+#J6Vti6T8qTc73<bg1Fvatk=vNc-*vp<aFsTH`+%u}K=oDF2gXYr5;k7=q#P
z(ZNq2+MY$-RUaGvkL*-t4S4Im<)3#0pP@G7tph0(WUwVrYJK~N2K=yaIk3_oC&j2d
zm4sjEAuJiB5jJ7x-baWM(Bl~HaF7KkmEV7)OT$ndtwT<Jgh0);Ui#d{k6MIP;$4Q_
z^0)}5l&5v6Qhyp2^W<puaR|_Ju&5dmmThpwAk{Pj^e*5E3q6WZKKvjvqMV=)>+%lk
ze&|H>*l&acEguswho#DwTzV300P7l=sU~=hE*sL_#yo>t1g;D#goz?DX{xL`oaujo
z%@5{w!?cJ4BC0NG>I()Y-0@H><DY1Cb1e$$D-$0j<oJu>B<)_RAB&o`<Ti1h;)mUn
z6WPVrBlmPo<$ex(Hcw_!6mb+$Vn6cxyqw=psl{mUZ*Zr^zH##c@NR6pNACu0p-`fA
zNvSO?+;1`ZwB&L`jIHBo9HtiS23~(Uqsc2esz;C60hEp&GqEgLEqGL&Rw<=QKFufT
zC|%N*dDIhcO=Y4yuF@G0sHG_{<gRI`&m#2Y#cO$LH5?h#Xik}o5C<YqkZK9Bl8$St
zj^Q_qY;_{8po@Wsv6am~O6L>wsJ}qP5~D6UoPet}5&S>i5v4qc>aB?2U|xSfHZ)>(
zqBEfB3>Mr8=2@FxL2>Vd^ZwD`yKT06{?1N5*|)qNon>(Owp^rw6Io{NT@_pAlSu**
z6W|!<14PX-hYk!Ae0{OY*jN1wPt!Z|z7EJV;EeE#XJT!eIG|Ilr%$COZ%W2+l{@8j
z{$fehjk)XDna(J)5^cAm0+N5cVmpYzO`@sdwHP_uUQ3l@A`AQcd=<TXX*d5h(Kh4i
zQ(Y*iD|A>xw&jvf+#U+41>I$^p*q&Sb}o`b`+Kxnp!DF`=RCZLTzS6mc(DcpV9?03
z8F6@{E`qTa#XNWVTmb`f=N9H#&udf^Ofc&Ym^lfE5hJ$X*-T494@iIKs69E}$1Ra*
z{9s}SchC_2=iE;OG~zfY+%-xrfBG~6i$8^}Vi2~3z_Iqh^^XPE{jVm+@4$c<qKTm!
zwuVK=2{%|%#?M(c$)jCv#3n$E?;4KegY4wUDcM$MGdewiP{Vm+Z8*^|_+l;DFj?^?
zQ857+6Uk0AB`F{(f%$(S)MB&YXBo25Rm>2u+4O3bVK{_Cle>@}5e<2^N_kcZ-gr1d
zqCfLy0JV)D6E$UeYYp(>;Vhsc=dCYS3l#W-M=%%JQB?OVLn$ZVb3n)=m12*MrqMXm
zcdWED-sR-U;szM@74k3>2t~!{<OHIT!7h?M9>UsD9+EOhfw+IkBz{8CK<L|4JOW{H
zq6|)Mud@kptW{#vk_X@UuN7Xx>X1qT!T6ZWPzIO$PMMM!eNZDef+rT-#(-Lo9m_Xx
zs^{5crA#Sc<|2LMjKmFKbao~!n$S<qxr#+@0ufzV7mDjrZc+*W#iaMov_~}DYQgG6
zkH?;+daR*Auu*@4gxll@O#@>pLkec?Xri46(1J^;XVeiycv_)j7IfV=I)EXb2mp|r
zyK;fWX!N60|De862<)_8&he@v%l=&8Me|D&^;0(=haayO-V!b1`@@<R9!re~_h*XM
zo9GFTi{YP0u9<bb-_sYG^5l{lD>Y_nDtO5wZ(XEUCUSpX!p4rqD+D9Zv1Eo9%7#r3
z*dxH<Mj8}+YQlpy$pwcfLI6;al`z*9YNql|QZ(@s!&E&6Z9Xsdm>8uAZZ(Ut3p`L`
zycv=@`(@_r_jZGCIBqfym+P_E`3%tDMGT5?ZdZ#Ta9C@2$=Ns*V@tKvCGK36>6=AL
zJX(7u?RkGMJ)L_D+z*VgRSLilHy_yur0$IyZJ*Dk<dsko<?LKg%dX=S>5V8{Wv4n!
z8!<R0bHE!`Z5`6a%LIO5Zre~@B%^r6<E3d<InDDG<CP`ca65r+%w7?JYRXs&oY#@G
zz*P(=X1BDpheQw*jG!QqfFw<lVXb7@ahm@F@Iil=q%j$cEG3_b5CXSGkVyum07XSE
zq$9ett>9N~8L(V{J6m~t$$<MtLjZu*miXxe0~D5GIRVsVJOX`Rnt&@cDnf0;BZ9B6
z4a@_=bZB?)0J(DSE3&->dx2c~N74u^?&+tZ+|1_~0_9fUp$058G8s28sPRXoA=fW+
z$&r7TH}uX*=_;5kq{Q4-0wV*F5kdqWpcK|^oTc)SGvK>uNdTZZ1uDKn00C4%j_xSu
zWYWnYq&^{T{}6zdy83%8cQ9GXI9|q*M4?iX&`T5i+?WRt8#P3;l<P{UX&P%#@a>si
zbg)Nb+r@PEoq{|E7^!GC2T=lX2jWG_iZp-IOU^C};higAA)srr0JD@FrJ&Iq=(r3Q
zgtT#gvdXUyv9vH9i)U8}6Oy1sg<o5s9I#e~T#ri4EU2x>X6KaaGLbq6N$td4z8Dab
zPqTCks+~oeBdZyYfB~5;aq=k`kdId*VsQ;q%o{u!0z@Cku(>&(#e25m*&_cr{Uv{T
z@+!Ld&}y63q8t|?C{JdHky33W<PJl>tRzA%NHBciQ7S|#Y92lo<Si!Oncq}E3;q)#
z88i8f`!IUVZA_oQIu<v?nM&OD!avz%(;QLDF8lyjzlivLZ$@871@dmO<Kvq5zHGi;
zMNg@Y$8`-f-mnt#Jyr5F!n>Qc?_z(3u!Y6!tp2q#R7gm*L`VxxiaBEf^V<?+%03e;
zx+P311d-s*{`w-$y~>0x^>hZAG93?-TKTW0wvvmm2rh}2>m2l|E^3=aeT=80lumk{
zc->2QKD^mASU%xxh}V&^^Z>$3J4LNYG*%vpg@-(J0=y{h(BUs^#w<_aMLd5?xHZd`
zng_}tVNS|&lYoA-0RR=^tqvI1#zs5=3nm6B#sDCS-~lb8%oebfTucNk;GC-pUCF}+
z3QaW$`Nid5JgP)+Kq?Tmk*K0Xt{ogq;gItbUfl>+4$Y;=WiGE;jE;0=-ysUTcigIg
zGY-<TONT-l?>sC`_c|bpuZn*jnf2vYgFcx>$Oq98o0*AtV}7ebmGnNFQwAEIVTCgY
zFm|MZ8lHqig$BWhm#)r85<keB`dxs!37Y190=j1H(F(&bh#^YmVn+!Vy7&%}CuUf@
zK-(*-r$S3_4$=uE6Q+SdQF>z>3j@~6^tB{c%25QRK2{0TMeNY*AHshbcF_Il_<S(j
z>zxeVu_L>8wA()zb_WB-KtNpA;ql3U6+FNd(_y8-pOlAEx=6tO1vE;R>INv|@oJH`
z6=u7_WH-W?jc<ELy;IgEt95ePQ;Cjyd*prw!+*Ven!ZNP>>8GckqXI)(H%^;uAe5z
zD>p@cxThLM`v%DHO9y|BeL2EkSmJ5VjU?ySX(*P0jjAv@1?%ZlUreIbuFr_gglGjB
zr3QWw1q-A~LKO{Ed?n&&3zN-EgtSDX*Gm!kkNdSWXi!usD=J4!!^PS<$*6V1kR!W{
z=W*gOd=Ogh#t%s{7p^+$rqpLB!B+YznI#JZ&hZagSHnSIM)ZGL&A5@K4D!eKI@}JR
zj3O?27<@bavsE0N@kHrlEd@xt+-Y>l;eyf{E>%FP)g}a7B?;=zbQZqf71#00SOGw)
z&*8XiQ+rf?{mEC>(o&%#)*V)9C=WRuq79ma@1O*G4Ey9U0`76anemM+|D0@j^s7#_
zQQZn9z`YwU&C7qb2W9Q`4X=m_B1VRCE|s^n=d8e1*pO2ZC_tQ&#7^k&UI(T=`?%_>
zd|zGwGY6iDD*40JDqaBjOEg1gD5Kf-;Uv7ljj4q)#x)|~x;v^+<3Ut~R&9MHS{3~p
zwVf}A0-g<O;xhTfrFLt$b8W=iUeE{y8#i*3!8$oS@ZNuh$5mqI&vkaIE(wXU6BL+B
z&f&@<$78TNjK?<+7-u{L(mq_xAy6K-)D5b)z&L#<eeZYS7bD86{F+~k%mnk3sQW;D
zFCZ~PB{xa<Su@vxvE^AKPH?W7Tg_0?h)tDBq5A<ffBT>g4Q?KwV<XJChw<j79`@#D
zgfo-_f-Qe21VYpI099R^n>ck<iH8!0>k1SMGOG?=SUlzDE0{%!^G_uT;aVcoHBG>-
zRC1;F3I)nHxTa{Z&wVvxe;HxsO0pZM5m>@(Lytp*H4#1+SLuy)qlMfN_lAejQPpG{
zh^iix`3VGbDey`;OSo+NTFZr8?rSbbg~BPnbs&G&M5g;DuIf{b6)KWD`+dculQx`4
z>j#X>U*<bIGj>plm~36Pl#sFZLnl(vstxrk_ong0fu136QNhE+@+Oh$Qf?$c@8^Mq
zVS5p|ZLZ?ili@2ZLgsSqYPt{?%d#w&!TB-(=iB(;n<zJ5xXl83gc<1TnFztvBhw^$
z44Hp?9xJK^rxHZLX9T`2W6wt8MGA)6LhZz+^<8wbi%w_^!N!o;pxHg#YjdW)9UZ;z
z@AbQ_hA>5%DAaX~eUUEkGvBYSZP=um!G@J*y-O)jMkhdehMF>cfeH*LkW3DF8Itgf
zzm4R2;9DVNj=^g-<07H*k=sJ?B4;p&t^j{z{K5)ihPAZ<C0i_ISOLsbCxH%z{;*#G
zT5^h@b>bDJl@>Ups-ztHrd=Od8CwAGM4Cc+lQG+@BHqYF40=7*3%@hrGGH6b;u9W3
zKt=?Wsx%<#+WU{MEc)X&1VL1OOnB)p62b7$9MS~?8F93~&DeOSIozIuBqHp2#0`It
z(8ObCdMT4qTQ{;1rrC|SsZ$<Q;-X)=v%+Dc{aks-01=ApWVa8tu^1ZiVuge0GL*PA
z@1q#l;e^H;0touUFG@vla&S3s!&MfTvE0Ieoz2EM4^trSwIMvj<swP`Tjj^#W0iCF
zbO?3=G7pUOlLtM*@xJuu<wxg-js|};jzQ}XVCthq%ntYFVDFSs)$Br8@`%Hix2pWn
z&ITVEGB2G-PsGJ~$jY^#T!nXU3?Xy@zGg&N?w9`%?|5DTv0DZihB@HYM$+a`dC9=$
zLqlz4oyhC8ogfZxljXZ4p1;A*cs87>!5iUtc?p?vCTG2~?S}WmU_=9p&n<tvFYcCL
zwKCT+&WYt@&?Hw4iGwaD)RP1vQvNJCI$m=RiCKfDW+ll}TOHp7m8T;&5u&c<V6O|y
zPh<NNbLF;hgbj5kt=FZ;zPveQ2U;?@V~6;RC!Z5WA-Sv?Pt0ITc=g6(=UuF>&?!`~
zHMzP1^aKZZdGXp80Tu)93(J2PZP25KLAoZMWCHc5Qcr5fARr+e<KpUHnb+#ZEe7sK
z9_mXbIU5`NKA<#c=Rk)qu11uH5fbSnhe%8erxcbWdN+LN&8TtC1%`B~Jqa8Pa`6(6
z-Mrl}E;Etm2JfacXVYd3Nwyes#?GBHqt(yBgyW-7myyuZ-mttl3~qm&1>0U8Lo%c-
zPkaZPYrBDYF2z+b3YnZ8F?_s)u`iJ2PUP8PGJz2q`SU)YU9x0?)N{(qF<C?pRfQfk
zwjqj9;#$R(#7wmeJ^h&$zN6ri>Ls2{e3vi$K5SAE=ZWsyP9$hknv2jc+|&tXs0=4_
zV1GcDN>~Iq)2~GYN=bisd3r*2Wbh8?4N4j979!z<*pPBcysJMLB)Vb8dqWO0orybj
zsi9jgcz6@g<_VrjZ&7e0hox<EATuc#da({efj>E6icpbvYh5Ez55OfxAV8C%4DGqa
z1*Sw`V~>MrP%KQQc$@>Cw7{TKu*Za9!S<j35*@y23A@p&43~dGol$X=Pk}m11KCs!
z9EgYH2ar}bwBg}YTi+tLgd0@b7xK(9rtze<092l{=s)B=Pg5cIA@>N5EONLyM}wjA
z=jJmUjM}#kf-gZZ9)W7YGoPcWlfq74E7H}JhKg`rp(&)+jE$~Ae&th_mmUpe%^FbO
z{MaA7>mSkmie`U)O!|P#pi4(RljaRT3vObBJBlx(izM>KMZF+OJzg3N<S>l|a@-PD
zsLQc>#iMA6jNT`9Dlo|njU6qk9Ug9oC+_5nJVhAsNsNRRd?rjttMP_1hBrq8p*fO=
z1RL#Kq%)`o--byP0CPZ$zm<=<X(<D2)oh7Z3DVbt@c4W)p<17R0fiCHhIwtzX{(N#
zAO{OeX7oM+g$);jv?!&9BsMLN&%@Yw2=|FzbjP!Z$(?2_6X~UeM~(1Z;8H3*Zsh5;
zBiI&*%`RvrkOIB#Ly5*128_c7^gp@C5~BiOsyjZhw<YDb65r0i1b-{L+!7drM%K|*
zL+-UyWoy#X1LzxnA%P&zivtcj+|3%s;oP&!Fn=~vl+JFl$&CyW2FoDQQ7mZUi)?1H
zTT1hZcQ#yR6+Q&{D4Xk!l;VUP2WZ)#Jpz>%Q~*DZdhdIu@_kQVGRchyCvqdU&y-Z9
z2qeJ?*Z?m%>&4GoZSR?U0$z7!T5|Jb8j663W6Fxz2>ptG^NA4?zHw#f=xQ4nHBSfy
zu5BU~7E10w(vap{KE<d`Qe?&~EpR+tWeJJc-=OB*YK$^yK(s5jR><{4WFwl!C+wHu
zo0-lqll(3it2A;RSy!Jt&$xPA>vjZtpde;S_flOjx=u#O8c<u6#--qPlp03sZb;bc
zG)7z{L9fMsn<nhlNjz^g8b=HQ(wRaNgziZ{kD3CbfeP)R5!H8l(ev$A8z=NJ*Q#iF
zt;>F~A;7L}qY@Q%V1_aKRx=T^9LJyspw*+Aka9k$fntTWixJ@2Vyh-^XVJD(@zc`i
ziy<T*z8>@Qc62;XW^WI;A*qlgMTksb(ID&uDB7fdH!2rpQk@7B1wtNnHeLy~(&r}%
zkv)W+G#FD}@(XV6(j(|FmstV*_!S0^z6uA&RVI}0O5=l~(3G)CfFR<m$aNS~L6k&h
zG{Jr`xpl@VndlI`xN~meO2?Qdyr|UUi#0(&!fmr6L>R+URM5v=)=<_`^NC0(E1`$t
zIA<Y$M08OSpirv_NO0ulZ8~0Fx0zIzUR^IS7vmJtuP;X(II$l6T!6*DG&`NASC^lj
zcEzX8e0Iff`wWb$^AQuW7HMX<T5!IKkyXCX^m0Y;d$?}GfJ5H5pxMC8EG-oZR>oVu
z-T63C_D2hb_%Uh<DTm1K!l&`4ret@~lN-l>(K5@T4ji_csGxrr)pEQhFVZEX_Kdnm
zdrj-3)eggVd4VHu@z{wA2fCp&7ce6}UjZZ`zH%7iaml@)@}*<|smp0M`t$ScPwfA4
z7YLa0WOu-f+L3VBK(3ybS}1TkCCfm;tl7aC0aUo*0k49!xA&aF$T%!Jh|R1#8*!+A
z2*>o|GUH^9%{+GsOw;)R=-kn-`<e4OUM%9f1F+%Bz179`!U;iS!R}yq`q#IAee>7u
zUx#O>Z{Ii-80Q2lPa)7h=pVh6He4>$xH;hgHwk;?7=@i5?e+HiM?DvW#K?o!@P{|#
z!9i$=vo2%|7q${sqqztfh0XGU!`<V5^P|D=xv;H3EQ5^X5rp~!vBtnO8K`ZPP2ehf
zxnx@dwp#%8w%10z?K-Hp9Y($9|L^v*P#J}L&!7D@Sja@a?GW-gUwyc@T@m-rkJt;R
zMkVCiUK{zg%aM<umWy}0#|MmwC3cMx0k>-*pui&}TrVI@1}l5>k;dcVvPC<8+Axt@
z+1ZOPtrxVd?eey^gKcfMaA4w+-H6P~I%2QcyB7_fCrU@WHX<#{j-Y}VAg_nR^tZfS
zx8-dyT-CC_=}VBYco|{%Mcyb=wB?v_^Xy2~L&Z;RGBSM8GON=Q+1G~pZZxFcTCF)J
zHEGHEwn5u7zhTgW_tF?3y=)eLbn)m_^sIGX!?`MPp6sB!wzZx#WfN%Y1dF3qYh*rN
zn>E)FMYU>&d?(F{T4FQRtFbNY;f#C{i2Lv{0wqgZ89xYd78xX9x*wsVjLx6rbOA=;
zA4QH8zL7}@z7h0X3rjxt$6&$alq3s5?se9a*-QeNl2n{}p(|CvEp*y{*^4`F4<^(L
zX1<{vnw^aE^qwGv=BI68i(`JHfebxgFgE{t8B7layvN&M)qxH$o-{7e2hB|%uzx4V
zXlwETZF6|k4GtR4=-cW+lzw%n7Ny|l7e`TkHyd3qvYAM7#*Lg+PI+*F*2ZKP?3_*c
zy_Qn<VA%3_HqPZ3lIR0}EVT#^2l(-!VM=@4UJa2CELwP%MkL@RfDMyyNC^y$#grTt
zLkcM3J;G#kaoY@Euj0i8U<BCd`C}_tqeML~4Wh$`Z5mP{EE>xDzyb;ATzM^_Y04&J
z&I^2C8~H<!8-P{p8ad)X9VV>ZP*{^H5rB`@XQG(SP@7+~<4L1`H5M1i@-{(xG664*
z6Ur}li9Veqe1yp7Eh3gaf8P0PCwi>hzj;Gwd?eH92-UH$S6h%t$}E}({q7l!2C$`X
zANVd7=5eq#pQI~?<=fzMX#mXyN_!26C!tD88!VzyMEQ;?U5%iMB69^_Qb?&6V+0Aw
zg|CF2f(W`qH5(d#v?9c#h&YFLb6h7P2Ft@O%N3EWN%tz=Tqhc2oOV%^2XZ~zf_w@x
zYzb&^%-AY`tp2nhJZYOZFG%!;TP=_)K5`>QV{PPC5*9Y+HrEe2(VQB}lEtAlQ;D7^
z+p7s0R0Q?%r~=?bf?*@T2|ZKL*ya-&Ym%fy!~`v0rAt(Q$l>J!DyS~0#%j?JNW{0M
z%{+hL_chX*FG3_T(_`h4&IEG7vz9e9ki-R#4Ajt3`-R^s2`6o(3Q9>B8<OOzYUrmf
z{jIHRVs^ITS>Op0q;%-i3B|Oo<U5k@Gp<z4)m<fa1Q5jqq=uGGOf#9wU{6$~Lp3|R
zS^z0aXTpwu@l0r+w2DTkrKLh1%;=OA10UhowjcRP_#yF=kPe@xkwfJ?pmbr9lbszL
z?ki+gNM;m4w8Tx73P5G6)5WC=L~eI9zh)Fyr0?LDq~fVTAZY>x?oTSiF5$hV%viY<
z^}tqTgla$rfE6QkZ6<Ael0j-TrMB)-wj#8?1r=U@I$cd66XuHR@XYdhB~<PkjGe_A
zIORdAqA5FYp$WKN#-77%p}_(>unJlQgAsnqMKqfjQbUqgRFP8Hs2fm2DgP(uu0(Oa
zDI|XSQ%K<0LJHDWfz-tGh!`a^iq4PNNI$@Fna*JBC){-#aBdM_>03k)E%Yrb=9%@*
zq=R;UdKjp}-SZ?1s5`Tw44zPwC+igVPZBcGHN)Hquks_Y2C*Wuz+j6viL{57?L|@K
zddW%m6F3|*aqdyoH8*G0IqG;+PbA8~A9>t~_jSrS9sf_BUL2o%(fqNUH*33*dFo3E
z{@JJJ&)D-KVuRZgz8h1#|L=IKeW|o7yzj1mSCIC8D^15jgNBljp6@@Na#L6(x|RlU
z*TNw>qiuNL)Ru3%j+jlm=aCk7kuibXl)^Q8SIUYURb?_vp1@_v)BJ1;y4a4MZ~rwq
zOyA%khkoGJMw^>IISkF09UCQISx~ZyW7lUKgIM>V3EqsJKimFZ{NuJCf6_O;I!r5n
zZfPh=GzWwNQ0;};pm-60pHzYnX<MIdpWi`~L!g>F=4VM)RIYmBd;*7j6<0}XbsjR@
ziM@bkj9Z!J0PNyzcNcz5D6FRN&N7=w%Vv?Mm)oFqDkj|}iX&CfMnr*jdX!)mVCEPg
z4plODt1?6KMG-`9l5l6a40)z`cWr-v;xVV7yAdKp66;-Y|6ln;OsI1-O+_xb#xjR&
zR;^YrNgAEh6(oj-gbH~x=kh?-!nH<0ITk@=RVri>1k=i)N26g6L{3-{)K|-AD!H5%
z&4he!=8lAXOQ2Lyk!h+Wg{_nk*3@uGcPGVt2q974H=B%#Gwg;6Utm~MNDIz?8D((8
zj_sne^%)ai0|pg!*%E)9uZz5{$%@qDJ)#XCB)pW@VmUq&kKn|NHut2!!KYF$rsOG#
zZEc0v+6PvnGRmF41V1~`iE>Fr^G|L@q4xkJdw{smz~~<XCy$mKfd3dY&SRq*%>D(^
zm_ZmoS3-lt6@_Pk{?BtW3DXCE8y`Q22!+rXxB_X*8*aA=n?deW4on;@l4#|fLlj93
znVwe&F_<K00eVP~07C@bBM<pN+u`yZ9#9`(2p>d5Z3Su>VcUx9c*llOO8?==8#0Iw
zfx0R$o24Of3iZ-1`GsBayrkgA%8q9l1PAVH*x#Uu_z_*5QtlLYnIw~cXa<KR&q(zV
zv>T}MoMcz%z;wkRHaC-HX%z>t)qy{OLFZ<-=@MPyxyJZ9UQD@(<5iZ8!H^a$lgSCI
z7x+RLR&lSE(RGIEsXn&~W!r>%z^J(4l$$_~$W$WnRxs^5K*WKb(C>_d7rIbZu`ald
zGnN5pFOnI<Xbk)!Rl?wZ&eT8!CPqvK+((3j*sv;KjZjoxBtXJtyf|*shY7J<P;lq}
zahjv;-xAOqw|@^*d2_A`-~lqg`E$gmg+QYsHDVN@c2=6r3;ic5qENRd-Q$P}UNW68
z@37`v#tERXjz^0u&$WJ+4?Ug1{>*tmQ=(kDjnNgOsfizteSnvL0y3kfyl+6pMFlVr
z89BU35{TIi+!Y!a)f5?Pd}g>NLB~|qBw40`L2ZA=T~w_46kI}mC}ZNA3QyLLh?5TX
z^q^qGu;CCuh&6JREf^;=<!HxUAqA8H(N)SiP_d&|t8GFk0<0R0>oSmCg2#vx-nOI-
z6}drqYeG>}Ru#d22>m?J#Uq|^S}PNa*+EaXWT;`mn1^|Kur+8K8f@+|gzn1nLL7}Q
z8j*0{H1~eKWcbaYB5rtuSG1%CN)gOsk@K%2em@lAf5M{8m6V{867j(ZpZ-JClyP%-
zkrsLc5gZm8BjWK`d(y__7{oxi*Rg~wB?a6~+zic(1lmD=J4kaVRMN;sHu;P}K3j=7
zwP2UaLX-3|K`-qlW)j7~jj}L!a8J^kWDE)J%{;XtQK)e`0%nNQ1uiu(L-v2My$jad
zhB2yv-}1^rEbVQ=Q`1Y|dvU`VNsmWKk}(D^O3mq|2VgW%7bn@vP7w$_ca`RZy)#{4
zG&V+oKZtyPHqgpj21n58vuS@|Z~}$Bb=grc4jIWyIP>VhUe2XLrD1u4S9r%1fpff!
zk11@$m)96(#ebIY)ze{S<}~L6+9P0-c$z4uFPx|fg2ZPz+tM#gjeue<WRDqF>;qn#
z$BGd#&I4d^b|{*NTSID{$L5Wf@I#T@K+dzSUrn-q3+_9`84yLmsiUi*Qji4V0QMZZ
zr%Q_F8K6k&9?Sq_?Q@`Xbbu9;fMHq!k@{wOXNg&@4{~l~e3qrVQYUiv2ANC9y=_s0
zLocc^W-g5Uw|m@`R4RpxV7Wxq29And**=E1(R?%5qQr}#CM*Z|!b@}-4dkCZ7i{Wk
z(n>#nz!T+-@En_o^gGKKqXfbhXaG*<kcXM4dEvId5c6xsBLm3T|8JBFX<Nh{5v`Eq
zI$#)~$)nsgsFFeMgWJUeLYSUfIqU@t(3wa-81%Zx=1aa^C>JWi^uTeW-N&T97~-Hp
zBRbM6zx)BWc=WB1_rpHmD(8v=xgug?44>nF>I?+{q|XIoMR{mn;!danGy<=Oo_&k9
zSYdCU$}zU#x#g9XO}Px7FJTK@;&?36zwn@EC&$MJQa^LhKk9YCVeakmX@BsJCw~OL
zFqcu`qAKS*q!`^$*LA}6Jwk5~gfs>$Sc1os!T{|HCBv0=I5~#9*M_{{ca|JYt0pmj
zj}DJZCxeeI5{v;tu>ngrOeram$_Ka*9>X;tbW21SA+8X(6Uhb96$2<pKTFo?YRY$z
zoEzdy!F~**%r-|EzVrfPe&pF*cyw7@I!$U6iE<D?-{f-}7wLw-(*O``#mlV>1u@1a
z0_7iPD>#hAF97R8t8Y3H7+YcTU=hE61H&x)LX1j1tC0;W<>G<}r#$B?;iw^D^|pk>
z3CZMK2?9eEz@@aG1P)<l!+1G_nMM0#nhgxQWp59)!9;xyR!+U;eAEqu=?=?e=h--A
z%+`v#q{^%UoY<Qds>pgecMvV@+zx#-xa|!kJkgPj`y^Ty+<{noVT%topEGiQ*)T9%
zr(WUP>>U%*F*?(&bk|xWoYQn?iU=?7slj(N1KNf1aocds0(m3X-s~4_3(nBMF}?z;
z1B3oHr0U#W0)ava1^|{W!nTQttHo|$Y9T!Z5ke04A;p96#{14d9<lRq$W!o*mS#QL
za0B)MKg^}KaM16S-hwuGMo{X1?`>O&Nwq~WuH#OHkYl5dLgxw);pl4m)}cTh>v00Y
zv{8qGs3IwaKn^x(>AT9qbE*WNh<F6blxsybBSw({ch+1ab;4kC4YiETgZ}<8L(>Dm
zShgWCzDIPtTDFK!_vkuhxM_I3$DAzTYT|^$%lJKq%m2T<Z~t!NII{kKeg2AB=ENao
z5PI0o=au7}rASKVXYsLo$niQkzz`Ucv%+gJfGBP@|NGZ<tE#)YX8=-`k~sS%d(K(}
zFf%><sIIEMb?-mG__4v2Vcav;mvs$zXuP~$Bf-OT;_2#<)RyP|zMW>cC&$vlr=qSX
z)Kv)AMvK%fHwJ8Z$+>NRXY`3Pr;~3iU7#`Fh%W&9nqTcDY8h`qlfWrJfwwYJNE4O~
z&I{bx?>fWbT4B12lM|}v-`hJS{#H^yV&`Pd$s~Jkrgv9Qo&OUJiOe8-DJGFY5Hcj$
zIP{Rrvd;B(^UNigPQHHnY1f=k1X}kxoF;T-nS&MMcFJw4e?wh=PtJ%NGzNsuy}1|l
zIG#$1>1E~+f~jS(Z`EmNEg3G6W$iY)>>fe_CX={t;*(#|lZfgx_!y}XLzcOb-%fTG
zKDBMUvDpV1kVkI{cX8ooE9{CF9pyRjn>ybZEa&yqP4?S4^l;~<OgD?4EIVFgYF%5P
zV0pg<%~~vI&17wVWJU|omKEECQQLgU_LJ>qY(TU12Glrn`D5aQTJq*-24MBd_{xr%
zEDUqu-+x^&GX)4KQbeOax>HO=0=kH;|ARuJ0D?{*wio|RUZ?ZWfZmPsSqNK7`-!6Q
zH3TKWl7fl5khejsS8#w6AvOsk%xnbgXVV-Q5rqhJd)!Wcy!4z)^H{n8od}&b4Yv#6
zv#ZIHl8~My0jtSC?i-9L!?K=X$Css;HI||1pVtE%=2K_L0ZJ%9;JA(H7SvX0@snLE
zvY}Lq>bh8{05;Qw#;A;Ra0C<sl#Par%xaoIy@^-knn|xGprc|$%+#L_bTXw-QOZEt
z^IWgLD@VS6ci|yKiS|J1&OmFCb>s-n7mH9ym^t31uI2<t;g1zL*!8tkWmHttc2Mq?
ze7{kI-8U!_+aze#F-@?)Z~E+kGg63DLOInGvj=}^)Y!zrzM&{68WsQ#c&H2pA$*{q
zwJ{)B(Kl98U~m8B>CP)Ek6@4C<?EeSX4Ssju^5kkqzS}gM@Jxh>)k~wJoE*b{^Y_4
zmJu4}|8TczgDSc;wE4|9TOt<JY|lwi*N1LhGepDv@eO{swkdRtZH{jMK_=aITYQh|
zY7@8N8tV%X;cwv^`roCS8*llC<)|+8*Z;!B-bcH~RFi$aA1;7W5+SK&=cl)$&*=?4
z+NC0YeA+keKflAvbcvD|HvXIZ^Uo{3*`Mt#4@8(Azn)P~kS<@ho)316vjVL@$~4^4
zLgN|tScH|K;md`TI7Z?BtrdRIA2G3N{JRJUxVBM|=7Zky@NR!X^;$~MLQ)KmXgEa!
zYP0nRTmDwv*+tC)4&P+9pH9_w_*zn?$Fp63Q7oRPO&->ZLt&w5e#6C@rq9}_8zRUM
z4SMoxGFk`Y>(B%DmDjgd*YjOWN2V(&x&7Mm<L0ZLk7su1?tNM`MWxczz0!C{@^)-;
zAN#+#A5;O9Vr{XddX(zzdU%ca;?2RBisU*vQMP~YI;un6t!>30(%`>v^IX#oqarnb
zJl-2=x5-!a4Uq%CF9*v7<RJLTKNQvC<#hg%YMARyzOUX<@>U>@O5j{fVguJ{-NNX8
z0;^yLJSp4OsTB8Az#7LLbTLDzzuWoe)7c!vQK}S2g!2S=f_`y2P+=1I`L;h9{!;Dm
zUr;CCY~YH<wH3PWjKmWPHSH*MN%7!+wszcBlPCF3`<eVqviy$)ww)xdP_34lvz)Wm
zoJywrAIm%uglfKUbDCyZ=7D{-Iy7V}J(jrRO{cGZRM9ci1V;WNV^XGR!5Mq+6XJ^X
z@EtBM(x(SFPxGeaJQBMgJj-{4u$T%Dec|~Uv6s0&H@N(EgS;`o6bb~B(FtOIErqRI
z-t4DJpM@mCWa~qS0`L;LE3-VW^DVYwM#1Ma_qKCS7tW5WqGmYCV4|uhamzGc;N(Zh
zOTIg;exAukQ+4PSHG;@yn~zuk3gzzU^3$cRuLkVDnpgra57DGFSeOo?eS8;PVYB*Z
zhtDrlGXfbs`@{`oz~`DX^SS?jrUS9nC5q_-uJlGS-Mw`ufAlE8J0CrgK2`UJXOC1V
z-_x7YAyPpE(#8aL8(aj}Cq;61+Z&;eqM(cKAIn*X%4mB71E#%lO`-7ue<$vsdkL}~
ze0khbM!g;#pG$W~jrgLw#_G1uP|E(-_Hn-0TQaMjezvVn({}FRbVxFPGPT|)F3a?R
zdwgwUJ4t$q+n{lwY4KVB3WcBJQbCH@#RPVlk}h+14F&IFQG9VqGaTMIIq2BrnV(`C
zuHlpw*oe9Wwg>!Prrxz_&sq-h#{iZRYnZ~PqcN33unx&x@u3t!1MAXXT3hU<kR=q2
z*Wm?qN#dOgqzw9rL*k=<_r9-INrT42<2U;~qTt~_4_+M|pY99Gsy{&swBKCWZIR#g
z@)F<!@S!j(X+yA9kFb*$0AZ}y9L{74;wyrYiCx6h>UePOLMnF{XvCw}UXzWKf=Pc7
zd${%}_n?P&rYA^2928H-fx?g8dIdi>m<O}yS|&dyHOM*_OdyYcBh-H4QA4n*pLoVw
zeOfB~_<+SSZf{+#^Lbl}#a5alHk|x>ZRi>kq{!4j8=*N9AwCf8r-G8mRAE1aVxQuu
zkxB}X#FR--xLnxo4@RZ4GD8AIk%lkL2LNzrm8uP|I29{I7Q_g`g0_VvFBN%Zi6yc9
z;yHvXRgPWP^;Ri=R9@41SFEg%N?3tZhozZzcE8)->wCw`0~n%tBeV>=Cl?+#Ma&(f
zfVkB+2rXG8un+O_iZN`T&IsgkehrFZ0)p^4`B<t;w%2Y<xQgl7=VjSg3PS!wt_SKI
z8k<$ah(uKTZr1}lzJ;(2%YnKYW+5Zv8+gzGCuNHwYXN?L88c8*LK-{Rrq0gW0y7yi
zjLd`=JK9Q-c^}{Hd;4eSr^i2jaMzMhmv$Z}+0$<3WrE9wO=qNaQ#Yg<!D?Hg1bZ+W
zwxE{OUMRfGHg(Tt5^=8IL$wm{A_~Naaf9aOD))TJwqM9U+Tsf#vtSGpd)}olr_il|
zf|DJ)NfCX2Gzds|7HCR7Ah(+W1;W^3g(zA)^T_im<o59-^=DxMc6TntHPP77NfI^F
z5cwt{V=WUE0HXOARajz2z?5idha#%Ptv*UpJWxR3#MHF*?fON$PlWAJO{wHX{JVTW
zVm>ZmOM9R;^HD~%)x$$M3jQ3iJ`-c0k<{?qJL#!^6jZKkXpvPWPL!=mRctEudhR9z
zepgH2U0ZR6^8JkDYbJ07rl765sTPA9<?)hQvF9t73>^+q%TCJq3EHvdhh`ef&%L@7
z%gYv5EN`)<?+PWFbIvq(Ui00!)WdMVJG+)i$&=S|fhXh<B8wZUCUVX9Q-jn(X2Hv{
zv8bhgs9JwY;7kf^ZCpqeZ2EGts79^t$*LKo;10!-?01){Tn~9IoUQ44jYH)$&=HRH
z#ya`I)AF;Z-UFm|ftGX4Q2bmf)KX_GEW~933yBm%Mm0aaa(=~fUSlA9VLSF~z6j0+
z@0vA;w5o-i_3_LXwWTaYy9W~<RG9twbBpbN{p%e)dy%y|4^nM{c+w+CPqtN;kRD0N
zDJ4}Dsfa-+EfN`{CzYM76zTWTU0R0F;9m;bYKgX#G_&W-kL%w-&%DGDe`J1@WeFT#
zNP#YkI{KZo*@C?x(ns=V9iPt=@V@9DiNcWwO~9J1Qx6mgWX{aA=?8`|F{maW9`hJ~
z`KW<{AGwP~DzeQQXj3;K0cL2G<JxMf&-<)8y|b2SBV8Tz4f*2wC!(9(`GXdyf49GL
za`q<_p(n3w^2Bl}9SO|bB41o>ZXAldTu|$vf`MNzV++A7O}`$Emidd$A152koTDxA
zjr~(MjAl370LK9zb_w<f*G_F_n3O_)1>;&6%g{uay`R_OOOIN4@UPQ$N}J{-Sqd^j
zZqJsP!foN{D`HdpQFmSQcpF;vtxTkE64sSC-8tqMnULPl%=GJR77Bc2jXB?s-D)(v
zrfTTHXo;k{FOxyCL@3-0YM6XQTQ~yH3D-56+(1+y(<)JE)+aDC(GoqUW`&=B%Ubm}
zCC(KFE%Jd!NBl^UhIK2LiUR{U+MC9>lBHHDqu>iJYh`g+DSO%Mc+=IuZrSKU)G=a9
zMaT%-85!@OzN6CbTc6t81x$crMy$03&2;y{0%?h4AmZPx*d6|}o=$qh<#?9=-?QVR
zoc?73F#0^+o09N&Iv42E0uG6PGp@Lekm@&^|6*B<hSWXv8Lpt#pL1pdX}vnXUOIo=
zJ<_Y64yJQb&cTiGswgMeIXXLVj+9$ZI9S~wXcO+}3p0mYBH$((4E;|g(wvZ6`KQf)
zBeNfRyN8drwlZcmm{mx@ZddGpGAA-stJi~KCJ`02iCr2|m!Vwh#reyB?XNre!P)Wl
z*I$42uiMWMVtRf%ZFDC?REhqQ?vwn$LR=N1GOm628D91vAojSzrrFPw*G{?_{VW5c
z97^`#N<~VQ%<lW?m5>k&r-P+|z+G8bo3k6NOoR|0fF{-sgzGSPOBm&CXP-ia_N{Eg
z@O-$0zd{i(dr{-!KWROGG1rqsPAt-DPLQcJ9COLzM$>C~zo<7o{i%lcT2ZGR%}$Q*
zz?BNXO4bQyL6eK#T2p0e#7-J-bAp?7PO}zDZD&$B;LO!vu*5{WOpbs=Z48)q4Flg*
z1Ps>NR83bAe6^-y%p?|2=haMbB=Y1$B3TWZ&zz%|jIA)2)7L$JbmERRQT`e=8}gVq
zEsi}E;6B2#KU}K#d`iWgG-@3-a;qt}6uIMmSGp}B5+}@}+y$!8_&9hvE1X@<`=sUi
zsIMVRHzv$qa2xqRhJQi(&$yJ+=MK|bb(|M^*C9|b(gzy&+tqI>8d$E*4c>G>(>hD?
zhoQqf?WY#J9V}vh-`B&lBAi9MU(#y9-Acfppolg}_6Z>wLB|cJUU#k$X0E2IN@@P!
z7a!hfCWv3)Q9jdux}R8hgMPfZ_17kdN`D?E&$pp<32~qMPb+sH{`pN{`~SJreOGiK
z_nA#Rw;@H&4TGF&Oc(Tri!kSeMjr|nNh6HbSF{Mx)gZlp`@ng&oe>mo{cvwKzHSHK
zg%`HQ_p%g|-?r(U+2-n<u=Ty6RR<4mQ;E~JtabWL-uI90BhP|hfzt@sQ#e}iS%k~G
ztks*L-`|w)3px@Qv)<~s+ip$S?51`&bFNH!2+7+{F{i*EQ(~Lbt!N2vc2GDJL1w6T
zOp`PY3@I~z4Row3c6k1gyH4FPpVW}TVDAIs1W9}VeR3VM8d8{#OqZU<QA#0WU+x`g
zzrfV92%+Z&X&k!51)I<-M{0N>0=(V`LEA=M7|QL^d$@VFan4lz&-0CMvhc;{-_kCE
ze`AU_yI{o>_qXU$DrLU8)mW6V6PK>Z%R3t~wJlG7+}!3)@129IJZj02oyqBiG)yN3
zYpR5T0vV<lmoKCgk+O6{S0&1+5&ww?Wr2?&Fe?ca(Znd(;zUMN?XmComJ2Wiab*Qg
zIEUqoa;1~tum*uz@owH#^M!jxD4@yT@FyWcaZ9R}XU~g3*U5;@n3E_VDq=quSzE{q
z41I2YwGi?EKG{=MngwA!fb4jewqqlzhER7Az5#KcL-<6%Dde8usCX6iLsWQ=z|}tw
zZs&%_dZ+_q#a+D{7JNwdP6SueX;5@6CklS^(zPz=QUW4yol&7G2vsk)O^>>^IsbOR
z#y7}r(7XD=1#cZ2gV|H}t*2jcP1CM|%%Ycn&SG9x*%?3&6r*p(<iBr(f$>L=%@TW%
z;~Fn%s-2{hA18TH>U0QoPfKayAt7`lnV%@X(tCLz2)|xPU|I$jh;|wR5fg+P7I<ND
zw@-N>BfPzYD(2npk39d1Mz>d-ta$Ea@;Ccz$)|yq^vkcm`aiz~GwIX(@I{v1m~YpA
zRyor0CZ8owAzzC=iR|~9DaiEqz2pllyhF}lCMz9>CfTZ?_EG7I#1_W}$+~aGi?a4J
zO%TYrC$z=o7!$L+RkwlaM$f8o<<=sfw<Ra>k{Fu|UHFcrYTnGOB=d^qVoFeEa^#_P
zAtumLxb8GLO_tm|H9T6>Kut-VW`G`lMVP6Tv%fWbXkP;H73GTg-#{zm>5HabSDt%E
zMvl4%C1H;}<WR&-Alnt_14!8YdQuMC9Jw{i?jzzQS$khT`Bz?eU*_LO3oi|NX!SMT
zz_6I79V(<(t3~lX<6F38*$&wMv#%+rIRQc~^u&lV!BHj*UqdyY2%S&B{&2m2o#>pw
z*``f_E4PuIrBy0P<tuQwD&n6LaRmGS7kAqSnGaien(vuEqz0S7pwkKQ0Mh=!$g&m`
zA}9JxmOgYb<@%JnntqKGI6QDw;P64x3bG1CvX1ToOqspQ#<Ixh`3A`gtCQL~t)6Em
zpZ7Guy~eMK3iHT1Dm@0uw$m4X7C>{dQDFnNW;srd3ZO7Ns;a|jy>U0e^#^a8?Xv3(
zRt2Q=+T6_}Pvjyc=IkhV0=U?a@SwCIJmbPy+Or5;7{8Mz!(jw@AX&+`vo(tI6UwQL
zR@(eLH5^HEWr^Z~h@d}e+y`x*Cf+qT8?yq#rzU?05T-qh@vwpvEo)hSfLyrKuvIn-
zaIgrnRh)*SISDA&K}_L9yf}-gAc8~I*n$>(+Rh`7B0!1A1)<)AGlPXs6#|K6-ih*v
znQ(z7zJO6K#0jBEn>I(2FB4%fbOF7&*gYF2k9+u*V_>%xBv(A*_mE^5?SRP-C_CqW
zvi*B=JBqsxBM|k|4Gpt@SC5UIcb)L?m02%T-6OoFMP3rLiOeP-lB~IB;}4XJ00IEj
z+)K8N>NT042G2z8rR2aGE$4H$^cd8e&iELv^=gkm52pq~oFQ&Sr1FhWHChWDu|94(
z&>=OdLMT*|N_f7BSUxf&&DZ^x2e}dLNx}9GiH9*t2}<KO)0wt^qV9IRU3#G55!_<W
zjZ$wpA(TzPGV&p~`wZDdA||gbGr0@(i9i=KM&M^&KaxRv7{9_#uLd?UG8H55$`y)E
zLlO-K2y#fkz~3+V?uMcXM;^@L=Gw;4y?Y$K=g))oGq7~d?XD@C(=-`>J<l=yk(Hxn
z&52W8F4Bj(YsY<m^ksgJ7y9!Z&h|1)X(sX&0e>607hV#F@)^qPc?SxS*h|319qy<`
zC?=OnCj`1vX2T1Jr_v|WtIfkZS{`RGE?fP8r_$L<Ps8my=AoT*`YJq9YL%$igdS*+
z=z(m{&viFC)%DGSajLv8NxCZtC$toYm~0H$Hd=8FmDxgn4rjUSmt}2Nr4if?=Gq$l
zqJ05)q|1X>3N!|}h6uCqK0g>q&`In4`ObWwwKi%6tkC=M48cngDp7PC)j`@$iy$hS
zZX^Ipn^z2U(;IqN=@qfWu@}qd-wj;Ls+;F}^HmV0j>r4h+w(a?z(~gU70xZ3nS1;S
zpj^Ir_*{{H<1V6hvuWGo*gYp3!LQdl#ckW5c>ujfo$PyQAE>3lZw=7Qc|!4E0k%hY
zG6sHYD}TLgOCfp08E%{6?mCT+0g7vdnMvY-w*ePEkd|CqjcX&ZjPvexXio^t{6SdS
zJLW**)VN0QK*iRx7iU2%f?Zj2uND}K+?CC>Aul6;`)n6-niVrgJ%VGQn{i@neO@|<
zvG-zK?tG<UH~X+H#{zMt8Ydq#A;+vtPdlBk9mTdeAwVRpSa^AwGb|+hj&(a!(NM>o
z&V`t-jb(5ZyJ_g8*n30OAl1O)w;d_?8B_os3hV5I4;~5R2C}qP0xKPR`;sy?geB>M
z3&Asg7`GkH@c!wc-okgKB|Z`Ad#Z(V@%aksAWG+Yt;m(X92M6}XHL=igbHRY<1SOg
zVV4G${LR7X`Nhub-iz1AyWg(^m76?`>Y!C~&xsLGO;B0~`l3a%$5s!~<aaH;uDn}8
zRTtVf?Qfdyg+Kdso23P3=cn#JuYT+u9vt<5&JPav<)yQiUTjLz7s)7c+A2NRSTTUU
z+~xAF&2&D`_-tvLk14N%UP34Db3xpTi&wqFozqtbM}7H>8ocxR;MEayzb)^afRc0w
z7+JFCu}Xw*V~C<foqI%my<{Lev1>?t8Y}i-;_^-Dh|fj)6=~%-7iJg^=rUdI2<3=>
zi0;<C&mt^Xu*1}iNF=z4Ow&ef@B@%aDH6u4ob!NJwY7llozU}5<*CRuBzgR)?+8<u
zWcniXo`^MQF&Q>jPKYRUX*Qp_v1EL+?b_Bp3n8>|l_y-Ttw-JZ+vGjceqan*#dNL&
zo*EOSo}EeuM+fHzZub1gzF8AzsK9)G>Y)n1lB@5#EPtB)ib379U%aI*=dGuEvk~KB
z$k(n-;c80YZo7s0qau7KRj^O;{*(86yZnD{vcKR|K^(-!iBhr;+FiAjK?_nozU}@?
z{y%ryL;w32U0_5=mJ|6SCa};+qeikWIcHaU{T*F?c4l;-`UQy4Kn#rM7x5E+ZFHAW
zVOUyIDcW-(Aro}LeJ67AZbX;gvD?y#Tu=hLwazHzvl-n*7665u!3%FG=uYxkb%bB#
zo<n>lB2Hxd6TJ&_@dH-$xR_s8INHR2v&@Q0M9$)z+_#F0J*q@Wo@I_SU(476H@;G+
zS7w{)8gbqXrJ=*zsC%rEyJ5e7qg8cg3mmIEriqF(=6CXxtMY2Sr%F4#Vol5Tpefp1
zkz<lP=I!w5Z;`AoDKR_n+F|7|3ss-&?8BGlmI#!I(gd-d%}P7LO>qx<kYQ-{!m2KK
zCS7oFrP{04ZUs?mAz;YOB%2ARoi73v2C*vCD(pv~yh4K+sjqL{r$Byx5d|H*Z52dc
zqL^G-a!;Q;`L!2+;X09Sw(FtgZrYD3y@AryQcFBW&^ITfaD?iY+}4T$2DiLvcS>U*
z;Yy7m+*b^?<fQ>Gi&}spPU%W4K)+gLVS5~h{~at0Un>eo)9CTYEy<4Fgpo^uuV34i
zs#Q<2Sj`z;r9t?3T#2uLGGRF}?()UWlKWko*48SH&ptqTn1xSpP6%nFXa``<1g7kP
z0kQ8D;|;LRhD*d2l(J<65f{GCBa#>rpZvb}{dcE5e=BnW6~Jd^*vNtwNag(G3t*%&
zq^(M3i`KE0NQ4;4-B9?nibZ3=7^%WWSz-#T)@C_(L&pPi1d%|0BMg0jJ*PcyiNK=A
zG9UEYUH@V3KQ!qAAHiar+KuDh{`vmyd2jdl^z`C{W&-;<YzyIJ0qa@l8ndjq9ERgX
zA7=9!-!-28K$l54-Ggd3mt#|Vhn+k%+1{Abpf@*$Y_kek>nLZvwZg)ujuUMN*KRHH
zgSD!4SQZ`v`gY=f0<nUa(u;}ni#9&WrNZsyCEdSdfKuHTP6IT_OuQ?IvyaN#>XH=r
z6sJNyK8PH!M@nS1b9T0WdQPklfKd`Nka#WN)fwH%cEYQtg14~iVm-IIDde-8h%I~x
z`$^bDTG(4MIpLqMML<fcWa&S*V!BD1%t+~I#tgs!yPl_in%TFGHa?0>b|&;;Ox-dy
z(<$=){1J9kcS+9-%XD+AlX1d1DWP5U1d{~mG@p>^6F>`Zo)Y${uzK^&L5sQAvMwzu
zSlc|>Y&AvE@pt>DKG43$h`Cwv)|ju??$6K?AI@gkPAnQW8Ja`_rtgxk0OXut&=}ep
z?O#qf4H+$eAn9iGUS{TU@Adx9_r#LKL`7^J#Z9gi+XmPO03XiVxV~m*x1b)9g?3d?
z<uTwyG_=SlWS5jm)%+T2a7gA<GO(v22*W=L7<pCn_P}0P%u17fEiKQWSqO)UiHyB^
zHuYlUHMI5|<&SH4Dm3qX=b0rDkcoIaJ-7Gz_*IX8#Nv0z8f54;^;>N38Cx5!=zFY=
zYX(s%ME&i0X?r@;WA)!a3Hlx9Ls?aXHC)`xsY$zuU^$%k7rqM$f2FPv_Fl$LhprCi
zTsU~oT*%_~dzj}xmSfklyL`I?Q#G%KfiegaV<Av}bQe7h$nuiGqneO)Ud$zG5qW0-
z{*PvVoyque#Yp0tS@=tE`?;8-gUNACIX<GsuTV;GRlQdN)~@Eb5TW&oS=9r&U^>eW
z<iD&b0h8<k?AZ;SiR_#lxWz`Zz-yo)K=OGdEdQHwG}9Ch?p4l<%L*y(RW}u1?|4>D
zUcI)?jk|bqJ<`VY2#ODwpO}e!Uq8_BBTLkOF9lN6fAf}q%Dbo@=h2Cs^BVgB2yfuH
zZaU76oa@-9^-@imEF8f_mh7dZ)1HT|MUddD^0^GSjX|w-R|8Y{i2`oL0>AGqBDqI>
zbuIyDkph{;ccE9!Vy(d#e?mltB9%MwKCjdR$z#XNa)+aqVpP3T)&VWuQt)7V5s)f>
z8+I~sFF0osw}&!u1@MGPJ(4`X;_=Yx<T@}qDTGKw5L+1-y+&y|iFn%Cjou`SSoa=B
zPhPduY>Ax=?nP^e6Q*4|%pg|4&JvBsdOBLFj|OcKo+&F;V@Zy6|2<<IdFUD3dd{R`
z2cA;FQ>oGe=W{9C=GoVNIh`Zan1X_Te2M%@VKt2xNv7pA_b$yzW1vD06|K6qE%THT
zq*7h(eMQZF+mn+O1EmE|$uW~Sk<xD<ORU~Y){@kt#-$5^haxf}BHUilj5-)$9_aMM
zkH$fE^eSGMr}F{p|5jnlYy>FYzO4d9Xv46%J2&qcyJ(3i7HbyZJq+;*xx7q&$=iI{
zSS<@lAyFYkL#0zV4dER?2w#yMjD8mqg&Appqb#tP_#@wCbDG6dv7?+*JbMz#_4VX+
zeH;f6uVd{C5u`OAZSc?9h3d!EB<$<~#1{An5f!Bp$sw=WV&pQdCkp8%CJ2XlKffu>
zeTu<CtN2PGbG#G^0^yj^tEEMM!gvrhMGoOTY+RRXQc{@7a`v&%Lq^1cxC=zrVvSQh
z(^Rv&O>)|rl17(GS0x4+Lc&bg^-y(bZSn#KI3eQ_@X&c5!!B3!Lx!nT1tyL|{V2Jo
zK+9@^&{b){0jnA+mGdQ>*_C|Pnqyp%U}Pj}%^=zkVRRJAhSZ}4`aQ{iRl6x=ue~%%
zZ$@K|5Dq|TtMQc*pdbDDUF}Px8fR5%oQvoNcORa(>}I4=q$i?#6&)IVv6nx6*71B+
zUefAa$wFR4EEo@n>@E~j%o9mA*$JuHk*3{Rmv@02r$y9T7NLFlK6YgM_l>zfC%}~Z
z4K0&KX=tlH7ABCu)T1na1iM)l0*J6^k+73WM{p0|Xv>oo#=I8=`#zae71t8b>WC_{
zEachNF(W<WItnep&dT*&1a{3e1WM0n8<cp7(-Ly#S(7-B&p`_(o_yuPB%U!uw^4H_
zmS2s^_mzY~Rg1)hBmxx$;@pZ`spy+hI*My<^$D(3XUbz&j}VN1G5)C-y?vhjbXK?x
z|83RDcZS8d>;C^cIvO43uQcvDF9$c1iZWgKxign@XT+ZCLB3TDpIGwEy+1sC*3Dm$
zld?z9Bns~8+^rgH&?Nuy?8(!w|Fn6tSj_6@k00OO-gd8tgLjZ-cQ5eRnWekOPoF&d
z>dUXbeyok!)<$iAhemB{qqdLA+b!#e#ADFAo-KQ@eXmX~wj(15qD{*DJ|~(@P(=m%
z=#Pi5knRI2m6DC6XlxW%rtY4?jUvlIk@+cWc%5$+Z;O0G2uv5WTo(1l79j^_i<@l%
zz7DF9y`sbH1odNGb$V|qL4m>+eJ$V0?Jp)c&2qon89>5+<W1!q+s%ueH(MK9U3uYx
z4~wS!+ONw+<Pg>6NQEzyM&J0Gx<6sJr#%>?gQ#2lUM=OxDN#tD|ER*GWLjU7{p=ft
znEMp1{)`&G^V5sn^NZ8{-uaIw`@Mrh;%N~BeQ@;hIR6V#IG78&=o1P#a@Og=6}b4>
zUiw?C`$hMEwi-Hn@@@Xb*Izza@spbpDCckUXHS2->NgliDpF3rA6K*2v=-{NFA+bz
zF79Z2TfP=NBi@CxUA@z<Uw!@J>z%KA7f0@c^nyi&6DIre2d@u~UiFSo&fVXy8~w#_
z1lIy`Va#Q(cYY*!*^8sS{g($v`;E@?G&*_#ljxj(?U2?DQ^@{L`sMEN>*Lej&iVPy
z?so*HVllw@zBQ6>HQ$-<=B~SNKYkjt13#iD;RES^ti0jFoP-t%p?O94#5)?`?vpE!
z2eC9+Mfz+l#6gBLh{YBRAT^b0YpG*^^47X)24@C#gt8213$_Hi@>i7K8OLr@GsE}+
z{!_$%U#rY`j2EGk+v!{@DBUhFQAHb;q#9ar1j?%d%i;q+ls8zCs;Z`)1om9AAVM_k
zVt*HV3F@40h<Gbleuk*ZA%Wyy=(s8Tf?4Ai%p=3z(7V#bt?$)A+F}56m(LZ2%tYfn
zoehEV#GW-)f#&7b#lkn9YMuhx++R$GI?G0X<Tfn%K-mMGIGQ7uUZU#y&h0c~@2A~~
zod*_~7-8^rclB;sFA5yPP=2kqoQ<Y#A3WpFIOm2V6MUX-ula^tyrFRwf^+M95@Vjv
zYQkHg<35_R$i_2Pk-_I2F^~&MN*yF!t#BMWR_$9J6^gHuILATM4$8}WXZ!zt;Y`(k
zf!o1;I6XMu=Q!XaHccB7wQZXAU@YA<@1<31+cjTYynMNTnr@rXm0GIx+poU*;<xE{
z#?s5J*kGQY?i`)bpJ%7LzdX}?-x%iq!@{rk@SrD5Z!4_zeSB#jNB?H15d3Y42M-*2
zBFy5y=o(V=PCmY~|0Ouw1NH$8s%bTUCNY>lR5HZyWVi3)^cJylfufizx;zRYTf1e1
zUT5y#7FCY!8b_aea^e<sQ5XLsF+iGb1fe9MhZQ?;38EvlBXiCE(Zk7>_(&jx$j<2D
zNmH+sBT)d;)z-ddkC>8{3lFmVNL%C<+}`ow-`)a&Xm#Z;SybpB!&L2A1?pdaqNxf)
z{J+IOk!_*W#<W;Ga<l$+LcRgpCt`iHUvITqF>A0^F8)GN1)!l7$AnCc&ud`C`_HND
zWd5LNpHOkm2)wHbMN;Wep<5K0`MF667*g2fq=LMOkJ6d45y|L{;oYPdR|CodcySUg
z>1Hsg!lIeSXuqf{f*mF2dRWGPbh=@WJVQ#gp#~;tGMZc<bE~cbZdbg+)15=&!(8Nj
z8^QOt==Jy~wdTZ~qwQ?|q73KtgJKRnG$EURt4doS`kyoIdnp8hph!}Uwu&+MURJai
zTD>H3RpmZGaO#@w!zYC&y9adOkDBMprRtf2AcAj0Gr^xp6r3PYrc_dY<stuD>iy(n
zoU=3AAkxqipS|Rp>&^UIY-;jSY6iy?LzEM=&%N@0Evvy>;tHo@Z=z7gbQ#bQ+?GEc
zsb_`TI2U*R5!_VJQXMBFK=aEW#~6FQbGVo9Fiwu(8Y2KLuIC8gbe!Cjn_lAZ{HB`K
zTRdWR%g`<eL^4_lf%C|JWL9m4p8@p6@-_TU@hqYTZE9Ju41(Qnw+K5`PBapd91|Z0
z0CYF4gpLUT5Sr@xD0uv?m(CtCNxAG^8TbgUGS&B|R~O_skc?n>Z1&K)4r#u4Cm=VW
zk@bQCwVmM*^Yyg6CRfQ>h!;DjTbQ~B5+Dz!=nG4l#?*=Q+HbIbR_Pp%v*`3UC<abT
zcOw&7syj7CKzli*4tQ~J%!1dx#wCpP6lTwirL4;z$SSrh%$sQ)7PWNJ&s&>xIDX4d
zxqoqXa+6YU%hNrl%)jhD;R@+Uq<Jaa2JC|_Cj&nC#)$(xZrdZRH1SUL@2E}$6&P~I
zHQReS(UUgv*%-`!KQGaj)r8NIX+OafqSKEl)gmQ{2SWh4(s)Nx$Qo~RaR{tg$Z>_u
zXSo8=+hTqQKw7=)t9qSYXHKwS=PpivOV#1-rRZE}s;5AJj+ysis`xaaA~O%b9$HxJ
zo@RRFt8ze*B#bixQ$~teC)aN$#uV@|>&Jxiu{=@sfV<Ftw?720^5E#~e1B(;9rJ^Q
z*_~v_*O`rYfCCUVm{w!G11~F?3BfU4fu)Z6+&(2*&Ql8^Vsq=pomlSbZ1ZF{HjK6U
z6mGsh`|7v(A=vcDoLrikujORKhD+>BDA=WUFjfavrjw}{#1-v`h@J>R*EYRjb+AK#
zVp29gtw^DNEYOUurR9a3*TVBHCef-Kyv-P2(>4Tfa-!~re2hJ_^mCgtfnlvBh+<t>
zja60uQlp}aqXRlq&<}me{vR}S`rs_j!&da)E)KJ-we+8FQ>@4*i_9KB&H?k6C$UJG
zAiPe1$X(n4vqy`DKENMM>i_5p7o0RW(%p0I9VjS&tgbfgNBL*@15yxMtt_3%`gVQ_
zjGfu-kV@yOT#4ScC9Xrwm<c-c_CM`Q9SYraPMVG5@=uVl&woa$jV`mJ`Es<ZZ^9e2
z^w*OP^~Vq29lIAlJNS=%xk=lIVOqYm=%*LOd|vScbRXznYpsf&&g`6?9_*izVPUy4
zbAxVwJs<FK@?lZGWkVv%2IJ&cTidn6da>eKH9x1a&{jP8-<RdGeCguk(VdFwxqG;!
zezD(sxpR2%`bUw6-dpkbkGp{c?%(pFZhkMcP~YZHTHDWNIU3P#c;q0bep1cKk@Gp_
z_nU+9@CB_}cfrZQ$vzQ<xN#%vh@M7jwE5kC8@Fcm|Ij=8ZfB3}xOl(re@`%@<P5Nr
zKV`EJT4=v^Q*8|;ZoJs2<~dz(+p3#R9VX2Fxonr3070zG@WXC2fg>VjT=L>)Z;e8Z
z)VN8qORoIc2b_4|6;|wra_^niZP7e@=fif$HCKL;&GLb}ogF;Wjo&o8Bx-HT_l?ef
z;_WcCohx_3wlNGJCw&x_hPf{Jb@Hcdn(NH)gEo%zo}YIAh+p9UpKZi1%72i3BwZ@M
zyzRvI=*R3Nv2mxg1UanqUpJ5JP2H4qqjSuxi1FvH)A{qzim*EPO3lRn#dZTdM(l+4
zfL-hGi>3Ya)3mi~7QwTRUIowAECb(v@#~htvk!5psE>XKdOYcQ#ERy9)J%W&(QD<|
zeNNZ2^~>bhCtN4dTKKfC*RzK2)k0vL9CL9!=CUq(1Mo(m_{Yoa)LHf&NpOHajgFu3
z^G=RL&GZsf{^7@w0A;`_3*LwsS9d0&=%fjgpru>X!P%31B~$;^3sN8h{$KKcwNn2C
zscktz;Vd6@7OVW~tto?Cj%U+(F|R1y%53XCJ&Lyy;Fan_>e+$j5v6zlOhZ>xG(k^6
zvXO5*a_s~K6Dy4R8aw}W$rTgipKe1`qThh4K7YOf|CqXnO%P<7Q0e=}tQ4@+XZ@<x
zBmC6EbSa#>L)S1#-I{Yjcj2smVu**;aq~Jv<j{0{c?aFKoWE0=qmBBum`RqJ>Lv-7
z=AJ^ucnc_?;3SnNf}-nK$lg8rA7wmxC#U;#KiXp18j$Sb;f`>B7x@j9PeLn)(wB;1
zgf^$2%&NSBrP`$-HlVphD`<}M8vYIhO7Zy(KApD5Y_4IO&0}iT*bPX3#;s7^t|cwR
z%prMgQ1(#~J53j?Vz1~vrM(4bLJ}MXo}N7L^h86N#(~k8-jlfeWP`@}XzGXi2lxJG
zYCQHc4<>wB$zVFUs;-wz7>jZW|5v89te~vOH+GMYeVqkR9>Lb8KioqI8Z@{&1a}Fp
z!97^;;LhL#cX#*T?!n>1-QC?Cmb?G{``>$O_fFN+R83VsbE><#-ZRzR=hY=_ZRYIt
zyR3Q9c{~ebFd7id#=!}?>M_Hlz=&&8)XWGL20(I0@%-P$nk6Zsxh2#|o-s-(cHI^5
zyrI4zEw)P?Yf`=S<g<49J(u7pj38Cjg4Bn}kO(lE(YTODMf-Z)9~&44kBtnmEu+2q
zesDW+P-FWs<Z|-@ew9!fC7*Ldot>lSwm7DQokX09WfL`5O}cHzKf3UiMbxS7IdT|q
z0kxfRlsp6+GTWk}vKAa?S15Ji4k7*8*e@>6K7F71bjn}ye-O=_9FqAhNYzZBVqgdl
zLsK9Y*O7ieoNJfOKKo6k$fGfBHR=w}J<%Esdyr62>78#Wl`POWpDnW3sU_-gv-cdi
zn*8a|@*$j6x@{GYqolB6)UB=DCPiTR9@sMK241mu5$0QI#2uSvc1>*I?(X5Mu@AlE
zagLPX9J`sIx|Zlx6N1h_8V&2*>kq<J!sT;EDc6(na3KsrFg?EU=zdvI(P(rO&RJd%
z<p>o=7vOMy`LU*!o$YdD<DN(w%0CEj`PpjcU{JF4X;wwckKd+A8c4d7+Z>l*fR6Yo
zxsB}Dqd%h?LPLWYgCK_P=*eI658Z`!Ogi)Yss@%oa36~T<4yHxOM_+-1E%@fZYm{X
zq}#!s)&X2}#xHFIt}=6<HfYVt57+XB_F)0nyk|?rC%%4Hek-e~p>u0z_&2(`_$Mqr
zN3r}vm&+)D*{tz-rf7MV=3!boK*Vo5a3V<J^Nkd2P^}tdE*m#t0Q&ru;cTJiVG$~Y
zQ8?_*pa=IC?GSZckACB>4LlAJ4;U*Szel@MdMfebLg%T8C4~d$ljF_HPwZZAIt*(9
z1vU*y?w0&U>Ow5?NtDnzXI_0&#3lB+-$;Ap5`Mj!w)Tl4NjB9ugfqLV0Qz7Fx7&xS
zS<3gViL-kBV_2Jk=hm76jLl+Z;g6JQY3>4qO&>jGj<3(-g`qh;=*w+NC_hRxVvyXb
z!jiR63C}iGT8Qq0^dOaO4AfQ3W$#6w+gBn>0`|u<cACmyA_p*hFVGedjzS(8Ut+$=
zls#j(k$-Mm>7+a5o<^722b@L&Sjl=>sBK^<Mq<Q0sr4S7uPR4j+J3myxxRFY2JLYN
zJ=f!h|MZ+d_9uvR^itIVZ3Q;teHzMvP5Z-8Q@Q9^AX(SM(M{m#P!hM%8-ZOZ5o#8w
zMvTTbC$vNbioB=MbR2<O%t=!du4(7G6Bs0^vo)zHU`&RgW8Ykr1U&8%*hu~c2~{)B
z3pa=-)SQzcXg95<CamN~+0K+v{#jNIQB9%W13@**Ug5Gr+7mqTW?*5glM}=0<xfrX
zdnI@hhh-g%rB){$kipT(@x-=|6ZT>Yn{$OdroeLq_`_p^6Jwjj7P7mr`58`Ggpqbq
z!SfIkaOYDKvrXg?01Oo6(T+X{@_6w<8-Cw(__5Df`5}Yb%x>ihd;@0oxe@jz62uiL
z#sx)4!R)mr83+=^oUHsPX#-EaXeJ}qdhrwm*pOPi8#wfuci00m3l6l1G<c(>&I)Oq
z86cVAqN1TI3v{ysk0FnAW+)ZtA6IS`)sw74(}br7_h{5Wng-D;N~?-dITeg;FC>mp
zcBzZJdeoEzBueyH&{BeL04ABSZkQwnEJ$fdpCAT=uUvAx_+t2Lt6T*+uQyPGCIe3a
zoSHKV@}jVSktvDCgI9_#o&=Sv=MlTMp<N*}a!S{))fcEP^_(q>7DD;WU7rS)ZmcY=
zE~UEike&m$_3Lz6-^gXW(NCrn)(59J6k{A}rn$U~u^{v*+XJIrD?)eJr{D(of)Nl%
z2kRifm=OA|Tph8lsd&iTl;%k(jU>V3<QL~)?)E@I{A@YeVd?gRiGmX{W;!!B4Teq|
zcSjWzi3uM;2;m2@>r?!;b(FRt_Vuh!A?GHTYJC8#_QsA5n;PWwBrVC;1M}XgePK)=
zqXY)&PL{&0;_p2lsL;Q(J=H!<Czls9(4~~@6ulcw616aYw%{c(gB2&X#GCosd{k<(
z&9iJ~s@k^UUWE)}Q5$9_fv%-mVH7W|SyyDw)2nTH&33lS^l;KwMEaS;xrLUo=~9MX
z<-7+F9K+@IM1QQaHeJc2>)$?!<Gp`!^AQ59(B}A?zUM)anZZC4q^ehWZHf-t*N=&8
z+el!<v#UQfI1=b4BC)5~i=1E6J?D7lmvsJaOl>U<Qgckd1v}#ApIZi=&O=G<k7h@$
zke$c%rcow4aTYe`aN;7R7fQw%PNt=P9cclkvmKL5lFtYFKhtc;;ksKE-w~mF+y+R<
z2D)`aRld6VzyFGPVXf#+_+LAd^c~i*OvaZXvFql7@pm7iaH?EGKfc%Uzwr;5f`6^T
z1gl*_?Mlxp<sS%s#Y_3r)#e!8iqP7ZwY83dRE}kKdtC3mMXDh+C~>{o=BX$fc)Ja_
z*dMvdWx^~f&I@{FQl53(Lvr2JO&g!W*dPW{cI!*_CYjq`wKccNC`|OP+1u|x!&R%z
z+!zg+CF2*^?6zhs5`l|cufStR#nTy0)ZHKI)cmHwJA7)*rQDlj6I3{l`)H0etj^zy
z{P;+;<U*Ew(;<(i_e!{75QJ{PU6{ZrADJ_s91Wn^LhBwwvh%BZj~O-E9=0IXY$biP
zf@n-Jg0;gPT>r?dqblIF=vhxNySJ6v>vEkmkksxrnGd{~%c9qxT5Q^}^cF~dkY(1u
zBDGGl&{AYoQBFJ_Fg)JMt@di&HCb60IW8?9n6e$Q{-{uUrPSGBwpHqF5eryjyZ%*2
zaCH^YYRFEsF)EAr6yrs2)I`{mX|zmTmbE~$gYoIF5xs*EzX;neRB}?NhMs2iG=~l(
zQ<bG_kMe}k-(Bd1TNx)_$H6y)25Wy36Y~b0sBtey-KS4!6Z%dIGx``dm-ktOs^i9?
z+or!<V~(9$w+45;-2{sq9*+avfuu}}2})8L!wM;869%+I6ov5SI!zPj#m3=ysk_Ck
zqoo%IQP!Cfg2P|$e-)DI23t=4={J$McPs9l<w`>gCm=&KlyA6PfqP<n`MABdJd?z$
z6c%?<a#X8+l3_h{moXj_Y@5toccVeFaSB`M*=E%^>VcJVCUYEI8=?oS=SP_fXf0S;
zlo#f1EVf*?EPS{UO6|o{KU<dWnWMhUTq<$4t(Y*)xNV@tJ;LWNNZ2V7Y@t0cFzcAu
zjH;Zxt#>vhT5a4L>z`2jnDL8Ivg!s~Yt%jBhpV22%;11?4row*AMfpJ%JR}QKpVt{
z9tw(9k?ar>-iE?AoO@q?!INc=!u`XtLrOXX*RZC2Y8CjFZ`7g|nNI$3wm4vjl0^hR
zrd9x%bamubHj<pQwcK($Q~%Z&HOW)P5)9Lcq*B=e-SlqF$CTP}mY%75tUL$I>_5)0
z^c$JkW;Iw=7QNRvY~&H8oREP;RoW-yC|xwfNHJ~q*!6}M>#76dnTy>mKq32C?j5!}
z^as8ww4~15w_RaJpV=;C;s!lSKdqi9Ae@<yX{piP;W%HxF*jH@C@ojG{S-B~DH<ad
zL9Ir-Yq6pb-V0ZhHhGe7mj6RWAZuxJ?sbqf|Kpe!KdWF3aKyww+ab6?7F92MK#LL3
zgilhAxvD0hB#Z^LLhZ`$j+mATQ+j)*4PUItkw^t$rx&R7v_8Za5Zmc-3zf&plCe~a
z92wXKx$4~e=3{5;VhmA_oHewSVo3#}8Tg3U^DzC`Rj^3@TrcDFSe=wDhvn$Uh_Yd4
z{gGtsZBYC{{_7A>t@ygKK=s7hu{6XWW6CL^=du`5nLG{5{1~i4CXJJ|%w@V04cOqy
z&!Jk+ooWu~q<sk9rbiR-pEH%&`HGwrtk6T4aUh_=G0JzP7EV9`9X<V#NnIMRr8Jc=
zdZ5D0UCV+c&N`qr#nFVGy)8|G=}2BcCfLS)AwuRb3kTKx_|FY&PI<{Cw_V1}t5rhz
zi<=I=j}8eiHnHWwy@j2^{i+!aN!t{pA{RCb$qvh7U%%@cn%imGhdrL7jG{DGr8bOq
zU$3zWCX60`rT!eej}z+M#0HI*=>L}hoVX<&6Xt&81+QPw`~lxGHe>0R?(*S*eVLV5
zF^U<q%W>->vy1<(nCDfJesbj4og7!>#LZ@)<T@@edQXM-*%*)SbMZZvq;@j%W1xmD
z6_;QLw$pbUHt@P&{V&X)cMPQ)m1z#CpO6=X<?e4pE2C;OBTy~E-uKNE*UT}d7w6L7
z@873YHky)Q_A96FOJG57>KP?8@~3&gwSSp_cswegRjo*Uqt^(X34KaTZ&e8XdE0cu
zpnePhZ`-{?eS84F<wKVqYe1EW$6NB?JzH{Eo$>{7a#%gS_!I9#uPMvV=KLk6b0Yz^
z?5e(Jao2DHs!QCr7#Xg3F58$)S5uKuolP}MgFYbFIqdRKmzP=sbQ7BxD!Dm*vETpU
z12ZE$H1XD)K~xXTdXunG4wLf|l5dHVmFPEM_fE>pVTc@tUNdDZ)?!cJ>%Dv}ie}8^
z1gp(?XCt2c-qEB8x&75<|1^}c!Al7{qwqcZ58OYi(zpKBgL|#h9H(vSjz=ck<>4`O
zQ(Gh(<IvW%GasXm7_6Z(r@PR}7IJ=jAsJU}D&^@@gpGCjQi%LgoDupNVl#<IEveZD
zL>7GSMyiJP#9pSqT6>8&8wc(uvtnl@1ooqljKlQDq2!Himzzdk-b&L3o6$Dx7wS;^
zZBJAaBpng^ifk`;_b~fru@nxPv3{6y3qdi{N_Lnqm}Hx04W^I9xwR_!^3saYD?Y6z
zXEJ6`XXW2WgFXSj47uCNn}&X@RHSwR@o7_T$=|WPU%d5hJC?W>-P_hE)h((ZH)fb6
z7#Lp9$-Tur+(|6t`kdI>zRD3;ydanp#*21&kL)TV-by8KdeN24KGGL=I-Lv_A2Lr)
zLaKMloyWI5fySPqvPN<!5?n?!8;tk<?xa(bBDD;>JAwV?{X)-XZ}ZVSySDliaAwJU
z5Lli(9XXQ?@%J#h!Qq$<e-OuC#N0AFhwNs#AViM76f^Vf4TreDf$1Fjlke;{q+&Xw
zK4twotjqkIrH?A_MIh}glklW<7G)>MkCa2AcFDe`u`+iC#o%lrBEep4{{Um?u?M2#
z<NG2oIO(iR22oZ<Z)F{q{?pYjz;M6n#c}47lF+w}=Bm+?d?KsJuOXK@)ASMO(!;74
z?pQzlB;5_$B}{%rB8~hMa8Jaj;B%2}Y{MLv<7A=Sjr^h&>^3o}C5`Kup=or#91`GB
z`((bA_Imokq$XT$f05tQd^JN*2>DDAK~N?;#A3qLGd0I<B)qN^TwvUd1I&D};Ev}N
zB{N&>GLS$5k<%CxCG1997^$4O;zSKoC7mzHaGi?c$6oi+NRFGJ>}>Tnsd?Y}k({&S
zS`nEtreCynY+bTE=LmK5;!}qkMmZpGP&fU|w<m6mG1xDkv~b1Vd?L&|etzn0uYw02
z3c>}ISKszx1L{@;5kxau0pPLc1(l7)UFjniEH>QXUCRl!Kpg+EkY#GQeCM^D{JrIj
zOF36k6kdHzOda65#tbtukT~=5;TH*3dl>~1M}5&S$rz>#Gc!s-rEZfufg2pQfIVz%
zA!MD+Rr4MPY=%~5ougJikY?xWlRvq}Lp%U2iRGD<H!>kD*x@Y&)aRS9>siqC+}N$T
zVpY~jA8p@H_jgwNcwMs3aMmXE0+-<50>=?s8@~iX;Fup=Llb!8_uErdyT55=vhxJ&
zG1eiKKTurR``AdWiRNYiSOSXt>dbKhgnDVa{d)|^W6qIxw<~Wv%L2pHG-rqMPWP4h
zdBQq!LQPyAIt*n1okra~HaG6lmO!di3>GxU>A+DqBZ<yql%NF^b?x<v3&P(xW(7J@
zC3m>HTYs+4ff-s)w<g><WGgC?4i31DNeK9gb)vl(7ZdRX@cZDvknYWD7R4>T6hw%o
z-_xm=JQ!vZ*bN-c4=q1*yAqE%zO~yBSPgYwR7;7>&#cM-+7KZhzpm`bMq9+pN|I%g
zk{iTM1k-^wmUn1`g1w>A*%Y`0x-JKB8QipaY+laGWI(++rx3P(AIpD7oe}Oof7hN)
z<0K|LI`5c3y6<6IG$JXA>!x@3W1p}AV>~jZ{LOvb1b7&9dI;)5t*q@ZMn|%f;NL-Z
zBX^{3A}Bcnwyy2&ghc0p+Y+k7=YIfS{2aYMJden@Y1K?nu$h$x@In&u{j?9;k)SzV
z45Qq;pzgHa5M{V_lK1u8B%Rw}L#;(30s%;-^P+p%moY}0mZOhd6tjDg+h=&9jt}kf
zw6;pY0<*~Oe@BQM7P_Uepve63G^mOC8+P**9MwJnVSbQaa-YZ_*TU~p<(Plc+IKP7
zs%hxl`o|dQTz2BASQoZdCO?-)Mwlq`Hmn%!xqGBYMqseJBKl2yhqP+<<XFm=&l7r$
zHu!ob3pWhAF|nv^C;>SUNFR^GVD!Sb^L|Qh&+gjV$$4(#+uo%krCvI1mzH*dCLDXR
zT|KlBfIJnv4`Hy7-TC_-{Az)qnI>(}l$$v2y+&U*PO|%@c;Qr$g1Vd(Gr*mrycvxa
z0^M=CK#Tfm@UTjH=t3C=Lqmpw^SWIj2sKn3B>xj~)CI&_3~~BXs6FRRKW%^A^-V{T
zAL_xW^><pdI@eCJaex`dqr3DFe^bj<gXhFNVB84v<Z`Lht~x>cBTOMOJa1;kZZyB|
zs||Zim{E6qajl!iVKdT#ooxS&3-)ZB7x9qfQ_6cvq#0J~aZ+HH0-b2K?8b2%)ez`c
z&<Im4&c3!^2`<pQ?!+l+2y-BIx_*RR(9@J&fx{vc(1H@bQ1H!!5z|-$PzQe7ObSv0
zbPOH26mORXGz)#r6R*a(-{&9Jfl!&G)x!x!h@$EO&#_FsuN^W`G!`Z^g^*RttdEDP
z&*<Hkwm1n-6o+F0Rkfqp9n2v+#EqB;htN<}H4V;E{uxAw8cqE&03<ksu-pY~i4l$%
z;CMy9jAPe1aqj&?V6d*Xe*I%+g=HH+Zs6uwE)9nEcT08#>unB83_O4$gT~Y4a=xdi
z37HJ5u=*?owUTydpqTSl=0mqDUq~SSDhCfM664+XWhEKdRUU1V1h=4IVqQ_y#=80*
z!DAe^1%Nhm6h8Jz#3?^+c%Wu?VYD_+6FZAE96elW2`Uou0{qOChWRQl7IVNN@UT=g
z+g^tPz!|}{l+5k;Q>D8N`B4^zRNQazzRri~JUO=YqCoVyJ8q;+v^?VjJI~k#&Bsbc
z&rV)^DY}2(EyoZk@WvL=Q^ok_D(K14=G*yHu#V1IM(L*8n<&YuT?n%vz)7nKoVkB&
zvXX<97?G&YAISeIwlVqoZUX_X5e=QH{T68v@>^<D=D~H(pDCjUmF;!lvI87Myh}Vt
zn?x*f)E$X1W9^#DzB%*5{6Y3R6~9?A611;<v{~n4bK26EwNhlzunM%DE+$#8WFyKV
z*7PU7jX*ySbdaxR)|3$D+wOX5-|x$lOL2@+)S;>_sQ`}CUtDURR)B+dLm_~PEwa<Z
z`stwT%sTAnQtiY~-V+L0<niT&QD<K0+)8Jmk2ouR+Sn_MB{R83Rr01$l5E-5jjSJ_
zG#utV9o4~cQDV({O|v!2@-Td%*$#Z0KeM%b@pd}Q0Ek<nY-CFX?4|pgRP%OqtX%B0
z>=;=glLEpjUL!lFGk^nqlP~tf*=ALl#e5gmeXC=;*6)SIL_=GNf3xsg<meDH0vR$m
zKavpUN+;29vyXJRZD!DtAlmJM0ZVjN<ge0hV^#tG7;5NS+GtDAOwY?(tS^ZrMK&<|
zlJjIFEoBU$&X<IoB-D3<{-$IzhMK!f;0~FWr-{6}igmT|6)+4hw0}lZZ{lIH4t;QF
z#IKCt7^(XmC^J9bsUae{YGJCgijG6SNokmJ!8@Lb*M|l(_Mw2aBicm{d(#T(HCZYD
zTT`_4<?MbwT$|%_&dszv9pV~K-LGO^!c~<YrE<}B>;@*NQXjtMQN&(ig?e~MW(<O`
zJHLsubf47koC91+V*K1iJb^g`df85&t$pf;R;nHB{e`9y<M@d68qwDzazMr8kUOPM
z+`lGp^+ON7x|xEj;$Qk0h2qt19ti5NxAGyXd!vbr=qE0>s2iZPQi#L}HDHBLyc+DU
z&EIY=N>5!RTmuCV-M_!)+_*9wR+q)^4~Ao^98PL4z5vhmDrZ^5#uZUYsrpZ8tpSXU
zQ2t*ZCD9|1Sh4@&*nS!1kx=At*N3LvM;Bo;LZT`W<w)p%bLPqnNlPkZ%lxaO&n<1D
zdsCR)`9nl{(GDhx`3{}6c8V{+x`JfMVVh40A=zB+XS~lDEPq<dnz|cg2_bxuTgJ?h
ztdwm28XM4rnpYgS*g%I(L5RNp8s8Ccbm119;wc}L##=rdkRf#==T0fT{xN!9aIBzW
zV_L(&HiVgeEivk^)m|ijQc_v#bMy11vTZD%FL$5;q2FF@1O)BSv+JrjH)(rjDtMh!
z<we|%#C&WPEpi9pBI&4A1gmWfNoCgH@jHWz{4g+icPl^Iag?5ZMsz~hT93J-w962W
z4PsXjy~(Hi;!~?C9H)S5@sOzU=_RSYT<z)GQ{idGX-VwVi(f9(Br@^X=>37iMF`q@
z6DyLLCHdr$I>)>M<JeCoteG^&SyiF#<gLFv>IN|IjMy@5+eAMPo2j7g{NgyKE*vl4
z599$Z;plKQ&OF6a--%_t;U7AawKxaf4TNH?K3&nop+%WouIpv8pc$x4A5soS#yl_(
z%0&OE9S5!n?hN*Y4+}GwnMOk`I(**DuGZkYlRcVmK)D#IK2Lk>Ge6eC%5O{FDtir)
zR4KLHFb~?GGI-KalYMv89=IypzsL(d@&*A>(wtvd-RriEnjKcUFfq0cdQ`88c+CUr
zVYwQb&B4(TOta<)k<T$Gx6Mx^kQ+o>9|TQ#M>8F-_4FPA&$dmu_F6M`&vM35W<GIy
zbX81ydfXdS!}Q=q|4GvKba!ZCitsN($`0oY9U>hry9N2CAAA|{{@+?Q`KiJyYHxr#
zpJK}KS*gZg`S=yeq;y;KC}RoIZKF&uw%PWTcKCU(ds0?A?NbwsZu_@!OVQ%6E&O`*
zjH*b&=)+uWmLq<*I6biV6eQ1riEKM~{w0>QW8>N>XAR|mMLCfu39^`Wrj#@Rc-&Rd
zf7**9EPNDJIE>U^IRY0c_qd|ltO2r-TuyYIHGEqSfj^V2?i-^6pArair~-y;e91U9
zBigC=BWQBL_szkW6u(HVaYq|4t9*z3&0CTxNxrN^ANbTS^j=>t4ZYiJKRUoh{E~X!
zm7&jWW)d}JBNB%4b_qxP@%>xb+3Xwx(23_n)QC=303!L$AR2aJHaPf{Bn%KEW1`%R
zO4vz-k{w{OV5^Pe*A&*Y66}v;a%dRwpsdcrCuRzHs)eCt{xJ_69<ITV=%xIcnZ{-E
zx6b|0*l|SU;AIJGhSiil_0q|+!W}|LlpUsA1L5F1e$iAIGiz@_Zkl2ig~D33T<1zp
zIdMkdD;*5-DTc@R)b-5PLIWUK9)iQyz-@(kY4Zh_$e|z91G;<764llxK<kjBVl!xk
z?60k}caGKy>=f);g<hs$7})lXo^(hvtXP}W=3f|D;pZ<Ao;ghq{l?TVmXKEQmqrqV
zozxor72yTiTxW8rWt!qRzwuQLI$7qU5P_%qcg_TBMf}*cqf|l1L3)5GS`~_(S0#1z
zGq%NU8M^Tq+USbHGllESGmLs`9@p}Ob31W5{=py*5iuqG>H2y)GQ?dDE0H72gAZ>*
zK)(Zu$_Lv8!WqWTTwHN2o%htUb0{PJ%ad|i$Y<?WGyWp#lvL6(&j+Ls$1BQAKLwZ3
zMRPvA?})l6m~~3=Z=V3LKN2PTVQWUu9Ybynkjk)ZC{RF?1*;=FJUmV01u>~lUN(O=
zAiQTFe%{iDt`VCMhsklX!YP<x*vtKcczOF?DMcMcCDx;?&igj;u&nAY)QJZJOR_fO
zpn9{Jc(=V)1ne}2*vV8Wjf9%=?;s6g+Do^gLisX3lBH^kfw&f6H2k9W4_4(|B%$dW
zs)95WGzJI+f(H@&_Rt)xY*c+;_W%{3fIw95Z|&_28C4xEEexz>jje3#T!kzxZ43<@
zZ0s0CWDP8gWz6gy>=_(f9MV;nte3<;dfuraZ}Uoc)AW9rgcMhdqnP`Ir~5tTawj-z
zAifqstc1*X4j#BX<EzQr8Bm@4BK%RKg>?_?xp%!C2ex}sFP>@6_TtXEYB241v3tFJ
z=KH+hsg%b;s+O-Jnb4|MToz=6eegSsm$Ll3GP#Au%CMz_9b#>A+1HXkDjHEGX7sd8
zE_o{P7~$Z++OoVnJIMp?VpTf{SxLzY2`!Bo1uAUW97I5+j4B&L72?Bt`2|78CQHH?
zDPi8+yg$R=$p!PuWSsFd*d)8dq~nKE9!E5l7?0W9pk!kQ$>1_*e%oX+90;)=+09j=
z%jPSIe-@@1asIq?;gDV$e#oibc7y*5v^sO{S57cl0G^KN$ak`C(b_K2MWt3oZl7o8
zEPG&zhp_;<5^XgU>FvLw;2_RgL}t=YD}ifvI=|`^ne)4<C#H(nU@X-xtHAuspB<9&
zm#guLGwY@-tE9VX_0Wf#svf|2QqkML7HgEn+G(3+s54fKL!q-iS=YAAR9@DZIfA~a
zjMCW_EJyUd*oalbTvFgDf{Nd+rKgpBoLs68%qa%4#ydi+!vv!UCh5*AtfbYaS%sfZ
zQ4abd3SN0hB%lMaSE2#2K<95nmSeavjp;BX$b+aLlNQ!~EY3Q<sbsBsj%?|lZeF4h
zCyQwMq<YFu`t|UiM=^c4dgZq!osRdd;frW_E^+RLPzSP-(M0RHoWs0LuJm_<ASu*A
zx0b*e4Jh(g0CqTh4=0&zxE_WaO25I^&d>IoXqCxEk2Niw88W0Pj}hd*T&VRkY!7}X
zptL7P7_^8~BhMwlm+wFY=@@m*N;D@U@*BxPy@3aA`EL8J+o(Fnh|^GV+AhNhLWn>6
z5ZGz|fm|~d;Hn<KU`J--o7ns{jT#Gu_R0sK_7cX>8E^`U6trSDZ69akrEbTDaqM4>
zSfi_5W~P@I&2|J%fiJ8bZoSxW+wjugxH-8NRLSS8-WJ*SH8wpQ#3MFjcey|Ap3sxU
z(uLaB6~!D@0d2zq<N>rC#y7u(R0<^h9&6eppw$AYVd4J9E-bGNZEkKhVtEKn5VQeM
z7Ttzr!7bI1tc@|7u$XUv_;~6X<6gaC?^A3jN2cuD{g)s1gwRFtoY#9k)IWwlw1@Eo
z3Un4HOxwU@l1zH`f50|Hz2G`Rk%P}v*5nweZ^wyroc?B9Xa0s;Vcbrzhm-Bd+AdEM
zPiMy^p7|2+z26Dv+bi;~xxb&wQ)T}ET`qx`rR@hTta5Gl?$(^w1gUq<dYJ^dIB62d
z*~Uce@mhpPX{YKg+Ar|(IJU#r$B<J{P&+@h-M{d_z8Gh9-{4k+%VW>H_M|$WCzKp^
z^Gu1gnn*rUYe?46C782|9g~GR+G$py-gTbBIZr?Nh(@^Y$1+v(i8#;3iks>H%cC@1
zxPDLx1Mn0ikK#g?>szP%ZVQX6vO={Z@)K_$AJayXG~0l?+j7T!OVlwj@)lv<j8TSq
z)Od5FRtfX?zNN1)7kt8zxWNzQ0;@*l#B=4#5>rus76+{R$pQw&n+N-=5B-@SMyOls
zdt}xH7`d+>hr~_W<c`Sk5l<I^+Sejt0leS}+*|^@1e?(Z&jW9;R8H~@-ik)~+KkyY
zxBvZy*jJO=jr!>kc(zpzg(de_I+bWX@+_P9H~v3HLJ$-n^Hn!2o?e<MZy+>0n7(Vb
z2RJOZWQ2}x-&tFg^$+?D*m#E}2gk#Gi+_lJ)Roe;$owS0f#cc=m(LAw@mR{bk@~Ld
zS_3m!3#nscx0m0ahP)ZC3(vTm^_2C=&54)d&`>La>ZImcKg6TD*=rqt&oCo4@|QpV
zt*<hBRKPD+uVop`E$jZ%t9DXnB`&qm)9FzmqJ{x4YeD)F4(9BV`_l4HBjzseCh`4b
zFjOy|KqnS^aOU2Ev+pwy662h<DvDL@doj<br=oLYs3y_|<;iQ9NX6?6+~d#Ai6lUA
z@LLunDuY=_MARUSIwo|~H%WLq6bLcr+4%W(T~U?4%XcJrzOfOU{2lLf8m!q+GOd;S
zsx|%CUbA1fzy2k2J~-1Uu-{83KPXLp?G56eRR-|T942z!ka?FE+xMI7KgtY)shNYB
zskM!r@s#`!cxrBQQl4f6ED6DaaU%q2&=lMi+yui_d?8fKRUF(~d|})x4jY)@R*YHf
z5|8tlm>OYJLPnB)a*~#TYHN~~R&G>Yat3M-5|qgNDu^EhI0-fYPC_G`=n#+sQ2(WZ
zWZ@o~?-79@6Nx2-Fabj+!T%tF3ex}6@E`K|yckGRi3I}v-~@q4|3UdbSDsJ$f8;2M
z35mW}z_v2_cOanCmO65Y4FcthgFqDjjeCFQ`9y^Or^rMkgyg=7$;f~Ee?T?R6{$D^
zL7>7H2oTA?FnjX<jS2jV=8M|6xSE(*8vlEgBiN_0VUQq@G&BfA{x3itI-&p2eKL|F
zVsgr2|41PI8To&Q00aX5H|?K;JP|@<{7+0XYeP#%BV)#Y22#Ec%@~J3JU1yMh>ZjZ
z#PlyQ%KQhOo*m<V1D!1Ntc<Pn4E~V;G5q{z{QoO)`tL8~`AjQ`{QtWkQISdLv+jT8
oUjIHR{s+OJ@gES3|1(7tq+#B3HxTFw>I!Ov2Ljak-VOx%U#V;{T>t<8

delta 175
zcmWN^Cl0~@06<aNviIJ5?>)*Ufg7Nz30FWPe!ydp8~{tgDezSUN5U!SbMJP)h@baK
zJR%?>p~rv`6J{(}v0=x76Blkgc=6#UK#&k&B1DN1Cqa@FX)<KVk*7eB5@jk>sZpmv
zlNN0{bm`G&z>pC#V<t?QF=xT@vDzQ5+u$a8R+aTrRW>i#Z!qdKKj|lZWkI()thD_B
D0}?rm

diff --git a/ext/vk_mem_alloc.cpp b/ext/vk_mem_alloc.cpp
new file mode 100644
index 0000000..3fd28ba
--- /dev/null
+++ b/ext/vk_mem_alloc.cpp
@@ -0,0 +1,3 @@
+#define VMA_IMPLEMENTATION
+
+#include <vk_mem_alloc.h>
diff --git a/guide/src/SUMMARY.md b/guide/src/SUMMARY.md
index 6c9363b..bdbb798 100644
--- a/guide/src/SUMMARY.md
+++ b/guide/src/SUMMARY.md
@@ -33,3 +33,8 @@
   - [GLSL to SPIR-V](shader_objects/glsl_to_spir_v.md)
   - [Drawing a Triangle](shader_objects/drawing_triangle.md)
   - [Graphics Pipelines](shader_objects/pipelines.md)
+
+# Shader Resources
+
+- [Memory Allocation](memory/README.md)
+  - [Vulkan Memory Allocator](memory/vma.md)
diff --git a/guide/src/memory/README.md b/guide/src/memory/README.md
new file mode 100644
index 0000000..b58383a
--- /dev/null
+++ b/guide/src/memory/README.md
@@ -0,0 +1,5 @@
+# Memory Allocation
+
+Being an explicit API, [allocating memory](https://docs.vulkan.org/guide/latest/memory_allocation.html) in Vulkan that can be used by the device is the application's responsibility. The specifics can get quite complicated, but as recommended by the spec, we shall simply defer all that to a library: [Vulkan Memory Allocator (VMA)](https://github.com/GPUOpen-LibrariesAndSDKs/VulkanMemoryAllocator).
+
+Vulkan exposes two kinds of objects that use such allocated memory: Buffers and Images, VMA offers transparent support for both: we just have to allocate/free buffers and images through VMA instead of the device directly. Unlike memory allocation / object construction on the CPU, there are many more parameters (than say alignment and size) to provide for the creation of buffers and images. As you might have guessed, we shall constrain ourselves to a subset that's relevant for shader resources: vertex buffers, uniform/storage buffers, and texture images.
diff --git a/guide/src/memory/vma.md b/guide/src/memory/vma.md
new file mode 100644
index 0000000..8226d70
--- /dev/null
+++ b/guide/src/memory/vma.md
@@ -0,0 +1,65 @@
+# Vulkan Memory Allocator
+
+VMA has full CMake support, but it is also a single-header library that requires users to "instantiate" it in a single translation unit. Isolating that into a wrapper library to minimize warning pollution etc, we create our own `vma::vma` target that compiles this source file:
+
+```cpp
+// vk_mem_alloc.cpp
+#define VMA_IMPLEMENTATION
+
+#include <vk_mem_alloc.h>
+```
+
+Unlike VulkanHPP, VMA's interface is C only, thus we shall use our `Scoped` class template to wrap objects in RAII types. The first thing we need is a `VmaAllocator`, which is similar to a `vk::Device` or `GLFWwindow*`:
+
+```cpp
+// vma.hpp
+namespace lvk::vma {
+struct Deleter {
+  void operator()(VmaAllocator allocator) const noexcept;
+};
+
+using Allocator = Scoped<VmaAllocator, Deleter>;
+
+[[nodiscard]] auto create_allocator(vk::Instance instance,
+                                    vk::PhysicalDevice physical_device,
+                                    vk::Device device) -> Allocator;
+} // namespace lvk::vma
+
+// vma.cpp
+void vma::Deleter::operator()(VmaAllocator allocator) const noexcept {
+  vmaDestroyAllocator(allocator);
+}
+
+auto vma::create_allocator(vk::Instance const instance,
+                           vk::PhysicalDevice const physical_device,
+                           vk::Device const device) -> Allocator {
+  auto const& dispatcher = VULKAN_HPP_DEFAULT_DISPATCHER;
+  // need to zero initialize C structs, unlike VulkanHPP.
+  auto vma_vk_funcs = VmaVulkanFunctions{};
+  vma_vk_funcs.vkGetInstanceProcAddr = dispatcher.vkGetInstanceProcAddr;
+  vma_vk_funcs.vkGetDeviceProcAddr = dispatcher.vkGetDeviceProcAddr;
+
+  auto allocator_ci = VmaAllocatorCreateInfo{};
+  allocator_ci.physicalDevice = physical_device;
+  allocator_ci.device = device;
+  allocator_ci.pVulkanFunctions = &vma_vk_funcs;
+  allocator_ci.instance = instance;
+  VmaAllocator ret{};
+  auto const result = vmaCreateAllocator(&allocator_ci, &ret);
+  if (result == VK_SUCCESS) { return ret; }
+
+  throw std::runtime_error{"Failed to create Vulkan Memory Allocator"};
+}
+```
+
+`App` stores and creates a `vma::Allocator` object:
+
+```cpp
+// ...
+vma::Allocator m_allocator{}; // anywhere between m_device and m_shader.
+
+// ...
+void App::create_allocator() {
+  m_allocator = vma::create_allocator(*m_instance, m_gpu.device, *m_device);
+}
+```
diff --git a/src/app.cpp b/src/app.cpp
index a9e63e5..a0f3b5f 100644
--- a/src/app.cpp
+++ b/src/app.cpp
@@ -228,6 +228,10 @@ void App::create_imgui() {
 	m_imgui.emplace(imgui_ci);
 }
 
+void App::create_allocator() {
+	m_allocator = vma::create_allocator(*m_instance, m_gpu.device, *m_device);
+}
+
 void App::create_shader() {
 	auto const vertex_spirv = to_spir_v(asset_path("shader.vert"));
 	auto const fragment_spirv = to_spir_v(asset_path("shader.frag"));
diff --git a/src/app.hpp b/src/app.hpp
index 7f5d47a..6532cbc 100644
--- a/src/app.hpp
+++ b/src/app.hpp
@@ -5,6 +5,7 @@
 #include <scoped_waiter.hpp>
 #include <shader_program.hpp>
 #include <swapchain.hpp>
+#include <vma.hpp>
 #include <window.hpp>
 #include <filesystem>
 
@@ -35,6 +36,7 @@ class App {
 	void create_swapchain();
 	void create_render_sync();
 	void create_imgui();
+	void create_allocator();
 	void create_shader();
 
 	[[nodiscard]] auto asset_path(std::string_view uri) const -> fs::path;
@@ -61,7 +63,8 @@ class App {
 	vk::UniqueSurfaceKHR m_surface{};
 	Gpu m_gpu{}; // not an RAII member.
 	vk::UniqueDevice m_device{};
-	vk::Queue m_queue{}; // not an RAII member.
+	vk::Queue m_queue{};		  // not an RAII member.
+	vma::Allocator m_allocator{}; // anywhere between m_device and m_shader.
 
 	std::optional<Swapchain> m_swapchain{};
 	// command pool for all render Command Buffers.
diff --git a/src/vma.cpp b/src/vma.cpp
new file mode 100644
index 0000000..36a67de
--- /dev/null
+++ b/src/vma.cpp
@@ -0,0 +1,29 @@
+#include <vma.hpp>
+#include <stdexcept>
+
+namespace lvk {
+void vma::Deleter::operator()(VmaAllocator allocator) const noexcept {
+	vmaDestroyAllocator(allocator);
+}
+
+auto vma::create_allocator(vk::Instance const instance,
+						   vk::PhysicalDevice const physical_device,
+						   vk::Device const device) -> Allocator {
+	auto const& dispatcher = VULKAN_HPP_DEFAULT_DISPATCHER;
+	// need to zero initialize C structs, unlike VulkanHPP.
+	auto vma_vk_funcs = VmaVulkanFunctions{};
+	vma_vk_funcs.vkGetInstanceProcAddr = dispatcher.vkGetInstanceProcAddr;
+	vma_vk_funcs.vkGetDeviceProcAddr = dispatcher.vkGetDeviceProcAddr;
+
+	auto allocator_ci = VmaAllocatorCreateInfo{};
+	allocator_ci.physicalDevice = physical_device;
+	allocator_ci.device = device;
+	allocator_ci.pVulkanFunctions = &vma_vk_funcs;
+	allocator_ci.instance = instance;
+	VmaAllocator ret{};
+	auto const result = vmaCreateAllocator(&allocator_ci, &ret);
+	if (result == VK_SUCCESS) { return ret; }
+
+	throw std::runtime_error{"Failed to create Vulkan Memory Allocator"};
+}
+} // namespace lvk
diff --git a/src/vma.hpp b/src/vma.hpp
new file mode 100644
index 0000000..ada2568
--- /dev/null
+++ b/src/vma.hpp
@@ -0,0 +1,16 @@
+#pragma once
+#include <vk_mem_alloc.h>
+#include <scoped.hpp>
+#include <vulkan/vulkan.hpp>
+
+namespace lvk::vma {
+struct Deleter {
+	void operator()(VmaAllocator allocator) const noexcept;
+};
+
+using Allocator = Scoped<VmaAllocator, Deleter>;
+
+[[nodiscard]] auto create_allocator(vk::Instance instance,
+									vk::PhysicalDevice physical_device,
+									vk::Device device) -> Allocator;
+} // namespace lvk::vma

From d87b2e66aed313a98b3e979de4d85a286adbcb4a Mon Sep 17 00:00:00 2001
From: Karn Kaul <karnkaul@gmail.com>
Date: Fri, 28 Mar 2025 21:41:45 -0700
Subject: [PATCH 02/11] WIP: Buffers

---
 guide/src/SUMMARY.md        |   1 +
 guide/src/memory/buffers.md | 127 ++++++++++++++++++++++++++++++++++++
 guide/src/memory/vma.md     |   3 +-
 src/app.cpp                 |   1 +
 src/scoped.hpp              |   3 +-
 src/vma.cpp                 |  73 ++++++++++++++++++++-
 src/vma.hpp                 |  52 +++++++++++++++
 7 files changed, 256 insertions(+), 4 deletions(-)
 create mode 100644 guide/src/memory/buffers.md

diff --git a/guide/src/SUMMARY.md b/guide/src/SUMMARY.md
index bdbb798..ff1f5f3 100644
--- a/guide/src/SUMMARY.md
+++ b/guide/src/SUMMARY.md
@@ -38,3 +38,4 @@
 
 - [Memory Allocation](memory/README.md)
   - [Vulkan Memory Allocator](memory/vma.md)
+  - [Buffers](memory/buffers.md)
diff --git a/guide/src/memory/buffers.md b/guide/src/memory/buffers.md
new file mode 100644
index 0000000..3af220e
--- /dev/null
+++ b/guide/src/memory/buffers.md
@@ -0,0 +1,127 @@
+# Buffers
+
+First add the RAII wrapper components for VMA buffers:
+
+```cpp
+struct RawBuffer {
+  VmaAllocator allocator{};
+  VmaAllocation allocation{};
+  vk::Buffer buffer{};
+  vk::DeviceSize capacity{};
+  vk::DeviceSize size{};
+  void* mapped{};
+
+  auto operator==(RawBuffer const& rhs) const -> bool = default;
+};
+
+struct BufferDeleter {
+  void operator()(RawBuffer const& raw_buffer) const noexcept;
+};
+
+// ...
+void BufferDeleter::operator()(RawBuffer const& raw_buffer) const noexcept {
+  vmaDestroyBuffer(raw_buffer.allocator, raw_buffer.buffer,
+                   raw_buffer.allocation);
+}
+```
+
+Buffers can be backed by host (RAM) or device (VRAM) memory: the former is mappable and thus useful for data that changes every frame, latter is faster to access for the GPU but needs more complex methods to copy data from the CPU to it. Add the relevant subset of parameters and the RAII wrapper:
+
+```cpp
+enum class BufferType : std::int8_t { Host, Device };
+
+struct BufferCreateInfo {
+  vk::BufferUsageFlags usage{};
+  vk::DeviceSize size{};
+  BufferType type{BufferType::Host};
+};
+
+class Buffer {
+ public:
+  using CreateInfo = BufferCreateInfo;
+
+  explicit Buffer(VmaAllocator allocator, CreateInfo const& create_info);
+
+  [[nodiscard]] auto get_type() const -> Type {
+    return m_buffer.get().mapped == nullptr ? Type::Device : Type::Host;
+  }
+
+  [[nodiscard]] auto get_usage() const -> vk::BufferUsageFlags {
+    return m_usage;
+  }
+
+  [[nodiscard]] auto get_raw() const -> RawBuffer const& {
+    return m_buffer.get();
+  }
+
+  auto resize(vk::DeviceSize size) -> bool;
+
+ private:
+  auto create(VmaAllocator allocator, vk::DeviceSize size) -> bool;
+
+  Scoped<RawBuffer, BufferDeleter> m_buffer{};
+  vk::BufferUsageFlags m_usage{};
+};
+```
+
+`resize()` and `create()` are separate because the former uses the existing `m_buffer`'s allocator. The implementation:
+
+```cpp
+[[nodiscard]] constexpr auto positive_size(vk::DeviceSize const in) {
+  return in > 0 ? in : 1;
+}
+
+// ...
+Buffer::Buffer(VmaAllocator allocator, CreateInfo const& create_info)
+  : m_usage(create_info.usage) {
+  create(allocator, create_info.type, create_info.size);
+}
+
+auto Buffer::resize(vk::DeviceSize const size) -> bool {
+  if (size <= m_buffer.get().capacity) {
+    m_buffer.get().size = size;
+    return true;
+  }
+  return create(m_buffer.get().allocator, get_type(), size);
+}
+
+auto Buffer::create(VmaAllocator allocator, Type const type,
+          vk::DeviceSize size) -> bool {
+  // buffers cannot be zero sized.
+  size = positive_size(size);
+  auto allocation_ci = VmaAllocationCreateInfo{};
+  allocation_ci.flags =
+    VMA_ALLOCATION_CREATE_HOST_ACCESS_SEQUENTIAL_WRITE_BIT;
+  if (type == BufferType::Device) {
+    allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_DEVICE;
+  } else {
+    allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_HOST;
+    allocation_ci.flags |= VMA_ALLOCATION_CREATE_MAPPED_BIT;
+  }
+
+  auto buffer_ci = vk::BufferCreateInfo{};
+  buffer_ci.setSize(size).setUsage(m_usage);
+  auto vma_buffer_ci = static_cast<VkBufferCreateInfo>(buffer_ci);
+
+  VmaAllocation allocation{};
+  VkBuffer buffer{};
+  auto allocation_info = VmaAllocationInfo{};
+  auto const result =
+    vmaCreateBuffer(allocator, &vma_buffer_ci, &allocation_ci, &buffer,
+            &allocation, &allocation_info);
+  if (result != VK_SUCCESS) {
+    std::println(stderr, "Failed to create VMA Buffer");
+    return false;
+  }
+
+  m_buffer = RawBuffer{
+    .allocator = allocator,
+    .allocation = allocation,
+    .buffer = buffer,
+    .capacity = size,
+    .size = size,
+    .mapped = allocation_info.pMappedData,
+  };
+  return true;
+}
+```
diff --git a/guide/src/memory/vma.md b/guide/src/memory/vma.md
index 8226d70..25e90c7 100644
--- a/guide/src/memory/vma.md
+++ b/guide/src/memory/vma.md
@@ -26,10 +26,11 @@ using Allocator = Scoped<VmaAllocator, Deleter>;
 } // namespace lvk::vma
 
 // vma.cpp
-void vma::Deleter::operator()(VmaAllocator allocator) const noexcept {
+void Deleter::operator()(VmaAllocator allocator) const noexcept {
   vmaDestroyAllocator(allocator);
 }
 
+// ...
 auto vma::create_allocator(vk::Instance const instance,
                            vk::PhysicalDevice const physical_device,
                            vk::Device const device) -> Allocator {
diff --git a/src/app.cpp b/src/app.cpp
index a0f3b5f..e311fe4 100644
--- a/src/app.cpp
+++ b/src/app.cpp
@@ -77,6 +77,7 @@ void App::run() {
 	create_surface();
 	select_gpu();
 	create_device();
+	create_allocator();
 	create_swapchain();
 	create_render_sync();
 	create_imgui();
diff --git a/src/scoped.hpp b/src/scoped.hpp
index 462d6d9..73b6dec 100644
--- a/src/scoped.hpp
+++ b/src/scoped.hpp
@@ -4,8 +4,7 @@
 
 namespace lvk {
 template <typename Type>
-concept Scopeable =
-	std::equality_comparable<Type> && std::is_default_constructible_v<Type>;
+concept Scopeable = std::equality_comparable<Type>;
 
 template <Scopeable Type, typename Deleter>
 class Scoped {
diff --git a/src/vma.cpp b/src/vma.cpp
index 36a67de..09aa9fa 100644
--- a/src/vma.cpp
+++ b/src/vma.cpp
@@ -1,11 +1,82 @@
 #include <vma.hpp>
+#include <print>
 #include <stdexcept>
 
 namespace lvk {
-void vma::Deleter::operator()(VmaAllocator allocator) const noexcept {
+namespace vma {
+namespace {
+[[nodiscard]] constexpr auto positive_size(vk::DeviceSize const in) {
+	return in > 0 ? in : 1;
+}
+} // namespace
+
+void Deleter::operator()(VmaAllocator allocator) const noexcept {
 	vmaDestroyAllocator(allocator);
 }
 
+void BufferDeleter::operator()(RawBuffer const& raw_buffer) const noexcept {
+	vmaDestroyBuffer(raw_buffer.allocator, raw_buffer.buffer,
+					 raw_buffer.allocation);
+}
+
+Buffer::Buffer(VmaAllocator allocator, CreateInfo const& create_info)
+	: m_usage(create_info.usage) {
+	if (create_info.type == Type::Device) {
+		// device buffers require a transfer operation to copy data.
+		m_usage |= vk::BufferUsageFlagBits::eTransferDst;
+	}
+	create(allocator, create_info.type, create_info.size);
+}
+
+auto Buffer::resize(vk::DeviceSize const size) -> bool {
+	if (size <= m_buffer.get().capacity) {
+		m_buffer.get().size = size;
+		return true;
+	}
+	return create(m_buffer.get().allocator, get_type(), size);
+}
+
+auto Buffer::create(VmaAllocator allocator, Type const type,
+					vk::DeviceSize size) -> bool {
+	// buffers cannot be zero sized.
+	size = positive_size(size);
+	auto allocation_ci = VmaAllocationCreateInfo{};
+	allocation_ci.flags =
+		VMA_ALLOCATION_CREATE_HOST_ACCESS_SEQUENTIAL_WRITE_BIT;
+	if (type == BufferType::Device) {
+		allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_DEVICE;
+	} else {
+		allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_HOST;
+		allocation_ci.flags |= VMA_ALLOCATION_CREATE_MAPPED_BIT;
+	}
+
+	auto buffer_ci = vk::BufferCreateInfo{};
+	buffer_ci.setSize(size).setUsage(m_usage);
+	auto vma_buffer_ci = static_cast<VkBufferCreateInfo>(buffer_ci);
+
+	VmaAllocation allocation{};
+	VkBuffer buffer{};
+	auto allocation_info = VmaAllocationInfo{};
+	auto const result =
+		vmaCreateBuffer(allocator, &vma_buffer_ci, &allocation_ci, &buffer,
+						&allocation, &allocation_info);
+	if (result != VK_SUCCESS) {
+		std::println(stderr, "Failed to create VMA Buffer");
+		return false;
+	}
+
+	m_buffer = RawBuffer{
+		.allocator = allocator,
+		.allocation = allocation,
+		.buffer = buffer,
+		.capacity = size,
+		.size = size,
+		.mapped = allocation_info.pMappedData,
+	};
+	return true;
+}
+} // namespace vma
+
 auto vma::create_allocator(vk::Instance const instance,
 						   vk::PhysicalDevice const physical_device,
 						   vk::Device const device) -> Allocator {
diff --git a/src/vma.hpp b/src/vma.hpp
index ada2568..ca72202 100644
--- a/src/vma.hpp
+++ b/src/vma.hpp
@@ -2,6 +2,7 @@
 #include <vk_mem_alloc.h>
 #include <scoped.hpp>
 #include <vulkan/vulkan.hpp>
+#include <cstdint>
 
 namespace lvk::vma {
 struct Deleter {
@@ -13,4 +14,55 @@ using Allocator = Scoped<VmaAllocator, Deleter>;
 [[nodiscard]] auto create_allocator(vk::Instance instance,
 									vk::PhysicalDevice physical_device,
 									vk::Device device) -> Allocator;
+
+struct RawBuffer {
+	VmaAllocator allocator{};
+	VmaAllocation allocation{};
+	vk::Buffer buffer{};
+	vk::DeviceSize capacity{};
+	vk::DeviceSize size{};
+	void* mapped{};
+
+	auto operator==(RawBuffer const& rhs) const -> bool = default;
+};
+
+struct BufferDeleter {
+	void operator()(RawBuffer const& raw_buffer) const noexcept;
+};
+
+enum class BufferType : std::int8_t { Host, Device };
+
+struct BufferCreateInfo {
+	vk::BufferUsageFlags usage{};
+	vk::DeviceSize size{};
+	BufferType type{BufferType::Host};
+};
+
+class Buffer {
+  public:
+	using CreateInfo = BufferCreateInfo;
+	using Type = BufferType;
+
+	explicit Buffer(VmaAllocator allocator, CreateInfo const& create_info);
+
+	[[nodiscard]] auto get_type() const -> Type {
+		return m_buffer.get().mapped == nullptr ? Type::Device : Type::Host;
+	}
+
+	[[nodiscard]] auto get_usage() const -> vk::BufferUsageFlags {
+		return m_usage;
+	}
+
+	[[nodiscard]] auto get_raw() const -> RawBuffer const& {
+		return m_buffer.get();
+	}
+
+	auto resize(vk::DeviceSize size) -> bool;
+
+  private:
+	auto create(VmaAllocator allocator, Type type, vk::DeviceSize size) -> bool;
+
+	Scoped<RawBuffer, BufferDeleter> m_buffer{};
+	vk::BufferUsageFlags m_usage{};
+};
 } // namespace lvk::vma

From 0f0ddd212b033c609efe84ef5599193f0e5eeee8 Mon Sep 17 00:00:00 2001
From: Karn Kaul <karnkaul@gmail.com>
Date: Fri, 28 Mar 2025 22:36:37 -0700
Subject: [PATCH 03/11] Vertex and Index Buffers

---
 assets/shader.vert                | Bin 1572 -> 1156 bytes
 guide/src/SUMMARY.md              |   1 +
 guide/src/memory/ibo_quad.png     | Bin 0 -> 74756 bytes
 guide/src/memory/vertex_buffer.md | 148 ++++++++++++++++++++++++++++++
 src/app.cpp                       |  70 +++++++++++++-
 src/app.hpp                       |   4 +
 src/glsl/shader.vert              |  19 +---
 src/vertex.hpp                    |  10 ++
 8 files changed, 235 insertions(+), 17 deletions(-)
 create mode 100644 guide/src/memory/ibo_quad.png
 create mode 100644 guide/src/memory/vertex_buffer.md
 create mode 100644 src/vertex.hpp

diff --git a/assets/shader.vert b/assets/shader.vert
index 1d47401067651e26d7355fbb9845e57b9f251913..ca41ab9d6f7b9492dd8230e282fa74e09a50c8ab 100644
GIT binary patch
literal 1156
zcmYk5-Afx$5XG-aHhycZ^`qA6T74^s4_X9K5tZ#jK#S1VC2SVCu<nLrBW<7hxA|B3
zB6xmx_iC<8X3m*&=gv%Gv#~pA%!HXW^JdRfXUR0g7;$aqqt0Dte^~bR504H|ESRPf
zqFFT4E^g`bp=)!%tZY%XB>OCD>aQXHqzf%GW1>zR-P}Z->p1E6<6-$XOXJMuY234e
zG%4+4if(F5XY(W*^~ME(6yt9OCUBkfi=i!T;rc*BFWp$IJR15cMrE87Sut>2%k|l<
znLsnIiNDX{+jQ_d9hB)GL9rE2OwK>kHj_@zE*x+3^3ML#1l*}|%&y#JX8TumSa$Oy
zeao>)a-%GJ%LUpOd*ej)3|kd+m>I?~dj``(q`UObn?E%#F^4^HJckwz?>X+k(Ua$h
z;n?-Es-oGE0-ktPQCmKgtx2UHlf&df;VF4I3_K&xo8Xfg`#!ioFP?hTN54?V@aVzJ
z@ADrNQ_ttY>;sN^%ktEt{}p|Hk`HB^?=@agjDAyiRUSRumLm4&Ymmd}Yh9im$kP|N
z`mI;*YzT)k>hccwi;M&2jjs;9<LW#8e@^{x%2A)Uf9QK;pUl94e-;zS^ENx?zmT1t
z3ghQw?Db4)a$s`o>7$Gtkz<!&e{WMU`d_L}kJ~ahj^{$faLjhA*XVIahBlNj7qeWb
U26ODn*bVdZCK&yTDjdsR0V17R<NyEw

literal 1572
zcmZXU?N1Xy5XP65D+mH20=^&~qM}mk8z6~MW5k>$O~8=&^-`}Fv&ngF+N(i7`Jb8i
zSNX-n=eKu@RhLX>=9y<_W@neH*EXk&nJ}|v&g`3VEt;ATBdp<c)IM&vhDEovv-<$X
zys0}PoCP!O>`DE8>ew7-MY1k|T-RSs`iIDqX2wMAI66Fx+OOlJ-;amImn@Alo2PNt
z4$`EspHq0#V?3KD*{C~C2*en#7ns1DQH_3YXbanOJp}5VK0apg`*cvGCvWp^dSb*3
z%q8I#xAP%WIfv12Z&budFY65|Z0kQ>!?c7c=TSN+)5=w)62~Uy+h~|6$7fCsw|Q}F
zzfw{=${4dz>{Vv_2X<I=@+3WtF=b+-EIW+_ny0%2#Uf3CGtNrxRzBxISdqB&ON}==
zB{mB_%VXtT^9uf8?14uQo`(&_?3a`k&W0G^*ekLc(xGHkEIlme6AR_@QoxX9`7;jJ
zkJfhO`<iR=&kBbNMx5Mp60Pq|orl=G1Pt+<1=(6JJm;JouyM{J3@y(&FB=SAQ<bQ_
zBq2ZhiPQ51=}^L~IMZ@vgFmf&?!?D0%BD~9F_SfE&cV#sf3>o~*^kft5oZS1oc?<T
zp)g~<>3j{BZ$n-vp?}2V*DF8#2j8rGxWwR7=Z1t_?1Mvpx1{NxIR5R*r(e#qEzNm&
z6aEgHvL__;e@~h?*t#s<px;9bA@6-@&P<#+;FsTzGB5LeC}F|hlZH>OJ-r3q7(KAS
ze+mht$;G?l`@lKyxf8wt-sg;4mH$j}YOPAR$LGohm$&dz8Oe270tN>@d9Fyn;ZqCW
z=ejA|=b{dCCKt23BLRa0pSkkC3{EcI0=}>FNH+Q3X+Lv)ECFMAY)3X2cW|Wcn9;5T
ZE-`=a^uQdSNSHPAr6xZ7U&^pA`3)_5bHo4u

diff --git a/guide/src/SUMMARY.md b/guide/src/SUMMARY.md
index ff1f5f3..852f5df 100644
--- a/guide/src/SUMMARY.md
+++ b/guide/src/SUMMARY.md
@@ -39,3 +39,4 @@
 - [Memory Allocation](memory/README.md)
   - [Vulkan Memory Allocator](memory/vma.md)
   - [Buffers](memory/buffers.md)
+  - [Vertex Buffer](memory/vertex_buffer.md)
diff --git a/guide/src/memory/ibo_quad.png b/guide/src/memory/ibo_quad.png
new file mode 100644
index 0000000000000000000000000000000000000000..554785ba7c1c950d2c076d7482a9ae3f5a522634
GIT binary patch
literal 74756
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

literal 0
HcmV?d00001

diff --git a/guide/src/memory/vertex_buffer.md b/guide/src/memory/vertex_buffer.md
new file mode 100644
index 0000000..8161828
--- /dev/null
+++ b/guide/src/memory/vertex_buffer.md
@@ -0,0 +1,148 @@
+# Vertex Buffer
+
+The goal here is to move the hard-coded vertices in the shader to application code. For the time being we will use an ad-hoc host `vma::Buffer` and focus more on the rest of the infrastructure like vertex attributes.
+
+First add a new header, `vertex.hpp`:
+
+```cpp
+struct Vertex {
+  glm::vec2 position{};
+  glm::vec3 color{};
+};
+```
+
+In `app.cpp`, store the vertex input:
+
+```cpp
+// two vertex attributes: position at 0, color at 1.
+constexpr auto vertex_attributes_v = std::array{
+  // the format matches the type and layout of data: vec2 => 2x 32-bit floats.
+  vk::VertexInputAttributeDescription2EXT{0, 0, vk::Format::eR32G32Sfloat,
+                      offsetof(Vertex, position)},
+  // vec3 => 3x 32-bit floats
+  vk::VertexInputAttributeDescription2EXT{1, 0, vk::Format::eR32G32B32Sfloat,
+                      offsetof(Vertex, color)},
+};
+
+// one vertex binding at location 0.
+constexpr auto vertex_bindings_v = std::array{
+  // we are using interleaved data with a stride of sizeof(Vertex).
+  vk::VertexInputBindingDescription2EXT{0, sizeof(Vertex),
+                      vk::VertexInputRate::eVertex, 1},
+};
+
+constexpr auto vertex_input_v = ShaderVertexInput{
+  .attributes = vertex_attributes_v,
+  .bindings = vertex_bindings_v,
+};
+```
+
+Add `vertex_input_v` to the Shader Create Info:
+
+```cpp
+auto const shader_ci = ShaderProgram::CreateInfo{
+  // ...
+  .vertex_input = vertex_input_v,
+  .set_layouts = {},
+};
+```
+
+With the vertex input defined, we can update the vertex shader and recompile it:
+
+```glsl
+#version 450 core
+
+layout (location = 0) in vec2 a_pos;
+layout (location = 1) in vec3 a_color;
+
+layout (location = 0) out vec3 out_color;
+
+void main() {
+  const vec2 position = a_pos;
+
+  out_color = a_color;
+  gl_Position = vec4(position, 0.0, 1.0);
+}
+```
+
+Add a VBO (Vertex Buffer Object) member and create it:
+
+```cpp
+void App::create_vertex_buffer() {
+  // we want to write 3x Vertex objects to a Host VertexBuffer.
+  auto const buffer_ci = vma::Buffer::CreateInfo{
+    .usage = vk::BufferUsageFlagBits::eVertexBuffer,
+    .size = 3 * sizeof(Vertex),
+    .type = vma::BufferType::Host,
+  };
+  m_vbo.emplace(m_allocator.get(), buffer_ci);
+
+  // vertices that were previously hard-coded in the shader.
+  static constexpr auto vertices_v = std::array{
+    Vertex{.position = {-0.5f, -0.5f}, .color = {1.0f, 0.0f, 0.0f}},
+    Vertex{.position = {0.5f, -0.5f}, .color = {0.0f, 1.0f, 0.0f}},
+    Vertex{.position = {0.0f, 0.5f}, .color = {0.0f, 0.0f, 1.0f}},
+  };
+  // host buffers have a memory-mapped pointer available to memcpy data to.
+  std::memcpy(m_vbo->get_raw().mapped, vertices_v.data(), sizeof(vertices_v));
+}
+```
+
+Bind the VBO before recording the draw call:
+
+```cpp
+// single VBO at binding 0 at no offset.
+command_buffer.bindVertexBuffers(0, m_vbo->get_raw().buffer,
+                                 vk::DeviceSize{});
+// m_vbo has 3 vertices.
+command_buffer.draw(3, 1, 0, 0);
+```
+
+You should see the same triangle as before. But now we can use whatever set of vertices we like! To change it to a quad / rectangle, let's utilize an index buffer: this will reduce vertex duplication in general.
+
+```cpp
+void App::create_vertex_buffer() {
+  // we want to write 4x Vertex objects to a Host VertexBuffer.
+  auto buffer_ci = vma::Buffer::CreateInfo{
+    .usage = vk::BufferUsageFlagBits::eVertexBuffer,
+    .size = 4 * sizeof(Vertex),
+    .type = vma::BufferType::Host,
+  };
+  m_vbo.emplace(m_allocator.get(), buffer_ci);
+
+  // vertices that form a quad.
+  static constexpr auto vertices_v = std::array{
+    Vertex{.position = {-0.5f, -0.5f}, .color = {1.0f, 0.0f, 0.0f}},
+    Vertex{.position = {0.5f, -0.5f}, .color = {0.0f, 1.0f, 0.0f}},
+    Vertex{.position = {0.5f, 0.5f}, .color = {0.0f, 0.0f, 1.0f}},
+    Vertex{.position = {-0.5f, 0.5f}, .color = {1.0f, 1.0f, 0.0f}},
+  };
+  // host buffers have a memory-mapped pointer available to memcpy data to.
+  std::memcpy(m_vbo->get_raw().mapped, vertices_v.data(), sizeof(vertices_v));
+
+  // prepare to write 6x u32 indices to a Host IndexBuffer.
+  buffer_ci = {
+    .usage = vk::BufferUsageFlagBits::eIndexBuffer,
+    .size = 6 * sizeof(std::uint32_t),
+    .type = vma::BufferType::Host,
+  };
+  m_ibo.emplace(m_allocator.get(), buffer_ci);
+  static constexpr auto indices_v = std::array{
+    0u, 1u, 2u, 2u, 3u, 0u,
+  };
+  std::memcpy(m_ibo->get_raw().mapped, indices_v.data(), sizeof(indices_v));
+}
+```
+
+Bind the index buffer and use the `drawIndexed()` command:
+
+```cpp
+// single VBO at binding 0 at no offset.
+command_buffer.bindVertexBuffers(0, m_vbo->get_raw().buffer,
+                                 vk::DeviceSize{});
+// IBO with u32 indices at no offset.
+command_buffer.bindIndexBuffer(m_ibo->get_raw().buffer, 0,
+                               vk::IndexType::eUint32);
+// m_ibo has 6 indices.
+command_buffer.drawIndexed(6, 1, 0, 0, 0);
+```
diff --git a/src/app.cpp b/src/app.cpp
index e311fe4..73a7d33 100644
--- a/src/app.cpp
+++ b/src/app.cpp
@@ -1,4 +1,5 @@
 #include <app.hpp>
+#include <vertex.hpp>
 #include <cassert>
 #include <chrono>
 #include <fstream>
@@ -11,6 +12,28 @@ namespace lvk {
 using namespace std::chrono_literals;
 
 namespace {
+// two vertex attributes: position at 0, color at 1.
+constexpr auto vertex_attributes_v = std::array{
+	// the format matches the type and layout of data: vec2 => 2x 32-bit floats.
+	vk::VertexInputAttributeDescription2EXT{0, 0, vk::Format::eR32G32Sfloat,
+											offsetof(Vertex, position)},
+	// vec3 => 3x 32-bit floats
+	vk::VertexInputAttributeDescription2EXT{1, 0, vk::Format::eR32G32B32Sfloat,
+											offsetof(Vertex, color)},
+};
+
+// one vertex binding at location 0.
+constexpr auto vertex_bindings_v = std::array{
+	// we are using interleaved data with a stride of sizeof(Vertex).
+	vk::VertexInputBindingDescription2EXT{0, sizeof(Vertex),
+										  vk::VertexInputRate::eVertex, 1},
+};
+
+constexpr auto vertex_input_v = ShaderVertexInput{
+	.attributes = vertex_attributes_v,
+	.bindings = vertex_bindings_v,
+};
+
 [[nodiscard]] auto locate_assets_dir() -> fs::path {
 	// look for '<path>/assets/', starting from the working
 	// directory and walking up the parent directory tree.
@@ -83,6 +106,8 @@ void App::run() {
 	create_imgui();
 	create_shader();
 
+	create_vertex_buffer();
+
 	main_loop();
 }
 
@@ -236,16 +261,49 @@ void App::create_allocator() {
 void App::create_shader() {
 	auto const vertex_spirv = to_spir_v(asset_path("shader.vert"));
 	auto const fragment_spirv = to_spir_v(asset_path("shader.frag"));
+
 	auto const shader_ci = ShaderProgram::CreateInfo{
 		.device = *m_device,
 		.vertex_spirv = vertex_spirv,
 		.fragment_spirv = fragment_spirv,
-		.vertex_input = {},
+		.vertex_input = vertex_input_v,
 		.set_layouts = {},
 	};
 	m_shader.emplace(shader_ci);
 }
 
+void App::create_vertex_buffer() {
+	// we want to write 4x Vertex objects to a Host VertexBuffer.
+	auto buffer_ci = vma::Buffer::CreateInfo{
+		.usage = vk::BufferUsageFlagBits::eVertexBuffer,
+		.size = 4 * sizeof(Vertex),
+		.type = vma::BufferType::Host,
+	};
+	m_vbo.emplace(m_allocator.get(), buffer_ci);
+
+	// vertices that form a quad.
+	static constexpr auto vertices_v = std::array{
+		Vertex{.position = {-0.5f, -0.5f}, .color = {1.0f, 0.0f, 0.0f}},
+		Vertex{.position = {0.5f, -0.5f}, .color = {0.0f, 1.0f, 0.0f}},
+		Vertex{.position = {0.5f, 0.5f}, .color = {0.0f, 0.0f, 1.0f}},
+		Vertex{.position = {-0.5f, 0.5f}, .color = {1.0f, 1.0f, 0.0f}},
+	};
+	// host buffers have a memory-mapped pointer available to memcpy data to.
+	std::memcpy(m_vbo->get_raw().mapped, vertices_v.data(), sizeof(vertices_v));
+
+	// prepare to write 6x u32 indices to a Host IndexBuffer.
+	buffer_ci = {
+		.usage = vk::BufferUsageFlagBits::eIndexBuffer,
+		.size = 6 * sizeof(std::uint32_t),
+		.type = vma::BufferType::Host,
+	};
+	m_ibo.emplace(m_allocator.get(), buffer_ci);
+	static constexpr auto indices_v = std::array{
+		0u, 1u, 2u, 2u, 3u, 0u,
+	};
+	std::memcpy(m_ibo->get_raw().mapped, indices_v.data(), sizeof(indices_v));
+}
+
 auto App::asset_path(std::string_view const uri) const -> fs::path {
 	return m_assets_dir / uri;
 }
@@ -424,7 +482,13 @@ void App::inspect() {
 
 void App::draw(vk::CommandBuffer const command_buffer) const {
 	m_shader->bind(command_buffer, m_framebuffer_size);
-	// current shader has hard-coded logic for 3 vertices.
-	command_buffer.draw(3, 1, 0, 0);
+	// single VBO at binding 0 at no offset.
+	command_buffer.bindVertexBuffers(0, m_vbo->get_raw().buffer,
+									 vk::DeviceSize{});
+	// IBO with u32 indices at no offset.
+	command_buffer.bindIndexBuffer(m_ibo->get_raw().buffer, 0,
+								   vk::IndexType::eUint32);
+	// m_ibo has 6 indices.
+	command_buffer.drawIndexed(6, 1, 0, 0, 0);
 }
 } // namespace lvk
diff --git a/src/app.hpp b/src/app.hpp
index 6532cbc..c06f8fe 100644
--- a/src/app.hpp
+++ b/src/app.hpp
@@ -38,6 +38,7 @@ class App {
 	void create_imgui();
 	void create_allocator();
 	void create_shader();
+	void create_vertex_buffer();
 
 	[[nodiscard]] auto asset_path(std::string_view uri) const -> fs::path;
 
@@ -78,6 +79,9 @@ class App {
 
 	std::optional<ShaderProgram> m_shader{};
 
+	std::optional<vma::Buffer> m_vbo{};
+	std::optional<vma::Buffer> m_ibo{};
+
 	glm::ivec2 m_framebuffer_size{};
 	std::optional<RenderTarget> m_render_target{};
 	bool m_wireframe{};
diff --git a/src/glsl/shader.vert b/src/glsl/shader.vert
index 8efde56..edebf18 100644
--- a/src/glsl/shader.vert
+++ b/src/glsl/shader.vert
@@ -1,22 +1,13 @@
 #version 450 core
 
+layout (location = 0) in vec2 a_pos;
+layout (location = 1) in vec3 a_color;
+
 layout (location = 0) out vec3 out_color;
 
 void main() {
-	const vec2 positions[] = {
-		vec2(-0.5, -0.5),
-		vec2(0.5, -0.5),
-		vec2(0.0, 0.5),
-	};
-
-	const vec3 colors[] = {
-		vec3(1.0, 0.0, 0.0),
-		vec3(0.0, 1.0, 0.0),
-		vec3(0.0, 0.0, 1.0),
-	};
-
-	const vec2 position = positions[gl_VertexIndex];
+	const vec2 position = a_pos;
 
-	out_color = colors[gl_VertexIndex];
+	out_color = a_color;
 	gl_Position = vec4(position, 0.0, 1.0);
 }
diff --git a/src/vertex.hpp b/src/vertex.hpp
new file mode 100644
index 0000000..20987d5
--- /dev/null
+++ b/src/vertex.hpp
@@ -0,0 +1,10 @@
+#pragma once
+#include <glm/vec2.hpp>
+#include <glm/vec3.hpp>
+
+namespace lvk {
+struct Vertex {
+	glm::vec2 position{};
+	glm::vec3 color{};
+};
+} // namespace lvk

From 6b1b15f91fb51536db48877793abc511a1c3fe42 Mon Sep 17 00:00:00 2001
From: Karn Kaul <karnkaul@gmail.com>
Date: Fri, 28 Mar 2025 22:44:52 -0700
Subject: [PATCH 04/11] Fix warnings

---
 ext/CMakeLists.txt | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/ext/CMakeLists.txt b/ext/CMakeLists.txt
index a4204b1..bd7eb32 100644
--- a/ext/CMakeLists.txt
+++ b/ext/CMakeLists.txt
@@ -67,6 +67,9 @@ target_link_libraries(vma PUBLIC
   Vulkan::Headers
   GPUOpen::VulkanMemoryAllocator
 )
+target_include_directories(vma SYSTEM PUBLIC
+  src/VulkanMemoryAllocator/include
+)
 target_compile_definitions(vma PUBLIC
   VMA_STATIC_VULKAN_FUNCTIONS=0
   VMA_DYNAMIC_VULKAN_FUNCTIONS=1

From 23f4b5040b523cd98cb586f0a99ba724c622dde7 Mon Sep 17 00:00:00 2001
From: Karn Kaul <karnkaul@gmail.com>
Date: Sat, 29 Mar 2025 15:43:59 -0700
Subject: [PATCH 05/11] Refactor `vma::Buffer` API

---
 guide/src/SUMMARY.md                          |   2 +-
 guide/src/memory/buffers.md                   | 110 ++++++------------
 ...vertex_buffer.md => host_vertex_buffer.md} |  86 ++++----------
 src/app.cpp                                   |  68 +++--------
 src/app.hpp                                   |   3 +-
 src/vertex.hpp                                |  18 +++
 src/vma.cpp                                   |  79 +++++--------
 src/vma.hpp                                   |  48 ++------
 8 files changed, 133 insertions(+), 281 deletions(-)
 rename guide/src/memory/{vertex_buffer.md => host_vertex_buffer.md} (50%)

diff --git a/guide/src/SUMMARY.md b/guide/src/SUMMARY.md
index 852f5df..bd6a749 100644
--- a/guide/src/SUMMARY.md
+++ b/guide/src/SUMMARY.md
@@ -39,4 +39,4 @@
 - [Memory Allocation](memory/README.md)
   - [Vulkan Memory Allocator](memory/vma.md)
   - [Buffers](memory/buffers.md)
-  - [Vertex Buffer](memory/vertex_buffer.md)
+  - [Host Vertex Buffer](memory/host_vertex_buffer.md)
diff --git a/guide/src/memory/buffers.md b/guide/src/memory/buffers.md
index 3af220e..149be94 100644
--- a/guide/src/memory/buffers.md
+++ b/guide/src/memory/buffers.md
@@ -4,14 +4,17 @@ First add the RAII wrapper components for VMA buffers:
 
 ```cpp
 struct RawBuffer {
+  [[nodiscard]] auto mapped_span() const -> std::span<std::byte> {
+    return std::span{static_cast<std::byte*>(mapped), size};
+  }
+
+  auto operator==(RawBuffer const& rhs) const -> bool = default;
+
   VmaAllocator allocator{};
   VmaAllocation allocation{};
   vk::Buffer buffer{};
-  vk::DeviceSize capacity{};
   vk::DeviceSize size{};
   void* mapped{};
-
-  auto operator==(RawBuffer const& rhs) const -> bool = default;
 };
 
 struct BufferDeleter {
@@ -25,82 +28,30 @@ void BufferDeleter::operator()(RawBuffer const& raw_buffer) const noexcept {
 }
 ```
 
-Buffers can be backed by host (RAM) or device (VRAM) memory: the former is mappable and thus useful for data that changes every frame, latter is faster to access for the GPU but needs more complex methods to copy data from the CPU to it. Add the relevant subset of parameters and the RAII wrapper:
+Buffers can be backed by host (RAM) or device (VRAM) memory: the former is mappable and thus useful for data that changes every frame, latter is faster to access for the GPU but needs more complex methods to copy data from the CPU to it. Leaving device buffers for later, add the `Buffer` alias and a create function:
 
 ```cpp
-enum class BufferType : std::int8_t { Host, Device };
-
-struct BufferCreateInfo {
-  vk::BufferUsageFlags usage{};
-  vk::DeviceSize size{};
-  BufferType type{BufferType::Host};
-};
-
-class Buffer {
- public:
-  using CreateInfo = BufferCreateInfo;
-
-  explicit Buffer(VmaAllocator allocator, CreateInfo const& create_info);
-
-  [[nodiscard]] auto get_type() const -> Type {
-    return m_buffer.get().mapped == nullptr ? Type::Device : Type::Host;
-  }
-
-  [[nodiscard]] auto get_usage() const -> vk::BufferUsageFlags {
-    return m_usage;
-  }
-
-  [[nodiscard]] auto get_raw() const -> RawBuffer const& {
-    return m_buffer.get();
-  }
-
-  auto resize(vk::DeviceSize size) -> bool;
-
- private:
-  auto create(VmaAllocator allocator, vk::DeviceSize size) -> bool;
+using Buffer = Scoped<RawBuffer, BufferDeleter>;
 
-  Scoped<RawBuffer, BufferDeleter> m_buffer{};
-  vk::BufferUsageFlags m_usage{};
-};
+[[nodiscard]] auto create_host_buffer(VmaAllocator allocator,
+                                      vk::BufferUsageFlags usage,
+                                      vk::DeviceSize size) -> Buffer;
 ```
 
-`resize()` and `create()` are separate because the former uses the existing `m_buffer`'s allocator. The implementation:
+Add a helper function that can be reused for device buffers too later:
 
 ```cpp
-[[nodiscard]] constexpr auto positive_size(vk::DeviceSize const in) {
-  return in > 0 ? in : 1;
-}
-
-// ...
-Buffer::Buffer(VmaAllocator allocator, CreateInfo const& create_info)
-  : m_usage(create_info.usage) {
-  create(allocator, create_info.type, create_info.size);
-}
-
-auto Buffer::resize(vk::DeviceSize const size) -> bool {
-  if (size <= m_buffer.get().capacity) {
-    m_buffer.get().size = size;
-    return true;
-  }
-  return create(m_buffer.get().allocator, get_type(), size);
-}
-
-auto Buffer::create(VmaAllocator allocator, Type const type,
-          vk::DeviceSize size) -> bool {
-  // buffers cannot be zero sized.
-  size = positive_size(size);
-  auto allocation_ci = VmaAllocationCreateInfo{};
-  allocation_ci.flags =
-    VMA_ALLOCATION_CREATE_HOST_ACCESS_SEQUENTIAL_WRITE_BIT;
-  if (type == BufferType::Device) {
-    allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_DEVICE;
-  } else {
-    allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_HOST;
-    allocation_ci.flags |= VMA_ALLOCATION_CREATE_MAPPED_BIT;
+[[nodiscard]] auto create_buffer(VmaAllocator allocator,
+                                 VmaAllocationCreateInfo const& allocation_ci,
+                                 vk::BufferUsageFlags const usage,
+                                 vk::DeviceSize const size) -> Buffer {
+  if (size == 0) {
+    std::println(stderr, "Buffer cannot be 0-sized");
+    return {};
   }
 
   auto buffer_ci = vk::BufferCreateInfo{};
-  buffer_ci.setSize(size).setUsage(m_usage);
+  buffer_ci.setSize(size).setUsage(usage);
   auto vma_buffer_ci = static_cast<VkBufferCreateInfo>(buffer_ci);
 
   VmaAllocation allocation{};
@@ -111,17 +62,30 @@ auto Buffer::create(VmaAllocator allocator, Type const type,
             &allocation, &allocation_info);
   if (result != VK_SUCCESS) {
     std::println(stderr, "Failed to create VMA Buffer");
-    return false;
+    return {};
   }
 
-  m_buffer = RawBuffer{
+  return RawBuffer{
     .allocator = allocator,
     .allocation = allocation,
     .buffer = buffer,
-    .capacity = size,
     .size = size,
     .mapped = allocation_info.pMappedData,
   };
-  return true;
+}
+```
+
+Implement `create_host_buffer()`:
+
+```cpp
+auto vma::create_host_buffer(VmaAllocator allocator,
+                             vk::BufferUsageFlags const usage,
+                             vk::DeviceSize const size) -> Buffer {
+  auto allocation_ci = VmaAllocationCreateInfo{};
+  allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_HOST;
+  allocation_ci.flags =
+    VMA_ALLOCATION_CREATE_HOST_ACCESS_SEQUENTIAL_WRITE_BIT |
+    VMA_ALLOCATION_CREATE_MAPPED_BIT;
+  return create_buffer(allocator, allocation_ci, usage, size);
 }
 ```
diff --git a/guide/src/memory/vertex_buffer.md b/guide/src/memory/host_vertex_buffer.md
similarity index 50%
rename from guide/src/memory/vertex_buffer.md
rename to guide/src/memory/host_vertex_buffer.md
index 8161828..4b0e1cf 100644
--- a/guide/src/memory/vertex_buffer.md
+++ b/guide/src/memory/host_vertex_buffer.md
@@ -1,6 +1,6 @@
-# Vertex Buffer
+# Host Vertex Buffer
 
-The goal here is to move the hard-coded vertices in the shader to application code. For the time being we will use an ad-hoc host `vma::Buffer` and focus more on the rest of the infrastructure like vertex attributes.
+The goal here is to move the hard-coded vertices in the shader to application code. For the time being we will use an ad-hoc Host type `vma::Buffer` and focus more on the rest of the infrastructure like vertex attributes.
 
 First add a new header, `vertex.hpp`:
 
@@ -9,11 +9,7 @@ struct Vertex {
   glm::vec2 position{};
   glm::vec3 color{};
 };
-```
-
-In `app.cpp`, store the vertex input:
 
-```cpp
 // two vertex attributes: position at 0, color at 1.
 constexpr auto vertex_attributes_v = std::array{
   // the format matches the type and layout of data: vec2 => 2x 32-bit floats.
@@ -30,21 +26,24 @@ constexpr auto vertex_bindings_v = std::array{
   vk::VertexInputBindingDescription2EXT{0, sizeof(Vertex),
                       vk::VertexInputRate::eVertex, 1},
 };
-
-constexpr auto vertex_input_v = ShaderVertexInput{
-  .attributes = vertex_attributes_v,
-  .bindings = vertex_bindings_v,
-};
 ```
 
-Add `vertex_input_v` to the Shader Create Info:
+Add the vertex attributes and bindings to the Shader Create Info:
 
 ```cpp
+// ...
+static constexpr auto vertex_input_v = ShaderVertexInput{
+  .attributes = vertex_attributes_v,
+  .bindings = vertex_bindings_v,
+};
 auto const shader_ci = ShaderProgram::CreateInfo{
-  // ...
+  .device = *m_device,
+  .vertex_spirv = vertex_spirv,
+  .fragment_spirv = fragment_spirv,
   .vertex_input = vertex_input_v,
   .set_layouts = {},
 };
+// ...
 ```
 
 With the vertex input defined, we can update the vertex shader and recompile it:
@@ -69,22 +68,22 @@ Add a VBO (Vertex Buffer Object) member and create it:
 
 ```cpp
 void App::create_vertex_buffer() {
-  // we want to write 3x Vertex objects to a Host VertexBuffer.
-  auto const buffer_ci = vma::Buffer::CreateInfo{
+  // we want to write 4x Vertex objects to a Host VertexBuffer.
+  auto const buffer_ci = vma::BufferCreateInfo{
     .usage = vk::BufferUsageFlagBits::eVertexBuffer,
-    .size = 3 * sizeof(Vertex),
+    .size = 4 * sizeof(Vertex),
     .type = vma::BufferType::Host,
   };
-  m_vbo.emplace(m_allocator.get(), buffer_ci);
+  m_vbo = vma::create_buffer(m_allocator.get(), buffer_ci);
 
-  // vertices that were previously hard-coded in the shader.
+  // vertices moved from the shader.
   static constexpr auto vertices_v = std::array{
     Vertex{.position = {-0.5f, -0.5f}, .color = {1.0f, 0.0f, 0.0f}},
     Vertex{.position = {0.5f, -0.5f}, .color = {0.0f, 1.0f, 0.0f}},
     Vertex{.position = {0.0f, 0.5f}, .color = {0.0f, 0.0f, 1.0f}},
   };
   // host buffers have a memory-mapped pointer available to memcpy data to.
-  std::memcpy(m_vbo->get_raw().mapped, vertices_v.data(), sizeof(vertices_v));
+  std::memcpy(m_vbo.get().mapped, vertices_v.data(), sizeof(vertices_v));
 }
 ```
 
@@ -98,51 +97,6 @@ command_buffer.bindVertexBuffers(0, m_vbo->get_raw().buffer,
 command_buffer.draw(3, 1, 0, 0);
 ```
 
-You should see the same triangle as before. But now we can use whatever set of vertices we like! To change it to a quad / rectangle, let's utilize an index buffer: this will reduce vertex duplication in general.
-
-```cpp
-void App::create_vertex_buffer() {
-  // we want to write 4x Vertex objects to a Host VertexBuffer.
-  auto buffer_ci = vma::Buffer::CreateInfo{
-    .usage = vk::BufferUsageFlagBits::eVertexBuffer,
-    .size = 4 * sizeof(Vertex),
-    .type = vma::BufferType::Host,
-  };
-  m_vbo.emplace(m_allocator.get(), buffer_ci);
-
-  // vertices that form a quad.
-  static constexpr auto vertices_v = std::array{
-    Vertex{.position = {-0.5f, -0.5f}, .color = {1.0f, 0.0f, 0.0f}},
-    Vertex{.position = {0.5f, -0.5f}, .color = {0.0f, 1.0f, 0.0f}},
-    Vertex{.position = {0.5f, 0.5f}, .color = {0.0f, 0.0f, 1.0f}},
-    Vertex{.position = {-0.5f, 0.5f}, .color = {1.0f, 1.0f, 0.0f}},
-  };
-  // host buffers have a memory-mapped pointer available to memcpy data to.
-  std::memcpy(m_vbo->get_raw().mapped, vertices_v.data(), sizeof(vertices_v));
-
-  // prepare to write 6x u32 indices to a Host IndexBuffer.
-  buffer_ci = {
-    .usage = vk::BufferUsageFlagBits::eIndexBuffer,
-    .size = 6 * sizeof(std::uint32_t),
-    .type = vma::BufferType::Host,
-  };
-  m_ibo.emplace(m_allocator.get(), buffer_ci);
-  static constexpr auto indices_v = std::array{
-    0u, 1u, 2u, 2u, 3u, 0u,
-  };
-  std::memcpy(m_ibo->get_raw().mapped, indices_v.data(), sizeof(indices_v));
-}
-```
-
-Bind the index buffer and use the `drawIndexed()` command:
+You should see the same triangle as before. But now we can use whatever set of vertices we like! The Primitive Topology is Triange List by default, so every three vertices in the array is drawn as a triangle, eg for 9 vertices: `[[0, 1, 2], [3, 4, 5], [6, 7, 8]]`, where each inner `[]` represents a triangle comprised of the vertices at those indices.
 
-```cpp
-// single VBO at binding 0 at no offset.
-command_buffer.bindVertexBuffers(0, m_vbo->get_raw().buffer,
-                                 vk::DeviceSize{});
-// IBO with u32 indices at no offset.
-command_buffer.bindIndexBuffer(m_ibo->get_raw().buffer, 0,
-                               vk::IndexType::eUint32);
-// m_ibo has 6 indices.
-command_buffer.drawIndexed(6, 1, 0, 0, 0);
-```
+Host Vertex Buffers are useful for primitives that are temporary and/or frequently changing, such as UI objects. A 2D framework can use such VBOs exclusively: a simple approach would be a pool of buffers per virtual frame where for each draw a buffer is obtained from the current virtual frame's pool and vertices are copied in.
diff --git a/src/app.cpp b/src/app.cpp
index 73a7d33..56312d2 100644
--- a/src/app.cpp
+++ b/src/app.cpp
@@ -12,28 +12,6 @@ namespace lvk {
 using namespace std::chrono_literals;
 
 namespace {
-// two vertex attributes: position at 0, color at 1.
-constexpr auto vertex_attributes_v = std::array{
-	// the format matches the type and layout of data: vec2 => 2x 32-bit floats.
-	vk::VertexInputAttributeDescription2EXT{0, 0, vk::Format::eR32G32Sfloat,
-											offsetof(Vertex, position)},
-	// vec3 => 3x 32-bit floats
-	vk::VertexInputAttributeDescription2EXT{1, 0, vk::Format::eR32G32B32Sfloat,
-											offsetof(Vertex, color)},
-};
-
-// one vertex binding at location 0.
-constexpr auto vertex_bindings_v = std::array{
-	// we are using interleaved data with a stride of sizeof(Vertex).
-	vk::VertexInputBindingDescription2EXT{0, sizeof(Vertex),
-										  vk::VertexInputRate::eVertex, 1},
-};
-
-constexpr auto vertex_input_v = ShaderVertexInput{
-	.attributes = vertex_attributes_v,
-	.bindings = vertex_bindings_v,
-};
-
 [[nodiscard]] auto locate_assets_dir() -> fs::path {
 	// look for '<path>/assets/', starting from the working
 	// directory and walking up the parent directory tree.
@@ -262,6 +240,10 @@ void App::create_shader() {
 	auto const vertex_spirv = to_spir_v(asset_path("shader.vert"));
 	auto const fragment_spirv = to_spir_v(asset_path("shader.frag"));
 
+	static constexpr auto vertex_input_v = ShaderVertexInput{
+		.attributes = vertex_attributes_v,
+		.bindings = vertex_bindings_v,
+	};
 	auto const shader_ci = ShaderProgram::CreateInfo{
 		.device = *m_device,
 		.vertex_spirv = vertex_spirv,
@@ -273,35 +255,19 @@ void App::create_shader() {
 }
 
 void App::create_vertex_buffer() {
-	// we want to write 4x Vertex objects to a Host VertexBuffer.
-	auto buffer_ci = vma::Buffer::CreateInfo{
-		.usage = vk::BufferUsageFlagBits::eVertexBuffer,
-		.size = 4 * sizeof(Vertex),
-		.type = vma::BufferType::Host,
-	};
-	m_vbo.emplace(m_allocator.get(), buffer_ci);
-
-	// vertices that form a quad.
+	// vertices previously hard-coded in the vertex shader.
 	static constexpr auto vertices_v = std::array{
 		Vertex{.position = {-0.5f, -0.5f}, .color = {1.0f, 0.0f, 0.0f}},
 		Vertex{.position = {0.5f, -0.5f}, .color = {0.0f, 1.0f, 0.0f}},
-		Vertex{.position = {0.5f, 0.5f}, .color = {0.0f, 0.0f, 1.0f}},
-		Vertex{.position = {-0.5f, 0.5f}, .color = {1.0f, 1.0f, 0.0f}},
+		Vertex{.position = {0.0f, 0.5f}, .color = {0.0f, 0.0f, 1.0f}},
 	};
-	// host buffers have a memory-mapped pointer available to memcpy data to.
-	std::memcpy(m_vbo->get_raw().mapped, vertices_v.data(), sizeof(vertices_v));
+	// we want to write vertices_v to a Host VertexBuffer.
+	m_vbo = vma::create_host_buffer(m_allocator.get(),
+									vk::BufferUsageFlagBits::eVertexBuffer,
+									sizeof(vertices_v));
 
-	// prepare to write 6x u32 indices to a Host IndexBuffer.
-	buffer_ci = {
-		.usage = vk::BufferUsageFlagBits::eIndexBuffer,
-		.size = 6 * sizeof(std::uint32_t),
-		.type = vma::BufferType::Host,
-	};
-	m_ibo.emplace(m_allocator.get(), buffer_ci);
-	static constexpr auto indices_v = std::array{
-		0u, 1u, 2u, 2u, 3u, 0u,
-	};
-	std::memcpy(m_ibo->get_raw().mapped, indices_v.data(), sizeof(indices_v));
+	// host buffers have a memory-mapped pointer available to memcpy data to.
+	std::memcpy(m_vbo.get().mapped, vertices_v.data(), sizeof(vertices_v));
 }
 
 auto App::asset_path(std::string_view const uri) const -> fs::path {
@@ -483,12 +449,8 @@ void App::inspect() {
 void App::draw(vk::CommandBuffer const command_buffer) const {
 	m_shader->bind(command_buffer, m_framebuffer_size);
 	// single VBO at binding 0 at no offset.
-	command_buffer.bindVertexBuffers(0, m_vbo->get_raw().buffer,
-									 vk::DeviceSize{});
-	// IBO with u32 indices at no offset.
-	command_buffer.bindIndexBuffer(m_ibo->get_raw().buffer, 0,
-								   vk::IndexType::eUint32);
-	// m_ibo has 6 indices.
-	command_buffer.drawIndexed(6, 1, 0, 0, 0);
+	command_buffer.bindVertexBuffers(0, m_vbo.get().buffer, vk::DeviceSize{});
+	// m_vbo has 3 vertices.
+	command_buffer.draw(3, 1, 0, 0);
 }
 } // namespace lvk
diff --git a/src/app.hpp b/src/app.hpp
index c06f8fe..0426738 100644
--- a/src/app.hpp
+++ b/src/app.hpp
@@ -79,8 +79,7 @@ class App {
 
 	std::optional<ShaderProgram> m_shader{};
 
-	std::optional<vma::Buffer> m_vbo{};
-	std::optional<vma::Buffer> m_ibo{};
+	vma::Buffer m_vbo{};
 
 	glm::ivec2 m_framebuffer_size{};
 	std::optional<RenderTarget> m_render_target{};
diff --git a/src/vertex.hpp b/src/vertex.hpp
index 20987d5..6c0fabb 100644
--- a/src/vertex.hpp
+++ b/src/vertex.hpp
@@ -1,10 +1,28 @@
 #pragma once
 #include <glm/vec2.hpp>
 #include <glm/vec3.hpp>
+#include <vulkan/vulkan.hpp>
 
 namespace lvk {
 struct Vertex {
 	glm::vec2 position{};
 	glm::vec3 color{};
 };
+
+// two vertex attributes: position at 0, color at 1.
+constexpr auto vertex_attributes_v = std::array{
+	// the format matches the type and layout of data: vec2 => 2x 32-bit floats.
+	vk::VertexInputAttributeDescription2EXT{0, 0, vk::Format::eR32G32Sfloat,
+											offsetof(Vertex, position)},
+	// vec3 => 3x 32-bit floats
+	vk::VertexInputAttributeDescription2EXT{1, 0, vk::Format::eR32G32B32Sfloat,
+											offsetof(Vertex, color)},
+};
+
+// one vertex binding at location 0.
+constexpr auto vertex_bindings_v = std::array{
+	// we are using interleaved data with a stride of sizeof(Vertex).
+	vk::VertexInputBindingDescription2EXT{0, sizeof(Vertex),
+										  vk::VertexInputRate::eVertex, 1},
+};
 } // namespace lvk
diff --git a/src/vma.cpp b/src/vma.cpp
index 09aa9fa..8841957 100644
--- a/src/vma.cpp
+++ b/src/vma.cpp
@@ -5,53 +5,17 @@
 namespace lvk {
 namespace vma {
 namespace {
-[[nodiscard]] constexpr auto positive_size(vk::DeviceSize const in) {
-	return in > 0 ? in : 1;
-}
-} // namespace
-
-void Deleter::operator()(VmaAllocator allocator) const noexcept {
-	vmaDestroyAllocator(allocator);
-}
-
-void BufferDeleter::operator()(RawBuffer const& raw_buffer) const noexcept {
-	vmaDestroyBuffer(raw_buffer.allocator, raw_buffer.buffer,
-					 raw_buffer.allocation);
-}
-
-Buffer::Buffer(VmaAllocator allocator, CreateInfo const& create_info)
-	: m_usage(create_info.usage) {
-	if (create_info.type == Type::Device) {
-		// device buffers require a transfer operation to copy data.
-		m_usage |= vk::BufferUsageFlagBits::eTransferDst;
-	}
-	create(allocator, create_info.type, create_info.size);
-}
-
-auto Buffer::resize(vk::DeviceSize const size) -> bool {
-	if (size <= m_buffer.get().capacity) {
-		m_buffer.get().size = size;
-		return true;
-	}
-	return create(m_buffer.get().allocator, get_type(), size);
-}
-
-auto Buffer::create(VmaAllocator allocator, Type const type,
-					vk::DeviceSize size) -> bool {
-	// buffers cannot be zero sized.
-	size = positive_size(size);
-	auto allocation_ci = VmaAllocationCreateInfo{};
-	allocation_ci.flags =
-		VMA_ALLOCATION_CREATE_HOST_ACCESS_SEQUENTIAL_WRITE_BIT;
-	if (type == BufferType::Device) {
-		allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_DEVICE;
-	} else {
-		allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_HOST;
-		allocation_ci.flags |= VMA_ALLOCATION_CREATE_MAPPED_BIT;
+[[nodiscard]] auto create_buffer(VmaAllocator allocator,
+								 VmaAllocationCreateInfo const& allocation_ci,
+								 vk::BufferUsageFlags const usage,
+								 vk::DeviceSize const size) -> Buffer {
+	if (size == 0) {
+		std::println(stderr, "Buffer cannot be 0-sized");
+		return {};
 	}
 
 	auto buffer_ci = vk::BufferCreateInfo{};
-	buffer_ci.setSize(size).setUsage(m_usage);
+	buffer_ci.setSize(size).setUsage(usage);
 	auto vma_buffer_ci = static_cast<VkBufferCreateInfo>(buffer_ci);
 
 	VmaAllocation allocation{};
@@ -62,18 +26,26 @@ auto Buffer::create(VmaAllocator allocator, Type const type,
 						&allocation, &allocation_info);
 	if (result != VK_SUCCESS) {
 		std::println(stderr, "Failed to create VMA Buffer");
-		return false;
+		return {};
 	}
 
-	m_buffer = RawBuffer{
+	return RawBuffer{
 		.allocator = allocator,
 		.allocation = allocation,
 		.buffer = buffer,
-		.capacity = size,
 		.size = size,
 		.mapped = allocation_info.pMappedData,
 	};
-	return true;
+}
+} // namespace
+
+void Deleter::operator()(VmaAllocator allocator) const noexcept {
+	vmaDestroyAllocator(allocator);
+}
+
+void BufferDeleter::operator()(RawBuffer const& raw_buffer) const noexcept {
+	vmaDestroyBuffer(raw_buffer.allocator, raw_buffer.buffer,
+					 raw_buffer.allocation);
 }
 } // namespace vma
 
@@ -97,4 +69,15 @@ auto vma::create_allocator(vk::Instance const instance,
 
 	throw std::runtime_error{"Failed to create Vulkan Memory Allocator"};
 }
+
+auto vma::create_host_buffer(VmaAllocator allocator,
+							 vk::BufferUsageFlags const usage,
+							 vk::DeviceSize const size) -> Buffer {
+	auto allocation_ci = VmaAllocationCreateInfo{};
+	allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_HOST;
+	allocation_ci.flags =
+		VMA_ALLOCATION_CREATE_HOST_ACCESS_SEQUENTIAL_WRITE_BIT |
+		VMA_ALLOCATION_CREATE_MAPPED_BIT;
+	return create_buffer(allocator, allocation_ci, usage, size);
+}
 } // namespace lvk
diff --git a/src/vma.hpp b/src/vma.hpp
index ca72202..0a5b521 100644
--- a/src/vma.hpp
+++ b/src/vma.hpp
@@ -2,7 +2,6 @@
 #include <vk_mem_alloc.h>
 #include <scoped.hpp>
 #include <vulkan/vulkan.hpp>
-#include <cstdint>
 
 namespace lvk::vma {
 struct Deleter {
@@ -16,53 +15,26 @@ using Allocator = Scoped<VmaAllocator, Deleter>;
 									vk::Device device) -> Allocator;
 
 struct RawBuffer {
+	[[nodiscard]] auto mapped_span() const -> std::span<std::byte> {
+		return std::span{static_cast<std::byte*>(mapped), size};
+	}
+
+	auto operator==(RawBuffer const& rhs) const -> bool = default;
+
 	VmaAllocator allocator{};
 	VmaAllocation allocation{};
 	vk::Buffer buffer{};
-	vk::DeviceSize capacity{};
 	vk::DeviceSize size{};
 	void* mapped{};
-
-	auto operator==(RawBuffer const& rhs) const -> bool = default;
 };
 
 struct BufferDeleter {
 	void operator()(RawBuffer const& raw_buffer) const noexcept;
 };
 
-enum class BufferType : std::int8_t { Host, Device };
-
-struct BufferCreateInfo {
-	vk::BufferUsageFlags usage{};
-	vk::DeviceSize size{};
-	BufferType type{BufferType::Host};
-};
-
-class Buffer {
-  public:
-	using CreateInfo = BufferCreateInfo;
-	using Type = BufferType;
+using Buffer = Scoped<RawBuffer, BufferDeleter>;
 
-	explicit Buffer(VmaAllocator allocator, CreateInfo const& create_info);
-
-	[[nodiscard]] auto get_type() const -> Type {
-		return m_buffer.get().mapped == nullptr ? Type::Device : Type::Host;
-	}
-
-	[[nodiscard]] auto get_usage() const -> vk::BufferUsageFlags {
-		return m_usage;
-	}
-
-	[[nodiscard]] auto get_raw() const -> RawBuffer const& {
-		return m_buffer.get();
-	}
-
-	auto resize(vk::DeviceSize size) -> bool;
-
-  private:
-	auto create(VmaAllocator allocator, Type type, vk::DeviceSize size) -> bool;
-
-	Scoped<RawBuffer, BufferDeleter> m_buffer{};
-	vk::BufferUsageFlags m_usage{};
-};
+[[nodiscard]] auto create_host_buffer(VmaAllocator allocator,
+									  vk::BufferUsageFlags usage,
+									  vk::DeviceSize size) -> Buffer;
 } // namespace lvk::vma

From ee82cf1cac269db3ecd556fe5d6b7cf51cc0d2ad Mon Sep 17 00:00:00 2001
From: Karn Kaul <karnkaul@gmail.com>
Date: Sat, 29 Mar 2025 21:21:42 -0700
Subject: [PATCH 06/11] Add `CommandBlock`, use device VBO

---
 guide/src/SUMMARY.md                          |   4 +-
 guide/src/memory/command_block.md             |  84 +++++++++++
 guide/src/memory/device_buffers.md            | 139 ++++++++++++++++++
 .../src/memory/{ibo_quad.png => vbo_quad.png} | Bin
 ...host_vertex_buffer.md => vertex_buffer.md} |   6 +-
 src/app.cpp                                   |  55 +++++--
 src/app.hpp                                   |   5 +
 src/command_block.cpp                         |  50 +++++++
 src/command_block.hpp                         |  21 +++
 src/vma.cpp                                   |  52 +++++++
 src/vma.hpp                                   |  10 ++
 11 files changed, 411 insertions(+), 15 deletions(-)
 create mode 100644 guide/src/memory/command_block.md
 create mode 100644 guide/src/memory/device_buffers.md
 rename guide/src/memory/{ibo_quad.png => vbo_quad.png} (100%)
 rename guide/src/memory/{host_vertex_buffer.md => vertex_buffer.md} (93%)
 create mode 100644 src/command_block.cpp
 create mode 100644 src/command_block.hpp

diff --git a/guide/src/SUMMARY.md b/guide/src/SUMMARY.md
index bd6a749..7f6f044 100644
--- a/guide/src/SUMMARY.md
+++ b/guide/src/SUMMARY.md
@@ -39,4 +39,6 @@
 - [Memory Allocation](memory/README.md)
   - [Vulkan Memory Allocator](memory/vma.md)
   - [Buffers](memory/buffers.md)
-  - [Host Vertex Buffer](memory/host_vertex_buffer.md)
+  - [Vertex Buffer](memory/vertex_buffer.md)
+  - [Command Block](memory/command_block.md)
+  - [Device Buffers](memory/device_buffers.md)
diff --git a/guide/src/memory/command_block.md b/guide/src/memory/command_block.md
new file mode 100644
index 0000000..26cc25c
--- /dev/null
+++ b/guide/src/memory/command_block.md
@@ -0,0 +1,84 @@
+# Command Block
+
+Long-lived vertex buffers perform better when backed by Device memory, especially for 3D meshes. Data is transferred to device buffers in two steps: 
+
+1. Allocate a host buffer and copy the data to its mapped memory
+1. Allocate a device buffer, record a Buffer Copy operation and submit it
+
+The second step requires a command buffer and queue submission (_and_ waiting for the submitted work to complete). Encapsulate this behavior into a class, it will also be used for creating images:
+
+```cpp
+class CommandBlock {
+  public:
+  explicit CommandBlock(vk::Device device, vk::Queue queue,
+                        vk::CommandPool command_pool);
+
+  [[nodiscard]] auto command_buffer() const -> vk::CommandBuffer {
+    return *m_command_buffer;
+  }
+
+  void submit_and_wait();
+
+  private:
+  vk::Device m_device{};
+  vk::Queue m_queue{};
+  vk::UniqueCommandBuffer m_command_buffer{};
+};
+```
+
+The constructor takes an existing command pool created for such ad-hoc allocations, and the queue for submission later. This way it can be passed around after creation and used by other code.
+
+```cpp
+CommandBlock::CommandBlock(vk::Device const device, vk::Queue const queue,
+               vk::CommandPool const command_pool)
+  : m_device(device), m_queue(queue) {
+  // allocate a UniqueCommandBuffer which will free the underlying command
+  // buffer from its owning pool on destruction.
+  auto allocate_info = vk::CommandBufferAllocateInfo{};
+  allocate_info.setCommandPool(command_pool)
+    .setCommandBufferCount(1)
+    .setLevel(vk::CommandBufferLevel::ePrimary);
+  // all the current VulkanHPP functions for UniqueCommandBuffer allocation
+  // return vectors.
+  auto command_buffers = m_device.allocateCommandBuffersUnique(allocate_info);
+  m_command_buffer = std::move(command_buffers.front());
+
+  // start recording commands before returning.
+  auto begin_info = vk::CommandBufferBeginInfo{};
+  begin_info.setFlags(vk::CommandBufferUsageFlagBits::eOneTimeSubmit);
+  m_command_buffer->begin(begin_info);
+}
+```
+
+`submit_and_wait()` resets the unique command buffer at the end, to free it from its command pool:
+
+```cpp
+void CommandBlock::submit_and_wait() {
+  if (!m_command_buffer) { return; }
+
+  // end recording and submit.
+  m_command_buffer->end();
+  auto submit_info = vk::SubmitInfo2KHR{};
+  auto const command_buffer_info =
+    vk::CommandBufferSubmitInfo{*m_command_buffer};
+  submit_info.setCommandBufferInfos(command_buffer_info);
+  auto fence = m_device.createFenceUnique({});
+  m_queue.submit2(submit_info, *fence);
+
+  // wait for submit fence to be signaled.
+  static constexpr auto timeout_v =
+    static_cast<std::uint64_t>(std::chrono::nanoseconds(30s).count());
+  auto const result = m_device.waitForFences(*fence, vk::True, timeout_v);
+  if (result != vk::Result::eSuccess) {
+    std::println(stderr, "Failed to submit Command Buffer");
+  }
+  // free the command buffer.
+  m_command_buffer.reset();
+}
+```
+
+## Multithreading considerations
+
+Instead of blocking the main thread on every Command Block's `submit_and_wait()`, you might be wondering if command block usage could be multithreaded. The answer is yes! But with some extra work: each thread will require its own command pool - just using one owned (unique) pool per Command Block (with no need to free the buffer) is a good starting point. All queue operations need to be synchronized, ie a critical section protected by a mutex. This includes Swapchain acquire/present calls, and Queue submissions. A `class Queue` value type that stores a copy of the `vk::Queue` and a pointer/reference to its `std::mutex` - and wraps the submit call - can be passed to command blocks. Just this much will enable asynchronous asset loading etc, as each loading thread will use its own command pool, and queue submissions all around will be critical sections. `VmaAllocator` is internally synchronized (can be disabled at build time), so performing allocations through the same allocator on multiple threads is safe.
+
+For multi-threaded rendering, use a Secondary command buffer per thread to record rendering commands, accumulate and execute them in the main (Primary) command buffer currently in `RenderSync`. This is not particularly helpful unless you have thousands of expensive draw calls and dozens of render passes, as recording even a hundred draws will likely be faster on a single thread.
diff --git a/guide/src/memory/device_buffers.md b/guide/src/memory/device_buffers.md
new file mode 100644
index 0000000..0d248b4
--- /dev/null
+++ b/guide/src/memory/device_buffers.md
@@ -0,0 +1,139 @@
+# Device Buffers
+
+This guide will only use device buffers for vertex buffers, where both vertex and index data will be strung together in a single VBO. The create function can thus take the data and perform the buffer copy operation before returning. In essence this return value is a "GPU const" buffer. To enable utilizing separate spans for vertices and indices (instead of forcing allocation of a contiguous bytestream and copying the data), the create function takes a slightly awkward span of spans:
+
+```cpp
+// disparate byte spans.
+using ByteSpans = std::span<std::span<std::byte const> const>;
+
+// returns a Device Buffer with each byte span sequentially written.
+[[nodiscard]] auto create_device_buffer(VmaAllocator allocator,
+                                        vk::BufferUsageFlags usage,
+                                        CommandBlock command_block,
+                                        ByteSpans const& byte_spans) -> Buffer;
+```
+
+Implement `create_device_buffer()`:
+
+```cpp
+auto vma::create_device_buffer(VmaAllocator allocator,
+                               vk::BufferUsageFlags usage,
+                               CommandBlock command_block,
+                               ByteSpans const& byte_spans) -> Buffer {
+  auto const total_size = std::accumulate(
+    byte_spans.begin(), byte_spans.end(), 0uz,
+    [](std::size_t const n, std::span<std::byte const> bytes) {
+      return n + bytes.size();
+    });
+
+  // create staging Host Buffer with TransferSrc usage.
+  auto staging_buffer = create_host_buffer(
+    allocator, vk::BufferUsageFlagBits::eTransferSrc, total_size);
+
+  // create the Device Buffer, ensuring TransferDst usage.
+  usage |= vk::BufferUsageFlagBits::eTransferDst;
+  auto allocation_ci = VmaAllocationCreateInfo{};
+  allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_DEVICE;
+  allocation_ci.flags =
+    VMA_ALLOCATION_CREATE_HOST_ACCESS_SEQUENTIAL_WRITE_BIT;
+  auto ret = create_buffer(allocator, allocation_ci, usage, total_size);
+
+  // can't do anything if either buffer creation failed.
+  if (!staging_buffer.get().buffer || !ret.get().buffer) { return {}; }
+
+  // copy byte spans into staging buffer.
+  auto dst = staging_buffer.get().mapped_span();
+  for (auto const bytes : byte_spans) {
+    std::memcpy(dst.data(), bytes.data(), bytes.size());
+    dst = dst.subspan(bytes.size());
+  }
+
+  // record buffer copy operation.
+  auto buffer_copy = vk::BufferCopy2{};
+  buffer_copy.setSize(total_size);
+  auto copy_buffer_info = vk::CopyBufferInfo2{};
+  copy_buffer_info.setSrcBuffer(staging_buffer.get().buffer)
+    .setDstBuffer(ret.get().buffer)
+    .setRegions(buffer_copy);
+  command_block.command_buffer().copyBuffer2(copy_buffer_info);
+
+  // submit and wait.
+  // waiting here is necessary to keep the staging buffer alive while the GPU
+  // accesses it through the recorded commands.
+  // this is also why the function takes ownership of the passed CommandBlock
+  // instead of just referencing it / taking a vk::CommandBuffer.
+  command_block.submit_and_wait();
+
+  return ret;
+}
+```
+
+Add a command block pool to `App`, and a helper function to create command blocks:
+
+```cpp
+void App::create_cmd_block_pool() {
+  auto command_pool_ci = vk::CommandPoolCreateInfo{};
+  command_pool_ci
+    .setQueueFamilyIndex(m_gpu.queue_family)
+    // this flag indicates that the allocated Command Buffers will be
+    // short-lived.
+    .setFlags(vk::CommandPoolCreateFlagBits::eTransient);
+  m_cmd_block_pool = m_device->createCommandPoolUnique(command_pool_ci);
+}
+
+auto App::create_command_block() const -> CommandBlock {
+  return CommandBlock{*m_device, m_queue, *m_cmd_block_pool};
+}
+```
+
+Update `create_vertex_buffer()` to create a quad with indices:
+
+```cpp
+template <typename T>
+[[nodiscard]] constexpr auto to_byte_array(T const& t) {
+  return std::bit_cast<std::array<std::byte, sizeof(T)>>(t);
+}
+
+// ...
+void App::create_vertex_buffer() {
+  // vertices of a quad.
+  static constexpr auto vertices_v = std::array{
+    Vertex{.position = {-0.5f, -0.5f}, .color = {1.0f, 0.0f, 0.0f}},
+    Vertex{.position = {0.5f, -0.5f}, .color = {0.0f, 1.0f, 0.0f}},
+    Vertex{.position = {0.5f, 0.5f}, .color = {0.0f, 0.0f, 1.0f}},
+    Vertex{.position = {-0.5f, 0.5f}, .color = {1.0f, 1.0f, 0.0f}},
+  };
+  static constexpr auto indices_v = std::array{
+    0u, 1u, 2u, 2u, 3u, 0u,
+  };
+  static constexpr auto vertices_bytes_v = to_byte_array(vertices_v);
+  static constexpr auto indices_bytes_v = to_byte_array(indices_v);
+  static constexpr auto total_bytes_v =
+    std::array<std::span<std::byte const>, 2>{
+      vertices_bytes_v,
+      indices_bytes_v,
+    };
+  // we want to write total_bytes_v to a Device VertexBuffer | IndexBuffer.
+  m_vbo = vma::create_device_buffer(m_allocator.get(),
+                                    vk::BufferUsageFlagBits::eVertexBuffer |
+                                      vk::BufferUsageFlagBits::eIndexBuffer,
+                                    create_command_block(), total_bytes_v);
+}
+```
+
+Update `draw()`:
+
+```cpp
+void App::draw(vk::CommandBuffer const command_buffer) const {
+  m_shader->bind(command_buffer, m_framebuffer_size);
+  // single VBO at binding 0 at no offset.
+  command_buffer.bindVertexBuffers(0, m_vbo.get().buffer, vk::DeviceSize{});
+  // u32 indices after offset of 4 vertices.
+  command_buffer.bindIndexBuffer(m_vbo.get().buffer, 4 * sizeof(Vertex),
+                                 vk::IndexType::eUint32);
+  // m_vbo has 6 indices.
+  command_buffer.drawIndexed(6, 1, 0, 0, 0);
+}
+```
+
+![VBO Quad](./vbo_quad.png)
diff --git a/guide/src/memory/ibo_quad.png b/guide/src/memory/vbo_quad.png
similarity index 100%
rename from guide/src/memory/ibo_quad.png
rename to guide/src/memory/vbo_quad.png
diff --git a/guide/src/memory/host_vertex_buffer.md b/guide/src/memory/vertex_buffer.md
similarity index 93%
rename from guide/src/memory/host_vertex_buffer.md
rename to guide/src/memory/vertex_buffer.md
index 4b0e1cf..0efe3a2 100644
--- a/guide/src/memory/host_vertex_buffer.md
+++ b/guide/src/memory/vertex_buffer.md
@@ -1,6 +1,6 @@
-# Host Vertex Buffer
+# Vertex Buffer
 
-The goal here is to move the hard-coded vertices in the shader to application code. For the time being we will use an ad-hoc Host type `vma::Buffer` and focus more on the rest of the infrastructure like vertex attributes.
+The goal here is to move the hard-coded vertices in the shader to application code. For the time being we will use an ad-hoc Host `vma::Buffer` and focus more on the rest of the infrastructure like vertex attributes.
 
 First add a new header, `vertex.hpp`:
 
@@ -97,6 +97,6 @@ command_buffer.bindVertexBuffers(0, m_vbo->get_raw().buffer,
 command_buffer.draw(3, 1, 0, 0);
 ```
 
-You should see the same triangle as before. But now we can use whatever set of vertices we like! The Primitive Topology is Triange List by default, so every three vertices in the array is drawn as a triangle, eg for 9 vertices: `[[0, 1, 2], [3, 4, 5], [6, 7, 8]]`, where each inner `[]` represents a triangle comprised of the vertices at those indices.
+You should see the same triangle as before. But now we can use whatever set of vertices we like! The Primitive Topology is Triange List by default, so every three vertices in the array is drawn as a triangle, eg for 9 vertices: `[[0, 1, 2], [3, 4, 5], [6, 7, 8]]`, where each inner `[]` represents a triangle comprised of the vertices at those indices. Try playing around with customized vertices and topologies, use Render Doc to debug unexpected outputs / bugs.
 
 Host Vertex Buffers are useful for primitives that are temporary and/or frequently changing, such as UI objects. A 2D framework can use such VBOs exclusively: a simple approach would be a pool of buffers per virtual frame where for each draw a buffer is obtained from the current virtual frame's pool and vertices are copied in.
diff --git a/src/app.cpp b/src/app.cpp
index 56312d2..64e6e4c 100644
--- a/src/app.cpp
+++ b/src/app.cpp
@@ -1,5 +1,6 @@
 #include <app.hpp>
 #include <vertex.hpp>
+#include <bit>
 #include <cassert>
 #include <chrono>
 #include <fstream>
@@ -12,6 +13,11 @@ namespace lvk {
 using namespace std::chrono_literals;
 
 namespace {
+template <typename T>
+[[nodiscard]] constexpr auto to_byte_array(T const& t) {
+	return std::bit_cast<std::array<std::byte, sizeof(T)>>(t);
+}
+
 [[nodiscard]] auto locate_assets_dir() -> fs::path {
 	// look for '<path>/assets/', starting from the working
 	// directory and walking up the parent directory tree.
@@ -83,6 +89,7 @@ void App::run() {
 	create_render_sync();
 	create_imgui();
 	create_shader();
+	create_cmd_block_pool();
 
 	create_vertex_buffer();
 
@@ -254,26 +261,49 @@ void App::create_shader() {
 	m_shader.emplace(shader_ci);
 }
 
+void App::create_cmd_block_pool() {
+	auto command_pool_ci = vk::CommandPoolCreateInfo{};
+	command_pool_ci
+		.setQueueFamilyIndex(m_gpu.queue_family)
+		// this flag indicates that the allocated Command Buffers will be
+		// short-lived.
+		.setFlags(vk::CommandPoolCreateFlagBits::eTransient);
+	m_cmd_block_pool = m_device->createCommandPoolUnique(command_pool_ci);
+}
+
 void App::create_vertex_buffer() {
-	// vertices previously hard-coded in the vertex shader.
+	// vertices of a quad.
 	static constexpr auto vertices_v = std::array{
 		Vertex{.position = {-0.5f, -0.5f}, .color = {1.0f, 0.0f, 0.0f}},
 		Vertex{.position = {0.5f, -0.5f}, .color = {0.0f, 1.0f, 0.0f}},
-		Vertex{.position = {0.0f, 0.5f}, .color = {0.0f, 0.0f, 1.0f}},
+		Vertex{.position = {0.5f, 0.5f}, .color = {0.0f, 0.0f, 1.0f}},
+		Vertex{.position = {-0.5f, 0.5f}, .color = {1.0f, 1.0f, 0.0f}},
 	};
-	// we want to write vertices_v to a Host VertexBuffer.
-	m_vbo = vma::create_host_buffer(m_allocator.get(),
-									vk::BufferUsageFlagBits::eVertexBuffer,
-									sizeof(vertices_v));
-
-	// host buffers have a memory-mapped pointer available to memcpy data to.
-	std::memcpy(m_vbo.get().mapped, vertices_v.data(), sizeof(vertices_v));
+	static constexpr auto indices_v = std::array{
+		0u, 1u, 2u, 2u, 3u, 0u,
+	};
+	static constexpr auto vertices_bytes_v = to_byte_array(vertices_v);
+	static constexpr auto indices_bytes_v = to_byte_array(indices_v);
+	static constexpr auto total_bytes_v =
+		std::array<std::span<std::byte const>, 2>{
+			vertices_bytes_v,
+			indices_bytes_v,
+		};
+	// we want to write total_bytes_v to a Device VertexBuffer | IndexBuffer.
+	m_vbo = vma::create_device_buffer(m_allocator.get(),
+									  vk::BufferUsageFlagBits::eVertexBuffer |
+										  vk::BufferUsageFlagBits::eIndexBuffer,
+									  create_command_block(), total_bytes_v);
 }
 
 auto App::asset_path(std::string_view const uri) const -> fs::path {
 	return m_assets_dir / uri;
 }
 
+auto App::create_command_block() const -> CommandBlock {
+	return CommandBlock{*m_device, m_queue, *m_cmd_block_pool};
+}
+
 void App::main_loop() {
 	while (glfwWindowShouldClose(m_window.get()) == GLFW_FALSE) {
 		glfwPollEvents();
@@ -450,7 +480,10 @@ void App::draw(vk::CommandBuffer const command_buffer) const {
 	m_shader->bind(command_buffer, m_framebuffer_size);
 	// single VBO at binding 0 at no offset.
 	command_buffer.bindVertexBuffers(0, m_vbo.get().buffer, vk::DeviceSize{});
-	// m_vbo has 3 vertices.
-	command_buffer.draw(3, 1, 0, 0);
+	// u32 indices after offset of 4 vertices.
+	command_buffer.bindIndexBuffer(m_vbo.get().buffer, 4 * sizeof(Vertex),
+								   vk::IndexType::eUint32);
+	// m_vbo has 6 indices.
+	command_buffer.drawIndexed(6, 1, 0, 0, 0);
 }
 } // namespace lvk
diff --git a/src/app.hpp b/src/app.hpp
index 0426738..5bd094d 100644
--- a/src/app.hpp
+++ b/src/app.hpp
@@ -1,4 +1,5 @@
 #pragma once
+#include <command_block.hpp>
 #include <dear_imgui.hpp>
 #include <gpu.hpp>
 #include <resource_buffering.hpp>
@@ -38,9 +39,11 @@ class App {
 	void create_imgui();
 	void create_allocator();
 	void create_shader();
+	void create_cmd_block_pool();
 	void create_vertex_buffer();
 
 	[[nodiscard]] auto asset_path(std::string_view uri) const -> fs::path;
+	[[nodiscard]] auto create_command_block() const -> CommandBlock;
 
 	void main_loop();
 
@@ -70,6 +73,8 @@ class App {
 	std::optional<Swapchain> m_swapchain{};
 	// command pool for all render Command Buffers.
 	vk::UniqueCommandPool m_render_cmd_pool{};
+	// command pool for all Command Blocks.
+	vk::UniqueCommandPool m_cmd_block_pool{};
 	// Sync and Command Buffer for virtual frames.
 	Buffered<RenderSync> m_render_sync{};
 	// Current virtual frame index.
diff --git a/src/command_block.cpp b/src/command_block.cpp
new file mode 100644
index 0000000..1a1258e
--- /dev/null
+++ b/src/command_block.cpp
@@ -0,0 +1,50 @@
+#include <command_block.hpp>
+#include <chrono>
+#include <print>
+
+namespace lvk {
+using namespace std::chrono_literals;
+
+CommandBlock::CommandBlock(vk::Device const device, vk::Queue const queue,
+						   vk::CommandPool const command_pool)
+	: m_device(device), m_queue(queue) {
+	// allocate a UniqueCommandBuffer which will free the underlying command
+	// buffer from its owning pool on destruction.
+	auto allocate_info = vk::CommandBufferAllocateInfo{};
+	allocate_info.setCommandPool(command_pool)
+		.setCommandBufferCount(1)
+		.setLevel(vk::CommandBufferLevel::ePrimary);
+	// all the current VulkanHPP functions for UniqueCommandBuffer allocation
+	// return vectors.
+	auto command_buffers = m_device.allocateCommandBuffersUnique(allocate_info);
+	m_command_buffer = std::move(command_buffers.front());
+
+	// start recording commands before returning.
+	auto begin_info = vk::CommandBufferBeginInfo{};
+	begin_info.setFlags(vk::CommandBufferUsageFlagBits::eOneTimeSubmit);
+	m_command_buffer->begin(begin_info);
+}
+
+void CommandBlock::submit_and_wait() {
+	if (!m_command_buffer) { return; }
+
+	// end recording and submit.
+	m_command_buffer->end();
+	auto submit_info = vk::SubmitInfo2KHR{};
+	auto const command_buffer_info =
+		vk::CommandBufferSubmitInfo{*m_command_buffer};
+	submit_info.setCommandBufferInfos(command_buffer_info);
+	auto fence = m_device.createFenceUnique({});
+	m_queue.submit2(submit_info, *fence);
+
+	// wait for submit fence to be signaled.
+	static constexpr auto timeout_v =
+		static_cast<std::uint64_t>(std::chrono::nanoseconds(30s).count());
+	auto const result = m_device.waitForFences(*fence, vk::True, timeout_v);
+	if (result != vk::Result::eSuccess) {
+		std::println(stderr, "Failed to submit Command Buffer");
+	}
+	// free the command buffer.
+	m_command_buffer.reset();
+}
+} // namespace lvk
diff --git a/src/command_block.hpp b/src/command_block.hpp
new file mode 100644
index 0000000..a5719c8
--- /dev/null
+++ b/src/command_block.hpp
@@ -0,0 +1,21 @@
+#pragma once
+#include <vulkan/vulkan.hpp>
+
+namespace lvk {
+class CommandBlock {
+  public:
+	explicit CommandBlock(vk::Device device, vk::Queue queue,
+						  vk::CommandPool command_pool);
+
+	[[nodiscard]] auto command_buffer() const -> vk::CommandBuffer {
+		return *m_command_buffer;
+	}
+
+	void submit_and_wait();
+
+  private:
+	vk::Device m_device{};
+	vk::Queue m_queue{};
+	vk::UniqueCommandBuffer m_command_buffer{};
+};
+} // namespace lvk
diff --git a/src/vma.cpp b/src/vma.cpp
index 8841957..9a93ff8 100644
--- a/src/vma.cpp
+++ b/src/vma.cpp
@@ -1,4 +1,5 @@
 #include <vma.hpp>
+#include <numeric>
 #include <print>
 #include <stdexcept>
 
@@ -80,4 +81,55 @@ auto vma::create_host_buffer(VmaAllocator allocator,
 		VMA_ALLOCATION_CREATE_MAPPED_BIT;
 	return create_buffer(allocator, allocation_ci, usage, size);
 }
+
+auto vma::create_device_buffer(VmaAllocator allocator,
+							   vk::BufferUsageFlags usage,
+							   CommandBlock command_block,
+							   ByteSpans const& byte_spans) -> Buffer {
+	auto const total_size = std::accumulate(
+		byte_spans.begin(), byte_spans.end(), 0uz,
+		[](std::size_t const n, std::span<std::byte const> bytes) {
+			return n + bytes.size();
+		});
+
+	// create staging Host Buffer with TransferSrc usage.
+	auto staging_buffer = create_host_buffer(
+		allocator, vk::BufferUsageFlagBits::eTransferSrc, total_size);
+
+	// create the Device Buffer, ensuring TransferDst usage.
+	usage |= vk::BufferUsageFlagBits::eTransferDst;
+	auto allocation_ci = VmaAllocationCreateInfo{};
+	allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_DEVICE;
+	allocation_ci.flags =
+		VMA_ALLOCATION_CREATE_HOST_ACCESS_SEQUENTIAL_WRITE_BIT;
+	auto ret = create_buffer(allocator, allocation_ci, usage, total_size);
+
+	// can't do anything if either buffer creation failed.
+	if (!staging_buffer.get().buffer || !ret.get().buffer) { return {}; }
+
+	// copy byte spans into staging buffer.
+	auto dst = staging_buffer.get().mapped_span();
+	for (auto const bytes : byte_spans) {
+		std::memcpy(dst.data(), bytes.data(), bytes.size());
+		dst = dst.subspan(bytes.size());
+	}
+
+	// record buffer copy operation.
+	auto buffer_copy = vk::BufferCopy2{};
+	buffer_copy.setSize(total_size);
+	auto copy_buffer_info = vk::CopyBufferInfo2{};
+	copy_buffer_info.setSrcBuffer(staging_buffer.get().buffer)
+		.setDstBuffer(ret.get().buffer)
+		.setRegions(buffer_copy);
+	command_block.command_buffer().copyBuffer2(copy_buffer_info);
+
+	// submit and wait.
+	// waiting here is necessary to keep the staging buffer alive while the GPU
+	// accesses it through the recorded commands.
+	// this is also why the function takes ownership of the passed CommandBlock
+	// instead of just referencing it / taking a vk::CommandBuffer.
+	command_block.submit_and_wait();
+
+	return ret;
+}
 } // namespace lvk
diff --git a/src/vma.hpp b/src/vma.hpp
index 0a5b521..77b1c73 100644
--- a/src/vma.hpp
+++ b/src/vma.hpp
@@ -1,5 +1,6 @@
 #pragma once
 #include <vk_mem_alloc.h>
+#include <command_block.hpp>
 #include <scoped.hpp>
 #include <vulkan/vulkan.hpp>
 
@@ -37,4 +38,13 @@ using Buffer = Scoped<RawBuffer, BufferDeleter>;
 [[nodiscard]] auto create_host_buffer(VmaAllocator allocator,
 									  vk::BufferUsageFlags usage,
 									  vk::DeviceSize size) -> Buffer;
+
+// disparate byte spans.
+using ByteSpans = std::span<std::span<std::byte const> const>;
+
+// returns a Device Buffer with each byte span sequentially written.
+[[nodiscard]] auto create_device_buffer(VmaAllocator allocator,
+										vk::BufferUsageFlags usage,
+										CommandBlock command_block,
+										ByteSpans const& byte_spans) -> Buffer;
 } // namespace lvk::vma

From 19ba8ac39c8eee4d30d2955d23f351adb425a7c4 Mon Sep 17 00:00:00 2001
From: Karn Kaul <karnkaul@gmail.com>
Date: Sun, 30 Mar 2025 00:43:47 -0700
Subject: [PATCH 07/11] Refactor Buffer API

---
 guide/src/memory/buffers.md        |  65 +++++++------
 guide/src/memory/device_buffers.md |  22 ++---
 guide/src/memory/vertex_buffer.md  |  18 ++--
 src/app.cpp                        |  12 ++-
 src/vma.cpp                        | 145 ++++++++++++++++++-----------
 src/vma.hpp                        |  45 ++++++++-
 6 files changed, 191 insertions(+), 116 deletions(-)

diff --git a/guide/src/memory/buffers.md b/guide/src/memory/buffers.md
index 149be94..4c74806 100644
--- a/guide/src/memory/buffers.md
+++ b/guide/src/memory/buffers.md
@@ -28,45 +28,63 @@ void BufferDeleter::operator()(RawBuffer const& raw_buffer) const noexcept {
 }
 ```
 
-Buffers can be backed by host (RAM) or device (VRAM) memory: the former is mappable and thus useful for data that changes every frame, latter is faster to access for the GPU but needs more complex methods to copy data from the CPU to it. Leaving device buffers for later, add the `Buffer` alias and a create function:
+Buffers can be backed by host (RAM) or device (VRAM) memory: the former is mappable and thus useful for data that changes every frame, latter is faster to access for the GPU but needs more complex methods to copy data to. Add the related types and a create function:
 
 ```cpp
-using Buffer = Scoped<RawBuffer, BufferDeleter>;
+struct BufferCreateInfo {
+  VmaAllocator allocator;
+  vk::BufferUsageFlags usage;
+  std::uint32_t queue_family;
+};
 
-[[nodiscard]] auto create_host_buffer(VmaAllocator allocator,
-                                      vk::BufferUsageFlags usage,
-                                      vk::DeviceSize size) -> Buffer;
-```
+enum class BufferMemoryType : std::int8_t { Host, Device };
 
-Add a helper function that can be reused for device buffers too later:
+[[nodiscard]] auto create_buffer(BufferCreateInfo const& create_info,
+                                 BufferMemoryType memory_type,
+                                 vk::DeviceSize size) -> Buffer;
 
-```cpp
-[[nodiscard]] auto create_buffer(VmaAllocator allocator,
-                                 VmaAllocationCreateInfo const& allocation_ci,
-                                 vk::BufferUsageFlags const usage,
-                                 vk::DeviceSize const size) -> Buffer {
+// ...
+auto vma::create_buffer(BufferCreateInfo const& create_info,
+                        BufferMemoryType const memory_type,
+                        vk::DeviceSize const size) -> Buffer {
   if (size == 0) {
     std::println(stderr, "Buffer cannot be 0-sized");
     return {};
   }
 
+  auto allocation_ci = VmaAllocationCreateInfo{};
+  allocation_ci.flags =
+    VMA_ALLOCATION_CREATE_HOST_ACCESS_SEQUENTIAL_WRITE_BIT;
+  auto usage = create_info.usage;
+  if (memory_type == BufferMemoryType::Device) {
+    allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_DEVICE;
+    // device buffers need to support TransferDst.
+    usage |= vk::BufferUsageFlagBits::eTransferDst;
+  } else {
+    allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_HOST;
+    // host buffers can provide mapped memory.
+    allocation_ci.flags |= VMA_ALLOCATION_CREATE_MAPPED_BIT;
+  }
+
   auto buffer_ci = vk::BufferCreateInfo{};
-  buffer_ci.setSize(size).setUsage(usage);
+  buffer_ci.setQueueFamilyIndices(create_info.queue_family)
+    .setSize(size)
+    .setUsage(usage);
   auto vma_buffer_ci = static_cast<VkBufferCreateInfo>(buffer_ci);
 
   VmaAllocation allocation{};
   VkBuffer buffer{};
   auto allocation_info = VmaAllocationInfo{};
   auto const result =
-    vmaCreateBuffer(allocator, &vma_buffer_ci, &allocation_ci, &buffer,
-            &allocation, &allocation_info);
+    vmaCreateBuffer(create_info.allocator, &vma_buffer_ci, &allocation_ci,
+            &buffer, &allocation, &allocation_info);
   if (result != VK_SUCCESS) {
     std::println(stderr, "Failed to create VMA Buffer");
     return {};
   }
 
   return RawBuffer{
-    .allocator = allocator,
+    .allocator = create_info.allocator,
     .allocation = allocation,
     .buffer = buffer,
     .size = size,
@@ -74,18 +92,3 @@ Add a helper function that can be reused for device buffers too later:
   };
 }
 ```
-
-Implement `create_host_buffer()`:
-
-```cpp
-auto vma::create_host_buffer(VmaAllocator allocator,
-                             vk::BufferUsageFlags const usage,
-                             vk::DeviceSize const size) -> Buffer {
-  auto allocation_ci = VmaAllocationCreateInfo{};
-  allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_HOST;
-  allocation_ci.flags =
-    VMA_ALLOCATION_CREATE_HOST_ACCESS_SEQUENTIAL_WRITE_BIT |
-    VMA_ALLOCATION_CREATE_MAPPED_BIT;
-  return create_buffer(allocator, allocation_ci, usage, size);
-}
-```
diff --git a/guide/src/memory/device_buffers.md b/guide/src/memory/device_buffers.md
index 0d248b4..1a72369 100644
--- a/guide/src/memory/device_buffers.md
+++ b/guide/src/memory/device_buffers.md
@@ -7,8 +7,7 @@ This guide will only use device buffers for vertex buffers, where both vertex an
 using ByteSpans = std::span<std::span<std::byte const> const>;
 
 // returns a Device Buffer with each byte span sequentially written.
-[[nodiscard]] auto create_device_buffer(VmaAllocator allocator,
-                                        vk::BufferUsageFlags usage,
+[[nodiscard]] auto create_device_buffer(BufferCreateInfo const& create_info,
                                         CommandBlock command_block,
                                         ByteSpans const& byte_spans) -> Buffer;
 ```
@@ -16,8 +15,7 @@ using ByteSpans = std::span<std::span<std::byte const> const>;
 Implement `create_device_buffer()`:
 
 ```cpp
-auto vma::create_device_buffer(VmaAllocator allocator,
-                               vk::BufferUsageFlags usage,
+auto vma::create_device_buffer(BufferCreateInfo const& create_info,
                                CommandBlock command_block,
                                ByteSpans const& byte_spans) -> Buffer {
   auto const total_size = std::accumulate(
@@ -26,18 +24,14 @@ auto vma::create_device_buffer(VmaAllocator allocator,
       return n + bytes.size();
     });
 
-  // create staging Host Buffer with TransferSrc usage.
-  auto staging_buffer = create_host_buffer(
-    allocator, vk::BufferUsageFlagBits::eTransferSrc, total_size);
+  auto staging_ci = create_info;
+  staging_ci.usage = vk::BufferUsageFlagBits::eTransferSrc;
 
+  // create staging Host Buffer with TransferSrc usage.
+  auto staging_buffer =
+    create_buffer(create_info, BufferMemoryType::Host, total_size);
   // create the Device Buffer, ensuring TransferDst usage.
-  usage |= vk::BufferUsageFlagBits::eTransferDst;
-  auto allocation_ci = VmaAllocationCreateInfo{};
-  allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_DEVICE;
-  allocation_ci.flags =
-    VMA_ALLOCATION_CREATE_HOST_ACCESS_SEQUENTIAL_WRITE_BIT;
-  auto ret = create_buffer(allocator, allocation_ci, usage, total_size);
-
+  auto ret = create_buffer(create_info, BufferMemoryType::Device, total_size);
   // can't do anything if either buffer creation failed.
   if (!staging_buffer.get().buffer || !ret.get().buffer) { return {}; }
 
diff --git a/guide/src/memory/vertex_buffer.md b/guide/src/memory/vertex_buffer.md
index 0efe3a2..703258b 100644
--- a/guide/src/memory/vertex_buffer.md
+++ b/guide/src/memory/vertex_buffer.md
@@ -68,20 +68,22 @@ Add a VBO (Vertex Buffer Object) member and create it:
 
 ```cpp
 void App::create_vertex_buffer() {
-  // we want to write 4x Vertex objects to a Host VertexBuffer.
-  auto const buffer_ci = vma::BufferCreateInfo{
-    .usage = vk::BufferUsageFlagBits::eVertexBuffer,
-    .size = 4 * sizeof(Vertex),
-    .type = vma::BufferType::Host,
-  };
-  m_vbo = vma::create_buffer(m_allocator.get(), buffer_ci);
-
   // vertices moved from the shader.
   static constexpr auto vertices_v = std::array{
     Vertex{.position = {-0.5f, -0.5f}, .color = {1.0f, 0.0f, 0.0f}},
     Vertex{.position = {0.5f, -0.5f}, .color = {0.0f, 1.0f, 0.0f}},
     Vertex{.position = {0.0f, 0.5f}, .color = {0.0f, 0.0f, 1.0f}},
   };
+
+  // we want to write vertices_v to a Host VertexBuffer.
+  auto const buffer_ci = vma::BufferCreateInfo{
+    .allocator = m_allocator.get(),
+    .usage = vk::BufferUsageFlagBits::eVertexBuffer,
+    .queue_family = m_gpu.queue_family,
+  };
+  m_vbo = vma::create_buffer(buffer_ci, vma::BufferMemoryType::Host,
+                             sizeof(vertices_v));
+
   // host buffers have a memory-mapped pointer available to memcpy data to.
   std::memcpy(m_vbo.get().mapped, vertices_v.data(), sizeof(vertices_v));
 }
diff --git a/src/app.cpp b/src/app.cpp
index 64e6e4c..3f5839e 100644
--- a/src/app.cpp
+++ b/src/app.cpp
@@ -290,10 +290,14 @@ void App::create_vertex_buffer() {
 			indices_bytes_v,
 		};
 	// we want to write total_bytes_v to a Device VertexBuffer | IndexBuffer.
-	m_vbo = vma::create_device_buffer(m_allocator.get(),
-									  vk::BufferUsageFlagBits::eVertexBuffer |
-										  vk::BufferUsageFlagBits::eIndexBuffer,
-									  create_command_block(), total_bytes_v);
+	auto const buffer_ci = vma::BufferCreateInfo{
+		.allocator = m_allocator.get(),
+		.usage = vk::BufferUsageFlagBits::eVertexBuffer |
+				 vk::BufferUsageFlagBits::eIndexBuffer,
+		.queue_family = m_gpu.queue_family,
+	};
+	m_vbo = vma::create_device_buffer(buffer_ci, create_command_block(),
+									  total_bytes_v);
 }
 
 auto App::asset_path(std::string_view const uri) const -> fs::path {
diff --git a/src/vma.cpp b/src/vma.cpp
index 9a93ff8..42b6fb6 100644
--- a/src/vma.cpp
+++ b/src/vma.cpp
@@ -5,41 +5,6 @@
 
 namespace lvk {
 namespace vma {
-namespace {
-[[nodiscard]] auto create_buffer(VmaAllocator allocator,
-								 VmaAllocationCreateInfo const& allocation_ci,
-								 vk::BufferUsageFlags const usage,
-								 vk::DeviceSize const size) -> Buffer {
-	if (size == 0) {
-		std::println(stderr, "Buffer cannot be 0-sized");
-		return {};
-	}
-
-	auto buffer_ci = vk::BufferCreateInfo{};
-	buffer_ci.setSize(size).setUsage(usage);
-	auto vma_buffer_ci = static_cast<VkBufferCreateInfo>(buffer_ci);
-
-	VmaAllocation allocation{};
-	VkBuffer buffer{};
-	auto allocation_info = VmaAllocationInfo{};
-	auto const result =
-		vmaCreateBuffer(allocator, &vma_buffer_ci, &allocation_ci, &buffer,
-						&allocation, &allocation_info);
-	if (result != VK_SUCCESS) {
-		std::println(stderr, "Failed to create VMA Buffer");
-		return {};
-	}
-
-	return RawBuffer{
-		.allocator = allocator,
-		.allocation = allocation,
-		.buffer = buffer,
-		.size = size,
-		.mapped = allocation_info.pMappedData,
-	};
-}
-} // namespace
-
 void Deleter::operator()(VmaAllocator allocator) const noexcept {
 	vmaDestroyAllocator(allocator);
 }
@@ -71,19 +36,55 @@ auto vma::create_allocator(vk::Instance const instance,
 	throw std::runtime_error{"Failed to create Vulkan Memory Allocator"};
 }
 
-auto vma::create_host_buffer(VmaAllocator allocator,
-							 vk::BufferUsageFlags const usage,
-							 vk::DeviceSize const size) -> Buffer {
+auto vma::create_buffer(BufferCreateInfo const& create_info,
+						BufferMemoryType const memory_type,
+						vk::DeviceSize const size) -> Buffer {
+	if (size == 0) {
+		std::println(stderr, "Buffer cannot be 0-sized");
+		return {};
+	}
+
 	auto allocation_ci = VmaAllocationCreateInfo{};
-	allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_HOST;
 	allocation_ci.flags =
-		VMA_ALLOCATION_CREATE_HOST_ACCESS_SEQUENTIAL_WRITE_BIT |
-		VMA_ALLOCATION_CREATE_MAPPED_BIT;
-	return create_buffer(allocator, allocation_ci, usage, size);
+		VMA_ALLOCATION_CREATE_HOST_ACCESS_SEQUENTIAL_WRITE_BIT;
+	auto usage = create_info.usage;
+	if (memory_type == BufferMemoryType::Device) {
+		allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_DEVICE;
+		// device buffers need to support TransferDst.
+		usage |= vk::BufferUsageFlagBits::eTransferDst;
+	} else {
+		allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_HOST;
+		// host buffers can provide mapped memory.
+		allocation_ci.flags |= VMA_ALLOCATION_CREATE_MAPPED_BIT;
+	}
+
+	auto buffer_ci = vk::BufferCreateInfo{};
+	buffer_ci.setQueueFamilyIndices(create_info.queue_family)
+		.setSize(size)
+		.setUsage(usage);
+	auto vma_buffer_ci = static_cast<VkBufferCreateInfo>(buffer_ci);
+
+	VmaAllocation allocation{};
+	VkBuffer buffer{};
+	auto allocation_info = VmaAllocationInfo{};
+	auto const result =
+		vmaCreateBuffer(create_info.allocator, &vma_buffer_ci, &allocation_ci,
+						&buffer, &allocation, &allocation_info);
+	if (result != VK_SUCCESS) {
+		std::println(stderr, "Failed to create VMA Buffer");
+		return {};
+	}
+
+	return RawBuffer{
+		.allocator = create_info.allocator,
+		.allocation = allocation,
+		.buffer = buffer,
+		.size = size,
+		.mapped = allocation_info.pMappedData,
+	};
 }
 
-auto vma::create_device_buffer(VmaAllocator allocator,
-							   vk::BufferUsageFlags usage,
+auto vma::create_device_buffer(BufferCreateInfo const& create_info,
 							   CommandBlock command_block,
 							   ByteSpans const& byte_spans) -> Buffer {
 	auto const total_size = std::accumulate(
@@ -92,18 +93,14 @@ auto vma::create_device_buffer(VmaAllocator allocator,
 			return n + bytes.size();
 		});
 
-	// create staging Host Buffer with TransferSrc usage.
-	auto staging_buffer = create_host_buffer(
-		allocator, vk::BufferUsageFlagBits::eTransferSrc, total_size);
+	auto staging_ci = create_info;
+	staging_ci.usage = vk::BufferUsageFlagBits::eTransferSrc;
 
+	// create staging Host Buffer with TransferSrc usage.
+	auto staging_buffer =
+		create_buffer(create_info, BufferMemoryType::Host, total_size);
 	// create the Device Buffer, ensuring TransferDst usage.
-	usage |= vk::BufferUsageFlagBits::eTransferDst;
-	auto allocation_ci = VmaAllocationCreateInfo{};
-	allocation_ci.usage = VMA_MEMORY_USAGE_AUTO_PREFER_DEVICE;
-	allocation_ci.flags =
-		VMA_ALLOCATION_CREATE_HOST_ACCESS_SEQUENTIAL_WRITE_BIT;
-	auto ret = create_buffer(allocator, allocation_ci, usage, total_size);
-
+	auto ret = create_buffer(create_info, BufferMemoryType::Device, total_size);
 	// can't do anything if either buffer creation failed.
 	if (!staging_buffer.get().buffer || !ret.get().buffer) { return {}; }
 
@@ -132,4 +129,44 @@ auto vma::create_device_buffer(VmaAllocator allocator,
 
 	return ret;
 }
+
+auto vma::create_image(VmaAllocator allocator,
+					   ImageCreateInfo const& create_info) -> Image {
+	if (create_info.extent.width == 0 || create_info.extent.height == 0) {
+		std::println(stderr, "Images cannot have 0 width or height");
+		return {};
+	}
+	auto image_ci = vk::ImageCreateInfo{};
+	image_ci.setImageType(vk::ImageType::e2D)
+		.setExtent({create_info.extent.width, create_info.extent.height, 1})
+		.setFormat(create_info.format)
+		.setUsage(create_info.usage)
+		.setArrayLayers(1)
+		.setMipLevels(create_info.levels)
+		.setSamples(vk::SampleCountFlagBits::e1)
+		.setTiling(vk::ImageTiling::eOptimal)
+		.setInitialLayout(vk::ImageLayout::eUndefined)
+		.setQueueFamilyIndices(create_info.queue_family);
+	auto const vk_image_ci = static_cast<VkImageCreateInfo>(image_ci);
+
+	auto allocation_ci = VmaAllocationCreateInfo{};
+	allocation_ci.usage = VMA_MEMORY_USAGE_AUTO;
+	VkImage image{};
+	VmaAllocation allocation{};
+	auto const result = vmaCreateImage(allocator, &vk_image_ci, &allocation_ci,
+									   &image, &allocation, {});
+	if (result != VK_SUCCESS) {
+		std::println(stderr, "Failed to create VMA Image");
+		return {};
+	}
+
+	return RawImage{
+		.allocator = allocator,
+		.allocation = allocation,
+		.image = image,
+		.extent = create_info.extent,
+		.format = create_info.format,
+		.levels = create_info.levels,
+	};
+}
 } // namespace lvk
diff --git a/src/vma.hpp b/src/vma.hpp
index 77b1c73..9060383 100644
--- a/src/vma.hpp
+++ b/src/vma.hpp
@@ -35,16 +35,51 @@ struct BufferDeleter {
 
 using Buffer = Scoped<RawBuffer, BufferDeleter>;
 
-[[nodiscard]] auto create_host_buffer(VmaAllocator allocator,
-									  vk::BufferUsageFlags usage,
-									  vk::DeviceSize size) -> Buffer;
+struct BufferCreateInfo {
+	VmaAllocator allocator;
+	vk::BufferUsageFlags usage;
+	std::uint32_t queue_family;
+};
+
+enum class BufferMemoryType : std::int8_t { Host, Device };
+
+[[nodiscard]] auto create_buffer(BufferCreateInfo const& create_info,
+								 BufferMemoryType memory_type,
+								 vk::DeviceSize size) -> Buffer;
 
 // disparate byte spans.
 using ByteSpans = std::span<std::span<std::byte const> const>;
 
 // returns a Device Buffer with each byte span sequentially written.
-[[nodiscard]] auto create_device_buffer(VmaAllocator allocator,
-										vk::BufferUsageFlags usage,
+[[nodiscard]] auto create_device_buffer(BufferCreateInfo const& create_info,
 										CommandBlock command_block,
 										ByteSpans const& byte_spans) -> Buffer;
+
+struct RawImage {
+	auto operator==(RawImage const& rhs) const -> bool = default;
+
+	VmaAllocator allocator{};
+	VmaAllocation allocation{};
+	vk::Image image{};
+	vk::Extent2D extent{};
+	vk::Format format{};
+	std::uint32_t levels{};
+};
+
+struct ImageDeleter {
+	void operator()(RawImage const& raw_image) const noexcept;
+};
+
+using Image = Scoped<RawImage, ImageDeleter>;
+
+struct ImageCreateInfo {
+	std::uint32_t queue_family;
+	vk::ImageUsageFlags usage;
+	vk::Format format;
+	vk::Extent2D extent;
+	std::uint32_t levels;
+};
+
+[[nodiscard]] auto create_image(VmaAllocator allocator,
+								ImageCreateInfo const& create_info) -> Image;
 } // namespace lvk::vma

From cbd31e5d63efbb1955f256eb2f864add6e5b687d Mon Sep 17 00:00:00 2001
From: Karn Kaul <karnkaul@gmail.com>
Date: Sun, 30 Mar 2025 09:12:42 -0700
Subject: [PATCH 08/11] WIP images

---
 guide/src/SUMMARY.md       |  1 +
 guide/src/memory/images.md | 83 ++++++++++++++++++++++++++++++++++++++
 src/vma.cpp                | 32 +++++++++------
 src/vma.hpp                | 11 +++--
 4 files changed, 108 insertions(+), 19 deletions(-)
 create mode 100644 guide/src/memory/images.md

diff --git a/guide/src/SUMMARY.md b/guide/src/SUMMARY.md
index 7f6f044..a465269 100644
--- a/guide/src/SUMMARY.md
+++ b/guide/src/SUMMARY.md
@@ -42,3 +42,4 @@
   - [Vertex Buffer](memory/vertex_buffer.md)
   - [Command Block](memory/command_block.md)
   - [Device Buffers](memory/device_buffers.md)
+  - [Images](memory/images.md)
diff --git a/guide/src/memory/images.md b/guide/src/memory/images.md
new file mode 100644
index 0000000..6db64f1
--- /dev/null
+++ b/guide/src/memory/images.md
@@ -0,0 +1,83 @@
+# Images
+
+Images have a lot more properties and creation parameters than buffers. We shall constrain ourselves to just two kinds: sampled images (textures) for shaders, and depth images for rendering. For now add the foundation types and functions:
+
+```cpp
+struct RawImage {
+  auto operator==(RawImage const& rhs) const -> bool = default;
+
+  VmaAllocator allocator{};
+  VmaAllocation allocation{};
+  vk::Image image{};
+  vk::Extent2D extent{};
+  vk::Format format{};
+  std::uint32_t levels{};
+};
+
+struct ImageDeleter {
+  void operator()(RawImage const& raw_image) const noexcept;
+};
+
+using Image = Scoped<RawImage, ImageDeleter>;
+
+struct ImageCreateInfo {
+  VmaAllocator allocator;
+  std::uint32_t queue_family;
+};
+
+[[nodiscard]] auto create_image(ImageCreateInfo const& create_info,
+                                vk::ImageUsageFlags usage, std::uint32_t levels,
+                                vk::Format format, vk::Extent2D extent)
+  -> Image;
+```
+
+Implementation:
+
+```cpp
+void ImageDeleter::operator()(RawImage const& raw_image) const noexcept {
+  vmaDestroyImage(raw_image.allocator, raw_image.image, raw_image.allocation);
+}
+
+// ...
+auto vma::create_image(ImageCreateInfo const& create_info,
+                       vk::ImageUsageFlags const usage,
+                       std::uint32_t const levels, vk::Format const format,
+                       vk::Extent2D const extent) -> Image {
+  if (extent.width == 0 || extent.height == 0) {
+    std::println(stderr, "Images cannot have 0 width or height");
+    return {};
+  }
+  auto image_ci = vk::ImageCreateInfo{};
+  image_ci.setImageType(vk::ImageType::e2D)
+    .setExtent({extent.width, extent.height, 1})
+    .setFormat(format)
+    .setUsage(usage)
+    .setArrayLayers(1)
+    .setMipLevels(levels)
+    .setSamples(vk::SampleCountFlagBits::e1)
+    .setTiling(vk::ImageTiling::eOptimal)
+    .setInitialLayout(vk::ImageLayout::eUndefined)
+    .setQueueFamilyIndices(create_info.queue_family);
+  auto const vk_image_ci = static_cast<VkImageCreateInfo>(image_ci);
+
+  auto allocation_ci = VmaAllocationCreateInfo{};
+  allocation_ci.usage = VMA_MEMORY_USAGE_AUTO;
+  VkImage image{};
+  VmaAllocation allocation{};
+  auto const result = vmaCreateImage(create_info.allocator, &vk_image_ci,
+                     &allocation_ci, &image, &allocation, {});
+  if (result != VK_SUCCESS) {
+    std::println(stderr, "Failed to create VMA Image");
+    return {};
+  }
+
+  return RawImage{
+    .allocator = create_info.allocator,
+    .allocation = allocation,
+    .image = image,
+    .extent = extent,
+    .format = format,
+    .levels = levels,
+  };
+}
+```
diff --git a/src/vma.cpp b/src/vma.cpp
index 42b6fb6..cc0016f 100644
--- a/src/vma.cpp
+++ b/src/vma.cpp
@@ -13,6 +13,10 @@ void BufferDeleter::operator()(RawBuffer const& raw_buffer) const noexcept {
 	vmaDestroyBuffer(raw_buffer.allocator, raw_buffer.buffer,
 					 raw_buffer.allocation);
 }
+
+void ImageDeleter::operator()(RawImage const& raw_image) const noexcept {
+	vmaDestroyImage(raw_image.allocator, raw_image.image, raw_image.allocation);
+}
 } // namespace vma
 
 auto vma::create_allocator(vk::Instance const instance,
@@ -130,19 +134,21 @@ auto vma::create_device_buffer(BufferCreateInfo const& create_info,
 	return ret;
 }
 
-auto vma::create_image(VmaAllocator allocator,
-					   ImageCreateInfo const& create_info) -> Image {
-	if (create_info.extent.width == 0 || create_info.extent.height == 0) {
+auto vma::create_image(ImageCreateInfo const& create_info,
+					   vk::ImageUsageFlags const usage,
+					   std::uint32_t const levels, vk::Format const format,
+					   vk::Extent2D const extent) -> Image {
+	if (extent.width == 0 || extent.height == 0) {
 		std::println(stderr, "Images cannot have 0 width or height");
 		return {};
 	}
 	auto image_ci = vk::ImageCreateInfo{};
 	image_ci.setImageType(vk::ImageType::e2D)
-		.setExtent({create_info.extent.width, create_info.extent.height, 1})
-		.setFormat(create_info.format)
-		.setUsage(create_info.usage)
+		.setExtent({extent.width, extent.height, 1})
+		.setFormat(format)
+		.setUsage(usage)
 		.setArrayLayers(1)
-		.setMipLevels(create_info.levels)
+		.setMipLevels(levels)
 		.setSamples(vk::SampleCountFlagBits::e1)
 		.setTiling(vk::ImageTiling::eOptimal)
 		.setInitialLayout(vk::ImageLayout::eUndefined)
@@ -153,20 +159,20 @@ auto vma::create_image(VmaAllocator allocator,
 	allocation_ci.usage = VMA_MEMORY_USAGE_AUTO;
 	VkImage image{};
 	VmaAllocation allocation{};
-	auto const result = vmaCreateImage(allocator, &vk_image_ci, &allocation_ci,
-									   &image, &allocation, {});
+	auto const result = vmaCreateImage(create_info.allocator, &vk_image_ci,
+									   &allocation_ci, &image, &allocation, {});
 	if (result != VK_SUCCESS) {
 		std::println(stderr, "Failed to create VMA Image");
 		return {};
 	}
 
 	return RawImage{
-		.allocator = allocator,
+		.allocator = create_info.allocator,
 		.allocation = allocation,
 		.image = image,
-		.extent = create_info.extent,
-		.format = create_info.format,
-		.levels = create_info.levels,
+		.extent = extent,
+		.format = format,
+		.levels = levels,
 	};
 }
 } // namespace lvk
diff --git a/src/vma.hpp b/src/vma.hpp
index 9060383..2a3e025 100644
--- a/src/vma.hpp
+++ b/src/vma.hpp
@@ -73,13 +73,12 @@ struct ImageDeleter {
 using Image = Scoped<RawImage, ImageDeleter>;
 
 struct ImageCreateInfo {
+	VmaAllocator allocator;
 	std::uint32_t queue_family;
-	vk::ImageUsageFlags usage;
-	vk::Format format;
-	vk::Extent2D extent;
-	std::uint32_t levels;
 };
 
-[[nodiscard]] auto create_image(VmaAllocator allocator,
-								ImageCreateInfo const& create_info) -> Image;
+[[nodiscard]] auto create_image(ImageCreateInfo const& create_info,
+								vk::ImageUsageFlags usage, std::uint32_t levels,
+								vk::Format format, vk::Extent2D extent)
+	-> Image;
 } // namespace lvk::vma

From 4e2116f7be5d0106658f03d697e5516c7030ffcc Mon Sep 17 00:00:00 2001
From: Karn Kaul <karnkaul@gmail.com>
Date: Sun, 30 Mar 2025 09:39:56 -0700
Subject: [PATCH 09/11] Bugfixes etc

---
 guide/src/memory/device_buffers.md | 4 ++--
 guide/src/memory/vertex_buffer.md  | 2 +-
 src/vertex.hpp                     | 2 +-
 src/vma.cpp                        | 4 ++--
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/guide/src/memory/device_buffers.md b/guide/src/memory/device_buffers.md
index 1a72369..804c704 100644
--- a/guide/src/memory/device_buffers.md
+++ b/guide/src/memory/device_buffers.md
@@ -29,8 +29,8 @@ auto vma::create_device_buffer(BufferCreateInfo const& create_info,
 
   // create staging Host Buffer with TransferSrc usage.
   auto staging_buffer =
-    create_buffer(create_info, BufferMemoryType::Host, total_size);
-  // create the Device Buffer, ensuring TransferDst usage.
+    create_buffer(staging_ci, BufferMemoryType::Host, total_size);
+  // create the Device Buffer.
   auto ret = create_buffer(create_info, BufferMemoryType::Device, total_size);
   // can't do anything if either buffer creation failed.
   if (!staging_buffer.get().buffer || !ret.get().buffer) { return {}; }
diff --git a/guide/src/memory/vertex_buffer.md b/guide/src/memory/vertex_buffer.md
index 703258b..75e04d3 100644
--- a/guide/src/memory/vertex_buffer.md
+++ b/guide/src/memory/vertex_buffer.md
@@ -7,7 +7,7 @@ First add a new header, `vertex.hpp`:
 ```cpp
 struct Vertex {
   glm::vec2 position{};
-  glm::vec3 color{};
+  glm::vec3 color{1.0f};
 };
 
 // two vertex attributes: position at 0, color at 1.
diff --git a/src/vertex.hpp b/src/vertex.hpp
index 6c0fabb..a8c003c 100644
--- a/src/vertex.hpp
+++ b/src/vertex.hpp
@@ -6,7 +6,7 @@
 namespace lvk {
 struct Vertex {
 	glm::vec2 position{};
-	glm::vec3 color{};
+	glm::vec3 color{1.0f};
 };
 
 // two vertex attributes: position at 0, color at 1.
diff --git a/src/vma.cpp b/src/vma.cpp
index cc0016f..4456b21 100644
--- a/src/vma.cpp
+++ b/src/vma.cpp
@@ -102,8 +102,8 @@ auto vma::create_device_buffer(BufferCreateInfo const& create_info,
 
 	// create staging Host Buffer with TransferSrc usage.
 	auto staging_buffer =
-		create_buffer(create_info, BufferMemoryType::Host, total_size);
-	// create the Device Buffer, ensuring TransferDst usage.
+		create_buffer(staging_ci, BufferMemoryType::Host, total_size);
+	// create the Device Buffer.
 	auto ret = create_buffer(create_info, BufferMemoryType::Device, total_size);
 	// can't do anything if either buffer creation failed.
 	if (!staging_buffer.get().buffer || !ret.get().buffer) { return {}; }

From 88e6f64705dfeb69e632fe702fb8370803aff7c7 Mon Sep 17 00:00:00 2001
From: Karn Kaul <karnkaul@gmail.com>
Date: Sun, 30 Mar 2025 16:47:49 -0700
Subject: [PATCH 10/11] Sampled image

---
 guide/src/memory/images.md | 98 ++++++++++++++++++++++++++++++++++++++
 src/bitmap.hpp             | 11 +++++
 src/vma.cpp                | 80 +++++++++++++++++++++++++++++++
 src/vma.hpp                |  5 ++
 4 files changed, 194 insertions(+)
 create mode 100644 src/bitmap.hpp

diff --git a/guide/src/memory/images.md b/guide/src/memory/images.md
index 6db64f1..7ee9d11 100644
--- a/guide/src/memory/images.md
+++ b/guide/src/memory/images.md
@@ -81,3 +81,101 @@ auto vma::create_image(ImageCreateInfo const& create_info,
   };
 }
 ```
+
+For creating sampled images, we need both the image bytes and size (extent). Wrap that into a struct:
+
+```cpp
+struct Bitmap {
+  std::span<std::byte const> bytes{};
+  glm::ivec2 size{};
+};
+```
+
+The creation process is similar to device buffers: requiring a staging copy, but it also needs layout transitions. In short:
+
+1. Create the image and staging buffer
+1. Transition the layout from Undefined to TransferDst
+1. Record a buffer image copy operation
+1. Transition the layout from TransferDst to ShaderReadOnlyOptimal
+
+```cpp
+auto vma::create_sampled_image(ImageCreateInfo const& create_info,
+                               CommandBlock command_block, Bitmap const& bitmap)
+  -> Image {
+  // create image.
+  // no mip-mapping right now: 1 level.
+  auto const mip_levels = 1u;
+  auto const usize = glm::uvec2{bitmap.size};
+  auto const extent = vk::Extent2D{usize.x, usize.y};
+  auto const usage =
+    vk::ImageUsageFlagBits::eTransferDst | vk::ImageUsageFlagBits::eSampled;
+  auto ret = create_image(create_info, usage, mip_levels,
+              vk::Format::eR8G8B8A8Srgb, extent);
+
+  // create staging buffer.
+  auto const buffer_ci = BufferCreateInfo{
+    .allocator = create_info.allocator,
+    .usage = vk::BufferUsageFlagBits::eTransferSrc,
+    .queue_family = create_info.queue_family,
+  };
+  auto const staging_buffer = create_buffer(buffer_ci, BufferMemoryType::Host,
+                        bitmap.bytes.size_bytes());
+
+  // can't do anything if either creation failed.
+  if (!ret.get().image || !staging_buffer.get().buffer) { return {}; }
+
+  // copy bytes into staging buffer.
+  std::memcpy(staging_buffer.get().mapped, bitmap.bytes.data(),
+        bitmap.bytes.size_bytes());
+
+  // transition image for transfer.
+  auto dependency_info = vk::DependencyInfo{};
+  auto subresource_range = vk::ImageSubresourceRange{};
+  subresource_range.setAspectMask(vk::ImageAspectFlagBits::eColor)
+    .setLayerCount(1)
+    .setLevelCount(mip_levels);
+  auto barrier = vk::ImageMemoryBarrier2{};
+  barrier.setImage(ret.get().image)
+    .setSrcQueueFamilyIndex(create_info.queue_family)
+    .setDstQueueFamilyIndex(create_info.queue_family)
+    .setOldLayout(vk::ImageLayout::eUndefined)
+    .setNewLayout(vk::ImageLayout::eTransferDstOptimal)
+    .setSubresourceRange(subresource_range)
+    .setSrcStageMask(vk::PipelineStageFlagBits2::eTopOfPipe)
+    .setSrcAccessMask(vk::AccessFlagBits2::eNone)
+    .setDstStageMask(vk::PipelineStageFlagBits2::eTransfer)
+    .setDstAccessMask(vk::AccessFlagBits2::eMemoryRead |
+              vk::AccessFlagBits2::eMemoryWrite);
+  dependency_info.setImageMemoryBarriers(barrier);
+  command_block.command_buffer().pipelineBarrier2(dependency_info);
+
+  auto buffer_image_copy = vk::BufferImageCopy2{};
+  auto subresource_layers = vk::ImageSubresourceLayers{};
+  subresource_layers.setAspectMask(vk::ImageAspectFlagBits::eColor)
+    .setLayerCount(1)
+    .setLayerCount(mip_levels);
+  buffer_image_copy.setImageSubresource(subresource_layers)
+    .setImageExtent(vk::Extent3D{extent.width, extent.height, 1});
+  auto copy_info = vk::CopyBufferToImageInfo2{};
+  copy_info.setDstImage(ret.get().image)
+    .setDstImageLayout(vk::ImageLayout::eTransferDstOptimal)
+    .setSrcBuffer(staging_buffer.get().buffer)
+    .setRegions(buffer_image_copy);
+  command_block.command_buffer().copyBufferToImage2(copy_info);
+
+  // transition image for sampling.
+  barrier.setOldLayout(barrier.newLayout)
+    .setNewLayout(vk::ImageLayout::eShaderReadOnlyOptimal)
+    .setSrcStageMask(barrier.dstStageMask)
+    .setSrcAccessMask(barrier.dstAccessMask)
+    .setDstStageMask(vk::PipelineStageFlagBits2::eAllGraphics)
+    .setDstAccessMask(vk::AccessFlagBits2::eMemoryRead |
+              vk::AccessFlagBits2::eMemoryWrite);
+  dependency_info.setImageMemoryBarriers(barrier);
+  command_block.command_buffer().pipelineBarrier2(dependency_info);
+
+  command_block.submit_and_wait();
+
+  return ret;
+}
+```
diff --git a/src/bitmap.hpp b/src/bitmap.hpp
new file mode 100644
index 0000000..41004a2
--- /dev/null
+++ b/src/bitmap.hpp
@@ -0,0 +1,11 @@
+#pragma once
+#include <glm/vec2.hpp>
+#include <cstddef>
+#include <span>
+
+namespace lvk {
+struct Bitmap {
+	std::span<std::byte const> bytes{};
+	glm::ivec2 size{};
+};
+} // namespace lvk
diff --git a/src/vma.cpp b/src/vma.cpp
index 4456b21..2123787 100644
--- a/src/vma.cpp
+++ b/src/vma.cpp
@@ -175,4 +175,84 @@ auto vma::create_image(ImageCreateInfo const& create_info,
 		.levels = levels,
 	};
 }
+
+auto vma::create_sampled_image(ImageCreateInfo const& create_info,
+							   CommandBlock command_block, Bitmap const& bitmap)
+	-> Image {
+	// create image.
+	// no mip-mapping right now: 1 level.
+	auto const mip_levels = 1u;
+	auto const usize = glm::uvec2{bitmap.size};
+	auto const extent = vk::Extent2D{usize.x, usize.y};
+	auto const usage =
+		vk::ImageUsageFlagBits::eTransferDst | vk::ImageUsageFlagBits::eSampled;
+	auto ret = create_image(create_info, usage, mip_levels,
+							vk::Format::eR8G8B8A8Srgb, extent);
+
+	// create staging buffer.
+	auto const buffer_ci = BufferCreateInfo{
+		.allocator = create_info.allocator,
+		.usage = vk::BufferUsageFlagBits::eTransferSrc,
+		.queue_family = create_info.queue_family,
+	};
+	auto const staging_buffer = create_buffer(buffer_ci, BufferMemoryType::Host,
+											  bitmap.bytes.size_bytes());
+
+	// can't do anything if either creation failed.
+	if (!ret.get().image || !staging_buffer.get().buffer) { return {}; }
+
+	// copy bytes into staging buffer.
+	std::memcpy(staging_buffer.get().mapped, bitmap.bytes.data(),
+				bitmap.bytes.size_bytes());
+
+	// transition image for transfer.
+	auto dependency_info = vk::DependencyInfo{};
+	auto subresource_range = vk::ImageSubresourceRange{};
+	subresource_range.setAspectMask(vk::ImageAspectFlagBits::eColor)
+		.setLayerCount(1)
+		.setLevelCount(mip_levels);
+	auto barrier = vk::ImageMemoryBarrier2{};
+	barrier.setImage(ret.get().image)
+		.setSrcQueueFamilyIndex(create_info.queue_family)
+		.setDstQueueFamilyIndex(create_info.queue_family)
+		.setOldLayout(vk::ImageLayout::eUndefined)
+		.setNewLayout(vk::ImageLayout::eTransferDstOptimal)
+		.setSubresourceRange(subresource_range)
+		.setSrcStageMask(vk::PipelineStageFlagBits2::eTopOfPipe)
+		.setSrcAccessMask(vk::AccessFlagBits2::eNone)
+		.setDstStageMask(vk::PipelineStageFlagBits2::eTransfer)
+		.setDstAccessMask(vk::AccessFlagBits2::eMemoryRead |
+						  vk::AccessFlagBits2::eMemoryWrite);
+	dependency_info.setImageMemoryBarriers(barrier);
+	command_block.command_buffer().pipelineBarrier2(dependency_info);
+
+	auto buffer_image_copy = vk::BufferImageCopy2{};
+	auto subresource_layers = vk::ImageSubresourceLayers{};
+	subresource_layers.setAspectMask(vk::ImageAspectFlagBits::eColor)
+		.setLayerCount(1)
+		.setLayerCount(mip_levels);
+	buffer_image_copy.setImageSubresource(subresource_layers)
+		.setImageExtent(vk::Extent3D{extent.width, extent.height, 1});
+	auto copy_info = vk::CopyBufferToImageInfo2{};
+	copy_info.setDstImage(ret.get().image)
+		.setDstImageLayout(vk::ImageLayout::eTransferDstOptimal)
+		.setSrcBuffer(staging_buffer.get().buffer)
+		.setRegions(buffer_image_copy);
+	command_block.command_buffer().copyBufferToImage2(copy_info);
+
+	// transition image for sampling.
+	barrier.setOldLayout(barrier.newLayout)
+		.setNewLayout(vk::ImageLayout::eShaderReadOnlyOptimal)
+		.setSrcStageMask(barrier.dstStageMask)
+		.setSrcAccessMask(barrier.dstAccessMask)
+		.setDstStageMask(vk::PipelineStageFlagBits2::eAllGraphics)
+		.setDstAccessMask(vk::AccessFlagBits2::eMemoryRead |
+						  vk::AccessFlagBits2::eMemoryWrite);
+	dependency_info.setImageMemoryBarriers(barrier);
+	command_block.command_buffer().pipelineBarrier2(dependency_info);
+
+	command_block.submit_and_wait();
+
+	return ret;
+}
 } // namespace lvk
diff --git a/src/vma.hpp b/src/vma.hpp
index 2a3e025..2ea912e 100644
--- a/src/vma.hpp
+++ b/src/vma.hpp
@@ -1,5 +1,6 @@
 #pragma once
 #include <vk_mem_alloc.h>
+#include <bitmap.hpp>
 #include <command_block.hpp>
 #include <scoped.hpp>
 #include <vulkan/vulkan.hpp>
@@ -81,4 +82,8 @@ struct ImageCreateInfo {
 								vk::ImageUsageFlags usage, std::uint32_t levels,
 								vk::Format format, vk::Extent2D extent)
 	-> Image;
+
+[[nodiscard]] auto create_sampled_image(ImageCreateInfo const& create_info,
+										CommandBlock command_block,
+										Bitmap const& bitmap) -> Image;
 } // namespace lvk::vma

From 1b1fffd4fc5e7e27d3547356814f36ebee4d9ae4 Mon Sep 17 00:00:00 2001
From: Karn Kaul <karnkaul@gmail.com>
Date: Sun, 30 Mar 2025 16:56:55 -0700
Subject: [PATCH 11/11] Cleanup

---
 guide/src/memory/command_block.md | 4 ++--
 guide/src/memory/images.md        | 3 +++
 src/vma.cpp                       | 1 +
 3 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/guide/src/memory/command_block.md b/guide/src/memory/command_block.md
index 26cc25c..6f5812b 100644
--- a/guide/src/memory/command_block.md
+++ b/guide/src/memory/command_block.md
@@ -9,7 +9,7 @@ The second step requires a command buffer and queue submission (_and_ waiting fo
 
 ```cpp
 class CommandBlock {
-  public:
+ public:
   explicit CommandBlock(vk::Device device, vk::Queue queue,
                         vk::CommandPool command_pool);
 
@@ -19,7 +19,7 @@ class CommandBlock {
 
   void submit_and_wait();
 
-  private:
+ private:
   vk::Device m_device{};
   vk::Queue m_queue{};
   vk::UniqueCommandBuffer m_command_buffer{};
diff --git a/guide/src/memory/images.md b/guide/src/memory/images.md
index 7ee9d11..583957c 100644
--- a/guide/src/memory/images.md
+++ b/guide/src/memory/images.md
@@ -149,6 +149,7 @@ auto vma::create_sampled_image(ImageCreateInfo const& create_info,
   dependency_info.setImageMemoryBarriers(barrier);
   command_block.command_buffer().pipelineBarrier2(dependency_info);
 
+  // record buffer image copy.
   auto buffer_image_copy = vk::BufferImageCopy2{};
   auto subresource_layers = vk::ImageSubresourceLayers{};
   subresource_layers.setAspectMask(vk::ImageAspectFlagBits::eColor)
@@ -179,3 +180,5 @@ auto vma::create_sampled_image(ImageCreateInfo const& create_info,
   return ret;
 }
 ```
+
+Before such images can be used as textures, we need to set up Descriptor Set infrastructure.
diff --git a/src/vma.cpp b/src/vma.cpp
index 2123787..94d9c87 100644
--- a/src/vma.cpp
+++ b/src/vma.cpp
@@ -226,6 +226,7 @@ auto vma::create_sampled_image(ImageCreateInfo const& create_info,
 	dependency_info.setImageMemoryBarriers(barrier);
 	command_block.command_buffer().pipelineBarrier2(dependency_info);
 
+	// record buffer image copy.
 	auto buffer_image_copy = vk::BufferImageCopy2{};
 	auto subresource_layers = vk::ImageSubresourceLayers{};
 	subresource_layers.setAspectMask(vk::ImageAspectFlagBits::eColor)