From fe34d29c68140dda36a00a94d72e26f56483866a Mon Sep 17 00:00:00 2001 From: David Weber Date: Thu, 21 Sep 2023 10:34:36 -0700 Subject: [PATCH 1/3] docs: readme link to package and CRAN --- README.md | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index f04b7be9..d679afa8 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,9 @@ Actions](https://github.com/cmu-delphi/epidatr/workflows/ci/badge.svg)](https:// [![codecov](https://codecov.io/gh/dsweber2/epidatr/branch/dev/graph/badge.svg?token=jVHL9eHZNZ)](https://app.codecov.io/gh/dsweber2/epidatr) -The [Delphi Epidata API](https://cmu-delphi.github.io/delphi-epidata/) +The [Delphi Epidatr package](https://cmu-delphi.github.io/epidatr/) is +an R frontend for the +[Delphi Epidata API](https://cmu-delphi.github.io/delphi-epidata/), which provides real-time access to epidemiological surveillance data for influenza, COVID-19, and other diseases for the USA at various geographical resolutions, both from official government sources such as @@ -37,6 +39,8 @@ processing ([epiprocess](https://github.com/cmu-delphi/epiprocess)) and modeling ([epipredict](https://github.com/cmu-delphi/epipredict)). ## Usage +You can find detailed docs here: +[https://cmu-delphi.github.io/epidatr/](https://cmu-delphi.github.io/epidatr/) ``` r library(epidatr) @@ -86,17 +90,23 @@ ggplot(epidata, aes(x = time_value, y = value)) + ## Installation +You can install the stable version of this package from CRAN: -Install from GitHub: +``` r +install.packages("epidatr") +pak::pkg_install("epidatr") +renv::install("epidatr") +``` + +Or if you want the development version, install from GitHub: ``` r # Install the dev version using `pak` or `remotes` pak::pkg_install("cmu-delphi/epidatr") +renv::install("cmu-delphi/epidatr") remotes::install_github("cmu-delphi/epidatr") ``` -CRAN version coming soon. - ### API Keys The Delphi API requires a (free) API key for full functionality. To From 265fbe33d6cfb46342e7e0121227e785c0abf9ea Mon Sep 17 00:00:00 2001 From: dsweber2 Date: Thu, 21 Sep 2023 14:18:38 -0700 Subject: [PATCH 2/3] docs: render readme changes --- README.Rmd | 19 +++++++++---- README.md | 36 ++++++++++++++----------- man/figures/README-fb-cli-signal-1.png | Bin 33909 -> 13135 bytes man/get_api_key.Rd | 4 +-- 4 files changed, 36 insertions(+), 23 deletions(-) diff --git a/README.Rmd b/README.Rmd index 0233fc8a..ce620d26 100644 --- a/README.Rmd +++ b/README.Rmd @@ -23,13 +23,13 @@ ggplot2::theme_set(ggplot2::theme_bw()) - -The [Delphi Epidata API](https://cmu-delphi.github.io/delphi-epidata/) provides real-time access to epidemiological surveillance data for influenza, COVID-19, and other diseases for the USA at various geographical resolutions, both from official government sources such as the [Center for Disease Control (CDC)](https://www.cdc.gov/datastatistics/index.html) and [Google Trends](https://cmu-delphi.github.io/delphi-epidata/api/covidcast-signals/google-symptoms.html) and private partners such as [Facebook](https://delphi.cmu.edu/blog/2020/08/26/covid-19-symptom-surveys-through-facebook/) and [Change Healthcare](https://www.changehealthcare.com/). It is built and maintained by the Carnegie Mellon University [Delphi research group](https://delphi.cmu.edu/). +The [Delphi Epidatr package](https://cmu-delphi.github.io/epidatr/) is an R front-end for the [Delphi Epidata API](https://cmu-delphi.github.io/delphi-epidata/), which provides real-time access to epidemiological surveillance data for influenza, COVID-19, and other diseases for the USA at various geographical resolutions, both from official government sources such as the [Center for Disease Control (CDC)](https://www.cdc.gov/datastatistics/index.html) and [Google Trends](https://cmu-delphi.github.io/delphi-epidata/api/covidcast-signals/google-symptoms.html) and private partners such as [Facebook](https://delphi.cmu.edu/blog/2020/08/26/covid-19-symptom-surveys-through-facebook/) and [Change Healthcare](https://www.changehealthcare.com/). It is built and maintained by the Carnegie Mellon University [Delphi research group](https://delphi.cmu.edu/). This package is designed to streamline the downloading and usage of data from the [Delphi Epidata API](https://cmu-delphi.github.io/delphi-epidata/). It provides a simple R interface to the API, including functions for downloading data, parsing the results, and converting the data into a tidy format. The API stores a historical record of all data, including corrections and updates, which is particularly useful for accurately backtesting forecasting models. We also provide packages for downstream data processing ([epiprocess](https://github.com/cmu-delphi/epiprocess)) and modeling ([epipredict](https://github.com/cmu-delphi/epipredict)). ## Usage +You can find detailed docs here: ```{r} library(epidatr) @@ -62,16 +62,25 @@ ggplot(epidata, aes(x = time_value, y = value)) + ## Installation +You can install the stable version of this package from CRAN: + +``` r +```R +install.packages("epidatr") +pak::pkg_install("epidatr") +renv::install("epidatr") +``` +``` -Install from GitHub: +Or if you want the development version, install from GitHub: +```R ```R # Install the dev version using `pak` or `remotes` pak::pkg_install("cmu-delphi/epidatr") remotes::install_github("cmu-delphi/epidatr") ``` - -CRAN version coming soon. +``` ### API Keys diff --git a/README.md b/README.md index d679afa8..57483d13 100644 --- a/README.md +++ b/README.md @@ -12,13 +12,13 @@ Actions](https://github.com/cmu-delphi/epidatr/workflows/ci/badge.svg)](https:// [![codecov](https://codecov.io/gh/dsweber2/epidatr/branch/dev/graph/badge.svg?token=jVHL9eHZNZ)](https://app.codecov.io/gh/dsweber2/epidatr) -The [Delphi Epidatr package](https://cmu-delphi.github.io/epidatr/) is -an R frontend for the -[Delphi Epidata API](https://cmu-delphi.github.io/delphi-epidata/), which -provides real-time access to epidemiological surveillance data for -influenza, COVID-19, and other diseases for the USA at various -geographical resolutions, both from official government sources such as -the [Center for Disease Control +The [Delphi Epidatr package](https://cmu-delphi.github.io/epidatr/) is +an R front-end for the [Delphi Epidata +API](https://cmu-delphi.github.io/delphi-epidata/), which provides +real-time access to epidemiological surveillance data for influenza, +COVID-19, and other diseases for the USA at various geographical +resolutions, both from official government sources such as the [Center +for Disease Control (CDC)](https://www.cdc.gov/datastatistics/index.html) and [Google Trends](https://cmu-delphi.github.io/delphi-epidata/api/covidcast-signals/google-symptoms.html) and private partners such as @@ -39,8 +39,8 @@ processing ([epiprocess](https://github.com/cmu-delphi/epiprocess)) and modeling ([epipredict](https://github.com/cmu-delphi/epipredict)). ## Usage -You can find detailed docs here: -[https://cmu-delphi.github.io/epidatr/](https://cmu-delphi.github.io/epidatr/) + +You can find detailed docs here: ``` r library(epidatr) @@ -90,22 +90,26 @@ ggplot(epidata, aes(x = time_value, y = value)) + ## Installation + You can install the stable version of this package from CRAN: ``` r +```R install.packages("epidatr") pak::pkg_install("epidatr") renv::install("epidatr") ``` -Or if you want the development version, install from GitHub: -``` r -# Install the dev version using `pak` or `remotes` -pak::pkg_install("cmu-delphi/epidatr") -renv::install("cmu-delphi/epidatr") -remotes::install_github("cmu-delphi/epidatr") -``` + Or if you want the development version, install from GitHub: + + ```R + ```R + # Install the dev version using `pak` or `remotes` + pak::pkg_install("cmu-delphi/epidatr") + remotes::install_github("cmu-delphi/epidatr") + +\`\`\` ### API Keys diff --git a/man/figures/README-fb-cli-signal-1.png b/man/figures/README-fb-cli-signal-1.png index 5a76514d301c351006ccbe139a1b544cd1b6f40a..1c05ba7be3ea3eb0266bceefec4d3079a245395d 100644 GIT binary patch literal 13135 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 Date: Thu, 21 Sep 2023 18:25:55 -0700 Subject: [PATCH 3/3] fix: doubled code block tags in README --- README.Rmd | 9 +++------ README.md | 17 +++++++---------- man/figures/README-fb-cli-signal-1.png | Bin 13135 -> 13023 bytes 3 files changed, 10 insertions(+), 16 deletions(-) diff --git a/README.Rmd b/README.Rmd index ce620d26..f109948b 100644 --- a/README.Rmd +++ b/README.Rmd @@ -16,19 +16,18 @@ ggplot2::theme_set(ggplot2::theme_bw()) # Delphi Epidata R client - [![License: MIT][mit-image]][mit-url] [![Github Actions][github-actions-image]][github-actions-url] [![codecov](https://codecov.io/gh/dsweber2/epidatr/branch/dev/graph/badge.svg?token=jVHL9eHZNZ)](https://app.codecov.io/gh/dsweber2/epidatr) - The [Delphi Epidatr package](https://cmu-delphi.github.io/epidatr/) is an R front-end for the [Delphi Epidata API](https://cmu-delphi.github.io/delphi-epidata/), which provides real-time access to epidemiological surveillance data for influenza, COVID-19, and other diseases for the USA at various geographical resolutions, both from official government sources such as the [Center for Disease Control (CDC)](https://www.cdc.gov/datastatistics/index.html) and [Google Trends](https://cmu-delphi.github.io/delphi-epidata/api/covidcast-signals/google-symptoms.html) and private partners such as [Facebook](https://delphi.cmu.edu/blog/2020/08/26/covid-19-symptom-surveys-through-facebook/) and [Change Healthcare](https://www.changehealthcare.com/). It is built and maintained by the Carnegie Mellon University [Delphi research group](https://delphi.cmu.edu/). This package is designed to streamline the downloading and usage of data from the [Delphi Epidata API](https://cmu-delphi.github.io/delphi-epidata/). It provides a simple R interface to the API, including functions for downloading data, parsing the results, and converting the data into a tidy format. The API stores a historical record of all data, including corrections and updates, which is particularly useful for accurately backtesting forecasting models. We also provide packages for downstream data processing ([epiprocess](https://github.com/cmu-delphi/epiprocess)) and modeling ([epipredict](https://github.com/cmu-delphi/epipredict)). ## Usage + You can find detailed docs here: ```{r} @@ -62,24 +61,22 @@ ggplot(epidata, aes(x = time_value, y = value)) + ## Installation + You can install the stable version of this package from CRAN: -``` r ```R install.packages("epidatr") pak::pkg_install("epidatr") renv::install("epidatr") ``` -``` Or if you want the development version, install from GitHub: -```R ```R # Install the dev version using `pak` or `remotes` pak::pkg_install("cmu-delphi/epidatr") remotes::install_github("cmu-delphi/epidatr") -``` +renv::install("cmu-delphi/epidatr") ``` ### API Keys diff --git a/README.md b/README.md index 57483d13..96a846f5 100644 --- a/README.md +++ b/README.md @@ -94,22 +94,19 @@ ggplot(epidata, aes(x = time_value, y = value)) + You can install the stable version of this package from CRAN: ``` r -```R install.packages("epidatr") pak::pkg_install("epidatr") renv::install("epidatr") ``` +Or if you want the development version, install from GitHub: - Or if you want the development version, install from GitHub: - - ```R - ```R - # Install the dev version using `pak` or `remotes` - pak::pkg_install("cmu-delphi/epidatr") - remotes::install_github("cmu-delphi/epidatr") - -\`\`\` +``` r +# Install the dev version using `pak` or `remotes` +pak::pkg_install("cmu-delphi/epidatr") +remotes::install_github("cmu-delphi/epidatr") +renv::install("cmu-delphi/epidatr") +``` ### API Keys diff --git a/man/figures/README-fb-cli-signal-1.png b/man/figures/README-fb-cli-signal-1.png index 1c05ba7be3ea3eb0266bceefec4d3079a245395d..21c040f1096a63e995711e91757af88fc6f0a54d 100644 GIT binary patch literal 13023 zcmch7RaDep^e@Vwgn)E|ASDgb=}7m0G*Z$n-Qh?GNK4nyNOyoT2n3Rzo}Q7Bk(rs9m6es9ot=}Dlbf5HmzVeR z=g<87{DOjl!otF$qN3vB;*ye*($dnhva<5>@`{Rz%F4>Bs;cVh>YAFG+S=N>y1M%M z`i6#v#>U2`rl#iR=9ZS0U%!6+{{6ePwY9CSt-Zayqobp zy?uRs{r&v|0|SGDgHR}RXlQ77cz9%FWOQ_NY;0_Ne0*YJVsdhFYHDhFdU|GNW_EUV zZfzJYinzJdwXYRXLomZZ*OmZ zfB)d%;PCM9@87>iM@PrU$0sKzr>Cc9XJ_Z<=NA_jmzS4US6A29*Ecsex3{-xpL0RaJ{?cw*N%Qnvl0pS&bv=~suHF+<^MIUGFzANpAf)=-ikuBY; zor0&qymknvxDnYJmtUT$0g%K3%8k$%@bKFG>A@sVfH}TkCM+Yga?$6^TMEK04d1y} z9R92w33d&6>-uoI49;!L^XT@|#F4x}Zv9nSAcP25!o>c;#z{?YU?v4>g+@U9(uY1k zjjFZnG=yc9Mbe{F7|S9_O}f#1j&p4QU;!<_t;@U2&7OW;UP!(E`NjPz!5G*??pCj^ zTdT=qJwIpk#k_m{jM?na5{!(G4t6#qS&jStA)gV9 z!&%|IYJXX!e-~a0d1K{iplP${cz&+i0$|Qd<4QN_M8-3FS!r%%V9Ig5GG>uYA^3!1 zp3te6)xI~uG+$zzB57raZ@4)yg+8?D_%uQ!p2K)CaF=7k-(NXXkM z68|Uh5X8OcYt{s7LS<&F0_}{0Sywe((xFN##|rT?o8DTIOol4GHFml`R+h@1j!D)s zy-P1S@3)jGu8M>H_A%Y|o3yQ!trC&6?E?AMDC|NsI(DbOv};}1H8buyW4Um zF4c)gpW2HYEW_NIWIm$$)~U5aT^hiPcZz5?CiB6I-T_} zWE}lbz1^`R8!qErYaR(Hn(Am}l7osal;@6@3`(0+)!)}{S88Vr&ek$Wl1A17k}NTj zM2<0N4M;nb-uFXpSWpBWZZDTPTHym1cW!WkUa_hV+vM-sv9%eMoLa~Uh*1_b#hPfzStztpm+I+UjG}}=#5Z#sZ zI>xUkj`%K^5GkU4T#AB`f)%^cswjiWk-)b4U^!azd0iKCr>V`y80P>{wJ)Ql*4nC9 z0%1)wnB{JL(i{z3vhJecje6#M)WDJH*csm<6indWTW;#z?rD^^MHUQCB?W1X(S0v|F|*S4YUE8hYUa?}05p?zGyTBhHQr z>aB;x4!ee~86<@OxaPEQ*VI977W?eN4lDV)O>&>on&^10M_{_G0X zWlL)0wAxcw#DuQQi3H$3!l_Q_N018j?0LOxG+BU<+p0TUIu7${_}A3y46Yp(+YmD4 zLA@gns&`ftrT#)D6d#L=JWL}YN0XqRbdxfCn75-(limPr8da#xh^h`CGubWs?DGyQ zI_60(+F7La>iO>Nd{AqJRm^bv5kR$`0bi76!e-k=;^9lj1}~|$8H9O5OChSo--&AR z-Dd?lgMRCXr*5Gd0mqhmdS~HIFK0*!i;LXiJaQ*$E@XtVzF50VPNAsdX!08w)-tn~CubaUbp50sgXBej zuuTL@x%2#Xa_t;*53mJhPt}a42M*?kvf!UJhtJZPdD)?nMn=(9V7q}Um@CoTm_`M*=;qxZ|rh>JjI$ONT1h+@Dp&O z)==cJ;^NxpaE7rs951$H4YY;3ljl9J6|6H(_@?Dmjei?t!hq^~!(Cs@fm7Rq~lX(G1H>if|iO&Lwj@>ULOdzXx_qIDr;YoAPI8w`iEQ@1( z%6#Qd%ZBNS&&)vZb|1O9`un^c61l*DkEPtZWRKG3_#Wl zZ1a<1-U^DE7UGC6aq~p&`cJ*&p88V(Eh8xq74Lf-T&srl^B|j~6~5NtO&SpWW_c?< z5%v#c3|OABpuF$@{L!1GEXZq@U68NS+m^6Kr?CPFMybJx%+JA%zIv@+r(h-6meYXg zEi_=aP@KUkU5x(<81#@H%WBUo&%BhbtDpXO!u}Xt$7 z(&V`aXK11D`1W}D%)C$-~}S-H;%XR zbZ-CPwgCrF3EzN}toFT0pd;FYU@_%L8FuvvNwj~N&FPno0) zE5GH!o%(aam#$5t=Af_`$;MeMpY%YYS4?yt+UN^F$HrE9M}^YE8VbORkOCjcz6K&u zM?r3er9e-DsOeic|DO$;@d8;Xl!#yMTGhS+Vo8CLe}SD}P$c+cz*|sFsGdgGHwlt5 zN^1J2D5zJcTF}}UYg^e7PotM8!SBG}W-tqzb*#j;7GeSoHtrVyk`7XT-n5SQRIB$1 znFN?B0s<+3l!%d6wagDsxe&r>yus7XiXp^no5^I}ou+K?K3(v1RI#BFS+cC%8;kNm zWVkqYl=>K&;!4~zA}9r zI=$B39;uG;+8y$dcFVYv=CY(8j&gn@E*hDF>sXZcsy{iu2(&ZZUX#`>W`4bt@P-vY zW42##7R@^%A!9WFS}x}!vm_^X8LBD!BTC-%CKw0(U81IFWNf8uqAB}nd1q_yIwveF zP4O1Isc_y7_g_p)qsc&TP%5m7J0UKAtFM|O$Lp3%=RC{_!rwKx9@3cs_mgDpi%RV& zG;$kLQ<8R6IL&}OZe-ampWj&2d$7XIECM8O{-J@M8TVVWu3&{CY#o9`20~Bqr?dHd z@cJQ^pi6OCyGO5~k#QA>HePU#@*`g%&4h#{lM4?Pg#*N20fEnf6y`Z>XJq^8-f#nb zBRF|~LF!+o$GF1H4VMD~y2PXze$`ys!0Vj6yO7!sJ(8I^x<)hlJFTed=Lc~;@eE-CoROC+Io110Z=S< z2)?9b?Y3c`l~jbl8AU)?6NHtyiYlzi{`Gu=NIt9B3SM!w&)kW94Y%SAQvdyh&4*c% z;7nKc?o-Mi52RmOAS;?l{@Xlj1iOBjU*TO15Y3q9&)$}`Vy43hXOU8D`60Z7D*<<5 z>hR?{4_==iWv~5-Uby2*^8kF2c@wo-xb|mVm>*o(L;REdb)Z83e^M$SJCmlr6$UQ< zNv(kB6s$2|sQmh`qXfdo>`6gMfV>e2dK8fctN^DZ?ugRE?a(|JB56J?eJA_i8GQuc z#t(iZYI;-@)Mqa_iz+=WP~fwk0Q`lI*3#gpC0;sadfq>SGkcAU$|C{eX7hu@Wza=J2&w4_--9+)CuHEfUjQd6#^4+}UyiD^@W2_f1N{H8-x(2f%g)q2K^iTZ&h=^ofypFh7W>cNh7m1ypKCg4t)2M8TQEcA{A zhG>G=@V#Z(?-k5on%a~P++htftx(e{Jh%rX`m-yvtY6d}t*{%z5aa=gL#4}8Hl=ET9fS(=>qT75**s8vjQ^lphb73CcL z>W634{ouRQT(K}dSvw7c;p6hed5a;CYe(T5W>;kvOZsvLK6OKbFwI`#KO@zi*mYXR zoOJ7Jntgm`9%mt1NO+YY&nG{*%ZgI&En~@?u;|7^pe=n{i)hjhJ0hJJkX3D$!t=Z1dnRvfm_kNzOumMJUIf1OqFHxI^=Pv8@wN3%YjY$NL3C2 z@vu+6hg%Ir2Wk*=^c7}ZSdb+{k>*;*pJ_@x_=z_i&7$b+W5hoz)kD~L$Ne%xtF0^8aTZ zwCLx5Bea`cyMELErqPr>0G>= zlPa|JfJ@qE(F-sX=|;#8X_y6Qs#v)zRlB)4t_iAbs#~amZ7r}dRJOS{X1WuG2rIDy z?kD&srq!)_Fi@ajfY6wFRT}LdVbp$5oRJ9d1xETa9Z|dN}inQ6dbr1e>e7nI(!;)=5Uml&9UdGmzTwDa|J^EwTKaxssE#kSCMTbP0 zcl&npqTqxGcQK`Or3Vp~Xh9s#f062JS^iYD_IM#w&}uvD7TNwqATpMGg9!^^nE(iy zfJ|Y)P;Zv1;7`kCHPZ^10Ul)RTWN{%=#d`? zDr$hLs6h3wTuHxx-^V3hRKkN*G7I8UIymI~Nc4t&b_5_)@fbaRsP$2|-?`w?7zP4b z^U&${KXOw6xz=GJO}zrbL;Vwye*=XC@#CygNJ-cF6*qk8 zgy{ooO8c8bADL-DZ#cT&$p34ATrX@ExF69lZ}v$oIPAl>4#`SL!xTf>e} zU37RO^DAVboGbNz8r8IWf+UXso&%TANCP?F# zLc=*s!ww~A*88V&e=X45`;PxOz}AEv?x^@(9m0pkY4H1)p?z5O^xh8N(FKB;t*!&b zIBz(ISHoe#;4tQm=HHJPDS$1efwNbS@+g3VZh~Ava3h~!;ab#Fn88Z=;7mwyCS-z0 z56V(B=MD>`W%^An2U1*pi%RVmu!Td4q}o45;8=8R4Kw1y;2P0cm$hCpmYKjuFW^Yq zJnJ?koXg0xfbPs73R_13EB!1RBo9_l(T9P#9fZYJj@6#zm>~eKXVo66FPOHy{2~*3 zEEM{|&t5v(xDGLYhO;*7d)Bp6l8q=ggaEcNZozvfzhHKt9U(3Gkn}8mxpkqKKGJ*u z1Y2mM`V!5!>`kQtb4>jGc=_4g3R*dxt#Zf44@Ir2W$IZwV;o*`-7f#^7WPT#k>pyO z=o&53%acrzqnK_kQ$`H5ckUp=h4F&Ykx%%k>#x?zVdu3t2QK{eMCOMSnjYR+x>l0wIsx&TcXXyyOx0~${mHEVEST>l0l$e19 z5K?b0DTsz?9}AXQAs5Pd&ju?|4)Ar!6=Ax60FD_T1B;4CjQAc)K1mVaQpvXoQnJU` z$%L?R*tgt1E`<}^QRRxX|7qarzOnV$Cxyr2Cc`FowU#%`^svRKgH$y}O5Fmlg2Rfz ztr4znLytb!1Ns;z!3t7XEpvib2?=g|@hGMQ5}`37@lZ7J@}phh%)sj>*k_{pohml2 zKdhwD1Z|FednCj^v8;{;bifkP2|j0mQkx2VX$)zDE^=>f6R7i8sp-S^!L8fMqEa9| z7@S)q|1GO(1#{{=-}Yrz`jhW6Lv#C~uFZh|2<{fmm+GQ(R0*orfgaU3h z<}a2dMqzkWMvd$)NDJ+EzsQP&JjIp;L)QIBoTML)yRpc?7ULd=c6K;3DnNh1NfbF; z3N|JEi{QZtO85W=U~ab-LGv@5n-Q`_!OVxihvV_5KQD3D6UT!T;k;e~i>!A5rm#c8 zdoTk|6y#9x1g&-C;WSMn4vNRFmUe{Gw<9MmEC(?CeiZYXem97I#CenMqWtI)5-HGN zW+!~YWN^AY8;&;u!trNU)$VaVExnw6h2P^qBIM9>awFqWc?FQ=`x9^A<19LQ4Pvfd zyhl^Gfm_FwS2`Y*hrpuY#)T3-EsEYuA({m7E>G;iZ9RuLxX$9ULJkG@m>JacJzTVA z>#N0sHV%&D9yICq_NEm}NdAg5VrB8!jc~0fQTRPFj3ryeJvJizk?zlCSIoGZA<8T3 z&+|VnCqH=Mg*ddaxC^0^Z=MGy?CJO0-$UNa$f%zg_B99K06_2*S`xB8*&w1D@6ovM zM)JCflD?0lXd~$#{bMrSoAbfkoRs!vZGtv?U4PkOee+3;92a3fhJbj%HOw+m^Oz~1 z)QVWPik8^?8XcWFZ$`k(Ih^8X;KelZXXC%i9XK^6Zw%N?8DOh4alG|KMXPUrHm$w9 z?2ur{7JjHdzC%Fu`_PJfK32cIIP+$34IL8p=pB(`BP^r-9N_l#KPKIq=w=~byd2JT z%Nb(PefLRfVcAr^diO_jN6GASwE`@q0z*g=fujOqN{DRs>8zqhy*y5 zyY@kB&SyVHmRU&8SW)Lag((I`a*C?(1{rfF0#tngsuC1HnxnK3S=crs1u}NT!Bvoi z)d>&ZCpfsN^(?THEKIDBN;`!v0jh58TMLXu3MRXo zVV9lBmI@$^R$+B*Lta?gEp#8moa-XgbpC4IJezK8oqD^X!H<&P4clJ%)%kPFJ3oV+ zn=cCp5(CFv8xDb3NRN-N(H6_ z&WUHc+}1&}jlme*zH?=v;m(rOs_UUv5>j-g@L7I;!f=k^y*hUtPZR0sEoR8f$G8kT zHE9sddtBTw;hz1elAKO6@W6LoTc6tk(-#HoAaC5$k*X|6y4{B0#QKszn@!LZjf;+> z5b;scRW|t!l&QILW{Ttbb*EGs(4|8t^N|}K?&1tTR?E*k_C!dHqqCEyH=#!M9Z~5I zBIeVNOf&u4)t(!QlTn#$8sgwENO35bZZia|m>L2l(SPK-NSzPO!5mf zT3>&|M3`s&V3=TdI5o{vXOnWpeobx!WG*5$X}j~b&bcF7ePH|frOMS|HQVRV-vBa= zv6X^By%??9fnTYA<{g<9?gDbgk4YDvv|u*)qYw0YC8B%$IA!q!Z{69SuTBdLFYg7; zSgj`uEh&nSJKu^96?)r)DrCS6zePc=85R=1hz(IJ-fW!GZ;14i*CeOBmUFIa4r^E{ zY5l#DArhrWo4~;8z^FyS-gC!adxCN)E{wq+H6}X{z}VYR?x$akf|3s)0ESD1zR)ma z0*W~84$e(FZit)46)Cy~VxdVU^4GKG9E%**9FvP@zP^vVyVJBN&jj`KYHxU&-cc9- zW;unU5eE?xIdOtQ%K%O17$Qz?ndEt$ax1Fsx<4-?a2>kP!$=49qA+HOZv%UXXn-+G zugxUJx)8?*WuRYW!v8qEV%D3s^LdSXgs1(4qLeF)yd;gE*~!aBeveg&ggURj5;Okj z6Cc|T$XCY8rhJiaRc?BF_Y4h!CwI)=61-=)l^`4;O5j-b+SoQeq*Dr<({*{@N7_Cu z_|ncRSyt2*_(8TM-bVd+k!50mTpq0nDJ%Vz99qM(x!l4QUzKoavm{aB zzOiRO@iRGieJ{>%Kyv2ToZz5i^jq|2h*jWzVL!`)XRAVdhd*2rb?d;(W&CY*~-qmVvFw3l#UVN^>`*g}*?hDj{!a_5g?_@pysy z)IB@xqT8RYA5u&-mZSQ*xttc=ziqsBx>G)bZENly@D`fpj?L(D3OcVeWwHhTy(_bjyWu+mar-S=%CFtJn z4g{N31Kdju6qWJFS6<3{ezY}~EwX!=dPK5B#akr#znc{-@uu2>-j zNoWBQUIGbH9i7ui%Y~rH&(ob<$|l(4!D*O+z_~E0|94I5XXTn18K-m}b)E z6|BE8Q|qAI#&NK8ntFNsuKM0i=oL^@R)AnfOQ{|;(L-^B5Q$_b- zIYaDhLcG;9x`?DR>U%_N&h|?6OhrEalb54c$t$=9mf_uFhe=z^iUus|uDWZEwW#i# zavf{ZVePZiN9I+Gt%3Q2Fva9#3l0l2MKOUB<dIRQikYfB^a*DT5b+aAXCfy1og|a+=Gt z@dQJ|IB{dj%K9X}UJm<*>~!vKo-0tVaM8(c#$w=4V@MSr^5KH$uCtR%P-UAYh>)Pb zaU%wAH;J*ofGlrp+Jh)s{<*4g6y)RZaApn)0cTB*ehL0%9CdH_nZ-<8;8&?t=1qg> z))88JlFH}2I?Vi?8?@A#G53n9v?x7vdqejq1Sghhvd5vvgoy$NNHh6QnkBJJ0{-v} z&SCL%@z`0NAaNy7)2CI6=Xj-~@w-SBrwx&tZO?ro1#Sd3jro-&%=fP!g^|pgPzG&e zb`|`g23}@mi^*YVLf2@=f4k)j&SRz2c!X9ZxGm((yaVTmm0ha|uiu6Y$6T*`4F3zn zPE&Q-#zX0Ov-f326wgu7D)-=%R_;^MKEuKW+oLJvPApvSd7Ar-RkxCp zUTZ^COcBZ;pCsD-**Y3%oeMR6ZY7ezZ%^63zbH5Tr)x}p<=BVnr?LwQ>GaTHj3FoA)(N4Ts;cWe&IG6odK4vJQhcrmn zJiOh~ODseOYKIk8lSJx*c`j$AVp7z!Lvj{vn?3~4>E*^hJz=iU7SAZM7P?Opd!X@& z+sRFrk-$IE;Ph@4U;i3;#40wPV;%8D0%ue!b8~VXvu}k-siXZC>+T>z5_}{B`-g3G zWo<43Y0tH()s~%4r`3ds?3(Rrq-qG@kA?T~b(Wgt!QV(RK0BkV1-gI;NF(gu(dn^K z?zkw3NcrH80Q?&Y!?goXG7=+Rpi9M?{)~&%wmbj8@#@PpG1-)c+gmBw2QmGE%I*=S zBf?H1;ig&+#ItLrqhvCJ0G?#X=baQqok5L)8etRL0)?AMuSL^fYWkAOQMq_?t<`xB z|4=2>1oIT!W=YYECrBy3Z3wS!H^TiYoOMMOu4H#L_bZRyVgFE1q&5TUaTl674Vc~= zqK&GU?6Z=!s~Xu5DuN1DRDPkM4FV!v%VZ?izQCAsUjLyQkr9ed^e`Li^z@}MxHt8n zz3K9GLfEiT_Ilz+*NLN|y-eWElJOeomd!U{qNT~g{at#&qP_)dC==mGpxtJ=$!gp5 zj-Wwy%ZvC3a)FGR!pN99B?i;gA=T!5u)y}-QU5rPb{FfiFYCKWR1tgOS%bGt4ttVU z2BkvIB(i&sCuTPA0ZYj-a8LmMbh(Q}p)HKAHJ_!`!iZbq#mggJ8y`Y>kn4=2vH>zm z4`crUO7C?;x#a2rdhY#SE0K$JG6R>a2*|qfF)rLOPm`7IRbx;q0(nf9M&>YFwbDK* zg)>PJz!~%5)FtE{w4_-Jfj3& zW+OGzZe=ko$JwFl5Jb=<%vZETK@hqob1xnkBu3L_=X15?j*D zdr)Rf-N{5Ttcde`&(D>6XzCqU=6h&cczYx)Zosv>7mlnSe#WvEIiJE#N(o$XJ(xf>Kqh7#7LVJ$ZsX9soDq(UKPqRyk+VC2V~W-a>6 z0RSG?%TSnf@sSq`m{}?bz=sJ!CQ&atyd9MGz^U8RMHAu@I zdoE$yij&84p#?kEU#273HN$JYaf)-XMSdNg;tzi+RpOh(JITmOPk@Z*gk%j3V);I3 zr*~HU5;L(Yxm+gGv! zd&ww0L(;gW%0FD;x7bs>I|B4hnT`u2N<;Nw*I4)o43mm7FV=WBvxm6g!c{E_pl||9^N0@!u;8RIHPVg_z0eb)F7`CmJPHpO1-ChR3a; zAS2T@=TQHd39BKsJUeTP0W^c_+iDY%>1I{f0}p03BkyJH9>m+@^zqi8K@?lj+$UV< z;?DRM@uC6;bP5v>G~V&N^4bQ-Gq%pl9v8k&T1cmDW%vTT3i4!nHNRZ2X1Dm|(@1%g zwF@x>u_cQuLC1@N%~s}18^BZ!>O2`K5G8DPdZoswj^+TL{O z$JUV{t_Ks@U1Q}(@aramzXh7gEA43jTK-QpK*=p;lVPpM^p6h9hrn_BHf#m7(DQl9XlmwNfdCyOYGhe6Cn+zQglLr4+ zei%QRg}hdx_U8-E6GGcMPP1qjlBE-ri0ahqr>N@_%>?}>4$Br>6;&OA`q3C*cNVHf zKBHKunB*=uVcC-~!Qybp%u>?^9n(Q}1w`MwVlX;Wv3p_J!-r~9yYcqM%I$um+80c8 z{qx3UihjaAhyYg*AItk7&r^-RWpeMcS@$8Ip%Yf+!oo*dQP+$%5yYOq!u-i!GKY!C z!RxjMiN6gv{CL!*K|77%ex`ZO0f7+PbG=>z20u)7N$7V!>ZRwvF#%D!keC0*d%8S? zC_*&G3D5SHee0%E;gq8IcVN_4Z|)YqEG*a(Hw+Yo0>+-9F!*L|A1%y|k2&b8Hpti& zsXe9U2r}~R2+g!;c_$e{DINlnkM|xrU{=$1gU~?u$M4&p`c%p#cWdff% z4k{sSss-8--8x{&X?x?*frPDspa2Z7IA7XD>(B3!JaN7v15W{N*;T3Hoed@ek(+6$T%^qW%{iv`v3JI;(ssQ`tK3#f4$pf-*-)iz0yaJ M7FQ4}eyx>FE6j4prELzsHCK%tgNh}qN1v*s-~u< zuC5LSgEcfXZr;3k>(;H?w{L4|YHDd|X=`iWxpPNHM+X9d=<4d~>FMd~>l+vt7#bQv zq0qZ`?;05y-Me?s*x1;_#KhFp)XdE6{{8#r=H?a_7M7NlR#sNl*48#QHnz654<0;t z`0(MQN0036?CkCB9UL4S9UYyVoSdDVU0hsTU0vPW+}z#WJv=--Jw3g=ydFP(?CtIC z$rBh1=IiV0=jZ3|?;j8l5EvL36ciL392^o75*ivB78VAF!x0EXczF2Jr%#_f zd-nYK^N5Iu$jHd3sHhh&Uc7wyGCDdsCMG5}Ha0FUEEQZ*Om3UtfQJ|G>b&;Nalz z-@k{3hK7fSM@B|QM@PrT#>U6TCnhHT{P{CEIXN{oH9b8&Gcz+gJ3BWwH$Oj*$Kw|k z78Vy5mzI{6mzP&oR#sP6*Vfk7*Vq64{kyTTvAMaqwY9aqy}h%uv%9;yx3{;yzfT|# z4h{|u4-b!yj*gFyPfkvzN~}YPK0y2Uj`tMQD5n$^D-w;!Ma1x5r2EOL!Fo;ueC{szcBJS&=rXs4X5;lKGY#n1 z(#jX5nvt<|NZ8uDdH)pM;VZi;ZDX_I`b+aiG}WWC)$^|#oKxkVL7yKg7>&{(Uey9v z_k97;he`m=FkZyvMka8gZ4RyT;a+Wr))&j7b)4k{+i`Uxjn|Wd;)ob;OhxpIutzyn z3hDMErmL4b+;z=+kfDaZVq;zw-CGq;wyLso)F?~u&adshgDD5-=koq-Z{=6HX=Cj7 zSLd8DC)V2Jy2`=$`be8mJ9SNDr&57)OS65Sire2+aWq|S`%>%{gdR&fWA=B(x3o1# zZgA>&3KH(v=N_b^vcT$-%m~XodT=j&_o6bQdFIu@tMKqG2yvGAk})BAtfq(r4D-yW}qj;;r%Tu%{7uyPwsT7hm!z_2%cDv@(w5J@Eh?f`>YNS&JYoW?yO zk_ok_3V{cF?|;(dIwrTj*#dMDJ`zNAJ@vorhE^0k+Q0exSK8LGa(<`H@Kg7XFn{NQ zlg`-UfJ~gfPV2q|GS8kS$WVFYW(e1Le8jIAXHk#+`{=<+<<4mzz(6!23>+i@FECI9 zb~CX5ZrL2e{7H32*CZ8k&5Vx1-80u=Jd* z=XP+FlLiC_+Jdne&G$3ndi-}&j-qgCGXjvt^9`bb{uQ0?Vf^nFO6+T6IM%qQ^^=6_ zF<;g_mbD^|x3uo>f*?8Pxv_`X6rQ<1^x8ux$Rk6Tt)%?`@rayExH_Kk@Z1!koB1VQ&fHN zWVU9pOAsr+e5Kt5$uAS4qT?qe>peGFL<+AI;B`t(N5=^oQCGRKT2n)iX}s^o%c{OL zKf={>4gSB7P;P92ee`$M5ESEcIM2>%2*7AZ`|kuUU1f3^-j)E%*&Z29b{LGAGZcJQ zC`~mh$*hdeV7HgwR8j`8F-Q6pTuU9lUp{|#)(0;?Q}QN_z53JkE=nfYHv zF~NnVO6_m0%s8{zeJ&kR%g6`3{eHX;=0AVz{kwJ( zct`P&fzVM^%%}&#n#`1ze;_W#qtFXmlGQ&{mQk-#!+WGKWz*JmRpoDZaxmJn>??{| zdw1uCl(@XiXOPq=m!-ml$9Q!%%PPX24S~Rvw^%Z>Cu{=pTMPsYf|Iqp;7gbA$KRmc`;9t;+t>>OyHDvkptxlR?;<@GH$5J zNX?CMfa;(ye#k#Z-K@g%Luad5wqMMIn9%W?Z07}v(nSdxRPfET&P>|^*TOxwY;AR} za|55&C3MtN67Z_NP~YB=>!1v`(2HS_v}9!*jf?gtYr_0rJ(PdWFIy`Hm$pX{o%714 zxz2@Ov)!f4mXxW3Rj&DmO3Xr-P-VdzbHTvbW(4SC_NgO)P%<*gidCzE1ftU zeIYy^5s3fdj?xVFKas{`Rs|Kq1QwY}? zzJ6Ra8I*C4+Dz~pJvSQ=&HGbl5!O{x1?K`7@nm*=%KIU+JHqd^m^LkZ1k62WO`mQ$ z8U?igL6168#|8H+y!mgt(1N!miiTAuSa&6nssA6@h6eQ$Ljj!`1PX5~l>J{pS zRb0)(yzGyFa0T}cuDh5Jr-z!~W`=)x&9G%~r2d&)8$8pt$%HRl*QxbqE`WV-wj5M$ zP~Wrva+?s=7pY&_co$|9(jPxkc^CX5*&n=?epy@vSNXWtgyoh?&|b}`Ysa;t(vX@X zm9YV7R&XMrj>00Zv1)z(bCZ5!CF^Rdn2DN-MzK-qot@#H-q1}g3Spxxf3Q$u#b#Ja zz4|xinV+UfdwhJ8ODppc@B|RKb>YqYN1fTv1_@!JBDb`ENi+{$`jxM{Jbw*wSwE20 z7(W{8W2oR>*Vj<@)h9+LMA3dPWoMHpJi8pQ;vA~YWa0fQ&!&2+Dde?9)ym`Q2Jfae zNuLayacOT@CP)~EWJi7EiWWb)SX-Pb_i~=YMD$Qnrn2S2lFPV9mJz|)o;VvS=%;I9 zUvzUJYt92%T_C+#NB(u!k=Fx9+l87O^&j`+0hfNf`!xUVr2om}9#2`|!giAX)}JGBHK7^hMw~4~`yR zI;*sD=2GhxD7x0m{!Ty*@5a*q#kTjDWrQMZOVd17dsU>&JMP%V{q^~jy)@VS++tpO zs-+Ff09*OZS(mM!*)lfwepiM${Xc62gz0HwinOxUZrp-)Chs8hUUwFjoaIONk2V5~M-_@)ZES90(r@Xds}Sh}KknIxx`K8?Y!2 zn59N-0FdVqi?V5~2vF`6pwAl6&Iq0b3JU@H-Q=zTsG!Zj+*$yV8_`YyHOLI-JBg_0 z1DgYLG2xE=myV|Ha|4iU2m%+r^Xu+)V~dX808}BMuN92ZZn%lry|OuDNp8P@e?{jw zInnTi-v0ChJN`4`DeW;i4WaG*jpP*^HY0Vh8cjwf)WNV zh6O#gKWVFUUy=d%R!4Cx{`$SIf+z(+nZb4kch+zh2Is8?rt&J1xe(&=*52lu6pG6* z^2!9G%7T285Uc4L3tx^azHlM@Jm+f!F~g5@Hc7Kk9c$i2A{=RH8r(`1MCIiChA{he zKAnn%{qoP|ItJ=()cXIr+tB&v@IiEp)dl7IHyx}xGp+u zY769|A)1`$ptVW_biI6jzpSZI-lE)D5*B6dz@HkHQZ%CbCU1<9z~TD@c^#G4t7Tge zCNkC#dN6uxs7|Vjv#>v7)v3^Z`^9v1;gwYbRU{G>re|78kmQ`x+kPg~Bbc0?>tSV4 zQ{nxRh_GwA)8O&0R7nd)?5JcxOjrx_NE)vm9&^Dhh1$wbAu3D5e9{T33GQ)N4I6ow z;fgA|*%|w#ZSo#(H_0p}l;y4O`p2GA{~pMr9^P}Ai#V8AcuY-#lEm?A*z?1Lz{$0r zS(;8{ynyfp$-m{zjQ&i0kS3cRAd|D<+;X*fSjD8AfdsMpC>N13;W2PPN|td09!KgF zM@0a->)kEq9KzsBsLV`Vfta)bs~@8pM_3oKlg<|vy->WUXJu6?G;cl zv`cYFYd0xu1=(Y6piby{vh8gJ3P#vTE5Jns({}dPr)$G0 ziVv#G$%D?IT-^9%#tOFH)aPWu=tztKDD~TKhvBb_VNRGa@eB}g<@@<_XN&#ddB2BF z+%X3vR{82!{pXtxqn24fZ_EuzPO`|nH5uH;>$=%6aGo@y8VXfCHM7b}$x3q!7ik7# z;X6g|H!Ais)6W@_^jl=y3Rve!4%Vf!x|~V!nSO4(NMe5V=x*Vj1ZhA@i9T4Xb^D~xBs?!mqD1$!QH7yK1l;!==Bu?v@?N^fcPGJ;;Kz&A6PXkpF znGr-tfuQQZAOZX>fCD8e421M^p+m(2`fL$l`a3S%XNZa+lN?cs$y(0;5wP3HmJwDk zCou-DfSD85WaBAGfm25rNyZQQ6@{TP`zB8L-CR2EO?RPw{_Kc1UVqk*qJDKd zgti+_r=elyw#PIM_k|o9bj-=2fnf#ASQC>2%d7GCERU!S2s~M>4fu{=SAnWq9^C;X z)1cDpC?E+``JqdaBpV@p*i`kH(r?Efg-_e2ji_;B3?vaBEg`k-Acf6m;WtkePsd3<4` zF#1%*1qx*G#n$A6Q`-rl-c9x*|0BwSMP>znBx?~f{qi-KE&r(sK(I?x_G(rY18U<~6}&qS$;r`TvT*UAvO@*`Oz|WxQ5~ES z`&$i{#kCp5)5F!+TY+l@yW|i&{ppB9#K2D5i-N$T6@AFA!RMlFS*$>|$tqE79h@Et z35I~-7Pl8>&o$i~*jX8w=WCx!b|L!M6I)Xj_{d4Wp1-uzHI47?ZHuk;Z>9U0aVlxX zJ|8N)T~b@}X5Y#-duSsMuy<=>y;i<7awLejFS0adk2=DrRa4%b95z4ow{u?# zVV040m4OQ&+7D8IE8dZrp)0ffJGa(Vp-L4hC*S7*#^a4N!Uc~2L6;sV`kxkOT0nHd z*!Qth@I3@K3LONbkt326gL7DsTAe=GOE{^K-SjFwLm)B|y}`XA^-cc~3p3cIWyaHf zXJi_dNB$#_@z-15oFR`P<-?vw#bgMy-9f<~^y>|{lC91_71XqK%}tiJE;qJ zzJaov|9(3g{4m~!oJypIWG!E`J&nn~!1ED5y);f)Q4?sU8NZ#5;L1fWDhw(8Yk(Zc zq!fY3YCT4YP#k+(Q<3L23GQ-m*!_E|BNH-SEV#pgkvx?aiu!YMZT}Hy0V`YOQ<2OF z8%FQ_0CO_y5CD=X&Zj{b(Jm4P=4P9Hn9|I!brZ`&toyEGWI()T$S7-eY3Oicd@pf; z8CUpqOjUT8LHanF7Cf8miprUV>%)qx!ZQW9d3%WHHe%e$%~{K9X6!TaE}i}-1B6r~ zR81?M3Z#HNLQWR}$?AI{!VGyPn0Sb+v{2`lRo8aGm?Q~e@s(SLJ5%m*m(S098SJuk zKT4Xcjfu@)iqM*j@0_QcC}EDAQT`Wz&_Fbcb4z;>GSh1}EHcNMT^(!tbB$P)8QZu} z22HQN*hZ!XBa57NN;;-!QkVCJO3BaEw3u>Z(bIt*=9+w11zl$FM@Y>-E5glY69t}S#*6*HYuC=O{h%?JqjHvCp z_0mjEaM)Yzm<2mSWmsRuuLTH)Qs)yP0gtV}hQ;=b3KCu!FLG9Ej9*xoYT zy1)z`JWTBoX-)r5^w2t1*_7@x?<}j*U+0EZj2ds-m3CDx(zs;mU%#p|QWY!eG0h^& z@8Xl$5?+@k+uDs~l37}{;ODRPcE1}Jl)37D^hZ2XZM16LfWiOo24vb=r7N99;|y)E zKt^C-)FBX$311uG02!>x3_5&#_cX~TgdYq2Bo)!f zq=axA=^`Mp0Bdg}2Hb*TQW>qd&xJ3<63gy0q@T`4--BpR73C5>Dti}7eerP zx9NWbjxWw69!MS|g5u^;-@c_o)*z5dMmayLM)Dtl6c^$)jyvtAjC#{ra5b0nl(|26 zVfN>IU+ig{E^5neL!HeIKvs!8cQ%o$Bf+>F*HUDu~+lg-F1O?hW*vXeZebSLAS>z%3G{xStf-D9~ z`A(%&^dB=DyBq(eIwp;8LLBc1qJwi@=sMYaf=!E#EWQTH$Py&~*I51n*CFr&9UD$F z)e^JzD_P2}CHCb3E&!c+uWCdEnH%^(CHP3GG*wy9kocfzZ~s6)aQ#HRCy&opJXDwplEs1 z+e$u8;5@3&rmVx#63pwb6^+z_|dmoNn~b+ipq@ZK(tOp|5a+|AoRI^ z?Pw?4;J`08yc49i;1UdP9V?2&B*6>H4xT0Q0O8u#)JW?#AQy++%X%OgnYR!)v+Je) z^kh>?f+eWBoQV06gysvVazmL-T`F>m1{f}oRboooM9w;%g%aSEWj4e+WD?Ntf+e&W z915w(gM?AAaF>FRt7H^K0>zxoEW-*;M_qshRdgJ!TV>OwPwvuJ?s)xNpV?=OYDN0=9n<~ ze2RFGChq8q`@(r)t3lykT z5R@3FaCh0HkO@FCGvanmQf%X~MijXxF(7SK|LllvMN*>7ERP*jsh|c|8J(wAGT0_c zt^)DFpQ5%|!HUT;D42kGHZ1l8s9G{Kn{T;jDiGXE1(-FSLgZH^?JA=?H)NB6 z`rX-lWh#2lGkg8g0gHlb2pm5}>M~TOWeuTrh*&r5-WbkqHTz*WYF#45a4 zd~j$MyU8x=PI$cbEVaeJZ;{Mm$w7WXWYU|BYa8 zeL)1;>nA^wkMaH=hAk~KoZ^GJDy043?i0IvYaGGlviia`##0`Kv?qcpP$BD)L=Z7B zhvS~kCgaEIhq> zJfmDu*fVWz{fu|OkVsRbj`pqDHIqDHB4T8rlWBMHX_>8ioY+JBC8l}N@A?JPPv>98 z%xV2Ha|f5Ds9ZRExXk!)^WM3ffe86bzCOvsWBL4z969}4&z5`Um3VGgs^~z@PZVqn zX0io`x@PASt*it=sD40cJ#iM-LH(NB z^h$j%eqe(!IB`{e<=F;b!YjUqvlAnI1gPXSu^gAA?oV^Mb63_EEM4PS!PN^unW7-G z1iM29XAE`sm5tyeA@`V^4;F%Fglau&L*bKiyGA{w#ftwCzn z;`kWc>rB4}IXrCUsx{%chVbd7$X&m%BV=fINRKaiWiIaK)4EzFvC543y^5C9SSjvk zMJvE-6!}IY^l0iR+#NU~r>&0-S5xkJq;VioVN zh?8jRq1$D_Y}5DDnxD7nWhjS*(V(@PnYFr|4L+Eb@YfQ0{jn*khmUg?hxCM^Ga*w1 zUYSM%uL$M8Icq31Deh@BpuK))H_U{`jZ~go9x31l>YvHNhoyV=&}4AHOor|dXTy!H zpD7rck%mZq-IIbQF!+`s=kVawQLMxAex_nK%(@ilLSh3LO-nvfy7F>iRy zo6&xmqV-r?fPT>pNSgw0xaY+KP7Wj~E>lA2Ti8Ma4?*}kRAX{%?>Xmj-lODLQOcU& zoSJJuWbz}aeShB)2?CdMlcORw-Pw>i;nP;g(BIfsX&cF<%V6pJNcX$4#7tylFlYIw zu|AYRrbu?^5=BiU&pny@hA8j%y)z;XL*d_sIzVn-F@L`OoW- zaZjuf7O5)P?&ZZ^qc?6?eB zcy0_*;RQ>rhiqU}K`#n-RdCcWgFlL?0~I{BFGPtlBK78jaQEJYg0|wca4YMn3-=(l z(TBaXxwFUYbp9XLEGNoCesA8PbtZUBDXU+RFUUK*>JMm#Fk)@>*Y0O|t8CZ_S~1=A~mP79z0vd zjE7B>YfK`EdT&oJzLynK0|fmlPtTq(shoPY;}o2k7uZTQIkP!ndymW3yJU*fm%1i- zc`6|=zhW;KH|>zs7~s4KJZOLFnFtv-ctK3?{b2azs1N|mXowYJ7%2}a!Q4?bpO2?c z$-1(AXU+2Cceb#$yjAd~TisXQ(zxg2S(;)iZVGVDDFN0x^Oy@n6fnwEPAN=>&uObm zWFDR~s}hvm_sJL$$Pc?UXj&!qW0U!5#KIAEg;(-)=wpRHZ<6&&lsGX-rQYl%v(!K4j}WuK2Wp+TK|T zMRzK1Bpy>CnetbDJ`NtDi6$1?L2a#b-5JXA@pW@yq-j&(gG%*}E=CPy#_!!yQIwo? zI+%DVT5E$b^i;l_5%~G?bPzEUd&D==D4S=0{EiO9=sM^zu()Gpw6 z$P)W#s=d?F*L}$r+A(2hVz;m>je=Q4H0?f5W&g8P7bp(Z721VABwkyjB2ujz1oIu! zE`&su$>w14%*}7UDXrM&#;X6UtU#Z?)SYGa9X|B8TFO&>h>f8XX!jmRifV75`OVc(arua}!Dd57pIy4M#KmBAKK}davq8aJ zLm@uA{>I4kuT-0$Wq23Q6FLKHjarH?25n(Q-Ay-*4p=8F7#9V*#7?D zZCOTqP}3&*{ys0%({qC0X!X;3RgS0%r|_5wx@AwTs6f4X4@dYqPls3Noo^afsf(1X zuZ}iTR5F1e9Odc~mOw;3XdsyKJOcRSvj>F^n0d0sf)D|7VTCAF9bG8-_FlWs(5VPX zJTV7lZ^{wXkU$JapFB$4E*g76tww0CL+`!{-j`sp)MC%e($6mkpzUr>D-iE$lXt-x zW$v!pHPY$?G59X``&$fqpA>iZd9n90_E12O zuA@0=k&cE;1*Mk{u<1MDC;e(^#@9duQ>vX96(ZQ)gCo2?)ZaNv8;U*dt1H8})SlCR>deOa3hc}E7u6I9L z>3{RC%r?_Yh!UmtRzDvJ>Z+}LAJANp)Kga*bK-av?M+dnI|lE1t8RAx1;4`MKlm}7 zI+m`NqaLJPH@5I0^eN%eON+T*Drp|57R##|(3F@ln)vSFHY_{cD|MLw&lVYKcVwai(-*wjx|&Nza0da1ftSz1)+(j zGrfEAZX3=$VEFm44V4?3R!Wxv_0A`wk4Kvi9?0bx1#w7}4{T|5iBCN>OPI=Pyua?r zfS#9na**{!^e`cG0^oW`TvQI>3<$_DI>+XSZ)@320>du2N<22_*&h{Exnrb$hXj`k z!l6&1w<+N|kBAlwq3vTQ-BS`b>5RlXL}A2rCh!=sWFnuKgP`?}Ngyb|gy;YFV+vPL z&FT#d#R${m%IY<&K^z71TI{bIBjVe3J6_7UC0y}Y)@Bk?nqh2gudh{uy%f?V&pP*{Jcr*SD1>d7 zA6M&X!ejB=O9A6QubG?uqS@!e6F3O=0lPmtX zb)-tMJh&FplSQY(yjgk}KKHRHG(>OLZeK+0Mi6AMpvp_>3xm|LzW@;(iNBbg!>;RR zZeFYJQ_kWGw#}-q=^#kstBa(ssj4Gd&J4o0gxe+^v6@Z z7>0~r23nLgYqxgow*X2(3G2_~#w67;JlAEhVjb7I8Xg=maUGNo zl23It!>!4X-3Zw%rGNIKa#?J+d9EoZP)f&mEd& zKIR~;n{|8Y-SN-+4CZcTAqx}L09^9#C-5;czB?s4>dZ=OmMGZCdU&sqOJ}D%wL$;h zvdu27t*X-0t?U0-svq7w+^xqv$~NFqxHe7$&cIyet!u&3=4He>G`|X?4*{@p8h2_p zORxP@k8!dgJ}+oxW5ynqJ&W6Ov9Tjk?@q+y&6yd-EO~l;K>wcR{r9>{HoN%ws}h{EQBi$e%HyhCR_6myX zi_ou4!!h=KEPwgcONLlvirbr|prWdTqT5ucmMcK?*g;XEw#pi&N8V0sj`ax?!?sOzdaplyu~ZCwDeL{1Ogs>b@9^Fv-zOp zOtQ!~%0fA^UW!h=7PNT({^)}ehz-D1j|GbXoeW=iEv%B7g2<3G>NP8Z z>)v2%Jl~kwwE)pELsRQ9sK}_Ea$V}}ESL3rowxL31H5hX7{PHmhq^}Z4pQiJrSmnn z37f^HFcY+sbBo9?wje9