From c5863615e91508c221cbd0793d963e435ff4a733 Mon Sep 17 00:00:00 2001 From: PascalIrz Date: Sat, 1 Apr 2023 18:28:15 +0200 Subject: [PATCH 1/5] =?UTF-8?q?add=20vignette=20"Performing=20queries=20on?= =?UTF-8?q?=20the=20=E2=80=98niveaux=5Fnappes=E2=80=99=20API"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../vignette_example_niveaux_nappes_api.R | 27 +++ inst/WORDLIST | 18 ++ .../example_niveaux_nappes_api.RData | Bin 0 -> 201569 bytes vignettes/example_ecoulement_api.Rmd | 4 +- vignettes/example_niveaux_nappes_api.Rmd | 174 ++++++++++++++++++ 5 files changed, 221 insertions(+), 2 deletions(-) create mode 100644 data-raw/vignette_example_niveaux_nappes_api.R create mode 100644 inst/vignettes/example_niveaux_nappes_api.RData create mode 100644 vignettes/example_niveaux_nappes_api.Rmd diff --git a/data-raw/vignette_example_niveaux_nappes_api.R b/data-raw/vignette_example_niveaux_nappes_api.R new file mode 100644 index 0000000..b37f6fe --- /dev/null +++ b/data-raw/vignette_example_niveaux_nappes_api.R @@ -0,0 +1,27 @@ +## code to prepare `vignette_example_niveaux_nappes_api` dataset goes here +library(hubeau) + +my_water_table_code <- "GG063" + +stations <- get_niveaux_nappes_stations( + codes_masse_eau_edl = my_water_table_code +) + +water_table_level <- map_df(.x = stations$code_bss, + .f = function(x) get_niveaux_nappes_chroniques(code_bss = x, + date_debut_mesure = "2015-01-01")) + +water_table_level <- water_table_level %>% + mutate(date_mesure = lubridate::ymd(date_mesure), + year = lubridate::year(date_mesure), + month = lubridate::month(date_mesure)) + + +vignette_example_niveaux_nappes_api <- list( + stations = stations, + water_table_level = water_table_level +) + +save(stations, + water_table_level, + file = "inst/vignettes/example_niveaux_nappes_api.RData") diff --git a/inst/WORDLIST b/inst/WORDLIST index 331168a..c2a3831 100644 --- a/inst/WORDLIST +++ b/inst/WORDLIST @@ -3,9 +3,14 @@ ANR Acknowledgements BNPE CMD +Calcaires +Clain Cofund DOI Des +Dogger +Données +Eaux Ecoulement Etiage Hub'Eau @@ -30,12 +35,14 @@ WaterWorks XKN annee api +bassin bioassessment collectivite complémentaire continu cours customizable +d'Accès d'assainissement d'eau de @@ -43,6 +50,7 @@ departement des doApiQuery dplyr +du d’eau eau eaufrance @@ -60,22 +68,32 @@ indicateurs inrae insee io +irstea +les +libres l'eau l’eau +marnes nappes +niveaux nom numero openapi ouvrage +piezometers piezometric piezometrie +piézométrie pkgdown poisson +portail prelevements qualite souterraine souterraines +sur th tibble uri usuelle +versant diff --git a/inst/vignettes/example_niveaux_nappes_api.RData b/inst/vignettes/example_niveaux_nappes_api.RData new file mode 100644 index 0000000000000000000000000000000000000000..b4a749597e5b6b32677dbb5cc1b2ef7f11fe01a2 GIT binary patch literal 201569 zcmeEv3s@6py8nOIZQa&dwzZa83fXEE6*b%=x1`o8RfH&40U@;t2neZi34xHQbrqEg zRYWcUq9P(7q{>YQWNHBsNQhjc+)_ajAd;92Aqkme{u8=wvwONdXV2MZw`Who^Nf>k z-tWEq-rx6r-+VJ5CjIySZ}IcuGu_gH?8*ERlNG;v?Y%X-Ui$oZ7kr<-=d{78`1c>Z zdhvJViFxRlH}I?Vml|8!h$-Q)Y`WjOkyseKc@92_tt*wLp4EOdySYs5f)LdD>-z}l$uLw-U2 zkTrQAXxBhi@9BYP|H!fH!CjX<^)E&ZmIYfa@4w|!5}4&b>tb)WwLYqHrnaKwWVv6E zKEc2FzK|a^pzFKkUsw}ZczvTe;^;BFPgxUKI|CF&ih+U>^T>rK0hPMaz}g^yP!Z~) zvzNff{F}WN0tasfm2_b;SvwatO=niyQEMe|yQh<6#AJMHd;Y$#1HnJ4^o5xu*gO$M>%A!iHHv+l+WxlokCD(%hT$zrXH8il% z&(mz34qxV98|7V6?y%9X0s;$siA>*0i0qWm`$0K!@Z!8%ZLi9&c?L5d+U)He3~GP-J2cjtqcObsFKS{1}b&#-m@lNvxFD>)oXU`UZ51r z)d=}kEq|Ijc%i#^=_}^;Ro?BlJxG|x!&y=vVW_Ri&xWm3f0TH&x z?ac~ZKbd==Z+Y>&xwz*s@ASNf#emEip!)aS?kGdv3X8V=jj#nfDeW3<^vosK+vbkKuj#z;KUaz8^KoHQoY?R;f-%8r}%M|?{%iqpmUL(4=#lA`mU-|%VrX%RBtI=HXLRJq^pY1$H?suEJ?6Lo z25p#4aacGCpRoeja^K<-;hThlAzQ})MyM7Z6?NXO|_X+A2_)mJXVno6|ut=ap!|WYLsbNnk}&-<^2IXl9T=QV-?p(@ftzH2({!y6J-a@Wz^J(y1QFD>+fT=NmFoDwU7bk{ z5XD4#Uen3#w?G8FAePfvqI9 zySaJURBE@9>Dj9-nB1%_pfdYDzMrRZ^4UF;+HLp39kd~9PJuQ!*`f_+D@b?O z%&eYnjffZ%!~Ne9WpS~icV$?9^)pX){4T9Y;e5z&h+Mp@-797onM`T4mo12Qm3F%^ z^a;JiJYgy^6WrrmD^uh=?ePR2hYgT3y%mLlP;VEAlc&?yzD*kc%T_9;I6V zUgWTb<+M2no^%fLEcdTg2=!TOqrH`HXICJ@0S*-bRhp&#m1ye<8xQZ=#_S6HZ2HUq z@_a`n;X+h)H2N*y0eQdNPupVZa8a+`Q3EMM|R_!+J{_<-7!#SMw^u1|e_PaXwuUFYt?bfo=YE<_h)4RTW*GF12 z>$b}F5@OHW#m+2mX1u%o>{8@-q3uAKl8Jy(0v+Ps2||EwQvM8o^x;iVm(zz#2Sn)Y zBqO4e7k#V}0vCdI4-ID{R$7f^#uPDvQJIpJXzpBpq<2=u;={M<;~*i3hvJ3@rztvQ zEM*FWb3D4%4cpo4a&-Dj_==eH8=L8bZ^O+SYh&eFK+YVl+tm?X z$*7S$YUl{tte?O5c>PJe`11B?MElGX5IRbe!^iGs*1NrlOl#l9<$W3++S0@oPb1ak z$BIjPk%&&=WX;_CYBD22tpoH)Hq|vzezpEee+t!mA4ssKq}D9+^*`^biFUGIjuzMU5eiNL>?2O_GS|}*IxVJ z_wOPt+x3by*DX%Ic=?&_kv$zzyVhpS^jCydhI%V6@`B>0gYEsa7Wg_H0 z&aXnL680w?Io{Eg<(_>jsQ$3`Z1OZB!#tD9IAt@0N29`2pCLN(#3tb_YtG@I_q|7x z2ciWPdW?ln?e$~_2|S7md3gNUR~K_sW`1{q&R^VBJ2P-|A8Y4m4Y^n4tFz>YS!p2^ zp|!~KWWh(}0Xjm{m_x;2g~p_N7Q1Uever*$0#0K{C7|}k+o+HypijNIY01v(qn~jG zY!N-iW@<0&zaF^@*5-B`a@RfSYKml=_fx*TqVJf{-stE!1R(sD zk>8@#YysNJ9Dnf(3nyD@{}m3p9C2KdmudFz6xMj+v&$>MU1LUNs7qwIhY>l zK9{qvyQWn3VB17{XaE&XIHdOv(#LH5_}N{;=gaiJyZ?o`Tlm9Aa&(TYfYX@oFjZus zUGm(c6D>PS3Px+9)X?OU>RZKfxCWW&k( z=P`~?GhMm?(YcI0K&6B+|N0}!!>@(pGFqfoO*ykgLs`-+PGnt-_GS8yUa@G%?HTb+-(!(u-@hK^ZI)SNekL& zs0@7ON?tvC<^H_6kOd57ud-Pm_VD+}xr1YNOZ#PgLKy>?^N2O9VIO??E;;~yJ^2m< zHIkHzuClMs?22reaj38-_g02=t^4lI;{WRLThR1oU}~PPZTG_)_{;y*3 zUEDC`w_^QrUsmshRd(UrT$@Apzxaio%oAw-R%OYvHG$`yf6aE-{*g?120pr#cz!PM^Vs-3sDXJUL4W)2_koxFFb;)_*oNBh+^yRyq2B>sMTW;brGcrx+p=T`*&{SiP+lxDCUeR26q zSLXZWG$fDPibCrh5ONojhm1e22&Z&UU+BNBgg% z{nyd{?>O2Qv#Ou8i$Wr7%LAs*Wc>R1Uyp#Ew3C(X+nksmTKuZ>ub*EL_-h0fkoIJy z^RDUSfsG*#dw%`=iom}q0)2Bs4!z3v;(z`8iom}q0(0?hWkHqp&57p!rUCvM*8f=q z=8!|p$vpe!ogx2cA^0`$e{TflfMagkMF&>d&S`7pLj|jP5zCn2N5e0TZNXRb!iu_F zbEsRO5m5s#jv;pBA1Z2h&7@jDO(H4}$`?EEBZ~O0Oe!9NMH(K&5aX~Phko7k8TB_1 z#O2!&_^>PVx#$JnvV2o}?BUP{O8cOG4ZLxBuxT?O3{h4H%ba~!Y{q1{ad zR3}Iwn&fpca&X`y_!B6dhjnCq9D1+mbLtC_2N!Dtw!*JN=R_-cR`~(;tiz!lO&6(a zp-xdY&x#S?$oeF-t?3+fB~&i*<5lDbI1p{W`(cHL@|yCg4$zEffLFl?z_AXZZw8*G zE{F0(4!r1mfjuiMw5#bdbu%<1s^vv91dgmjq3ul>RCB0Nl)#hZ3mjMxq5P&IsvEQ* zQt~7W0gn9f*w;-bs7oLZ9@YWuhrOZGqUAiZe4IV`@YsW<3)D5xebITI83X4?{$#AR z=`3{xbVKCHW8~u;$l+t$raY=0Bogs>33CX(3Wxa^|26G1&HsZ=h?ek{=9}1K4&xutzSR5?x+glxTgotT#C(EprJd3I z0lF&M&P&TTalnM*xwKr3HS|Q(!b@YA;K2Lv+fX!@WrI10|AzJ_&F`TLqBT7C{7idH z7`~HsNwXg65f$^?8JUilL-_l&FEnpK(L9y|I0y$pw?&6|?fIDwm7QP4giX%p*I11F%0d z%q81_JlGK$=8li`4`;om?@xfpBUA-oM*%EQ*~WDoSfJD^BW zAGb7*Xa{t_YoQ!2$rgAFhe0_!k|WRtuY>})BpYA=_Jh!O>>U6e>;MV4Bs*XfPJjeF z5)NpAmqR$N&>HB2Js})VXb*J3o1uEH&=wemW1xDT(2*I7AEh;F;vouGXalsv=FlpU z9XBGEZ_SLv_t9=>_CSH6YHmax-xd(SArOTpbYRBdhiP@1qmYv*jw{aP+W>sn4N`H1 zcFbtJfL5hB08vE{SDeSUW0LVg8b?EeUJxzgn&x7y0U?|Usdz#h=?Lc`?W*Pj$b?I< zM!trZKqfqbJ@OFV4($-7b4~NGwxpw+N3`3TPoT9T4{lB_)&_Y1uYoeT1Y1%Rr=M1) z@rJ@gUEG{JtR38hvaCswoL*XqW;aCS z5gd?y*azZs33dn7f;C zc0!&a1{aq{wnchj4+zTx?U7E{3Sx0VTj5d8V_LN)9NH`j=GNzuZIB^28e;K4M`09a zfL5XLhsa#e2DuNLK{29XZhaovP8iD>rLi@Mkh#c(OUad43nMvwv{H>1MCO4G$RHdH zg^1W(N}kMC7{eK+)oWrQH&F^#l`FFmMsox-mL?REaX~wz8+L(YJP?PB!6{IxNXu2_ z$?Sw=j*tdw=+F|;Qm#oZ#u~W?FNH8%z?yJ`{t&*R*#>PFrEyL2Ft$h!><(dgfIZjWutRt-4q73ydpJ0ek?8Fx$d`hVALZU|e{Iu$Sd~4c8(W0N-1(3<`tpsnB;p}CM} z#M(KW5t?s(Y!uW#m#RkAtnV8U^+}KsfN8glDKcS9k)N+IMv40ep8}%xhUwrRd|YSD z)R8D7I6q|=(c+(83BHH7WxFwgCJZAcxPD^ft@UH09Q@7F{SU_SKTH${%Z)H=S!V1y z))?qLzlf5Md(arbJ|h4RUN(+{Z5)TuZ1PV%CHPF-ApcMm_8aH^`2}Ndy?@~LziNn~ zv`DKp#_XOEwC@`8;MOmK2am#yc<|Mzk+TQWjFI*FMIieZ1%Y6U<~xo?Q-j)giu;!p zgosd1U;X*!!fz{4Aai?AXyXygDB`X{Y_ianDLtVP$&@08!ck~@e!TdvIc;}ENn8BA zS5$Pcp?-en3WQFujV}IcPB%rOtX)J8^(yJAF`65U&}{ED4(j_5zVG*a z0u}?qH-ec`S+Q0-rT-tC`te4E?kZJ}E;Sy&WO0qYROGRLG~kb;02rf-|B_Q(9`bCr zF#mhE9<`1vdcEk&?Xrd+kvL=*_kBqJ5=RYKjtbi|L`L~3G{)A2@qG|z@)B)+0obNC z4H=_}-WvYEt3!Yhn(eDR~MgYDOE&XvkZ0$A*>N}4A3kY%Sb0ah- zJ~T!%*m(Gn?Tq4Bq|gr|^PlK7?STEWoT*w8?*-v9T%I>y$+LVgRUQ&j5;pric_`RlEq5txyn)A&k4({ zjjX_y#@%$9Sc64`Z*T%x^ow9{6^Tftpld*bdOg#i9$EAS_)B4f$3He1c4vM{YDD*U zsQgYC_4r4Z3?Bbyo{Z=a;UMKFSJebb%VIo91}!FJLp)Cm@!*@NhON54Y%;`?hBFv{ zZomUGX7J~4^*0vApzHgH)IZzcpmY4+>_$68woHmPWDRx01a-rZV$>#@_2=kgYojLe zCq`1#2t(db{}($h%{4FpHTPqaQOECep>#3$Z*B1ZXM{5i?E79&X8$+(0{DXOVKWZ< z=P*K7ls`g(|N3VjK_U1%V5iy}<%d@KclG@_Vf2}}Q8*@x6#P3`VAS6zc8l-m_ML4Z zT0nnb;9t1&V-|icT|bc@eGUmT){K>K7;IJ8C^~LAx3sa+v77`U4`V}-bv4RF($qlJ zC@sGsg*2FoGin<7>29OiJ5u(45dO)BM{$6Zff~{^kPVtye1kD1YHXw#Z*WKuVQ^@{ z;7}+Nl^c~*8#Jf>lyD~c=m7sjiZ*80^dl^F*ja^w&*sD*3IJSSh|J z;Sq1Nz4}$OP^u9}$yaQ0L?QZcWA;{ctdyfel+F^Ep6LV%Cn|sHpg9;v2gTgWLYaIJ zM&?v0`T>CXxiI4SV8MU!00W&eyCkJAU%Wk1Xn2eDUXisDZoq;!jM`@ZyUp)@hg(bNE?1+$*vR;TH=8cLKKYJ{q4l_@HE;4)$=t7qM#8E|>mvyuGArd^LQae(M z-kXUPs%e8>^k|vS=1kkGM+c0!vajSZvMnk5`f|tri+SGfwxHL z^S&IV;W5h{dToQ2G{{1+=vo*Mt>W3`qt8|k7j?L1QN!baB8EXZKMpe3M~sivMJQ{5 z!8pTwle{?p^3kONLDFC-oNnl_L2ii`=id=S0r{K4i%Iw&^fxkAgzowMU>|*d46SGX zEtiZ`8miq0`a+9QjI=v{5jJG7k%~8j%}2wA+CW*A5xlrXEn60~gc-nVSnQUAb{iGnF@SeqQMk*1)L#jsul^V{3ByrB{A4#^5e@8O zf);IniwRm3Miy<57PGl%!ypWQWnhLO!G@+ho{k!eep87X78U(~^nW$eMzG@1dy60X zqb~~m96^k_eV2`&6UG>Z^!IFXMW1Z`&k4F{-+=LtY(gz36rEP*Zn0yfMMVh$-e_O7w6P&2c`yV=SrkU!jQCL|lxNfp z3jg~w{YSG>gV`}1vd}1z4hNFaYN17{m4l38*mg81fij>Kksp)#hYM8TdFfq9wZIg z7_MN!jD{5Tlm#B$r9lN?K%?v)ZE^om_`i0#xOz=PSFflR!&22k4?c2!w#v33d&BnA zd#1yZi)s+2O-taa-t;Hc`6@G}eo6V<>-d1vujueG&ieD+#l2o@W3;`dP>rrOG-_d< zw;;rq&DsUF3gIVj%j@S}`%}&A)1ic#QRNrv;RM^Wpxe968}R#@|Mnhul)JK3XwLNZ9u5Fr15`;^`Q!6Y_$zKzv_+s=%Om)k6oT#R&e0I#F zRaij^(x>3&ovzQ~mSz*`g979Y_1Hf!*|)F5R8!#wyzF%9ICQxL34gy&4taF1WD=@! z)o=rIZjW%w`kDa!=TBzaOg9y5*3;`=bOu%0(balAo84*}9nQVs6ZJ<@145W> zlW#sC(FEa>SUsHKIX%3#O?4K#im89qI))uzr66>Uu4mMpRPY}r-V4=u@HIO#WxYja ztvTHrR|C@>rZq^IIe$=}(@bwrxNB+tMx-l-)q#``dUhf+8S-&bs?7ln!^$%U)HDVuaKQW* z7Rcrun4XF1u#p!v!8NwweR7g1eV<-X>>aNs0oLBI#3ycPDY<@rrbIk2nCEv1ROU3Z zu9LxO8dJ(5he}Feve!VrJVtV?P%4Y*vz=KWyEKLhC@ET8Jbk#-zDGICL3YW_6LxO| z+FO=9l|5?k)(WW|8EG}m#kUj``mqxk$nfrfbb!$qphXgOZ%oP>rw(e^-t?8i+B@|M zim7xXKsoL|3#i7IwyK_TwhJPNtb$~ks)-aR25~8?OTcXaX;H>2@*frw8TVXn>Vi*SqyePpBS~ zrXBl2n?8~)ZB1|5?=C1ka>J@EJu&3H(76HI@g13?RtW4!ILAZ|P~;Fu{ZLHVR_#4* z>Y7-uej(-6Go}@S9rW8;QM#%2#-Ebpy;ceOHnKLfNqstFd~GLa89II%n#|enu&?Rx zS-0`EtW|El!(r8}*iF9s;cuR-y>UdVuUB|XHtuQaACR5NN#3lp+~b+$5z(-%DLyl1 zyhM0pL+CRLjZ)fY*j zP2XJGq`-E#9DpzWCb|tvgH~UsXgc5qOhTq@}un6{Mo#TXke%shFtjOG`imQzJh7%(rES z1)71a`ZHBT-sK$$cn1=2h*eig-i1&$HTaKi?yOX*Pd4gn6Gu0IiL<(7{U9f%AZfNR zb6Q{FQ<9rhc((qm;PIpFngoy3Vz{yR^!j>f#Ev#eHoUEAY%0W=lZ>goKmtE~$qkg4 zY`8hWA|N~EFFGZj!QEAOgz#UK*iKUiznxOd0m3ZoY(Yq-pagsVHE^!l8?;?4yp!q@0$wJE@1<9~LV7?RnBQnlswiboagHbtQ8kr}QIG-G3F+wh3Mlt$drp6SA{zJ1WfmOm-K`jA;sWW~cij_Ghe4NZO)XBN@pSVS zBl;xU(;`Vn5c7>=RU=q*+Ue?cJu8 zxl-$r#IkjfNXX2dhw_Ami29@)*6kjO zayEmdz1!TVAI+%`pl5zl-InqS)rX$>0`;ki+w9R4!Mc!4OX;?{s;v{B&2FRz#PiEw zt5CcLe2$bRkvH54*{%uj>cS$Oq$(de%LCJ+Q6ryGWo3^*_J^8jw{1*HX)l0L$rzfvWU|i)djv^-oF#_c(?=^i{ zLu1K%w3s^_7JN0wS0FcOp57q88tv7E@xS|374lVd$_C(3@7hjG5xHod&=kFHl+;3a zW{Kn%xV5pS6Dy@iba=>h__YYni-c?1ZSvQ!vde^VF)N#(Py{yW*D#YkRmcNfLp+iZ z)f1?{IlOUNnbI$vc1C&}NN-}?s;}w`-_mJpyb<8ucuB$9oU>P7E0{Ga znbn3V7i{Ot<<7#}0@3Rj7qGyBc}#QK3K;pi)|qpxi{3whlh(%!3DxrS{* z=KVV6$iXtH@F^v6dZFZSRB=0@#Aihz(0NFk&Ag-Y*PJ~arc}Qt#jYb9yK*&y;1J0Q zrFhFKZ|X{8`8OxnRfEZL$+`i-1ZDI_R5Cr3lzhTMDDl~S1QD=SU4g)>d(6#+%T0=? z%;Xk@dx9>u>Em43jMWeXndP7vrSvr{OVE*Lkgs4yII@urJ#MZ=7%cTidLEWk)vmgH zl%ZUR@0xs}76}e7!ubxjm?!Ag)ofV0djo;Y=-|JA7&wY;rZ;Yr^0>XWuFg) z#$6pFkH`ZP+~|}y;Tm?`nj#;4p`9{r;3@mKGzSP!{gxl;B3YrKM3mix*~8P~@(v1U zyGui1PF>LvqX_Qpgy~b)6qY*sZJB(x&57wk=y0$+W!}C|BMeqK6e7*(77rzln+cQs z2~DiFt>*2is!~McH8ih1o&1iB{QRO?XA*7-0@}CC+m{Ro(g~kNq{^4#clGEoO;3-? zmy+LpSO0DPdi~xqX9Z?AuS|!Z+Z8TPi`yg6X`VYow_@~P-GJQ{dtL($zyG2ple=mY zUh|CKW?7%)t!jT-U-SniZRWbVxbVd@1m~DjuzRNOo4_q)@p$H_a4)~U{nfdZKvPfq zcqZZaS@nbvzX>@T11cCy+cAGKAPYHaSD+d-9SSz@$bLsjKtOr4w9Y z@6IF7tb`pv)u*0rq@rj$cer8K3Z)uPIr6z0@}zVD`rCEmd|6%zT&8^aEU{U(PF_|a znwFI#&lx_NMc#q-psbwH5hr4$^tnMnQ@Jx4{G2(0)zx zLf^7+)^gWBBDL)N88s=m&jS)vj9iBW?KxShh4Scl1l*_oN^RDGm1yMm7wlv{!cC-o zNH@o6>ZW3>K;SOc`p<_oT9B1hSK76e6pJ?i?Z}NzfE^Ix#vy}uKBOg|uAYM#W3wLe zX`yeg&QT}Gcji!n{QKn~v}flmQYg!uQAX~pe92k1DigdSW8O|UF;A$ze{$T8%=XdP z)!*{f-|~1mvVp|F6m#U+wUPvVwfjh=j$ah$N%I=3 z>SV^XeblVy=OLddgk9cywE(OAyh50gnl_J&O{<>rXA@Z&fYhVDlbN!fodJaQ^)zyz zBJ5hcEN%5T#4vv-=KmgHkLfzV~H~2SxNypA&NYg8B{{y-T?qvwt%(aSnS9CFGAgsSoh%O!F_gbwvjZ)m?{)B=ruskC}277?e6q0(J9Eb|mCE!$Qc%y4_+CnDNaSGKeQ! z5BT*SodpI$vRVUTvm5cxHa`2r!Fb55E(ky zm!KQ$PTA%9w9!lRWQH7{+VZ)#GnnM{+GM-FS*dQz3z=*uc}?p>1=Q2(MuGI9oaMqH z!s&_TlYmX-7exT+SzvK{L@E^ACLml2(UQRE3V69vm<>L8!d5QSKaseiyGpf<4}@Ef zRc8Pb_g5)!*{OcCzVo;#`Do4R>I|eSeJl%^Jmb)b9H-*ttd~nSA{FlzC+IlIziNJ2@niU*CWxVVHcjN?0F<5y)ko2M*|~ zDi$^Xf;nOh64LH6B^QpaDb66Py4>3+$kuI|lr6j)VpUQ5aHp`EaziR>UM}<1k7>yl zL5k`VbA*!6)rm;wrxl=f#?f4;@=G}b03Ipm8N;GSDGZ3cm_a6W{w_qAs-2nMI&V6( z8bBW8DOA`k@6rF*9@hw%9H`!}KhaRx25gOJRGS1$2Ix)tSbcJH?(_5Nds{ZQns7ot zY^OXwVjh|Qb8Z;KOj(vk1J~tW_yvQVTK=lu?^UO|3Hsjv-ANH*0VcAxW;tkidORA zQARSHxhaLH60kJFUOg~N@YJ*HN*@sNQ!6r5Q!7bR3l^!eEu%oY?c|`+X>gYgP~46b zoWZz^klKN!j+Kp^_EJ|XI{f}Rx$y1fetNPAYfz5N$1Inxs4aS(a7?(~TzHmuvX$t6 zcej{w`~yFEmRUby$!whZle+8};Vd&qb5=e54JHaH^{LMmB+75k!IxfXFbV5R+^@8( z9UXJg(Y-qMlV==b+{+MR$5x4te9x|FOrY2Bt26e*;f5K+$F^|FvPe@NoEha3q62n| zwwLs&n8*E1mB@yOX73N-Tg9l*omaF+%j-<=>j_=k&qOK;o$X zc!W?}2UpjNO!@vwXZg{xY49axU5M}iTyUIxh8dS?A&15iVA!%~C0~~sE_Ypi`ka{haV_jB@$Qp>mzoAj&xo6!gcOp-JWsYl ze(F7R4&!1gr290>f(e@z{ee&5fJypO(@a`qzW0@n)=rw<4Zo9g!X)D?GpCdVLkrjy z1hUr)a>&auxPY@cw{bEmM%b(Ezw~+Ox#A_>2lb3n@eqT@Nhj*qThJo;FWIHhYX!v&FEZ4 zMrkX5vX?2`ur_$Cl;wd>WF&RC38&@YR}EvOHx6t?`PO+#_{K`CpA$>rF*@K$FT1xA{<%Ea>p7h#uvOZPqlfN8HAOgCN8s00*p9ebrl%7C1@H*xVR#FdNVHL_kAssK@ z*vX1Nfs$l*v2-P?W)Et8as*YsQAK98*DAE=Y58F=xIJL99CL{jruQub20jm&YxJ#6 zLpznTkXvxMyJ`cWOt)IIi_ftnOtVi5Ie693Zmfcyw*^?Yp7%Tb2_xfKS%e zwwifyuR`Rzj#(MtzOt+6Eqf*E)=rO{4d5|pox;o{^&_!RJ#oVsTt~$Z$Z^x`4>QSG zn!tFyCtvTW@nk)-9Gh#COyauA(HH_t-CG%M!M^Q+XCGl^L25KQj(JSZ{wB?drIYnX z=F*eW-ILGOtCLHsfUfe&$@-@1+PUt+JA;E= zlxcX274^0Sv+F*7J^k@Tm#3s6fH@CnzV%XIN&EeqJgZWa>e}hliX;YQ{#?D2@_ZF> zxJuSZc9~s1S?_kyy$^*Y+# zaw9((c3xLF32eG=$}mkC!TeGRSQlN1XDv^R#p4#_0tT*Dnf zLKX<++KR4g{zHJ^K+Z-`^5xm&)TxE;H_U%nQ$MWb^`MndjI~6IZci@L z1Y8Dp>$7oazlP(p6OHKeqQZyzl#&-U&3GSlX!!N)9uGL*@g7pHl3ftGkTII(H1tkb zRb&_g#Ed?L_JAfmiMa~(YM~(X8q6u|nuZrR@ysOQnzU>np*<*BAEKK}8xKI#XXb^h z$NMxo3t2HtXE&Zzv3ho95|NbMoicFJYtrQApobRosrD1il0n`|%>JmxD*o3`f9tG2 z!ITc@m#)<86p$a@?d`ry_s7=HJ0ekZ0^_Nx3{5~o=8()Q}a zi-elsXw7y~FW=ASbYVhmDDiY{vzPuW(_xAFwC>RXEoQ9zOgCBWQ~vGV@ZZ;AsA;iV61oJ&Of>w77r;0PRKD zL@j36B{l41&FqZnoD9AT$0S%x3^i}T$414P3-6{9k028aphV19i+clpyL(u=|EeTw z1eC{n`8Ut;3Wv#F0n4;X&`{czXRfZ=xX8DZ$wO!e%NqJGUN=hJGn`6}5%C0JaHRuPwQW(Dk0ov{+E7O&G# zIPtX>pbOD!1sL6rF6JrCTZ7;#roal3Hr7wcL2X%?LN?|XD#n$0ub3nzuYbU-sjgGI zIWV&U{%GE$5E|GkPw9H6S2LRf z$!tXNr-ep5w%xRqw1K$^$!`6Tjs-+kG0=Bxap{=&RGt96>lX zKreY*`T)>Hp)RpN4SJ7!{^inm4tWl(pNjitXrHmI2R=}te~C%ur|VG{^Emo7=7@_aPatoO)9KLr zc>l32z|ON)tr719cati#W3uT@>L!mZE0~njHF7EjxF(*3Uw3L1n=o%_$@<>qCh?G;Dm6O`Jmg%ik}buCnIhjl zcuQ^)O#TD%ya9cHijn#w%sV#&&sFiSx$iuOT}Uicm zqLXxtyrMa_>Jd~8XXjKs)YTrph=!HzVlg034VuV>iDb0DV*0dHL9hb%YMAHARa!|k zaalCN%;D^AS5X!23IfT%WxuQAih$+p5Pi9mcxK^NHz!04F3dQMSCE1$wTC>V0}HA! z&rCOGjswPUpIZ04ZGls3{&F-DO+v@?o%zzj{IttC8wjqNjHE}DA~gc!q(Mt<=aMSQ$sq_-4&thEyuYMa; zh@3uH`;?r7ta8Jf#f4o2kA1W(M0j52@K7GpIe#sK+;`V?f#bej8#o|{gi2OUl8XxV=|v&iFM%aHF|$BdjKPV^n^C|y z7RN;5GE!zr%+0!XsQ}ChwwmmhXa|GuPYZL%ccvlV4Z^4NhNilcRegHUDb-hBmmD!x z8f%8%FRqV?TzL5vPoFx|hCtPm`KukBqj<`nIDmV0yOQ>(XLh%_FeAWJvM|fd4Wvb+ zO*C>`NWLg!(2?c3l=+yGmCkxHGkHHPU`&R}{F`JLbgAO| zl+c*0^bDCcV{Hv6GabPKB)in2jbXy(1y{dL&b0ZQdX|uKheJj-W2Q8BkkJ>1_$Sh( zgSwzOD#Gvo(A45))2+#1sdHYI5*Ui zzVH+$XQt2h$#o;RG&MgRtrYO_#ASsDwm#NRk0nnIOdNY}*jv6PwWuF{07>ExxO+)d zzCQFAZ@+d#(u;Zk(s2jisfW=C@3=Gd`}94S))S60ap&K?D0*q6-S+wPg67#K$wNS?sFC0(SeTpMIr8+ud&zyMc%A zDXNQp&5^m0qyJ3B_?s1bIt4;C3KV$HtK_10=VKbMFr(m&kQSKj{qAfl^ND}$#&LBn zeKurLTxiv(gVLm;Rb)Khx>x$W-87e8J-I9;D#hhMNI1G^dp z76tQt7EKkEh*j0hLMUW+)Yd(NSpIg>HEfQn>jJa)HEGamJmT*M**?<;Hn$19o8X|! zFR&enVEvJeAbCcGPfI2i_fmnjWK)v78FB-Mxw^-<#*SA1`B->3aWe^?E3hC;pXUHX zckU1`yFRKS@=KRdIC`_DdBwbbgI=EeZ-((H^3A^$xZM6+&t-yU+*ir?Qsh>I;C&)_ zZSrqZ;Hbo5k=9Kw0wZ9&1lF z-0!U%Ya(1P-(NoYrk%~^>6(Pb_th_SA;U5HJ@$W7Ftew?F1Dp-70v6UGCe%$4lNp~ z2>*?f9P;|uj&O8AGp%1~Lq2CkLD@f*noh@?R;rPG-7F+(>fIFr{UQ199CFVd5X6~S zaKEYRTq#Jt?1DG1>X6&AxO-&k6nu3tE?VBL*7;t}Pc8hWk7Lq&NN`Y$!NJuTpDBfjS_(HC|gFM7@imG~3iA=Rni*uM#s+w3Zwx0`k67Y$$kB24ny@3Wld^xX9tQ)8Mv=-xq^ngg{`1R zoFZ>95G;8BbmFQA!BH5cB8r}Y)!CXLpI8qw@+pKM#?vM;+p-u$9yQo#|+$xX_Dc7QW@Xy1$+7S+CU z^bm~tWNVVcxjHFysnHK=q{D}K-O=D;$YVqDu%*v4;$8+{pPOS#6Y|wGc9G>5?plxn z4^HK?X^XSj{E3x}BKAa`y}0XAIib1*iX;E^LxvFX6Y_<9qy1Q{BRK!&@|O(hBL=X9$NzVrL(1lmB=Dj z`jQmYm;0km)XxNVXOjoHB_~bs(**+dAT~ZSJ^cYo-XwRsNukxwr*?6r>niF9TK12A zCw7>uM@GcRL3-<3qRH=;;N+GKxyoW&-P>Z0uY=rA3eQZXSHGDqIvIVE zEdb(jnvpbYGC?4?leK!9VcWEiYk9QdMzH#VY%WTF+qcj>Dc;(KBx{ zQ=q2+JKn{o`nw@#Tga94nZujgwune@^qSd3TkL)RBe<(H%GNgx4J~yv1%*{C2!D+ax6dzRWhTxclaX_pe6R(NjzmDWL^zxHwmVf3r)R99R z;bPk;E&P(`#_qT#lQ4ALPEi*O9eEY&KfO9vQcpUS(`1=hNev%c-9=vQ+B8SA0RCOg zWZO~GaTw;@91TWtAi#{X>YbH4E(LUw?|vCFO+17>k5DEgXtKmX==(|XL#WzRoFm6| z&Uni4w!Bc+IG*kiRV3~`wk}b$^|GgTk_#lrE^>h=LzG$HgM-QNuNV#-x zirb=*ww1kMn3EBi1+?_Ip`<0rU%UpXtgS-bjIC@CriL`Z>y-{3Nz}k};5blMMA}WZ zKwvFkLFCiP8uSVL`9da>Qzlx93b*c^YO+L`^Hap?6Odix>Nl2Te1oBr0yEc#K#Z_g zJliV=*mIs*L+xDYZ9E+|>3JKhTb-q`#H-+zl%;_dJ+liRRseRMe*o4=)-3x0plIR( zgI>+*k@dt-o32rCNRhfJ5JSh@pm9m3$;;B|bl(zoINg!@jm*7o#gk<|?3d7iuY@M0 z2#2>;Zc29<3dhZq#515Dxj*x^bg$6lUt}B0L=Aaiav$)at0G*fIu%aPD2hEdsjYm( zD@p~{dbcs4#H%23uLn^9K+?;;Jm%CfJSJa|m4&N@t7(eV-wW{Ojvx)@ZkM2{w&tcE z^FXiv<`oL>d!uNHsL_o5mcgmfGF4K#7e|C>qU_l_s3jxR6AylswjU$AoGocm!pxyC zc^rY;FM>vmU`+coApl$gs~pdtk1ibymcXV2X&bBQ>gi!#%R6qUXS$0lELFr}yQcsw{Y^qK zakTMO2qGpNFAmTIJq+@+71$S%bblp-Q|o&n?GvCF8?T_U>cre zV=|#ofMdUT9gT@(J5?B_MzYJyQh6vx@YB3Y7+^gZ1Yw7lJ<%Ye zLRbP>9O}6-O&H_D1Bo;|6R{U>Fsp5m^uYXwRvIQ*s-?ai6Gd=Pi|dEN=)LA9&dTz- z)-a5ZMFm*T{v0xee3&HK zmc)yQsK!2=ay$5cGjp9LbnS;LF!#PxXE0iD&L=(TB6kmMK#?wEDX~DmMmGIxw~jBc z4U!2Sm^aKm?qfe4XK{B!h>q4tty?lj=$e+NX$XpN)*{vjks^e1koE!%(?qKw=%|9U zG-SijC(T%4S|a}ehv4nQKlJNOZgrT_W|vfsz1JB6B9Y`zF6GLW4*vK#%_7L6mrXW@ zVbbh=%#CS%&N%$-w5Ym7oNMf_rb_Q>OPauItfX=dg1Uvni^YgLz z3zekU&2@{)$S|}+(Q6GlEN7URy9@uYxOg66&p9N~S^WX;6aRed6;N5qyUcG> z@lGx!WLSB$V6z3b%+7m6h?v^Q7qggKmZas%;DU|j!URxM?|eW$jjl9YNTQEl*Vn>v zEG*W=gsITP$l}zC6t$Dn6*8TN6`D|ICmjAiV{qWLJ#vsCQ1&~E? z$MDGwjH4|om`_r)XOXa-zbvW8t^`fRvZ03y*mXyke=?9uWlGCWchkU5JE}EkN@I9b z!fH|izIP;iTs*OrXUoxvLq=;Qiwj#pDI)6N1#Ez^ySt4nC;h`G`>(wcyQmg}gx7k4 zIuY8QZK~`op)E-tPUnMQ3;qGYre%UGsw=k#x!)u{oDI1mXZK!kav`B*2f6tkTR)&O%y0p=Z>u9r*T5)}5Q9QRa3!$vctYVWUgi%*4 zNX^|ff6%idFQG+6Q48G0KdqEGM~cF59Lb+79z7Fq;@ z2f7Q8j76D}@v6%puH>42a6Dk6W;`r#SjmSs8suXP?g%z%5=F{ESV#QdE6(SwsdNNV z;wIt}+}C3Ypm9GWr-OLCM@^hQk`PY3 zVxEe1lp@YupQwz2QSf=<37CJT*j`5cgeHg^t;XZWg4D& zA(TfK+l0&Yn*Z}EAJc(ehg1AN%d;yP{VP!*&7)(z}IxVK3v?o!!+q=hUOAaXYfcSxCuZ5m8QfB8(1pK^X+aL#|`*^VL3X| z*2pP5(^%;smv<(F0omldH2F4v^E^TGOkL+Vu$i6262I`Qx=#Gwrp8cnce+T7EOG48 z&oRGA6wfJ4D|cCyEh)7P<_vhdAj{0$k`vYRlkhW&Krn@^<;9%ZgRBYx`6K1HC$J3x zJ%ybe@QhZbu+X3QHWp@%*b@Be9(~Wd#7djxBDMJR=^;0H?gL6VR?Pxi+eheeP0tw{ z^(Dy9P<4kzsbekhB*!t!qHt(xwi}G%s#h(Q4TnsXv1DB>8x4_-^W^2oF14`_igX-k z^ZX^Pscrgwk~buhI2h!p8g;Cc?eal+hPM^-VoB=!y$~N;2zTJ9VSp2;^exUb3xl z5Io3sNgZ=jHLC5R{ZN?^mWVAco6c2Q*0M^rfg3z5=7*AN`u|tjII~S%0t&#coilTV zHyz7#LF?vNW;|J-aKVA=Tz}!-aK=c({em1-qe?_Mx6GjEEgbKkgUMVpLJoi^1&|7< z+@ewQM@gj0k#a&MvckGai!iF+EHu3(8ysrF)@n`_C`P7<2%_Dy>}X7J=#Y1`qF4~+ zWr1U-LCe_)(eoTrWm6`&?jMfc`+p@Wb(DRh#b`$jAbr-fEFFbJeOjeU1rM~zU!p+e zI^@xUAbv43s|9QfYxj|BXc#d60VDgENVxj|gN4@KWvZ@=jnIuXk*x^LIOC?3Eezx6 z!m`Lb$iDxKgB%=)yi3o*lnE#>;0gKWtR1bn^A}JawxjDq5+hw{c4G6gI@n7lb^wm8 zz79r0ygNZYLLOs5+A`H9PE4c0)zI)Fq_m`KN{_$(^U_Uev!6e$>D_Q|PbgP4m5T6$rVr$cK#p#~*yu|GB(7X9PU^)t?ZS zCvy4EC))MNxMX=Zigbc(s|%tPxH^?5cqkZgmIUe;?MB9US#Zc4R!I|H6~%YOpxlwWhrmV&^PWM*5Y}ilIm9ks9r>2>|{*X58CJsMd?-9Tw(OPt; zQ3;^+Zjs7Y=3J5_SLCdM-ga5G=s91uqc=|>a({Jn8kp>zQ^?NkxF1G5Aob7l& zPmR!vR3ZbD#gFNrSX5R_?Fp)zigJ!wuC4jPv1V z^pw(iXKkujQbaOv&;m$DV`B1V`&0(Df)x>}hbL;qE7?g=3H5 z5ykS?&>jb6@djc^V#NAk3t7e7rvH+HGOUzKv0NABQZ{s1+%e25nTLd0Z<&I6)q%@R zM?%F1d|4qpru!lIJ%}-9S)% z<(Xq0el0X(HW0SRPI8|r=Nwc_2Fl%CgiCpxZ3m2SX0%bm32d)Wfz-rVSYXU70#;RP z1H&ad1L@ySTPp6)uL~19$V1T=0|F7|E=sd4>rojzL${zkc;0XU-)ANBq~(12rP{%I zL&(7smZ222xoZE>-S}|YEe2Jp9WQR)8v|yhjSK4h5BbMa^%O6~D=9blK7@v&3f_Kb z(UL#UBzvE~rO$w)Po3r#wv=f6=#@Bzi_yldnmDyHH=;dcc-hA9yr=`xI4WBnCnl;{ zqCLQowak|E_R*rLg66tN*aRf46Vadlk9>17B!zsZ>l>J`Dq^qi!jWNddjj!FQ$;vV z{`K$r0E>lZyH(@$<+)(KZx?CEae{q400%)AVo~zgc9j>n@2l&oQ1H}lmD+;HW8i9jBuGyo${ z!cLwb)kGcQ6&RBXWdX~J@b;nlZf)Js`RWyAco(9sB2}K$ElLJ>GuNkTTSS!g@Wu{( za%7p9e<+hJPKWZ883fgQfI%vphaN}=qk%JA93(pYi0(qphzmI0ZLHTZI-~fa$yCn4 zWuB)=^M^$4Q2EdT&ds-$1PrxZtniXAcM9k5;pLjjv3N%?`4`(+Dv-(F;Ee$E_g(5t zrYs~E{ykFX+^0JyJ-Lz8EnTjtzB3%0XDuRp zik3jgA(6g|_0Oyf2!Y%+Ee0;w^LGm*`8FingRM_SFv%p^Bx5`X=gh4B&>3qA>=4mL z1*q0guZ2KyMGY}QJxLokPeW?q95eL8fQL;&J9TN&4x(Sb+C5 zOu5O+7AwN!2;0UBGKIfniz&C)wi!HJFpu~T4yn5zeVtA&SoJjR(~YYf2hv()LbR+& zxXY7EKumm4fUYK9JQ_h|i|Zn^3x&<~*i@w&A~O*v>@k?qq^*p+FK%oLh+jzW4w@7nh3a3=l zmw5^$f4Au>7tbL~a&e^vlb9XQVIDUotV&D@WOmaLq~~%4mjD$AH;TeMRa2yqggTT; z3hs{Un?zZxe`DW6&71;(TO{|kqimr!=Q?@!a74iYmBf- z5-MV!1thf<<6J5o{Z`2Z6DBH=W%CjST-Z8~Gl{I*2wfOV9;d$6e7B^u;9v7m2MB7} z1@p4-uO1wLwl^SLZcS)%MnKfz_9FH`MNAl8U1!ik2HjXIHe|QxM_v@nM>&L{DMh40 z1%!@pLI7!Zzt{&_x8y418>6=+npMOic4#g&7z{uzF$#y~od0A^V=nxp(3le^!?rss zJEvNNk=ZO>6Nx)~s4*OZ*K@L_bIKO`l@&sq{Kg&wy#|fjL%K zPFC;*DI)#agr#^cB+w;cRQeorLq7<27@i=t4C`f*o`~_T=i`0KYtycc z{sD@%>dLnUP7_o0g>+=6>p@Jp{4{7sWK}oVIoQcg*KNext`mpg;LNS5Rz$Yb#CtXp zH&7elh6{Mi#I*`~21lOdMlf)v>eu2QhOXM;NXPNX2IM|&R=`PCB(;&J%kZX>Z&K1* zFgq)XGBD$+T~rc#Zk_!$D{qb6UTeErAn4?E?qcLjgtR*cLfqGL>SDU{>6)D;Wn_!n z6YdCypgz?z+Qu$**Z83cBith=neRT`VrH^0AM&J6(jJWP7;qzUTAii~OUgVD)65q< zJoTPS4GjZxtB4hq`+y1Q>V#0Tx`4i9IVxe=Sco5ko4NfW24U0*47`#N{GgJg6FNl~ z#{Oy2*!&>dRloZ49A%K(ydXGuYm|ojPW^x$u*_$hV zxMv#Jn@qd^_3tE#B-xUN30B&*AZ$tRzhAXbs-YVk5Nh4-R+4tT$_jzbx$_Er ztAaqL>X7i%v|ckmp6qEaX@^paC>58B5RCMtbGMV+J9{iXOaly8v7*?QZnVr5oLm;1=`5&QVg_~===Yo=ueUkO70{-1f!s4&77!`p zRx>~k{bds>hyNcu4P`6m?Btk@m>48HIO?>KXSeDV|{_#hShQc+o_N& zAo#t1N%kg>?isD4z6~4?iu5E7wjXHIsf7W%J^dz}q{JH`j5i7GI!PE;ii>3aa2LU$ zm>ijUS0_wSdivp?a3fm$oD;$FBwRRU&rj~_l2p`LuwQ7l@Q8`}%lG&3{MDa#6E?nD zo09yYv|WU02YmXqO69F9JeKVFH-bIv$KPNpT?{Tk9rl7oocV7x`5kIU3PK>1H0cLm z-ET6T*o%|}nwu;$k~65N0meJK88o=PJ<)E!x{dwvyf)m&4n75h8=4m|9jBgHg=53% zF*k|ubD)D?Nps*jCbL^wZetbOz1!KSQ-w?yMLPBtR`HA?41d~f`3G|ChL&WF`?e+yx)O?jR$~|QMB%K|3 z2v_Aqt?$?ZAI1#lyA zncE&NrhRtoBN3CB2}scAZfv<9wp$#Az_1BE!?ffeGJ<^brn~^PApW6s?__& z*2eE(x~mDYv~33iIwS3x&h89yTsUW{kkMN?RUNN!A>KKT1)cXwjF)+3!(iyP)3}*;?Vb3pYujlN)IxttRLl>t= zfyUT+#49_=MuvIObwjq%9pwWzqI2RV?MKiYC&58ZhS7+sC41rcV$3K+mru=cOy&C^ zetWMRgGvYVVt}F-k3LWdRJZfJS3|p#<=qngj)7yz7X-UXx_|| zPYn#{MfW|5qIz&aAO;Bf*bHv$`oCp&4f-LPE zx4S_%Tg^_EW+^=C`M?E_J)Qabnk>D2+z{HGsYNa84sQ-2$kVMJ1_I_=E6hB}X zkV+rd_axm~Jut7C@vzWi`R_}tbj!^j;q5GBjZ0*YkKF2_A-|i2c^Ql5YY4wV;Db=% zZOzg2=m2wtJ+pm4H9g4bJl)DuX5m+AASC>CHdndV=D7i&ldF1@-ep(ONT~D}OX0a@ z@E-@?b`qW-6W&dlWu3iue!kfar6Xt_w~yVZuvEN^s4y_NXFj@;_1V0lv*c=2z*a?+ zrKef2mV~x?=rTY{9da6MY)YwK&F_)0t5|7D;8+DDt&PjJI5d#BqjvXOWCA(n)>$U< zYLt6v_q9XKq7U)}AM#*M!tb&JbX%cD2+=QrPi!jr{5rglhk`ag=bxkOm?!G0`xx3C z#EEDT9Rs>TM;vloJbg&_&BRL_=SV{Kb=lNG zVu6OS;1?-3f~cqs8@8zK4)`rTONcJ zdTyz7dY|=F+Lwa+$k1V&5BW)=IxSk@ZXAh+z8w1Sd8&sw8#9X3*3%LJhU-?jFUu8%A|i*ldFe&B~Q3kqreS3cc)rjr|Zr!!iVxc(p;UW@>9zYe>6 z1_UUPmMDHhyzbywnS@hsKyJ?1klCT_BqV0+Yq}`ic#=xoH_81T(m+o?D{h~?G^3`P z^9<3W>=m>ZDEroI%yPc!w;cS9JgGP?(I*5^75tFPyJ&b^^W_He;cnp~a7R_K?XTj? z%E#W@W`2IXGX+;*4<7cP0Zz%U`$maVj|Z;8TsZTyE`*K8Tbv_ew;>xuEP1Sx<06l(&X3LqSiAYRkxW%JCC>KXqReDb&)U+wc6z1@I6i==}WSNMV zGc}%ThjjZwTj;mH$ZjoP84eNmItR`ebI4U#VB?TB@2e7DRT+iBNR#JvIcB9>6h)Mk3 zmv?~r{Thhy%BQDm-^=GGar4j7CvcPPvDe?lq{zJG{U=_cuO3esn)GlXe3Z$6bpU0W}$ z17oKx7J;!wUltB7u#`(C{nrJJ^;+}F+(B5!a{J#56QNbVTL;ss53wj??B666@iz=R zWZtj&S<){5y^5G{;x0vGs=>b-J~g+$G(0%WvV|HtWE~*WvTc`ufTC~@DuKM`Odm2@ zhwDU-%y}<2CYQfW>e;zGoZJ{_sQ7lndAf{bR9ir-r&wep)nD}S6;06R&jZ=sIvtFu z)Scyo@}D(^lfB=3rGwWaDh?!-ujF_j#xPO?y)mDI+J0ZOJGhF{j1)jQi{ayZ2jcja z>+D`R_BV}h=!LU6D%4Ng?;Z{fs`Vj;R22>;PG&%78ZB$zGLxLX&O)qL?rT7$tB-N$ zdl#E6Yn!e>Ejd#~`B1kn0#?8f$vnxN&uqa_A{Y0r%u7}UaLl+!Qp$%5ZMYuefcFZj zgJ~lT7pGJAl@ka7#-GX3+CopdThcS!ZWk?J;-cyzZ^Afqktv(2U*pCe8sN&ClnYdD z**&G;sqjdrt~soBl@!N9-3~NO}4{_$9z$_7MZ){~?`kS-Vz! zS&8SQGKcY7`hfzxYLbBpS^5F6A$#bYfsozk_hfHIpCjp6;c-w;6oi zeo^y45j}bd7~~fGD2#UYxLN`4d>2C7QyhzDrEne{tRMgU_b zgvxC|W+&=pt_RnQc~zBE@ptsQhKyYKZ|gXF?2TyMLDeN7_v?imN2|?4dofoHv1w`g z+8bFa1Ya88)K6PVF3ul;CJon=h7b)ttw--lb-(<`!*%3)+AYhsRtFt##FXAxyKJ{xFby0VY#f}&dk0qd?d5+e@~+zx`#df5Y}V-5KM3Nwx{e8RkC zUnV@%ML3ZM#Jd@&brOckH6-C#9y6x1AR!SJAXzbqs>Fy#l0hcSzUUx`h}ZC`7wi0+ zkyCtTCxXUO71Au2{cq38?k!7q2|L~c@zHRw>9ks47XkY4cL^KvU#?s_mi>)>XQsY0 zzd11c8ba?Vt~ChujsB?nTx9EgeZH~3%g$-v%~G=O!u(h9xl!(BBr(j4VN8;#P3QA} zTKv>WJRh0-YIT8D5%pW;grCuTWsLVeqF;e;q+@2^S|Jv;=~_JQOJ+jm&&Y^>6z6is zL@Miq#!ih$LEf>UYoUd&5Xd{fcp&SKcyNtC_HiX?a;g71?gIpy9kGNHe-_^P7=1{x zL!;#Z+P$XcBrd*SG5M-XQ!0u6hi)cFQrb4?SNC5_u5*2IodVZ!1O9a?68G#+-dMNP z$h2wPZ{5ljdQQ&^R{-b0et9!!}~^<;MRKfGmjH|fwo{l6IF zT>QxHNb)x3$~D1hUnKB)rCCdW0_3mcoAS$E(tfJ{w2r!S3~ah-%gNWcnIjvq@lWEA zvrosXxmUJ3>^64XUU@TaL**Qi8a*g(E=uwt#x5yx6_@svBdw))a!jkrFp{{YuQ1*q zUyxj?1<8KCx`-*=AKm^+-rB_;P~Kf+7IUFE(cSjDYqJmjfA2k{Lk3^l4qDFrB_;2F zz4s^MW!i5+Rm7vI9UAZ(0EHy^8DhL(K5rJJ1HRaxw$i+F-i-4&32|xihJo^T zSjcV9_| z?uM5fK;LWJv4HoLXjt-AZj0OQZA|?ZP<`@I0JZiJ8|gd@^=sQ9&Q~bcuDR}*J-6vQ z>e$0cxFe}I{`I4YN)U8iCWzrf$Er>wZR5mb-!qKy*HwEj@qG(*J`Ao*Q^FDt_DXXG zKfm3u%>YGhz}N?3KYS2u>B#i(QuxZJ$|`*1MZJj&(wxN~FL=g_SMN#NI@Xpcuva)~ zeOC(9>%J)`Gq~+7-)B$nf)vzIZs`TZMpQ)uv}c9cEq!-j{EZR>lo0gQr{diuNwr3Y z1F3_K*$noyLN`fa_Sc!v>RbPjb@3|tQjD!*K{+MH)P-c(9zHsI`@|bBYcr5&igCdC zoHDNql2F~kQdPk&^_~IpfmI_NlB%WyXadI$jv?)3V=e# zT(XpaT3?~rue6%bm0yE^1M>8!tV^t~f@!B8D7p?Up_X*Q8-}XxGtQ64^3z{#zhjv$ z1`~sZ-h7W(Zyo!a*Bw^pW+elGa2{q~3uGE9ZD0@YDASgadFtIaIvjwiYMWCySLNYF zAIXJw<50;Lvl@gGNXFkILwI>1NjmDI+iYYjVIFSf?~u0S-TTmsbeoIPjsd{jSsZXE#Hw;HzVhqkj^ zdRku$6_wz;fwFZU#`DNUFYnP?e1iW};znhN)-1M>^=vM^v8iNNtgrA_vo1vTo-2}o z?e49#hL7|s<#EU0g}2Kn*h8O2O@1M51Z@*H{kl@Wlf764RyO@7z1Ta*ld+8+J)_OO7x2||G&KMM&N;MGbKYr^ zW|Y83SudIOI$pO|^{#yK`NW`#F~of|)BTafVoY1BS%8@Uw!g=io&GOfD$J@BzTq*hQd@StpF`zA67t;um*Jr&LG{n!MuEPBp+ zt7vx{c*iRe9EIk;sxp;~o!F=I$84{kw;VK179{<`_zP-17~7wdXJPyXSYkX#A@ET3 zUno~2a}ITjBbCIhqJu+kh)U-N41nV}p`bfkaE?4AW}!taMNfO!HT7-}{U z^#?_>gX@?GQ|6O)ONJUXV3i$|t6Ao{zVwnb@%}i+E8+()97WcxFwFTYlA>mCV$M=2 zv6J=Hl=nsEWCUK10^!}>&Bt>r{}Ey$ekWzjt>kIEq?%NpPo(PVe^4;D-dgx!*>2oS z1YJs+RxXws=d+X~nkZUlel2bs#@%%@0Rx1-|0I6)wRS;t0G=ulMeXSpOX^JQ0Q5-e zH*QQ@B41&u_Q~?Bay4cQq9=zB&&%U2)_V7-(a87B^(-Id<3J>wKtyc@{%?wh8a&zX zAcZDMqeZza3ZZjG%K zx}W@hBX}KpRs9Qki_3IR@W;ERj4kn$A3{O0t|w&-n)Sh3w*^rfx+fK~Bk-jvl6Z*i@kC|w|X6aR+|fCL-1S0q&wLwmldX)HQ# z(b({KPG2>6F0VKK0K`vdi4VlB1%bt*+84t88ktv=|1Dnn2ASpW)d=1KJr-O2fd_%wAn)p}EQ&22?@1mxXrN@UBXQ|@um}P8OGz>qJ zt9GmZ30&$vIu5KYxQJWj*J`)}-;b3OtaD;!llWVU0p5Gq8YQOu6u`?olmgtpZORsP zPHUDEH2qB0{;jO<#DDx?B-!l%a`0a4ffRfLZx7Aq-ui78Y_R2T$+d29Q9KyPh%##I zbC2X#b$O_E(o!QY!`#m@qld)Jh@L-j*A*^3F@}!itz?5W%6f3~7$d@NNCY%h4 zWYu4((eJH-i0W&Or48eqYqErR%ZFP8$=Da-)uR@IO>$Q}uZLSL)T-gSZk3WFgVrDO z@sK{REW8i6u2ic?Wsaz6#4l0ei``yQyT?{k!O=h_^4==_*CRSUs5v_E2?V9Y0eBc;6Z_RO7e0FD6vkl_lusF zc5>xt)r5bUg*b+I z{&92)5L~oNUofvDKhs{M0b&5lM9<(I!e*j4Ag8CheAbAqT>_TR)6g|)Xg|=-yl_Hg zfO+{u&|>=Lr!$DZVWCPF^*}x@8+5-&aNB=yWrGlZ`c{C+=Ggnu#>vri^7YA+OtJ!Mwnd*(7I#0MA zvz6E&QI)!^d`f125WAg_iY9iEZF#bCT?x*o?s@v#+Fbb?Teeow@u_zLV7t?tx4(P} zwsln>Ckr|P&_||H=GAt814NqCvJjK*gVXuf4w>lD(;_oMqSAv`^MjuhNElnAo7T4W z1d_;hL?E;gJWgl{maA(hiJ^VTC<&W&&rmlbCLjD zmX(aPJ@F(?y)2`q*={nTqbNu~=*U+rYEkTouvE5@Z)b2zW93?O%->5cEiOM7(C{8O zXR|H>BwxIL1m}@4|Ldqp4`LI2qKk(=w@&!*Y$9gR@kNq-D;_NJu8>{^9Mf;76c5C9 zEFd3ZpGf@8sgHvL(Ra6U{02wfDvdsQ_BHv2`0be=T9`0ySnU{%xtct63Q-?RkhX))4OLm7#CQM;(u)+u?%j(#hPkx#qF2mXPVW=o`zzll8-^U&VD< z7tyFj277M`z4Rz=is76lnyE-k@HThH9Q+bl3-6WPY83JswhykK*Y{X*8yc0C!F?q zf||aBj4iEp#j8K(TRN@Y!6ovR9$`+*)9p21ZiHu@$II0bGhWA0rGJAc4UM1dfoUQ` zJIWkqA9Zof>kK$-^hYx$$}cwQ^(1&F=(M+JH;cP6SuQPrr|n>cJQjc)OJaQ$%{KI=}yz}mfrfz^Zs<7mat)3l|1 z3{iN1l}t*KUQ=S#X@abv6H)$U&`eXI1*{Z{R$(0;_vkcSq}g$ClDzr-{D2-c1)mhGn>vEEDX zJ%S&c>3A@4fDC|+MJV0S@=`+9?4|k>$+#sQi1?#MEqJZ2v~=xmT>MPygz7U@M3jc5 z`Nn?qzfb0xP42mBg9|%2*?98)lXH{D!+xKvX_{;HGu71yI+))oP8v?zPk&t({|$O( z<_tS@f#A!67){5^^ZNAi6nR@6_tOVjeLh=5ZlR5>nHpd$=}pasvBdv1jKyv%Cm3uB z_(bYBT(f{RTwJzmh=O@FND6LMstUG%r+>Gfj;?(g)Mr65XS${8Oy9n!dFT7Vz#&wO zDjHn@9;6Tzn*0Fyl+KnR%Xrsq#q_T}yC>&FTe|RnRhZJ4|LS8s=xGdm2(BuNWNQ+k z8C3W%Bfw7L?6t48Vgq>>t$EJ%a@6h^@2{Fon?GSS3wIhj)~z`63IS=gDghe1<2+o#clEA(-+*u z$;m&MgJIKWr^~to_XYrlq__7Ql)h*_Zv@zF;_DZacac7mjw(DKE$J{$m-i`gQL|y- zguYENvVgcXyIIiiE&4oqK(cMk%4!MV-wWM~<{5zX@#KT8+0XG$&D2X(P|@T)qcp)U$<9yW{Y}6}cO4%A@Ix0^kqEf=vo4*?z4YN?}ObnFW9w?bA71^e~3;}S?UbwV+UMd`KFc&}ZA7K5JH-Xk3O>uLFfXdi zs5(Geyr+k@)dTHJZ5nMhfO_sJL3i>enz%J)7u^${UTI@Ciuww^Pj}}yo z++U4xpo-5Lo~u?GC;EOy2NDyK>@%Q58&5uRd?F=ytUMvN~?m^~W=sNRT!HU3nb9k zAfj~0+CV`-1w^Gp0VyIxKnOKa5u;06q^XpsG^r7(0wHRU&?7ZU3oUdANeJn=@9=xx zf9`W1xS4xq=JYwAbF)HG|K?*FvVlGwo!H5bPTB$pRe??p&gNKpAHyJXo%?H1zTquM zM!u8_L)gwe0-0kQs*toTYnX5%^L`>%_4Bky>^6D~`bQZYPJF$(hT(r@%T{s!(QV3P zeS2crhWTk}6Y-I*F(drXUP|JoI#hYXNYbCpG&gPBL01}Umtgp-N!fWTX3KNL$T_tI z6ejdBXYww{RQ~o*5fGR5WOPN(Us@(~QujDocf z$0r*)a?IUa7&&UP@<^QyhnC^RZB3bTItAy2H_oRJJI3B2N`eh16PQ@;EwEP}EK+c`LP^jBUs zzP$O6G0{(YkuDlLGK4Xg6C>7F5OJb04W57d*p~L-g)JIbfzAWdo!lP3t}sDW(LZRM ztVZf0`_91;>bERG6drNcTvP?}DMES4-6&ByNX|Ch9QcplWcWyiZhCE)A7ut~#O00qP_)EMxCL* zf^KgEFC*AG^EkhUC#d)bkEMKnUk&)Foxb+c z@=;0tpTvCqT#2(?=w~$Pt-)jLiH`Ttckgx_gF-uYbaIz}#}q;93H9-Qb?N%1QLMc~ zaw-$eqG!;u9eXHPuo5^X#J?h<(gve-~P-wdg8sLO4!zq8;j5q z+aVskS}&xP|A85-ImO3yDO>R=-_yb@DAkSQlpj0P2!=Qo4vM}Yk=wcT8Wg8!)&_m> z+0I8KhCU;j7B=feyunIzhzc4NXg7idl!1tzj&w94HN6(zvAC_+-qAW6>B#3S=)_YN zWsb&^GSlC$8XOJzIGYdwTaHMv0;EoCPn8-xGlg~(-`_*geGD^ zqf<15J}io9Mr-n8Q2UmJt8`g@aOdqFT-JqksKZEy=jPa*UDB-Eo&*b|U zr=p`=(k~0m9Upw<;}l#!jMz0z&C?3in^75T3)lzcaA{sZdpNvIW41EHQ2_m}zy>X` zvqXpmQx7rP=sB&RMO9+mwAX;Wcvj7AhAPv=6FWPrCHB--A1%#5dRMnW%U$+ET-R-b z!`x-SG2D@rcyGyd5L-+3=yi8MA59A-CjswBCT1=QG0mXXXiJS{5&j>*E!sRz3TuZt z=-{zG;Phsd>=@E@NLyF7C5ObB5-ig@w?KOB1*#+%B8LB)m!NM@;E+1p0BR(SPl+xaOw-+JJ|l(C2M*CHIK`U=*PA?GkR zN2)F75GFg(6koi!4b?*EKD-8bpcqETO!7g9-x7wCjf-P0 z#~{+(C<|K$!0ZA}hX0SR$a@c!C=MQMYN&rNFCf-WgnJB8SE)uU1BHl8rthQpFpGs2 zg2Bn01mOqpAY$6YF=R^a{WQ{Dqp$mDQ&eGbz^i8x{NR}jkkexQ$U98Eo!oVFADXC9 zSQISXIKSC$0XcYoe*1OxHB3llE4H83c+D=1Ee|F*vuO^xPq0d8!y6=oS=={+TMt&d zF@5SJH`g%Lk}r&hVj8!IcIV0gx}uVPtYXytc3$;?&xxWFp>5O10>M4wqUSSz^#?S}p`upjOILyQ>Jp4+oX9Hnuq@ZtmBtXl3UnbX&l z_aA5U?j<`G>Q|fuzw#g9wZJ5?8E-Wj$PFK&F>g7A6?QjwIiQAKfkV!{UayG3)QD1i zw^rgSBHP0|EF-;bn(<-%3F;+KN+HyUWqI&rudX=+mFHSY3^?O4KDvMQDyFu>UxOH# z|Mw7Wv_)l1d=BIRa%YZ|GgQ*)2Z$=v_0%!=fLRGUt9WJp;girc(}ywZ+|Hu`1@#%f z@3k}Nfr*01Xty>_-|(MA%@9Uz6ux*R+iK)W2re<@BQdE&pPOW!1omIQ7kN$??|>V( zfHmk5qlGHoIRfq9mm%R;=0!+2P&>s%@B9f3hy$vga}9iKjKs<+*U=c_gLVc&^ol0c z8S#y`Yui7N6RdQhOC+83C`(BDN}69o-jUcYsCte(7R9WWy%WcbdHrnq7UN8kVmxTC z+l6+MGWRrOjt-o^VWMk(elIqKR(B7xVBp41URR{ycc~6}9%36jnvkgjf>om)^}1MQ z%H()DkiCiO7Y#)!=3msK!bWb-1YR(kY$&n3^6;Jba5vW;4TWS0Y?i*yxwo} zithIv0^HM&WjGELFgp5($>+n}9Fx{GJ)C~m%>wFRB!FYJLs#En=dQxVy1jDJ*yBJTY`(W7*N1qNf7?{%W>?>#fb}FK| zkH`)d{&;UVnDhg?GL5^#O6Ta_)e;aR&UN1tAb*ozNN%l=@K*l(-zgELL*U*1vhTY% zr>e*~}Q+4q<$Z2@3 zs*s@X1_S3Kyt_c$hGRA^OGXbH(18z4rgm1*R_J$m(*eYZ6oZW)s^>x_g;k4x;7-MW zMbX&Q=;UZu#>=4JR8Wcrc--{p_2!C}4N3>g?89I8#0V8dWgwJMyP_A7M+BSNDEi=@Zq7%24O;-dm7f zIo{m+(m29tEHfutuxaIIve@B1cHqfFEV+If*B7K5m6)=hI-GTN-M&Z}6g8A67uwx5 zGt4Q!()6X8cC5%>mu*6g11s}Ije9GJ{TAf$%qXL&g4v69lOlf0QsH$9+}_y;?cE)5 z>kcr$oIeb}NOGRG?rab%hN(0;1poBltWY%+1uNsm=etqq z`k80N)?y%JZUT)Q;ppd=VCi&BC_)F$=cl2i47!I^D=|v+p?A@Vu9snGpo#PEvtnR0 z5z3PzAETVju)?v$Oslv5!MKau(aioc-pan47{d;7-mE5@kRC#aFQM4lv0baE>@Z*F z1g1zSW9?WOBILIZ%CJaQ@M$5)mb9zaeeG@<(bB1#i@9B@geh<3Z#w_7G(Ms3Y*3WkW~`WO2}xE_OUe?2US zTs}k5EneLH6YEHw{QxU@TIGBl{WG;}8pe9v8h#cxtc(7ZZZQ7M`z86~j;4DzBcSV} z2PQ+FJ}On_&{`X|5{;@frcl99M9b{V?v!5PC(S$^!6(h;gs}MH{|IxW;-8`F7Rlw5 zXV{1eMnR|Qn8r}fquKmkPTr1^K!Uz+9J303e08U|Vf39eA4y5mfNHq1Lm1(HFo+Ab zF1~n`PWq@Lk_rrP*b`DOIZ~~zovS%XvT7&xWq^5@?AL0=6t3wF_O3~RB`WvZ&u6%? z?l%2xg1D=4*dXApeoS_Y zxFD%x5!zHy_f@BqGp4Nh%rhOjM5Y&Wl}Du%L1*(a{V?Hy(+ zNv9KQyH*Qh{%1!OcmBCccVxu0$s&6ms}yE6zqsCeI&dpHb0}ypJuk60U)0~=sA%{?#H!Fqm21e}-))&3fvMD&hhb${G4lP zJz|CBj$i!_M&@8N#}?-%ZwG>#uQWzE?E)W~2Ka6JB}}6ErKgg8hG!xKw-X zUj1jd3#X=AYKBqf=+})|ypa^@E1FPW%M&wZOvkyXB&km-pIczL&@J2L*OXGN=6eqJ zU`EX%PsY%DC7cH!GP+tno+k9qo?y@nQ=s$U!}mm(_7cn~+At(-eWohdTN1RDGmg%f zx_42M#aKRoANke{K2Ktyas(nj2Y1mAsLv&sT`&KJ$mI2D=rme;aXjTMU{$;16Gb}6 z$qR|>8F~+~k=AekNAb|t!{C-VzR;`=pgvlD{{TvKaD?wDOhrImjPCdKeutJ`AqR#@&|Od4%NZ+FeJ9$~v|LJ*S_Gf$uMK zO60z|DoNs+Qa}`Idja0Q`r^7f>QeqWZ)1l zf^!A=j>?jb=)ac5vNv-0CyLE7g5uT*?<60nmsckP0!zv6T3|n93-`=gIJ#UCJsePi?klx3;y%DD+Ls|Ztxzwpc^1~lm7mK5&8dqGDWnn?IjXfszY4v zZi?RZFWvl}Jh>OahtuL_!YwpuKAXsN%A*^Jahj<$mc@6v(TYXii=L=o(!1AQYO!`jxy?coXQyv>VJ|bIYH0Kb@y0Qs|B-q6YD%shfx;hN-# zV~M4yMbXfoatrvHc{#dMoRJNtc(KGXSv&eNrkM8jeE69w$X-Z6MbIAj;!iwNG5Th) zFLKE$B1ml+fA3Rr(EYNNGNp!Gn6+_s813kM=`X`v`+k%>RC`A2OHKH}Rna-8yy{)i$Un_s{APvj#iB~Mf^P_Cz9 zBec{d+K|Kt7zGv0_fp@=|CMp={!HIfrk@-6G3#wDl9uqu=4Ft`>_EAJ(F+ek3^=D+ z6QO?UM0IqK0@W?ZymUMVKt!@27PS#ai9Q1sKI+^x>l~Y zv+qPTT=)#mq*cKuZi}u{fe>D&QkNR|aM1+dxDb3)602c2^auv^MSAL|7`3SpD>=|o zjlHKt;YF#FJ_W?xQqVMA~f={Q%1L9xp-vUY$$At0huOkaCu+78| zFzcB0O1O){+5_XLhf;oL<{yWwelzL8<{zpbizodj3!qr%&xO;D${XClgn@M|zSi$2 z(o9>2WmAOuzH`9lTs}`5^Kf~7M*qF&?#>q-$9C&rQUur}WeW&PiIP^8M4sYX&M_M` z6F!w(2F09Vq=jj{iUU_7uh_naSs#TLC(|Ak>x<8D{!vZ02=yW+oDS+&FQ+B@3R2<4 zobW`;vYS6Rrx*UD=~?CaopI{zmTiMaEJw8)l=Qqrzvj>*E!rL|nypxR=|)kGCHVep zemud5B-C$n>4;~ZthIWF4weEuQsKCC0IHB#)qT}cEI3Bakp4=3lhu7N1Q@5&D@$hW zicU-4qT*?&C+i#CC@+2Xx$`yTeuesLW`*IMR-Wz2_yUZ~AoY&qs1no?b)|JG-0`!^ zrySOCgSu-?j-7D?T^yUN(b32K8RCh1l2w1&*D^U)qvkEz$R%;g z{ir*lquCp?EV{Fm@2?~$^@M1?WTtOy9^)2h>fwHnPBH94EBabInXL7N?})zn8TZ`$_-~BD zR$Ni=YmuJ%-i&K+`RQW)-crq;cv`9d`Bu1AHB6j2ny(PGZtTsXpqs(ZL&t6=DtoRE zUy@eY0=)M-2AnSW!E6cTmh<h?TVD$>P%iBf3$i8l| zL95|1${Lt4rYWxxVdg^VV%YS2r+* z(bl_yZ^Er_U;~$2*gNSacK3)0(~Yc6Wa|!u8r1tT;R{jQ3={?W&QofuP`~T$4Ankh z1}-2%QAT2CH`FGM4x*JC-^+Tj+XdMX2c*5o#ZC`h{J5}Gy-0~kQfqrAo_LiS^@Np= z-`cO9HOxevRT5o_oGw_ZP4-kj+;S}u_$o&*VHd;;PYAc*3-7QGGc>t#_&CCT`j@cU z@%oT(3(-U0i&Cf=@7Sw3PEI1z3w$l|iM*yXH@!DdnySA%!%{K#3Nct5@HQlS z%0}z^c;+k3t1C0N^?VpJq$gDv_Pw>czHy;OEgl_BFRM@;25rRCqsHy=%wNVur>1H- z_M2yht3~&QW{ugp;!rc6vrx@^_WMTvsd8P(aQB0$sM@244Jl;s92wDl{Wwj50t1Ri!1#mq>o* z-qJVKuzOZj_Yk`7QFD7N)A*Hs_TsFM9}pbN!Xtf&xv*V6MDI$ADoWqKj00+v)hlYz z=5N@983XSqf{F~>g%uH*%?T{+a^h7imK}p`7Qf}2jG3h}jnGekDVc%;p3FX=7tgkP za5cx?&Qv$AF(t*R2ba>J-$P7sLfX@cwl~8vY>gP|K)}Xc0I~L!@}u*N(H6b)_&HMV z8xELncixANW}PnyMlI+{W^)8RV{G7U|9_(w?mU|B zI<`kW_4MxOoAoCb4X9IFs1FyutQuuSnOpddNJWW$ArJF!03|zZ0xGm#F~Zle)=gi) zyF~FyZ!knAP;7_-aL_fm8qkjk^fO-MPk!0fPUtV&gu!T+t$h$@L5iI z`5B`*z2zOgusIwgB0hu~fWPraG5SN(W4DGkw8!t-<0)wh^Q&6RM^6%+^ryU!xV}_4 z7wtr5ct_!LvMq)98Ooig%{GTM;6HOWo32LhEXVqV9K9~7HnSh6j$QbQhm~Hzlp{wk zOBUtS9}>1WJ|OY7mTk{%dZ%7CahB$42oL*hJZSyUTZ0J+wcEyS}qPvzywaB!jK(i4QpdaUJV)jzzYM@gKL|0K9n`8-2#&+19dXL$o z{Pw40oBI0br9EvZBlzFvvHXU<^X^S6&9nAUHg_jq7+xzj;*B~VZd1L5muJfvm8eX~ zd{KfQo_9;jSdBbURs`kLZ(b%iwE_@g`?;rZu7VMv^I+Db@>h!E^Ec(}ocb zHR+ZN^QI6+Ct%lmJwa4nEsjSGHkb&oJ?Og z%WeZpJMZQ+XlIrCqe?wrhDpj#^#i_~)rOl_bkw8>&N&y{Zg*nrlGyiz1uOEcIy&?E zP;kJv4K13+5Q_DdF=D#el&HY^Aa!05SCPs-N=*}-5&{-V^);|GLW4t_rm|8}MC9UL zl3~+s<7Qr?-@ZRF1|dhMAZ=fhF15e$ zDaRnO3s^a>RKZn=FspnOCLX#j!MgqsnY9+RpcOU9m%{OHEAwSI^mL*n6nx^Gh7Kx) z<#vYK$IKtDHK(+67 z%|MZ7?0MXr`-5a|K9Kk(c%Y|<S-i+io+dKP`7`d;Zr<>Y^ z{ZH-JQ=R^MLMw3iwV7yB^ssij_(arItO(AzH~52M21rMb!4A^!&&O5~9n9fWG~va2 z$%g;{-s^e3Io_$~4Q#DpZs3x@e(8g0;eLd}Sc#jIr4+luSe8=Aj zmsLTcv#hU2M+o7Q3 z_BMJBI=2V|h_af4=8ZqcPIGq7!;oRs*P5|%1BoBU2gbw&qJ{I%zm_n}cH&j^KRQWHqIg*|IzX5>5C)VOQ&IFJ$WiI7G;j)TyzM&--XLp!VV$dbJ)7isIas|D37Jkz?3j zBv5{&A~0VqPV_t1#m$S{Q$lR@kp;Zjo@~%2CW= zTx{y_P2z5jfl51AyNco$q67%QJ5Ilm+kyOinW@)XHgAOn$L=INaRO&l>szKum_b~HRhgPI+U#@H#jLCnq&dja+D(CB%N=51|HOr1}7_2c!b z__{wpDG>geDE@ZZ(zDufbA>U%gVT#e90UM|>B|70Z0L9dUI}NAFVZLe-)_QIj(btf9N z6!L1Z!sAa+DNSzFbWzP#;N(VUM**QSRvXAO%U;Y2gwI8VZkY|yRdp=710Fq2C%t*A$>B+%H6eJNJQytfUuIF}mW89yMSkv5Rq7Ow2oLoj0yyZV3|vpdI2cg{GT>!f67(ag|hp#yGRq{}GMw6zugWXBOsi&y-%1h?cdRjFEb4D!Y$Ax}dg8KX6aezfpb)TbWQZgF^awe zbGS+j6l`dAxSMR~Ss?nMZCm1JrxOF$P@nDoV4pE6Iwj8R4Lu~z3<8m*dpoJJ3Rx^I zB>m`@X&&BZ5BDP#4ge$Zx@LUea%TDuG=SWB>vHU9@xnq7TVu@44t`C zapN)zfMv%U^LhT-_rWZ*Pwko&U3{WA4}Ew&(@(71O)E*~lQL*66)6)p1&jM$NOZEE zhT#QxxM=fO$&T5Y`RU*s>SI9`1;iHCkzhb;1E;CR{CRvUu~ck7RCz`GnCZNK1JBlY zZs)?SF?>x>6nWD|_G;MaGJ&bPxA-_c+;Iw~3WPLo$!}UFI(61@PohL;x;{~QX(`4(o6^+zZjPm= zOgqC%YPMF6Z7d1V9$Lt$Y=tl!EdF;g-*wnF+|6~dL+DUZ@V3Cq}?eY2`GseVGuN=i2EAG$h`5A4d}Wp=S!A6XHN*Di?2bFLQstNq$siodfXnf z2+q)uAy|>rEQtI7L2sXr;H10k)HiBI6ahAH!coy@b^>@j+qgTdOb?@|6{DBzEQ2ts zKXF^RCwly4~4EVTH~xoXkhM6K%JXvML&tOW&EJ2Q{v{J z?`)KH9ks6PAzlW^wHv6#1x911lRZ@NV*45tMmRWB$i&*&<>S=r`4tk|n`yHW%y-JO zMRwlA&KU$?2?{zBBcAYx`9jGSeEyeZhmya@FC^Xg*`&t-;bga=Tdvq!+sw0(VhZ9n z!{N>h51<~tUtWM4l&f-ZCTAOM0#}@l@+nDHg%b8ofDmFEMURhhenPQa^GW|54DJ$4 zhmFOFU-28qyST;Q$>TfN1%RX_vItl%rw`Chnv`!A!~0hjb4{=8k~wkn#rDAUU4!f& z<|#LmU6~xksx9zb5cwzO%Hzi4c>e#6^D5V7 zpXV!bXojH0LBL3~l_YaBz&Qrg1EMnzH9E;2I$Y2T{U`r&8Ws-f)6PkObk@0A{X5am z1t0-7vS6%&_EQ3iuWX+Ii>CSTId=EYd*kXVhAVuSSGGL>Ok!09FZhvjk8#OiVbvPTeLNB}C?AvL9`Q5L z@=N)MstUgGvN*{@e2ZweOJC32&c*#TPTiTQx7RL6@nqBXIOg!a?e7&|)0!8w*WiIe z)+}`aSmwMPU?cKEZL8pIvnM#}X|J!LSz&7!z!QD#vvsyPp)Ow;b|~2jH12uWcl(9o z`I6L>LU~GR1H8x}1$;=vA5n1aOp8W5){n_kKJlvSobBTa(^uD zrxpQ)HlVQrgLtIj4^Rf51b=;w*p%^qhD5Xlc(@`3Zw&*?;EryJ-TV&@JJ;W`8@gKv z`jQy7aEpPK+D|FM-!TFH>bJP5EIboSyj!RQ62stZ#XJHon(YfL#X>!*O_i+1+f}wN zz4Mq@{GJXm{+EpE;cH3{U$8K+1TP6jb*@t&7W-;YoiEc6E@ZV}p!;7@&Ez3C{p~|Y zPzfF7Ky9bq0f(`17!W{{tOgk^Gt@5`tY!n_(d5!z+be*8(PDIORR z;KnP>!>J*kd!T#SIQ0X>A&=s#7=L_hRqgt$dOw0Z?PAiq*=^PMx9m8uM9Zf5_7KGS zQ>xypH~0ue$@fJy$`h&qnAIYF&O#z!V#jx{p-GCzv$r50a?Km>lDb!)$L)jXTF5S* z>Q1gm{Y1Kce**^zNxpxUU76_g5R z_p^H*jq8W?1;@sF_fZE^X{EC^?a0tlWp>Z;ke&QY6mJ`{34lQQ{fxl@p)sg$DlHt^ zM#VQJF{!nzXuAdYXwI4rQ~zE}c`$GE&Y;PH!KH=ndf#h~%+UwBUk=f0SDm*Ynb%a(?B$Oefd+9!nOr7A{?v4Pc66dHK|zcNU?0p_{ODh4uv)XT z@1~tUHzMKhXy;`9NtaHc!|&Dg6Lj7!oy6fY&gXclEkzOT}avgdMi!Wsf!mAR1W;d0zQ<1buQ5&>9?JlBBAo0NKlNq=0?kI#%2h8 zQJ&dgGm&63#fuN#izF6aBRUeGwBO0@QvF$RR18cgB>o2iX2&|x9;klwnlbO4+TjDl zvu8ogvlNy3Ui3{X#D_Zmc(1^~^M3#mb12vE6{d9{Egm08r^e%%tdnY-@o-0dv{S-H zJk7wli=N9j<~H8-s6Ew9(!X4an@IQ#>A-3k#Y!drCwfic7iYYiFaAK<14;9Gt~Jm1 zY#~ptTQ3;+(=Q0Gc&`_l_SpdmuvDNNg<7L^p&+lw&u`?yX2!!?{L=}1TZ@L|BqI@ z?6%q}rW!HdPI<_i&sFAnYc;HQ#tcONKnA;G&&QLS6aJ;mG{>a9ro1%rovzhyx* zjdSQo3I(pHIPvO+w@5oJK*}ur6RodSJxBES1~{JK>P#cb`XNdQ(4JDVM4JXg_D5t8 za0@{AfY7mo3LP}_HYCsvl$YCU-FV+rq!n(PR=5?Ksqg2JbTTjV`)t7xtX)Sy3rBZ! zkLuxY0ca2uZc#Qrjk{ZwA)(Z**b2S#(C*Q{6r1v0B2{zj?+MppJ7+rux@&#~n%MQO zE9GauRPM?+1^O)Vmi`&iYk*OTSP#fo1@MN)+#*Oo!VY{G4UPwZG9wx74JFsK96B^> z_{DfRG#-Sl%82OqZoq;3TR=4BW=bt*6}p|5V1V}?8bjfFLl}@!$(^kIGX54^4z4L| z*u|uzd!qd_3GbA_8_)as&_1B{if_8C9HufRzW|LEhr><%@&!$&ma3kM9X{JXW;HH2 z{Cp#vc;y(PfoW3#__ppYuvW8Ur)EvypjTIRAC?3p0oft}mD9XT)z_4JnBR7e;AB2b zgACsBW)6Y?>O5&L`I4a2-3)MQZM3%%_yu?F&y2p8FrAWy-JWJe+$-1;ouq>};}WT< z#m^xIeAmP&?=?I;>X@*oT{JPvx!ZW7e%$*AzPL^35T53y-tJ0oOp=t<+iwF5s?#?C zdY&H@5F5Q7>>~S_lHL%{;D%30{H&3~`SVA>{`plt825{7x-O}&02r|P_;W10aPSrX z7W~{x?=>7;wDkm-nc~)w$H*5Q`M|n~4CzK8Q(lv#4n_N45Ml;~d8ExZFzbAd%=rNb zV6#f5hednghr_MC!IpRY0UmVTL8&wc`m9pnKg?p%;xwu{i_9-~L)=s?Z$dw$!b94K zUFU50!(;jdm;hJ1pVGC-a^nG(kH&|kj(ehO@YhB9wd%7EiL@M792>P(WGgmt7rn-1 z3l=9#rL+eS7cEV!Nf@eyt#v2#$Qe=o^0rOrID z|A=`M2zeixPKERzOAg6pVkrP1x#Sx!(TS{2bT>7%1Eadp(|fdauscL6X%TVjs(QQf z8a=#*Ry|(!wPKb+WLg+?I{+FCeG|K((K3EKjQab*A0p4(%_1|C`A&fQ$om&i(MBfT zgcVxUx~teK3ojGFidX;sza5eSzx61$i|khNzr^=8FU!MtOa4-IGdC%Lalm*907wz6 zn0Sl~@kxqxp93h!(c%r82I(a;IohLc4sXqSVj?r11&_Mjta&BSsq@bho1a(*9Z(wb zOYKy{RmAL<;g`^WH|R&Yxg}9gL}<Gwj` zCClK{2E#iGl&TJ;1#i_9bx&cLtCJ+r5hl4^X%LHlK{`Sx+a_|e3sBWkOXjVOQu`e9 z#3KO z-?}e2k-;{>ye_ihYbbL|feYdgVIdjrNikd4IpF^XY&j@R^u8o|{C$#NpTv2c#1n=r zMx5`4_1(V6ziZP?B0b9v5&mQQ|u+S^^nqpSaZaf2zd8OrF*nbz+c0Sh>8$ zaNEY5pnn_!wl!C9;UU4oU(XW&%-!K>QM7{Hvor+f$+{)=fmL|Vi9d?qf?Wcll5#8} zP079^hV7B~Lsvx?9&(HULV*$W4d1wy_D$51-DoG_CE66h(W+oxNJT9G%IU`qO)6w(ZY10$l6nI+|JdKT%;u z@9EA9Ha9PVyF)?8mhJleF9~H}Ztjx3nB8|9Q!F?eX;zVzOc?7iE;YjxfWAOjIXhV3 z0{$8RRFuZ3@VkBKi-ub>Fj}G*3R;+qD5W{*Oa`y?dtrVKQE4+mOwu`S$B-V8_Y4R_=2T$gQ?_K2F zduuW!WG!x=;SRjetOEHJ$U5Au>*T+n#Yli_D~_oV&jf@;zS{^wDB7N4@hlAY`xzi; z#uVT!J5K^q-`E{CM4L>$er5cBX`(Pi`#}mc2V*cZI5`|?F%i^rokBYXg>I!4wKEzP zzR?=G-J^-HuZ6|nKccOJB&>%vXquynzN|mR#=)ZkruMtQzbpe8m|eL85k=Rme}tix z(*M~IZVvXOIoK0Lu=Q}+J*rJ$gri`;8YeHc3r)XeuSeB5PRaxE=D<=I*7G$(y{8jF zQ&g(T`8n_c$y(@)*jXKrObbmf6ocRjxo~zP?KKY;Qj}IH4~fo$JJpc1uuS-Eg8NodusEg!WD7Ki19;GrGjd2j6IS!bSKLEt-O1+>f!j>|g{7x?c(cu+Q=D zqlsht^duJxhJ7(TYvNQy>ex#`oXK*G91={&C2Jo=B+>_w0cIzlgg6SSebutp=Ivg_ z+oib#IlZjC^~zHU>RZ`PD#~#_zggg~eJ?BF7<2$d4X$O^feSSGFbJj6Ljrvq3 zkD>ili(9q@-&lQWBf%H#{+1{80k;kMhw}-s=73En}%A(YVB@g>mh_q+%_i){eQDm zy!(0K;_#TeXi->`ClRQb78WbUQ(_DZ&+HjH2yJbgxU>#XS1T*lLWP-`?~1!?9vcji zB$$xgPOoX?2)*-IZ`tqF7CXc#qK&a@tii3}XCj;K#yct@&IC1LIoQA321BalLif{C z)T%8_#R~RE%{u6JXUAK)}zCDd(KIIlIq`RiH z(t?`Zhp4CK4IAl}$QI(j<0%)NvXPe_c>!r{O`0K#`kZ;hVuNfet>ByK0&?nPcEnIA z$d~CSFIq9=7HayS@53w3q`H~}V1tJ~NmEMhpGN{j*xfx~ZAbqB>j4~WyYOXgR%3Ah z++DR%{2o_DB%ri5_v$P`Ai+rawVUw~q?<#?djzE=iRBeasD;M>tW^c<^XU9>FpB-q zok8ze`V!=XGKaqi4Nd$_<_z3>b%tHU#KMRjb&s-DzJ|MQ25_3uVgNX4_zf^}4Sc}0 z4dS!lH?`o$K29NI#@)E{+Noc?f zs)W#sAVs2%f*+%57pw57KLBS%->!rZqu%2YL&NIvU;)kNZR3-YWx#(d45TYn1cPee zaU?3oejqw#1B_MtenYh(0A{To(RO~Ogec3L0MSULugG=BB5bD8-DqiC z=)atkjbX5;=GC2`=@JZwj^TK@e@AOpw@oOgB3Vy>AojHb#G;MAiUt|)tU(UP-$WdC z%5g_qm?wXcScZU6lWr$~DO7WhQfKG(1I5M0Chd5d>4>`wb?yi4Vf<$R-ca9KVuc}h z0)$hN5qMf3Zxt0*{iR83WCXcuL}X4YDJCbHQACMm1S_M&Ly5@|F415KrxIO`Ky^-F z-;)>}00|WKEx0%$>X-50Z=R~P70$AMe~gPfJWdSML(b22nE1{3*GNasvrlh3EA#aM zkStv}ICV;y=U7zs7H~wF(t~4^1!Hva{Svs{7u73E$NI)z4x8O9l$io4s+s^|THvSk zv3w&W$>PDC+VrN0^!MLyu?^8zbU2f}VycOZ2nQ-H^uqmf}x6&Vx1CTc+tk7WZRDfb4o}0CE{FSxx&tV&R#A*}$GI!_pFQ?PSp9R8y5Pp?)bY zj8VW+jx#T1nUy~kqHVCkgp<#O%EnS$;Zx3KVrTe9qtI{(Xr$S$q8QKH99e?E?yIgOq$q~z|_6I<@mUXh2z(<9jjW#!4pni z=8qBEm$nmc|JaNkNaqF=mo!PQmZ*V|c2v!6g_(x@rSclFi>M!TRP>e{&8tqz9;Zq% zVh}X84B9N%*z_aUHS9kvnr`vaUKA->z6*WJVJO* z(*;!w3yC`cO)JgRSlR&SdJ;nAtBF=d_pG*Vl^aiHKN?RqP~#C4DC1nO10=?lzh*6D z9gDV_-tRpXmWtY8S{(M5Nb;+1Rj3XCCG}9k>;cEM7e~U@CM2tKF!gcW%~~Xn&=b$d zo~vUvvcrAbR2qKEsAS&Wq(Z%`Vj3U|=2B;AHo-h$I?n8XzE9=Od{sT27z@AoYqw;4 z@DT5OHfGfT8>tsVwghRESD0vjkJ50l^T4Gj59n5N8JcFB$Zj$iG0lbuC__$r- zl_zlii=<@DyO*59zKrX^A)Gx6$=jmeOx%FO}FJ-#~Yd6>)sk>^)oW;es$n#f6rsR*k1VBzc2E7@h9}l1~-cr9%xe@8EFiE4Txkd5pFycFosI&>w z({PUOzc{UjJ-ZLK( zf;w$v!HKXqCE}z>Rt?ftb*~dD0J>zMEB4~5!4JFf|Hsmm$3wOL|4LB_w-iOpZFS2s zl_KlhR`({{awEi4Le@!^8O%}%w-hZmDxqB^B+FQ5Ea7HN(qx;3Y*}WkGtBn;Jbi!v zJg;*;&-?TKtj}}KFmuj>KFEK)C2vWK#ABuG>p5M?7%xshHybTIR<2E2EDO@)_x#QG zXu0e&b0gX(@C@hXcKw-OEK92iq**_9>Ff8HL)9Gm=n7g+ry30d&ocROK%H!Q0;6%b z3U`&~`Mmyhxl)>O=7O}4z~z>7zr~is_Zuu(iBjI1ZXAb;(fd|~OH+-e8Jt&<@AlJ{ zw5c+2xTh|lIbm|G=-s^A$8 z|FVh}=EJ%9gLQbe=M~i|OA+fwU+j^;ah=EX=>=sc)1i+ic9C!VU2{90%hX1;qpYD> zIU76#cU(UdAG`Ohuk`iy;>o45jEh(iCS{WVXWh@GQ7x+E3GvZ#s}A@!n3#9m=$`R0 z@{Ri9mik|tt{L?opWElo?I&U`CDWRsOkeNE_ICfVrVxI^@#faol^(f$x}=)+GU8qM z?h__yd%<`3MbMpdOLIcgDW=E!w{m#*G&?Hw<6`DRYJ%2p+M8R9$3B9$Gqug>8a^ z`9cHI%;11P%Y6}d&sWnctUpevUf^o$RN;T9?8?ZO!Sa;n zeM8Eu;!5I;<6}R-SwDw9@Uu|9gOs|QEinJOhZoii-(r3<6%XH5E*Ut$4NFYD%#ymQ zco2$=%h;6}f=Iqn#fT8MEQgu5y-b!_BT(#7=c<^%57hhw(`(Dlh>r+j^#`l9t>G!r zU;euUG>01!sjyFH+o-pLNsEXr_Xx!Cp0ONL@~_9#Vy0ABGDC2;r48k(9WRz=G(J z7d^2fL_Y-S-@>f&7qDlfo+SFha$Zlk zZVa*EH#I)n)2K}Rl0*{zt1HkQ>)}~B$u0{?d$rkZzbdjrBAiJrQA)gWtu>WVh85|5 z{8)2@yzw>NUXR3o5XCFcnY6b1;pnARmS`yUeQwPd<5G@}8xwMy(&cvZ+BTh3?R*Eq1J^`)eCl_GcCw7vjpIZxB*=d5-nh$z+8f%+lQgmnwOvQ)G4*51Nt#Jrx ze1a3~#H{BID4gXDl$KOA8LL*+&Hidsv^(5*;@b1vZN~(`I_8yiS)EE4p+JvJj`tNz zH1MnHYzpGscC%IJCvU0Ii@3X}x`u4fIpB4voJ(TXglSNXd-`rqSbdL3}=-{1HM};DH(Gk)2k{sUM!5dc{ zR41byUOQ=8d%e-J?*D8n`Z8I~bA;qKy&eqZI?{R_HrpB7#yLzKm+a1P!ubD0-zKRCypxzahjF|F*hs=N`EWzZQlL2WVcWDUoh16Ic#qFyvh3Z zZhv2l=xu45paUMk-PAEPQ0c=VFCf0^P#@oMV4^K_>96dkyEE=6kei>M6g^Vz;f7pS ztJJAmML2fRa;N&Z=q4%t^C@*mPKa7w`r(ISo*tR~`)u1EQ{lOMw}-+KD>AjEM=+N{ zs~F7KPJO6s&UM&qc(O->!EIF)RcUaz$|p<&F~{iK_=ovdu&zZaj3Fmoa&VyJ+Vh&c zpejwgqhxpLo1j>Wj@%N*_|%}m5$yIzWXjiL&dGs=u*2R~1SZQ?bk8&#bM{84#gm)LjniALL^ zF9C~BU7WmZyVCr^F^4PhW>B|-J7BK3)2zrcOYsz=QF!f633>Y|tKeTwQS7h5BlT-Q z(r|yv1l_x`!Wq!!`VUHDb5tHI!8@z>IJ^3A)-lGf z_hu9`R>AV0F=^wCU=LQYfr6;4Kl>BEB+rX|`{rURpw2wEZ)hA-Wa z+%~d9G~kiNO`!)w6YQlcIGNmU$9*wbSmGn-xpsgT)%hrne~fjNf6ZNy z({=QkLq752X%YJ$V*zERfG1v`Tp?VdS1oiN1W)Ao>H?`u5`z}5>eEylL;MtV0A~AM#g_XZuOjM^$ zg;kDLRrz-Q)u;|~T-2O^^7Q+R#R_Tw*g!Br=wxK<~Y##JN^7G6qUd(hHu z_``UjK%HQ~(~DYC?GO~GihEGFlKN&7NAF0+*Bf!^k(y= z>V0g1q;c%9ATP|Rx}}+_fQzE6mOT2pMO3_PhBs(bQqdx%EWr_c7vX5J5d7SJ$?h%u z)JzznEFHc_DSe9xr+^U&l=zaJq^w*@>YR&unxexD;nMTrXA-WJ=??&csy?jwSOybS>Z6*pRp{ z%LNq~P(D_tLk!;SPe@N^b+}+e5s8vvdnlo{sOo+hGO;|r&!6q!j-uD@6!)2pIED=_Hj$v%hl%h zNe_4xIBP1|WmoCv+XN9ctfmpMlWi`7Q*wR8(1ZO6aeZ54E73H0s+#m@`6TEPuo z$vT0cW~)HZ#Sr{c62@Jry34ZHoci#yP9R+F#*a?Ka*F>}rqb7g$h~2=s3-3Lm#ExQ zwW;Y%>62FH`~!Amwl02wpMbdB=jT30`SZc*0WMXb$JEWmKH+Ld%k| zO{9EV0x7in80m&b1nEZJs`TFm>@6(|_oD0{*LDBFL^3$RPu%txS zmADgM4+%(wC=&VDYDwj{1c6eWuxby3zv*QqMz=(PCVHYHX}#nwu(6opCGHyKCPsC~ z;@I7avb|mwl0Tzhr8+qA95!1;tX=MKzI9dFJF>ndkF7^K>#0xby`nAn;1(&^oN6a{ z{s4BpJBtjtA5Uag-W_{bb(hlNuxU#&H)ESs!HzhbRoD{Qw2ddJ{=Yqf)rm(*^>wX+ zFO|u>*HPLPj>gUvZIQ759|`fo-TXHxVO;+OF}|oS^q~iEe-o+k z?1Nq;`|l+*#$FwnC3&gjkUPYw8SFo-z0X-Nr7qCU=^qAuU>Vp@R5Zr-CWg{ zqg4)$k^V#Qv`|JJxEGlb2k_?NwX*SSE6dD<)Q88vme~v5rii&6dzSM$jK4W-@>1%K zVdi|%l~Gs0X_Gc1=Bq z&a5b5Oy{kGp>3Hvetum-Hdgv34u*%(Ff2dJO1}Q)$%ySCM<9CI0G{_wg4V=AAQG)F zVf-yo2Q4c_7{+2iL3Se>dvC=7R`L;5Fu$c^X#R6L6%Au(NQQwEgoc}FI2TGe*8Gb* z{$IDt+1UD;XCv{G^Vf05=3WfVKb5${xdVL>E_NxO&KOYd+mx21lwSf2t>L-*y{Y`1>%%OJH(ER>P zy%NT!PDok)@z$A`aGOxdlX5M0{CV7dmS(#vK>fA@|ClvUuonXb{-11kotuZ-gx;H- z+V1!-MX}jfKc_=1%{_Wx`5^@PbN~+;{)<2(44A%b|DC02{_N9CO!F}ypMvy$(FJ>c z`~xh_0w__u`C(9MHUXtUD8Q?(C4g{;-2d1LlaYZCi`6<1#eeK2xyy#7S)Kq1@W8ju zG>|!J;31n2BYK?Y^LsPQPC0{|0eM})1f|1Yz|yAmpJrzS8I;iPS~m7* z3sAT12kMJZo3+CrIy?Yz9XkN7ypn<|Uo2p<1Pha6kk-RENT0VmP;^8BMbg!5Y;8XD zuICqk9)(?M2LbZdm=3KKe`t1Ti3&?QfI@$X;=t>T!hW!T_b#!%8GnEqMT_5qV3Qw zM+2Zew`Lz0E+VU?)Z}&Xs^3kVC_$3$i?%&K>iH&+W>DsrTh+OZlL|G6VBXV zPdS4cYt#UClAdjFmW)Wz^1EvV%HItqRnlGUs&w~2g zFN7{V8U;Kr=`h*01Vp+}5bxcPCu0rpWE~HjW*9*nM2KT78mNy3f_BJufJVStYupYC z!`lVw;Nk<+Z&7`^U?*stMIR(-z^V%MiK(WBQh2wZ2L`5rI;0S&&9LCQr!&Zl;M%iy zD^L{2g4fxwyzgrR>%cIGBH#*jmJQqfPUb?8<1~Sq3DIbLfi6_`hGn$`QhoN!p-@Wh zg;gbtlSAOY26Fw7C;0QU4<=h-wdRr*!z3A6&OinihDVA}kqmbTZW|Qa05wxm061%V z9GnVK0;kHBgHveRw{-&}FB*XC^KZcOb|>%@zEdT47)q{vxR|Ob=+BF-Oje4lK5+tm zhgJ_ifOI9Llmy!)_nnzjM{Q>h#Q&tJX;|EN?pQwIg{ zW4UsH{yg(9_|CGXQ7Wi6xK7h}cP`1WPWgxBn)>J9MN%6TrTDi2*Fj_sKRmq$FIzm@ zvv8V}You)D@s=N_i~UNlNz@#{Kdp;b>G{-G6RR>barVHj$g*$e|Ix*oWdEM1somGw zSF_a$lzg{=JXF)lBOnM(wj4;*Od)`#;T}LFtpm-5H2^DE1u*kv04u+wi!Ic6R;SDg z9-63{SsYn*K^hC92aoIG1LHucaQ!riXYz}cN72~v-X+E5hZ8lsqJVMC4SbpX8_1qT zufm?M^Mj+ll|b9E%8Jn#XSLkQW7O}8E;iioV4`Me6@bS(uQU6{UBCz79sp--2e9!v zfK7mxQ8F-Ct`0DE8z2Y^VbT{py^A0Y7NEvMKJ~>!?T9QByn<*gUp}c* zPHX_3KOz8iZX>W>R0Y<#7+q{a!oEaJn{uFN#X^cg)`F5HB-b*pwJ*jQ2iYl5u<{_4 zLzs0X&+6hmwIOS{=YXe72Y47@ay<>QY(E5(>b5X>?GKoIzX2xAFjgLqRses7AEeZA z7CiU@^$9M4^6m|c1|>X{H-iS6#(m(ygS&ueBm&~=V$ckO#_)kiYKr%PygO)%$ERWz z9Fehrpeh4LIz(4y@w85v-wwWucSe>KeL8+kGjty$RC654p1u|2K2SHoGDr&}4AR06 z*y3@E4<+JdK=_iafMUi2ijM{Dy$h{8PFaFyMjDV=+h<_>#WOJZ8Kt*lEljeZWsR7J z5;bLqL5T(x63`NKv5QIoe<^HeV&ktXQG>YO)Wv3hfT%N3b=tQ8hu_sz*x%k+N0u!O zg=Ai?1d(eP&<1LO;ekZJJ3}^DdZ08ic#pJ?MSD^g|7*xJX=Nz1z+wvIv9h|g?~q_0 zh$OmJ9^FHr6f_D-rXB!I>4D@o*#YfWa^&NTz9k8Lt_2?$KG87NwyCM#dUS(T2J$HDL5 zt3@;fm}&)z&Dx+y*Mw+F*MPPiWc+q2*#54y#pAE zj1Hbi&4EG|04TY6WZ6GoVL2Xh00&w%A?9g3xaoOK7kjoD@_c_koLOjDd3?}?LgYpO zS2NV+!x%Uh%m<5QQ1O3=V1J?on4`0SxiWH^Gy%2oundUT#p=ERdG%fpy)ug|BjrQ8 zS(ZTAby+}>I0#|YnL=21e}Lx4P-r}L+BE6*U!cDEB;@1j6qtOn6wV&P*@r$jo6wIe z`$G#l;f^ZA_gn~~hy@^GgVT5LAj+@;!Zy1jWsftq!Q=}om~?^3 zoDE+4-h>!B7lBCQx-RxJbnT(}qi{xrv|47uj*->@Iz9|=&Se?6Zw<|0iGyxV8w7VW zH{BB@VJ*R0{3!_VB5VVsVkIk&vPNizoJc@8yFv7sp}^P*o8-B-ki>NkfFE%J#scW4 zoM!;gb_Z>5SW~1BZ9shm)B{!UdScr|-584*CfFC!2NoUwU-Zz5R zNqUiG|J6f89S5L@vsAE{3U0E6z{N+qy;u`09&iT5GYXMqqFYyWu@^fbw)L6-RfnZ^ zaRz9zjbZL@g>rZD!vwaG^^(W*__FImV;c#pB1`|9I!w@vI5afYJ9Tn8d}3~IWT{A^ z0?>7r*+z`@`w5zOYry9yeCn!UxgU|#=d1&)n;KvPjRBi<1z^PA37Q<|C-iu}T5H!K zs`7OBZRYxN_wP0!!rW}_s!3b|N_B?Q;m00FvyGN}gZ#?xaCUM@x%=u)INOhhGm%oc zyCfgDa1J0!$AQV5+n~r=3D!n7MV9`ib%SkmefB9m{^?P`cWZ-oDV+6&0-!W+6?0PP z3P<8)0QJ4eHafBx4zBGZXwn`63KxG*bdOdA?r=(gmA@XKrc2Aq8+|C-BTG+>LpDw^ zEMZ_TFLyVhX}};?FL%#A9m_Uy7VIY^>yr<|pn3=f-QNk=DHnbm%ydFdog<%!oSnuI zkbMaTdjMvxeM)aQaq3f7|MrQYv5P0Hro)SW96vS;SK(d9a2u9BN|Eau<& z3N^OyD(17H8ZQ65k>szn!T&w44ikjkQf!!Tx*#>+6fGQHR0|~6=8RhnviV0ZoGZV z`tbsWVYhy;h2*4mZ~u|HFD3%dTspTdg?<%-?_G}5y{&{hM%yU4+NUDArY-6}qL1k-k`}!);@FL7d0w_;x3xIhjehHWkQp+szQ(O zh2srdi02>0ij&S)N^31D zrS@AZrIXi2es$lyB|AE__1P}T+423N7yH0Rqp@KH=5(z(wV1d>)PG$3t6P4L9ZS%XLY1q4aG3k$~UrGNMgY{b$ z+T15IoazIE3DI%vqUFpJ&z4EPP8SH=WPI+KHBH5uMt<$-m|j8E^ZHE^Bn}ajX8Kj| ztxqW??*1dj#t5@Gv5cri&B-;9u&-c7a1*g$Ir6yC3fYG@Ya}0Cz?#EyNd2ltFu8>U#79H{3mn!T0kgq4ApKwf zkUuE^xl?Ewr&s=KcJ#m9YrtK2q7muh@n0pcpBPDAH@J%0_5yHQq$hVG&{2qfrs}$YMIWf<3|U@fK4@2#ZM_9K_HMr@IBL;*>(2*_U_m3U zhet3}t>&c7tI))r8j_wrAP#;)=w+t32$Qx)q-p8TUqNyjup))0s|o^~VYXvk8@HKokkG1#5!3p&jy7JBtJks1RLjP8l1C49VX@rU>WN%XG9}}c+1bqH?4Y<+nEam14HxXz zi|yKZW9hw~So8d-<@|RSe=Vzyb`&Hix(X5+G^#BQZ>@r82QhKPrTyVCM9fv(d6)HKQ_;8N znq1EH#PXrru`qP3#6-1*H0>s})Dd}ds8hNcKg(hr5Ye<@CZjo=l-_|yg>Zdx;n_Ar z-eJv&T+PF@DK3b71i6|NaUMF>qa(*f0^T+OFHW&Cj#)?i^Tyi8 zOE9_Wz|ebQRrhlnT+zpueHZSoCXdGWM!_&#Uw5G`j>6rfV#(W-?0gB{^sZ_BW+fQ= zvIrb`^_QAx$Q3%H)mVr7ET^`r=}l;KN{8;%lsRbU#v|TUbvKx5n2njr1S6kJni>Z5q;5W;5uexRAeZwxZ;pW z(y|V`V?usNS0}ro^vr*gp++U#;~5_|xZ1LJda-q1^vZ7PCB1H{^O7QpB4E7LAcc)h zRy<=zOKx7LJf_7p25ip!0v1XSnTkgH07lSa@N zNg4wMOUj`ul~3taX+Gy%#f}Cnz!zy?qH+a)8j+9rOZL@lT)7x>Nr1LLStha~2aEO= zIrjWs)b?mAL=+VWKHqum$+b0_t4?h&y=vi>bp>p)=LY`}9nXswyzqc_cme;jdfX7p zxQeydv4~-yj1j-zJKMEIG^yFbeG_zm_eMqZP5Hz{m7;S+D~yVtSG^$h8ZCQ5)G|u) ztFGzUa-n$NE(vq*>|~Srg)lpqnpr^}ZRq{xyz5Ho(a9^Nr(P{3Zc9_b@0{I$VET-e z#6RDzpU`AX3f7D2)q({l6iTa|$IKVw?@egK@?@H6G0Y2$$#!v4!JbTNCCl>RLVVZ8 zRSc*0g$xrvHL`o(B2h_Q;4)k-P zw3`ZO(;0hHA0GB;7P3%c+zH&=NY()L{0b-!P+ntYVRu}$p<~?%#Ryf1b4-- z7wB;m(FKj36`LLjI|%I6VbFDL*JgM=op0fRAo$9b551mp!g}#iP%Dmv$&iF^ZWl5x)#IfO6j zrql36d{x*F`I$#9Fvq8ORBcS9G;KB(A3$794fZk<)hHzhZ09EgwhfUL*h9Lp_@I-E zn3gmX$;GACvykvHwF+s@>Pm$p^o)OBnh3cIt#x<{nZl}^8~RuAW@c-s{bKk@KwG#V zbG(%69KxtpP=fR=BErRD5eJ;gp1Bwe%S`6lxmh%m@I)};?}{?u1{c9AoApVbq^C*m zvUM#|k+CvrS_-UtHCgW@gINsi$U=0gk@lmxfxwE#pkyh9wUK zpIV>sp4eck4@^N`={KA!2xASGIFYdVEj6Bui7Rfu9A}lxqnCmYK{*&jW-44+mJ-~Q zb+er+t3BILt!zPaB@qVV4~uI4Uh5c6@y=hU^!aVj)8*)e>M;jN&%X=C$_7E1sD)#oFL*UargMFHdxd z_(gZ>@lsv?(`sm=XD!oZoyS@RQ8!o`g=$$czPghnjo|`OW+_)~`(QQZn|&-!Pz=5G zSy6UD5-zH~`}4Z|@`=Dk*AUr=wywnRbFbj2AqukRbZe-!wV_hlr;m%$-VK;r^8R!r zoz0vP9Neazw$@4`?RnIawEUu-mcz4Jq>HI^!MV6r!S|75o<0CX{H_jt=iFsc_|}OH7;Yo{ZfWX))I%VoGTgS2l%UpU-160bu^u}zb#u- z?r1quvRW2k6`4Uwy2{>`Mz>l*8@~bvbx(-bHJj9V*hj4vHSrchsl8qb)Akb=jQ|;; zQ0`dv<}!Pmhn)?7b4MfNgdGDDj=Z0iqg^B`u81_|Fx{-j9Q5w00Si@Rk`E$$j8L% z-HAh~uq=ddmL^w!z>2A-6*IOV@CLk)f_ zxyE*ZC!{Gx`oQjU9n1+g1G-Ba&_;mX;t84i7(8u%Y*Gb8@Q0^uvh^URS%b?=1z_j6 zgAze8GUHS>_;@PF_$QO?Zv*T-3=HkJ(Xa^(km~nef0?#-@dx1Bd)L_8{Du4Y{}w>Ty~cb1QP7Nr z0yHe%V*LtM?F|$hV;k^RLp8EjLiJg1<6w9c4a184{D1vV9Du>@5De~z`TvI1KO@$g zL)zarn@u;%qt=VhKwkO5qoq%XGC4LuYB_CR%(I(rhED|eeS8T9J{TA!Tryn;q^4$< z*>kX0SA%wty*|2qGx`Z6{6CNeD`TYKApZ+o$Kt{EOv+S=4-D12f7WBoCyV|B^;Q@L(Gl~Lh5V+c z94N;vfqWd^C|(v~5}DEc0t16rodLSa6Mt%c1WtN58rGme>1R!opAzePHnk$(TWt9M zMqPzCt^A*&u4JxKnvO6vg9@K52%7cV zPChEM5bR9ptgN%_S!PNQ>I5-9s|LxqCgivK{6*iqf&{s@@!USGC(MSvfoCx6Z{_q) z6nx@9TJeWy$%flOs8Kk?e;=bZ9|g;IVu(L^^)4F7)5MO?tEKLRp*DaEY2|oj?gL!A zF35kV%$Hi`YQhklxe60{wsT8SSjPN?kv;m{uP?$^_sbIZ&fdYomBhn2w#y(=m0oPM zBFL>yJLv!4|J`k`uM%YHwX}O2J*=d7{X7j!8xP4Rzwd_!Xw;vdra_IiMS$RMPZ0c| zPRn5@qrj6-e1kxkKM2EgHX3Houo*pQ#SMm7__u7@N_ZSxm#K|Bc`O;8_%us|r^`SO z!P7~6*uTSY0%m;d&@cxNp~%yRSLx?T87{QBkiWob{5YX&t_s;pr>iFUznN{otsr;xjpP z2KM7YIX2#txkkz~NT9%rAR~t1Kg$ur>M*$I!|(tCO+EyXG^9NJslbG%Q)d1EhV4r5 zKJPVGWmsEyk>>l|OW;M`Mo;7oPuI^g4c>l|dj)Gq@ftBO6%Z@KHl)FU1b+JJqz370 z7ynF<5DwkD0h+7{PF_bI;YDa7&@z_em}v+&ilR>1hx7sm21ASVtl4 zti_Mza_u^{wp0$AN?ofQwh7u&Dc(a~xg32!QT`c}+O!W-N8N3Tw=mgIm z6WSk=%i%h+W}XQ<03#j1RO6rRDoy_xC+7Y#+^rZH7BdQMi0NjiQ3Xrjt<0~qfBFpn z@}GORVP4J*9)+hKc?n-Yg2nDo=VuF{&O6oMJ=8@%oun#)(&h#55EIvBFqoquav?fJ z&rnH#8dy0%&}kfC!9v|TMs@(f3__Uv0z={d(&zy8MBYF9RR@Ao&xCeXPlThp=n>bw z-)x}v84o42(Q;zh--iliH_h~y4=mpP>i%DiPp>Rny-D#y8^s>;OUUnIcEbB1T6H^q z4DJ0fbU&oo%wphC-J?y{%^2_J#cySeopiSKP`9|0DeRH(`m#Gq{o3E;f6aR{a#F&a zO-wbE;l*`<8uAvoj(EgChPNPU#miaEI=&O~&f;WO33HA(YMLjajg^IU?6Lk<~czY%i_i(^Krdlo-_~8R_mwN9+>K$FZ z@+PJy6Zyy*M>Y$D|BIXW4xlA&$P#rcg604j=r2d$ghZW0az ze^VVP__~8aka;_pOtD7zfy)R_euVH$urk2O#dX81n+LM;b&G*4U2ZX}jG}NuT3xzp z1LkDJQ6l&|#s5Y`c}ZwR9Kk(iNwmRybXa^7=!hPu9H~qcDa#v)!?J&tgZc{1%A0_# z6ojbe_6?x3aKuKaI0*R1?5b_Ox(7oRR z2&Hi3&*f4ON4<*!gj$dfI1z0MnVW4{2V${L2jFNP5GpEe1)Rh&P$TiqfD=|^=oo*s zM8tBt0PIA4KZnR85V?(W0f<{Y5&86SHnXoeUr zJ}os_NkDPFet^#3T)fwh3qu)la6qlswuzlD$-ou@U>IX4<47!KecZs^#>I%v9a;8q z0J=&3H=Gc;*MdczHD!ZViX$)a+5`Aqav~&AZp>V$xTwL?S=ch?QP6Nh^LZ@1WkG))R> z2kCvT5w1`eh=!eUef>6mjlLbZ`J>j_#B}4aa5mV zhyN|&I^t&HcR)xsj8G&BVuab6aPIj4{ky$zuQ(YD0#K*14v{^!mhlJ}S* zI1?3$<4{JObe2ruHCl3{`8R5&{Bb(FE7=Y*_xU)(G`!f08b8RQuJfOebYh8amP~eF zI0#Au2@~+gjTh;yy>l}kI{}zJx;=i-RBj|q0wM?MlbWfKyEFjJuhw?4WLnp75T-W- zbTdxXfzmelS(yA6a}p-o{gBR#9-55ofyvj&c_iu-|1%B|?2ZSs)=e9faXVLLjGYml zZ_jY=9H(SClnRr2RMJm&%T$L$Ly(ak-8h1u=vI%|HJ!nFV560=F7gR48ha!CALA7f zFZJoZ3rp3WShxKGKKPXU@M=hpsIQ!r zHrfcwKMU@8*1`{*z!d|1%QIss{eK|PT<;^zt!IUm86Dyt%-##G)y@MZ5#H|8qdF_< zz?nJXaI)ps?^xbw`oteV}>Y!+x>@R=hm1i*$;z24MCN!%t@Btf} z_l%ol60(_zbpBu@t>m6wZ?}T|JF?V$z8FsxiLUK+V3uY{BC>Z=^Q~LD;vdQe+$kAC zl{!~Q8UKK77jbIlVfT-8{y!fLXpB2yNA4F68LrA>InIcx4QkLZ>{jZ!J?`92cH(@o-x+>Nl4u@#`!d`bz5OL`3F&)Ki< z5jdwT?f2EEJt2;=S@Ts59IrWLJ~Y*Qm4kcGMeOG;sQMvQx7K?6_x@o!Ib|NQ)Wo!v ze|wh1q1!aUQ=J-`zRJ2eFEGBK^wgQ@JBj`3d87d!@S*=@dQCH~g@GSU7LJK)Y>a&S zd?qr9^ocx?X$Z|?r8tY#!{8J9Wm|oi!ter_%h`JwW8y8c`4$)v;7qV9nhO?W9Cz#19kZPC(W1vZC9w(#aes52MP@@uX}yJV>{bS*2&=CjH2? zh0FWYh`!EgA>*ra30g__G;^cyBl`UJm+mnq-PPYpGYvX?$M7#^FMnj#-?eqI%51)n z-=9-5wZ()wLmYONR)SJ{;b>q>W>4@V3bS)Dvad>MsK=1fpk{c=c4)9netAYYb3PdS z&&lO#nP9%2^tEc^Yh?rw=J9<63R!Yi0Pb^V@xT-9PLazLKAi7Q`E)5TORl67AY_=p zMo?vXpQ@C8;kW{UPNGt>BCK~vvkLk~oH(wg);^P2R#RKHwse+SogH%%_vB>hj7+nu z*ls=}1qQU#5ZztUtS;iMa{9QyG>Z|Iv$tcKIWE#WDx3Lg(ZX=!?*b1;DD>z3YA#Z< zyR`o%6bxxY-F014p9;ovB~NHAZ`n`yI{s4xsh82aNfxeQ-1b$DeCVT-OmPYpC!;cL z&0ShF-Dr=M%E%e0_&ayKyvaDqM0PooHyMuKPpR%veK$ep1){K?xuBjsJm%0L>KSr{ zk}-nmUZdih`YD~%+=3-P$ibUl{7Q&q?r1_7$-yIo{A~Q=`B7a|Q?n+CjPh zKs7jLNB3{#Xvp)U@F~zS;wC$WVGgI_M~`3alB45Uv%5<380~Gd!eu`;y`)1QY>LhC z=}#!~wMyZ*Iaqx9-W54$6Zj}ViY=vQT3_^oylpbo^_HD##IVqB^abgyQIkqYJo3M+K zUtU0K3~K9)v>Z4Hfq1gZ>V9+u#VOm##+ps3`HY@u`EF?-?);UezOlrIt+h3?>a&Ft z`PEgl-4Wp;ag|9Tk@T%O^((QP^thc*OO}lUzhvsrI;(2??Yq9gww&5*@wJ{4anCEj zs$;HbTb3*}{bXA`xR~B_T3Xzo-{wXsHM08p{U%g`Ztdenm6T4Gwg~_2=QG6hNldZ3 zk1KVY{~141To97D&gq@Rsy@SoAv2Pu-6i;NrijCtnpoe7?jJQuCoSob6L&RQvOM0u zs|m?WzL7@?nz^IYHJ{Q&oZh;SVN2v?Ye#671$+~0PyK+@14ci;7Uyk05^V(mUen0)e8_-2N2U> zzKfweEfIl(%`2oaAwczP| z1r9hU7d()-8#$)L&j)mR9-3^~3GT_J6w%~EHcZAH0fBWWDzTb_H+WN>0{NX6%ptJ^ zg^?J5%Du@4GCBXBPll`P87enr8m=x*7>Y1GN&am+0?*nYftV#sl9OoY5QoZIm+oFQ znSSyM9O}ssk$NH``o0LM6vqL-1KShCj(N!J7gZz<%R}Opb0BWhK?2G>5VRac9d7J~ z!e~5%#8c5o9E5OrK1e*OiNy45Bu+gG;t;qEq|Zw#>4!ENj#;GkXxX6fTxdcv=^TO`TA^ zZa#ZiATjko3#sV^6q+(sal$~}lz|R26M>Y_9{yfJm!YI|!L^4zKO02LlhFC7HBxnv zZR1*CBL*S1o?&E!j#5?XjB>(0hY)nMfcU9s)kJZS>#`l-2K-DM6oqvt#7bAdQ7_y9 z9HtCy0dbi~orn5}Dtd#&GblsPP!mhf_r90wQ_E0hF?`hhb&2Glxpaf`aHtoB6hD?L zyT~#^(BUvDHZ`(gAW7bF6dgLDbmV1%r#iS7K+$IdFmu^PaH&p?Cu&Q7{*ppBc*kt5gLp4H7E&&A7wF<;Jv#8jaddTU>Cnfzf zcSJOzgwDOk;|=5~?&xqJJkR+JC!F?ilBt8jp|en;d-9D>%7|SkhMpJ57hybj%ORlU zBOF9&l(Il9+kv_sBST`fbcF8v6&#>RP5mIy~FZ($APeJmWwmwZH(Hkn(Y(bBXPEAN=pV?v}I ztM9r2>TGNO}wx$bB-ATBNKSw}+(ZCjDlJPOm0?t2Aj9@raDW;(JhBs3 zP@ZlnIt)e$Ov`hHL$l7_VwaW?2%yP&qGgrc2NR@=hXMx7;?wdaX0h5iNln49zvP)Q z9&}F*p5g%GBO3B=Fhjuro{0(82j-!`dBtp$DIsjHO#{}z+tHnaGUek7lvC?rAqJ#n zAVXbn!R#o5tC07UHIg#skd$5u6m#RS`b}sKXpR7DFF=+8sWaRG+g{!h_-veFcmbA4 z-V!}1U?Dfj%}sVi6KuE%qClhE#Ik-eDix)NH3&{b!pHc2p$s}TkIjd~xSelLG@w1f zL9N|}_JD#i7Mb83K)jMi06V0Cc>l8oWsL|(olCk09L|p-$`%SbY(|HCdvwT#+lqkJ z2S~XSqyeq|$W{28MMz#vA%s!*tp@Rk;qukdn}WQQV0sK`6Ijrgacco~CR4RgLd76| z&cZJ3ZM&YC(T|;Y2@G4D;ohL|`^v$SvOCyyIZ1{E&q4ZP7WwxDZg!fIJm6Z>@wpG# zls<+zuK~z@VPiI$D~5f*Mcx5(Gn}vJ5EaQ4c1n<`E_8F_ox(si@=$>T(anu_iWF}DIs`I^t6B|(A$c&7 z#GHGIh~;QeHerSX=iCfVm$??!oCF28ZsYDr`lBAuO0rm+lN1;+wIPYweghN=f1nDr z!)V?)>JzV3Ow&Nf#Bi(RCa~U*)b8{vjP5fTL{ILww zF*CVv*y<1T+7z^Fw-Qhy!w&&}m#!~lWUK+yY7J07G%iGkmgunbXJMVug6n}B*OWjU zS}$XIGP9~{q>Kr_4ppmBVRwhBr~NyLPS86}h>wLmfjQV5ZqO4rX90gZ=LBSYG?1l? z<ex0LHEtmO1PVo$;V_^(_~)n%<6DyoYD;RnDjjeInvf6|$}+JP(TUT7#26%|o%|1u zrBD1IIWocjG56+CO(k95=-chnO?TT$tF5#$q!kqvB~E|{Nm@}+QP4(2rbI;ygOUb> z03nGpDnmpj6-Yz`M20AXVM@}<3_=(a36KaO1_&V}WFYf*((iZQ=ehUKd)K$tUF)pk zP-oY!F|}*|esxaW1k{dV0C4*%Mtlv3QP9SLr=r1s!hLMxeRMuhN^D8|N2zkW4ak(1 z!v;!)#XtKbRgQi#N}$t>TEs&BPP_pCuX_}*9%HnjGo%}K@idTs?B662&^h0rjP+UO zQv(#k#3~rb4tN_GkhH9+0Teh-|6vsE^8z%ioDVWStpxhRd1<3Dx+4*&-rVDHV<&G! zj{tgHF`tbgr5ezd#0fFV=W>kN&c8Rt1YR=6kj9KL&^nCn~Y&ph3PIsM~1PK>0+by!t?noDdAw7F}eJWQ6$0FSPt1nV>zY;#&UqnjCte7 zMgbw6586STJNR?bm|93#*cKCH;d2+jq z`8a+whUj<3+~(Z?b&>d(NPI2dOz9)OsA|;>1BoZ~vy=L;Zty%=f5-R$Xi)=Y43UpL zKsILZmm`o&F_CY~rf|eqNVlMWLPuj`5lW100Ln4OwC5N*!*i>#3Z!eeLOwo4!EpK*)Tl;$myE4%$VPz{-5xUvF-wf zvF_k?#sQ0%GuDw7*8asRqPI5k|3SwDB3iSdzsUV~S^OKnk$6Q7ozy5JTYJFB$40a(%V< z0180!!YW67))_#KBWIEggxtCP|AcFdVd80Hs09c!AOu(;Lhj|G#&B}mKOw*%5^|%q zCmRf8x+hjGF)C^H`zP%DC&U;--VUP0X!cKTommj6sVh-vL3knagii|)k@Zk z0oN{i9bljo(Txv|G2V~)Z zxC%)3e=Zx-cmGpz12=)B`G!S9Ep;if9v%>FGMT^lS~F&F`XnvMRlZri0-ZZ3EoqFV zw{D%3RZ~M%IFe>Xj=%nAFC)Fv{12xRC)k6*w`G}p*6h<`{|>m%a*291;j@l`;t2Go z@V2O80Cz!<>h*#$O|t$qEduoAXuZU6MTH6$SIr+!&As$7x>qPA#As zR)!lA7xS0yPOJogcLut;bum|251@c_sKJbMA%1zev&7^IeRBI6(Uz#@}Q``gq= zF~q4==ef5@Jt0#0hNh%WR`}A411*8t*uYo9RTkZ1>epKiRtX@0aY+!ffJQ`w+yok9 z`MBYIEwaGO$U4-Kj1gRD<1oGBTU$R>@{PGrsokGIg{hvD_EUK5d;E}86X3T`r5RJ0 zc8f>#$-`V_UUIqiXh~d$ta^H(@mkZ)2Au=h9R4n+lQIq9D#m`3B^0-}(sDUcGp^Jj zoI5Fihx2#o2OUj4T5!NJgw7EIkP1sfH4-nY3rmR11>;c2iIbnoKz9O&3IZWrFsp#L zLp60-Vr4zZ=_Ad5c6duUJ!c+&yR%VdMYy0JAXxT=Z?fChUdp6*&s8PM#e2ECf<#Kq zm~Hn3oWa(pC3Y{sPl}`Q+7Mf0{WpuBHQg)3u}u@}fz~sZDI{j1fz+ADQ~B?*p!j{6kHF zBt8i}bG_=WXzmrM20KpyI*-=%D90aGJ|MZDMeiCmra4#yC@D*O+S7%Q1HcK(Cs(^} zkP&81zOE|E2b$t5c3ucH4s=27TtU1AGIq2&0r3>-V-PX{E@s-{qm=bq;>(%qsqODK zge~bP%rtw$LUJnE-qRjn1itc&)$;2AhU6gtAYhq5E&|Q_1uh&#-$B0zxK*ff-dGHK zHXu=3Ir>2gjPC2kX3`AM{q$^L6-lS{UR}oknvkV33dMAHKgF@A*S!Xt8vu}mPUAc` zDo_FoQx*$jr0+J`8VfuHU~R0VrfWcUeLBEq-?!2|N;MRa=+}5xb%2jbCesbiwsOCZ zW}p`FcY4=WkQ@%Mf#&)iWQAoOv2YMPQH;NZagn^l&(6AQRx0egZ)e-+eMishYHkRd zbZS0T(bz9_Ot}1wEt)r@d?$9`%=~O_V~)U5Q(33KUSPCMY!zKaGac&(0Igf;V`0J% z#myLhRWAG@z^)96d*;hg?+Zrq#eo17m@7=16UinZ5eCPse?^vG?dB zOCySo&T_+hY*1h>J!l<@qPL7*7-7Sd-skN zp~e?z`NjDU>NR8FcYy8t-`ggJfDy9Z05GS(JZ0Wgb!P&xi^v5=?X=r@{il+qP%c9| zpS+c8+%I9Y^XB-s+W9h$x?w_Mb3xNU-%G*5gaalQG*`z_0qAD8*m(S=UI%fA2KRpU zJB99=sc2DjWDeLbp}-O%vG+G{fY~d7L9F)0G5QCe;Sx9vXM;DXvGe)SzPf5eO?eiq z{T#|)Z{go`O%D7H5H2Aq2~_FCHCpRR02n}!gp6(wYN>5?F{$2Xyl0lAc}o^)>Pf~b z5pigLy^9-N{$e89nR{TBK(w!mMnW4FG3%ifua!A(Q{=M5j*JwiqPOQqer@aaY)1Flk< z6dR7tbAcTr`*HxC*jes#y=Dyag0B<-OOXVwWsV)E)fY5-j2k74HGYTSII7Hmy^mV;B+>;b-37(H=;Wew%XZSarMy#m9Aa0*V$j2w zbv2TAEs?;?F;;TOo#Lm-flvEta5Kx&Y9#eCYPYYh zTb3}|g}4fACK7g!?PaS=@QmfxwDNzJXNKO>*Av0cqO|k+D(f8zU6rH76+T$QTYcUT z1wdX1#C!t}@$|v6tGgSkp%($riDjb2h7B@qq8#5U`18?t-pVrkJ$uD|UBzER%3|(X zIOdbAdh+i(YI7^6d_H-p>%MaC5|@0ixnH4slW)n?dy~hyW)T&bo;GEeKL{ly$Cd$h;?_8@8)3!RtXQG@ zJGpqTZl(6Cn=M{`%V^7Rz3~d&EQ%f>0y@&vxX&Tg)T&m@3Rna&Y4!wN*$lF$g!Nvr z!cY2FxZ#Bk_FioQaT=R4Zwf(_;TP&uyYLHlk}l}|sGzrE)&@*2pB%%BX2QZ56lxYd zR#09{swLyw+ZYFyj|K5jaXpjg z4adAJ!$sVXp^M$z={BcRFmo*B*$kd{T77}W6+lOVv+13FKtrLTaN}%xXNk>IZEi%U z(GEuw-YQV)4^_p69%k1mJn+*I7M{X4n*pnD?2+(>|Nbu0lwmr*$uw8%KX2Tk)9q}ytP?8h4e!WV)x)*c71|11d@~z%nKf!2 zH@?WERUr2O3nTgbvI-Cdx8zl(G*m0=@o{y=aoxUxqCJZm3sDv3khoGe5bgnA2&{*4 zKDS6I<6^&VuHs?*PW-3CCTwNU8{mik)a1UeJ~kQw*lW?=5bzAkYL=vWnLajrOPs&=ULf`_5)ff?}p5(|UIWd6e8%Q~TjT9$D ziW>la|~05~%Kn-%ldyUQ7&@5P|=NFu;v%yd1|<72s*mRV4`EWFwq< znK+KSFatI7Xqlo42kn}wCLY8$m=n3&|&NDgOR0Hjhi#t}zy6N__*(N2j_XDwnwB>J!NEfX#w3Cue#zL%=>5YCK83+?b&0 z>#1VHJ;Jo6Vj_AG*z2i-%GsRrhE0aVaT!lpDvo_P%oV)HUr=EMBOhsE=dOP=l+gQV zO3e_sHZB3%PufLteeI+O8I9VXsJFye?e1YI^fy;9s$}2T__|P`U%GQn)A&h0S4pVa@2+|>a}3u&w&;6& z%~SpP1N?*Lp0-W9IbHsd_5AC&^0>K1Cfyc#St3)P%-tCwt~jS_ku?tFny#;GDj&%J zT9s=RCX#A~!a+|H%f<{1sRD1LzPAfe>%#fk{D#5^QlDlB94}sb?DlP;#<< z;NglP$V?d=$*qX|+HijUIi$hYnK>4GUFbNT0S#gLmRr$nbS=&0*gGYO18p;3RPZXC zd6U@GZ38EUm_=t^7Wl!+0e?~~ujSnuF7Xy)8b2!g{AYZT5VaT|09LnM-rT#^>=-?}xgx z0aC%tPk+_S`!uY%Q5-DV0G&NL$XkfU_|@k!;O}Cu(?;t7Zx4MM$<<(|f{6C2_jQr> z-P|a3^-g@ZbSRt7U)y*=e?9{etipj*DkN~vJ$*@KeP0x!vhI!hBy~$caHJHt5MaF2 zQxVy8IVNbQ0XX7S^@d?jH0*yX(cWyW7XlkodIQ1Y%aQX5s``>$bgF=R8X+3>3|5EH zdnd=_X`#S#@d5c}fAT@Q>H}yh&n!8bWt;1p*9fowau(P>R|{y#&j%J)`FLlJ)EV~f z02+I4)N6%HI3kx`s6j;Vf@ELJD!9iGOSiN3shfco5=FVQmpFSEFEMwWLaSc%S#r6rcclsMOW2R#nq%Pw~~D1ODzk z4eXjzA1}kVFW=c4$dxz)$3r=&8VgkqOKYiE7M6_7Hw1q1yr@$RTHutW8I9moUq9Guh^+k zI$8_3BprgK;7Kib-Ws@!FlkhB^g3m_nKB)i#X*{`v9P8bKt_V%0dc@sr2FSp*AbckalixY5GgzUokoA(_PO0>uT@Q;B z4aYQ-q4iOlJRIldD^{2~V%|Z=m0(NQsuC1;=DTKUu|?QY$1fP-rG+W84MYvn7JuLL zycoI)nWyvaCP_YriZtsHs^FxD2L_`U7xbr0ATrv-KAlMOOrvj=A}bAbPbY#rUG@Md za5=Jdp-)rMo1H*k$_ilUSIAGdRsLC%BhX*QOmw}^k^B$ z2Daz3AbiNy(N3DUU;J}8nm}Jq_7yv+G(jscy^4y7LnQkJX6h;82=YRE7YWO#Jv~2y zvK!Gv?+j|XicNEcRVjKT+N(^OlNtR3CpVg_s=!7=uK~|0RjI6UMobH4tKt8K11sz6 z=o0`8tar(?o%>}@+>KYk z4&v>gn*1zh0|Ff3f*%{7^1qn+X$tXWDd)8QJ2QzaNCyt~D^j)P3t@}9;wSo#^!nnA%~$_BD8B2JOB3qJud zToDB<-OmDG-C_rLHSKulPi6RYA+uUPx39TLfhAS+z5`%jNhM&6lg7)bSjU96HUxJN z^j;y?C0rG@AEnHq)P6O%r$u1(&5>kz>-Uvc0=Oh3=-An}2*a`9Knt zuKnKULVPz}cApP6$dBieZ0BO%&M?G#@X9~SP_5KhieN3uX+Vu?&55m+p7%>kfsk*= zPcvb*jH={RQdaxV@1^HCC|%oP^i?p^XS*m=POcIHjqxUDR^p_9BDL^94 z2V2zDs1?xnz*|7fq1?~P@T_(36qPX_iX3RH=Wm;`D2f2CpN0utL@>GGhQFFR8+-Ex zFT@Ln*6o8-MjLK#Wi@yuUQzp^r}B#pG2~|h90ba*+Ds^{eMY^25VP-8=r?-NkvfN0 z38-a=&jTFL!I4!=u&YuSEH#CU&$X)i7zhUy3xRyw(=8`!GP0`mizv3b`a>`98isk^ zjeIQqLp3QEdVd!>Z6@aPA)xUb=M<*7U~{|L_rr}762@n=IWDTMHmLCEUR!jbtKo9O z2;hRw=~9zc)+!zBsFy^eOYb`?@LDUyIN`k#__G%5pmH29C3U`=iSfzJ!K%>&Bte8g!VbRA=k#CWy2JC@F2UI+e~8&6}yc$ zL#0Bxzuv**)LRvckNIqp7%t7+o7`L?zC<6NTu@;?qu3*D_qffRcw#LKZK}y0^{0FH z)*eV)v{IZdsf|Swm5)+|y$njN)NO@t>(}PjFm5oHpq@M}6!)7e>~$$new2{aPqMfs zMK#s{g&wuiJeP}~-dkCtNc9bk=mtf{0siWzT;)^fd;d#&2HRuZasjt`Ui4vWyTUyp zNY#n?T+J|NIPMIUiViR;iW!#9@As+DO)(J}4Dltde*Sw-?4y}b!OXfEF`6^^tvTht zpswqb;80x@#qZD@VBb=^9rMyE$ADc!l$@_!6SxQpr3{wiehePrpi$ zw%M`XdbL~08fuYq`-HwUZnHjVq@0GQC+S%DeP|(5)%W81x_q4coxlYal6#M2kmGxG za+Q>bq3^lT=de6`oo05P_x<%jVIE?i;W-(6A^}(wPI%q^nppF8v_^k}H~XgXpdJE$Xl8TKl5bT=|BN^2j%QWLX9+U;5(2M7vtL|S7nW@43&Kxb*ifHy*x+vM24mB| z<&%%VrsIQUn*)eypTpqrGxIx!V81}fsR8CMD7R{mfnI-;kE?`dIKNLZtEKn4xc?QO z^t<4fsn5STFuZCIwtOTaIwvIfn@`g?OCZrS3 zuShsc`^#R9I?A@jg54pd`m^!jd&!rvABWeQBp^iVTjJJ#stZ^TnRd>ie4CJ-xB+pv zb4K*is@1#=-GvdBAXpPDnEj(9DAId@S?yH{4q{++0HRPYX$%^1%Tk5oCOy9G3ImLX&b6evdjDFl1 zr#A?l-B4XRZ5&#VU&Y!VVb8Iztc8YQ`wy5^K~>t}re{QC#d1HJTKGGU6zxN`Twjyo zQ^0Iq$p3mhdi+visE+uP%9}j(+@d~O_^W70E1;$$Zo(X80^v_l1Z{nRX9Y-4WLiV2 z4NJ;|b+c4Pe+d&-;lp)c_a{b7w|8qY#aWeV`MCeI#+!r5iCL_;&pAeOtw&XR(3+K~ zx4kq@9|2ZoQA9tc;bF+tMEapdS^gRBb_DmwEu`9MWH@+?8 zy(@#Kg1&cu4UC1@kR~DZH7E;=ou+y|GdWBKr6hP`E~^I0Xc=(%PL(WwHp3;sQxxfx z+)5;6`EBnxFLgu{U2T=^{*Z48hC-mD*5+`-( z;j9w%-Ff`IgmYQnk>HOYH`a`f==lm1mkY_)muevSh zQw{{|413uYC|mXt`#a`5LyEX7^`8R&80@&bmaM@s;s$9uoe{COM+Gmm%SGH5;yY5) zN%gdFmGDLYqGn}FjE`7#u&qI|5tqb_so=4Z0QSF3)J{IrtLZ3H-aARqP{cWr+^G@e z_~S}3qF@|cy^{6^Bz>j-%J6isBy1H}|@c9Wx8XiB|hSlP<}zwY0^A zrCw1K6(lQ;ERG5!6woKD+fwmnT0)(^^+sn&f)FnvI64)!j0mJ5`S$Sl0w1vqI$4Vg$*2gWyr3nv@5nd%70LgK4p2KU}DVn59 zphvjNl}&F+N2x_^-ZHO3my;~$OXQ4GcE+gSZ$TePmKTnGih3iCZ!7JJ-&!8j<)hkw zU?ca>&+{8?`ZL<{*#%LPv@%Iy)HwpPx+KI2rd15U~{s(==iOr8ddLf1o0idYZgYr^K zCtVr!Q027Ewm?xdtpT%@h=`G;#YAU`xmx93i|Xd-T~6|DP;k5 zSYoHfU7h-cJ77tCWfCR3iCP14vWfb%62BShrjq0lh`e|bXVN;|P0Rl{B#g9U7cAv0 zrn-R5u8+8NK$RjqFj(0t25jjO`tN>s!>bc zcfIu4fDPj0q+zX0b;=N1f_<*^1K+?MeI0Xb8}7XDF>|}5$`A1?DmBtaQuFAJzN2C1 zkovb?%;vM&3fdaNtEI=2PEu}rwfKSZp^KL-?GMeP#R6&BZSJo+%{1%??hu2WB%^8f zf|C*^HBy^G!*8nXS!RRd;^RwBRgUAPKj;f+Ik-%#v$4gBn2|$jkKc5unOt7f_Xg+I zeS%rfrC=v#>!o||I30vCe4gP)G4R@wAr8TB5o98M6Xi^k4-%~6vY*;H71B5B;xx?% z&gmj8O4{%#J_kT|0-mF*$a$XUnl^u8bhsbo_=-!RZaru9U)M>l#D>bx0Y=tNJ3^v)|&QTMEk zoS+QvYaHMmXj%D}^D^fxEFyUt+^KR}bmg6vmw|W(&e7ProDb`MZKt$7YpZDU4j}JG zSRVwfNXWBpN#y}+itW;oJ-APu#-~IN4bF2c6YtmsKJt>r)nW6iCU3@m=(Fkg?;KVZ7N!@@!5Xs}M9? z82e*TDJs2D&Q+jWHz_fs&nOP#_vRL?N!gX+|nRYlHAFhmhj%6 z>6`RN`42o-dk!W=wU#|JT|=(ko%mp>M-_)!FO?H%$=qbhYCO|S>B*t#DjwQrrN1~%s}qa-$$MR4 zZ(yzXlXjA#Nn3l`P{hoMME=|%&}7+ggyiV}eyC*1@Apq8ohAAK<#V&i=wa~_FP?YQ z8^q?4rBgi!$>V`LZMl;hy!OEJO^PgJw)7Y4m0z4C#7XzHz+sDz$Q|6Lc`<(qQ|9a{ z-29TJl-MP)WP@_>0(va%31XFK4~4ZJQI!*n@2VU)_&QPIRArk_a0Rhh_Rv~<$I3xv zI%R-XfNkf6U!tF-Rw-LOr=2?sb^LXl49m4jOVOPt&d_e$0JI|NO3o4IfLPMp7OD;8 zNc|=khrli?uw~c;Pjx1wEHY+~xSNw@StfanOht^0R%z^sS(U1-8b|fA=Qi`m zcWIsY$JFhHfW)SyA9@VahEnQt`V(+AS@l{Gm=uuqfyQchA^*bMO)lg{-I)yvD1}rp z_@*=1EWiUY+M5EVuRKZn@uISU_N(|W>SMCvxT(}@3KkORWQq;Zhc@N88Ul_xZGfpg z7B2|TwnX=dzpL@#ErJU4-80Bk*P`~ABa0r~vH*GES1Pa|N33qUBeRBi;GWA81DD{s zUv=nIo76QT^9^Qx0`Py;_MU+Dcmmz=8hi$0OSFDuvFgs1_OAI%-B!&7{Uh!7Dp=K>U=sLu*gbV7nEp}sP1i7{YI!iB%Pw=g zLL98@f@eauVZ0@Y`JTTtSh_ps6v35dZ$XV2V3?==#oXb!0|spRTpYiBDXzv$l9a2v zt(SjNa>z^cDp)Rkxn8O7?Ho>(Y}5zxwn({E&U{j`&#x#e)n6lxI~>)j$z_-Gj>m?j za9a-K$Nfw4OE0PlexkR-^QT~+t_bh?J-Fw| z=OQ{&&-Q6$g;)+W@S3iqcrNC*b6xWs*ur_UGX!ES<2a&uL&&ZG9B+08AGl$e?ovMUx3)lZGqfweP7)$v`pH9 z>_YvC9k?Si=btx(8L}-mW4oYPx}t>5IkMNt&LX6sFx_j>Ghsk;)=r*FOIFk_U1L=* z#YzJ`hrrb1cCG6pewKDaQ*~=Jp6Wj#hp9HIS1`%fCth4Ps{pxeVAKhmfD)QRXDHwJ zDAMPM-L6huW^cGb7Ke1d@=OL?E$~vLH+j|z<4v4%lhbKFjq;t1KDx+_{LTn(!%^%s zcDO9EAhF0zwS~}?8ubQF@c9?~s5~SOgPr!2w?xiHg=rVc#aEDJO&18nEu`6g&69m; z*27?G**FL9(m3|qB-0k}i%U`;5<8=sHHQ)O!}wCzxwNSie#qD{!zq4S{A!&q1Op4R zC^htFXdpHIJRe*GaTunC>n3*IL`3-k}UrLZZRzzs}yESPvo{1B85 zid)CiC#uhiJ5gEqvP9K0slUBvt8J$#6YXbePxs_wCEj+XQQLICs+y-=Rg+YY7cP?X zlh3ALT_BfTLtv{D{Fa0k^BG@UO^H|UH#I&plOuV^KjVkU2^Q-Oll?1S!P36!?rcYb zr^a&=S_qcMG%bw}lLi|sR8Ck#p`KdmCVwPYLoZgArHmfrKPYj|lf006BT{2^x0L4y zGVcY>=fe(>n z#fmu(C+Cd@t4zmr5b;e~CJn+BeW?4$wWx>4uO(YJzo7K))}J$^Puc1Sw``b+X~Gi4 zy%2DxU1t98db_r6KDm?N<#HsJIv1z9Gw*o2U;G64RHO&hO!w(2Xz<=VOs-WPNZ0OE z1;ST~1~Jm=mvozR_5JuvgEb@^_E;Z`eo!*lP>NdgxnnzMv}c!#917Tx~KC>U}D|{rcGcV8nyZ4 z#mMo@#IBq%buUZYQq8v3m4SvC>lcr5L%CkM9d6usz!}}5+D{y_DxgM~g%TzCbEXAf zOXti)$_<9+l#?v|E47R`>rI=CPhiscD!>{X)0J^wdDeO@p5d2TK5^qMg3B9sAh@Ap zrQ9qq^(5oDvZOsSm39tiQ8JJ*=QeV-3S5YIA>S|EGif@-nss6usv3h);gGb%o3oMl z4b<)WHQj4X|5p3mZwEJv1w`wQj2yG;HPxq@{vMo==&(zQy^(kKYMV-wsOh4g2?(pc z$K6TrGXQdk zO@NaWE5fJgO&dj{Z})g~n-BJ$HrJiyWXAsFSfESblV$P}# z`zLDmA)E3u+-+>g^Vqb4u|1i#EgW0%U43kUfGt)jf|rUq{Kx;~V!#L*d~x)J?eKA9fWc_403r z5?;!W3R9V+m~^zItW17FnDf_eX~jc0>km@+?}9(RlFtYWm?tW7{oHDM?L4V|_?$vo zaK8^;RuF>;owZ)+5C4`LV(5c@(R?SGcXc)^pxp~aqGo4~LYDu@_;$!OvEfue!zq_K z7c=>%qmbx78FMvdHgeeu;z$UqeEOa9V$@aHfi;WQkIg>26}w8g%hMe@_<|n#8nt6~ zjmHUUh8Oor4QlVKi20gwB!D7|F3jID*{DCIrO2>_`TX^K~X~w|aV;XnF{;BO)&f^kUysH(SsUdANk&F$rufS$L&}2i8*ttz%K&l7aY)<%e z>5(zAY-QBJO@h%C*sKSO*_^{1$8;aYN0vG7)m^;*NAa!+Q^!@1NpQ{sAN4*Q`bRo@ z74*ejJp7}%!gG(Pm(gCz{w2E8z72A$(W)@8 zh3vjyxn+s4T2iyR>G;e>wyU;hmHyQcEpY74B-b{-?&1uTeNQ(V2NpHcZZzfUtt-85 zlVdkWFpsd^T?&rmz4@2H>mxk&E;nM6sNK$P6@A+W;Eh5UaOJ$sa9=PuZ6==iXa)Yj z%XwREIdS&+ar|-}q-c>iP?!hI2x~NlbftRMQs04ry1}KPy5TxzT#}hIzCiU-^-87q zUMDzipt-9K_h?KXdkXI{vm_nLEuwX}9^kE)?YckkRq(IOpo+nT8XAr90a~WJWTj|U z`3f+LoR4!Dc1{gG6gEhs>=cLNGr3i(HGl8;{0$p#@{Y9Pst%ExP{ZwB`PlG#<6%Y> z>;m8vV~F7aQOwN8cO zJI0>r*LHdKS5G|@m(YA5@0zx`)sz%!osOh!zONj&a`PM@&0U*uzFb4$D?6=x8s@}5 z#is2JPAX};NA!kU*t`Q60`?l+qXQ9%d7Ik^UF&;XPGZ3+Gbivi6NWf!jrC>Oox8K9 z?Jv+hu08HOgPEjid)`spNq3kV?$j6am#{S~OBGn^^OCg5a76!rNjWrRjX$DI)@-bC z7Zz$Z%E;QsYeNXk;c5H>SQsDufHa$|^<$YGj;PQ`9oM}G5G|iazA#g*@25YtjOQah zJ!%@?j$S9T(k&PH3>FYV``u(VQ*NgYsif8qn(cMpDFk&0Tstjy(fqT4?-;^8t@@E& z!Z%BNg#A$8TZ8{adwbgCNFzc)n|m07?3mAiY;xv^VrNf}h$AT0Nux6_<_befVD|zN zdPn&ER-Pjhfi>;HNx~74IFp(h5P@>jY>4+##Pkw9M*2Sh0i!=H7UOiWH=@|mXK>|& zcZ$i{m|ZmOuHg%P9Jnhx^)1$Q4;DFXBhZSmO*@In%P@I z?=8$vlX2^7eBxH>;#P_bCZe=BhlB&>kY8*rQoTVj_q8zGk~UCwabQsn%ppHxmi zi;u=f$p>&VuIh8JpTJ0H*jPwYXkG*CsP4JrbI<3f=lJK8=d9;~=LTu@RC~DYu>pL; zkQ~1%{%$60o$AK|;OObUqiYUJthaMEE8$m}=ytI*d|CyoxQm#6 z0GfS(XC9HIkbo)0wnZG%LI~faTfGWKK9X4WaC-YDiJhDFb4GmR!z{KAE*ByK}8?8pgoki|K#|Res`%e z{uTXh%XgNNlEvfnqnmNlfKOG#%W)JQU0JjSd7}mIX{{r*ELgeR>@G=oBcp$ybeD{de zVRbg~MAQ38e<`|saa_=$TDy1@_g?##O0Xod0%ek5_KEkFt_x}>tQ(rEKeeGJK`kgo zx8_mqF&uEn%U|owN5U(2CfWgJ=s5}egVtPFvv?z&oGe(Mhg@rFt~z^0RT1aQ7jWDc z9&JyNtE*?1C!($)ZBOMh{?hMV$eweyB0q2`R_}VLj;#I*=c*GQZ@eJJ0;B$c$?1IF z1DDr}1rMXmyL?>SB$la~4;>>ACw$j(n+m{gy%4o|;FUxdW zqVU4%cy)nUg;_dsxM35~TbR0ZUQ)jNCBDLQ@hpK^QNJDU(G^4UcCqD$>2lZV9wAc& zjxHX*sl2<~C2x95s$d~HW`h3o0rW=Be(9@6(P5-B7UwiciVXB;Fz2O(B%h5Q6K5MN zv{#f#+uihUwLX$H>Et234U8Gz@rBZbNNo!0g$09Bw3i?Gd{Pwzrc`%>)*`0$A-By^ z^rgF{$I=bSO~f;?_v5I)5^^Smn;0=$rA}M5ql5k2(2ngeA4T8x6i-!Szc>r+bJzc@QkG}Z7Te?>pc|pOln8&Bg&9kbugj7n(0$P@x!kr4XDfI zev+LPyu+h-_KNR`?N14|V(LSjy?FUKylD23vzErx+W*$)* z<@H)=F-+{MJpcJkfXZi}L`V_P+cyRoT5!pcopqox12+h|ZG76zrPF&_>-)oT$ z5R&mx)g|4~KO#szA3XXJe}&#}sxtpm(rW>;+FfbeODaTA zOXPr4VEdBkII`VOS+nxkwboo`Jn^m1pOJmP89t5d`BBrVx-m6C`(4w*%bx7N6ZjI_ z%1a$uBQhPatOAc!{-9_<%$OA{@-xe@o|=n3@sc`vI0$A@Z(68zeXRL?Y8^OplCCU3 zL}}5>IT$c|Bga2cX(emEp#GqWn7!VK9`v|0Rc}qtpRD(nunW_jJ5hsa=e4mFk$==V;%i9Qhuk4;DVlNj5Y@G=i>)*)$Y8@b54es#3K^3RJT+_Dr%(qxy^IW zDwaLiaHv7MLS+NY!j&Pqhl&^4eHDd%h}sAkIePb0IBWn~q&uy7HD@kx>K~*GfpLpS zEk=?%_=VB!Y1T!^p~GPM#<*`KKckh!i@SW9wub%#LDZDC1d^PXENnqMG(^#U zhTn`A2<#^sbxqrZho4ElbRtnMXPu;Pxiw247G+r|yuB>keymLzx2xdm(ad-c)J zu-)mp@=tXPNVPa?#I$=!9Q@Vo8Fp|`0(@Y}@8?j^v! zVw{Eq$LkZa6W_sWU86MnUMs#nj!c8isxOa6r6gRz+6J+JFGDH2fMZx-32nW=zgh1D zelOJ^XGZ&X!oSu--=qZkv{gpmB}pYFuq<Jd`u-yZ9K} zDiHW~6vlV!z3wv>;#Y9b-AC?d#$to&9lyQLH)uxfX z{3vNJs7YtZz?P?W>7k)Ac^}K2T^RGL^Ipn)SbiH$#{EuwqOpcnZP18cy)(V?}Ce6 zmPhK@__eG)+MHzhRKP<8`H%Y21NRh~qIAbLo9sVKOY4pxWa*FGWykdJhf8Z70^vWUsyXXtZfrLWN^+0Ng| zyH@6=Bv{8br+JU@Z01}>qG1=?@dTX;68mbwe~yVd9559=cU^Ki9l6?cEAG^9@m7*+ z>GV#?fzJi$CGjTlcTqf_PFj!Tz%9xugf)DRbZGXeTo(>KODDA={`jWAw3}#U_CT174D)!HnP@ma8r`@TalpUMAw4rX~Rv$ z4-*+(Eu|KP*i|}{ku3{8Y5fr=3OE_m!8a~o$5(4g+%Lb;2Q>b%M9H)Ia~s}v);sp8 zwK^wo-5xelD!fv1^qiqVcdYRxb*ppglK+~KlKqu0$Fnit^T}2z77>hF3%4T}N1g2^ zIUN%?2X!XQPE+{^{>8*b1veYPFWgdbYrl8?1-?7f^rOMa@Vn+0s~t*=D;2~ti37&V z&sk!{W@#ujvT-%UX;aBx%V*8#FJr>@0eb>0cgVycC36F*zac8l2w%;8UUEs%KgKqG zBSMfAD~mvPCsY4akVijs2)8vpja_*;vBM62N3uf`_j^?3{lt&n>8N1!Aw|_+N7dFy zn3thyI#3afmo@zyb;Q|Ea~3A!DfX)$C~6ednGgW~!u0F&Ag8JQmBicx!AnkFpe67f zvm`d5FmOCyU5oD~64TYS3{Owp;Udpui;t!0K|7`%#J-u*?^Q8PQj?M%ssr>!_-)b5wOEPoRTu7}`5>R77Oo;m_}X&ONO6UO0#I;Xcdj z{eBqCs^u?HNU(5Ut8ISDYiHa*@pxT_%V3Bb?73u1E}`SmZegUk@kv@OdEkG*$I$+< z)YV7_fK1V$5J9rWtXP5F@iN?x2tmN>V8#&Q1jscByS|+}ALSSss5^mQ^8__^NPS+9 z&3AUhTvMlpKc4&9r~CEnp~MZeuQE;IZKwfC-vU|^#p0i$Zr8r`fTXDvv<2SxQs>(q zr$~~#v>VxvIvd~Uu{V!!J6rb@c^=iLcDni@U2ii!6G69oKNAnN{jYtuIkZE#2anp! zexwbv*PmKZG`A$KZL+}cPStNURHw7HdWpaZJd;)9jbQcACDNgDQ`>1jr&G5YIvFM% zKpx$~yD~(16<&68ueu8)@~l6jTK)7n4I~t1wJBX&5>55_ZMi_O6A0Hvj@dfbJ5TqT zVa(IP?@i|!(8sB8#a~oWoIZkP#3}>G_^ta_;fZEG|AI}-&7m7+Ie10O1}>*8S*O4* z1ZUIkYum|N@%3Dx?zS>AOyADFsXm$w{8vi^;%4xZLd~j0F^xZrR_4((saR#H*RJ|| z2sJX>Xrrje;4=w6+7ZYQp(A;rH(U8Cy&9EhEgq|+<(P7d^o5?;IEJH+?4w<>n~U@) z(tmbTv2YVb8KBCg#Fo3@Ho5iWrixCR8vs(QD*(V1Vn!Sus1oM>oVR%KglWkSQjZ zsFhUnhPauC>H3`Gc2n%cdGy!7)$SJbiL0p_uVwXk1)3DDY5yQ z(^?XJ@);t{R6NT|no}qb=})=n2GgC5R1NF4G(>`(zmT5l=%Eki5!b{Gc+kl!=b!oIV;oWS5RfgJ1eWTQ{NkOScf5f$=XTvTjGF-J-`7NiHoB zHUJ0Hx5zZ_j$ki=>}pZ`&HT7n;$MKMdfQK}zmk_k$tEr5>q)Z~51%FVtbrWm?JfbJ z1~;Mx)6Hd3?fHw#E<~$?tQk{p&|`bvq0_fl*Asb_y@||5((BWmwn_R-wNryInRHCo zK?^ppnUV(!E>4h4XN+$mZOyDL2E{xi;?ikOCYm;94ct>Ws~nL^qQw9E@D7lyVnen_|LmZ6E5Aeg~!e4o`9DQLMTXvxextHmN?! z;``4O=Sf3=N|c!o(4-0ojo_s?9M{am*#VB=5EIG&6MQAhSCE=J8s=%d|NbZ7dsL8E zm^szaZWE~)WUTt>^K~qh$%JuR7dNsot^_fW1svQ+7{UB7#EO?5f)o$D0&$pDSI%T-dGH{2Y3{X1>H>#E?8cqV)P#9*tAARfm2?lgl2DZh7gUjB80g_ACKn zkL6!vqrK*1u*2TZledPywSd!u_$~7F0;`EsjNusE=PR>;k=>~}6mQeaaqxGTJ4ysp zhJ5|14wrKz(wgOwkRpEa64nxn0EeW!SzR{-pMydzA_coh6Dlu(+D-*O3MB7jME3b= z-$)MiRFQIcDY#s{Y}#c(P=-IOm_$A3$*ta*l*cKb!9{BE>|$90*6os;Wmg)DBw>0LQk@4 z=D3a*MAO)e2=!T7vn7V3Si3HLzU-~xsBSgkbEL|#x|5yU!8@!oTSAI2F@=xu+4vMv zuAU=t9pURuWQb2H$370uB%x1u)3DBK1_>rahQ4Eeki?Gw1s}c{z68ArPE`pv59hz!@RZ(`^&voXn(^6ZkI7+*e}jgT0MO7v4M7kKDz!hmsXftSXjLv40I+?mCB8Di*qpMe1!! z$@5TQ2&tWXf6%qYUwrqAd-79^J>M1|QO|Az%`>$h9fV0aEY zho2hCetp{X@=N|D8t0whxLUsuz{k(WIT1MgH>9IR5iP+N-Gt+%*{XLNop_LvBYaF@ zs`)`AF?G6-H1F*-c;&L&883At#6 zm}r5D!9(!LVTaiiDWdCulwmy~IF4?9(q7oaATv9odZwe)@!JK-)hJG)i}7wcqkfR$ znSky7ozaMA6NK2-#3tLeyE`vZEXbDH`i;q>OijDRy#>9@8j zI{c?t-BhL$0nJJTST%VHXLt@HLT|$n-41*aDrqF$Wa*3NaN6kGGt@J#7ys+ zLH0=2d(leNL{ProMV(+cxO&@*dPe_8uE%EH|C-o2E}ukq#O~cz{(dk4**sByZJZFS zznafL;C|}$JyycD(S7U#9Ms!ok{`@-<~@eYDl`QjP)YEHyuDz5{Z%O-SpQ^Dhd9Ib zI?IZhuw^5kB1-W6ka+m^c2^XGDO~m=9|#ka!9ruzr!oSTfK#``PVDD68O{nd&?qVP zHr%p{504>T$HjzsT0_(9eEA!nB_X6l%;`3YY`|QnREVJ5JVxMZstEfs^Te3~TM~C^3`+Ndt8hNF81mVvlRWL|>h=kP-Ul8HmtpSCSStu5f$ThRrZjXqm;P{}gLY)5K_-=i9$8VG_IofLo zmER~{7LD&kM1|1xSK9jOy&k0WN{F$Fy+l3ZE7WHx8SFX{*ypO*I{|M%-;T8sg?}ou z-zD|Dk%rV0=U&G+VEKVkA3ChWzWAWfF&?vyiEw)yMfk%aXuc&`D0KB@JYvH3l8Owbrro-5ISTy=Ft@3TUFHyxW7e=DlyBW##zchf~(HK3&}|1!b-cSbi&x(k)t zs`USo8Y#D>fn9bqBzT&&whGHlIX^F3M-VdRgw6z@Qqwn?N3rk*fxSi^b zf-&KNuEcD`R=gwCSDTY&EefA&Ew8DxpUaA^#_))HJxJtMOYHOqPiA_%rbuGbkG~}* z@!C`Ga>7^^OXWP15yd`^l=lzL{}eN-_u0oCDz9aKxXw?5^MiZ&)dLrdu@iwrtHR9! z@)<&Fs}qKe*jgBuuS4w+B)8xy;8N-t86HW)cB0t_Q8WbGHNBnMlUnsOTFQI2I5_ZU zfe`WemILp)wD;Ma9Xjy!qJLQSRwi$D<{hQB*z!Xp?f_#^ivm4gR4{^U2T5COIe(1wG{rA@2LnAq*2=AbTLfAg`#se37Z27v#m zqMW)L=iLAGzXRcjmq`4HmDhLUwk)BD2^W0z=XY@8M{?%@M*ssAWBP?!plts?+9d^S zg!U6x_EgW3_O5M;2p4}rB?i&Uo2py{!T|6ezAGyQ=?AX+OMhO+J&C0D2%Fk!;-R~_ z(NH6pn5!C9IrFm_iQn=@izydtoN%4q$}QZJzlCEzv}wz+=XfIcQ!U^D8F<$K;}e}F z24hz5t@xhbXNysIOLWOBMPxryXkKD?PXEwITDtg*&7JYvjxZKj9ZE!u3FCwj#O+H8inj;Oirt&I zkXl&-zI$jTxY;qTj@{iOnVSGWSw8K#oV~0>s5+n5b(siIq~*`;U)Y^$78-BW{dzmT zLK_&JMaODXaT8U_vbmpf%e>CU4Jb`zn)DUx$SZbzFfZHo^r<_M-4`L$Y!>}7hEVq% zuBuLZyVol^#I0~n>*FWdGG`GLXSRqGnd;GJyMv-?B;PHBs6>hyy6w)av~{Aj4Ia9w z$8)<&EL3ZG>wN5Xi`TYD?zE9}8|UZtJJN@8K{s(h5GO(W=C<0QZouCC9FdKb*S1D* zQ@`^Ar|0cSNSqt#z3TQ4+7GP0N1ToC̒j=(9|Z4Nct7(cR(WpH)lAbRJLox7Up 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"vAGo^1dM(geoG>R{3YTE8Chz)pgSyyzR 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 literal 0 HcmV?d00001 diff --git a/vignettes/example_ecoulement_api.Rmd b/vignettes/example_ecoulement_api.Rmd index 6490486..706bfdf 100644 --- a/vignettes/example_ecoulement_api.Rmd +++ b/vignettes/example_ecoulement_api.Rmd @@ -1,6 +1,6 @@ --- title: "Performing queries on the 'Ecoulement' API" -author: "Pascal Irz, David Dorchies" +author: "Pascal Irz & David Dorchies" date: "`r Sys.Date()`" output: rmarkdown::html_vignette vignette: > @@ -60,7 +60,7 @@ list_endpoints(api = "ecoulement") - `stations` lists the monitoring stations - `campagnes` lists the surveys -- `observations` is the data itself, indicating if, at the date of the survey, the river flows or if it is dry (which is assessed visually in the field). +- `observations` is the data itself, indicating if, at the date of the survey, the river flows or if it is dry (which is assessed visually in the field) `station` and `observations` can be joined *at least* by the field `code_station`. diff --git a/vignettes/example_niveaux_nappes_api.Rmd b/vignettes/example_niveaux_nappes_api.Rmd new file mode 100644 index 0000000..60d0519 --- /dev/null +++ b/vignettes/example_niveaux_nappes_api.Rmd @@ -0,0 +1,174 @@ +--- +title: "Performing queries on the 'niveaux_nappes' API" +author: "Pascal Irz & David Dorchies" +date: "`r Sys.Date()`" +output: rmarkdown::html_vignette +vignette: > + %\VignetteIndexEntry{example_niveaux_nappes_api} + %\VignetteEngine{knitr::rmarkdown} + %\VignetteEncoding{UTF-8} +--- + +```{r, include = FALSE} +knitr::opts_chunk$set( + collapse = TRUE, + comment = "#>", + fig.width = 6, + fig.asp = 0.618, + out.width = "70%", + fig.align = "center" +) +load(system.file("vignettes/example_niveaux_nappes_api.RData", package = "hubeau")) +``` + +This vignette shows how to use the [`hubeau` R package](https://github.com/inrae/hubeau) in order to retrieve data from the French piezometric monitoring network ([portail national d'Accès aux Données sur les Eaux Souterraines, ADES](https://ades.eaufrance.fr/)) from the [API "piézométrie" (or "niveaux nappes")](https://hubeau.eaufrance.fr/page/api-piezometrie) of the [Hub'eau](https://hubeau.eaufrance.fr/) portal. + +We illustrate the use of this API for the geological layer "Calcaires et marnes du Dogger du bassin versant du Clain libres" (`code=GG063`) with an example of map and chart useful for the interpretation of these data. + +```{r} +my_water_table_code <- "GG063" +``` + +# Getting started + +First, we need to load the packages used in this vignette for processing data and +display results on charts and map: + +```{r setup} +library(hubeau) + +library(dplyr) +library(sf) +library(mapview) +library(ggplot2) +library(purrr) +``` + +"niveaux_nappes" is one of the `r length(hubeau::list_apis())` APIs that can be queried with the `{hubeau}` R package. + +The list of the API endpoints is provided by the function `list_endpoints`. + +```{r} +list_endpoints(api = "niveaux_nappes") +``` + +- `chroniques` long-term time series +- `chroniques_tr` real time observations +- `stations` lists the monitoring stations + +The tables can be joined *at least* by the field `code_bss` (i.e. the site Id). + +For each endpoint, the function `list_params()` gives the different parameters that can be retrieved. + +```{r} +list_params(api = "niveaux_nappes", + endpoint = "stations") +``` + +# Retrieving the data + +## Sites + +Download the data. + +```{r, eval = FALSE} +stations <- get_niveaux_nappes_stations( + codes_masse_eau_edl = my_water_table_code +) +``` + +## Time series + +The aim here is to retrieve the time series of water levels measures in the piezometers. + +```{r} +param_chroniques <- paste( + list_params(api = "niveaux_nappes", + endpoint = "chroniques"), + collapse = "," +) +``` + +No field allows to select a departement, so it is necessary to iterate through stations. + +```{r, eval = FALSE} +water_table_level <- map_df( + .x = stations$code_bss, + .f = function(x) + get_niveaux_nappes_chroniques(code_bss = x, + date_debut_mesure = "2015-01-01") +) +``` + +# Tidying the data + +The dataframe is processed to get a 'year' and a 'month' variables, then averaged by year for each site. + +```{r, eval = FALSE} +water_table_level <- water_table_level %>% + mutate(date_mesure = lubridate::ymd(date_mesure), + year = lubridate::year(date_mesure), + month = lubridate::month(date_mesure)) +``` + +Selection, for each of the stations, of the years with 12 months of data. This is done to prevent incomplete time periods to influence the yearly mean water level excessively. + +```{r} +yearly_mean_water_table_level <- water_table_level %>% + group_by(code_bss, + year) %>% + summarise(n_months = n_distinct(month)) %>% + filter(n_months == 12) # complete years + +yearly_mean_water_table_level <- yearly_mean_water_table_level %>% + select(-n_months) %>% + left_join(water_table_level) %>% # filtering join + group_by(code_bss, + year, + month) %>% + summarise(monthly_mean_water_table_level = mean(niveau_nappe_eau, na.rm = TRUE)) %>% + group_by(code_bss, + year) %>% + summarise(yearly_mean_water_table_level = mean(monthly_mean_water_table_level, na.rm = TRUE)) %>% + ungroup() +``` + +# Plotting + +```{r, fig.width = 8, fig.height = 8} +ggplot(data = yearly_mean_water_table_level, + aes(x = year, + y = yearly_mean_water_table_level)) + + geom_line() + + facet_wrap(~code_bss, + scales = "free_y") + +``` + +# Mapping + +The 'stations' dataframe is transformed into a `sf` geographical object. + +```{r} +stations_geo <- stations %>% + st_as_sf(coords = c("x", "y"), + crs = 4626) +``` + +Then they are mapped using the `mapview` R package. + +```{r, fig.width = 8, fig.height = 8} +mapview(stations_geo, + map.types = c( + "OpenStreetMap", + "Esri.WorldShadedRelief", + "OpenTopoMap" + )) +``` + + + + + + + From cb1f5759378cc32981e4ba2758f90f8f57a79259 Mon Sep 17 00:00:00 2001 From: PascalIrz Date: Thu, 22 Feb 2024 00:49:22 +0100 Subject: [PATCH 2/5] Mostly fix typos --- DESCRIPTION | 2 +- man/hubeau.Rd | 21 -------- vignettes/data_extraction_naiades.Rmd | 76 +++++++++++++++------------ 3 files changed, 42 insertions(+), 57 deletions(-) diff --git a/DESCRIPTION b/DESCRIPTION index ee11ba0..03c6546 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,7 +1,7 @@ Type: Package Package: hubeau Title: Get Data from the French National Database on Water 'Hub'Eau' -Version: 0.4.1.9000 +Version: 0.4.2 Date: 2023-06-01 Authors@R: c( person("David", "Dorchies", , "david.dorchies@inrae.fr", role = c("aut", "cre"), diff --git a/man/hubeau.Rd b/man/hubeau.Rd index e4e1233..dd4e5a8 100644 --- a/man/hubeau.Rd +++ b/man/hubeau.Rd @@ -2,7 +2,6 @@ % Please edit documentation in R/hubeau.R \docType{package} \name{hubeau} -\alias{hubeau-package} \alias{hubeau} \title{hubeau: A package for retrieving data on the French databases on water 'Hub'Eau'} \description{ @@ -116,23 +115,3 @@ Available functions: } } } -\seealso{ -Useful links: -\itemize{ - \item \url{https://inrae.github.io/hubeau/} - \item \url{https://github.com/inrae/hubeau#readme} - \item Report bugs at \url{https://github.com/inrae/hubeau/issues} -} - -} -\author{ -\strong{Maintainer}: David Dorchies \email{david.dorchies@inrae.fr} (\href{https://orcid.org/0000-0002-6595-7984}{ORCID}) - -Other contributors: -\itemize{ - \item Pascal Irz \email{pascal.irz@ofb.gouv.fr} (\href{https://orcid.org/00000-0002-2066-8935}{ORCID}) [contributor] - \item Sébastien Grall \email{seinormigr.grall@gmail.com} [contributor] - \item Philippe Amiotte Suchet \email{philippe.amiotte-suchet@u-bourgogne.fr} (\href{https://orcid.org/0000-0003-3514-1447}{ORCID}) [contributor] -} - -} diff --git a/vignettes/data_extraction_naiades.Rmd b/vignettes/data_extraction_naiades.Rmd index 1991250..6ce747d 100644 --- a/vignettes/data_extraction_naiades.Rmd +++ b/vignettes/data_extraction_naiades.Rmd @@ -1,5 +1,5 @@ --- -title: "Data extraction using the The API \"qualité des cours d'eau\"" +title: "Getting data from the API \"qualité des cours d'eau\"" author: "Philippe Amiotte Suchet, David Dorchies" output: rmarkdown::html_vignette vignette: > @@ -15,16 +15,18 @@ knitr::opts_chunk$set( fig.width = 8, fig.asp = 0.618, out.width = "90%", - fig.align = "center" + fig.align = "center", + warning = FALSE, + message = FALSE ) load(system.file("vignettes/data_extraction_naiades.RData", package = "hubeau")) ``` -This script applies functions of the [R package Hubeau "Get Data from the French National Database on Water Hub'Eau"](https://cran.r-project.org/package=hubeau) to query the french Naiades database through the [API "qualité des cours d'eau"](https://hubeau.eaufrance.fr/page/api-qualite-cours-deau). +This vignette describes how to use functions of the [R package *hubeau*](https://cran.r-project.org/package=hubeau) to query the French Naiades database through the [API "qualité des cours d'eau"](https://hubeau.eaufrance.fr/page/api-qualite-cours-deau). -The [Naiades database](https://naiades.eaufrance.fr/) gather hydrobiology, hydrogeomophomogy and physico-chemical informations for french river and lake water. The information is associated with a water quality station (location) , a date (the day of the sampling or of the observation) and a material (water, suspended matter, sediment, river bed, fish, ...). **The API "qualité des cours d'eau" focuses only on water physico-chemical properties.** +The [Naiades database](https://naiades.eaufrance.fr/) gathers hydrobiology, hydrogeomophomogy and physico-chemical information for French river and lake water. The information is associated with a water quality station (location), a date (the day of the sampling or of the observation) and a material (water, suspended matter, sediment, river bed, fish, etc.). **The API "qualité des cours d'eau" focuses only on water physico-chemical properties.** -This example shows how to extract physico-chemical (here nitrates concentration and total pesticides) informations from the Naiades database on water station belonging to an administrative entity (here the Cote d'Or department). +This example shows how to get physico-chemical information (here nitrates concentration) from the Naiades database on water monitoring sites belonging to an administrative entity (here the Cote d'Or department). ```{r} library(hubeau) @@ -38,21 +40,21 @@ library(Hmisc) ## How it works -The Hubeau package provides functions to query the databases of the french water information system using the Hub'eau API. +The *hubeau* package provides functions to query the databases of the French water information system using the Hub'eau API. -The function names are wrtitten as follow: `hubeau::get_[API]_[endpoint](argument)` where: +The functions are named as follows: `hubeau::get_[API]_[endpoint](argument)` where: - [API] is the name of the API (one API = one database) - [endpoint] is the type of information which is queried in the database; the query is defined by a list of arguments. -For example the function `get_qualite_rivieres_station()` uses the API "qualité des cours d'eau" to recover the water quality stations corresponding to requirements described in the station() function. +For example the function `get_qualite_rivieres_station()` uses the API "qualité des cours d'eau" to get the water quality stations corresponding to requirements described in the `station()` function. -See the [readme in the R package Hubeau](https://github.com/inrae/hubeau#api-hydrom%C3%A9trie) +See the [readme in the R package *hubeau*](https://github.com/inrae/hubeau#api-hydrom%C3%A9trie). -## Listing the available API in the R package +## Listing the APIs searchable with the *hubeau* R package -The 0.4.1 version is able to query 10 different databases which can be listed as follow: +The *hubeau* R package allows to query 11 databases which can be listed as follow: ```{r} list_apis() @@ -62,7 +64,7 @@ The name of the API which will be used below is `"qualite_rivieres"` using the [ ## Available endpoints for the "qualite_rivieres" API -The function `list_endpoints(api = "name of the api given by ")` of the Hubeau R package lists the available endpoints. +The function `list_endpoints(api = "name of the api given by ")` of the *hubeau* R package lists the available endpoints. For the `qualite_rivieres` API it gives: ```{r} @@ -75,7 +77,7 @@ These 4 endpoints are described in the [Hub'eau web page of the API (see "opéra - [**operation_pc**] lists the sampling operation occuring on each water station; -- [**condition_environnementale_pc**] lists the environmental conditions observed during water sampming (air temperature, presence of mosses, alguae, etc.); +- [**condition_environnementale_pc**] lists the environmental conditions observed during water sampling (air temperature, presence of mosses, alguae, etc.); - [**analyse_pc**] gives the results of the physico-chemical analysis made on water samples of a selected water station. @@ -83,7 +85,7 @@ Each endpoint is defined by a list of arguments to query the database. ## List of arguments by endpoint -The function `list_params(api = "name of the api", endpoint = "name of the endpoint")` gives the arguments which can be used in the query. These arguments correspond the parameters of the Hub'eau API and are described in the [Hub'eau web page of the API](https://hubeau.eaufrance.fr/page/api-qualite-cours-deau). +The function `list_params(api = "name of the api", endpoint = "name of the endpoint")` gives the arguments which can be used in the query. These arguments correspond to the parameters of the Hub'eau API and are described in the [Hub'eau web page of the API](https://hubeau.eaufrance.fr/page/api-qualite-cours-deau). For example, the following instruction lists the available arguments for the endpoint "condition_environnementale_pc": @@ -93,9 +95,9 @@ list_params(api = "qualite_rivieres", endpoint = "condition_environnementale_pc" # Extracting physico-chemical data -This example shows how to extract the nitrates concentration values in river water samples for station located in the Cote d'Or department from 2000 to 2022. +This example shows how to extract the nitrates concentration values in river water samples for stations located in the Cote d'Or department from 2000 to 2022. -## Availability of station in the Côte d'Or department +## Availability of stations in the Côte d'Or department The function `get_qualite_rivieres_station(…)` will be used to list the available stations. Arguments for the function can be listed as follow: @@ -104,7 +106,7 @@ Arguments for the function can be listed as follow: list_params(api = "qualite_rivieres", endpoint = "station_pc") ``` -The argument "code_departement" will be used with the value "21" which is the french administrative code for Côte d'Or. +The argument "code_departement" will be used with the value "21" which is the French administrative code for Côte d'Or. ```{r, eval = FALSE} station_21 <- get_qualite_rivieres_station(code_departement = "21") @@ -114,10 +116,10 @@ station_21 <- get_qualite_rivieres_station(code_departement = "21") station_21 ``` -The result of the query gives a tibble of 466 lines and 48 columns which means that the database comprises 466 water stations in the Côte d'Or department being described by 48 parameters. +The result of the query gives a tibble of 466 rows and 48 columns which means that the database comprises 466 water stations in the Côte d'Or department being described by 48 parameters. -## Retrieving nitrates concentration in river water of the Côte d'or department +## Retrieving nitrate concentration in river water of the Côte d'or department The function `get_qualite_rivieres_analyse(…)` is used to get the physico-chemical analysis for selected stations. Arguments for the function can be listed as follow: @@ -126,15 +128,15 @@ Arguments for the function can be listed as follow: list_params(api = "qualite_rivieres", endpoint = "analyse_pc") ``` -These arguments are described in the[Hub'eau API web page](https://hubeau.eaufrance.fr/page/api-qualite-cours-deau#/physicochimie/analyse_pc). +These arguments are described in the [Hub'eau API web page](https://hubeau.eaufrance.fr/page/api-qualite-cours-deau#/physicochimie/analyse_pc). -Needed arguments in this example are: +The arguments in this example are: -- `code_departement`: french administrative code for department ("21" for Côte d'Or) -- `code_param`: Code of the physico-chemical parameter; if more than one parameter, codes must be separated by a commas; maximum number of code is 200. The code of a given parameter that can be found in the [french water reference system "Sandre](https://www.sandre.eaufrance.fr/Rechercher-une-donnee-d-un-jeu); For nitrates the code is "1340" +- `code_departement`: French administrative code for department ("21" for Côte d'Or) +- `code_param`: Code of the physico-chemical parameter; if more than one parameter, codes must be separated by a commas; the maximum number of codes is 200. The code of a given parameter that can be found in the [French water reference system "Sandre"](https://www.sandre.eaufrance.fr/Rechercher-une-donnee-d-un-jeu). For nitrates the code is "1340" - `date_debut_prelevement` et `date_fin_prelevement`: beginning and end dates of samples ("_yyyy-mm-dd_" format). -The query can be written as follow: +The query can be written as follows: ```{r, eval = FALSE} nitrates_21_raw <- get_qualite_rivieres_analyse(code_departement = "21", @@ -148,7 +150,7 @@ dim(nitrates_21_raw) nitrates_21_raw ``` -The query gives a tibble of more than 13000 lines and 134 columns. +The query returns a tibble of more than 13000 lines and 134 columns. Each line corresponds to a nitrate concentration value (`resultat`) in mg.L^-1^ for a given station (`code_station`) and for a given date (`date_prelevement`). @@ -200,7 +202,7 @@ analysis can be computed or not. ## Selection of stations available for analysis In the following example, a list of the stations of the Côte d'Or department is -created (`get_qualite_rivieres_station(code_departement = "21"`) +created. ```{r, eval = FALSE} #list of station to query @@ -213,8 +215,8 @@ Total number of stations is: nrow(station_21) ``` -We use the function `get_qualite_rivieres_analyse(code_station = "")` for retrieving -nitrate concentration values (`code_parametre = "1340")` from 2000 to 2022. +We use the function `get_qualite_rivieres_analyse()` to retrieve +nitrate concentration values (`code_parametre = "1340"`) from 2000 to 2022. ```{r, eval = FALSE} nitrates_21 <- get_qualite_rivieres_analyse( @@ -236,10 +238,12 @@ nitrates_21 <- get_qualite_rivieres_analyse( We compute some annual statistics for each station: ```{r} -nitrates_21$date_prelevement <- as.POSIXct(nitrates_21$date_prelevement) -nitrates_21$year <- year(nitrates_21$date_prelevement) +nitrates_21 <- nitrates_21 %>% + mutate(date_prelevement = as.POSIXct(date_prelevement), + year = year(date_prelevement)) -station_stats <- nitrates_21 %>% group_by(code_station, libelle_station, year) %>% +station_stats <- nitrates_21 %>% + group_by(code_station, libelle_station, year) %>% summarise(nb_analyses = n(), nitrate_mean = mean(resultat), nitrate_p90 = quantile(resultat, probs = 0.9), @@ -254,18 +258,20 @@ Stations with less than 10 values per year on average and less than 10 years of are excluded of the statistical analysis. ```{r} -valid_stations <- station_stats %>% group_by(code_station, libelle_station) %>% +valid_stations <- station_stats %>% + group_by(code_station, libelle_station) %>% summarise(analyses_per_year = mean(nb_analyses), nb_years = n()) %>% filter(analyses_per_year >= 10, nb_years >= 10) + valid_stations ``` -The number of lines of the tibble `valid_stations` corresponds to the number of +The number of rows of the tibble `valid_stations` corresponds to the number of stations with at least 10 samples per year on average and 10 years of data. ## Statistical analysis of samples -Then, we plot the year distribution of nitrate levels with violin plots. +Then, we plot the annual distribution of nitrate levels with violin plots. ```{r} plot_nitrates <- function(code) { @@ -325,6 +331,6 @@ plot_nitrates <- function(code) { } ``` -```{r} +```{r, message = FALSE, results='hide', fig.keep='all'} lapply(valid_stations$code_station, plot_nitrates) ``` From b79ebdce9a308f249a26efc0fc4ce0521c247988 Mon Sep 17 00:00:00 2001 From: David Dorchies <14124454+DDorch@users.noreply.github.com> Date: Thu, 22 Feb 2024 10:19:33 +0100 Subject: [PATCH 3/5] fix(DESCRIPTION): wrong version number --- DESCRIPTION | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/DESCRIPTION b/DESCRIPTION index 03c6546..5165a72 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,7 +1,7 @@ Type: Package Package: hubeau Title: Get Data from the French National Database on Water 'Hub'Eau' -Version: 0.4.2 +Version: 0.4.1.9000 Date: 2023-06-01 Authors@R: c( person("David", "Dorchies", , "david.dorchies@inrae.fr", role = c("aut", "cre"), @@ -41,7 +41,7 @@ Suggests: spelling, testthat (>= 3.0.0), tools -VignetteBuilder: +VignetteBuilder: knitr Config/testthat/edition: 3 Encoding: UTF-8 From a26fe2d035ab561d2b8fe4234bc8bcc023d8f971 Mon Sep 17 00:00:00 2001 From: David Dorchies <14124454+DDorch@users.noreply.github.com> Date: Thu, 22 Feb 2024 10:30:54 +0100 Subject: [PATCH 4/5] docs(vignette niveaux nappes): refine and set data cache package Refs #42 --- .../vignette_example_niveaux_nappes_api.R | 32 +++++++++++++----- .../example_niveaux_nappes_api.RData | Bin 201569 -> 3143 bytes vignettes/example_niveaux_nappes_api.Rmd | 5 +-- 3 files changed, 27 insertions(+), 10 deletions(-) diff --git a/data-raw/vignette_example_niveaux_nappes_api.R b/data-raw/vignette_example_niveaux_nappes_api.R index b37f6fe..6a0e22d 100644 --- a/data-raw/vignette_example_niveaux_nappes_api.R +++ b/data-raw/vignette_example_niveaux_nappes_api.R @@ -1,5 +1,6 @@ ## code to prepare `vignette_example_niveaux_nappes_api` dataset goes here library(hubeau) +library(dplyr) my_water_table_code <- "GG063" @@ -7,21 +8,36 @@ stations <- get_niveaux_nappes_stations( codes_masse_eau_edl = my_water_table_code ) -water_table_level <- map_df(.x = stations$code_bss, - .f = function(x) get_niveaux_nappes_chroniques(code_bss = x, - date_debut_mesure = "2015-01-01")) +water_table_level <- purrr::map_df( + .x = stations$code_bss, + .f = function(x) + get_niveaux_nappes_chroniques(code_bss = x, + date_debut_mesure = "2015-01-01") +) water_table_level <- water_table_level %>% mutate(date_mesure = lubridate::ymd(date_mesure), year = lubridate::year(date_mesure), month = lubridate::month(date_mesure)) +yearly_mean_water_table_level <- water_table_level %>% + group_by(code_bss, + year) %>% + summarise(n_months = n_distinct(month)) %>% + filter(n_months == 12) # complete years -vignette_example_niveaux_nappes_api <- list( - stations = stations, - water_table_level = water_table_level -) +yearly_mean_water_table_level <- yearly_mean_water_table_level %>% + select(-n_months) %>% + left_join(water_table_level) %>% # filtering join + group_by(code_bss, + year, + month) %>% + summarise(monthly_mean_water_table_level = mean(niveau_nappe_eau, na.rm = TRUE)) %>% + group_by(code_bss, + year) %>% + summarise(yearly_mean_water_table_level = mean(monthly_mean_water_table_level, na.rm = TRUE)) %>% + ungroup() save(stations, - water_table_level, + yearly_mean_water_table_level, file = "inst/vignettes/example_niveaux_nappes_api.RData") diff --git a/inst/vignettes/example_niveaux_nappes_api.RData b/inst/vignettes/example_niveaux_nappes_api.RData index b4a749597e5b6b32677dbb5cc1b2ef7f11fe01a2..a26be89b57365fc229962819f9b2a6b66bf7b9ef 100644 GIT binary patch literal 3143 zcmV-N47l?jiwFP!000002JKo4bQ4t?o<1qGKgCM|90 zBb_GGb~KsPNzzh45nUEk++#)EBA!)I7FZvk9v6!b@KkVDK@L!P9ak3@R~8iT#jZSb z?3+T8iS|G(e=-+%5*{yTH6*%idFieU(X#3Au(b}D3xA{ZJ`~MS3x@A7e)FTSdwv2iUwBM?4cPSM3lW{e?~O@`#4ciarALcwNb?p zar!T%yI`hVN_WAein6K&?>*W|K$Mgb3Cr34MOcQ} z$A#R(f#auKX>dxy@#Von(k zoLXA{?rUR>AKmqI_lV;0#;yY$2RF1GF&=#J5zT6293Ka;%zSy%H96~nMc$J5!dJDx z0(SqfBBdNyCcUt2q0Rx@uQImhXTkOk&3m;wfF&(?dH1;-U@1IPw0i38&_4CX8GEM# z%gv)wcCY*cuw;I6^1|qwfhFT`_8(6-0!wLWq2vd#n5)9B20=Wo zc!qRSSLCsH925O4WAHRO3{I-S;9$LmB8%C8DF}nvYSXC(jRuV_)<{_ABz>`st86{j*bACT7o2zq9?AOKz>YS||$GJLZ+v^>txH{*)36mEE>Kwnji>q_K1KkZ=fRq^K%KMT zgZl$@&W_yLV4X8#Q?Sl?LKdiVo=i&!);ZYPV4ag36R2~}*R2iKIS(2GbiJ*x0g5#Yl;@B1?*t-xgt0E*d)x> ztcnO<67R)U^K1!HoHti$Q&KGPRaPotF0qx^q&%~&Ql6X~NuClhT&)N%SrRcqr677F zHK9-obhskCL`=YNy#fsj1R)SKA`PxkhXu7-puus0pu&WLCM-a&T7_EO6D^_8sKOG4 zE5gg+z(~~Gb&(nzV@4f5!{SY*vHmGN@$S+6ylmxIr3^SD`maW%AL<&ta4w-%LE^r23&m0F7mP5JyK z9X~rKD~Au*TvV2q!>{;LW}9T@JX2w@)s&wTzGWJbz-RGk?t91@z6GU09Mp!|@@*nJ zV7e!Wt3vuIJGsv;U|hw0o`~Sd4Yiq}HXGqT!ek~`EU1RK8U*pUjAqj1AZa*vWt30m zCRqj^IsLM1Ph%s+a!2)~*Gn_97K-(fjE_UiE)oJRy1r+|57G?M4AKnJ^g|=Q@5~IX z@mpJ470}$tQW5KXWg#S_vU5nk&Exk`EL`?8lu~#{8zdPd86^3YlSm#Rl~YccjcS(R zm<-by2;6`XGINftREDEC-iMLOfT=IS2-id!l{Wch1%5_`>SdVL!2R{&F2V@y#a)CE z^xJDpMGl_~5@31*p*0W##)M-AwJySFLM}_o3P?tVt7MqQpi&uBdT11|L8GvdhOIH+ z1Lj+W8HfS%tws&%UdAS2A`BQBIkrGdT-@palg@w=eB7!&h_vueKqTG{mEdr}`4^gL zar_#_SMRcipIOI2iGQBpBz+{DxPj-JBA%hFr&Yl{_vE;^g?KEtR)I^V(^7}L5$7I71CsptF*rhIIh!q?UuerFj59jsTVm>^O# zvz}&(_0g19A$V{+w#UZfVVyJsN9V=*Q}Xj75hlw{J44b)(&eLlewc&MW;Y&Z>O+b0 z+M8)=frrNf`EpXtBpZDDz^9kXRwO(OmOYfqMcKoHyB3b8!NWKyKMT{{LV103qtNk~ zU`E~Ct;