diff --git a/._timeseries.Rproj b/._timeseries.Rproj
index 364cb68..b57fc73 100644
Binary files a/._timeseries.Rproj and b/._timeseries.Rproj differ
diff --git a/.gitignore b/.gitignore
index 807ea25..d893563 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
.Rproj.user
.Rhistory
.RData
+Meta
diff --git a/Meta/vignette.rds b/Meta/vignette.rds
index ff0a06f..0cbe8d7 100644
Binary files a/Meta/vignette.rds and b/Meta/vignette.rds differ
diff --git a/doc/qstacktseries.R b/doc/qstacktseries.R
new file mode 100644
index 0000000..a7ff05b
--- /dev/null
+++ b/doc/qstacktseries.R
@@ -0,0 +1,36 @@
+## ---- include = FALSE---------------------------------------------------------
+knitr::opts_chunk$set(
+ collapse = TRUE,
+ comment = "#>"
+)
+
+## ----setup--------------------------------------------------------------------
+library(timeseries)
+library(gapminder)
+library(dplyr)
+
+## ----dataset------------------------------------------------------------------
+ testdf <- data.frame(year = rep(seq(from = 1980, to= 1990, 1), 3),
+ rainfall = c(runif(11, 0, 100), rnorm(11, 70, 10),
+ rnorm(11, 20, 20)),
+ temp = c(rnorm(11, 70, 30), rnorm(11, 45, 20),
+ rnorm(11, 100, 10)),
+ daysofsun = c(NA, NA, rnorm(9, 280, 50), rnorm(11, 300, 30), NA,
+ rnorm(10, 340, 15)),
+ region = c(rep("A",11), rep("B", 11), rep("C", 11)))
+
+## ----example 1----------------------------------------------------------------
+qstacktseries(testdf, year, rainfall, region, verbose = TRUE)
+
+## ----example 2----------------------------------------------------------------
+qstacktseries(gapminder %>%
+ filter(continent == "Asia"), year, gdpPercap, country, verbose = TRUE)
+
+## ----example 3: Errors, error=TRUE--------------------------------------------
+
+qstacktseries(gapminder %>%
+ filter(continent == "Asia"),continent, pop, country, verbose = TRUE)
+
+qstacktseries(gapminder %>%
+ filter(continent == "Africa"), year, country, continent, verbose = TRUE)
+
diff --git a/doc/qstacktseries.Rmd b/doc/qstacktseries.Rmd
new file mode 100644
index 0000000..c23bc21
--- /dev/null
+++ b/doc/qstacktseries.Rmd
@@ -0,0 +1,57 @@
+---
+title: "qstacktseries"
+output: rmarkdown::html_vignette
+vignette: >
+ %\VignetteIndexEntry{qstacktseries}
+ %\VignetteEngine{knitr::rmarkdown}
+ %\VignetteEncoding{UTF-8}
+---
+
+```{r, include = FALSE}
+knitr::opts_chunk$set(
+ collapse = TRUE,
+ comment = "#>"
+)
+```
+
+```{r setup}
+library(timeseries)
+library(gapminder)
+library(dplyr)
+```
+
+This is how the function `qstacktseries` works:
+
+Building a stacked area time series plot with a dummy data set:
+
+```{r dataset}
+ testdf <- data.frame(year = rep(seq(from = 1980, to= 1990, 1), 3),
+ rainfall = c(runif(11, 0, 100), rnorm(11, 70, 10),
+ rnorm(11, 20, 20)),
+ temp = c(rnorm(11, 70, 30), rnorm(11, 45, 20),
+ rnorm(11, 100, 10)),
+ daysofsun = c(NA, NA, rnorm(9, 280, 50), rnorm(11, 300, 30), NA,
+ rnorm(10, 340, 15)),
+ region = c(rep("A",11), rep("B", 11), rep("C", 11)))
+```
+
+```{r example 1}
+qstacktseries(testdf, year, rainfall, region, verbose = TRUE)
+```
+Building a stacked area time series plot with a pre-existing data set: *gapminder*
+
+```{r example 2}
+qstacktseries(gapminder %>%
+ filter(continent == "Asia"), year, gdpPercap, country, verbose = TRUE)
+```
+These are some errors you might see if `qstacktseries` is given non-numeric input for the *time* or *voi* inputs:
+
+```{r example 3: Errors, error=TRUE}
+
+qstacktseries(gapminder %>%
+ filter(continent == "Asia"),continent, pop, country, verbose = TRUE)
+
+qstacktseries(gapminder %>%
+ filter(continent == "Africa"), year, country, continent, verbose = TRUE)
+```
+
diff --git a/doc/qstacktseries.html b/doc/qstacktseries.html
new file mode 100644
index 0000000..e23927c
--- /dev/null
+++ b/doc/qstacktseries.html
@@ -0,0 +1,375 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+qstacktseries
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+qstacktseries
+
+
+
+library(timeseries)
+library(gapminder)
+library(dplyr)
+#>
+#> Attaching package: 'dplyr'
+#> The following objects are masked from 'package:stats':
+#>
+#> filter, lag
+#> The following objects are masked from 'package:base':
+#>
+#> intersect, setdiff, setequal, union
+This is how the function qstacktseries
works:
+Building a stacked area time series plot with a dummy data set:
+ testdf <- data.frame(year = rep(seq(from = 1980, to= 1990, 1), 3),
+ rainfall = c(runif(11, 0, 100), rnorm(11, 70, 10),
+ rnorm(11, 20, 20)),
+ temp = c(rnorm(11, 70, 30), rnorm(11, 45, 20),
+ rnorm(11, 100, 10)),
+ daysofsun = c(NA, NA, rnorm(9, 280, 50), rnorm(11, 300, 30), NA,
+ rnorm(10, 340, 15)),
+ region = c(rep("A",11), rep("B", 11), rep("C", 11)))
+qstacktseries(testdf, year, rainfall, region, verbose = TRUE)
+#> Plotting time series...Done labelling plot!...Done applying default theme aesthetics!
+
Building a stacked area time series plot with a pre-existing data set: gapminder
+qstacktseries(gapminder %>%
+ filter(continent == "Asia"), year, gdpPercap, country, verbose = TRUE)
+#> Plotting time series...Done labelling plot!...Done applying default theme aesthetics!
+
These are some errors you might see if qstacktseries
is given non-numeric input for the time or voi inputs:
+
+qstacktseries(gapminder %>%
+ filter(continent == "Asia"),continent, pop, country, verbose = TRUE)
+#> Error in qstacktseries(gapminder %>% filter(continent == "Asia"), continent, : Sorry, the time variable needs to be a numeric variable!
+
+qstacktseries(gapminder %>%
+ filter(continent == "Africa"), year, country, continent, verbose = TRUE)
+#> Error in qstacktseries(gapminder %>% filter(continent == "Africa"), year, : Sorry, the variable of interest (dependent) needs to be a numeric variable!
+
+
+
+
+
+
+
+
+
+
+
diff --git a/doc/qtseries.R b/doc/qtseries.R
index 70faa7d..d046fcd 100644
--- a/doc/qtseries.R
+++ b/doc/qtseries.R
@@ -6,6 +6,8 @@ knitr::opts_chunk$set(
## ----setup--------------------------------------------------------------------
library(timeseries)
+library(gapminder)
+library(dplyr)
## ----dummy dataset setup------------------------------------------------------
testdf <- data.frame(year = rep(seq(from = 1980, to= 1990, 1), 3),
@@ -18,19 +20,13 @@ testdf <- data.frame(year = rep(seq(from = 1980, to= 1990, 1), 3),
qtseries(testdf, year, daysofsun, region, verbose = TRUE)
## ----example 2----------------------------------------------------------------
-library(gapminder)
-library(magrittr)
-library(dplyr)
-gapminder %>%
- filter(continent == "Europe")%>%
- qtseries(year, pop, country, verbose = TRUE)
+qtseries(gapminder %>%
+ filter(continent == "Europe"), year, pop, country, verbose = TRUE)
## ----example 3: Errors, error=TRUE--------------------------------------------
-gapminder %>%
- filter(continent == "Europe")%>%
- qtseries(continent, pop, country, verbose = TRUE)
+qtseries(gapminder %>%
+ filter(continent == "Americas"),continent, pop, country, verbose = TRUE)
-gapminder %>%
- filter(continent == "Europe")%>%
- qtseries(year, country, continent, verbose = TRUE)
+qtseries(gapminder %>%
+ filter(continent == "Europe"),year, country, continent, verbose = TRUE)
diff --git a/doc/qtseries.Rmd b/doc/qtseries.Rmd
index 40d8226..ca62a3e 100644
--- a/doc/qtseries.Rmd
+++ b/doc/qtseries.Rmd
@@ -16,11 +16,13 @@ knitr::opts_chunk$set(
```{r setup}
library(timeseries)
+library(gapminder)
+library(dplyr)
```
This is how the function `qtseries` works:
-Building a time series plot with a dummy data set
+Building a time series plot with a dummy data set:
```{r dummy dataset setup}
testdf <- data.frame(year = rep(seq(from = 1980, to= 1990, 1), 3),
@@ -34,24 +36,19 @@ testdf <- data.frame(year = rep(seq(from = 1980, to= 1990, 1), 3),
qtseries(testdf, year, daysofsun, region, verbose = TRUE)
```
-Building a time series plot with the gapminder data set:
+Building a time series plot with the *gapminder* data set:
```{r example 2}
-library(gapminder)
-library(magrittr)
-library(dplyr)
-gapminder %>%
- filter(continent == "Europe")%>%
- qtseries(year, pop, country, verbose = TRUE)
+qtseries(gapminder %>%
+ filter(continent == "Europe"), year, pop, country, verbose = TRUE)
```
+
Some errors you might see if `qtseries` is given non-numeric variables for the *time* or *voi* inputs:
```{r example 3: Errors, error=TRUE}
-gapminder %>%
- filter(continent == "Europe")%>%
- qtseries(continent, pop, country, verbose = TRUE)
+qtseries(gapminder %>%
+ filter(continent == "Americas"),continent, pop, country, verbose = TRUE)
-gapminder %>%
- filter(continent == "Europe")%>%
- qtseries(year, country, continent, verbose = TRUE)
+qtseries(gapminder %>%
+ filter(continent == "Europe"),year, country, continent, verbose = TRUE)
```
diff --git a/doc/qtseries.html b/doc/qtseries.html
index 3ed3dee..6193a3b 100644
--- a/doc/qtseries.html
+++ b/doc/qtseries.html
@@ -319,9 +319,11 @@ qtseries
-
+library(timeseries)
+library(gapminder)
+library(dplyr)
This is how the function qtseries
works:
-Building a time series plot with a dummy data set
+Building a time series plot with a dummy data set:
testdf <- data.frame(year = rep(seq(from = 1980, to= 1990, 1), 3),
rainfall = c(rnorm(11, 100, 30), rnorm(11, 70, 10),rnorm(11, 20, 20)),
temp = c(rnorm(11, 70, 30), rnorm(11, 100, 10),rnorm(11, 45, 20)),
@@ -331,33 +333,20 @@ qtseries
#> Plotting time series...Done labelling plot!...Done applying default theme aesthetics!
#> Warning: Removed 3 rows containing missing values (geom_point).
#> Warning: Removed 3 row(s) containing missing values (geom_path).
-![](data:image/png;base64,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)
-Building a time series plot with the gapminder data set:
-library(gapminder)
-library(magrittr)
-library(dplyr)
-#>
-#> Attaching package: 'dplyr'
-#> The following objects are masked from 'package:stats':
-#>
-#> filter, lag
-#> The following objects are masked from 'package:base':
-#>
-#> intersect, setdiff, setequal, union
-gapminder %>%
- filter(continent == "Europe")%>%
- qtseries(year, pop, country, verbose = TRUE)
-#> Plotting time series...Done labelling plot!...Done applying default theme aesthetics!
-
Some errors you might see if qtseries
is given non-numeric variables for the time or voi inputs:
-gapminder %>%
- filter(continent == "Europe")%>%
- qtseries(continent, pop, country, verbose = TRUE)
-#> Error in qtseries(., continent, pop, country, verbose = TRUE): Sorry, the time variable needs to be a numeric variable!
-
-gapminder %>%
- filter(continent == "Europe")%>%
- qtseries(year, country, continent, verbose = TRUE)
-#> Error in qtseries(., year, country, continent, verbose = TRUE): Sorry, the variable of interest (dependent) needs to be a numeric variable!
+![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASAAAAEgCAYAAAAUg66AAAAEGWlDQ1BrQ0dDb2xvclNwYWNlR2VuZXJpY1JHQgAAOI2NVV1oHFUUPrtzZyMkzlNsNIV0qD8NJQ2TVjShtLp/3d02bpZJNtoi6GT27s6Yyc44M7v9oU9FUHwx6psUxL+3gCAo9Q/bPrQvlQol2tQgKD60+INQ6Ium65k7M5lpurHeZe58853vnnvuuWfvBei5qliWkRQBFpquLRcy4nOHj4g9K5CEh6AXBqFXUR0rXalMAjZPC3e1W99Dwntf2dXd/p+tt0YdFSBxH2Kz5qgLiI8B8KdVy3YBevqRHz/qWh72Yui3MUDEL3q44WPXw3M+fo1pZuQs4tOIBVVTaoiXEI/MxfhGDPsxsNZfoE1q66ro5aJim3XdoLFw72H+n23BaIXzbcOnz5mfPoTvYVz7KzUl5+FRxEuqkp9G/Ajia219thzg25abkRE/BpDc3pqvphHvRFys2weqvp+krbWKIX7nhDbzLOItiM8358pTwdirqpPFnMF2xLc1WvLyOwTAibpbmvHHcvttU57y5+XqNZrLe3lE/Pq8eUj2fXKfOe3pfOjzhJYtB/yll5SDFcSDiH+hRkH25+L+sdxKEAMZahrlSX8ukqMOWy/jXW2m6M9LDBc31B9LFuv6gVKg/0Szi3KAr1kGq1GMjU/aLbnq6/lRxc4XfJ98hTargX++DbMJBSiYMIe9Ck1YAxFkKEAG3xbYaKmDDgYyFK0UGYpfoWYXG+fAPPI6tJnNwb7ClP7IyF+D+bjOtCpkhz6CFrIa/I6sFtNl8auFXGMTP34sNwI/JhkgEtmDz14ySfaRcTIBInmKPE32kxyyE2Tv+thKbEVePDfW/byMM1Kmm0XdObS7oGD/MypMXFPXrCwOtoYjyyn7BV29/MZfsVzpLDdRtuIZnbpXzvlf+ev8MvYr/Gqk4H/kV/G3csdazLuyTMPsbFhzd1UabQbjFvDRmcWJxR3zcfHkVw9GfpbJmeev9F08WW8uDkaslwX6avlWGU6NRKz0g/SHtCy9J30o/ca9zX3Kfc19zn3BXQKRO8ud477hLnAfc1/G9mrzGlrfexZ5GLdn6ZZrrEohI2wVHhZywjbhUWEy8icMCGNCUdiBlq3r+xafL549HQ5jH+an+1y+LlYBifuxAvRN/lVVVOlwlCkdVm9NOL5BE4wkQ2SMlDZU97hX86EilU/lUmkQUztTE6mx1EEPh7OmdqBtAvv8HdWpbrJS6tJj3n0CWdM6busNzRV3S9KTYhqvNiqWmuroiKgYhshMjmhTh9ptWhsF7970j/SbMrsPE1suR5z7DMC+P/Hs+y7ijrQAlhyAgccjbhjPygfeBTjzhNqy28EdkUh8C+DU9+z2v/oyeH791OncxHOs5y2AtTc7nb/f73TWPkD/qwBnjX8BoJ98VQNcC+8AAAA4ZVhJZk1NACoAAAAIAAGHaQAEAAAAAQAAABoAAAAAAAKgAgAEAAAAAQAAASCgAwAEAAAAAQAAASAAAAAAq0AljQAAQABJREFUeAHsXQecFFXSr5nZACw55xwlKUEFUTCAOaCeijkg3mE+PzFjvPPUMysGzDmjGDgREwgqSM45hwWWDMum6a/+NfuGntmemZ6ZnrC7r/gt0+H1C9Xd1ZXLZTCQBo0BjQGNgRRgwJ2CMfWQGgMaAxoDggFNgPSDoDGgMZAyDGgClDLU64E1BjQGNAHSz4DGgMZAyjCgCVDKUK8H1hjQGNAESD8DGgMaAynDQEbKRk7wwIsWLaLPPvuMFi5cSBs3bqQOHTpQt27d6Morr6R69erFPPozzzxDixcvpl69etF1111nu5/Zs2fTyy+/LO2feOIJqlmzpq1r3377bZo2bVrEtpdffjkdc8wxFOv8Ig4QY4PCwkJ6/fXXCesH3mrUqEHt2rWjESNGUPfu3WPs1fqyFStWEHALGD16NDVr1sy6ocNHn3vuOXnOVLdut5syMzPlHvfv359OO+00dYqcmiPwumfPHqpfv76/73K5AT+gigTFxcXGww8/bGRlZcG/qcxfw4YNjS+++CLmJZ944onS57nnnhtVH59//rl/Llu2bLF9LRNM/3VW61HHXnvtNekz1vnZnlAUDbFOfgEt588vqfHUU09F0VvkplOmTPGPNW/evMgXONTi5JNP9o+r7of596KLLjKYWMhoTsxx/PjxRvv27Y2vv/7aoRWkrpsKxwE9++yzdN999/H9J/kCXnbZZdSyZUuaP38+vfHGG7R161Y6//zz6c8//6Q+ffpIu2j+Gzx4MDVt2jSma6MZR7U9/fTTqVGjRmqXxowZQ3v37qXOnTvT2Wef7T/eo0cP2U72/PwTsNj473//K9xb1apVSXFoy5YtozfffFO40lGjRhHW17FjR4uroz/EHxfC/QbUrl07+g7ivKJBgwZ09dVXk9frpX379hF/6Cg3N5c++ugjOv7444Xri3MIWrt2LZ111lnxdpM+16eO9jk/8qZNmwxm8eVrxOKWsX379oBBWAwwqlSpIuePOuoogx8UOY/rVq9ebWzbti2g/bp16+T4zp07/cfxVUdbJmT+Y2oDX7nff//d+O233wxmkdVh+bXigIqKiqQv9MdiYkD7UDstWrSQ+V944YWWTazmp9Zx4MABWTO4g19//dXAvgJ+UYyJEycawIUVYD3A3/fffx+yTfB1uAf8pBvDhg0LOPXJJ5/IcZx76aWXAs5hB2vAXGbNmmUcPHgw4Dy/2IIzrAkwc+ZMY86cObKNtsAl/oLxb3f+/IIbkyZNMr755htZr3pGZIAQ/ykOiEXKgBa7d+82WNSWtZ5xxhlyLhIHVFBQIM/P1KlT/VyT6hTrM18PrhfzLc9A5XnywXNnHYv/wcYDZAW33Xabvw1/jaXJkUceKceuuOKKgEuaNGkix++9917/cSsRp6SkxHj88ceN7Oxsf98ghOedd56Rn58v11oRIOYKpL3H4zFw3g5EIkBW8+Mvs4zD3KGBlwQvPv6YSzD++usv46677vIfw/EbbrghYCqTJ0821Ljq2qFDhxp5eXkB7YJ3TjjhBOkXuHjxxRf9BB4vNYgMc3L+jwCuBUH8+9//HjCXOnXqBODm448/lvONGzcOmDcImfnlNItgduaP+8ScccDYWCtEnUgfh1AECGvq16+f9Ml6L+yGnCOICz4qzC3655CRkWHcfffdBogSAB82hX/1C9yWZ6hQBOjWW2/136D9+/db3hcQJnXzFJGKlwDh5VJ94oHFy6kepDvvvFPmEUyAWEyUa1wul8EiieVcrQ4qQhCKAwpHgKB36d27t/GPf/zDzyniIa9WrZoBYtipUyf/On788UcZHpwGzmN9zZs3l3bqq87ik9UU/ce++uorf3+4HuP37dvXAEFnhbS/ndq48cYbpT3asZhhHH300f7rp0+fLs0UAUIb9MlKWANr2Lx5s+XLbXf+rLSW/oBfEOQHHnjAaNu2rRwDgQkHVgQIRBa6RswN8/zb3/4mXVgRSRAYVlRLO7TFR0LdZ+xfddVVci04PfMHBM/acccdF25qaX+uQhEg1onITWQrV0jEz50713+jwREA4iFA4H7q1q0rfYKDwj6AdTUG656Mc845xwAxNBMgKMnxYOGPrVbS3u5/6sGMhQB17drV/zW95557/HN49dVXZXhwJODGMK8XXnhBjrGlT/bBiShxCMRAzR8cVDh45513DMWBqWvU7yOPPOK/dP369f6xwU0qUC+mEmEUAUIfwDdedCUOW73cdud/5plnyprAtSmxBkSSLXgi5qn7quZl/lUECMSGLW8GuDNFtDFP4BQiJcBqjmaRVN0LiOfmDypEe8CaNWv8uK8ISugK5QekzOtQ0vKDyfe+LLA+x38QSsNwwPc73Gk5B6Xgjh07ZBvKbf4yyzZzGaIwHDduHPHDGNCPUpIz4aLhw4cHnEvkDosDxNZBGQKKdAUnnXSSbFavXt2vvIWyHsA6Fvnlry1hLVCorly5ktAWwMRIfkP9B6Uw3CD+97//0fXXXy/Kc9WWOSF66623ZJc/DMQvuWzj3mEc/EGxDLAaB6Z85iAp3H20O3+YywE//fQTtWrVSuYJhX+bNm3E5ULdV2kU4j+2wMpaWbwkFielFfp67733CMaBUPDzzz/LKbhmMFGVbSZmhGdIAYuRarNC/VYoK5iyprDCkVgRKf4muFvMhoslDNvwC1LQpUsXtSm/wUSLv0IB5612WGnrP2zXtwcX4MUB4Xr00UeJOQF/H4nc4C+zv3s84ApY16U2yXwcB5kzkXMzZswgVib726kNEBcrwAsInxcWjYgV/sRcgvyhLXMBYsnZtWsXffvtt+KbpcbBeRZb8RMAbCCg4Pthx89H9Rtp/rfffrtYrMaOHUvMsdLSpUvl7/nnnyfmNoUYBkzIYgfEChY+3FvWB4q/GY4xB2TR+tAh4AnQs2dP/wcC+/BdgzUPeFLrwPGKBBWKA2Kdgf/ePPnkk7LN8jXhyw8nPXxpnn76aTmek5NDrPOQbfV1YxHDfz2IEUypkQBfOAUbNmxQm0Jc4HjIikP/11CdvPTSS4nFDNnFPJmtVqcS+htMXNRgcJoLBYo44QsOzif4j8UEy0vhdIgX6pRTTvGvVTU89thjCRwVAB8KgBoH26ybKzMOXtLgF5ktmmgeFlS/keaPvvFsgGCynw3dcsst1Lp1a+mbxT6CY2skAFc4cOBAYr2MEF2sMXjOVn2wXk4Og0iC+ClgnY8QH+yDGFVEqFAECDdf+Ui88sor4g3Llhq69tprxROX5Xv5KuNGwlMW/ikAfKUAbDkhsNGATz/9lEC8IgG+wqyclWb4WqovFTvZCQsNXx0zYUNDeOvedNNNwqHh3P/93/9FGiZl50G4ASCkeMFYMSsvBdbFylpiVwfLucFTXPkvsT6J3n//fWKztIgo8A9i3ZFcp8Q/Vk6L9zAO4kOBcfD34IMPipgKr3b1oVADhiKo6jx+7cwfovY111wjYhc4IdYHCTFivYu/K4iIiQJ8IAF4FvBhwi+4Y+XVjQ+EEuHMBM1MrBI1t4T3C8VWRQIo6fhrYTDi5A9WJn5x/Ps4jmNmb2jmQvznoagdNGiQeFJD8Yr2kczwrKvwX88Pi8FckX+fiZKg16yEhgkawC+Vvx2/dHIs0n/xKKFh2VHABNo/NrzHFTDRkOOwCgGYQxFzPfAAyx6sU7A8YR/KV+YU1aVlfoOtYEww/GPietZDGSzq+K+7+eab/eeZezKYU5J9fukMmNIBZiV0sJ+XlYLX7vzV/cGzAcsSEyT/cwTveaXo9k/WtKGU0MF+QKYm/k2rOQL/l1xyiX/twC9z6P79+++/3389XBWUlz+eTyi8zffP37CcbFQoK5jCOW4Sf8nEIoEHHX8gDIcffrj4dahj8NMB4AbCDI026sUAgeKvjuxHIkDoAy8GXijVNx6SkSNHGrBmANQDjvOKAOE4f6HlGrxwdh6kZBMgzBH+UjCJgxBg/nhB4FxoXgfaWQHreAysTeEFvzDjs2hWxr8GxAyWMWVVZI5HLJTswe7vOloChAvtzp9juuTjY/bnGjBggDhE+idgsREvAUKXsLLBZYO5cT+uQFzetHDRwPOo8AlrG5xIyytUSAJkvhnwRl2wYIHfhAyHszvuuEM8opWpWbVXXrZqP5ZfeBIvWbLEP14sfaTrNSDseJnDcT2h5g4TP4fDGCyihmoScBz+O5EcHQMusLFjd/54RljnY+DZSQXA8TGUR7qaD4toci/CuQeotun868LkmJpWOoBuiL1IA6wOlQ4JesEaAynGQKUlQCnGux5eY0BjgDFQoaxg+o5qDGgMlC8MaAJUvu6Xnq3GQIXCgCZAFep26sVoDJQvDGgCVL7ul56txkCFwoAmQBXqdurFaAyULwxoAlS+7peercZAhcKAJkAV6nbqxWgMlC8MaAJUvu6X47OtpH6otvCocWMLTXE1qhQECAmikKQsXlCJx+LpB/PAfOIFREIHR9lH2ydeMMyFQxSivbRMeydwg2h55P2JF4Dj4NxB0fbJcXmCGzsZEaLtW7c/hIFKQYAOLVdvaQxoDKQTBjQBSqe7oeeiMVDJMKAJUCW74Xq5GgPphAFNgNLpbui5aAxUMgxoAlTJbrhersZAOmHgUGmEdJqVnovGgAkDxVytZ+piogIuUtK9NSewr2M6qTfLNQY0ASrXt6/iT76IawTc/BrRbvYU8HLqvIOFRPddQNSrXcVfe2VYoRbBKsNdLsdrHP0B0dbdRAe4QAmID+C/XxLlxe/W5etM/59SDGgClFL068EjYWBDHlFJUJFbF1+0cF2kK/X58oABLYI5fJcmziH6aDJRPn+tu3C5sHtYXPAkmMzv53qKO7meXW2uAF3dV+rM4VWlrruavKZ9h+pFykQOMG5X5fImU6K6XCG6fg3+5b+soKe5kMW3cX8wt7SHqDPfixN6pG4demRrDATdMutGThxFrfFZs2ZJNVJVCBD9omyyubwx6rurKpAoeofa3qhQqaqYOjGXRPXxv1lEb0wiKvKVOKcF/JX+92c+nUWixoRy9qX/cW5dfhn35hPdehbRcV0TNVry+734OKInv+JaPqWlE0DM2zQkOo2LiW5nwrKDi9du2uGbVw0mvvWYEFVxcb14frIvfsZHlECIfuC6gj/OI/rXpclfgx4xNAaSQoBQaheVRlGS991336WLL76YTj/9dJnVa6+9JjW5UQMb0KNHDyFAs2fPluqlQ4YMoTFjxkj98KFDh0qbdP3vdSY+sNgoACFasoG/1hz61baxOurc76pcl+hDzD0+PZ6oMaOyYzPz0fK5vYcVzwfZ8jXyVKLvZ/t0QAMOI7qAi7UyjaGGtXzrArcJndAO/tvIItve/Rk08xcPV1IlAvFRgPvw+1Kifr6K3Oqw/k0hBhJOgBDwOHHiRCmxC04G9cJRwlgRoOXLl9Njjz1GLVu2DEDDM888Q1ykTtpfcMEFUp4X13DBv4B26bSDr7OZAGFueFHwEiUCfl7gsez21wXlnwCBqMxaRVQtm+hILot+Uk/LpcrBqvxINK/n+8OBTVuLafLiLPIG6Y5AjLbsDN2PPpN8DCScAHGpW+KKk7IyRChPnTqVQIgAiMJGFDUioLn0LnFJZKmzjkjkDRs2CDeEdqgxzhUgpa64WXzDOQVcLC9kxDuIIKKa0SYewPwRsR0K2jeqRos2ZrC4wFSnFKCfKTi4j6/zsUboA/MJ14+6Ntwv+ikpZornYiJkGo9cBhPBQu4/SHFi0RnmAeBCfHFHj0fCjcXwZQ4VFhYSF9qjHTt306zVmVTsddFhTYpo397oStdluYuoVb0MWrM1mxXYh+4FF5Gm6pn5jJvIXwT1rITKOsBlqtP6Y1gGuWl6IOEESK17z549xPWv5WEfO3asHF65cqUQhhkzZhBu6C233EJXXXUVHXHEEcS1sZl7OPTw1KpVS4hVKAKEDsOlTgBRUw+VmlO0v4qQBV8H/5TlWzKpe4t8/q0hBCaLy6B7mBhc1G8frdzsou1Mtzryy5Tt8ckE4eYa3H/wPujGhh0eqlm1WOoqBZBVJkYNaxTQrr2FVDUr/IurCJAQM37x44FQuImmT9wfrs5Ms1cZrHguoZ4t2fbOJrCCKKeGfs7qtYd+WtiQDQCGECH81qzqpfrV8/k5idyhGTd4doIhnTnx4Lmm837SCBDXA6fx48cLp3PdddfRV199RV26dKFx48ZRnTp1BEft27cnrgNOffr0kS+hGXF4CKpUqWI+FLDNdcSpYUPWTloAct6AoKESajwAbo3rlgd0AZFrzmoWs/hdH9Cd6MJBPr1PYbGLOjZlhWhWLdFPwGy8nPUTTWvup7pV9oaca0DnFju72Nq1aD30HQV0eDsX9TvMRXe+y+NkEsFidN3JsBrVpJUsanRqRtQscLoBPeIlA25wb8BhxgNWuIm2P3CFC9Ya5M2oLbisXzO2+4V8QPX4WfnsDqIPJzPxZ93QYc1d1KKBh9Zvr8f3kKhVg/Czw/MGzhy6Sa4VH76xPhszBhJOgMBWw/p19NFHC0czcOBAevHFF2nhwoUiioEzUgQIeqDc3FzZB+sLLkHdfDzgTZvyG51GAOe42aynKOAPZO92PlMwpgeTrxlgmenfmWjZJqIVGz2U7c6mmkxzod+wC1Bo43ooWWHt6dWmhE3PbibKRJ+M4l6YAIJhzGCJDEQRRApEDybow1r4jtsdK1K7p5e9Qp+uH0+Z7gx6sueD1Kfu4ZEusXV+3XYPbdlt0FGsaK5f09YlYRtBJ3fpoMAmsBYu3ejzqoY1TUNqMcC3KLGQmZlJL7/8Mk2fPl0GWrp0KaEue6tWrUQPcuutt4pYhq8xrGUgUGBvjzrqKOGYcBH0QyBSilAldsb2egcn8ucyfpC5+VGsJIUfSjgAYQAhOLxVMRMsF01ja8zareGuOHQOROe3RUS5u5irYRp8dEeiWtUOiVeZ3Hcmf0owBgC/PVoTdWtJtI0J0LQlPj8hORnnfxdMG05PLHmRVu1fS0v3rqShU6+kbzf9EGevrBzmta3a6qHmdYtFoRx3hyE6AFfYmgnPcibm4ksUop0+nBwMJKU2/Jw5c4QIga0FRzNs2DAaMGCArPDtt9+mSZMmEc5BFHj44YdFPFm7di2NGjWKPB6YU91iku/Ykd+8GMBpEQyWFPj4gBM5om1ZB7hwU4R4sGfvftpd0pjg5Vs7x0coslmEmjTX58sDQoU/+PUs3kAEYteITeud+eVBOwA4ROAmnFiKduDS5q/1xVK1bUTUjt0BlGpNiWDQr9kRwRbvWU7H/zIU3QZAw+z69EvfL8qIpwGNwuxgfX+tYI4wYz91aHiAGjSIIB+F6QungGPgBR+/ULB8M9HqXB8+gJNgUCIYRG7FhQe30fvxYyApBEhNc9++fVS9OruuBgGUhjgHAhQMu3btEjk8+Hg0+04SoF1FdWkFP7wgCN2Zw2DaGBXg5QDxaNy4sV83BBHu4yk+YgFTMUIPTuzB3E5zn26nCxMjePuawS4BwjVQWq9kHxh88Wuxqqd7K5/4V8IK37Xrc6lunZpUGwqkCPB73l901fSbaVfRbpb4fByYi92Rs91ZNLv/pJgIEAgkOMlqLEp2bLCbiosKk0KAsFTcR+CkDRPmDk0CF68JUCA+ErWXcB2QeeJWxAfnweFYER+cUw6K2E4lwNK1dHMm7S3iB5ZZ+A4OqKOUbujxL3xcjjnm6Rf25QEXdAzrjqIlcsF4AsfTnl8wjAfODc54jWoRvToRfjGN2HPbJc5+gw8PvjJwv2vNTkxuXH7ig7MZ7AbQpCq/wTEA9Frw9YHIeEQbdgdgTiiZAJwANyDOINIwGmhILgaSSoCSu7T4Rpu2mGjCLN/LcV5/X2xX7m439el0yOEtvhF8V+Ply91dNuCSpStRbsdLfMxzrMPM59E8/7mrOTzkA3WG30CGsUyMIA72ZX1WKKiZWYMe7Ho73TjnbsrxVGP9l5caZNWjnwZ+QQf35Ie6zPI4CDqsh+D4oENDHFd0PVh2G/VBiF9QTEMkw5wg5mpIHgY0AbLA9efTiN779dAJvCgIZDytR1FCFKQIqFy/3fcVVqMiDw4IgtMAhfU+ftOhSyoo8hEfjAFu5Ms/wxOgvMKdVGgU0YdHvUJbDubS7N0L6PJWF7LupiodjEA+wGG887NPzwWRE/qoE3sS9WlHlMPiVyoBIhg4IVgZAZoI+fCQjP81AQrCMhS/ZuKjToMj+ltfVs4kAP5xCvvvvMQvAffN76mIJA1qJi5mCaIevvrBgKhzcCTBUeVo5zW8NHX7dKqVWZMGNezP17upzubalFfAmnQb8OSXRNNXMKHj/gHQv0DtNJiJUDoALGMgQjDRsz2EFfcuWrS2DjWv76FrhvjuSTrMs6LNIUoVakVbftn1gDvIyS57HIShmHUliYCGrNB+71YWRVg8wtcXwZYvXJeIkXx99mGRB7FWZoAoCGX3ZDb3w4cIISRmmL1rAe0p2kvH1D9SiA/ONa7akHILtpmbWW4jlerUJYeIDxqBCM5f49N9WV6UgoNwTkQKlYc+Ifr8dzct2FCFo+g99LfHGV8FKZhQJRhSc0BBN7kecx4QT/YHPXB4ibIzQYYSAxBD7jg3MX0H9wpL2LPDfalOq2Z6qYTDN87t56KhR3N6FKYncA/AHyxvLZkzMLK206I9S6ln7a5UN4upZSk0zm5IC3YvIYhmVqQZoXdIl7Ge+8rgT11xEAMJsSw4eFf1napfuCyAOHpLY8iAGxDnDyYTXTM4VbOquONqAhR0byF+3Hch59V53UeI8GJBEfz01ZxYLOgFCrq0XO225K/9R/9n0JJV26lRverUuD5TJQZYhqCf2cS+TiBGM5aX0NKD66lh3ebUtUUXaTPud6Kf5jNRyahPrfq4aUvtXGpCTKkYkDYVzo/I1ZPHxAdECAS9FZ+GtckM0AU54fFs7jPebaT0wJzNACIJJ1ANzmNAEyALnEIf8PbNPv8U6AWQDgL6Co4GiQhvrf6IHl/6Ih0oPkBH1OlOn/Z7jb/+6YlmENuGNUtkbeaFgeCq9BaT1i2ikk37KWd/b5q80EXI+IgcRz7w0NwpnAcjfzcdV7spLWWCBR0aAFwWCBl0WXDYhKXr0qfZY5u5CXht4/jDl/japtP/uPfAC3RhCvAMVIT8Smo96fTLqNZghQFRkB5udSb0sddWvUcPL3qKCrw+BcvMHXPp0j9H0kf9Xg19URqf2XJwK202ltApXbpT6+yq9OdyM/HxTTw7vwN9/9dWatPLRa2ZewJnBeISrMiukkUSHIqwEpi7QeDwYqcbIOEZkp/BXwomAXBvVbNcdH7/dJtpxZiPJkAO3scHFz5JRWymVl7CMFnP2jmf5u1aRD1q85NdjqDIy7mbts+g+tn1qGutzjLzhkxYoKsyK6g93uq01zObOrauTl2asNIoAjRjwpPuAM5s8oISWrLuADWrX4VO68tUSENCMKAJkINozXJnsj8Na6tNgJxGBd4gjbbpfLpu/rVzrsx7SP2B/ilCj+MJ4lqyvDUop2oR5RWxIxOxnFVBoH9ngzrU28fhJVlpyalVEDRLPquKspaUr+OUJicwQlmBUgrghHYX7aHutcoX97MxfzOt2LeaetXpQTUy2EuyFKDLQZUPANKgwl2hHqcEuXFwA8otBAHSoDEQHQY0BxQdvsK2fqrnQ/RT7hTaU7yXqnmqsr+Mhz5m/U8VD7+p5QQKWfT6I28mNarSgDrXaF9m1oiXev0GXwwXFMrIc7T8QAP6bfcqNrMXp63CvcxC9IG0wIAmQA7ehmxPFr3W92masXM29a/blzYe3ELgJg6v3c3BUQK7Mthtt3DCt2RwDm1XixaUdfqZLDIEyUmBl4Tdm75jFuuxiumYekeGbIfcR+Yk8Y2rNBJP6a0F26lp1cYhr9MnNAaCMaAJUDBG4tzfxETn2PpHU+86PSn34DaamPsLrdy3htpVbx1nz2UvRz6f/SOu8cVVcJJ6mu6moi/HUc7LY8mVEf2tXXdgI63ev46OrtebcjLYjm4T4JyIlBxbeL2aANlEmm4mGIj+KU1TxCGnEHIHWQFeVKcqPyA1bCjYXrSDU6DuoB4ZXSSBfiZ5qHZJDfptwx9Uo0E1Tl2RIYnXMJ9w/YTq33wc1SMyfv6RMjhGy1VU6jnHODA8rHf68gvynnCSubnlNuYBQG6h3Qd204/bOfNkZi2qV1g76vnVcdei5dtXUmujmeVYdg6qiiHx4ga5fJDOF2leYgU8TwCVvym4HyRwi5QMLvgavV8WAxWGAOFhC04Yr5aLhGSoupGIpPRqDPyu2bWR6tSoTR0bt5e8OTh2XI3+9PWmibTFs11M8eqBDjVXXGMHQDSMnTvJKH1RQEogeLmYE6qCjIBByfOt+gQBUsnaZuyfQ9VyqtKQpseL/sqqfbhjTQ80oWXeVVS9dg2CNTAWQFJ65BCPFzd2MiJGmp9KSIZnRmdEjISt2M/H/omIfcwKe+X6/RupaZUmfuKDhSJ6vGONtrSQY6nyS4IiPGPEhLGX4xyWLeXoTnZ4RKCSGVj/427OUaURYG/RPrp6xi00aNa5dPgvJxKyHfatc0RMxAdDNeS8QCBoEDs1aAzYxYAmQHYxFaHd3uJ9Yv1qmcNmoiDoUaurKIbn7loYdCaKXeZ0vFs2U/HMGfz3FxksbrpPGkLuHK5DpnTOmeyzwpxP1mDOHxEGSowS6jDhaNFP7SrZQ7uL99Bzy8aKy0CYy8KeqplRg6p6qkieoLAN9UmNARMGKowIZlpTSjY3HNgknE+TKmWtQDDDd6vZmeZwAq/mrsaUwbqhYPDuyKPCjz4gLxMWT4+elH3GWdLEOJhP3o0byWDiY7B45eI6VZ6u3chVtRq5WdFc5bkXqegnTurPRMndth1lnXt+cNdl9j9b/w1VdVehfO8hjoy1R/TAwifoqwHvlGlv90DjKg1pi430HHb70+0qPgY0AXLoHq/P3yS+M6H0H11qdpAyNnP3LqTe2T0CRjW4RPWB/+OEQFAKg9NZuoSKp02l7IsuJoMJEyxarkaNydOsGbmq5fiuZR2QgoPHHs3hEPlUo3FLyg5jgodT5Kb8XJrLhLCE06mqkBHVD7i4eAC5oWFFg6gJbkiDxkAkDGgCFAlDNs7DeW/rwe1ieg/V3MNOib04On7Shl+ZC9pOjfmfgoNjnvflgGAC5LNLMS3amkslixZQ5rGDmPg0CmlW/27zJPrnnPtp0IZqtGXFXhpe42E6o+lg6Xo/R+RLQCmnT8UvCAOSynes3o4Q6wXAPqAKF0s8q+kpsh3rf8gPBMjlsVrntIy1G31dJcKAJkAO3Gw4G4J0tKhWVv9j7r4Nv5R1M2vT/H2LqCcdck70sjVLuB9urNQ5CEByN2xEbuZ6QsHivctFkYzzeczRZHHemmv+upWe4mql1TNzJIMhzkER3qpac4LDYGP2cM5kKxU8na+acTPV9NSQ5PIDG/ajWzqOQPOYAb5D1TNyaLMmQDHjsLJdqAmQA3cc4ldt9p/ByxcJDq/ZjSbs+1FirdpXbyPNPR06UvHmTWSwb4+fALE52t2yVdjuPtrwpf/8lqqFlClZ/Awav/l7uqn9cOrBMWiNshtI0nh/w9KNU5ucSLNOmkST10yjFnWa0TFNjgpuEtN+EyZym5nj0qAxYAcD2gpmB0th2iBZ+6b8LdS8GifDsQGoIto0uzHBIobYKUD2sEs4DygTH9TigQ6HdT6Zp51Bnvbho8tRkwsA7qvAbVCj/EwJhu1cvb3kbgbHhYoVoQA6m4F1+tERtbqHahL1cXBY+4r3E8Q/DRoDkTCgCVAkDEU4j6Ts0Kc0rxpe/DJ30z2ns+hjFu1dJoddXK465813KePY4yhjwLFU5bZRlH3hMPMlltsI9/BwdQpAlRI31S/IFGI0vO2llu2TcbARW8IAmgtKBrbL/xiaAMV5D2F+h8WnASfusgtIcdGpRjtauPuQc6KLPbk9HTtR5omDKeOwrmG7KuZg0ak7pkuJ5CcPf0gUyZ7MbKqXUYu+PfrtiLqosJ3HeRK4gDgKpbcGjYFIGNA6oEgYinAe+p9mVe2JX+aukCNo5b61NIfL3fSr18dnBYOfT5Xw5muINr9smypWt2Pq9aVOdTvQuc1Op6K8reSev4iqVO9iHiYl2xDD1h7YkJKx9aDlCwOaA4rjfu0s3C26jmjELzUcnBO7c6rTlfvXCCcDh0OBMARoG6e7gNn9YEkBndTgOLZs+UIu4HtUrWpNzsXDOiEmYqkGWNtg8offkQaNgXAY0AQoHHYinNvA3A/8e5qU6j0iNC9zukvNjhJ7NXPnPK5n4/NKdlWxVhqDUE3M/VUsbac2PlHM+QEdZvoCQA3Eh6UYYOJHTiKk59CgMRAOA5oAhcNOhHPQ/4D4xFp2B+WNe9XuLla0DbvXyWhQSJsBAZ4zOT/zNE4QD1+ekxtztLqFZcuVxTlSAWy+TzWAI6uXVYcJkDbHp/pepPv4mgDFeIcgYmwv3BGV9ctqKHgM18+uS7N3zSchPqYcNvCw/mnbb1yVdJkQqgH1j/KXRS7TF6xhMOOngQiGuTVir2gdGV/mLukDQRjQBCgIIXZ3IX4BYlFAB4/Ru3ZP2nEwjz7c/TO9uOINmrFjtngxT9jyI20ryKPjGwzwl8YJvta8Dy7ISAMOCHNqwnXjUR8tr4C9vDVoDITAQNKsYFu3bqVZs2ZRp06dqE0bnwewmtPSpUtp7dq11KtXL6pfv746TNu3b6eZM2dS69at5Tr/iTTYgPhVP6uupTgU7fRgwv9h5QTa7N5DyxcfJNQTO63JSRybdTKd2vgECaWw1SfEsDThgBpwfiCImLkFW6ledh1b09eNKh8GksIBffPNN3T77bfTBk6cfu+999K3337rx/TTTz9NTzzxBM2ePZuuueYaWrdunZzD/lVXXUXLli2jUaNG0bhx4/zXpHoDHsyId2oeIfbL7jzvmPcwVd9bQLtdBUJ8cN2kLb9ycrPG9okPLmJFdDoooTEV6MVAoDfna38g4EODNQYSToCgRJ04cSI9+OCDNHz4cLrlllvo448/ltmsWbOGpkyZQq+++irdcccdNGzYMHr//ffl3DPPPEOPPPII3XjjjXL+jTfekHSd1stI7lEQHyT1isX8bjXTv/JmU5VCDqjwB4IxLWFF7iLOohgNuDghWTooodWcEeqBShkIV9GgMWCFgYSLYDDHPvfcczI2ko5PnTpVRCocWLVqFfXo0cOfPBwiGLgj5OMFt4RzgEacjgJJwDdu3FhGfJMG/B+SiG/bZm32BRFEDuUDnHcnHsAYubm5NH/vAiouLKLCnQcplw4l9bLTN+aCP/SjoHFxDfZm3kElLl8yDqTIgK9PZr4noJ1qj1/0ATCX4HHv20fu7XlUbOpbGoX4T/WxZ88eSb4eopmtwwo35saeQl7V7h20xL2M6mVGFsNUIngzbsz92d3GuuK91wo3OzlTgRnHag7IFY1nUkN8GEg4AVLTw0N+ySWXSHWKsWPHyuHNmzdTrVq1VBOqWbMm5eXlEfRFOTk5ATce7VAtIVh/5L+YN5B43gpAfDI4wDNLmaqtGtk4dpB9dVAJIW/PLmpTo2XI8cJ1haTrIMTmud7X+np6efHtlJ9hSFhFpitTciyf1Tx0fh70gUT8Hli+FORUJ5d7G2WGwINqpn7Vi5rJohv+4gGFG3MfzTg/dtX8qixa7rXFLaKSBap9mHFj7s/uNnCM+x1vVQxUUsEzg76CwepYcBu9HxkDZTEb+ZqYWoC4jB8/niZPnkzXXXcdffXVV/Ly4IFTAM4HDx9eKvNxnMe5cGVQ8LBhDCvA1xCVDeKtioE5FGSzp3GWizrV70A12fs4WkDFBvRjnmv1/S3ooa530J6cCbSlKI9OaDiAbuv0j9Amdx4URBV4MuPEy97UJVs2UQYTSb9fUJgJKgIEnMf7NQ9ekxq21cEWtJf2B6xXnQv+VVUxzLgJbmNn36mqGCBA+BDqqhh2sB5bm4TrgPA1+uOPP2R2YGUHDhxItTmv8cKFC6lBgwYB9afA4TRp0oTq1asnLxi+iApwrmlT+xHn6jqnf2F+Vwm9nOrbwINerRa92e8FmnDch3R75+vDEp9Q44oOCCeLUx+OoeYIczxcCaAz06AxEIyBhBMgsPYvv/wyTZ8+XcaGyR1iVqtWrahv3760YMECWr9+vXAFX3/9NR155JHC8h511FHCMeEicE116tSRv+AFJHt/w4HNUv0TJmbHAGEY2eGDUG2NVSpGpYsvEOaM9BxQQkMZnQoALoyCg5LsLRXj6zHDYyDhIhi4Hli+QIRg7QI7C4sYuB/AiBEjxDqGYnQgShdffLEcHzlypN/8DvFq9OjRcjyV/+0vOSCBo904iNRJwAviqho/AfKLXQn0BULWxoJ336Li6X+y5t+grEsvo6wBx4VEB0IyEJoBczyyJSYTimZMp4I3WN8IMZ+56WqPP0VuNmhoSB8MJJwAYamHH364EKB9bKWpXr16wOrPOOMMOvnkk6WUrvkciBHM9Si3DJEtHWAj130HQXXC+zlgPcwBuWo5sEalSOavfqLgwJ23kwFrY6lpvfCtN1jk4xecSwmFApTrQaL6ZIJ33VoqeuHZgCEPjL7bR4RMho+ABnon6RhwUI6IPHczgTG3hpgW6ly6EB/Md1PBFkJK1VCld8xrsr3NL7LBX2cjKAjV9vXmhkwcXYxL1A9LBJSsXk3G9kPER8bgsQo/9fl1hRoTYlhe0U5CbFuyoGT8oXzZ/jHZjUI4N/+ByrcBQxAkEEQlpAMklQClw4JjnQNenm2FedQiitSrtsY66FO0u22aziP1aYALShABokKeq9U8VS6jEJNDxgBY3JIZnApRUQE8psRrCr5TJb483OpcZfuF9fmBBx6QEKd0WLsmQDbvwqbS0jtOhV+oYWE6FwiTiEy1tfObSG9oN8fkKUub/6Vm/Vy40kGYM8oCIVUr4sKSBZ5BJwQMJU7mTJgzjjwq4Hhl20E0wrvvvkuDBg1Ki6VrAmTzNqxn6xfqnyOfs6OQX5qIzAkrGE9MFNEJ4oBcPMeq94z2cRPZHPbBYqOLg4er3PzPiChBeo5kxoV5eh5OWRdcJPOSNCfMuVW99wFy17WfuzviohLU4IUXXqBrr72WZsyYQRdeeKFswyMbXCSMOeeccw6dd955NGbMGIkAME/j119/FYffoUOH0kcffURffPGFXK+s0IitRJstW7b4L8P2k08+Kf1edNFFBEdh5ZWORm+++ab0sWTJEkLsJvS2V155Jc2fP9/fR8wbvKgKD+xxbbAndszrZDOy8dG6ccbPa6bE3Ie6EPPAfBQUr1ppFP42We3a/mWFPrsP5ZdpX7x0iVH05x9ljlsd4IfM2LRpk8FOjVanQx4r2Zpr5L//jlE0a6ZR9Nd0o/CPaUbetm0h2+PE8r2rjHfWfGJwHqWQ7djgYLAXfMjzdk8Ax+x/ZpTs2GEUTPjWKJo3xyiY+D8D87YL7GkuuGEPb7uXONaOX3BhMBs3biy/7P/GEmWJcfnll8s+60sNzhoh20yg/ONOmDDBYIuxHG/RooXBBhOjZcuWss8xltLu6quvln22SMs+7n+HDh3kGDukyjVMTIxTTz3VwPMBuOKKK+Q8Z7KQcZs1ayb7HJ1gsPOotIn1v0rBAcF8jgRisQJ0F9ABITrdcYAFzCHxC3OTnEAJTssKS6CnaTPK6NqVPJ26iInbxVancKBM8Mm0hhm7OI6Lw1MyunG8IVtSmbqFm2LanYNTLtLUfP/996Kzeeedd8QZF35ziJXs3bu3WIoVd3PfffcJ54JfXDd37lxpF25hN998My1fvlzcXxBrCb+8du3aERMz4XzM18J1hj+etGLFCmICR/BcxxjxQIUmQLs4afzpUy6h42edRz0mH0//Wcw12GMA5P5BEvn6mXVjuDr8JYYQIOsYtvBXhjiLiHiIYFC4JghgtQMYGZnkYrcKVHB1obLrnt0hR/SXbU5ieg5j5w5y12H3BlgHucy1N287GRwGYweQcqWQE6ohqVqqAOlomIOhbt260Z9/st8VQ8OGDem1116j559/3h9H+fvvv4t4pkSiyy67TNxFunfvTn36cMWVEMBcC/30009y9rbbbhNH38MOO0yyUuDgpEmTAq48//zzxUkY4T+dO/t84UCE4oEKS4DwAHX+3zE0ixO+I8EX4KWVb9Gbqz+MGl+xlt6xM5BUw3DCBK8GK/UFSpQpHsOAAIHTQi0zAAiQUS2HSlhHoPyD5ETQf/AHWsWliPBhSDiwtcvguDuqXUeGcjMBYvaA3Qgie2Qv2bOCBk0eSoNmn0cdf+hHU7f7vPgTPuegAUBsFKiwJOhrPv/8c/lDjOPRRx8tAbOInVTB1ubYtXAxfojfQ0whgMUqNZR/GwHkZjC7yqjgZRCxeMA2AQIFRngEQiJAAc1/iHJPN/hjx0xWGleXSqGcAEMUpwe9BfTKyneimipKy6DUsFO5fwIGx81jp0GXlWk7oKH9Hb83dAKdESXnUNah5PkgREb7DmTkHyD4ClkBPgjPL3+N7pr/CPX4fhD1mngSFZQkjrswdjGRY/y66/i4VuDYxSk0vFtzrabnP7a9YAcN+uUcWnNgPeV7fWL7Rb+PoHm7FvnbJGtDERSMN2TIEBm2NVsiwfHg79///jc99thjdOmllwpncvzxx0sbJAAEQFz67bffZNvqPxARiHEAhEEpUNf37BnoXArR22mwTYBAZCBrwjMZ1Nj8h9QQ6QYl3hIumeNz9EZ+HX4a5W9n0W5J9GW3dvl6Fr8Q99WUk2s5DRC/8JI4qQOirNK0Ggm8JyKCBac24ahxD3NC3vXrfJxHELIgCk/Z9gfhI1BgFErp5qtm3BzUynp3T9FeenbZWHp08XM0Pc+mA93uXZIh0sXzUgAxDGJZOD+p99d+Rpmlz43vs8XNuRLtq6veVd0k7decTgTiFMQxBHZDNIPV6vTTTydYu5QYdPbZZ8vcbrjhBjGzs3I5MF2Lxcz/8Q/OusAfkOuvv55YyU0DBgyQnFxIjYwQqkSDrVAMsGIrV66k/v37iw8BlFHmPDTm7URP2G7/fese4SvUZ7qgijubBjbox2LZfC51M09ShrbOaUGtcppzfa5qppasV+Wv86xd8yRB/GFcvyuj9KEMaBTnjhAg9OGQCV6m4xfBmLOKc34hL2eHRFfNWmVOu1u1Ji+HaRQvWUQZvfv6RTTgciFnd0RJaQUsDNGfeX/JvWjBqW2reaqKHkOdV78gPn1+GOLXxzy7/FV6vMdourz1BaqJ5a/BZmtPKfejGrhZpPGuXEFe9uZ2N2mqDgf8FjGnVsL/FPFRJ6EPSjVAGY1YybffflumggR+//rXv6h58+ayzxYuScqHmEsoipEGedGiRfTJJ58EpG0xr0NJLw899JC82+ByINZBz6TiNc3tnd52wXxmp1PIiKC8SJNaXmDbwe3UfeIgquauSnjgL251Lv27+91i0Vqfv5HW7FsvX2I8bPU5MbwQI669hWyEQ369gGA9O1CcL1/tZadOo5K9xYSg2XgAuWogd7OJlbxbNrPeZDFlcDCnyyLpVbhxrPIBqfZFv/xEbhaJPM1bqEOWv7j10Ckg2Vs4XUHwxcVTp5CrWXPytG7jP4V0KcCNsXcPFc+aSR4mRu7S87BAdvvfcYJP38Pm+x+cxt1dbqEamT7fKiQ1y/RmUKM6jSiHCVK1jGp006x7aPX+tXL/FEHN4Y/Fj4M+4/vV0j++eWMvzyVz9kzKOqxrGUJTPJs5KO4o4/Be5kv82wt2L6ETfz1P9n2cs+/UuGPe8pXQ9rdM3QaeIaS5QdoaMyCdMRKlIctE27Zt5dTgwYNFmQwVCjJNhANkFIX+KN58TOHGCD5niwPCRXBA+uc//ymsHYJLzYouyJLmxFjBg6Rqv0GV+rThjDk0e908qlu9DrWr73thEMvVLqe1/MHKsf4AE6P962nmjrnC8dw+90GesnrcWY/A/y7983p6+7BnHV2KcED8wERLfCJOAlxQgkQwdg6RWDN3CMW5q0ZNcjPhK1m7hp0UuUIqW8ngBT2k8SD6cuN3pVPHq+3iVB0N6MrWF9GBknz5y92VS3sK9lJWRhUpeY26a1sLtjHx8cp16kuJ+7ds76qQBIhlEmnvKlVAm/EFLqhk+TKfIj1oDXgW1rLuZ2S7K2nMyreodkZNEb8e6Hp72hAfrCVUYr2ff/6ZXn/9deGI2HdH0tz8+OOPYjmDdSsSJIPjCZ6DbQKEahb4WoKiBsPf/vY3YfOCj6fDPqoztKjSlHKyD+kCzPPKdmdR++pt5A+cz5+svIaoBl2FAnBI81kJCb1RXf7nFCARWahSzPGMIYroRCmhS03wbHIJOUVPm7ZksMkbolgmi2Iwgz9/xL9pxb7VtJiLLFZhgtS/Xh8a2+dpyvZk+Usb1SqqToWZhdSACZeCl1a8RfN2ByqAd7AeDwnvQwL8f7jEtZVy38UEiFYs54j+reQycYggPj9s+UUI4Y0drqWb2l5LSzYvozYNWlHjGmHGCjmJ5J94/PHHJRc24r0gmiklM5gHswUr+TMLPaJtAoRUGmatvLnLUMfNbRK9DXEinDIcZkqwreHAzV/l9lXa8P/YcjHZOQQgSC4uWxGpj0NXWG+pVLPox7t/H1czzSBvhHlZ9YR+sGar+Xj5hefk21QSoV8lfcMca9WP1bgGz9nL7TGGy9Q/XPfNfRht25F37hwqYZ0LzPSAb/u9LxZFJCirmVmDA0PZCGiyhFmt6enuD9NJv51fej98ObMPr9WVth/Io/wq+WxoMOXELp2wlxXNxfXqB8yv9JT8eJkrK9m0kcQ0z0fw4flp+xQmPgfpRC4CWZ2qiR6oddUWVN2VE7Au1Q/0numm+4QI/MEHH8gUIaZBrE63OSr8qV/bBIhdttU1afmLl0n5SgRPEOfwcIc6b25fkx+/cxufRl9s+dbPBWUzRzSs6TmcCjrTVh/m/oK31Usmc9nLBAhyvOIqghuH2QfRgMJQEZHApkyADrB/R4R+1bXoyw5uZAz+EHH6Sp9R0dQ/CFBAH1CsN2BuY9VKYqUCR9H7lPyZ5HvkAtqWTj4AN6XHWmU2oz+O+Y4eWf407S3eR6c3OokOr9mNZuyeQzvyd9Kx9Y6mqm5TMjdO7uZl/5iiljnkNc0vAD8QzZYvI2LjSgFP5+cd09hTPp8G1TuGqnmryjqwHgA+agpP5j6ggkjnlzuUmGZeQzps2yZA6TDZcHOAKTEU0qGwBZcW6nxwv0/1eYiqzq9KX2z4VvQXw9teQiPbXyX5q+32Edyn2seXCQ81+ilyc0gDf7XcvB0thFNCl7BS2bsjjzIj9IsXC/1Af2dXCV3C5m0vt8+EMh6cVimoNal9/Bpdu1EJSiFx6EBGr94B7c3t1LbiooJxzCHA9Fq9p1Uz+W1SuzH9um0aTd77B1s2+xOqywK8+1jJz3q17CZNKctkgpeT6j/2CSrauIEK9+6g37PXkJFp0BnNT6a6Wew1XQogynD0A17M+k51Xv86gwHbfkDQqkPrbvUH819Fg391v4sWn/obzRoySYiP0+tTPkCOmuDVJBOohGZ5hCS63ER81LDBvy6IKZ27iGXMu2F98Om49kFwUL4a5vuJub/Qyn1rpD+D/dSIvbL9DplWozCBKqhTnX5Y/4NwPoNZQW4mPlaX6GOJwYBtDghmVuXwZJ4KOAvFrpqP6+0IGGBRAeBELujgkeTl4y84LFYqXCK4Tcz7SEoWRgEd3K+Lg0DdHLhasnoVuaCXcbCYH4jPyY2Pp2nb/6JpeTMITqY9du7h8ItDnEzwfLAvOp+MVZRfsIdOrtGX6mSW9Wmyuk4fcx4DtgkQHJuULAyCA/YUjlHQtsOJSUN0GDBUHiC21jgN6uvvQnkeU8iEE+NIHFiQ+TpSv24opGEVmzeHKS4z3fz8ZHC+HieIEZTQxzY4iuruqUWzcmeycnoH9W12Kpm0QgHTgzHhh62/0sFqmXRiVg+qvYsJanh6FXC93nEWA7ZFMLhmw08AfyiV3KZNG/r73/8ugWvlyTnRWfTF3huCUMX/h8UBpwFR6oCElOcpYEtilEQN63Q1aUIH33yNDnKVioK336D9/7iWvLlbHFt615qdaWBGF8oz9tEPBXMIMXzBIMQnl4kPW7sGNzmB6jVgz+0IsWHBfeh9ZzFg++k3m7jBCWEfNb7AGZljVpydXgXuDRYaVuYmAhQHBAJ0SE3szEhSQigKEQyjQhQ8eP99ZeaS//h/qNpj/3XMEbPp/gw6pXZ/+sGTR9/n/kwNqtanBxc+QXmFO1nHU4duZv8ePKuDG3FxTBa7jIZFVMwEyGDFtat69IYAZzBauXuxTYDA+VjpgIC+cDlHKjd6Q6/el4YjsQSIvxKhJxDLGSYkqLHlipIDgk8S9EaKIMK/CoSRUzGyw2IeuRyq1QUFdO2mzWlw/e40Me8Xumz69TISxtrNMWV3L/g3TT7+KyE+fIh1UmzJY0W5NzeXPJoAASVJB9siGHwe8PUw/yEIbtiwYZIWIOkzL+cDQgfkaBS8GR8Q6+AjZHIUNJ+OdRvcD8BV5VAqDlt9lYqZihsT4oMLOX2HE3ogdMU5d8U/Cek34K/1Ta5KpgU/dkPCOaC7/G6zOs4XsT7Kzb5KWgwDBlMDtjkglFPW4CAGEFGeAAW0f4aJMMUrghalCAazfdbfLqTCTz4KiFHLPO0MydHjn3McG/B+BkFxoeggc1b7OYeTz5vd58+ObaTVQHCxGSQ0g4OCObmx71rzSb2dcAzY5oAwE7P36po1ayQtAJIeaYgOAxLCAHEmWk4iimGkfI7TIhgU0AyojhEtZA05hbKvv4nc7E/matqUMo8dSNnn/S3abkK2h/jlqs3Eh7l0wNCmp0kQMQgP/gGQDuTERsfJtvoPHBNwpbkghZHk/tomQAjnR1IkmN9RVwiJq6/k0hw9evSQXEHJnXY5H600RCCRHBAU0U6LYF6IYHBABHcVA2Qe0Yuq3f8w5TzwCHk4WZaX80g7AkzMDfbQVtkP0efFLc6ls5qdLN3DzwfllMb2eYq61eocOCSvB1wQglPZzyTwnN5LOAZsEyAkukZSMmTkR9Qt5OnTTjtNFNPY1xAFBlSMUpT+NFGMwOEFTCSUyBTNheHaor8oxS/L7njdbjZqlHA4hBMvveh/wFEGOSC+3PsJ+mng5zSm92P06/Ff0plNh1hOByk6QKzFi9qyRXoeLOHskyUca2c30b7dVWznvNlIahbK6GS3HzvtbOmAEAmP0h0o98G1g6R0BxKUIXfsSSed5EyBMjuzrSBtXPAmZlFBmcsTsSzhgIKSisc7ji8ZfZQK6BCDupu1YLFnpqTtQN6geED0P5xVwM25iILhsFqd6DDqFHw4YN9Vq7aIlRDDPJzzPN0BBCf/8UdJwlvAtSFm7fkx5LbIUhnLWpAN8amnnhJpJ9FpWW1xQMoHCHWKkOAIcOKJJ0o0Njih2kFfnlgWXZmucTEHZJWrxkkcCAFyuj4YFOcOcW1QFiNJfAlz1PGC1P/CM2gjPi3UWC7myLwshsFnKd3hwN2jyMs5jaBsB/EB5P/rYeLqhY5M/Y033pCc06jCmmiwxQGhEgaCUF955RV26fBZEZAQG1n5p0yZQo8++mii51mx+ocIlsM+KIkEeEPjgcQLVaqYjXs4iGBc6M8pkMyJixfF5wjIa4QI5mnXPq5puRtxitwN6yVpPWLWUg3gNovnzrachhcFFoP0VQbHahZO/B+5+T0NBk+HTqwfs8fZ4X1GWleoXBDhgLphJ5xwQnCXju3b4oAwGogMxDDUlkZKVmTjnzlzpuQ2xrYG+xiACJYMDggzclQR7ZQOqBRV8MGBTsnLVT5jBS9nP8TL6GJrVuxJxEQAADB6SURBVDwAbgz3BE6J6QDIJACiYfXnYv0e7HoBf0UFlm1xPdrbBXA/SOcKgJHppZdesntpTO3CckBz5syhVq1aSS2wa6+9VogOrGEDBw6UdI/XXXedZM8HhxQJdnKVAhCsrlzOF6KcgnXr1pE52Rk4LZQTAUAZhmtat25NXJdaXVLuf2GGT5gTosKOUhbDFO9AyAfYe+geQuWCVsNG9QvHVo6U93IZYTdbVWMCpN/ACxkq908UnUr1VOaChGuM4rqENGUuBJyLFWSecRYVff3VIZ8qWPI4/1Hm0f2tmts+hlxVn376KaFUD3RA8P1DelekYkYRhUSA5wGGUB2jPAesXhC3QHTg84MAVJWCFaZ4KKUjARaBOkaovvDhhx9K/Bj6BuA4iqetWbOGlixZwsn2isW0P3v2bKlLBP0SRD8kzerSpUukoSzPq3Sy8SaWgvhpZ72Wkyg9WMgpTYt5rVVbsz9MHC8N9HLwSge7bAlcF83LViZJDB8mBQZwA9yqSpeWfeEgV6xAfx4OdbDi3mLFjZtFOi/0QLyWQn6WkBUxJwq8lKzkWERWvgo3VTp5pIYFXqLNWAi9GcQw1JM3eC5wOcH9DonjkMhK7ImMzpxjidfoRbZJ1sll9OtPVf95e9ypV9577z2xdPfr14+ZSkPySKNSBvBw3HGB/lNOrTDE0+vrHoNPnTpVqCI4EaQANVdQVJNoyo5lqsKiOqZ+8UDBb+iJJ56gNm3aEOoQXXDBBcLmgXOCWIfqjii6ZoZnnnlGZFBUZ0T74cOHCyFUxM/ctlxtH2T9D0Mi8gCZ8eC3sDmliIb4BVCclW8v/v/BvbAZ3Ms5momtUdGAmM6ZoLub+epiRXOtVVt8EPBnIEIeGR/TGLLPv4Dw5ySgogasXkoEQ9+QgFA3/q677oqaoNuZW1gChFLMKPUBAgD49ddf5S+443BVMfAVQiE19VVD7Sd8dUGYQFmR6AyEbvLkyTRo0CApKQIuaAPrBeDkCED6D6TG3LhxoxCx4PGxryL0rc7hGMYzJ00P1S7ccVj84u6D458AhQgbUC91uEFDnAOOsOZw8ynh+SI/cqhxcD0AfYXrB20QMY5k9AZ/hLgxDgVAPLgxuGIpuCuxQnG+5khzUQPDeVAS5FdnwmGaE+41OES1PtXezq9Rtx4Z69aS0bqNNEc/ViWJ8VxHy2HZGT9VbSB9zJ07l84999yAKaDaKkSyb7/9ls4666yAc07shCVAYMnAnUA8+u6776S+UHC9aEziiCOOCDsXRXzwkD777LN0yimnEPILzZ8/X8I7ZsyYIawuqC+KH6I/XGO+8RDfQKzARVkB+g4XrwYRQVnwrK63eyzcGHb6cHPMkYfFjR0sbycaMtiSgkql3tKE8KHGQ15o/IUDN1te3EzMisP4FsWDmwzGCbE+sIR9eez242HdkauomIr3M1HHnwlivtduD2XyGpHBkdg/CXoRK0DxPvVcW50vb8c6d+5s+QxA4oAuNlEQlgBBtALBAKAsM+TA//znPzHNBXFkyJyIr9I999wjfUCnM27cOFFy40D79u0JWnik98BXzAz4Socrfgh9CIiaFeCBhixvN/G6VR84Bs9QEMJ44MCWTVTIcnuoudrtGy8Y1hxOr1XCYoQrpxq5Q+AF9wK4Qc2ocLjFnIw9u8nL3IEnRF/x4sbochgd4IqqiJCv3SJQHA+FE+9q1oGw6B68PhBT4CVW3Q04MS9bKlm9LVVCrcR+4F5D/BgIS4DM3U+bNk12582bR1AQ4wsARbLZomVub96GqHXHHXdI9kTUq1as6y62YKDuvLKiQQ+Uy2ZQ7OMhAtFSLxi4HxDEUABuKZwiFQ9MuPOh+jUfd6SPQrZK8csR71wgpgCP4foRZbHXoIwQZlglokTqBzgoLmELWDVWyIboK27cNG7Cdb6qkpstLpltI1vEkNS/GDhgB0J30JywHhCfcLgx39fg7RK20hazbpIaFsfVT3C/er8sBmyTcehukPsHItiVV14psiKsYC+88ELZXoOO3H///WJGv/POO/3EB03w1bz11ltFNMLLgNAOWNvwxYH+afz48dIT9EMgSopQBXVfvnYR0BlDNHksixRFtFNKaI6EjyUK3va8+QOCKHkXlxMi5j4iAbyfAVbllyNdG+m8i8Wwom/GU/UH76OiG/9BJRvYSqchIRiwzQEhDuyjjz6SL8KAAQNEcbxw4UK66aabxDyO0AwrWLx4Mf3xxx/y98knn/ibgHBByQyl14gRI0QRCq7q4YcfljYjR46kUaNGiYiGr+vo0aP915brDebqjGRl32NvaMccEUEUWFRLJEAZjUKGJWyA8LRtF3Yog/3KxGrlsFXOYBEQoQ4AVrcL5I++h6o98h/2WQrNgZc21T9RYsA2AYKJDhwI8kCrIvZQTMNHaOzYsRIbZjU29Dxw7w4FMPnB7RuWMRAgBTD/ffzxxwQxraLEmhngRqDbYhEsKYCXE46IDgAImd+070B/ll2w2GQgQyGn6fDAChVGz4IAVLPvj2V/MRws+mGilMs2WOQECBGCBXX8l1Tl7yNj6FFfEg4DtkQw6GngyYz0G4r4oFPsN2QfjtWrV4cbI+I5cDhm4mO+oKIQH1lTaSkeI5kiGFsHheiZkRrltqR74Jcw4d7bPC8v64JANL2sCwoFBspOgyDGGX5h1b9wjOzECcKjOCC0U+lora7Rx2LHgC0CBOKAyqjwBdhsyoAID+etbJ6NZIaPfXoV60r1EBsOiw0hsVSqnBXOK2QjGyeUTiYZ82ZrJQhLycb1IScG8QuR7yh66DRICelS/yhz35kDjjPv6m2HMGCLAGEsOCNCHEIieuiA4DdwzjnniCn4vPPOc2g6FbwbVuSLWJGMF5lRKWlZ+TduPZA/FWtyREdPixaSakIIjcUjAfELZXSkrprF+XgOQfeUPfw66cKLEBYOU8ni1LEZvfvE062+NgQGbOuAkHoDpnBkSkN4BgCmTuQMGTx4cIju9WEzBqQUT7QlbcwdRLmtdDauOPVASA0BiLocT5TzVc1d7G/EjlvsHb3eMkEYMhciiDVRkHksczuHHUY7OfNDTXYNyWrmTKhHouZbnvu1zQHBzwZBoRDBYM365ZdfxIx+zTXXlOf1J3fuiANzIDLd9qSVCMb6krgAIhiHjvAXJ65uornY05wzJrIHrhBt04UGPJPZKdWc/9l02rFNZEksYUV4vNkaHZtQBe3INgHC+uEYiLB8xH7BSoXQfbNOqILiyLFl+YoRJkeMkUl7PCLyxSuCiQUsWZa7Umy7oYzmNKvBuYIMc/kdx+6M7ihVGLBNgHRVDAduEUSZJL/IiF53MccQD4gIls0m/WQCE08P+914YfQwheV44f9Ti901wpjokzlNPVZ8GLBNgHRVjPgQbbAeRszZyRTBeMpQRMfLAcEz2alc0NFg0cWFD4j9cbxcOFCAXQpQficR5vdo5qXbOocBW0I9nAR1VYw4kQ4LGCDZHBDrgeInQKxDsqg44VtQ4v5H3TQXB78iFAI5f7wcEItshXbzGyduZunR86p9a6Xaa4fqbcgNHV2cgAyo06dPl14QT9e6dWsJiUKwcqLAFgHSVTHiR7/yAZI4sDhFomhmA0uYwR+QeAAimKOpWKOYDMr3lHBydm8eK6SRCoT1Qq4UEMMoppzwpkXeIrpi+o00Y8ccHsugvVyGeskpU6l2VnyZGiZMmEBvvvmmRDUg2Pmdd96RkCtkLK2boARttggQQjB0VYz4nisD1UTYkigZBZNIgDBePBwQREfJkcz9pALA7SDq/eBLHPSMFCRdunJZ58rtFHjalItpyZ4VzP0cCrMZOvUqmjToU/K42PAQByAI3JyIftCgQRIkfvnll8fRa+hLbREgXI6qGEgYhtQaqirGRRddpKtihMZt4BkWwSSaHEQomQBTfPGhBzXqoZUJP4n+S+Y5okpF4YfvS70uYA5WMWRmqDJ8hLlZhdvOLzlIP22dYrmuBbuXEOe6DDi39sB6en31B9SsauOA49jpW/cIaphdv8zxSAeQrQKRDqpIRKT2sZy3LTiiKsZazkCHlBkILkWuFVTFQFZDJBLTEB4DIoJVSaIJvnQ64g0N5W2MXJcSHZVTY/hVOn82/z+P+Dgw7hoJZPFXPONPX8ZC54dLmx6h06mTWdvyL9tdlhst8BZS3UxOWWNxTYbLNp9BX375pYRdITcXUiEj5xeS1CcK7M+MZ4Asfoh+VzBkyBC1qX8jYYADUVF7KtmgCId4Q8fiSFjKAblSQDyBK4NTrgIC+EZWkJa3Ou6yiCj+A5HpX7+v5RXXtbuCXln5Nh30slsHA2cXp8ZVGtD5Lc6wbB/NQUQ1PP300yx1eyUHOxLSIwsqcnklAmxzQGeeeabUAANbpiF6DIgTYpJN8DLLeL2hQYD4hYfyNxUgaTmCxVbOlulUJYxUrCneMe/qchNd1PIc6aaqpwqd3exU+v3ECfF2K9cjzzWcjNu0aSMxnzfffDN9/vnnjvRt1YntpwpiF8SvG2+8kZApH0opcECx5t21mkw8x0Cx4S5gBci2CC9ulYLUqo2dY8hLjdQkUQPEH8yNfwtL5xFTP6aBVbWGiBUk4PwIBTjH8YkS3NSHwgfyS2NtVuBiz2MUJcyPsO6YcWMaFGtBLvAA3Fx8Kbnvup0MlJrmNBlQiBsXDqN9IOYh5oR+MB+YkmMFPE8AlRo4uB/k0LbKFR3cLlH7/+lxH+EvkYDYz88++4y6deuWsGFsEyBUyEAMGNKkIlEY/iAjXnzxxZJQLNUpORCrFqpoIBTn0FmFOm8Xu3iwY+qDa1eVsBXJzfFFBs8DL0dM/QRNFHmUVM7soFOHdvlFkbH5ZQwuKAgCBNzgRQqVlF5eQxYd3RwcGg5ixo2pUxAfzCkANzyu8dJYKvn5RymO6O7eg9xt2pquKrsJ4hFPUnr0iLmAMKMfK0ITD3ErO+P0OYL3/IMPPpAJwfQOKxhq+iUKXHzDfcWhbI6AB+2HH34QyvjFF1/4v1bdu3eXahcXXnihzZ6S1wylZcFa1ohTB4MvQiz+EAiqLFkwT0rn7mWzNr6q8Za6RR94CUIRDjN2i6ZMJg+qR7RqbT4sLztwg0ofoSqGFHOlCiQi8xzWNeDa4J1YcWPuB+I9ni9z0jvzebvbKKUDvMSalB7j4COBenW43xGJvN2J6XZlMGBbB6SuBHuMAoEo2YyXQAGsYTDLK+qpjutfVqQeLPUBSrYXdCnyXVmxe0OLFSxFPkD62an4GLBNgFDd9OSTT5YyPDC///jjj1Lp4vHHHxfzPPyEAJAZNQRiwMV6GImlClamBjZL3B4U0bHmBOIyQgmthpG4VeueywEGbOuAoA0Hiwx2HZwOKpjCa1IB6n499dRTouxVx/SvDwNeKIGTlAfaEufMwcSSllWuMVgLlOxIeMtF6IMVEQO2CRDK7iD16tChQwOVhKVYgRJ4zJgxkqq1IiIqnjVBBHPnJC6gL+LcmAOSUJCIDYMalKZiRTiHBo2BRGDANgGCLwCqlqIWmDJxwhQMRR2Ufpdeeimdf/75iZhjue9TRDCuM54qEG/oWEQwVggD3Knk3lKFND1uUjBgmwAhSvbqq6+2nBQyJIIAabDAAEzLePlTpIDGjOAN7Y2BAKkwDM0BWdxXfcgRDNhWQj/44INSAUPFfSE+BKZk+EgkKlLWkRWmuBPUMAcgt03KAEpoeFtES4TAAcEDOg6HvpStWQ9cLjBgiwDBWW3dunV0/fXXS4ll6Huef/55SVLWlNNmrlq1qlwsNhWTFBM8Bk5RLJWsuVSHE60iOiWpWFNxk/SYKcOALQIEhy44dsGZD3mBOnXqRCjLjExp8IAeN25cyhaQ9gOjEgZDKk3Zqj5YtByQkaJUrGl/T/UEHcOAbQIEkzuiZFETDDFgcM+GOR7VUps0aeLYhCpaR+CAhPhw2ETKACIYQ9SJyVgES1YtsJThRg+cUgzYfisefvhhgrgFLmj48OESro94MMTdXHHFFSldRDoPLjqgVIpfQE6MBMgA96ZN8On8eJX7udm2gqEc84IFCyS+BiLZrFmz6Ndff6VTTz1VyjWXe0wkagEFnAeoKpf4TSG4wH1xLqCoK6QWMQeUQutdClGmh04SBsISIPj5qLQEmA+CH7GP1BbIGaKsX/ALSpe0HEnCm/1hkIisTl377RPUUpLTR2EFE3ENlrMUpWJNEBp0t2mGgbAiGBTMUD5H+kNKDg0WGGBiLZYnxmHKIdr6YCjHDNAimA8Pafj/dk5NlbvL+Ylt4Lzb7777ruh8ly5d6vwAph7DEiBwPOBs8Bcq/wliw5qhgJyGMhhQJniks0g5sNgcjQgmJniedKpSsaYcX2k8gRIOz3v8C6KbxhLd/BrRUI4D319adi7eaX/00UfUt29fmjx5Muew2yGhVyNHjoy325DXhyVAc+fOZcttkfwhLyzK8yDaHeEXy5Ytk/w/EMmuvPLKkAOoEzu5pO6kSZMsa8mDyk6cOJG2c94cM2D/+++/p0RTYfOYjm6XmuBTGohauiARwUpDK2ytUbVlzklDemHgfs4XNmMFJ7pkP9GC0oInoz/0+ZrGM9OZM2fS3//+d/r5559p7NixBMMTaoIh7xcIUiIgrA5IDQgi89BDD9E111wjAak4jgT1mCCKlyEVByhnKPjqq6+EcB133HHy27lzZynxg/Yw7SO+DKU/XnzxRXFwREb+2bNn0+jRo8XkjyBXEDkEwpYnSCcOyBeO4YvtsoVDpHKF4toTe1pTW+PoRpYYAGGZu8byFC3ewJlpg9IIbsoj+t9sonoWdQ86NiWqnWPdl/koPvYXXHBBQEA5ErKBAYCkkwiwRYDgCY18y8gBJDWZSkUKUEUkJoPMGAqQ2hLyJPyG2nCi60suuUQWCdM90nsg1zS4KqQXBRF7//336a677qJnnnmGHnnkEerZs6e0h+kfFTms0mOGGjvVx8UEDx1KKn2AFBJgiocSGoplG3mJIIJpC5hCXvJ/cYuq+Ny3ygyewd+EwqAU3sUsllXhR83qGndASZEy3fkP/PXXX5KI3n+gdCNRxAfd2yJA8HhG7Ne0adMkRWX//v0pLy9POBd0csYZZ+DHEqA7QjIz+A8BQMBAzECYEMLRowfn+C19QXv16iWOjbCqgajhHAC5p5EyFJkYQcSsAFxauiWldyERPH+qzAndkXIUWXADEq9bLSjCMdtJ6VU/SK3BeYnyMSflFwRixGCZlH7XLnJBiR4i8bvqVv3insW7JuAGz4VT/ajnSs0xml88T4BUJaXP4jezR2uZQpn/TulFNGEWf09KiRDoCwjP8d3KNI3qAFLhBqtBouoghsa2CBD6BRFBug3ohcAJAXCDUbDw9ttvl/1Q/ynig5v67LPP0imnnCIi3ObNmwNYu5o1awphQzVGXIOYMwWgwlCKhSJAaAfiFgrwgqiHKlSbSMfxcoQbI/h6z142U3AqixLTvNQcouknuF/sox/gB+uyBTx3D9wq9u0lo9QvSaUDBzHD2szg4UT6aOc1zd18Png7WtwEX499rAlzcgI3mI/5+bEaL9wxM26scAzDTKq48StPINrJRVamLGIjJb/BPfmb/H++Kj3hlhTxXO/evS1VKZBWTjjhhIQ4HNsmQIiCh/PhjBkzhHMBgQCH0rp164gLQwP4DkGPhBt7zz33yDXgjswPPm40KiIEH0djnIM7QCgAMWzYsKHl6VQlpS9akU1uzhjgMc0LuZPwVQ01V8sFWByMJik9Ljf4fhVvXE8ZNWuxX1Id6RH3ArgB4Q9OSl/EuHYz52meu8U0/IcqalL62rVrp11SenyX/3k20Y2n833lOwAi5AQMGzZMVB8wOP3zn/8UBgOVcKAbAuOQCIhq6njJERNmTsVqZ1LQISFlK8z14JaUSR8s37x58/xd4CFGXBkCXhXrqyoS4BxCQcoNIJUpixRpYYIH0jgxvQD0QHaA22kdkB1Epa5NZlRvb+R5omoMDEY33XSTn+BAB4tCEyDEiQCHl2A9xfvvv18i6G+44YaABvA3AGWFIhuE5+uvv6YjjzxS/I5A5FCDDMnOoOyGCwD+ygsY7AENSGkeIBOyVEQ8HCMPCbamBqZN8QGCfkg7IZqwUjk2YY2eMGGCSBxgHMAdJxISToAWL14sOYT++OMPKWyoFvPCCy+ICDdixAgJboW5D+Edyqsazk+jRo2SVB/gvGCSL1fAMWACqQ5ENSENRMhWRHypD1AqU4iYpq03U4AB6LgSTXywrIQToC5duoipPRQOYUFDuR/oiGBtUwBihGj7XWyNSRT7p8ZKxK/KhJgOToj+9UEMsyGCKS9ozQH5Mac3EoSBhBMgO/NGdH2oKpblkfhgzVKFAuEP6eTIB/N7KXcT9r6UxoG5dDmesGjSJ+PHQNhQjPi7r8Q9wJEvQj31ZGPHFxEf2RtaOCAQK5d+PJJ9jyrbePoJS9AdlzCMdCtnA6JiRwQDB6QV0Al6MnS3ZgxoAmTGhoPbsIKljQlercuuEpq9prUJXiFN/yYSA5oAJQC7Btz4kdA9laV4LNYFEYztqyTzszjvPwT/JZ2IzI8OvZE4DGgClADcGuztLMUI08gEL8uECAaIIIahIKHmgHyo0v8nFgNpYQVL7BKT23vBJx9S0cTvyWBOo/CzTyjnuTFp8zILBwR0sDNiyEqtcEAEgdI6oOQ+OJV0NM0BOXjjCz58X4iPvMB4kVmUyX/0EYl/c3CY2LtSycXCcUDKTK9FsNjxrK+0jQFNgGyjKnLDop85S0Dpyy3hDqwL8m7bSt51ayNfnIwWpSJYOG9ob6kHt07FmowbosfQBMjJZ4Dd18sAFNLB6evKNErOAZf49jBptMEBaSV0cu5JZR9FEyAHn4DMY44t2xsH9Lk5rCRtgIlQOA6IY2JkqoZSWKfNxPVEKiIGNAFy8K5mDbuE3J27+HpkL2h3y1aU8+Ir7FCcPmgWRXQkDoiJTzrN2cFbpLtKMwxYyAxpNsNyNB28tNXuupe8XAEE/jYuzmuUbi+ypOWAFSwE+HJBh078FuIyfVhjICYMaAIUE9rCX+RO57xFEMHCpFk1dBhG+JurzzqKgfSRDRxdlu4sJAbg36NM7RaNJBBVR8FbYEYfSgQGKgwHhITmyB1kBch9jMoPSL4eD+B6pIaNB5DbGvOJtx+VSxtZ66IBF+PBtWsneXkdmAcA6W9VIng3jrMPkBHlOp3ADfpwAjfAMfJLIZFdrKCKB6gc3sH9IId2uBzlwe31vjUGKgwBwsOGrIpWgMTrSHaPnLfxAIhGqDHs9qse6Hj7iTYpvZof/HxK8rZTJuf4NTi7uUrYL0npmYgXZWeTh3N1u0PgUvUT/OsEblAnDqV54sUNcAziECrHVPDcrfZBxFABGM+Myktu1U4fiw8DsX8i4htXX50iDKjc0Ja+QEo0017QKbo7lW9YTYAq2z0v9e+x8gVSx3QgamV7KFK3Xk2AUof71IxcGmSqiI15EoiCF9CBqGa06O0EYkAToAQiNx27dqn6YMUWCvlSEcwfNZ+OC9BzqlAY0ASoQt1OG4vxsN0BuZ6Vvsd0iZjgwf2g9KYGjYEkYEAToCQgOd2GAIdjJYIhDkzrf9LtblXs+WgCVLHvr+XqDNT0tfKJAlekLWCWONMHE4MBTYASg9e07jUUB+SLA8tO67nryVUsDGgCVLHup63ViJLZQgmNODCtgLaFQt3IIQxoAuQQIstVN/AFClZCI3Eae/+GzBVdrhaoJ1teMKAJUHm5Uw7OE97QwUpoiYLHGNoHyEFM664iYUAToEgYqojnQWTA8ZSU+FdnHPRlQtRWMD9K9EYSMKAJUBKQnHZDWIVjKJFMW8HS7nZV5AlpAlSR726ItfkVzebMiEhExg6I/nMhrtWHNQacxIAmQE5is5z0ZRURLyZ4zf2UkztYcaapCVDFuZf2VxJKBNMKaPs41C0dwUBSE5Lt27eP5s6dS8ccc4x/8uvWraNNmzb59+txIvcOHTrI/vbt22nmzJnUunVr6tSpk7+N3ogTAx4PcbrA0hLMPsdDiYTXqVjjRKy+PFoMJI0AIeXnAw88IGkyzQTotddeo9zcXKrNGfoAPXr0EAI0e/ZsGj16NA0ZMoTGjBlDV155JQ0dOjTa9en2ITAAXY+BcIxSsQtmeXe1nBCt9WGNgcRgICkEaNWqVXT33XdTrVq15M+8lOXLl9Njjz1GLVu2NB+mZ555hh555BHq2bMnXXDBBTR8+HA6/fTT2U2FTcga4scA8AjLl6I5BYU6EDV+rOoeosRAUggQEqffc889lJeXR999951/ijiOXMLIvTt58mQaNGgQNW/enB1yi2nDhg3CDaFxo0aNCDmLN27cSG3atPFfb95AEnGIbFaAROfIoYzE9PEAEsFv3bo1ni7Y/cYrided6MfFVqs9e/bENB8344NYJKY6dWkPJ6nP3LmDvLxtxLi+dMMNni3gJ1ZQCftR6MCqn+rVq8szGWv/+jofBpJCgLp16yaj/fLLLwF4X7lypVQvmDFjhiSNv+WWW+iqq66iI444gnJycgJuPLgnEKtQBAgdh6pSAOKTwXXb4+WeIEaGGiNgYWF2kHQd1R/i7Qd94MXAumICxi8IENKSZXFxjAwopmty0n5O5h4LOIEbVLIAIYsXN8Ax8BJvVQx8sJDY3grHVsdiwVtlvybGp9cZtHXp0oXGjRtHdUoL+bVv357eeOMN6tOnjzyI5lHAFYV7MPGw1axZ03yJfxtfQ1Q2iLcqBuYQagz/YBE2ULHBiX5irYqhpuetXYdKmKAyH0TZbhdlcdWQjLpcyZW/7LGAE2tSVTGcwDGelXirYoAA4UOoq2LE8kTYuyalZniwtztRxrgUoAeCQhoECS8YvogKwP00bdpU7erfODFggOMpzQnkgi4IoPVrPjzo/5OGgZQSIHzxbr31VtHNQOb+5ptvaODAgSIqHXXUUTR+/HhBBPRDIEqKU0oadirwQGIFK42AN1gBDbO89oKuwDc8TZeWUhGsXbt2dO6559KIESP8YsnDDz8sqBo5ciSNGjVKRDSIVzDJa3AOA8ob2oUUHAjJKHVOdG4E3ZPGQGQMuJjz8NXnjdw2YS1gGYKTopXsDzFN+QjFOgFV/TNeHZAT1T9VZdTGjRvHuhy5Ll4dkMG6qKK/ptOOZi2oxv59lM2PQUav3jHPyQncKB1QA67MGg84WRkVVVq1DiieuxH+2pSKYGpq4RTI8RIfNYb+DcSAX9zizIiiA9L6n0AE6b2kYCAtCFBSVqoHCcRAaX0wV1Ex6VzQgajRe8nDgCZAycN1eo3EtcFc8CFCbmjWAelEZOl1eyrLbDQBqix32mqdrHh2sS+QZEbUIpgVhvSxBGNAE6AEIzitu+fc0C520gRoDiit71SFnZwmQBX21kZeGBTRrnwfAVJR8ZGv0i00BpzDgCZAzuGy/PUE3x/lhaFFsPJ3/yrAjDUBqgA3MdYl+E3x8ILWjoixolFfFwcGNAGKA3nl/lJFdDT3U+5vZXldgCZA5fXOOTFvTYCcwKLuIw4MpDQWLI5560vjxAByQBd+/BFlLZxPXuaAvC1bk1tnG4gTq/ryaDGgOaBoMVYB2hsce7d/xDVUMmc2uTjliYvjwg7ccweVrFldAVanl1CeMKAJUHm6Ww7Ntfj3qZL7x/AeKs2MUs0F77/r0Ai6G40BexjQIpg9PFWoVgZyY3M61zIZk5EnWoPGQBIxUGEIELKKIC1oKEDKD+RRjgec6gNziHcuyJ2MNcfSj9GBa6wF44IV0q7evWPqD+txCjexrglzUADchHsWVLtwv+gDgH6sckt7uLaa1fFwfepzZTFQoQhQqKoX6qEOdb4sWqyP4CWLtw8QDMzHiX6QlB5zihqQg/uyK8n99hvk5VzQnBSKqE1bKhp8ChXFWDnECdzgZXeqH+AYRCJWUHhVifKD+0HO6XiLHAT3WRn3KwwBCpdTSCelt3i0TziRSrhayQ4uAFmNE4DlxJGMDL2DeFgllLMYOeQhlZAs3n6cSkiGj4ROSh/ydjlyosIQIEewUck6cTdoSMU9epKLSx5p0BhIBQa0FSwVWNdjagxoDAgGNAHSD4LGgMZAyjCgCVDKUK8H1hjQGNAESD8DGgMaAynDgCZAKUO9HlhjQGMgLeqC6dugMaAxUDkxoDmgynnf9ao1BtICA5oApcVt0JPQGKicGNAEqHLed71qjYG0wIAmQGlxG/QkNAYqJwY0Aaqc912vWmMgLTDgeYAhLWZiYxI//PADtWrVKiANwp49e2jKlClUlaO6a9So4e8FwZF//vknITCxAQdbmmH79u1yDVIu1K9f33wqYHvp0qU0a9YsqsWxUtWqVQs4t2TJEtq3bx/Vrl3bfxz9/fHHH4SgSvSLaHUFODZ16lQJ2DT3hej4GTNmUF5eHjVq1CjgGnUtxsE8NmzY4P9r3ry5Oi2/VrhZtWoVzZ8/X9afqfI/c+tQuFm3bh0tXrzYPwaCMevVqxcwjtpxEjdqno0bN6YMlItmWLBgAa1cudI/F6z9IFdxDZ5PJNzgPPDbsmVLNXX5VWPi2TDjJtw9DLdm1Tmi5/HcYb5YTzwR+arPivxbbgjQ559/To899hhddtll/od0/Pjx9K9//UsIz5tvvilEon379oTo90svvVQIFR6+L7/8kk499VS5j7M5+vuWW24RwvHKK68Q0ip06dKlzD1++umn5brCwkJ68cUX6ZhjjhFChIarV6+WPtq2bUsdOnSQa/HAXXfddYQHcObMmfTTTz/RCSecIAQFhGf06NEy5uuvvy4pJzDmli1b6Oqrr5Y2CxcuJMznjDPO8K9PTQrXP/PMM7R161YC4cPf4MGD1Wmyws2dd94pcwCxGTNmDB177LFUvXr1sLh58skn6bfffqM1a9bIGLi2R48e/nHUhpO4efTRR+nnn3/m6tAl9N///lfmiQ/Jp59+Ki+yWi/20aZfv35qGvIbDjcgWMD7smXLAvAVCjfh7mG4NasJgWBfddVVtJ8Tu2FeWNfJJ59s+VFR11T6X86bktbAHIJx1113GSNGjDAGDBhg8EPln++wYcOMRYsWyT5zNcaJJ54o55kwGfzg+dtddNFFBj/Isn/55Zcbc+bMkW0mAAa/8AYTDX9bbDCBMYYOHWrwAy/HP/zwQ+Pf//63bDMxM84++2wDY3/33XdyDP+9+uqrBhMq//71119vMBGSfSZ4xi+//CLb/DIYF1xwgWw/99xzBhMk/zX33Xef8fXXX/v31QYTJuOtt95Su/7fULhZvny5cf755/vbMYEy7r33XtkPhxvgae3atf7rrDacxM3OnTsNfkH99xTrfOmll8oMy9yQce655xrMRZY5Fwo3zD0ZF154oTw3t99+u/+6cLgJdQ/DrdnfMW/wR9BgQuU/hGf2999/9+/rjbIYSHsdEL56Rx99tHAh5q8FP7zCEXTs2FEOgzXHl3Pjxo3UpEkT4geNcnNzacWKFbRr1y6qw0m48EXHV0591SHyQBzCNWYAe442KuNdr169iAmdNIGoBy4GnI9ZxJo3b56/XzTEvCBCAJpytYnp06cL9wH2vGHDhnIcHBM4OgUQ06wSlWEt4F4++OADESf4NsoloXBjNResCRAKN+Aad+zYQdu2baP33ntP8CQXBP3nJG6wJog/f/31l4itELsUbtSw4CiZ+NMdd9xhmW8oFG6wnnvuuYf4Q6G6kt9wuLE6h3sYbs3mzvGs4VlRYH5u1DH9G4iBtCdA2dnZdNZZZ5URS0BQ2rVrR8xZyIogWkG3s3nzZurNqUUPO+wwefjAEjPXIw82RBgkmDITDuh38OKZAX3guAIkyIKOBjBkyBC/HkIRAhyHiDZp0iQhctA7TJs2TeaCc8OHDyf+EtKZZ55JzMnQbbfdhsOSUU/pHyCygTgqUVEalP6Hlwy6JeDinXfeIf6iy5lQuOnfv78QPBBpZPaDfghrAoTCDV40vOwQWUHYIKZ+++23co35PydxA33PqFGjCCIRcziSDhb32gzAKe7FkUceaT7s3w6Fm26cbK179+7+dmojHG5C3cNwa1b94hcitTmZmvm5MbfT24cwUK4TkoGDeOGFF4hZZ/myg+jgYQWHAuXzuHHjRFGMryeUtuBK8HKZAVwR9EBmgOLQ3A5twPmEg1NOOUW4JBav5Kt+xBFHCLHDNTfccANdfPHFdM455wghGjlypOhtVJ/QZYHreOqpp4TTCR7njTfeEP0RODIQMRYBhVgFK6LVdVB+Yh7QLyFt6HHHHecnqKFwA90K8AXCDoAuDeOefvrpqlv5dRI3IB6PP/44QX8HLhG6NuiEWBT1jwncsDjp3w/ecBI3oe6h3TXbbRe8hsq8X64JEF5yPICwhOFrwzI/NWvWTJTA4HpAjPAHhS1EILxkUBDiSw/uAQDuBw+/GWAZATuuAG0guoQDWMMefPBBIXgQLaBQhjgBrgx/rFMSiwiUwSACsDaBRX/33Xfp+++/p+eff16sYMFjQAnOehmqW7eunAJBgeiIr20oAoSGUMIDH+CAcD3GA0BBboUbKMWBR0WAYDWCCIvrlSiK653EDevi5J6A2AEwXxBnBbDKQTweNGiQOhTw6zRuQt1DPEN2ngdYPs3cNLZbtGgRMGe9E4iBtBfBAqcbuMdKPoL1CMQHVgc8AHiBwErDbA0A9wIdA/RIYPmPOuoowlcVMHnyZGmPa6B7wYsK6Nu3r5iB169fL9ezYjikCCAX8H+sqJYvOPRQeJHRN8bCnEAoYMIFgHBANOratSuxEpt+/PFHYsVrGeKjCBdENHBGEMEAICQQBw8//HDZt/oPLy10HyAc4O5gQVIvcSjcQP906623Ch4gWn7zzTc0cOBA6SNRuME9wXqU3gv6MRxTAAtY586dA8zkOLeGrXSwcDmNm1D3MNzzYMYNPi4TJkyQueH+QQzHR1JDaAyUaw4IItgTTzwhLxnYX5hcARBTwM7jawqOBw+QMt/iGPQOEDfwgqprQMgeeughIU4gaCBu0N38f3vnjqM4EEVRb4WIkDUgEZGyASSEBAGQk5KwDUIQC0BEwxLYBNuoeefNFLLcBvOxZUPfkppuf8qfY/O66rnuNS0Pxh7RhbpXyF0sl8tkPB57q4HuD60xymw285YauSG+3ORXaIHReqOVke7mDAaDZLFYeLeELxjr8kM3kx+SxORM4niZvGNiv71eLxmNRt4FI2HOdim32MCCPAznTdCGwWq18jpVsuHcyYnRmqHFOJ1OfZ98EGgY6pAtrLNer5NOp1Mqm3vX8Nb9kGYDc/4RxuBvTxWTVquVPXxNpwh8hR0HX2y6PdnCf0m+qHlfVp6MpQcRZusyzSBBumt5285bn3m3joVlBEOS4K8WWikEhnQS/d62+FIT8GJ3M73uLTZ0uTgH9nOvlMmGY6QlkR6geW/fecvKZHPrGj56zuQfye/l3Xd5x/6b531FAPrNF1DnLgKfTOCjc0CfDF7HLgIikCQKQLoLREAEaiOgAFQbeu1YBERAAUj3gAiIQG0EFIBqQ68di4AIKADpHhABEaiNgAJQbei1YxEQgY8eCa3L948AavfdbudK98lkcsWCtIJBdZi2RV0apm7n89k1SsPh0A3AYgW0WchUkH0wSBMZAaOwGZHNIDxGkaObQ5mOfMT8l1y+Eevrtwg8TcBGoap8OAHTmWEQFEw2Emz0s5+NaeF8Xrvd9mnTjwWTaPg806YFG6UbTH4RttutLzfLiWCaOJ9vNhbBRiX7uiYp8eU2UtmnLTAF05f536by92X6EIFXCagL9nTIbl4FbEYQmaK+RtxK2e/3/jsanqGdQqSKPxKiW1pByC7QlUXFPBomC0iu/D6dTl4fv+10QcIyn89dp0VdFRF4h4C6YO/Qa1BdAgtCSLpi+NoQgNCMxQCE0pxCsEFdT0Gpb3ajLohFuY/y/Hg8JmYnezV6i0p1r/D/g64dnkMqIvAuAWnB3iXYkPoIIAkK+AWRE8IBAAsOjNEp2FwQhLABSb89hGWbzcZV9v1+360kut2u53lQw+MLRIsJ8Wo0UMOsDfW8igi8S0B30bsEG1KfoIJzIF2kaOqF8VgsWMlSsAnBHpa3X5BgJpmMIRjOhPgYYZZ2OBwSrCTyCrYnCj55ZDTvJQKvJo9Ur3kErLXjyWG7ETyJbAHlepD2ZMuXWbcrWMsm2BMwn+atIBTL6/i0+QUF3gJiLSafJulMiUloeyLm0/oQgTII4Bej8iUELL8TzMDLA4cZqP04KzPEDwQgApT5EgUzAwtmcObr8Robc0D0J2M8IbPWUTCPbV+XVxopAP3AqRklEFAO6KV2YzMrYUBGdworWaxBSUbnlcvl4glo8kXZguMi3bmsUX92PU2LQBkEFIDKoFjzNgg8vPnjj72iiMGENvbH39ChXE3NF0a7LySgAFSI6DNWwEKVJ2GMCeIVPzwFUxGBphNQAGr6FXrw+DCS51H5M/7VD25aq4lAZQQUgCpDqw2LgAgUEdA4oCJCWi4CIlAZAQWgytBqwyIgAkUEFICKCGm5CIhAZQQUgCpDqw2LgAgUEVAAKiKk5SIgApUR+AsA7VknFWhIYQAAAABJRU5ErkJggg==)
+Building a time series plot with the gapminder data set:
+qtseries(gapminder %>%
+ filter(continent == "Europe"), year, pop, country, verbose = TRUE)
+#> Plotting time series...Done labelling plot!...Done applying default theme aesthetics!
+![](data:image/png;base64,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/W3dYPaHo8Lz/Hj00UfDe/n5559TzmXaGTduXJgv6XncsZ49ewbTpk0LNt100/D+vv322+CLL74I1PDYJSZOnBjonyPQFsr2f/3110ArcqAGKdxHf064z9GjRwfqFblDeW9vu+22tO9iueWWC7iHYsnrr78e6kqNXbGKzVrOVlttFV7XvY/odq+99krRYVIdynqRSIInnngiQHdPPvlk5Gjtn8O//SXo8fhHwTJPfBT0GvFR0O2/Hwaz5i+onTDPI2uuuWawzjrrBOecc06Yk3qzwgorBNq4BG+99VZ4fO7cuYE22FbP3MEZM2YEc+bMMZ2ogxDWz1mzZgVbbLFFcOedd9p50qs3FHz88cdWt11+6vPvv/8ecE11NFLOkaa6ujrQxigYP368yxJuqfscp4ypU6fa8aJ6QP/617/k73//u75/sRZwv/32sxZXH0LuuOMOcw932203eeedd0QVaely/qpeIEM230y6d+umedeQYMF8yzr12uNlwdRJInreyfThF0jF2fdI+ZJd7VCwYOE5yWPeZdu2bYXPHnvsYZ7XhAkT5IcffrAyV1xxRemm97LWWmtJ+/btzbvr2rWr8Mw87+67727enhoxef7558070Jcj+++/v2jlNW+I1ur99983D2vvvfeWV155Rfr06SPoSF+U5X/vvffk3nvvlb/+9a/u8XLaaiWRI488UrSimK4pkxb7qaeeMjcej+XEE0+Uu+++O6fysiWi1eXZkQ4dOmRLXvTzXbp0kYMPPljQ8cyZM0UbOpk0aZLgWWrDIIcffnjB1/z+++9lhx12CMvB8i2o5jtVxk6fI6eNnmAH5/9Z9fijnTX6B7lyUO/UxLqHY1Seh3e05557mkevjb2V9dJLL5lXq41AWPapp55qni96oRfCe6cXwv/zu+++M6+R94Su+D9SRz/66CPRRkmWWWYZ/ZsEss8++1gePK6rr77a9Et9PProo2WB/qeWXHJJ0UZSHnroIRkyZIioUZGtt97avH3qH/WbLiOeHx73iy++aJ4p98Qx7rtoBuinn36S888/3xTAg44aNSqlu0UFWHfddUWtrxxzzDGiltpugnxqqe2PHnVp+aPzkCiJz+w3R8peKy8tc5brLK1btpQ5bz1l15o/4SszPjPnLZCxU2aJtjGyes8WMuuF+6R57/6WZt6XH9iWr/mTxotaDvtjYlAQ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)
+Some errors you might see if qtseries
is given non-numeric variables for the time or voi inputs:
+qtseries(gapminder %>%
+ filter(continent == "Americas"),continent, pop, country, verbose = TRUE)
+#> Error in qtseries(gapminder %>% filter(continent == "Americas"), continent, : Sorry, the time variable needs to be a numeric variable!
+
+qtseries(gapminder %>%
+ filter(continent == "Europe"),year, country, continent, verbose = TRUE)
+#> Error in qtseries(gapminder %>% filter(continent == "Europe"), year, country, : Sorry, the variable of interest (dependent) needs to be a numeric variable!
diff --git a/tests/testthat/test-qstacktseries.R b/tests/testthat/test-qstacktseries.R
new file mode 100644
index 0000000..58c667b
--- /dev/null
+++ b/tests/testthat/test-qstacktseries.R
@@ -0,0 +1,22 @@
+test_that("Quick Stacked Area Time Series Check", {
+
+ # create dummy dataframe
+ testdf <- data.frame(year = rep(seq(from = 1980, to= 1990, 1), 3),
+ rainfall = c(runif(11, 0, 100), rnorm(11, 70, 10),rnorm(11, 20, 20)),
+ temp = c(rnorm(11, 70, 30), rnorm(11, 45, 20), rnorm(11, 100, 10)),
+ daysofsun = c(NA, NA, rnorm(9, 280, 50), rnorm(11, 300, 30), NA, rnorm(10, 340, 15)),
+ region = c(rep("A",11), rep("B", 11), rep("C", 11)))
+
+
+ # test that the data is grouped as expected, testing with NA's present & all arguments = TRUE
+ expect_match("region",as.character(rlang::get_expr(qstacktseries(testdf, year,daysofsun,region, round_values = TRUE, verbose = FALSE)$mapping$fill)))
+ cat(" Expected grouping & extra arguments working? -> Yes!")
+
+ # test that the output is a ggplot object, testing without NA's present & all arguments = FALSE
+ expect_identical(class(qstacktseries(testdf, year,rainfall, region, default_theme = FALSE))[2], "ggplot")
+ cat("...Expected Object Output (ggplot)? -> Yes!")
+
+ # test that the first layer is a geom_area layer
+ expect_true("GeomArea" %in% class(qstacktseries(testdf, year,temp, region)$layers[[1]]$geom))
+ cat("...Expected Geom_Area Layer? -> Yes!")
+})
diff --git a/tests/testthat/test-qtseries.R b/tests/testthat/test-qtseries.R
index e250365..4c97b12 100644
--- a/tests/testthat/test-qtseries.R
+++ b/tests/testthat/test-qtseries.R
@@ -7,14 +7,14 @@ test_that("Quick Time Series Check", {
region = c(rep("A",11), rep("B", 11), rep("C", 11)))
# test that the data is grouped as expected, testing with NA's present & all arguments = TRUE
- expect_match("state",as.character(rlang::get_expr(qtseries(testdf, year,daysofsun,state, round_values = TRUE, verbose = TRUE)$mapping$colour)))
+ expect_match("region",as.character(rlang::get_expr(qtseries(testdf, year,daysofsun,region, round_values = TRUE, verbose = FALSE )$mapping$colour)))
cat(" Expected grouping & extra arguments working? -> Yes!")
# test that the output is a ggplot object, testing without NA's present & all arguments = FALSE
- expect_identical(class(qtseries(testdf, year,rainfall, state, default_theme = FALSE))[2], "ggplot")
+ expect_identical(class(qtseries(testdf, year,rainfall, region, default_theme = FALSE))[2], "ggplot")
cat("...Expected Object Output (ggplot)? -> Yes!")
# test that the first layer is a geom_point layer
- expect_true("GeomPoint" %in% class(qtseries(testdf, year,temp, state)$layers[[1]]$geom))
+ expect_true("GeomPoint" %in% class(qtseries(testdf, year,temp, region)$layers[[1]]$geom))
cat("...Expected Geom_Point Layer? -> Yes!")
})
diff --git a/vignettes/.gitignore b/vignettes/.gitignore
deleted file mode 100644
index e69de29..0000000
diff --git a/vignettes/qstacktseries.Rmd b/vignettes/qstacktseries.Rmd
new file mode 100644
index 0000000..c23bc21
--- /dev/null
+++ b/vignettes/qstacktseries.Rmd
@@ -0,0 +1,57 @@
+---
+title: "qstacktseries"
+output: rmarkdown::html_vignette
+vignette: >
+ %\VignetteIndexEntry{qstacktseries}
+ %\VignetteEngine{knitr::rmarkdown}
+ %\VignetteEncoding{UTF-8}
+---
+
+```{r, include = FALSE}
+knitr::opts_chunk$set(
+ collapse = TRUE,
+ comment = "#>"
+)
+```
+
+```{r setup}
+library(timeseries)
+library(gapminder)
+library(dplyr)
+```
+
+This is how the function `qstacktseries` works:
+
+Building a stacked area time series plot with a dummy data set:
+
+```{r dataset}
+ testdf <- data.frame(year = rep(seq(from = 1980, to= 1990, 1), 3),
+ rainfall = c(runif(11, 0, 100), rnorm(11, 70, 10),
+ rnorm(11, 20, 20)),
+ temp = c(rnorm(11, 70, 30), rnorm(11, 45, 20),
+ rnorm(11, 100, 10)),
+ daysofsun = c(NA, NA, rnorm(9, 280, 50), rnorm(11, 300, 30), NA,
+ rnorm(10, 340, 15)),
+ region = c(rep("A",11), rep("B", 11), rep("C", 11)))
+```
+
+```{r example 1}
+qstacktseries(testdf, year, rainfall, region, verbose = TRUE)
+```
+Building a stacked area time series plot with a pre-existing data set: *gapminder*
+
+```{r example 2}
+qstacktseries(gapminder %>%
+ filter(continent == "Asia"), year, gdpPercap, country, verbose = TRUE)
+```
+These are some errors you might see if `qstacktseries` is given non-numeric input for the *time* or *voi* inputs:
+
+```{r example 3: Errors, error=TRUE}
+
+qstacktseries(gapminder %>%
+ filter(continent == "Asia"),continent, pop, country, verbose = TRUE)
+
+qstacktseries(gapminder %>%
+ filter(continent == "Africa"), year, country, continent, verbose = TRUE)
+```
+
diff --git a/vignettes/qtseries.Rmd b/vignettes/qtseries.Rmd
index 40d8226..ca62a3e 100644
--- a/vignettes/qtseries.Rmd
+++ b/vignettes/qtseries.Rmd
@@ -16,11 +16,13 @@ knitr::opts_chunk$set(
```{r setup}
library(timeseries)
+library(gapminder)
+library(dplyr)
```
This is how the function `qtseries` works:
-Building a time series plot with a dummy data set
+Building a time series plot with a dummy data set:
```{r dummy dataset setup}
testdf <- data.frame(year = rep(seq(from = 1980, to= 1990, 1), 3),
@@ -34,24 +36,19 @@ testdf <- data.frame(year = rep(seq(from = 1980, to= 1990, 1), 3),
qtseries(testdf, year, daysofsun, region, verbose = TRUE)
```
-Building a time series plot with the gapminder data set:
+Building a time series plot with the *gapminder* data set:
```{r example 2}
-library(gapminder)
-library(magrittr)
-library(dplyr)
-gapminder %>%
- filter(continent == "Europe")%>%
- qtseries(year, pop, country, verbose = TRUE)
+qtseries(gapminder %>%
+ filter(continent == "Europe"), year, pop, country, verbose = TRUE)
```
+
Some errors you might see if `qtseries` is given non-numeric variables for the *time* or *voi* inputs:
```{r example 3: Errors, error=TRUE}
-gapminder %>%
- filter(continent == "Europe")%>%
- qtseries(continent, pop, country, verbose = TRUE)
+qtseries(gapminder %>%
+ filter(continent == "Americas"),continent, pop, country, verbose = TRUE)
-gapminder %>%
- filter(continent == "Europe")%>%
- qtseries(year, country, continent, verbose = TRUE)
+qtseries(gapminder %>%
+ filter(continent == "Europe"),year, country, continent, verbose = TRUE)
```