From 78ead1632313723a925448600443b9f63b47dd7e Mon Sep 17 00:00:00 2001 From: DTTerastar
+
## Main Configuration
diff --git a/configuration/settings.md b/configuration/settings.md
index 4a0475c..ed903d8 100644
--- a/configuration/settings.md
+++ b/configuration/settings.md
@@ -37,9 +37,12 @@ This is a beta feature, it is for the usecase where a device fingerprint doesn't
## Calibration
-* Rssi expected from a 0dBm transmitter at 1 meter - This is an average value for your particular base station. In order to figure it out you need a beacon transmitting at exactly 0dBm and your ESP exactly 1 meter away. This value is the base value we use to calculate rss@1m for every beacon that doesn't broadcast a calibrated rssi@1m. (Basically Alt/iBeacons and Eddystones all broadcast a calibrated rssi, everything else uses this w/ a correction factor)
-* Factor used to account for absorption, reflection, or diffraction - An average value that accounts for the amount of "stuff" in between rooms in your house. Use a higher number for dense materials, lower for assuming no walls.
-* Forget beacon if not seen for (in milliseconds) - Specifies how long to retain MAC addresses in the internal tracking list. If a device is not seen within this timeframe, it will be removed from tracking. Setting this value too low may cause unnecessary removal and re-addition of devices. Default: 300000 (5 minutes)
+These settings control how ESPresense interprets signal strength. See the full [Calibration](calibration) guide for detailed steps and examples, including how to use the RSSI adjustment for receiver to balance different antennas or dev boards.
+
+* RSSI expected from a 0dBm transmitter at 1 meter - Reference RSSI for non-calibrated devices.
+* Factor used to account for absorption, reflection, or diffraction - Adjusts for walls and other obstacles.
+* RSSI adjustment for receiver - Per-node offset to align RSSI across different antennas or hardware.
+* Forget beacon if not seen for (in milliseconds) - How long to keep idle devices before removing them.
## Misc
diff --git a/images/calibration_screen.png b/images/calibration_screen.png
new file mode 100644
index 0000000000000000000000000000000000000000..9867bf01f15deae60c47c271f48354e9557df3b1
GIT binary patch
literal 141248
zcmeFZWm{Wsuss~SP^`GLK=Go*i$jaM1Sk&0U5h)#-QC?Cio3hJySv+e)89Ft;Cc02
z*9j?v-6Z?oGjq?ZwPr$qjFd1E0v-Yg1VR!O5s(9cpdbn5B2Hz!As3>^k5Fk&cL*
zBnae04gz`n0f8QXLmqn|(C@Dx(18{R#1RhyVOu6Q$Z`Sy0sBi_SOE0;_Lbh87X=)F
zvlW#Tgxg1i0(~I7dLO(7975I6ma_ZrOnktvZ#PUah?3d&z#D@^1^B@Z3rEZLU<@UE
z*fRrrh%X2tvZxhW-76JZL3k{Q@m*IMApsSn6?JosJ%*+M3=D~LQFG3x&00S&WCfgJ
zkQ*}-sShH5_kATzD9aPLtCR@Y*|CBZ
zSz|RMi2vuNJT;$CURmiSmg6N?@CUem&**!E3cp>A6fxR|A^M+ZWlnf{lK$^YB7Oev
z@tZCF&kp}Z#Q$eIFrh&c(RNOV^T)QiN(;Q*^de$%us!l=oIZZhy5T@FhlMgm($Yb)
zH7st6w~w(b)!ok_vDs*$cw0bbrNrlVURwJ;V`TQ@(ENRmlZMP=hRiZW(|sc&z5@e2
z6G5VSGS*b(`gO3zAy=n0MPJUW4ScpN_%k4RlD}|gs>5h4BF2n(bSyOEb&-j_Dz?Mk
z{qjJgnjxX72&_B}@CR=BE;0rN9RmXhR51u*IcUHg!H4)1g>S`OoOnirxOpSeqpcUR
zL&vk+5JFnVqZ|jKBEX{rNhXI;W?B#e1-orf-E(9ZLvKTnokpmwr?Ww)SV0}SX-S#v
zesL}aFJ&`F4`lN?rFEmVZ#Z_4;x)2{32Iu!&)2osFZt1cp|^_u;q4X!i%1%gZNd-v
zGDoqtMEi_6)1d=FWRC+;1;Jd1)HEj=kZOiuSzdFMh*9>(png%H?!CR3DH$IXk_kJ-jLfdXDf9gKZk>aZh-kCFz)?3ibEkvJCn&B=r)Mb#t63T~!ttDmpMADj+}Y)P zzcI5FKC3m>6syAeIt?{2ap`*)&>f8DI9CONHe>6Q%>o9Gy*rYD-Zj`!HfC^4sXu l&;Am@# zGoBV)CZq`23+H5#XDVF7TvHlxcSP0JbHd;>#?_5mcw$C+;7?YF+SS(H9c9&(>vo^2 zYM->)S1n(uR-R7@{=(Zlw6DhT4iQ@BaYW!w<_|Rw6rpr<%_28*7K$# zTd$8!!eWQ<+lvz6fN0aUumFaCoag3#Zfd-V_nheRC6bN+oB^=UEKz!)3Vd~%i1ChVKAR;YC8kyP~l StX>Ig})|83WUM(`n|pvtZ5qMM1P`A*L( zsVIn&vfgkc`}^(zm}+?Xlc#ou_Ijp GzIKjp2<=+v|Czy z#tRXu9Bz_t;X+05`CeI92oUJ3OJ ha zjZ B!u4SZe{SzH)aVt+KR|6EzcE@XR^jU)<|l8owtAG z9Aa{QvCbsxL_Z)^rMZ)y(2@g9NoSOglk6)coSyMDS_w0&fV7UgOe$3v;N|R@YW)W2 zH+EE%!Q0#{wCarR!m_|9+ k{j|(#{q4 R|$pBYSF8iRQEPVCL$j9TA9vJo&pRmoS2tJZu2wF zK0CFUDR;(@Uz0isMi#PAkZnacv;yvrEx;4imhKMt!|P(7-j3(5RJzPOcu{RU4hGkn zoN6o2rn#csmIGru0g;ArfDI4gW1M7Z8;2J490YWu^NSsUPY45_C;4l287f#Oru`Re z_q~;8RQtM;-7;?P!^w>Lea)p<)zHuoaR|NP6=4*MNgyvW40pJF$QL65QLaU#`wb}X z=HOIr&8wX{-_!#CzG|RQH#gYb{E)P;qE~AzUCzFIp9eNe2f!JiVT<3mR8>_~IKO_7 ztvB!#80luGx2dSC{672Y{yb
JwJ#W9u+PBKknW;p6mYo|E5Ah%1GJCCbBn~S#jE%glw`mAz2}WviBa@n~-Fd z%*ft*Z}B@`=lS`4e%JN+ey%^R>(9&0ADx}5*ZVb|uj6 M{kyh{4?K^+D~q0;&$sjzQhVd0elBHJ?@9p}3} z2k+~JM$Sv`Sq@vb*sfJgk5ndXuYWurBRcWOjeg$eR1HO)hL0Wo(A2Os+cA~*{;?LR zke$Mzd+Z%O>hJ(i7$fDsB&ASZKXw>!Ryu*gpFr+=L_5uWB~OK#d(t&b*RLof*FK9~ zFrSbmm3D{WBgYc!8rhb)tFgYV>Pe;TxU#A`tjpsrelNACUTRdz?s(p1z ZdFk>xVsbjfDm5jJ!TO@xxQ%S8J0K6G{8EsIq)(tDR(E3a6j>JJ=3AnGWor zcVftdyzitbCKD$*!?QNr=ndyEs_`>noNMq>d{<1;K{!4czG+nE!9Q24s}G;$V}Nqr zmnDi&OB!UZ(LMFE<%(hiW0cwj5v NT8P_csv3jf2HG31gGjT) ztAUDlR%cwmL|Nl3?()dCTcn=GqkC^_R9$s(q$(hn8Jvyfi $n& h7pd(FOsMJX5&3G&jr_Ex)(?{o#QQjCP)5gtBRb_YY?jG7z#Wk5> zPx>z3U0Kvnewx+#Ae{{~dS?AYCa|6i=d0bnekDEK$Zq|MmM7=3K !BKd4cyI6?TSs5Fj0GB8c(0&W0~)an5kbp1^z?>=wCI?`uaUnvHZiSyy~)rvigj zh+wRi+VDzER+jOQoHwK&-!!8zfB9KNwZ4avsy9qx-(Gr?Z=wtTV8o3GYE7qUp00M% zk(lFzNeFG$qvinNA;I>ENeU4s)B>NWpuxe*x&-xtA=kTjAu Ki3Gd8PW$fHD znTblVgNYi5V^jhHI!hg-U{g*n17p(hLNyLzR&=h?-u>VS3ag|ExUKIV{n1tO^9hsk z@7B1w-TuigeJ!y(Izv+AxoX@uh8oBAEtptT409s}OOP~=Pse5WqwCgGKA196u|K38 zr_~ZZTYl=v@uDu*bK|t=F5fJclG|3Y-Y2gS)Xx0;`XjP-cvMj5RWV%h*586#4~I4# z5rv}`kavYrp6Xq$=eLAU>?@Y5xqPg?f)OnP1SohF&dz|XnicD@f_GZ-#GlG8FpSNn zd}*vWSR2qIXmCI3jk5zarf3Cvq?siypBYe&Nh%efQqinjWG&R*iz}Q7#6Cq~;oo&_ zxa=$7_1eTser>*F#%F(y4Q@|=DCb{-q3+xA-Tp^tBZ^%Dw%DIL2Z$tbyO4=^Q2zij zFv(Z@4R%z@k5;@c<2<%w(n}3l NOLBRI-n;zc+y#iED#Im?sFtcm2154vrO^?4e#!sS<+ zdSjvS58-ghw!HYSfcBp8T+-v(B-XH7Nfk8|qYeD2xEGU6iUopDJf&chqrp*Dm=AGo zxvhXK+G(1tfw6y^OOlnzVrU<4;wrKPz4)2f;By2eIos6DJ7H@p40>{wdsFqLCtDM4 zm-^-QP3li>dRyzHx `g@S4N!GeOBQ`WqG QaIEJzt%-O@mg@(_4L8t*^|sK z^`5sj73>_>(9uY+*X8eth?(-_BKO*Eu|5vS?)@ho;OqehThU(2;6yLlo~gnsm}nL4 z`ae+!(RYOUbZ6(xHYgjKiNG{}5rUX4Ay?A4l8}N*xfAc-FEd6OGYps-Kz~hY*7#J~ zl3Cj3co?-0(-5#l4U$NI6mbv)8R){@!rD4aX70^Ok3;0U4|_i{m|p%hFpgE8{dSmy z*R@yfuZ?!~!Rl29d5 zH?M|`!!f6LZog^C+*(v07?&%{rhn&PmDKF|lt7{kEQnZ*^(0&=t->%lT6qLs9IxFL zlBk8|bCwDD&i3|up^Nfj9b%66Q@Y^-!6_4?BV)yk{Se3JwDuEK?v8xqP?4jzwKi9K zI$yNJgfNH|vfSopyL(47^O`dD+Ir`Ie$+|gE1iH3>m5}F)(T7&457I|59}VQe_{$^ zrmksul&)~4#WO$>q%cl^$a!|rvt!m@7&$ou26n?=xC1l^cB=zJ&1A7G@r=K|P&J1T zk~ucLCV9T;bZPMe<9M3vgcS`wB6^*Z4XelT&+HdrtH&ofzoaOz;K|e6nZtIpu&uQW zs)hHpFAY|9kbC@~$+qd1ENul3O^j>+zy{yk-MUM_IKS9;7YiojCO8K1ebL1i-lN-R z%AC7JrjaK^Ilin%4-ajA7PzUmD`Mry9PZO+75E5XpVrI|Vi&;Mt$mL+BTS;zoo|iZ z aP~n+uzK)3>|vc zLNOcNl2OqG_{=AdOC_yJESS}x73pxd+xl1ye|(Vjv>@BnVLBAupY)`*PW3CU1KrGd zmL;sD@6-nZ{16&pgGXPix^DvqJ 4W3znxxZX{H1{QNcW9_*mUv(YZQeFuI|W#^L% z?4{LutIOCuyQ8$ aiXZ7^Wr0V$uBGon!uIiksB$V$Fy+lGKbeqx{T1i<;if*okj9GY_hAD zOyojm_AhhAzE@L1|I^1kZprin0cTZ9Al$}vDS)>V$6ANy3HTOGhJu)SYN;w4t*o$Z z+x*5q_Z9oK*v%{FseXWk3ecAT@LNgiS7Rl+1PI~oIoR2KZRNu+J*^HyT5{uFGAQ;D zHE5UL>6SGH*+^)sen;l8+=y4!b4d(XRnS3he+DfHPy%U_Uyh+mGkknGiSFk->tPsh z i zHkxNk>Pfw$`W_2t4F_YPfZn}+_hk0$HDnx}Nhl@fg~+ZRa~u)_-N$fE{LhH?Uz_Qe ze(#QQ`pr_|TfHDMDG4Vg=7a^$*d6qU8t*x7auK%>1UI3hPV)=nQdL(6S^ZjESD)E% zW}5L|`PARLb%9^8(!ByUqFZDnSXs)!AvbSs@8@3O8R@#SrF{-a-|d%7e-*5!;1v8- znl3)sJY>N|mGS)6DK+V@RV&q^S@a0TP3<-U^`GU&5|SO1+}x;IT3We(wV;!Oy+f(J zmzwWNvXGpVqdX}>oW#VSp pIp1Y`|Hu$BAH*d%SF^G>21SJyH403Af=w!e`mG9=BY99Tj%u;owZ7 $&0{3$PAe&TVPE=vVB`D?+O;<~z53JX=?H=l5Q&o8sAk0AhL<2qKvV+mu P$_CM@DG0P@t7+9z<-)px6W|E?2^F;~~+HMO)v zvy?^iRK?&s?XUSisPz3EkFLr{sG8Yd`6pFSVn5|4x%Bh!|L;-OS)NA=G7^%zVCbOa zr{&(7f+S#P+GX{Ge;{F5+5pPyepy6fala+;uif8L%; 2XVqe95} u9_82j#wHC|+~3 z>kaI>11%9*J+5d`Umw%j^awF xm>tNwx~MEx(}2LIO8 z)rB0(D}R5lw55c^s2h;6-dt2vg!N~dkoZn`z3_pqld}t`o;Hk4@nuvH< zRaFHBM=f`*;4U!uzl(~ph%#qTV}!!sj+fX8LB~M@?~=I5ci%R;iexnK?1Y?fbcm<@ zrHOoeL-_cl9(VEb3E|)SF6@p4le>^NNu1WGNJ*_$<=CRiY4umf@(FED=4?zgx_QhA zcWx*YK;M$zfaxtjZln}CLtS74|HhN1V~9N3npJdEKlM{oK+>1G)mT-5^teXKMuJAd zdCN!Hs?i$Px1=KYFpy?$q`zag)+eN-1?wExoP+!t5-ukL5HZi49E`c!P~azxRZDf; zw1!f<`)9#ZRoaOLFWjl{B%3I6Fr+>|TO5kjr%8XFp~|=ewx;LD%Xw}lBUd-4|1s41 zXAwmp0Ux Qi(%vs>UvvCJ|72zYbfHOdok**dwBOpGZDCNoK%f*9#cgt%L(EW zs9O;4WyPo>IJEM#k>0;)=%PW(c^zD#`m;HZ{M}5tz4Zf~t+hW-PWJr_ePVp;s*LI) znXvl}7=;z9al?dhd7>Pc(cbj%6v04H2eeHLyf4UA8Bd;yLn~Lh8|QTFJi63g^&3vl zv)%mwN%w7eXbMKA6u!RhH^|UgI&806SM`P$MQ6MNcxpc MHE0SCZ zL}!OzpojRIYWI7hw#S9~t7(lA6qwI`TKLZ_by|KVyb8)y#l*hx71WZ-E_df6m=|H_ zxc7IxRuu76VS4xe-G|rBAf%g8G@7hPK41^>rB1h}=i PfS@ zwp$gjM*;dm{N?7{F|OFuw`0Tu!;{6to=2%`l`NfOB~9Cc$f#LvFRZKAGot%wMT`AK z@1@Mr*45La)&kap+Xt>drA8!q+?;`lA&tLmXk3wK_hOjj+`-x&X*}1?P`$h;F8T9~ zl<|r#q(9lt*;*k}%u_8Jv*+6bRxr0v@q6(CEkq+3`tt{L6`-R)wGAfKL;M)i7ccJ9 z(%y_n5o{m!Ig;k45Cni(*mX$_>VeXIT1v)pq%7WxnBsO9JbWp&pcP@0B!M|zZ8aVc z`Jn03e){bd;L?=%99MfJm9$2vICo@0umVEtYav5M@9_AS5QAYEbU#6%-)t_Yyh*G< z#Vj#9P} b=1u4H$5BtzT#hTP4P&hz zXK9E%PtPs1Amou_RnME b^k>5@Uqf2N2nfre8J1>f@xd zcenW;iBK6qoep^pZi`e+_fEBH&qgJ(LVy0mdQ2k+!4(L38x{&+%=|ooAWlTj%FhXj z{|ji`I8XCjUO}cEp@oIyxW@%y7XN&1_IAoUv$8L-@K~i!j=@$x#oZdU^z}i1ksg zAI#%04cAHk%~;zF&Q1cYO6){ZCc}%u9W$`qELS7XkM*ET_4>LM(8+TEb(WPsjkDs4 z m|mc@~?YUH}%x(Cr|4W8)X`)_iE9kDousgCmHHG;BKg0KS7( zQ;H@`7*|U+17$&I5nnsb2TCARhO`EY2(5<`Az`K4pp~5h7~rRz+d-i`6JD9qRcuFW z*Uw$7A1ydYxx1qybtW0U<<6Se<|z#|?MEjqP#O{MWTt879fPHGdU(yr)Z5+#l!uay z4HKRP+20P1=FQG1*&d2{P=YpkI1V!+FcUb>UQDn^NVX%nudsv fMwhHfZFlmF-fXo;8t89z*XbPw6CVePvl*_ _jhpGQDII#CBuOCz}I@W21+2I~esc(j{0W?2n$nX+UN~KF*sX7U_oh zn|7>vIJaV))}F_|9uO%yz1o|=Emjmi^pw3(7mRz6%oHLP*L4{MI+MebiXMLTJffLA zeVMyl?H{O^KH`vMqSzgk-KYI_|Lxlb9}m?czZnBBtCtPnAeh@CJFDoLbn`-q=QhuE zX@EfmFQ|+PDUCtfL1sl$2rCLxtX#c%^yIa%+c8NCTezPqmefRH5(enaXww < z_STPm) znmrH1L_F_T-mugRbS~OfZq}!rID{=NF384$$XoI8@Jtlv`se75T}DK8o7}}6djtgd z(gCqS$YM_O!OzPJ9>nCqVD5P^-;XbN-J7~@ginC474&)Fg8hddCJ+n#sj0a}%4?7J zBqBxhrF8DH3upvDe4_$96{u)ECrnAO#HI;Cs-HOd+!Wba>Cv=ZKX*P5!62|i05KA& zhp&F?T4J*!PL6`X=S~hH$&m!G?kH6&JRK}h0f)E~qx~n16sV36+#0T@DBy3Me+ILn zDcp}%Z@}osf53zElz>Uya!Gi7GV3a$BY*%t+O&ppNWq_0`5n17K$x3UIdNvq)+Hyn z3&Y#u1DkDL?(ZKQrYuko=9S-hQ2zLx+u%0q^z1A%u`n$+Ijs7vd2lpbp8#W5YPPW+ z%wGu$_bzfu25b4~+f)p`C1VNWisd7~%?*J{t?bhGI6-S1DfsEV@y#UUh=3u9zoH$i zER|i*5^LvrU@O@fLJA`ERi>=ELyV#SrZ2-)Oj(1!%D^KD^d+MHfy6>6j^T3+E-5vw zP}@(!<~cxBqV|y0y0|gWZhqAK{E ^>Uv`HpF0aDqSZT+a{OVGc-c;B`T+@0J(Q zfA# ZRqyo;qoSjekPiAFXIaXQTV_@`BH3F(_^81Da;%5ihX z&c!}i;rRh;(Jqo7A$-4o`Ed{pfuMnq(ENe>0i-#^6`Nt;c{r|J(~Izi#aOe}y>WSl zwt4#9kA}FRFdb(kcBaewgzLaf?WG>ja@6iWx?{#A&*AeTy6yA=(bI%|KA?t)SPVu4 z j63s%wT0o=)VgqaWf zj2=O5Ma%sNHUKA+#+TtGgy=~b9p7hxIK5}ZcnWf}2=gC8m{bh#^?-=G>pfMw^yq5@ z@$*l?<)!dOLnyz&1grnTN#`y T_OsVqnHe41JBf=`Dt4XmMcJL=5p3=`J;I z-^v5pue#M SM`7&BNM_tf ^()@GO;WbEWV*mg+j`8f*At(f zR$(CUYSvBB&Y=i<=}P5qXdq0I_R1Go+X~UTx4-vYMegx8VTpc5bbZ8?6G1opeKYNu zd8r9tIv68#o{~^yw3!}L tV5$TI&ghGQgaFY z!0G5t9LNl8(Jx32%A%QIl9NH#BL<`Pq_*= Kq48k6Iqk zISGFs2UZj66aE~Z6 ;&cFWzCJ|b55R;GfhiN%R+r&qSZ^fE0eq5ZIsd%k-@&BQ3()-?Y#W7cSO$j3(S5Y z Agr z8#GJ33Kb#qm-iQY7vm+fvkN5Ysck)O-Jf2x3##U;mcGRA(^=$I(&{)Y3T=1@#2DVt z*U(@tmQGJC ~}ItZ`|kTc0?c%cro; =k1l+SjJ@yk{i zO>Z^+xxrs)>kqc2ci`Xt?1B5~u*5oj1zx~NE&rqFvsb@z$Ft3gz5h |G}13b4|}C4Ky8M3{sSSKco~uLpXBq`}f`sh)W>f1X-}?*V&6Z z_AMMO@8I`4b;5wM3Fp$X3aqc*2CT(s`p^{_J@F0(QWOORgmHul$GDkvYlv6q 6uPbUfhlXnTQZ_d;(Z=T4oId4!utVN`?bmB$*F z&Ubn2gVd|vgWty&z>B+FhE- ;Th-<#=!sDcCGWDn=xJ4mCsSPap- zv)kr*GC;JNWU`IcOU3k$3P^6*Tn&txkm3oM;(p_auF!XfVc_<>`D=QaLTIp|q2*6_ z%bd)k<%nYe#JZQeQ+r$+-G}pnMzORXtC*$nImZD-?p%tEBWYe3;WEST7+ibN?JZV@ z&UPOFlPcvH*7Hk${H;R1fMpkbXZRgv6TqlN(|#077Y*kkpaBdSem8h2vOn9t&?!j` zZBFT1c>^g2zo^%N8DTrDXWjElW8qd Q6}oaCJbo@%8C& z{=n@~N?%inn6~7KXd+q?_4(*5g|G$-mB_$V@ocY3?|9)TY}V`Eo$xnk7ReJ$Oq(am zZ7vwIjn(@7j0LlsA> De)ng&4&CVZxOogb zCk-`=d!FA}z|9Zx`T=@WpUkyXgXIamHQu+uVbKkn54Cs+p^9|7tO6${xHopAc!;oR zC$85-AN|&9pWtHM(rJ*OLn|(3K~G78$Dl27i$Qr+ZeE66RjxQBeC!1NFg8`>F9;Xy zLm)y&Q4D+c#(To^_??fH0Z(~*awu0ssay $KA}c7O(}a(4C4yO3d&0jd6%^^`w4s)Y$^GU1n3oG$3KJ?pGL5TTp*Yk1O&E zX7o)gX_R!+qG!silNpJ7Tn_^ZF#cTUv9+XY?76&!_2IIij;jB`eH83_`@Y6u(kPIH zNjN8k(~@b973zTBZNDAls&lZ}ueBSWBsapf3mG$acMj-2l~)Gbhja0P!^TKv0?Lhu6XB!_K&0=Fv?9zjV97lD?DC^z|&oE5ix*=1ojVUC;F4KOM>) zso;QGl&2`z(|R`D?Nw?yWvFBgyHC*fcR%|e5grM~{I$et4K7@HVgYO=rAupDOUnYP z36f%r-~F{Ij!wIV5W gtSIZA6l;5}dKb zA2G1Mng5Iy*}h3Ih1_HV0EqWj@p-RakqY}ZcyBt|LSd+~+?lmLQfYQgZ0*idiKD4= zVb3kDLHZwpjn4P^S^IOCbp=AsgtE%Ml>0RJPD+t*=lW-dkpxAB`)qGM_8$+)&HeBo zFL5nv2~DJ$q}vbFCmc)52_btz&mi V?Sp3U zuE$FsqN23yPp_V?ZRt08jmJg}RA&O%)p@OtqUorv#qJEs_InaFt}>HOxjJz-Y1o5| znRRq@0Q_1NvO$$b=Lz&WQPPj5W4IA;#lUCBHy43F)5}1knVsM<7(V5AA6J|$QPh1c zm?#84r@fX<-!m<+WpmcrnrS-B_s{goOz}b7yW=TAW;g7^^+_39d|9xwKyF5GSBmU! z%S`t{0n=2|5tgJebG>f#eIIgJlNpMS5pvY)vE?a@qodPvNA2S}tGojXfYY+ZQby(d zvvAC<&(oj0&1C9O2EK9m+!A JL~c&P0916Ad2`Bwq{t<}#C|$8AD1*n34ciT~7N4Jyrti~|P&v>GkC z;*a&?Z#|4FhMY _;HyEE{ptIvIW^=UshSO5H!c+3i zm-gU<;Ez=FSLYivy#&@BI!m585EXG+^R!7F&KeH7f3WV#3bbu=PcH*yZF^$$9 0wD%5Y`B~RKb=w_>iU{zka4@L9-6YI^1h}X_ z+EbFwam6s|;tuFXj1MXnAYQb M*Hr13Iay=13|FvMQ=qFSc*)Zz zo1jnI`K6Ho;;m9+63PcTty*V-Bae{5Ks_(i7F|Nd(P_Awz5+yVH2WcKSv_@_II QCYN%nW}TZO{m&v1smrh_jssP zBsxME$lp3X6<5IjQdaEFg$oJ3A^DC-a5S`7D6c@G`%z&h&S{~E>$Ez^>G}}0$46gA z=;cshUcF20xrJ*tNpX#|n(4^Mo`Ps44PInNdw0E*EE=9%h-gZ~L&k2{L3kkNw(B`H zFfk&L*z?Hs!ZKBSTu$4hy->GF!enyzoO(z_TTCo{@&!%p^XGF&1`5O@ODo7oT39ef zsVGNAMKP{YiV@`zCvaJOSk$bVXVZN0)$_M;!}}|b=cIm8G$T&c2OZx(1847T9iL&B zacZX7%wjRT&8WQbfI<1Jb9`K7xCSly?vkvu^iQpFZVezlFAE^ z%{JH`SDK@O_+Df=xTCVf=J|~--SKt~b$sOs(Q+c{x09feY&DgBt_L6uf&o25QqJe^ zsFdNF`<^7j;%%qGlAG7s-<8>K&~F|ASn2_Ja`Ls0X^?%5KFFHX-Y`ero(pwR9^Hny zr#Wnyc!D|EStRRJsziCDN@!~AO86Xq)@Zz+*}r_W;R*RE;ef6MR}BHAk?Pc)EhS=H zSEtIYNXeiih@*&mBqpD?4op2@Wt>vs32Eid?Z^n+opN=&fGK%x7_&E?bMOT3Mc*DH z(6aV-ZCTwg%|XsXf^kn;O)*RHMmWSfpYBE9p#5fjvGy0`inYxBm`t^<6^FP-w*9jG zrDqd0ACKKutOolu2DtS*x@8O_WGI)=4D!ogL&t;okgB&P+YVmUOSy3AzbiIsa_4eG zy&(=Oo_cH~hN6wb!~cqD3hjXCoo a^Un6A?y+YoNqi zK7V&Mw6q0E{3E5U+FE#zwtyvDdten3qshi9+2yVrmc88gGzgF3lLm-SkIqV?WT)Y_ zeh~Ujg=SoH<=#EXly8@vdG`(9zJHIG=+c2bbSiSWY^{2 v_JF*68BR9ewL z?{?zxQ9;T{*s4-zeI4)eeh>C{B^pW4J099iE%#SO=N3Lo&c?!X AcS3`9n7j&Kv#87J~#0>Qx!z+l$Ll%K1dKt?W)4lqy1_ zL@}zk)}8!K-w46Y$o&Cqx=L aQXbVP9>nLo%3Z#NRWktE4SqtOP%z$!qDym`=DM$e~`0%Rk!Mu#f$R(`oXO|OSZ zIRoJK)0u7R&$PSR@6ZctLuIj?DNV8>wv(( @6McQJo_@2?$AVP&;B= zNGfl>c^_aINHeK&P4u0vOSW!mRLIluZ&Z$re{GJ{W&c3Eufjd#;NWyy?STQOsdAbJ zyE3Dk)c6aH;AFqdrr3Bfy%g=c`<>(IpZh_`3$vIUhV=)mA94ljN@jOKKg2#vOp}9{ zHWt0x82n?EHa4-=hBo#F((LSS6{CuPEUa?k0BRY#t?Bfd?-4m5*_4p5$Mlhcc4V~E zq15S*J?}z6zj5E5tOkB~&TS=h52>zSZ+?|U&k|w4LAZi`OyzM7z5q#+Q};54P;JiW z%~>Jg`wS()(k7;MDp0%<8x9Y$1ti `+@-LNU9gD@#4A8V>3DQi yYytQ1JG)nB~8d6NpGe$DEgl!h`ewhOu*Ux!=l zKJ1*(p=f?|XBaHazkI_$aQF)}0H84*UV|K-4fxmGm~H_;IC!t;!g}J)V4fa6tRZ(R zS?d0E>3&kj55R)OE`k@M3ERg@(i7Z(9QdFpQYi_kkJNOcN-}7= vCsZs9orn2@KG-MBPQ=mYsqU0ebpyl+k3YhcM<`-ZY3D7PEkS>;)XGmPtE_$E< z1LgITI}a}vB{4kyB{HDBix!{mI!MrLo}uWB`;_3anWl2a?RLq% =gJtia^&JXfJdp~LRr{twyP?u1hP*sC2#Af_0kcfBQ=Iq0*u%~} z2Y^qtg)#}Lm+A`Fgim=nd#HUg%e=Ac>T5qwOyPnr9A%z*Psrnf-P@p9&5;Zfg3e)J zSoFC@x9(5{LKVu2pR$$iM4_UXc9fAwGZwGaW^Iy8)H(jRL5=#k7E1#*9=HQOCmP}l zKB3+*M?f9@AcA`Y$3dUj)Ey0vl{>e-Hn|>%H1wb_{rb{QA9I=scKrlBo_1 ` zr~ynZ`v4(Zk|r& O&dEU&|Rk9wlKu#=7xdb8C#N(IiYqUC^C* zV#xj?juiZ>>1!%rvPw^1pmFAsSe4uZ8DSN?N}pq{1UoxL=1;h7H8nV_{!iFdn{T~q zoNXBrjS*ii
p$ZOEd{l+^ABc2?B>2oRm z5( msTAgZA&tE_#sW!7i +u*%oLV=!AUHcZ+zR8Ze+eA4447uKZ*4v`=j0K=XK z^`=DSHW(^Vt9qNj@ixx=#_>$$z;yP8S^Vt68epB;lLjrsCTI*XvXDifrV9I6zOMaV za1(D}s>UgkdwAaLop*uoe?~1$dHWn|dx9jZ#|dN??MoC0^Jl@u{Tnry1w5Whn16 zD_hfop~UvCt{Zxn1`lYOpX#`D#eaueu_C;?{KTF8T4ue6vqS%sgg6Yx1szcBr5~O_ z_A)kYHtdNZ!eZe6H&x}Nvprt-@YrdCR?y>cDpX#J7d<*!rJ~pb!eBY>{^bH2zbq-t z+6)_ozNFZqDov@nDDQYSU@v-$TEr7c?CzUn>kdI)6{}7CIdO+Vd$3AFSVXV|)`4fA zfvrk@y)UjrM@`z&j4 YMKY@J>YuxfGJLs8^3YMkz#=b9VMHMZ?FcnpR^{ zcOIw(aQ{PwzJ}DXA8vElz~w<*A)(foz_k;zPS~nXwKA2(#IxN;a@CO~0nBBP_>-YF zM*~%=5p8b^01+#N&l5g=3@|VE`2sc-?FA%qN$7?W*RR3Mre|G$-1P|HncoH;fOq?H zGbU{4TQxcCdg80+foq8XRdZ{$%^eN*<|^v;V|PKq$ItHTh<;>;;|uXe=?)#v^bhmh zR0*AU8VvVtI+~4Wm&qu=hw#>}R3EMw_{s6eyUSClHqGexYf*iAnMLxL(9y@UhMzHW z7N?0>A5Q*AcP6p}kOs3h!x`t-_ZSFnz_~16rr8DZ5a~UVdQmgdjgTyA$px@|$R57Z zypxrkZ3r^_-&BsRGNz?~i$x+bm-?MjfuJ71Yc?5AM{r1dh3XHUY^A6d0?v{1`VN zmLJ@aRlxIO>BJ^#pr=pWXh*TY#D#8By@O3;D=_8*`wWTdr^rpORWPea)aso>KoX(L zNP|yYfYBqk4EQ+@Z^c~Jc_vRT`ozn7XPy)Kw5h*|ucz##DfM6yj{zya#V-YRQO% z+m4or?_PZzr;xSet)_{*r3Sq+9CDmB>y*!$8tf0;`^z^R^!S&P`XH4zcry(41qcT( zzv>b%k4?zd$mCGgcZ|HuO^7IftswffLhE6Ld^PK#*hzCBsIMi}+Xi>jqoY7Vx9`;; zs!Ss(%caUEE6@CyGpv02Qt^sF5N=@DdFOrDss;(zgitS3baDJ2xYW^Zb9F0cZ+2bn z>2Dk_NI5^>9Y;qz!2&uDKfXTxQ*A&P1Dq1##;`jJcP4ZJd&K{yA4%%Uqm6>ymK|Ii z2xAB}qLWL6eGGQ7Vsulyj +HW$_bx1a34eeqD^zcKlgM?@hxOfXs z4-{crha9s+r1|TTJ!2dF %?oB`McL+Kan zBLkZx2t{#0 5h#%a_*-0C1TEG-;Mm#-l>{oA*m_nvQ9Hb!oy9#5*+%W$o5 zynny|Q$1LEhWW`AlNw*sbo-Ql 5 -tX)-|ruD=VFCPWmIEGh)=p1 zp(rFb(ckd?4Vn*pc8ENE0BQQ-x}JW0U(P}L`O%Pfe3xOPBNfh%KG}~a1e)+_`AX;i zqy=OYzy@LDY6>ycA)wMxmn4+jTvnMUzP;7_hp{iYnQBZCF-QG~oPymAZaX^@!e&Op z 8BJ3UxILg{bClxXh} zsTZAKA$u%U8|r0J=S;( eAy26-<5Bpmze1jR-qEZe*q9r8 z<1I$^V~2`7oYkvxt+to8)(ZVd!1W1kt2M7*f9Cypwml=FqCK8uDa$Ml)=-c>KmT$g zt<=`5!QeHk+{1XTuVs=0j^wP!c2(HuN^n`&Y`^k${wAc+1Cl4opn8v~<^m=U&;>*k zuDHPTY+o#K3NocWnUAv|VH&%rKVZ@e?_pWfo45|i8aBl-Y>-QxQN03rH;=(NEfryE z17^KeOV*>IlQX!P8gXZebU0gbD4NVyhCbB*0C{Zj XZ-uGWu>KGGfTytCY#|Tz zXKS82MLdYrPCG|! zVD&au9D%8l=gBV*sS-=Oli2|mHj6Km8670Nskko`?x6{cw;si7jzJIkyfybeqKo(& zyr_3tc?Gz~U9S>kmVT%AV`lk_3;-rI%bvjthzY~zu-N#sK?>manul$UoQFlWgRTfR zxRRcSUV@W#au;?}`5S8muv02x90=S+1&V^0)JA%X;oR^PpLpwiZ)6LV5DL>&6_1mV z^RjeMs$*+xRdb(Z> 8|(`ShT=J$%DSXM)NUsM+7#l&i;}9k=ND!c+}kUc+(Q* zNPmeYR;X$C{pAHL9X$U`5D@%LOtBj*2e3O-d#{c!IEPbn n57eppINFctH_gDTL|L7x3KQOVqeDAFtzsjn6`SoY!F|s(R|cJRo3LMSO6 bP>2QE< zVr2b5iPq~}i^#s-!@Z_0%id(LL dh1-;w09kD{pJ3m2QVAcXaDFd3i9xtX?O>q zGB0Nb(K; (h{F%mN0qX0YeA05308-5^+oU5y-N3v zXvt9ycJ|1RA2BPX{ACHrj1ATY1~_g3q4r^vH!~|o{Ks`<9F1h#PrQ@!gE-9~a{ai= zM-$JKJE9mNqveP~Pz>@0A!!Cs7Tg$R%qJbPxwD%P>7a2ucqlc*Xi_cndG1FJs9%!q zQc{y_D=S* hssd=>pOAo+UsFqr&HGLeHfrN$L1kmJ3knZ|_#+8P z3=G6IkzlzXhVeTpTICktcV9A1Kb2O!DKCG3bah;zO!=_M34%m`s0L?7^c9LJ9i6MH zQ}nuP%UzS1yFGxVYPw#7Lyb&|!4VM9;S~@_bM9TG#iHy+jQP31o<3PxrwdR<< 2_z^7^-)9zTEo#&w4#=!H-QnsPEBy6H2?m@fsyZdmD8%R8rD{sKx^s^c+S707S5 zd=P{8UrAB=QobD&*rd8E3(PKtGe3v4P2kOlo8og`1zTnUj+(1`SI97yUQzq|W)hOR z3|n-n%7 G@gZrr@Nn_Tuek&t;D>(CD!r71E=vpP>7$N&!N8P`*eCgGzkKdkWs?h zs_qyojU%_Nb5XyWp$BJKB1;t&bEq z`hHc%!@2q9o9tl{G9)p8vOQZKQBxPM8r-C{ozOm&c3;#gOkxOKhx+!=^Y6ktsqIrT z;7+f5-dIo|2_UX&LBsC3k=bBsQ$c}f%>0i?{Lv=MX31YziXzI^c;WaEkFFXz6qf6c zu~plaZZ+vQ^)5MbVKpCNT!&owSrz4pFG=6vt}LzQ|3$+_9CrMCQt^(79)FeOQ8AgW z9v4;nXk}P#ED4AEwben)QhEoMxjbLwfR$kF56GNf+uqv~HIsgno 1 zH~#8X*3^96n*N-Ch~zJ;N1x3ewVJWF8nd@qao5+m|3f)*ML`~`c9EY{k*`#NZ-P1& z56?rv-xJd_Gn=ccN;q(Ls0Fn=dnMeAa(XUCKtRBbVBzpJf8|B_J*f=%#-wMFx_COE z%19_EB$T?h`>L-SU;Cjrs;c+-!C$rW^Q)1dFo}w$6%>g5^GDS`^uCy1BBB&&Mlt{9 zmy?6x+2FK&&|h0;p^5{SGvuTE3*)7EDgnA9srUcFyz`U%{78gk+1bmdm)5R|7*OO6 zF=}Xp=3}BqNk l(jU_-y U*T0%`>l(jAR-_lT}n!)bSW(g(p}PB(xrfe zl(dAPfQlg9-CY6#(hbtx2zTxezu!4`+;RVaJMP&7#z17Rz1ABup83q@HOEbSatE=_ zuz7vkE&cmU{XYE)Or3pk_b%Rj;o93LXCBSpq~W9N*4>ECJUnlc%x|uQiz(lQOUo-M zg+v!Uy^D)WmoPOkfpK0Vw6#B2uer3avVz#Muy*;(V{V#f<5_DkRaFVtIuJaNO9@XR z5iGE`msc{ZER}YWWxjbc_%;y Y+NL?xOy=m72H$2$=&0$bL!Pd7BO z4 Y~QVaeVol$_|r!EH1-`k72SRbHA#u?>ME^ zzb5pm@xY@(iM&D06!9H3!sqIr+t_3sej}H6`!KLJ1 utq5d&gXrh2j!^6zmisk1lsmDv?yS!hLp%TM^iwRF-69dc~53rUnP8@eS^M z!(*VQmw00CzxFazBGkXn5&LeNKKbQJGOze3;>{V70~xZA(!0onPp0$SndJmhnav9Q z>_(C%1Lno1YQlGfCizrVqb?txJ}A5t6Ju5KaTcyg16yLZlyv7y$A|52;7yC5Q5M}JjEhb$-OuRMV=I}31$1K+;0idRxnGUVuG9@M%;HTd}C>?-Vq4%u8? zmZX25MWd^;6M292O{Z*cPx~98+Pc9(DttY7kdC~_AYpcj=!ucbd$|EOmW5W9EvTu` z-7KQO6czI!IQ50yiz1kPnjxBh)_ -98k-if4I$fj5kR8+? zBzd}Fd1B9ea>|Lgyr_9a;MVi9%1X4aMu<(vK2|P~*#l1}Uf^J_&mQkL(9r1fN#&cC zw)o}#%6##Y9v6Q1X5cAJ)F4Tf(k>`=2e*-q*9c8+9q!sW?q6Ov 0*#!C>E2=A(Kced#GS4^(re1PCr1rl#|8_)A~#w%jQfD4yHY6fX9kRq!r5W^sJi6 zMi}OQueLkn+FtS`(tR;KApjnyPLK8D$B)l>o-v;a{j k{b 0DWOU$EE=TTve*Vumq&hlY4>Z3TH4*}S&GYk%^}WOR zSI%qTgua{{yvx6e5Jdz#nBaFI`>I=Uyr7tAFiNU*5oeb(6eHbR9Uz4^-A7q?-5(Xc zt&PH3!Y uNnt(yt6&p*;$;sEW (KyZSX1l~Q z1hto))-RE0T uee8X!S{OHI>5fT`Ut+F%qt-8(RGAa*rXec>42g&0vZ@=v-EWVrXpVD}+ zo?0;K7Uw@+jo)oPJUWkSe!JM+)#0??dTHAz3c%+_TrFJkGT{hJA8@5$PYvsK^emiq zUi(!%wdfHa5Ap*4yyOQP49CQ{plc3ACN?MH!}%zBxPjh9@{O%SWLrw !;cBbeS?(f%8%6%$mJV7Iq*51?yOJ~X=<3eX&bPWaaVRH2kVm 42>SndMXcso5J!ak2?#^$ OX8RLzTExqqv_y&`GT(jk zzI43oQqc6ry8hZ{G&s!KHE(zE;XJ`NGCYa4*o1`YH*#^_@;N@n#w7&wpI>vmfhIEM z10`LSE=$AgX4%oTrVr9}F -F>#?!P{Q30nn@(i%5=lswyWwBjCV7lTSUVwb zWx$j;&7Y5EuUj^VR|)URB!%!ZXqP=LEt4 -V05v*k=Ax=3vHY)oxG*`>{?~> z Tzm`@-B^J^`0Ty@Zk3#g zkgvK)A>#toQHMmAR~UQ=+X2ncBp6v5pM`ezP&iK2bYd6pjJd1!C5QYy>1YqlZ!mlw zd+o!rzZCx(_(a6aiIhAIPH(>WUUH=Qb+_rayeM0q4I>5RYTdI{|5ZA(U-|CB=VunU zccOC8hB=le)Q@(TSZ?1XxR=DdGU`+ad#7Hz6if7_5*54$yz~udi>mJ!Ow4opgEzyz z%DpZ!EW2*E`ok+{vie`Y0;X_qvIbewZsV-ko@FZM8Txqt_k8hqt+4dO>nKMvS-hL~ zD{73cuDeCd5b(QQvnK7wVhQzDeIKHk%To9DVdB=0YUi879}<%9GY&5cux&KcvKl@o z&$tj?=0 8F| (k7^O=UM#%buVFwhFzwNXU# z^Tt&aHs7)nh4x#mbdbNK{Ks&lj)o#Ek(CA)K1w9BcKKVf-=@PA^BPxzG;V2EMF;9$ z97!si&vJy ;hi?&iPI8rtwRZRW0z>6;mtSAV(6S%~{ z6;LezL8QLpVIpqsQqwmV{Z1Mr)A76-+e(Vy*zd2}Emf)}rtp|>V!5rx>*6c_jYL_& za(pjavbO6?I}|!0Ni10_DnI*H=HOy?rZiJ@#j^rE%J%g1IMu8AhV=1g2I-^iVQN-} z8#I6R#&nPN!#_8eiK6a*>(Z9G+(i#>fO}HeTc5zt|5V>#7BzWHFy^!orG4=9%vIoG zRP)Cwy5GQNUjMW8$x0iXSZ{EgRf2zT=JD@#FrSX48X;^ 7isy z-A$~Oo^EbjSiYCiZs-GFkQ)PtAhEi!Vy ^r0Ks*&&pEy zOo$==!@L**tmj#Sh_7!-pD&Qwgcww=BO>TqRJ<)dDR?tu dw3ESkS8|S6RQX^OuZ9b_aFbOWhTY7iW#l9P zVc0L-_wFDSSqxkyui>x1zhCRU_5kH?R+Z5Ji%dZzTVW=imaJ}-MOb~q@z(DF(%P<+ z(BCH=X}i@1mD8Palj4SAAMC9Z!OFsbwC>6YDlMOe{PinjPF7hnzlyuJp@krS`m6Bv z;f~|m#m)YF3~O@UYk%CF84kJ7Z=!FnHhfkqc=-^(6sw-x0oU0BY+ts;9!+^##-_o_ z%Zr)cbFyMcfn$n8U#Am=y{1~~TivzWYC|It@E{q^{YpW}Kuor=@x#?MRrbSkv7cz7 z;nt+jOOvvL#GV>+gpmq|A_s)sr+!EZ+ZYKctuGK9> fSkNu6hGQZ3x(=8-F`nCuNgTKRo`J097Z^QvczO>28ivK z01N=6yc>&;i%ZE*+dDY;?-&8#h$SxG++b$ko2*m_*(|zgvBn6E|1#kSeC*%H#R1G9 zIhpK-IqwTit2(&W%v?53?9%)q+w#9?K=jvMN!gq-)!=as+Cc%ZC3k9s_)IxxbNQ(s z4*cii=w&xX `-z{k-|K>0G0Bw#8N!j-%C~?3(2|hYL z5y{5$UT7a4&|`-L?mrL<>^cC?(7pmD4Kqv#-`K?(Z;-roXNpo&Ur <>B5BC8~9TfT=mqSG Ar1 zs>?~mZ|`Mk`pnQ?F!0C26XpVek6lOLV?MrTGaDPsNyeNBwlns3eE()q#m~LG?lWu2 zf)}|X>+I|-Y5T4=D@&RgF_n0Lf5tpXy4$VCI(_z8%*o+$HZ#THW_Y~muu*&;@o0Zm zxX;P+4@w4)ist|Tq^Z=$wU=pqeh}WXU*Y~|ZsnPvaPS6x(NO}~C*YreagF4wWSYU9 zEmS$`KtPzsC-*|(Cd6iqh5(>fTn^~G9!()(ko0gi%@E3~>5mXQR%vN#+p}e7F^J?W zEv;hIg%rI!j+KOE)Yjc83D9SN^W{Kf-Y+O{i0}}^fK{imgpRp$abY5vxeks1>F7d! zTuDl%H~Pa@I8GA=uyMGR_|yFmvA>|Hs_ThIdb%+MEqCu?RsEwYw +Z-KNh_@68MS{Y%3l-qb>R{ z1vL|nxVX5=5);~k^2*BksbN%rvy$~L?Mx<6E`{vv_u4wzi$~sM`&Cx*KlVj_ua-!q zWb825{ZUKdVd03@Nv|P$J$#vRHt78eKYuUUV+15~v^Yc}&A+D;9l+16JzG%dBrdWh z0?C97WqMWbf5F;zL#` Br-HwqTpaarHS&4u)JKPnWJz~s2=b>=0@OEbhDdF$hzb nq{MORO&GaXbO10nKFSqMwBe?Zr311{dH_*rDvC>Sm=H-kPBT6(-CV8nt1|Iiu zmeGS(9pSZPnYXi5G)M2=L4s8BxtdbQ>vJwCG$46vJ9Bbq#(Jv!E_7O#O|CNOl)NX z6kqHm7Oj>y!K!+!1lro96q)yna&nNcm90)ON$Nj$27UI 171Sy)to=+4z@IQ^;O5IA5!FAZ~$6XV4DcZB)c6JUS;X z>&Flzjidwx=TA1d8>ZL;KL^Rf1GNGXA($R(>c@{F$5-ib!5Ly!f9i* I9RT3HOg2dg+(YA+Wv!HQxycm z{l-n5TgsQ1OzEFhdocO#U>b80ZO^RbVta2qHd7xPVk6+Sgrb;)vQopb%+X2Z6k`Wj z#bysZsgy>+OGh&}1UiR`#$ZELc-q&@MopWUfq~ej=1)ZPwq4=7cX|LLnDat_79sAP zU3VyaVRmQ_JdD5`@*p9>%2fB#FeuCwyOXL$<>=STdFyo^RC6u;aXZfiKr1X@lQ =#Qw b 5;YpK>o33EkK92H2-ie_(a3W&viQlt zfq_pDCByemzt}UyMJ9wr|9lBc;?{e9@^E1RJm(2E5~9$S#R8av+Kck84Wyx%Cc~#G z$JbS|CqlS&-0>bgx}y9-QzEU%raV9CwD`;R?ml+xX-BlGNgPg;?fDsXZ~-1$_w74f zL$o;x@l(?J^4Pvo^LKUlSoB?8b*A4{eP1K-D6A_mYR|y-{gLs=6Y`ffeFzU;f<%c* zA&i_#T;g%N0Oay*G$@g6*1O(k$nFQ^EvK7L^WqC(2!r!%w|DGq;LOM<7pqzKqxr_t z+tZt>MkV43)oxDp&cf&Vc8zzi$==G6jzZZDv(#?a>FlIcA-KSfMey}~ TWx<=2_RC+0KP<9c?GT)zmTf-)-Hg4leq{% z=w!mtomghw0GT+PPkrWW9#X=bxedH(nTdclgD_@as%6_Noq}xhpv*$HG|77arl4Yy z2aFg#{u*Z0SE|ZAa*UI!6BRuee5|W|9 p-~htH3SRV7+G$v#oMlH^Vlh zP+$BN#IrW(eq*B2$#%J hM=6(TdM=db&GHPEAhWcDu`Nr5gUO6S_r#9dQj(Rjr9YRuFm>;mJ0< z`?fF5f3~+)70vfyr%Dchl}?+2RF?a@4IJTZnAxjy*^Q*77~%m3*=!3F>XFlf{kW@s z^&dLM@v!A3Bx2JUIitJJf-)-_8YnEMil WA{!}5D3p8MJm12 zI*@|~mlhZOPg_D7MCyqTMJ44Zm;^-?yk;Uf1Ej!sj&pf@>}EFTlaDx>LN=gUfDy;1 zxs}^xRsIAj7CAK9aAX9^+u&f*iVX->(?6Tk0jcQ3K;@=y{i~wATUyU5P<-pvwsH9$ zSzD7K{#;)^V%7*sjFGvY?>%H{{FIWFmyxkoy3}QmnwNJ&x_uY~^_PpRc%oD^^Gl1V zQ-rA>YQO(EB@b^wD9J^{FZ^6b;zkjHjzbCf=$q&<7qQ*Oz_Tp0eYi}tgMRZai%IzS zxB!*TGYL2UxkFJSQjVM#oJ0|k3H}ztiX>iw73#3F6%+;{K18kNtq%0feWfxIMLEdX z+FoVssnJ zQN>q4IOS9|3S#5W1vQ&GSZyX(%7#bUCMuU8~ zjD&Jlmz8oXTs04hiCSeY*O%@vgCw3<@bZ;&ufTO!lAtAJa606aJ!Z*e&|4#_R$(vL zlU!-KU7pBo }zP!QL6$})0Mf>MWM9n!?- zzEO$?tYtEn)$TY$ZxehL?RsH`p}D$GX^{@5uWHFhORZjyS(EyKUg6mI`R7j6?ZLAY zrVj8PVfDyvln_M8sD5u8#n5CrFt`vB+*&L%SwGPcgM-c=(5?1mM-3Wfj_r3OG^A2k zj+78*4V?$?;xkM4@P`tK>9^Gh5eR&Yn|GTtjd8`i_Db*+b1ntff_iBa2tr`eketJa zGJhXhbhayQAGyxx;u(3>)V%es4N{HTKCU9~toBexgpj&$2xIhw^WlRcYe)1~#E |BMw2-XRQP6Nx)X9Pv+o6(7DEtoWS%MW#Z{*knoL8WU8h=)YY+ zxDgQ*6^y1RbUWwp$qV)zs+{^S-p(&}{P01h;TDqKYFPFA(?P7rxqPv9XF}&i5*^nW zJMs287Og6uL!l&w(^I5Z5Dhb)yW>Joep3`>uK~UH9E)sY2P@Y;g_n`)28*1Fq>I7V zUY0rty@4iAXnEw!-vZL08l^>5_0B(?Q^lS 5o;nF?2|=ht*Tps# zJVMOiab%?8)@e#7;+qv>2!Vqi1malzJv_#<*OpqV1U${|wYO^0x}qTgKO$LdxM$sR z$Q3MT W2T z>b_{*K#p8+SGqUY0Lv_LALI8J4s~t9na|bs2NCwCzm1)zBFvocePcfijdZ}brL-mX z-nd$maDh%%b%-fo+e@mVTcbR5{3?S_Z nEjWKF2<+t&uY5wDX6<2khUC24@4v;nmE?@LH(@%$oad_Ry06S)4?`g z4N#=C?9o(SSX`XhZ{O6crek5?fNY{_|Ni1dUS5C2iFSD;6(}rgmX?0;1oqNX5<#z< z142hnxdLAn!Zaf;QgG}Fy*vK2$=;%Un`up>p<}FGv$w?e%hbWpP9_UUg6J{>9q;wr z8a9l$TrH+e<{WkybFZTXxu>Vo99dY;jkK$h0$Wo)yn^;gdYvy#U2?T{F1Mw7BE3~Q zQ6j_u1KXMmaL7i9=;-L`XekRC$anHxU!R|!pY1LcDk2o4w`g7obvfR5wn|oH*nM9f zFOgRN?sYZw0vrVNyy)!UL%&|f^p$EVBZx${8_G(pgaRiRnT4+OR u?3m zKQQS@j$1nfNqeF!&bcs-okwl%7`YE|k_z53tlan{sogCLueoO|rm%ShV*)e1E!+ zg?kd>NV)RS=qZQvvGtqQzM*w@DkEg`Ha*OkVjE^1*`~tWrzNZ7*O7!T&bhzHUNq$_ zp{9-kdq$zll1rwd7wLA5>vtBHLLi`q;kQ0(hDbJGD2u&x;b}_Ohj578Vl761gLO2U zm}2x5|L)xv4f9xQUM|3ix=O-q@ $vuYcWzzitBm4OU2jJ9*ZYalQ$JLjs;<}4 zC99_BzKT!jX)MB894!w0%rImCKFjE9O06v+%&~s?iZ}fRqp` Up=6|6VLiWMtw4t}M#JE&>z z955J99Kfy4xHAIwI31k`I|$0SbWRRJA&GC$BpiN&exlIv8Nc)~;^t?|(SGBM;X?W* zep twhlW_J!s EL(BN0E#EFQv6poB{=fHX9#ifPwKHr)ne=>f0;=y8t;%wlTmS z4Z!(2yAAe_>UF41t#06>Kkje_TYYyo#%}G|?UoBUr<0{A258v83_jj0x1c(SA=Kfn zs9FCqN=?xq%4VoXUSu 8as*ouC6ciYSoIYNPU0*c58zpjv*x5YK_E=G&)%04>4$!i(7Qe2-!>*D`h5S z1rE$-@7`p7U3*b}$NtX13>=k{Qi-&ZHdO~+HZ)z2-6-2XrQrl2_kG fUS4vbNl_@gA^#vLLfZ!1D zbf=!KZ&ah^n+0>0jbuE!OIG2{Ia+Fl7NhYd>g%lC?>01G6h5+NPB>l`@HjmVXs8mg z7`DOQ5QZ3ztn3hTZ*2(e_3LwJE0P$GcR1QErH*u1$;Yw#RbW+W_{&n2gv00|#6FNW z;bni?JHF0?>pWzh9QOw`{7DD!7-EV#j^RBGsQJI3NyvEb2B$Sa=(vDjSPD-lw8+V5 z^#9&P-&)`nj^odj`HGp{$Nq(oV#V)1B?mg>=L;IW-3r&!D!D9%${JR)A4uxvTE|8v z&{PS-fY0U!v{IBv;zKoJ+Opv~39s87hGFYSk4*pp2!M!FP)V$)o+E@>Vm(3v$~z*f zvE4I^Uz%fpCSo)r+<^CH*IO-6or5Okw6Mi#Gi1bp>ChcqHzZ8Ai72Ml9X8J!BMbC> zPabr5s_5LWfApT)8D;CjZhdg|ycvQ{^{(AI!O}EUtj_T?`F)Da`I`8{iQI l; z+s%p6Pe#Fj8*EFMYoIu7jD`cdB}PlL#B$1aQn2!)v!&|Sb?4NCkLE(kiZKSP1Z YBsT| tR6**d)*#G)B}eB_d5vE*br{N*~LfvFk8$XJCdN9&n{(tK#* z=ftTS!Tt@|_=MKZk&^(Rd^&o$s1)4vZGE&zWNe6OYjKRc!wYM(mg5T3i*xt1$#i+- zz4bv1MU$?GA~9auBc3kf!udxAf4;0YlzOlTA3m@q9j)El%xJqICN81ZRyX z+dZ~6h~M53 *&4x-_Bq~xd z53%nbHn7KO%FDAsOcHGShrF7*Z#H28cOwX}6tHbR&QmFrXumJcm)NE6wa2t}bpu_M z((GF)a5=MHr>|EY$aJ9Wms;MpJ?>D}cdi5G<8 u>Y&Zl9f< zPT}p^K<4T^#Y^&x=;8CT_zEZM06H9 Z-3$zBZ)nI>9>-f#}a~y)NjqnxeLfAAr*=co2F@X($)k zQ!5fuz9suB5 ^vlqN1La=ThKW)`q`61fbaV9wHdNjhnDd5h9^ajHd=*Q zz4}kf{v^|~S 50YWeI$^vM?}-oXftdwJADJBW(N5TG347w%0tx#5}#5&qDN&= zhbR5ckm@=%HUE4q0`S!%%ORz#M^w`-ZGuMRN{%|o@7eYpN3IP+!(BsXuOL0$)Pvsz zu3)wGxArIKa@#SHpskM8?ritQ0}c%%2+*Z^+X@~y46-Szr0DdQE)01Qzj-76OM#{} z5Guc mUWhxj)|B>vCCgls-PtK4sw4s$l4S4W|#aSg;7) zKU=S;tegqDm|)Oie#n$Io`R2rvKO z(w#VnhF)J8r5gpXk $zI~H;?XeyjmSrw43S29U(yj+z1l!(zS|W z4U9>5cM=H8Zv%_{wF00A4G{)kS#9cV;1BT0T&J0{y0sbHHG7`#3{8;r?SJm>0(BoM zBmP4voIEi4e)5#xv3N(b9ozvBe*CLDBNH7jM9+Ep2irKWdB&QlbSbAzh-QMS7k7Xx zsfMO!o6Y^G#xw_zJ?QkihWdDEfzI`P&%jdS;f18vRqGH_#gfiv(s8I39v)TOdj?o~ zJC%iu9i@;8VRBuqs0*c81Vfp}*Zc8GHMI>M4o*}@b&9rh^w$g>Lmrd|E(2$6$j%14 zLlbyL@Fb5l-27AfmNrNoG|h$yOjgG#D-Ey7VatC+_`T7!nwP6T&eh6|qr{ox5vi&+ zMajlH8beZG=cN}*sDn`?;5bnM-(H_8z`>C9lDuN&JvJH!n#3s=6Qc$nB;S-X4b;JS zDAZ!d8~(S}m|W}bTqoD@Sj5hv>;}4(z{O9|NYt~?i;cR*!>P}|cLjFpCKjwed=_)_ z=VYB;Umw4}5o0^FZ$9 %kQm-mLV{G}yBhT+)_f)ib4W^)B^7|B(ptIn~ z54FUJd&FYHjqe~=(S8YQH<&9sI`sAvCE~%VLYxt5FdmHR6%sp}xt}faJcqqT?g1qk z2NbORyYDL$YcM5yon7fVwe;Vz`pmS-W!*T}EBic}wS>J?8P^5vp!$LH>ULB=H$8xm z4CV!-V`+t1!p7xIH+)zSi^;;KDnQ#EGc~WxwOoJAD4X~ulGtDt1D(Za+3RlW_*B%B zf_6{2Bq2&I+4j(^2e 4ioE9GVaXk0sVB1XKgIbd z1eAUW4n~Oara);=cH+yOo(dgOK^j5K1colO!D0t@>G%xg3WXd2R4y~i%F`Dvq-Le_ z-*1L|zcJo6$1TN5G+XmW(r-6d!*YLBv8GO2c`3v*DmjAAgKhG${$o%1P96(nzT4QE zRPwxlT g-d02}@1nCF0}~$Xo48FS zgM(&IY(nhoLNt7!mjyvUxaTGa6sES$0hv4Ko!FimzfFzM0#+qQQr?%*XF#b3Hhts< z2N22;X%x~cGHrek{MGz18~ep{oM&`p%*mu6rcUYZ7CKtVAG{%%N2OIEx6IH>ptLr( z>na?(TBuc-oM~DEvC>GAWP9S`%H!z7&yW5*0PQO?5+<{ul>4ThYD1wUPBFs`>=H8= zl@Ffhzg%#$95t`3?0~`pwNbo!?CImXtQoptRI3y@e8%&8zenX2N*qtg#)S`@g4rQy z=+<;nj}`|o*OjBwAb+ifaeLpnmOeAwG`b2-V@RCv8!Khf&0_ovc^