From 818b0551d421af58f6b1915b7193dc0bdb4948ec Mon Sep 17 00:00:00 2001 From: Aaron Kaw Date: Sat, 27 Jan 2024 19:38:45 +1100 Subject: [PATCH] Added doc for uncertainty ribbon plot option (#109) --- docs/src/examples.md | 12 ++++++++++++ docs/src/plot-example-ribbon.png | Bin 0 -> 31303 bytes 2 files changed, 12 insertions(+) create mode 100644 docs/src/plot-example-ribbon.png diff --git a/docs/src/examples.md b/docs/src/examples.md index 3dd0633b..8e6dbd4f 100644 --- a/docs/src/examples.md +++ b/docs/src/examples.md @@ -607,3 +607,15 @@ julia> plot(sin, [x ± 0.1 for x in 1:0.2:10], size = (1200, 800)) ``` ![image](plot-example.png) + +Displaying errors as a ribbon plot is also supported, but only for the y-axis uncertainty (a limitation inherited from `Plots.jl` due to how `ribbon` implements a `fillrange`). + +```julia +julia> x = range(0, 6, 301) + +julia> y = measurement.(cospi.(x), (5 .+ 2sinpi.(5x))/10) + +julia> plot(x, y, uncertainty_plot = :ribbon, color = :red) +``` + +![image](plot-example-ribbon.png) diff --git a/docs/src/plot-example-ribbon.png b/docs/src/plot-example-ribbon.png new file mode 100644 index 0000000000000000000000000000000000000000..efe85ae3119613e9135a3de4df306bbb9799f687 GIT binary patch literal 31303 zcma&NRa6~a(>00(HUxKfcXtWy8r&TcB)A0&uyJ>H3lQAhAvgqryK9h*+uzSS#&>;A zb3sF|UR_-PuH^uj3!F|9^?F?QH)82-y4|C6`svIIrT5D z9poTY(MRgXTjQF=*1mMIxDl-X?s&VU5(x>X zh%8Jw>?Q|kdj!Au_gwe~wjuw|SbnomA_?F|K>~o;7GGK^_5fpJOSVJf|9h|0 z|IY@r2gutciVwe4FAuWPv!Wns{APzQ-Y?VdTSw|gMn57fJftvcdSc6RB@7IT!}=pc zvlB=ItD|FgewMNGg>9R82`@F!&B5-3BsADu?L?tVcV59KCe}I{6(bBHQn7V~aM?g@ zE!$kB)R5EA%)xSgq*KlH-HD*16hZP^skEk`^)UZR4rjN!!pZaGWh-?({Nd{ua2>89U9$HEGo`6p{v2{8yF zf5xTbwf&ZM>)zhM!G*Ok>(n15aR&zsY;*H|bY4Ei5ox@Q{Xur53N`G+peLp(3mg|p|?g8 zs8q#X-K?n@DUM7*=N`{3J+J3~|Ng}udh+jiocuQYzay4JsPt8`=2POw|8>gfr!MvF zn{H@7BAYSW)01X30e+xTbR?E|EScDw$@{HIK^_7E0+}CVc5iQQ6jeS9(+)Lkmo;e2 z-__MsL`1~f+uNg~nkb1n%GMENfr+UF$}dCM-ye<(#nL{@$w7xpiGqQK+!xidGgC#9 z#*z&5yc#@+UTlY5jZ#IKJnZ20w0hqh(B*njGB6wmyx#}hpDiclA z@a^vGSX*1a-H5&4{O7(kt3vvV&7Oem#l-&(%;hkjE~&S-EplJcRzo+cgLEQFEzkx0 z5G`-NLvb#tBPgxjgQffS*QKAK`)wkgf`US`$J$zQBlv+LQSssLB=JDOei}+ zzfG<;Egv6V?+;i6kMor#tMSy875(2#!F^i+FCziWFFvQgTKxB!OcK6Vl~s;QH^XAv zI-m@%`KIUOG%edFkV+3;^6?Hc5NGM-7Y*?7eDK>vr|lh^!;_x$HkiWy8B|+&6JQ!=*+egF~3vbWgTzJs&w;|tFn^m zxqknM%*R4{8R2G9@y_7j;<~DvW8GBuI zKVLAhu$*69ysaII>gemQ)VBWGptR4)X^)d7D|$L>m{w6%etdnyGx5Ee|M?kB`0|sB z%k_WWiNa$OeTDoP7#P@mf4gt_wn>VIcR#^3?IoPM-r;$A-G=R?g>OMmMrzbQ6K}S= zB?ZHHjD}j+IA2@fgn#AJmG?AX2246!WABrnWw;~XKY#vA}g zLh^c|(?f_1zq-0AX=1%Q98+MJ56pmxi3zc{tGGh?YLlL~GO^b$`udryd5V2U^e_H{ zL*Qpu0eJClS}4z8^N;Fq3z>mL5=pa*i}%;#Z0`>vVxqnemph9oXj?|sPBYfMzfJv+ zxB0rSV)ofKybp5<$S|?6dhWaa9bb!|!3E=!$`~7mg!RpSWR&FR2dRf>eO5G&Nx&e| zYE1eTl^%U{b(Nc&dzcr{U0NFYWL*)Vs`L=6DwX>K8kmS7v+5<3N#hxLBlFn(WMNzQ z(7zb>LT4e=UGDwh;#1Pn)kgecu4?-1!V0l4(C=_&z z1!F0oz7jGbxZwE;cKp3%4UVA2%6Vs1SZ&S_Nl6eql?W)-I!L_TFamuIeHgy0OV?k* z5Qp`3sdty-s1Io5FE%{#zeZ0_x(5T7wa}8=AtcT4B8E?OKg>dB6n=9;g@$27kdhIL zn1x5d;FBHRT3bN#9vdv73+7CvnfL=s!(;+!xHc^v-69PwA;c+)pg$pDAIDTc9ey?Q z6Sng)rYQ66NQ6SCG335s&DKoP>tEM>bxh1j;`w=-Y#brPK8ir%<8&ClnSXBiZ6fu+ zz#6&?pM!(ct4t~vUsy)Q5|f~U1aKG`85PSGAo%$W%g-o$57`Q3fBN#pOcM+xBjZMb zM0du`TfaGe=&wl?Y3s;)afQnjQdD&IHMxk*U+mzJBGS#1ho>%pa=L&IjTFuO+J-$m z757dR@HjPGaC%;u=<@PvR0e?sJe)2oHzNq2B&I7?cy?q7-~X0rVydta`+gmvK9mz3 zZWyH>-B;Qcb1G-xBO6rj-T6{?P9wy~ldlmwV{eWRwlG}BxbNrZ@VJq#`@+s_hztuU zJ2b8VMvzb_t*HlY&-42J0l$O8!}&M)^?@lB<;OosNy8;3u5!mmy-{ou*c6do&kmip zxW_SsS`>K?)?4Q-&L`MVUR_>ydPo@njNtMWmCC-~7}(Jcf`u(!Q5(lq2eH0}-yCG= zIH(c}NKk95&ojPmo1O3r%bL*AT}=t;_~XF6?6XNp2g}OF7|$3?qhEvMEw7%PpCEI1 zs@ZDy4=~W#LS?sq+8|VlI%$I{=i_V^KKidRF$?US#!4z*ePCp%=v0`0o%8U8r5S5@ zs-@Z?cL8t?%NX#&TK3>+O=lryOQ)0gpa0o1>T;Go80G5fwTqHMbb9Lk;Kuq2q6DP{ z7b*e}z~AqOX*`hxEI!ddA?;|klj}|h>0r;Z=#g9jC z!_M*ns8)(-ay-`2QooB;1TcKk}N6bs50V|)Jl(y1Z0wI@#%+5mS-AaVJKE|C0D zI+F74BIR!=0@_K^F}uhwN#B%#(CgW>-|}A^j&66l?jZzFc@GH^O%@Yvu5$!X>+7}- zJl0A&|INeba&0A2vJsQ_cF0gOFO6qns$!bkckD3Y!~?xDRmG4`oBmn!b@3qy7`gm} z1agAIop&o5;t0WB=S`R4(L@p|t?1HjZsjH(*VL$_o!6Bk!HXt~uK2!L?39putY1UG z`dR_DFd=iRYB;++vHmQe89(2bo;SiZZAg=Uzwyz4hdxRx6|oP+ObQ=AehSZMsz5S5 zQ$l&tDot&($`cqJpO!>_9}bYchm#1YX@*=l67%P~a-An&6qg)7enLeInIj|Us|koX zU#)YY*$5y*L4ij*MM~ucrVt2jt8vdWj$CtLRwYM6zQQ^*Ooj@k4FU^&w)t(IT}DPt z+j@RLAknJ}o5W&x-&M%xQ$(UP&pvvi}g$sK@D975LMa{4#>fc!JiC00?jJ;}Gd! z)BKm%vmo9>vrgu`$K$4ElA~1AW>khBU>UaN(1@&)x~Ib;BIMBe2`8pyrAv{S9YBwn zNans;*gq9rme^lUEU)fDn zj&B?i*tf1seFW!%$%j@#oxIY&VH3m(Xi+@KBwVF)S#iU821nCY7^2t_N#vmw6(x{L zRaxjuj%pRmDk*2Q+)@FTha0g>B5Miz<*`cXoE&WF`|`bwVj>W4DvpU2mhA$i6|9yE^Ti=Q;D2R^B;;`Zl zp?7hxWiE}03d+mlAmvgFAb6?*ed~Ta_~&~lgvAMtf)n>TDhPW60Gpqe*F)V1>G#V% zgbz3Lveif^LyhBo=!Q?B=KVKCA1@s+{?7zvHn#Ww0I&b6PuoXSQsJZfXEL873Me!Y zNc{Ankncn7-Sk2j{V^uyuXMvjDS7EFTd?A0JxIb0#|>qK)Xc!ZKuarS(i+yZWtEAM zab;x%yZW2S;MrN#Tv3&ya_{|=<+F-=VVlX2kBLaf18Gd@&aO&f-%*$sZ=C|U1 zRp{Wx&B}`E-;#XaH1BZW)2|8TQCfV_iQS*Nnv41)&e{_`$ zZOoYdJ8^*vZaDoLLH0_&9pl&{#LBAjnCXPye|B~@^jL_6g$1Bi7d#>2*w|Rqe!6M@ zf8Wcin`2@Hr*d3huHtk%aD_Z6MRUJ;RYxEe7ptwClWHi5UN7sl8a@dtU^}1Tqms$E z^LU&~80VUx8={8&YFTuCYTQlh8H^<zW4_i8fH%)+S%Hc|NJ?7 ze#}c$Utep1(Cj$$_WH2-K4c>r9E}`F2Z0>%;!l~s_^-DoJo$VfB6 zhT|vJZGgA?YwCs1))O6zdbTWCw&L?$UAN zgbW``oLDsofPz!hH?xf%7R!>R2_zB*UB>bB6olQgnnA`&%=9Rcre z79+8ULAAgM_z%WAMD-m40A|GArbS}|ef_7Lf4*fcE%!p3k1F2Yj|Y=kO#v4gn3%QS z`I;RDKC8}J!J?w{4T^`-TiYw;A>TfF3*TaEe7-s=(y7|QbaA;{o~C3)?RjM}+9c~% zw?y~(*}q}@a@Vp{2kW^;L3H-BdiYQ@>`&R%UxRtHL;N4cbMITQ#QcG>qwf}be zJ*W1(4UoM#Z66jE76KN2eP^a*WZJ&nK?~@`>;9DaX?As-iu$Q&oe5i7_+8k=z)=qgtD>m8~r8U;0Q~|kawm7h7Tsot4mv%I56@akx_}sMaYDCtnLP4XT$GA z5`N1AD6#e4xVY?;n-<4>9vx<>4XZHRbAzJ2wE^o#U>|HfDd7MW2?@VDQr;7`yLIP! ztg1iezaG_-e=W_N(XmA#(+DwTLa3x6?h0D!(&ms7EB6JbH|TnDEaQ(k`) z6!LCPo&pw6eJsfB_B;ddu`K+h+<79SD4I;Dp!q`Di)PWgpIO%&4Zr_VDWahCK%ods z#$NMbGWG`36G_x9p@b3knEc5!-4w0T3$Ew9qtnzj-&g2-ZGKAe7ZZ~x;?mbFAm3sO z=p*qYXNY*EXxWTCurAE!i-SLo#XXLT2FOPbvhb92-Vms-b_wx;yCVxVd$9%Gwt85| z$Xh$oYyKU7InGwVf65}R!`dLX(u&LdXriBF;JHb8V&g`tjl5pn-RYM8$$GYwPVX>_ zM?p-!qwsA;&uhNQNJ>=^No1jTuKgGYKT%wVos;ZNH7g@SX5RPbgKH)Z_|^@(g{3 zbF(lHnyuvbK=$@d5S(^Ekv#ISSmnL#jF?sLHpnNkXX=0Qv9vlCCKwxwPY!9Y(P9;H z4LyuKkz^lj9sloXo$Ax(lTf197}+9~8$>nT#?xp`oc5ye(_v_$y|E;MXrcIa_!3a7 z%>@lul9G&RIl=^~v${~BkLaMSbx)KGWFgO;^A;_A9UtLVFZK7hW^ybnW+RE`XAbuK z_ct|j%9E3MJg~BI_*AM=Y49ZM+ZJqcDy5LYzu9@eCgtlfLvKk{IlA0WnNqEZzmXrjDt!himaLUp$?;Z^#DRmLHFNgqVetQz$5`ZWh=7R-H z#M@Kn7k-Zm&35MEv^cVnNE{FxJBPDCacT+}*vSovbNggC8tsCbdHIP$-_4j9Yrm1T zcWBjXh>&((!fbfKGBBiPwD}@UT1z@}T(pJN-TnN}l-Z)CM)^a_*?mJ#l3X7ozV+gI z6anGryjSGkzvYw$A0GC{)>-ks+FjMfsV@e!5dQh&rV>oQGm5e1o@NG1IppKA-i~v7 zD+P_-LqOlK3d8R_ zgl~`!4r7Q+qd!@J{6vB8!(xC;G#O@TNzRv6ZadsB;ZzU+o({7Zxx5}1{{HC$Jlc}u zNG8v4bSTUzL4P!Im2r&gA^x}f=c_eWVa-CA1z#Z6?uGjMi_4xns{EI#G0-0T7*i3-2zko zmw|lRhs24A%iT~$HG+OM%Zc#L$Ng5rrP?3mpbla@R#PwC9_S%rO@PUFe(`!Byhu(a z$DhZZ^*$sqj#ft0M{DgNJ6$B=B}4+^KSjmun}V9SSHyo^BMsx089CrZMW4FOxKMce z4g0;oYU^>_Y|%-7V>RprF2^e56vnf&kUs?775cnH&Gxg&Sfaecq)PQLnsZ{_m`zP) z*MSSQ#T1RpPLn*D+U|e;@Vm+Yw%}?eZNGS9V}~@IDp=Fj*UyhTF*#jim&$O}q5NV* zcCGw@LNv2du@NN$y+FyM9cuU#6v$;$`z0x%sGv776uq}pxz!7U6zv(ys}f0|Jjh~O z2Mo+k?l$p0aueK93D(y(fyO4V5a)qMQN2bIo)Bly59n8TY=d~k_Z{iIy`#U@Qd~fY z84*FxFk3v;-m$RSp^N2G<75l^{F$DO&xKnUx{Vg*e1sU) zekou6$6y}Dj&+Dqx9?7ira`P#I_?kT6W>+3Pvhf$uKaAnKOsAHMbR% z%ZM6gKaV(j_|2iaU9X~|1ItvlnF($>7nO-IW2zonvlx6KvKnwWq@H1{H;TP<}J6&2&8(^7XTKN=C`U zYq4Drmkp&b!B;z;oVbg#Jz3jSiB?(=93=rVRD5=Hr?B#Hv}dCUY5}C90|PH?p%R4@ zh2$@9NJfTkoy4Da?tiQGAwxLF*y&l4HgtchdHg?JSDC~eSl{vZk@q$rq)C(`Wo6d- zxa&?&Fw|XR=HMN1J zgWb%a^G8=)aviWW{jWyHoYI^8H57fA2#5%&n}>|3#mupk^oOZDn*f-!H**;1LgABC z+$w!=GWITlRMnK>mA(h{1)gRf3|n)9bpBsw|{&Y(GsIU8&1o#s{K3}G#;qjM`U zv@xx1Ou6EKH(>=uh9KyYlBK$V_&3=#l(~c}=Rz9j6ofOk!fIAw(uREiC)}Ps`p%$W zYAwwKHrdH1m3>6IRDBNtcDKz}5>76jSVsnDXL>f^?W0?!r>;FFb%1qN;HUp`n=5vO z!w9PI3%kcz@9X`kNpgKLTvF0J3Ks4bRsaWefJ_Y@2}yZ1txx`Bs4Usg#d_;uE<2>= zFciJKLP7`cdmB%;dLw>64|E&jTHB3F;%g*M>n`fukKcWK5w}6qs*Ll8akZ&x8kp4` z7uVA`I8Qp(Evt1NEZ^PS?2-TcX-B2cq{w)PiJ@nt{6(Xw1rCCNs$F(E{Uy^<3p~TA zO-+9+mwR@#^3=AFAki;qR()b3o|l-Ot*64lPmjRGbvcYq{tJVQ%+mOv(=pqpLL{~$ zmTjT`(*hWNvZDFIzC}gW#u()Ddi%tNWcQWZ0qg6rDV9aN-20lq95+D+iIAu9V2H1k0uD-3 zGruKmJ@?8t13jc7{_?@p<$8Z<)V!hsQlndArN=HjF`Z;2qxHnag-_7-HKOK|ciUjU zGlfP49xqWveDaJ;G`O+6S#KkkiV9B0nCgWiF2167_EGqfxBr~pgryBNuYIMpakYOHlBRR= z@SKIltG=KI<%{}F<F>q>{?_spQy(2dQ`^+m}V3-$FW8;Pl-qsB;hsG@%* zU`58d@X1jDq@FN7Iv(Bkb{Ws(!$S+lSdM2;a~R{Asoe+}&1n@c;iF@Un5Z$DdAZPV zw;-Z^GzKs;UqT&2UtjlvgkbyD3aaUm zo#V%Ed5yg4DkTPKwfjdk{m24};UEJ;oFG$Wr>jCpa~^d{O8qx0%Of(9Ulrz_!L1PS zW^p+$U-VDX;4_20D{6&S3PZRX-^=Gm8H^YI6rR4JsPYQRm}@*7hOWvE3O9Z=?O|Qh z@JfkKB3FqDIH7t^($eYKmTS}pb77f~SARD*`izz#00OWm->oNO2N(Xg7!}rIo}Wh> zjd}UnyJ^w{0QWJzchnfi6jRU1V)UQEE2~`Ja4}Y}CkvWr%RtJDsZ(b7wp~Z-methz zTIDC`MCXe)=Yn2*=UgEbbkXiJx1~4D&fY$Nv|4 zxBHgAQBwmjq>c&86FG%W(l#ob-F;)fe=J1-Z^^#6LwPTRH-f;0Oe%qoQZ2#Xl`Aq5 z9ZwcQuay>X`;~*@hnr~#dx!YT3o`KJB{_8q5iyf}m}|lzZXh52LA>?(qQmoi#r~dIwq@O8br%TYA9my3$9rC)?$CH5PreRM?NU+spwX|D`PHfY2EdZtW5eK=n6X+s);qs zDs&18_j$STV#5t_D-zLbCezCsr#)hApi_aX>koWc_4l?ZxEJOf5ZrvAEMoD-ll=tsh zs=H6kXy`?x;^GSE8{$k&(ElnC6s&cj0d;wmVO8o>nhdX#-{cb_livs4+{hxPtcc6L5IJe1}6KZO!G@&~;6#wzhRi=)rsEhPU( zr;-J{IJd>!J@`6Lh`3uhC8uofNdFL(Ufo<}I@zF;OITjk%i{PwI3HeUXZneCdURvW z-lR*=v;~XjQ}ePflXiTz<>mgt%59AN@X(NzCCI@+Tp{iA+35|}y`asI@LY?hr_esl zDUexWX2BUf_?e!xOUFOX1S6+7FbMZZzQDlf()C#S%`vvQ(X+ON58e3q`PE+>9p=X; zelbl{S=Bg6<5p*72L@@`-q5wQ+ZM$2s&~JU_1)SNJEb8-$a$cs&2E`@2F51gEROswW^(c)2c(!NP)F3ie_l zWu~9$VM8+~v?**WjBoB8^_0IHGun)jy~1_lOT?*0q7@7M$z ze{*!KuBkylA7fCKmzP&meBMS2cmM<@S~H=!*fZ{ zn;-Wl%=D|6{q_N10?AQ{mmY#97d3uooz&BF64aZ5GvFm<=cUau{_(YzhW+_#Ge2v2h@G+j=F_-oeb|7bkm1zCM9GJi@@s=HhaM z>pe8YjJPod0D%&)Ah1&=KFMFEOPTGoH0BqFNaSl`nS6sV*Oh+VgR}%eoq1I072R;< zs8s1m8kx&HntnkpQq#BcAxuib7Nq1!;hq+iGA8{Z|J@}ribGh5v** z3|3ltp2k{J@z*fpm>rCymYMjEw~Tga=~g$yh6XoJJ=Yyce?Ad>sqaEYZ!CNv`W&`J zX&Dr@e)SIh=FI%3zx5zN6hPzzZ)r)Mqo z2(A*iqUfPKJCV@Fm9~0$@M0DeCG`gcW7alQJX(h~p&IE=&&L<_2fp!H$U%WqD(!{& z$V3P51QPIkqnQL)NEPgK2zv{44!o}Nd69J-OvA7T2kbmFuiAD@O=#G&C+HkzAhS%X zA3RzGhF&4sI6=SB5B5ye&8Yn3)aMgnBahJ{|EcJQxDAecM(YhXhTGq_ zwJYMX{}EUvA8zJ`{NXn?;YXr1^s&#{GUxb=#6Kg<_Wr^(0>eC(M%cW8AcecHq-Ja> z-QK9|vb;Zq=~m1)H9NYI8*(?dZY9nqH-)aEY~~p2m<6Qm{D2rTz{*HBd{({P!S$nz z9CrPof&S57xaDPRg3u@qb3Fh_>_VT6K7PW&y7W4_ds)&f0DKvYHG#4XQ($k#2%bPG z5T&L&4It%ebWm{*?>}rjvyQc7U}OoIUWrwzG}Q7 znzmO+D2bw4!oB}mw1vs>lT|8l;oRJ39adM*vB7O=@#*CO`+lLe@e8#6CS*b45sMui z2|3C(OO##2Qc48<3zf&H>e#qDfP`%;Sm8FG099T0t7v$kn+kL=V@UI(nwGTZYqNvb z9)|DBt^!T|*jRZ30!x!JKR>;Z+z)XaYwNFHsU`N|hlb4V9fhw!)m_@hocesDU$3B& zym|#OBtvJci_+0}cz_;~QwuwZ(L~F+zkF$#WU&H`3>SOO;%l1uc9st03kVbwl<^XI zocE82h9+X#uY|03Snal~p=ijc;50XZ4R8`wUk0UK^4^2n1(TDvVufn`yUtPo4=*q> zI!W3ZgAOHCQ18y#c79mf?8XXNvX#0cvoz7Fsev0AkOc(vv5Y|_J>Fc+_HEa84!mYwd`b@V;K{wYEsW9#G}_9Vo)xYBb=H)?IBlIG$7g)0rs ziA`mWitlxjq9XR+`O#b%{Ra4f0qk`aX7}`}4uhxLa4#?sZ@EcQPE4G?+i?^UMg2^D zAn|Fr#3+9M@fRg!_4|nVY9yS_j1MO#sXmG-bSEd4HHUy9R8(_X#|HZ44PXb}ZpwM0 z4w9xO#zp&0R_B@i?OvWmITJF*)3ps1LHL?Q2?DId3MXq?&I)!uoqgn*^;nVb)MMO- zhvQGRVDK7BqP2_0(~GSE(fAkK^NQMLZ5mIvAtZouA3Sw;uYVqFoFzY%GZ`uO($9QD zu{?@k0Ydgav?cQCNx`QzY5sOM*2@u^8vTdCaGyWVN#8GP7O-w7C}$;ablvIe-E{Kn zw&RDvg26{ePCHSzb2~Cn5uziexp~L zu&t)iu>iC`^Y`6$_jP8)V28LOB3!YJRDf7w($A0Y)>g-y^fAC=;Q$HZT#bomj=~?@HpJ`<#Eu-wkHeHV z1$F8>((1qx+oW^kar#GW@H}Y7z-{3fTeGg83ix)RcmDpW~?I<)yaI`!XMH zjWi_c=o|ZeFTG}#8LpnT$T2bFQ)TYCN$7w$Lh+&4prwNC^ImaY$_Mpgr{F5`*T34w z`l}eo@KCj@b#{w$>As@~3QC&ov-=YM-4KJ45^Sshe`7%~^)NukKi$scf>?yPzmk(Z zFKH3gGB7+q$`(}57&YtBQqm~~kt%9SJ_M0p`3!dTKRlFp7tqkO?&IDP;c)XW(AMD; zvk~A)7X#b|k6kJ)+NN)VhMF66o0*Lb6@Ibq{zxZ88rZuqYo2}ai3c-z+*BKuy=>>@ z=H>tpmKMdkzXzn-Xr5e|H0#+I#C6gdPfTKQf-DZF0Ach2&Iu8zUJq%9=fHl@dMuEK zy9_)V-Zt0%m1xALHZ)>x{3M!J#Yl{wuMM6tct~ zL;AAbgRk`{B5&lj*%z&&`=TDP>k9NwMkEy#TP_$Gz399|3JS$2zVe91-XHqN)m3CC zY7kX&lTo2OJSf@XcF;&A(voL~0Lr%MBi}}NGIk_!_CjSsJo#&vf&!4wu{XZL1kC@} z&GhOs7!17$ zULNAef&iIThA&_0k9&jzm4UzZ*)-`AKIM!+KtopMD*GnV6itHA6LvEf$ATz~TJ8o{zsl zCF~;QBMDc$MRe15+Qlel>q8ju5NvO7qSj@!Pid2wZq3>2 zm`2}&SD62)xqHXOyca!kXO3<4Pw?iuar1Apq@03;k02)I%wicf z;>Q#$edBRsoIl0UK|~UW*nhccXdbp;3&W&tBQJq`_QAw{-UsM3R{2G2BbY255Z6zM za`~RFoKbX{8i3S%*}>BpCKDv4#e>x)FGkY(sLecbZ23*;8(gK1;`r3Dl)tE;P=vl; zOq^^b#o5I$AZ%OS&do`=;B61-6Hj%KU|$?OESR+_E*?D?x3o#RfKpaTEX~M>IXD1< zNaE(PuM`v9WXU_wdslTwMi>{XBj!V4VHjj_I85c=ka5_!(c0z26xQ=ULDh8jCm!O! z_5q-yL_HmCXh>@HAc%auczDlC*lQmrl}J`*%PsLP+(bzN#y!PY^7mBgWZLiFKLGI- z;%%7JPeuT2`iYFk*gqDsr!m4+ox_s|0=m9bA`1y%$SD*MlTlU4kj30=@5wLkd0CnF zGr>W181de6XnKW95veFiSqTG*&Xl`AobVV^DC`?6?O*+C#HFS4WSB9I@gu=hvbv7Q za5IY|8j`RFiK2WV8uXSw!iXg?{V;$|Azy}xEM#zC>LZHCjd4LR3B%ktySv2%vx?|& zkULB*L;cw0;(s3Ff1~I;g9~S29c@j8Usl#*Qke8yjFmnEdaeIDEOw)#qvFAVg*`!w zXa{nEzwwDM;M_c!aQ4-Eg_mzW(jzlqqmerY7pgqn-bRo2<&s+344hlH@tqW_+Jctf z5-~zps8LZ!on+wMx9O<1L)9W7ZZs4af}!dyl$N>3U0tISQW7xZUDgIzpVV($8%$`|-D z82&x>SsYq|g7|c>N_=EcO%xakV(rLg--UKJoQ{l}O+Tr`>MN%R)xkMA^z^3oWM(SIOgh~$B9iOlmrLGa$iIohcEpV3839K_?|$KH}f_>r`{E-mwFASX$Ema=E_Y z;4R&VBG*5Fy|D~zRw8h%MubYiQsFp&2dZVhBHi3XZz#!xdLyy2Nq1lovlODi%Z~>$ zhqaB0Vl$;mfgC|rYAVD{tLnPtZ(_xUwVT51s-eqzO3EB>1|uU`9N$GluFXsGq0(6U zcGbP*H04aN38rUv2U_W~7`YwTq2NN*+`GNH(lchArDSFo%ig{*hvA|v`OYnlpp%OE zzkCLY0!Bpd>c{|{e&M`8*6i$Tjqg6wf8?MJP$W`k>ztN+DCrF7!6X()*aXr$X8NMH z6PSvN>2uIM`Q!8As##OQq`(k1BT9$**6eg-_)jdPYP#Wl;>+F9AAt*67M(63Pceft zceMZwXllCEyz1C-T$u{K`u7*Wmw+cC-S@M z6n@r{{M^Nwu_^=|>mjQHf)FZSpyHwV+veLoTL3}tf2`-^H~$;5_bW0y6Q_%{HZ;)( zQ%g%~4vsp2Vh|E~2IxXN`IS`}-2KPenW#?`uMF4}99o{>eRfrNsPl7xJ{bN!S%m~` zXCbiJ#SAl(~Bkneu|3YkOeKqlhac^$F=nIbPzcQhci%saXYcl*&lJ8 z*=sGSp5Ws){}M}alS$6KkU>;gk5ddH8rzI2#uL{ZgiSA*Ui$|3NuN-WY|*KZ*)P#H z{t=}hRV_Z%G?0O=8#UG2)|UQNa)h0V3buD^%XF;JYG&u7#3J(8eJ3uQ*`HG7k3If7 zSa}aCi`}%IS5*ZBCs$Xjd8*rf-^~iTnt0Sc7da{Cm(khkqFww)K^{0Xw>I-;?JOn_ zY|NRnF(R?Ae{5Mj^srN+pV>bhH}mYsi8Pti)5W*{f(StL@8Ib}GGc6$D1@WS+b(0B z05O9RdK&|S+EUt4>Q_^3?N3=p(&_+1o~9%_^TEcv&}h5T%Broj^ksL~TqALfW~VoB zv(}fOXOj&i@u{gbh4QYHcK_W;53X=qTvx^SGBVY1yA+YGdv8b;pG$ zclMCqzklD5g<>2W96%KtiaaJIC5c42BmsYF>@@|iJH7*>qV3Yo(b3VxrT)6C0mUF^ z&$76LL0S%o7mwnZSXC&F2llUeYcV1V%WqFV!VC{@xzw$#E`XctjO_1m@jAE-KqTGW zFdsfJ2Bgkud{;#~Il*Ri_7)y?0H0jmhJ_IXYxa@*_?&&eV}CnLPWh6JT}Z!jen;&s zRGiW&%+1GSq^60zxESVsYRQ(K6QioYNl(IT30k)&5yPF~yyD_AvL^}&tSpo$g5;1D z?o%k{{d@&-q~LQhc%+rpRV+-*`kJX0LtpWuOrGl)Vh3J>oI)2wri=^)Ge{%%;E08# z)R%vYdl-p*;=`Clh2hn#XDdSwZT1Tc0}&^J-NkTWXqARsK-OOz33kGHwp+AHx6hdF zZ*pHcmcohRX>VR|F`qouhM=Or?==&u17%6_-)!C{euDySamdLS@z%=yjrb+ID^*j zz1uOpK5&bG^UMb}>`!{;Iuy?tv$vc3a-RszV zy?A)=va%|99jGQoKqGbY)lGfN{eJOyBrCQ8%pOBSds9mjPdV)nK#6Lq){G}l9tg;{ zQ`Ke*k#Ht@I0*=>&$=74CzMjQ%;XV)f{>=gF=JC}NuWlJ7Uk&`AKz35tiBC9G(shy zN0Y$>7>h4)pmAUpSlre~tsi+d&^fpGYjCAPtFof9@;vJ7$N0Vr^T~8#c6O)Zdb@3X z5V3^z9}afjv*ylttaSW4)0{!q`p|BQXiBqT@qp4w{7putnsORvG>_=5DKs zz8YpPI)SI5pa$@kMH&RmQKMDqU{UTw^6Yg#Os=l2* z8mj6TPtPe+=9!;ykYILuS60;ZlisDkKid^&cp* zAG*2}9@P$#{iOu78Uk${*hicv{1idG9GvX)=RA(Lc5Ke2qH zuW4pgk^y*U&GFVNa2%XXT*AeBz#U?Lax_P?WPc`oS6PAo4f*4LR$)^7o*aTSCK_>U z`T7QEEJ`IY!eu~G*2#fFh#mS>vAqX=IPns*CYS?;9Jz3h<1DA0VD}3a?64LOEhRoRzC8nBwnrA@}w+7wZa0o`W2^@P$&$>CH8zh9O zCA=0=rm8kB*OoWr3IMfLQ2iizgRHX-Ny*YxdZZpkO?qi-eK}2v`8DzbYLVbeAHB%R z2tZdu5NzSd$Lna>#!(-ynype*M80>>%q@YPT7jN-bBNEDi$m1zfKb$^Vg!t z(b;n>M%hW#E!k={^&%pXQi-S(T{zWQIIJYg)qH3vYjX|}Z;8xKDZN)6)Lp&YI6`QG ziWHwFNZAbx=Z^#T-!Y0k)0*Nh`{YFVSoY=rhljwah|@Bw)Weq4z$tLORk|Iqtf7LGZ@_ zfrFo4o$A=IJxt{MdOJ^shp3eE+X5FT!Kvw_TuuC~Y4BkpgA?i5*Fy-9;jc6~0afV0 zOqrOXWI6?}PCp{X2`1XRuY?fE%lEl27E~b@hX0laL>lT+ z*4D{6B!)qgp%AxQv9w7K0Yd5wbnLG`>=LU#{(u@c%dKYJJ79c-dwguY)87O13#ds+ z_$1Q4!bnJkM>7E0hC{FD2d63}{#t=Ypa7kH(1U=*ao}N&&WFlGXt& zVl&59D&mRy7mbtLgO!>nE#v)x`p9g_r1Wsv|5w#lhE)}GZBqi$DBUeBlG1YMKC~h& z-3`*+C5?b^=RM$FJDFxItTJ|PXk@X&BO+M)75>tp(85$|m6jAigjYdI zm#h>~<0lgV%Jagh`qEyla#O8eagx3*u2D*L8EnrgFW!{MP!$<6c(vDGne%4SJ4l%M5t?5(AYKQX7SrT+vO?g zh0c{P`Ax(MSW|o|g*gZRE)eI=)AVG{;*v9jg~{mZYEt2*fT#sG`gU+12(`gy8V?T% zwwt}YPZw+e?c#ywn3SpSfSu_@p_VZu$Tm#Q)~K1DBX&n&b3A$244&qA#eQ`(u=@9# zI*Jsjua>cy83ChI%^MPuaFYec9RyBVKXDxDZ}k)F01Nbf$T*=B!n_kkKAL!uOKOk) zeUeQ~rbTdmA!_w6(O`T&3{m`{bR0(5^qpot6l`!iDj1A`P;#McR(m{JG#tR=0f0}B zm7Z$9LYK3S&N41-fiPm4c(jlunjFhhwKT04h7(7T*{XkROzX(9n4Q z(85tm7F9TQ{Wj_h=)Q@NBa+nAyhg1n{bzPRSK}>mI`aN*ZJ+Lydo^8|y?;J*iO)Mx zim)*`fDQB@Zb!QQiQ!Opp6z#cYjs(NYu{p&O>UZ0HxqNbrYMj#+E`D>EdP%EO!|IT zRY&yKj+!X_UVi=$mV8M`Ik|+m2m<24M6^+CTGHQ-IkleLgI(R(M}&1@S}JP)?XBY( z!!Cj*OqmqB6e6Fp?anjzE0%Mp&``VR_g%Syzb6SA4!iH^!ynScC+ve8FcnftDjA=z zu61wUy<cn30slG&K#EL0ml2XRymG6M`aA3dOmDKwxnF@|SUzs3Q1{D{lz@`vVHXC*9bz zES$uNiE=NsAGgYBAFz6BKTJD}jpx;Vaz()4;+4}l!KlO|elqr%M$=SErJs^g!T;W4 zHATNdfPXK^eW*!-nZ-Ap{+lL@{r9wC>obFwOiTr<9iD1eGHU&7)k9uwUedvqh1F1% zlH7pW=b`VwvLIm{tf|-Fr|`dTx!4a1&@oVR{<*&|kCqz{X8>CsUn${f1BgPXD^O&~ z661K7+hJb$D0`I=MB`0Q*Z|mElk+bqA2^vKhQpp=O}0rmBc6<_z`Oi?McdlVs23Nb zVYJh)nBTBHjH~?Kl&4OO7o?6LhnNg)OP0*(s>WZm+u2RGzCZ3LK098SlE}Vjq~NcH z)){<;z%oea#lCP-<*uP-zoz}Q&kT+|Swe-9y#&FmdL6pDgbH)`G4eyAM$B8ok#s6q z37)>z78rsb-Y-B*XwGS%gC1IOfIlyvmLp9TluACj~+QS@(KlN=%3;sCLZ769r;(8u!$5M zrWN|wmRjhf)-4*2o*QpXaX2rrOg;!>?yX}vmra^SZ`N5WI<~W{BLYIFYMNWH$d|&u zN5aQ=*^N0lIvy#>u~LfN5U|J^{Km!IyRscv4lyTax=+*44r^ZN9nY>K1~m0Jia?r4j>*i=j)Rm3W0a%? zUG~`*?`xTTJLwphXamPFwcW80M<+h`WQ}7$GC!2$vo`#2#;dSTK+@14p)Rhvz&GDL zFY!dz6|l5b+HFw;X)n8UFK2a)Bj%KgCy4s`sgFTWUQ=^*J&NJ9sajs$h$H*au~#c2 zc*H50SaWbX42ePvi8a((*Z`io{Hj+O^y%_44S%}oGd6;c2?fPy85z@l{$5@&*)&*y ztBtLBPRmF5{rl}78Z1=!Hc6$HGT@MRj-T@Md> zHbq^+Z-W}`Po{8!$$w1e{o_j4XIqGZaBwicO!H&gI+KSNaC9$fu`DNDa+{iaF~yFr3q=kF0dJ>x>|1^u>ud78mh{*4fG`B`TMrTj*h)S zWq3uA@wKfInqiL4&(6>5SmPCQP=fO$Y^RHd>#Xc$KDHj@iOUpDfH7-G>S?ia2{Y?i zqZt@@L=~878OL~qvQ8>=<-TF`P5^Y?R0VI%X$PxMV??NFVx&b2M6krpAhZMb!95s@ zJ-QVbSTR{W1HhFDT=NKEakwtH0s9v*@|sLH44G@`ih{he5G>I&)<{wh{Ag44w63ni z;nfg!o<4|+4{)l{6U*eV}fAa7TI)kaWP9Ty`5d1?+`+T9%=b6e7Cx~ zogn?l$f0o=oitlva*+PP!l7dfz3?jI3#?;}S>_AGc=xUbzM~?QoVIZ}kB`2im)Djb zY){glc8W%o;49!>SUnMS0@Pf*FK2c3_xAii1k>-(#_+vg&!d72P)~}9fBdLU%@J`E zVv#ct5{601l~71hYQgvf&?UK~WF_qrjz}1M)ua?L0VBZ4Nlr1poskxiO~?9>tTqe& zu8qRTc^4N~lE6$$Psssyf31v{mzP4s(-8#nfNW6ed;8L=s=r4bU73waW+K;X!GBh~ ztFPjtxv<#4I#|0ju~pjkq7W4&7^Jn-`V}iMY|w3lWrEt|+3hm%>uS-BN?tbHR`ky% zv=maTv1_CI?)Kfg^z__z#^0#l8I9{q_74~cLndTDeOQ_f8diXN%uEB=>1~OnB#68K zKwrDvVpBl@1A?@)^v%u9U_7;nXs8{Tm=QBye5je)@ux^exe~R*yLkgB2ZK zO_Ia&#PVK{8E0UI+eVi|be)}P(Al@eQg-*$cP+aDnAIuhHB=IvU+=X2_(o!Tih!Ia z!GET;wMHXNq4nxi0$QaSz8wL@qvt>)kT1G~}(x_($2o#%} z>!FwuTU+lEuOB+&;sk?k#hPkgZC~*I(#VdD?d52W;9gZzQpScho^oTU5o~XPSkiKN z(~B3vmW5p=p)>Zxx3^OIlEVrK+ulKe^?gY(r{LyhQ<|as?Za&okK5(d zGv9{{(mU`BaUGR~(qH#ETmO+y?KW)xPG@-cZTmd*{jH!NP+O8|A$Xr#Hte^P@KBU_ zL8<6tXn6lEwk!=E7H${9`oU{~UvQV1H7Le~rAl{`OV&zMjo^s{dh>-&W!+41$4^#P zipt8{xw59GLEf&sUyR)B$;s$a{AAG-6tmC#)txS_Lp}N;nWHqr5=?8QZYw_Cm{hm6 zwpMpsE%a7*baVg-E@$EwFJ4r?Z?4ktvvR1118D6_{J7y?jv*hF5fFea{Do8eTw1zm zPCLq%5{W`m5+`1^>24qC;h~_&#`#%&ebc>9>%JWvE>zrYMZ-NkF(`UZ!~UtHeZ$`!6I#hf{3-t*XjR_~C$(L|Y`6ilSP)Yme*+c&KBZI45)T|68g zR|)U+TS59g?O+X2j_sve6q)w$iHMu{L0jbsgcrVu`L=a*Py%9OIC5b3<-8$oZed|z zXD3y_>hT{x61CmkT|vM5>)XqH5F_n38cIiizAG)w$RglRFvCq0n76l;GAo=OjokG` zq9gf>e9e>p(BwxA3DNnGJF7-+ekQqx6+$AyQ~4Sk3l*wf*&k7873p7fIx#8@YMOIr?fMmc&-DpODbf;f1mzO?W{UVk@oY3WscrDk|Mi zy+FBE2`XHxFL4v$U#Q@$7_=?q{U^jVaHw{X_i&7z(VGq)#+!Zz2U+{7#0-yimhnm% z+S`!UPM`widzO@AYi;cXGC>OBS&D{#&(b6jX8~jy06??F{l!SI{+@)3vuk~^-Fnd= zFSBUN{tBN>C$B?)V0!Y|-rusCFiaFVMMdBp83mL>2!Ga5v9g{l*qq$BR;kX-g}Ln~ za{{izgRGssj4^EZq~$`VO3LBorT*;fYd?xifqlV5BRoK?DOGC=6CrUtr7J5-=8SNg z+HYE|_j|ZyM4Zry-a7^Af#9=$`40cvCdlV2q6O?(^YZW6qFb1AiBxEw!n$%?Nf&-b zBtA>w=zg1nyH}%?5fv{hfvEew*1hseu$o(NN#6SGtO7BB3})^TrqrZpvv3S3z65~8 zs!|whWhHA^0`#_r=5wag`Iy3d|84(vqfCZTChqL4rS)_dLbLOzvaFV6{plq0^bDzv zo0b;9^=$Vjsg|?HJDQ^v*w|Z`;2{0qSKmEic{?S|wv|M`F9~x~^ zc!|k3HtMF-AX+2~bn9UWc>KHV%gpRQ#D%%! zsNfex@erb2wqp}6E@3vxhoe1paXtL?`;Tt8uLT9S{z$dZn)aH1IF{AW$p2Sog~dFc0TKZ)C#(-XUZu^3Wxuo{H7)7B4e^&TmL-7O+sE1_GAvFfNK!B ztZZ@$=I?s(TRxKbsi=|KZ&)rEgu1+`S3g9Bysl5Cb;!u%?s&7ss}sX1dy&oqBd$H& z%Z;R5UA@SPRXBWWJHPC#K=qQVpAH%Ghu8~XU|htJ?;|eaFsj*Qh^+Z7N+1e_vD?~=55R!7GH-2n@sP8{O)#Fa@S)RK)d6&9{#ZMWf zRK&5DdQUO9xqnV*kl|BeqXK@rPRCgfT6zX;TbijLNMH+M5D?U?w%b#ZkzJ5uAOQ8U zweFPc^ACe^BUt?Wc{Na9`{IHVz8*phOi~9Wc?lJq-6KlDq@>qQK*RIyPf{2K8JQFOSGtx_T90pVD&u^?tORCI?{}U0R z$`WD0XGsAOA_l%m4lYvW$sJUDnW_@cb7de(l0kZZSzWN05QqQ*T2T$5Ytx2U^#CY9 zK)mlCpn!L>Z6W@buy2po0jJSbo)p<-xPg^UcOUqdy5AMSo#mSrszNE4iHW&UiAhukVF z4~;RNZMR$y=TBjmRm<8{`sE`cjE?;h=z?LkKKJUb3Awn5f+Fi~_1#|H%F0SYmBY@r z)eKY!&KtT-bGz-seP)yifqIB}?9muAXP=fa$)jP!UAyVoVbUD$Ff0=b)R>~3#jwO$*Y6!#a$A+P1sa#!? z1jLd%ZN>QI!?u60R2bq4!~X^FZ6QCoxj8s}Rs38_E39BN!R3~BSA~%H!FjI2xU0DY z9pF1Ffr6Q4yi8+>0lJMG2zA)u$)qxrR`gHeF)>|`V`Jw*QdB(<57qDcY{ikln3yvwfQGlhHeq9RmZ z-vT$h%iit2P)vdzgpr6ZClRngj<|Lx;v(dL+whK~D9elm??6wO9r6@Mn zX-|@pcJ}jYRym2iS$fhf_O-9P0e9j(@zGCDN#v-gh&bG^n$iC4FeomNow)MW=d92t zpSziy1qfFcbB+xXbr7Q;%Y-|;Wa}G^v5o#n|Jn(OTtMAaq^Q_t0WH?9tckI*z&Ze0 z3HDz}9}l&($de6t@c79TUPEGom8nc3N&aZ^%PQq9i~UcWX%A8C>J zik;*K!0*(55w|BkSYyb`1N4|RtGT)37S`uXt)t3{{`U^BE<+8WPF6p0mF(VaFFi2`xfb_qMkJ;?zxc z!9hsBJ~W+9{Y2-_T#OI=aHX$ax+W_gq?oogOb9KPs1A=nuh9ijgt9U{5vo2eE@Px0 zbG>=eE7)~SMBieZjSu+_0EeZiWYh3f8g z?5v$n&0xjCgx9c#hmm9p_IspwKmUHUaY- z+`?ydbu?`IFyfgRS~koTUt%Gltjf$xOoy)^)Mg;Ey>lG?vMWTZeCfSn^`9LH`5ef| zHbbPb(KN&Sc|bfhuClV@Mp$!i%_6J_6$4|*03SE>3$)z02Wj47PNTT@bi;t+LrDjv z{nDE7<{V9G;r8clw%$JDUl8I=sr=H8sJt<$I^8TM%Awn;|66gtk8NqA`)Yq|*hut=w4rM2p2yq#WGs@sH(w$+H-ZjgavGtA*2AJOxIsNjKH~$mf8MxU=`nf8Sl0LYS$bTwnxZ zS#o_k$;2_{w%XeZDXF*^mi~3QKlzinU^%782I-~Oy%Vv(c2JPfg=ICbiXp-{-iw^q+JrSj0o=de2Udu9I{MiMN@ZPTu+r!oyrTK?z4!a&`_6nPBs z2LcR?5Rnzh8NNVbE8eQ(7y=@Qe)hEs-+OkbK6bn)ld1lHThy)GhgCAEhK;02cWPKR z_SSyj@@-3Svl3#vsEWawmwZ2#^;9-KN~8f|!=~5HkeTp2W+Dno6&hgd5EbyYd*3Q8f9(Cc-~ zSIyo#cm#w`Deh3~U#9+iJKwxrtOCTv^;}=MDH>A$_<{bF!j$AIos>aR`p)gD&AL>} z$LF07+F2Yct;n;pC;iWnbc(GkPK3mszZuU!mW>aBvyT&X{Ux(sCHkw0YHldSx$T3F z9#E=b{LgQy$@4dQ3?e5j zUDAAI!c+5X*+1st2J;n&rQq{hH1_rcL-pA2t+?1j=oC~vI+XmxmO44cLptp203lr| zlgZI-_;ErdZt!p$dkK+X(OuBl*oK6m#xo6eOTt>NP5p0OTO1`qjGI~6X!*6TDU5r1 zsK&TL!?;NFbcj|cr{;BY+Br#XJCj%?a&2MbT?ExdV)IlmxB#%+rb)>{DiH^m&|HPCe?OflMrJflLA#Ih%*O&>Fi%_3 zN2Ho@do1{T8!Q*v_czxcxH9y_+qWpp4P8Z4gBx^#N`QWQh=}&jRovq)T$e3RA$}?| zFxljgCLlvxP<141Y{#t_?_>W5q2#o_M8@1%jEE!eWWIR05Q{5hWLN{i)sb7f_=81` zgiZOr#Ij!RL3G?dE2uN~@9jP`>XvztaVH=vS5VL*T5^!jJkt3(^aQ}KfGq$04=Y6# zY3YG)vE=bl)0E@$q_IAV$uh`_X}!Pt>|Gi5_ks==VJ&ahG#YU84l1B@K4jm}`oHy# zX4KealIx%na{>p6{XG+8)nl|%;DkK{0SZNc!GIdy>dFQM+TB%8hc}mZ)7s7vCdSzX z#ln096rGKYt*^H?mE%4C#Hsv_ga6&)Y`KmAKfl=BK|PS~Jr-Flari(YutgaY6H=TL zChF}u+Z%`TvyHGwIrzX<73nK3Zs>{;ck3(b$7|r&r2G_k$es)n05BInB zNW%F7rLN;`dbnyFX&osJmUeI35;k(bQYW7&r(AQv< zr)(1*4sn2%(g-cYZl0ghic_z6VUm$ka`rhv-#tac?LFJ1Yd}GGBZq#KbQaa}THv;( zhCMkIX{6WxFLFl*4spBppT8C1W@hUmr$M36fZW_%n&RvkR#sMZz?W86N1)+*{1B4M z(elq7Zt7HpL=*q2Y+m#KM}9kB#R>G|t`3746-D-V9%#aPAUhmKI35DVNbI^OfH?C- zbaMG&GUqi;m0lpY;PYprO@%)S70=VXUOvTgJ#N=xHJ+j)5qt&|&{VQWZhc_07&-np z=hUApUxi9jDSB2@Y&cZ^*t-#bbN#9+^PWyV@+aEx3{ zTDsyjqZx0Vd%Jf>W^l0a0LIoR=~jMxz(z~I6hBQsyGOj0UFiGfmL)y=6%lA@KUrM{ z=F?gptfA}u%jE-}si}%~D_}YKY|=LdGn6xFM6#me%(Ymns^hI}QBtDV*ngvv^$iUB zS(fO3TjdyZ>df?=Gc{SF)bc+w9U3xXWljGu*iyiNj%`K~w!dpkM%ME4?a^-WaSlRc zvTwV=#P{p=#<%PggHB&xuxl_ARFwCmcoO!0{`?u}AjleuJFdO?Jc8JV5GFNRS8+Zu zdD$J}<8ic9D?DDcZ0~WV^KQnPG#F7xcv(N5oCoz=jIr)}SY>RxTQnx_HaB-mfB#*d zWu!nRB{31x`SDzMy#x0vB<@0Wrl@Gi@ z3XH3nIJC6RRY3-H5Q~iQ@o`4QR8ak(Yxnrru+H>5V4e${+^!Eq3)n57ATT9aZ4Rdl z3=DuMu&$HSDY!>$o~!M-o5`ik$ukiGuapt^E_$9Vr%-7vyOi`NoZeTg9zOV0oXAK> zpuhy8(QKI(0@u&r3&2#DT=MAHSn=G574^Q-YjONFt78b_i=Er#muNEdTrn-NcP4q& z+vx?reK!UrN5=84Qdk zM3Cb|7w&=5*!=|SaCxW6A$BXlg+6yY1QhM zsY{kf83wq{>?j8gycfIe@IU5p-@QeT?1jkjjEXg)+D8v1XnX(bks3ClWx&7<d?~Pp80ZN{}TM;myYs23~CL7Is5p9%^iH8Wx#&yjq#NkNupt*aWO+Bk*m|Wd(SXiA7UGN9-}{4-(eS?bmTJ1&&*YCcjgC z{bu%V7}-O(Y097Xtr@`y&BclE5e+_TsgQ`EB_>w5`{W9NVKIB7eTO_?5sFe%@fG!M z@IX;sTUZR54fbVlAis zH>Npeo3FnH`zK9UC46USH}HPe3t>k7^ojeHxE})kPS86fmldyLefC{!Sy|%oriDS1 z&}j(-gsWs)39)$;S89y!-3KGcM39dO-~ZxKs|q3Al3+RSz9u7<1z(3u2hkSlfhR)s zbqbQ0j6yF9fhLfb$B@wakqil@68eYWhXqdMgY!m5k;-W2#aA`-MqLu|l@7MA5$Kcq z1M&SHLmQd|k?rDKSfihxBrzfO1;DWun|c~;zG^GUrRwJh z`7qe~`}-f^H58QYc>mG;3oc#)3qv}|rGtrV?=B3aH@56RJg>SZyHuRu8NJEX?A~!X z4Z?3g3wc#dSUMpFo<1T1uX4lk4FV98m8`bpJ^7(g6(8m)C>IqG-dn&hH14-Un2&Eh z;od=KoRcU68S{WcfyZi8vdB zOob$EUw4u!j*ASRpNOfs(0gz^LWxXyIB^`Bpx(M%H$i{u)MR4IZrQlrzg7?4Zy58V zv%c{S`(N>ro}7w%OP+dUXhM1omy=K&(+lDIm!AbD;5|SuSw=EzQlJKOj&d`U0d9|I>WgNO1j z-%HhyN_t}{_$eU@jcAjx)xP9{7YaA*>x0!eUW@;NC9qG_ zQRl8zGr-HMP9V*^}_pbB=?<~Wp@T`9|q(NWjaTurCblMWP_xc*nX2$--KPd^h9 z(%sw0>)u}DFIlm1RDbaz88$v%4aT`mbq)h}=NFf3Ulv8H$doF_ME&tS772oD+b?pt z7fL6tGk%DeFk4Tt^__&Hpgxm#ZyPLkrfPD#^AG7JKKe-yy|_a~9?ia+WFy1oM@`r^ z2A*a1@?UCRbF3JuheFJ68KQv;_0PX#X@F$5eJqWCXZ`qM_CWah0BKWPINy&ht z8pxSjmvwW{;eRwh|ESJtd}<=6f?7{16Bn{(6yLNj3*J6x71UI6)NjTKMZhCM)hNbT zB6_ym9g$yIiKOGPqP(RB=*}n|F`mxx&{EfzDOkbVo$!%apX_^_*GUe##j_FJsiKn)BlI-Sz9QB#(FY ze7%~vBFVsnBVK}XMjNzGhjCosn{b}XB9dPXF=jJaDoFw9rQOJ?l_oVl@7zAzGji-SWG%#X}-j6Gv3 zLw$nU;Q|>nT$92uC>kbgbjQ^m_fLRDs9)c*By5WL{)UG^;K-bMB4B`iVM7-9LRJnA z@v*V9SRQ>{jg7Om{J8fO>ZR-YDv57+^6~9gx7r;|8OHP0#q;vszz{NHkIy^>cT|@+ zLehOtfzQuDG;)2q@lwCdwDzsFjm--zf$G7t&5?;5acTkr6a;#inAfg53EPX8@2935 zZ@5=OPb(&Kmb?gc|<*jE$D|-XYr2$thRcn~$Ol^yOVD2Rpl~!4t$a zpt%ilnTPxP=RVPXIAH7A$azR7p)j3ZJ(&=@!oo|Dk|f~9I#27mH|q<-j*X42{(3eH zARUUbip~^&K=xf-hA6Mp%|RX^1bu$ynI*Z>y0sGBC=N6uZu5TMw@|>B85Rl$_-!&q>Pc+_8+CJ8+?};LjxO%G6Aajewq| zCruY=t~|vqbYBIMWL4^=nrBp&2IaGDdg;gB9Vfk*@tx@@DFZH-fvo5V&tIry@mfuP zPkKQ~2uU>qYGMQDc8J|(NfoLJiW@w9*-XO1LofgPh!$7RpXC+~3~-ah@^g%di;Lk> z4A!!f|MriMGc^s6L9Y6Y0%{V(7*x+%7d}<6PhQ187yZa7;C*GQ)@0GBn+agEPI6q^ z*B59S<%h3ct>8Y9=M-CUqg7Jqy^*y;1tejb-$-3(MN54>A5J+yRHSIUAZv-0a zWsxww*kE`4%OXZ)ZKKbg^qEzjS$prFi}B$Uwuc&JNj+T-DVg5O{qfYEQ}>6Ijm-7czJt5+YtNE$ zm!>ywNkT$fU+p2SOJqT=*P~yG-LA)w@}T;mqoZGggC{50xt>uU=ivcc&^5jLraJt{ zJ{*$-3s|v^j%VLO3f9kf(LH=#p7e31`Ssq|^`1CpCCuaqPWXAXX*$t-mzH|-CZPVw z^mGA6C>=<)TKA({oF|!CD3V|#W}Rog`RZ*$zuLz&UROQ4UJ|tu5DKkw6|$(G`30No zGBXXxM>7o${rh-9sPGDe@dxG?#mbO#D1?5n8PY1$VYH8lo^#54wOxU4J=5Xx~^V~wE@Y}l%0 zSIU4ell==1g{~ASkuIcp?P)?_G~bnT{!Ui+^l;fzz@P~Yu0lg2-a9D=w&=Jo2x9;B zL6{v75plCoiwf2neh|njdhZxaC9~wJe~LzxFE81-yI~?loe1c_z=Rzre|GJPWalR$ z;-I6%P6XvK{#bD2a3L}&KmHR6#T!jWRA6LIsquV85?g?LW`Q;6Km@gVTR9gHfPfiK z+KRf=>6@9FVF^y$Ki@*jseLM&n*|scLNulNr_N3*wLy6TszXk>kwI#lK__2dUrnrc zON*Et9g;^x@7akm$7Bw9m5#<`htO0E*XR?IdlfVmk;7ULOa2s&+< zF|8CjtrQ=72s&*@$<|`%Nw&v|m6a7O<&#(b|L#_SDcEHmT6=B(aC=#hPg7J}ybb7a z4B)T8hJo@>RJ+U(H=w*24z-w)5QfR{$jE-yg#LlpDrX3w@%j1sia!2eTm0Wg;5tpK zB^cMfovVB=3w~N<&~baU=#Uf_lwRF=YYhtTJ+|N0b~_1^1mCujRK-e5OY#4R`nKcI zh2TM`dLa>bkO=Fy==czHHDv?(k)O8wu`)@o5A^iQj6 zH2{Ku{*;}Y{pPESfxs*+Eo*cuMbeIskLR)C6cwrOudh$#WhGDtoj|PO;UpsXq6ThD zF&HWQEgiR3w-T%Gqzi#7Ly0r((>x(97-5E2UuFMS$FVUV|MUM3JN1!=>&_(X?94fT zs>OM8_~gWK`j=c8sOxsII|D#fAcYYdAOC_fuHeA^?sQ`i1iZYxy&q9=y1ELp$PCNN z%kA!mW!2RdBuwJs{yjlY*cCT+4|ZpYyMQgItK()Z+I|=>R7{Jb5*50(0g7sxngp$m z=sUZ+@H#U^Nl8gtTibWLJ` zFQN_a*Y9u63qE{Wcr2A>JER&K99^7;OJwZk=z-Czf~fc@{SEp1Ir21drl#ztQd6w2%1 z+YUZ(_Xe_#09(g(a^B*!(PXzMBg8C^Eh3kkoUCbJpdv(6dim!Mu8&XL1{payB0xQb z+R7DBi21yxqYH8+K&g0JYXYdw2w+Mm2@%QLt$h9X_x=VQH#0L^@wCYKO7|5M zkn#0>7|q~83@}d5;IYuw)=tDxP)V;o=RB= zuar{Er=_*^td4~Ilpa->uzGi@j=qy z%-o!Iqb@)#2%VHqSr&ZMhFHT7uO8X1W1soFI=;BFC)UAjfg&Diu<-~8Y&O}_f|u{* z<@Lq??~QUM|0^s>AtIy;uZI$~{I>RXfT7C%^vUT6&{^>1i$Pbx%qdJW0Q5}2JRYBz zs4gkN+aL3-tB+AA1nmMO%g_I?+~%g3 z$_^l)Ma7|O^Id;0>nFrA6BDNw7Zt&ci8vpF8ohxz{s5TTd4Dz{?0!H)o@k2t_dD@R zgZp8&YJ>olVsG#YAN3}kR`ilRKD|{^iWxJv0gb^l&BTZCu)Lqq^vwPU8sndTT}$xl=l@LSF;k$@sz?%mQ#7_>+4|M z4)pi?TujMcG~gh1^Gt}i07Za$iwPzsrajj-(3FL#X#$P{9q120x&n+|u$CjJ&v$V_ zdh>{MJsqS5`AiRYcWo`L2jHGQM!$A*(RU6HXLnu4#>Ob#1bIAq9cG< z8t@58@7;b6eY&{F0@WHHE8tT3F!JyueL+<(pS|4#PS4$8vrzWqa4ZPk*z&*E*I(Y5 z$}jyKQ(9kt4qQo4?yt7CHtB_`cBv*99bE^9<4^Rmnygw95|&AX7RtfQCKJ*Z3y0M&7=9xBl|xW{lgt!N$#(TIF|yIp%LVz LRivsQMnV4%a@Zek literal 0 HcmV?d00001