From 6533821e40ec8518b0a1538ccffdaf037e722f48 Mon Sep 17 00:00:00 2001 From: Alexander Gabriel Date: Thu, 8 Feb 2024 20:25:39 +0100 Subject: [PATCH] Erster Testentwurf erstes Projekt --- .../hochladen_erfolgreich.png | Bin 0 -> 3462 bytes .../kompilieren_erolgreich.png | Bin 0 -> 3759 bytes Arduino_Grundlagen/01_Grundstruktur/readme.md | 93 +++++++++++++++++- .../verifizieren_und_hochladen.png | Bin 0 -> 39831 bytes Arduino_Grundlagen/02_Blinken/readme.md | 4 +- 5 files changed, 95 insertions(+), 2 deletions(-) create mode 100644 Arduino_Grundlagen/01_Grundstruktur/hochladen_erfolgreich.png create mode 100644 Arduino_Grundlagen/01_Grundstruktur/kompilieren_erolgreich.png create mode 100644 Arduino_Grundlagen/01_Grundstruktur/verifizieren_und_hochladen.png diff --git a/Arduino_Grundlagen/01_Grundstruktur/hochladen_erfolgreich.png b/Arduino_Grundlagen/01_Grundstruktur/hochladen_erfolgreich.png new file mode 100644 index 0000000000000000000000000000000000000000..42827bf62864f8a7f04bdf8045b76f867b90e73b GIT binary patch literal 3462 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 BT;Koz literal 0 HcmV?d00001 diff --git a/Arduino_Grundlagen/01_Grundstruktur/readme.md b/Arduino_Grundlagen/01_Grundstruktur/readme.md index 16b375f..7792711 100644 --- a/Arduino_Grundlagen/01_Grundstruktur/readme.md +++ b/Arduino_Grundlagen/01_Grundstruktur/readme.md @@ -1,2 +1,93 @@ -# Z-Lab Arduino-Grundkurs Projekt 2: Nichts tun... +# Z-Lab Arduino-Grundkurs Projekt 1: Nichts tun... +## Dafür lernen wir, wie ein Arduino-Programm (der sog. Sketch) aufgebaut ist +Die erste Zeile Code, die uns interessiert ist die, in der "void setup() {" steht: +```c +void setup() { +``` + +Jetzt müssen wir ein bisschen ausholen... + +Hier wird eine sog. Funktion definiert. + +Funktionen sind wie Aufgaben, oder Fragen, die du jemandem stellst oder die dir jemand stellt. +Also wie z.B., wenn dich deine Eltern fragen, ob du Durst hast oder wenn du deine Eltern fragst, ob sie dir aus dem Kühlschrank die Flasche Wasser geben können, die für dich zu weit oben im Kühlschrank verstaut ist. + +Im ersten Beispiel wirst du überlegen, ob du Durst hast und dann mit "Ja" oder "Nein" antworten. +In C würde die Definition einer solchen Funktion etwa so aussehen: +```c +bool habIchDurst() { +``` +Dabei ist hier "bool" die Art der Rückgabe, die die Funktion hat. "bool" bedeutet, dass die Antwort entweder "ja" (im Computer eine "1") oder "nein" (im Computer eine "0") sein kann. + +Wenn wir jetzt kleinlich wären könnte die Antwort auf die Frage an deine Eltern, ob sie dir die Wasserflasche aus dem Kühlschrank holen können auch nur eine 0 oder eine 1 sein ;) Aber das würden deine Eltern ja nicht machen sondern sie würden dir (sofern sie es wirklich nicht können, weil vielleicht kein Wasser mehr im Kühlschrank ist) einfach die Wasserflasche geben. Wenn kein Wasser mehr im Kühlschrank wäre würden sie dir das dann sagen. + +In diesem Falle könnten wir die Funktion wie folgt definieren +```c +void kannstDuMirWasserAusDemKuehlschrankGeben() { +``` +"void" heißt einfach nur "mach das, was in der Funkion steht ohne mir irgendwie Rückmeldung zu geben. +Also im Falle der Wasserflasche die Wasserflasche. + +> Es gibt auch noch die Möglichkeit, die Funktion so zu definieren, dass die Wasserflasche zurück kommt. Wahrscheinlich kommen wir da in einem anderen Beispiel oder Kurs noch drauf :) + +> Und sicher ist dir in dem Beispiel schon aufgefallen, dass Funktionsnamen kein Umlaute haben dürfen. + +Ganz wichtig sind die Klammern "()" am Ende der Funktion. Erst dadurch wird die Funkion auch zur Funktion und kann nicht mit einer Variable (kommen wir im Nächsten Projekt dazu) oder anderen Elementen verwechselt werden. + +### Die Funktion "setup" +Die Funktion "setup" ist eine ganz spezielle Funktion. "Setup" ist englisch und heißt auf Deutsch so viel wie "Aufbau" oder "Einrichtung". Diese Funktion wird einmal ausgeführt, nachdem der Arduino mit Strom versorgt (also eingeschaltet) wird. Alles, was nur einmal gemacht werden muss, um die Aufgabe zu erledigen, die unser Programm erleidgen muss, muss hier rein. + +Das ist wie wenn du mit deinem Lego spielst: Zuerst musst du das Lego holen, dich irgendwo hinsetzen und dann das Lego auspacken. Wenn du dann mit dem Lego z.B. ein Haus baust hast du das Lego schon da und musst nur immer wieder in die Kiste greifen. Und hier kommt die zweite Funktion aus diesem Projekt ins Spiel + +### Die Funktion Loop +Die Funktion "loop" ist das zweite wirklich relevante in diesem Beispiel: +```c +void loop() { +``` +"Loop" ist auch wieder englisch und bedeutet "Schleife". + +In der Funktion "loop" muss alles stehen, was der Arduino wirklich immer und immer wieder machen soll, denn diese Funktion startet, sobald die setup-Funktion fertig ist und dann wird diese so lange wiederholt, bis ein Fehler auftritt oder der Arduino keinen Strom mehr. + +Also wenn du z.B. immer wieder einen Temperaturwert auslesen und dann eine LED leuchten lassen möchtest dann muss der Arduino immer wieder den Sensor auslesen, prüfen, welche Temperatur der Sensor zurückgibt, dann vergleichen mit dem Wert, ab dem der die LED rot werden muss und dann die LED anschalten. Danach geht's weiter... Ist die Temperatur immer noch hoch oder oder niedrig genug oder muss die LED abgeschaltet werden? + +### Der Arduino ist wie eine ganz normale Maschine +Der Arduino ist wie jede andere Maschine oder jedes andere Werkzeug. Wenn deine Eltern z.B. einen Wasserkocher verwenden wollen dann müssen sie diesen auch erst mal bereit machen. Also auspacken und anschließen. Das ist wie die setup-Funktion. +Danach kann der Wasserkocher beliebig oft (so lange er nicht kaputt geht, Strom hat und noch Wasser da ist) verwendet werden, um Wasser heiß zu machen. Das ist die loop-Funktion. + +### Was gehört alles zu einer Funktion? +Alles was zu einer Funktion gehört wird von geschweiften Klammern umgeben. Also die Funktion geht von "{" bis "}". + +Also in unserem Beispiel... Garnichts, denn hier stehen keine Befehle: + + +```c +void setup() { +} +void loop() { +} +``` + +Unser Programm tut also gar nichts... Das ist aber nicht schlimm, denn wir schicken das trotzdem mal an den Arduino, um zu lernen, wie das geht und zu überprüfen, ob das denn auch stimmt. + +Dazu drücken wir in der Arduino-IDE oben auf den Knopf oben links, auf dem ein Haken ist. Wenn du mit der Maus drüber fährst dann erscheint da ein "Überprüfen" als sog. "Tooltip": + +![Verifizieren und Hochladen](verifizieren_und_hochladen.png) + + +Dadurch wird das Programm, das wir offen haben vom Compiler überprüft und kompiliert. Wenn dieser keinen Fehler feststellt erscheinten unten link kurz "Kompilieren Erolgreich!". Das sieht dann so aus: + +![Kompilieren erolgreich](kompilieren_erolgreich.png) + +Danach drücken wir auf "Hochladen". Das ist der Knopf mit dem Pfeil nach rechts, auch oben links in der Arduino-IDE. +Wenn du den drückst und das Hochladen. Wenn das erfolgreich klappt steht unten rechts in der Arduino-IDE kurz die Meldung "Hochladen erfolgreich!": + +![Hochladen erfolgreich!](hochladen_erfolgreich.png) + +**Herzlichen Glückwunsch!!!** + +Du hast gerade dein erstes Programm in Maschinencode übersetzt und auf den Arduino geladen. + +Auch wenn das Programm noch nichts tut so weißt du jetzt, was die Funktionen setup und loop machen und wie du ein Programm so übersetzt, dass der Arduino weiß, was er zu tun hat und wie du es hochlädst. + +Also schnell weiter zum nächsten Projekt denn da bekommt der Arduino jetzt auch etwas zu tun :) \ No newline at end of file diff --git a/Arduino_Grundlagen/01_Grundstruktur/verifizieren_und_hochladen.png b/Arduino_Grundlagen/01_Grundstruktur/verifizieren_und_hochladen.png new file mode 100644 index 0000000000000000000000000000000000000000..05e49bd74b6a0119536c623564f61b1600e91f25 GIT binary patch literal 39831 zcmZU)b97`+&^Nxx#?D3?YhoK4+vaSrv2Aa>vAwZvYh!P0+nkv1?Dsj(dw%%io|$|5 zc6E1Eb>FH_RfQ=jNFpQPA$K#fq$N5q-QHxlOvOQbDf zA(8};7AaSmUbi;X5`)TY00KxAApM0%%wbe=j@ltpBK%AU$=WM^AA}r83+eny!~gQ- z*WBsKpbYpOwBI;$pu~>4@n(;qC7-gA{m*a~Opx z)hUq);)!kil`@Yhs^W6zc%m%|?y~>Rm>nG2~aQjY(1PS@HA<^8~U>#hv?W^aq z4<_((A%&UeFetL~l(s?2+X>U<>N*RZ_|25}!uxkQGnU$!UXfh)7oP#PvL}55wbR2y zsC5#3-_yEl&!*6I>g0kaLlu9;|KoJJu#n@!i@t zW9AruKHQg*Osuv0Wk;QOgbd+HeP6DS*E-fN9#?{DGDOAygfo$+XZ~A-M@d5kQ$l>@ zk(VujURu7}cD)C0G>@>orc`}N$=!F1Q^Yz>CuuGFvw)Vz6&krsW-KPIcjNE?>!`Aiuas5ZpW+TP*V?xQ-i0y@w4v~T3doMEiO}G6alg4ycfQO0E=3nI|YC! z|DOQZN)Bm8sFOD0d)wA@LL^pxab`RYocC1DIvIJRMjsF#N*R#Wdkv}r#^?oIe}63x z&dt?WFd-I?17L~^+g?ji{U_@fs8mxa2yqD&%o)Y3-m`0aNpH6)^J!{(V(XJyc?|Geak7p7@?m;b)4n|1>m!1b)f8_|ba{v<=zCuijs@`;>}F zte~B%mOoHA>tC?5De0u`d&TT&Olw?o+As{{fAppn$Tsi7_$ST!5-OQ5BqIp%lY$D; z5_wwX`C7`as{XQH;vuP7iIUP)dHu3g=LL+Pobk+>=>Ku-k+?XE8h73jDI6(lL7vT6 z$vD!|rF`a}ZuC5f^DCbivc{tsZcmM=8fn)PiSE_qD<@9qsJ%j2FzqP#O_X|5FZzJZ0s7a`NAjBTEj( z`nT9n;r~%SUL=u3aD&j4K`dr%SJ1y{NB?*Ynb8sqVDi z$9)VnO7{?L{;GU~WwpMszVPwGxlaZx+RiZ=fli9gX|x{5+~kPmySv_w=Ka`lCcT5I z9f2ta%e1pI-(elEL0(qYG+W(^5BZDZF(ujs0jO2Eo8x}dqlQ^Vm^HW0{yI;-wwdSJ z9RfZiT$LrBTll^bP6A%Z;`d{Zw<*r9-rj<5E33vmJhB*B@zMS<6$gL1_z9MpqZP9| z@JoNnEpwFCJ&Sibvd4;9BCkvu#JUeC4t010Bu z(Hl9P7Dv%MMz%V2NeI61bDppEU0iPNwyrXgms(kU;rB9;k(ULSfs$tpRj)A0AAmK+ zJ`-&Lv-gG7f?|ugqUP!>li%^cldMOmr9{r5`uQ%mO2M6CE&<9+sw!nm{a9d&{0kh< z!}29A_%Ttx#_j{z2LopNm71-m6PxQR%300z^8M0E9J5%vr*WxN2-X8U(9DdH)ds6*iD{PWm6<(Rnvs#;@ zh%zRHSFq#DFZO-^Mg?(YS6a|e5lxJZJIuJTBR(rf_5aT!kHdD7E` zo^xY7`!TeMn{3&5tE4u!O$qDs--o2eBoo021(Wxs>rta`m;!2M!sC#NeDr9v=-G*5^uMq{4ZS~KISw?}alj*Xelh4BYjTWC1@yn~t zCSIEFL2bv^>?XIn-^wSgzO6zX;xoWGPZ`x}+qcR%Ks*QK7EnIEdHBq@tB@m(&{}WJ zRqT7$xP5B=u%M3nq+4vSidXUC>4ZqpNNMXTz*bwQZ-Lfl_ZGd>PJ9p^R0Oi=Kw^BJ z@D0d-k;q%rY?M8c>O43ZHASKeG~E=k+*YhuUL9rS^r(uSuD3H$GU<9NLMgN|V07_< z3=qlg|NP+_1N()u{^&UjDdP$5vIu8Rfbx{>A`^sO>*o$K9No;^&RqX#mr*)_5-f!#v!L z^eq2JUjM7*`3JUrXy-uLl>+?{QH<`nIIf;V>*87-PF7ya`otU#UmKy_ z$%FIqO#dv8yW=+ktGswu?e*CO@@M9)8Igg@42Cyv<4uPIXo^FR!0XL(cGX(#!y0g& zoNKg|y|LSf+l04z<9_+PJP}i1vH-H-^Iifvbq&VDzq?nrZUz zMYP)hY;C|(6Fj!R!WJ$`7(4C;)9 zY!A-T_=F#qe9c$04NbY=)pudZw>+%zdzH50w*3|ULOWq}bKy{=%R-D>f!_qz^rNmbRY-FO_?fmUnL;=&He@wCEHr zmHV=%yCP114~wjz=`Yj*#=CkgQF7bCt$AzeL^__^j6d4JTyD;z9`~V^Lm$hLwyu9o zVWO&2B<}6)V@a1YZve&?0R6)C6bB-gTWB$ji!;N+5jymk?klQ2?0gt?cQIJ_pLn*3 zV4njpQmb1-dOyQ*cbOr!$0Vx)bt2cX6;&!ej=}Z;$8oE?&vdKy!@J~J&F7`%>w|8o z7{Y-d0Ld|HmHblgW|qF9f=N=Vk@^{kGLc=&z~9<#^to3rHQz zv)5mR?G*szif5GtbX^tE&VNj@bj$xuzHFO|E zZ(p2%PPEL$qb$SIfE9(GR(em}w`T+Pv{)BjR;D&0r&}!g77B!LS*y$hW@9)vzDL?} z)GV=YuM$KTwP~%hOotD%)dm{}5IR|=79`Cw&iO57t~7obJn6!3RE~!SP()sLzA#U! zheZREY#a|1RroxyzHh3yPN%XJe=F%uG$`L4P~tY%2WxurTit>?aSxjyg413fw((ot z_eebN^e)YW)dcNyU zY#l@4SWjFgGn6K@%vTdk4EtGs^2Yf56(NI=M!db?cjkRewxZwYp1;|nAvXL$$;I^H-P zzBlFExC4#6%4yR1(&Ejs2QV>2rKI3^GZ}{ug#EYZYc9}3_>Fcm)eY^-w${W|a-`j) z7A!}IScCpi#EqJVEKn&`DxWuJ$7=vGST^D{0@sa;1hP@HCqsvJdv>pLsAcYme-m!2 zIP=mnwg%mZM*ycnDbN}?7#&?rMS4HA0U=)WHZq;a?fL~KSD-Bnz00IA`^6)t9iXFz4*dwRn2!?lVl9sd-sQf{mds5@3 zPK~hhzi;57D*MErLCq|e^>U79j8or_(_HENd~QNqQNN3C0H2fuD6k5}7~08T zV)NbQ>F;Z{Tq`$@jGm_qZ6B{rvmU3;iMrknjSp(`NYC9GpvW6AeNqZuFxsY4+wkxD5-|BUAbk17LJg33 zjQe{cXS%8cd6$d>ZwkN4KUtxOBnA|WCfr2Cp*B{}B&cA{B|%~xIM&*qnifG#cTlC@ z|6{y>NMgG5L>G1AJbGAe zyMeEx^oJbx8@|m-0!0|Ss^4VMk$DFmvOp4EYi5wegiZ4d1AT+;3^p7T!=bqYJjRCi zsda|Kf<+4Ve$bJ*=fL31ylH;Id_buqk45O%0F4(7PjE27@C3!_Qtkcld*pJy)R%Bz zR3u(?SzWdCeeTV3?7Xl43MT%TNnD(>Wr2laAvIr0ZNxVil-^PmWy%+7hgKQ~-qi|} zvLkG4nae8ORX*K+96(%AON4ni7qv7bYnu9_zhfE*QQsq^b0`(^Ae&cH5Og~(*L1PE znQZzS%L_9JftaLRO^VjV=2E&aPpEkJJ%S2UAUv7#>V5I-@j1}Rv22n!H6w8F_z%IC z0G5840*wgOWFBQTIbmsO*>W(G;NFYPF_goje{IE+ivBt!SibGys0j{X<={x#dxX-k zUGA+-pjz$yU2m!Ab16NT$MMAod7wfg*S+)AlHEabk(;yo(fiH=m_6CuRxJ}{%uF`M z3X>UatDJdk+!(KG4;iXTA5Vz}_tyrv?%*ICL-gt}N-=@`Griv>dM`$maXWyBA84fz zS|_PoS`!kSfR_D}g^yss95N7nz*vMOn>nYvy;EyoP?zce><5{qaTc- z1bjFE_i1#e@?kZj6|68s0n%j(Ru9{Khe74dygD`UmJf70Gj_ z-MO?=xezi6M!Z^*1@|;_Hyfgp)w{#L5pK8LxyKmoG#UXaz$pPcVunIAq+twcDIVZ3 z5=#p1-7oH1Bw>Mfv~h&3;<84Yp5Ql!7jG#batR<7ubW+df7;ibWLzSVG_j@Rxd-nbMunHo zAOk-=jU4@A!3dtzJdv!fb#5*|OtLwHe^wHOiXH$kH$Ye*Djx|FF1ET&4HbN@S+Hvc zPAt^eD`2L?YN|z!QHf$qc)(<$lpkCF3JB}J-j!k>VD?^N-kDRn?Hki^n?2WYnQXT{ zC6V_``)G?fuD3n7h>3ynQ|a-1_k1|ld3a>43xcIa`;7&jOsApIDqwf#hE-s*Ca!NN z1_S%c%uWZ;QZbb$XgPtBQ#LhVWDJjFuAR}y?Y!ddWhe-$%^6|H59Vw{za@oBf-QI03*rGtpGEA0G!q5uxGvTUM`xpd}ftSE~HC5On0%Ml*BQaH) z?_ovo(RiEwOJKw|bT}v*xjXJcvu3;9D)juxp%$hlPay#1UrabSy_Hi$^&&~UAF(12>Dko=)E{c>qXR>u6sN`i> zOrV?djHQF0S1bu%U&k~n-c2yR6VgPMI>ObbI6N5XZ+GpXAGmDx3kql{YV7U58f^fa zzYFdRpe`hMAoRWzu~5{xVpzV1Q?;H4k{^XkZYS`(e=+vE|LVpxL2f**^9~x?JGrfA zuo(B-r;J}7!+&7du>t`uh%dKJu~vt9_l0p1#?`qt`b~Vwk(^>%9pNvlMo7x10vXvu z-i;Xdi^f!d>cm?HyPKD$J@*$nZjuPvbQ-niQt&~pW{(Z{tzIH-&gbdfIgA&olEb|7 zeaySB|%_`7p74;fkDn6)Sn&i~^-GmMRAF&)X zV4XLo-1GjMK!y;-(>aW+*Af}bY%%=VsHzYo1?NizGY+NshCN#2)lnwx_jAsh{FxU1 zDvs8~8i!rIwbZWy?yP-JS@TwGTJ7sSsmhHRG$23UgeN-0kq3XqzhYAFT=ed5_^iKk zBF>^)fAD`S<1dw4p)YSz%SKS}(l)hv?c&RPx(;IFKN!nY9N*`f~ zdfY>B`ZlFj?6h_`%d#FU99;7J@q70TYJs4Mlol8rB$U*8xqLWUd4M+^%=CYSP68iP zhAf~3Oqiu&3WGuN4rlQPHrx4DiAn*mqS^|dg4C;8XvsNhP?SX37oZk&ge@5iNE!Sv z@lSRw8C*I6KZ7kSd}Gwg#ix&7AyASGon~wg?f2tx&^4?Wgn1K=JmpO-tCdt3aU~ls zhGE^^HuT-yV!~LQvJNIft0@ar=~!tt23Porm?>EJM#MgZrGvJ%Q=(R>%e>A?zl<9l zUd3>2ZY99ZP_MRyAyG}esbqbBgktKvVsF-8YSOO=VvK!fUG(f3Yn7NJX z!?%XCDkb63kyjL2$>ArLVD{<%m2(5%6hrsbt3!YoDDQ(x8JluzbGea-i$qeY#E$o2 zjf%%%f~63h$tzyk=RaVaC#j~^S=3(E@fQfaXfO)X^MznA1CL?W$mdWe=8uC-#b8&1AG+d!y z_t&NQ$l-R0+PJ0m8*$@Wbdyg6L~FJ=d(_$#KbyXdywRSLQN|hL8}Ad7(xIA1X=%`ipNAQf!NkZ5+5?(r-KXATKRqUOsF!|}`*N7b0m9WN=c9!H&b#$F;}mh}!Y!4>j? zKk@A^-BSd|+tQAkJ4Ym_ws`)mOt_@WB2kV*5RmFtwzonkmJTKc>{pQ(oz3w&Pq=jK zN!*tFA`}<*{6WdgO@m=i?#^*hLzsQ*Gm=Urfhw(3_F1dftVB*Bu|N?M9m-374W4~|$q z$XYV@v`t$Nn3ynJi1Nl};Lou{EzhDcTyF)`4(VNx(01J0Jdd8(of1CmO{od>Sl52} zLKKoW|7EcdkvE_8sD#(c1K;%kHlh#*qbfuAV4-@2e&p=d=G}p(lM1wkk)pz}{pCsj zdMa>iczmUQ@(!#D(0z+@1 z)(Dfc_KRf_^BveT9tcp=Qu#7>v)8kP@#_FVrRIK#5asv9?1Tva!-Yxjy-g$NVj*fb zJW|mg9DFAqplC71ji3OS3p=*0FA3U-K+8WmulivU4G#E!vT6pG8B%V3Qb{XBU!gR0KefXY6)32RF{VgW1#$e6o zW8a3Ah~^@`b-bG;YEKH42Np%CAcAy%hKJA1NHoqaH?nnCnJ6n+#IOMSp;Y9CpK|B9 z&|y|I#_=V1!V25Q_Z?DrNL*$8j%q+-o8)7?+3NgP=K*R<18_8oa?O&X?!Z~Df2+$U zH9dW$Dx^|M5!F-sCV2_;G%4ux=5+ixBe~3jSOK*N`eN4AoEt+O)CfIy*WOP@#2yK>o*lhr&y-Cp; zAiDSWrp&ex%~m7pqa~C}xl5~wJF!n39aRcN;(esbR<6;$Kb%wX2;{DtB1{S>qcwbL zn9KS>4gwk~3QNOhR%m2ZVL)Ca0N%NG9nU=Z^~8HFKU9JX!(5M8FM_T(jtCeVOm<7^%nYn;KZ<6H*y5z zc=!*O_N$V4DG0toT32F$@zNRaXPvcRz(;PG3gI7@BKYE?O%+qe21fk4^z2?#`y>MZ z1`S$M!9hY&aOUh%!sGgy8ry*Ot)Qz|a8>}%0WSsAIxacd1UVdmcqUS&|y>XLs1FBhUju}~tZQ;}iV zJwMk0&v6PQ_;`y~C&Kb}>hb3OWkHz5TPmvn!uGG>8`G~W@90W7kQvRC2Nrx@mfP$E z!T!^2cvNBegalQ2p{J|O{}W6=wp>%R;!e0{2S^D>@5Du@2*p!_p1FO?;3|I}T~%hyF_mFpB`@&Bgl`3Ktd@zM zOdFs~=9GvJ-}?Bp?)i(rG770O8R41JYm0{A$D!c=l9>b=H=@Gk(1 zZk}J2-Rn{@y2Ca7UbCzoE=6@ED^3wqf;D0^^9RaRNXzHVCS<`05dqN({K}rrM>RlL zBpP}#NOo!|8IWc^za~68wsbPUSJ0QwH4|H0Wqa1VWa{|p#Myn$(mP4s?O&z{oLnc@ zUeVDJu=}kCh1Iee2P@tW^Uy;<)F_S-pUXcJofA_!xMChb_}@6DWLU|Gb1JySv(naT zmC#U+i<=+OO-^Rdl$2lauqCv#z7ht*mEVnQKY3u71Y34td>vdi6)1o}QlfM<$z50Pjqof{-!-roY?nTC4fkSZPVg zpWVA1o)q#_+Rpqoc~=s$^M7RdE$rFN*5UZ1m0J#?zu6NDM(1}Bg!Vc7g-@t+ARk?- zh3F(li*x;lhitG@%M@eNmo&=-7f?sG?;y}d6XsV`oUNf3mDyh^=g0cKvTTt`NcWj8s*bV*48fR>B|LX0C3m^mn9%Z-v`UhWL5_pQpx0XA)};(DW4Bl*6jVO zsJC-bUd-ya_X8$|V5|Y3Xm7vzVVf5N`o%*aq1rpjM;-~E?#%?N{JwEK4_PsCzii+I z^5R>=ffFmRUBTe~i!IR`N%>!h&~_ez?{};b$E-*^u|^xVzxU%#Nd z!|^2nqi8sjQ4+H(>Gf;h-S@ZM z>^GlLHpPg9`5!3fG#9ev8Y#;^o;7cFci(y|rhhD$Po3V0Nk|yhYB6U_XjKv|2=b@k zI7+fSOuM=B@W6DI$NHS6T&?AObDz2+)=NWo3PD)r#?|i_AN3_qThrWh4ST+?J*k|W zzDrkdv?>ybY!BD$N{v2>1`BrT7j@~pWhBgJ@HU8w+CQxBHtkQOfk>%>TW^Y*(yoUr z%0F^mqEguFS5?dn`z2Jom_Ka}8IsvdGcfS3{WaOQH;{f=4g zkTZY&Uu*}gKw!Pd&CQ)hcO@kyrS5)>;^LyPKMVz>>J{=+;`>ld>^JtXIedS`m+fvz z8QBCl7Vmo{@5vt|HOD`_j(S`@(h?Dz2{IT>vlHD;7|nmy(Cd1JkTDw%vccz0%$Cjd zgmYs^9oqZ4wFjf;d&{G-e_ShmXX03fkHhIl_Jr^LRLunPX+reQx#Wp%jrlupKan~9 z(H1*%x5#pO#h0wp8k1o+`eVj)5(JE)@OG5!_*fz)GCKQy-2uw}UNc`A=w_E|r*36-PqpTy3&XZZ zZ|u1J#kPwyFwV*P?0bT=o*rpcSH0Hbt=!JM&^;|SqkBen-J4#v%@jS+Gf3_k2=q>2 zAAMIm0A+g6vuF#(%^OiZ=;BS(M(NiX8etcj|3T}UqG9{G+;`Ny;H6P_yQ+)X0+AH_ z*nq2(j28%FPxKzAm}0k+YE8;lhT0ib+!^~ehJBT3i|Hft;BaJ&UYOn`m%bJyir?gT z2EGG_YhBmHc94apZM&WfIdGr!*lCfs!!XhW_91&un>;Yz`oDj0%Ur_4)IDG-IoAbT zHCRO6+M4veLn0`6{=yf`pi}LIU>cf9sr9zORtO9p4uS}Zz~=7J&Qms-I&n@d^L36e zn&|$JUX!hkYq9x0g)3#tl}o3A)@CS9H*SsF^K9`?&sh<lw|P<3BdBTSn+P z#jAH~xtmQ}^_R$M-~D0Vcz32uxIFF&831Wxai&mID-IqA^bb9(%hC9v4?kWyRfK!~ zQpAqw7oowu6c{=bBsSbY2DN&;IdjTAp;nLA2)&b*EcL={(!H9gvtn;zW5cLQU-)#q zT{#&mXboFwQsrl}q}*nwOg-4iwiLp8e~9)KFO&y{D4pgwBYr2myt>(Ozl}y7?>=Ek zE|@gl_$Au$cI0Fn?VG8H{UClhw!8aMwd=o#@wDT=_d{mN8XR>EPV*?(xMiO0>uLAH zm0jS){TLE-QVt5488_*;yOtq4)Keh#;Gz>)m4C!~a5Tz8zuZphxPO;vdT0gb$a+-h zb`jZ~tn)GR5y-e+Z{v%*d#NAf2lQ5`P;R;+?jnm@yT5rP``T;`ez!9yEBe`3{T_(i zE{UG4G8m$m5{KnQ=$D@Pv*-JtkOzIUDXWxEeWOrc4T2~qT+k+wJGCnA*ukS z&kBL*x?#`L=}^b*Ib}3*ThLLSe1(>}Q1O5`r6YLYV|&v*5Ca~*L_Md(S*ucmjEwA8SXhr~ zJvuI~^x@ykuwTDQIG7jobP%xd=c~2!VXAex(rPgVSzUXzC^wbztEmi`6C^orSgS;D zmPYzZAn5xaYQSb1n)l06U7z?(Q0+UP%e4+GM=S8vI@6|wRin;vT>xPnJKoMS+=FfB zb5S)_mP0~3{7TQ&{>{@a>XqnZsQdoHtOsWV$*EAaqVZXfyB|@J`;O5XCU&yO1`H>G zg7MAe%kx92QL2Co9MvpWLw|bCbU!jl>&^M^yHnpIuJ8!5*N4u+N#^I{`}zmwA1y!W zh*QVr#JU#?j+2GB>)Bn5}p-(M$u}_XE^aMzbOJ#u)2o|ez4-QeE+l5jStHxWvJ=Flk4@s zy48nz+~Fs9f`WIX1U4;IrixKd8R2$`+oacc3vpngU=kz(C5s_Dga0ZkYaxYLPL`C# zRM>u`GK@opBGN#0OO+(FdR%|0x`Ald-#tjtDGns0=d>1vJv^SmJ?*&fd{2~-z0;yE ze$W=7S92NY*Qt-yyp`3uxg2souNAQ_WlQtg%#1{ut1N8#VIh&AxnTzKSVq2f8-QXm zc7bn0aXykS{;2+Z1u;;VXxIbXH7RY@no>_}n#;>!PK`=J4Z|@Lhc476uBWaagkVH< z*vI;rau!9W-QNBa;S(Qb`!?ApGia=@EMFC~P1$j$xfMRDmVZ}5AmQ0W>Hj=~mW0OI z$oGC2gj~=dr1zRi&7(;u-3$s%J~39qYcQWWvOFt))eo+RjD#sOQ85AZLqQAA#|lj~ zL7ktNyYPa)pOgtf6>J9cCE!GcL{x&|m42}fB2)qGL0x4L2WcKgTqMRc3w>XSNy631 z@E;>U2FaHJ2gUxcGqzu4D>R~jmG)cZTyPQLl=J{7aPHQKu?TUVzawJPuvD)cB@&FN z%O44n9m#0GPItMMi#uh#=VSA6pY?n7qr~Q8Ql1LAVb$Du2&MiKHa#VdM`6_oyNqJ8 z3SmQ0Q=Ip{4z?Z-4ne5a-C8H#y$YW`Jstsf>&a_+(@^{~+U1(su#wZjHSlJ2ZCUVV zb-_Z9g_XT}i^c5EHfBU@nOYo(BrBz4?3A4*s7wDQ6lCoBxT{1#`^`k#yL(>0HzwjD zt5nYyf_PDgOIraS*FwKy;RuPUKiUw!>JKW)K>y~}d^kDm$n>np-%g)#(!Oh^r+-D3 zD6!wEU{z!+tf)Aj!GTK`tzX$}03v$^1}%OcrD?}V84F(Bzfqh!0Vyjh`;(PVr8AgA z&|l3XFOpBTUEH4Sga<%ULueMO86ZReDsaz5O#^eM-{QR^TOPXiQUV#D3ncRQUWfnw zriPK1C84E-%2YVSA*qMC)v%6>3xc|eJel^xb{g6k?+_G(L0ucT?P1aK4klP>2yfPZ zBXE0N`;+CrA|a+l^SvICbRK446XfGb6KS58bJ7KP2vxW8&9Uz_wvP7kewBxbg~O~n zsYbm~{U}c5B8Tau3F&gsC<*7*5G~EegnZ%=UNQ=cpenjF&T2D4+BB_Ka_3G_c{aS>uRRH65Ze4>GP2rx*nNb{Lz9+6L17Bm_3WA`V|rkDTj)Ak z57lZlL}Vd{gk5TYb$EN;dNahp?Q4%CK-oxWf3%fH_bK{7`7REvC(1>}@Cl1Rc2m6R zjG_nGSw1Jjgx|}T!SLwHzJtoG?kxxBnSJ)>RTp5O!t`a3?^*s=j}Y|osb<}J;^1wf z6!oa#i!yR2tg}_Jq}9;^@~US0$S~o+qZV?ZS5sXvCRv7nI*GYc`Z^8RVpq0eKWYHV zN$ehDS*+WFT{WT@SWIYbWd%gVeWYE1>}m*>fU-(YS?WxYfR7*~7Q75@vH;m?r&{kP z*p91CSek}!`Bm9{SYha2qZobNZBgt@Ta=alJRlj(W(jYeDr`JyM#0toT>AR(_)SZ| zJIYP3Eo~76YiH*BuVbDdWlcuokx0@d60mdswP@253m@F9ZM75jOUBd~$cLY8r*=-5Y3 z{b^K?I4a3g?_UDTCOX`|!*oo=XAvy5hLv@A z8DsW8e3Q?45#xM9;?`_%hKx}e+{NLbD)V}92~YBs5<64!3x7nP$XCPp88!Zw7Q{z{ zO4N*>vZ~9U(2_^(i#l@Hr%R(#m#21Fp606EqpZOF2aQNJlH(D!$C8z!O}|hjciMc) zvhnE7)0vmhv$JdA5{0cu#$E!Ajkkf=Py$xi%Hqx}79efj2n5?ZP-t-AWUR&00dNIT zne_o8KnA82DF!04i8`-0fQybEP%!;Qn^fjG-AT)0`M{#`4;wK@KYw?v!lSk_Z@84~ zpy| z*HxQHTBH*DZ^pmrRI`gF0xG8AZ|gLs_Gl3q#0!V4u`x!$a7WLR3@H6l4LF{>MJ4;M zB*#C8=T{SJPg+mL5NbBlejs76*=jttllMzX$J4qUH!xEL`el*n@Z64##`1GJFQ-5_ zNBkDwvMFv~BMwK+#_0&5_f=q~zv@uz++0A{r^I^DD$`@DiWz$wnze3Q0xNae#Q|@q z3~vRgDZ!wtd6xRkqro!penHnlY%#D@6RG$GSFgL4+6X%P8;rwlO)5;ZQa;#@D|7yR zH+T}>SMhAhwGfwpi>^I{R~YM}UvZ$hOJb_~TPgxO%z<$G@LV$Ifx7AhBYb5SMimy3 zRXKd={v7D&DQE1t*~VoXyJxrGNjxUqX^8nOFZ(2n_m_cuSK-nP=lb-%@@$-;_X4JK zB)swzT23x3|Jp>xYWB8sUdDU50@#K-F+3*aRI&fYuTdnAFPGx#9>VTPu2GMznz^d* zOT}xevEE@;Ll4*-y1ve6`cffqG}$B{O@21P70aBn4L$5s?`ZFgE0vuCRf@o|-6_e^ zT8*x0LHgomRwR{ z?`7WjnZWA3nxUX`>}yR{B(l}kCp#i9CvQN(Ap1wwVknwzV*tl*M%~_NKM=p*N4(^u z0ZU1Q8)$?J7gJ4QNb5zxSVKnFpn}BhfzwwYRxz$Gl#xCB9S51BP_}*!J&Nb|@RiU) z`|``1;|zmQi-VM!OIEk<1I4$#A(m4z{Ho8Jp!aEN$|Zzl*AldL#M|w4ToyxSc;pUA zpI}`27Xidsag4MTS=og_yGPP?q!gSV4ArJjF^G!k!;OK~IeYaN5tmPmWvw)PX;w_F zKd*S3u+LTppU3$S2nC#zshT2x82L`%Gl_L=J81 zqLbN}OKAg(PC@R2mJ0+8yY_9@v`SZZu-2ca`dOaBl>sFXZlvF4XP48=hAL}k7+By> zrwO^^tAB`82u_f@{NAax3i&t5AWI4%I6b&xdYQjL<7b+(@8X8jWvMkQguN=;Gk+ zdXv>?QE4%8$JEA8u0N47!KlIrCd;JC8}YJbIGNnU~ETjmS{RR?OoLa;u+U4KJM?{BeU-d;T*2T0~uz&^i8hslffwGq+!&}+0mw$MzT=4Z7UK_7+;+4h_E zh@ok9BeReDiB}yYpEA|y+~%dP%=BrD8Vrg1SD?uZ?Ruv8F$}t3QO3Q+O%W-4p0u!M z)_c3v;h0lb3;~WbDR}Rp=9_^*?=~d70S?`XM}@aR)C}Jp*j-FYw`x)X74CJT$g|P0 zzPPz|ZF$R2N0nkLbE$x-(3M~DmQ@Wllxr1(4rDQ8`rQ6q8R>QPBVKe;9njsi%^+^Z zYy;6tT7b_vP{W$T>8++LM)~tLCq5o|&WTtGoYmFFZw}0eYP9yx%-FSVikxCp@tCE9 zdO-hqY=jc&uO85DQCHi;%cDbriVr(*3DZ_2g>%bo3wdSCmU19I>HM* zd~*DrP138iJOHT1dV+Ru&kUehi8tSmX3&w0DPPXvdWwjZ3Mhvnz-f4p)eetfw&3Fkt1r$ zF&c4w8+=krSh8<}8A4wG1b z<_cL;@RBTi%@$!M1!U?ObuK_m`5m|CK^W>tbtWxipU3=Gqk`i^Dj(9Am|7@Ft9<=6 z`5oiiSbi#Vmq+HD{0?1iiH>|hWszXsAhtnpAjJ|^4UCo9Y}z(;wU7-fEWK#YG@neL z=gb7u*WIJ4kElQ%ES;rh5B&pV6^)yZWv_>;qN;D3FXVRGb&MOPfk9E1*tJH14$PF? zU*Wc5Kjo6r;I5d)|7A0q8IxnX)LHrKq4@WA+N{S4Po~q~22hq;y1=Z$>==H!TtWzC z0YC{ZQC3dQ8fkDaI?5!HNlQvXq6r|o(6lLN9cW`skNX5!F$sF~ptrC(&tA~;`dE0b z+yv@-#*Sz)pCAm3P&?SOaWVa>uMMvoq-*gE6eUDb4{pf4$bv#M>Me^bL#huDKOI`n z4;Tmp{U6TWGPtdvThomlL(DNVGcz+YQ_RfFw#=NEnK1^L9WygCGsVozJjyrc+_^P1 zbAQ|_{ZO@}-P*l-OTE_nysKLyhMb}_GbOXVmB`6nuX~oi=gfpK?+s$&Jqoii6)WF} zu{>wHPwI0`Ih@$kRBm=-WWoo>uXs^f-aAD_*pj5nVX0&02weEIDw;?zLs?zFI01Bz z=4Pke-KJM^quLk|#St&<(G-sLDVK%y+CuE!_gus;ie;NI=*@JJM9c^j8L?1*Az9#6 zffKw$x50ikY1^H zyTfu&S5r={jpx$~ahC|-;kqCeqLJ=5hIF|nN%*NaR|+Q*(bz7NOCa&R}1(~oA)(r;51o_TS493%pY zm16qAp{T%@6y#={xUK7>Qz%MgVHHHv%4s@~@yiiuy-RN+Ik6Sd_g3bx5PQxXus<<8G-y|U zFM{KB=%>$nDAScmPCw-%NHV`Q9@L!MPCr<@QM4HYDCN$)~?v8VyqW78@4~@4x41V)5kOne;yMjk#MyyO z$0yo|Zt0H%x>UM8JY9R~*6UUj*DeTl5~)>V=1zv-oy*${Mgb-Qbri^?DdSDmuekIeqG0Io-r;f7U?9{*N+7^ZaAUBjH^w{}ln*tA8Pe&# zz+%a z_l|qCl|~ix$justN~n=UD!>L3gq06m?OM@oHmxHz(3AX|V|NqM3!~7JOz#njs1@O0 zZ2XwT@x!^aL% z0^9GW{&1UFo)5+-K~hfQ8!1*tpg9m<#z&)3O8WPd)+&X`GVm7B|S9Y(`|>7OL(6J!hLCK2L_7~AUS!ARA#N+?U)?j-n1T;9#N)`;!sgW zypI-vf9CeXLUie7^ixTtLH0n$A)j7=#z*riG7H4F-k3WolBC;C@^ z9XKc0Ml)J3DkbhgW-C8mus?WdQk~cVcP0YG{Gg+cTZVaiXDr@tc^t${s;qvGbF3EOyP)puECUS3P zz0jdVAinrUVfX@=UpsZBPT+I(q%^c@E@geR?>vGo(8p&&3!h=pA1u~@V<^Sg@-c#m(S*q|t_^l@3y zEVl`@MdIK53psSRb9=rIB7xZ8I*`#kJz+$jYpfW)m0QOJlDx|ipaT!{I|7Ru2I7%* zP_B_bksF#aW`N3z%l81wOh6DU8gU?@r&toMcWgC^0w?r$<&+ZJ7!X}9DowR@=wF|K zf9)kgEUQNk`kp1LqC{ z5#)^kdZQ6h4Us?&U1H1#8~7n)!&c!3?&nVjjM_}bj}yV$7JokHa@~;CLB`L^>MKsd z^%m6&{!fn2tNZG!alvdu99|L_2oG`+a=sG?F4YHQK{|(>B-$?&w3!52LmslKmzGUi zE#i_^BNkNIHmt=$9jj4g64HLV?z;Tlu@Cok?`uWtwS^KgW{-pzH$9IZf&#ja@&uU| z;+i&3E1xT4$va(tKi_?bNm5lDyND!YW{P+DKGhD4j#nu?&x@vR6IDVRO$e`UTCUgh zCz)dA=w2VUZbsAavESQUFEN*6^jfYJJchVC?;ddJ-X0D9Ts3%j<<~~z<|68DXLh|& zXZYj3u)e+E73}MW#T;+H*CPG6zcny?dgT1!(HwXn-oSZyPJxsatry@&A&C~ zU@IwF*%8auKRf2LCZd%Qr{sOtY}x;Y=i?)PDk$6_?_(fz{@sx=`1}*$6_aiLY*Fd< zu^K*>skP-n5Ptr%-d63`MsufKp3zhsTQJ~G%ldPhu%*!g8o@t9?woMV@?}Z$`hLUu zVqgouaIrBNXovcVr}x1@kXXL__{xh#@3q=|CT-M*I#4*)OAd2E*e^xBN>+U^;ZQ|z z41vwGt3hzo#voiw4wwvwz%YsDI^X0;;O0` zQjXA_?Ktq;Pv>jIb<9t+=MW z!J(er>S@w0v76kp-eya%);mhA8|XGAK|nSE`cItz`x%sa3L%wg2JIlwQ&;DZuzvoL z-$2>0w}8^Pf!vjWzsF0*$AoTCP3drUaGrky2b$<<-g}^DRx+)!&NsXvg4*!5lgzQE z259t8)s|a(dG33ZDW+0{i_3pKdV>YEZ~26dR}>}n!*_J)ukATxJ+ppcuZ%Zz%8a{f=#%2eb^W&8Qh z!uFyGrk9_Pga@{dn>2f1mMVX*xg%pV*m3dvhRo znmuB|2@pA}uakV67QCno?5vU5`}(1iJo4IchZ5;k)@)b-ga18>%kF~4;eDy=K+;Z& z?=!l~un+GnjsE*Mxp5(zDi`C`Y&qdv;|`2p?Ff%#?H9P^rLGmYpA?1pnTqtrU;~l zI&775sxJM+A|-RWU_&l`H+2P*#} zw)Vz!`#iby@)C{n_&m2`_^IpI;~VBE!zz?_ z%Vz+%C(WX5yj=xV0LXyNxfh}corLPt@=mTOk{!Xl*V?|}lWCi}EgI#>@b$~!wSKyd zDBq(W1G>6GC?L$@s~8apJz~+{LcSSIk}&9TO$h2=Y)4dQlA<=+)eI-zdW_r^EStnEo|_Ydb9Mh zHDi`_oZ}WZ)|+-pwkd|3n}uRw^otu3(2%#5$3h&rpa5Y zrDseDFbuy-VB(dtcBM`0z78i2zWuJ><&EfTEi6YZ@RDrn&5>~nds?}+{-=ZB(P6Tb z?U}>i?aQO1Zd)%AY->^5kDG>6`xu6OO6k`{MyK`%e$bD7W(X9#Wo0N<(+7ykN-n-~ zkbXWx#}m|(^o=E?KE^HdzvN9LWAZtG{=xXpJ=xVXgPj?AJ#!gX{|q}hv!(cqnl%4t z^*P0ea-(D#=Ehu}btgJQx(CC6=D*PDax^2gVY#~3Sy12@9I4xNCI zI8g!>D7rps|>0sNrQ-kIH~}MDW0nOF$VOmnPm; zNFwRTo^Q}?V;_?yN~@+@8U4J!gZVhkLACu{Lokt)wZ?Vm&>u*c@(o8Q=H&{vNB=xl zjCfvD{LHXmc!Rurn}FI*gLs6D=Pl|HhJu2^x*-XMhlgj$17pK6HrE;aL6nB-%6GN? zxij%gAVJ0JBiDcYR+&q7wpeg?i=#uzAvetcWnEB=4LE<8>j`F-H&kb>l|c;t9!7|2&;Flh(8RUKOh_Me>J zNwDC>wf81Szy;pE9_U~g|D#y{ei-2ph>7TD2?O3re&{LkvR5tvEdrguFy`EN+8Ht! zhT@XVd&oHQ(Lj>gYeEZQs^!j~Vv7Xh#osSky64E$NT3y-V;4(wd_n}UEw{~!3-={jJLs)OT)*1cViv#_n zio09q+{(x3^u~)`g1aW$4@UuSFGMg^PjQb0jwNa(ptoTsng(e_V7Q`jwhci=eUZC@!&jn&ALYqd}Zo; z_Y(a5_Un-^x)kE2Lxk!a7|( z6TpT$wJXetZlS{@&`er}2-CmmF#|k=1-6>H+iy+!Yuye#U1qa6tjc}u`A81mJvH1g z3S0KYnFDi0i7c-zr3q1ER}IV#M~6e(l21=owmO2@hTp)4jJsmfvRi%X7i)BVvp0;T z>oA;(R$XISmSBd)b$7& zdbLr}{ecXbq76FbWYe_Y1`-sc&V@C{p7t~=-e61CFh*qLs5xfNm!o8O85s=|xL0i8 zPUnxFnN<#50rZXE@ETE(US1irT*_M#z#&DU0#U6j`H>88mMG3@t)iNrwg&v{njKFs zr7;dGWP#!Z#6(H3Q(CAI(gCqy*LqnscQUMu*z8FFi#3dL3Aj3@g31jr{S_!+JxV zi43)}oPT=1SsJ$>H{^^e1b`v2H!ws*5&-+pfZK_QNxr(Wvlg(@vjMAGJ)NqE39w7I zp=zin4H7YaJ_!Y3lq)IBu5)2{4Qhkc7DJQKSn8a~l88?AH1SdQRz~j{3(5l@imN{j zYEm{DAw;ql@Twe9Wu)4iqBi4%25;nKFw&>X2~KDfoSRh+LJ`tA2@)p5ZmDc!yzH}K z065%NZLl#0y1jENVJkJNiNghofmLVTEPEOv;oLi1gjIufd==-7vL{q#3+4U=(8sR}#Jipkaoycf`Ggqsy)O@tlrv zzbKUul$Fvy|0;5H+AHdENC4v7$ zUbxK-zuQdkndFX0n3~iU_9ljJXl$lWW8r@}xBx93Muc$hKD;`7U^}M7UyP=du+rOk zzyXfk=Z0ZI+(m?405wfx3Zz!!Xls$c**?PcXsqAXN*kMe+skJvul)IYQ3Ej+Ai_8Irz2B3I+<4^=i6|CY;HP@_=C>wNe$tJU+p7k>mVcD-{1>a(ViMvhr2P~Ry z@8_TSyageH?Qs~qq(`!KacQQlf#Rt>G5tFJKzC&Z-bK^RWg1DlYQrtycJAiFIkD@; zgpR{vY^^joTbz{Q&zg}8W^)u&AZtO->Whtxcd#cQ_{hv` zzF|Ipn4-Rb-~mjMpRz2|vh9MLi^(=vz*|mI6_+tK9X*~*3EG~38P|O?1$0~R0m+Ch zDvfL|uCi1l`OSba#CASe#^q>QuUW;}5<)g{H8HDq64j}OLgZ)~z7n2<8;hIze11$B zL-(U>=4d8y7}bQpp-=&O1UpUW?Dvu8*Bzz3ZB$QQs_L?$nd6=%!Fhd=GPx7SxpXjK zp|JEQnFOK&wGHv{_+ySJ_%y@54x?{QbvU?g`+PT&|1Ae2q~H{7sE5_lg*9q)pqR`o zC7k}NRXs10IhsONRT+B$)#$`o+r@A%1xlVgo#A8OZm$3{bDF(ZS$|%xxyUbp(g0wt zw#@4Q4^0_T4RCTWWum+ctVrJt;ucF zh7jkaIvW>~S`16Uf%09bHdTd^srqaqCUxI1JIO5Uauzm%8g0{{$;T2)cV%1os6W06 zQ(V65`B}zYC$woO`b@oGVNk|Q|Q`NWn}2fajj*Rr)+bg;2f+0sda?eg_BCd zjg=e;Q79p2XIpEI1xe}YsuAoUgHJxFMIgqu{8zX9E^&@;Ro+^kk^iNL3VORxFZRydx`P zV$)}~1iCAUvALy{cGgaSOKbuorb(1as>_>kyLz}Wa6yrpa| z_7U4jS<^z7)6-*d{HzIdA){q(^g5MXk1@B{179-Y0U^VnXKZl}WJm6!JL)|x)ES18 zUEA`^fEl(VxqP1EGmbdbH2GO6#)d~1SYh` zW?Yy?l_g>$9iC^?vNb=LRB{(8S-V#FGKe4=Vl~h@I4#z6&Dr*=drZp0-0c3q;r;Z= zs+3oUi5!vg0buP}XdwZ+XO`6Vsb!oHt{d@>8=`qVoZSN&NGAW43X@fmI_$5#EJm364XRPKP zRmNI?tvW1j5{a9;6?yB79)7a1%^SQ@>jGM~GnVuk#tAvP%1c%YECdiX4F$KYiOcGd zTj=qysD$109Im-(F62MY#PK|wdDtH^;e2(*dunf@AWz?!C|Sa5-WN-7MUmEkjGYtj zPU{vy_--;-@(5CZ(3_@WhpY~tDBS@PZZ{XUg@yWuDjRH%?YOZLvLY%t)WvPQIfs0Y z%z`bQaSf%gR!%gPsf<^Qxp!CHFGU{PR4_iN=k=$o%iJsDcX^SmW4?ul7IKVDj??1L z(2^x*onAUg?+QggF3CTo#q}H3O>+#BnJTZ~kh_%nte*IGBiDv&U%U?g-)p<<%*v zy>N;16xXxj6&5a>ts4G)dagUGCRC7Dlp?##r$R)ogtYbM8lJh8TvmkyX$cuYYzp=8 z{tOm%#9IS1Wuk9ys8&a}BDkG(Gpxik?ho^~7d#8JDu{#8Lo*YEyf{$!uwd_>cs zxpsUOorBkEWW-_x6K}CI!FdcD+Y#h|-`ah-#-~IDHT&NzfG1S_Fbr(wV#V&he5sKc z-UhWus|eBeaW?ByYCrv|TBAdN^KZHbc6lJ1f0_d*PDK8fiXZ0+W*B`S?0N1+%$bb7 zm_&Qrgopv*ir>sJqCj{d_^{+t1#-HOQEjiHnNr||bUZpeR1 zg!i-ybN%lPWIW%@vquV>F1@(#q#V_62QPJ`Xf{U=>ZuqZ(j$aOFE1+dd`)Y9QfKNV zjyO&gW#7ikyeJC)WKZlcr_G!LmZcK=mK9WN$1a6Zo;oS!H#+}4pR-)zA4>r#z!33F z2%y6@(}JAyaFw8FES%XMkw!FkVs6T;kLU>}<`3|LV`vg|&}bnzGYf4ZZ~itHl(?5* zrgr&cz%yEPcA#XgZX~_Z)aDj@{M`|v%*P#1*wq7x9xIprqJKEkf(A4_b zUhy34qkuepLlI;ByPS*W5_vb|cDSF&3C zU6|GqZq2&2p=CUO+)tV;TQ}3INNSjef?xW3)f1awD0cYr!ojxF~sT!I=R3s^qj5zGiT# zggv^W%TYNsSO&ACAb8%8oTTUa_o4I%1x2gI8bMrIl=8enpnsbJsk4(PU)Ztp6Ds-3 zDqACe8^Kybrn@$|kW3-fDT?6dIWsut8N^Y+@i?-=nw}>VJegUg;nj+xp0xScMf9HBeW9if_uHhF>#4(N z-B#W^+J7SZKRh?*rfb0Zx#F+>(EGsh5*PT5G3pj z8^rkm{ali0t~P)d*7?ZjBcyb%%^{K^J^`3hKz8)^smFv(LoGh3DFu^bIOJuXiSR(* zS^=*h%a$Xxics zs!!Uxdi0*dde7omIG44DQdS!L(e#jx=TSU(!rqS~yMl@{ws66QTH0}Xlj8ci@{D)j zS{&Tstw^z4x7OIDViU^GSh0_t$@6}PL(c*9C?vZ*xKgNZ53?(z8}0f=%f}T0gMMv+ z>^20HlJSmBYK}*H)OR|vBeCIy>-T5cJVGT+f$v?HL?*iw8iQXme%v98u`kfx&zn`6 z4kg<3sE-Az0=e_aYIniD4xUB(kn0RQ9y32=RUbO~(~!psibgcX253Ontk`;!B*wMH z_)_YbrrH~ZIxUAe=G>@&N6aW%D1JxD@2JU9u*0FPLu=2`S5qa4Ft=WLpg!-H-6&1W zx-F_Xu8}Vs)CXQ9swP1bTP&l+`*NZ-Pu*6Mf^|Nvh!Fg2ktL@cWF`sE;ZMeU;rbPc zEPXohJVGUbs-c4{j#@GoMjGC^zb#im@l}F6+U?m2f?>@nvJfCS;vsv@VH??f{vf9G z<$Jkkxw0~<^KzC=Pstqdn2~jO3l7&>ky3l(mrUbs%i6dmnp81GxM)2Sq-6M-#78X3 zIBZRR`>JRk&PkE50ijtDRP8>L6b9yevb1k6uVMW=aZDk$-+DBS(6JhOQromt~FV-@>>ay)xFWGC{CBG46jwV=YM?xyd5)%DX>nvq> z7Z4}e0n&`RW22_n1wCRi_QbSu3?~do9(k@%Q52}P!r>S&zF9B@BOx;-kyKX1g^ER{ z>NpWI0SWruuy9<}(e}A0fNZf60}@{|Vh*kFO|FWI@);wxjJRDgGP1itDLW=)hm@;3 zPvYgl6_6H}H%U()Anm2~YM$tIkKtarG1cmPyqSkMP)# zS}tbe(iov8T*YDG6^AW6*h+X*72!)&n8)yS4RbuA#Q?-<8I&V8EcU)3_?WjvqRBy; zQJm_(CkTjE$0am{!cQ9OF+>-qey%X1X%EI)Lz1FLI$*2@3i4Y6Qm$2BGNj~{G zLV7Pw70VpLyM#L*dC*wl(_9XO0(^A&2Lc2V&KgQh2Tg={ zRs6;)QC6+J$zRK>66+e1>`GYx2wYR`Ljnd*6mpT@PW`pr5t$VJDD-AD#bdJQ%`YrD zKP-Ez6@yYGt>Yty4Q#s~vCN5GRY}Raop}ob;t#?0Hk4A#MvY+981L}?%@`DE%Gm_k zJbFi!Hh;VnRpyRKMu4IUOkXyK_x2qu4$~TmqFXpaRU>HZ5j7gN&n!(&w|sqW&%r2d zJ}e5yX;qp4hfO5oEN{* zef*ALeTKjB`y=_J{#p0R?$F`wEU2qFET)sbdR3W&d|PbE3F*-@hIM_x90q8F zh6Og)@MqE98dkb_qn5`&r`pQ`ri^%Yf-?ks&o^NoegeL28QEc&erP=q6{bRmGB|)? z+VmAT$d}bgP-XjScg9wjkXSP7Sq1CeL}&m4KP=9pst`bE2}>;thd?E#m2f#Fy>!mv zYIe&(%>Fbmp*|)E55N|e0Jr@1ms%ljKh)Xwztvdr=lmwsk$(l`aKVhM!c6NMPr`~M-HW*^6 zQKhT!H|f-zIKz)8b5hl-I5mJKKej1OPgibpIFAyZw-U1GY+hYO!#gVDhNvG$i4Ggh zEbQM%yTEEIboKQ_e&9~tbg!ifWeykc%8U^5R~9wZqre=3Q4YX<1PXhe?IVo(NS7I0K7kL}>?wjR5<7eR$TaRz&?K5m> zLE4wZfbRy}OEc9$`2>VVWcDLNFNoF&Dk*TEzlmQHQ;;Ev@cW`@fp35j0NS1ALPTj><3~J2fq}{&3SXHs zzCBiT(Oz%gWh_5K=WZ7z#XsKtpm#Be_8OsS#H2siP^_MXOFJBd|5s!uayWZd=%?Xl zbGAVPk81%WGt|55D&zLIDEyG)Bv%4m!7Q^^eT8^j|Qa!is4glGU-c!HrA90Z_x8zu}(&=Z_U zgMytFMztg|5))sH;@T~>))I2dcV_gSD}8`je^SkFyh-05dWz6D$AO=VUaNxF+{l`y z^(%Xl0kzpHO3mEA@#&ItnEuUfA}>e6O&uQ!K$xDopTx+}miWlJ+gvzC^$5x-YJ}Gy zr!Ax?s&yGkY|lF1tsKPwcQK9k+K7C69BO@@$$h8%aQ<}d9{@>!hVDOAe)kaxcWI7m z$^DEs(;%&fyy~v7q=}~V+!lP=gcff6oY=a(8+~S(`By8w356V3Xkw%dCGFJ52<>fI z=ixjyn270EZqX%eE3XUcz+U5C1DiGR44 zyH*%9J$i|)skak2QkIbqSxU@$_Z+$+i&JJC?p!K4VZ>WJl4QYiHLiStADo_P?1g z_+sOCyw%Mq&?WOPCT6-!_vO9|6ac&jQyu&mm*9W;dIu0CI|*g+o@cH++|R8XvPHR& zBKp3LKi;FJ@GaNFav-M1lqjVq->Ybab5B5s5)ag0b9tH`5UrdXDyri=pwKX|U&8-Dy%iMU<$%)p~nE?qO$LYGyZ|ED58xXd;BKjJ zjH!zRQimVlRfuD}Rh(5QfYprfy6*-< zp`{(d7_IYR|L_^`qPzBQ*4$>Uc*taMjYH8-8WMJN3S*4+-O6kV_;mU)t)I8mL2=!0 zR(l<*rZe(Ca4`bMj=+51{_BIe+&^l{dQ2lo4*-n%)kvnOP86g(7KDD)m~JycZQhsD zRkv?r+^7cr$JF}YX^=rbRNs+ZYNLCn+f^9#b5lEoQJtVjDUNaMyD%^Rg739?67pGW zkXxsk-WV@H`&`ITR(|D4IYhs?c`&0x&(!!gs&?t-pgZF0*MEBb`tmO$MOe2Kt^U{JFGb3w~Lc zTiLw(TK`5*Cry8ge|lg*u}z`_xqsn?y6SoeLAT&|&Zf!F05yE2WB~cw&N0DiG&=N-SoYnjtN+L&N)Rj#d!4CIkSiX zFaD?Bdwky}Wl0I8PM?XNU!;u7%K9FiaDa|Pr~EC;c2~}lx;)H=^Y4S>0#PDBGZq{) zO$-lOEFcUH;TF*$Z4nl(4g7s`SQU`uF{f^Cz<6P3oqv#9>wvzSedM6q`-@&jY%hsc zjt#0k@w8LmWv6CO=NJJvAYDB)_G;styKqwEsEUz`O%fA`nt%?Pf)}D(Mc(lLSka!1 zsBiz-gwk-6=-=J<{o4V;zkfN<7x@2fFb`LPmfZ5qt+JNOLsQEUmK7rfi7h6!-LxskH zQG>eXD;gJOa;c2n6@RFqMIlgF9>Ey{_|alQ>SaXz#hd%J%{K|*6}xgWikv$5cP}`L z+%Dq6QQQQDPZ;*{uH&EJ0`FL5PCs0CJqq3&J=sAz+5G16$J?svI6*%$uLM%EI|)?h zD0}<*J}7)V|3|EgHw({~KyM@dHN2(6_n(Uawh?_;nD0243e;sKcs}o2UdKKljK)~y z`NH2TY{R8U=+q{E5;^=lUm6c(+TNirwLT&1C)qK1(%HSO_q0&nkhrKF`>X$<(HQFK z2=;jz8Ju{mU1rt2(Mr6El8p4|M5b8zugtG@4CsoAgiZcDC&N^Ltf&>1;~dHP!-_hh zO#HPvi$croq~8(!#rV00hQ}Zp;eH*t({*#S_PQWktAB1i#H2@sgE4I{KndE-js|3$ z9`?=zutv}YSHvY1<_UU+)ZXIL`I2Fm{+G5Nj+jj7lZ6>E$Sd)GNDv`=N!C+9mb1j) z3!lWai+a6Dd^~OU;~rK#U-3`U6t({u75Te^?B~QCPmh6_Ji)*RHcgA2lvFXuG2*7G zw{XU9Jk)&RWzC)I!{^)}JwDxPtvVbxsLF9v}%O10-s8lyB9k?44pcDOJ2kt{!uYmD#a%{>2)gu!_Q8%F$j zIq;wi)1WH^6z!)N<3>PrD~`3uC>S{ZeSj3UpkVfe%+$1qIrj8o&{Wn~6KMlM3MSnd z?OF1twKXw3gBxlJTJmt&U@$8g6JZUIrXgPC&p5Gv4pE^+6}f(8Axzbh+wFmSmGF6j z1C0mWMuaVu8OkwvN-P}<e5jf;3fu5BFEF$=95B>3af6y9gaJ+>M@)2THv#4Nz zXm)onu(Ct8eisLi4sBYU=DcHvwop^@Aj?kw89c>W67{q_kenhJU-rV0i$QC6OoeM{ zI?#nFy%2J2<^6fTL>TEX7C+BCsG6%hwr0!Ta3W)9M44=z9vzRz3-*0c<;KFv6x$h8 zC9x|9pO@2EZ9|QKyMLxkjAaqHaZ=LZj+kv50?k=_9!TsES7Qw~g${4XxTV-)&)x=y zI)n1Hrq83DB3?4rFGg~KD0?A%dC99Bp)(S=?6Il1nW56C<>t9s#{G7UEYeEp#U>rG zK6#wiO2rF+^%fysYXp*%+fVvCN4!KO5<5gu(N}OP%)}Gd3+<{^455?4U_4Z>D z!W8V1Qhu*)y?Xi*oY@Lj`G+i(uRH`e6l*K}CE6xE~j$SbHjmK>W*(aC^?fHUwH1WF$e&K0c6}5fHf*w-id9+ z%Ck{+gf-=!&RA`x1GHMZXvmFjH{B&SlLE*<3>rp@y8Jupig!&aUaiTQI*iU{j`qnC z=C-72)8Lajm!tPG9VD!)>5DOw#|N>PP6P4u;<$~qIW9mROxw~RtXfdj=}{Bk$l^iY zS+zBp|1M&qzCgcnTkuZ5Y5Wn>9K_i|`(ko0oVZJ~WNzIr34ao=MECHw`Vgn15VOk6tTt-Kkc7M`4xIwiEwuyH$B0EuTcKkF z$-sYia4R-;MVXYDZ&1Wfm_-61PkmTHRf*qza7;}`7}IR1+>yM>Xh<{#m$R;r(~xZ- zKklyPkClp{nowoPmL@f-FDmUE_wu4VI$*TQtvCMw zIC(+Qs-ws(^!z#qIf5pb6?s+$97GSyUNyZ*)d?eL1;CZNpenCvTf!XvJ~B1+CA=U| z!oN>iT2y%`{pvOy+$KpPAaHR|leh@d>hKdFh*78k%VFx(eN>s#U$g1$JTVSxxdpKY zEPJhKe^W8DEDkjV>3{5!p{TMb?U*Gk3;6V5i>PFU!bb)chEmjrk<;lJ zi%2se-#sD=gchn6wQm(ul0c_$Uu1CS!P^+2fnSb4&frhqbf!UU8yfYpf33jG6)qm?AMYN#u-y| zUd$X$8JcC1Q2IzJS#t6wuSl7}$ATFn!Op1K#fIS4<-Pn;4a8hX3Uj-gqZ97=eZPC5 zEDWKZO(Bs(pFov90pg^47+E+gT0Mzfzh?m#?91g9iG zjPODqy+FOiE^{8owBjJM`W^rSr6!_m%`0kl5+D#qb_az|6bL0knmzyHD~}MZbl#HD zJbcr3PyQASNOqca3*?WMaQ9~q=AL_mb5~koFwzlxzFOaKg<1MtWE-hcGQN8ZX+m@{&tvN;!=*Bu8Nt%_`5tU0lEf zpBqdQk^FjF>fpQnIUCJmquJ9ro`A9}l?Q(t2PKJ3;Dc(rw$m$%L_wowZPy78w~g#d z3QfUMz`s8|+$I6xSvjM2iHvP{aTu$4nEF{zrC_l0VTb6J1p?&GOyNl%pPbb_Gavif z@xNL`)8;_ET$#-s>5LtaqKv^vt@Xdmow^Ae=FV;^QLqt&2JV2_^{_pNVg zg~5^!*?4TG{|7VV4Y69Er$?;K4M9BD%`xt_g0`|vPxk6Vgt@xE`z`TD|L8x7QABYo zQAC)aX79IxEFZiGWWahARYgIjPKas-^_%=zDeRx)c(cOEbYy*;OuXTASxUF>Wd*;& z3|YL6J^tvEPe-<`$-nLcV*ET4Uchj1Q=-TIz&)TU5zk*zGQD`wliw;eMim^8nYm-y zR}(6x28XR$(W11RlLsOj1QworGPi`VafV>q0^fz zN=j4J26n5zPPe@2uk(M@gq8^V2%|#-Na_>Wnh%e?c^Iyp}pe{&n&GGpW9Ft}Yq zb?$c>P;5?eh=WMt!zs#DUdB~2w%xGrg3T`w?+-BhlPyrda7 z_Igkp#xCnuf71S$Zv2=OhezHsnYTjIrVkd^|6fn0GWR(OdByVpnj7AZr8rBjj)#li zNUIM$dB?sQ-pY`ZdT&}w%Hd*h{$=UmMzDJQmZ!eg^6M!e4t}rFKWu{9a9n%rpC^-c z$u9WI7hG&|+mpo7MdAUY}bnXt1Pjn%sp61=C^Wb!Wf%xTuL{I9h- z{{6W^D`4Xe(DBsnd-w40*RfvNqD?}}3}0SPAF7x^g~=iAXT(n;^>Wi%yg*h;^xG*u z(=Jx2MOsG1tj(RqxxsM8ckIu54+Ku#ofm18$Uhn zv09L|>?ijRYJ{ER5@2H`w83{LpRb(+tGM3B7r)5486vLQ9Gg76&6pYSJI2#f^xL(+ z+PGXC7EM@@(JhnzP6&FdR&}H$Bn}kG*ew0q6p_RD5xT{(f4zg`z}KMU@u_;ocenJm zqXgz~CX;>5$`gCJo6MN(^BV5ovzU%a`hDGPTm{s*Rg?0<1p#-Z1~GC~B#{hIv|I(H z46A?ZG9L)UmGoc~JtRk*U0M(;GC0U7JZh6=b~D%?Xp+6IV)$#2%YnSC)QN2duVT&+f@Uqnn?GMPz6 z)T0!T+}nz+rT6YK<#jn|=#OFNgK1<%>q*O8&F*_7>f5KA+i{kd(%7Nv;9yPn$Y<_) zjB{QQ~!%;0yP<-*E|4R_Yk zLY}btcx1z4RPWl#k2F=h(K3Uy4L754FSeiUMb3Mjd-hgy&tE;w;ISvM9k33i^yx36 z>3=q}7N^%cPtzFkUy`(jhmK=vcHOaE4zl*xY z4m{&be0|OqTHFhI|L#~~lG(7x!5_W~WHs?L@P}p-}^ueW~9k{_z4-QL(79_7MN%TKbOdrALOr(l_Ypcm&g*??$^g ziqQB1VxIdx%JRK*R*foX$sWu(L+?S6w423iqv-kk$k@blH8ordTgtMen+T*`!m>Cg zm6dI?`dvaH2?RGXW2NMC*m3p;{s@gEF(DfDWTo|YQD+-7CwXbQkq$PXF% zyVl_*b@5_GtIOEMi%Ic1u?CYVOzx(pS0d9GJ@T0pO=jd={#Ga6#u~!Xa>fkep=tRj z-B$XX;A^%r5R-#ubS~+b98?-B-sa&fbKyvfV#k>3!eV2g?dq5uJDsg<_za7Qz3ER_ zOiVO%*k_oj#`P8FzUn0=K7MB37YOcRW~P(|y*OO%fZ0uf&bXLK$01)Ab+wJ76jCU9 zb23X37BM`bmV3K!^iT5r1&51ce>l&Xka)JI$C9Aw=Fq3-Io5RtL@}oEOk@WKYdp|b z%loYnJdqwun0AmThCDjsCnLAQM>u;EZyy8W3y}fTV?Ofr^@B1DOM`W=d(Gm!9Eln+h$4$gqj;^Es)rHI7m^q3F#?Bu9rM zg+~!Jtd$1c^xP#TJXh&wym&2^m!5l=XLIl6rSCk=t4TIqJaC!z+b&HMJ5r-KQ&Wqz zu9h>}WOkT_uPMn~q@kv*?Yemnz-e!zHY|e7U~;2}=t$MV)y`3VnE@x(?zvp|MiCyL zid-vOjJ>zjL#&br4;w*FzuF7yzWd?u_Ly`!A2`1*}41ZtFyx5)G=Y` z%J4Ao^)pcd(-D05e1UtXOZHRz^|5k=iY_{_` zskJptsE|Sc6e_gg!?9C?_oQ8((v>GAVFg=DCsvYTO=bny&DCaT}S-vMCt7QjmQ({W1)AagNC+9mUg2 zqN%-lj-S?b)9iLqSX{!}Gu*>7=o?ZQ1LK;4X7e7@b+6F)yF$E9CqC<58V{U7xoI~M z5-9H5gJJOzT3_2oZ<`Z;VWtr>invf8r@#Y$@ zliIo_x+YUd0VGL+K&JY^fxBa+l$aEQ{>!Vp`o|dd+@pss8?XPthCZc$tUIw!Dbm7@ zMI}7n9?j4H!?*~#$ZUSQ1zspRMeYR;sG@l!^Fa>e27E-_SJ-yo97l#%#W-2{>nk9s z+4Jx&ewhrZ%Qx^=-)UYragdh>l;o%7@{^?=_694TTuSTTZo^*N%wRwnwSQkhyD}E_ z_QRxoGY4Y!ko*H^eCv5C57a=!N_3kJkoxx3&`P_=yn_+VcoboNnJv6|1m1-VEsLl$n2`%YHJkB?wLha zVF`TPH8yL3V9uCX>I!!Y*4oY?bBZdOB^L8YsJFM1+Pao06%s&Ca|Kn7A*G}?rLn}M zV!F(~)D>RJPJhPV71=23@`75=%B)rVaN9DnZbP`0NL?{8u3yB_D7{6-Ulwq4mscC_ z{ouPCUGcwpW7ot!pPo}c=h@#F_#eO8J>z{!rLX-NKkD7hk?-ZrtN?-FE@fsbrLZu< z6bza0e0}u#K^+DI-cD?FEx3YENYIa`&mZ`|g0Q=05LJ=2?qS|tccx;NK53KKo9+C>p(^36~7W zzEPpJQz@iDe2zvMyZqPhkBp8IyW8iOD_5?Not=HB#h5qf|Eh_3IeiJ&incEhjAG{T zV4+dOo3!H&vs9opB~7l72K#Zf+NfymxgK{E7GWkfLQE3{0)ap<%TvOYi{eT2)Kc3u zys>1E-p)qq2BI)T=+J~K2~!Nv@9U$-)kUYXi=O@wYhj3L5lL~8%wP+mKp+qZ?m}jn zx+0XwxMWg7>Zo%B68Fhox;k3v>S(>`Hzjp6Nr`53Vv!^e2n2!vvrqD;2qQAq!ct8e zjcuK{`lpDS2vHFkZ6?mBLpiTJ&VoCQtGtl+tP=T~Hw1Ug(L%#j#(PKWv25K!?mTmF zIj(%ndyR=awK;2k`rZOeET@NxQ^z>v$zaFB8O&l!^DRfVmvj7lIdx7C{tzXm^mXi5 zX=bXqxwo>A-<0XuzI_!j6ONlMN{$}p?C{A|3IloD=3hGthB?SQ3!p$5X(m-~#M9%% z;p(BsokL#zD4XIZeu*yYao(wmyFO^N zmwv?WIx~3o!E}c8j9l{>`!0mDZATvQqdHiqN{wC{hGssu54o0)e|L?Ttq-w6JN4~? z+ku2iqeUO0oN{oVJ~9=bz00SKfj<=zng}DwOLKT2-7wAP^>X>bB^p&(Y}=YbgycgG z(a(|0dUCh!B6kpE=Oqq)(ljTf-VC|vEc?$7kiTUumg%2+Fe!7SlmaLu)Dh9BBci9i z_pU{zs`NB}f1-jj4jEOXfz9hS@M3<6RhpPRk(}g_7jlhe*C<CT(DAYci{`sVNA+mW3B~*1USoh@7N{UWgs+>O&g3{J6DFSM@Eynj&I!` z7u0OjYcJ>2g=^RxJ$MyL^ic_{S)0d_2%w{kgQv=|dwlo@q5Z@C6agsW*tBy4OG1N? zGl1Vw&Zl3LQ|w@J>yRz5#e$d%y(fDOypwKeMo^WDwrGgu^* z8be@Dq#-JU>T9QQ^~zuzda*Zs?~TRmKX1eB^WpUaB_Hss5&#|94?fBR=HTUYRGp>h zij5Ypgx-|S`nAhRo>$t?CVjny{1vALv8Yvv?j`PviwWxkBNp_q4zCOBf;Q_Jy_rF19c zvMtYy)@P^q%QGClpk>!;Gg4F*JHMHQ?6}0ikFQa5&PQhM7B(5d-5(yLdBnw)bC+l_ ztYQ0F6RJTU-5ot>hUXEB(%JHG3Vw%`L#OSe7p&)A4WI}^HQbA)k`rLS#g#HUdASdf zuk%oG{xn5jmJ##y9AXq8w-j^eOe--t>v$?bi`;pQlV6_Zr1}xIBoB33e`^^f5$o8t zeFGZVK}q3pPL`TUUY8iuZhT`PdaMapp!N`h$LYnfu$1LZuhciL$^*2*=`Yb0e8u`}R;3i!`wa*}FX=ui0T+Wy()JGB_+i|%8wFB$bdWg*+ z()d$j>=Xg@9GXF2&rDW*sBh?i!wPf0K#-hMwSm1@lF#$?o@ zvbR&|pY&_<9!E_rt%elRC$r1>o3PeHa@vg@#NS%Xn{V&uSAl=8ooV8Rs!&L1!lemk zNv`T^)Tz?hv^oWoR*lAx$k(zH@zzz-Fe=4_q*Nl|Lz}vayf`f?r51xW*sdny2PBn_ zMG;!`dIRyPi6b*eg%XWMi#}XJ3ivQIS}hvQh#wvKwE9MFQ;GDlf8O5$$B-KXbZWi27C@Xu8D=dfneL`)b!Hs@L^aqZnde@qgVCe=mxp9 zoU>(R6n)i-Jm|vFEfEnB$Ze)gBs)D0lU|KRqsNk+hSBGsC6Mh}td!=MtdtnMg_n7+ zBbJ@f5_C22s}ohU`%SpKEX*1obWl;-OMFK1q`o3=eKj^^GTSB?G(w{@*tRC+`pE@y zV=;%m3jXnSrwf0VgZJJoA0?BFf51$)AI50G5FKXoOgvf!R;gv3Ba0O& zhQOdPM{)v$XfYZ_O)r&7RLJ-TfI%1ST{5oL&)7FQ)zYAhU+=*UXn;_a9{s2yLPLN7 z83tkMGn9O|dVHw#hEeZQi9xR=bmUkTyshP&x>Q9&S1-PSfDEd1Mvq;g5&AJ+5lI4h zVC0V5A?HmAqCSIL)Jy17*RVMw;8SWUr|8UQNE;p^&m>K+ea=u$4G^lx_YbufzpN)A&~z5!5IL_gt=hofw|>G)|M35KDGXHM@jRE4fT_-pYN75DZmZ&& z*GzuWWX5X`*Q#65ByheE5(nKU=F?MU_%qhAW1|^;DA0I@eZ@B~;|6ZEoIx;EeFiN@xDJzH$aHNo>hZOI zL~)IsJd=5v?Q>>w4!w72R`od-at&cduTC4NLag@v9-y>EVm$al+w_mqnk)9 zI)Gj-esLPBI)^QrEyQRf@K;MQm-53-mmBrWkvR}r5U$H|XQbFnUq zdJK_Zb$L)lOwSP?JWBLBB|fJMH*tZ9f{eq}H)2xlYNuTh z$Hq)E!;@QgcMtO5?c4zrgq%}xTk3P6y!W~6M-oy9cqcIV8T4Ab_EuWl1~N@%LZkb* zSnt5A(GHoy<#t+}YL?`r6Ei$Z?e4-gI195DC3n0)Gqdme?_6rrnv$v$Mrl zkF`m{GJ&sX7)Nz2c4Nv=l-f)gl=1px{K$B{WAmZwEm>FwsySIyj;*5?cdv_<`fHpm zZyjS!l6^j82JrTe%cmX;vK?z#HI0s5+#U~()>iEO5?akTO{~$OSGcIIXu{?3;qG?f z@=Z_9$x*T-!-A@@gpdDNPfNE4x66*L@)9NWp6UOlNr+EPCc;t9$#Od`kB9b}VoI7u z)tN?z)^F#U&4Js~OM6`@$IBhTD}&o5=Pl z&K7rFHI1rdwworoVbG4Xu8*YbWM&lbK4|Cc(Lzd`Bi*9t_wQ4rkT5JQVAo0`s1w=v zpv>9Qa!#Ho9SS4W8AwRa0l-^xnzz2J#~X0Mw->(86@?N@{x{f?9Q>5f-EQTqwHSB5 zOlY{C_@!&fPaOAsm4)?rot(UMhIcA_pfr+O@DRC5rj#=nq?lFgSg+>u%NIFZ9tcg3 zG?RJX94-+}%h|Hp$H~iuyj2Q%qlGog6FFrIT-T?wKHJX8(&M~&UK+ZdW5IoK?nIaq zIlIgG@K`C0*Y%W(g9pk%Qj@vv8*Gf9tNN62Ri9>mAn%n*Ys9j00}l)@H|E28A9PUi zNg*XpAO1jBDmnTtC6W?T#s+rYH+4S>9z8~bk`lWeFZwYnJ1Ihsrmr4S%tPkU#YR*Y zT9K0in}iicR;^Cwc*!~TSIDR$%&f@C!E$cId^h8KO7n&JmrqIN*xPTg=du@-R!`QF zWqfz@D%M8co~IAzQ>v_}5UDE!0>Ldou0O+@XJyuJU&oR;&b=a5N^_3H=BK|y<((Eo zAP@*{5mG`rnSU(ATHVW%jJZ9TVj+4t1OkCTa3@h1$<0Zo`>RXXX5hlT8Dga*5C{Z< zX`_nI