The Data
For this homework we will be working with the data that were used in the lecture on ggplot
from the 2011 The Economist article looking at the relationship between human development and perceived corruption.
The data are located on the class GitHub site and can be accessed by the following URL, which is being presented as a CSV file.
# The URL for the data on GitHub
url <- "https://raw.githubusercontent.com/dyerlab/ENVS-Lectures/master/data/EconomistData.csv"
Use the URL above and load the data into R and present a summary. Name this data frame df
because some code below that I give assumes that name.
## Load the data here.
library( readr )
df <- read_csv( url )
Parsed with column specification:
cols(
Country = col_character(),
HDI = col_double(),
CPI = col_double(),
Region = col_character()
)
As it stands, we are going to need to turn the Region
column from a raw character
type to a factor
data type. To to this, we can use the function as.factor()
and assign it back to the data.frame
.
# Turn Region into factor
df$Region <- as.factor( df$Region )
In all the plot on this homework, you must make an legend when appropriate and label the axes properly.
Univariate Data
For this section, focus on histograms and density plots. Create a historgram plot and a density plot, one for built-in graphics and the other using ggplot
. Feel free to embellish them as you please but you must have properly labeled axes.
# Built-in hist for HDI
meanHDI <- by( df$HDI, df$Region, mean)
barplot( meanHDI )
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABUAAAAPACAYAAAD0ZtPZAAAEGWlDQ1BrQ0dDb2xvclNwYWNlR2VuZXJpY1JHQgAAOI2NVV1oHFUUPrtzZyMkzlNsNIV0qD8NJQ2TVjShtLp/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+8AAAA4ZVhJZk1NACoAAAAIAAGHaQAEAAAAAQAAABoAAAAAAAKgAgAEAAAAAQAABUCgAwAEAAAAAQAAA8AAAAAAthHDUQAAQABJREFUeAHs3XuwVeV5P/AHhBxQhAgh4AUqJbWKw00gJDWVpIg14GU61FSindTGZozQFlFbZWI7HYGYitpqq9h6aazYSjQ1XmraJDaScpEpSoCqBSKeQq20VeAgFwEP7Vq/HydczgHh7HetwzqfNbNl77X3fp71fp71h/Odtc7usOf/trARIECAAAECBAgQIECAAAECBAgQIECgggIdK7gmSyJAgAABAgQIECBAgAABAgQIECBAgEAuIAB1IhAgQIAAAQIECBAgQIAAAQIECBAgUFkBAWhlR2thBAgQIECAAAECBAgQIECAAAECBAgIQJ0DBAgQIECAAAECBAgQIECAAAECBAhUVkAAWtnRWhgBAgQIECBAgAABAgQIECBAgAABAgJQ5wABAgQIECBAgAABAgQIECBAgAABApUVEIBWdrQWRoAAAQIECBAgQIAAAQIECBAgQICAANQ5QIAAAQIECBAgQIAAAQIECBAgQIBAZQUEoJUdrYURIECAAAECBAgQIECAAAECBAgQICAAdQ4QIECAAAECBAgQIECAAAECBAgQIFBZAQFoZUdrYQQIECBAgAABAgQIECBAgAABAgQICECdAwQIECBAgAABAgQIECBAgAABAgQIVFZAAFrZ0VoYAQIECBAgQIAAAQIECBAgQIAAAQICUOcAAQIECBAgQIAAAQIECBAgQIAAAQKVFRCAVna0FkaAAAECBAgQIECAAAECBAgQIECAgADUOUCAAAECBAgQIECAAAECBAgQIECAQGUFBKCVHa2FESBAgAABAgQIECBAgAABAgQIECAgAHUOECBAgAABAgQIECBAgAABAgQIECBQWQEBaGVHa2EECBAgQIAAAQIECBAgQIAAAQIECAhAnQMECBAgQIAAAQIECBAgQIAAAQIECFRWQABa2dFaGAECBAgQIECAAAECBAgQIECAAAECAlDnAAECBAgQIECAAAECBAgQIECAAAEClRUQgFZ2tBZGgAABAgQIECBAgAABAgQIECBAgIAA1DlAgAABAgQIECBAgAABAgQIECBAgEBlBQSglR2thREgQIAAAQIECBAgQIAAAQIECBAgIAB1DhAgQIAAAQIECBAgQIAAAQIECBAgUFkBAWhlR2thBAgQIECAAAECBAgQIECAAAECBAgIQJ0DBAgQIECAAAECBAgQIECAAAECBAhUVkAAWtnRWhgBAgQIECBAgAABAgQIECBAgAABAgJQ5wABAgQIECBAgAABAgQIECBAgAABApUVEIBWdrQWRoAAAQIECBAgQIAAAQIECBAgQICAANQ5QIAAAQIECBAgQIAAAQIECBAgQIBAZQUEoJUdrYURIECAAAECBAgQIECAAAECBAgQICAAdQ4QIECAAAECBAgQIECAAAECBAgQIFBZAQFoZUdrYQQIECBAgAABAgQIECBAgAABAgQICECdAwQIECBAgAABAgQIECBAgAABAgQIVFZAAFrZ0VoYAQIECBAgQIAAAQIECBAgQIAAAQICUOcAAQIECBAgQIAAAQIECBAgQIAAAQKVFRCAVna0FkaAAAECBAgQIECAAAECBAgQIECAgADUOUCAAAECBAgQIECAAAECBAgQIECAQGUFBKCVHa2FESBAgAABAgQIECBAgAABAgQIECAgAHUOECBAgAABAgQIECBAgAABAgQIECBQWQEBaGVHa2EECBAgQIAAAQIECBAgQIAAAQIECAhAnQMECBAgQIAAAQIECBAgQIAAAQIECFRWQABa2dFaGAECBAgQIECAAAECBAgQIECAAAECAlDnAAECBAgQIECAAAECBAgQIECAAAEClRUQgFZ2tBZGgAABAgQIECBAgAABAgQIECBAgIAA1DlAgAABAgQIECBAgAABAgQIECBAgEBlBQSglR2thREgQIAAAQIECBAgQIAAAQIECBAgIAB1DhAgQIAAAQIECBAgQIAAAQIECBAgUFkBAWhlR2thBAgQIECAAAECBAgQIECAAAECBAgIQJ0DBAgQIECAAAECBAgQIECAAAECBAhUVkAAWtnRWhgBAgQIECBAgAABAgQIECBAgAABAgJQ5wABAgQIECBAgAABAgQIECBAgAABApUVEIBWdrQWRoAAAQIECBAgQIAAAQIECBAgQICAANQ5QIAAAQIECBAgQIAAAQIECBAgQIBAZQUEoJUdrYURIECAAAECBAgQIECAAAECBAgQICAAdQ4QIECAAAECBAgQIECAAAECBAgQIFBZAQFoZUdrYQQIECBAgAABAgQIECBAgAABAgQICECdAwQIECBAgAABAgQIECBAgAABAgQIVFZAAFrZ0VoYAQIECBAgQIAAAQIECBAgQIAAAQICUOcAAQIECBAgQIAAAQIECBAgQIAAAQKVFRCAVna0FkaAAAECBAgQIECAAAECBAgQIECAgADUOUCAAAECBAgQIECAAAECBAgQIECAQGUFBKCVHa2FESBAgAABAgQIECBAgAABAgQIECAgAHUOECBAgAABAgQIECBAgAABAgQIECBQWQEBaGVHa2EECBAgQIAAAQIECBAgQIAAAQIECAhAnQMECBAgQIAAAQIECBAgQIAAAQIECFRWQABa2dFaGAECBAgQIECAAAECBAgQIECAAAECAlDnAAECBAgQIECAAAECBAgQIECAAAEClRUQgFZ2tBZGgAABAgQIECBAgAABAgQIECBAgIAA1DlAgAABAgQIECBAgAABAgQIECBAgEBlBQSglR2thREgQIAAAQIECBAgQIAAAQIECBAgIAB1DhAgQIAAAQIECBAgQIAAAQIECBAgUFkBAWhlR2thBAgQIECAAAECBAgQIECAAAECBAgIQJ0DBAgQIECAAAECBAgQIECAAAECBAhUVkAAWtnRWhgBAgQIECBAgAABAgQIECBAgAABAgJQ5wABAgQIECBAgAABAgQIECBAgAABApUVEIBWdrQWRoAAAQIECBAgQIAAAQIECBAgQICAANQ5QIAAAQIECBAgQIAAAQIECBAgQIBAZQUEoJUdrYURIECAAAECBAgQIECAAAECBAgQICAAdQ4QIECAAAECBAgQIECAAAECBAgQIFBZAQFoZUdrYQQIECBAgAABAgQIECBAgAABAgQICECdAwQIECBAgAABAgQIECBAgAABAgQIVFZAAFrZ0VoYAQIECBAgQIAAAQIECBAgQIAAAQICUOcAAQIECBAgQIAAAQIECBAgQIAAAQKVFRCAVna0FkaAAAECBAgQIECAAAECBAgQIECAgADUOUCAAAECBAgQIECAAAECBAgQIECAQGUFBKCVHa2FESBAgAABAgQIECBAgAABAgQIECAgAHUOECBAgAABAgQIECBAgAABAgQIECBQWQEBaGVHa2EECBAgQIAAAQIECBAgQIAAAQIECAhAnQMECBAgQIAAAQIECBAgQIAAAQIECFRWQABa2dFaGAECBAgQIECAAAECBAgQIECAAAECAlDnAAECBAgQIECAAAECBAgQIECAAAEClRUQgFZ2tBZGgAABAgQIECBAgAABAgQIECBAgIAA1DlAgAABAgQIECBAgAABAgQIECBAgEBlBQSglR2thREgQIAAAQIECBAgQIAAAQIECBAgIAB1DhAgQIAAAQIECBAgQIAAAQIECBAgUFkBAWhlR2thBAgQIECAAAECBAgQIECAAAECBAgIQJ0DBAgQIECAAAECBAgQIECAAAECBAhUVkAAWtnRWhgBAgQIECBAgAABAgQIECBAgAABAgJQ5wABAgQIECBAgAABAgQIECBAgAABApUVEIBWdrQWRoAAAQIECBAgQIAAAQIECBAgQICAANQ5QIAAAQIECBAgQIAAAQIECBAgQIBAZQUEoJUdrYURIECAAAECBAgQIECAAAECBAgQICAAdQ4QIECAAAECBAgQIECAAAECBAgQIFBZAQFoZUdrYQQIECBAgAABAgQIECBAgAABAgQICECdAwQIECBAgAABAgQIECBAgAABAgQIVFZAAFrZ0VoYAQIECBAgQIAAAQIECBAgQIAAAQICUOcAAQIECBAgQIAAAQIECBAgQIAAAQKVFRCAVna0FkaAAAECBAgQIECAAAECBAgQIECAgADUOUCAAAECBAgQIECAAAECBAgQIECAQGUFBKCVHa2FESBAgAABAgQIECBAgAABAgQIECAgAHUOECBAgAABAgQIECBAgAABAgQIECBQWQEBaGVHa2EECBAgQIAAAQIECBAgQIAAAQIECAhAnQMECBAgQIAAAQIECBAgQIAAAQIECFRWQABa2dFaGAECBAgQIECAAAECBAgQIECAAAECAlDnAAECBAgQIECAAAECBAgQIECAAAEClRUQgFZ2tBZGgAABAgQIECBAgAABAgQIECBAgIAA1DlAgAABAgQIECBAgAABAgQIECBAgEBlBQSglR2thREgQIAAAQIECBAgQIAAAQIECBAgIAB1DhAgQIAAAQIECBAgQIAAAQIECBAgUFkBAWhlR2thBAgQIECAAAECBAgQIECAAAECBAgIQJ0DBAgQIECAAAECBAgQIECAAAECBAhUVkAAWtnRWhgBAgQIECBAgAABAgQIECBAgAABAgJQ5wABAgQIECBAgAABAgQIECBAgAABApUVEIBWdrQWRoAAAQIECBAgQIAAAQIECBAgQICAANQ5QIAAAQIECBAgQIAAAQIECBAgQIBAZQUEoJUdrYURIECAAAECBAgQIECAAAECBAgQICAAdQ4QIECAAAECBAgQIECAAAECBAgQIFBZAQFoZUdrYQQIECBAgAABAgQIECBAgAABAgQICECdAwQIECBAgAABAgQIECBAgAABAgQIVFZAAFrZ0VoYAQIECBAgQIAAAQIECBAgQIAAAQICUOcAAQIECBAgQIAAAQIECBAgQIAAAQKVFRCAVna0FkaAAAECBAgQIECAAAECBAgQIECAgADUOUCAAAECBAgQIECAAAECBAgQIECAQGUFBKCVHa2FESBAgAABAgQIECBAgAABAgQIECAgAHUOECBAgAABAgQIECBAgAABAgQIECBQWQEBaGVHa2EECBAgQIAAAQIECBAgQIAAAQIECAhAnQMECBAgQIAAAQIECBAgQIAAAQIECFRWQABa2dFaGAECBAgQIECAAAECBAgQIECAAAECAlDnAAECBAgQIECAAAECBAgQIECAAAEClRUQgFZ2tBZGgAABAgQIECBAgAABAgQIECBAgIAA1DlAgAABAgQIECBAgAABAgQIECBAgEBlBQSglR2thREgQIAAAQIECBAgQIAAAQIECBAgIAB1DhAgQIAAAQIECBAgQIAAAQIECBAgUFkBAWhlR2thBAgQIECAAAECBAgQIECAAAECBAgIQJ0DBAgQIECAAAECBAgQIECAAAECBAhUVkAAWtnRWhgBAgQIECBAgAABAgQIECBAgAABAgJQ5wABAgQIECBAgAABAgQIECBAgAABApUVEIBWdrQWRoAAAQIECBAgQIAAAQIECBAgQICAANQ5QIAAAQIECBAgQIAAAQIECBAgQIBAZQUEoJUdrYURIECAAAECBAgQIECAAAECBAgQICAAdQ4QIECAAAECBAgQIECAAAECBAgQIFBZAQFoZUdrYQQIECBAgAABAgQIECBAgAABAgQIdEJAgAABAgQIECBAgAABAu1PYOPGjTF79uzYtm1b+1u8FddUoEOHDjF+/Pg4//zza1pXMQIECNRKoMOe/9tqVUwdAgQIECBAgAABAgQIEDg2BObMmRNf/epXj42DdZRtXuCss86KV199tc0fpwMkQKB9CrgCtH3O3aoJECBAgAABAgQIEGjnArt27coFBg0aFJ/61KfauYblH61AQ0NDPPHEE7H3fDraOr5HgACBlAIC0JS6ahMgQIAAAQIECBAgQKCNCwwYMCAuueSSNn6UDq+tCvznf/5nHoC21eNzXAQIEMgE/AiS84AAAQIECBAgQIAAAQIECBAgQIAAgcoKCEArO1oLI0CAAAECBAgQIECAAAECBAgQIEBAAOocIECAAAECBAgQIECAAAECBAgQIECgsgIC0MqO1sIIECBAgAABAgQIECBAgAABAgQIEBCAOgcIECBAgAABAgQIECBAgAABAgQIEKisgAC0sqO1MAIECBAgQIAAAQIECBAgQIAAAQIEBKDOAQIECBAgQIAAAQIECBAgQIAAAQIEKisgAK3saC2MAAECBAgQIECAAAECBAgQIECAAAEBqHOAAAECBAgQIECAAAECBAgQIECAAIHKCghAKztaCyNAgAABAgQIECBAgAABAgQIECBAQADqHCBAgAABAgQIECBAgAABAgQIECBAoLICAtDKjtbCCBAgQIAAAQIECBAgQIAAAQIECBAQgDoHCBAgQIAAAQIECBAgQIAAAQIECBCorIAAtLKjtTACBAgQIECAAAECBAgQIECAAAECBASgzgECBAgQIECAAAECBAgQIECAAAECBCorIACt7GgtjAABAgQIECBAgAABAgQIECBAgAABAahzgAABAgQIECBAgAABAgQIECBAgACBygoIQCs7WgsjQIAAAQIECBAgQIAAAQIECBAgQEAA6hwgQIAAAQIECBAgQIAAAQIECBAgQKCyAp0qu7JjfGEbNmyIV199NbJ/zzzzzDj77LOjc+fOx/iqHD4BAgQIECBAgAABAgQIECBAgACBYgUEoAV6NzY2xqpVq2Lp0qWxc+fOGDZsWAwfPny/I1i/fn1Mnz49Hnvssfjggw+a3vvIRz4SkyZNirvvvju6d+/etN8TAgQIECBAgAABAgQIECBAgAABAgRaFhCAtmxT03eWLVsWX/ziF+O1117br+64cePi8ccfj5NOOin+4z/+I8aMGRNvvPHGfp/JXmSB6Te/+c344Q9/GE888USMHDnyoM/YQYAAAQIECBAgQIAAAQIECBAgQIDA/gIC0P09krx6+umn47LLLstDzAMbfO9734vPf/7zsXDhwviN3/iNpvDzlFNOic985jPxsz/7s/GTn/wk5s+fn98OX19fH5dffnmsWLEiunbtemA5rwkQIECAAAECBAgQIECAAAECBAgQ2EdAALoPRoqnW7Zsia9+9atN4efo0aPjl37pl/Lb27/73e/G8uXL46WXXoqpU6fG97///fwQss/ffvvtccIJJzQdUkNDQ/zu7/5u/NVf/VUeiM6YMSNmzpzZ9L4nBAgQIECAAAECBAgQIECAAAECBAgcLOBX4A82qemeLMh866238ppf//rXY9GiRTFr1qz4xje+kf8t0GuvvTZ/75577sn/vfTSS+Pee+/dL/zM3sj+7udDDz2U3yKfvc7+FuiePXuypzYCBAgQIECAAAECBAgQIECAAAECBFoQEIC2AFOr3dnVndl2/vnnx0033RQdOnRoKt2pU6e46667YuDAgU377rzzzqbnBz7JvpuFp9n23nvvxbp16w78iNcECBAgQIAAAQIECBAgQIAAAQIECOwjIADdByPF01dffTUve9FFFzVbPvt1989+9rP5e7169cr/5mezH/z/O7Nfju/Y8f+NbW/tQ33eewQIECBAgAABAgQIECBAgAABAgTas4AANPH0N2/enHfo0aNHi526deuWv5f9EvyH2Y477rj8Y9lVoDYCBAgQIECAAAECBAgQIECAAAECBFoWEIC2bFOTd37+538+r7N06dIW67388sv5e2+88UZs27atxc9lbyxYsCB27dqVf+ass8465Ge9SYAAAQIECBAgQIAAAQIECBAgQKC9CwhAE58Be0PKv/zLv4zXXnvtoG7f+c534kc/+lG+v7GxMbLPHWqbN29e/nb290N/7ud+7lAf9R4BAgQIECBAgAABAgQIECBAgACBdi8gAE18Cvz2b/92/jc733///fiFX/iFuO+++/IgNPtxpK997Wtx2WWX5UcwYsSI/N/p06fH/Pnzmz2q7PMPPPBA/t6FF14Y2d8PtREgQIAAAQIECBAgQIAAAQIECBAg0LJAp5bf8k4tBEaNGhVf+cpXYs6cObFp06a49tprDyrbs2fPeP7552Pw4MGxYcOG/EeRfvM3fzPGjh0bp5xySixZsiT+8R//Mb7//e/n3z3++OPjnnvuOaiOHQQIECBAgAABAgQIECBAgAABAgQI7C8gAN3fI8mrP/3TP40TTjgh7rzzztizZ89+PU488cR45plnonfv3nHXXXfFFVdckX/mwQcfjOxx4Jb9Avzs2bPj9NNPP/AtrwkQIECAAAECBAgQIECAAAECBAgQOEBAAHoASIqX2a3qWWg5ceLE+O53vxt7f/Ro+PDh+RWhffv2zdtOmjQptm7dGjfccEPs/fX4fY8nCz2/+c1vxnnnnbfvbs8JECBAgAABAgQIECBAgAABAgQIEGhBQADaAkyK3Z/+9Kcjexxqu/rqq+NXf/VX49FHH83/Vug777wTZ599dgwbNiw+97nPRbdu3Q71de8RIECAAAECBAgQIECAAAECBAgQILCPgAB0H4y28vSjH/1oTJkypa0cjuMgQIAAAQIECBAgQIAAAQIECBAgcMwK+BX4Y3Z0DpwAAQIECBAgQIAAAQIECBAgQIAAgcMJCEAPJ+R9AgQIECBAgAABAgQIECBAgAABAgSOWQG3wB9Do9u1a1ds2LCh6YhPO+20pueeECBAgAABAgQIECBAgAABAgQIECBwsIAA9GCTNrtn+fLlMXLkyKbj27NnT9PzlE/mzp0bf/EXfxGNjY2tbtPQ0BBvvfVWPPbYYzFu3LhW11OAAAECBAgQIECAAAECBAgQIECAwKEEBKCH0vFeLvD000/H/Pnza6qR/cq9ALSmpIoRIECAAAECBAgQIECAAAECBAg0IyAAbQbFrv0FHnroofid3/mdqMUVp3fffXd861vfiuHDh+/fxCsCBAgQIECAAAECBAgQIECAAAECCQQEoAlQU5UcOnRovP3226nKt1j3hBNOiHPPPbfF94/kjSeffPJIPu6zBAgQIECAAAECBAgQIECAAAECBFolIABtFV+xX+7UqVP06dOn2Ka6ESBAgAABAgQIECBAgAABAgQIEDiGBToew8fu0AkQIECAAAECBAgQIECAAAECBAgQIHBIAQHoIXm8SYAAAQIECBAgQIAAAQIECBAgQIDAsSzgFviSp/fWW2/Fu+++G9u2bcsfXbp0iR49ekT37t2jV69ekb22ESBAgAABAgQIECBAgAABAgQIECBwdAIC0KNzO+pvbdmyJR555JGYO3durFy5MrLXLW3Z3/wcPHhwjB49Oi666KIYP358dOjQoaWP20+AAAECBAgQIECAAAECBAgQIECAwAECboE/ACTVyw0bNsTkyZPj1FNPjSlTpsSiRYsOGX5mx7F79+545ZVXYs6cOXkAOmTIkHjuuedSHaK6BAgQIECAAAECBAgQIECAAAECBCon4ArQAka6cePGGDduXKxYsaKpW3Yl58knnxz9+/eP3r17R9euXaOuri4PPXfs2BENDQ2xbt26qK+vj/fffz//XnbF6CWXXBJ33HFHTJ06tamWJwQIECBAgAABAgQIECBAgAABAgQINC8gAG3epWZ7t27dGhMmTGgKP0eNGhXTpk2LsWPH5sHn4Rrt2rUrlixZkt82//DDD0f2+rrrroszzjgjvyX+cN/3PgECBAgQIECAAAECBAgQIECAAIH2LOAW+MTTnzdvXn67e9bm8ssvj8WLF+f/Zld9fpitc+fOce6558b9998fTz31VGSvs+2mm26KxsbGD1PCZwgQIECAAAECBAgQIECAAAECBAi0WwEBaOLRL1y4MO+Q/f3O7MePOnY8evLsR5Bmz56d18tup1+7dm3io1eeAAECBAgQIECAAAECBAgQIECAwLEtcPRp3LG97sKOfsGCBXmviy++uOnqzdY0nzhxYtPXV61a1fTcEwIECBAgQIAAAQIECBAgQIAAAQIEDhYQgB5sUtM969evz+v169evJnV79erVFKRu3769JjUVIUCAAAECBAgQIECAAAECBAgQIFBVAQFo4skOHDgw77Bo0aKadMpuqc9+CCnbhg8fXpOaihAgQIAAAQIECBAgQIAAAQIECBCoqoAANPFkR4wYkXd4/PHH48UXX2xVt02bNsX111+f1+jZs2cMGDCgVfV8mQABAgQIECBAgAABAgQIECBAgEDVBQSgiSd8880357es79ixIy699NL819x37tx5xF2XLVsWF1xwQWT/Zts111xzxDV8gQABAgQIECBAgAABAgQIECBAgEB7E+jU3hZc9HqzW+BnzZoVN954Y2zevDkPLrPnY8aMiWHDhuVXcfbp0ye6du0aXbp0id27d0cWljY0NMS6detizZo1MX/+/Fi5cmXToWdB6K233tr02hMCBAgQIECAAAECBAgQIECAAAECBJoXEIA271LTvTfccENkP140efLkyH64aMuWLfHss8/mjyNtdOGFF8bcuXOjY0cX7x6pnc8TIECAAAECBAgQIECAAAECBAi0PwEpWkEzv+qqq6K+vj6mT58effv2PaKudXV1+e3zzzzzTDz//POR/f1PGwECBAgQIECAAAECBAgQIECAAAEChxdwBejhjWr2id69e8fMmTPzx5tvvhmLFy+O1atX57e7Z7fHZ1eGdu7cObp16xbdu3eP7Pb5QYMGxdChQ/N9NTsQhQgQIECAAAECBAgQIECAAAECBAi0EwEBaEmDPv300yN72AgQIECAAAECBAgQIECAAAECBAgQSCfgFvh0tioTIECAAAECBAgQIECAAAECBAgQIFCygAC05AFoT4AAAQIECBAgQIAAAQIECBAgQIBAOgEBaDpblQkQIECAAAECBAgQIECAAAECBAgQKFlAAFryALQnQIAAAQIECBAgQIAAAQIECBAgQCCdgAA0na3KBAgQIECAAAECBAgQIECAAAECBAiULCAALXkA2hMgQIAAAQIECBAgQIAAAQIECBAgkE5AAJrOVmUCBAgQIECAAAECBAgQIECAAAECBEoWEICWPADtCRAgQIAAAQIECBAgQIAAAQIECBBIJyAATWerMgECBAgQIECAAAECBAgQIECAAAECJQsIQEsegPYECBAgQIAAAQIECBAgQIAAAQIECKQTEICms1WZAAECBAgQIECAAAECBAgQIECAAIGSBQSgJQ9AewIECBAgQIAAAQIECBAgQIAAAQIE0gkIQNPZqkyAAAECBAgQIECAAAECBAgQIECAQMkCAtCSB6A9AQIECBAgQIAAAQIECBAgQIAAAQLpBASg6WxVJkCAAAECBAgQIECAAAECBAgQIECgZAEBaMkD0J4AAQIECBAgQIAAAQIECBAgQIAAgXQCAtB0tioTIECAAAECBAgQIECAAAECBAgQIFCygAC05AFoT4AAAQIECBAgQIAAAQIECBAgQIBAOgEBaDpblQkQIECAAAECBAgQIECAAAECBAgQKFlAAFryALQnQIAAAQIECBAgQIAAAQIECBAgQCCdgAA0na3KBAgQIECAAAECBAgQIECAAAECBAiULCAALXkA2hMgQIAAAQIECBAgQIAAAQIECBAgkE5AAJrOVmUCBAgQIECAAAECBAgQIECAAAECBEoWEICWPADtCRAgQIAAAQIECBAgQIAAAQIECBBIJyAATWerMgECBAgQIECAAAECBAgQIECAAAECJQsIQEsegPYECBAgQIAAAQIECBAgQIAAAQIECKQTEICms1WZAAECBAgQIECAAAECBAgQIECAAIGSBQSgJQ9AewIECBAgQIAAAQIECBAgQIAAAQIE0gkIQNPZqkyAAAECBAgQIECAAAECBAgQIECAQMkCAtCSB6A9AQIECBAgQIAAAQIECBAgQIAAAQLpBASg6WxVJkCAAAECBAgQIECAAAECBAgQIECgZIFOJffXnkCbE2hsbIyVK1fG7t2729yxOaBjS+C4446LQYMGRefOnY+tA3e0BAgQIECAAAECBAgQIECgQgIC0AoN01JqIzBz5sz4gz/4g9oUU6XdC0yZMiXuueeedu8AgAABAgQIECBAgAABAgQIlCUgAC1LXt82K7B+/fr82D72sY9F9+7d2+xxOrC2LbB169bYsGFD7D2f2vbROjoCBAgQIECAAAECBAgQIFBdAQFodWdrZa0UuOyyy+KXf/mXW1nF19urwOLFi+O2225rr8u3bgIECBAgQIAAAQIECBAg0GYE/AhSmxmFAyFAgAABAgQIECBAgAABAgQIECBAoNYCrgCttah6BAgQIECAwFEJrFmzJnbu3HlU3/UlAnsFOnToEJ/4xCf8AN1eEP8SIECAAAECBAiEANRJQIAAAQIECJQu8MADD8Rv/dZvlX4cDqAaApMmTYrHHnusGouxCgIECBAgQIAAgVYLCEBbTagAAQIECBAg0FqB+vr6vESPHj3ixBNPbG0532+nAtkVxP/1X/8Ve8+nohhmzJgRL774YlHt9KmwwEknnRRz5syJnj17VniVlkaAAAECBIoXEIAWb64jAQIECBAg0ILAhAkT4gtf+EIL79pN4NACr732Wtx8882H/lCCd2fNmhXbt29PUFnJ9ihw5ZVXxiWXXNIel27NBAgQIEAgmYAANBmtwgQIECBAgAABAu1BoLGxMV/mLbfcEp06+d/r9jDzFGv8m7/5m3j99ddj7/mUooeaBAgQIECgvQr4P7T2OnnrJkCAAAECBAgQqKnAkCFD/PhSTUXbV7G///u/b18LtloCBAgQIFCgQMcCe2lFgAABAgQIECBAgAABAgQIECBAgACBQgUEoIVya0aAAAECBAgQIECAAAECBAgQIECAQJECAtAitfUiQIAAAQIECBAgQIAAAQIECBAgQKBQAQFoodyaESBAgAABAgQIECBAgAABAgQIECBQpIAAtEhtvQgQIECAAAECBAgQIECAAAECBAgQKFRAAFoot2YECBAgQIAAAQIECBAgQIAAAQIECBQpIAAtUlsvAgQIECBAgAABAgQIECBAgAABAgQKFRCAFsqtGQECBAgQIECAAAECBAgQIECAAAECRQoIQIvU1osAAQIECBAgQIAAAQIECBAgQIAAgUIFBKCFcmtGgAABAgQIECBAgAABAgQIECBAgECRAgLQIrX1IkCAAAECBAgQIECAAAECBAgQIECgUAEBaKHcmhEgQIAAAQIECBAgQIAAAQIECBAgUKSAALRIbb0IECBAgAABAgQIECBAgAABAgQIEChUQABaKLdmBAgQIECAAAECBAgQIECAAAECBAgUKSAALVJbLwIECBAgQIAAAQIECBAgQIAAAQIEChUQgBbKrRkBAgQIECBAgAABAgQIECBAgAABAkUKCECL1NaLAAECBAgQIECAAAECBAgQIECAAIFCBQSghXJrRoAAAQIECBAgQIAAAQIECBAgQIBAkQIC0CK19SJAgAABAgQIECBAgAABAgQIECBAoFABAWih3JoRIECAAAECBAgQIECAAAECBAgQIFCkgAC0SG29CBAgQIAAAQIECBAgQIAAAQIECBAoVEAAWii3ZgQIECBAgAABAgQIECBAgAABAgQIFCkgAC1SWy8CBAgQIECAAAECBAgQIECAAAECBAoVEIAWyq0ZAQIECBAgQIAAAQIECBAgQIAAAQJFCghAi9TWiwABAgQIECBAgAABAgQIECBAgACBQgUEoIVya0aAAAECBAgQIECAAAECBAgQIECAQJECAtAitfUiQIAAAQIECBAgQIAAAQIECBAgQKBQAQFoodyaESBAgAABAgQIECBAgAABAgQIECBQpIAAtEhtvQgQIECAAAECBAgQIECAAAECBAgQKFRAAFoot2YECBAgQIAAAQIECBAgQIAAAQIECBQpIAAtUlsvAgQIECBAgAABAgQIECBAgAABAgQKFRCAFsqtGQECBAgQIECAAAECBAgQIECAAAECRQoIQIvU1osAAQIECBAgQIAAAQIECBAgQIAAgUIFBKCFcmtGgAABAgQIECBAgAABAgQIECBAgECRAgLQIrX1IkCAAAECBAgQIECAAAECBAgQIECgUAEBaKHcmhEgQIAAAQIECBAgQIAAAQIECBAgUKSAALRIbb0IECBAgAABAgQIECBAgAABAgQIEChUQABaKLdmBAgQIECAAAECBAgQIECAAAECBAgUKSAALVJbLwIECBAgQIAAAQIECBAgQIAAAQIEChUQgBbKrRkBAgQIECBAgAABAgQIECBAgAABAkUKCECL1NaLAAECBAgQIECAAAECBAgQIECAAIFCBQSghXJrRoAAAQIECBAgQIAAAQIECBAgQIBAkQKdimymFwECBAikFbjsssvixz/+cdomqrcLgZNPPjmefvrp6NGjR7tYr0USIECAAAECBAgQIFBdAQFodWdrZQQItDOBhoaGeOKJJ9rZqi03lcDq1avj1VdfjU9/+tOpWqhLgAABAgQIECBAgACBQgQEoIUwa0KAAIHiBLp06RJ33nlncQ11qpzA7bffHmvXro09e/ZUbm0WRIAAAQIECBAgQIBA+xMQgLa/mVsxAQIVF+jQoUOccsopFV+l5aUUqKurS1lebQIECBAgQIAAAQIECBQq4EeQCuXWjAABAgQIECBAgAABAgQIECBAgACBIgUEoEVq60WAAAECBAgQIECAAAECBAgQIECAQKECAtBCuTUjQIAAAQIECBAgQIAAAQIECBAgQKBIAQFokdp6ESBAgAABAgQIECBAgAABAgQIECBQqIAAtFBuzQgQIECAAAECBAgQIECAAAECBAgQKFJAAFqktl4ECBAgQIAAAQIECBAgQIAAAQIECBQqIAAtlFszAgQIECBAgAABAgQIECBAgAABAgSKFBCAFqmtFwECBAgQIECAAAECBAgQIECAAAEChQp0KrSbZh9K4IMPPoif/OQnsWbNmjjppJNiwIAB0bdv3w/1XR8iQIAAAQIECBAgQIAAAQIECBAgQOCnAgLQn1okf/bCCy/EU089Fdu2bYsHHnjgoH4rVqyIqVOnxoIFC+L999/f7/1PfvKTcfXVV8eXv/zl6NjRhbv74XhBgAABAgQIECBAgAABAgQIECBAoAUBSVoLMLXcvWPHjvjKV74SY8eOjXvuuSf+5V/+5aDyt9xyS5xzzjmRhaQHhp/Zh5csWZLXGDNmTKxfv/6g79tBgAABAgQIECBAgAABAgQIECBAgMDBAq4APdik5nuuuOKK+Pa3v91Ut6Ghoel59iS7GnTGjBlN+z72sY/FsGHD4hOf+ERs3LgxVq9eHcuWLYvGxsb453/+55gwYUIsXLgwTjjhhKbveEKAAAECBAgQIECAAAECBAgQIECAwMECrgA92KSme37wgx80hZ+nnHJK/PVf/3Vkt7rv3bK/85nd9p5txx13XHzta1+L+vr6+N73vhf33Xdf/O3f/m0sXbo0f3zmM5/JP7d8+fL4wz/8w/y5/xAgQIAAAQIECBAgQIAAAQIECBAg0LKAALRlm5q8c++99+Z1jj/++MjC0CuvvHK/Kze/9a1vxdatW/PPZLfB33rrrZF99sAtuyI0C0Wzf7PtwQcfzP+W6IGf85oAAQIECBAgQIAAAQIECBAgQIAAgZ8KCEB/apHk2euvv57XzX7A6MwzzzyoR3Z1Z7Zlt71nV38eauvSpUvcfffd+Uc2bdoU2ZWgNgIECBAgQIAAAQIECBAgQIAAAQIEWhYQgLZsU5N3stvZs2348OHN1lu7dm2+f8SIEfkt8M1+aJ+d2a/Bd+7cOd+zt/Y+b3tKgAABAgQIECBAgAABAgQIECBAgMA+AgLQfTBSPM1+yCjb9v27n/v2GTly5L4vD/v8f/7nf2LXrl355z7+8Y8f9vM+QIAAAQIECBAgQIAAAQIECBAgQKA9CwhAE09/b8D5d3/3d812Ou+88/L9L7/8cnzwwQfNfmbfnc8++2z+skOHDnHOOefs+5bnBAgQIECAAAECBAgQIECAAAECBAgcICAAPQCk1i+zW9azLbvV/fbbbz+o/NixY6NHjx7x3//933Hbbbcd9P6+O/793/897rrrrnxXdmVp9j0bAQIECBAgQIAAAQIECBAgQIAAAQItCwhAW7apyTtf+tKXYtSoUXmt3/u934spU6bEO++801S7b9++kV3V2bVr1/ijP/qjuPPOO5u9EvSll16KLEz9t3/7t/y7v//7v99UwxMCBAgQIECAAAECBAgQIECAAAECBJoXEIA271KzvXV1dfHkk0/mv/KeFf3zP//zGDhwYPz6r/96PPzww/HKK69E//798+d79uyJ66+/Ps4+++z48pe/HDNmzIgrr7wy//ynPvWp2LBhQ35cWaiavW8jQIAAAQIECBAgQIAAAQIECBAgQODQAp0O/bZ3ayHQr1+//CrPLPRcvXp1bN68OR599NH80Vz97CrPvVd6Hvh+9jdD77333gN3e02AAAECBAgQIECAAAECBAgQIECAQDMCrgBtBiXFrtGjR+e/BH/HHXfE0KFDj7jFWWedFffdd1/88Ic/jOOPP/6Iv+8LBAgQIECAAAECBAgQIECAAAECBNqjgCtAC5x6djv8tGnT8seqVati6dKlsXLlynjjjTeioaEh3nvvvdi5c2eccMIJceKJJ8Zpp50WgwcPjiw8PZrQtMClaUWAAAECBAgQIECAAAECBAgQIECgTQoIQEsayxlnnBHZw0aAAAECBAgQIECAAAECBAgQIECAQDoBt8Cns1WZAAECBAgQIECAAAECBAgQIECAAIGSBQSgJQ9AewIECBAgQIAAAQIECBAgQIAAAQIE0gm4BT6dbc0r79q1KzZs2NBUN/sboUVsmzZtipdeein27NnT6nZvvvlmXqMWtVp9MAoQIECAAAECBAgQIECAAAECBAhUXkAAegyNePny5TFy5MimIy4qRLz66qvjySefbOpbiycvv/xyLcqoQYAAAQIECBAgQIAAAQIECBAgQOCQAgLQQ/J4MxOYNGlSbN++PRobG1sN8tprr0V9fX0MGDCg1bUUIECAAAECBAgQIECAAAECBAgQIHA4AQHo4YS8HxMnTswftaC47rrr4k/+5E+iZ8+etSinBgECBAgQIECAAAECBAgQIECAAIFDCghAD8nTtt4cOnRovP32223roBwNAQIECBAgQIAAAQIECBAgQIAAgTYsIABtw8M58NA6deoUffr0OXC31wQIECBAgAABAgQIECBAgAABAgQItCDQsYX9dhMgQIAAAQIECBAgQIAAAQIECBAgQOCYF3AFaMkjfOutt+Ldd9+Nbdu25Y8uXbpEjx49onv37tGrV6/IXtsIECBAgAABAgQIECBAgAABAgQIEDg6AQHo0bkd9be2bNkSjzzySMydOzdWrlwZ2euWtuyW98GDB8fo0aPjoosuivHjx0eHDh1a+rj9BAgQIECAAAECBAgQIECAAAECBAgcIOAW+ANAUr3csGFDTJ48OU499dSYMmVKLFq06JDhZ3Ycu3fvjldeeSXmzJmTB6BDhgyJ5557LtUhqkuAAAECBAgQIECAAAECBAgQIECgcgKuAC1gpBs3boxx48bFihUrmrplV3KefPLJ0b9//+jdu3d07do16urq8tBzx44d0dDQEOvWrYv6+vp4//338+9lV4xecsklcccdd8TUqVObanlCgAABAgQIECBAgAABAgQIECBAgEDzAgLQ5l1qtnfr1q0xYcKEpvBz1KhRMW3atBg7dmwefB6u0a5du2LJkiX5bfMPP/xwZK+vu+66OOOMM/Jb4g/3fe8TIECAAAECBAgQIECAAAECBAgQaM8CboFPPP158+blt7tnbS6//PJYvHhx/m921eeH2Tp37hznnntu3H///fHUU09F9jrbbrrppmhsbPwwJXyGAAECBAgQIECAAAECBAgQIECAQLsVEIAmHv3ChQvzDtnf78x+/Khjx6Mnz34Eafbs2Xm97Hb6tWvXJj565QkQIECAAAECBAgQIECAAAECBAgc2wJHn8Yd2+su7OgXLFiQ97r44oubrt5sTfOJEyc2fX3VqlVNzz0hQIAAAQIECBAgQIAAAQIECBAgQOBgAQHowSY13bN+/fq8Xr9+/WpSt1evXk1B6vbt22tSUxECBAgQIECAAAECBAgQIECAAAECVRUQgCae7MCBA/MOixYtqkmn7Jb67IeQsm348OE1qakIAQIECBAgQIAAAQIECBAgQIAAgaoKCEATT3bEiBF5h8cffzxefPHFVnXbtGlTXH/99XmNnj17xoABA1pVz5cJECBAgAABAgQIECBAgAABAgQIVF1AAJp4wjfffHN+y/qOHTvi0ksvzX/NfefOnUfcddmyZXHBBRdE9m+2XXPNNUdcwxcIECBAgAABAgQIECBAgAABAgQItDeBTu1twUWvN7sFftasWXHjjTfG5s2b8+Ayez5mzJgYNmxYfhVnnz59omvXrtGlS5fYvXt3ZGFpQ0NDrFu3LtasWRPz58+PlStXNh16FoTeeuutTa89IUCAAAECBAgQIECAAAECBAgQIECgeQEBaPMuNd17ww03RPbjRZMnT47sh4u2bNkSzz77bP440kYXXnhhzJ07Nzp2dPHukdr5PAECBAgQIECAAAECBAgQIECAQPsTkKIVNPOrrroq6uvrY/r06dG3b98j6lpXV5ffPv/MM8/E888/H9nf/7QRIECAAAECBAgQIECAAAECBAgQIHB4AVeAHt6oZp/o3bt3zJw5M3+8+eabsXjx4li9enV+u3t2e3x2ZWjnzp2jW7du0b1798hunx80aFAMHTo031ezA1GIAAECBAgQIECAAAECBAgQIECAQDsREICWNOjTTz89soeNAAECBAgQIECAAAECBAgQIECAAIF0Am6BT2erMgECBAgQIECAAAECBAgQIECAAAECJQsIQEsegPYECBAgQIAAAQIECBAgQIAAAQIECKQTEICms1WZAAECBAgQIECAAAECBAgQIECAAIGSBQSgJQ9AewIECBAgQIAAAQIECBAgQIAAAQIE0gkIQNPZqkyAAAECBAgQIECAAAECBAgQIECAQMkCAtCSB6A9AQIECBAgQIAAAQIECBAgQIAAAQLpBASg6WxVJkCAAAECBAgQIECAAAECBAgQIECgZAEBaMkD0J4AAQIECBAgQIAAAQIECBAgQIAAgXQCAtB0tioTIECAAAECBAgQIECAAAECBAgQIFCygAC05AFoT4AAAQIECBAgQIAAAQIECBAgQIBAOgEBaDpblQkQIECAAAECBAgQIECAAAECBAgQKFlAAFryALQnQIAAAQIECBAgQIAAAQIECBAgQCCdgAA0na3KBAgQIECAAAECBAgQIECAAAECBAiULCAALXkA2hMgQIAAAQIECBAgQIAAAQIECBAgkE5AAJrOVmUCBAgQIECAAAECBAgQIECAAAECBEoWEICWPADtCRAgQIAAAQIECBAgQIAAAQIECBBIJyAATWerMgECBAgQIECAAAECBAgQIECAAAECJQsIQEsegPYECBAgQIAAAQIECBAgQIAAAQIECKQTEICms1WZAAECBAgQIECAAAECBAgQIECAAIGSBQSgJQ9AewIECBAgQIAAAQIECBAgQIAAAQIE0gkIQNPZqkyAAAECBAgQIECAAAECBAgQIECAQMkCAtCSB6A9AQIECBAgQIAAAQIECBAgQIAAAQLpBASg6WxVJkCAAAECBAgQIECAAAECBAgQIECgZAEBaMkD0J4AAQIECBAgQIAAAQIECBAgQIAAgXQCAtB0tioTIECAAAECBAgQIECAAAECBAgQIFCygAC05AFoT4AAAQIECBAgQIAAAQIECBAgQIBAOgEBaDpblQkQIECAAAECBAgQIECAAAECBAgQKFlAAFryALQnQIAAAQIECBAgQIAAAQIECBAgQCCdgAA0na3KBAgQIECAAAECBAgQIECAAAECBAiULCAALXkA2hMgQIAAAQIECBAgQIAAAQIECBAgkE5AAJrOVmUCBAgQIECAAAECBAgQIECAAAECBEoWEICWPADtCRAgQIAAAQIECBAgQIAAAQIECBBIJyAATWerMgECBAgQIECAAAECBAgQIECAAAECJQsIQEsegPYECBAgQIAAAQIECBAgQIAAAQIECKQTEICms1WZAAECBAgQIECAAAECBAgQIECAAIGSBQSgJQ9AewIECBAgQIAAAQIECBAgQIAAAQIE0gkIQNPZqkyAAAECBAgQIECAAAECBAgQIECAQMkCAtCSB6A9AQIECBAgQIAAAQIECBAgQIAAAQLpBASg6WxVJkCAAAECBAgQIECAAAECBAgQIECgZAEBaMkD0J4AAQIECBAgQIAAAQIECBAgQIAAgXQCAtB0tioTIECAAAECBAgQIECAAAECBAgQIFCygAC05AFoT4AAAQIECBAgQIAAAQIECBAgQIBAOgEBaDpblQkQIECAAAECBAgQIECAAAECBAgQKFlAAFryALQnQIAAAQIECBAgQIAAAQIECBAgQCCdgAA0na3KBAgQIECAAAECBAgQIECAAAECBAiULCAALXkA2hMgQIAAAQIECBAgQIAAAQIECBAgkE5AAJrOVmUCBAgQIECAAAECBAgQIECAAAECBEoWEICWPADtCRAgQIAAAQIECBAgQIAAAQIECBBIJyAATWerMgECBAgQIECAAAECBAgQIECAAAECJQsIQEsegPYECBAgQIAAAQIECBAgQIAAAQIECKQTEICms1WZAAECBAgQIECAAAECBAgQIECAAIGSBQSgJQ9AewIECBAgQIAAAQIECBAgQIAAAQIE0gkIQNPZqkyAAAECBAgQIECAAAECBAgQIECAQMkCAtCSB6A9AQIECBAgQIAAAQIECBAgQIAAAQLpBASg6WxVJkCAAAECBAgQIECAAAECBAgQIECgZAEBaMkD0J4AAQIECBAgQIAAAQIECBAgQIAAgXQCAtB0tioTIECAAAECBAgQIECAAAECBAgQIFCygAC05AFoT4AAAQIECBAgQIAAAQIECBAgQIBAOgEBaDpblQkQIECAAAECBAgQIECAAAECBAgQKFlAAFryALQnQIAAAQIECBAgQIAAAQIECBAgQCCdgAA0na3KBAgQIECAAAECBAgQIECAAAECBAiULCAALXkA2hMgQIAAAQIECBAgQIAAAQIECBAgkE5AAJrOVmUCBAgQIECAAAECBAgQIECAAAECBEoWEICWPADtCRAgQIAAAQIECBAgQIAAAQIECBBIJyAATWerMgECBAgQIECAAAECBAgQIECAAAECJQsIQEsegPYECBAgQIAAAQIECBAgQIAAAQIECKQTEICms1WZAAECBAgQIECAAAECBAgQIECAAIGSBQSgJQ9AewIECBAgQIAAAQIECBAgQIAAAQIE0gkIQNPZqkyAAAECBAgQIECAAAECBAgQIECAQMkCAtCSB6A9AQIECBAgQIAAAQIECBAgQIAAAQLpBASg6WxVJkCAAAECBAgQIECAAAECBAgQIECgZAEBaMkD0J4AAQIECBAgQIAAAQIECBAgQIAAgXQCAtB0tioTIECAAAECBAgQIECAAAECBAgQIFCygAC05AFoT4AAAQIECBAgQIAAAQIECBAgQIBAOgEBaDpblQkQIECAAAECBAgQIECAAAECBAgQKFlAAFryALQnQIAAAQIECBAgQIAAAQIECBAgQCCdgAA0na3KBAgQIECAAAECBAgQIECAAAECBAiULCAALXkA2hMgQIAAAQIECBAgQIAAAQIECBAgkE5AAJrOVmUCBAgQIECAAAECBAgQIECAAAECBEoWEICWPADtCRAgQIAAAQIECBAgQIAAAQIECBBIJyAATbBiFloAAEAASURBVGerMgECBAgQIECAAAECBAgQIECAAAECJQt0Krm/9gQIECBAgAABAgQIECBAgACBIxJYunRpvPjii0f0HR8m0JxAt27d4ktf+lLU1dU197Z9FREQgFZkkJZBgAABAgQIECBAgAABAgTai8AXv/jFWLVqVXtZrnUmFjj++OPjyiuvTNxF+TIFBKBl6utNgAABAgQIECBAgAABAgQIHLHA9u3b8++MGzcuunbtesTf9wUCmcCPf/zjqK+vj23btgGpuIAAtOIDtjwCBAgQIECAAAECBAgQIFBVgS984QvRu3fvqi7PuhIL3HvvvXkAmriN8m1AwI8gtYEhOAQCBAgQIECAAAECBAgQIECAAAECBNIICEDTuKpKgAABAgQIECBAgAABAgQIECBAgEAbEBCAtoEhOAQCBAgQIECAAAECBAgQIECAAAECBNIICEDTuKpKgAABAgQIECBAgAABAgQIECBAgEAbEBCAtoEhOAQCBAgQIECAAAECBAgQIECAAAECBNIICEDTuKpKgAABAgQIECBAgAABAgQIECBAgEAbEBCAtoEhOAQCBAgQIECAAAECBAgQIECAAAECBNIICEDTuKpKgAABAgQIECBAgAABAgQIECBAgEAbEBCAtoEhOAQCBAgQIECAAAECBAgQIECAAAECBNIICEDTuKpKgAABAgQIECBAgAABAgQIECBAgEAbEBCAtoEhOAQCBAgQIECAAAECBAgQIECAAAECBNIIdEpTVtXWCnzwwQfxox/9KC/zMz/zMzFgwIDWlvR9AgQIECBAgAABAgQIECBAgAABAu1OwBWgbXTk7733Xnzuc5/LHw8++GAbPUqHRYAAAQIECBAgQIAAAQIECBAgQKBtCwhA2/Z8HB0BAgQIECBAgAABAgQIECBAgAABAq0QcAt8K/A+zFfXrFkTu3fv/jAf3e8zW7ZsaXr9zjvvxOuvv970eu+TM888c+9T/xIgQIAAAQIECBAgQIAAAQIECBAg0IyAALQZlFru+sVf/MV4++23W1Vyzpw5kT0O3Pbs2XPgLq8JECBAgAABAgQIECBAgAABAgQIENhHwC3w+2B4SoAAAQIECBAgQIAAAQIECBAgQIBAtQRcAZp4nrfccktcf/31sWPHjrzTiSeeGOPHj48OHTocsvPOnTvj29/+dv6ZQYMGxZAhQw75eW8SIECAAAECBAgQIECAAAECBAgQIHCwgAD0YJOa7rn22mvjs5/9bFxxxRWxbNmyyP6256ZNm+Khhx6KU045pcVemzdvbgpAf+VXfiVmzJjR4me9QYAAAQIECBAgQIAAAQIECBAgQIBA8wJugW/epaZ7sys4X3rppbjxxhujY8eO8Q//8A8xePDgmDdvXk37KEaAAAECBAgQIECAAAECBAgQIECAwP4CAtD9PZK9+shHPhJ//Md/HD/4wQ+iX79+8e6778av/dqvxZVXXhnZ1Z42AgQIECBAgAABAgQIECBAgAABAgRqLyAArb3pIStmt8MvX748Jk2alH9u7ty5+dWgL7zwwiG/500CBAgQIECAAAECBAgQIECAAAECBI5cQAB65Gat/sZHP/rReOyxx+LRRx+NHj16xLp16+L888+PadOmNf1YUqubKECAAAECBAgQIECAAAECBAgQIECAQAhASzwJsh9Gyq4GPe+882LPnj1x1113xciRI+OVV14p8ai0JkCAAAECBAgQIECAAAECBAgQIFAdAQFoybPs379//NM//VN8/etfj86dO8e//uu/xujRo+O2224r+ci0J0CAAAECBAgQIECAAAECBAgQIHDsCwhA28AMs1+Gv+mmm2Lx4sVx5plnxq5duwSgbWAuDoEAAQIECBAgQIAAAQIECBAgQODYFxCAtqEZnnPOOfHyyy/H5MmT29BRORQCBAgQIECAAAECBAgQIECAAAECx65Ap2P30Kt55F27do0/+7M/iwkTJsR3vvOdfJGf/OQnq7lYqyJAgAABAgQIECBAgAABAgQIECCQWEAAmhj4aMt//vOfj+xhI0CAAAECBAgQIECAAAECBAgQIEDg6AXcAn/0dr5JgAABAgQIECBAgAABAgQIECBAgEAbF3AFaBsf0L6Hl/040oYNG5p2nXbaaU3PPSFAgAABAgQIECBAgAABAgQIECBA4GABAejBJm12z/Lly2PkyJFNx7dnz56m5ymfPPjgg3HfffdFY2Njq9usX78+r7FvkNvqogoQIECAAAECBAgQIECAAAECBAgQaEFAANoCjN0/FXjhhRdi6dKlP91Rg2dvv/12DaooQYAAAQIECBAgQIAAAQIECBAgQODQAgLQQ/t49/8EHnroobjxxhujFleczp49Ox577LEYOnQoWwIECBAgQIAAAQIECBAgQIAAAQLJBQSgyYlr1yALDcu4crKuri6GDRtWk4V8/OMfr0kdRQgQIECAAAECBAgQIECAAAECBAh8GAEB6IdRaiOf6dSpU/Tp06eNHI3DIECAAAECBAgQIECAAAECBAgQIND2BTq2/UN0hAQIECBAgAABAgQIECBAgAABAgQIEDg6AQHo0bn5FgECBAgQIECAAAECBAgQIECAAAECx4CAW+BLHtJbb70V7777bmzbti1/dOnSJXr06BHdu3ePXr16RfbaRoAAAQIECBAgQIAAAQIECBAgQIDA0QkIQI/O7ai/tWXLlnjkkUdi7ty5sXLlyshet7Rlf/Nz8ODBMXr06Ljoooti/Pjx0aFDh5Y+bj8BAgQIECBAgAABAgQIECBAgAABAgcIuAX+AJBULzds2BCTJ0+OU089NaZMmRKLFi06ZPiZHcfu3bvjlVdeiTlz5uQB6JAhQ+K5555LdYjqEiBAgAABAgQIECBAgAABAgQIEKicgCtACxjpxo0bY9y4cbFixYqmbtmVnCeffHL0798/evfuHV27do26uro89NyxY0c0NDTEunXror6+Pt5///38e9kVo5dccknccccdMXXq1KZanhAgQIAAAQIECBAgQIAAAQIECBAg0LyAALR5l5rt3bp1a0yYMKEp/Bw1alRMmzYtxo4dmwefh2u0a9euWLJkSX7b/MMPPxzZ6+uuuy7OOOOM/Jb4w33f+wQIECBAgAABAgQIECBAgAABAgTas4Bb4BNPf968efnt7lmbyy+/PBYvXpz/m131+WG2zp07x7nnnhv3339/PPXUU5G9zrabbropGhsbP0wJnyFAgAABAgQIECBAgAABAgQIECDQbgUEoIlHv3DhwrxD9vc7sx8/6tjx6MmzH0GaPXt2Xi+7nX7t2rWJj155AgQIECBAgAABAgQIECBAgAABAse2wNGnccf2ugs7+gULFuS9Lr744qarN1vTfOLEiU1fX7VqVdNzTwgQIECAAAECBAgQIECAAAECBAgQOFhAAHqwSU33rF+/Pq/Xr1+/mtTt1atXU5C6ffv2mtRUhAABAgQIECBAgAABAgQIECBAgEBVBQSgiSc7cODAvMOiRYtq0im7pT77IaRsGz58eE1qKkKAAAECBAgQIECAAAECBAgQIECgqgIC0MSTHTFiRN7h8ccfjxdffLFV3TZt2hTXX399XqNnz54xYMCAVtXzZQIECBAgQIAAAQIECBAgQIAAAQJVFxCAJp7wzTffnN+yvmPHjrj00kvzX3PfuXPnEXddtmxZXHDBBZH9m23XXHPNEdfwBQIECBAgQIAAAQIECBAgQIAAAQLtTaBTe1tw0evNboGfNWtW3HjjjbF58+Y8uMyejxkzJoYNG5ZfxdmnT5/o2rVrdOnSJXbv3h1ZWNrQ0BDr1q2LNWvWxPz582PlypVNh54FobfeemvTa08IECBAgAABAgQIECBAgAABAgQIEGheQADavEtN995www2R/XjR5MmTI/vhoi1btsSzzz6bP4600YUXXhhz586Njh1dvHukdj5PgAABAgQIECBAgAABAgQIECDQ/gSkaAXN/Kqrror6+vqYPn169O3b94i61tXV5bfPP/PMM/H8889H9vc/bQQIECBAgAABAgQIECBAgAABAgQIHF7AFaCHN6rZJ3r37h0zZ87MH2+++WYsXrw4Vq9end/unt0en10Z2rlz5+jWrVt07949stvnBw0aFEOHDs331exAFCJAgAABAgQIECBAgAABAgQIECDQTgQEoCUN+vTTT4/sYSNAgAABAgQIECBAgAABAgQIECBAIJ2AW+DT2apMgAABAgQIECBAgAABAgQIECBAgEDJAgLQkgegPQECBAgQIECAAAECBAgQIECAAAEC6QQEoOlsVSZAgAABAgQIECBAgAABAgQIECBAoGQBAWjJA9CeAAECBAgQIECAAAECBAgQIECAAIF0AgLQdLYqEyBAgAABAgQIECBAgAABAgQIECBQsoAAtOQBaE+AAAECBAgQIECAAAECBAgQIECAQDoBAWg6W5UJECBAgAABAgQIECBAgAABAgQIEChZQABa8gC0J0CAAAECBAgQIECAAAECBAgQIEAgnYAANJ2tygQIECBAgAABAgQIECBAgAABAgQIlCwgAC15ANoTIECAAAECBAgQIECAAAECBAgQIJBOQACazlZlAgQIECBAgAABAgQIECBAgAABAgRKFhCAljwA7QkQIECAAAECBAgQIECAAAECBAgQSCcgAE1nqzIBAgQIECBAgAABAgQIECBAgAABAiULCEBLHoD2BAgQIECAAAECBAgQIECAAAECBAikExCAprNVmQABAgQIECBAgAABAgQIECBAgACBkgUEoCUPQHsCBAgQIECAAAECBAgQIECAAAECBNIJCEDT2apMgAABAgQIECBAgAABAgQIECBAgEDJAgLQkgegPQECBAgQIECAAAECBAgQIECAAAEC6QQEoOlsVSZAgAABAgQIECBAgAABAgQIECBAoGQBAWjJA9CeAAECBAgQIECAAAECBAgQIECAAIF0AgLQdLYqEyBAgAABAgQIECBAgAABAgQIECBQsoAAtOQBaE+AAAECBAgQIECAAAECBAgQIECAQDoBAWg6W5UJECBAgAABAgQIECBAgAABAgQIEChZQABa8gC0J0CAAAECBAgQIECAAAECBAgQIEAgnYAANJ2tygQIECBAgAABAgQIECBAgAABAgQIlCwgAC15ANoTIECAAAECBAgQIECAAAECBAgQIJBOQACazlZlAgQIECBAgAABAgQIECBAgAABAgRKFhCAljwA7QkQIECAAAECBAgQIECAAAECBAgQSCcgAE1nqzIBAgQIECBAgAABAgQIECBAgAABAiULCEBLHoD2BAgQIECAAAECBAgQIECAAAECBAikExCAprNVmQABAgQIECBAgAABAgQIECBAgACBkgUEoCUPQHsCBAgQIECAAAECBAgQIECAAAECBNIJCEDT2apMgAABAgQIECBAgAABAgQIECBAgEDJAgLQkgegPQECBAgQIECAAAECBAgQIECAAAEC6QQEoOlsVSZAgAABAgQIECBAgAABAgQIECBAoGQBAWjJA9CeAAECBAgQIECAAAECBAgQIECAAIF0AgLQdLYqEyBAgAABAgQIECBAgAABAgQIECBQsoAAtOQBaE+AAAECBAgQIECAAAECBAgQIECAQDoBAWg6W5UJECBAgAABAgQIECBAgAABAgQIEChZQABa8gC0J0CAAAECBAgQIECAAAECBAgQIEAgnYAANJ2tygQIECBAgAABAgQIECBAgAABAgQIlCwgAC15ANoTIECAAAECBAgQIECAAAECBAgQIJBOQACazlZlAgQIECBAgAABAgQIECBAgAABAgRKFhCAljwA7QkQIECAAAECBAgQIECAAAECBAgQSCcgAE1nqzIBAgQIECBAgAABAgQIECBAgAABAiULCEBLHoD2BAgQIECAAAECBAgQIECAAAECBAikExCAprNVmQABAgQIECBAgAABAgQIECBAgACBkgUEoCUPQHsCBAgQIECAAAECBAgQIECAAAECBNIJCEDT2apMgAABAgQIECBAgAABAgQIECBAgEDJAgLQkgegPQECBAgQIECAAAECBAgQIECAAAEC6QQEoOlsVSZAgAABAgQIECBAgAABAgQIECBAoGQBAWjJA9CeAAECBAgQIECAAAECBAgQIECAAIF0AgLQdLYqEyBAgAABAgQIECBAgAABAgQIECBQsoAAtOQBaE+AAAECBAgQIECAAAECBAgQIECAQDoBAWg6W5UJECBAgAABAgQIECBAgAABAgQIEChZQABa8gC0J0CAAAECBAgQIECAAAECBAgQIEAgnYAANJ2tygQIECBAgAABAgQIECBAgAABAgQIlCwgAC15ANoTIECAAAECBAgQIECAAAECBAgQIJBOQACazlZlAgQIECBAgAABAgQIECBAgAABAgRKFhCAljwA7QkQIECAAAECBAgQIECAAAECBAgQSCcgAE1nqzIBAgQIECBAgAABAgQIECBAgAABAiULCEBLHoD2BAgQIECAAAECBAgQIECAAAECBAikExCAprNVmQCB/23vTuAkqerDgT8Q/rsruBhwAyineASUK0DQqMGIIHKqiMEjKopKWA9OFTziEdEoKCooGBWFrAloFERA4hFBOUQRhBWVQ44lyBFZ2BVYYKX/71daZc1Mz9EzXdMz3d/3+exOH1Wv6n1fVXfXr95BgAABAgQIECBAgAABAgQIECDQYwEB0B5XgM0TIECAAAECBAgQIECAAAECBAgQINCcgABoc7ZyJkCAAAECBAgQIECAAAECBAgQIECgxwICoD2uAJsnQIAAAQIECBAgQIAAAQIECBAgQKA5AQHQ5mzlTIAAAQIECBAgQIAAAQIECBAgQIBAjwUEQHtcATZPgAABAgQIECBAgAABAgQIECBAgEBzAgKgzdnKmQABAgQIECBAgAABAgQIECBAgACBHgsIgPa4AmyeAAECBAgQIECAAAECBAgQIECAAIHmBARAm7OVMwECBAgQIECAAAECBAgQIECAAAECPRYQAO1xBdg8AQIECBAgQIAAAQIECBAgQIAAAQLNCQiANmcrZwIECBAgQIAAAQIECBAgQIAAAQIEeiwgANrjCrB5AgQIECBAgAABAgQIECBAgAABAgSaExAAbc5WzgQIECBAgAABAgQIECBAgAABAgQI9FhAALTHFWDzBAgQIECAAAECBAgQIECAAAECBAg0JyAA2pytnAkQIECAAAECBAgQIECAAAECBAgQ6LGAAGiPK8DmCRAgQIAAAQIECBAgQIAAAQIECBBoTkAAtDlbORMgQIAAAQIECBAgQIAAAQIECBAg0GMBAdAeV4DNEyBAgAABAgQIECBAgAABAgQIECDQnIAAaHO2ciZAgAABAgQIECBAgAABAgQIECBAoMcCAqA9rgCbJ0CAAAECBAgQIECAAAECBAgQIECgOQEB0OZs5UyAAAECBAgQIECAAAECBAgQIECAQI8FBEB7XAE2T4AAAQIECBAgQIAAAQIECBAgQIBAcwICoM3ZypkAAQIECBAgQIAAAQIECBAgQIAAgR4LCID2uAJsngABAgQIECBAgAABAgQIECBAgACB5gQEQJuzlTMBAgQIECBAgAABAgQIECBAgAABAj0WEADtcQXYPAECBAgQIECAAAECBAgQIECAAAECzQkIgDZnK2cCBAgQIECAAAECBAgQIECAAAECBHosIADa4wqweQIECBAgQIAAAQIECBAgQIAAAQIEmhMQAG3OVs4ECBAgQIAAAQIECBAgQIAAAQIECPRYQAC0xxVg8wQIECBAgAABAgQIECBAgAABAgQINCcgANqcrZwJECBAgAABAgQIECBAgAABAgQIEOixgABojyvA5gkQIECAAAECBAgQIECAAAECBAgQaE5AALQ5WzkTIECAAAECBAgQIECAAAECBAgQINBjAQHQHleAzRMgQIAAAQIECBAgQIAAAQIECBAg0JzAas1lLeexBB588ME0Z86csRZp+97vfve79MADDxTvbbDBBm2X8SIBAgQIECBAgAABAgQIECBAgAABAn8U0AJ0Go+Er33ta+mFL3xhWnfdddO8efPS5ptvnl796leniy66aMJ78drXvjZtuOGGxb8Jr2RBAgQIECBAgAABAgQIECBAgAABAgMqIAA6DRV/3333pde85jVpv/32S9/+9rfTnXfemVqtVvrVr36VTjvttPR3f/d36bDDDqtadk7DLtkEAQIECBAgQIAAAQIECBAgQIAAgYEQEACdhmo++uij06mnnlptaY011kibbrppWmWVVYrXHnnkkfSJT3wibbPNNunGG2+slvOAAAECBAgQIECAAAECBAgQIECAAIGpCQiATs1v3LWvvPLKdOKJJxbLRdf3s846Ky1btiz95je/SUuXLk0f/ehH01prrVW8f+2116bnPve5gqDjqlqAAAECBAgQIECAAAECBAgQIECAwMQEBEAn5jTppT772c+mP/zhD2m11VZL559/ftp7773Tqqv+kT0Cn0ceeWT65S9/mbbeeutiG7fcckvaeeed0x133DHpbVqRAAECBAgQIECAAAECBAgQIECAAIE/CgiANnwkRHAz0ite8YoqyDl8k+uvv3668MIL00477VS8Fd3g99hjjxRjh0oECBAgQIAAAQIECBAgQIAAAQIECExeQAB08nYTWvPXv/51sdx222035vLz589P5513XnrmM59ZLHf55Zenl73sZUXr0TFX9CYBAgQIECBAgAABAgQIECBAgAABAqMKCICOStOdNx566KEio0c/+tHjZjhv3rz0zW9+Mz3pSU8qlj333HPTW97ylnHXswABAgQIECBAgAABAgQIECBAgAABAu0FBEDbu3Tt1Sc/+clFXtdcc82E8nzc4x6Xvv3tb6cFCxYUy8cYoh//+McntK6FCBAgQIAAAQIECBAgQIAAAQIECBAYKiAAOtSj68/KAOiiRYvS3XffPaH8N9tss6IlaLQIjXTEEUekU089dULrWogAAQIECBAgQIAAAQIECBAgQIAAgT8LCID+2aKRRzH5UaQ777yzmAhporO7P+MZz0gRNI0Z41utVjrggAPS+9///vTII480sp8yJUCAAAECBAgQIECAAAECBAgQINCPAgKgDddqzOb+/Oc/v9jK+eefnzbffPMimHnCCSeMu+UXv/jF6TOf+UxaZZVVisDn+973vqJ7/LgrWoAAAQIECBAgQIAAAQIECBAgQIAAgUJAAHQaDoSTTz45bbnllsWWli5dmr70pS+lk046aUJbftOb3pS++MUvptVWW61YXgvQCbFZiAABAgQIECBAgAABAgQIECBAgEAhIAA6DQfCE5/4xHTZZZelhQsXpjXWWKPY4uMf//gJb/m1r31tuuKKK9JznvOcCa9jQQIECBAgQIAAAQIECBAgQIAAAQIEUhIAnaajYO7cuSm6vd9zzz3pkksuKSY26mTTT3/609OFF16YvvzlL6cYH3T+/PmdrG5ZAgQIECBAgAABAgQIECBAgAABAgMp8Md+1QNZ9N4UOrqyRwBzsunVr351in8SAQIECBAgQIAAAQIECBAgQIAAAQLjC2gBOr6RJQgQIECAAAECBAgQIECAAAECBAgQmKUCAqCztOLsNgECBAgQIECAAAECBAgQIECAAAEC4wvoAj++0YxZ4uGHH0533HFHtT8bbLBB9bjJB3fddVf64Q9/mFqt1pQ3c9111xV5mM1+ypQyIECAAAECBAgQIECAAAECBAgQmICAAOgEkGbKIldddVXafvvtq93pRkCyymyMB2984xvTmWeeOcYSnb91+eWXd76SNQgQIECAAAECBAgQIECAAAECBAh0KCAA2iHYIC5+4IEHppi8qRsB15///Ofp+uuvT09+8pMHkVKZCRAgQIAAAQIECBAgQIAAAQIEpllAAHSawWfj5vbYY48U/7qRDj300HT88cenxz72sd3ITh4ECBAgQIAAAQIECBAgQIAAAQIExhQQAB2TZ2a9ufXWW6fbb799Zu2UvSFAgAABAgQIECBAgAABAgQIECAwgwUEQGdw5QzfteiGvu666w5/2XMCBAgQIECAAAECBAgQIECAAAECBEYRWHWU171MgAABAgQIECBAgAABAgQIECBAgACBWS+gBWiPq/C2225Ld999d7r//vuLf3Pnzk1rrbVWmj9/flpnnXVSPJcIECBAgAABAgQIECBAgAABAgQIEJicgADo5Nwmvdby5cvTqaeemhYtWpQWL16c4vloKbq8b7nllmnHHXdMe+65Z9p9993TKqusMtriXidAgAABAgQIECBAgAABAgQIECBAYJiALvDDQJp6escdd6SFCxemJzzhCenNb35zuuSSS8YMfsZ+rFy5Ml1xxRXppJNOKgKgW221VTrnnHOa2kX5EiBAgAABAgQIECBAgAABAgQIEOg7AS1Ap6FKly5dmnbZZZd09dVXV1uLlpzrr79+2mijjdKCBQvSvHnz0pw5c4qg54oVK9KyZcvSkiVL0s0335wefPDBYr1oMbr33nun4447Lh1yyCFVXh4QIECAAAECBAgQIECAAAECBAgQINBeQAC0vUvXXr3vvvvSHnvsUQU/d9hhh3TYYYelnXfeuQh8jrehhx9+OF122WVFt/lTTjklxfNDDz00PeUpTym6xI+3vvcJECBAgAABAgQIECBAgAABAgQIDLKALvAN1/4ZZ5xRdHePzey///7p0ksvLf5Gq8+JpNVXXz0961nPSieffHI688wzUzyP9M53vjM98sgjE8nCMgQIECBAgAABAgQIECBAgAABAgQGVkAAtOGqv/jii4stxPidMfnRqqtOnjwmQTr22GOL/KI7/Y033tjw3sueAAECBAgQIECAAAECBAgQIECAwOwWmHw0bnaXe9r2/qKLLiq2tddee1WtN6ey8X333bda/dprr60ee0CAAAECBAgQIECAAAECBAgQIECAwEgBAdCRJl195dZbby3y23DDDbuS7zrrrFMFUh944IGu5CkTAgQIECBAgAABAgQIECBAgAABAv0qIADacM1uttlmxRYuueSSrmwputTHREiRtt12267kKRMCBAgQIECAAAECBAgQIECAAAEC/SogANpwzW633XbFFk4//fR0wQUXTGlr99xzTzr88MOLPNZee+206aabTik/KxMgQIAAAQIECBAgQIAAAQIECBDodwEB0IZr+Kijjiq6rK9YsSLts88+xWzuDz30UMdbvfLKK9Ouu+6a4m+kgw46qOM8rECAAAECBAgQIECAAAECBAgQIEBg0ARWG7QCT3d5owv8Mccck4488sh07733FoHLeLzTTjulbbbZpmjFue6666Z58+aluXPnppUrV6YIli5btiwtWbIkXX/99enCCy9MixcvrnY9AqEf/OAHq+ceECBAgAABAgQIECBAgAABAgQIECDQXkAAtL1LV1894ogjUkxetHDhwhQTFy1fvjx961vfKv51uqHddtstLVq0KK26qsa7ndpZngABAgQIECBAgAABAgQIECBAYPAERNGmqc4POOCAdPPNN6ejjz46rbfeeh1tdc6cOUX3+bPPPjudd955Kcb/lAgQIECAAAECBAgQIECAAAECBAgQGF9AC9Dxjbq2xIIFC9KHPvSh4t9NN92ULr300nTdddcV3d2je3y0DF199dXTmmuumebPn5+i+/wWW2yRtt566+K1ru2IjAgQIECAAAECBAgQIECAAAECBAgMiIAAaI8qepNNNknxTyJAgAABAgQIECBAgAABAgQIECBAoDkBXeCbs5UzAQIECBAgQIAAAQIECBAgQIAAAQI9FhAA7XEF2DwBAgQIECBAgAABAgQIECBAgAABAs0JCIA2ZytnAgQIECBAgAABAgQIECBAgAABAgR6LCAA2uMKsHkCBAgQIECAAAECBAgQIECAAAECBJoTEABtzlbOBAgQIECAAAECBAgQIECAAAECBAj0WEAAtMcVYPMECBAgQIAAAQIECBAgQIAAAQIECDQnIADanK2cCRAgQIAAAQIECBAgQIAAAQIECBDosYAAaI8rwOYJECBAgAABAgQIECBAgAABAgQIEGhOQAC0OVs5EyBAgAABAgQIECBAgAABAgQIECDQYwEB0B5XgM0TIECAAAECBAgQIECAAAECBAgQINCcgABoc7ZyJkCAAAECBAgQIECAAAECBAgQIECgxwICoD2uAJsnQIAAAQIECBAgQIAAAQIECBAgQKA5AQHQ5mzlTIAAAQIECBAgQIAAAQIECBAgQIBAjwUEQHtcATZPgAABAgQIECBAgAABAgQIECBAgEBzAgKgzdnKmQABAgQIECBAgAABAgQIECBAgACBHgsIgPa4AmyeAAECBAgQIECAAAECBAgQIECAAIHmBARAm7OVMwECBAgQIECAAAECBAgQIECAAAECPRYQAO1xBdg8AQIECBAgQIAAAQIECBAgQIAAAQLNCQiANmcrZwIECBAgQIAAAQIECBAgQIAAAQIEeiwgANrjCrB5AgQIECBAgAABAgQIECBAgAABAgSaExAAbc5WzgQIECBAgAABAgQIECBAgAABAgQI9FhAALTHFWDzBAgQIECAAAECBAgQIECAAAECBAg0JyAA2pytnAkQIECAAAECBAgQIECAAAECBAgQ6LGAAGiPK8DmCRAgQIAAAQIECBAgQIAAAQIECBBoTkAAtDlbORMgQIAAAQIECBAgQIAAAQIECBAg0GMBAdAeV4DNEyBAgAABAgQIECBAgAABAgQIECDQnIAAaHO2ciZAgAABAgQIECBAgAABAgQIECBAoMcCAqA9rgCbJ0CAAAECBAgQIECAAAECBAgQIECgOQEB0OZs5UyAAAECBAgQIECAAAECBAgQIECAQI8FBEB7XAE2T4AAAQIECBAgQIAAAQIECBAgQIBAcwICoM3ZypkAAQIECBAgQIAAAQIECBAgQIAAgR4LCID2uAJsngABAgQIECBAgAABAgQIECBAgACB5gQEQJuzlTMBAgQIECBAgAABAgQIECBAgAABAj0WEADtcQXYPAECBAgQIECAAAECBAgQIECAAAECzQkIgDZnK2cCBAgQIECAAAECBAgQIECAAAECBHosIADa4wqweQIECBAgQIAAAQIECBAgQIAAAQIEmhMQAG3OVs4ECBAgQIAAAQIECBAgQIAAAQIECPRYQAC0xxVg8wQIECBAgAABAgQIECBAgAABAgQINCcgANqcrZwJECBAgAABAgQIECBAgAABAgQIEOixgABojyvA5gkQIECAAAECBAgQIECAAAECBAgQaE5AALQ5WzkTIECAAAECBAgQIECAAAECBAgQINBjAQHQHleAzRMgQIAAAQIECBAgQIAAAQIECBAg0JyAAGhztnImQIAAAQIECBAgQIAAAQIECBAgQKDHAgKgPa4AmydAgAABAgQIECBAgAABAgQIECBAoDkBAdDmbOVMgAABAgQIECBAgAABAgQIECBAgECPBQRAe1wBNk+AAAECBAgQIECAAAECBAgQIECAQHMCAqDN2cqZAAECBAgQIECAAAECBAgQIECAAIEeCwiA9rgCbJ4AAQIECBAgQIAAAQIECBAgQIAAgeYEBECbs5UzAQIECBAgQIAAAQIECBAgQIAAAQI9FhAA7XEF2DwBAgQIECBAgAABAgQIECBAgAABAs0JCIA2ZytnAgQIECBAgAABAgQIECBAgAABAgR6LCAA2uMKsHkCBAgQIECAAAECBAgQIECAAAECBJoTEABtzlbOBAgQIECAAAECBAgQIECAAAECBAj0WEAAtMcVYPMECBAgQIAAAQIECBAgQIAAAQIECDQnIADanK2cCRAgQIAAAQIECBAgQIAAAQIECBDosYAAaI8rwOYJECBAgAABAgQIECBAgAABAgQIEGhOQAC0OVs5EyBAgAABAgQIECBAgAABAgQIECDQYwEB0B5XgM0TIECAAAECBAgQIECAAAECBAgQINCcgABoc7ZyJkCAAAECBAgQIECAAAECBAgQIECgxwICoD2uAJsnQIAAAQIECBAgQIAAAQIECBAgQKA5AQHQ5mzlTIAAAQIECBAgQIAAAQIECBAgQIBAjwUEQHtcATZPgAABAgQIECBAgAABAgQIECBAgEBzAgKgzdnKmQABAgQIECBAgAABAgQIECBAgACBHgsIgPa4AmyeAAECBAgQIECAAAECBAgQIECAAIHmBARAm7OVMwECBAgQIECAAAECBAgQIECAAAECPRYQAO1xBdg8AQIECBAgQIAAAQIECBAgQIAAAQLNCQiANmcrZwIECBAgQIAAAQIECBAgQIAAAQIEeiwgANrjCrB5AgQIECBAgAABAgQIECBAgAABAgSaExAAbc5WzgQIECBAgAABAgQIECBAgAABAgQI9FhAALTHFWDzBAgQIECAAAECBAgQIECAAAECBAg0JyAA2pytnAkQIECAAAECBAgQIECAAAECBAgQ6LGAAGiPK8DmCRAgQIAAAQIECBAgQIAAAQIECBBoTkAAtDlbORMgQIAAAQIECBAgQIAAAQIECBAg0GMBAdAeV4DNEyBAgAABAgQIECBAgAABAgQIECDQnIAAaHO2ciZAgAABAgQIECBAgAABAgQIECBAoMcCAqA9rgCbJ0CAAAECBAgQIECAAAECBAgQIECgOQEB0OZs5UyAAAECBAgQIECAAAECBAgQIECAQI8FBEB7XAE2T4AAAQIECBAgQIAAAQIECBAgQIBAcwICoM3ZypkAAQIECBAgQIAAAQIECBAgQIAAgR4LCID2uAJsngABAgQIECBAgAABAgQIECBAgACB5gQEQJuzlTMBAgQIECBAgAABAgQIECBAgAABAj0WEADtcQXYPAECBAgQIECAAAECBAgQIECAAAECzQkIgDZnK2cCBAgQIECAAAECBAgQIECAAAECBHosIADa4wqweQIECBAgQIAAAQIECBAgQIAAAQIEmhMQAG3OVs4ECBAgQIAAAQIECBAgQIAAAQIECPRYQAC0xxVg8wQIECBAgAABAgQIECBAgAABAgQINCcgANqcrZwJECBAgAABAgQIECBAgAABAgQIEOixgABojyvA5gkQIECAAAECBAgQIECAAAECBAgQaE5AALQ5WzkTIECAAAECBAgQIECAAAECBAgQINBjAQHQHleAzRMgQIAAAQIECBAgQIAAAQIECBAg0JyAAGhztnImQIAAAQIECBAgQIAAAQIECBAgQKDHAgKgPa4AmydAgAABAgQIECBAgAABAgQIECBAoDkBAdDmbOVMgAABAgQIECBAgAABAgQIECBAgECPBQRAe1wBNk+AAAECBAgQIECAAAECBAgQIECAQHMCAqDN2cqZAAECBAgQIECAAAECBAgQIECAAIEeCwiA9rgCbJ4AAQIECBAgQIAAAQIECBAgQIAAgeYEVmsuazlPROC2225Ld999d7r//vuLf3Pnzk1rrbVWmj9/flpnnXVSPJcIECBAgAABAgQIECBAgAABAgQIEJicgADo5Nwmvdby5cvTqaeemhYtWpQWL16c4vloabXVVktbbrll2nHHHdOee+6Zdt9997TKKquMtrjXCRAgQIAAAQIECBAgQIAAAQIECBAYJqAL/DCQpp7ecccdaeHChekJT3hCevOb35wuueSSMYOfsR8rV65MV1xxRTrppJOKAOhWW22VzjnnnKZ2Ub4ECBAgQIAAAQIECBAgQIAAAQIE+k5AC9BpqNKlS5emXXbZJV199dXV1qIl5/rrr5822mijtGDBgjRv3rw0Z86cIui5YsWKtGzZsrRkyZJ08803pwcffLBYL1qM7r333um4445LhxxySJWXBwQIECBAgAABAgQIECBAgAABAgQItBcQAG3v0rVX77vvvrTHHntUwc8ddtghHXbYYWnnnXcuAp/jbejhhx9Ol112WdFt/pRTTknx/NBDD01PecpTii7x463vfQIECBAgQIAAAQIECBAgQIAAAQKDLKALfMO1f8YZZxTd3WMz+++/f7r00kuLv9HqcyJp9dVXT8961rPSySefnM4888wUzyO9853vTI888shEsrAMAQIECBAgQIAAAQIECBAgQIAAgYEVEABtuOovvvjiYgsxfmdMfrTqqpMnj0mQjj322CK/6E5/4403Nrz3sidAgAABAgQIECBAgAABAgQIECAwuwUmH42b3eWetr2/6KKLim3ttddeVevNqWx83333rVa/9tprq8ceECBAgAABAgQIECBAgAABAgQIECAwUkAAdKRJV1+59dZbi/w23HDDruS7zjrrVIHUBx54oCt5yoQAAQIECBAgQIAAAQIECBAgQIBAvwoIgDZcs5tttlmxhUsuuaQrW4ou9TERUqRtt922K3nKhAABAgQIECBAgAABAgQIECBAgEC/CgiANlyz2223XbGF008/PV1wwQVT2to999yTDj/88CKPtddeO2266aZTys/KBAgQIECAAAECBAgQIECAAAECBPpdQAC04Ro+6qijii7rK1asSPvss08xm/tDDz3U8VavvPLKtOuuu6b4G+mggw7qOA8rECBAgAABAgQIECBAgAABAgQIEBg0gdUGrcDTXd7oAn/MMcekI488Mt17771F4DIe77TTTmmbbbYpWnGuu+66ad68eWnu3Llp5cqVKYKly5YtS0uWLEnXX399uvDCC9PixYurXY9A6Ac/+MHquQcECBAgQIAAAQIECBAgQIAAAQIECLQXEABt79LVV4844ogUkxctXLgwxcRFy5cvT9/61reKf51uaLfddkuLFi1Kq66q8W6ndpYnQIAAAQIECBAgQIAAAQIECBAYPAFRtGmq8wMOOCDdfPPN6eijj07rrbdeR1udM2dO0X3+7LPPTuedd16K8T8lAgQIECBAgAABAgQIECBAgAABAgTGF9ACdHyjri2xYMGC9KEPfaj4d9NNN6VLL700XXfddUV39+geHy1DV1999bTmmmum+fPnp+g+v8UWW6Stt966eK1rOyIjAgQIECBAgAABAgQIECBAgAABAgMiIADao4reZJNNUvyTCBAgQIAAAQIECBAgQIAAAQIECBBoTkAX+OZs5UyAAAECBAgQIECAAAECBAgQIECAQI8FBEB7XAE2T4AAAQIECBAgQIAAAQIECBAgQIBAcwK6wDdn2/WcH3744XTHHXdU+W6wwQbVYw8IECBAgAABAgQIECBAgAABAgQIEBgpIAA60mTGvnLVVVel7bffvtq/VqtVPW7ywYknnphOOOGE1I3t3XnnncWu3nbbbU3uclfy/spXvpLOOuusruQlk8ETeOCBB3pW6BUrVqSDDz64Z9u34dkvcNddd/WsEGeffXb6wQ9+0LPt2/DsFnjooYd6WoC3ve1tPd2+jc9ugbvvvrtnBYjP3SuuuKJn27fh2S2wcuXKnhbg3e9+d3rUox7V032w8dkrcM8998zenbfnHQkIgHbENZgL/+QnP0m/+tWvulr41VabuYfepptuWpT13nvvTfFPIjAVgfJ4mkoeE1330Y9+dFqwYEGK4NVsuMkw0XJZrjcCq6++enr84x8/bRsvz5Xly5en+CcRmIpAeTxNJY9O1o3txW8ln72dqFm2ncAqq6ySNtpoo3ZvNfJaOSnrfffdl+KfRGAqAr347F2yZMmQXpJT2X/rDrZA+Xk42Ar9XfpVcqu+6WlG2N+O01K6yy+/vCctQOOO3o033pgeeeSRrpTz97//fdpuu+26kldTmdxwww2p13cymyqbfKdPIO5EP/GJT0yrrjp9wy0vW7Ys/fa3v52+QtpS3wqsvfbaRUB9Ogt40003pQcffHA6N2lbfSgQn7lxET6dN1sjcHTrrbf2oaYiTbfAWmutldZbb71p3WwEkO6///5p3aaN9Z9ABO833njjNGfOnGkrXPR6uuWWW7rSU3HadtqGZqTAGmuskQwxOCOrpqs7JQDaVc5mM4uA3O9+97tqI+uuu2712AMCBAgQIECAAAECBAgQIECAAAECBEYKCICONPEKAQIECBAgQIAAAQIECBAgQIAAAQJ9IjB9/TL7BEwxCBAgQIAAAQIECBAgQIAAAQIECBCYPQICoLOnruwpAQIECBAgQIAAAQIECBAgQIAAAQIdCszcqbg7LMhsXTxmC7377ruLgcdj8PG5c+emGPx8/vz5aZ111imez9ay2W8CBAgQIECAAAECBAgQIECAAAECvRYQAJ3mGli+fHk69dRT06JFi9LixYtTPB8txeylW265Zdpxxx3TnnvumXbfffcUs+tJBAgQIECAAAECBAgQIECAAAECBAhMTMAkSBNzmvJSd9xxR/rABz6QTjvttDGDnmNt6OlPf3r6yEc+kvbYY4+xFvMeAQIECBAgQIAAAQIECBAgQIAAAQJ/EhAAnYZDYenSpWmnnXZKV199dbW1aMm5/vrrp4022igtWLAgzZs3L82ZMyetXLkyrVixIi1btiwtWbIk3XzzzenBBx+s1lt11VXTcccdlw455JDqNQ8IECBAgAABAgQIECBAgAABAgQIEGgvIADa3qVrr953331pl112SZdcckmR5w477JAOO+ywtPPOOxeBz/E29PDDD6fLLrus6DZ/yimnpHge6Zxzzim6xI+3vvcJECBAgAABAgQIECBAgAABAgQIDLKAAGjDtR9By9e97nXFVvbff/9i7M9oxTmZdO6556YXvehFRRA0xga98sor02Tzmsz2rUOAAAECBAgQIECAAAECBAgQIEBgtglMLhI320rZw/29+OKLi61vtdVWRSvOqQQsYxKkY489tsgvutPfeOONPSyZTRMgQIAAAQIECBAgQIAAAQIECBCY+QICoA3X0UUXXVRsYa+99kqrr776lLe27777Vnlce+211WMPCBAgQIAAAQIECBAgQIAAAQIECBAYKSAAOtKkq6/ceuutRX4bbrhhV/JdZ511qkDqAw880JU8ZUKAAAECBAgQIECAAAECBAgQIECgXwUEQBuu2c0226zYQjkJ0lQ3F13qy4mQtt1226lmZ30CBAgQIECAAAECBAgQIECAAAECfS0gANpw9W633XbFFk4//fR0wQUXTGlr99xzTzr88MOLPNZee+206aabTik/KxMgQIAAAQIECBAgQIAAAQIECBDodwEB0IZr+Kijjiq6rK9YsSLts88+6eSTT04PPfRQx1uNGd933XXXYub3WPmggw7qOA8rECBAgAABAgQIECBAgAABAgQIEBg0gVVaOQ1aoae7vDFz+5FHHllt9jGPeUzaaaed0jbbbFO04lx33XXTvHnz0ty5c9PKlStTBEuXLVuWlixZkq6//vp04YUXpsWLF1frRyD0vPPOS1OZUb7KzAMCBAgQIECAAAECBAgQIECAAAECfSwgADpNlXvKKaekhQsXpqlOXLTbbrulRYsWpegCLxEgQIAAAQIECBAgQIAAAQIECBAgMLaAAOjYPl1996677krHH398+uIXv5huv/32Cec9Z86cFIHPAw88MO25554TXs+CBAgQIECAAAECBAgQIECAAAECBAZdQAC0R0fATTfdlC699NJ03XXXFd3d77333rR8+fJivNA111wzzZ8/P8UM8ltssUXaeuutU7wmESBAgAABAgQIECBAgAABAgQIECDQmYAAaGdeliZAgAABAgQIECBAgAABAgQIECBAYBYJmAV+FlWWXSVAgAABAgQIECBAgAABAgQIECBAoDMBAdDOvCxNgAABAgQIECBAgAABAgQIECBAgMAsEhAAnUWVZVcJECBAgAABAgQIECBAgAABAgQIEOhMQAC0My9LEyBAgAABAgQIECBAgAABAgQIECAwiwQEQGdRZdlVAgQIECBAgAABAgQIECBAgAABAgQ6ExAA7czL0gQIECBAgAABAgQIECBAgAABAgQIzCIBAdBZVFl2lQABAgQIECBAgAABAgQIECBAgACBzgQEQDvzsjQBAgQIECBAgAABAgQIECBAgAABArNIQAB0FlWWXSVAgAABAgQIECBAgAABAgQIECBAoDMBAdDOvCxNgAABAgQIECBAgAABAgQIECBAgMAsEhAAnUWVZVcJECBAgAABAgQIECBAgAABAgQIEOhMQAC0My9LEyBAgAABAgQIECBAgAABAgQIECAwiwQEQGdRZdlVAgQIECBAgAABAgQIECBAgAABAgQ6ExAA7czL0gQIECBAgAABAgQIECBAgAABAgQIzCIBAdBZVFl2lQABAgQIECBAgAABAgQIECBAgACBzgQEQDvzsjQBAgQIECBAgAABAgQIECBAgAABArNIQAB0FlWWXSVAgAABAgQIECBAgAABAgQIECBAoDMBAdDOvCxNgAABAgQIECBAgAABAgQIECBAgMAsEhAAnUWVZVcJECBAgAABAgQIECBAgAABAgQIEOhMQAC0My9LEyBAgAABAgQIECBAgAABAgQIECAwiwQEQGdRZdlVAgQIECBAgAABAgQIECBAgAABAgQ6ExAA7czL0gQIECBAgAABAgQIECBAgAABAgQIzCIBAdBZVFl2lQABAgQIECBAgAABAgQIECBAgACBzgQEQDvzsjQBAgQIECBAgAABAgQIECBAgAABArNIQAB0FlWWXSVAgAABAgQIECBAgAABAgQIECBAoDMBAdDOvCxNgAABAgQIECBAgAABAgQIECBAgMAsEhAAnUWVZVcJECBAgAABAgQIECBAgAABAgQIEOhMQAC0My9LEyBAgAABAgQIECBAgAABAgQIECAwiwQEQGdRZdlVAgQIECBAgAABAgQIECBAgAABAgQ6E1its8UtTYAAAQIE+ktg6dKl6eabb06/+93v0kYbbZQ22WSTtPrqq/dXIfuwNMuWLUvXXHNNUVebb755evSjH92HpVQkAgQIDJ5Aq9VKN910U7r99tvTPffck9Zff/3iu/mxj33sjMd4+OGH06233ppuueWWNG/evLTZZpulddZZZ8bvtx0kQIDAIAgIgA5CLSvjtAn84Q9/SNtss0266667im3uuuuu6dRTT5227c/kDe2www5pyZIlaa211kq//vWvZ/Ku2rcBEPjFL36RPv/5z6dFixZV52tZ7Ec96lHpqU99ajr00EPTa17zmlkZDI3Pot/+9rdpgw02KIvVs79x8XffffelTTfdNF1yySVT3o+f//zn6Z/+6Z+G5LXKKquk/fbbL33yk59M66233pS3UWYQwfAVK1aUTzv+G8fPv/7rv3a83nSuEEGGKOegpUGo20GrU+Wd/QJXXXVV8Tl+3nnnFd9hw0sUn+8HHHBAOuigg4oblsPfH/78hBNOSP/yL/8y/OWOnl999dVpwYIFY67zwAMPpK997WvF74of/ehH6ZFHHhmyfPz23XPPPdN73vOe4vfFkDdrTx588MG08cYb114Z+jC+6+IGbQRW/+Iv/iI9+clPTi972cuKvOM9iQABAgTGEch32CQCBLokcM4557TyKVf9W2211Vr5LnCXcp/d2eSLzcIl372f3QWx97Na4Pe//33rla98ZXWO1s/Xdo/juP2f//mfWVXmH/7wh62tttqq9elPf3pG7Peaa65ZeD/pSU+a8v7kC8xWfK62q6t4LV+ktv73f/93ytspM5g7d+6o2xptH+qv54v0MqsZ9zfOhXe84x2t3LJqxu3bdOxQP9ftdPjZBoFuCsTn0Wtf+9rWqquuOqHP3HyjsvWWt7yl9dBDD425Gx/5yEcmlF/9c3v449wKdcxtnH/++a2//Mu/nNB2Yr9f97rXjbrf+YbbhPIZvo+58UUrvh9z4HXMffUmAQIEBl1AC9D8DSIR6JbAF7/4xSKr6OoS3WlXrlyZ/u3f/i29733v69Ym5EOAwCT1R49SAAA1nklEQVQFrr322vSiF70o/fKXv6xyiBbb0VI7WifGeRtd4a+44or01a9+NUU3tmgdF602vvOd76RnPvOZ1Xoz9cE3v/nNtM8++8zU3ZvSfkXdvP71ry8+V6O7e9lCN1qUH3fccekHP/hB0Zo3lonWQ91Ocazk4GtH2caQCjM1/d3f/V362c9+pmtmrqB+q9uZeszZLwLtBKK3wh577FF895bvP+EJT0jPeMYzinPzKU95SrrzzjuL3kOnn3568TkfvRzyTb4ULUbj+3q8FpqRbw5STqjVaLkP5d+xPvff//73pw984ANVi89omfnSl740bbHFFinfQE33339/uuGGG9J//dd/Ffsf+x3XCsuXL0//8R//kaLHyVhp++23H/J2DlwUvRJi/TvuuCNFi9FIV155ZbHdl7zkJemMM84YN98hmXpCgACBQRIY9Aiw8hPolkDu9t7K3VKKO7fRqiYHVIrH+UdcKwdSurWZWZvPueeeW9ydPuuss2ZtGez47BXIXbBbuVt71bIizs9osT1a+s1vftN69rOfXS0fLZevv/760RafMa9/6UtfqvY5d/2bEfvVrRagxxxzTFW2gw8+eEjZ8sVx9fmbuwG28vigQ96f7JN6K8E8Dt1ks5mR65Wt8h/3uMfNyP1reqf6uW6btpM/gW4KPO95z6s+26OF/1FHHdWKlpDtUu5qXvRumDNnTrVOHmJp1N/Z9RaghxxySLssJ/3aF77whWofcuyg9eY3v7mVg5Jt88sNIlqf+9znWtECNJaNf9GCdXga3gJ0+Pv15zn42broootadb/I901velN9MY8JECBAoCZgFvj8TSER6IbAaaedVrQYi7xe+MIXprgLGyl3x0xnn3128XiQ/wuTfffdN+29996DzKDsPRI4/PDDq7FnY0zKCy64IO2+++6j7k20CI3zdssttyyWiUkYZvpYjqMWpk/e+OlPf1qVJA9jUD2OB9H65/nPf37xWv6NU0yONGQBTwgQIEBgxglEa8Xvf//7xX5FL4zLLrss5ZtdKQc42+5rvnGRcqAxffe73y3GwIyFfvKTn6Qc6Gy7fFMvRqvOt73tbVX2sc/RIjVambZL0dLzDW94Qzr55JOrtz/72c8WEyVVL3T44P/9v/+X/vZv/zZ973vfS+9+97urtWMbeSic6rkHBAgQIPBnAQHQP1t4RGBKAmX398c85jHFD5JXvOIVVX7xI0ciQKA3AjHh0UknnVRsPCYJiO5yG2644bg7E7PNxgQKZYqbHNENT+qNQH1yo6jT4em6666rXorukxIBAgQIzFyBmBwvbk6WKSYr2nbbbcunY/7NPTSKgGO5UHRDzz03yqeN/82tVFMet7TYTgytE88nkmKIlr//+78vFo1hso4//viJrDbuMlH+2I8yvetd7yof+kuAAAECNYHOBrOqreghAQJ/Foi7z4sXLy5eiFZIMUPjX//1XxdjAF1zzTXFnercfTblSUD+vFKbR/EDaunSpcVYgzF7cLQe/frXv16MbRezJ8ds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xvkU/+K7P87BOIdm0nfQdLvYHgECBGaKgADoTKkJ+0GAAAECBAgQIEBgmgXaBUCneRdsjgABAgQIECDQuMD0N+1qvEg2QIAAAQIECBAgQIAAAQIECBAgQIAAgT8KCIA6EggQIECAAAECBAgQIECAAAECBAgQ6FsBAdC+rVoFI0CAAAECBAgQIECAAAECBAgQIEBAANQxQIAAAQIECBAgQIAAAQIECBAgQIBA3wr0ZgrXvuVUMAIECBAgQIAAAQKzR+BTn/pUuv/++yc1y/vsKaU9JUCAAAECBAZdwCzwg34EKD8BAgQIECBAgAABAgQIECBAgACBPhbQBb6PK1fRCBAgQIAAAQIECBAgQIAAAQIECAy6gADooB8Byk+AAAECBAgQIECAAAECBAgQIECgjwUEQPu4chWNAAECBAgQIECAAAECBAgQIECAwKALCIAO+hGg/AQIECBAgAABAgQIECBAgAABAgT6WEAAtI8rV9EIECBAgAABAgQIECBAgAABAgQIDLqAAOigHwHKT4AAAQIECBAgQIAAAQIECBAgQKCPBQRA+7hyFY0AAQIECBAgQIAAAQIECBAgQIDAoAsIgA76EaD8BAgQIECAAAECBAgQIECAAAECBPpYQAC0jytX0QgQIECAAAECBAgQIECAAAECBAgMuoAA6KAfAcpPgAABAgQIECBAgAABAgQIECBAoI8FBED7uHIVjQABAgQIECBAgAABAgQIECBAgMCgCwiADvoRoPwECBAgQIAAAQIECBAgQIAAAQIE+lhAALSPK1fRCBAgQIAAAQIECBAgQIAAAQIECAy6gADooB8Byk+AAAECBAgQIECAAAECBAgQIECgjwUEQPu4chWNAAECBAgQIECAAAECBAgQIECAwKALCIAO+hGg/AQIECBAgAABAgQIECBAgAABAgT6WEAAtI8rV9EIECBAgAABAgQIECBAgAABAgQIDLqAAOigHwHKT4AAAQIECBAgQIAAAQIECBAgQKCPBQRA+7hyFY0AAQIECBAgQIAAAQIECBAgQIDAoAsIgA76EaD8BAgQIECAAAECBAgQIECAAAECBPpYQAC0jytX0QgQIECAAAECBAgQIECAAAECBAgMuoAA6KAfAcpPgAABAgQIECBAgAABAgQIECBAoI8FBED7uHIVjQABAgQIECBAgAABAgQIECBAgMCgCwiADvoRoPwECBAgQIAAAQIECBAgQIAAAQIE+lhAALSPK1fRCBAgQIAAAQIECBAgQIAAAQIECAy6gADooB8Byk+AAAECBAgQIECAAAECBAgQIECgjwUEQPu4chWNAAECBAgQIECAAAECBAgQIECAwKALCIAO+hGg/AQIECBAgAABAgQIECBAgAABAgT6WEAAtI8rV9EIECBAgAABAgQIECBAgAABAgQIDLqAAOigHwHKT4AAAQIECBAgQIAAAQIECBAgQKCPBQRA+7hyFY0AAQIECBAgQIAAAQIECBAgQIDAoAsIgA76EaD8BAgQIECAAAECBAgQIECAAAECBPpYQAC0jytX0QgQIECAAAECBAgQIECAAAECBAgMuoAA6KAfAcpPgAABAgQIECBAgAABAgQIECBAoI8FBED7uHIVjQABAgQIECBAgAABAgQIECBAgMCgCwiADvoRoPwECBAgQIAAAQIECBAgQIAAAQIE+lhAALSPK1fRCBAgQIAAAQIECBAgQIAAAQIECAy6gADooB8Byk+AAAECBAgQIECAAAECBAgQIECgjwUEQPu4chWNAAECBAgQIECAAAECBAgQIECAwKALCIAO+hGg/AQIECBAgAABAgQIECBAgAABAgT6WEAAtI8rV9EIECBAgAABAgQIECBAgAABAgQIDLqAAOigHwHKT4AAAQIECBAgQIAAAQIECBAgQKCPBQRA+7hyFY0AAQIECBAgQIAAAQIECBAgQIDAoAsIgA76EaD8BAgQIECAAAECBAgQIECAAAECBPpYQAC0jytX0QgQIECAAAECBAgQIECAAAECBAgMuoAA6KAfAcpPgAABAgQIECBAgAABAgQIECBAoI8FBED7uHIVjQABAgQIECBAgAABAgQIECBAgMCgCwiADvoRoPwECBAgQIAAAQIECBAgQIAAAQIE+lhAALSPK1fRCBAgQIAAAQIECBAgQIAAAQIECAy6gADooB8Byk+AAAECBAgQIECAAAECBAgQIECgjwUEQPu4chWNAAECBAgQIECAAAECBAgQIECAwKALCIAO+hGg/AQIECBAgAABAgQIECBAgAABAgT6WEAAtI8rV9EIECBAgAABAgQIECBAgAABAgQIDLqAAOigHwHKT4AAAQIECBAgQIAAAQIECBAgQKCPBQRA+7hyFY0AAQIECBAgQIAAAQIECBAgQIDAoAsIgA76EaD8BAgQIECAAAECBAgQIECAAAECBPpYQAC0jytX0QgQIECAAAECBAgQIECAAAECBAgMuoAA6KAfAcpPgAABAgQIECBAgAABAgQIECBAoI8FBED7uHIVjQABAgQIECBAgAABAgQIECBAgMCgCwiADvoRoPwECBAgQIAAAQIECBAgQIAAAQIE+lhAALSPK1fRCBAgQIAAAQIECBAgQIAAAQIECAy6gADooB8Byk+AAAECBAgQIECAAAECBAgQIECgjwUEQPu4chWNAAECBAgQIECAAAECBAgQIECAwKALCIAO+hGg/AQIECBAgAABAgQIECBAgAABAgT6WEAAtI8rV9EIECBAgAABAgQIECBAgAABAgQIDLqAAOigHwHKT4AAAQIECBAgQIAAAQIECBAgQKCPBQRA+7hyFY0AAQIECBAgQIAAAQIECBAgQIDAoAsIgA76EaD8BAgQIECAAAECBAgQIECAAAECBPpYQAC0jytX0QgQIECAAAECBAgQIECAAAECBAgMuoAA6KAfAcpPgAABAgQIECBAgAABAgQIECBAoI8FBED7uHIVjQABAgQIECBAgAABAgQIECBAgMCgCwiADvoRoPwECBAgQIAAAQIECBAgQIAAAQIE+lhAALSPK1fRCBAgQIAAAQIECBAgQIAAAQIECAy6gADooB8Byk+AAAECBAgQIECAAAECBAgQIECgjwUEQPu4chWNAAECBAgQIECAAAECBAgQIECAwKALCIAO+hGg/AQIECBAgAABAgQIECBAgAABAgT6WEAAtI8rV9EIECBAgAABAgQIECBAgAABAgQIDLqAAOigHwHKT4AAAQIECBAgQIAAAQIECBAgQKCPBQRA+7hyFY0AAQIECBAgQIAAAQIECBAgQIDAoAsIgA76EaD8BAgQIECAAAECBAgQIECAAAECBPpYQAC0jytX0QgQIECAAAECBAgQIECAAAECBAgMuoAA6KAfAcpPgAABAgQIECBAgAABAgQIECBAoI8FBED7uHIVjQABAgQIECBAgAABAgQIECBAgMCgCwiADvoRoPwECBAgQIAAAQIECBAgQIAAAQIE+lhAALSPK1fRCBAgQIAAAQIECBAgQIAAAQIECAy6gADooB8Byk+AAAECBAgQIECAAAECBAgQIECgjwUEQPu4chWNAAECBAgQIECAAAECBAgQIECAwKALCIAO+hGg/AQIECBAgAABAgQIECBAgAABAgT6WEAAtI8rV9EIECBAgAABAgQIECBAgAABAgQIDLqAAOigHwHKT4AAAQIECBAgQIAAAQIECBAgQKCPBQRA+7hyFY0AAQIECBAgQIAAAQIECBAgQIDAoAsIgA76EaD8BAgQIECAAAECBAgQIECAAAECBPpYQAC0jytX0QgQIECAAAECBAgQIECAAAECBAgMuoAA6KAfAcpPgAABAgQIECBAgAABAgQIECBAoI8FBED7uHIVjQABAgQIECBAgAABAgQIECBAgMCgCwiADvoRoPwECBAgQIAAAQIECBAgQIAAAQIE+lhAALSPK1fRCBAgQIAAAQIECBAgQIAAAQIECAy6gADooB8Byk+AAAECBAgQIECAAAECBAgQIECgjwUEQPu4chWNAAECBAgQIECAAAECBAgQIECAwKALCIAO+hGg/AQIECBAgAABAgQIECBAgAABAgT6WEAAtI8rV9EIECBAgAABAgQIECBAgAABAgQIDLqAAOigHwHKT4AAAQIECBAgQIAAAQIECBAgQKCPBQRA+7hyFY0AAQIECBAgQIAAAQIECBAgQIDAoAsIgA76EaD8BAgQIECAAAECBAgQIECAAAECBPpYQAC0jytX0QgQIECAAAECBAgQIECAAAECBAgMuoAA6KAfAcpPgAABAgQIECBAgAABAgQIECBAoI8FBED7uHIVjQABAgQIECBAgAABAgQIECBAgMCgCwiADvoRoPwECBAgQIAAAQIECBAgQIAAAQIE+lhAALSPK1fRCBAgQIAAAQIECBAgQIAAAQIECAy6gADooB8Byk+AAAECBAgQIECAAAECBAgQIECgjwUEQPu4chWNAAECBAgQIECAAAECBAgQIECAwKALCIAO+hGg/AQIECBAgAABAgQIECBAgAABAgT6WEAAtI8rV9EIECBAgAABAgQIECBAgAABAgQIDLqAAOigHwHKT4AAAQIECBAgQIAAAQIECBAgQKCPBQRA+7hyFY0AAQIECBAgQIAAAQIECBAgQIDAoAsIgA76EaD8BAgQIECAAAECBAgQIECAAAECBPpYQAC0jytX0QgQIECAAAECBAgQIECAAAECBAgMuoAA6KAfAcpPgAABAgQIECBAgAABAgQIECBAoI8F/j/FfmOP+q5GvQAAAABJRU5ErkJggg==)
# Density plot for HDI using built-in graphics
Now for CPI, do the same things using ggplot
graphics. You must first load in the ggplot
library.
# Load in GGPlot library
library( ggplot2 )
Then make the plots
# GGPlot histogram
# GGPlot density Plot
# Overlay density on top of histogram using ggplot
Categorical Data
For data that has both categorical data and continuous data, we can display the data in several different ways.
Bar Plots
For standard bar plots, we will create a new data.frame
that has average values for the continuous variable across each of the levels of the categorical variable. You can do this manually or by using the by()
function. If you use by()
you’ll need to coerce it into a numeric data vector via as.numeric()
. If you need a reminder of this, check out this slide.
# Create new data.frame with averages for HDI by Region
Create a barplot using built-in graphics.
# barplot
GGPlot has several ways to look at these kinds of data. There is a Cheat Sheet for a bunch of ggplot
functions in Canvas (as well as GitHub from that link).
To create a bar plot in ggplot
one can use the geom_col()
geometric layer.
# geom_col plot
That plot looks great but the x-axis labels are all screwed up. To fix this you can add some customization to the theme by changing the text elements on the x axis. The code in the chunk below, when added to your plot code, will rotate the angle of the text by 45° and justified. Add your code to this chunk and see how this changes the axis labels (feel free to play around with them).
Note: You must change eval=FALSE
to eval=TRUE
to get this chunck to work. I had to set it to not run because the text {YOUR PLOT CODE HERE}
will not compile.
# Fix the axes
{YOUR PLOT CODE HERE} + theme(axis.text.x = element_text(angle = 45, hjust=1))
Box plots & others
A Boxplot needs all the data to be able to display the distribution of values, so we’ll be using the whole data frame again.
# boxplot of HDI by Region using built-in graphics.
Now the same using ggplot
.
# GGPlot geom_boxplot
The ggplot
library has additional ways to visualize these kinds of data. Look at the CheatSheet if you need assistance or the built-in help file for geom_violin
to make this plot.
# Look up geom_violin and use that for plotting
Adding Colors
Take the violin plot above and color each region in a different color.
# Colored violins
Continuous Bivariate Data
Using the built-in plot()
function create the following scatter plots. The plot characters and other customization are found on this slide from the lecture on built-in graphics.
# HDI as a function of CPI with Regions defined by plot character + legend
Use whatever color scheme you like.
# HDI as a function of CPI with Regions defined by color + legend
Now do the same with ggplot
using regions as either plot character or color.
# HDI as function of CPI with Region differences.
Labels
OK, so the last thing we are going to do is define a separate data.frame
that has just the labels so we can make it look a bit like the original plot. To do this, I define a new data.frame with just the countries that I’m interested in plotting.
Country <- c("Russia", "Venezuela", "Iraq", "Myanmar", "Sudan",
"Afghanistan", "Congo", "Greece", "Argentina", "Brazil",
"India", "Italy", "China", "South Africa", "Spane",
"Botswana", "Cape Verde", "Bhutan", "Rwanda", "France",
"United States", "Germany", "Britain", "Barbados", "Norway",
"Japan","New Zealand", "Singapore")
df.labels <- data.frame( Country )
Next, I take this new data.frame and the original one and use the merge()
function.
What this function requires is that the two data.frames must have a colum with the same name. In this case, both the original data.frame had one named Country
as did the new one. I’m assuming that the original data was loaded in as the variable df
as requested above—if you named it something else, then replace your variable name with the df
in the first line of the code below.
df.labels <- merge( df.labels, df)
df.labels
Now, let’s load in the ggrepel
library and use both of these data.frames to add labels to a scatter plot. To do this, you’ll have to use the full data frame to lay down a geom_point()
layer and then add the geom_text_repel()
layer using the other df.labels
data.frame. To make it look right, you may need to futz around with the various data mappings in the aes
functions. See this slide for a refresher on what ggrepel
needs to do its job.
# GGRepel
library( ggrepel )
LS0tCnRpdGxlOiAiR3JhcGhpY3MgaW4gUiIKYXV0aG9yOiAiWW91ciBOYW1lIEhlcmUiCm91dHB1dDogCiAgaHRtbF9ub3RlYm9vazoKICAgIGZpZ19jYXB0aW9uOiB5ZXMKLS0tCgojIFRoZSBEYXRhCgpGb3IgdGhpcyBob21ld29yayB3ZSB3aWxsIGJlIHdvcmtpbmcgd2l0aCB0aGUgZGF0YSB0aGF0IHdlcmUgdXNlZCBpbiB0aGUgbGVjdHVyZSBvbiBgZ2dwbG90YCBmcm9tIHRoZSAyMDExICpUaGUgRWNvbm9taXN0KiBhcnRpY2xlIGxvb2tpbmcgYXQgdGhlIHJlbGF0aW9uc2hpcCBiZXR3ZWVuIGh1bWFuIGRldmVsb3BtZW50IGFuZCBwZXJjZWl2ZWQgY29ycnVwdGlvbi4KCiFbKkZpZ3VyZSAxOiogVGhlIHJlbGF0aW9uc2hpcCBiZXR3ZWVuIHRoZSBwZXJjZXB0aW9uIG9mIGNvcnJ1cHRpb24gYW5kIHRoZSBodW1hbiBkZXZlbG9wbWVudCBpbmRleCBmcm9tIDIwMTEgZm9yIDE3NCBuYXRpb25zIHN0YXRlcy5dKGh0dHBzOi8vbGl2ZS5zdGF0aWNmbGlja3IuY29tLzY1NTM1LzUwMjk0NDEyNzEzXzI1YmJkNTIyMzBfY19kLmpwZykKClRoZSBkYXRhIGFyZSBsb2NhdGVkIG9uIHRoZSBbY2xhc3MgR2l0SHViIHNpdGVdKGh0dHBzOi8vZ2l0aHViLmNvbS9keWVybGFiL0VOVlMtTGVjdHVyZXMpIGFuZCBjYW4gYmUgYWNjZXNzZWQgYnkgdGhlIGZvbGxvd2luZyBVUkwsIHdoaWNoIGlzIGJlaW5nIHByZXNlbnRlZCBhcyBhIENTViBmaWxlLgoKYGBge3J9CiMgVGhlIFVSTCBmb3IgdGhlIGRhdGEgb24gR2l0SHViCnVybCA8LSAiaHR0cHM6Ly9yYXcuZ2l0aHVidXNlcmNvbnRlbnQuY29tL2R5ZXJsYWIvRU5WUy1MZWN0dXJlcy9tYXN0ZXIvZGF0YS9FY29ub21pc3REYXRhLmNzdiIKYGBgCgpVc2UgdGhlIFVSTCBhYm92ZSBhbmQgbG9hZCB0aGUgZGF0YSBpbnRvIFIgYW5kIHByZXNlbnQgYSBzdW1tYXJ5LiAgTmFtZSB0aGlzIGRhdGEgZnJhbWUgYGRmYCBiZWNhdXNlIHNvbWUgY29kZSBiZWxvdyB0aGF0IEkgZ2l2ZSBhc3N1bWVzIHRoYXQgbmFtZS4KCmBgYHtyfQojIyBMb2FkIHRoZSBkYXRhIGhlcmUuCmxpYnJhcnkoIHJlYWRyICkKCmRmIDwtIHJlYWRfY3N2KCB1cmwgKQpgYGAKCkFzIGl0IHN0YW5kcywgd2UgYXJlIGdvaW5nIHRvIG5lZWQgdG8gdHVybiB0aGUgYFJlZ2lvbmAgY29sdW1uIGZyb20gYSByYXcgYGNoYXJhY3RlcmAgdHlwZSB0byBhIGBmYWN0b3JgIGRhdGEgdHlwZS4gIFRvIHRvIHRoaXMsIHdlIGNhbiB1c2UgdGhlIGZ1bmN0aW9uIGBhcy5mYWN0b3IoKWAgYW5kIGFzc2lnbiBpdCBiYWNrIHRvIHRoZSBgZGF0YS5mcmFtZWAuCgoKYGBge3J9CiMgVHVybiBSZWdpb24gaW50byBmYWN0b3IKCmRmJFJlZ2lvbiA8LSBhcy5mYWN0b3IoIGRmJFJlZ2lvbiAgKQpgYGAKCgoqSW4gYWxsIHRoZSBwbG90IG9uIHRoaXMgaG9tZXdvcmssIHlvdSBtdXN0IG1ha2UgYW4gbGVnZW5kIHdoZW4gYXBwcm9wcmlhdGUgYW5kIGxhYmVsIHRoZSBheGVzIHByb3Blcmx5LioKCgojIFVuaXZhcmlhdGUgRGF0YQoKRm9yIHRoaXMgc2VjdGlvbiwgZm9jdXMgb24gaGlzdG9ncmFtcyBhbmQgZGVuc2l0eSBwbG90cy4gIENyZWF0ZSBhIGhpc3RvcmdyYW0gcGxvdCBhbmQgYSBkZW5zaXR5IHBsb3QsIG9uZSBmb3IgYnVpbHQtaW4gZ3JhcGhpY3MgYW5kIHRoZSBvdGhlciB1c2luZyBgZ2dwbG90YC4gIEZlZWwgZnJlZSB0byBlbWJlbGxpc2ggdGhlbSBhcyB5b3UgcGxlYXNlIGJ1dCB5b3UgKiptdXN0KiogaGF2ZSBwcm9wZXJseSBsYWJlbGVkIGF4ZXMuCgpgYGB7cn0KIyBCdWlsdC1pbiBoaXN0IGZvciBIREkKbWVhbkhESSA8LSBieSggZGYkSERJLCBkZiRSZWdpb24sIG1lYW4pCmJhcnBsb3QoIG1lYW5IREkgKQoKCgpgYGAKCmBgYHtyfQojIERlbnNpdHkgcGxvdCBmb3IgSERJIHVzaW5nIGJ1aWx0LWluIGdyYXBoaWNzCgpgYGAKCk5vdyBmb3IgQ1BJLCBkbyB0aGUgc2FtZSB0aGluZ3MgdXNpbmcgYGdncGxvdGAgZ3JhcGhpY3MuICBZb3UgbXVzdCBmaXJzdCBsb2FkIGluIHRoZSBgZ2dwbG90YCBsaWJyYXJ5LgoKYGBge3J9CiMgTG9hZCBpbiBHR1Bsb3QgbGlicmFyeQpsaWJyYXJ5KCBnZ3Bsb3QyICkKYGBgCgpUaGVuIG1ha2UgdGhlIHBsb3RzCgpgYGB7cn0KIyBHR1Bsb3QgaGlzdG9ncmFtCmBgYAoKYGBge3J9CiMgR0dQbG90IGRlbnNpdHkgUGxvdApgYGAKCmBgYHtyfQojIE92ZXJsYXkgZGVuc2l0eSBvbiB0b3Agb2YgaGlzdG9ncmFtIHVzaW5nIGdncGxvdApgYGAKCgojIENhdGVnb3JpY2FsIERhdGEKCkZvciBkYXRhIHRoYXQgaGFzIGJvdGggY2F0ZWdvcmljYWwgZGF0YSBhbmQgY29udGludW91cyBkYXRhLCB3ZSBjYW4gZGlzcGxheSB0aGUgZGF0YSBpbiBzZXZlcmFsIGRpZmZlcmVudCB3YXlzLiAgCgojIyBCYXIgUGxvdHMgCgpGb3Igc3RhbmRhcmQgYmFyIHBsb3RzLCB3ZSB3aWxsIGNyZWF0ZSBhIG5ldyBgZGF0YS5mcmFtZWAgdGhhdCBoYXMgYXZlcmFnZSB2YWx1ZXMgZm9yIHRoZSBjb250aW51b3VzIHZhcmlhYmxlIGFjcm9zcyBlYWNoIG9mIHRoZSBsZXZlbHMgb2YgdGhlIGNhdGVnb3JpY2FsIHZhcmlhYmxlLiAgWW91IGNhbiBkbyB0aGlzIG1hbnVhbGx5IG9yIGJ5IHVzaW5nIHRoZSBgYnkoKWAgZnVuY3Rpb24uICBJZiB5b3UgdXNlIGBieSgpYCB5b3UnbGwgbmVlZCB0byBjb2VyY2UgaXQgaW50byBhIG51bWVyaWMgZGF0YSB2ZWN0b3IgdmlhIGBhcy5udW1lcmljKClgLiAgSWYgeW91IG5lZWQgYSByZW1pbmRlciBvZiB0aGlzLCBjaGVjayBvdXQgW3RoaXMgc2xpZGVdKGh0dHBzOi8vZHllcmxhYi5naXRodWIuaW8vRU5WUy1MZWN0dXJlcy92aXN1YWxpemF0aW9uL2Jhc2ljX3Zpc3VhbGl6YXRpb24vc2xpZGVzLmh0bWwjNTEpLgoKYGBge3J9CiMgQ3JlYXRlIG5ldyBkYXRhLmZyYW1lIHdpdGggYXZlcmFnZXMgZm9yIEhESSBieSBSZWdpb24KYGBgCgpDcmVhdGUgYSBiYXJwbG90IHVzaW5nIGJ1aWx0LWluIGdyYXBoaWNzLgoKYGBge3J9CiMgYmFycGxvdApgYGAKCkdHUGxvdCBoYXMgc2V2ZXJhbCB3YXlzIHRvIGxvb2sgYXQgdGhlc2Uga2luZHMgb2YgZGF0YS4gIFRoZXJlIGlzIGEgW0NoZWF0IFNoZWV0XShodHRwczovL2dpdGh1Yi5jb20vcnN0dWRpby9jaGVhdHNoZWV0cy9ibG9iL21hc3Rlci9kYXRhLXZpc3VhbGl6YXRpb24tMi4xLnBkZikgZm9yIGEgYnVuY2ggb2YgYGdncGxvdGAgZnVuY3Rpb25zIGluIENhbnZhcyAoYXMgd2VsbCBhcyBHaXRIdWIgZnJvbSB0aGF0IGxpbmspLiAgCgpUbyBjcmVhdGUgYSBiYXIgcGxvdCBpbiBgZ2dwbG90YCBvbmUgY2FuIHVzZSB0aGUgYGdlb21fY29sKClgIGdlb21ldHJpYyBsYXllci4gIAoKYGBge3J9CiMgZ2VvbV9jb2wgcGxvdApgYGAKClRoYXQgcGxvdCBsb29rcyBncmVhdCBidXQgdGhlIHgtYXhpcyBsYWJlbHMgYXJlIGFsbCBzY3Jld2VkIHVwLiAgVG8gZml4IHRoaXMgeW91IGNhbiBhZGQgc29tZSBjdXN0b21pemF0aW9uIHRvIHRoZSB0aGVtZSBieSBjaGFuZ2luZyB0aGUgdGV4dCBlbGVtZW50cyBvbiB0aGUgeCBheGlzLiAgVGhlIGNvZGUgaW4gdGhlIGNodW5rIGJlbG93LCB3aGVuIGFkZGVkIHRvIHlvdXIgcGxvdCBjb2RlLCB3aWxsIHJvdGF0ZSB0aGUgYW5nbGUgb2YgdGhlIHRleHQgYnkgNDXCsCBhbmQganVzdGlmaWVkLiAgQWRkIHlvdXIgY29kZSB0byB0aGlzIGNodW5rIGFuZCBzZWUgaG93IHRoaXMgY2hhbmdlcyB0aGUgYXhpcyBsYWJlbHMgKGZlZWwgZnJlZSB0byBwbGF5IGFyb3VuZCB3aXRoIHRoZW0pLiAgCgpOb3RlOiBZb3UgKm11c3QqIGNoYW5nZSBgZXZhbD1GQUxTRWAgdG8gYGV2YWw9VFJVRWAgdG8gZ2V0IHRoaXMgY2h1bmNrIHRvIHdvcmsuICBJIGhhZCB0byBzZXQgaXQgdG8gbm90IHJ1biBiZWNhdXNlIHRoZSB0ZXh0IGB7WU9VUiBQTE9UIENPREUgSEVSRX1gIHdpbGwgbm90IGNvbXBpbGUuCgpgYGB7ciBldmFsPUZBTFNFfQojIEZpeCB0aGUgYXhlcwp7WU9VUiBQTE9UIENPREUgSEVSRX0gKyB0aGVtZShheGlzLnRleHQueCA9IGVsZW1lbnRfdGV4dChhbmdsZSA9IDQ1LCBoanVzdD0xKSkKYGBgCgojIyBCb3ggcGxvdHMgJiBvdGhlcnMKCkEgQm94cGxvdCBuZWVkcyBhbGwgdGhlIGRhdGEgdG8gYmUgYWJsZSB0byBkaXNwbGF5IHRoZSBkaXN0cmlidXRpb24gb2YgdmFsdWVzLCBzbyB3ZSdsbCBiZSB1c2luZyB0aGUgd2hvbGUgZGF0YSBmcmFtZSBhZ2Fpbi4KCmBgYHtyfQojIGJveHBsb3Qgb2YgSERJIGJ5IFJlZ2lvbiB1c2luZyBidWlsdC1pbiBncmFwaGljcy4KYGBgCgpOb3cgdGhlIHNhbWUgdXNpbmcgYGdncGxvdGAuCgpgYGB7cn0KIyBHR1Bsb3QgZ2VvbV9ib3hwbG90CmBgYAoKVGhlIGBnZ3Bsb3RgIGxpYnJhcnkgaGFzIGFkZGl0aW9uYWwgd2F5cyB0byB2aXN1YWxpemUgdGhlc2Uga2luZHMgb2YgZGF0YS4gTG9vayBhdCB0aGUgQ2hlYXRTaGVldCBpZiB5b3UgbmVlZCBhc3Npc3RhbmNlIG9yIHRoZSBidWlsdC1pbiBoZWxwIGZpbGUgZm9yIGBnZW9tX3Zpb2xpbmAgdG8gbWFrZSB0aGlzIHBsb3QuCgoKCmBgYHtyfQojIExvb2sgdXAgZ2VvbV92aW9saW4gYW5kIHVzZSB0aGF0IGZvciBwbG90dGluZwpgYGAKCiMjIyBBZGRpbmcgQ29sb3JzCgpUYWtlIHRoZSB2aW9saW4gcGxvdCBhYm92ZSBhbmQgY29sb3IgZWFjaCByZWdpb24gaW4gYSBkaWZmZXJlbnQgY29sb3IuICAKCmBgYHtyfQojIENvbG9yZWQgdmlvbGlucwpgYGAKCgojIENvbnRpbnVvdXMgQml2YXJpYXRlIERhdGEKClVzaW5nIHRoZSBidWlsdC1pbiBgcGxvdCgpYCBmdW5jdGlvbiBjcmVhdGUgdGhlIGZvbGxvd2luZyBzY2F0dGVyIHBsb3RzLiBUaGUgcGxvdCBjaGFyYWN0ZXJzIGFuZCBvdGhlciBjdXN0b21pemF0aW9uIGFyZSBmb3VuZCBvbiBbdGhpcyBzbGlkZV0oaHR0cHM6Ly9keWVybGFiLmdpdGh1Yi5pby9FTlZTLUxlY3R1cmVzL3Zpc3VhbGl6YXRpb24vYmFzaWNfdmlzdWFsaXphdGlvbi9zbGlkZXMuaHRtbCMyOCkgZnJvbSB0aGUgbGVjdHVyZSBvbiBidWlsdC1pbiBncmFwaGljcy4KCgpgYGB7cn0KIyBIREkgYXMgYSBmdW5jdGlvbiBvZiBDUEkgd2l0aCBSZWdpb25zIGRlZmluZWQgYnkgcGxvdCBjaGFyYWN0ZXIgICsgbGVnZW5kCmBgYAoKVXNlIHdoYXRldmVyIGNvbG9yIHNjaGVtZSB5b3UgbGlrZS4KCmBgYHtyfQojIEhESSBhcyBhIGZ1bmN0aW9uIG9mIENQSSB3aXRoIFJlZ2lvbnMgZGVmaW5lZCBieSBjb2xvciArIGxlZ2VuZApgYGAKCk5vdyBkbyB0aGUgc2FtZSB3aXRoIGBnZ3Bsb3RgIHVzaW5nIHJlZ2lvbnMgYXMgZWl0aGVyIHBsb3QgY2hhcmFjdGVyIG9yIGNvbG9yLgoKYGBge3J9CiMgSERJIGFzIGZ1bmN0aW9uIG9mIENQSSB3aXRoIFJlZ2lvbiBkaWZmZXJlbmNlcy4KYGBgCgoKCiMgTGFiZWxzCgpPSywgc28gdGhlIGxhc3QgdGhpbmcgd2UgYXJlIGdvaW5nIHRvIGRvIGlzIGRlZmluZSBhIHNlcGFyYXRlIGBkYXRhLmZyYW1lYCB0aGF0IGhhcyBqdXN0IHRoZSBsYWJlbHMgc28gd2UgY2FuIG1ha2UgaXQgbG9vayBhIGJpdCBsaWtlIHRoZSBvcmlnaW5hbCBwbG90LiAgVG8gZG8gdGhpcywgSSBkZWZpbmUgYSBuZXcgZGF0YS5mcmFtZSB3aXRoIGp1c3QgdGhlIGNvdW50cmllcyB0aGF0IEknbSBpbnRlcmVzdGVkIGluIHBsb3R0aW5nLgoKYGBge3J9CkNvdW50cnkgPC0gYygiUnVzc2lhIiwgIlZlbmV6dWVsYSIsICJJcmFxIiwgIk15YW5tYXIiLCAiU3VkYW4iLAogICAgICAgICAgICAgIkFmZ2hhbmlzdGFuIiwgIkNvbmdvIiwgIkdyZWVjZSIsICJBcmdlbnRpbmEiLCAiQnJhemlsIiwgCiAgICAgICAgICAgICAiSW5kaWEiLCAiSXRhbHkiLCAiQ2hpbmEiLCAiU291dGggQWZyaWNhIiwgIlNwYW5lIiwgCiAgICAgICAgICAgICAiQm90c3dhbmEiLCAiQ2FwZSBWZXJkZSIsICJCaHV0YW4iLCAiUndhbmRhIiwgIkZyYW5jZSIsIAogICAgICAgICAgICAgIlVuaXRlZCBTdGF0ZXMiLCAiR2VybWFueSIsICJCcml0YWluIiwgIkJhcmJhZG9zIiwgIk5vcndheSIsIAogICAgICAgICAgICAgIkphcGFuIiwiTmV3IFplYWxhbmQiLCAiU2luZ2Fwb3JlIikKZGYubGFiZWxzIDwtIGRhdGEuZnJhbWUoIENvdW50cnkgKQpgYGAKCk5leHQsIEkgdGFrZSB0aGlzIG5ldyBkYXRhLmZyYW1lIGFuZCB0aGUgb3JpZ2luYWwgb25lIGFuZCB1c2UgdGhlIGBtZXJnZSgpYCBmdW5jdGlvbi4KCiFbKkZpZ3VyZSAyOiogSGVscCBmaWxlIGZvciBgbWVyZ2UoKWAuXShodHRwczovL2xpdmUuc3RhdGljZmxpY2tyLmNvbS82NTUzNS81MDM0ODcwMDU4Nl9jOWVlNjgxNDk0X2NfZC5qcGcpCgpXaGF0IHRoaXMgZnVuY3Rpb24gKnJlcXVpcmVzKiBpcyB0aGF0IHRoZSB0d28gZGF0YS5mcmFtZXMgKiptdXN0KiogaGF2ZSBhIGNvbHVtIHdpdGggdGhlIHNhbWUgbmFtZS4gIEluIHRoaXMgY2FzZSwgYm90aCB0aGUgb3JpZ2luYWwgZGF0YS5mcmFtZSBoYWQgb25lIG5hbWVkIGBDb3VudHJ5YCBhcyBkaWQgdGhlIG5ldyBvbmUuICBJJ20gYXNzdW1pbmcgdGhhdCB0aGUgb3JpZ2luYWwgZGF0YSB3YXMgbG9hZGVkIGluIGFzIHRoZSB2YXJpYWJsZSBgZGZgIGFzIHJlcXVlc3RlZCBhYm92ZeKAlGlmIHlvdSBuYW1lZCBpdCBzb21ldGhpbmcgZWxzZSwgdGhlbiByZXBsYWNlIHlvdXIgdmFyaWFibGUgbmFtZSB3aXRoIHRoZSBgZGZgIGluIHRoZSBmaXJzdCBsaW5lIG9mIHRoZSBjb2RlIGJlbG93LgoKYGBge3J9CmRmLmxhYmVscyA8LSBtZXJnZSggZGYubGFiZWxzLCBkZikKZGYubGFiZWxzCmBgYAoKCk5vdywgbGV0J3MgbG9hZCBpbiB0aGUgYGdncmVwZWxgIGxpYnJhcnlbXjFdIGFuZCB1c2UgYm90aCBvZiB0aGVzZSBkYXRhLmZyYW1lcyB0byBhZGQgbGFiZWxzIHRvIGEgc2NhdHRlciBwbG90LiAgVG8gZG8gdGhpcywgeW91J2xsIGhhdmUgdG8gdXNlIHRoZSBmdWxsIGRhdGEgZnJhbWUgdG8gbGF5IGRvd24gYSBgZ2VvbV9wb2ludCgpYCBsYXllciBhbmQgdGhlbiBhZGQgdGhlIGBnZW9tX3RleHRfcmVwZWwoKWAgbGF5ZXIgdXNpbmcgdGhlIG90aGVyIGBkZi5sYWJlbHNgIGRhdGEuZnJhbWUuIFRvIG1ha2UgaXQgbG9vayByaWdodCwgeW91IG1heSBuZWVkIHRvIGZ1dHogYXJvdW5kIHdpdGggdGhlIHZhcmlvdXMgZGF0YSBtYXBwaW5ncyBpbiB0aGUgYGFlc2AgZnVuY3Rpb25zLiAgU2VlIFt0aGlzIHNsaWRlXShodHRwczovL2R5ZXJsYWIuZ2l0aHViLmlvL0VOVlMtTGVjdHVyZXMvdmlzdWFsaXphdGlvbi9nZ3Bsb3RfZ3JhcGhpY3Mvc2xpZGVzLmh0bWwjNjIpIGZvciBhIHJlZnJlc2hlciBvbiB3aGF0IGBnZ3JlcGVsYCBuZWVkcyB0byBkbyBpdHMgam9iLgoKYGBge3J9CiMgR0dSZXBlbCAKbGlicmFyeSggZ2dyZXBlbCApCmBgYAoKCgoKCgoKClteMV06IElmIHlvdSBnZXQgYW4gZXJyb3Igd2hlbiB0cnlpbmcgdG8gbG9hZCBpbiB0aGUgZ2dyZXBlbCBsaWJyYXJ5IHNheWluZyBpdCBjb3VsZCBub3QgZmluZCB0aGUgbGlicmFyeSwgdGhlbiBpbnN0YWxsIGl0IHVzaW5nIGBpbnN0YWxsLnBhY2thZ2VzKCJnZ3JlcGVsIilgLgoKCg==