From 9b5e286341b6bb6d35bf1b40a246788faa182893 Mon Sep 17 00:00:00 2001 From: Dimitri Falk Date: Thu, 26 Dec 2024 22:18:45 +0100 Subject: [PATCH] doc(get_*): parameter --- DESCRIPTION | 6 +-- R/get_gauges.R | 2 +- R/get_measurements.R | 5 ++- R/get_meta.R | 7 ++-- README.Rmd | 6 +-- README.md | 48 +++++++++++------------ man/figures/README-unnamed-chunk-5-1.png | Bin 8099 -> 8104 bytes man/get_gauges.Rd | 4 +- man/get_measurements.Rd | 7 ++-- man/get_meta.Rd | 9 +++-- 10 files changed, 49 insertions(+), 45 deletions(-) diff --git a/DESCRIPTION b/DESCRIPTION index 68f19ba..7d28773 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,10 +1,10 @@ Package: EGLVgauges -Title: R Interface for data acquisition from pegel.eglv.de -Version: 0.2.4 +Title: Web-scraping EGLV gauge (meta-)data +Version: 0.2.5 Date: 2024-12-26 Authors@R: person("Dimitri", "Falk", , "falk.dimitri@eglv.de", role = c("aut", "cre")) -Description: Grants easy access to EGLV gauge data and metadata. +Description: Granting easy access to gauge (meta-)data published at pegel.eglv.de. License: AGPL (>= 3) Encoding: UTF-8 Roxygen: list(markdown = TRUE) diff --git a/R/get_gauges.R b/R/get_gauges.R index fa1e494..78f4121 100644 --- a/R/get_gauges.R +++ b/R/get_gauges.R @@ -1,4 +1,4 @@ -#' Get gauge locations +#' Get gauge metadata (simplified), locations and latest measurements #' #' @return Sf object. #' @export diff --git a/R/get_measurements.R b/R/get_measurements.R index f4ecb2f..6ada223 100644 --- a/R/get_measurements.R +++ b/R/get_measurements.R @@ -1,6 +1,7 @@ -#' Get water level or discharge measurements +#' Get water level or discharge measurements for selected gauges #' -#' @param x Tibble as provided by `get_gauges()`. +#' @param x Sf object containing gauges to be used for subsequent queries, +#' as provided by `get_gauges()`. #' @param discharge logical. Retrieve water level or discharge data? #' #' @return List of xts objects. diff --git a/R/get_meta.R b/R/get_meta.R index 91e36ca..8d816f6 100644 --- a/R/get_meta.R +++ b/R/get_meta.R @@ -1,8 +1,9 @@ -#' Get gauge metadata +#' Get (extended) metadata for selected gauges #' -#' @param x character. Station ID. +#' @param x Sf object containing gauges to be used for subsequent queries, +#' as provided by `get_gauges()`. #' -#' @return Tibble. +#' @return Tibble containing metadata. #' @export #' #' @seealso [get_gauges()] diff --git a/README.Rmd b/README.Rmd index 5879c3e..bcc2480 100644 --- a/README.Rmd +++ b/README.Rmd @@ -39,7 +39,7 @@ library(EGLVgauges) ## Basic examples -### Get gauge metadata and latest measurements +### Get gauge metadata, locations and latest measurements ```{r} # fetch all available gauges @@ -51,13 +51,13 @@ gauge <- gauges |> dplyr::filter(id == "10119") gauge ``` -### Get (extended) metadata for specific gauge +### Get (extended) metadata for selected gauges ```{r} get_meta(gauge) ``` -### Get available measurements for specific gauge +### Get available measurements for selected gauges ```{r} # fetch water level measurements diff --git a/README.md b/README.md index 9cdfdd1..5b70ce8 100644 --- a/README.md +++ b/README.md @@ -25,12 +25,12 @@ and load the package via ``` r library(EGLVgauges) -#> 0.2.4 +#> 0.2.5 ``` ## Basic examples -### Get gauge metadata and latest measurements +### Get gauge metadata, locations and latest measurements ``` r # fetch all available gauges @@ -80,7 +80,7 @@ gauge #> # geometry ``` -### Get (extended) metadata for specific gauge +### Get (extended) metadata for selected gauges ``` r get_meta(gauge) @@ -91,7 +91,7 @@ get_meta(gauge) #> # ℹ 1 more variable: level_zero ``` -### Get available measurements for specific gauge +### Get available measurements for selected gauges ``` r # fetch water level measurements @@ -101,27 +101,27 @@ meas #> NOTE: set 'options(xts_check_TZ = FALSE)' to disable this warning #> This note is displayed once per session #> Wasserstand -#> 2024-10-28 17:30:00 68 -#> 2024-10-28 17:35:00 68 -#> 2024-10-28 17:40:00 68 -#> 2024-10-28 17:45:00 68 -#> 2024-10-28 17:50:00 68 -#> 2024-10-28 17:55:00 68 -#> 2024-10-28 18:00:00 68 -#> 2024-10-28 18:05:00 68 -#> 2024-10-28 18:10:00 68 -#> 2024-10-28 18:15:00 68 +#> 2024-10-28 21:20:00 68 +#> 2024-10-28 21:25:00 68 +#> 2024-10-28 21:30:00 68 +#> 2024-10-28 21:35:00 68 +#> 2024-10-28 21:40:00 68 +#> 2024-10-28 21:45:00 68 +#> 2024-10-28 21:50:00 69 +#> 2024-10-28 21:55:00 69 +#> 2024-10-28 22:00:00 69 +#> 2024-10-28 22:05:00 69 #> ... -#> 2024-12-26 16:40:00 85 -#> 2024-12-26 16:45:00 85 -#> 2024-12-26 16:50:00 85 -#> 2024-12-26 16:55:00 85 -#> 2024-12-26 17:00:00 85 -#> 2024-12-26 17:05:00 85 -#> 2024-12-26 17:10:00 85 -#> 2024-12-26 17:15:00 85 -#> 2024-12-26 17:20:00 85 -#> 2024-12-26 17:25:00 85 +#> 2024-12-26 20:30:00 85 +#> 2024-12-26 20:35:00 85 +#> 2024-12-26 20:40:00 86 +#> 2024-12-26 20:45:00 86 +#> 2024-12-26 20:50:00 86 +#> 2024-12-26 20:55:00 86 +#> 2024-12-26 21:00:00 86 +#> 2024-12-26 21:05:00 86 +#> 2024-12-26 21:10:00 86 +#> 2024-12-26 21:15:00 86 class(meas) #> [1] "xts" "zoo" diff --git a/man/figures/README-unnamed-chunk-5-1.png b/man/figures/README-unnamed-chunk-5-1.png index 36c6f87f1b07a2e4b6fb0a561519b7acbf6fe3c2..4c7882481d93009f53ffebefdc02a2745761dfb0 100644 GIT binary patch literal 8104 zcmeHMc{r3|yPr*i>?x8xd)cy&?G>X4jqGE~+8`?X5;IbWEQJb9-YD5AB7~$A6_Yi4 zlBE%{E6bdB)OW7$yRPs2an5zle`n15J~PjKKlgLrzx#LJ?=zR{II|P1%zVr+7>w2E zq`?^&3<1Jm@Gp!=XvXx6{2u5FBhJJU3w?#bFff=W43i4;tX87G@JdQVB|KgU58Xi} zVlyPhz&tUjLy!QP#VZl%LOh5k67fXn-i!x9JP6&#J$DUxR?~>PCWuOq2BZz{DuP6? znFx*(o1r%?6$48hqJelNaMut>R01JA$P8Tz1e?dfaav(vVYMf$nnr6TDm4@F%^>t9 zHaF9S&Ew6@d4kw z6^z=N^|XJRs`G?TfAC`O_d1@l8GU; zm1tE^u=^i-}>VB zkB%d1zMVq76V$FLr4eUeYa!Z-Venb|0WF#7?w}x#0GCIF2to;Sc+Zo)=+t{eBVSLg$Hqz;+Bxci!Q2}^$c;+ocgxe|I=zQqDCKHovCr5v zZA|zg3D}d^4zk%NNiLj9@_B0>|D&IKDiP76bvm_0k5!NJJTj?MfIssm>lX3z;er~p z?am;cm`1u~Y03)PB>DGeFJ@*2w*595PA4n-wDuS4L7|i3A(jS)*F4+GZKep*@dY~N zasC>ML59jF6ay&X7cVe+pS>mB`iO^i^y~|BFEvD0UHyyD62ZRENQ(e#aWZlFh12y) zneQR1*AYD*f)+QLFmVV==YC1fP8s~_wvwMofUcU&wz$#ye6Pmr(2K^3u68-LU{*i= zKDEZJop@t(POrAlG&mYRC_bE|maAdROsG70hSc|^iq^xB&0w9;!rz%gn>%-8FU3rb ztPd|LpG}KDx4(GAqrtyN-+tLP@aR_^-z@Xos@Tv>!fnf%Dx)K^{B0xtJVg_<$y-~G{o}_7;e2e^W>Xl> z+nNkb4fL%W3=8}U?Pe-zOu?ktbs++a?+nNyM)+<79GUCQ(>#E^tqWudz;$!?fs&(nDr>2ga-vjp7YUYL| zpnHZ3LOS$T8J%mwO>+bGUpTG4s-kJr9TOb8@xgkL8wUfDYA_K26z6hlA)=czK2gwW zAx4K-x~|tNYUHrVu9qvdU6fXw?>I>z70u2u1&Mu)!xofafx`dQOXUz{^H-1|_ei$B z;%9|LMScT)62GU7J}@E*+M*H6!NUKiL!2e4PnX-8R+O*vx-XQs)EIceW+v4A*iDVTp%h4*|l8;X1OtoxGEY* z_qC<^^gNi4O`e(2DY;;b$Wn-nAuy)Kv~#<+KYAI-p<8w|s`YN-LxVpkx#ufb$R!P+ zCsi%7c-eAA0Jf1x97WZ_&Dw?7_fJk!7<$^$PhBqVmPI54eTi5+i-tyF@c)PZhv5H$ z1@VZL&3xQ*BRPSWz*XgGoY*uW3D;u_+?C1Ha8+4be52!e($$=}`EeG*1p~mIX z)cd2uR}LSxwRESDQ|G^}zpDoRJGFI=dJNe}lQ3 z`NE`D46f3*m>+ycp6|5)Nw6lt^*dv-iQC;JB)*aME}$Vxz5;E^-J++Ade{8nn@9U2 z&Hx-DOKP_q_0O?k!s3bB*QPN%M&Di4<6~hOujOvt3&1@QsEAm7=bQhxJ}vWwE#wMC zcF?rR=g;kWhYC*jPq`S|j-L(KZECwgddKIi8Qpy1(wsQ|k&eiQ(;s9QrFH>wh3~&0 z9vM1&FFyA#HgP8b-4~@})XQqoI0T=-u8SgExZ01(zq{KNRRj%-xo{==KRBG%$wH&Q zM}HdpqpN*Nd>G<-#|x2zN++3J`XVFv1AuxRihFl3CoS2NBRQd!{NR?;<6({gA&+>0rU{u{W3F)<>#p(Zv<#ekQrxE^$S015lSQ-_ zBPbmvDLDD-OW%C;I432D68b;*1KYm{+PNi{;#We&Ai{kXw7l`NQJ0gsOz|y5sX_sm z{?=yhhSIuo(c8YeZpB=b9=5w0GxZiDo}zRqsnLzy`_aP`k(St#QydNK?HYsuBO@XG zSk{{#qKh}A(1@(T=uOa^4W;}{Um1M7eMu9Vfx_8GdoBPso#W6%YcHk@aYAN!fzxXf z!F0V9)ow51a55=BINnK&y!LjEk>HK?Q^IO+Kx!!E_Gr2UkxsO`3Vk@s&Nm4F7MdKC zKbw&Z|5;7=@77}A*T|0RqTnY*_s<+{{9nfsbMUDo!?&p}`eFg`QSwpk3-4Nc{|5L( zduBFmtY86V1mWr+_OJWyS^3tKW&osNUL)EU#5gGr*%pUP9`BIF5LrENJ{p*hyB2XI5j0Liyra3*Yh!xFM za_!gjbv-76G1`P3gGDK0Vp$G}W+Hiv{@{2N99x_SR((LvEYnO}jqdM@)I+OSBcNLY zHU%z3S(^P)@4gAgb3x9*fH7iV`zDwx&Pc$-eTGt(VzB;e=V}DysTjy4;0oW~S>>6m zx7ZOWUvpLx_xAs&N}4PC)o8 z=PVzZibYrJE}or^ zCVrlmf~yqLIk+JhNHyCBPfGqnDqZw;x3kHiDW<{LS`XN+97${=yK2pgHJFmn^ac7gUNZp-k;HoRMc3kx<(lTK>!hc@pKOGlu?3Ffv zeEHe%w?hAI(fk7;MnXCgDpdgZ13Q9m8UXg~*4r8sC?nxUO#V$$J_M#Bv_UPj3Id>w zJ`b&$2LLyIeg~+x{+s!wJ<8n1!KO^*v83CmKz3+#YcxqBrW&T~11@@$M9f z0QO!`t5XN92vBNUTwqidLKqOE!~v+FRsdMg2?JnJMQ*f68;!u&ydfNCB3#wqAss*k zK21hbzH-21M?^UPnCjPCG3z@#k*XX!0Sh#+cw?y#XtJ6Bk_E{>qF5fF0vnNVvMi#G zoo;9qb{a|nKQmZ%_x7GD=+WjSz&PW;Nojxrs-^oV3r zSx|u{0s(uuC^NkI2r6R&>8p=JomB+e01_(sgY+h60<+9{6(bB%a;5npqtbvy^#Qmx z4A^W6O5E%EFs4$2amInX;*dZ~D6sjsLbz4qx$cS)u>SR;I%zFW6x`rrno&-4 zfCVWt!bcL3Z~;yv+_58?lzcs!BsWFz83`XT0p@tGkl56C;N%4Wc>5XvcmmXgfe4p5 zcAQNj2NcT6q5f_c&`lV0E4pt_Z@3o~=)f640C1DeIp+yOab65&MfDVP?Ke zB*07}$x*+I0&V*!eibNg=fiNa=M!acr`&*(vJK&LX>}jPgI`Ms3UP!lhQ!8c44l(c zx4%tV^AQ8zt3S6_wE;BQ@1Uya_JzU2vkORX3XpdPf*U${Io| zZ!lD40{|1@40_>f4|&+WUmjJkeHViD0}8i|l$n5I7k=`qf(&qhaRn`_l>$nW-el#> zNOBswXSp^bqQAGTH?%m%{^u9CtRx~~>~IdcAOnCn;|VV~UfD^$`Di(w6bok^y|IrW zaCpH0^RS%(_DoJaYH49KE$B+C^3@4xK4~b-iDuYfy~>*Z_~-|9`Q%Ha*jtQJjje}a zRlgVjr3o(>RYwwximP?Mf$R}|x`M>4Nft(6+<`q{Zd4Uiz4dI%aDi#z@&V^|X?{}2;T4F(jD)K#qc9br zU^uJaIy#7#R41h2_Ok{7CqLu`BE~NLIIm|)aR3C4%nV>I0#LWx?U;Rn(4zrH$sM9G z_*c^grP$yYiL!1~PiK1N&X?ZDKIWGrMRqLWqLM7Gp#rV@J<6K*!7G^)S>#sFL08ev6H3ngCf>Wt|o?EW-#a53!}hkI*1 z_3}M;P$1hpEoFd2?TJJV>fGB)h?hRMJ^m9xngYG$>}a~rEXTtXZ1q2R-jS4f_o??x2Qj8TO6}39n0l&2S zL_I`79fSEfN6Eu^5fg2`iZyF;U}g1C>ubvLoObQz{OSSRh5SVf0uWelUED9aEGo07 zlXeDz^S}nainif=&)@I@?+@U#j|j*kDV!}~ zFGavNaPnuFLeX^x6()_U<>onY+AC|X6sH!c;oP8g=1p=eqQ`~@MG@yQTJmV(06nI~(o4Dyzncc+fBby|7UdRZ=0EVu9?L?_#~EoOZ3D=Se~b)2sOu?RuoA z{_|PEH|N$!w_DrPYZ~Cxd9Dh@8@DdehBEUTKKeEF=y#qq;IIxkzt+)uDo>#d0~e^T zR_6!a%4Pf{1>5&!o)@3vp;Y_lo$D4j7sA4PW5X>*L2HPw{$aJ3=Yp@+-D8PZcYmfm zGc!EHg~*~@De9xrkd0N@EQviXB)^-3eHI6j`&-|AigaMfQ>wj+tm5wmJwGu*=OUB1 z&2cC%8p%A@hCM?((!%ygAFM=sSr#}BRgD^EP=`;*%N*O&)9aBdA?wCJOgeB7>3vlM z&N>{;dARFEMwW*B^5wH0KLUNvvn0Z({N3c)W~WaVO=9#`;VOd-X@jdBNDAiZcq|M- zy(D1knS`q*h2Ov8bSNuD6N`4uLKdjRuI4HpOGv84th{$ZKj?M*6M(v@cP%s4vPmf)vLmu~%$UIGO67lrgALhXtls1`C^qSJHNL=eUvvj2mtbbwSQ<$Yz1eP;NIIX0zTBvE+n8vw9Vpbv~v zRWs%q?wlz2wFBBRaYwJvk2NPIQz3`A@hb)VPZ_U}jwcFc=pWGImj$_>v2)^NeEzpD z4fu#-ne{n#k6)J~x=%F~vdhnxq*K35#$+sAw%0W2n_p@VtSnb4{GD5tmwl{eshM|h zk1bhOB3W z6gBH8(VF~yd`r!-{(aq?BdHw|XjPZ&)IQuE=ZZV+Hqfo2PumS-$6=PPwHm}9u)0#G3aeY88!J;CC#BVjJAY_>t*bx8Pnn<8b*P1B z1XWoTV#1{>j|e5`X^%W>Jjdk5;Zajob^?E>M#P*un%DBwyP~c)Ul5i_4|9gEb5s{M zHTI2!Zg&-0^nU4jaW{%)%X3Su%vceBAuCv(xLF*Bxf(7iV&<;@4)aZ~RhmjTa))mH zhMww6n-JeVcg3DO?BvftS;Kd}+csx|h%Wu9QV9UdQ}Nd>-C$~wI6ujFgOB@7yysF= zp);oV_UVIXB~PP3_FkBbQ>ZJ4#-=Yr>wIrsqbGlRb+Q>VjO_x;*Ea2jUzQE-7Ol9x z7&~o1<)bXx*vqlA>ZtoCbCfGbkwx&G>-MfNN{&q$%RU{&^%64KXrImdGr|^J%-m@S3Esc8{XdmaCU~_MA)I;U@un3f; zH7-+U>^?ElV$IeD zeSDEK7|Tf+55Gx$#RAD1J1?5MqC?T`NUm(DURm4k+LycZ3=mZgEepm7FxZTKqyU;%&tVDABh3WdFwrGf%c!O~K}5|CpYpFoo6Iw!+M4}}TJ~voGkR=44CkXpMgbE6AAA+a=Yrxvjz9K|~ z8i>#Yu>t;2?qPv@!xYF;0on(Ghzby_2gB@XK~Td4G(pMD&8;8+6%^?nP{L;hVNmADZ|4Q$^>LN0TCx4Xrh6*Cxr6a6(KE^ z$IH2|=U=IGNGV=?=~n%F#&0C%XEs4L*UKdFYJR3`cM^p{JQj`uNvPkqXpcImbxpCH z=l?aX`%AJ$ue3BggT<`kD!|q!iaaYU{ZAf+{NRa=mw~_6B-FQh&Yq_|SN~!8?oa>S z9n;WV=*fJ$XjyqZmWZL;ti0s^`a}L~P*q#L2(C+iUfm^m^2b7j^DztI<}c6Ed=ky8 z62w=pm6c#C4zA1ciRwC}DyF+HZO@IiI%{VwC9I$5l0CA++<`+wWBsN-lX3N?4ZXC2 z%F8_!n-8KVlaN8L#fz_B-~HtmV8NR|b<>$)StRBbE(t6AWTB`qHbH5r-)m->VCV0C zm}7YM1M^|gIMI|PpXbSy-1j?QDO@x!iXu3lf-(Xgve_n1C%njG3n`JD2;Q`;&DOfU z-9F8oE)4aBsMgdKZ)T4)X9n4(4~1rL<$LTdp7U~~t%&c)^gZI)sxYiCnR)7BhB5n) zt?Eppgojg>>Ck7RJMWbTB`nxRqx_!6sZPW>-y%?1`ffCxqrSP7zvL(;*DbyYHLiJQ zqK7WpY->!eROfGhAr=DCcRP2BxP zS>oqe|8r}yvG@HbOH7+OlyyxtqvRyKQ9fCpr6-9LA!2msql+ zK)j40SZK|8S0a)IpXSBb{}6Py8hN~F6f@;*mI~bQkl_RfUx)IC%NHW9XG$6sLr_G5IczMQn#N~JZn>jvH^zw=7wz7-cT}1{b z5Pg+1;m35Ta#V|%%;E+0J3bVIW~)J#*X3s1)!xp|-cv4b*wW)9`RNKEGy$$&?$5|ZP2xnC)LSIFCKlfz~K8;eaJ$EGG3 zm3`@$(lV1GT9-HZ$MYJqwuCD+Jl0HhxL2{yFVHC!E8Nsf^AHj>@_%B+Y38z45m<>z zX1?E7XeoR$CQBs4=<7n%cX1xvmCR8U+CHJ+z8Uu0ou)Nv6TMS&*8WUGT$8L;%_blM zI6gWv*RDZKo8lv0eliqw#PnyxsgS~TjXpuW)Ga2B46&Wkg!~MfZ)8&5atC77;4M=O zPA`UJ{NH-GDM4OT5)9%ozK6=+)1-*pY`Xvn@H3W43P7iraamM|n^u^A=|xit%;%%e z4>dJWztMl_0>?KHbp?+<^#1C_d?W56wTT6DQaY7k3U11~{t{a^_@Aiat*K60QHa{mg zy6OHZP`s6!OFFW<_JWptY5>8j{jT8%+YhL8<=8jlF`G}HIZ%qO7;$B(1J1H0GOM4d z7r(SlI>lC=iRRFvXN*A(bv@L-yrxmv!6q5S#?wDYOYNc1M-X0{>S+26wP;l*Qz2{= zqm&?{Z0kv@wEdWl#YFy#gZi&uw*Q^sf1o!0*&u6Tpt1T^uAPngH{sF7e@aU5AeoP1 ztWNoOk%erDV*Bw%;E1ONc%RV+82Pp_7;;{9scsrpJbN-vzzw=!+I_baKjr|qHsl1%WFl>o2pSRy5QCx&*f4jY^Y{P>|58au)w zTtFe5b;MPnu8sNTOmDHYuT3`~9qsBzdnJKZh)EPrJPNg7M|*c?3UodrrmvVkD&%b_ z>p7IYP2%{ezLY9Ebzn{-llp#m(~?>atgX|oLFZh~Z|r@+kr8_>inw}nN|jSjKH^Nn zgffR-r%KKz#!vOZUzJSubvVej+1AFI+f2J{KE5gD!#R=M%XY!Ii0+~vdo*&|>Br?( z;p1=5ZDqZG4P`vkR>6?9BgU^UdLKYW!!GP!(A4;vgq4Z7D}vEQ@+DHOd#-EoLwuun zFaNp}Pz+%>dCUlftL#wR{MagRoaWIV6g2N-e%*2t_ZWBjdoHTB3?B4!h6YOZ!RT$9 zY`S0;vZBlv2Ov!fnf%rfgA0rcb3D(8^6Tag2fn?++6Y2tBIUr1+Q3M(SWlRy>gRBh zATL_%|9Sz34YsvHgka+@G10%`htAL<_b-u`z%i#m&V}Nu8EyxqVtn^jhnar5ns0k5 zMK(HMTh)1Q3>vkv#Yb7vq!Uv=?-d2lC`Sr?XBxaO;+-6e5g4VIpT7T>hqgyeiKCv# zCn&|ZHs!;hXbefj=ddVpI;%mgWG{yzA8B*y?%~dBG^2lRu|6IDM<9S(zt=6+oEGZw zcMJa>R1|@6bHVRb6583C7Jz-ZKZu_3zcfNHmrh7&43$ zy{;k}{m1K^4HH`-Z7}|IEGwcsQ2kqgLzC-2LOm2wH>snBi2LzI+xXuD!|SqDteow(NYA<@7uX!RP5gX^q;nNs{-zYZ5aq?VAS72GLXI|MJ=4DR9lRbai9V-Eb(HC> zbq#G34B46S=@oJS-|dCv9r1NY8(t8V8_3O_d^nRtw>521iltPqk{YFs#)&+HSq6ie zUN6oL9uWGASM1cBUmn0Ndc|PKM`gY!0_-gJ(ialH?>X?EXQetmRP;mOG|xMF*zwDV zm7Vg7Uqm1m>lPPabD|^b+|bRwzc&ej?(FJ2O;=HDEbxO^7jW*2FdA{$_sa#4Sb1Lm zSgD? zc0|!~uR|G)*i7=xrO3Fq{g6V$al%p2ryAOChU~075Z?FMq~Q*QgQonCmAmoD9-a!# zdvSI|%saL|tE(>gaMQER)cj?N1YZm7@k8^;`>ce21oJ4|yCm!_Q5`2AK?4*zi6QT2 zUl{3@1%~{d5vAB34rdWRWCyoPrBn!pGP0u51-Kmd{^W=5^P-&}!!w_Ii;~A z9dG4hU|GB2^d>0?scCu|j1fZg@?sD-2li6fJD7wO5`=#Jp+&LAjFu~?rzpj@;iOJ> zMBMjFRF-~EvS@Q8kN(}?*FXmgjh}%DGnqf;GEjah3Zu!t$0uLLsqtz;kPu#XMakZZ z8Ro`LP8a|Lnc-L@H_0PsqHdEK|3>|2m@_)UNP<#Fp{6)(P*Vy$ZOsf9HHytn1I$$U zjgYRp6B-!uMD!HLQOFG#y6vh0+Ay4kNdrUH z<3Rbjz$2O)mpg=zTwM(%(?-QwNQB2t`0?yt0(d+Tg6?2~5WKE3NUlp0p4X5=__JVQ zfU+?-Y$uJ#p;&dH6w{lS5ilPg4jLr|DP?zSl+g0BAq1(!nGGN-?A9AUI5i>V+SzxX8)Ex|RE+tAuBwv^ie- zYlX9OZ_m~wbV&!Ukd%nKV;@UK5Yh}_A!>hF-P`N}v!_j#gWd2WxOcC7jc9P^#5}+)v@m2M{9z8!YZTyMeE_H6XaQCm+QUICf_uH2@zq90%v%ad zWG)lfbQzp=Kwaf_YJB4CozDc3txu`3j%zx7HF9@&$af;@+0oNljur}K>sIAa2GlrC z?qzN8siPHR8^ZNeA?JmDGfIIndKyAI%UTtlI6rqSjQy<(Fk{=pimPurO(IZ{I;}<2 zPJlawASmj33|iA9C>H?E0g<90ip{d(o7|Oa4~_?}o-F_HP?#Qh7SvT~rzwAobnZu% z@7AlWCbPaPqv{=|e*uit2Z}{Muimb?hK8E}I1b`qb(aw;emQaf)K zLC?#ODmfL^dtQ&vq;qI1Viuvukf6}8G!|?8J>Hher{cr;+DM1WoEwkyl`fsM_2hfF z)w^kBu70n&`%rcXX^nHv6sb1-yRbL!R(p^q@3qh~SMZmXuj3M`0-1)6fJ2O$YSVN` zY#O;!S8Y>a>lg-?7?FDKmF=25!tmPthaD)tvzXDruU7Bq$Hdq;aY>(RjNe`8ptq-i zItE;LEVlPNU@DSG`=w;k#pu9v#0Plk%Cp|sfWU4=496qp7fLGuk3_eh5%v{HS%VYV zLxu@VMUV*n!5k;aVPYGOR3WE$*9`EJdAbaA1e27Ssx3+wa^l6E=Bc``B`8B_diO$n zjWMS(m7q0G{5g##0Vrrz!VKu0BHyq_`RDy?UI&IE-f4l?!%OmA&gmvn`K^f>M@CFP z7(4uCtfGrsw$~jmtk%~h{a6XA)pWmwDzBv$9zg5(?JzcR(N4#{oP5o19cQ(IbR{s1 zdIVOGu<;$Id; z=9MOm;ren;Ixfv?S?Oo*?YJIvs5-88;3SmIdX+2o@%Z`)$4@t+Ni;MQqoCX!THd*g z5rdEzHSOtAQpNRQ=CV(wh_tyE7-*+VVtlL62_cwm=;)A zY5g`Ct^L5Qbpau&p}dOXYgp1|_QzVrstaOJ`lxR~gt2s*|D-v6oCd?No#dpAI+7@*PLKJsOXu!RO_#>XsbvHnn41V1@zOgI$=~p zp3S2n>FzFIU&l|H%UFkH#BqhKJg(ATMl2Xo5tg>l%D?BN$8&VfvbKAD>qzaV@(>`i z{gcrbHbB~1c8A%~Y4$Z>TBcQd)x<7|Z}pe7|92oyB(pXuFMfw~=jk>YkT$07RnN6# z!MRyAjJF8(ThCn3c6xiyLY9s*m!ZxpZnrt1kkT3y{`hgTv>fzh?iXp((^Z1R<)z2f z=IE9(a_MPnH+_KpL6N!dp`r1k2IB2?{dpd9LzBt?Z-~kwqN9fjKj5+QjJ}VNM?`_j za3-$7`cpnC1uxk#M@T-TJ4(((vaLjO{~-4gu8!**+_j)ckdjZ-=bX4`ZAic=kkgyw zFOXUz8V#Yf`irs;Jbl`jq~b0;Mab+qz+!MlblRVcGUpo;Z; ze4EIJQ_lg9Aguwvero5Rb+IqnInN^Qu<@kJL#)0@2izknMD(Uw3#{jh1{NZ0(w?ao zaFE5{z#Ho;)GPBx!NLfGpHG$a<|CBKI>tQ=9eGz*4OP+8mKp_cV@x7mf0~In&Z*I& zm-gXZ!3$;IH=ou^1)y2#`%=&yu9S-ceyMK9enfbx=Pw(^j%J*oRyOwLhss*lprKco zMj9U$xVtdz*IK=>(8jEc!MR%qAnE-Ai%7=3EP@ce=bt%}8JvyIvzDtuR}Sp$xsNi# z&2Ae?1H5|-ZgJ6K6;iDNx8eU2@I#;Ao#@fe<=Rf ztohG8@I_YDw=OS7W&~DM&u5L9F*&Vc=bJTO@zkcj*N|2m>?{;m>h z`lL6Z+=MW2>X6n))JF5=c782}Jj3A!osJxbo47RIKf1Sm(h?&B2ADQGzGT6fj!k?w zI~o&NnD@(D=wETKB2jlpEqwqYOV51sCr=3IyV# znd;r!Ir(+Xw~*gKKWB?q8chqaw9PkPK0vnF2$GI}`>|{>Q{Q#04H%6$0D(5GMCD3G+oFoJ#H=7(DJ zr9{eVoP0(izge!Y`^HXYdo4TNQboc$k+&bqiHpM*)$sCo1v(%8VU7N0`BHe{W6ug~ zvfGP8YB^O;$7F*l&26 zcbBsuRE*9}x#l?vR6Af!o1XQr|3WPfOn0@3-=fQTeBJB{-^lEMXyK6>9+q%Gdh0m> zCFx`_Jo`O$5yOe|!c6uwx6l4!kSWvas{~h_e zXX(enRD_ar!LlQe=)ym(+12Ou+PsvS=fD?k-Jg1 zAWQq%@PW(x^4~*dQ7`cN2c;hr(0T4W@Ih3`a|VUQ9F-?-Tq~pb-J$-Y;U%@RiJl~N z$(beU?t{FA&k)$CsvMr!=tk?jL!E|BrG6Owmv6_FOa>#P5QX%wLW8Sj4=#4F;jP0S z7j=vgSVHYno~Q5LzP<6%zjM0VUwHoExQEC^OetNjsm{R+U)D15?uraqFOEFdl-!!1 zDg8LWIfVltxZ