From c547664014aa6726c19dded44f6008c760baf2e2 Mon Sep 17 00:00:00 2001 From: Bob Rudis Date: Mon, 25 Aug 2014 22:20:55 -0400 Subject: [PATCH] initial commit --- .Rbuildignore | 7 + .gitignore | 7 + .travis.yml | 23 ++++ DESCRIPTION | 20 +++ LICENSE | 2 + NAMESPACE | 8 ++ R/statebins-package.R | 6 + R/statebins.R | 143 +++++++++++++++++++++ README.md | 75 +++++++++++ _README.Rmd | 67 ++++++++++ .../figure-markdown_github/unnamed-chunk-31.png | Bin 0 -> 45220 bytes .../figure-markdown_github/unnamed-chunk-32.png | Bin 0 -> 44490 bytes data/states.rda | Bin 0 -> 782 bytes man/statebins.Rd | 21 +++ man/statebins_continuous.Rd | 14 ++ statebins.Rproj | 21 +++ tests/test-all.R | 2 + tests/testthat/test-statebins.R | 6 + 18 files changed, 422 insertions(+) create mode 100644 .Rbuildignore create mode 100644 .gitignore create mode 100644 .travis.yml create mode 100644 DESCRIPTION create mode 100644 LICENSE create mode 100644 NAMESPACE create mode 100644 R/statebins-package.R create mode 100644 R/statebins.R create mode 100644 README.md create mode 100644 _README.Rmd create mode 100644 _README_files/figure-markdown_github/unnamed-chunk-31.png create mode 100644 _README_files/figure-markdown_github/unnamed-chunk-32.png create mode 100644 data/states.rda create mode 100644 man/statebins.Rd create mode 100644 man/statebins_continuous.Rd create mode 100644 statebins.Rproj create mode 100644 tests/test-all.R create mode 100644 tests/testthat/test-statebins.R diff --git a/.Rbuildignore b/.Rbuildignore new file mode 100644 index 0000000..71a8201 --- /dev/null +++ b/.Rbuildignore @@ -0,0 +1,7 @@ +^.*\.Rproj$ +^\.Rproj\.user$ +^_README.Rmd$ +^NEWS.md$ +^\.travis\.yml$ +^README.md$ +^_README_files/* \ No newline at end of file diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..60332de --- /dev/null +++ b/.gitignore @@ -0,0 +1,7 @@ +.Rproj.user +.Rhistory +.RData +.Rproj +src/*.o +src/*.so +src/*.dll diff --git a/.travis.yml b/.travis.yml new file mode 100644 index 0000000..cf8c99a --- /dev/null +++ b/.travis.yml @@ -0,0 +1,23 @@ +language: c + +before_install: + - curl -OL http://raw.github.com/craigcitro/r-travis/master/scripts/travis-tool.sh + - chmod 755 ./travis-tool.sh + - ./travis-tool.sh bootstrap + +install: + - ./travis-tool.sh install_github plyr + - ./travis-tool.sh install_deps + +script: ./travis-tool.sh run_tests + +on_failure: + - ./travis-tool.sh dump_logs + +branches: + except: + - /-expt$/ + notifications: + email: + on_success: change + on_failure: change diff --git a/DESCRIPTION b/DESCRIPTION new file mode 100644 index 0000000..8398d92 --- /dev/null +++ b/DESCRIPTION @@ -0,0 +1,20 @@ +Package: statebins +Type: Package +Title: statebins is an alternative to choropleth maps for US States +Version: 1.0 +Date: 2014-08-25 +Author: Bob Rudis (@hrbrmstr) +Maintainer: Bob Rudis +Description: statebins is an alternative to choropleth maps for US States +URL: http://github.com/hrbrmstr/statebins +BugReports: https://github.com/hrbrmstr/statebins/issues +License: MIT + file LICENSE +LazyData: yes +Suggests: + testthat +Depends: + R (>= 3.0.0), + ggplot2, + grid, + scales, + gridExtra diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..7f50115 --- /dev/null +++ b/LICENSE @@ -0,0 +1,2 @@ +YEAR: 2014 +COPYRIGHT HOLDER: Bob Rudis diff --git a/NAMESPACE b/NAMESPACE new file mode 100644 index 0000000..55687f0 --- /dev/null +++ b/NAMESPACE @@ -0,0 +1,8 @@ +# Generated by roxygen2 (4.0.1.99): do not edit by hand + +export(statebins) +export(statebins_continuous) +import(ggplot2) +import(grid) +import(gridExtra) +import(scales) diff --git a/R/statebins-package.R b/R/statebins-package.R new file mode 100644 index 0000000..52229fe --- /dev/null +++ b/R/statebins-package.R @@ -0,0 +1,6 @@ +#' statebins is an alternative to choropleth maps for US States +#' @name statebins +#' @docType package +#' @author Bob Rudis (@@hrbrmstr) +#' @import ggplot2 scales grid gridExtra +NULL diff --git a/R/statebins.R b/R/statebins.R new file mode 100644 index 0000000..de10a48 --- /dev/null +++ b/R/statebins.R @@ -0,0 +1,143 @@ + +#' Create ggplot-based "statebin" charts in the style of \url{http://www.washingtonpost.com/wp-srv/special/business/states-most-threatened-by-trade/} +#' +#' This version uses a discrete scale, binned by the "breaks" parameter +#' @param state_data +#' @param state_col +#' @param value_col +#' @param text_color +#' @param state_border_col +#' @param breaks +#' @param labels +#' @param legend_title +#' @param legend_position +#' @param brewer_pal +#' @param plot_title +#' @param title_position +#' @return ggplot2 object or grob +#' @export +statebins <- function(state_data, state_col="state", value_col="value", + text_color="white", + state_border_col="white", breaks=5, labels=1:4, + legend_title="Legend", legend_position="top", + brewer_pal="PuBu", plot_title="", title_position="bottom") { + + stopifnot(breaks > 0 && breaks < 10) + stopifnot(title_position %in% c("", "top", "bottom")) + stopifnot(legend_position %in% c("", "none", "top", "bottom")) + + if (max(nchar(state_data[,state_col])) == 2) { + merge.x <- "abbrev" + } else { + merge.x <- "state" + } + + stopifnot(state_data[,state_col] %in% state_coords[,merge.x]) + stopifnot(!any(duplicated(state_data[,state_col]))) + + st.dat <- merge(state_coords, state_data, by.x=merge.x, by.y=state_col) + + st.dat$fill_color <- cut(st.dat[, value_col], breaks=breaks, labels=labels) + + gg <- ggplot(st.dat, aes(x=col, y=row, label=abbrev)) + gg <- gg + geom_tile(aes(fill=fill_color)) + gg <- gg + geom_tile(color=state_border_col, aes(fill=fill_color), size=3, show_guide=FALSE) + gg <- gg + geom_text(color=text_color) + gg <- gg + scale_y_reverse() + gg <- gg + scale_fill_brewer(palette=brewer_pal, name=legend_title) + gg <- gg + coord_equal() + gg <- gg + labs(x="", y="", title="") + gg <- gg + theme_bw() + gg <- gg + theme(legend.position=legend_position) + gg <- gg + theme(plot.margin=unit(c(0,0,0,0), "lines")) + gg <- gg + theme(panel.margin=unit(0, "lines")) + gg <- gg + theme(panel.border=element_blank()) + gg <- gg + theme(panel.grid=element_blank()) + gg <- gg + theme(panel.background=element_blank()) + gg <- gg + theme(axis.ticks=element_blank()) + gg <- gg + theme(axis.text=element_blank()) + + if (plot_title != "") { + + if (title_position == "bottom") { + gg <- arrangeGrob(gg, sub=textGrob(plot_title, gp=gpar(cex=1))) + } else { + gg <- gg + ggtitle(plot_title) + } + + } + + return(gg) + +} + + + +#' Create ggplot-based "statebin" charts in the style of \url{http://www.washingtonpost.com/wp-srv/special/business/states-most-threatened-by-trade/} +#' +#' This version uses a discrete scale, binned by the "breaks" parameter +#' @param state_data +#' @param state_col +#' @param value_col +#' @param text_color +#' @param state_border_col +#' @param legend_title +#' @param legend_position +#' @param brewer_pal +#' @param plot_title +#' @param title_position +#' @return ggplot2 object or grob +#' @export +statebins_continuous <- function(state_data, state_col="state", value_col="value", + text_color="white", + state_border_col="white", + legend_title="Legend", legend_position="top", + brewer_pal="PuBu", plot_title="", title_position="bottom") { + + stopifnot(title_position %in% c("", "top", "bottom")) + stopifnot(legend_position %in% c("", "none", "top", "bottom")) + + if (max(nchar(state_data[,state_col])) == 2) { + merge.x <- "abbrev" + } else { + merge.x <- "state" + } + + stopifnot(state_data[,state_col] %in% state_coords[,merge.x]) + stopifnot(!any(duplicated(state_data[,state_col]))) + + st.dat <- merge(state_coords, state_data, by.x=merge.x, by.y=state_col) + + gg <- ggplot(st.dat, aes(x=col, y=row, label=abbrev)) + gg <- gg + geom_tile(aes_string(fill=value_col)) + gg <- gg + geom_tile(color=state_border_col, + aes_string(fill=value_col), size=3, show_guide=FALSE) + gg <- gg + geom_text(color=text_color) + gg <- gg + scale_y_reverse() + gg <- gg + continuous_scale("fill", "distiller", + gradient_n_pal(brewer_pal(type, brewer_pal)(6), NULL, "Lab"), na.value = "grey50", name=legend_title) + gg <- gg + coord_equal() + gg <- gg + labs(x="", y="", title="") + gg <- gg + theme_bw() + gg <- gg + theme(legend.position=legend_position) + gg <- gg + theme(plot.margin=unit(c(0,0,0,0), "lines")) + gg <- gg + theme(panel.margin=unit(0, "lines")) + gg <- gg + theme(panel.border=element_blank()) + gg <- gg + theme(panel.grid=element_blank()) + gg <- gg + theme(panel.background=element_blank()) + gg <- gg + theme(axis.ticks=element_blank()) + gg <- gg + theme(axis.text=element_blank()) + + if (plot_title != "") { + + if (title_position == "bottom") { + gg <- arrangeGrob(gg, sub=textGrob(plot_title, gp=gpar(cex=1))) + } else { + gg <- gg + ggtitle(plot_title) + } + + } + + return(gg) + +} \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..19fee03 --- /dev/null +++ b/README.md @@ -0,0 +1,75 @@ +statesquares is ... + +The following functions are implemented: + +- `statebins` - + +### News + +- Version `1.0.0` released + +### Installation + +``` {.r} +devtools::install_github("hrbrmstr/statebins") +``` + +### Usage + +``` {.r} +library(statebins) +``` + + ## Loading required package: ggplot2 + ## Loading required package: grid + ## Loading required package: scales + ## Loading required package: gridExtra + +``` {.r} +# current verison +packageVersion("statebins") +``` + + ## [1] '1.0' + +``` {.r} +dat <- read.csv("http://www.washingtonpost.com/wp-srv/special/business/states-most-threatened-by-trade/states.csv?cache=1", stringsAsFactors=FALSE) + +gg <- statebins(dat, "state", "avgshare94_00", breaks=4, + labels=c("0-1", "1-2", "2-3", "3-4"), + legend_title="State Groups", + brewer_pal="Blues", text_color="black", + plot_title="1994-2000", title_position="bottom") + +gg +``` + +![plot of chunk unnamed-chunk-3](./_README_files/figure-markdown_github/unnamed-chunk-31.png) + +``` {.r} +gg2 <- statebins_continuous(dat, "state", "avgshare01_07", + legend_title="States", legend_position="none", + brewer_pal="OrRd", text_color="black", + plot_title="1994-2000", title_position="bottom") + +gg2 +``` + +![plot of chunk unnamed-chunk-3](./_README_files/figure-markdown_github/unnamed-chunk-32.png) + +### Test Results + +``` {.r} +library(statebins) +library(testthat) + +date() +``` + + ## [1] "Mon Aug 25 22:19:55 2014" + +``` {.r} +test_dir("tests/") +``` + + ## basic functionality : diff --git a/_README.Rmd b/_README.Rmd new file mode 100644 index 0000000..4eb2e32 --- /dev/null +++ b/_README.Rmd @@ -0,0 +1,67 @@ +--- +title: "README" +author: "Bob Rudis" +date: August 25, 2014 +output: + md_document: + variant: markdown_github +--- + +statesquares is ... + +The following functions are implemented: + +- `statebins` - + +### News + +- Version `1.0.0` released + +### Installation + +```{r eval=FALSE} +devtools::install_github("hrbrmstr/statebins") +``` + +```{r echo=FALSE, message=FALSE, warning=FALSE, error=FALSE} +options(width=120) +``` + +### Usage + +```{r} +library(statebins) + +# current verison +packageVersion("statebins") + +dat <- read.csv("http://www.washingtonpost.com/wp-srv/special/business/states-most-threatened-by-trade/states.csv?cache=1", stringsAsFactors=FALSE) + +gg <- statebins(dat, "state", "avgshare94_00", breaks=4, + labels=c("0-1", "1-2", "2-3", "3-4"), + legend_title="State Groups", + brewer_pal="Blues", text_color="black", + plot_title="1994-2000", title_position="bottom") + +gg + +gg2 <- statebins_continuous(dat, "state", "avgshare01_07", + legend_title="States", legend_position="none", + brewer_pal="OrRd", text_color="black", + plot_title="1994-2000", title_position="bottom") + +gg2 + +``` + +### Test Results + +```{r} +library(statebins) +library(testthat) + +date() + +test_dir("tests/") +``` + diff --git a/_README_files/figure-markdown_github/unnamed-chunk-31.png b/_README_files/figure-markdown_github/unnamed-chunk-31.png new file mode 100644 index 0000000000000000000000000000000000000000..dba2571b92b5fd049495aded0eb57c6bb0983003 GIT binary patch literal 45220 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 literal 0 HcmV?d00001 diff --git a/_README_files/figure-markdown_github/unnamed-chunk-32.png b/_README_files/figure-markdown_github/unnamed-chunk-32.png new file mode 100644 index 0000000000000000000000000000000000000000..f4314d9d46dfcad57f8f3a05777914b910dbaf57 GIT binary patch literal 44490 zcmeFZRal%+vo(mjBxukM7ThhkyL<2uf?II61PKno-Q8Up2@u?+ad&rVd^+dMm*m{d zoVl5cpXa^kXG8CfG$^iuh zM`p+cFyG3;z!4NyuJUpSdAEbgqdnz^5beo9?%X<-I zV)Kt>@$&cQ=qR^%xkHMH5Eu6wN|ZePxe*?rh38>0rTNLw5k7g&-~6nTQ46Lkk&*V? z`-MsN?igNU9q96jTJ4wK_5BdfD$g$8uEC=+VUSp4rA-gQTC0jFPKcJ&R0kJ-#$E~G->A2T2+h`C5ueFb z8CEvS82Q43qwXiYVB7#ISH(ZPomO_G3=PY1RuER;Jtw{tqAEOCIY=%{vhwpc)39g$n-is;fSF>0%TI-bcE=e{_vDe%QSRSg?Ngjrwi2B@7II`u3 z=qFTH-dY4dGRe!$o`ZKGr)6bZQ7p1hk)o}F`oxyZXAsp-YXgk$iUSN`w76sw4B^T4 zPVB$)EjRTrd%Z9R56r+{h|XM|JaR&K<31O)|L;!+EkK3)RoF45jBbLK# z`nalWdmFmIbCuPMk2b0>d>=hR6S4=-T)L3mC`bhKpr@$N5AD{p#}`x=s&n%X?)=9o z-gOG~3l2{1`zNSPc_Xo zFv0TxPunu7<~%D6jj)$P_02(6nVi&Wii4h8_}g)ht&cVQL{&J=hNQ8DTWx1Y$TuTs zPb6(`oKR{l73w`1&*9#1U{WEZBh2=y_XLzW;b|{s#ulh@_4m$QQ53r9rEMpKy76X& zQcH)NhAI8(+hB)j%xDE0fZtUWz+OMcVzcn_uGuiiQ}wfNr1RQqN?f5hrH+s2`yi}h zufDwrRLro7%dhKAlaAOSaxch zaPzy>7^4>F18@_*RB#jW8Ir%?O_*E?X+zn&SrgG?LqQ2c$%u=nyFnkN!+YUK5%p%u z`N5H!BVoOLwS>L2jKZi~$Ed7hsh;&@Ijy_kqkM3q;U{X(d~yOu{fZwhc#SFMVP$@E z5|~Cw#v_+;dkb7T89f>XzAPUJ@SP5qDKaAvB1c30ecp%oCB_~YaZ(Dy{C%=sXF+WT z{=2fK4ug}W*fTOH?FaYgp%HdR{~vqBL%|oR+1IjRy@mespeP%_{@qy^Mv+Pw`apfD zEd1|2(ta>;v;W8x?WcyU?8l4CO;7Q6A1sJSoc~9pzsUU`EB*h#m;8yv|Mkge7nl&M zLQ&sc(*@Trs*3v0;pdwxe>2Y+@1c2LAmAvM>%4fW8di5V$wv!TWK1aM#$3PiR z(E6qKvm_}@^OkiP?Bs?VN55y+GO(FID=cslH(~TgWLL_nD`{d$8=>rG&AC;?ZwHCh z2Rm^^Q(%v76~=N~>F3YTE$iUztz%7Buc~V8eNmjO8z|O@e@sK<&(G7wYP?F23gfh} z!hSZhA6+!7E5Tmu38#}l`)F8b7R^8_8*KQg`-M(>ITguGV8y5YN_+t zxf}`MG7`bFn74q1H+SJ(@`q~bq;9gd9{(G1D$Y)4Y}nuxx)e}P?fF8V5lZ?|xDHX`xBGJP8jx;h}Y z_4TZ40dXiTB(-ffQm512%l^mR)>z?M!k{#`rYO;bY)&n3VkXWnp~1_ln#2M11gHOe>G@x<-sC6K=R~VpoEh( znm5w&Cq`<}p*PLJz7X;BbwtH3w}VpLG7wnc#!COGQpCbpt*uP89$(%*&->yXT&K2` z;JFGjW@uBw7nx;ndno*o85&NVeou-X!#v|g-WaUkM(tD4sueU_|=|gI;%Q;KTU!bMm z)+{P~{z(zgSpC+JHzzB^ZT}5vDC9XvEw;qR#FqKTTx_XO z@aCr2ChmW8gfNT?Z_zu8h7jivPh#7-l{aB3}dFHvh-Jrv1VQNp`arX2*YJjy^_$7zU^|3j6M_ z6=oq#g!BKS?G(GWbe_xp3u+FS`=P$<4zDgoi#=J8KT~0)?!9Cof1>bYO#R8emoQ7~ zSNgeY#{FsAwH0TeyWWqzRD6S;QefV}m8L9oiovI0rQgzHyv-8wg_3zle4n)yj=!&8 zh5|v@KANF3TzK-tcX(#mL_**T87H)d`mf9F53cq+^O*YCEI-BIXvEG23L{YeswNCG z`WDhdp$(RO`_~haA$DOyVfqtDkQeX2K^%ddrWWI`seXGQPSyZT(?2PUat#f#Hkvie z`zNp|q(zr&LL?W*Bl|F;6J!k_*}6E^9Oj|b+&@0|(k zoQoqKpW99I)0@4pJD8U8Z9EIDNVcvoS>>W4fI%^Gx#LZ$_D)3_gtW6GY>t6&OMXAc zP+c~b;&rQB1X5cXO;>3dmI=a`u7^I|>`)ZQa3z+;(*>+3&@IT1Np~$jAcMUQ-fi6s zgxt1(0vj7m_*Ox>uIJZf%UK<5Y zl#966UfnHzs=Ff07FoDaOSH8-yv4@i6tPT5rl(v(fMe1FetTWpNLFSp$iG-pq7W4n zI=ASw$B<#ArZ8m3o+~5Th_FrkPWZHk`rQlj{nl0Q;)QV1WW{QG<+gjf&GqjJ_mjXz z_giR>HOlzBZsfc@HuH!OG03L?; z(p=)Opm(a)`I4Wy5l-rwqk_~K^`m}^SC z-P2TTT6pu;x=$4go>(@P38GVUWHa#QSG3}B$da9YOWL@YQS@Q2X|U7qN47i+sAo@# z<+#g8mjmh_>W^Xb0@bONK9pF6?)Om#HztrK@g>f?2;B)e)WxHq1cb7nfh~}+uw#k! z)1?xWpbugSBNSsHAI%NJlgFHlm9!X{*4G9O*y>)bdO@>Yj*vR=!5{^P8m@M`!G&$jH@^RJYH%R)z2e5MZ z^BGI=R0)yYu>AW>KB}zn3z7>ncAp(mUirx1O9)Y9dw}luBe_}))fC=hrq>`(P!ohI zxktW7qNRFW0Z}K~FBOZW;i?E4HR7{4kPWn3tCIhzpCZ?mJ`hJ-TEv$|#gh0jOEigY zYff0_vpMCO44hZK(q*gy{aRy>XPu@ur^m9nr6v+HGf9T6%6!wnar+b1m5}OvYQvKg z0>WeKo5NrMBWLy2;?3ob6jVFrLz{2sAt43Y0zUKiDjttU=TN`%#M{HyMXEKgzFuz2 zoFJAI7^<${xU6RnATBnT(x`uU9u*Kv@+p^Bn`*U0-trm;F!4~}OaFvL;-8vifmx}; zRo7o+=OU5hvjAbzzFC`*nh?#wW3I2vmSCJ_z$;EZFr5O*z?WwJ2!v5vT+W@GhdEFw z3>*CcLDLnc1Xn%6V^(grDWA&#FPB#qiQ7RmpW$o0fn*lKZ#y?IIn<8V>@5byG?PGJGZ(%;=--pNk6 z5XniFbtHw=@zic-6C8Nhs}c2Lidxi{DM|`4zpx8=7Tn%;s;m9pFfQYxfx38sg}G{e z>G&32GLik$^AsWB&C9T&mh=ptCJ3cur$R%GiS|Jk0Z=S0+^1v0zwuFn#%H?p_*G_f zUf>4ydpZL?JDe<1`@2b*-+7wll{qbp+WbuSZq-ibm0S=`w;?CGLVDFl1-}y7)M=Xa zi=K;AQ%JpZ!+{22sw*5+tiU;Gu0+;sv#H6D!RmL zX^w{QhYnJqSgNtld-DANlI~WuE7YH`ANa;1xQ%YYj^X`RaqyEA4xHCI;xW2BmXviW zY0rEx!BFNDqKSaxPxm`GE#9dm;bK=!#cV8V&6%2#ACY9e(AaGa9KfDa_Veh{&WZY6 z+dhg4BP*NKQ%&0*A4@t9;Z5iWX&8oku>ZCFVw9x z^Wh9ml&92|$J9HV*?y>I7E{%*{8y#(cfyul=zu%ejNDm%7TdeP`64yD7mJ83opcwZ z>rqLsfw)qiS$C-0m6GW{RPA!vM6RMmgSMhz;35IquZU&L+L!Dl`L`Cbi9$|T6jx2m z{}e;v7D$0CAR=)6w;1*#L5^7AId` z$kFP&a4DTBJ*0ZBSmtMvQ@e=L)(ofE!SH<8p^wnxvt7@sYl3cc0 zn%MHy*i9XLIebbz+2dJ@$8I4OJlWU9y9kBhKuwnq6KnP+L9T7DnLENDY9+e%bIr|g z(U;K?nzU^x#cH#>4Pq+GUOtFbEJHY1txD~~4Qa`;Jj1ZCZnS)IevNfoIX|-bL);Fq z_w{hDT*sFRK_(b~VPvyJys`i=S9!lcOKA(R5{e2_ZPWEZQ_148n$3)q+$d4`E$rIU z+^fA%4X1q6$Wp#_j31xy`6?dK;>u7f(Dh>$T;!yeZfcjEw5Tj^2OQG%G`t&%6Uo5V zjwS9{f1z3<{Y@Hd@{gnb#krsBH)$|ZyyO4Zqy0P~zUv%yDa`y2PK&?&nX51b@y{_+ z80JI-!fFVN!nXa5C4Xx%2*`_RmZUU)1EdKN(&*p5$GrObAK3liAZI|7@&CPmYrr*# zChvQ~*k@1Ie2F68wz~N^m6Co^+5JV*SN-znJdH9CRRLm{>Jujw8{SR@S2>%2x6Zg0 zebtU680LKOaKFNgH@XyQr?6{2>oj9ZjTv_LEgyDL7j`!G@EKR1{3NJ7@OIo0&K5Qd zK!DHDk5E0ksCn|SswH8!*zPR{z7bqFJJ}gDk~mlI^Wc)pX!?kn6O|z`k=5#U9fH^7 zDnu&gYxt49!$P$FqGtlw_HOXC6VxJAn?wlguUR;Q_w?fmXzh&0p2o)}lCbzI(&%Rh{^2Y4$tDLwg z*K1+Pu+*J0<-txo5xuH@kHd)Lrv>C3zgTX=j~eT%5Vc)RbE{Nh=dm5yy(#5BSv!{z(KTlZnIfr z@m_=RLAQDdDx8tjK1+AA%H>|>(iPt?p*b17`N)+^_L~fb`4z4{~8$V)> zuC@ltcKYMNsOS4u(VzrAdY!pHSmL$&w(}FxWAu?leedWi!I4^7;$gga@6a6=5nN?? zN{hCy%BSsD5h)m9w|iWrZR38Y^3Y;u%#WqAV45+k*yOxRDjBX{f~)(s65vr^8bM6^ zt5r5UO6eDop;BM`VWUc}S3fLtN_4B8rH``}Nz6WsI`UejxE|f*`9O%PfzM!9#38qx zmAk>-iTgU1a}ZAkFY9(o@6D|iCbylC#oaegeesIH%g0>jG&)$ssy<&Dg{NT`<7zbd2_f8Cey*Pz z7;-WG1=rne(nd#BhBBU=tM##GhN7PWGdew0Q_|q|EXVEJk9Rbuq&^d&e$iXW@487UxT4^V?q^o*OUdMQvHUj4L zCnl-6oaYt`3wUe0VNIabB=36{wz{l}XaLMq-9+Yfy^gJ^&EwYL#GLPYF8vn${f)O%REc+{RGTGaDQB_BmC_x+JFA3r8JoR6TE(PSO6`Rph9xt zFnHgPzDkITY1_1-Fjkn7BIHkZV_pZm@nyoc=hVq=d>Z>&#cHbFN zU{QG^lNqgWpA8>|#oHdwayqiIEP$k~pk+g4sn%ouHg^aAb%~M@@|^|>tsf?7Wmw3! z1u_GHk(U;<5E&Uo=UV3{*?y{JXj6t-AF;HS&wS)`@o}2p`3HQ80l|+ow)f`)Cgv8J zWb9MNKF!`gZikNGahW=p%d^K?pA9MBy(?&T15G9i8T#GOMhm^73PsE{+0^;Keu&Re zp-YlWJ=WKnPc*4#;KANdp|6?bX&h8Xs8d@^fAcoSixnq2fyYX-L|Sku5wQ%q+jP*L z@7AMwCyLtckW$~Tff(o)n`oy^+#Az$IA_0srK3e>8qFnMW5`Natkx1uJb|lzyKt-#Yhd zo})fLc$7@^KB$4w5blo3tNm)+ed=>rShHW+3NHsLD%)bkb90}ZT+qP-f#x_sz%uUV za}$w{Pi?qu(`2oYyHkZ4f^JksUj+_7@o@zTY`vX2e67~8Cc)7KnQRiw6pR4xdn$f1@RZNjADMqozMD0l>zWm~Z2`_htY#S4l z@i=Qzm#03mwmQub|4gO0{?PnACGC@+1|#ETE<6k?RhZZkO>}Cv_q&1wl>%iiPbR+m z7wceKO#xk^XMmZGySaLK<{gaJM1w(d+zIsqpY6JfIt@WURrJ@r`IZ*EwhzF=B+%p1 zp4V@B%6&D;?qOdBy&^xH&Nn3B z1sM`pkOpaa*VxKtih_iu^^Z$25iMbZ1s`sh#Q}q0^frgPNgDl{q&VEeaj_HHCn1eD zKHC_VERS6y!C%zwLvMcg#NJqg<&Lv-M1v!>L(GFVj5thes~GM@%B|(Hq44;>s#m zZHbLJnS!p&a6BGNujYshDtSGUoaIAN)svPTe`M1T_u0Z3?VF2kA#>$iw3U-pu6liT z&Nj2sgSnb9ezXqe9sU~Wmuv1OX}Xx zX3wj_*+{qZ>lj=YW}-=kDou-psJU`)a>&nq_KUAoxSl$i%S#DZcclsr(C8=)JiN`( zdZ(1V_1#$Qi5pRH8F$eIP{lVWQ0`n>oE*0t9di}QCbW;aq#|Bq@y0-5s_x5_$kh)( zOWlXC?<}p;`AiKmG%N3U1sNY$qj>yJ$c5uamR^^7mkLca^yGXWRv$m=?Ec~agU=@a zvra?p`dIzjTeaFm4=#x?UfeA4L+@lonjr5@#S%6+@qYasg&f1C<=AE%_Kl8=`&t=>^S5CH+wq&|}avOfV z-4~%R-S;`EBc^Z+rlY62{MypxQ5P{T2_))1vyAp@5pl61IYDuq)ZabBG!Qip$ys>J z^2AIEuAkEV5MJkVKe)Hp6-c~zv6w5NVN(ZWMH8~?_OW5n;YQxg2L-jwVPs2OSY3WQ ziJy6+bC0Y}n*gC*EP|4u1Q4j?BQS&Znd3d@C_Y+))Gxg;2n9g~nv4n|Gq;(iS&X-y zW$j!FY9)Lo4ncG#UrjvnyONp@R#_gWw}BI40mbLpoF?&>9tEDa*mYyNZ1pMU*aS97 zx=wj$lClmLKd0gZ9Y`QYtspIbLI!m@UsB|1Lob%?NfP9a)F@l6b#OU3WxU_gTUe(! zVGV8yH6q~kn`wDkDN1o6jdw|0K6nEGSI<~G>fU0B-T-KmCX4lS>fknwwos%&z*-R(g(=~6H0c@5F#Ae5%A1UD$lE9m5n1+7%zh7|gKi2y^9%6Y+4{#1?7 zi%u4AT3eVYgEp9fk`E+-Tl%%+T0Z-udAXSGt-wK zof{!;lQNCry3t{Sb_Q>C5K$bAM0j2CNt)s{Z4_B!9oX4Y2i*}e%aqtpth1i-Nfuu5 zMg-(v8J2U~y@^bGaP5gK`UXBoM4qY1YdKzAEi`v;akY%GTnRVrXMD1Sa9})#H=7$E zUFA#P8%1OAa@~pPx(Q2_oWN0ZBSu70(+o$*kOk#g>R=rhSD?!&xlLQ>O#sUwVJ0rPWzQ4IvhgNzb{}CkL<0L4U4BQ)(s7OjXW`sAriI`P));)ldoIO zsRm%9WilJJQXCkkvMZ3PDe-khdD5fByN5)kwO|Rvv5f$v53cM~f`*TdR254t!TvU- zWXc(#`X-hwRM)+^+#TuJ0`;!8wm{>yQZM=Pm308xv}AQu3I}t28Qy-Frfu){7li=B zj3u}0WLv!b$hj=Z?oyfE)kl+TfA?5fOpOs10$f8KA2g|2rFpS)dghp5!i$4d?TZVP z>;0aYvEYrQm2}ZC{5WVy{d#Cgi)12>wrw*PA5Om_$>toe*|i{Y&uKj$Si0Va?r>_w zgS)`=wTZG$i!Z~16HovT)5tkPK{#C&_;cxD{P6)$Q9cnM42%w z-lQe&6C2A<^8-$|Sl0~Ust!yY?c^kbZ8fF&r#$D)+WZF=UN(fxdO6P*USome>!+tj zlBAZ-w|RC0#HrNzLqBczeZJ@;s5pls_4ElGm}qKXYA6DO;_F?Rm2}>OFfm#UUUZZJ zN`&!`@_udZod#u@+=_5n3E?EeVO`Zvu5+^)KhPR704ld5_T^6n*2z?+*sBP2Sm z9w=IlUwz)21vkhkMfxaVwxDfmoPNn{wk{lLtTrk7f_StfwzKzicAKv=V5z8NRe&I? zpwoid=@8NQ17GO_`}N|LQ=bmlY0Duzg(xJO`Ms-p2WMu@AySMTPJ)>#s{KO8w!{~*U!rtQtcCpgJ!oXDp0#2(}ky`gcwk-qJcSm<}V8<@K z<6IrtSt&^i3QI)vy-59`K1(|Zw#80=dcjGlyXxK`&9PueUTm2uGqq@40@Y)(7CgU6 zG^>c{?T24v6r3_~s^Uww=kS6M6v_$)K_ZSA&{V%9eHOG(d-w`_!$Fgqoy2XH!m9Nw z-Esc3a%uF-mec$lN_FK%u655-QPY!zGS4ZE3Wt5^HN+Ks!G4M>wjYzwCV8%_@u;!J z4S{}OAp@6B5f+t$Kov|k?gIBE)4fg0(vkr0N&Jgvblm}_ z#R}9CgwyC=mqVqNH&pG0wW)nnAuEDsC>6$y2YI!8F-~sT%ls9x!xLAqK#jx7U*z@= zA0Vt}{ND0~@gAvstjS1l-nYY;Cd;^b%0#B^DAM0P^OhPDE4w9;*_`gi5^xMtfLy6I7sy`D6$csG4B?5EakF50n;4It= z!Pzv8OzvNtr4jv!_xp#+NF{|Uce1B{cuPRhMS4pXe(=& zkv&%S(sCSq1s%A^r~qhOwrv^0x{MDVtt?tTxK6zJ4o)0sULJ86fEyCwJobopdWUuI zXxqO+{fei{uK%=Lj7 zl(tWu|1~F&Z49jV;tT{)+ddFA9r|GEw>;*r>%02tuP#$fwEuF&XWmEr7qkROAf}io zQeg)C#hm~56%n&EY7d#e(WD&&K|Fycp8wU~s5|?8MI^&MV~^_Zj-Lr2YuY>N7s7uX z>*wz)A|Ac&If;M6J=)~=U7TdK0a&uXcX7sk-(exx4Ker|?!x~s1YCvBG*R5{2K1i~ zHCBCjAvof3gs-mAW3aR3Kw=D_?h;$yHTDVFyY}#EQeJV)=yKxyNgd3MvNI5PUt=dO z?T^F5=IY#ep)gm)i9(_?BNgj0vpUb`*hy%;>iFukZ3dBg?3Yp3aDI_S8%&F{wdoXr zvsb1!9|APAkK1LB0oP?dx6#rS)%!17?^j5{a2LC%EQ?RW&0%1ZVFsH;U?qP@tN*j< zel_*j#u)PDc$2O3@%zY3-e9KV)GS*!s#>oC`VxMPliD_b$owQ(flP8u>+K#7!@Sok zAZBJ~Ip3{Ho3%=S7EPp7s(O&3KH9qmw<+kdMFQg*__OPQ5YfBGSCH;)0aOXa%sk7F z`ohVKC8ea_)d#!qlRELP-qr~m){(F|+UC}})J7JHxXo$nvhRA7pZccx9EmUySu~ig zhtu$+mwMx}N2Nb@ib!lh)4vh7K+A5mZo_dKWCw ztms!GagpsB8~U9_ZLTX3bbiAUxATW;PNnvg7EzSERMfsP~~tm_H&+P0>KGJi*=wss_>m7hJ? z^<@x0fpG0Bwa076Hg_E^*S$7g0;U89ny3=Hc%0TPS3_H%??5kDF+=xhQ&K5P$j_(F zpeN4NZjYokCC1LSwHrFt~(Tt|Wlt+sYXUrq~X^nN}XSTVnJ7g%&8 z8*6GGRh+~&Z~4||>G7e{1-{MEQwihuWn2l&HDlV`6jZQT$z*W3$U>hvZ6bAoa^f_G zle7^GZQMQi#n{ZVb3GE0b1_!6apoSriWe3oZq7t9hXo4Vk*lDT@eyw~s5jKT9We5t z047GqrJa7`(m0a=S`Hj0w^e<5a(R4jiO@Up;cFXxAGx7{qe|g{Zqq0BUPavi5!e>8 zJo8sRgaX)sC|f<7Q5^NJWF%i^tQP{ueBT6fXPg=>#nG--lM{B_J7XO{$hN)(E;f3{ zlNxlLl!Z4c<@}ICgl&SL-Ml1Yn`C?q`Ma>q?c4V5I``5lvz|9w12%WLe6ITlXwQ4p zb>=vc%)$J2nwq9%;jbrd4rX888jQM5h(b$8pEg_FT1W`Z)S>kHETKZb`}FbpCKv3o zL71wM$V?DWiRj!#5n+vLnaXFzVl-Hz|DpbvCg{q_;u@jDUWq}Fs9wHQ0=XrdxnbyI zL~`xJeku8z1gTA*%g_OstBgnKQk%i)?ls+VdR=vwC)?J9-R2;ZbUI-rgI0g&4yK-x zqS%41%dTs_q()AJ)v-nY-9`287XxdPozoy#GnP*`TpUFoh6|w5N!)SRxk-9ak4yOE z{VMQ;+V!pP#%-Lqf*Uaat`&i|yn#gA$=-H2olo;e#|vC`%p^gA27L_66ZE%RD}tZO z)(LM0l40#`?Tl5nuTx#?`Nv$XK5O|s3%Ii9M5fu7K(#qMaV@mpBf60A=H8W)>TFgl z{Thz zqh8Gjin;_)#H3}asvnaX-ViydM*QBMukT%dRUCXQ#4dU2!l7o zJYlP5w!ix4b&$La38eeC>K-n>pBR+*i`0BJ+%>Z02vc)#W;c`PuM9ECCEB5G24%(=0GP4Wxh9A4dx#zz9&@Z)W;>QQk7R$ zD$Mysnc0XjhCJ4lTh5p8yDW>q!GmQzUOnr0z5)nn%2kkE2D_%ln>utAb}$MT7J!tC z!`I)lHG}1uPaw10J@7q^xXdq;0RB9|g*=qO1R6N15-l6PuZ_Mb!Q8${VdU_zMc^6+e$zk(0l zB6gBK=F1H*l-G%(n=DyuE4~E$8cB252(@}fO>^@r8|3w$8{%fw6SX%%y))iiYZ%y2 z+h$_m9(r~j`q-t0Zf}qg4tV|AL-%=Ityb@%Tdz``%xk)#B*A$f`m##H@jKq+#UXJ57au54o^f3f6FmiF$~ViJ>=`Ts9DALdTEWj=PSZ@b+%3uwz4S$>i~| z=VKg=DZvcKj_2H|`ym>mwPAn63XPzKHXYo{@minq`wpQUxr_$~J=zh&F4H^MOLGA3 zeF+X>IA(@LL`bF(ZFzCX-pf3WLR{X`n8sm=Rc9S8aH7E0{VD;_czGejzAGYES?VP# z*Ore0UT^;ngvREkVBKFW64$wL7SD)!XZKUW;`nhDmGOKY8=dpK_&_Cl4FNaQXwsKA zE2hq&WM))_Tznby=LbR}*4@{|zJQ7A)ilUhQy zr_YSG8`zzeUX6E`R-LUr0kiP3?WfcW1id7;8T(%3hRhLqtCC|LpZCU&aGV!kl%B91 z6KVcRv&)pgXpR(oazy^Ir8CBe$<^x_em_dBPZ_s87}ISHly%f-1dL=O`l=(fw+F0h zeAl1H3hDh!oeMRhXtucZAy}s9qylAL0IwqOQ2xgcd_I}gnna@bZk2tzhU;JXTgSzW z>ddA{^MDQqzWOo(#h3ldPMtUR`K}$E@ul2H3A1%R=!^jZ-p`gxK-X3B(_wh4Z1Fum zYIIQ$xflZ1Ry5Ja+I!Awh5NjenKnT-+0t5tDPCm&$d298SKdLPWOXl4PD>(dMsa25 zG!Zek!yCT@*Yszq;rjEF8>2#f#XZM=S1%_x|}D&X<`NtAgOo zwv!97TRU@FllHhn0o_^gT~m#EK#Klk*8vlk{;xu;Y?6GdpT?6H8}vdR9b;?(lS@5P zRzB0Q2~GH0FD|K%V?MyHas6H$K{IPU`}LNY7HvL;H&42n)jIhos7k)TSR@#dcXFAE zO0|TLi)>5)LEn+C>-`wkCTC`mL+bkvZnWUgHL!R5I@u_B?Kke}QUgL}7rXFs$ebY6 zeg@D*awOUk8WrCj6~;{}oIXf(=CZn@dCREQ`qsyN*WT+L45tWb3qPm?Lg48Mk(#-q zyC1OT_t>F~*C`Kvb$1!^qo8`X5Z4F@wNPJpg|+-c61v0|W|e=BVxh{3EI1Ywl`&`? z&{|Y~kNylUR6q1An5AfPd3uK@JI9wFky`x*`q_Q_asrPwmd&IsK43ilgF5-Nxtyk* zNQEBHM5~cPot1&sVyii*qrH5-PIqypA(?EXDf3{Jr^?WbV9p6<^@#`F^>n41{?s>$ zJP>uww|j-fbm;1IRH4+8Y>&G=^&6(IZa}{`bzK6Yv4nzUf=JX1XO<4%lyN#CQJ3OF zRJzibEyhS`*Qx(xq6T^yO0;Gr6ZwzXqwk&mbMJ#^QV9YvPxY`%sGRn4Xv8xem!nb$ z-%^grnCsTYEuXvN)UuJDIbb?_#3lPsj)AUe}6cR>& zb`C-6Aq+tydG85o0;+WccdTfTsE)a}2XSj?F zP+_uVm>+Oo9$Ew;8RQO9@m;>R0j*{otRU8+3P|N=vOcd968o@JAc%1*s{OG zQ|5GdW+a%ms1x5e_ug3`5g&-S?(a!0A}i0bN*RE=W2supvA|vQJ%d~@!l?3UTB}SsD?xy_R{(A= z8ymmMNQnWVpJs81?UUjB6p57xy3W1hjj7k|z3~E<>(eH);LDx3K;46Le!vE|(G!tP zd1R<--AnMO!9)oSi8bx0>I?}J#rkb#OL!YKb9T^GB8SfH>r3l<(#)ir1Q%m>%m;6Y zdx{L8>GuN~6>pUmYMTUTNg>8%R8Be{;o4AB3BZqu1)|TwyM6_@F%O++s7l;SQM9^| z8%h@NPbULGrg!PpIizS(J{LF(?N{swUi_qoFFr#DMQ&!`A37w3%x_53=;FERFbWb@ zm#2*L10TzU(7tuXRYIVxLmLhI5qv^1`Bq&_M`ZQDVsCW)r0<9Jvx=W7o(v}4ZsgS% zkk%;sLIk?lqg=9wUTum!d4Y%E!`ak=SV3ytw&wQN^OB{{nWcb)lBW8(J2LK~eFk;u z7LQW1vq|8p<<|;fpKn<*+Mg%ZzPja^2rxvyzOeimX@B+TmYgFq??=rh^k{pPEgLwA zgh21>mcLW)jpxpTT3<8;!da%yQ2F?*I^WSq8WVW(l~joC%VUyqm;*f z;J1kM4h_fLRf?csg!;)E7wrIP`dP39-`Vz0jDfCclE?ZTG1L&-*10C)=MTOgi0%Zp zL{_b>+)3(>zw*b?(KBEIi?vmf6XdkZ0>~8L%^_FpX~@3Gm(8bm7k<&}dK|4H?a;y0 z#gCpjj~U~V2)Od)uCG2syY2IF5aQ60BlwO*{%xVxjz65)WUWvoiEt|Yd^yJ!zI8em z*(bAIk?8Ju#m{B5h-=xohyXTjTagv_V+*Q7EXk-0-~#YceYCks*UDjVtcp11`hC2> z!~xqieFFjV&0rRw7FDyvusQ=V5-2n|rAPWj$wUHXL<%h>@~akXT*0ZJzm}=BSXv#5 zQ<3_x#m3ZL2Vr<#z>*c<(N6^M^c}gw>$7|f*hf>mfUqtPfmq=7W8K61*WMud;A|K4 zOHH(}boM5Z`mans&N>b{nmyexL!Wr7 zXzRU+<0~Z1=wpfzxQkTo4~#iDU)E?}ORMEm)%h0k_Kw&-2pm!^zVzOd;~PPsCvE^tXB8 zX)(L1;Y4D(Z|@Ifhiuw$^cAPqD$j{92RQS(8IUJRqb8;wvkNPhy3{R@k5}`)+SfvI zCi=y3()E(+%%6Tb7}q-soaor*Muq{3`8^(M+#)y#O63C4|vvvbRR6t@z1x4=8 z14rDeM^1i0Qxe;Lp(My;IYix?mU_&5GpIsGPL_CZnlHplKn+X=SE; zbfE%nuTS67A~T9tY7Kt>Q(l3-EUjR?kmbd_Ww!Z+uqSr*QRCn9+X_||Q!H77Xhi9`9Cm%m67ClV`(4%4 z>|{#RYRMbELoL&&aTV_;3?|YVrSzB#9UM#0{SpK(&U1MyQ)tE)H|FPonB+QmIr|C- z&!!4iI@Sm4PBQ23dijw$?4A!f(^6hydZeyhmm6Mi8UXL(=Qa59T1_Vzcc>s!w)gJZ zqUS*`X2I&8^T#(PKYftA_l?wT1N7o4($9asdJrK_2wsk4D_1cY9<@0b@te+IpD_Tt##wm2Op zaD5+OsQsq-HGfe;#$7ETMeq6S8{%}F2Ce@iXqBGz(<5C}QYLr)i$0;oFZN^0kD2^g zZD-wI;|8>S(qTA;GCv(6f&=7{C&k`{yvP+G->DhwCr(aVJsG4oqa&JBO^#!LhF5~( z*edt$x!KBN370sGZ)Jv;4<7-0<5+Y!FXS6c1`}OJ1?|a9M7wb5&0iQz8Fj)=E<6;C zeU+!YlG}*M9UbXJiVaXp3bZU|b1EcokMnxe>itTzB2pAPKF3VJ6HS|6e<1jfBl)w? znna~?=pi#;E#6srQ#T?G>}5ZPrWca{_FpD!;>USI{ZyxZXd|%St;6-JRVnlJEqfFp zDWSSmRpA`VU57ez?3=dzqA7jS7Y{^6oaNnzKxI2|S&M@RDZ7_8yzEKFJ)l`?zWhzo z_50=o{3F3g53CesE8{Z|JErKVuV51EFAYQ<>n~<;2}Rv|zG%5s5k6bjW9Yc&A382q zSA*E?wd`*;oYlWLr zjCqsU5jn3?_(k~Mrfso?EvWw?Y|0WEO9$Mn%jooEMS?K05V>RWEq&!wzKvEoB2+7P z!A858jZ9~C;N_Xa0Q+ksu~*zAA_()!*LQ5D0FN~?oO@(S6M-E4>DjLQW!KD3z$#_y zV*57JB7bDIShAy3*(>&ptw_0qMKPn}tBEeg0C0UQC(5ay@*#_AdV2kox)OA+SYl)8 zGZMR7X?X|2l#_bh01(;*rB85+#Ek$qcAZ-<$3qe<;V%7wW8lI+)x)lxw_1zc`P z^^XP;rHXIA<+O5QhC$-)+R%ImcN+Kml)nL zS2_#hBX@V)9Aa@)zNW+6$N<1gqe8yoT@a{>HS~@8EXNYEe9v)o9EFI)o#4Kae*?5^`3$e`jmMt{p9KYqVBDN;`+j`&0xVo2p&9v z;O@cQ-GjTkI|O%kZQLceLvVN34(_gvG}HNiHIv^|&BfGA&Bau4)z!6o^X{|zoPM9R z)@Er7L>h>F+Rs)gQC6zTEyq&o)Z19B;AAf9H87TJq47j zySF7`B@!1cbazJ`w9n6Jl7l&n3a}I2OndRxqRXie)ZF@In05aQ%PbtedB?Pn= zmbLOP{3*zpB^*iFi-!-;y*4f6e!yt#k!rf;H1ev~+`DwFDK=Hziw93Bi+>Q1u;-J} z{)Kh%#wxzq?F(ahsRWd}8^7lAG=cQ8AHn?DjT#i-lvWP_As5yg$TxlpB~lOFm~Z=K(6d-XTkT=A@K`Pxuyy zAt(7=r7;XU^^@nXj+nXl{e@hJLB+LMOLX>#&2>&EC9Q_1<0WFXiti{Z$P8oSm$FB7 z$0bs^#nMCna`H4_&6XpUNwLwGh}Q=(?^@1%A#^TpA0v!li($2j8C=8$SQ zCtk;2Osza4k#$$}KbZRJ`1@gp^%QQFGY`7t8hOb`C%)qZK_c1(-?dt zj zHFWfKQNWyPmU=wbCAHplFSR+j|Ionyz~f74oNk&|_EeA7lMF z1QAQ$r74Sw|1&v#vHEM1!8?c-7yJk2h#;1jc_TS2LbCsZqxo0<<+xT^;zV%&z?}OB zh)pJzQ`I@?ALxU8FeLoLfye{%ADDyWJ5UPn?yJlw{sVo(cz=C7|FG5S0onOuJo0tTbBAJI$S-Um-|mq55_^Ca|>$p84`&tP=UzqG4T z=x{@=$NZ0OVY^*@%Mt>9hk)r+-aY^pu##jZsZ9eitd) zEU7kR?XF&%+t);1Yc_OGkL|x3Z>sNR)Xu0?QGfJ@kzIu(2WJyaY?PTu+dR>j0#t(O1u7l(iKobHxVNf zs*;ZVD>)=gVexN`?v4(6{@QW>*Wb^ZztRT)r`5mI1%K*03oeUmF^G+^fm9L}xp_pwxbPcU{i=6teK$7v32mN?u@0n~0BUA9Vh zypsF6vQodiY_*e1$F_``Eq#;{#%cb?uSd3@)M|G&0dqXK{?+OJc-L<+#p10Z+;((B z+Pm4Q#^K;OYTM=_L-FY88%O65>77@{H6VrQuU=s1VAE>|C^8F{v^^?NUoQCR$JE|+ zgeudNd0yA=Z7_{xXWaZ$m-L==0IJCu1=CB zhEvdk`(4|Rl{+l&gQ`VrxQT{EZbQvhCEauqNFmQ1$q)a7;f?>QS5|gK zZW#Y<_Wzd?j3dn?pg?88g03xLFzgMWTXx(1P`%L-s5F3_FPe>XxJeGJtJ?%nW^&y|Fahzfmj8CZkHx@VQrdf5Y(FhfN&G0btXPJjQJaJlQ^`=(bl4D^e4 zBM;>F)zBy%eC0mJ#-mJX2&Fppva@nX>OmzicKA?Ple5OPA~qimrZUCjeir40*{MF| zUS$ohlt6Qt1bF47UaLPRc*^NXRC`dJ`y)?)wNwdOzNz|S_j)Vswb_1%26v3nb9m(E z`8wtR7$+^v&Yga;@pUw00Kw*=Qo*-kTmBFMh{df$hpkm^SE$wyep09JaY9_7{3pMz zxn_@4Oz4{P{x-@B7X>=nUPQju+$eUi%#SAcXL)Ubv+IHBMoF^B+ivVLk@57g!_7+O z;+k-=s%z0JcZ@N|DDLvN$h@7!FAy{ho+G_E7v`T@i*ZV|+sZz_i(8r+`jI{GkkLs| ztK$A(t%=4arKQWEC$kd9{eXVySYnUa?C`3Anc-e_Pm~!4A)MA@re}$gU~2F*#u%@NzcstcuJb6XWkU8d_7k8k_0;`;N;M z*wW0F8hJTPCw9Pxug7?J7WVnJ#j5Tpj_* z$8QXd27Nwr`k;hFYyTAWdl?DhE^gWB`Ii%~8&6b#i5NyWmO5YnHATDztlre#T^Uqu9N+!8V_7;xKK~ z2rUxRG!5y$B{hF7x!7=0uTKZZ_ZmqnIB}t7s=e9{_?w*l*10OOxt;<8>(;)>^NZNSL{%BHHyr zP{(-Zw#p|-qVXAz)|wRro5w)x39D3bTeL)`68b+ie(d^>hXdwsv$4xuAei0pBb)t) zE0)w>LYj>#V+Sp*nXHP}#~5_u*DZ6SIDzdueW_d&?at@hY$|6jM5`RtF^GDdNgX+4&<7Znf0O z?K6XOZ#xW;KcL|rVhH=nO#L1hrBNBa^g@F0_U!3aZ{*NFx`MoP`4ndH`C0VM8H?Yf z|HfRkJAc9l`ucHIX3SiO$O0v+*0M$xipyqC*InAG8{L%ZZ0ySF5@Nk$^9QYE#^&jo z2umxjCuja>0eyP^*6=B|gZHDApU20dNKHE%DM)lm75;#kcRrDmu0?bTR-~n9?CBZ; zn%?+8oW|NrmlT2&<|RwT_4D3L#v{RcIdeubgJDX_3>HwEb6P<&MExRWAbRbgAw|+C zy*(ypuD`^RaKqt|R&G#7IK20b?~fR9_fKhv$2mM@;S=R{Yi5JDTwEv&8FS_W0voo` zJ+JMNtLxrl|RXhaFcG^(El{|6LIz+)=(B>LP z-|y6zC_WyBhYV9y%}@T~Y4u_BnIVS+s2vBOT;8Wx>7J7=T2EeF|mhVOA@u2(XRx_cLAbwYkZ;! zZ@MsuBQjNS6xlvVzk%niGmoS`+8tbSR3(n3z*-Nf(cL&oW0U@}aQl!0wy#{=<~+;9 zna*=il|?A)qa`&+VbDDZFl%G&)kPeW*D^F0WEQ<_4wJj<2ld>|pa@2YdVX4BHy7gG2pizPIkS1=_eO&020m!F2v$^zJg{zLcYm+v`8 ztDn740fP+#T8R};mnDAoiv5#z#CHSJOKq0h%4FrlvG3W&3}=@Z@)g}RqCR&b6qr^@ zZcZs87ZtVthP8mprr2PZH3H8%rtvFG`bW!ugawfl3~`s%1d!OKA|@ea|JFo zjupzx3Z3;8xl~zSK`-B~Aw%fC32hdT_?25ke_NcFRdHdf%Atjhu5gmM;87+i?03Kt z7zmdKvo>Z~Ai0hm||ADyjx5H%ZWFl>yVguyBcoQPSL#0va*FjW$;7seZyA#yN{ zM)V)e7vJP0o1v}P1^dhDploQhBvh?H4KDE0N_GbY;oCLYG@(8;nQoOL?#s-OYZrRJze7 z#%po85fmUH3oZAe0Y<03*tYV^VmKmt8%Gtx-~gt*q+Y-?ItXC66<1ZRrVFa zWmcJt%-isPJSuW&|NIDo)o%5rQ66(uG2qowTZqVMH3f)bmEW-dx*1j%sjTAffmc=z z55CY{9!0#~g(g!OE|x!_YMiSg3uf&ctdM$4==@BrSt8_B7q@$CW+XJ1l~$!EsBM2Jd@y381WrED5cjbMy}t=~AQ#^^Y{B>xDiwQ9KA(0T**4(+A}j1tAx}63(u> ziE%VkEsd|Q3dwBom+f>kq;z?9ymMdEK}5LLg(AXhVyZUx{>mnBSO{_O0VK;!42xS; z=;Z@iylGkO?u3Ee8I~ss>y}>8b)pJgB7%s0S~$6}WBRxYcsaAK#GDllcFNqeCJ8H^ z1(xrj@-;OGZN#q1+CI?wbP^t?G;Lm&yeE!6T|)2>dFxT@=JRME z@0G@OPOI25iL``v3j8q5w0fuY@Jmq>V+~3A?pL9vr21)?V1OioyUsi!A~2N|e}19c zM^-!02S-$s?@#%qmq3p8;a8Xx0)to%+8PvrjE+HXg_v@y?4Zrq?CuaVkwQ)ULpC*` zbN}tN0+&8k;`VulP&P#hhd=XV;w_enrV~ewSlnoCpf+Le`&%KleVpoicYCli6F-5M9JliwV_Zg=+T0om z^Zn?sr})}mAFj;P2YJm;;jI-YK9@=rHz;ToC{G`npFA86gXUeQ>^-NjRclSUJwE#a zYrmgHMhjo4EmWrX9qy6^!NL_k2@}%$;3eaVuWQlKVzAqKG5$GR&2~TQDU54aU#*`F zhGu-Z(hO^NzzHm|?sQ%|+-@LK$44C-<;5CVlp{bzUq9Bq!6U|Ow&7j%kK2@+<5CR-m5RMY z659ep26N&-@sRGFqCIWGgSjeN4I(ZdTzunqO0k1j@mlZQs9E-(oo48Tq2wOdq%{Sb zPx-8|Lx2w!c--bt7Z!5$R`|vrHC8OySqatu_1U2@nKYD`FeV)1u$tbB?U4Is zev&W+{}~$oHgaybZXyh1S?EpAz@kf%A9Iv>AJ4fu4>Mdk^~8%XAm6`d)vQ#-Ecu0! z$?zo65(;;Gy0cY~a{NapLu;YMZ1bhkWj>xF(s2LBd zMn-mOR|5aL1IEi9-czBntTx)!qS-B8J+_FIOE;x5EnAHOY$Az~J^xopbMW1XsW$6Mxsn#P>N}s=h^xK;h!KG#OToMRgTPb}lo;TGF zEc4ECqXbyK9BQ{wAH20tLyHYZlU|4MSLoPp>cdQ@ z>^-VOP`6nSXs{T16bVM@t5}>O5d=+lZ1y$d(QH-8$bLPbzVT%2Ok*RS*B8ZterqY4jaU%YoUYWVDc>tM91$X+t|>lN8`lWDq)iBc4^~00Pt0@g;#qBw zEH`lirdOoZl41)VT=Xh%2ZqnTjXo2W8{PFd9cuA^Fqq9h`M`1yqiW#BcC2&vV2!Jb zXBij9yilht`DmMM(x_D^*d#FY;tuyp*?& zjzmwN@@B+Zby8JlnZ_Q=2smGH@v0kQKzpfFHET%e3ZbRgi>&PPx8(80{W-c2yPKr%j#=kM`bxT4H+}+eV*DlwZ%YOG za(TsGMyF%KvGg%k;~Q%nx|B5g3wN(^#YV}5vY&!#X<=Aw!LC}#{$8T$RxH#L zU8+3j-igs|?|lB4edU$1wybz-O1Cwb5WQWI^P@{r9RI!2k5(ac>_a}4Tu*Te0BnhR zSpv${?qL@NUFNNn4&_zZ>?J*0yu8rM2aPsV8dN>U)lASgSBOUWwC1O|MhgOB~> zXt|-^I%Zoh5o}g@ecvqcbUAIy{BTZ8UQ5ucj)88yg<=9u@Fs)1Ef(%%ma${3Zc?GT zQp+_U&FBE?tx_TSGFIKJSjVy97Dq;@v=j-2r!n*c*7_iDM%(?b1qb02p;A^$#p72k z#YqWEJn-p&RmQ<{czx)k_W9v-_HPa0OOh0E zp55UIwis5$=>F5!wYudoy%ZA=(uHwgH|V+YDptfRK50=Jk!8x5v7g5!luqomDo3O8Ms!3uYRZAlqmv{MY^ zKs^b$!PuN7booXP@eiZFmyDU0up}&%s!y>UbiVRc=SD31eKR7qPD*D3DbqI<+J$LC^J*kSGp1O0u3R3yAg_ z4I9a19xY1n@HvpC6UIZ8NBslQL;4)k2FknK(Mpi(1HH+HUqz zUL*xSEjij)2+pnEi#Klr6Y&lh8j%tOPK%hNU`wmqvn`QcU+u_|olrYg%JK#ZC564L zF7i$&3UXaVq|(?=xk6&QGGj=3!O!yCWVGxrns*h&+Y6ox6wxS_Ee?oWlwaF#R6dLZ za*_zBN|1X^itn#+MLH$mvAsIY$VFu|Ph{DEyuV2Qc=GOkCl2ZI{Z_}rZNpC}nscY1 zhU6rY`;l!!dB*6~JU4%;DOZ+T;8MV<^f`a(qoh(qKsuPTG!ciSw-p9$Jg^uoQL?8z z-7Cqbhp1cJw+W|_Dlc1R%46}-uq7Oq*i@lw5=^BtS5=F2Bh4f+29M$V3a(pZYcSTu z9DBIH13li2TS+O8;Yyz2snn{Vjq5hSv4{q_+Qz@k$dmDTJrIUx)^QGM>13EgGlJ`j z23yeqoo_58iy^5QU%y~=+m{U9m?ZJ>u#5&?bKb$uXY^CmvB;XI)?6+A8A1Qyjhqpb zEV$LNQhRc#QQDYAU3&l7fmP8UZ9ZdkB(jO5`80m>dqYE);D};@0q<&1-dmW5f`b@* z=fAF}?iz~*d_hj2Dn`|pgMx$7Zx>Yy^ti2OLR2V^iA9eb#196zFK~R0X>wtcCHt6!%QJs>@ zn0_hQw0SNqG9mRaQY8%yK;~44a4aZi8?LTE4kYyGdCgU7!>nxew6Wf;dBN#&_SKu$ zhvhhh##~unPSZs}D|55a|Fv=Q3_unBAof~NMMbz;;os-8KjFiFR+16&cJYwdXv#&d z_|y08z*{Eyj7znRf<@L6$!}_lrSA5KPg5%H8GPY9JsR}_d@uqJ&Vy=UzSXj859A1! z7}=QrKzRk8m7ai;D&>9ZFYMZ09&v^FPoUlx#>#)Yo1zj>2DD1wrOCR!YJA@&yv65} zzp>_!Z=@luNTDh`3%RwfV$PVjQ9GOA$p-qB#W%skcETTR7Grlk+H^G~n{_W~9XDMz zxB(OQD{QFEUT^979`_ka(SBbH(l2IQrf#_QQisP`C?XSPtP+*^%yuc&`LeHQ7;o7T z=K^b-7|jOc##Gvm3(70eUavP?-PvW{hNPo+%b&aOc=g2G-fGhd^Kl#enlhS%m1e#L zS=Ozm^->&<4PEFt3lHGDxA3d9W&hCRNP(wHPYRLYi4lOJ^1y&o9P2$bt>W!pi z8DXFITcRoN7rIJ3U2W{6hi!WBTUo+7c-OR*-c3N?K6{m5dvEGmE7Wh4-K8rpN>YpG zb#5a9?4LHQ14q@N=TEWhCY$fdT*Z#rZtdv4cXn2B+H9nvdswO$=GPUg4uD_Ili#yv zs%&0ZwhF)_b{jL8pwDd7+ETsLI@f%sIU8E5DqpS0Fa!~1EX~4}I!aLM)hQ&b>in_{ zEy~GAR?JH+Pem1sy+`Q}FH2!pHY(Gf9tlWZqoW&IjYCbz5It#B)4*!+vovmbq6S)QAm-9s2A}q5WJ(@1>#|srTg%T`;6461(lNBUp4$ z%QL%RvUhs;wdONEpcBUVeaW_!1(~P(K1fRet(`nAp9HP5uzSPN47)}B_}xRm!fA#+ z^T2Os>y-a_ZR7&4`Sgil_R1!Lb1Q?N<&pvRLAy2{dwXr{CW-7f+H}%hda;%=iP)Ka zqFSP3hotO5X3`(bv6qolgwoe|nxuwJA~v#91N?9d1?B5tW5NQiwEtyNO%VSnCo!@! z*#6J63duT`gn-)gKkoSdIBlH3HG~k7$Kqf7J81(75_S%u=*9s%HvdSX0Q3kc1QGJs zc0~Rogc4uUA^oRB#F*y)=Iwurg)qYFmMi*yh!B#;{x=?#{QIWZKhFOx?r#Fn|HUM^ zzmj2SXS7Ug;M;PJwicJ^reieIWWIJLVRWyw;Mw|eqT8&~HJ_dlyfV&smg)Aa@z2n2 z)V+uCUBReIJ;vfm_{C;joMk_zN4g*@9sY46;JRmLrCB+@EXl5K;_64Rmg$x*BkSI? zY&f5p+68Tq~KeMm|epN0Oa~1^ut*quZNWrjycsBpC`TbdCAWMMK&6Dw;tbYqg z^oY5pw^c*>zsk-sLRNtF<=UL<--v~xkaAgERn3_GE38BxWC7+b#|n=AO(zZ;k@1rc zWI){h{lmUF?Q6-6Yn4E+#ZRG416g_~JTcBchNyzOR{rD+IsCpnOsp_y`!zM~!{8vmpk`Lc!sOHN1zAxNq}4E*a)p!TI)+A*{E)DoLsWF@d_=k0!b>JfxLqceX!~m5=HtotifK#_ zhO25LA~M|}DmDTqw+PA8`62{+q|G8-_~?HgZU0+HD}wd4+lcS$zgo9oLS~lgNyz#i z!amCnS(Dqh7*No^TK`dk)L-Y=W%~1f*5vK)n!IuEWBfCH|CIiFuuR#KpwYh#`Q;VT zkCJ`6NR$7M7K2_CB7XUQKEZQ102t^H;?c_>J~8wxQ15FG9!^#6e7Z z$31#c;?1Y)dLbPiP+CfP`}V|9QM|sf5zkh^?`VuH6v(xp(4x;*aUFzHGNs$!Z-H!o zd5O5*<^wN^v?u(^wQyyaX_mKYNa9}t(Puod-n!R}eOhjL{@(Q&+-w>f8p{2?b56}{ zZA&?o@pfvU?Ij2oOA3=w`e`n}tE*sL-MfxI)Tq*A^E^8ukdSE2^ zg3$CsQ5!aQ4W!K;17l{`=kGLpdJ@dDQl}4!!3az7f@TKk_nJ)=h)$rVJe4^xpI(Yq zVmTa9@H5DY2CbmSXVz@=)C|%0jZL6jv1vCTDr^gpkqJ>OQisIRc7>#O9!Gh%E<2D* zp1DyaqVnaOKiZC2RCUGj0N;YK7dG&(4r|p8k|W?gVCBM#veG9S1rh{q#f-Cy>=03D zF$~o!?c+?%dL?kcGJVHSO%>)N{brZxO`kLsqtqSVU}4-wp7lh)8%pR#5-;hC;280! z?RP?-Uo=PCd;h!*nqeH)GwZbh^)8(K#wF-@6QH5_5^&==Z$z5{0L|dkY|Zty&XCre zG4QnwCd8wW`JjL-DmS=!d3k55jF4X*7bu1k$P%kJ0g3zh56>_L2>>TO&})R#lT_y4%}+b(_cG^6JWD2ou~P-`o7D(+b7=OAjXe!LgF=!W zTwdkb>3~gdtg9WbEOldHVx7liHj9!Y<6wSpuv&C^fpcwPY=i0bO;42Q$r;kL1@huZ zX*qX(fsxYe{I|xU{sS7|L|-A6*Njro?tItT7O7w9#8DLh+hY5sgirR$bF4fg+mh8~ zp?c2!U}?a7%@6PX^@>~yTPB;|{NRGWp9>9Ox$E?_a+3CSi013PIMh(&?@9*J?5nxE zP{q$~$J8N&T|v59a{96bbytzfx84HThL1e7%d`7fAQA=8RJ6GgEBs(%15x?)r8X`^ymL}}>`q6Q*H!6AJ`Ovz!$q@vflR$8SpyByR*VwQR`?9tw;B~xBM=+HN+Xy5oI zj%=M-J&CviNlEzlaq?CqU@g)3A!eWO9@Ex~3KsRty(608uiXWj`v|N+)8PY_yyVM= z-DRMcl+0#3akvr1l zuH;Fu7rsl)DpiQF{qk5sgD@Udx4x^nYjH=Q1CLgFLiPAz)Z=!&&&F)p<^>$h6-XdQ zHQIHNG8xsbv8)pMoJoHYQo50@{@gD+USam(0G}qlV_LpE?;{!u@Fu?g>q-pbFDhq3jD=)kklTLKsnGxZ#xt;(TM4xqPe=I) z?&d(SuZ``O>DK4@Y7JZ?@`;`oGAmkMyVWN64d4s$_1;7{?oO9*{a_=+A59I5L-mv4 zxhq3O>*v*r2uY<|?ehG+0qsuK)fWUgjcxRGxH^jC4$q?~!#W^MgNix0^N;y;Lj)Q~?0uGiTdK zQ@W<0&E$OrDbO(14|Lq15*b9x%&5l!YBovuY>I^HJ~|7`bUfzj%V~@nRD@i4_(Opo zZI=BSV|-IBT%42+jw7$^`kqL<*w^$1`QQFvdEX2?mn!8Yf!KW$eq%tMeS8d!J9-un zN{=4i;pRbvCg?884uh_VaJ zh_EA@yDp&z3hl&F=pUEAwvfw7?I&r7h3eWWp)E*rxrQ+=`K?afG2c~-(X8P_x$Ju~ zO+s08$dvF~tkUFr?j<8QNH{hl%uv|$9X{zT&_J=FKkW_fe0M&pp4nKj(WA3J{9<_3 z6qWEEGKLg&(WQ$)aYWfaJK?Yn$5>oE=9{Z`7Z0GW@E9x6tpQ* zw_BuBT}i_JrqkM{SiG!Sz7LRm-ZrVuyj12SX^cB^yLgO@#86{?Y?GmKct@K>3?G}- zaNA%gTUlUAh)dX*IxlfJbm1J@1_*~u_#jRM`qOvMCuT?=F$M>a$R_2mS-PBHAL8HvNRH+u}u8Wl{>Qhq7; z+l?10lnGstqG2cQH{%}{$?I5Qv{}YiI4M-(X8Ta_lcSxz&sC$HQ$&b?jI48+$2G}y za2qA%*z%S|e)7wFjmBhx+3iU0g!t7G|FiL{scaH`5)5!^JqjX6SvymU4glW)T$h<& zR9~8{2yJ)|!E;-W7WdfmK7O>D7~P(Da2X2h&|tF)5vTJcD5yA|QFPy4%I$n}iDz>`(}Q1chlDGQ^C}URC;TVuEH%{L8Lz`8xh&75 zW*5vcBLy3lA9z$&Myn2sH>WvAliz0xug#lBiom3U@wucqUbuKUE4d5Qz>QtAk~aWv zLnkK&#cXpxnM|iB(MyBXKQ4-YxkWQ&rCLJ&1G$lJ{w1`3=9NmdSWMtKBJLE}$;ZV( z8~e*`D7Pdk?3`c)-=lu*K%>ZAw{!=&^&;j4O|R({_9<2`8ttZuRBH1e>_M|IDV%*R z-3c7xPLkOm9BrO4xAFaoTQMvC33G}rr)ROCHL)+kO83%|@Q=lnz}r+#{W9g;iib#l z%GB{=cKWmZ{lOp4f!f=7whx>3&~(C%y?Pyc+3}7M2&!9&_Qw7!U#-?%w~H6;)OGRD6(*WZS{bA` z?u{4I;Zo`qe|J6S3<^bWULG34>VhtWi)ditgdNvoO>|ncNr$RAAccTQg$E~_nKa1yekLr5;P?F8SZpC zKZYH}PpxAs8G@@=Qca#Z<;wZQcFG}IA(d=3>J)ewFV^Wr7uRRgn8_Il+1j@+q=nR{ zN-w(%SNv;Bbb*B3cVdEwQv7ax1~#zdzS&89kniB*)J@4Ng&Z2gdGE@&pSKX6qKV%o zwdlMmEtU3uEa~+zV?cp^8dZMki@C3d}>6myVOfRV8;{*n`B2mcYQT&M{#x26y)I0hmihQ^rsHxN-kHUt&$xe z=JeHUZ@TM-M1{9zezj|K@Guv3jslxmF(I;wfif4S7vH^WL9ydv9h>&ixe#d?`K{8;g;E zJQ^wnTQgG=ej1|KW4-nEw_cvB%s>B(qbYO3MKviw-SW(^5Me2J%D>@*{am!s5O<6{ z8nQ%#(@&4K0b|+_`nR3E5nWIi(*s&9#AWpgk~6boH0P^+G5~F?ZiviG%F7<};hc72Eyf_n2YU3X z)9PT>i~gKUYRt`6o&gQ#IE+GBtW(&0Ybrr~FRNL>iJyMbgg}>Y_?f&zduw)(V)f z$h||HQvfNsDlL|9K-$aNWuIF~x(FlHD~F~5LtpEomb+dxDWv093Ck2a6`}~ZVY=m~ zYh=|wN?-Vat7v_$`!hSaew^%1zBX(CF2JFVZW zRXd*VjBVZ?RM+stZlZqD2YNeQi z&FZEWLHEZn(%FUu_*^lSXO{}Inxm3Qzi*qJ^;0_HavBdmIC^5l_6HX*jVTfR^ES4^0jDs}OZ)70z$T3>x2Np2}47lmi_h((5$r6J?tTPB;D2;fPhJGUJ}p zMW5HAnNB2RHVG{{vGaVF zdDn1Ol10Z4@7_^KN{R@o=-caJMj=DtnC0BhCH)>iY7UPL;|36nN4 zV?7%S5@wEO_bOJwXZyZ&@1F_;y4Kwv?&uG1EX6UA7i$95xyk7=_y}IR@M2bw)eL<) z%I?dPNA-W5LdYP@vmSWD2lBW=fM%blBY5kCA9Jpci&%*6f9PYRR8~T9GDrt-&oW~; zx-3qsAM+oIhqRQ7rq#ie`(A?vOEcowJF34Y!X&)CXlAM zh`A~~{Xp95L}=WrJHPTVkZvX&c(xziK_Wc5d?Sb{WSd1(2N-{_js2WCwjUkFsjAl_ zqNLFvAm3X7%SoUL)kQx4^3?kVucLl-b4FYPztsw#{{ARWE-{Hd%z(9&7ABbRqG@2V&}!CBBH4|BrFZ z;&0k&hKDNaf6SV*kaNzaZ?A|z|1oREnL=*4#p&vz!vBn8|6dF!k*UQ}hnV9wABX>sVQ+~9V%XEX2weP+VXqAm zEuC?$$3z_WukzZF5D|-2C#t6KKgf0jiIz5R^BeFM_y;KL=^!Af`i{>WB=lh=>J7PVodXuCEts0^{`8D*xsGLP{CSuax4)_F4);Hr#1bKX9!e)) zJzMLvmu)daZPJ>AMwb}-OHLq%Oq_kwhxHG$|Fh3Ys_9$KE*pDJ=GiTI#&>tAmVc*R zD|8#2=-#ow7W`@T-ZgCemJvO+xxMr(o8R7?n`je`{?t`_NTY~T`W@tek^CuN6!PCx z?txJC9{)=41li~cLsH+=|nQ~3Yi`__>+GvI3=Tq!}|w=uIp&*a>)FEfGH zlx}Dyz5=b=7p~xBf#iHn7rOPXw@<HkzD?l#6h;XK@p#d-ZSGjM;Nu!~~ z$w(BX@s6o~)l-nTkt^MY{o!mH|QYI`}>QU!!$Vf5yUu`+x#s;OJGvC(0`2Jj2b3N2zG;a^O8pfjU{ZjT6k zPz~&%DNr+9@JGhp^0=FX83#Jx@zbsbF5#v0gsC5Et>B@75Flbwp|#^4E~xVUgNg!m z!|gUwbEUj5PfZoJE_PCSw7T`kMrKt)scMY?iJu=IP2Q_nuSd%G^0{|8puj$vNmp(~nN%XH2CYI(W0};Xr?EZ|%`?&7#T=)g$F?fwJ7|o?DSbK-9gNKBMml z+WGX_$K7oni6@Q$CWq*pGKT@dOD@=GdlY81+h1M}L9}~v>i5{3@B;z0(M}%nXGV`e zwc;E%{bnxq6Q)F1W_17g=jg=v(rXRLFWKlVUke1-z}zs+=ls2XIW-aTnyP}PdJH0w zk1L)e1ik*x0QR0hVs$xKn!;X*4wv?DGh-QT z2l#eBj0cquIPS=!)xVt(m|FDhql|y^{~++2?QOv9-KDn(xK}E}tQS!c8;bVoJ13JlGmE{<$pDrkjeFQ(N zaR*_J1}ZA2aC@=}kK*m31~fa@H$QN&z5u=Lt1qiy={-6&M7c=NNTAuk)@FZi~egMH} zB}Pl;+YTqO3wM2GFIU z+{o+o8R2rq0EmWJUrEs7&xCGI>?UCH)s5%546YO7JFcQf{~U0UT~Z2WBAyh_-w~jV zKJ;%EGv5I_BwQayhY!+VaFokIm^R|FwKR$=@?x}3u*nd-~E5{Ik2PC6<5tU?=~c` z{6-~%w8dRDNK1M?b7enIB=-uv`mcw|gz zLxhYG(hAK$=BRqo^*rY~A00OI0y)MpHc}?Q=#nJxCEn%1H0AWhTq5+B;{0#zeRoik zU$?FVRIt#CfT4G!2+|P{lwPES9y&;uD!q#I-XS0$QbXuShftK>K{|r;-U&@OFTd|Q zgJ;g%nLBsp{`ck2J(D-f;SJLcLyxB%Ne%YvdHxrkKW; zTTpLWxDw@BtWT1=zG_(9&JpCIX>68b@`h`uG^{y>wuQrZO|M(d7cpT~P;#Owm-n(O ztgEyMb&0*k7T>)6sFspAXjG$gUo9<~%Qdm4z3wdk^sH$vb=AYu<3mP+f9p$ci7X1* zXHqRYw46>WiKk87CN18q`%e?VjgK=S?)@mEG#BN+n)YLcHaCJJ)PdnT(dc4P2hlX>#~maKvwsS zh8$3OsiRFw*>!IZ?`n5*pZJhw=SS%N&`9E9+_-iRlkJ9Al8*>K<0xi+YT$c1EAfQ5 zmo? zY6)VWTW4v(5GLQHUxUJ}i0n}bQn?OQmAlKBo}VGZ^T1ubNt&qpY`4?L3@-=Lo;{mp z8*KdfL6wt6Yeb4_CBHLsOhGGe-<;iRp-N3U=qnF$C{Na zLY5CCL^~qZU3vZ#w=b7*Csom2RhV>b!4Z$4<+gmO<8b`u&cVY~6O0!XrRlUFMXW)s z11){YILF|8ndErK;dtYu7$wOk8FA|ur!oqCK2TPS@1Q?>KKOwa1x5Q_h$82`^V8#u z6VKXb9d9Gw`qA*dqj*?7ndTtrK#!))%wNqQR!v!NLN5k+Iw;^Zt@YXPPs^eC-Xvj9 zm7rGnA|X4_Cs&N8uKuJHl5%D=`ehc#41aRjYX@vx?itoq^f*9pw=|G=x262b(f{)K zpBjj%08ZuPV0=V}ojfQ4o_Xk(Qsh#zpEMD*KN8f(YFH-UQX=4rrvIl=f*c&7ztem8 zGDyjI)h|vPc^>ks5zcKow(`e(#)~SRTgCFh+o}&LZqXdkF#~A7p@`o;EF2$nx-@-~Nx^FYpi$jsOGTe;wNDaUTq$|KG^$EMaq$|lRJpZab^F6MTd{a2-S)inMR8N( z96U@P1z?dz?X6IAJ+{|}21k9g0mr*-GsHh#Dn$Z z4b|~VM7TTX8_>%=+7g37wuX);=X98(C+i3F3~3zy7+bMYXIBGluMhu_-sHc-no z1t?J{6J6Ya?e0i<=t|YxNsqvkqBIsMG}`BWbMLfa0+_u_gv3_JZ!p%)2FOgUU9Bin z-F1>I7w-sr^xBs;lXT7WP+4Z)0&6t-Wl3K1IH66GPH=aIf<(0-y|T7Oho(Kcvo_Y0mG88 z(r(}vuDYP8WkPoe0yRS|dboL#A@P;pp9i5$I7{B)UZbS#j2mV8*nIq+sZ9!ExymP( zZZ0kuSM}%9)Ul6q36;_A|{<)RLlkBKj~zj(6I+TFuToo>~3Q zO?JoqmpZKypL_H+sOR?dFNMLzWS=WF&<0}7gbQ6sIvWdmuWeHCpb(8 z5!=fB9G6gj0No096SaWP(ocMVq&Oad7QUHd8UJpZ5gpjfOgRiSP;Q zNxQ(&xl=8F9%EbKmum$a@h#%dxP}JEU1)f4KG2IioYuOZZcZyxG_O~HKJ!pr&d5fc z*01sn64^{_@el(6REu(T0I{UWe-e*uyB2nXH?&EESQ7K6?tf->!ze$ycm)KPfLWG8 zUd;@TRQ1%~#uj`rq>+Hi_$^E``LCWlbOtxN%k0i_=-)?m7~ni@j0_oWqZQG<%D`9z zP0xqFpJ)wejH^OErQFIh#XypP?vf|;+4SFqtx5qM^e6+d*{wYD4&b$bF{X0sq}y=H zje$D>CIk<;WvI{zIw6nty0#qd%y?cBRCmpi?_tX~e17=T?qTOW)MX31c}nuq!tx+H zpAyG-)$Gd{dtxO@i@^{p{ zc6a8`Ag3_hq*Dp|-cN<=<&AE4oyuMJVJ1(5!IjYKr#(0^R_q>)L8v#zNS_4zS-WkD zgT$W*BN{Xhz_jg{=c}+UzCnDw8pX%!SBZb%t@UC*fM!dn&*!)^Vs9r= z7l=FN_cS~p6Tc1gklytA`r$g@DSL~C-A$J#_CpqP%v*F#Zn{B{F1|cuzC{;#)8(nI z7oJIdJ6qAufibgiRBzs2LA#`zDqH{W2BQ3x7Em*&&6v(Oq5E??$NqhZZ6&kFsO(&z zNO!Dj7DNKkzwVgC>E5b4ij4?fiDi?#^$NOTiBRmEQa!`a@;s%@{TLs}O>Dy-@Yq9OuuY#QY-S+AY`<_Y*aNdh2+{!we@lj*E*oha$d#I*lJ4zGkztC^2H@cj<@8 z*f)b!HncO5H9^$0xvietdkn;}NLAdyYaZ9oAFiyNOXD*6n%|P4XzttRHU->xvqCSb zF$WJx+Nv6)l$8~UGC!(Qwumy8P{#!a{>(X`8XT8H$tFF0*l`M79jx{APQNp2zd)R- zFcWY;%9yj!m?u;T+*p}W<}m&I@`W=rmg1{bMIn>w3%(smk@k`iKC0hy5|1u2t9Is4 zfqg9#XVaYa1|-0Dz-H0N5duKsQX1TCflY2XeMG9@D>(xJIgw5Az!6ZPhLBHmdxXGh z%>e1S*B$pFE;QXXQo}uok?pgq&n*Vrjtb8c&3v3aH^WIr`mCokG>JK6$FERn=Do{fP6o)c^JX3AmrRdHxyYBr59Wh#roO&>Qkje~{KT)=?Ez_&FMf(8-O+FrX2S)Lsp@(31bU(94jA5eF)MIvdn!+BWS~?^^HEaCFC3)HR$+l*43TX}ed-;FpE3 zFYGcpVtpDfp$@yPZZ>Z)$AZYoN{{WarXqn1a7}S~u-d$LvGk@c$Sqe}>(Oa`J$nWz zodMmA^Ia?C;YGkk%O(#H!S$yeUD`0y{>}y>(j2V5z&DPWV)M;bzIutA^00x~_8REB zeVO#%f+KTj%_MHGlbbYHG0-)@uc}joO20@Y6WdB@q>$3#N&(9oT^NvuC17`x4N56T z(W?>oJpR70a3AZ5?EHBjrm#C<&gSA&--H$i6pdRNDF(Xidw*w!=I-I|fsFGh>$CY7 zRd#x@yd9yaAbeh#Pm1TRU1(u_csRyBGJnbzABni~k z#E~px|W5l^RdB614zR{1nXKu#w z)3Vx6@+c}?EH)(=;+hqc>kax!({2;Q|-r#wc z6s(NJ()}7FK7aI`+|_2!$t3PHYq5FFdUBhoQkR-7zwv=tNq5S>GDWzs(TdUf_;;r^ zWGK5*2betutfnn^%PXv64z$(#rP15F%zGm%LW*~v(rt=rq}7BjJ3N}U15u8#n~gDY za8dZ>cMPqaH_Oy`q0r2**CQ`$K?tf#sgof6Z|guzUnn@Hg7x7`PF zZVR3Qlt>(4hPXx6e_dQkBPoC#?O~FvbW1Ae3^0K)iPG}Fs?1XToA2CQtlpMTr3Mzu zInZZ97}bj0ASa4!k_ z3G+Al#D+ik@P#x7C63jj9z6oadFtICZ9@C*1<*Dk8(EusTTvKAm^FL982KXKYc;ay zt=(Kug7M96Z3obh@zqxj|Jw8IZ|j|aH*%Iv{_DE;Up|j^z1-%OVo{-i0fhed^FX80 zb=I(3$|fxayrf!C0O{XgNZ#<_SoZ1v!G{6R#;6VN{S9smU`oV)%=-^||5xv=|DXK@NcT$gQ1EfuqKuQSl?k%56>NGEpKM|MnR^ojaS&tyL}2H-^2jhqBy z0dyPh?eAje&7W(t_0`2$Zig#bo@WPp`}?mD+Esf!9L;oa#Y@arTf| zH8)eY);7y4BV3~d8Q0pM&% zZq8ja9R4?6i%xNVp)F`_BoBv}P5Udn!Sl?a(qcrCAnYOWGqLG!HqY(m#loKo46E=l zJ3mWUHW@2~JQ4A9y?j=`S~$QCt;^J|veYayx*Pb2)PH-rIvX%LacJrSwY&Iag5x zx-r*SpU_ujHO{--8Pi5cL}c1UV*l>o;D8I-;HumsCksC8!^6YNrFj#Y+?~h;#`W6rm9ytpR?G@CD$SL*FHg3or&fn^(||4FOb{wL6B9uGY^>X*{kdVYf z9F*wReu2Wq4HkNU3P8RVJj5h#tn}tJQC+zX33dvXJn;Z(ba0|DDNJ`Pj(o#;i zrK}p<>FmICn>%O2JYwJH=GpUKF!(_mUpNBIfK+r%0y{bpNM9iYZq%P95MAKd6TxlP zJJ{dnCR30t$*S+ROyqg7T|E^H&naURo-8%|$V+p+5JXAyey)L7sQlf4?O5zH=E34V zBdy6)eCHy;g@4M<*E|6jP~F7CECJvbyJ#~Tx)N6FQ%@3)vnJ}CS#9SUu$Ci=8-7D% zWz$i=d?<5d6I$UVO_n3LJUKoKt#^S)bSSfx0-GC*@4X~k9r3opOreuZNv^4oz$a9X zD7geu&yu4CMm)dzM@^+04~Vj$N8bmZ0UL>tHdB&s9HA3L#$##F6-%$ppX+mVb|1Af zD`8-e`BT%#d35yRbbpcO{mB?yLjs(qm_FPvF?Lq#xN7&i9ZO+}CCf@=w6azJp<9a| zLCz-$7?&x$xLAVfjbn^r2<>woTSe$pSIYVL`1~JX6&COt9DMssuVKO=8$XK0DK50n zLNOAUc~yJjHzj(Fy<=<{kI7yj2eTxqPO|~~^62%`mwJ+v>eaInw7*%0Fes#o3C|LRvcbBt^x!cl+?4`s2DlMtnYN6VVi~f%e)l)Z`VGU%c=* zvF>SP;cN)79+rFqF*9;5R4edTOc&JJ(O?w4I;CY$ObZ4JeGo&8$8*ZAO;+SVz|Qvb zNHhgck?YGtZLgcuW-t$zpiw(!etKH(@?MF*}7;2uXd{z`y{V|LCx~%7!LOM|wVgI?Il^kxW4L&tC(g z*Vbe&-7ClJPxlPBKM+N!eWy<_IL{^LvrRV9{zYe{ra3jy&h1O3z)GTG<3gvClJGHSYj8_UWc$u;~~5=P0|sqxNP+VgG@ z{Sc)|mC>WqePg*=L74(U^@s!i8y=+_jJ!sdJ`|cDe?Uik2l&XmQG8u2Zs7l4t^g@> literal 0 HcmV?d00001 diff --git a/data/states.rda b/data/states.rda new file mode 100644 index 0000000000000000000000000000000000000000..9bf93668c7af605d2812e60f4eb236649b22ccf5 GIT binary patch literal 782 zcmV+p1M&PHiwFP!0000018r69ZrU&uO+z4jwVJd&08h{#+Y=yIOG*)y~d5zh+?Io5z_Kcr7z` zl_r}0Oofn{^1RyTl3>OsGrn1l-@ipPM)U*G6wsiLXo6@CXgEOh9ncjjU!(6R0u&7q zAumc0p~rZJ=n>E@?#37`M!mS&#b_}q$EX)$9WmCCpkA^-G(vQPC`N=?CD?-mbD5y; z1iL%Ip59@mQ_OURDl=4>WA^h0K=+vQqC%**tPs|*#2CxRlT#4(3$h|xV$Fsz)rR1v zWWNLlv)Pv$!WB{0ZVyPoo`mEK83R!WNit#W&OmTZQ_a$ywo6}zOliqd-4jneL*H#z zmHUtuWKSf8_*X`aWth%26>^R2#>j9PvsOLINDgtEQBg217-SkoJYxh42_msam9bk= zb4i4qzl zJ26wL{5?Oj%10@&lVFFj;JQkpnb4JV-cuu?F9h3kp3r@7M7GZ=XV}Vixp+gRq6c>+ zrmrj&mF&LvDCEZ47m1KM?+u6)rkfz&eP11tO;tiL$r-9lHidZ;)sdP=x)xA<_l|O| z4#f+pPEB{3i;VUn<+So*CU*ac{l5Akc56<{ekuy3*5~vUUubZzNe*3HP`NdYghUt2 zoTe&`_L7*6@wLWe&zDr`-U+R>WGWS0F<^zugV-9s(&6~eGSbJp*<8G3{T7$^Z>J37 z%&p^{{mu*RDEV~g1W zavDx7;MMF1PB@{hx$bbFepmxt-|?+EbKvCX>ci~T>}p!Q58ui