From cb98c840312e4e0448cc23eefbb9e892632ca504 Mon Sep 17 00:00:00 2001 From: Diego H Date: Fri, 26 Jan 2024 00:23:10 +0100 Subject: [PATCH] Improve deprecations --- CITATION.cff | 3 - DESCRIPTION | 2 +- R/deprecated.R | 65 +++++++++++++++ R/geo_amenity.R | 65 --------------- R/geo_amenity_sf.R | 61 -------------- codemeta.json | 2 +- inst/WORDLIST | 1 - man/figures/README-pizzahut-1.png | Bin 9709 -> 9044 bytes man/figures/lifecycle-defunct.svg | 2 +- man/figures/logo.png | Bin 21003 -> 20989 bytes man/geo_address_lookup.Rd | 4 +- man/geo_address_lookup_sf.Rd | 4 +- man/geo_amenity.Rd | 51 ++---------- man/geo_amenity_sf.Rd | 102 ------------------------ man/geo_lite.Rd | 2 +- man/geo_lite_sf.Rd | 2 +- tests/testthat/_snaps/deprecated.md | 20 +++++ tests/testthat/_snaps/geo_amenity.md | 10 --- tests/testthat/_snaps/geo_amenity_sf.md | 10 --- tests/testthat/test-deprecated.R | 11 +++ tests/testthat/test-geo_amenity.R | 5 -- tests/testthat/test-geo_amenity_sf.R | 5 -- 22 files changed, 112 insertions(+), 315 deletions(-) create mode 100644 R/deprecated.R delete mode 100644 R/geo_amenity.R delete mode 100644 R/geo_amenity_sf.R delete mode 100644 man/geo_amenity_sf.Rd create mode 100644 tests/testthat/_snaps/deprecated.md delete mode 100644 tests/testthat/_snaps/geo_amenity.md delete mode 100644 tests/testthat/_snaps/geo_amenity_sf.md create mode 100644 tests/testthat/test-deprecated.R delete mode 100644 tests/testthat/test-geo_amenity.R delete mode 100644 tests/testthat/test-geo_amenity_sf.R diff --git a/CITATION.cff b/CITATION.cff index 8cc63641..c4f4dd1a 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -106,9 +106,6 @@ references: email: jeroen@berkeley.edu orcid: https://orcid.org/0000-0002-4035-0289 year: '2024' - identifiers: - - type: url - value: https://arxiv.org/abs/1403.2805 version: '>= 1.7.0' - type: software title: lifecycle diff --git a/DESCRIPTION b/DESCRIPTION index d2d92049..ef7bd546 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -40,7 +40,7 @@ Copyright: Data © OpenStreetMap contributors, ODbL 1.0. Encoding: UTF-8 Roxygen: list(markdown = TRUE) -RoxygenNote: 7.3.0 +RoxygenNote: 7.3.1 X-schema.org-applicationCategory: cartography X-schema.org-keywords: r, geocoding, openstreetmap, address, nominatim, reverse-geocoding, rstats, shapefile, r-package, spatial, cran, diff --git a/R/deprecated.R b/R/deprecated.R new file mode 100644 index 00000000..14efd9b9 --- /dev/null +++ b/R/deprecated.R @@ -0,0 +1,65 @@ +#' Geocode amenities +#' +#' @description +#' `r lifecycle::badge("defunct")` +#' +#' This operation is not supported any more. Use +#' [arcgeocoder::arc_geo_categories()] instead. +#' +#' +#' @param bbox,... Deprecated +#' +#' @return An error. +#' +#' @keywords internal +#' @name geo_amenity +#' @rdname geo_amenity +#' +#' @export +#' @examples +#' \donttest{ +#' #' # Madrid, Spain +#' +#' library(arcgeocoder) +#' library(ggplot2) +#' +#' bbox <- c(-3.888954, 40.311977, -3.517916, 40.643729) +#' +#' # Food +#' rest_pub <- arc_geo_categories( +#' bbox = bbox, category = "Bakery,Bar or Pub", +#' full_results = TRUE, +#' limit = 50 +#' ) +#' +#' rest_pub +#' } +geo_amenity <- function(bbox = NULL, ...) { + if (requireNamespace("lifecycle", quietly = TRUE)) { + lifecycle::deprecate_stop("0.3.0", "geo_amenity()", + with = "arcgeocoder::arc_geo_categories()", + details = paste( + "Operation not supported any", + "more by the Nominatim API." + ) + ) + } +} + +#' +#' @name geo_amenity_sf +#' @rdname geo_amenity +#' +#' @keywords internal +#' @export +geo_amenity_sf <- function(bbox = NULL, ...) { + if (requireNamespace("lifecycle", quietly = TRUE)) { + lifecycle::deprecate_stop("0.3.0", "geo_amenity_sf()", + with = "arcgeocoder::arc_geo_categories()", + details = paste( + "Operation not supported any", + "more by the Nominatim API." + ) + ) + } +} diff --git a/R/geo_amenity.R b/R/geo_amenity.R deleted file mode 100644 index f60da235..00000000 --- a/R/geo_amenity.R +++ /dev/null @@ -1,65 +0,0 @@ -#' Geocode amenities -#' -#' @description -#' `r lifecycle::badge("deprecated")` -#' -#' This operation is not supported any more. Use -#' [arcgeocoder::arc_geo_categories()] instead. -#' -#' -#' @param bbox A numeric vector of latitude and longitude -#' `(, , , )` that -#' restrict the search area. See **Details**. -#' @param amenity A character of a vector of character with the amenities to be -#' geolocated (i.e. `c("pub", "restaurant")`). -#' @param custom_query API-specific parameters to be used. -#' @param strict Logical `TRUE/FALSE`. Force the results to be included inside -#' the `bbox`. Note that Nominatim default behavior may return results located -#' outside the provided bounding box. -#' -#' @inheritParams geo_lite -#' -#' @return An error. -#' -#' @seealso [geo_amenity_sf()] -#' @keywords internal -#' -#' @export -#' @examples -#' \donttest{ -#' #' # Madrid, Spain -#' -#' library(arcgeocoder) -#' library(ggplot2) -#' -#' bbox <- c(-3.888954, 40.311977, -3.517916, 40.643729) -#' -#' # Food -#' rest_pub <- arc_geo_categories( -#' bbox = bbox, category = "Bakery,Bar or Pub", -#' full_results = TRUE, -#' limit = 50 -#' ) -#' -#' rest_pub -#' } -geo_amenity <- function(bbox, - amenity, - lat = "lat", - long = "lon", - limit = 1, - full_results = FALSE, - return_addresses = TRUE, - verbose = FALSE, - custom_query = list(), - strict = FALSE) { - if (requireNamespace("lifecycle", quietly = TRUE)) { - lifecycle::deprecate_stop("0.3.0", "geo_amenity()", - with = "arcgeocoder::arc_geo_categories()", - details = paste( - "Operation not supported any", - "more by the Nominatim API." - ) - ) - } -} diff --git a/R/geo_amenity_sf.R b/R/geo_amenity_sf.R deleted file mode 100644 index 3a755e57..00000000 --- a/R/geo_amenity_sf.R +++ /dev/null @@ -1,61 +0,0 @@ -#' Geocode amenities in Spatial format -#' -#' @description -#' `r lifecycle::badge("deprecated")` -#' -#' This operation is not supported any more. Use -#' [arcgeocoder::arc_geo_categories()] instead. -#' -#' -#' @inheritParams geo_lite_sf -#' @inheritParams geo_amenity -#' -#' @return An error -#' -#' @inheritSection geo_lite_sf About Geometry Types -#' -#' @keywords internal -#' -#' @export -#' @examples -#' \donttest{ -#' #' # Madrid, Spain -#' -#' library(arcgeocoder) -#' library(ggplot2) -#' -#' bbox <- c(-3.888954, 40.311977, -3.517916, 40.643729) -#' -#' # Food -#' rest_pub <- arc_geo_categories( -#' bbox = bbox, category = "Bakery,Bar or Pub", -#' full_results = TRUE, -#' limit = 50 -#' ) -#' if (nrow(rest_pub) > 1) { -#' # To sf -#' rest_pub_sf <- sf::st_as_sf(rest_pub, coords = c("lon", "lat"), crs = 4326) -#' -#' ggplot(rest_pub_sf) + -#' geom_sf(aes(color = Type)) -#' } -#' } -geo_amenity_sf <- function(bbox, - amenity, - limit = 1, - full_results = FALSE, - return_addresses = TRUE, - verbose = FALSE, - custom_query = list(), - points_only = TRUE, - strict = FALSE) { - if (requireNamespace("lifecycle", quietly = TRUE)) { - lifecycle::deprecate_stop("0.3.0", "geo_amenity_sf()", - with = "arcgeocoder::arc_geo_categories()", - details = paste( - "Operation not supported any", - "more by the Nominatim API." - ) - ) - } -} diff --git a/codemeta.json b/codemeta.json index 8d1fe892..80d3b9e7 100644 --- a/codemeta.json +++ b/codemeta.json @@ -199,7 +199,7 @@ }, "applicationCategory": "cartography", "keywords": ["r", "geocoding", "openstreetmap", "address", "nominatim", "reverse-geocoding", "rstats", "shapefile", "r-package", "spatial", "cran", "api-wrapper", "api", "gis"], - "fileSize": "189.88KB", + "fileSize": "182.118KB", "citation": [ { "@type": "SoftwareSourceCode", diff --git a/inst/WORDLIST b/inst/WORDLIST index 9ef50f02..f9a83ef9 100644 --- a/inst/WORDLIST +++ b/inst/WORDLIST @@ -26,7 +26,6 @@ geocode geocoded geocoder geocoding -geolocated ie json lon diff --git a/man/figures/README-pizzahut-1.png b/man/figures/README-pizzahut-1.png index 4954bd0beac15b9e33fd2b63195389851d99e2bb..3e7ce8c35e1610420226bcf8fdd753ac01adf10b 100644 GIT binary patch literal 9044 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 vA5jBOKT|MU~*JwycNa!>lsOgiCkbxv5 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 diff --git a/man/figures/lifecycle-defunct.svg b/man/figures/lifecycle-defunct.svg index d5c9559e..bca2fe0d 100644 --- a/man/figures/lifecycle-defunct.svg +++ b/man/figures/lifecycle-defunct.svg @@ -9,7 +9,7 @@ - + diff --git a/man/figures/logo.png b/man/figures/logo.png index 9572ec666a86a1fa6628d50f84858b46ed3261dc..78f5c08679f7c2f660ec49da4d51d98e59aee8da 100644 GIT binary patch literal 20989 zcmYhh19T-%^er6T*tTukwyhg;VmrBUGO^7GCX-}hn-kmi#F!W_zyJ5%``%jBYn?i0 z@7@fTc#OYb|M~x?G5nAJ|91b6^S>y=|Bv|+`D$MZDvTokoB01C z|6iNo3;BP!|6~8}sF3Ra7y9acetzENqBDu8GK;7%i>lq^V5}wL3n>|k%E)s`>u^YF zrR0`L%E<~zE3k-Z@JJ}$-rcWn?Xrm~Ynr(TC>S0dpK^*TzrTN+o?Xl?u67TMy}iAK ze$U{M)q8w=atHD)tgOeT72M{a&&Cl3TXAPNvv7$kDH+-;DN8>;zxYKYWxF!*ODcGo z@_l@Kv;|YfXBIaHQR-@lOKDjir(=t&n~SIbO}_d0n)6IV6Q5^cjz*Ex_|fjA;tWNQ z8fl3FwMEY|G369xPBX9$({KjHrkXnXEcJwCb*#NW31d@pk+vMAUJLp3cVn+UgS4`a;(3A?>}xmsdCHDw5wF*p}n*!)!PwW)?d8M}BzG=esjb%`GKm zmzwK}l-D+!I{NP(92Hgm&i_#(E-QC*dd4cM{5ycUw7T);_O8;0mP1^5Dwb#~8Mo?p ztD|3}f}(VAOj>nAyMn&$*6zVoHs;IAtFgULtUdeL#g#`$+{5D|i-?MYcX;p6xNBfc zcFE6`_3g0uteq6x#y~0^OZRRNd8!kOrkdnJJV9-9XPrNdy`f-{2V;0*j;e`cMq#C^ zF@JwJS+y_S{?SQ*1-GM-fSFT3M<_*a7+JC-YvMPy%Ph>Ro7>+l-NWNEY5C<*$+?Dh z-nIrp(RS=htD8-o{fdV6ww@q9d4t^2Ukz=&GV(J0BNG?dn13^|gp`e){iD@@PSOf8 zlA0DRU4tBA%IisZb4zPtYNokvOd}IB2DV;5el?9w%7r@xv)s;2C9uTlmUtl1?KmKwP98!^9EzP*qrRNFmtTPOY zm)y31G^%9BV;oo$%=MIg0=ta+to^s>xG`-i(jqDW(m$3lryu&JQfrB>` zfdYY)UV2V{gHw>8Xft(+l%(nyI_cTos^&Gr@%1Zg5gO4ojZGzFFMfpMGgcJgN+<;B z(*MvZldOs(shs@j=wP8=&Fyk1-Sj69FFh|{;&N(gVr%3%kn$`~&+2i@=`xpZJNGIq z92_i|ujAoz6?~wV56)A%kWR1zEF#oI@NUkZaQoJ45P zJq=RZMQq@fBIW6X{Y`En*7qSbib1Y3716f~K**QcLTw@xhZ3&4<|_>=GXO@djBE() zj>2#=N0^!s+;P{6b))@uLq^0J&}~6^j(lbjf-D)LwW^Ji3^ZT$#bu>-LT`~N3ch|r z$K^b#v!sK^M9Z=2Yh?=`Vo1biTtgv)5Xfv`f~bU&otc1w?l>wTt%Iku!LIYggGb)= zBkfTX*f_A@0)xwToLIw*=j`kDV9jha+q#sJWeA2+V!-?gMy(<9B;1=mRLPdIiH80_ za?5ZMR=bO%0Piu_9Z;&h@K%s7V{fIKDV(qy)4Qx zc--n*w-ap^C9x0$TA)q}bO=YM`6mWm`Cr-qavKwceo7nXRZVaueeOWdE8d5#G3cb6fn76nj#jCanXrZ2znM zWYIV^S$BGv+)Qp7FWP@JZ`aiWss9S*HhDV_Q4lFEiW;H&Ph%sGUA#z@6FOyAWr z%|0n@A_#g;a zF}$42ICEG(mRd`tS2${!vcnyH4@#F#P>m|(_$qm6p%VE!>82&dfd%MxT(ZMKT{X($ z8w=kQ1lnj?;aEn>-Msy$J$um zwY#yL1zC?`CR7*5-9+I`F9l)m91jsSq*OWqvr+Cmjr#LVQqQ;KzMWqn9h^LI?j$Kf zyfkjQ{D;uh*d#ncJo-yH3o2dL;TI(eord0@$!Sln*6WR9*wdI?To8jyeAI~hG%*E% z--XqA#>a;jljgQCKiXa0hRR0YpXuy6Z2j}G-U(RbRMb0sv_Lb~GW3D>^HuNJvMxMKVvp_Osk4pGPqrN8Tx*h-Twm3zdDR;h=u&4bb4 zCgTJeZvF$0p?!wZdhtL*Zate6Z`5PxnAAs8&JxDRHR%M!M!5+b_@$~;FLvwSS!(GL zMkO-T{!AkpVIv6w{^!FEU&LN28*YClgrV}8fFs!OIM++oJ3-hP%M>(|@gqaUP>Ys@ znO8?Yc)Y^{_6Hx-V5mv?oI&?D!*;s)LrRhBGK_+^T^;6*;V6&qkrU^4y(VzkNndv; z$Lzu`eEgL}Mr9WPMi2%~NgEj(Du~iXdyP^*JIv?Xgv;i&pCafa;d9ql;YM>sgewA) z_{rgZG_Kat;g@dZUn?i`k8)9vO85Js&H(|s3PJ&{grVr~!Du{_akL`tKF$4Im*fIT zg{L;_quc`!%oc$V^Q?k0F&*m@4>1n0JkO$U{crD!FiB8P&ygZ!5S<<{aM_efV_rN{NW~_LwsW1V`VV z*H_qvouJFB{Sh5E^QYYq`w|(WbxKe8hGawQnX)4FYbIG`ot4ALo~ZbbKLVFmUVgtk zEwHB08>d`vyKFJqC8Tq0WWq|-E+G#~`yaP&8nxqgrn$*#SeeAmF718#OvN*9i!OVr z6x=&B@M3oe;-ooD1W~`PY2p2*I8+b@#r59YEPzWYO@uSLPt9NjIf#F?`V;57y%fkBYUL-LI^XWD4Kh1 z*i#GVTeExFrJN}Q$>;bM8Dad5$vY{8O4x-V$hZUM2G;7*YlB&&S1aZcZ*89#Ih>v<2%A31e>b10D1>APSK-z8QA7h`t;VVm4G>~qnHTJo% z1W%yxTh09W&x1B*gagtu*JIZY%7fHxW4lWBfQdidLb_&eaNb?%I(Dc$EQs4ZRN5y7 zVFu;we~*Hy6Uw!Kw=6yvyIp8eUDq#>VjqQ?AbZV zx!w1oq9%m~Ih;@ioF}nfMh|XRNc_co^WUwAVnkKqwR7I|v#${9)6R1BF0z=bq)1(2 zW+KU0U~G2$J&3TJAX26S)=r3FGH1qEI*LXP7|51mva0h%)<5?lT(Ii>w)eAjL3Va2o7B4XZbW!dzmp*} zxAym^ox5w2K8(jI*fEC@iED|Za^3#-EN{j1#$E72s1+r0aNnOUCS(G1+s?$vNR~H&1!%bAdrv3C z{=0agOsE>N)H|_Z=3_CU7LauGnDD2H+7p(bzQ9Dd`ggQRvKcNUgBs_Vh}zPK8ZoTiQXKy6Mal(l$310Ctcry z9^Y4jM!8ckW6s(fQVQ-+N~`xXTQKzMWIBpUy#{08#smpWJSK&0g9jQ0UWh)^OnRRA zKR*3rwm&XRx~V(={oTeCxv2}u}E1Wei82+}bzl`%vve`d5UDJ*Y(v#pygO zg%n!W68~|7MAGqwXhIaf7myIZ_fqm%!8=-a;%r;hUR#%<%8POQPb{;4dZ=!P5(0lz zqMRP{9fQ~Pq%ku)CNt?xm&`A3uo!=sofy$ z)B39OGkdfd>_bEeE*cyTs?-)rO%z%T2kKO67Dd`yb$;ychZZ77tSc2pm1 zdCU3RbiGPTh0`~Z%>cKnJUr?w;kGeh;iI?0F;+L4vG=LA<9xTvw!FP3hyX$#%H>xK zVZ>Z238`4SL{W~%(pai-@iG?RQS7_(FtE8^Z~|_@Ct>KEv-lV#4P)Rbt9<|4G!F-Z ziQ)taq%uVV5JTyS)mba$lE%0A#qC*Lg!!-guw-dNUn~Zc={kzfO4S|lXr2v=##NsX zv)lK~#NkLwn2Z_8;VY9LdWCS1t;l-xGEYVt0rkxW)gav5q!$c&J>N0SyvM5e;HYkIz)A-SH}5|qG^0MH@WIkw@I+LJNhCVKO7 zOZJP9;-`%@D4ucFwQx0pSr_V$OmioHeA+*41~=y&sR>ov9VR@Q8FBpWk!=vg02J2i zCX5d{Dx)QZDzCfHnNP!hMMX1G&c#0*bQ3_3{$x_ zuY-GQHm%_h{88Qx^BS=wP!P)**2>z}ey)6a1_2PeHc|)-UEJZxx_!@R>>ljE4St_8 z2!~+?Yhn_T5FLZG`YAv%f@$}rud7V;V}7}Og{`m;!*lvnb~jxAN6B$K;|c@6-}mYu z(UgUSDX*&z(V*LVQj_w%VX*dOr|5)op)^+%1DsM3B6!Xxu{B`{nPl?R@Sj*(O75)> z4iW_?y}*ef@dK##7uP}K!Kk(fkx^Ps#%!#qx?wg64Qr~sVIc9uF**@) zxG@R6!b{dK8})H6tMe%GWy%z(x-r3UduECG5{vy}f%?g-UY)=Fks*Z&BVz2eD>Cae zBmmA3reA-_F>@}6_2vI936OL^uvO?hF%oU$+b(Ro9;eEipJDJ=!^_Q`4PA}WKy!}M z$2@{^0l2AAS2YG(T#LHpKOVZ}zN zjTm%^v*=xP5SHRbo>{cjr{B<(vE+OCE*cqts?rC-EY*oVgUi1%*+iQx?%!(Y40A{I zN-z+BbKv4I?W99LHFNj*Pj+ij-`Xgf9v7^=-KV6pIwFajqeHwUhA$_d;ve)eCXc5Z zQf`Yo7Z}$Ba4mS<9XWsdwT(t%@-wtJdhnn3G@aayD{|&$j%EPEspS(rXfD(vo2tbOhQDYeN6M1U=BhME2JTEeJ`Y2pqnj z*@TV+^IGfW_Zo8++_C~BPhpt(ti$^de@WSN(G!In>(q{($tLPhJIOwB{Ouz1i(~%G z?CtddT$v)mzL?~Sv$lTsfab`>DF?p6rR5W}d${tZTAL3QZr$Osid^VI?)B~r+kPvd zaO-+_-Ma5bcEYvb&_;~t3<0OestX-0Na@93mm~bcQ)lKprhr>`0Z-kh@nfinkTsl= zAoH{Q8}e_Gtrm$^GdAGixVE3!(|3b6WZ;S6XTxs+bFRJ5UK0zUJt<&l#dXOVjg9HRQ{&jX`lCabBQKhTy(KT7q}u~Dik zd%ySfjTIv=5d8szWS=NlhhlUoCcOGX+x_=UNrV`Z-GSHu-I-%Pa^r*K6I|Nn*T22uq5{Ho7x=sfz2ZQfBNb0L6B0zXSf?wPlS^m?^dTXwdUY(o zC%q$GA3Vr@lXK4F?38ai3t_jLlDJ@cmlg!9cL4g9w(q3m>bFwkup2{Qm!S8cVr223 zzhX384>2vHzzd>6T0)$pi_OvLqWt>OOPx~M#t=!C+T5h_qMVPEkbzzygxC0rUH=srhD zGQ~cR$U_lHM+h@~S~B#)O+%yfV?X>05LTM6M3I{0AA=D_tO*X;*bJPF5PQ@xWtOSS z`UA&hIwWdDG;<;ELgKNiU|X3Hz0}>@a0S03VA{IZ93!y`4RTp{*P61OOgkSX7xdCa z?G_xnx?l$NwPI+=X5M^&tPl;a9;68Xwo|tF6S+mh5m=BO9>I2a_jtpkAx4W;f5nQt zjd0*`bTsH{kPl-UwGn@mkXcZRWR~n^{u76r&ZDXL3CsPapxzH`9~>P7qW;8#T<);6 z8z7B!O*eLIxw&p0M@oQa9ZOoPaK+ZY`$NU}hO{M!w6v?5J`AL<^-AJRR38C} zo!-owIK9H|jS-LR)WCvfE&qpIaVZvR`fcW&ptalNqA^DEPE-)bzQ%MRf0gg-7l!|Y zlZRPdc*}F*%B;2mE-NfO#=^gQUO-`(VybMu`nNvc8iWRU2A3Sb+es0d-KaiTD8mAW8w_$M~agmcMQh2QQO7 z^f2M{icKK3;A~*0b%mSvJ0xfb_~GmDcZGvx6;J|Sncd17{C8)&wM)#V>kU5+*)lR& zLJuFrGsO|kwxsMu0FstQA-pM$Ze1J#K0pCviFRr#j8T}f+%dYbizN6IaRAJLAfoD_ z6J`K-Qm9b=*Dz%|d%)(30;&6Xz-fiJr4jLGhi=sEn$7E^AIv)sTiXSufDL<(Hv}A{ zKE;4k8ZrWelsC}oHi+z)5N_6YLhJO;RM+2w2dHc??nkpi=(b=azg$cZf`kVGC|wM&<W+|M{`fhgc7I-V{hT#?5 zx8VGSpza^AjEyZc=?XUd3K_S!GaM^>n1ZZK!E@E3P92;;9)K|gnG+Y*_m zJMgDk57mGc49B*jU!OU%;BtXa9+~&|^ReCZbo$xKeyf4NwmcudwLMqwL<3}b>s-N1 zy~R_O?Xa`W8B$9IMvKkryJsCmdxKX7_~n4L$)1);m7lbVKYa+#*$_X##sbLz{^4}l zkMg32%`jR7KQ+jqv1WuMp9U##QOhmq%`4@Y4X|{KIH9T~_V@G8eanR_SK9`c$MgHZ zw1@S}KHE9YogJ&XtI=QLmiM$v7tayf)qWHfs5k?`Xu1wKH#4w8yP4wa^fe)2X@N)? zO+5s1+;120em!e_8DZdvtef)zctQ-zokB=hLOJ_{-;otGJfvJSB(5tIXh;P?0D|8H;(?birf;W6eG=Y6AHm|buXoj0Ep0V z&B_6W@@j`Dyr~tG<|k%g(ph9$a%%!2JuC}}5y?$wt&{srm-y6moG^cJ7t!IQ{MgjI z&u#K2DP*?m10yh5A008XkAcIIZ6@30U@q@yV$sHjB5hhG{aGK>QiCY0ggYp@HBmBX z*K-6Xe$kuLf<;;u;wxal;Lt(w6uB|f7o%|6&i*868f@PiePHzMB;&pBbKp6d{`MY` z4Las`RaZQEhG5Y-!c;eMLwMT@`cHTe9xI+-R4>~gpIn{{Z*XQzo&+vzaCIftclrE@ z-$Q7sus1W70nu9F;8ywTD!emF#cWLfT#0zBR}t2WT?mRtsSk{QQ_-~^LO(F#3`G0; zdfl<*$r&i&R>zmjoE&8aH&UZ7N@?;!bzNh7=_+}TM;_q>?-DR3Fx_p@MonPQ!*B;a z>YG?E0)e6!SF()lMCN)pkUZ}8`f#+Zw777Eulp{g1{YaQ&9P!pdstwdMoJ*b#5fby8ervE2)HeZaJ+oJgZN79?&_n7$ZU_|8KK zZJmVB+F-`G=iB3n&YC)1`AG1T-l~s|KP;b#vnGZkf&6M(E9p4yY0w(vHg;FYoAR1) zfC^Jnb|;>&D($y9vB#?hQY$mNn*WmWm?`M*dqOlEXibLcRr5!e8~`k}02|wKc(h7v!SH@7%#q4l!N`%T2sg5P>&aM<4A?$i1>y^4p!|852x_=P zxXLEl^gv|^djEYMz<|PZYch+(o+|t=D4uj2f3kmvqzB%Ki;ub#p%z~5sED%`qW2ek z!ipm)y(7E84w2_0MAory~^W@y&;~$STo7+Jzg&Vw}=}8gqhoz6d9INHqo9p#z z^Q^3$!Ud!YK9eupVQ0>sY$+hPe(gXL5{nu^GzDe43dIIsgf1BUuf8dh04m{7F?8ZY zZonl~(9H(T2aL9IQjt4-U#~gyyV#S|B;R}JJNq&%E#BD}8V>0q)IR&(UkHA@)`D-} zG5pyCyR{ew^3k6y6d-I5GdvwX*3+6=uxt81H_87oxqS|vwqn4CKX7|7M}W-9hC~d-OyDA87Vy^u%k|y>rY4b`)kj}299w@X zG``&!2#xmyHUUpu?b+&%mte9ZMsA=*WTT0O(=c}wS-zB6l&5!1=mNq*{>{0eHs#uo z!xH%3UxbdZ&jY0)ZJZsHS&j{&M>J(Wb#eb?`cMmc9T;1`EoqgbREyC5b7S7O&4e2> zJ9K+sc~W^hWDwsGiv&-0vNoj<%qOM|9`~S02a>N8unUDIU_9scD{kMTB2p@>WVV=J z-Ut_ZnajRWTsb?E%fIB{JV+59_s`9yISext{Q?l;~rmC%BV4#YXx}NkQ z?~>T#T4PzKXr$X3^uRTCF2@TKTy7VR6OF@xJCdJ;`e3I;e$F~lP>a`s8xqY^YsT_i8p{deCCl`x1jB}M#OgUcd6qVv+T!dl;+ z>M#etBWBYphXJkvD|`)F_1A8t6Vy`!hrryF3IXIll1*(o>?Al9OFmUX=>?;EQLMF{d) z6(`n^f_~l3e(Aw^$ooGZMlASRFG4(UH~A%g#N)!oTVlr!w_OxNa>w}3?YQ1I8JRG4x&O(I8l`*p<=mWk+Dc0|>a zotnnDk`^p54KWIt?MHhuZDVK_#Yk}~vl5Smx?k+OCSc{32mMLk9w1|voMVTl8)2dom zA87@7``yOamhj)(u*<>f8f&IB3YmLc6QDG0Zd17Bpi2fpsO6P?W3q&JMBS`%FXjYw zCFigSoLHenb(~d{3npw1gQGBE%24f`8w)1$q%6)bODHY5Egt8lWQKYB;+IPQ8g;A% zDL#V)a}-|EZzRNsNV_=p0)5sMd1j&ACU7cB%4imDn5CRqN)7&HG!1LgZ#$XS{b05P z6Zte_PDMyR>mJ!`F=2Rj?7OnWDb;#&XQQ&a-y+owS^2{#9T&tAkqQas!Psi+8r*PkD8&14U+aWRwp zcytt$S#9lmh=B=mLq&bkeGjkM=N`C5Ic6@kZ>qXm;(`4OKNS%f5Cc(6ox|S!VTRO# zM1b@bbexAf%tDIal&rxHh6k93O!aY#8zMb6^>P8xy zTbNfx)kP1jWQbs0o;{%qykR#rBQ%4T{RYjVX2!&uIMf-9{sx=f3hFN!-ej4xMC z7x*<8mU+k?E~i758>#J1x)=d`7kam}Nt=^SHN;79gj%`*x)qf6k zu*VSQ)fdHOEv!$dsw5bR%`Qhg9S0CN(Z-vtOEDNmgUQ8wmu^F}>D0AbYo%X7B`@43 zH;nlL*RjL0SHx{v7mP3T6TBWutD7(}=%EscTbLQ|dK@L3-icmfg7gRYsyHs9y;q_; zrWuwi0mnJD}cN47$8(u+$z&ownC=hIkc98Y&+7I4=K7;rzi=k zcCA?^4jI(`yt57h_3?#nM0)|gme2=ef&=yHW3BULdisj5G571ORWyH7v)vZk5ESG{ z9==vII?wtC;0z?m21REa>_kI1w+K?ok3`YBspbm`~i5C8U(A>EIZ9RCf(pwRll^A`WTXrBc>;WkEH*O*iW5ri@{`~cUVKCMBt*80BE2RNP zV%iU&8w_urB1aW>&O#MMc~l!f1px{U;K?n1@6gV({A0ZShfxHLv=VweFJwVf&@%w> zZqw@b=yhz)ndgPD$D`eGUz)+;u=X$&1-KTgtT5M6sOq1jbHxJ>*SRXNOwXh+`nwSG zQPM*OU#MIH+xt}1w2;xz;9?w>(04?D?xp0g@b{NkNm!#WIkLjT&i+b*lUG<^=IQ8R zC+}T(6)-0JcSW;MV$(%r{4r*^8BWMcWeX#I_yyN93rQ5 zacKyx->?CDk!Xz`hka8lSLyp~>Ew}PsHCnaNFyK2pF`?2NQne&gg6H0@R&)I0=W1a z;MsIs&1_^zRXm|hG~-92xaHAcAC+EGnqK^UhM!#DyCY@HZ9gkaTlf>({jt$tB% zv-IF<7c-mv3exxr1tMq;VEg_Y;-pNUUV$Y#h?h_}v^uhO9`q|UA_FrlzRCR+ktR6d{c-xYfXAeSN(V zJtmRsHd5{aLig@-DJW5yy|X(K6d^ z8TOK5#5*h`H7Zv-332iLFMJP@W=Ic;qb=kv=%KG8KqoRJ(nI{X&5*w~0;7Yl)>$=m zQz1re{dcOs$b*huY}zzWy%GJQ$r}LBI;|!x*+|~8$z}5R#*oRC3;EC7dT+(~31UOl zyPnC~u)cu)rNHK*qimpeKAk4<=~XWDs;ihie>Or6l$LY|3pJvcr4@Zsf z^jfzJ@VE_Vmu5hRK|ldb4dp9@+l@DDm6!1^^^aX1yn{jsVnv>DxK9sS(a=D%{0TylQzH1K0o5Ww&B%~yArR}+%Chwk|MN5E z`EOzjFfD&4N_}BKDTgR51x6KBM%;AZ&Z_s-32P!3ww)yvrZD{NsT1_0fW@D9PaJ;K zlo7*iKkus5c6CgPUJAo^mc~4>U$LG|obIU1fVvEw7xqcd|HnGQDih@W` zqyH2Q({Na`8BA;P4?8T|<40KSQ4>V3{1Z5yN1QYPbDNEP4xI4Z4%SIUpaCW>REA%j z*74Tb{P>uIo^h3*3D+?jK6|zjWCM~iTTT8Fq9BH*Z9A*qFUO|q_+ot$JE;S+Bw+79 z|JZ8hDVkrC5I-FLag9Od>Y8L_N;iUJ#6&5j2PH9fDT`W^H!-&+%g!?1bz}?HiiHU9 z{R>%hG55a*Q%@0MI!odR{~UbxvZ|Qq^$;GNPbKjXhQ*k>{`Al?DAB@30w|t5usoa_ zxH*kq)fPORJdFf}YA%LfD=9EgJxzvq>8s~4?*m+9%(4pGZsIu_M>A&iHhuqXJ0Wa_ zz~s%wJ)Cx1jftQ8Peq0Nc~zUwiS>gWLPq!9P z${=mBs&xl)T57ql?`N0vV}IO!G?Pm2H*;!3K5<_8U>s*Hu%>&F*Q(S9hUF|qoKCrk z2ZvyZ2y(EmwR~k~;~|j^<+2rA^_bdyshsK<-UyzY{$mBX-L>%Qm&kZ0UNa>yIO4^# z%3nha3oHw3P=fJIWUm0h90D%3Y_ZooQ)Y$j?QJw4_UQX>DsV{7*n`kNJb8pyIb;BM z5CsqsZc8%`tPUh-Jfto)DJ5xn>k$dc;u%YaLQGtHg893J0m~r12~~bsrohRNCNA0M z%$TJ7T!_R39gbKs(7XHq?%$ZP*mWGw`^bQUbI+TB#C59|)2t8}5r+(FTZLx9#pi`n zr3mT;t941aUwI8N$_IGtiCB2xPJldolN5)Q^EOG(h*yk^O-iye#ZL($X7}_7I zrR0^IKD~^}Xu5^O_21YFg$$_mfw2w2C13v@Xd(&qxZF7cCy2n!O9s`4gts+^JaD}; z(Z&iBW7!27*4G=P*8SdXzQ5bs61!^96%$dWU89u@iTlu*%hQieka_|t|JJg;0dDOa<$5tT^+flD-h7yXZVvR`nIru;gZI#Kr%88f8#_1teH|m zl{N_pO9UI{tbLC$bJGqhsPCLmkd*9!De=v0JL$ZVYtd5ZF!>@vBT^m3)GYsS>0F#; zBSTm&h!zeS@-BA_TU-Pk^gYc_{m>~X_pxI#YS4Tyrg z&j`;$J#}oFuE60{Ll>9|aeH4_lh$VLD^a~Z zI*F#k4BxQGeG7gHwt6Lz5^5vZgFyH_z$g(J68g2^j_m@g2h$p|_WrOzcb=0q zui1jBXtVa{$=cO}nNw2vlWurnLg5z3i+T$)SHRDMCBwuuCt`7(ms_7@REn?AJZrc> zV36{+Pb-1EAG5tidqY|e-0L3j%3tA1hgtj$maj&*{k68Y;${;AcWsiEqH5FH{Stb&E_5++`4m$?&=7UK`sCnTi zx+&`FKZ;64by-5Q{$35A$VTMrAR2eoQ}5EVK~P99o(j;gu=hC~m6rsE6~CoG!O zdP_%-%O&}J+9rSYP`LHTmTrgYv`9n3TqiA=>2`3* z1wJCw1wk~^-;Xl)sB09sD&4NjTXW4qC4g7CqnV>XTr+0%t^S*t|MaR9!q-=FgE6rk ztAdH4{LCplY30!p00|(@jl6|NXF!X&Jv6@hH|g!-gjERgba7G%3G3m;Z9pDi+ zb%bBcj&-Mn%{lg^jBwT7cWEHyX}eI=PC*t`sVQbniL-$lO>9?$&SjOL|FZ2$@cP>J z`833USC(;2A@;j*qzvH_khJa!&|hyrMO0OL7!Zo~j3@brHWMT6D56`_m(~V8Vkg~s z#qZxuZrN=4)@IGW{Hg2t#y(?eqZD51lMF!O~H8 zh}b*BucF~4e#hO}4CIPUPyc(bboAY9wTUz#$|AmW2$m!y%gR`!jwkgb$DJwywk7Jn zn}W?G`Bz-8fHK5uj%J###xD6#fc*si#D^aNCb|~=+>?;@vQ8$NtQ`cEjV+Ac_$p3s zWAj+hCeT<#uSsfgz53FYyrqqVueE_`M}a6!dm97s02P+c5qWKG7Lvxa3!K4mk2}{aIf6C}Ti1jMz3d z3$S8Qwl0vvJoZgb9Mhi9JoA1wxl5$P4>aOgAgP6pXsHKu(9VvQT4kFKd292Qit{%w(tk~|s0m}1$w*-<<#{0s#KX2-ApLuT~p&=yZt2Bck zlq&ru^1MSrSb#_aEZ%pdi%`>)UvGN=GFzxwZOi>n86Rl!yEK?zuiErvVvIPG1gp<> z)x?FbCj)v=khd5-|F-mWqG};{2Gd26AI&* z2DCMOs6tOO)M8NOvWgL_%8+5>UJbTtHieHQFS1t(Eg#`OZJWKfw$`rQgSUzzGV+=V zP%ol7tcb*LSH~cn+v$(kcjjjOjbmj0(tB3vldV%Xo!{7p^qH@CJObYcw;|^Dc@6hf z{I6vUUyaY^*ayFSg1QpfsB zHqg6jH#CAV=O34F1i6D}^I{}6CiZHz#^UueKE+OgCJ{>8+1(J!@D#pvd9MUu$rwgF zotXQ31QOj;!!OUF4aQ(wUm)K7Sn69$EMl(2-9HNn+2t&6Je$ngkTRUIdXLT{xQbO} zyRUA`4;ab7@Q)4jO}JT0ywJItOKK!4sgdt5T;SjrR%J8de_RniL;b92^{c1Mc+uqj z2@K}9SZLs%nOM!V+`S^cBdPUq8A7_MmAZ(;IunkT6S6-+5iWL+S<_;v=IEQ}*Bi5$ zWj=_Q8)JO-ADX7Qo;S`j_3Q%+hiKK<+0TWae)M<`zkxt26L!lPB=+pIM&XXDFqu!; zd$fahL}&Cp`{6d17!k@*9x@L&N6+-oF3+)KT>&GPCBZm!izfz(` zN*n6MV;m)MUeXl}29yES0w;G_r|>Yna2X>qPB2JO4~XOl#m9$SnPfIh|5(IT^qS2u zhzHrjWwNUFg5^FK7i@$tT@XEq!U&w z)L=mOpkaD7OvVX{J}3VtP!=5s3f`fdGtNFV8%^T!cI(_Aw z!VB?A?HsSV%W6JND?oO2Xx$H1`P%*E2y8czLj1@X-SEEZ#Nkl zG8!&(PC>N}*8~p%vMv5P4F+t3I&hv-5l$Jgi->HC?JoMOx zN;DW?>>ao@4eAdfO%hdcS8(R?peD7hq1BNc1$AMt5K!}$e6RW-vP~XfhM(9`!$K+v zvJD6veIzv);H)3gv(+DkPo%g5h`1uE(VO3zM*6Kzg8|Owd(NED+9)ESgs60ShjtXy z7QKPBTt^CK!blOlxl*n5&!HU!)wPeln>n|~?+1ct#smV%nElJkMVoMYxHVLn2Oq%3a|A}MfGvS2ynU3I9BS9D?3LZl-MWe*>rg3r;i-o_eztANddq{1|xQMG^g^t2K z4F*DU`NndZ0@C^tdd{)nQFQBO!TP58_wRnoR!b@89CghsjX=%YQnL)mmFzu_g!cw_ z5G@@-3w)G?FU@M`z1jg3O{N(JCX224Vtt68_EPGphUI5G=Tz;m`t2S{IEm^6l&76L`~is%3w1I57|g(=faCcPUvtxxkvO)R;&f!XVL z#p&^Y5}Fu_>+yH>i~~N6=OpNK^|(bCb;Y0w;N%f@^j{4o1XOgaXv3-I)j77KFqP8T z^Gn8;(bQA%B0>Ag-?eV`HJq&}XLLI~nj7tne9nD1k-;XUHefAjAk#0es@1bL_-Tng z@?d~cnW=t#oDN>OGhZZqroaHa;W>8}NojL^jPdEq-V)39!LSlb1E+ZCH1)GBgUrC- z1+lJ8I^9H|*oGqJGZ7etYYw~3Q7hV~1qLR26Yzlcgsaaa#2&AC=*bI?eJ?jMlK69Y z`ZnHRHgtDMB8cP>`T>;!L87_mo1qY%=oZnmE@0&no;$dsFfIKQuAG7;j!qAvEl=3Z zJ7;IsVzziS|u9J@YT6My0bW+DT*U#Ig!a*uy#&#Yba(9!SY3FFqkq6llI;fbD2g> zk@-9=dL!9Iju_K#5vYJZj*n?+Fi_24EtGiegTD7%T=>5d&*=j+ky8XC&q2;a_XywX z{s!vCw`wq$Is?Ko3nU#Wm2~Ju>h#%F>4H=G+(3bb%?4PH@!p`pVCw9EP-kyDY%)A9 zDN#S0+l zmPWybK)|X97Sfmon;2RGP16VaLIXA$NFz-XNxW1{6Z;~m60J6JvHDOS8k^emp-D?g zg*L5;8cl1WY15`@%FMvR!p`o@w{tn?oAY}yW?6P-zr)P=&VSDTe6jWSpFC=JsV&2m zxT7GF#o#*N-2vvibD)fb*I=mP`OANOaYz=v>X2UyGFUOH7X;I9JyEFmEQOiA%P!h7rGwPGZaS)Rk z!F&i`6N%xtuS#FMsx|v_r*3@xx^+UIZ2eeUg*OUv!PK`GuTysHdN&J7^u}zsXV5(J-S?}%{O_yZZ8szaPQCW|{y-(> zCV8)T4r35Ru5mF3MQP^wv++UT&{3T;Z~W&u-XPH@u72LTOG zs!vFVF@kNc7?TmfI0!EWCqZvB;A&9yH_76m0ajFY6* z(9T6_ejEwuHyo34{N`Z$eb1qHRks{ZcOmpZoR^b%$V!EEHd7(ql-v824#}PT>0Q$u zi+te?By3X@3kmo7SV-q1_pbSCY}drmHm}b{4fpgPc@FtFs=Z=nJPR2YBni5DkL;*6 zHqGlH*n;7?BG0g?n=Kd!9eT|Fj?56@p{`MGZPez2wMdaL~J z1W&5p{f|YHgN#B=PUfKijs$(bcFtt+c%#PoJ)^A)t^zxUJmpX2-qS6=>UVap{#$xu z1Dd^J*vfEbAb=$3&iPCG-g`a4`$Rk~3$3)qs_U!bcD0f3|8$@mlQD^SQssmc3_j1c4?wnFmM` zbVculS(79`4oTbgEHcw-?riEiFzRyysTfntd-b#;%X`JUM==CJWRZ)RM${%i_2sG| z$y)Ey((Ispcu^FL_{|`W$ko7u+MgzTB6%|Io5m0Y`H9R_;xhrA>;>hvaChKb%jnIy zbg!~UG1l8tJGVhNtzweXt6WdcY3)7h#j;n_D<|^+NP-^l`J0#WzoXZtW($RFo^ns; zWY3OUk9$+M-b_LUsh>s{He1=ej#&s43A(;+ z=*Pi<=J$QC3Xipy{HssT`*k-o2A;8eTlyi;L9lF9G_w|15_Hw{gW2H=ySjRG4f64{ z99$4V!-H?A7m5S+%0Q?bhbkuvAVHT`o}JkM9&gnDP|#$*&jgnN)hN2k`wveC*qGEpHM=T|W44h9y2VKsod>4owiz`l#uaixy03o} zU?e1zx|y96qzDrTFY!x*1zJUgKg20qnAgk@Q4{6tFIv z_(;iPh!IMHwhsc}1zLR>dPES0c<&$tG>L3>dQLGjbj3mND{OjjP$hxCPAmr>S`pwm_z|mgtf`E!dh6J z#DvC`LG|UJq-HVUf#b3X6w`byfz_8ck_4>|QaPCq#}r*fPT!5j%m&h&?F}tQD4SB=rNt-WJ5qL zL8s=?0vZKcmratB4F#tJ9Yb=m;VA+>2|7QAmd$vOxonE$YY7WPgC19qoNQu!8OfkW z0evlDfkJ{NIoW)`4|*gy*&09(dKB8%5?G1=SAr%v*-BhRAnVJ8)QDs;00%uf#Mcs7 zeHoa`rh|Mffz_8GxooCWBa&@^aoJ2EIoVb~NYIY-wFH(TY_MB`j>({;078A)UYE@h zl9Pd8qXbQIG9+vo^hk0tFl=$zBsm!#mb+|{uO&<@b=eemOd@_P8}t}PjYyzV1Z!M2 z$=4EmieP?=6Zu+Vz+{(Al9Q2OrUXrLG9pZqph-@~bwP+Q!)23vE%9Nv%O=UmIIjqX zx@?lKC0fE)8YV%PP$Lpz4073|MkMSQ;Ic`+mI4s61Wk=dVi1x9O>(k0a7)nSYbh37 zE}P_QDPD@8UxFq%SwwWYY?7~~sI1d2L6fhgz-V>Zq%nztqse8H#w3bQ&=#j`l9L@l zKna@0BsypFsOqvwa?&K9o3%y&0000IelnaRgW#SP&2p1W5@IB@hrW!1t#C4gM{mH`&Gj0Rab5kWmp8x0j*iQ=sLQqv2Pi z<&*!OQ}d{PW7ygC{v-eY2F-tI|F49GPvLv~&oA$PO?bb}|FZ%u|NqGUAK-t%G`tGm z;~Vq;t7!k*{9E{~{oggezP|3WQR(;<==tUEvQX&-6nSO!HWGdah)aEbeliKG@QO(v zot`rYD)$aeu!yL#3(GJG$f+1QunNiD-rXld3ytXB)W91c^AS)-vB_i!+z-eIX z9h+XbwX@&qNBT=l{W25%Fa?WW9;hTQ;%US_9YHW2PFU+j`Skoe5=x}2Dv(=RdwF#O zR1-K)N9UB%K1;{omev`Xn30qb@9-x*zr2=EH**V$OS5M%(d6?9PcnA!(=vB0cB3)V z;?+_S>>eDOnO`n-qmHp=GSc8*iNy&vXWczG%5|nq$Sf|XXt34gW)zTX@FCYw7P4>+ zs&49B-T2$tKPoLF#v&v)6NN9TYGUgZR$9|CF*6@#!IE8E;~$wKtz{viVtk#6-XBbS znubyBN!8LdAf#l}(mhz&(5`3Yp>N|AWyS0g5Y50ZpORZVGdwZ-@c7h1n>X8uF0-g=FBwZl$Li|(c5rN3MNy=#wVPK?PfS|e-aBGD z5nB;xcaed<9*@H!DA(3AJiokteS5dFcUWBAJoe3Rb>r^-VSIW{L0(i|UUVpgxWb)E z$I@L=T3pdIV*b0_nVps7ltG^0Fp*!OK*2w+&)5!e$%vNgQ=MjWHh5@8i-hhZl!Gd# zBCYip<96D5H03;e2aL=<3x+yDK!`vjMFdsc*DrK^6wr@|ps?u^#cx zfyo?m*XwvF`~-O}D;}Ghjn-dr z?#GdJw1BNUsG+D2B&0UhPx){iCM9Gms1 z-uDMAItuP_e>+o1$y5R!?KUhi7yLS`T`$2vaxCUUV@=ct+i`}Z2+q4hk3>QHDJqCPxNYcJ3c93sIm9P06jMpAQ12Uud2 z#3aGMQff*CS-DgSL1AA`bd4^w1V~DUd4l^^agse`DAeXs`@0rWxShrdVnZY33Xn9} z8sr|l1o&?ZsZ%!-7z(2OnhG!FYA1FAQhff>NFj#^lt7>w5^++JiRA1#v4{ehQ#S>k zB4m8N>NsB5w~H7g{!^ucL;`ZDs(TRhS+M`fj|f%2iE=~MaEfBMA#GeJl?upt8gVBm zeb#`{shkMEKp-NbP?pFm3KW^#T@aYkf8y|KI1_sq_1g>){k8=HCexPk$O;CPbtGed zD+(p+o99WP$zYS~Dyiiq-Q01sz#6yx7q9I~_3PXI7Hw z5D4^H+stDRlm8u@yJXI7)DY*;?|fX+=j+L(rsxA;v>*_C=wOoa2TYvUC|B_UoZ;-( z&;tW~;1X&!)!F{@{Ll;*PX;0eb_5-)Lfv-8F<~~Ph8L9sX z443m7>F`P-BaD_AnHJ+(ZZ>n(s zK8z>d_{4xeLYgejH+47^Y)Xg1|FD{+7Yxd-MmA5)7nD;&UhK54h2qqdoLxI{pc`tSk;CDs@JEzFUCvXnaB3##s z^N}YuHQX~GN#bb)lNcz}OH#al110c*fzVYE-~RT<7Mk2lAO!hW&qL872k@lH?j0WN zu>i~twtt%u_sOI~^u##pOW#8V!IfT|!XpP1i^ZWgOIo9mf9<#{Y9-!yvMvmQph#Fe zNC*=vy;huB$hW(+tOgeaZ)d=X$ZL~;i>!(SLdb^H9jfx2mc;t4S3^OPJTRe<1aF!o zA#!q3U_pUHWv7J+EAt>pWk^tjs0EgetT=+mx9h&^`Py*1P1$G0bQ_*XWtZQ!RG*JJ z`2V(vIT_@sZ%hOtCP2u_XAMj7Y>8f7Z`cRVCXK@)3C*1(kZ^WjH|+$k4W;^aA7UE< zw4`TQTO?Us_am4&yAk ztQF6#-0{VN^^C=#rIV>n-wMd4$x?5Sx=POb_n9V>Jmr5EL5U6Od0AP<;G60FU+hWB zr~mu`_?r-#B!5@8Z1hL;ZA(S-?&cUES)Pq#?!-VO8&C|G0)(}IzUX7|J$szG~ zbR+g14lnbr73cC0ukYrC5xXhNw;{b?)2`LpFn@^cV+&!L;taJ>E)-~|HS?a8W=@FY z>}4v>Yrl;=ebJ`wFdq_Fe7>edQhI2fG<$Pb_Q6}9xG)ETj2n1|tE z_f+|_a;MR?YoC=m)%InO(F{I5<87`(vvbr@%WKFP19Zc7vec6*(s|IYI)Q^*X+0ZD=;`;AO4zfSiFsi_0Egy)kO8Rivudh2!UlYm3 zWW^qUI63Y%!&%~0f_1aQ87AC0%e#LZ1E(|hzexgO$ls!4M6r|R+E6$1H&8#lV;$RI z%2ZZP=Y^&C1MU>2FaWz>&Nl&@hkMJ@^OF$-#O^ZfD~3vY94pEW1BQ$Vy^s|6R~h~Q zOCa)}Uv8zQtxL;ph-EmNjMnNzUBgQS7=XM3b4E}Em40M`4bUJ~rLj0Dk1<;>bZ=El zmS^2bSpo2odjNv_W#88a|POkTgQsqV}q#HGym6&G-BSOx{lVjrf17)|8AOuamQ+qZE* zn_oY>rLAG2LfPz;N7!e3Q!fQcImuDz>ixa9~de99v$4x3_Q^zEGbZ^A$zsMxYj( zM>MZ{f<&y0+D-5<$2Ih~8v)aB1V{XBg~iP_^)n>rd-JSU`KrtDes_JMBre9BX)9)o zq+7`YL2UT}G^3`2pJN^|EM^f64Sd4huShG&8(C3E5FK2{t4Vl%a|~&XQF=<^qY2#4 z!BaB&0@*@0e~6x6|GP5`nQQO$t#C`^IR76e(WgDrTpq~ImzE$W{P_K%jjo%o6+2*Tq^?&Dh`)p zCo5y)tr8!9oJ_kz5Wr;}I3hrR@S-_h-=(V_1B*`F^V*ek{bAqtz;}9#kCl(>#+_aE z<`{9~+i^lraKo&K3Rsm18dSD1vRJFPYR$luXp|cE%R-BxoYJ5xt}5C z`&?g64AqA%XLYWn;_|Ct$xW-7{=0mKbD6Vha6_7WLiG9gaX%8y4pgLkh3gADe?*+$ z@z~}R690|S7s|P{l6mD`rmFW0KYC-V@V1=s48dh<^0vV)S|W^^&(g2AVo=0Ch*fUy zX}*s~G%sIugdY32eqWf+%j$kK|01M&_SG#nCO1R&-#v+)%by6Y9iPHbZOhYM>VcNX z#Q6a%wv@=UJuU}->Rwk5&0fyzA+F!H)Asn^>Y{^^ZxPc%C!tWe9YR=?^$3G4xJJSt z%}{0q@G?yxXn%L?ew_aJ9DC-q+xWUi>JZ&UlL=zi6Fy;o8Tne{e(ocWrSt!ie+yrg z5D}QAqy{S_LDf?5fbmsO6ww1qDTBOy6{ypC*n^@89|>1gR4F8)7H!}YEWzwiQaTS( zsoBoS*!oTWwrxE>HI_|CMBCLQdDLY#lkIdQQ+wtm@(w46?5m@dC7kou&+H^k%-1`B zCxj=lE0KvGP&-dsB#I$XoZ>P6FVT{s5L5AfM3KX&9>;>9RHU+dOwSW%?lWmRg7ac} z;l1>ut3xy_`+jWac${`s%+MEpbE)_^BDef=Gki8JiYtd1WrFo)k2N#{QJCPUyc^1q zf(!Q0%RX;Ir>Lm!0=V0tO1k`hoMwSZIS5iKj5&$otFN4re}NfA3{VgG43SFZV@@{a zsUQsxRcve~4LTCc5%9YYE`+?pg4{xig<0304gbfq12_JV&9LL{CFHW~p4#}2&wIXU z7(-Nv>#^umhnEva7TG8V3DL}2<&6o}K*XamQ8@^f!S_wZn%71X;%H1jK*00}w^mZ! zo+}Th9c@&VreOfTx1$Q>-iU}+)E0LIF@JC0WqfO4-_tQM5+oq%IzOxP3iQ|FK@gzT>WzpLo}wGB z|GkhOu+i_9wa+(HShq zBs9eg_f-@U5M+x<@^f~Hedd`Yly2@_%(B2hk=P-WDHF%>u4LUDbS-qqmqyVJK6SvG zetTEpEipCEveBs<6<~SI^SHRVwl}YYYamp(Dgwm#P_jpdj+-D0{DXn=iT~ zWv3uCcLE6&9g5X1CE8x@hKPZ*HG*5E0?3R7(H3YBGtrZ;LCAE{r|r@Ya208>-_Mo? zdm^d^dYq;}6#~CfK4co>| zh`xs32g}e|GkN7^l@^A10_%scaFL=iPdkl3e*SjvibQQKT@LkD-$yaU5OF9BGgc)_ z_@_~t<86>vOohot%I2_n{Fb9?pm1JzHYJzqUQq#q8Fao$7ix9=?2Zv+h#tIUuY6Aj z@48yBBaTxv1b?SjDsjeqPQtV=d?5@Ks4DIEiXNmtQ1srjUX{q;fZDsny1NKaD`SIh zLKW|h1f8g+@GW!Uv&{zMu5I(OsjI9e5f-dckRqAZ!?!}~f?YoUS}McCBlPuAc*Nd1 zPJFH_guw*A==3q+^Og!}|4)gvge-61= z=zJfF2snq|{>C0KL<`Nf$GA}a%4XMeeupi|#clL-!vt zvxG{0xp?E<4Z`1cj_2+)oIQtwr?d#b5c$l6$c>lWQ}8XP0mOL+gRa*CQF%$9i z!<{M>n#_E2ZM1RtnBd494>vD6M^ZBgQO$+UY~|n+XRCs7(=OFU`z9ewQZ*7Utg<@W zlFwoW8YT)65AY{JzGML?oJbDN^+Vcf&cgiXKVXuKd9k*!u{g+aM_}}(C@txB;2=@ekN#TG*v(`N0{(Y=HIL(%T&$RrH zkB>!|SYM(n4_S%7F=2vReuYI;HnZpm#<>fRY_@ISX;vkY`tbQ&?(8s&pw5)?DMS4M z8*+*)J9r8xr|G%Rvr9j$640R_UkzsqCGg#`@7LWKw0lF+Q3gFzGJ-p1JS~w*B?3OmPJgRY;mp!PcG2{y=d^}jyLs}E`A^rR9NNP{) zB?AWD(AA?54*JUr&!8_3G|;`60U)&)aJ#))gc{@uYfJg#w+v0YB-DxrTsbhJNbCoE zwpD}mcrvtB47`ulr>wgFel8qA@UMq+eCy0oX~MfqmxK*#Y@PqC`%w!Y)cUxo6N^m4 zL|{3K0q)@+m%7fQo7!I8Yh7%se}f04PYBN9iu>Ga02 zJH>LbeMN#j+@TN>jB{;AGur=Q%bsGOaGhBy`1^;FOs64H9ijqVklb(VgM}(B6JAP) zs&k>;JJcCtj?htK5GPKo1q1r?rb%{ZBygzDoeJI*E?Nd1fELMQ-=`hL z46g*^R>4ul0BAfT0&KgM94Ug5bE0aS%m`WOWdw)x4G^9St8gTTFr|;2>5`fjFFpI?u&y!lY!J}Ep6)fg1{W`Bf z>HbZqVpt#A@-LoaR!y1530 zeBb8{flL%t1}}xsvvz5meS{Qma&O&V8^gU}@ zjvln+`a@(6j#l%84z9p=M#Yury~3&7F1iNyY5;WeTwtUnjU*aP=PVp(+&Y1TSCIR_ z$zg(SDvny5PJ-oMlv)%EcoUF`QwRd>9>vU?7Qxmx@C5q%fU`lt=RZv8;9dcl%%O;j zcU<81mQMpfHTGO~;^He=IYdFMM6&4px7ka?&_u{jA>jl2L$hQ3dZUXQl8D5Hu`VH; zBjWT7vE%J=30NlK`@bS*p}^aH9?s6p7VO`zq%px?Sal7>=;fK(XJ{cS1h-w=$%$HV z>A~96JcM!ck1z7-sKDSZ#Ujc&j|LDjd{u%#Lr0p{#PQ`%A-i+m5PX5CnY9TXw15M6 zPl`JmPoTj3R8LLK$u%nXxzMzVA-Q=!5tvG0v&BXd_g&{6y2%e&Q|u(lmfZ(@>q*5B z&{UoFD$m{d(`(H7l2w-*k}GpR)7Gs|oOFEM1#;{fF7%Z-heMkp`c}|owUk!Z?yk^B zoR!~G<=0xi=%A;_jpZ2 zDYiV$Wu?t@+U?-CtyvZvt#6)Pt(=_X7+)2Zde(!<9R%||LT;qK4@d7`yC z{h+$pLiaid727WH)&?mmB?Zu}{dE2AK+q?hV&>HB;ssTQLs7wgE>?2Sk(lSZq|6)D zPrWBZKt1!a@8gPYNtl!H1aHQySu|=J36+^yya@^9$9o|Zzut{M-R_Yx!E{HZ0%-~e#`tQ|#(>txP<0(6i=7y@FdOJGdV7$Nwog`3 z)tK93@}RLj8op_@R(MU0=(G4Lxq2ALx!qxOKSC?v}}Zw z>B(g`N>04k?tJ_+%OSz7y)TIfSz0hrspDzU2F-N#?RC>6aUh6VR*0&YJM@$RdF1fS z#CAuo67vO{v_hBtRbhznv(h~|C5WwCDDT2oQhEE9nWgZ2ir70iH*E6>I1i?N51;l4 z#gRO8k}?5>3~lPldx>KyAN~K@fUWhS+J>qIj8No83@99-?e0p)D2PPlhR4VNFe0nU zpQ01&PSy?(=tAAjvi|}4XB5s6-HkR-gIgug-lDcqikTx z9xrqILm2fPHc@PA?EKjiHm-nXa?~YJ4kgH*8)P>Pla8q{%)_98EL#1pNuQtmjSA&> z?(dhxHaV(60f@5QKO0U)qmy-Rw`PBv>=S)O0!cx{aVq1ekXb=;uQ>*8Y7n;3&z2J& zOe5vJiZ*0_-3PVKRu1Ho)OW}H*myHC{}H8p%bMc7ZGK^Pru%R~FSPGk1IKsU43pnb z7LwcWwmzDV0}o8f3mzX}z>b#%;c`BrPnauj0$;AMk;vlsml>iG_HImYb+S7G4MowM zqJ{uSOJ)p_Gt>i5t?W<_xg_e9j)s|~9~*q51;0X&W;2(r!Gs5bFPP_J zslwcQ)EWudeD2peAnT7F(O}oL*MQQrG9LU1qpLK?YAI2J1B8ig@?0dkw$x#9L7R#w z?a&i4Z)9S;Ll_&-Ch}9pveS0D^Wd~l3#S8 zzexUqp@%p8NSJ?35OGxlSE)K7_Gu>f^wfJ$MS7<}S7CkL_qOR#^#@(y?P(BmqXgHH zoWC9v1k=x$)O7_j1Mhokr2^r*pNj7P_}=Ne(6^pWQSyMJKS#NQ7ued2%+cH!^o*g2 zIu3A1g70*)pv_E|}J!uBT8PCIdvB~IqyLs-Q;q7>j<#R64>1O)Ur=*O9;Igm& zpM%7ZfZK^hv%+!9P8CS)(AtPIB02Q=i%(Bn$DIgmj3`kTEiB70SiH@X+h-`QumL=( zPh2yTJ;O`X_4N~9y=y3Zi82g;-s!Y%5clzEj^$~}8XxFg+@YxBzjzim6<+mpYP{py zQfz!Xa`U3*0`DdDa`k(zI3*9);q#iEZClS1`^%|mvCaA)nw@s_(~^&s**GKf5-@+k zq?pI^xoB~nYf?ei=jpY*)G^);WaQnrLAYb^{KA`O3T_erLnxB(m zKdg_rw%tCxGV$fd!6N5T#?9s&9Ez|uBERK^v%=Z2&d>s5 z(f;t{@$~g=-pj~yaDNa0oK&B#U+e{$R{Yhpz_6-+|b{`rMBEVxs23@+FxR7@e1$ za;-j;9m-*Cd+`T=H?+t+=O_v~Iwa3$jiG}`?!vI5B+;g-xDd!3vG>*v<8mEi1q(iW zpEO*<2+|DT`fYzo_fv{YJzObpPQ ziiHmmnF)-l?l_bGywB+ky4`JxrYMtxTpR?d*16gvwo+mRv%w?hxw2ACxqGXRO=%f{ zxJ|Y&c#gQ5J|6A`gPdi#VfYV-kRX#=M$TuI{R8Rs4YIcng0sNx&R_EX*`r&0QL1Ak zOTv4CzK;$z33j;G85Xj%Xu?=v3x&!lrAmZIr)uaI=72oUnEuQ)ZPl8uZ4VL8rT>Ro zoeNMEA64Np_S5|WOv7o3_Kq^~AVwaHjKMbE%-Q_V-hZ@*3Y&>B3g}OxQWDqS9Xc9? zKvpvhq%6RR`-9Lpl*L52e5k6Z7hZH%oH92ZzCW@(taVq&V0Thz+{BDDe!L+J3g|1D zt<+D^&LVKPhrCQ}C#A|QJ!*TkZ^)7$KBkOnLsF7s1pZCB+hGl;EXo;N$AtL^Y0D^p z2S?{}r=#09uLSSU$Qzt z2KX$kP9@yAKT}Hg&67^8w!NWe6tq+Baon7l)(UB8l;HY_#kgQ(u8#HwP=9`cLT8OTVHiO1C+ z61eu86*t~a#7SBz>>PhA!OY1{{|9d{GK9;2G0H<$DzNhc}=n;U%g%+ zW;-`F#vq=UR>dN}^^ze$L@0%B{p)62Cv3N2I@oiECg=gnImc4R%v8?!f*U-b_;jyK z75myna7-#)Kn3M?Dro5x$l23RleT+@Phk~aTk(1IK-t<2`SkY321XZ~$YorH(y*C( z9ga#bGrK@{WPm;1+A@k{9Cw(N8V(%%EYpinfO zZjHGy=V&9Q8O5Z-T2H8r)I+?Vv5Gl;ebOhsQ#C$Vvmq7CS&DF^f~#nijOGP12Sr_8 z-ndFCs!n#jc9PJgwdwsj;`j^h`zC|K9K#1m>v#Hv$x5radE)8>jM11mXoZZc2nGVU zR-`$lFAgD~=)|xtJ|;}z>=IH!j4q-Gu5f~Js%v$TRMy9Rq2@ReF<_n%iDOVd(%8xL zrkl?efrCWgpSQ;A`J;mq1XMJ&DM&YIT|+)YdqeF!LH#Swa!G0KMrBj?7i+;ov6pU-b8>ls@)Bx20{F z6(y;Z9uO2i&`v0-L+ysczO8UAAF46NQB^z~1-949a8_U1yT@qw(aXCh5gCIt0LE|z zjMW<-#YMB-hus^!@z%xQOvog+udw<^&kS zX(b7EZ|Or1%+uI4&=-}en{va;&6io*56J;v7`#?KmxohApY3q|kfN|kOB%0GtBKUA z<Pv{{x%yc!YT%2Ym zf-{VdrZY%&MyH>pH=Iq=GrBpCySo3rk)i3)(X?G3i@5t4k%t_sY5817%La@r9|u4O zwG>AR*{clm@CptJTq=1t{H`>td_w`a?XFIRASMQOfrKaDEbYzLMB0_HRTR!Mu)Er1 zKs@ishJmU?bhOPre@SS`P)wpwyV5vQuKxrLZ+LQP{^xB(TWs+s6hHv~*#Vub<0{qo z2Lc6yj9Yj5@{|OTik#NwkxzZ3iDB2V-pj0i0GRZ3PGtd!&rCn!D%nW0yxknZjkwGN zk_jLs!7(1`-S%Qb)&BUy4~78nf_9|X{(;`xm=tycFCj&?FPFyUz;t=OSH@YDTdq8L zTzOBKn&^wI!N|CI(>4yS#z)#Fq+V*a3X58d71@w3PSQ}G#B`lu;QOl$Pes{Ua=Fpl zqB)pnXi`!i0v*0}z>MH=PegZ@@7DHM=-r3IX*>e80#c1y51t@0BhlPvh|C%Vw!5O4 z)Cl67G3(F{&(g&OZE$HpqS8lRV1NknD&(5dZbdRX0cR9DOsjxJVHQh~wZ}!lV&4Pr z4iz^V6?BvafRYi?l&6_WS5&-!mB`hS;L{6g3m0&Rn_szZIfCA;JimF9(6PcJ!P}8! zX7!+CQc@p&=510>9m_-rWADMxV1yPGhGpyd)nPPs`U=<9 zsu*ir1)eyMZmm|QOtBDN`P;SRY`jCLc3{C?)LrGajtIXnkR4xrlKLmK~h2h;~{||rh_Qik(6^TTTade21JlP zQNe+_{_%X+TQtt!i7+M?wU8NE6ItQGP}tmm0AwmhVwIcM4+Ew^-arXDy_3@El=_tq z4BK=)J7~>$nQtY6U( zW617|JIs=6W{3n^-M-ELUM7rq12w~n2GasN${TZ}#T_qKDnwrzaET?j49kY&+%3rNa#0iz`fi2{czZPQOczbH~uk~9}xICYOc>u+cP165deJR>jj{}== zjpBAk+n~^4MskdoNVprLKjV_Fa0j+a8&n@?^P7=ixx8OXY2cwsDiS;jI^+0$_*NMd z7TolZl;GqYZK4gg>YxV1z1y_fF~(UJZ71%SwUxCrjH+v`EJUT}(V(52s@Jw3$EaH{ zDBz7vt2bJ~ukmiI{rHaa)MO#wKtXf2Et2}?dFZDN>3hM)jRpS#aL1r#)`I{E!>?$o zn;@P~(3Qa=$H>&+{*A_w_q>R6qWN=bkbQ3dS==hk7mw-Y+Jdpnz~$DfX6b z#V0$S?Ps}u2b5FziRwJ<&9K_rYN&=VF1?p~`2z#=Y~_g5*T5l=Umo<8s1hz%^?rw` zwbdaJqhr1oErL1T*VU>~!vlju`7RB|N(Jk8+0Pc#G0dDMZcXpc;I93yT^aBNkk$2D)-iS8?ilV$)DdlWY+y(GKSNVUBwI*^h`uw3{xamf z2YKDFzh+&jRpe&%5{v?wgZJ}?m`Ah-u4russM*b4ev0@~T~fB>n!J z?EJicmyNxQM$$JP$WW%{@6p{Ex2&h%wZEdFKZaK`n3_kq(W}D>2HnE};F4Vk1~(CX zb&)Q2%2caH_^u#Q?b{N~-Vc#x{>WmX7}E4VZ2cx1Znu|!L>9D*laYTmGWJ&f!d|(J z$KzejxDj#1wfDL?dBx|3!RBUEbNHGY49>GuHc}e(CBIG}9l5t}uwqMWm|p$b3eUs8 z?s(p6(C62?x)+6GEU4)R)T+~HiQ=^L1|HsH{f>pZbe#DRJ)Ci2wf%ES<2|!gZAo5F z2MaGW#=BbC+x8^GVbUs7my)A?_JHkj>hiSR0Vs2+&0TipK~u5qWb~@?{`D2%nHd*q z=>c9C`*>DlaA7+ZBc(SN|lj#Tt#VOD7*T1s|;h>AQL*|{KfUyQ7HsxB<=`sUDB|Jj{3 zZIPNbDkF5qS%`uZy<&{^bo~lNZH$`ovM!#sAYF5Z%~zPZ2Xc6yD_RAQ>xiWUj#=Hi?&W87%Y_^&DpvH`#UY_{}G*j}36qP8tlbI~mG)yT@a)_u5crSU93hOy^%*Le&gji+93){)f>nlnw?v zzo54UR(_HJl;~%Sd${x-`7R_sIdTJ~76MP`S_J;kbKLcB({1c;{sK)B^fWvczZIUL znG{aW!D1wC$ZO#IFAr|1OHnQ9NvM?+4t4LyRK-MKSGb)#(N^we{p{w^dKQUeC3O96aPc;Y- zLdEXUPbq_vo=?zN;#5kkOriyZD-EcD_pP#ewOJ5#X7P=tV~N2SRvPjBQW^O^ zn9@Nf^5dhJIWrItG6FAq8Vko?dpM9f*f8f1Q8zlm=Zp)xQ^YtijE{)ASBh}p-|fs1 zCoJ!nBw7n6KcM;)qr<8&r~e+L z(IWsRFJVZm#}!>?^N--++&Rk{Vni_nZG}Tsh)}_io(}}071Po3z)q(>2E~izg zP11vPdU_KW9LHdaLE{8KCF>Azd%ALl%e{Z7oog+fXjMQ1LWi1rd{Iz->gdh>pw5@% z%ykUw+@n%hx!U)UG};Zcgosgr04HVkjf-uaJ5S{hS&t|aLG0Gp-!IHjTTJ#2PUhe! zAL!3}qPM*35OA|k-QXZ-<#J+l<#V;Tppq&si5*h>LHr#mb7BS6bS>RXx~70qbGy%2 z4G6KKaQC+L<3*W@I}AJh`Q|wDR*3S9&ONu?u;n_XDd^5$C>@@&vIMp9%Bh*ze}oPv zqsLF6<$QmoefFY4Cq0T;fQRJSmQ!xEmoo}%&fpLJAvcB|o7>wJ{H?PDB96Q?)3P<# zp#FH}i7`s3>p}5+()brqAkCfL0j-9bE0Pl3sq*{IV2f*xLgbpTBIekH0zotG3Z&VQ zn!z{;Z-UR-wU!^KIk%lqwEyZy6-HdZBJsYX?K`P{RP6qio^A39>&af!Ukt~7-%F)#(-rK6l?O! z?Gn0c{Akyf^0K2^?`lHrqaT;OY{1{z%L1)QW3`-KZqLt&-cZX7_mujwTQpC$4m?hA zFg<1)GP7_OXSU7_f|%L**OT_azYiH6a}O3FQvvV8K`&j_)A(g$u-Mu&PgS$bg#=(zQ-Q9 zEG)-&*;CUQK^8N|Z5f=g_u2P+f9}0)ub=7D z=_-fTMJsv`QWbjzBXYfEMRy0K9=hOl1>sib&)GCH8`9!^B?rh6U! zidZ7fC050t-%fZ3(?y!Iap9rbD(tpTFmMsY2Rf!Da$Q!Xo(+Y#fS+@(u`PrjM#Jyy zASxF8d3&G8;SrpU&6AM8K_?`jzZVyIiXhp!yfywAM(n5Gc~z-Q-Dk!c5M(a$3*` zevDK}6`N58>S<2h-EVung|l59M=*n+I6v)tDoIRpsrVpH(oOU@WK*PYrXOVR3s%YM znZuYX;I{`8HGDAqtk~xMmal4fYpP}Q(Ovv_p%pP-LJ^)+6lgD)Y34sZBRk4DcEmZu zAZ?KxSa9MfOzJZs%{+(zxB0J=RmUO5DL3O}n*3u8GB-X(LAgbMaAl!h#iEppz6v{=m2vf67 zFmFRa%0UbvtUf6V37NHZqGK|dJuUv`S2qdoA?BaYNrwdF^J36mY2!*GPt+K7FLd&y zsAi^5#SnudcSPOd8)vkJf0*`h)VKi^p7B2JV_<)eMMI9#J^x1h+T& zzeJ!+qd(IE1!blVK0b%~g4Nv^sQ%G)iqgI+Atlu(y%6$;X-o#~!8z`cy}RB0fCLxI z62>GZ@K#v7!!M*g7GZn|QH|eKT_?h3;~bZ_&6g(+#|eu0B0R(hUv1-KeXJoB0@I|= zWN&m#*5LJjJ(0u;1nmgO^89nM5pfN+qWUz1bA{{Po2BQ4ZJUs%pq-u}h5ekG(SsnR zt-9zf*fr^*ANF^Di6xJ9s(^9!_n6vVw_nSjEZ_8J{bO*s;0#gA?VUd<0^w07CtgrI z8g=)X31Ku9T0y)IJHjy#sM%~xIHueP=sE-rC87n%wfxP|wbE{Tve6c;?pq4FuX_Z# z1)*(R=k&yt;av@}M9~+GP=(eRM_qo(GJ@m&-vtOC#auv)@@FhR?ZF=0x zdn0LdLSIe{y_fXFt=V=+@dc|-#MWQ!`7QBz5NH<3ei?c5GS1@fG`s3{D!8O*H)(p? ze#A;9D8bWN)tddi1qRy9$y>1LZ5X{Rd9jjT4AxgAGE%l=#3C)qgh>itHzVHWb+a75 zRh7$g>%sygh>KRU{vB51Tco~jx$GlJZErq}zFD2R8H{y)tp^{)JU|g@Hgo@rWmwMG zNsx0jZZ;=&6h0lH<@Emj=lEtpFK?y==r07iNoBwA)SWBuv&DT5Ng}0dnlWtZ+HJf$It*V>M^40}t2`fUwZa#`ik~ZwkR66^+l9 z$g1AO>MEmSV0;OhAT!8EE-Cl{2|G*VC;d0Y!4vyZu~lr}kx?MS$g7Zy@He z&+7<>+xnH#fnw{}+7q~~8#1`}{|O`!+wP%a(*mG7emLOZYOp8zG^x?JA`D_cr{^3y zrop$d6b&6>r=-#_6gsObgdw>5wv zz0ow~E~jf_t~I%GBjt8n%hrX8+_my#Y=<@31L7l_G|p!Vz(Du6JtC{{p@lZ0iGSfh z6qAn5CuC2V&F)`rc`adVZdKr}!QN?iq9Tj=^=S#p5H14)BuC^Ww=n;wC|MO?`ddcg z4~o>t(T22mjDsZ3OS-MXfHJ^Z;1(e36h5XGE_Fc033{p017bAN;p0QD%qSbCKVRiC zdbu(T>OuDKqO7jH5V;bX!DbkwD$vf_jMd_KDv2D+bzlG+G~7u!oYe*yabBNq`z;3jJ3TJO6?d&3zoj*kRSWDCE32? zWJMD6cn>LBqr$*yu$OyWMj#zZ>(FI?Y<_(BQoeZQCAUslztL_Q0YA8@G2va zPFS@?g#q1zhUwLC87FA_GWs8PS>-^G@DAminI3+W9jDb6_KNK>zzq0Kqr!l0ejvw^ z5h&*rzNoH5-WKnud2OM&_>XPxQjHihU5IceTc8uK3Ci^;fQ~Jj1C~K@hrDSY;GPP?$X)^cIa82+KK-)5|QDML~$OG3i72%Wty9$wQv9h)=BfEq>SEp8TR}cmy zXyJ5Qr2H7lMwAK~GlmFHa#a8T4sc0CK~$p=cNCVWFyPv4kZO6ad_ZLwZ34xG7JU`u zN&FSSpkIXn#*TnnQ>y$Rk|mWYF3gM#4mqUMHB>vZqo6Ddwt&*S1>Y$?h%A!_m>MK@ zRILz8f@}i>N6SbR1~}`6<=M)Q!aqvf0YtSTij_BiG>!CIjS2&t&Fh&tp|wF&grZmI z^iJ(4C{20;d%13U&V-So^5z1i)<36q6cpz^`ex?bo}gz0QGp2rlI3@Ui{w_SH8{1S zpg0VUgXYDF*E3?QzHL9^_HY}iW+_>=NUD&#Yr+7vbA7z;s9<~C_AB|X0v&pVdl`al zG8}~oQiTDZ1tLDA8^`1qZhL-zEX++}m7~WlNdzZgO;{l$@rbdlp^3emjV5Sd|6QZP zfY)}ITRIOckuhnKL*3`rna_kH-e)?3cZ>vKlt_3C$rOze+neV4#AAC{GfbDYUxfj` z>8dQfy>mW>+clqWd9(jddZTy`_vIg0ksMTJ1x*E$Ls!s-M=bTr+Lukjv4^CZ)a$q& zR_G`^QDGo7m+$DHF(94jr{^3!_eED{3-&k7n>_O^n=Pe-bJR66H3BtnOU*JMSF*Dm z5%2ZxCPo^C7Wi~ay);YE`?M1RG zI&XpjfCKCA;fh%h1KyZrIzasTu{I_UhTTQ>is%4b1&Wh93RA|JO!}2(SfA$2l1ehW zl&N*R>cE2~{WLO^n6pQU83$~5usu$rDaI|rNEL%dfOC|vLw_}s5Ma@nK&ISUQ>bNa z@RQg2%Yy+*WhMo6aTL6&W}3W9Uy7+VX*8|wVjGI`FNAwKP8{~Rvv#yk3k*zlX-OFE3Flvkt2|qBvWFKO^WW`Y zB=KkQ=r%rP3c7nF5X2~>A-X^yNVK%Q0utegZV^rE0+ue}wUavv)1s$v`zdU3bPJ2N zJYjFY?d#KSu*nni1G3rC$044s;X+VC{?PJq7pLuQ1f#cMjs^T-hLASC$*vK7@8pic zG|6h{PM>;ohO1hm<};VTdng@-wnG5=?i~ zc7uYOaViWP=~I|iiP8&veJ-%vS-hSpokM8Z8q3?Tc3E_5C}tPbe%$=*_b#=& zRQXsF?kEUnQMeBHnvePJ94I5t8sry)WLApmcwKvf_Fwhnmzg+t z??vv94?d5(KS3eg!Puq{L7`BA?Bm@U88z!i3(hnJG zWU(087rNmQ+8~Hs8_B$poe2KWhox`ccM-s>Ien+5Q9pSWQX0xsaIT65e(+Mq=ry$$ z_bbn(erL*&RLDIztyrHm$xmQDa1_C=DoTT}d(~c4jPc$zXJwAdtrJKeJS)gxe#k6_ zeEh9Grx{6)sek*kKEKINFm>+6>y*80qm%h1a$P#yGnktB?)%hV{_oY_x9SoDN8f(! zkgpPRoxE3kf-wlfS2~y`B2sdop2JOZMBNYk<(faB-76-=GtGph0ZkF4?0mxbUvqKE zgUw#b7Yzs}E+*!(fQZS0covl=>3MQP^yY8WUhbdPUEwl?=v7V@AdzbU)|Z=uoZzID zk9-=SR34EIV+7k?F)BHXaS&PxPJ-T|!_}brr>;hS4-0L5WhM$#A4ZX7UX4#~Ux z>0RATlYHTIBxHRA3kv7PWsuHC?p^cN*sh7~jc%WfY3}Ji@*MJBRC~p=I2JSxND_4A zF4<9SVv^^>9b*f+=67>un(eZY*Bgj}z?+=R10)H$rB_+Sy@8l4K04h~|7p$a{h++{ ze1rV&Fi)!A_L51HgY-g8PUayOjs*Q+e9mO?O0CBEJ);c^t^#)lTxHkg-qZ3sfjhfb z{wjU23e8?IBrlZd2p|c%dH&MA`(C^MJ`q>_LMyEa`2%hL$p8B+;5kskvhnX0EK%TF zPUayj8A^S*ZusW>x=ugz{#Uzm{O_TOFFM*PD^4tkg4UCB_ZG#mb1cBAv1g>c;x;Vq zHmMoR05VIUoS&=niQ7-ltI0^yh}%C&x&F(yg&hy)-&;MTcrA7Y@_Rp&Eqf2(2m(!V zG7pd>=!%Y>S(79$4oO>fEi%)ZYOd?tH|lW%shCjAdjn}jmiLN#w_^x`@FE8@jEMDs z>dVywlC|ERrP)FM*rF&H@tQ##maBo=v_DOFN%Ca8Fo_`wisPA~#H9f`*&gM#u(#_; z{pjVnbg!vhG1l8PKDR-*rDBrPp@%66wi@A} z;@H}ISW_)Z9uU$3JP0`DWG)Fh4@Qd6@|lXo?gg#-U(-FeL;r7nQ$LL^Y?iWNH8T+? z5_C(=z@Ob+Q-6706&`CZ`B&bW_v@~z^*v+xhV&-TL9k{;Br_LS5_I+C!`a~rS6kZy z8sy`u-?kuv#=5^&FBJRim4Q$>4pvSUK!Pr7Ixw>VyiyzZLqSjbJSMnwsYcO#uVbFT zusn`gf};pl7j*x*Q+yw+JTtMt-G6M-$HrtFs@YXR46}@Q&@D~@(Y$YHZksW!Vq767 zq!;=|0Y*Y>p_5rjZlW-OP*%}7Jf#G}POlXuw@}dstauQvubj-4BBVr%69{FlT4lsj z?}_%4OLE1t?qqTr)CD0afdK%H1g!^8=e5h$;oGytqKd(%XB$sc&F2q*wC2=o287ic z1d4+}4|(#~R|kfU>{vVs>U}Ux3d=S*85km0tPv*;s(btmh8ypMk`x#zC!?33gXK*3 zkqhcUFf{1f4{yWH9E-$vkAI(n=Xf zNNEH^fpgO`S}minN=_C*f)<8?42Fu#Vp=o(E60UShK$JEbXqrkE5|Dx3?YDBHZhVE z&yWJvWfLEX*$gp4Nzm58;cE#jMG#4XwyJVme?qzJ2` zX@#|rpTLC1kxcbvzocd`;eq3_2^7P8ErHdS*O3IR4pKRpBxqg1D<_i#ts7?eTEYV6 zphrtVFDG-Q2y3au$)j?d9L8)3Nze-rMNZ}c-k?W|z|n|gpae}VP8RuEk^~Kmv^YlC zU4j-+dGlo)RkfK za?o=7kf7JwqP|=lPfP6^P=g*xP9_Q3C^#|95vaaBiprc4m);&eQCqWly(z59fGM7z}d@W&tXwYL0$;k%R zmyry56wuca7APcWl9P=mA&KNq4xSmLrtaxy$jciALgOPHAIvMKJEMEsaG=rM#EkwB*i z=D2L;C(u_7JVh|R#ff|^F<`LECdtW2Fj9ghIT;a#Nzf!G9s#;+lCPzxtky0;ldq+~Xm#17F^Phs$z_wqB#MvU z7N>NQlWl=d37Wat04vaL{Y*(6^}yWvHGCOO%TEOOZlDW#;qo+-jYmratB x?TdTRBaKP4H}PpXWo20;C)=KgFe)6g{{g5Sx5*&)^v(bP002ovPDHLkV1kN_*1Z4# diff --git a/man/geo_address_lookup.Rd b/man/geo_address_lookup.Rd index f5c95974..bdd838b4 100644 --- a/man/geo_address_lookup.Rd +++ b/man/geo_address_lookup.Rd @@ -71,8 +71,8 @@ Address Lookup API: Geocoding strings: \code{\link{geo_address_lookup_sf}()}, -\code{\link{geo_lite_sf}()}, -\code{\link{geo_lite}()} +\code{\link{geo_lite}()}, +\code{\link{geo_lite_sf}()} } \concept{geocoding} \concept{lookup} diff --git a/man/geo_address_lookup_sf.Rd b/man/geo_address_lookup_sf.Rd index 51b14ce5..a4d5a2e1 100644 --- a/man/geo_address_lookup_sf.Rd +++ b/man/geo_address_lookup_sf.Rd @@ -111,8 +111,8 @@ Address Lookup API: Geocoding strings: \code{\link{geo_address_lookup}()}, -\code{\link{geo_lite_sf}()}, -\code{\link{geo_lite}()} +\code{\link{geo_lite}()}, +\code{\link{geo_lite_sf}()} Get spatial (\code{sf}) objects: \code{\link{bbox_to_poly}()}, diff --git a/man/geo_amenity.Rd b/man/geo_amenity.Rd index 1cce33da..cca0b4b1 100644 --- a/man/geo_amenity.Rd +++ b/man/geo_amenity.Rd @@ -1,56 +1,22 @@ % Generated by roxygen2: do not edit by hand -% Please edit documentation in R/geo_amenity.R +% Please edit documentation in R/deprecated.R \name{geo_amenity} \alias{geo_amenity} +\alias{geo_amenity_sf} \title{Geocode amenities} \usage{ -geo_amenity( - bbox, - amenity, - lat = "lat", - long = "lon", - limit = 1, - full_results = FALSE, - return_addresses = TRUE, - verbose = FALSE, - custom_query = list(), - strict = FALSE -) +geo_amenity(bbox = NULL, ...) + +geo_amenity_sf(bbox = NULL, ...) } \arguments{ -\item{bbox}{A numeric vector of latitude and longitude -\verb{(, , , )} that -restrict the search area. See \strong{Details}.} - -\item{amenity}{A character of a vector of character with the amenities to be -geolocated (i.e. \code{c("pub", "restaurant")}).} - -\item{lat}{latitude column name in the output data (default \code{"lat"}).} - -\item{long}{longitude column name in the output data (default \code{"long"}).} - -\item{limit}{maximum number of results to return per input address. Note -that each query returns a maximum of 50 results.} - -\item{full_results}{returns all available data from the API service. -If \code{FALSE} (default) only latitude, longitude and address columns are -returned. See also \code{return_addresses}.} - -\item{return_addresses}{return input addresses with results if \code{TRUE}.} - -\item{verbose}{if \code{TRUE} then detailed logs are output to the console.} - -\item{custom_query}{API-specific parameters to be used.} - -\item{strict}{Logical \code{TRUE/FALSE}. Force the results to be included inside -the \code{bbox}. Note that Nominatim default behavior may return results located -outside the provided bounding box.} +\item{bbox, ...}{Deprecated} } \value{ An error. } \description{ -\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#deprecated}{\figure{lifecycle-deprecated.svg}{options: alt='[Deprecated]'}}}{\strong{[Deprecated]}} +\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#defunct}{\figure{lifecycle-defunct.svg}{options: alt='[Defunct]'}}}{\strong{[Defunct]}} This operation is not supported any more. Use \code{\link[arcgeocoder:arc_geo_categories]{arcgeocoder::arc_geo_categories()}} instead. @@ -74,7 +40,4 @@ rest_pub <- arc_geo_categories( rest_pub } } -\seealso{ -\code{\link[=geo_amenity_sf]{geo_amenity_sf()}} -} \keyword{internal} diff --git a/man/geo_amenity_sf.Rd b/man/geo_amenity_sf.Rd deleted file mode 100644 index d56f8c99..00000000 --- a/man/geo_amenity_sf.Rd +++ /dev/null @@ -1,102 +0,0 @@ -% Generated by roxygen2: do not edit by hand -% Please edit documentation in R/geo_amenity_sf.R -\name{geo_amenity_sf} -\alias{geo_amenity_sf} -\title{Geocode amenities in Spatial format} -\usage{ -geo_amenity_sf( - bbox, - amenity, - limit = 1, - full_results = FALSE, - return_addresses = TRUE, - verbose = FALSE, - custom_query = list(), - points_only = TRUE, - strict = FALSE -) -} -\arguments{ -\item{bbox}{A numeric vector of latitude and longitude -\verb{(, , , )} that -restrict the search area. See \strong{Details}.} - -\item{amenity}{A character of a vector of character with the amenities to be -geolocated (i.e. \code{c("pub", "restaurant")}).} - -\item{limit}{maximum number of results to return per input address. Note -that each query returns a maximum of 50 results.} - -\item{full_results}{returns all available data from the API service. -If \code{FALSE} (default) only address columns are returned. See also -\code{return_addresses}.} - -\item{return_addresses}{return input addresses with results if \code{TRUE}.} - -\item{verbose}{if \code{TRUE} then detailed logs are output to the console.} - -\item{custom_query}{A named list with API-specific parameters to be used -(i.e. \code{list(countrycodes = "US")}). See \strong{Details}.} - -\item{points_only}{Logical \code{TRUE/FALSE}. Whether to return only spatial -points (\code{TRUE}, which is the default) or potentially other shapes as -provided by the Nominatim API (\code{FALSE}). See \strong{About Geometry Types}.} - -\item{strict}{Logical \code{TRUE/FALSE}. Force the results to be included inside -the \code{bbox}. Note that Nominatim default behavior may return results located -outside the provided bounding box.} -} -\value{ -An error -} -\description{ -\ifelse{html}{\href{https://lifecycle.r-lib.org/articles/stages.html#deprecated}{\figure{lifecycle-deprecated.svg}{options: alt='[Deprecated]'}}}{\strong{[Deprecated]}} - -This operation is not supported any more. Use -\code{\link[arcgeocoder:arc_geo_categories]{arcgeocoder::arc_geo_categories()}} instead. -} -\section{About Geometry Types}{ - - -The parameter \code{points_only} specifies whether the function results will be -points (all Nominatim results are guaranteed to have at least point -geometry) or possibly other spatial objects. - -Note that the type of geometry returned in case of \code{points_only = FALSE} -will depend on the object being geocoded: -\itemize{ -\item administrative areas, major buildings and the like will be -returned as polygons -\item rivers, roads and their like as lines -\item amenities may be points even in case of a \code{points_only = FALSE} call -} - -The function is vectorized, allowing for multiple addresses to be geocoded; -in case of \code{points_only = FALSE} multiple geometry types may be returned. -} - -\examples{ -\donttest{ -#' # Madrid, Spain - -library(arcgeocoder) -library(ggplot2) - -bbox <- c(-3.888954, 40.311977, -3.517916, 40.643729) - -# Food -rest_pub <- arc_geo_categories( - bbox = bbox, category = "Bakery,Bar or Pub", - full_results = TRUE, - limit = 50 -) -if (nrow(rest_pub) > 1) { - # To sf - rest_pub_sf <- sf::st_as_sf(rest_pub, coords = c("lon", "lat"), crs = 4326) - - ggplot(rest_pub_sf) + - geom_sf(aes(color = Type)) -} -} -} -\keyword{internal} diff --git a/man/geo_lite.Rd b/man/geo_lite.Rd index 1f76e33e..8779dc0e 100644 --- a/man/geo_lite.Rd +++ b/man/geo_lite.Rd @@ -75,8 +75,8 @@ geo_lite(c("Madrid", "Barcelona"), \code{\link[=geo_lite_sf]{geo_lite_sf()}}, \code{\link[tidygeocoder:geo]{tidygeocoder::geo()}} Geocoding strings: -\code{\link{geo_address_lookup_sf}()}, \code{\link{geo_address_lookup}()}, +\code{\link{geo_address_lookup_sf}()}, \code{\link{geo_lite_sf}()} } \concept{geocoding} diff --git a/man/geo_lite_sf.Rd b/man/geo_lite_sf.Rd index 72058fb9..f120b400 100644 --- a/man/geo_lite_sf.Rd +++ b/man/geo_lite_sf.Rd @@ -111,8 +111,8 @@ if (any(!sf::st_is_empty(Madrid))) { } \seealso{ Geocoding strings: -\code{\link{geo_address_lookup_sf}()}, \code{\link{geo_address_lookup}()}, +\code{\link{geo_address_lookup_sf}()}, \code{\link{geo_lite}()} Get spatial (\code{sf}) objects: diff --git a/tests/testthat/_snaps/deprecated.md b/tests/testthat/_snaps/deprecated.md new file mode 100644 index 00000000..3b55f5a7 --- /dev/null +++ b/tests/testthat/_snaps/deprecated.md @@ -0,0 +1,20 @@ +# Deprecated geo_amenity_sf + + Code + geo_amenity_sf() + Condition + Error: + ! `geo_amenity_sf()` was deprecated in nominatimlite 0.3.0 and is now defunct. + i Please use `arcgeocoder::arc_geo_categories()` instead. + i Operation not supported any more by the Nominatim API. + +# Deprecated geo_amenity + + Code + geo_amenity() + Condition + Error: + ! `geo_amenity()` was deprecated in nominatimlite 0.3.0 and is now defunct. + i Please use `arcgeocoder::arc_geo_categories()` instead. + i Operation not supported any more by the Nominatim API. + diff --git a/tests/testthat/_snaps/geo_amenity.md b/tests/testthat/_snaps/geo_amenity.md deleted file mode 100644 index 41c14fd1..00000000 --- a/tests/testthat/_snaps/geo_amenity.md +++ /dev/null @@ -1,10 +0,0 @@ -# Deprecated - - Code - geo_amenity() - Condition - Error: - ! `geo_amenity()` was deprecated in nominatimlite 0.3.0 and is now defunct. - i Please use `arcgeocoder::arc_geo_categories()` instead. - i Operation not supported any more by the Nominatim API. - diff --git a/tests/testthat/_snaps/geo_amenity_sf.md b/tests/testthat/_snaps/geo_amenity_sf.md deleted file mode 100644 index f2fd7c8b..00000000 --- a/tests/testthat/_snaps/geo_amenity_sf.md +++ /dev/null @@ -1,10 +0,0 @@ -# Deprecated - - Code - geo_amenity_sf() - Condition - Error: - ! `geo_amenity_sf()` was deprecated in nominatimlite 0.3.0 and is now defunct. - i Please use `arcgeocoder::arc_geo_categories()` instead. - i Operation not supported any more by the Nominatim API. - diff --git a/tests/testthat/test-deprecated.R b/tests/testthat/test-deprecated.R new file mode 100644 index 00000000..3ae58ed0 --- /dev/null +++ b/tests/testthat/test-deprecated.R @@ -0,0 +1,11 @@ +test_that("Deprecated geo_amenity_sf", { + skip_if_not_installed("lifecycle") + + expect_snapshot(geo_amenity_sf(), error = TRUE) +}) + +test_that("Deprecated geo_amenity", { + skip_if_not_installed("lifecycle") + + expect_snapshot(geo_amenity(), error = TRUE) +}) diff --git a/tests/testthat/test-geo_amenity.R b/tests/testthat/test-geo_amenity.R deleted file mode 100644 index b8964b37..00000000 --- a/tests/testthat/test-geo_amenity.R +++ /dev/null @@ -1,5 +0,0 @@ -test_that("Deprecated", { - skip_if_not_installed("lifecycle") - - expect_snapshot(geo_amenity(), error = TRUE) -}) diff --git a/tests/testthat/test-geo_amenity_sf.R b/tests/testthat/test-geo_amenity_sf.R deleted file mode 100644 index 02f8cbf6..00000000 --- a/tests/testthat/test-geo_amenity_sf.R +++ /dev/null @@ -1,5 +0,0 @@ -test_that("Deprecated", { - skip_if_not_installed("lifecycle") - - expect_snapshot(geo_amenity_sf(), error = TRUE) -})