From 5e367c05ae9d2de4206625e010dbe14fd0e002a8 Mon Sep 17 00:00:00 2001 From: GitHub Action Date: Wed, 27 Nov 2024 22:14:32 +0000 Subject: [PATCH] Automatic readme update --- README.md | 65 +++++++++++------------ man/figures/README-unnamed-chunk-4-1.png | Bin 17325 -> 17756 bytes 2 files changed, 32 insertions(+), 33 deletions(-) diff --git a/README.md b/README.md index 4407001..3860c7a 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,13 @@ -## *{{ packagename }}*: Tools for estimating vaccine effectiveness and vaccine related metrics +## *vaccineff*: Tools for estimating vaccine effectiveness and vaccine related metrics [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/license/mit) -[![R-CMD-check](https://github.com/%7B%7B%20gh_repo%20%7D%7D/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/%7B%7B%20gh_repo%20%7D%7D/actions/workflows/R-CMD-check.yaml) +[![R-CMD-check](https://github.com/epiverse-trace/vaccineff/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/epiverse-trace/vaccineff/actions/workflows/R-CMD-check.yaml) [![Codecov test -coverage](https://codecov.io/gh/%7B%7B%20gh_repo%20%7D%7D/branch/main/graph/badge.svg)](https://app.codecov.io/gh/%7B%7B%20gh_repo%20%7D%7D?branch=main) +coverage](https://codecov.io/gh/epiverse-trace/vaccineff/branch/main/graph/badge.svg)](https://app.codecov.io/gh/epiverse-trace/vaccineff?branch=main) [![Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public.](https://www.repostatus.org/badges/latest/wip.svg)](https://www.repostatus.org/#wip) @@ -15,19 +15,18 @@ public.](https://www.repostatus.org/badges/latest/wip.svg)](https://www.repostat -*{{ packagename }}* is developed at [Pontificia Universidad +*vaccineff* is developed at [Pontificia Universidad Javeriana](https://www.javeriana.edu.co/inicio) as part of the [Epiverse-TRACE initiative](https://data.org/initiatives/epiverse/). -*{{ packagename }}* is an R package that offers tools for estimating -vaccine effectiveness (VE), using a series of epidemiological designs -including cohort studies, test-negative case-control, and screening -methods ([Halloran, Longini, and Struchiner 2010](#ref-bookvaccine)). -The current version of the package provides a set of features for -preparing, visualizing, and managing cohort data, estimating vaccine -effectiveness, and assessing the performance of the models. -Test-negative design and screening method will be included in future -versions. +*vaccineff* is an R package that offers tools for estimating vaccine +effectiveness (VE), using a series of epidemiological designs including +cohort studies, test-negative case-control, and screening methods +([Halloran, Longini, and Struchiner 2010](#ref-bookvaccine)). The +current version of the package provides a set of features for preparing, +visualizing, and managing cohort data, estimating vaccine effectiveness, +and assessing the performance of the models. Test-negative design and +screening method will be included in future versions. ## Installation @@ -37,25 +36,25 @@ Our stable versions are released on CRAN, and can be installed using: install.packages("vaccineff", build_vignettes = TRUE) ``` -The current development version of *{{ packagename }}* can be installed -from [GitHub](https://github.com/) using the `pak` package. +The current development version of *vaccineff* can be installed from +[GitHub](https://github.com/) using the `pak` package. ``` r if(!require("pak")) install.packages("pak") -pak::pak("{{ gh_repo }}") +pak::pak("epiverse-trace/vaccineff") ``` Or using the `remotes` package ``` r if(!require("remotes")) install.packages("remotes") -remotes::install_github("{{ gh_repo }}") +remotes::install_github("epiverse-trace/vaccineff") ``` ## Quick start -*{{ packagename }}* provides a minimal cohort dataset that can be used -to test out the models. +*vaccineff* provides a minimal cohort dataset that can be used to test +out the models. ``` r # Load example `cohortdata` included in the package @@ -109,10 +108,10 @@ ve <- estimate_vaccineff(vaccineff_data, at = 180) summary(ve) #> Vaccine Effectiveness at 180 days computed as VE = 1 - HR: #> VE lower.95 upper.95 -#> 0.6991 0.4975 0.8199 +#> 0.7254 0.5437 0.8347 #> #> Schoenfeld test for Proportional Hazards assumption: -#> p-value = 0.1273 +#> p-value = 0.1507 # Generate loglog plot to check proportional hazards plot(ve, type = "loglog") @@ -122,22 +121,21 @@ plot(ve, type = "loglog") ## Package vignettes -More details on how to use *{{ packagename }}* can be found in the -[online documentation as package -vignettes](https://epiverse-trace.github.io/%7B%7B%20packagename%20%7D%7D/), -and in the articles “Get Started with vaccineff” and “Introduction to -cohort design with vaccineff”. +More details on how to use *vaccineff* can be found in the [online +documentation as package +vignettes](https://epiverse-trace.github.io/vaccineff/), and in the +articles “Get Started with vaccineff” and “Introduction to cohort design +with vaccineff”. ## Help To report a bug or to request a new feature please open an -[issue](https://github.com/%7B%7B%20gh_repo%20%7D%7D/issues/new/choose). +[issue](https://github.com/epiverse-trace/vaccineff/issues/new/choose). ## Contribute -Contributions to *{{ packagename }}* are welcomed. Contributions are -welcome via [pull -requests](https://github.com/%7B%7B%20gh_repo%20%7D%7D/pulls). +Contributions to *vaccineff* are welcomed. Contributions are welcome via +[pull requests](https://github.com/epiverse-trace/vaccineff/pulls). Contributors to the project include: @@ -158,14 +156,15 @@ Otero](https://github.com/jd-otero) ## Code of conduct -Please note that the *{{ packagename }}* project is released with a -[Contributor Code of +Please note that the *vaccineff* project is released with a [Contributor +Code of Conduct](https://github.com/epiverse-trace/.github/blob/main/CODE_OF_CONDUCT.md). By contributing to this project, you agree to abide by its terms. ## References -
+
diff --git a/man/figures/README-unnamed-chunk-4-1.png b/man/figures/README-unnamed-chunk-4-1.png index 3d4171723c8a676ff9d6439b1415426bc75e0490..62eeb4f2dbca279955a0859a59e7513b34316bc5 100644 GIT binary patch literal 17756 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 MhjJ1*;?G|FH=|s3uK)l5 literal 17325 zcmcJ%2{hI3*Ef75Lxw0K3Q01Qgiy$l%9tTzAu^XS^E_loNMX4 zc+At`-RJk*|L1|=DcEW=9fP=k&6;g)5v&RA(y7cX_66{{kBetPraDOhC{ta zWu!?_i&8M;Dc)ek4=mQo__D+W#XEaHCb!&oS_aqlL>jXwj4S5ZZG{qG4V$SELh#pJ z5fVlOf-ZFe4-vxrU%w4Yp0FIPyhKk=&%j`Q{0bkTC@ZD7vADRXS!yONFE4PCkB7)& zz5kQ~;Ys#<1A+KON$`LD+icYNjTLu>2b;}nqe_{MCS&-7XHPf0(HsZ_uevwsnDNHz zOd76qd5mqo*=VdaCKdO}CcILM31L=}bTpyR(+lI)3K1eeh@F%Z{$F3;|LeJ7sfx=6 zqgAwYG&k)?rg_SWOht`8iMJMnAzrIcS3e(gb}?>lk$jfGX-Ap1xzOMFyG3$|8lhOF zxFK=rzP`l7Cpx9fyNPi}yXK37%IYuJ?I;mhcK5AF{!g}-?!;xo?>xg$p{}=D?&_bE z#)a;*NRb9I1R{;^-O*UN)%37sUBW|`-GEECEJiC!T=py)KT{wOoDDw+JPx-P`|~ub zDl21SV+o0fm>yXFES$zicm~|v;5hX1I+GxunWV-U+1lFLluJTNx;|RP<|8F9ua@id zHj;T+Xm24VZ3O-+M?gR6hPvGDN~IjUM)Z~l0Xztel?&YcgV+z14F>koo) zSc>47g8Z-dzIJV*H3>cE-o&Yy|vK_8{_|Y{tbtsz186|%kf%5CK?1ntSp25BLyTy2Aby$^Wv-!>|A9?jlEcl)x@5ujq_x$%xJ0)$OmHqu9 zmF3#7dNUy>AK%_*hD)50-PiHNb{^HIN$_SX&x0?OQ7~}26rIEg@Sh{+m${C}(q?x= zOSugcCEoN*@4_lbtgS!MoI~VXB4OkYt4K(2TJASA3rPyqExwCTB)1A@04ID> zkB_+am|Eoj_P6O#LI_1)`8!&dvD3i{8q0faw>q_5I=?s}e!RKwZrLOK!znXl=;MR2;4n^nk@ zef`y;67Xz1JiO_aU_rR{!STfg$z0DSMMag`F7}+Gy7~3Rx9eP7=104$9~hXxk$m0< zPf%UFxU#ZxjK%s=f{z7%{w%Pvk3b|}C)3(UOiZk(sA&1ju(i7@YCR)0kpC)BeRgh+ z@qzUdVyoqTt{@5hzt}Sf&oFp14GoPqA$hEzWnxTBOj??LFyq4jbrcFEmms8yG`F<0 z{NL}K?@Ai4aoGbrf)DO5(5ZVj*$~5Lyrll%!2|5F&gn(*pFe+A?@tB(3y}l|pFVwB zV$#>v)YODV7poU&)85fy*G4I2kBs83g!p(85)!g19e|Rs_oTH})6HxOiPdgL_7)av z`LC*C@4eOgi@`&PJ-xh7?N(*KIyF6Q+!-4g9X-FiEUepbw(&DJzSB@c?zu&PcSc#h zlDHZaM5*L{o?~wd@qaEd(XS$3aw5uCTenZ2G_^hrWYnsCR*!!dz$fdrrsewYBsaBCE(H(F zQ&m4a#6xXb(*GTJG8gdD4oz2we5P9hjW2Pk4!4HC(kP3%dlB&xP-yz?MSADc9#rw) zzf-KO^IgLC%w^!d_emJCtZOoT|TbeiJd|Mg4C)O7hfa%FkhbOCKjpEXfN6h6 zLqqBc1qFi;`sdGd5+yu@rwm8U1e{)8pGkYo#X9GmC2Nm!KyjK|`2T@&(+$rEY8gX= z7k^_=vVqZGG&Jj+4~v`YA2p~T3_NkKYQLxz0Xv@>M4Jwzsulc}md}{LQ&CzZs55Mj z3UDp=iogrA# zd`YLLr-P_S!G$Cq5S;!NUcV}2yRbG|Wm$*a{hc6u<=&e=RSxS(?uV`SCt**Dvi}@S zyn6MjCFqKv{mNgtIDwkelOqUn3_N;IRN3%N@;(ihsb*xL3Y6KuE)S?@sWi)-O`hYZ zo3OFAc0a}9q94Rq7C}K=5ah1e4!aPBR}#|J@r?KzO1*%$bn#?1I&aKv;DtW|tujk} z{3qq{-pZizix+=06_PA#4>CMXPefc9vxIhp?3^E5Prb{%E`8-#CA&4PW@l8Tcyu2k`D@(D_o5;@p;v$cZygW_lc?{X z32)!N4L_t{67Ar!%lahiprp)eO)hH2qJHHTd4V{>vnSG~a=ljpnQ-rIPo8GknKNgW z(Amn>#|QIC1yip>@Po27h%pD;v^jbkiCukhA`=xkm+24&$?;wkWMtIhxc3F$9$2(h zjU?usTDGV9ZjzemJ&0&BaYT2&GC%%Mz4cpo zxYXQbIj<~$)?&PNbZo2^&NcF?7D`DjQDm^SH9Ktj_KU*TzvCZ--;`S#EXt(R!yfKD zbl$%2xbb>xuG5#&n~384xpM~--V|+@Q?3uIC_Olp$v{q$J`fNPP^Bakd!Uk$kx9cX zTH=VQo4*t=z^!e&u@!!g`n6PPX=#0ZeVm}Bd-?WXK! z%gTleQNMoO=tqHc-G8U2m+FqQ>P-0r5_0lO;#yVqTsLk2k!%_o5@KgxI6l}qG!F|8 z*Kt2EWMgBqv|L~8&7`HFiK@KI&8?84xPUa&)7u0#d31E7`QpVr6EwSsh!zqJw;y+2 z=2B2lxN;@#1bZ}IVKa~Mf#d}sf~&&dU~`tqeLsaV72H>5nC<%NogbV(y-{E@NlPbmsp~{SmkiIEzZ2g_z=kdk00N^e+N@7 zG8^Q@uE4Dq7Z$SmOu+hkGvuo5mP^5(@QKbtR7Jt+gc9=Ma{+?XR!sjsQKge8&yZ2Vfx_^9pysxjsVSNlv zV7?tAX7_IS$NNuJ4m-WSxip6k_NC&8vP4Kp1K;BlSqv2~COC{;IDLRDP|LLw8ik|< zENx|Wmer@+X8w1&bhrfm7XaphgM$V6_>QK7k=v3TB))nh zEBk9z>vwc&T_=9vMar=Hd<+QK+}kTFD(dyvEg8^uSuGi8XlP*6`Lb8n^&Xd`xi{3; zKSEk9_ORxuX>Q)B_VV&l(uriedi5*voX2ciB!J!rUtjROw~*1WmN_X+1S|kpy?*_= z$f(oH+Z*C#k?qGb+|BfN_+o6dqv65BocPB3j?b(LT^>vgB@n=`F(0_G&=&T$+~vqsv4C!C&w(e<{5 zv(*823s^^p_3?ZwzE@V%dz$%mo4i?UM^{ge*X(a$Cji!Xt=q2<=EEFO06|;ZZHSu! zhHVk<*u(78EfYc{vM!L8+sMFR!B{;{qYo&Y5^Yq~xKU>;>&=@0@X|=Y*wG(9#ISk# zO<(i!8XFto-Ev zRASoRd5R2e)6T2g*9k+RW|dbFp4~SRMQc#T3fSV3%=y4vby;wPPm_&)L<9sev9W7| zMUr(t>+6}3NDsjL8s{A$r_Gs9bbJs3m6enT$u29FS&W9VNVH0K$eu1F#)*&{sgC;Q^$>kNB~6tds$h5X4%@&dR;*s z(+S2mc;uu zB~PB&f3BCBnpaGI^eA*EAw6*MolCQ{xUi5?yd(a>7PvDQt6FYfZ>EBSl@%SI(WjJ) zh^~p9HMu)u&Wg>1Ltd#Reg!u&W{DNjd~@tA)`l~=9ZA{PGTRD6&V&b7?GO_U7wE3y>kCBeXYy==q1rEOnxxEJ6vcaqHkiEft%5@qQQbD#8Te zD^85jud*kJlp)sbO@6d+f>km;qc{tRLfM$}vNwgOVzvqo4-X`oNBh&kzLXky_CVjZ z=DVPJP!M$G;*X+SNEjzNVh($E_T&?*w_2E#*v`BrL(v|OpPuZ2JE`WXp)xbO;vWsvul8Ke5 z3f}!w@~R5*D)=fNcRw=iq|c_p%i=^a)muVH=}DKK6;&_>Ts`z#!ppiaB4m5nY2}N% zvu2%pW$N{}TZk+n1=qo6Psb`D4av#uA+6o7v77xqIrsvS3nUnYmASE@;luATDT;6I z(I?tL;mc0#P|m(-Nu;@_M=4M3Xn(&WL0B-@Pv;Cmk?SFbzIqHQg}A*0e<-ya*Unav zkdVN|w6SU@C=lrC>eA8C0dnxkD?+|(1=#}FL*2n#+@Did(^4=MNc(T8efb7=^$gR)CB>bJ@u?2h)eR(ID0}Ib2VQ1>o+R zJHy%XB+t6E`^ghF_!4;=cV14*$hVZoh!b&1Me#*MXqwvx3Yti#J0@^vo4F1SPR>f# zgYPn^usz>7I0IHz*8BJOR|bpVlw?r6P`ABy?KN!5`Sa(STZu%jlqh{$t64KNyE~mJ z^;;UhFG}ZO)j>hA;C>4(;HOU_whM|F+MhEya5z*qpMmpz`}Pgu6(r;)W@cYy zP_g%|QXwrsynb<5v<;*v#H~Ks=4>5M3CLXg3UqXk%afDeplYMr_(9bTY6E1Ju-KH8 zl#GlF2=38BvVEMV^vBb-@q=d#*cL|~M8?EWHq=T}-J+n#o<^vmz+C~+fa!(^Nk!hu zoN(D*z;sJ8nGb$%YHWN=Yy|}>4&{vMjRsPQR>B{bpDm%E$9}nb(6#4Fzq`n{KcIsO zI;)Zmg=T4n`pazVb8|D{uA~p-S7@lIZ@>Kh6VmU??|s92H67L#>ZsO% zMC-cOqWuw<#U4m*K!{|MkG~Hoj;(DmW$N4Bj7N_iRo|isp(8amo?N-@bN5>@+Q>+T zfyfgt!h;+D<17L0S~N~eOM{fe2_ke(Cjpe`C$lZTx3{)Fa9Gn)eS)XRKs_^)-qK9M z3@iWk&OS=$yr=Q@ZHI3BkXt1&gQIDZ>P{}C%;>qf^^DBiXG!~L1wO1R4!`bJ$--|(S{C^lsf)lmvl_X$36fPPPvhhtG_IYXuwk#&=rGm=v8X^k_9ulQRNp{a%EnwFN?kMSHyMxIh6Q;%T}3Ai*= zR1`z#m^|j%xr;7dWOqz9;(1r^=jT`OvM6IF%x<~gYJ>uPe{OfzTy$TIIMjA+B!;_A zPF=Ta{ zRaeuKU(M=lYkMYD?lSXnU6z|ab>e+&@^;+H2MVUdgoIbtt$spxB=v^BMDhI(*W%bsNj$?Luclebt#h= ze}wBvwLc2g^D|w0{x^x?(>h~P5iWBzH4U>BKG#C2Tz5~LJXDX&+Qub?W9w5*9XS?iglWTZ&@BSi&WaX z?Vz(cM}6fpb9*qX>dy7F1NLfa{VchVFiWI8XQwtKbKaP!Z;OX8KprzZTxU1`S%8lZ zJJ;C>EwZ^;=>%d&nkEYKK!5*G0cq7+^JJO{EiW`QApHU#gJgX!a#v7*&+~Ti*tmrd?@Gfkp*?4V@ zQue1$pR{US52~HEAS^UCH1P8B;t1U@NeEkzQm!m5X&A=fNh!p|#Kgts@bdG2D~=E% zReTP`Zm84&hg3B(nu9(TDG5osyoxWiq0T=%N0P~nnx0;x+5oKVe?_!$po$;J=&S(< zGe=P;^v95!R@$!~-VVik`~{<&u7QfjDqYF;MvG8bjvbdi!p9c({G3_0va%Z)xdA0P z>e;LHEzQjW`(5J(54pJufbx+t$0sB}@hSHXo##^PP_NCxSdG)-A_pxuV;mpb^sae{ zguX`R=gn`DhKLZw2L$8r@Bl*vud4bXbtJ|B>xIZ>2N|TWuuFI9(-E>@`c*ZVIfo~@+c2jP-0EJXOgb3#gkjp=Ru94T@)l~o~CyDQMR@Nrq9%ve(j!u`ljK(T#-u0x%M^K+*!Gn4%q*Ra~0})(aT+CMCoSvG3 z@}d3uSYF)?3WPYZjd0b?#t)ae#)3ab-6ccRK#{h==NxAwC$JRABgH>L!w_;{z;`RC z7)$sQC1=RgSU0VFlYBXRu>U1$kLDJF@VR{b`golO6m<^mX~i8K9dB!uzkA`Y(}y>4 z!6Zn6ow^PRy3@JG+HNHjeng(nBRr^!`XByF3qXEi_1!}Z>Dg8Y`8l?rj^uk0)60`1 zP0NS1lwz0QSpLVjmYiYzW@sDZo1v!GtZ)Xc0Yt0^C402JIQ>t`0mX;FK-0nRvrq{6 z6h`hjBJ$DSpN!PSKzBOjv3X4mYb*Y*7Y_*57Zx0+e)>ZtM^aLflsQ(woSvFmWw%NX zFInYtXPjh#=AKmjJSx+)s3DAIik+E4g0{xh?ic(zs7AahB&1Wu2L= zrZ};J*3A6xgxmmjsAelBR)QEoY-jJbPB=aSAJAD!#O)9>tG2WBvb_8+vE1(tN0x&Fva9b4ptSw9mCafBYpc4l0w*$cG(BLne^SA zi@D}o92bGk1v&A@TYS7z!HhM#TV3uflAH8G6K_?EC*0iJdV6}z7+nrnJQ3V2p531> z4SruA8LiIE_F5`6RWEy0^_a=^oe5^j&V0ymXYHZEo(059{&SKuh@67Yr^m(%wQf6A zcI{oiLIANE6*mw$+{&iQhYy`!lvm0yoXv9LbPo8BFsMpTkVSrHTyEHIP7U)_DTUZ< zMbGptr*8U^LW;`G`1_cW8n@iNvE}=wQD`gA*pyTPq`|Kc&Q3fu;dwQq3*F}~bf0eB z^?yDZOSX=d%8}w1ui{XSj}=6gxjL=nzk>7OUm55M(|1l55otYtH}Uk!0GD80@=Vxs z9j4p2r%J1=??2p&@3rY-O?*IAdwkGPCHNwGb4iPx;NE$HWThPai!2Me@x>5zEB&jY*0-Iw#A1Oco6Hui0Hq zK7?)*`bMW@@Y?obrisngF9K45y@k-|sGD}zlVfo&-kr0zpI#gHz*MdKP?~C#j-0Ml zLAsa20?pA*eLdaD(K5@Ux4j)^=Ih58KiG&R&;Tg1fa%#L3YS?_*((v@<#5#ABuc)i z%&v4t`*>(fn>eMk(25~q((>G9cNCL(7+clCYHTp`W~Yd*V#xH|Vx!Q# z?RQ^U%nM^1y2r=6$90G?8<2q!QD_gAa-IC;nfF92AMW^i8IvWerA^>*)a<0{ve~pPj^u+N;e;!HX z(*8(Am1Izu(D`euB#fS}Z>}<2p`hzA>baqOE4QxyD@TtBO8%_W2QQ*)g0EjD=j4?x8n~Vg~CGsnVyM$n$^3koR4Ccpt))Cb70iofR@SpQFpk&U-zlzpmZ{l z+NlvC`*@Wp?L*5e_wH}?sT|P(e9C%I9 z-cH_T4Jo zxP12ed-)Dqn9@9syB}P8J<*?sGRskXF;GyTh&dys!VO3lVYnT6YiMP~n~LqE#Hf?g za$TuxaRbxR)s<*I^IB{W@@Muy=+zk-_4D8EsM0|u$nWhF60ymP)EM~thAaQr$212M ziJT*#K;Ipf|9N76QtCd`@nmQ4qy1;Kk-1m1x3#qBDHt@CIDN&xSsw2z2hxuFe`L3_ zo7i5I?|P_Sa^TsbxFIITTj^&hZc^$l#C2=EY|A06$A;bUEkC2sy`7;F&7-~fj11A* z-MJGi!QkK;H0ABcd}U^#!Xgqw)C4U4=3;M-J7&AYXM6njc<5cSfRZGk5-d6!m9H_7 z(Fr-rI^#nP6rQcnD{T!8d6|HDQf_K);N0a7D_Qq=vU^^o4dKW+mvF%~zP)h;lin{m zs%>nd(==g@J7^A;6%_OwWlfiV6&Au*Si6o^P36Htw*;}L3AnEbRQou5fPooc!YocK zl!*wWqKU(v1ADKvW@TeV%``9#mkbLVb&T=obKd{xaC+ixzmnx;8$t-1ra~T{CrURa zAXuk}teWjwrYI^g^f=3Fw7U3qb@8RO^mvlH^JQ9f%muS6{JigON%o!Vlvbs*O>Ntz6+i@y+W=UahX{)RMglQh8Vc(i=_d{znI!cB?24TjO_aZ8b5tEIW`qqL|_d@&7~Y^drW8mEaF zLzpAQiJ6@}Hgnzkn;UFLT}C^fIgZjP1}biNlG*L%#;Gep`hUacqnxYbhMuduJ2N~P zCoJZ1KYefgYRz^p;5!j_GnAw~G2jn*8>_W%_)27mC(Y96#{B1F5SxjXH0q>xaM<$z&B=et zVY-r#mZqjq!_;K{3B4|;&5{d?f(U>ZpVn1e+^eKy$BTeePhTH8X}m@qU#3)XC9MZG z8I;%g_K33Y{2=*E$W-o{mdpKPz9fjLl%zc76kUELk3-hszY-IWTp3h!Z;ieXI>=BY5= z>jkW{wA3+i@7Tx{Spa)a+Usg-JltHEe_GC4NNUSMDDyOKX*WXr8+Gf{O<{z>Hl{gT z#gSuAg2R3P_G5AQofywR~7rinF1o^6vHB?RyrejV0sc50k`jFaX~BH?so5ICiMpN@6Gu1xiO2*LHDWK#Za?GCSmJ8Y+bJrIGFo+uZ$BaS zT=E1qK_h9pm4tMDP8@oCcRmtD6cAtw6hx6(%lkjohRWLr&L^iD6))oy&M~XVG^wWv zJ5_1OGLZbBg6HJ?S>NV5_eYKH!BFwnV}3t9rJ~Jr`LoHlsYN^kmPU&6DX*VA>W_WQ zqhySycpj(~Nc7;T9EG6rLX7E5th?QT1}7QhE-Se=t#dJXXtIFSGjrM?jjlgMS55no zjD*EZU-}VUMU;_U`gwwh=WyRlU}w$Me^iLAb|qxsRfV!d9@SelfR2|p;?doRW7>fU zJdresd;#pRqrg_7GCQ>-_jov*z-j#j5lGijJakMe+&+Kb%?u4aUYu5E;?OosRr-Co zr>%Pk7>bxVKup$GF{b(S?f9v|4lVO1whakHF9BXanJi}LRPjP#VYu3HSIye!iLIB9 z6N31k2a|;dyL%U&i`mFr2&Kfy_>#ZS+`Eo|Kk6El;t^0{vX0SuYpp^L3-@}Kc87!t zJ3iLOVNzmTpxwKB7bVV<95g@OuJB4h!2NP^KcLBF1r4>6!7CiB(d?H<#+^%zOd?f6 z5f!*s{44yIe)gqjBNH7B4zeudJ~)`%kiH?-3_)08Q&+0p2fZRmBd_TpuBmuKno(>F z_j9F|k)N6Qoh+n%GPPexRnDE5;QdQ5`IEyLp`^tAGfIEp)Q)!zqsk@1a6&gUwBV13 z0h%E7*0u0-l;~wJH`0oqLjaS4+4={WLVC7p^HFyc+S?SIehJULH^wQP`cx$3Pav(| z(i55(e0P>2S;%C@#N1rBa%)=-?Cp-b9qKbaS_C#L>vN@`!>O)o8LbAoDm;weVA8UE z?}QZ?@;~OibLr|t3Xdv7pma4(tw@vnAq7-WI^?guUa5S+hMK>DnwLr-$kGMfcQRqQ z4RRUMBoD2r55mc*_rbVFOZKd!+uM*-abY@&Gs*+agA!>f>|jJH4!F-=t2_W9B&wz? zcL#IJzrf9ILnqVab=DspDJ4wjzo`a947D^%k?S zU%TEzF0&@2bt86G9_UxNJmLb>OtYLc_-%`G^>+tW(cuGOdQ?oiZ`SU>UJT(}J!odu zY^QHwURZR}&=!GvydqZAyeoteVqK$D`hlvL<_M2|1T&m7zed~#`8}l~KI`I_6+^eq zEy|6W4+~h^mv&1fkcL2@OeS1Lqf3;P)tP?={q(bRJ8Frpx^svwIdFc)mTiOAgHy&m z*s%VljZBf;n_CkM;~jfpzpxTS4NJWU)c%)GT8WcX6(PW1Q>Kw6(n|l7pjOmRBM6{k zCe1(2oJw$*Pf+Q1(`ayYEcMKKhSH`6Jz5DiJtWRhUnppGHj_%6&F-R@_&;J@ob7!t z0YbxxYG`iQZi-?AtoRfJ-2U+$0s0b|gU0&H*ssxnC6N`ab?SpA5hQmy9-qL2@}irE z7Y7#W#XnA~Up%c?L|5eoQy0*WHVPJ}mDzS9SioFELSuYA|&`=pB=&2|MH%@f?=|XcEsi6?V+!fKKrYm?CCG$Yj@b|MR=TTZM096_YsbeJ0Ba7Z&+xSazxrwr!+A$un5bx*U)Nn<*VS3#49a$%UyNHm zuOlth>F$~*{_%5dz5q>z>Qzcd$SV+$n|q0JR7ypspDOmi7?lJ+Ds-+*sh8#Gvs05; z(%vGVSZwqFI8%IiN@k8tSM{b{89kog0adY}_$Ru@8g!F_=g`zpNk^!%b39~wC|sAb z2QGMT(GSV=GE0dQfF+|Q*hY1op$|0Dz$4<#@BJ2_XIWWD3yI>Ot6+_GEj!&TtCIxN zO7mj5muGyWp%~8jk?<{i=ry9zxGLoL8Eq4L*SCAvlqi5FvBa_EVXYxBy1;~S)oSfX<-St~O zmwfy7veI_34f;Ov2{}5E5fR&)?cD#=#+UnN-6Wyy$qZZz#Bv$XU>H^3bZ5 zN$Vz~zb8c;8Xxa^a_sc4sRFNoaU={Z=rj9h%e&k;R7Lpq{jTAg8s5y!?%-f^5KwzZ*ADUs9+W?6kqljZ+ zy&sUsOD*1SaBQWKsb2jLDBVgl@>E=i5GuYB&;@_8@Rvfegv~qL6(Z!j4Z>v@b3n;6^8`suudU@PWv8FN&Lb==Y;0_ttt?dl+M+NK z6} z;)LGRAWD`tyGUvgBxJYL^T|j_i%Lo&g#sg>k4gnS+heiM8m7>k1|8zUa9Kg<-tyYo z+R~EAOhT$k541?_?DA%kJj=`PGd}_0fyn_TASft^G8MWzN<^Vby1F3CgCc9m@q9>P z;vJti-KoB?yXcqcxP2`yF4j2ldqkW9`s|UB{Re2HlEV!c7O4oEqjsBx^8r;j=*l^$ zNpK4U;h*?N4R<>2%-*J!mf@kH{>}CcC^y1}XF-RLtIi@aHWpeA6=cxa)5(-)Ff}#J z_7>yiFToWd=}dMk4`Hq;(qP=X;8Wenp(!Xkp;5mwQn7W#vifb)cQ3 zF$&CSgzv4tstdK^|4#Xi1%cYvVyA17vFbs-zP?EwCkJtswa}Ap%T+Isc=ALlK}rTr2@6(j zy2|1m78VwD`{gE>r2F2e1N3X#qq(DnLUF=43}_;`K^qE7e*5+<^7Oa}?SG>b+8OW( zQVHU`Ai;pef;bMYdEaX#FFSATgDOH;NT~Epcf-g?HFRWQq9{x#)BsdzV;-m2l@+sW zZ>gI?LY2@N0f|YzmTgcXon;gQEq4RY2e94Bd3tHH8@7S@3u$?GGSp z%hbTaWH4OYCMA{q?sbHzH))P-x*kS{giv0&q6vToE7mx157k%$JraG;T#(>c)-1(6 zTU%RDcNoJ619bi%v>qQHr_0|6g1z$qG1V0Tvlr#>QgU;b;rnfF(=1gu-~Wn{*;J2s z`PXj>N6PSnSOz503NZ3KL`sPPVBu;|*w@~*3J-L{n;zm~ebrzO700ZzO1|;~% zKgdBV{`FOr8nWt5_jTA000j^{M2>6~ZaVt!JTq84!IR@Bnl^NQSFdN1%m@lc}zjjqhSG z*{)&!RBU%%6kfZ3zkKsCUKZKsiRZ6IK*-Ujt^;kz{J6N`TLsmr$fVmoQqt0Nyapd@ zYTQ8P2O^dXMRt%tbKW;66B5Y_>Ge|ZAvKD3_s1!yUDq6&w7 z7z9Z&R6m}lNr2ca*v}~p5D-QN(m$!Ml0&<`u@N`j^pCO-6qM!V3}>tP8PxvX@$WyfZ%``6oX!nmp58v=?e^Q^g!Ju zP{*|z#Nr@Q1Gz%Ph1XyaP-y`zsR5Lobev`*A!>%{w(aX+0o3f)Mk+p$N5~ik(r`i9 z$(ItJkj!y^V-g(pWT(IbgqDKiuF5zp{sTi`Y5N1wxapG3wp$=Yr5Cb&182o@{W_F! z62KG~h3%gar>N!Pg=STz(D0}6+mu~ zk>2Iwla-e4=B6MerNSwUmrU0;XWLncDjYGXlv4mOO|skMIXbCoxdY%>I-(XM_jPo1 zu-g!Ud?;zTwME>I%ORkcnB=%SJ$m#$Ft8nTrcC}h>uA`Rk$q`>*wa4{d~{OJojWIk z+62j_;aSDpJ^+zE?qGla3%HqsJcG*#@(u@^hB!g!5X*b~GiP9UOh;rGluHm!4nobF zKhaS^^Ao@j2+7~SFR%@8?m|LBOSYAu4g!_0>o^Y7lsUzAZ^S`*l!gGfMItzE$+EhA%XV*}M0Akkn)Gr-{>%nQMw8dk$soCkV-;9BRH z1>hlox)74n+phfOfhY_*0#N22LWK@;sprQmcJJOvNl7{8gdoU1$E_%GEik&|0x7%A z&i==wgmru;Uxj`}y{AQo*-~GB8Z;IdBWI;KlFxMX^g_T+K*|ncuDabJ(^*0=fZW%G zl39IA;9I-`uxD_pS07k|Ef_&x7$zg$yjjS4o_4smj>It~fyaL5SNn3+B_x_bSF=+# zVtOz3AMv;|PMA9m#s{b%Xg)-J@#1wK_S?5rau3P~LM}^gWYOR{*tE3jt_p)7nSrK1 zC^P5g=N-WRfrBqZM`Pp)+i+??82rF6??ZhRjG0@je4{w#*8Pl=F)uKG01va7U!h%; z$zC{D3J-7pi<`6&v>b!}nmX9{Wd;VEZ^^~*qIBxqS!FAgGvz_0405{)r!Av5Z?Y(- zz{7!Rt%IPQEy>jy#DfzPud(LN;vZ*b48W3Pnh6!9<<9n(BM|tKxc?X6IEwt-jT<-O zL5S_BmevhIu@aaaxp&WYvcVV9Se(=aSOjRFeJNpAnfOi6P=ubEnu_Aqxg#UIFYpoe ziGuzf`;8k0FjN9UI#^6=M~7>AA>>`CO?VY3qM&VUmzn6fwK($&(!2Ep*(3)inQFht7CCO`6q>6JiH zx5EX6{ae%lFp;V8@+A;{F7P1uKMwZaor2D%pzg%E$zv0dy3%nx#u(zq2c=yV-XcuK(A<;x6w;ff` z-!uON8x_TF_X7XV$jpQkM!VLvVxL101RI#09XVOqqHo_gDyl(%4ihlIoM8H1->`Wc zd>5i`*q1L^-EZ3d;>?5S{MA1m%1oX<<%Gc|ojpC)Af96KIK~Y*0jj-tae3Z7DM~3D zjO-9*ev+Jgz#9Rf-GNg*{y@f2H3}0#wc!7dl_Ixl5tm5_f=%Sox{o0hfdhF9CNFR7q`ZEpW@|yV^TEFqOfZsJaJo>o^EWhsiYo_wAMOuveoE18(?8u#`{x=|DiG37<)7q>zxMin07$#q$p8QV