{"cells": [{"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "slide"}, "tags": ["remove_cell"]}, "source": ["\n", " \n", " \n", " \n", " \n", " \n", " \n", "
\n", " \"Matplotlib\"\n", "
\n", " https://matplotlib.org\n", "
\n", " "]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "notes"}}, "source": ["Matplotlib is one of the oldest scientific visualization and plotting libraries available in Python. While it's not always the easiest to use (the commands can be verbose) it is the most powerful. Virtually any two-dimensional scientific visualization can be created with Matplotlib. The expansive [example gallery](https://matplotlib.org/gallery/index.html) shows the wide variety of images that can be generated with Matplotlib."]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "notes"}, "tags": ["popout"]}, "source": ["The highly publicized first images of a black hole where produced with Matplotlib."]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "subslide"}}, "source": ["
\n", " \n", "
Image credit: Event Horizon Telescope Collaboration
\n", "
"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "slide"}}, "source": ["## Two-dimensional plots"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}, "tags": ["popout"]}, "source": ["**Axes** should not be confused with **axis**. An *Axes* is the area of the plot containing the lines/points/markers of data. *Axis* are the coordinate axis of the plot. See the figure for reference."]}, {"cell_type": "markdown", "metadata": {}, "source": ["A Matplotlib plot contains\n", "\n", " * One or more `Axes` which each contain an individual plot\n", "\n", " * A `Figure` which is the final image containing one or more Axes"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}, "tags": ["popout"]}, "source": ["
\n", " \n", "
Image credit: Matplotlib 1.5.1 FAQ
\n", "
"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["*Axes* are what are traditionally thought of as the *area* of the plot. These can contain the actual coordinate axis and tick marks, the lines or line markers for the data being plotting, legend, title, axis labels, etc. The *Figure* can contain more than one `Axes`. These `Axes` could appear side-by-side or in a grid, or they can appear essentially on top of one another where they share an $x$ or $y$ axis. The `Figure` can also contain a color bar in a contour or surface plot and a title."]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["The following figure taken from the [Matplotlib FAQ](https://matplotlib.org/faq/usage_faq.html) is useful reference identifying the different parts of a two-dimensional plot."]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "subslide"}}, "source": ["
\n", " \n", "
Image credit: Matplotlib FAQ
\n", "
\n"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "slide"}}, "source": ["## Basic Example"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["The easiest way to learn Matplotlib is with illustrative examples. In this example we'll instantiate `Figure` and `Axes` objects with [`matplotlib.pyplot.subplots`](https://matplotlib.org/api/_as_gen/matplotlib.pyplot.subplots.html). Then add some data and a label to the `Axes`."]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}, "tags": ["popout"]}, "source": ["There are several convenience functions in Matplotlib for creating the `Figure` and `Axes` objects. [`figure`](https://matplotlib.org/api/_as_gen/matplotlib.pyplot.figure.html#matplotlib.pyplot.figure) and [`subplots`](https://matplotlib.org/api/_as_gen/matplotlib.pyplot.subplots.html) are the most common. You can use `subplots` even if your intention is to create a single figure."]}, {"cell_type": "code", "execution_count": 1, "metadata": {"slideshow": {"slide_type": "-"}}, "outputs": [{"data": {"image/png": "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\n", "text/plain": ["
"]}, "metadata": {"needs_background": "light"}, "output_type": "display_data"}], "source": ["import matplotlib.pyplot as plt\n", "\n", "fig, ax = plt.subplots()\n", "\n", "ax.plot([0, 1, 2, 3])\n", "ax.set_xlabel(\"Some Numbers\");"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "subslide"}}, "source": ["### Changing the plot style "]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["There are many options for changing the plot style. You have ultimate control over the entire look and feel. In the example below, we only add grid lines; however, you can adjust major and minor tic marks on the axis, change fonts, remove an axis or the entire frame, add a title, etc. With the [`Artist`](https://matplotlib.org/tutorials/intermediate/artists.html) class, you can add annotations and adjust colors, basically you have full control over anything that can be rendered on the canvas."]}, {"cell_type": "code", "execution_count": 2, "metadata": {"slideshow": {"slide_type": "-"}}, "outputs": [{"data": {"image/png": "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\n", "text/plain": ["
"]}, "metadata": {"needs_background": "light"}, "output_type": "display_data"}], "source": ["fig, ax = plt.subplots()\n", "\n", "ax.plot([0, 1, 2, 3])\n", "ax.set_xlabel(\"Some Numbers\");\n", "ax.grid()"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "subslide"}}, "source": ["### Use NumPy data"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["In the previous example, we input data as a Python list for plotting. However, Matplotlib has full support for using NumPy arrays as input data for plots. The following example illustrates the use of NumPy. First, we create a list of numbers ranging from $0$ to $5$ in steps of $0.2$ to be used as the independent variable $t$ in the plot. Then we plot linear, quadradic, and cubic polynomials as a function of $t$."]}, {"cell_type": "code", "execution_count": 3, "metadata": {"slideshow": {"slide_type": "-"}}, "outputs": [{"data": {"image/png": "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\n", "text/plain": ["
"]}, "metadata": {"needs_background": "light"}, "output_type": "display_data"}], "source": ["import numpy as np\n", "\n", "t = np.arange(0,5,0.2)\n", "\n", "fig, ax = plt.subplots()\n", "ax.plot(t, t, 'b', label='linear')\n", "ax.plot(t, t ** 2, 'k', label='quadratic')\n", "ax.plot(t, t ** 3, 'r', label='cubic')\n", "ax.set_xlabel(r'$t$')\n", "ax.grid()\n", "ax.legend(); "]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "subslide"}}, "source": ["## Built in styles"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["Matplotlib has several built in \"styles\" that add some default design styling to background colors, fonts, and line colors, etc."]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["This example uses the style `'fivethirtyeight'` which is based on a style made popular by Nate Silver's [FiveThirtyEight](https://fivethirtyeight.com/) website."]}, {"cell_type": "code", "execution_count": 4, "metadata": {"slideshow": {"slide_type": "-"}}, "outputs": [{"data": {"image/png": "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\n", "text/plain": ["
"]}, "metadata": {}, "output_type": "display_data"}], "source": ["import matplotlib\n", "\n", "matplotlib.style.use('fivethirtyeight')\n", "\n", "t = np.arange(0,5,0.2)\n", "fig, ax = plt.subplots()\n", "\n", "ax.plot(t, t, 'b')\n", "ax.plot(t, t ** 2, 'k')\n", "ax.plot(t, t ** 3, 'r');"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "subslide"}}, "source": ["### XKCD"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["There is even a style meant to mimic the drawing style of the popular web comic [XKCD](https://xkcd.com). While it may seem superfluous that this style is included in Matplotlib, it can actually be a useful style if you are trying to indicate trends between variables, but want to remove any notion that the dataset being plotted is real."]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}, "tags": ["popout"]}, "source": ["Because it's unlikely that you would ever want to use this style for more than a few plots, it's recommended to place the plotting code under a `with` statement which will cause this styling to only be utilized on the code within its indentation block."]}, {"cell_type": "code", "execution_count": 5, "metadata": {"slideshow": {"slide_type": "skip"}, "tags": ["remove_cell"]}, "outputs": [], "source": ["matplotlib.style.use('default')"]}, {"cell_type": "code", "execution_count": 6, "metadata": {"slideshow": {"slide_type": "-"}}, "outputs": [{"data": {"image/png": "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XC7XBXb/+7//e1YqldQeXkNw5swZ5nQ6GQDmdrvVHk7dcv/9919wno88JElifX194/48ithMkHQ6jY0bN+LEiRPYsGEDHn/8cXg8Hjz//PP4xje+gXvvvRdXXnklOjo61B5qXfKTn/wEDz74IKrVKgBAkiSVR1TfnD59GuvWrcOpU6ewdu1afPazn4XT6cSPf/xjvPzyy7jvvvtw7NgxitxMMr29vXjwwQdhMBjwj//4j1i7di0GBgawfft2bN++He973/tw//33qz3MuqZareJTn/oUkskkNBqN2sOpa1atWgUA+PjHP467774bBoMBer0exWIRJpMJ73//+ye2IeYUirC65LHHHmMA2Cc+8QlWrVZHPfeTn/yEAWD33XefSqOrf9asWcMcDgfbvHkzA8C2bdum9pDqmn/7t39jANgXv/jFUVGCarXK1qxZwwCwvXv3qjjC+qRSqbAf/OAH7J133hn1+MDAANPpdOzGG29UaWSNw5NPPskAsI997GPM7/dTxGYK+eY3v8kAsGeffXZSPo/62EyQlStX4u2338apU6cwb968Uc8Vi0U4HA643W4MDg6Syp8CotEoNBoNfvWrX+H+++/Htm3b8L3vfU/tYdUtjDFEo1H4fL4Lnlu1ahWOHDmCN998E9dcc40Ko2s8KpUKfD4fFi5ciDfffFPt4dQtPT09WL16NSwWC7q6urBixQqUy2XEYjG1h1aXfO5zn8MPf/hD7N69G+3t7fjtb3+LUCiEtrY2bNmyBTabbUKfR6moCTA4OIi33noL69atu0DUAIDRaMTq1auxf/9+dHd3UzpqCvB6vQCAZDIJALDb7WoOp+7RaDRjiprdu3fjyJEjcLvdWLFihQojazwGBwfxzW9+E4lEAuvXr1d7OHVLuVzGfffdh1wuh6effhqBQEDtIdU9g4ODAIAvfOELOHz48Kjnvva1r+G5557DX//1X4/782i59wQQBl+2bNlFXzN//nwAwNDQ0HQMqWGJRqMAQJOOCuzevRt33303AOArX/kKjEajyiOqX7LZLLZt24bly5ejtbUV27dvx1VXXYWvfe1rag+tbvn2t7+NN954A+vXr6c6pmlCCJvDhw/jyiuvxBNPPIGXXnoJn/3sZxEOh7F58+YJRcsoYjMBMpkMAIx5BSvQarWjbompQQibpqYmlUfSOJRKJTz88MP49re/DcYYPv/5z2Pbtm1qD6uu6evrw1NPPYVCoQAAsNls+MY3vkGRyini0KFDePTRRyFJEp599lkqJ5gmRCBg/fr12LFjh7Kse9OmTWCM4amnnsIrr7wybqFJ3ncCmM1mABdurT6SeDwOABPOCRITIxKJAACam5tVHklj0NfXh7/6q7/Ct771LXg8Hrz44ov4/ve/TwJ+ilmxYgWGhoawc+dOPPDAA8jlcrjrrrvw7LPPqj20uiMcDmPTpk0ol8v453/+ZxgMBsRiMciyDCpFnVo+/OEP44477sAvf/nLC3rVbNq0CQCwd+/e8X/gpJQgNwiHDx9mANgdd9xx0desWrWKaTQalkgkpnFkjYfoq9LV1aX2UOqeAwcOMK/XywCwO++8kw0NDak9pIblueeeU3oIUS+byeXTn/70JXupAGA6nY7dcsstrFwuqz3chqG7u5sBYLfeeuu430OpqAnQ0dEBo9GII0eOjPl8IpHAW2+9hWXLlk1szT0xYURoftydKImaYIzhE5/4BKLRKB555BE88sgjFJ5XkS1btuCRRx5BX18f+vv7lZo+4vK54447kM1mIcsyisWichQKBRw8eBDVahULFiyAzWajSOU0EgqFAAAOh2Pc7yFhMwGMRiNWrVqFP//5z+jp6bmgiHjHjh2oVqu47rrrVBph4yBSfZdKCxKXz8GDB9HV1YVrrrmGRM00EgqFcPr0aaxZs2bU41qtFn6/H319fSqNrH7ZuHEjNm7cOOZzgUAA5XIZvb290zwq4uc//zkAYN26deN+D8nOCSKKl7Zu3QpZlpXHDx8+jK9+9asAgHvuuUeVsTUSYtm3KCImpoZ9+/YB4B1BNRoNGGPIZDIIh8OIxWJUezBFfO5zn8PatWvx2muvjXr8wIEDOHjwIK688kq0t7erNLrGgwT91MEYw5YtW/DlL3/5gvnk9ddfxzPPPAO9Xo+PfvSjE/pQYgIUi0Vln6j29nb29a9/nW3dupVZLBYGgN12220XdCQmJo+nn36a3XjjjaylpYUBYIsXL2Y333wzS6VSag+tLnn88ccZANbS0sICgQDTarWjag6WL1/Ouru71R5m3bFjxw4GgNlsNrZ161b21FNPsa1btzKr1coAsJ/+9KdqD7GhcLvd1Hl4iqhWq2zRokUMALvnnnvYK6+8wnbu3Mn+4R/+gZnNZgaAPfrooxP6TBI2NZBKpdjnP//5UZO81WplX/nKV8jBTjHr1q27oKDP4/GwYDCo9tDqkn379jGXy8U0Gg1rbm5mHR0drLOzk61bt46tWbOGmUwm2ghzCqhWq+yZZ55hNpvtgo12f/jDH6o9vIajs7OTtbe3qz2MuuWdd95hnZ2dF8ztdrudPfbYYxMOFtCWCpdBb28vjhw5AoPBgLVr11JPlWmEcVEOgIeJKVQ8dTDGUK1WodPpxnyObD91ZDIZ/O///i/6+/vh9/tx66230oajKhAKhZDP58fsOE9MDowxvPrqq3jttddQKBTQ0dGBj3/84zVtdEzChiAIgiCIuoGKhwmCIAiCqBtI2BAEQRAEUTeQsCEIgiAIom4gYUMQBEEQRN1AwoYgCIIgiLqBhA1BEARBEHUDCRuCIAiCIOoGEjYEQRAEQdQNJGwIgiAIgqgbSNgQBEEQBFE3kLAhCIIgCKJuIGFDEARBEETdQMKGIAiCIIi64f8DftSQ0Dc1+zUAAAAASUVORK5CYII=\n", "text/plain": ["
"]}, "metadata": {}, "output_type": "display_data"}], "source": ["with plt.xkcd():\n", " fig, ax = plt.subplots()\n", " ax.plot(t, t, 'k', t, t ** 2, 'b', t, t ** 3, 'r');"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "subslide"}}, "source": ["#### Available styles"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["Every style available in the Python/Matplotlib environment you are working in is available with the `matplotlib.pyplot.style.available` command."]}, {"cell_type": "code", "execution_count": 7, "metadata": {"slideshow": {"slide_type": "-"}, "tags": ["output_scroll"]}, "outputs": [{"data": {"text/plain": ["['seaborn-dark',\n", " 'seaborn-darkgrid',\n", " 'seaborn-ticks',\n", " 'fivethirtyeight',\n", " 'seaborn-whitegrid',\n", " 'classic',\n", " '_classic_test',\n", " 'fast',\n", " 'seaborn-talk',\n", " 'seaborn-dark-palette',\n", " 'seaborn-bright',\n", " 'seaborn-pastel',\n", " 'grayscale',\n", " 'seaborn-notebook',\n", " 'ggplot',\n", " 'seaborn-colorblind',\n", " 'seaborn-muted',\n", " 'seaborn',\n", " 'Solarize_Light2',\n", " 'seaborn-paper',\n", " 'bmh',\n", " 'tableau-colorblind10',\n", " 'seaborn-white',\n", " 'dark_background',\n", " 'seaborn-poster',\n", " 'seaborn-deep']"]}, "execution_count": 7, "metadata": {}, "output_type": "execute_result"}], "source": ["plt.style.available"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "slide"}}, "source": ["## Using Matplotlib w/ Pandas"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["We've already seen how Pandas has a built in [`plot`](https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.DataFrame.plot.html) command. However, sometimes we want more control over how the plot looks. We can pass an `Axes` object to Pandas as an argument, then add any additional styling we desire. To demonstrate this, let's use Pandas to create a scatter plot with the default settings."]}, {"cell_type": "code", "execution_count": 8, "metadata": {"slideshow": {"slide_type": "skip"}}, "outputs": [], "source": ["import pandas as pd"]}, {"cell_type": "code", "execution_count": 1, "metadata": {"slideshow": {"slide_type": "skip"}, "tags": ["daytum"]}, "outputs": [], "source": ["from intake import cat"]}, {"cell_type": "code", "execution_count": 1, "metadata": {"slideshow": {"slide_type": "-"}, "tags": ["daytum"]}, "outputs": [{"name": "stderr", "output_type": "stream", "text": ["/Users/john/miniconda3/envs/book/lib/python3.8/site-packages/intake/source/discovery.py:131: FutureWarning: The drivers ['sql_cat', 'sql', 'sql_auto', 'sql_manual'] do not specify entry_points and were only discovered via a package scan. This may break in a future release of intake. The packages should be updated.\n", " warnings.warn(\n"]}, {"data": {"image/png": "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\n", "text/plain": ["
"]}, "metadata": {"needs_background": "light"}, "output_type": "display_data"}], "source": ["df = cat.MV_2D_200wells.read()\n", "df.plot(x='porosity', y='permeability', kind='scatter');"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["Now we will use the same plot command, but pass a Matplotlib `Axes` object as a keyword argument to Pandas `plot`. The we can easily add grid lines and change the labels to symbols using standard Matplotlib commands."]}, {"cell_type": "code", "execution_count": 9, "metadata": {"slideshow": {"slide_type": "subslide"}}, "outputs": [{"data": {"image/png": "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AABh4HBJpdbnF+tIaZXZTfFKWXWt7l62U+P+a6PuXb5L1z+7QXcv26nyarvZTQsoU8POxo0bNWvWLG3fvl05OTmy2+2aMGGCqqq++yV66KGH9P7772v16tXauHGjTpw4oVtvvdX5el1dnSZPnqza2lpt3bpVr7/+ul577TU99thjZpQEALCgUA0ND67K05aDpS7Lthws1ZxVe0xqkTlMDTsffvih7rnnHl199dUaNGiQXnvtNR0/fly5ubmSpPLyci1btkzPPfecxo0bp2HDhmn58uXaunWrtm/fLklat26dDhw4oDfeeEODBw/WpEmT9NRTT2np0qWqra01szwAgEWEYmg4XFKpTQUlqjMMl+V1hqFNBSUh0zvlC0E1Zqe8vFySlJSUJEnKzc2V3W7X+PHjnetceeWVSk9P17Zt2zRq1Cht27ZNAwYMUNeuXZ3rTJw4UTNnztT+/fs1ZMiQRsepqalRTU2N8+eKigpJkt1ul91uTkp3HNes45uFuqk7HFB3aNd9tLRKOw4Xq11Ew5OmoR2Hi3WwsFwZybHOpcFS99GSCsVEGk2+fqS4XD0Son1yLLNq9vZ4NsMwmn4nAqi+vl4333yzysrKtHnzZknSypUrde+997oEE0kaMWKErr/+ev3nf/6n7r//fh07dkwfffSR8/Xq6mrFxcVp7dq1mjRpUqNjPfHEE3ryyScbLV+5cqViY2MbLQcAAMGnurpad955p8rLyxUfH9/kekHTszNr1izt27fPGXT8af78+Zo7d67z54qKCqWlpWnChAke3yx/stvtysnJ0Y033qioqChT2mAG6qbucEDdoV330dIq/csLTZ+bPphzbaOenWCp++f/k6vth0+5XMqKtNk0qleyXrlrmM+OY1bNjiszzQmKsDN79mytWbNGmzZtUo8ePZzLU1NTVVtbq7KyMiUmJjqXFxUVKTU11bnOzp07XfbnuFvLsU5DMTExiomJabQ8KirK9F/MYGiDGag7vFB3eAn1uvt2S9TIXl205WBpo9Awuk+K+qQmuN0uGOpecscwzVm1R5sKSpzLxvTtrCV3DPFL2wJds7fHMnWAsmEYmj17tt555x19+umnyszMdHl92LBhioqK0ieffOJclp+fr+PHjysrK0uSlJWVpb1796q4uNi5Tk5OjuLj49WvX7/AFAIAsLTsqUM0uk+Ky7LRfVKUPbXxuNBgkhAbpRUzRmj9w2O1/N7hWv/wWK2YMUIJsaEbPlvD1J6dWbNmaeXKlXrvvffUsWNHFRYWSpISEhJ02WWXKSEhQTNmzNDcuXOVlJSk+Ph4zZkzR1lZWRo1apQkacKECerXr5/uuusuLV68WIWFhVqwYIFmzZrltvcGAICWcoSGI6VVOnqqKuQm58tMCa32+pqpYeell16SJI0dO9Zl+fLly3XPPfdIkpYsWaKIiAhNmTJFNTU1mjhxol588UXnupGRkVqzZo1mzpyprKwsxcXFafr06Vq4cGGgygAAhIlwDw2hytSw482NYO3bt9fSpUu1dOnSJtfJyMjQ2rVrfdk0AABgETwIFAAAWBphBwAAWBphBwAAWBphBwAAWBphBwAAWBphBwAAWBphBwAAWFpQPBsLAACEjsMllTp2ujpkZpIm7AAAAK+UVdfqwVV5jR8selt/E1vVPC5jAQAArzy4Kk9bDpa6LNtysFSP/OULk1rkHcIOAABo1uGSSm0qKFFdg0c91RmGthwqbWKr4EDYAQAAzTp2utrsJrQaYQcAADQrIynW7Ca0GmEHAAA0q1fnDhrTt7MibTaX5ZE2m0b3TjGpVd4h7AAAAK9kTx2i0X1cg83oPil65qcDTWqRd7j1HAAAeCUhNkorZozQkdIqHT1V5Zxnx263m900jwg7AACgRTJTQmMyQQcuYwEAAEujZwcAgBYKtcclhDvCDgAAXmrqcQnZU4coITbKxJbBEy5jAQDgpaYelzBn1R6TWgRvEHYAAPCCp8clbCoo0ZHSKpNahuYQdgAA8EJzj0s4eoqwE6wIOwAAeKG5xyX0TGagcrAi7AAA4AVPj0sY07czd2UFMcIOAABeaupxCdlTh5jUIniDW88BAPBSU49LQHAj7AAA0EKh9riEcEfYAQC0CbMJI9gRdgAArcJswggVDFAGALQKswkjVBB2AAAtxmzCCCWEHQBAizGbMEIJYQcA0GLMJoxQQtgBALRYKM4mfLikUuvzi7nEFoa4GwsA0CrZU4dozqo9LndjBeNswtw1BsIOAKBVQmU2YU93ja2YMcKkViGQCDsAgDYJ5tmEHXeNNXTpXWPB2nb4DmN2AACWxV1jkOjZAQDT8JgF/+OuMUiEHQAIOAbMBo7jrrEtB0tdJkCMtNk0uk8KITNMcBkLAAKMxywEVvbUIRrdJ8VlWTDeNQb/oWcHAAKIAbOBFyp3jcF/CDsAEEDeDJjlROwfwXzXGPyLsAMAAcSAWWthkHloIOwAQAAxYNYaPA0yZ4x58GGAMgAEGANmQx+DzEMLPTsAEGAMmA1tzQ0yP3bK87gsBB5hBwBMwoDZ0NTcIPPjp5mVOdhwGQsAEJYOl1RqfX6xjpS2LJw0N8g8PYkAG2zo2QEAhJW2zmDd3CDzjORY7fdLy9Fa9OwAAMKKLwYX/3rC93RVt44uyxhkHrzo2QEAhI22zmDtrleo/+Xx+v1PBmhgj0RJkt1u933D0Sb07AAAwoY3M1h74q5X6MsTZ/XsR/9sc9vgP4QdAEDYaMsM1o5eoUvH6UiuvUIIToQdAEDYcAwujrTZXJZH2mwa07ezx0tYbe0VgnkIOwCAsNLaGax5rlnoYoAyACCstHYGa55rFrro2QEAhKXMlDhdf0WXFoUUnmsWmujZAQDASzzXLDQRdgAAaCGeaxZauIwFAAAszdSws2nTJv3oRz9S9+7dZbPZ9O6777q8bhiGHnvsMXXr1k2XXXaZxo8fr4KCApd1Tp8+rWnTpik+Pl6JiYmaMWOGKisrA1kGAAAIYqaGnaqqKg0aNEhLly51+/rixYv1xz/+US+//LJ27NihuLg4TZw4UefPn3euM23aNO3fv185OTlas2aNNm3apPvvvz9QJQAAgCBn6pidSZMmadKkSW5fMwxDzz//vBYsWKBbbrlFkrRixQp17dpV7777ru644w59+eWX+vDDD7Vr1y5dc801kqTs7Gz98Ic/1LPPPqvu3bu73XdNTY1qamqcP1dUVEi6+DwTs55p4jhuuD1ThbqpOxxQN3VbnVk1e3s8m2E0mPfaJDabTe+8845+/OMfS5IOHz6s3r17a8+ePRo8eLBzveuuu06DBw/WH/7wB7366qv69a9/rTNnzjhfv3Dhgtq3b6/Vq1frJz/5idtjPfHEE3ryyScbLV+5cqViYz1PGgUAAIJDdXW17rzzTpWXlys+Pr7J9YL2bqzCwkJJUteuXV2Wd+3a1flaYWGhunTp4vJ6u3btlJSU5FzHnfnz52vu3LnOnysqKpSWlqYJEyZ4fLP8yW63KycnRzfeeKOioqJMaYMZqJu6wwF1U7fVmVWz48pMc4I27PhTTEyMYmJiGi2Piooy/RczGNpgBuoOL9QdXoK97sMllTp2utrnc+YEe93+EOiavT1W0Iad1NRUSVJRUZG6devmXF5UVOS8rJWamqri4mKX7S5cuKDTp087twcAwJ2y6lo9uCpPmwpKnMvG9O2s7KlDlBAbXiHF6oJ2np3MzEylpqbqk08+cS6rqKjQjh07lJWVJUnKyspSWVmZcnNznet8+umnqq+v18iRIwPeZgBA6HhwVZ62HCx1WbblYKnmrNpjUovgL6b27FRWVurgwYPOn48cOaK8vDwlJSUpPT1dv/rVr/S73/1Offv2VWZmpn7729+qe/fuzkHMV111lW666Sbdd999evnll2W32zV79mzdcccdTd6JBQDA4ZJKlx4dhzrD0KaCEh0prWKGZAsxNezs3r1b119/vfNnx6Dh6dOn67XXXtOjjz6qqqoq3X///SorK9MPfvADffjhh2rfvr1zmzfffFOzZ8/WDTfcoIiICE2ZMkV//OMfA14LACB0HDtd7fH1o6cIO1ZiatgZO3asPN35brPZtHDhQi1cuLDJdZKSkrRy5Up/NA8AYFEZSZ6nGemZTNCxkqAdswMAAOALhB0AQNjx5jIWrIOwAwAIO1zGCi+EHQBA2OnVuYPG9O2sSJvNZXmkzaYxfTszONliCDsAgLCUPXWIhmYkuiwb3SdF2VOHmNQi+AthBwAQdsqqazVn1R7tOvrdg6SHZ3Ri9mSLIuwAAEx3uKRS6/OLdaQ0MAOD3c2e/PnxMmZPtqigfTYWAMD6zHg+FbMnhx96dgAApjHj+VTcdh5+CDsAAFM4eljqGsykf2kPiz9w23n4IewAAExhVg8Lt52HH8IOAMAUZvawZE8dotF9UlyWcdu5dTFAGQBgCkcPy5aDpS6XsiJtNo3uk+LXHpaE2CitmDFCR0qrdPRUlXomx9GjY2H07AAATGN2D0tmSpyuv6ILQcfi6NkBAJiGHhYEAmEHAGC6zBRCDvyHsAMACGuHSyp17HQ1vUoWRtgBAIQlM2ZvhjkYoAwACEtmzN4McxB2AABhx6zZm2EOwg4AwFSBfuK5xPOxwg1jdgAgQD4rKFFml4SQHwTrqwG9Zo6Z4flY4YWwAwB+VFZdq7lvfa5bkqWZb36umjpbyA6C9XU48TRmZsWMEW1urydmzt6MwOMyFgD40YOr8rT98CmXZaE6CNaXA3r9NWamJZfEzJ69GYFDzw4A+InjhB4T2fQJPVR6EBy1NNTaWrwZM9OS/bWm14nZm8MHPTsA4CdWGgTr61p8PWamLb1OPB/L+gg7AOAnVhoE6+taHGNmIm02l+WRtotjmloSPLiNHM0h7ACAn/jyhG42f9TiqzEzVupBg38wZgcA/Ch76hA99FaupCLnslAdBJs9dYjmrNrjMi6mLbX4asyMlXrQ4B+EHQDwo4TYKL1y1zCtXbtWL00bGtLz7PhrQK+nJ557M6cPt5GjOYQdAAiQa/t2VlRUaM2t446ncOIrLb27yte9TrAWwg4AIOi0dMJBbiOHJ4QdAEBQacucPoHodULo4W4sAEBQ4e4q+BphB6nV90QAACAASURBVAAQVLi7Cr5G2AEABBUrzU+E4EDYAQAEHR7SCV9igDIAIOhwdxV8ibADAE3wZkI7tJ2n97ktd1fx+cGBsAMADbR0Qju0jr/e51D+/Aho/sGYHQBowNOEdmY7XFKp9fnFIfsk70vb76/3OZg/v6aUVdfq7mU7Ne6/Nure5bt0/bMbdPeynSqvtpvdNEugZwcALtGWCe38KZR7KyT37Xenre9zsH5+zWnpjNFoGXp2AOASwTqhXSj2VlzKXfs9ae37HKyfnyeOgHbpQ0wl14CGtiHsAMAlgnFCu1A/GR4trXLbfk9a+z4H4+fXnFAMaKGGsAMgLHg71iUYJ7QL9ZPh12c8t/9S7t7nloxTCsbPrzmhGNBCDWN2AFhaa8a6ZE8dojmr9rhsY+aEdqF+Mkzr5Ln9l7r0fW7tOKVg+/ya4whoWw6WuvR+RdpsGt0nJSgDWqgh7ACwtNYM/Ay2Ce18dTI067bmnilx6hQbpTNu7ixqF2HTX3/xfZ2qqm3UrgdX5WnzQdfBxt4M2g22z88boRbQQg1hB4BltfbOnEtDwfVXdAlEU5vV2pPh4ZJK7T9ZoRVbj2rX0TPO5YG8k+toaZXboCNJF+oNPfX+Aa2e+X2X5f/4+kyLPjt3Qa4tExIGWigGtFBC2AFgWd6Mdbn0hBLMt3e39GTY3K3egbytubkxO7uOndGmf14cwOyo6/++s8/jNo7PLpg/s9YwWjCIG94j7AAIaZ4uzbR0rIu3l7zMnOXW296K5m71DuS8M96M2bn71Z3OPw/v2Un7TlR4XN/x2VllfhqrhbZgQ9gBEJK8OTm0ZKyLN5e8OsVGBdUJqanQ1VQt7vztH9/q5kGXtzjwtCTw9UyJ05C0RO35usyrfeceO+Px9f6XxyszJS5kJxB0xyqhLVgRdgCEJG9PDt6OdWnuktff/vGtNv+zVJ8fdz1hm3FCairo/XpCX52utquw/LzX+1qSU6AlOQVeh7bW9kC0j4r0uk31zVzJ+f1PBkhq+WXKtvBnb56VQluwIuwACDnNnRwajv/wZqxLc5e8luQUuF3u6YTkOEGmJcS0oLrmuQt6mwpKvO7NcefS0ObpxN6aHoijpVXadvhUq9vmECHpB307a2CPRJVV1+rF9Qc9ru+LW/IDcXkpkKEtXBF2AISc5k4Ol47/cJyYmhvr0tQlL29dekJqeIKMiTS0eIRUcc6u5KiWnSAbBo+WXKJqCUdou+3lrU3etdXaHojdx077pI0JsVHOHrkHV+Xp82PuL4v5cn6aQFxeCvV5lEIBMygDCAoNZ8n1NGtucyeHS20+WKJpy7Zr0z9Lmp2FN3vqEI3uk9Lyxsv1hNTU4OBH/vKF1/tr6inYG/J9H3Qu1XC8zKXP32rpTM7l52olSU+8f8DjdjaPr37nTLVdp6trm3x8hsPQ9ESfzE8TqMd0BHLW55bMRm0l9OwAMJW7ywQNJ6DzduCxO/WGtO/bCre9PQ0vQzhu777t5a3affSMvOnfadiL4KnnZcuhUq/HX/jjUpU3Go6XufTE7m0PhKM36k/r/6nbuzV/zJb0o3nzaIxfjOvjk0tMgby85O9JBcP9bi96dgB4zR//KnR3Um84AZ27p3u3pRfG09PCD5dUapeXQUdqfEJq7gS5/fCpZt/DjfnFLX5wpr8d+La82R6ITrFRLr1RuV7efSVJETYpNrr5U1LP5LiAXfYJ5OUlR9Be//BYLb93uNY/PFYrZozwWRDxdDkuHNCzA6BZLflXYUvuWvF2/Im7MSENJ9mLtNlcem9auj+H5sJKhE0altFJv7i+T6vm9pn/173OP/e/PF6//8kADeyRKKn5iQDN9PKmQ5o8qLvbHgjHZaM5q/Z4nNvHk3pDqq6t97hO/+7xzve7tY/PaMnvpxnPrPLHrM/c7UXPDgAvePOvwqbGmJS7eUzA0dIqrc8v1s4jLRu46u4SRmbKxUc6jPleZ7e9Dp6462VpLqwMy+ik/757uDKSYnX0VJXLto4T6fCMTl61Y9+3Fbr5hS36UfZnKq+2NzsRoJn2fluhI6VVSoiN0h+nDtbwnp2cr+06dkb/tmKX33ujHLecS+579jxd9mnJ7+elWnqcYNTSsVZWRM8OAI+8/VehuxP15oMlLnetOAas/ssLm1VT530oceiZHKeN+cVan1+slA4xmjywu8u/SLOnDtG/rdjlcjeRJ5f2sjjmqTlw8qx6Jcfq8KnGJ4irUjvqT3df06hnI6tXss7b61wmzYtv304V5y941Y6931Zo6FPrVBc8V63ccoxRcXcnVHMTAbZVfPt2GpiW6Py5pY/PaO1dVVZ4ZhV3exF2EAK86XY2Y/p+Xx/Tl/tr6b425hcr75syDU3vpGv7dnZ5zZt/FRr/G3waqjcuDqp9dfNhDctI0s9f36H5A9zspBkRknp36aCbsz/T2Zo65/Jn1/1TV3TtoDk39FVap1j917p/eh10GvJm8O+XhWd1/bMbVHHOtTfA3Rwy3gYdh2APOtLFk2JT4be5iQDbquL8BbeXW7y57OOLyzih9FDRhsy4HBdsLBN2li5dqmeeeUaFhYUaNGiQsrOzNWJE6EyxffR/u8KPnapWn9QEvx6rrSfVtmzfkm2bniX2ezpdXaueyXHqFBul+1bsdjnBDe958TKDYyyJu3lKWtL+hus3N37FU3BwN8mcu/317dJBU0ek6/oruzRq4593HlfOl0XKSIrV/8nq6VJTUmyU/mtdgcu+MpIu0/xJV+mmAY1vi9lcUKIH3shV5SUBolNslF6YOlS19fVeDQZNjovWjmYuRy1c86Wki/PNtEa9pILiSrev5RdVavbKwA2ybOrp3VY3PKOTMlPitD6/2LQ2tPbuJybt8//dXsHOEmHnz3/+s+bOnauXX35ZI0eO1PPPP6+JEycqPz9fXbp0Mbt5HjlOdDsOF2vxCGly9mca2auLX24HbOuth23Zvqltl9zWv8ltvLn1tl2ETRca/JNy19EzGvvser03a7QWvLu/Rbc0e9Nme119o7EmWw6Wasbru3SopNJl/51io/S3WT9Qx8vaNTnJ3EOr9zWqs6C4UgvXHNDCNQf0/d7JemnaMB0/XaWfvLjVpd5lW46qY0ykS29HQ8dOn9MDb37ubEtacqzHgbBnqu2atmyHS81ZvZKbnAH3rmU7VX6u7QHg6VsH6M3tx3TgRIU8D1NFS/3PjBH65sw5l8t2LXXP93tKatkcR77W2sstXMaxxuW4trDEAOXnnntO9913n+69917169dPL7/8smJjY/Xqq6+a3bRmBfJ2wLYeqy3bN7VtU5OsNTdpmEPDoONwptquf8ne3Kpbmj21efPBEm07fMrtJGO7j51ptP8z1XbdvHRzkwNPZ6/8vNk6tx46pTmr9jQKOg6ego67tjhq23zQuzt+thws1Xl708fwRdCRpMsTL9M+gk4jHWK8f6aUO1m9knVt384amZnUpv30u/xij3NTt59HtHwIltfaOrleICftC3aOAf3hVLNkgZ6d2tpa5ebmav78+c5lERERGj9+vLZt2+Z2m5qaGtXU1Dh/rqiokCTZ7XbZ7YHroj5aWqUdh4vVLkKKibh4Erv4/3rtOFysg4Xlykj2zb+iLj2W64dueHWstmzvadvdR0p0S7Iave9HSypafcnDocZud3PMhty3v+k2t1x1TW2jfTk+7/3fnlFMZPNniR2HixVpkyLbdt5TdU2t3t5xRDsOFyvK63/qGDpw4ozaeM6V1PD3/DvD0hJ14YK9zZ95sGqqbm+8OzNL/yw6q4fezmvxtqN7p+iZnw6U3W5XWmKMxn0vWdvdhHVPIm3SqF4p6pEQ7fx7uuS2/nrkL19oy6HvAvzo3imy19Ur99gZ5/7bUrdrHcl65qf92/T97L7Nbd+vO479BfJ8Yjazavb2eDbDCKJZq1rhxIkTuvzyy7V161ZlZWU5lz/66KPauHGjduzY0WibJ554Qk8++WSj5StXrlRsrHldtAAAwHvV1dW68847VV5ervj4+CbXC/mendaYP3++5s6d6/y5oqJCaWlpmjBhgsc3y9eOllbpX164eFkhJsLQU9fU67e7I1RTf/Ff+h/MudanPTuOY7nT3LHasr2nbR1133jjjYpq8IDEn/9Pbov/FdpaDdvfXL0RksvlFptaNuX9pZ93/x6dtOfrMr/fzeLw1M1X67d/2x+YgzXQ8Pd8WHqisqcOVfxlFz/7QH7mbTGiZ5Ie/9HVuv2Vraqsbf4yoru/3w7pnS7TA2P66IN9Jxv1lDzz04HO96binL1Rz0RDkTabRvVK1it3DfPYnmOnqnX8dJXSk+KUkRzb7M8t5dj+8vgYfZW7WR+c7qyNB78b59bpsiidueTyp6PWM9X2Nh03WNjtduXk5Lj9XrMqs2p2XJlpTsiHnZSUFEVGRqqoqMhleVFRkVJTU91uExMTo5iYmEbLo6KiAvoh9e2WqJG9uvzvWI6Lp86aepsu1EdodJ8Un96Vdemx3N162Nyx2rK9x217J0kqcvveL7ljWKO7B7wVoYsD8irOXfB44myq/Z7aPLJXktpFRDQauPzFN2UqczN+pVNslAZcnuj2OU7XZHb2qs4xfTtr66HSJscoeatTbJR+NjJTa/aVeP10b8d7dKG+XlsPuR+k7Lq+FBfjfo6Z0b1TJBXp+anDlNklodG4AXfvRcNB5f4yNC1B//im3OUW8HYRNg3oHq8935Q7l106qP3d2dfpX174TOXn3N9mHiEps3Os6urqJFWppt6mmjqbhvfspOnf76mru3/3HkwZkeFx8GhyVJRe/ddRznVqauv0wvqD2nfiuy/7MX07a8kdQ5r9HuuTmuDyO9/czy3l2N5ut+srSUv/z3B9U17rUpu7WpPj5fe7UQMp0OeUYBDomr09VshfxpKkkSNHasSIEcrOzpYk1dfXKz09XbNnz9ZvfvObZrevqKhQQkJCs91g/lBebdecVXv+926sOj26M9Jvd2M5jtXau7Hasn1T2y65rb82r8/RD3/4wyZ/aR1fislx0Xr2o396dSIc07ez/uPH/fV/393X6ruxmqu34Zf116eqdfPSzW7vxoq/LMplXxfvxqrTD66/UcnxF/8F+8XXZXr0/32hrwrPurTDcTfWt2eqdfPSLY0CT8O7sZp6Ty69G8tdbRnJsXpwXB+9l3fSbc2S3E6mZ7PJJQQ51j9dffHk5rhjrmdynHokRGvt2rUeP29Jjd7bS38HHn9vv8vkfZLUOyVOxWdrdLbmu9AR376dfju5n1IT2+tCveH292fA5fF6YExv9bv8u9CxevfX2nKoVKN7p+i2a9LctqehzwpK9PcvTmrroVIdPX2u0XsRGyWtXbtWHfsOdxvy2iKY766x2+1efd5WE451m1Wzt+dvS4SdP//5z5o+fbpeeeUVjRgxQs8//7zefvttffXVV+ratWuz25sZdhwOFpZr/44NunrkWL//y6atX45t2b7htq35C9LUifDSk+ql7WpqfW/b39L1Pyso0efHz7idZ8exr7SEGO3fscFt3UdKq7T98CnZJI3sldzomKt3f62P9he6zLPTVI2lZ2t0ovyc27Z4qs1Tze5e8/Y98tUX4pHSKu04fEqGpFGXvEee3ntvavMFd/sPx5OfRN3hVHewh52Qv4wlSbfffrtKSkr02GOPqbCwUIMHD9aHH37oVdAJFhnJsdr/v//3t7bOBNqW7X0xC2nDfTS3z5au39z2zbm2b+cmT7SOfdntdjU1aqa54912TZqzx6Gpbbxtc1Predre3WuBnl22qeN5eu+b29ZXQnmmXcCqLBF2JGn27NmaPXu22c0AAABBxhKTCgIAADSFsAMAACyNsAMAACyNsAMAACyNsAMAACyNsAMAACyNsAMAACyNsAMAACyNsAMAACzNMjMot4Xj8WDePireH+x2u6qrq1VRURE2z1KRqJu6wwN1U7fVmVWz47zd3GM+CTuSzp69+JTptLS0ZtYEAADB5uzZs0pIaPoh2pZ46nlb1dfX68SJE+rYsaNsNpspbaioqFBaWpq+/vpr0568bgbqpu5wQN3UbXVm1WwYhs6ePavu3bsrIqLpkTn07EiKiIhQjx49zG6GJCk+Pj5s/nJcirrDC3WHF+oOH2bU7KlHx4EBygAAwNIIOwAAwNIin3jiiSfMbgQuioyM1NixY9WuXXhdXaRu6g4H1E3dVhfMNTNAGQAAWBqXsQAAgKURdgAAgKURdgAAgKURdgAAgKURdnxo6dKl6tmzp9q3b6+RI0dq586dHtdfvXq1rrzySrVv314DBgzQ2rVrXV6/5557ZLPZXP676aabXNY5ffq0pk2bpvj4eCUmJmrGjBmqrKz0eW1N8XXNDet1/PfMM8841+nZs2ej1xctWuSX+prSkrr379+vKVOmONv9/PPPt2qf58+f16xZs5ScnKwOHTpoypQpKioq8mldzfF13U8//bSGDx+ujh07qkuXLvrxj3+s/Px8l3XGjh3b6PN+4IEHfF6bJ76u+4knnmhU05VXXumyjhU/b3d/d202m2bNmuVcJ9Q+7z/96U+69tpr1alTJ3Xq1Enjx49vtL5hGHrsscfUrVs3XXbZZRo/frwKCgpc1jH7u1zybd12u13z5s3TgAEDFBcXp+7du+vuu+/WiRMnXPYTsO9zAz7x1ltvGdHR0carr75q7N+/37jvvvuMxMREo6ioyO36W7ZsMSIjI43FixcbBw4cMBYsWGBERUUZe/fuda4zffp046abbjJOnjzp/O/06dMu+7npppuMQYMGGdu3bzc+++wzo0+fPsbUqVP9WquDP2q+tNaTJ08ar776qmGz2YxDhw4518nIyDAWLlzosl5lZaXf63Voad07d+40Hn74YWPVqlVGamqqsWTJklbt84EHHjDS0tKMTz75xNi9e7cxatQo4/vf/77f6mxNGy/lTd0TJ040li9fbuzbt8/Iy8szfvjDHxrp6ekun+d1111n3HfffS6fd3l5ud/qbMgfdT/++OPG1Vdf7VJTSUmJyzpW/LyLi4tdas7JyTEkGevXr3euE2qf95133mksXbrU2LNnj/Hll18a99xzj5GQkGB88803znUWLVpkJCQkGO+++67xj3/8w7j55puNzMxM49y5c851zPwuNwzf111WVmaMHz/e+POf/2x89dVXxrZt24wRI0YYw4YNc9lPoL7PCTs+MmLECGPWrFnOn+vq6ozu3bsbTz/9tNv1f/aznxmTJ092WTZy5Ejj5z//ufPn6dOnG7fcckuTxzxw4IAhydi1a5dz2d///nfDZrMZ3377bWtL8Zo/am7olltuMcaNG+eyLCMjw+0XaaC0tO5LNdX25vZZVlZmREVFGatXr3au8+WXXxqSjG3btrWlHK/5o+6GiouLDUnGxo0bncuuu+4645e//GXrGu0D/qj78ccfNwYNGtTkduHyef/yl780evfubdTX1zuXhfLnbRiGceHCBaNjx47G66+/bhiGYdTX1xupqanGM88841ynrKzMiImJMVatWmUYhvnf5Ybh+7rd2blzpyHJOHbsmHNZoL7PuYzlA7W1tcrNzdX48eOdyyIiIjR+/Hht27bN7Tbbtm1zWV+SJk6c2Gj9DRs2qEuXLrriiis0c+ZMnTp1ymUfiYmJuuaaa5zLxo8fr4iICO3YscMXpTXJnzU7FBUV6YMPPtCMGTMavbZo0SIlJydryJAheuaZZ3ThwoU2VOO91tTti33m5ubKbre7rHPllVcqPT291cf1dRt9oby8XJKUlJTksvzNN99USkqK+vfvr/nz56u6utpnx/TEn3UXFBSoe/fu6tWrl6ZNm6bjx487XwuHz7u2tlZvvPGG/vVf/7XRA5hD+fOurq6W3W53/g4fOXJEhYWFLvtMSEjQyJEjnfs087tc8k/d7pSXl8tmsykxMdFleSC+z4NvmsMQVFpaqrq6OnXt2tVledeuXfXVV1+53aawsNDt+oWFhc6fb7rpJt16663KzMzUoUOH9O///u+aNGmStm3bpsjISBUWFqpLly4u+2jXrp2SkpJc9uMP/qr5Uq+//ro6duyoW2+91WX5gw8+qKFDhyopKUlbt27V/PnzdfLkST333HNtqMg7ranbF/ssLCxUdHR0oy8JT++fL/mj7obq6+v1q1/9SqNHj1b//v2dy++8805lZGSoe/fu+uKLLzRv3jzl5+frr3/9q0+O64m/6h45cqRee+01XXHFFTp58qSefPJJXXvttdq3b586duwYFp/3u+++q7KyMt1zzz0uy0P98543b566d+/uDA6Oz8vTd5+Z3+WSf+pu6Pz585o3b56mTp3q8qDQQH2fE3aC2B133OH884ABAzRw4ED17t1bGzZs0A033GBiywLj1Vdf1bRp09S+fXuX5XPnznX+eeDAgYqOjtbPf/5zPf3004qJiQl0M+Ejs2bN0r59+7R582aX5ffff7/zzwMGDFC3bt10ww036NChQ+rdu3egm+kTkyZNcv554MCBGjlypDIyMvT222+77cm0omXLlmnSpEnq3r27y/JQ/rwXLVqkt956Sxs2bGj0vWVlzdVtt9v1s5/9TIZh6KWXXnJ5LVDf51zG8oGUlBRFRkY2ulOiqKhIqampbrdJTU1t0fqS1KtXL6WkpOjgwYPOfRQXF7usc+HCBZ0+fdrjfnzB3zV/9tlnys/P17/9278125aRI0fqwoULOnr0qPcFtFJr6vbFPlNTU1VbW6uysjKfHdfXbWyL2bNna82aNVq/fr169Ojhcd2RI0dKkvPvgT/5u26HxMREfe9733P5u23lz/vYsWP6+OOPvf77LQX/5/3ss89q0aJFWrdunQYOHOhc7tiuub/fZn2XS/6p28ERdI4dO6acnByXXh13/PV9TtjxgejoaA0bNkyffPKJc1l9fb0++eQTZWVlud0mKyvLZX1JysnJaXJ9Sfrmm2906tQpdevWzbmPsrIy5ebmOtf59NNPVV9f7/yC8Bd/17xs2TINGzZMgwYNarYteXl5ioiIaNQN7A+tqdsX+xw2bJiioqJc1snPz9fx48dbfVxft7E1DMPQ7Nmz9c477+jTTz9VZmZms9vk5eVJkvPvgT/5q+6GKisrdejQIWdNVv28HZYvX64uXbpo8uTJza4bCp/34sWL9dRTT+nDDz90GXcjSZmZmUpNTXXZZ0VFhXbs2OHcp5nf5ZJ/6pa+CzoFBQX6+OOPlZyc3Gxb/PZ97vch0GHirbfeMmJiYozXXnvNOHDggHH//fcbiYmJRmFhoWEYhnHXXXcZv/nNb5zrb9myxWjXrp3x7LPPGl9++aXx+OOPu9yGffbsWePhhx82tm3bZhw5csT4+OOPjaFDhxp9+/Y1zp8/79zPTTfdZAwZMsTYsWOHsXnzZqNv374BvfXclzU7lJeXG7GxscZLL73U6Jhbt241lixZYuTl5RmHDh0y3njjDaNz587G3Xff7d9iL9HSumtqaow9e/YYe/bsMbp162Y8/PDDxp49e4yCggKv92kYF29FTk9PNz799FNj9+7dRlZWlpGVlRXSdc+cOdNISEgwNmzY4HLraXV1tWEYhnHw4EFj4cKFxu7du40jR44Y7733ntGrVy9jzJgxIV33r3/9a2PDhg3GkSNHjC1bthjjx483UlJSjOLiYuc6Vvy8DePiXT7p6enGvHnzGh0zFD/vRYsWGdHR0cZf/vIXl9/hs2fPuqyTmJhovPfee8YXX3xh3HLLLW5vPTfru9wfddfW1ho333yz0aNHDyMvL89lnZqaGsMwAvt9TtjxoezsbCM9Pd2Ijo42RowYYWzfvt352nXXXWdMnz7dZf23337b+N73vmdER0cbV199tfHBBx84X6uurjYmTJhgdO7c2YiKijIyMjKM++67z+XkZxiGcerUKWPq1KlGhw4djPj4eOPee+91+Uvmb76s2eGVV14xLrvsMqOsrKzRa7m5ucbIkSONhIQEo3379sZVV11l/P73v3cJgIHQkrqPHDliSGr033XXXef1Pg3DMM6dO2f84he/MDp16mTExsYaP/nJT4yTJ0/6s8xGfF23u9clGcuXLzcMwzCOHz9ujBkzxkhKSjJiYmKMPn36GI888khA510xDN/XffvttxvdunUzoqOjjcsvv9y4/fbbjYMHD7oc04qft2EYxkcffWRIMvLz8xsdLxQ/74yMDLd1P/7448516uvrjd/+9rdG165djZiYGOOGG25oVL/Z3+WG4du6m/p90CXzKgXy+9xmGIbh274iAACA4MGYHQAAYGmEHQAAYGmEHQAAYGmEHQAAYGmEHQAAYGmEHQAAYGmEHQAAYGmEHQAAYGmEHQAAYGmEHQAAYGmEHQCWd9VVV+m///u/zW4GAJMQdgBY2rlz51RQUKBBgwaZ3RQAJiHsALC0ffv2yTAM9e/f3+ymADAJYQeAJeXl5WncuHH6wQ9+oPr6eqWnp+v55583u1kATNDO7AYAgK8dOnRI1113nR555BElJyervr5ew4cP10MPPaSxY8dq8ODBZjcRQADRswPAch544AHdeuutWrBggY4fP67Ro0fr0UcfVXx8vD777DOzmwcgwAg7ACylsLBQn376qR544AHV1dVp7969Gjx4sCIiIhQZGano6GizmwggwAg7ACxl+/btqq+v1+DBg5Wfn69z585p8ODBOnr0qM6cOaPvf//7ZjcRQIARdgBYSm1trSTp/Pnz2rNnjzIyMpSUlKSXX35Z/fv314ABA0xuIYBAY4AyAEvJyspSu3bttHDhQlVWVqpXr1564YUXlJ2drU2bNpndPAAmIOwAsJS0tDS9+uqrmjdvnk6ePKl27dqpurpaH374oYYNG2Z28wCYwGYYhmF2IwDAH5KSkvTaa6/p5ptvNrspAEzEmB0AlvTNN9/ozJkzzJwMgLADwJr27t2ruLg4ZWZmmt0UACbjPFaSzQAAAEhJREFUMhYAALA0enYAAIClEXYAAIClEXYAAIClEXYAAIClEXYAAIClEXYAAIClEXYAAIClEXYAAIClEXYAAIClEXYAAICl/X8dMBrYP4REgwAAAABJRU5ErkJggg==\n", "text/plain": ["
"]}, "metadata": {}, "output_type": "display_data"}], "source": ["fig, ax = plt.subplots()\n", "df.plot(x='porosity', y='permeability', kind='scatter', ax=ax)\n", "ax.set_xlabel(r'$\\phi$')\n", "ax.set_ylabel(r'$\\kappa$')\n", "ax.grid()"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["As an additional example, we'll use Pandas to create a histogram of the porosity and permeability values. This time we'll start with a `subplot` with one row and two columns. This will return a tuple containing two axes objects corresponding to permeability and porosity respectively. We then add some labels and set axis limits."]}, {"cell_type": "code", "execution_count": 10, "metadata": {"slideshow": {"slide_type": "subslide"}}, "outputs": [{"data": {"image/png": "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ZIUFBQXB19cXWVlZlnBjMBiQl5eH1157DQAQHh6OsrIy5OfnIyQkBABw6NAhmM1mhIWFNdh3c2/nLtWtwOXwZSQHcrntuJLIZU7lUAMRkeiwc/bsWatltVqNTp064b333nvolVq/VFFRgatXr1qWCwsLce7cOXh5eSEwMBBz587F8uXL0b17dwQFBSEpKQn+/v4YP348AKBnz54YNWoUZsyYgU2bNsFkMmHWrFmYNGkSr8QiIiIiAE0IO4cPH5bszU+fPo3hw4dblmuPGk2bNg3btm3D/PnzUVlZiZkzZ6KsrAxDhw5FRkYGXFxcLK/Zvn07Zs2ahZEjR1rudLpu3TrJaiQiIiLHJjrsFBYW4v79++jevbtV+5UrV6DRaNCtW7dG9zVs2DAIQsNXNqlUKqSkpCAlJaXBbby8vLBjx45GvycRERG1LqLvs/PSSy/hxIkTddrz8vLw0ksvSVETERERkWREh52zZ89iyJAhddoHDx6Mc+fOSVIUERERkVREhx2VSoW7d+/WaS8vL0dNTY0kRRERERFJRXTYeeaZZ5CammoVbGpqapCamoqhQ4dKWhwRERFRc4k+QXnlypV45pln0KNHDzz99NMAgK+//hoGgwGHDh2SvEAiIiKi5hB9ZKdXr1745ptv8Pzzz6OkpAR3797F1KlT8c9//hN9+vSxRY1ERERETdakx0X4+/vjnXfekboWIiIiIsmJPrKzdetW7Nq1q077rl278PHHH0tSFBEREZFURIed1NRUdOzYsU57586debSHiIiIZEd02CkqKkJQUFCd9q5du6KoqEiSooiIiIikIjrsdO7cGd98802d9vPnz8Pb21uSooiIiIikIjrsTJ48GW+88QYOHz6Mmpoa1NTU4NChQ5gzZw4mTZpkixqJiIiImkz01VjLli3D9evXMXLkSDg5/fRys9mMqVOn8pwdIiIikh3RYcfZ2RmfffYZli1bhvPnz8PV1RV9+/ZF165dbVEfERERUbM06T47APD444+je/fuAH56XhYRERGRHIk+ZwcAPvnkE/Tt2xeurq5wdXVFv3798D//8z9S10ZERETUbKKP7KxevRpJSUmYNWsWhgwZAgA4duwYXn31Vfz444+YN2+e5EUSERERNZXosLN+/Xps3LgRU6dOtbQ999xz6N27N5YuXcqwQ0RERLIi+mes27dv46mnnqrT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AFCpVJg7dy6WL1+O7t27Wy499/f3x/jx4yWrg4iIiByX6LAzbNiwOm0/v9eOlOfsDBw4ELt370ZiYiJSUlIQFBSEtWvXIi4uzrLN/PnzUVlZiZkzZ6KsrAxDhw5FRkYG77FDREREAJoQdv71r39ZLZtMJpw9exZJSUlYsWKFZIXV+vWvf41f//rXDa5XqVRISUlBSkqK5O9NREREjk902PHw8KjTFhkZCWdnZyQkJCA/P1+SwoiIiIikIPrZWA3x8fGpczIxERERkb2JPrLzzTffWC0LgoDbt28jLS3tgZd7ExEREdmD6LAzYMAAqFQqCIL1IxMGDx6Mjz76SLLCiIiIiKQgOuwUFhZaLavVanTq1IlXPxEREZEsiQ47tTf0IyIiInIEosMOAGRlZSErKwslJSUwm60fismfsoiIiEhORIed5ORkpKSkIDQ0FH5+flY3FCQiIiKSG9FhZ9OmTdi2bRumTJlii3qIiIiIJCX6Pjv37t3DU089ZYtaiIiIiCQnOuz87ne/w44dO2xRCxEREZHkRP+MVV1djc2bN+Orr75Cv379oNForNavXr1asuKIiIiImqtJd1CuvVPyxYsXrdbxZGUiIiKSG9Fh5/Dhw7aog4iIiMgmJHsQKBEREZEcMewQERGRojXpDspERETk+Lot3C9qe20bAasGAX2WHoSxxvo83etpY6QsTVI8skNERESKxrBDREREisawQ0RERIrGsENERESKxrBDREREisawQ0RERIrGsENERESKxrBDREREisawQ0RERIrGsENERESKxrBDREREisawQ0RERIrGsENERESKxrBDREREiuZQYSctLQ0qlQpz5861tFVXVyM+Ph7e3t5o3749YmNjUVxcbMcqiYiISE4cJuycOnUKf/7zn9GvXz+r9nnz5mHv3r3YtWsXsrOzcevWLUycONFOVRIREZHcOETYqaioQFxcHD744AN06NDB0l5eXo4tW7Zg9erVGDFiBEJCQrB161acOHECubm5dqyYiIiI5MLJ3gU0Rnx8PMaMGYOIiAgsX77c0p6fnw+TyYSIiAhLW3BwMAIDA5GTk4PBgwfX25/RaITRaLQsGwwGAIDJZILJZGqwjtp1WrXQrPH8sr/Wqnb8rX0epCS3OZVLHUTUusk+7OzcuRNnzpzBqVOn6qzT6/VwdnaGp6enVbuPjw/0en2D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9ufsEBERETUHww4REREpGsMOERERKRrDDhERESkaww4REREpGsMOERERKRrDDhERESkaww4REREpGsMOERERKRrDDhERESkaww4REREpGsMOERERKRrDDhERESkaww4REREpmpO9CyAiov/os/QgjDUqe5dBpCg8skNERESKxrBDREREisafseyo28L9kvZ3PW2MpP0REREpAY/sEBERkaIx7BAREZGiMewQERGRojHsEBERkaIx7BAREZGiMewQERGRojHsEBERkaLxPjsKIuV9e3jPHiIiUgoe2SEiIiJFY9ghIiIiRWPYISIiIkXjOTtULz63i4iIlIJHdoiIiEjReGSHWkR9R4q0bQSsGgT0WXoQxhqVHar6CY86EREpm2KO7KSnp6Nbt25wcXFBWFgYTp48ae+SiEhBuI8hclyKCDufffYZEhISsGTJEpw5cwb9+/dHdHQ0SkpK7F0aESkA9zFEjk0RP2OtXr0aM2bMwMsvvwwA2LRpE/bv34+PPvoICxcutHN11NpIfXK3GC3902Br+QmQ+xgix+bwYefevXvIz89HYmKipU2tViMiIgI5OTn1vsZoNMJoNFqWy8vLAQClpaUwmUwNvpfJZEJVVRWcTGrUmO13jolSOJkFVFWZ7T6fd+7ckbQ/p/uVkvYn6r1beE4fNnd3794FAAiCYPNabEXsPob7l4bJ5b95W1H6+ICWHWNj9s2N3cc4fNj58ccfUVNTAx8fH6t2Hx8f/POf/6z3NampqUhOTq7THhQUZJMaqWEv2rsAAB3fs3cF0mrJOW3s3N29exceHh62LcZGxO5juH95MDn8N29LSh8f0HJjFLNvftg+xuHDTlMkJiYiISHBsmw2m1FaWgpvb2+oVA0nVYPBgICAANy4cQPu7u4tUaqicT6lJ7c5FQQBd+/ehb+/v71LaTHcvzRM6WNU+vgA+Y2xsfsYhw87HTt2RJs2bVBcXGzVXlxcDF9f33pfo9VqodVqrdo8PT0b/Z7u7u6y+JCVgvMpPTnNqaMe0akldh/D/cvDKX2MSh8fIK8xNmYf4/BXYzk7OyMkJARZWVmWNrPZjKysLISHh9uxMiJSAu5jiByfwx/ZAYCEhARMmzYNoaGhGDRoENauXYvKykrLlRNERM3BfQyRY2uzdOnSpfYuorn69OkDT09PrFixAu+++y4AYPv27ejRo4fk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\n", "text/plain": ["
"]}, "metadata": {}, "output_type": "display_data"}], "source": ["fig, ax = plt.subplots(nrows=1, ncols=2)\n", "#\n", "df[['porosity', 'permeability']].hist(bins=10, ax=ax)\n", "ax[0].set_title('')\n", "ax[0].set_xlabel('permeability')\n", "ax[0].set_ylabel('number of occurances')\n", "ax[0].set_ylim([0,175])\n", "#\n", "ax[1].set_title('')\n", "ax[1].set_xlabel('porosity')\n", "ax[1].set_ylim([0, 50]);"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "subslide"}}, "source": ["## Reference Figure"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["Below is a nice reference bar chart that was created from a Pandas DataFrame. The DataFrame is stored in the variable `top_10`. All of the commands that customize the plot are shown."]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "-"}}, "source": ["
\n", " \n", "
Image credit: pbpython.com
\n", "
"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "slide"}}, "source": ["## Contour plots "]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["The following is an example of a filled contour plot in Matplotlib using the command [`contourf`](https://matplotlib.org/3.1.3/api/_as_gen/matplotlib.pyplot.contourf.html). If you prefer a contour plot with contour lines, see the function [`contour`](https://matplotlib.org/3.1.3/api/_as_gen/matplotlib.pyplot.contour.html). This figure shows the depth of a petroleum reservoir.\n", "\n", "Contour plots must have data that is defined on a rectangular grid in the $(x, y)$ plane. In the example below, the file `nechelik.npy` has already been organized in this way. Scattered data must be interpolated onto a rectangular grid. Any data that has the format of a floating point `NaN` (`np.nan` in NumPy) will be shown as white space in the contour plot."]}, {"cell_type": "code", "execution_count": 11, "metadata": {"slideshow": {"slide_type": "-"}}, "outputs": [{"data": {"image/png": "iVBORw0KGgoAAAANSUhEUgAAAosAAAHrCAYAAACn9tfQAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAPYQAAD2EBqD+naQAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4xLjIsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy8li6FKAAAgAElEQVR4nOyde5gcVZn/vz3dc5/0hFzIMCGBYBSMCyGE3TD+EIGNDDEgaNAVIVwENW6WNYmGbFZuC7hRLoKs3B5xCQquCwqoiSREwkUkICSG2y4h0ZCJDJPAkpmenvulf3801VNdXZdzqs45dar6/TxPP09murqqJ8l0f/r7nvc9iVwulwNBEARBEARB2FAR9hMgCIIgCIIg9IVkkSAIgiAIgnCEZJEgCIIgCIJwhGSRIAiCIAiCcIRkkSAIgiAIgnCEZJEgCIIgCIJwhGSRIAiCIAiCcCQV9hOQxejoKNrb2zFu3DgkEomwnw5BEARBlBW5XA7d3d1obm5GRUXwbKq/vx+Dg4MCnhkfVVVVqKmpUX5dnYitLLa3t2PatGlhPw2CIAiCKGv27t2LQw89NNA5+vv7cfhh9di3f1TQs2KnqakJu3fvLmthjK0sjhs3DgDw7c0noaYh3B9z32Cj8mu+N1Cv/JoA8H8Kr3ugv9b2+9395fsLDQADfZWBHj/S7+P3pTfJ/ZDkAFvin+xlPK7f+5hUX7D7AaCy133Tq1Sf95tZqnfE+zrZYdf7kz3eCUuih+EH6u7xPGQ00+19HiJWPPLuPYHPkclkMG3atML7cRAGBwexb/8odrzUjHHj1K2g6+4exZHHt2NwcJBkMY4YpeeahlToslg9GOzN2w9VlVXKrwkAlSl1100lq22/f1B9Dpm+8v2lrkgE+zfIJXz8vuT4ZbGCcXlIcpTxOIaNS5MeHpf0djgkhz1kcZhBFlPeF0qlPGQx6f33kqhgSGEqhjwPGU2ofw0jwiWdTgs7l8ilYOPGVSCtUBaJPPQ3TkSWCTW9YT8FgiAIgog9JItELEnXMtQkCYIgCILwJLZlaIKwE8ZyLk8TBEEQhB9IFolIM6GmF+/31zEf75Y4kkgSBEEQRCkkiwTxAU4iSRJJEARBlDMkiwThgVUiSR4JgiCIcoJkkSA4IXkkCIIgygnqhiYiT9gjdNK1/dR9TRAEQcQWkkWCEARJI0EQBBFHSBYJQjAkjQRBEEScIFkkYkHYpWg7SBoJgiCIOECySBCSIWkkCIIgogzJIkEogoSRIAiCiCIkiwRBEARBEIQjJItEbNBx3aIVShcJgiCIqEFDuQmCIAiCiAQdI0PIjqjLubIjo8qupTOULBKEYihdJAiCIKIEySJBEARBEAThCMkiESuisG4RkJsu1tQOSju3I3Uj6q9JEARBKIFkUQFNVZ1oqupUes3J1VlMrs4qvSYATKrpUX5NKySMwYQxWTss8JkEZ7gup/Bawc8xVKfmZXWkodrzmFxDrYJnQhBE3CFZVIhqYQRQ1sIYBWnUdf2iL2HkTBdHasRK4AiDFw0LcKehukTgcwzXJ4M/EVGMa/A8pKIxreCJEAShKySLigkrZVTNpJoekkZGZAljFMrRrMIYtXRRBEMNNKyCIAg9IFkMCdXSGIYwAnqkjID+pWkdhTGK5WhV6aIXOpWiCYIggkKyGDKqhbFcy9KA/iljbIQx5HK0CqJUimZat8hQiiYIonwhWdSAckgZdRFGQG9pLFdhZEVUuuh9neDnEIFOpWhat0gQ5QvJokaolMZyF0ZA39K0jsIoG9XpIpWiCYIg2NHnY6skmlJdqKsMXu5pHxov4Nmw0VTViY5B+debXJ3FuwNqy0+GML7XX6/0uk4Ywvh+vyZR0geka/uR6asJ+2kUSNYOY6SP8+WibgToZf/dG6nJIdnvXd4drssh1et+3EgtkOxjvrQvhuoSqOwNJrnD9UmkeuTPqMw11CKRlfwXQhBEbKFkkZHmyk40V6orFatKGct9HaOBjqVpGQljXMrRIvBKF8uuFE0jdAiCcIBkkROVwgioa4AhYcyjmzTGQhg5EDlKR8TaxaBQKZogyotnnnkGZ555Jpqbm5FIJPDoo486HrtkyRIkEgnceuuttvcPDAzg2GOPRSKRwPbt22U9ZSZIFn0Q55RRNToKI6CXNOomjNxonC564ZUuxq4rmiCIQPT09GD27Nm4/fbbXY975JFH8Pzzz6O5udnxmMsvv9z1fpWQLAYgjikjCWMxJIylyC5HqxzUraLRRQRUiiaIaLBgwQJcf/31+OxnP+t4zNtvv43LLrsMDzzwACorK22Peeyxx/D444/jpptukvVUuSBZDEgcU0YSxmJ0SRl12hpQt4HdTpRTKZogCHlkMpmi28DAgK/zjI6OYvHixVi5ciU+9rGP2R6zb98+fOUrX8FPf/pT1NXpsXg69t3Qqmiu7IxVxzR1SpcyoaY39K5p0V3SNbWD6O+r8vVY7g5pju5okZ3RnueoBVIujcLDdUDK5bOCLl3RIw3VSGb9vYERRFR4Z7ge9cPq9lbvGc7/Xk6bNq3o+1dffTWuueYa7vN973vfQyqVwj//8z/b3p/L5XDRRRdhyZIlOP744/HWW29xX0MGJIsCMRJGVdIYR2EE8tJIwuiMkTCKksYgwsgN5zgdEagYo6OCoYYUKrPBEl2mETrjGoBu9+pCRWMao12ZQM+FIKLE3r17kU6PLcGoruZvKtu6dSt+8IMfYNu2bUgk7D/k/sd//Ae6u7uxevVq389VBlQfkYDqsrRMyn1PaTviWJZWun6REZVrF2VDpWiCiDbpdLro5kcWf//732P//v2YPn06UqkUUqkU9uzZg29+85s4/PDDAQCbN2/Gli1bUF1djVQqhZkzZwIAjj/+eFx44YUifyQuKFmUhMqUkRLGcNAlZQw7YdShHO15Ho90UYdStAioFE0Q+rJ48WLMnz+/6Hutra1YvHgxLr74YgDAbbfdhuuvv75wf3t7O1pbW/Hf//3fmDdvntLna4ZkUTKqpNFIGGVJIwmjPSSMeXzt8CIQEWsXwyZqu7lQKZogSslms9i1a1fh6927d2P79u2YMGECpk+fjokTJxYdX1lZiaamJhx55JEAgOnTpxfd39CQf9/90Ic+hEMPPVTys3eGaiOKUFWallmWppK0PXErSStBwigdz/N47dgiuXNaRClapxE6BEGU8tJLL2HOnDmYM2cOAGDFihWYM2cOrrrqqpCfWTAoWVSIypSREka16LDHtKiEUcdytA5QKZogCC9OPvlk5HLsrwNe3c6HH3441/lkQcliCKiYzSg7YaRZjPaEnTKKShh1a3hhSRej0OjiBe3mQhCEjpAshohsaYxjp/Skmh7tpbHchZELxVsBBi1Fe23/50XcStG0mwtBlAckixpAwsgPCaM7Ya5hLOd0UcRe0SIYaeAf60EQBOEEyaImyEwZZW8RGGZZWmdpDFsYRRDHdFF3tCpFU7pIEARIFrWDUkZ+dJbGMIUxjumiCKgrmiAIgo/Yv+I0pw6gPhXsk/rbwwcJejZsyOyajusAb0DfjukwZzGK6JBWuh2gByxDumXPXIxTVzTNXCQIggVKFhmYmjqAqakDyq8rsywtk7DK0oC+KWMcStK8cKWLVIouQlUpmgmauUgQZQ/JIgdhSGNUhREIrywN6CmNYQmjiHK0krWLZUQcS9G0dpEg4gvJog9IGNkJM2UE9OuanlDTG4o0hrV+UUa6KKIrWvYInSh1RYtqdCEIIr6QLPpEdcoY1U5pAxLGYqJYlqZ0US1alaIJgihrSBYDolIaZY/XkU3YwqibNKpOGcMqR9PaRXkoLUXTGB2CKFv0WvQSYaamDijrmm6u7IxkpzQQbrc0oGfHtMpuaVH7R4cNS1e05zlqgaRLI/BwLZAK0Cjs1RU9VFeByt5R/xdgRGVXNEHIpn34INQNq0vde4fpAyzAmSxec801SCQSRbejjjqqcH9/fz+WLl2KiRMnoqGhAYsWLcK+ffuKztHW1oaFCxeirq4OBx98MFauXInh4eLk4amnnsJxxx2H6upqzJw5E2vXrvX/EypEdcooAxVlaVrHWEpYaxn9ID1dFITs3VyCbv3HdI0IlqIpXSSI+MFdhv7Yxz6Gd955p3B79tlnC/ctX74cv/nNb/DQQw/h6aefRnt7Oz73uc8V7h8ZGcHChQsxODiI5557Dvfddx/Wrl2Lq666qnDM7t27sXDhQpxyyinYvn07li1bhksvvRQbN24M+KOqI+rCCFBZOixUCGOYw7qZoFI0FyylaGp0IQgiCNyymEql0NTUVLhNmjQJANDV1YUf//jH+P73v49TTz0Vc+fOxb333ovnnnsOzz//PADg8ccfx//8z//g/vvvx7HHHosFCxbguuuuw+23347BwXxacdddd2HGjBm4+eab8dGPfhT/9E//hHPOOQe33HKLwB9bPqpSRhLGYJAw+kOHZheWrmjPc0jercULESN0dITSRYKIF9yvVDt37kRzczOOOOIInHfeeWhrawMAbN26FUNDQ5g/f37h2KOOOgrTp0/Hli1bAABbtmzB0UcfjSlTphSOaW1tRSaTweuvv144xnwO4xjjHE4MDAwgk8kU3XRAhTSSMAaDhFENUSxF6zBCR7tSNKWLBFF2cMnivHnzsHbtWmzYsAF33nkndu/ejU984hPo7u5GR0cHqqqqMH58cYPElClT0NHRAQDo6OgoEkXjfuM+t2MymQz6+pwXYK9ZswaNjY2F27Rp03h+NOlEXRjjuq+0QbkKYxCkpotUiuZCaSmaEUoXCSI+cMniggUL8PnPfx7HHHMMWltb8dvf/hadnZ148MEHZT0/ZlavXo2urq7Cbe/evWE/pRJkp4wyhRGI9zaBQHkKY9TTRRGl6LCJZCma0kWCKCsCvUqNHz8eH/nIR7Br1y40NTVhcHAQnZ3FQrFv3z40NTUBAJqamkq6o42vvY5Jp9OorXX+1FtdXY10Ol100xXZwkhlaf+UozAGIQ7pYhR2c1FZiqZ0kSAIK4FkMZvN4s9//jMOOeQQzJ07F5WVlXjiiScK9+/YsQNtbW1oaWkBALS0tODVV1/F/v37C8ds2rQJ6XQas2bNKhxjPodxjHGOuBDllJGEUT0yhTHq6aIXskfo6IKoUjRBEIQVLln81re+haeffhpvvfUWnnvuOXz2s59FMpnEueeei8bGRlxyySVYsWIFnnzySWzduhUXX3wxWlpacMIJJwAATjvtNMyaNQuLFy/Gyy+/jI0bN+KKK67A0qVLUV2dfxFbsmQJ/vKXv+Dyyy/HG2+8gTvuuAMPPvggli9f7usHPCTVg+ZU1vMWFjKlMQ7CGJY0lpswBiHszmgqRYcElaIJomzgeoX661//inPPPRdHHnkkvvCFL2DixIl4/vnnMXnyZADALbfcgjPOOAOLFi3CSSedhKamJjz88MOFxyeTSaxbtw7JZBItLS04//zzccEFF+Daa68tHDNjxgysX78emzZtwuzZs3HzzTfjnnvuQWtrq6Af2Z64SmPUG1+A8FLGchJGbdNFKkWPXYNK0QRBhEQil8tF/2O5DZlMBo2Njdj2P1PQMI7/U3v7cHifmmVtGyhji0AD2dsEAghtm0DdtgcEIGV7wKDbAPb3VXEdP9LHuNtor7cksWz9l+p1P8Zt6z/Ae+u/lIfHu239l7/fe+u/VI+3PFdmvUXca/s/AOzb/3WzfZgb7dJjnBnBxsb+BwKfw3gf7urqCtxHYJzrR9vmom6cwu3+ukfwleO2CvkZokwEax9qCDtllEEcytJhoGPCKAPtd3aJObqVokWmiwRBRBu9Xp00I8zSNAmjPSSMeXRdvxgWUVi3qKoUrbzRhXHtIpWjCSK6kCwyEEdhlCWNcRbGciBIusjb6FJu6xZZiGy6SMJIELFGr1cmjQkrZYzieJ24CiOli9EmLiN0VKeLVI4mCIJkkZMwpJGE0R4SRiJqiChFi4TK0QRBsMDYjkhYaU5llXZMT00dkNYl3VzZKaVTuqmqU3qX9OTqrPIu6Uk1Pdp0SE+o6RXeGZ2u7Q/cGV2uDNd5d0V7MVRX4dkZPVyf9OyMHmpIMXVGs5BrqGXrjh7XwNQdXdGYpu5owhcdw42oGVKnLv3DajcR0BVKFgOgOmWkhJHQnTAHdItocgm6bpGFqKaLVI4miPKFZFEAKqVR9o4vMqRRtjCWezlaxtpFVWN0dGty0QWWRhdRaxeFQ+VogogdJIsCoZTRGRJGQgdUNLmI6IpWjfB0kYSRIGIFyaJgSBidIWGUB3VGqyNqpWjWdFFoswtBELGCZFECcSpLiyaOwhhX/Jaiw1y3GCdElaJFQ+kiQZQfJIsSiUPKGEVhVA2li/qgosmFBd1K0aLTRRJGgigvSBYlo1oYZUhj1ISRytHiUNHoUq5NLiylaF3TRYIgyguSRQXEYcQOCaM3uggj4Y6IJhcR6xZVQ+kiQRB+IVlUCAljKSSM4tGhHE3rFtWWolnTRdGjdEgYCaI8IFlUjOrmF9HIGt4ti7CEUQdpFIWqmYs6IWLdIguiStGikdIZzSiMBEHoB8liSES5W1r08O64NbwYhCmMOqSLYSGiyYUF3UrRotPFsHZ2oXSRIPSDZDFEqCw9RtzK0QZxShh54SlFq25yUTGcO38dMecJI13kgcrRBBFv9H4FKgOoLD0GCaO+lGMpWhUiB3SHlS5yQeVoIsY888wzOPPMM9Hc3IxEIoFHH320cN/Q0BBWrVqFo48+GvX19WhubsYFF1yA9vb2kvOsX78e8+bNQ21tLQ466CCcffbZKn+MEmIvi03JSjR73HSAhDEPCaM4yrkULQJV6xbjApWjCQLo6enB7Nmzcfvtt5fc19vbi23btuHKK6/Etm3b8PDDD2PHjh34zGc+U3TcL3/5SyxevBgXX3wxXn75ZfzhD3/Al770JVU/gi0h7DKvH83JSrSPDIX9NArC2D4s95O3IYxvDx8k7JzNlZ1oHxov5FxNVZ3oGBRzLoKQyXAtkOoLfp6hugQqe91L40N1FajsHfV+TvVJpHq8y/VDDSlUZr3L/yMN1UhmBzyPA/LCmMgy/IWMawC6vT+8VTSmMdqVYbo2Qcgkkyn+f1hdXY3q6tLkfcGCBViwYIHtORobG7Fp06ai7/3whz/E3/3d36GtrQ3Tp0/H8PAwvvGNb+DGG2/EJZdcUjhu1qxZAn4K/8Q+WWSlHFNGnZGVMJZbuhg2UtYtMqCqyYUF3XZzMSOjHE3rF4k4Mm3aNDQ2NhZua9asEXLerq4uJBIJjB+fD0i2bduGt99+GxUVFZgzZw4OOeQQLFiwAK+99pqQ6/mFkkULOqWMKhJGXdNFQj/Stf3I9NWE/TTyTS69wXctGa7LIdUrbr2gCkSnizzwJIzMMCaMBGGwb7AR1YPqgp2BwbwP7N27F+n02AcXu1SRl/7+fqxatQrnnntu4dx/+ctfAADXXHMNvv/97+Pwww/HzTffjJNPPhlvvvkmJkyYEPi6fqBk0QadEkbZKaOMsTqioHSRCBuV6xZZG11YO6NlDOqWMk6HIWGkdJEIm3Q6XXQLKotDQ0P4whe+gFwuhzvvvLPw/dHR/IfBb3/721i0aBHmzp2Le++9F4lEAg899FCgawaBZNEBXYQRkF+WJmEkCP+wzFsMqxRNwkgQ+mGI4p49e7Bp06aixPKQQw4BULxGsbq6GkcccQTa2tqUP1cDkkUXSBgJglCJ6HSR69qCtwIEqEOaIKwYorhz50787ne/w8SJE4vunzt3Lqqrq7Fjx46ix7z11ls47LDDVD/dAiSLHpAw+oPSRWfKrRRNTS55WNPFsMrRADW8EERQstkstm/fju3btwMAdu/eje3bt6OtrQ1DQ0M455xz8NJLL+GBBx7AyMgIOjo60NHRgcHB/OtkOp3GkiVLcPXVV+Pxxx/Hjh078PWvfx0A8PnPfz60n4saXBgwhFGXxhdA3ngdkU0vNE4nfCbU9OL9fo3bcf2isMllpBZIekyDETVCRxZhN7zQSB2iXHjppZdwyimnFL5esWIFAODCCy/ENddcg1//+tcAgGOPPbbocU8++SROPvlkAMCNN96IVCqFxYsXo6+vD/PmzcPmzZtx0EHiGlJ5IVnkQDdpLDdhlMHk6izeHaAdJVjRpiM6ogzXASmGWekscxfzx7F1R/PAOn8RIGEkCCsnn3wycjnn3123+wwqKytx00034aabbhL51AJBZWgf6DKTsdzmMcapHF1upWhCHmGWowEqSRNEOUCyGAAdpFGWMJbb+kVCLjzrFok8IveMNiBhJAjCDySLAghbGstNGGVA6aI+qG5yGa4T0wjDMkInfz0hlyuCpzuaRxh54BFGZkgYCUILSBYFErYwypBGHYUxTuVoIgB1Yhs23FA5nNuMjHSR6/qc43SkzGBkhISRIORBsiiYOKaMNIORIMQSpXRRxvxFQHw5GiBhJAhZkCxKgoTRHkoXi4liKTpd2x/2U9AW1lI0Dzzpog7CGOb6RYCEkSBkQLIokTBTRhJG/1A5Wg5hDecmnCFhJAiCBZJFBcRJGEWhe8MLER9ENbmIXrfIU4qWlS4C8RVGgiDEQbKoiLBSRtHCqNv6xTiki1EsRWuDwiYXVmSUogG5wsj1PCIijJQuEoQ4SBYVE4Y06iqMuqeLVI4mZCOj0cVA5jgdEkaCKC9ou7+QUL11oOjtAUVtCShiO8A47Bs9qaYH7/XXh/00pFNTO4j+vqqwn0ZkYd0G0A+8+0fL2haQINx4b6AeVZXqXkMGB2hDAYCSxdBRmTJSwsgPpYvhoWOTi4x5i7qki4C8gd2AhBmMlC4ShDJIFjVAZWlaV2EMCm0DqBatxucwrFtUuZMLIG/dIsA/qFuXhheAhJEgogrJokaUszBSukiUM7zpIgmjCRJGgpAOyaJmRFUYRRBUGCldJFTAWoqWmS4CJIxFkDAShFRIFjUkisKoy/pFEsZi3u+XuCDOJzzDucsJP2sXdRNGGV3SJIwEET4ki5pSzsJIEAYim1xUr1sE+NNFmc0uBrKbXkgYCSJ+kCxqTLkKo47pIq1b1BzFw7lldEUbyF6/mH8MCSMJI0GwQ7KoOSSMhF90LEGXI37WLpIw2kPCSBDhQLIYAcpVGIMQtbWL5TCQ24zO6xZZS9E86aLsZheAhLEEEkaCEAbJYkSIojAGhdJF/8QpVdRxOLcKVDS85B9DwkjCSBDukCxGCFXDu0UJY9jlaNHpIq1bLEarwdyMsDS5yEJFORogYSyBQxhJGgnCHpLFCFJuwkgQTChucgH4G11IGNkISxgBShkJwg6SxYiick/poAQVRp3SxSgQlRJ0HNYt+jo3CSMTPMLIJI0kjAThG5LFCCNbGHVqeKH1i+WNzusWZY7RMUPC6A4JI0HIg2Qx4pSTMPpFZLpI6xajT5jrFg1UdEcbkDBaIGEkCG5IFmOA7MYXXTqk45oultvYnKjAU4r2ky6qKkcDJIwlcAgjQRAA3+7vhNY0JyvRPjIk59ypLNqHg7/ATk0dwNvDB/l/HpWdaB8az/24pqpOdAzyPy5qRGW9okFN7SD6+6rEnbBuBOjlk5aoMVwHpHr5HzdUl0BlL1+qOlRXgcreUebjh+uTSPWwNxoNNaRQmWVbYjDSUI1kdoDp2FxDLRLZPveDxjUA3d4fhCsa0xjtyjBdl5DP/w3UozIl8DXDg6GB6PQHyISSxZgRhYSROqQJP+i8bhFQly4C+ieMPCljFBJGKkcT5Q7JYgyRWZbWoSTttxxdjp3RRDB4u6JJGMeImzASRDlDshhjdBbGKKeLuja5hFGCjuJgbkCPJhczURFGmesYeYVR6CxGBmGkdJEoZ0gWY05chZHSxfig87xFP6gapWOgUhjzj9NDGAHBw7tJGAnCEZLFMkBnYSx3qBOaD6Z1i4J3cpE5oLvoOgEkM27CGNpuL1SSJghbSBbLBF2FkdJFIo74TRdJGE3n11QYKV0kyhGSxTKChFEcuq1bjNrIHB3gWbfoJ12MmjCWyyxGEkaC4Cf2stghae5gVImjMPpBl3RxUk2PkPNMqPExeE8jeNYtiixF6yyMQZpedO6UJmEkiOgRe1kEgPaRoaJbuaOrMPq+LqWLhMYEaXiJSlmat1Nah1mMJIwEwU5ZyKIVEkc9hZHSRUIomqSLQDSFUbeUkafxhYSRIMRSlrJoppylMU7CGFazi07pIpWi/RN3YSzHsjQJI0GIo+xl0aBcpZGEUQ8oXZSE4DE6BmEJY5TK0jzIFEYWaSRhJAh3Asnid7/7XSQSCSxbtqzwvf7+fixduhQTJ05EQ0MDFi1ahH379hU9rq2tDQsXLkRdXR0OPvhgrFy5EsPDxUnBU089heOOOw7V1dWYOXMm1q5dG+SpMlOO0qijMKokTuliORFmugiEI4xAdMrSUdtTmoSREMEzzzyDM888E83NzUgkEnj00UeL7s/lcrjqqqtwyCGHoLa2FvPnz8fOnTuLjnnzzTdx1llnYdKkSUin0zjxxBPx5JNPqvwxSvAtiy+++CLuvvtuHHPMMUXfX758OX7zm9/goYcewtNPP4329nZ87nOfK9w/MjKChQsXYnBwEM899xzuu+8+rF27FldddVXhmN27d2PhwoU45ZRTsH37dixbtgyXXnopNm7c6PfpclNu0ihrP+nmVNaXNJZjukhI2s2FI10sF2FUlTLqtkWgF0zC6AEJY3nT09OD2bNn4/bbb7e9/4YbbsBtt92Gu+66Cy+88ALq6+vR2tqK/v6xrVPPOOMMDA8PY/Pmzdi6dStmz56NM844Ax0dHap+jBISuVyO+9Uum83iuOOOwx133IHrr78exx57LG699VZ0dXVh8uTJ+NnPfoZzzjkHAPDGG2/gox/9KLZs2YITTjgBjz32GM444wy0t7djypQpAIC77roLq1atwrvvvouqqiqsWrUK69evx2uvvVa45he/+EV0dnZiw4YNTM8xk8mgsbER6185Ah8+qI/3R2RCViIXNrIkuX2Yf3eEt4cP4r/O0HjuxwBAx6C/xwHAuwNidn4QsaNLGDMXM301ws7V31fFfOxIH8f2cL1sEpLs5y+7pnr9DbYGgGTAl6dUgKF8l9gAACAASURBVMenfC5zrezll+TK3lGu41M9fEsIKrNsSXMyO+B5TCLr8ZfazfYBeLQrw3ScjmzsfyDwOYz34a6uLqTTwSTaONenfvs1VNazv0YEZahnEJs+fbevnyGRSOCRRx7B2WefDSCfKjY3N+Ob3/wmvvWtbwEAurq6MGXKFKxduxZf/OIX8d5772Hy5Ml45pln8IlPfAIA0N3djXQ6jU2bNmH+/Plif0BGfCWLS5cuxcKFC0ue9NatWzE0NFT0/aOOOgrTp0/Hli1bAABbtmzB0UcfXRBFAGhtbUUmk8Hrr79eOMZ67tbW1sI57BgYGEAmkym6GfiRFBbiOpJHZsqogjCaXagUHQ6iS9EAf7oIBNsSMOyU0Q+q1jHKSBmFJIyM2wJSyhgfrH4xMOD9ocPK7t270dHRUeQ3jY2NmDdvXsFvJk6ciCOPPBI/+clP0NPTg+HhYdx99904+OCDMXfuXGE/Dy/csvjzn/8c27Ztw5o1a0ru6+joQFVVFcaPL05opkyZUohPOzo6ikTRuN+4z+2YTCaDvj77T3xr1qxBY2Nj4TZt2rSi+9uHG6RJY+EaMRNHHZLTcitHU6OLpFI0ILUcDURbGP1Io991jDqUpUkYCV6mTZtW5Bh2DuSF4Th2fmPcl0gk8Lvf/Q5/+tOfMG7cONTU1OD73/8+NmzYgIMO4q+0iYKjhgPs3bsX3/jGN7Bp0ybU1IgrO4lg9erVWLFiReHrTCZTIozAWMooO+UyC6MO0uUX47mLEuDmVJZb2qemDvgqR/uhqarTdzl6cnVWWDk6CBNqestq+79k7TBfOZqRkZocd0l6uC7nuyQ9UhusJG0Io9+y9HCdv7L0UF2Cuyw9VFfBVZYerk8yl6WHGlJMJemRhmrPknSuoda9JD2ugbkkTYjhQH8tUkm2sUgiGO7Pf1jZu3dvURm6ulrOc8jlcli6dCkOPvhg/P73v0dtbS3uuecenHnmmXjxxRdxyCGHSLmuF1wf8bZu3Yr9+/fjuOOOQyqVQiqVwtNPP43bbrsNqVQKU6ZMweDgIDo7i1Odffv2oampCQDQ1NRU0h1tfO11TDqdRm2t/ae96upqpNPpopsbslPGomvFIG0UKby6l6PDhtJFiUgapWMmzIQRCC9l5H9M+SSMlC5GH6tf+JFFw3Hs/Ma4b/PmzVi3bh1+/vOf4//9v/9X6A+pra3FfffdF/wH8QnXb+vf//3f49VXX8X27dsLt+OPPx7nnXde4c+VlZV44oknCo/ZsWMH2tra0NLSAgBoaWnBq6++iv379xeO2bRpE9LpNGbNmlU4xnwO4xjjHKJQKYyAvMYRVYQpjCp3d9FlZ5dyhrcULWPtIuCvHA0EF0YRZWnVaxlVlKV51jGy7vhCwkioYsaMGWhqairym0wmgxdeeKHgN729+Xi/oqL496KiogKjo3xNYiLhqt2MGzcOf/M3f1P0vfr6ekycOLHw/UsuuQQrVqzAhAkTkE6ncdlll6GlpQUnnHACAOC0007DrFmzsHjxYtxwww3o6OjAFVdcgaVLlxZMfcmSJfjhD3+Iyy+/HF/+8pexefNmPPjgg1i/fr2In7mI9uEGpfMA20eGqCztEz/l6ObKTt/d0X4o11J0urZfaEe0VOpGmDujAX/laCBYSRoIXpYG8sIYpCwN8Jemo1iWppI0IYpsNotdu3YVvt69eze2b9+OCRMmYPr06Vi2bBmuv/56fPjDH8aMGTNw5ZVXorm5udAx3dLSgoMOOggXXnghrrrqKtTW1uJHP/pRYaRgWAjfweWWW27BGWecgUWLFuGkk05CU1MTHn744cL9yWQS69atQzKZREtLC84//3xccMEFuPbaawvHzJgxA+vXr8emTZswe/Zs3HzzzbjnnnvQ2toq+ukCoITRDyKEV+dydNjpIpWi9SKMhBGIdsrI/5hwy9IqEkZKF+PPSy+9hDlz5mDOnDkAgBUrVmDOnDmFWdKXX345LrvsMnz1q1/F3/7t3yKbzWLDhg2FPpBJkyZhw4YNyGazOPXUU3H88cfj2Wefxa9+9SvMnj07tJ/L15zFKGDMZPrRtrn48EFss65UJoxRThfNiBBfXlmPwuxFEeli0JmLqptcRCeLPPMWDWTMXTTjJ2EEgs1hLFxbwLjYOM5k5JnHyNL4omIOYxTmL+o6Z/H4h5chVa+wwaVnAC997lYhP0OUKYu9od8ePohJMFQ3vcQBETMZVaxfjGKzS7mni9JG6Bj4aHYJK2EExDW/+E0ZdZ3JyLuO0QtKGAmilLKQRQMSRnnEJSm1EnY5OggTanxGQT5J1/Z7HyQZWY0uIhAljGF2TMehW1qZMBJEjCgrWQRIGGUSRBjjli6K2tGl3NNF6ShMF4G8MJZryqiqW5rpvCqEkdJFIkaUnSwC+gljnIijMEY5XYw6fkrR3OmiYmEE4pMy+kFFWZrpnCSMBMFMWcoioJcwxildBNQKo86U437ROpSifRFRYQTCTRlVbxXIimphdIVxW0CC0JnYy2LHcKNjJyxL44uxp7TdTSRx2OXFjCphnJo6wJ0wNld2cieMTVWdvhJGEcIYpBStet0ikBdGkdKoJF0EQhNGShl5jmcvS6sUxiANL5QuElEg9rJo0D40vnCzYkgja9d04ZwuIulXJg1pjIM4Ukk6TzkKIzAmjSLEUXdh1CllDGsuo44pI2unNAkjQbgTe1ncN9hY8j03cQTgSxztCCqQcRBHEsY8YQtj2MRdGAF9UkZAnDT6epzClJEVbYTRBRJGQmdiL4tAfrCycbPCI45+E8ii65WhOEZBGP2UpXkJcw1jWOmimbDWM6oWxjhJYxgpI9/xERNGanghIkpZyKIZVnFk2fEjqEj6TR2jKI0ihnez4kcYAf6U0c86xqDCGMVytJmgwuh3ULdKYQSCp4yAuNI0EK2UkbcsTcJIEPKJvSy+N1DvuPWamzgC/PJoxo9A+pHGqOFHGP10SAcRRtkpIwljsHWM5SaMlDKyHCu28YWEkSCK4dhINdqYhdHuzdosjE5v/lZh5JUKQxi9RMYQRhZJMoQxSjuoNCcruUW3OZXlLt0bf89+lgw0V3ZyfUBoqurk2kd6cnVWyP7RUSZd2+97P+ma2kFfe0f7om7E1z7SwJgw+t1T2sAQRhF7TBvC6Hev6eFaf3tMD9fx7y89VJfg2lt6qK6CaV/p4fqk557SQw0pz72kRxqqmfaStmVcg+se0hWN6UjsIa2a7v4aJCvU7Q09EvB3Ny7EPln8v4H6ku+9O9BQdLPilTgaWJNHVrlgTRvjnDKqShgBdSljVIZ365AuGqhOGH1vBxggYQTEpIyA+KTR9/NQmDLKKkuLShjdoD2kibgQe1kEgPf66ws3O1jFkSU54hVIL2nkKU1HbS1jFIQR4EuQeYQxSDk6aGc0CaMP6kYCl6V1k0YRpWlfj1NQlmZ6HgKEUWaHNEDCSOhBWciimSDiCLCnjmZYxJFFGpmvFzFh5JVGEsb4obpT2rcwAtqkjIAe8xlVp4zsx0ZEGBl2eCFhJMIm9rJ4oL8W7/fX4f3+0lclkeLIKo8s0uj4WEoZx45PZZU2vgD6CaOIdDEOCaPShhcDAcKoW8oIRCNlJGEkCPXEXhbNGNIoQxyBUnl0E0iv2Y5uxDll5H6MT2FUNV6HlbBnMOoijuUkjICe0hiFlJFnHSMJI0EEJ/ay2N1fY9txKUIcWWAZz2OHaGGMijRGYR0jqzCqGKkjelcXHaSx3IQREF+aFiWNvp9DAGnkIYrC6AqDMBJEGMReFg0yfTWFmxW/4siSNprxGgZuReQ6RiA6KaNqYZS560tUOqSt6CCNfggijGE1vhiITBkBMdIYRgNM3IWRGl6IKBJ7WRzoKxWPoOJoh3Ucj1e52g43aXTC77aBuqNSGIFg0uiF7PWLMveMDksawxjaDQhIGUkaS6/vI2X0U5ZmO06cMAaBytFE1Ii9LAJAf19V4WaFRRytuEmjGTd55O2o9rsXtRMkjPb4kUYdhFE2YUhjJIUREFqa1lEafV9fcsqoWhjDXr9IECopC1k040cc/a5ttOI0x9EK7zpG3nSx8LgYC6NqaYxzSdoMCSMjglJGQOx6RiC4NIaRMrLC2vgSB2GkdJFQSexlcaQ/hZG+/M0KiziacZJGoFgc3eTRbfC3GVXCGAX8bmUYVBgBviYYkcLImy7KLEVbUZ0yRlYYAW1TRiD4jMag0sh1vISytC7C6AoJI6EJsZdFM4Y0uomjFV5pNHCTR7fdYsyoEMYopItAdISxnFApjZEXRk2lMczStIqU0fuY8IUx6JaABKGC+MtibzJ/s+Akjk5po19pNHCSRiskjM5EQRjLJV00Q8LIiCBhBPSTRtUpIyuswsgijaEKowuULhIqiL8sGhjS6CKOVnilkTVxNKOLMEaFIMKoah1jmMIYFlEYtRNUGHVLGQE50hgEv9LImzKG2fjieg5ZwkjpIhEy5SOLZhzE0SttNOPUQQ14yyNLWVq1MEYlXQT8CyOgLmUMSxjDShcNZEtj0D2kgwgjIDhl1FQawy5NMx8bgjCKmMHohl9hpHSRkE3sZTE5kECyf+xWAoc42pWo3UbvGNiJo916Rqs0WhtfeId3G3tJs+4pbcxgjMIsRhJGZybV9MRaGkUIoxYpIyBUGAHx0hjouQRIGZmP5Wh84dlT2vWaAWcwyuqQJmEkZOL/I1BEMQtjyYuqWRhNL+JmYTTeJAxhNL/pOAmj+c3NEEbzG6khjMYbvCGMhiAYwmiIhVkYzUJiFkY7mbEKo5c0mYUxiJzJojlZ6Vtqm1PZwOX6qakDnvMvmys7HVNhg6aqTqaZm8b/B9Ydg4z/T6yjnWRg/n/Our6XhXRtv+sHNBZqagdtm9pYSdYO2y5f4cZ4rbFZIuMX47XN9gMyB4Ywpnr9n2ekFkj2cV63FkhxPGa4DkgxfDYZqkugstddgofqKlDZO+p+vfokUj3Ooj/UkEJl1vkDxUhDNZLZAfcn68S4BqDb/rW7ojGN0a6Mv/NGhIG+SlQk/P/e8jLa5/5/oVyIf7LYm0Dqg1vJff0uqaNH4mhgThud3njs0ke3tNHAK2kEvNNGr91fWJNHXRPHoAmjiHWMntdhTBhlNr6EnTQC4tPGoAkjoFFZGhCeMgLiZjSGkTLKWscoqkta54YXShkJ0cReFs2kTOLIJY824sjSTe1WtjYjUhq9xJFVHt3QTRyDpp5BpZFVGMNufImjNOoijLquZQTElabDWstIwmgD45aAJI2EKGIvi0mX9xIeeSzgIY5OZSmWtY520mjGactAHnEE+FNHN3QRRxFl8iDSGKVO6bhJow7CCERDGkUgYswO9zVjLIxuiOiQJmkkRBB7WQTy62WsNzvc5NG1VG3BKo+sTTIGLCkj617TosSRhTgIIxBcGj3Pr4EwAvpJYxBxFCWMoqRRGJp3Tft+Hj7L0szHRkgYVe0hTdJIBKEsZNEOFoG0E0fPtJFjCLibNHqVpgHnkTtBxdEO3o7qsBDZiONXGlWvYww6i1EXaQSCDfhO1/bHM2UEYluajpMwBkHmloBWSBgJP8ReFlN9pTcn3OSRWRwNXOSRRRoNeKRRlDhGXRpFd277kUbV6xhFDO/WRRqDlqZ1EUZA75QR0KM0LbPxRaUw6trwYgcJI8FL7GXRDlaBdJJHL3FknefoJo0s6xl59532EkcrUZZGGaN+/AijyrK0qN1edJDGuAmjztKoQ2laZlm6LISRdnghJBN7WUz15edvec3gshNIq0SyJo5AqTzalq0/wE4aDbykEeBLGwHv9Y1WREmjanQQRkBtWXpydTY20qiLMGqZMgLaSqPqlJHpuAgJoxskjERYxF4WzRjSaHdzfIyNOLKUqt26qwu4SCNLEwyLNALeaaMV3q0FAX33o5YljLLK0iyoTBmBMWkMQxx1EEZA45QR0Lo07ev6EoWRRRrDFkaVDS8EwUrsZdFrWr8Bi0TyiGP+nPbyyCKNBm7rGQF3aeRd22jGb8roRphrGHVIGaO4jtFKmOLoF5GNL9pKY8xSxrAbX0RsDShTGF2hhJGQQOxlEcgLo9vNDb/i6CaPheNdpJGlNO21IwzAlzbylqbt0FUYAT1SxqiuY7RDlTjqNMAbEJcyAuVVmua+Nuc6RtXCGGaHtOiGF4Lwoixk0QtWmeQRR8C7QaZwnJ00foBbygiw7QgDuEujGZ7StNd8Rh2JWsooApHrGJ2QLY4ihTH2KSOgpTSqSBl1E0ZqeCHiQuxlMdU3ispe5xsLfsXRq0HGVRo9Usag0ui2nSDgXJq2wyqMOqeLBrqkjJ7n9BBG1uHdgNyU0YwscdRtX2lA85QR0HI+owphFNn4EmdhpHWL4unu7sayZctw2GGHoba2Fh//+Mfx4osvFu7P5XK46qqrcMghh6C2thbz58/Hzp07Q3zGbMReFr1wE0k7ofQSR55y9djjS6WxAOOoHQNWaQS8txMESkvTooRRB2SmjKzSyFKWjqIwGogWR12FsZxSRiC4NPpJGcPslI6zMBJiufTSS7Fp0yb89Kc/xauvvorTTjsN8+fPx9tvvw0AuOGGG3DbbbfhrrvuwgsvvID6+nq0traiv1/M65EsYi+Lqd4RpHpKbzzwiGP+mu7iaOAmjU4pI+AsjW7d0wBbeTqIMFpxE0Yd0kUDQxplDPNmhUUY3aRRZ2E0ECWNooVR15RR965pIHjntB9hlFGWZh2t40aYI3UIPejr68Mvf/lL3HDDDTjppJMwc+ZMXHPNNZg5cybuvPNO5HI53Hrrrbjiiitw1lln4ZhjjsFPfvITtLe349FHHw376bsSe1l0wk4g3W4GIsSRRRoL9zmkjECpNALeI3cAZ2k0YGl+YW16iULCaEa0OPKmjJ7nEyiMYUpjUILuJW1Fx5QR0L9rGhCTMnJfU9I6Rjd0HqkTJF2kUjQbmUym6DYwMFByzPDwMEZGRlBTU/yeW1tbi2effRa7d+9GR0cH5s+fX7ivsbER8+bNw5YtW6T/DEEoW1nkRaQ4Fr52kUbWlBEQJ41eZWmW8To8wqhTumiHSHFklUaVwghQymhG15QRiL80yi5LswijLiN13KByNDDSnyq85ym59effW6dNm4bGxsbCbc2aNSXPbdy4cWhpacF1112H9vZ2jIyM4P7778eWLVvwzjvvoKOjAwAwZcqUosdNmTKlcJ+uxF4WK7PDQm5mvMTRLI9uaxwLX9tI49ixLimjQGk04BVGoDRljEPCaEWkNHoRhjBGWRpFCiOgb8oI6D9qBwhWmo6DMAYdqUPrF/Vk79696OrqKtxWr15te9xPf/pT5HI5TJ06FdXV1bjttttw7rnnoqIi2roV7WevEB5xBOxTRx5ptKaMBl4DvQF/0mi377SBtSxtJ4xWWEfq6J4uykCUMLrBK4xA+NIYBF2FEYhAygholzJyXSuCwhhaw4sDVIr2Jp1OF92qq+3/DT70oQ/h6aefRjabxd69e/HHP/4RQ0NDOOKII9DU1AQA2LdvX9Fj9u3bV7hPV0gWfWAVRgOn5hk/0mhgV5YGXKTRpREGcJdGnrK0dbQOS0naaR/p9pEh7aVRx+coskvaTFjSqKMwUsoYDBJGl2uE0fBC6aIy6uvrccghh+DAgQPYuHEjzjrrLMyYMQNNTU144oknCsdlMhm88MILaGlpCfHZekPtVxJI9YzYvhBU9o4WvYBU9uaKXnBSvWMvUoYwDteOCeNI7VjKaLyYmoWx8MJsCOMHL/xmYTTeYAxhNN7AMn01hTdGQxgn1PQWhNF4IzeE0ZAJQxgNMTGE0RAZQxjNSZlZGM0pm5uMyRhx43XNsJmaOuCZ0DZXdrp2pzdVdTIlwXZMrs7adsfLZFJNj+3weFYm1PTajokKQrq2v2Tphl9qagdLxl0Fwfh9tn4oDIQhjL3+19aZGanJFX+wZWS4Llf0AdnzOh9IoN3uWSXnri2dg1t6/dKJFlaG6hKuu4AN1VW4zvMdrk+6TucYakg5hhMjDdVIZkubLIB8upjIOvyA4xqA7tIPgxWNaYx2ZRyfC8HGxo0bkcvlcOSRR2LXrl1YuXIljjrqKFx88cVIJBJYtmwZrr/+enz4wx/GjBkzcOWVV6K5uRlnn3122E/dFZJFSRgvAFZpNF44DGk0XmgMaTRenMzSOGx6ETReEK3SCIyJY4k0AiXiaCeNxhuiTGkE2MTRis5S54fmVFbZOs6gwgjYj1SShQhhBCBUGkULIwDh0ihUGAGh0hhEGAFwS6NKYfQiqDC64VsYHSBhDI6xnvGvf/0rJkyYgEWLFuE73/kOKivzgcfll1+Onp4efPWrX0VnZydOPPFEbNiwoaSDWjcSuVwu+MafGpLJZNDY2IiT512BVEr8PwJPicCp3GAtU1jLGtZSiLl8Yld2sZZubEtAljKTtZRlLpVZS3DmMp+1ZGgtW1pLoE4lU8/5gpzb6EUJFllkXvvJOPvSrzQaqJTGIMJoIDplBCBMGgGxwmggXBoBYSkjAF/SCPAJI8AmjIC3MOav7X6/W7qYv999tzAvWXRKFwE4yiIAd1m0SRcNRrsy2Nj/gOtzYsF4H+7q6kI6HWxdpHGuabf/Gypq1YnVaF8/9i69WsjPEGVozaICZK1ltL4YOq1rdFvb6LYrTNAmGLs1jXbrGt32mDbWOTrd4k7QRhcrftcxGoTZBOMH0fMYAfHNL9qvZQSErmfUbR2jiDWMYa5fpO5oQgUkiwpxk8bir53nMzrNZnTbPhCwaYgBPKXRwKsJhkcaATZxZE7UPGRSZ6EUmZp6NbuYCSqMgBppFLm3tM7CCERgmLeBIGkkYbQ5fxjC6AB1RxNWaM1iCNg1wNg1vwBgaoAxMDfC5I8fe6xnQ4zNmka7Jhgg/0ZpXs8IgHlNI1AsK9a1jWachJE3bfMSxjiXup0Iso7RjOw1jUHXL5oRvZbREEaRZWkZDTBSytJ1I4FL0yobX0StYfRCdsOLG27rFx1xaHYhCCskiyFh1wBjbX7Jf8+7AcZg2KYbkEUcR2pyjh3UTtJo1wQDeEsjUNoMA5SuuXNLyuwkMki51iqTuskjS1c04N0ZbcX4+xcpjYB4cRQpjID4jmmRzS9ARDqmASENMMYHVl5p5G18ESWMKjqkXc/t0h3thp/uaIIwQ7IYMm7SCHh3TQN8aWP+sfbjd5ykkbdzGuCTRqC0NGonPaoEUqU8iu6K5hVGQFzKaCAjbZQhjIDYlFG0MALiO6YBSdIYgZQxKsKo0zgdgjAgWVSI8Qtut/bE76gdIHjaaJZGu1mNfsftAM7SCLCLowFP+giUCqQIedQtdRSFaGEExKeNooUREJsyRqEsDUgcsxMjYfS+ZvCROq7nD0MYCcIFkkVFmH+xzX+2iiOvNOa/Z1+iBtzF0U4aHWc1Okij3XpGwFsaATZxNLATyCDyGDVxZC1FA/7SRUBsWdqKqAHfugsjUMYpo6CytA7CKGIGY5jrF31B6SLhAnVDh4zdftOA957Txd+zH7ljfSFz6qQee9xYF7XtyJ0PMHdOs+w5bdc9bbeVoLWT2ozRVe0mMk5d1nbwdFw7Xk9Qt7VuaaWIbmk7RHVPi+ySNtB5q0AD0SN2AIljdgLgd1/p4bocc7c0S5e07h3SNE6HUAnJogJYFiQb0sgqjoY0us1pBOzF0ZBGQxyZpdFm72kDXmkE2MTRTh5FiqMoadSN5spOrnE6VqIgjKKlUfeZjIC8uYxS9pkOiOzxOlERRtfHKhynQ5Q3JIsKSWYHim5O+BXHsa9z3OII2Etj4bk7SKPbUG+gdP2WIY1O4miHKHF0I6g0qhBGP6XzINLYVNUpRRpFzmeMSsooGlkpo1BpLCNh9CKIMHrNX3TDTRgdoXSRsIHWLErGED47OTR/z+mX2iqM5k+S1vWNbqN38t93b4qxW9Po2QTjsue0dT0jUPzGaV3XCJRu8WaVAad1joB3k4zbTEcDQxhF75zihey9oo2f2e9aRhnNL6K6pY3/I7qP1wHEN78A4rcMFLqeMeTxOizrGEWsYQyz4UXaOB0i8oyOjmLXrl3Yv38/RkeLl6+ddNJJXOciWZQIzy+wnUzaCaRdc4yTNALe4miWRuvoHSdp9DufEShthAGKx5dYUx2zADiJo11SZTfL0UCWNLYPN2i3/tCKX2mUIYyiES2NosfrANHpmAYEd02H1C2tkzDKbHgpq+7o3iSQE7dXuSd9Cq8lkOeffx5f+tKXsGfPHuRyxf/vEokERkb4kn8qQyvA+EVNZPu4fjGtZWvrL7y1VM26tjH/fed9qO0aYcaO8y5NA+7rGYGxNY2sZWrAX3OMV3naC97SdJB0kEU0RSWefsrTokvSsrYLlLGWUTSiG2BkrGUEBJemQypLqyxJR3H9IhFPlixZguOPPx6vvfYa3n//fRw4cKBwe//997nPR8miJNxSRSdhZFl0bFe6tpvfaBZGt8TRbYcYc9LIVZoGXOczAvZpI8CfOLKkjSJSxrgljAZ+dn0RPcBbxlaBMlJGkQmjgeikUWbKCAgoTYdUlhaZMHpfS17CKGOcTiTTRcKTnTt34he/+AVmzpwp5HyULErGnCp6YSSPTje7c5vl0akxhiVxtEsaC392SRl5R+0YGGlj0MTRqTHGLml0a4RhaYDhQccOaSf8JIwiU0ZZCSMgNmWU0S1tEIWUERA4aieElFFUwqiiQ9r13KrH6RCRZN68edi1a5ew81GyKAG3ppYgWIXR+AU3rmN+MXAa/O2UONoljSwpI5CXRp79poHiNx2vxNH6RurWGGOXNNo1wjiljCITRj+wNLrwDOhmvm7I2wTKShgB/feWNqCUkR/edYyiEkYRQ7vdkLV/dOzWLxJFvPLKK4U/X3bZZfjmN7+Jjo4OHH300aisrCw69phjjuE6N8miYOx+SQu/gLzT8T060ozzWqUR4BPH4fqk67aCIkvTcJYUAwAAIABJREFUhefnIY48ZWovaeQpTXuVpXmEUWY5moSRj6iUpQGxO8DI6pgGBDbABGx+4S1LqxRGN8IqR7sJIxFtjj32WCQSiaKGli9/+cuFPxv3+WlwIVmUhJBfRje5NImkVRrN17eWHpy6qZ3G71T25orWMzqN2uHaOhCwFUe/aSOPNDqN2+GRRp5tA2WUo0VLok7IFEZAbMooo1vaQMaWgZQyjsGzPaDreULskFY+TofQnt27d0s7N9eaxTvvvBPHHHMM0uk00uk0Wlpa8NhjjxXu7+/vx9KlSzFx4kQ0NDRg0aJF2LdvX9E52trasHDhQtTV1eHggw/GypUrMTxc/J/6qaeewnHHHYfq6mrMnDkTa9eu9f8TSsJubaDQVFEQbgPA7TqpC/c57Azj1DXNPNDbwOietlnbyLK+0W5to926RuuaRqfOaafh3l47wRjDvEXsBOOGimv4RcYaxqisYwTkrWWMSsc0oM9aRp51jCxrGHXokHY9N61fJEwcdthhhduePXswderUou8ddthhmDp1Kvbs2cN9bi5ZPPTQQ/Hd734XW7duxUsvvYRTTz0VZ511Fl5//XUAwPLly/Gb3/wGDz30EJ5++mm0t7fjc5/7XOHxIyMjWLhwIQYHB/Hcc8/hvvvuw9q1a3HVVVcVjtm9ezcWLlyIU045Bdu3b8eyZctw6aWXYuPGjdw/nArsBFHHiJ9FGAE4CmP+a7YGGEMazQ0wwJg0yhJHMyx7UgcRRxXyqLMg2hElaYzKdoFANLYMBEgY3a/jfr+bMAYZp+MGjdOJN6eccortiJyuri6ccsop3OdL5KzTGjmZMGECbrzxRpxzzjmYPHkyfvazn+Gcc84BALzxxhv46Ec/ii1btuCEE07AY489hjPOOAPt7e2YMmUKAOCuu+7CqlWr8O6776KqqgqrVq3C+vXr8dprrxWu8cUvfhGdnZ3YsGED8/PKZDJobGzEyfOuQColrpzjhDn2t+2AFp0s2qxnZPlE6PQCYf0Uav3Ean3BMr+4mV8IrS+a5hdapxdmxxd3mzcNuzckuzc+6xus3Zu4kyw4CYqXCAXZi9koZ4cphn52d3FD5IgdmaVpkc0vBjJK0yLL0gYyStPCBnkHHOLN0/jCUpL2GqnDsn7RrSTtVo7O3+/c8OK2ftGtHO0WbGzYfq3r82HBeB/u6upCOp0Wcq5pN16Pilr57+kGo3392LvyCiE/g0oqKiqwb98+TJ48uej7b775Jo4//nhkMhmu8/n+rR4ZGcFDDz2Enp4etLS0YOvWrRgaGsL8+fMLxxx11FGYPn16QRa3bNmCo48+uiCKANDa2oqvf/3reP311zFnzhxs2bKl6BzGMcuWLXN9PgMDAxgYGPuPz/sXERTX9SEhlaDt8FrLaLeOESjumM5/7byWEXBfzwgUi6P5Rb1IHBkbY+zWN1rXNtrNbHTaHcZpS0Gr/DitczTgkceopIc8GH8/IqTR+HeQNZNRtDBGafcXQKw0Cm18AXxLo+g1jGE3vLghY3cXIpoY1dxEIoGLLroI1dVj7/UjIyN45ZVX8PGPf5z7vNy/0a+++ipaWlrQ39+PhoYGPPLII5g1axa2b9+OqqoqjB9f/MYwZcoUdHR0AAA6OjqKRNG437jP7ZhMJoO+vj7U1tqnZ2vWrMG//du/8f44wuGZqxgmyeyA43aCbsIIeHdMA+6jdgBOcfTRGOO2L7XXntQs4giw70VtECR5jDJRkEYZwgjIk0bRKaPoBhhdtgrUTRiDNLzIGqdDxIvGxkYAQC6Xw7hx44qcqaqqCieccAK+8pWvcJ+X+7f5yCOPxPbt29HV1YVf/OIXuPDCC/H0009zX1g0q1evxooVKwpfZzIZTJs2LcRn9AEapYpW3FJGp32nAe+OacC5a9pApDi6pY1undROO8TIEEfAuczrJZFxkU7dpVH0eB0zoqVRljAC4lJGYZ3SgDJhZDqfpsLod5wOpYvx4t577wUAHH744fjWt76F+noxr2fcv8VVVVWF7WPmzp2LF198ET/4wQ/wD//wDxgcHERnZ2dRurhv3z40NTUBAJqamvDHP/6x6HxGt7T5GGsH9b59+5BOpx1TRQCorq4uilvDIKq/cHYpo1kYAWdp5Nk2EJAkji5pI0uJGpAnjoD3WkfetYIsWxTqjGhpjErKCIiVRhnCCGicMioQRlUzGIMM7HaDytGEwdVXXw0A2L9/P3bs2AEgH/YdfPDBvs4XuM1qdHQUAwMDmDt3LiorK/HEE08U7tuxYwfa2trQ0tICAGhpacGrr76K/fv3F47ZtGkT0uk0Zs2aVTjGfA7jGOMcUUD3ErQddiN23LYOLBxj2jIw/3XptoHWzmnzyB1grIPa+uJrdFNbX7xttxZk6KZmGb8DeG8taBUJp65qA3N3tcimD7eubD/nUo2o7mkZXdOiO6WtiOqcFt0pbSC6Y1qHTmnWLmnWbQE9zxOgQ1pWd7TbOB0iXnR3d2Px4sWYOnUqPvnJT+KTn/wkpk6divPPPx9dXV3c5+P6X7d69Wo888wzeOutt/Dqq69i9erVeOqpp3DeeeehsbERl1xyCVasWIEnn3wSW7duxcUXX4yWlhaccMIJAIDTTjsNs2bNwuLFi/Hyyy9j48aNuOKKK7B06dJCKrhkyRL85S9/weWXX4433ngDd9xxBx588EEsX76c+4dTie2nMo1L0E6okkYguDjajuKxSCNQujc169xGQLw4AuLlUaQ0hoFIaRSJjPE6VkRIoyxhBOwnDfglWTssRhoF7CvthaiROkHwK4xusxfdoFE68eLSSy/FCy+8gHXr1qGzsxOdnZ1Yt24dXnrpJXzta1/jPh/Xx4z9+/fjggsuwDvvvIPGxkYcc8wx2LhxIz71qU8BAG655RZUVFRg0aJFGBgYQGtrK+64447C45PJJNatW4evf/3raGlpQX19PS688EJce+1Yi/6MGTOwfv16LF++HD/4wQ9w6KGH4p577kFrayv3DxcGUUwV7XAqTQPOWwYC7k0wQLEwmj9Z+ylV25WpWdY2eu0U47W9IMBfqgacZYa3bO1EHMrTQeU5amsZDYKWp2V0ShtoWZb22SkdtYYXv1A5mli3bh02btyIE088sfC91tZW/OhHP8Lpp5/Ofb7AcxZ1ReWcRfMvl7IdW3zOWTRjFVunx7t94gwyn7HocTbvkU5lHLtP9HZJQEnZKcDcRsA5weGZ4WjAm4LxCiSvMOqWTIpIXGXNZpQpjUDw9YwyhNFA9FxGIWsZfaxj1G0Go9/5i35nLwLO496M9zNd5ywefv13UFGjcM5ifz/euuLbkZuzOH36dKxfvx5HH3100fdfeeUVfPrTn8Zf//pXrvPJGQ1fRtiKYkRJZPtsfwajNG33idNaomYtT1tfAI0ytdf6RsC+VC1jbaP1jdGuTA2U7hYDOJepDVjK1WZ4y9a6yR8vuq5lBNSsZwxCVMrSgKC1jD7K0qp3eQlj/SKVo8ubK664AitWrCiMJQTyowlXrlyJK6+8kvt8tNo1AI5xfQTWKrqJrXGfXdJo/pnNLyp2Q72B0vI0UFqizn9v7AXRrlRtV6YGSmc42nVTl5SoAaZOakBumdrArbPajo7B8Uwy1T40nilh1FUsRZSlAXkd04C8lHFCTW+ghDFqZWkgYMroo1Nat5K0G34HdgcpRxPR5s4778SuXbswffp0TJ8+HQDQ1taG6upqvPvuu7j77rsLx27bts3zfCSLZQhrAmo+jlUcvaQRKF3XmP9eMHG0W99oXdsYZG4j4D67EbAXR2tKZMiFUzplSI2sPZGjhs7CCOg/m1HmeB1As51fNBBGz3O4CKPf9Ys0rJuw4+yzzxZ6PpJFn1hTxUiWoK0JqM06SAOv9Y3WAd9O0gi4p43577uLo11jjNC0EWAa+A24D/0GvKURcE8b3ZpiRKaLOiNqLqPsLQMNZGwdWE4pY2BhBLikUaQweqWL3ud3FkbVw7qJaGPMWRQFrVn0gasoal6CdpXa7mzxzeM85puBdW2j29gdu7WN1hc8uzWOrOsbWdY22o7fAZhG8AClsxsB+7WNTiN4ADCtbbSjXNYvGohYxwjIT21ljNwRNZNRxnpGLWcycq5jFLmGMaz1i67ndFm/SLMX40tnZyfuuecerF69Gu+//z6AfMn57bff5j4X/S8JSJQSRW6ptTvGIX20rnN0ShoB+9E7gL/E0a1M7TdtBORsL2jgp0TtlDSWU8II6F+WNiM6bQyaMBrIShpFpozCxutomjAGWb/oRJByNBE/XnnlFcyfPx+NjY1466238JWvfAUTJkzAww8/jLa2NvzkJz/hOh8li5y4zqDSPFUUgjV9tKSQTkmjXdroNegb8E4cix7PkTYWP46hkxrgGvhthqeLGnAXCzvBCZIwRjF1FJkwqlobKiptFJEwGshKGUVRzgmj6u5oShfjx4oVK3DRRRdh586dqDGNGvr0pz+NZ555hvt8JIscRHmdolOqONqVKbn5wkEa3UrUgL042pWpAXtx5C1TF56LS4la5C4xZvyM3rEjSCIWRTm0Q5QwAmqbicpFGEVJo5BdX3wIo6itAYPs8kLCSAThxRdftN2pZerUqUXjdFih/x2MeIpiVFJFiyja4UcYKxrTxec3laudStSA/fgdwL0xBnDvqHZrimEpUecfJ2aXGN7ytF1p2qksbZYc1nK0jpjL4zwyK6rxBVBTljYQ0UEtqiQNlElZWnKntOt5XErSMsrRXlDDS3lQXV2NTKb0vfzNN9/E5MmTuc8Xe1n81eMrIzV1nfDm5NO/xz2/0UkaAbbxO/nHss9t9CuNdusZvcbtGPCsXyRKkdktbcekmh5thBGQI40iR+yEIYwsBB2p43ecjt/uaDfMo3Q+deJ3sOnZb3Ofg9CDz3zmM7j22mvx4IMPAgASiQTa2tqwatUqLFq0iPt8VIYmIolbmbr4e/Yl6qJz+VzbyFKiZtkdxihPm9+kWUrTdrvA8O70ogPtQ+MLNz+ITlSjVJaeUNMrtCwN6L2WMYySNAs6rl90vR6Vo2PPzTffjGw2i8mTJ6Ovrw+f/OQnMXPmTIwbNw7f+c53uM8X+72ho7afI8HGyad/r/Bnpxc+u7U7di+urPtSs+xJ7Wc/ars3Urs3bKsU2ImGl+hEtVTNggxBVpUyAsE7pkWmjAaiS9OiytKBO6U5E0bWcrRXwujWIe1Wjla9d7R5SVCQdJH2hg6fP/zhD3j55ZeRzWZx3HHHYf78+b7OQx8hiMhjt0sMwL+uEWArU7utbQyyrhEo3VLQrURtN9jba+vAIEKlu2iKGqtjRvVaRp3K0oD4HWBElaVVl6RFrV90Q3U52u9WgIQ7hx9+OPbs2VPy/X/8x3/Eddddh6uvvhqPP/442traMHnyZJx99tm47rrr0NjYKOw5jI6OYu3atXj44Yfx1ltvIZFIYMaMGWhqakIul0Miwf9/mWSRiCTWHWKA4NIIsO0SE3hrQY55jXbbCbKua7RKTtDyqlXEdJRHWcIIqE0Z/SJLGAHxaxlFCCMQIGWUIIwy5y/6FUY3qNlFPC+++CJGRsb+Tl977TV86lOfwuc//3m0t7ejvb0dN910E2bNmoU9e/ZgyZIlaG9vxy9+8Qsh18/lcvjMZz6D3/72t5g9ezaOPvpo5HI5/O///i8uuugiPPzww3j00Ue5z0tlaCKyfOrEsXUXdutseMrTY/f5K1PLKlEDpWVqvyVqK6LW5ukmjbLXa8qWRhEDvGWUpA1ESmPoZWkqRzOVo/2WoqkMDSxbtgzr1q3Dzp07bRO9hx56COeffz56enqQSgXP7+6991584xvfwK9+9SuccsopRfdt3rwZZ599Nn74wx/iggsu4DovNbgQsYB1W0HAedB3/j7xcxsLxzg1w7g0xAClMxvdthM0MJphWLYSdLuxoFtDTVNVp1SBlT3MW9QsRtGNLwYiG2BEzWT03fiiYcMLDevWk0wmU3QbGHDZoOMDBgcHcf/99+PLX/6yY+nXkFARoggA//Vf/4V//dd/LRFFADj11FPxL//yL3jggQe4z0uySEQWu0+7Tuts7KQR8C+Oha8ZOqmDdFG7DfpmkUYDL3F0glcadcKQRqdbUAxplCGOovaWliWNoveZjqMwBkF1d7QX5ipO2CRNmyeouCU/eO2eNm0aGhsbC7c1a9Z4PtdHH30UnZ2duOiii2zvf++993Ddddfhq1/9qrC/n1deeQWnn3664/0LFizAyy+/zH1e+thARBrrHtSA8z7UgPOQb6C0VOO2xpFlT2qe/aiDDPp2W9cIOO9BbcAiJk57U1sxhFG30rQdItc3yljXGLThxYyMtYyA2AYYUesYfZWkNVy/KBpqdgnG3r17i8rQ1dXVLkfn+fGPf4wFCxagubm55L5MJoOFCxdi1qxZuOaaa4Q9z/fffx9TpkxxvH/KlCk4cOAA93kpWSQizYbt1wKw30oQcN6HGiguU7Omjjxpo4GvEjXAPLPRjFva6CQL1pK1197ULEKkW8rohIwZjSLTRlEJIxCNlDFuCWNcytGAXuliGKTT6aKblyzu2bMHv/vd73DppZeW3Nfd3Y3TTz8d48aNwyOPPILKykphz3NkZMS1pJ1MJjE8zP87QskiESvskkYDt8QRsF/obd0phiVt5Bm/E6SL2u+WggZu4uC1awxL0hiVlFFGBzVQ/HejUye18e+u65idUDulJezyEmSHF9Xd0U5QusjPvffei4MPPhgLFy4s+n4mk0Frayuqq6vx61//GjWCm3VyuRwuuugiR5llWWtpB8kiEXkS2b7CvtMG1pTRKo92L3xuAsmzvaD0ErUPaQT8iSOLNLKUpstVGA2CzGsUWY42I0MadRJGQMA8Rg9EzF+MUjmaYGN0dBT33nsvLrzwwqKUL5PJ4LTTTkNvby/uv//+QrMMAEyePBnJZPAPKhdeeKHnMbyd0ACNziFiwoKZKwGgRBrtsEsdnWAdyWMt71hLQdayEcsOMbyjd1jG7hi4lQ2dxNGtJMpSdtVdGAG9x+7IEEYzopNGUWsZRUgjtzBKGKkTlXE6XqN0eMboyBid86F//XckFY7OGenvx5///V+5fobHH38cra2t2LFjBz7ykY8Uvv/UU0/ZdikDwO7du3H44YeLeMpSoDWLRKxIZPsKNyeM9Y3Wmx12ax7t1jk6rW0sPEZgF3UBH2N3DOzWNho4rXH0WsvoRRTWMcoW2iBrGUWuX7RD1z2mQ1nHGJP1i36gUTrBOe2005DL5YpEEQBOPvlk5HI525vOogiQLBIx4bFdN5Z8zyyOXgIJ2EukGbdZjoVjGKWRpSFm7DHipJGlIcaMnTAGSbhIGPUXRpHSSMIoDjdhdEJGs0u5N7qUKySLRHzozuZvLtgJJGsKaeCWNhaOEdhFPXa8P2lkSRu9kkYrdsIY1XmMduhcMp9U01O4yUKkNIrqlo6CMHoRJF10P6/zfaJnL1K6WJ6QLBLxw5BGD3E04ySRZpF0E0cDa4nabfxO4TGSpRFwThutOEkjCaNYRI7WkS2NoigHYYxaOTrIKB2ivCBZJGLDY/vuLP2mWRydbh7YpY8i08bC8SFII8+axjgJY3MlmwjK3DpQ5M4vMqVRdMoYlHIQRtfHKixHO3Hy6d/jfxJEpCFZJGLFaFeG/0GMMhk0bSzcH7AZRrU0mom6MDZXdhZEkVUYAXkpo+itAmWWqHUTxqDSGLYwuj5ek3I0pYuEAckiESs29j+A0a6M540LTnE0ECWNVnEsXE+QNJpxWs9oJqrCaCeHvMIoQxpl7C0NyGmGEZUy6tT4woVAYYx6OZrSxfKCVqoSZQmvMFY0fjBfy1y2HpeXIUMYjRmP1l1kDGE0FoZ7Dfq2DvkGineHYR3w7Xe4N5CXRutwb/Mb/Pv9dbZ7TvsVFJm7vXgJYXNlJ9qH2IVVxgDvIEO73TD+PUTPaBQx0FuHAd6+hnZz7PLiNbRb1u4uToje2YUoH0gWidixsf8BtNacJ/SchlwWpBEYE0dOaQTy4mhOGZ22FXTbUtCPNBalHb3JoqRkpC8VWBitsOzwYiYKu70A0RJGQO4uMGUpjAJxE0a/u7u4bQXohJ+dXU4+/Xuu2wDm/CwLIrSEytAEwYFtImlpkvEqTwOl2w1aX4itL9rWNMBvI4xRmi6kHUZp+oOkxGsto7XxxTq8224O47sDDYUbCx2D40tuQfBKDXlSRTNRKkkD8ppggpalRZak/Zalo7p+0U85WnSzC43SKQ9IFglCBAxd1SzCqEv3tHVGo19pdBNHlQLZPjTeVgr9iqJB1IQRkLeWMQiihBHwv44xTGHUqTva8To+ml1G6oNv1UjoAX0kIAhRdGcLJWkgnzBa96pOZgeK9qauzA6XfDJP9YwUvTDzlKYB5/I0kE8pgqxpNITReEM2hNF4szcLoyEQZmG0ExU7YWQRJjth9JK3oHJoh901g6ahMkvSgJy1jLqUpIFgZWkuONYvehGFcrTjYxpSruVokST7gaTKZZf2O8GWHSSLBCESn8IIFJdzrE0wQF4azWUiVmkE7Nc1mt+YhuuKF+KP1OR8SSNQKo7m1MkqJ04pl1WUWNM2mY0yPIgQSONnjpI0ihBGoLQD3w9+hFFmw4tXs4vn412EUXSzi5MwOq1dJOIPlaEJQjQ2axitsKxjBLxL0/nvuZengYAlape9p+32nHYqUTuN3HEqWZvhLV1HYYcYVmSXpQGx6xmjPlqHuxwNMJekZZajnc8p+HwO5WhauxhvSBYJQgFO+0/bCaOTNBYdx7GNoLAB3y7SCDiva3QSRy95dINFHEU0x4gkSNqpQhgBcdIoShjD2vFFpjB64SaMuje7EPGF/jcQhAxsGl5YhRGwl0Zrylg41kEaWcURGJNGQxxFSKOXOALsqaMbXuIYJ2GMkjTqtuMLL76EkYGwuqOdENnsQulifCFZJAhZOAijU1naDjdpdEobi7/nLY5uJWomaXTooAacd4SxW5PmJI0Avzha0SllDLqeMkrSKFIYg0qjEmGMWTma0kXCgP4nEIRMHEbquK1jZE0aAXtxtCtR57/vLI5AAGkEpKSNTrBKox1xEUZAvTT6RZQwAsFTxrgIo8pytOO5KF0sK+hflSBCwrrjixnr7i8G1l1gzDh1UJsJujOMqK0EAZTsDgOgZIcYAzvhMITRraPaTqZ4hDHsrmoWzD+jrp3TQbukzQQdsaOkS1rgSB0nVHVH+xmlQ8QPShYJQjYeA7udStMAW9roVqb2aoxRnTSypo1W/JaoZcpTUGQN9NZ1qDcljKVEvRxN6WL5QLJIECrozo7dHHCTRoBdHFnlUaQ0WrcTLGBZ1wiUlqgB7x1iDPyUqMtNGAE1u8D4kUbRwhhEGnVpegmjHO2En3K047lIGGMFySJBqIZRGlkTxyDyCNhLoyGOrNKYP9ZlD2qAWRrN+JXGKCFTGHVMGUUKIxAsZfS7NSAzmo7TUZEuEvGCZJEgwsJDGg28xBHwL49O0pj/Org0Av6bYcw4rVFzG7tjxm+6qKohRubaSBJGd3iFMYxytAyo2YXggWSRIMKGoURtYE0dWZNHr+HfukijGdaUEbCXxiiVo2UjO2UkYfRA8vpFVeVoGqVTvtC/PEHohFkcJQskwC+NheMCSmMRNrMaDXjmNAKItDA2VXUWbrJQNWqHlQk1vVo1vvAga2i3GzqUox2vQeXoWEOySBAKGO3KFN24sBNIxg5rN4n0I41+G2Hyx7o0wgBcKSPgvp7RDZ2F0UCmNMoSxqjPYpTe8BKTcjSli+UJ/asThGTs5DCQPBo4SaSLTNrJoyxpdNt/2sC2NP0BXh3TBl7CGHSkTpiDvGVJo1GWFl2eJmH0IGLlaCeo2aX8oNWnBCERVhFkOa6iMc13ca8S9riGosHg5kHghjAaC9TNA78NYcwP63Ue7g0UD/hmHu7dm/Qc6m19U3ca6m0IyHv99SUi4zS0W0fMwihDXq1/D2Glr8a/l4hOd7/Du5UM7fZgpCZXmrybGK7LFX3oKnqsy7Bu5/MV7xtv4DSomyg/SBYJIiL4SSBdBbM7C4zLSwGPNBrpAa80mneEMRIQO2ksCCNQJI1eu8AAeWnkFUZAXmm2uXJM8tqHxEheU1Wn9LQzyK4wk2p6fO3yYkaUNGopjAp2d3FCxc4uw/XJks0ARJLqA5IKN5RJlA6XKEuoDE0QkvBdXhb8HJxuAEpK1izlaRHDvb1K0wVcytKA81pGJ5wkRnSS1lzZWSSKxvdEoXIbQj8iHaQcbUZEA4zKkjQzGpajRTa7EPGDkkUilmzsfyDsp0CYOO5rtwAo3XvaqTTNW5YGSveaNiTBSKfcEkbAPWU0kjxWSROVIurC5OpsKAmjQdCk0fi/wJsy8iaMXOVohoRRVjn6lVuWsz3HgGQyGTQ2XqPkWoRcKFkkCEIZ5nVR1s7psWNsUkYfe01bu6WtTS9u+0kbNysdg+MLtzAJ4/phJowGQZNGPymj9BmMBBEBSBYJgpDOtruXew72tttzGrB0TLvsNe00n9EsjU7Du6MsjirRpSEoNsIYQjn6f/5dTapIxAsqQxMEoYzK3pxtEwx3aRooLuE5lKnNndPmjmmzMJrFwyqM5mSMpUxtxqtk7SSZfh+nCt6StMhytJkgpWk/jS/SStICytEEIRuSRYIglPDCT1dg3uLv23ZO84zaMb9pOomjWRqtaxqtY3acxBEYk0c7aQTckza/UudHPFVj/Nys0mj8/cmSRr/CCPCtY5S6hjEArGsXKVUk/EKySBCEMpzG7XiN2gHc5zMCNuLIKI2AvTgCxU0xQOkaPFZxDErYaaITflJGQLw0qkwZ/YzV8URyswtBBIXWLBIEoYxnf/ktAPC95/TYcQnbPafdxu4Y4siz37R1jaPf9Y1xxm/ji+jmF8B/AwzvOkaeNYwq1y86Pq6WUkUiGCSLBEEoJcjjkptxAAAgAElEQVSe00YTjNOe04BDQ8wHuHVPA2PSaBVHt8YYO8ziWA7y6DdVlSGMgL8GGC2EMSBuzS4EEQSSRYIglBNkz2kDJ2l07aIGSjqnAfa0kbeb2qAcpDGIMMpKGXkJXRglposEEQSSRYIglPLUhlWFPwfZCcYrbTQoKU1bpJE1bTRjJ42Ae9oIxF8ag6zbNKRRpDzqJoxMBBRGu3Rxx5VUgiaCQQ0uBEEox7zntCGMbntO57+2b4QBvJthHMfucOwMY+2iBkp3hzFwaogxUNUYE2XMf3dBGmL8NL/wdkqzNr3o0B1NEH6gZJEgCOVsevbbANj3nM5/nbMd7A24l6gdS9MA94BvQGzSCMQvbZQhvyISx6B7TItCdTmaUkW1XHPNNUgkEkW3o446quS4XC6HBQsWIJFI4NFHHw3hmfJBskgQRCgkswOFPxvCCIxJo92axvzXpdLI2kFd+L6HNAKlaxuDSmM5ITMtVSmMPCXpMMrRblCzS3h87GMfwzvvvFO4PfvssyXH3HrrrUgkopP+kiwSBBEKG7Zfi2R2oCCNRspoJ46AuzQC/NsIAi7S6NBBDcC2EcaKUyOMG3FKFwH5wuhXGnUQRlHd0V7pIqWK4ZBKpdDU1FS4TZo0qej+7du34+abb8Z//ud/hvQM+SFZJAgiNBLZvMWZpRFA+NIIOM5pBNhSRsB+TqMbJIx8BBFGHmkMTRipO1obMplM0W1gYMDx2J07d6K5uRlHHHEEzjvvPLS1tRXu6+3txZe+9CXcfvvtaGpqUvHUhUCySBBEqBjCCIiXxsKfGdYzAmPS6Dan0SqNZpyk0YzskrSuWwPKQlXKyNslLYyA5WhCDNOmTUNjY2PhtmbNGtvj5s2bh7Vr12LDhg248847sXv3bnziE59Ad3c3AGD58uX4+Mc/jrPOOkvl0w8MdUMTBBEaj+26EQtmriwIY64h39ZsFsaRhuoiYbR2UJuF0W0bQbvO6ZEP/mzdRhDIi2NR97TpTXukL1VIhqxd00BeGq1d02YxceuWfnegwbdgGaLYVNWp1RaBvHtJ+2FSTY8vEefZW5p1a0DV3dF2WwH++ZsrAp9XR1J9QFKhPyc++LXeu3cv0ul04fvV1dW2xy9YsKDw52OOOQbz5s3DYYcdhgcffBCTJ0/G5s2b8ac//Unqc5YBJYsEQYRL95gYJbJ9hZuBW9ro1kHt1D3tVJrOH8e3GwxPysjT+CJCqpqqOrVMGXVcyygjYaRydLxIp9NFNydZtDJ+/Hh85CMfwa5du7B582b8+c9/xvjx45H6/+3dfXAU9f0H8HceyJPhEhCSEAkRhfIoAcHiKSJKSkREsbQjFpVSKsUmo4hFwJ8FdEphlOIDg+BDBR1BfBihiAJmeEi0hqdIhCAEkFiomsSKySUxz/f9/XHssru3e7eX3FPu3q+Zm8ndfrO3t8rx5vN9io5GdLTj+2Pq1KkYN26cD6++4zwKi8uXL8d1112Hrl27IiUlBVOmTEFZWZmqTWNjI3Jzc3H55ZcjMTERU6dORWVlparNuXPnMGnSJCQkJCAlJQXz589Ha6v6D8y+fftw7bXXIjY2Fv369cOGDRva9wmJKKjtqFzrCIzS4yJtcPQ0NF762bhr2pPQKDOxhaBSewOjtwRbYAT8Exo9FcjAaIoH3dGhWlXsjOrq6vD111+jV69eWLhwIY4ePYqSkhL5AQDPPfcc1q9fH+Ardc2jsFhQUIDc3Fzs378f+fn5aGlpwYQJE1Bff+kP5qOPPooPP/wQ7733HgoKCvDdd9/h17/+tXy8ra0NkyZNQnNzMz7//HO88cYb2LBhAxYvXiy3KS8vx6RJk3DLLbegpKQEc+fOxR//+Efs2rXLCx+ZiIKNvcZ26YmL4AiYD41mqoyA+dCoO3P6Ik9mTJsNjJ5WF12FwmAMjEDwLbHji7UYzQRGf82OJt/7y1/+goKCAnzzzTf4/PPPcffddyMqKgr33nsv0tLSMHToUNUDAPr06YO+ffsG+MpdixBCtPv/rh9++AEpKSkoKCjA2LFjUVNTg549e2LTpk34zW9+AwA4efIkBg0ahKKiIlx//fXYsWMH7rjjDnz33XdITU0FAKxbtw4LFizADz/8gJiYGCxYsAAfffQRSktL5feaNm0aqqursXPnTt1raWpqUs1OstlsyMjIQE1NjWqcAREFp5y46QCAyCSdP69d1cFJGtsIOMY0SloS1aFN2hUGcIxnvPTzpdDXqshurZdO6zi34rlyPKPqL2VNxUf5F782KCgrUtpgohduPAlTZgKh2XGMynP5a+yjL8czelq9NTuG0ewOL2bGLwLO/+jQpVkPVOub3MdMvZc/2Gw2JCUleeXvYelcw37/d0TFmLvv3tDW3IijG54w/RmmTZuGwsJC/Pjjj+jZsyfGjBmDZcuW4eqrr9ZtHxERgS1btmDKlCnevnSv6tCYxZqaGgBA9+7dAQDFxcVoaWlBdna23GbgwIHo06cPioqKAABFRUW45ppr5KAIADk5ObDZbDh+/LjcRnkOqY10Dj3Lly9XzVTKyMjoyEcjogCx19jkh0xTbTSqNOrNnpa46po2u6i3bpXRg25pVxVGb1QXXfEk9Elt/TlJRuqa9tUOMJ4wW2EM9u5o8r/Nmzfju+++Q1NTE/773/9i8+bNhkERcOzkEuxBEehAWLTb7Zg7dy5uvPFGuZRaUVGBmJgYJCerv2BSU1NRUVEht1EGRem4dMxVG5vNhoaGBuhZtGgRampq5Mf58+fb+9GIqJPQToSRmA2Mnq7P6Gjnfiyjq3UZlRNf9NZh1G4RKG0H6C44VjQnu3x4KpCzqX0RHAMdGM3wVnc0kbe1e85+bm4uSktLdbexCYTY2FjTs5OIqBOrrXPqltbTpa5V7paOrm+Tu6SlwCh1SyuX2gEcgVHqmlYutyMFxrZ49VI7UmBULbMDAAltcmBULrMjVZmkwGiJb1QFRimk6C2voxcYfb2OYaApP19HK63tXV7HG8wup2NKQpvb7mgib2pXZTEvLw/bt2/H3r170bt3b/n1tLQ0NDc3o7paPXamsrJSXqk8LS3NaXa09NxdG4vFgvh4zaAiIgo/mskvEmV1EdDfc1o+pqgyOp7rVxkBczvBuNpvWllpdLf7i5lqo5Ky8qj3CCXeqDZ6UmEMRHc0q4sUjDwKi0II5OXlYcuWLdizZ4/T7J2RI0eiS5cu2L17t/xaWVkZzp07B6vVCgCwWq04duwYqqqq5Db5+fmwWCwYPHiw3EZ5DqmNdA4iIiV3gdFVt7TZrmkgMKHRKDiarZCFYojsaGhs744vrvi9O5pjF8mPPAqLubm5eOutt7Bp0yZ07doVFRUVqKiokMcRJiUlYdasWZg3bx727t2L4uJizJw5E1arFddffz0AYMKECRg8eDDuv/9+fPnll9i1axeefPJJ5Obmyt3Ic+bMwdmzZ/H444/j5MmTeOmll/Duu+/i0Ue5KToRXVRrHBa0y+sAxuMYgfaFRvm9fBwaAedqo6Q94VES7qHRbGD09nI6Xp3sQuQnHoXFtWvXoqamBuPGjUOvXr3kxzvvvCO3ee6553DHHXdg6tSpGDt2LNLS0vDBBx/Ix6OiorB9+3ZERUXBarXivvvuwwMPPICnn35abtO3b1989NFHyM/PR1ZWFv7xj3/gtddeQ05Ojhc+MhGFDIPuaIkn3dKAZ6FRb+a06dB4kZnQ6K7aqKQNj2YCZGcPjIDvF/kO2skurC6Sn3RoncVg5s31nYjI96R1FpV011zUo5jwolyDUaJcixFwXo8RUK/JKLdLiNQ8V++/a7RGY5vmEtqzRiPgep1GLbOBxlVFLVQmy3gSgM1WZM2uvQiYW3/RzGSX9qy7yHUWvcvTdRZDFfeGJqKQYrbCqKwyAt6tNJreCcbEftPuqo0Sd1VHiZnJMp2dJ6E3UN3RZrC6SMGCYZGIOj/N+EXlot0So3GMRqGxvRNh/BEagY4HR1cVtXALjN5mpjva7NhFzo6mYMCwSEShQWfCi5kqI3ApNLqrNkqhUW/PaaD9C3t7Ghq9HRz1hEKV0Wxg9EV10ZuB0S1WF8nHGBaJKKS5qjK6Co5K7qqN7QmNyioj4FloBPSrjYD+bGqJ3lI87jAwqrE7msJRu3dwISIKOi52d5ECo3YCjDIwKifCKAOjckKMFBj1doTp6G4wANQ7wih2gwHgtCMMoJ4ooaxUKXeI0brQmKDaKcZdUJICY2edANMzti4godcS3+h2sotXd3YJA11+Fohq9d+83MjmkJwD7DFWFokotNTWuVyDUa/SKDGqOOp1U2urjUaVxvYs7A0Y7zsNXKo0mqk2uqo0SjxZ4LuzMhN0A9UdbQarixRIDItEFJqk0GgQHKXQaBQelcFRGR6NgqN83IPQKL9XOxb2lhiFRi29NRuVPN0RpjMKVGB0hwt1U7BjWCSi0Oem2gh4Fh4lytBodkyju4W9JR0Nja7GNEraGxiBzltlDERXurcmu3BmNAUKwyIRhQ9ltbED4VEbHN2Fxks/uw+NpmdOA4ahUYmB0Zm7wBjMk12IAoFhkYhCjr3GZq6hNjya7LZWMhMaXa3T2OGZ00C712n0hnAPjGaxukidGWdDE1FIkYKiXmA0vX2gXmBUzLJWBkZpdrUUGNsSY+XA2JIYrZo9rZw5DThCo9HMaWn7QNMzpwHd2dN6M6e1oUQ5OxowN0M6GKXFVAMAKpqT/fae3eN+9ngNy46Kim81txUgkZewskhEIcFeY3NbUZTauHoYMqg+aquNZsY0enM8I6CZOQ04VRmNhEp3dFpMtRwUpedm+Ls72q8LdRN5EcMiEXV6prudTZ7LVJDUBEdlaDQ7EcbT0OjxeMaL9LqlJa66o4M9MGpDovaYGcEYGM1gdzT5E8MiEXVq3gyKZt5LN0B6EBolrmZOy208XGoHcL8+o0QvMOp1p3oSGP3JbBjsjFhdpGDDQQ9EFBR2NW706/vlxE3323tF1TXJu8MYjWcEHKFRuxOMFBhbE9S7wADG4xl1xzLq7ALT2BAjBxNbQxws8Y1yYNSOYVQyqrZpq4u+XKZGGpdoFBrNjlt0VxHtaFgumrCiQ79PFAwYFomI/EAZGLWi69ucAqPjZ+MJMIA6NLZd/NkwNBpMflFOelFuEaitMroKj4B+gDQKYt4MkcpQ6OkEl0CPtSTqLBgWiYj8RFth1O45bbTftDIwAu73m3a0dR8atVVGwDk0SlyFR8B89RFwHdI6EiQ9mQVtJih6UlX094xoIn9iWCSisLSrcaNfu6IlZgMjoN8tDfg+NCq7ppU6Eh4Bc5NF/FGN9Bd2QVOoYFgkIvIzd4ERcB7H6PjZ96FRWWUE1JMtOhIeAc+qj1pSiOxoaDTb9RysE3uIAoGzoYkobPl7Uo2S0dI6EqMtAx3PhdOsae3MaVfL7ejuOX0xNBrt/mK0C4z00LrQmCA/jPyv8TLVw4yOjDP0Z1BkVZFCCSuLREQBop304qrKqAyM2kqj47UIjyuNyp1gjLqm5Wu9uK6fNjDqdVlr1xI0U3UE1CHN3ZhHTyuMrCgStR/DIhGFtUCNXZToBUYAbscyApdCo+M1/eV2AOPQ6LZrGnBacgeA2y0EXQVHQB0ezQRHwDk8mu2W9qQS6a2gyKqi70Q32BHdanff0EsiWvz3XsGMYZGIKMD0ltXRhkbtWEYALquNXgmNgOngaGacY3uDI2C8X7WrKqO/giJnQlOoY1gkIgoC0hhGs6ER0A+O3g6NgP+Do6tqo5nA6Om4RnY9E7nGsEhEYS/QXdFKyokvZrqnlfTGNnY0NALwODi666YGoLuWo8RVaHQVGD3li5DILmgKRQyLRERBSq/aqJ017W7ZHaDjodHR1kRw9GNo7ChWE4nM49I5REQI7DI6ABBR14CIugbdY1F1TaqKo5K07I4yREbXtzktvSMFR+WyO3pL7sjv6WLJHbmNcukdwBEaFRVH7TI8ANwuw6NHuwRPR4Oer4Iiq4oUqlhZJCIKMGVIVP4sEuNV7fQCo1HVsSUxul2VRr19p+X3clNt9KTSCLieSa1XaVQy6o52hxVFIs+xskhEFEBG1UTpmKuKI3Cp6qitPiqrje2pNEoLe3tSbWxPpRFwXrsRcN4tBnCedexp8PNlUGRVkUIZwyIR0UX+7opWhcDaOsfDRVu9h5a3QyNgHBql4OiN0Gi2a7o9gdGTHWI8xWVzKBywG5qIKNCUIVEvMHY1numrFxhFYrzT5BjlbGpPu6cBdRc1oO6m1tt/GlDsDCP5OUrumgaMJ8K4mwRzoTFBNenFVZc0u52JOo6VRSIiBX9VF+WQ56KaKJOqjnoPg3NL5zdTaZTCo1GlEfB8/2mJuyojAN0qY0f5spqoxS5oCnUMi0REfqZXDbTX2GCvsXl+MhcBUi80SsHR1QxqT0OjxJvjGY26pSWuuqNZTSTyLnZDExFp+HKRbqdxihrtCYyRSRb1C9J5L3ZfS+8pza5WdlG72lZQr3va8dx4BrVynUagfV3TrrqlbQ1xLrujvcXsGo+sKlI4YGWRiCgQFEGxXRVFBakqqXzI76GoNmonxbSn0uh47noGNdCxrmlPuqW9NcFEWstRu6aj9nWjdkQAsHbtWgwbNgwWiwUWiwVWqxU7duxQtSkqKsKtt96Kyy67DBaLBWPHjkVDg/GKB8GAYZGIyAf0upr1xil2NCgacTqvpntayWhMI+A+NMrtvNU1fZGrbmntLGmzoY2hj3ytd+/eWLFiBYqLi3H48GHceuutuOuuu3D8+HEAjqB42223YcKECTh48CAOHTqEvLw8REYGdxxjNzQRUQfYa2yXuoFr6wxnLrtaK7EziK5vU82ebkmIvPiz+8W9zXRNAxcX9XazoLeyW1o5S5qBj4LB5MmTVc+XLVuGtWvXYv/+/RgyZAgeffRRPPzww1i4cKHcZsCAAf6+TI8Fd5QlIupsXFTwtHxVVfQV7RqNSmarjKbXZ5S6pi+GR2WlUTv5xdVWgVpSW+WDyB2bzaZ6NDXpb7+p1NbWhs2bN6O+vh5WqxVVVVU4cOAAUlJScMMNNyA1NRU333wzPvvsMz98go5hZZGIqINU1UV3zCyVE8S0FUYAqipjS4Ij7EX/7KgwAs5bCALqaqPLSiOgqjYqK43a7QLbG/zM/p67LQjJ96J/bkN0dJv7ht7S6nivjIwM1ctLlizB0qVLdX/l2LFjsFqtaGxsRGJiIrZs2YLBgwdj//79AIClS5di5cqVGD58ON58802MHz8epaWl6N+/v08/SkcwLBIReZuiO9qoutjZqopKysAImOuWBowX9Qa8Gxp9hVXI8HX+/HlYLJf+QRgbG2vYdsCAASgpKUFNTQ3ef/99zJgxAwUFBbDbHf+4+tOf/oSZM2cCAEaMGIHdu3fj9ddfx/Lly337ITqAYZGIyAtMVRc7eVVRSS8wAsZVRuBSaAScq416odHxO8Lj0OgNvg6e1LlIs5vNiImJQb9+/QAAI0eOxKFDh/DCCy/I4xQHDx6saj9o0CCcO3fOuxfsZRyzSETkCyEUDI0oxzBKjGZLA5eW2TGz7/Sl37k0rtHVkjvSmEbloyOkcZHeDKAUnux2O5qamnDllVciPT0dZWVlquOnTp1CZmZmgK7OHFYWiYi8xOzYxc7cBa2l3Wca0O+WBiBXGgHnaqOrSqOj/aUuat1KY4JzcDUbGJWLgOtRBkZWHMmVRYsWYeLEiejTpw9qa2uxadMm7Nu3D7t27UJERATmz5+PJUuWICsrC8OHD8cbb7yBkydP4v333w/0pbvEsEhE5CvKpXRCvNKoDY3abmnHa87BUVll1C65A3gQGjX7TavoBEklvVBpFCBZaSRXqqqq8MADD+D7779HUlIShg0bhl27duFXv/oVAGDu3LlobGzEo48+igsXLiArKwv5+fm4+uqrA3zlrjEsEhF5kbvqYihVFfUYhUbAfHBUhkbA/VqNTpVGLaMg6SJEatd3JDLjn//8p9s2CxcuVK2z2BkwLBIR+VIIVxSVO71Ie0tLjLqn5fY6wdFoQozZBb5V4xkVTIdIF13ZDI0UzhgWiYi8zKi6GEpVRWVQ1D5XBkflJBij4Ag4wqO3QqOWXojUDZDK8KgJjgyNFM4YFomIfMCjhbo7GW1QNDpuVG2UGC29o+2ibk9oVL2PmwDpMjgahEaAwZHCB8MiERG1S1SdesuztkT1QsWuuqkB/aqj3nqNjufmQiNwKTjK76MJkNrw6DI4Gsy0BszPtibq7Ph/OhGRjyiri6HSBS0FQG1Q1L7mKjgqSSHS3WxqvdAIuJ5BLV+Li/BoFBxVodGgykgULhgWiYjIFHfdz0ruqo5652xJjHaqNroKjYDrGdTytbgIj0ZjHaMaI/SrjABDI4UdhkUiIh8KlYqikhQE9fa9FonxTq8pf0ePFCS1Yx2V1UbtTGqzk2EAdXAEnMc5On7fOTQaLsnjomuaKBQxLBIRkVuuup+VtAHSKDwqSec0ExoB/ckwRot8A+rgCBgv+O34ff3QaFhlJAoDDItEROSSXvezXlVRj9l2IjHeacxje0Kj47l+tVES3aDfTe0qNOoGRqIwwbBIRESGlEHRqfvZ1YLj0jaHJknnlCqRymqj0bhGM5NhANfVRjOhURkYAReLfBOFKIZFIiJyy9U4RV2e7lxzMVy6Co2Auova7GQYx2vuF/qWRDUYB0aAVUYKPwyLRERhKKKuwe14QpfjFL29jaF0vnaERsD1ZBjAsy0FAfc7xBhtLUi+1aWuFdHR/lsMPaKVC68DQKT7JkREFOq0gbAj4xQDSbtLjHZbQWW1EXCERmU3dXSDekJMVIN66Z3onyN0d4khCmUMi0REYard4c/bVUUvMxMY9UKj6jlDI5GMYZGIiAC43pWlM1QVlaLr21ShscvPdrehUVtlBNyHRqJwwLBIRBTGtCHQ3TqKwV5V1HJXZXS8xtBI5ArDIhFRmDOqGroNjp2EXmA0Co2q3zMRGonCAWdDExGRijYkdrYuaD3R9W3yuowS7VI7jtfUs6YBc7vCEIUyVhaJiMhcIOxkXdBa2nGMElfjGc1UG4lCHSuLREQEQH/txVCoKmppd4CR6FUaHa8bL+5NFA4YFomIyL1OXlXUo90BRqK3qPelY87d1EShjmGRiIhkyupiKFYVjbirNkr0thIkCnUMi0REpOLUHR1iVUXtVoFKRtVG+Xd1ZlEThTqGRSIichKqVUXlNobaLQ214VE7GUYvPBKFA49nQxcWFmLy5MlIT09HREQEtm7dqjouhMDixYvRq1cvxMfHIzs7G6dPn1a1uXDhAqZPnw6LxYLk5GTMmjULdXXqf7kePXoUN910E+Li4pCRkYFnnnmmHR+PiIjInC51rfJDjzSbWvkgCgceh8X6+npkZWVhzZo1usefeeYZvPjii1i3bh0OHDiAyy67DDk5OWhsbJTbTJ8+HcePH0d+fj62b9+OwsJCzJ49Wz5us9kwYcIEZGZmori4GM8++yyWLl2KV155pR0fkYiI2i2EuqClEBhV1+R2wXFlcHQVIInCgcfd0BMnTsTEiRN1jwkh8Pzzz+PJJ5/EXXfdBQB48803kZqaiq1bt2LatGk4ceIEdu7ciUOHDmHUqFEAgNWrV+P222/HypUrkZ6ejo0bN6K5uRmvv/46YmJiMGTIEJSUlGDVqlWqUElERGSGMihK9AJjW2Ks23MQhRuvLspdXl6OiooKZGdny68lJSVh9OjRKCoqAgAUFRUhOTlZDooAkJ2djcjISBw4cEBuM3bsWMTExMhtcnJyUFZWhp9++kn3vZuammCz2VQPIiLqgBCqKpolVR21D6Jw5tUJLhUVFQCA1NRU1eupqanysYqKCqSkpKgvIjoa3bt3V7Xp27ev0zmkY926dXN67+XLl+Opp57yzgchIqKQoa0qKifvaBchN8LAGByi6psRFeW/NS5FW7Pf3iuYhcx2f4sWLUJNTY38OH/+fKAviYio8wqRqqJe97NSRF2D2wdRuPNqZTEtLQ0AUFlZiV69esmvV1ZWYvjw4XKbqqoq1e+1trbiwoUL8u+npaWhsrJS1UZ6LrXRio2NRWys8VgTIiIyIURCopH2hD8GRgp3Xq0s9u3bF2lpadi9e7f8ms1mw4EDB2C1WgEAVqsV1dXVKC4ultvs2bMHdrsdo0ePltsUFhaipaVFbpOfn48BAwbodkETEZEXhFhQNOx+rq1zfhCRIY8ri3V1dThz5oz8vLy8HCUlJejevTv69OmDuXPn4m9/+xv69++Pvn374q9//SvS09MxZcoUAMCgQYNw22234cEHH8S6devQ0tKCvLw8TJs2Denp6QCA3/3ud3jqqacwa9YsLFiwAKWlpXjhhRfw3HPPeeljExGRSogFJo9nLofY5yfyJo/D4uHDh3HLLbfIz+fNmwcAmDFjBjZs2IDHH38c9fX1mD17NqqrqzFmzBjs3LkTcXFx8u9s3LgReXl5GD9+PCIjIzF16lS8+OKL8vGkpCR88sknyM3NxciRI9GjRw8sXryYy+YQEflCJwpKUXVNLpe30WsPaKqKROQRj8PiuHHjIITxBuoRERF4+umn8fTTTxu26d69OzZt2uTyfYYNG4ZPP/3U08sjIqIw0qWuVXePZyLynpCZDU1ERGr2GhPrzXbCSpt2ZrO2y9nlWEUi8hjDIhFRuAihsOQuMBKR9zAsEhFRp6QXGFlVJPI+hkUionAVAgGKO6sQ+R7DIhEREREZYlgkIgonUjUxBKqKEm11kV3QRN7FsEhEFMJ0Z0SHYHhidzQFg8LCQkyePBnp6emIiIjA1q1bVcfr6uqQl5eH3r17Iz4+HoMHD8a6desCdLXmMSwSEVFIiKprYlWRAqq+vh5ZWVlYs2aN7vF58+Zh586deOutt3DixAnMnTsXeXl52LZtm5+v1DNcyZSIiIjICyZOnIiJE3AMaKoAAA9TSURBVCcaHv/8888xY8YMjBs3DgAwe/ZsvPzyyzh48CDuvPNOP12l51hZJCKikCJXFYm8xGazqR5NTe0b9nDDDTdg27Zt+PbbbyGEwN69e3Hq1ClMmDDBy1fsXawsEhFRaGIXdMiJqG9ARKTdf+9nd4TCjIwM1etLlizB0qVLPT7f6tWrMXv2bPTu3RvR0dGIjIzEq6++irFjx3rjcn2GYZGIKMTZa2yITLIE+jKIOq3z58/DYrn0Zyg2NrZd51m9ejX279+Pbdu2ITMzE4WFhcjNzUV6ejqys7O9dblex7BIREQhgxNbyBcsFosqLLZHQ0MDnnjiCWzZsgWTJk0CAAwbNgwlJSVYuXJlUIdFjlkkIqKQwLGKFMxaWlrQ0tKCyEh19IqKioLd7r+u9fZgZZGIiDo9VVBkVZECpK6uDmfOnJGfl5eXo6SkBN27d0efPn1w8803Y/78+YiPj0dmZiYKCgrw5ptvYtWqVQG8avcYFomIqFNjRZGCxeHDh3HLLbfIz+fNmwcAmDFjBjZs2IDNmzdj0aJFmD59Oi5cuIDMzEwsW7YMc+bMCdQlm8KwSEQUBkJ1kguDIgWTcePGQQhheDwtLQ3r16/34xV5B8csEhFRp6QbFNkFTeR1DItERNTpMCgS+Q+7oYmIdOxq3BjoSwioiakPBfoSPMOgSOQzrCwSEZGTHZVrA/PGmtCnV0HkOEUi/2JYJCKizo1VRSKfYlgkIqLg4iL8sapI5H8Mi0REpCtgXdEaLgMiq4pEPsewSERERESGGBaJiMhQME10YRc0UWAwLBIRUefELmgiv+A6i0RE5NKOyrWdb91FCk219UBki//ez97sv/cKYqwsEhFRcHJVOWRVkchvGBaJiIiIyBDDIhERuRUsy+gAYFWRyM8YFomIKHgxGBIFHMMiERGZElTVRSLyG4ZFIiIKbsrqIiuNRH7HsEhERKaxukgUfhgWiYioc2BVkSggGBaJiCj4MSgSBQzDIhEReYRd0UThhWGRiIiIiAwxLBIRkcdYXSQKHwyLRERERGSIYZGIiIiIDDEsEhEREZEhhkUiIiIiMsSwSERERESGogN9AURERERm2G21sEd08d/7iRa/vVcwY2WRiIiIiAwxLBIRERGRIYZFIiIiIjLEsEhEREREhhgWiYiIiMgQwyIRERERGWJYJCIiIiJDDItEREREZIhhkYiIiIgMMSwSERERkSGGRSIiIiIyxLBIRERE5CVr1qzBlVdeibi4OIwePRoHDx4M9CV1GMMiERERkRe88847mDdvHpYsWYIvvvgCWVlZyMnJQVVVVaAvrUMYFomIiIi8YNWqVXjwwQcxc+ZMDB48GOvWrUNCQgJef/31QF9ah0QH+gJ8RQgBALDZbAG+EiKi0NRqbw70JQQc/44xJt0b6e9jb2hFC+C905l7Pzj/d46NjUVsbKzqtebmZhQXF2PRokXya5GRkcjOzkZRUZHvL9aHQjYs1tbWAgAyMjICfCVERBSqkpI6d8XIH2pra5GUlNShc8TExCAtLQ2FFVu9dFXmJSYmOmWJJUuWYOnSparX/ve//6GtrQ2pqamq11NTU3Hy5ElfX6ZPhWxYTE9Px/nz59G1a1dEREQE+nICymazISMjA+fPn4fFYgn05QQN3hd9vC/6eF+c8Z7o431xEEKgtrYW6enpHT5XXFwcysvL0dzs/2q2EMIpR2iriqEuZMNiZGQkevfuHejLCCoWiyWsv7iM8L7o433Rx/vijPdEH+8LOlxRVIqLi0NcXJzXzudtPXr0QFRUFCorK1WvV1ZWIi0tLUBX5R2c4EJERETUQTExMRg5ciR2794tv2a327F7925YrdYAXlnHhWxlkYiIiMif5s2bhxkzZmDUqFH45S9/ieeffx719fWYOXNmoC+tQ6KWakdoUkiKiorCuHHjEB3Nfx8o8b7o433Rx/vijPdEH+9LeBo6dCiSk5OxbNkyrFy5EgCwceNGDBgwIMBX1jERwptz2omIiIgopHDMIhEREREZYlgkIiIiIkMMi0RERERkiGGRiIiIiAwxLBIRERGRIYbFTqKwsBCTJ09Geno6IiIisHWren9MIQQWL16MXr16IT4+HtnZ2Th9+rSqzYULFzB9+nRYLBYkJydj1qxZqKurU7U5evQobrrpJsTFxSEjIwPPPPOMzz9bey1fvhzXXXcdunbtipSUFEyZMgVlZWWqNo2NjcjNzcXll1+OxMRETJ061Wl1/XPnzmHSpElISEhASkoK5s+fj9bWVlWbffv24dprr0VsbCz69euHDRs2+PrjtdvatWsxbNgwefcIq9WKHTt2yMfD8Z7oWbFiBSIiIjB37lz5tXC8N0uXLkVERITqMXDgQPl4ON4Tybfffov77rsPl19+OeLj43HNNdfg8OHD8vFw/N6lMCWoU/j444/F//3f/4kPPvhAABBbtmxRHV+xYoVISkoSW7duFV9++aW48847Rd++fUVDQ4Pc5rbbbhNZWVli//794tNPPxX9+vUT9957r3y8pqZGpKamiunTp4vS0lLx9ttvi/j4ePHyyy/77XN6IicnR6xfv16UlpaKkpIScfvtt4s+ffqIuro6uc2cOXNERkaG2L17tzh8+LC4/vrrxQ033CAfb21tFUOHDhXZ2dniyJEj4uOPPxY9evQQixYtktucPXtWJCQkiHnz5omvvvpKrF69WkRFRYmdO3f69fOatW3bNvHRRx+JU6dOibKyMvHEE0+ILl26iNLSUiFEeN4TrYMHD4orr7xSDBs2TDzyyCPy6+F4b5YsWSKGDBkivv/+e/nxww8/yMfD8Z4IIcSFCxdEZmam+P3vfy8OHDggzp49K3bt2iXOnDkjtwnH710KTwyLnZA2LNrtdpGWliaeffZZ+bXq6moRGxsr3n77bSGEEF999ZUAIA4dOiS32bFjh4iIiBDffvutEEKIl156SXTr1k00NTXJbRYsWCAGDBjg64/kFVVVVQKAKCgoEEI47kGXLl3Ee++9J7c5ceKEACCKioqEEI4QHhkZKSoqKuQ2a9euFRaLRb4Pjz/+uBgyZIjqve655x6Rk5Pj64/kNd26dROvvfYa74kQora2VvTv31/k5+eLm2++WQ6L4XpvlixZIrKysnSPhes9EcLx3TdmzBjD4/zepXDCbugQUF5ejoqKCmRnZ8uvJSUlYfTo0SgqKgIAFBUVITk5GaNGjZLbZGdnIzIyEgcOHJDbjB07FjExMXKbnJwclJWV4aeffvLTp2m/mpoaAED37t0BAMXFxWhpaVHdl4EDB6JPnz6q+3LNNdcgNTVVbpOTkwObzYbjx4/LbZTnkNpI5whmbW1t2Lx5M+rr62G1WnlPAOTm5mLSpElO1x/O9+b06dNIT0/HVVddhenTp+PcuXMAwvuebNu2DaNGjcJvf/tbpKSkYMSIEXj11Vfl4/zepXDCsBgCKioqAED1ZS09l45VVFQgJSVFdTw6Ohrdu3dXtdE7h/I9gpXdbsfcuXNx4403YujQoQAc1xwTE4Pk5GRVW+19cfeZjdrYbDY0NDT45PN01LFjx5CYmIjY2FjMmTMHW7ZsweDBg8P6ngDA5s2b8cUXX2D58uVOx8L13owePRobNmzAzp07sXbtWpSXl+Omm25CbW1t2N4TADh79izWrl2L/v37Y9euXXjooYfw8MMP44033gDA710KL9y0kkJCbm4uSktL8dlnnwX6UoLCgAEDUFJSgpqaGrz//vuYMWMGCgoKAn1ZAXX+/Hk88sgjyM/PR1xcXKAvJ2hMnDhR/nnYsGEYPXo0MjMz8e677yI+Pj6AVxZYdrsdo0aNwt///ncAwIgRI1BaWop169ZhxowZAb46Iv9iZTEEpKWlAYDTDMXKykr5WFpaGqqqqlTHW1tbceHCBVUbvXMo3yMY5eXlYfv27di7dy969+4tv56Wlobm5mZUV1er2mvvi7vPbNTGYrEE7V+mMTEx6NevH0aOHInly5cjKysLL7zwQljfk+LiYlRVVeHaa69FdHQ0oqOjUVBQgBdffBHR0dFITU0N23ujlJycjF/84hc4c+ZMWP//0qtXLwwePFj12qBBg+Qu+nD/3qXwwrAYAvr27Yu0tDTs3r1bfs1ms+HAgQOwWq0AAKvViurqahQXF8tt9uzZA7vdjtGjR8ttCgsL0dLSIrfJz8/HgAED0K1bNz99GvOEEMjLy8OWLVuwZ88e9O3bV3V85MiR6NKli+q+lJWV4dy5c6r7cuzYMdUXen5+PiwWi/wXhdVqVZ1DaiOdozOw2+1oamoK63syfvx4HDt2DCUlJfJj1KhRmD59uvxzuN4bpbq6Onz99dfo1atXWP//cuONNzotxXXq1ClkZmYCCN/vXQpTgZ5hQ+bU1taKI0eOiCNHjggAYtWqVeLIkSPiP//5jxDCsYRDcnKy+Ne//iWOHj0q7rrrLt0lHEaMGCEOHDggPvvsM9G/f3/VEg7V1dUiNTVV3H///aK0tFRs3rxZJCQkBO0SDg899JBISkoS+/btUy378fPPP8tt5syZI/r06SP27NkjDh8+LKxWq7BarfJxadmPCRMmiJKSErFz507Rs2dP3WU/5s+fL06cOCHWrFkT1Mt+LFy4UBQUFIjy8nJx9OhRsXDhQhERESE++eQTIUR43hMjytnQQoTnvXnsscfEvn37RHl5ufj3v/8tsrOzRY8ePURVVZUQIjzviRCO5ZWio6PFsmXLxOnTp8XGjRtFQkKCeOutt+Q24fi9S+GJYbGT2Lt3rwDg9JgxY4YQwrGMw1//+leRmpoqYmNjxfjx40VZWZnqHD/++KO49957RWJiorBYLGLmzJmitrZW1ebLL78UY8aMEbGxseKKK64QK1as8NdH9Jje/QAg1q9fL7dpaGgQf/7zn0W3bt1EQkKCuPvuu8X333+vOs8333wjJk6cKOLj40WPHj3EY489JlpaWlRt9u7dK4YPHy5iYmLEVVddpXqPYPOHP/xBZGZmipiYGNGzZ08xfvx4OSgKEZ73xIg2LIbjvbnnnntEr169RExMjLjiiivEPffco1pLMBzvieTDDz8UQ4cOFbGxsWLgwIHilVdeUR0Px+9dCk8RQggRmJomEREREQU7jlkkIiIiIkMMi0RERERkiGGRiIiIiAwxLBIRERGRIYZFIiIiIjLEsEhEREREhhgWiYiIiMgQwyIRERERGWJYJCIiIiJDDItEREREZIhhkYiIiIgM/T+XyXDgxH4rbQAAAABJRU5ErkJggg==\n", "text/plain": ["
"]}, "metadata": {}, "output_type": "display_data"}], "source": ["X, Y, Z = np.load('datasets/nechelik.npy')\n", "\n", "fig, ax = plt.subplots(constrained_layout=True)\n", "C = ax.contourf(X, Y, Z, levels=30)\n", "cbar = fig.colorbar(C)\n", "cbar.ax.set_ylabel('Depth');"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "subslide"}}, "source": ["## Surface plots"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["The following example is a surface plot created with the [`plot_surface`](https://matplotlib.org/mpl_toolkits/mplot3d/tutorial.html#surface-plots) from the [`mplot3d`](https://matplotlib.org/mpl_toolkits/mplot3d/index.html) module within Matplotlib. We must first replace the `np.nan` values with $0$ to get the figure to display correctly. If working in a Jupyter Notebook, the command `%matplotlib notebook` will allow for some interactivity with the figure such as rotating the display."]}, {"cell_type": "code", "execution_count": 12, "metadata": {"slideshow": {"slide_type": "-"}}, "outputs": [{"data": {"image/png": "iVBORw0KGgoAAAANSUhEUgAAAg8AAAGLCAYAAABA7HHxAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAPYQAAD2EBqD+naQAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4xLjIsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy8li6FKAAAgAElEQVR4nOy9eXBc133v+Tnn9u1uoIHGToAbuJPaRYq0NsqqqKJnKe/VpFKZcnnG8ZRlu+RJnuxURd4ke54kx5kX68XxEsWx7DeRk8w4M65MZlKvnp8dKZIzdizFkrWQABeQIAkSBIiV3QB673vPmT8a96K70Q1iX8jzqUIV0d333tPNxr3f+/t9f7+f0FprDAaDwWAwGOaJXOsFGAwGg8Fg2FgY8WAwGAwGg2FBGPFgMBgMBoNhQRjxYDAYDAaDYUEY8WAwGAwGg2FBGPFgMBgMBoNhQRjxYDAYDAaDYUEY8WAwGAwGg2FBGPFgMBgMBoNhQRjxYDAYDAaDYUEY8WAwGAwGwwL59re/zc6dOwmHw9xzzz28+eaba72kVcWIB4PBYDAYFsAPf/hDnnzySZ599lneeecd7rzzTh555BFGRkbWemmrhjCDsQwGg8FgmD/33HMP73vf+/jzP/9zAJRSbN++nU9/+tM89dRTa7y61SGw1gswGAwGg2ExZDIZcrnckvejtUYIUfJYKBQiFArNem0ul+Ptt9/m6aef9h+TUvLwww/zxhtvLHktGwUjHgwGg8Gw4chkMuzaUcfQiLvkfdXV1ZFIJEoee/bZZ3nuuedmvXZsbAzXdWlvby95vL29ndOnTy95LRsFIx4MBoPBsOHI5XIMjbhcfHsn0frF2/cmpxQ7DvfR399PNBr1H68UdTDMYMSDwWAwGDYsdfWCunpx7RdWQVHYNhqNloiHarS2tmJZFsPDwyWPDw8P09HRseh1bDRMtYXBYDAYDPMkGAxy+PBhXn31Vf8xpRSvvvoq99133xqubHUxkQeDwWAwbFhcrXCXUDPoarXgbZ588kk++tGPcuTIEe6++26++c1vkkwm+djHPrb4hWwwjHgwGAwGw4ZFoVEsXj0sZtsPfehDjI6O8swzzzA0NMTBgwf5yU9+MstEeT1j+jwYDAaDYcMxOTlJQ0MDQz2dSzZMdhy4xMTExLw8D4YCJvJgMBgMhg2LQrHwxEPp9oaFY8SDwWAwGDYsrta4SwigL2XbGxlTbWEwGAwGg2FBmMiDwWAwGDYsa2GYNBjxYDAYDIYNjELjGvGw6hjxYDAYDIYNi4k8rA3G82AwGAwGg2FBmMiDwWAwGDYsptpibTDiwWAwGAwbFjX9s5TtDQvHpC0MBoPBYDAsCBN5MBgMBsOGxV1itcVStr2RMeLBYDAYDBsWV7PEqZrLt5YbCZO2MBgMBoPBsCBM5MFgMBgMGxZjmFwbjHgwGAwGw4ZFIXARS9resHBM2sJgMBgMBsOCMJEHw4ZDTzd1EcLcMRgMNzpKF36Wsr1h4RjxYNhQaK3J5/Ok02mklNi2jWVZSCmRUhpBYTDcYLhLTFssZdsbGSMeDBsCrTVKKfL5PEop/yefzyOEQAiBlJJAIEAgEPAFhRETBsP1jREPa4MRD4Z1jxdtcF0XKKQrLMvyhYHWGq01ruviOI7/mnIxUbyNwWAwGBaPEQ+GdUt5tMGLJORyOcbGxqivryccDpdEHrztvJ/z58+TTqfZt28fUkosyyoRE942BoNhY6K0QOklVFssYdsbGSMeDOuS8miDJxzGx8fp6upCa002myUcDtPY2EhDQwONjY3U1tb6YgIKEQilFJZl+UIkn8/7z1USEyY6YTBsHEzaYm0w4sGw7nBdd1a0wXVdzpw5w+XLl9m3bx/t7e0opZicnGRiYoLh4WHOnj2LZVm+kGhoaPAjEJ5Q8PAedxzH+CYMBoNhgRjxYFg3eBdzx3HQWvsX7ng8zvHjxwkGg9x///3U1NSQy+UIBAK0tLTQ0tICgFKKqakpJiYmiMfj9PX14bougUCA8+fP09DQQENDA4FAoGqqQylFJpMBjG/CYNgIuEjcJbQscpdxLTcSRjwY1gVeSsF1Xf+irbXm7Nmz9PX1sXfvXnbt2uWnISohpfQFQmdnJ1przp07x9WrV8lkMgwNDZHJZKirq6OxsdGPToRCoZJUh2VZJb6JXC5HNpv1X1NJTBhBYTCsDXqJngdtPA+LwogHw5pSLdowNTXF8ePHAbjvvvuor69f8L6FEIRCIWpqarjlllsAyGazxONxJiYm6OvrI5FIUFNTU5LqKPdNeOuEGZGTy+UAiMfj1NfXU1dXZ3wTBoPhhsGIB8OaUVxJAfjRhvPnz3Pu3Dl27drFnj17ZlVELPTC7F34AUKhEO3t7bS3twPgOI6f5hgaGuLMmTMlvonGxkbq6ur8NZT7Jvr6+ti+fXtJBMJLdXhiwqQ6DIaVwxgm1wYjHgyrjteTIZ/Pl0QbEokEXV1dOI7D3XffTWNjY9V9zPdifK3XVfNNxONx3zehlPLTIY2NjUSjUd83AQVBYdu28U0YDGuAqyWuXoLnwbSnXhRGPBhWlUrRBoC+vj7Onj3Ltm3b2L9/f8kd/lIQQpREHq5FsW8CCkInmUyWRCey2Sx1dXU0NDSUpDCMb8JgMNwoGPFgWBWKO0AWl2Cm02m6urpIp9McPnyY5ubmtV5qCUII6urqqKurY+vWrQBkMhlfTORyOXp6erh06VJJqqOmpmbevolqzauMmDAYro1CoJZQbaEwoYfFYMSDYcVRSpFOp2eVR16+fJlTp06xefNm7rrrLgKB5f86LjTyMB/C4TDhcJj29nYmJyfZtm0bwWCQeDzOlStXfN9EcfOquXwTxaZRb83GN2EwzA/jeVgbjHgwrBjF0YbXXnuN+++/n7q6OjKZDCdOnGBycpKDBw/S1ta24utYSSzLmuWb8JpXxWIx+vr60FoTjUYr+ibm6jdx5swZtm7d6r++uHmVaa1tMCyH58FEHhaDEQ+GFUEpheM4JcOsAK5cucLJkydpbW3l6NGjBIPBFV3HSt+tV9q/lNJPX+zYsWOWb+LKlSvkcjm/34QnKILB4CzfxOTkJB0dHcY3YTAY1hVGPBiWleJog9cW2vs5deoUk5OT3HrrrXR0dKzqmtaSar4Jr9/EhQsXSCaT1NTUlIiJmpoavxqlPNVR7JvwPl9PRJjW2oYbiYLnYQmDsUzaYlEY8WBYNiqNzhZCMDIy4hslH3jgAUKh0Kqtab1ePMPhMB0dHb6IyufzTExMMDExwZUrV+jp6cG2bRzHYWRkBMuyfN/EXHM6HMchk8n4qRDbto1vwnBdo5bYntoYJheHEQ+GJVNtdLbjOJw6dYrh4WECgQD79+9fVeFQvL71jm3btLa20traChSGg3ldNqemphgeHvZ9E150oqGhYVZzKigdSe4JCaCiCdP4JgwGw2Iw4sGwJK41OjsSiXD06FF++ctfrsn6NuqdtletYVkWe/fupaGhgWQy6ac6BgcHS3wTnqCo5JsoLhHN5XKz0km2bfsRCuObMGw0jGFybTDiwbAoqkUbXNelp6eHgYEBDhw4wPbt2/0L0lpFADZC5GEuvM/P801s27YNgHQ67ac6zp8/TzKZpLa2tmROh9dvAmaXiCqlOHHiBJFIhM7OTjOS3LAhUch12eehr6+Pr3zlK7z22msMDQ2xZcsWPvKRj/ClL32pxCh+/PhxnnjiCd566y3a2tr49Kc/zec///kVWdNyYsSDYcFUizaUj86ORCL+NmslHjb6hW+uz6ympoaamppZvol4PM7g4CCnT5/Gtu2S5lWRSKTEN+FVbXgRCtd1cV3X+CYMhiVy+vRplFJ897vfZe/evXR3d/P444+TTCb52te+BsDk5CQf+MAHePjhh3nxxRfp6uri4x//OI2NjXzyk59c43cwN0Y8GOZNtWiDUoqzZ89y8eJF9u7dy86dO2ddYKSUVUdpL4aFiJGVFi3rJbJRzTcRj8e5evUq58+fByiZ0+H9nyzEN1GpG6bBsFa4WuAuYaz2Uradi0cffZRHH33U/3337t309PTwne98xxcPP/jBD8jlcrz00ksEg0FuvfVW3nvvPb7+9a8b8WC4PqgWbZicnKSrqwshBPfee2/V0dkm8rB4FvsePN+EN2BMa00ikSiJTmSzWRKJBNlsdt6+ifIS0UrNq66Hz92wMXCXWG3hrmK1xcTEREkL/jfeeIMHH3ywJI3xyCOP8PzzzxOLxWhqalq1tS0UIx4M18SbgKmU8u9OlVLXHJ1djPE8LI7lXLsQgvr6eurr69m2bRtaa9577z1CoRCu65b4Jor7TYTD4aq+CU9UFosJ45swbEQmJydLfg+FQstaHdbb28sLL7zgRx0AhoaG2LVrV8nr2tvb/eeMeDBsSIp7B1QbnX3PPff4EyjnYrnFgydk5nNcQ2W8C31DQ4PfvCqfz/sVHQMDA75vonxOR3G1Rnmqo9g34bXqbm9vNyPJDSuC0hK1hGoLNX1e2r59e8njzz77LM8999ys1z/11FM8//zzc+7z1KlT3HTTTf7vAwMDPProo3zwgx/k8ccfX/Ra1xNGPBgq4g2zevPNNzly5Ai2bQMzo7O3b9/Ovn375j06e7nEg9aaCxcucPbsWUKhkB+WL55kWWmblWI1LoIreYzyz8a2bdra2vx5I67r+nM6xsfHK/omotFo1X4TiUSCkydP0tjY6LfWNr4Jw3KyXGmL/v5+otGo/3i1qMNnPvMZHnvssTn3uXv3bv/fg4ODPPTQQ9x///1873vfK3ldR0cHw8PDJY95v69mF97FYMSDoYTiaIN31wj4o7MzmcyiRmd7xsqlkEql6OrqIpvNcvDgQVzXndWRsVhMRCKRDX+Huxpmz7k+I8uyaGpq8sOn5b6JgYEB8vk89fX1JdEJ27b9/Xq9JMp9E/l83n/ejCQ3LBbF0kyP3lkpGo2WiIdqFIvrazEwMMBDDz3E4cOH+f73vz9LJN9333186UtfIp/P+zdor7zyCgcOHFjXKQsw4sFQRHElBczktwcGBujt7WXLli0cPnx4UaOzpZSLvhBqrRkcHCwZ3+2FyIsrCyYnJ4nH44yOjnLu3DmEENTW1pLL5ZiYmKC+vt7c4ZZxLfFQTiXfRPGcjnPnzpFKpXzfhHf3Vnycaq218/m88U0YrhsGBgb4tV/7NXbs2MHXvvY1RkdH/ee8qMKHP/xhvvzlL/OJT3yCL3zhC3R3d/Otb32Lb3zjG2u17HljxIOhZJhVcQlmOp0G4MKFC0senb3YtEUul+PEiRPEYjHuuOMONm3a5Jv0iim/Q1ZKkUgkGBwcJJlMcuzYMZRSJT0PvHD7emctJoMuZFuv38TmzZsBfLE2MTHhzzV5/fXXS5pXzcc34TiOf4xyMWF8EwaPpTeJWpkbildeeYXe3l56e3v9xm4e3rmwoaGBl19+mSeeeILDhw/T2trKM888s+7LNMGIhxue8miDdxL3RmcDHD58eF6myLlYjHgYHR2lu7ubhoYGHnjggQWN75ZSEo1GcRyHWCzGvffe67d3Lg63R6PREkGxmKjKSrIRe1QEg0E/tNvS0sLJkye55ZZbiMfjjI2Nce7cOYASMTGXb8L7yWazxjdhmMXS21OvzPfmscceu6Y3AuCOO+7g5z//+YqsYSVZX2dKw6pRLdqQy+U4efIk4+Pj3HrrrXR1dS3L3flCPA/FLa5vvvlmtm7dWtUIea27z+K8e3F75+Jwezwe5+zZs6TT6ZJZEY2NjfMSLBu9FHSlDZlSyllRoeI5HZcvX54l5BoaGnzfxFz9JvL5PFNTU2QyGTZv3mx8EwbDKmHEww2IUgrHcWY1fBoZGaG7u5vGxkZ/dHZ3d/eyXBznG3mYmJjg2LFjBINBjh49Sm1t7ZKPXem4lcLt2WzWFxMXLlyYNSvCq+hYbVb64r4a4qEYKaXvm9i+fTtaa39ORzwep7e3l1QqRSQSKRET1fpNJJNJxsfHaWtrq+qb8CIVRkxcfygEiqUYJs13YjEY8XADURxtKJ6smM/nOX36NMPDw9x8881s2bKlpB3xcrSVvpZh0ms6df78efbu3cuuXbuW5US/kH2EQiHa29v9Ji3FsyK8ngfBYLAkMrER0wrl+19rceIZW2tra2f5JuLxOJcvX+bUqVMEg8FZczo8UeoJBe+YXiv1TCbjH8P4Jq5P1mva4nrHiIcbhPJogyccykdnl99ZL0eJpbefahfCZDLJ8ePHcRyHe++9d17lUstx3GtRPivCcRy/omN4eJizZ8+itaa/v598Pl/SQGkjsdbioRLFvgnAL8udmJgoqaZpaGgoMVmWjxX3Uh3eTy6X830T5a21zUhyg2H+GPFwnVM8zKo42uA4DmfOnJk1OrucpZRYFlPpIu5deHt6eti2bRv79+9f19UPgUCA5uZmv8eFUoq33nqLmpqaksFTxf0OotHoko186/HiPl/m2wn0WliWNeuz9/pNDAwMkMlk+NnPfnZN3wQwyzeRy+WA6kO/jJhY3yy9SZSJPCwGIx6uY8qHWXkn0VgsRldX17x8BSsVechms3R3dzM5OcmhQ4f8u/vlZiVnanhh8NbWVjo6OvwGSp5vor+/H9d1iUajJeWhC6noMGmRynjVNNFolFwuRy6XY8eOHRV9EwuZ01Gt34QZSb5+UVqgltIkaoWmal7vGPFwHTLX6OwzZ85w6dKlqqOzy1nOyIMnQoaHh+nu7qalpYWjR48uqARzMaxWNURxAyXPCJhKpXwxceXKFXK5HPX19SW5e6+z3FqwFobJlTiGZVkVfRNeRUd/f7/vmygWE55volqJqOebmJycZHJykh07dhjfhMGAEQ/XHVprJicnUUoRDodLRmcfP34cKeWco7PLWU7DpOu6dHV1MTw8zC233MKWLVuWvN9rsZYNloQQRCIRIpGIP3iquKrA68bo3R17P+U99U3aYnHHCAaDbNq0iU2bNgEznhXPN9Hb2+sPBitPM5X7JrLZLLFYjM7OTuObWGeoJaYtVqpJ1PWOEQ/XCcXRht7eXmzb5sCBAyilOHfuHOfPn5/X6Oxylivsn81mGRsbIxqNVjRmLoSFnpjXUx8GrzzUa0/r3R3H43EuXrzIiRMnqKmp8e+OvTvglWQjixMoiIf5RG8qeVa8NJMXnXBdt2ROh+eb8KIbXqrD+CbWD0ufqmnEw2Iw4uE6oNzb4KUavNHZruvOe3R2OUuNPCil6O3tZXh4mIaGBt73vvetagnmej9pV7o79iITV65cAeDtt9+mqalpRQZ+rYdSzeU4xmJSI8W+CW8/6XTaFxPFjcMsy/JTGPPxTRSXQ0spsW3b+CZWCBeBu4ReDUvZ9kbGiIcNjuu6s7wNUkrfsLfQ0dnlLMUwmUgkOH78OFprv0vkWpw011Pk4VoEAgFaWlpoaWkB4LXXXmP//v2kUqmSUHtxmqOurm7RvoLVMEwuh+dBq2GkuoS2bgcRLnluuVIjxf0mvJRaNptlYmKCS5cukU6nef311wmHwyUVHdfyTXjdTL1jVGpeZVprGzYaRjxsUMrvcDzhkEqlGBoaIp/PL2p0djmLMUxqrbl48SJnz56ls7OTffv2ce7cObLZ7JLWshhWQ6ys1AW4eHiO17iqONQej8fp6+tDaz2romO+YnEjeB5U/h8J5/4Yiwk0AbS8Gde6CyUPoqxDvnBeCUKhEJs2bSKRSBCJRNi3b5/f62NkZISzZ8/6vgnv8/emt5p+E6uDSVusDUY8bEC8PKvruiV3Ov39/Zw+fdqfz7BU4QALjzxkMhm6urpIpVIl4mW5jJeLYSNFHq5Fcai9s7MTrXXVgV/exayhoWHO8tD1nLZQmWepcf4LcnoXAgehupCqC/hrNE3sb98GgW1YzvtR8hBadizP4ovXoZTvZZjLN3Hp0iW/PLc4OhEIBCoKgmKvUjabpaenh/379xMKhUq8E8Y3UR2XpaUe3OVbyg2FEQ8biGrRhkwmQ3d3N1NTUxw6dIipqSkmJiaW5ZgLiTx4kzg3bdrEoUOHSi5Yy91v4XrxPMyHa1V0lA/88vL28Xicnp4eMplMiQmweODXevU8aDWFSH+ECJeodl1wxR6knqAx0gV0QfbHACixGSUPoaz3gYggVS9S9SL0KEregmsdRIlDaKt93uupFt2o5JtIpVK+b+XMmTO+b6I4OuFV1Agh/CiR4ziMjo6yf/9+/+88k8kY34RhXWLEwwah2ujswcFBTp06RVtbGw888AC2bZNIJJbtLn8+kYd8Ps/JkycZGxvj1ltv9SsJyvezVhGAjRp5WMy6q+XtKw38amxsxHVdstksdXV1y718YPGeB5X6OAF9njQBbOsmpBpAiin/eVfehVTHETizthU6idQj2LlvIpgqec5SJ5DumwiygMS1DqHkQVzrEFruqroe13Xn1dyruDy33DcRj8e5dOkSJ06cIBwOl4i52tpa/+/Mtu2qvonimTN/9Vd/xeHDh3nggQeuua7rGZO2WBuMeFjnVIs25HI5Tpw4QSwW47bbbvNz4rC8KYJrRR682Rh1dXUcPXqUcDhc8XXLLR7mu6/r4e5sqe+h0sAvT0xorTl27FjFi9lyfHaLiTy4+TcJ6x6EkIACdXJ6cuI2tNiKFEEkCYTYhtCjJDPNWIEm7IAGUYuluxDqncr7Fncgdc+0eADpDAI/KqyVRhzrHpS8DWXdgZI3gSicIpfiq/B8E+UVNRMTE/6MFMuyfAE3OTlZtd9EcYno3/3d31FXV3fDiwczGGttMOJhHVMp2iCEYHh4mBMnTtDU1MTRo0dnNRVabvFQaV+u63LmzBkuX74852wMj5UQD/Pd30aNPKwUtm37Q6cuX77MkSNHfEFRfDErr+hYjJhYlGEy8wwajSjOV4gtSLkJSx1D6HzJy+vCA2TdIBYToONosR0lWkDnEXoAyVU0Fq68k0AVUQGgRBRLHcN2/xHyoAmj5O241iHqgo1IeWhh76MK5RU1SimmpqYYGRnxW8fP5ZuAgpBIJpMrFjEyGK6FEQ/rkOLR2cUlmPl8nlOnTjEyMsItt9zC5s2bqw6zWsm0hdet0rIs7r//fiKRyLz2s1wX8bGxMbq6utBa+xe3pqaminfLGznysFqiJxAIUF9fX2IC9CoKxsfHSwZ+lVcUXIuFpi2c7H9F6YukASE6CYpOAjKErX6FUMMVt4kl9tIYuYCYtr4JfRH0Rf95V+xFixYgi2ILksFZ+yhEJM4gyPiPCTJY6i0s9Rb728Pk9A5C6cB0mqOQ6kA0zfu9VcOr1vBuDI4ePeq3NZ+YmPB9K54ROp1O09jY6HcnXQm+/e1v8yd/8icMDQ1x55138sILL3D33XevyLGWikaglmCY1KbPw6Iw4mGdUS3aMDY2Rnd3tx+mrJYe8LZZrgtP8b601ly4cIHe3l52797N7t27531hWA5B483m6O/vZ9++fYTD4ZJWw8V3y01NTSXNlFbKGLga4mS1DY3FfSSg8LkXV3QUVxQUV3RUKg9diHjQWuPkvobt5fVFiBDnkSqOJowrd6OpQ+gEUvcBAiX301R3vOo+XbEXqccRutd/TNGEltsAG9Q4WrQQ0HNEJNhC3s1RG+wBVfBN2M4PCs+JnbjWIRzrbrS8FS23zuu9Vlyr6/p/7+VtzT3fysTEBH/zN3/DX/7lXxKNRnnhhRe4cuUK73//+zlw4MCyfFd++MMf8uSTT/Liiy9yzz338M1vfpNHHnmEnp4eP/WynjBpi7XBiId1QrVow3xHZxezEpGHVCpFV1cX2WyWu+++27+wLGQ/SxE0iUSCY8eOIYTg/vvvJxgM4rpuyd3y1NQUsVjMv1sWQvgu+KmpKerr6zd0JGK58f4/5vN9mu/Ar2IxYdv2gtIWuexfYulhEAJL7qGWqwjShTWSwVI9/msV21GyEYHNRLKT+tqrSJEo2Z8rDyFV1yxTpSQGKoamASXbsVQPrrgZLWoRehKpLyLITe/jVqS6QE0wVXHNQg8iVZQa5/8trEts8g2YrnUILfaAmN/FyXXdqv05in0rf/qnf8oXv/hF3v/+97N161Z+8IMf8Pu///v84R/+IZ/73Ofmday5+PrXv87jjz/Oxz72MQBefPFFfvSjH/HSSy/x1FNPLXn/husDIx7WAUopYrEYWmsikYgvHLz8ZygUuubo7GJKxIN2yKf/EiU7CQY/gJAL6zQphCCRSPD666+zefNmDh8+vKCR0sX7WYx40FrT399PT0+P33BKSkk+X5r3Lh5wBDP192NjY1y9epV3330XIUTFZj7rlfU6jrv8ztirBPDEhDcOu66uDtd1UUqRzWZneXOKUcpF576LFAJJI7UM+2mIclx5G1JdIKD6AWiIgNYCJToL6Qmt0CJEQL1Z9Xiu2I1gCkudAcDSp2D649AEcdmLsjYj1TjVakUVbSAiWGom8iH1CNJ9mYD7MgCOvBfETKpDydtAVJ7D4fWSmA/Nzc2MjY3x2c9+lltuucVvOrVUcrkcb7/9Nk8//fTMe5KShx9+mDfeeGPJ+18JzEjutcGIhzWkONpw8eJFAoEABw4cwHVdent7FzQ6uxhfPLjnsZJPY7snAXBSnycjWnCt27GC/5Zg8N8gZPWvQC6XY2RkhHQ6zaFDh2hra1v0e12MeMhms37/irvuuss3mHn7mwuv/j4cDtPX18cDDzxAKpUiFov5Q6i01iViwnO4rzdWKloy38jDtRBC+AO/ysdhnzt3jng8zi9+8Qt/4Jf3UzwjIpf5YwIkcJUgFNiKIyRSpxB6CCkKQlgjUfIgUr2LQJetQSP0JZTOgghhqUso0Y4WHWgEUo34XgdHHsRSJ/3owmxskEFs9+f+cZPZTViBduwACD2AFq1IPYzQo5U/W+S0QfNfCw+4/4Kjfp1s6MuF/VfAS1vMB9d1yWQyvuchGAwuy2j7sbExXNctqd4CaG9v5/Tp00ve/0rgLnGq5lK2vZEx4mGNqDTMSinFxMQEXV1dSCm57777FuWmlkKwreVVApP/zS9JAwgIqGMc3H8ml/op+VQIS9SirNsRwX+LFXwEIQsnttHRUbq7uwkEAr4zfyksVDyMjo7S1dVFc3MzR48endfUxGrH9fBC77T5edIAACAASURBVMWdGT0x4U1ULBcT87kT3OjVHCshTryBX8PDwzQ2NtLR0eH3OhgYGOD06dMEg8Hpz9qmpf6H5DRErAjoHpQGBWhqQexB0IAlbSz3V7OEg4crb0aqywhdMFZKPQx6xmSpaEXJ/QgyKLEZqS/N2pdiOwgHS52c+XxQREIjwAjoQo8JoYdQchcakGoYyRX/9Zp6lNxCQL07/bskb/8u+eAn5vzM5kpblJNMJgFMtQUm8rBWGPGwyhS3oy0fZjU+Pk5/f/+CzYgluIM08hRtW9+t+pIp16VGSiIiB+TA/Tmkf46bepq8aCKe3MXlKzezb9//QDbrMjU1VXVf82W+Js7iEtCbb77ZH6i13BR3ZizP48diMQYGBnAcZ16mwJVitdIWq2HItG2b1tZWWltbgcL/s1fR4ernsIXLuBMmapWG3gUp0FlscRHpjhZSCmIfiCiQRKpLoFPkxUFsdayqsFC0gGggoF6fWRsRXNGJFjUIPQm6BkkvQqervBcbZd2C5ZV76sGifTWj5FaUrpn2Z3T5x8iG/gg38OA1P6uFpC1SqYIHY7mrLVpbW7Esi+Hh0sqW4eHhis3fDDcuRjysIpWiDZ6nYHBwcEmjswFE9h+w0t/EpYXxqT00NUiEOu/njh2tyWhNfZUTlCXA1WO01o7TsfcdlP4BuXCUydBuVPZ/RNgfmDPNMefa5tGpcmpqimPHji2oBHQ+x4VrX4gr5fG9Ns+xWMw3BZaLidVgpdMWK0k1w6RlWTQ1NVEXTZJLvk1c1RGUUWCk5HXJ9E001lxETpseBTksfbbInxBlfHI3DQ2g5K1I1Y+gtDW7K/Yh9BhSnyt5XJDE0qcKfgl5CKm7UWIHiHogjVQXC+IFyOSiBOwmAupYxfcpuAp6KwF9HEEGTQTHOkLO/jTaqt65smSdC0hbpFIpbNtellRFMcFgkMOHD/Pqq6/yW7/1W0Dh//DVV1/lU5/61LIea7lQSNQSUg9L2fZGxoiHVaBatKG49NFzpy/qgqSuYqW+jMy/BkCAcVrqATXd6MbaT9ZN4ajzRKqcnLTWZLVLSMz0zJcCwtYk4ch7kHoPR38BJbehrN0Q/A2kPZPmuBZzpS201ly6dIkzZ86wc+dO9uzZc82T6EpXTZS3eS42BcZiMXp6eshms/7/pReCX4yZdK1YzchDNcZTz9GoIaZS7LdnDMGaIIJbaa7trrqty3YEeVobCn0omNamSmxFi02gXbQOYel3K7axLhynHiW2+dGEUmFiocROlNhGIn2F5mA1f0NBfFhFDahc62DB3yDqq66/nIVEHrwW4yvxf/fkk0/y0Y9+lCNHjnD33XfzzW9+k2Qy6VdfrDdcLXCXkHpYyrY3MhvnTLdBqRZtKC59PHLkCJOTk4yPjy94/yL3U6zUcwh9tcorFFBLmNMIy8LVmqRSuBT+82uExJmOTITniCrktYOFRUBfBucyOD9D6adxRBMqcDvYj6AJgx5Cq1G0voqrUkyJO2mq/c2q4iGbzdLV1UUikeDIkSM0NS296U4x8408zGc/5abATCbDe++9h+u6nD17lnQ6XVKu2NjYuGivxnKseb6slXiYyp3AdY7Try3qZBOSwnfY1TW41l3YTJHjTiQxpOpHipnPI5bYRX3NZSwrP2u/Ug+g9ShK3kxAv1UonxSbZxknC/6GfKHSogICFyWasNQbtDYU/kaU2IIWm9BopLqCIIWSnSXCIWd/lLz9qXmXaHos1POwUg2iPvShDzE6OsozzzzD0NAQBw8e5Cc/+cksE6XhxsaIhxVirmjDpUuX6OnpYevWrX7pYyKR8AXG/A6QRKa/i3BeB13Zk6DEToRwkO7b/mOWEESKLqhTCkICNBqNi03p6F+lBS4Otpj9VZECgsTI53+KzP8zAoGDi5q+6NlCUMNPcOPPo1Ujbdu3MDJ1nqba38S2mhkZGaG7u5uWlpYlmSLXinA47Nffb9mypWQA1blz5/xyxWIxsZgw83qvtrjWMapFkc4n/ogOmSaAQ6vdCfoqrg4zTAeb9RmEHkVTGJnsUA9iB4JaJLU01v1r1VLOrNOMELUEKaQYpB4BPZMO0TTiyNsRpBF6DI1EUJpS09goeSuWKvUOST3oex0UW1GiAwjgyoOgJ8gHH8cNPLKoz2q+w7dgJvKwUnzqU59at2mKcoxhcm0w4mEFqBZt8EZnJxIJDh065JvHoJADnm9jJ5F/Cyv1HxBqoHA8QijrJhB1oCcRbh/jk9toiV5C6Mrh2pzW5LUmaglg5m5HaU1Ou4XZEWhsYWOLyndDWmtyuASZSXUECfhl8a62GHJCZLVDTmcI1Z4mlTpJKvVVxia+QPzSdm655RZ/+uBCmO9si+WKPMyH8gFUXrli8TTLSCRSIibm6n2w0qyl52E8+wa1nCGuICQFYfpxdYhhthDAnVUCKZhC6wECYjOWfne64+QeXBUhlRimoW4cQZasuxdLXiEgK0fiCuWeu7HVz4seq8UVO6abRE0g9NR0/4b3qr4vr3mU1AOgQYkOsqE/LfwdLpKFGiZXKm2x0dBLnKqpTYfJRWHEwzLjum7FaMPg4CAnT55k06ZNFe+y59UVUueQ6W8hs/9HyZ2SIItwCzXYWmxGy10ErASuvAPJVIlpEiChFGEhKvofpBDYWpLDpUbaKK3JuEEsmUYgsKYjE44uRCtCFSISHllCbApksUXh2BllcVUFSSlFTr3Hfff+NpG61TEdrhRznby9ckWvpW/xNMuLFy9y4sQJfzR2ce8Dj+up2qKcvuT/SiMutnSIWjeh1TlG2EfWPUGTfW/JbIrCIvcRZAqpzxZ+JYOlzmABwbpCpMCRR7FkBoGNVpcQJEt2kcvXkM630FBb2opakPKbRBUqOTSaAK68C0hNGycLFRiaQqmmVdRrwpV3kQn/pyXPuVgvaQuDYT4Y8bBMzGd09u233141b3hN8eCcJpB8GqF6q75EWXch3FNIfYXGCOBHJmpQcidT6SQ6cIEGKateMPLaBYTvf5BCELbyeF8VpTU55SCYMUGW70tpjYOiVpS29A1LzRZZiIRsbvsldv7XSVytx7HuwA4+Sm3o4XkbMOfLakYerkXxNEsoiAmv90F/fz+nTp0iFAqVDPqClU1brPSda6W0xVD6R4T0IFoW/ApRK0pC3UnGeQuAUNngKmEdwVYnEcz2NwA4bhBh7yegfjFzXCRK7ECJ5sJ2KkvAnqDBvlx1rVl1O0F5atpcOVJinJxKb6KmthNEuDDZc/rJfOCD5IKfqdo1ciEspNpipdMWGwkXgbuE4VZL2fZGxoiHZcDzNriu6/dsKB+d/cADD8yZ77Ysq7LnQbvIzP+GzP41Wm5DB46AiiFUnx9N0DSjrc1It/JwH0GaRGKScDBBaNo0mVEKReELEBYSmF1tMet9ao2LIlRkrFRak59Oc1iicEqVCIJVUx0w4ITYHEhjoQiKLKjXIPMa+bQgQQs5eQhlP0pzzUPIZRYT64ny3geO45Q0UvL6a5w8eZKmpiYaGxupqalZtgv+aomH4mNorbmc+jo1KAJCARYBNcSwW5hLUWvtQepC22mlISsfIKSTaHmAgBrBKivldHQH2XyeiFValSFQCH0RqS8WJmbSjxbNuOIgaF2YScHo9HECJDK7iNZ0VXwPAhdL5pAMI1V/obpC7CRnfxzX/nfL9EktPG1hIg8FlF6ab0Gt/X3FhsSIhyVQLdow39HZxVSMPLgXsZJfRLqF3vnCnXGFa2pR1k40zQjiCPcklVA6QGyqk+b6PsR0m99i0yRARik0FgKXPApbz45MTLpBamTen3jor1sIglhoCv4HGwsHhaMc8gSICPA2SSpJUllssyv34LeFRrrjNPAK4dwrZDIWI7qDnHUnNaGHaQr/2oLFxHqKPFyLQCBAS0uL34Y7mUzyy1/+knA4zJUrV+jp6cG2bT8y0djYuOS890qLh3LPQ3/yf0fqGDXTzaAaAgeIE0FNpymisg10P0rDqLiTRhEHdRwF5AAt2hBiG5IAEomlzxIJJysc2WsRfZDAdCWEKDI7AijRhhI7QdvU1fRVfQ+Tqe3UBMeQOl7Yr2gmG3oGZd256M+lEgvt82DEg2EtMeJhkbiuSzqdLukQ6Y3O7urqor6+/pqjs4spHWalkdn/C5n+hp9rrbAFEMRy/6WwCRGUtQsIIfQ4uH2kspsQAlqi56sed0opaoXAEpqS1IR20dSQVTnyCFqtanMAIK8LjYQ9/0MQCwSEgLyGq06IlBLUCpe2QOXQs9JwVQlapPbFRli6bGUAGIDsf2MsGWI48Nvsb/pi1bVUYyXFw0rt27sL3bNnD1DalXF4eJizZ8/6Y8g9MVE8hnw+617NyIPWiuHMfy6IxOnDhkQL4/mZgUshhlEaRsQdJJx3aQ2U9kkQehStxxHW3QTUeyiixJM7qa9vBj3ut5zWRFFysy8cKq6NBix1rtDgiUIVhpLbgQDoq0h9iTx3Ul9z3BfescR2Tg78e2rramhsHFl0BU0lTORhcaglGiaXsu2NjBEPC8QbZpVKpfjpT3/Kr//6r2PbNo7j0NPTw+DgIDfddBPbtm1b0InZT1uoYWT6u0jnl1BFOCh5E0JfRbozbnBBEuF2T69RMDaxl5oaTbi2Ea1rQF0syez53SarmCZDWOQ0BISgRmiuuhIXCKOpK7rAX8qH2RzIYovKF1ABSBFkV7AQgs8oQdy1gToiIkOdlSKlQCFotapfhC/mQzg6hsr9I7Aw8bBRHenlosTrytjU1MSuXbtQSvliYnR0lHPnzvnTRT0xUVdXV/X9r0Y0ptjzcC7xDRLKZbvtCVGLhIrDtJehRu5A6gGGxZ0knF9Rbx1AUOrx0dQTtPb4cyMsMUFjZAJU3/TzERx5OwBCj/gRtXIqjesWxLHUdHSBIK48iEWWbP428rlRwnWH0Q2fYYsoNAvr6+sjkUhQW1tbMhOleODXQjCGycWhCkmqJW1vWDhGPCyA8r4NUDg5xmIxjh8/TjgcXtDo7GKklHQ0/YrA5LOFUjFAiwaU3AEigHALterauh3hvlO1h38m30jeidDWOH3SnT5vevvSWpHKHyMkJXXX6DYZFIKgLByn2ZpJqeQ0TDgCJZqJiAkCVdZyNV9H2ErQZs30oQhLTYfMwfTdXoYwOZ1FAVMK6orSHIVjCc7lLCLWGLaAiB4g56aQLOxubyOkLRaKlNK/YO3cuROlFFNTU8Tjca5evcr58+f9MeTFYqL4u7takYeck2Q88/cImPY6QNC6jWyRAI5am0npCFPOrwCokw2UfLXEDsICpKrc1AnAlXux1Dv+xMxCSedeNBGETiD1ZZTcP6t/QzHeqG1PoEgp6Z/4bba0Pk0I2BSOllTQVB/41big1NJC0xbFpd43MqbD5NpgxMM8KB6d7QkHr5nLmTNnuHLlCvv27WPHjh2LOxmrCWqd57hrzz+VnCyFnkBM+x203IkWuwAHbR0CdQWhr5Ts5urUThoiw4Tt+KxDCD0B7mmwbqdOWjhoEkqhKTRzCk+v29EKhZ6utqh8wU0qQb3UhGWhI2ZGB0FlECikEASQxF1JvZXCrnIuzGpJbzrKrbVxwkU3WzkNSVegRZSEkyFNgoiV8Z8PCIcLU//E3vr5G9U2auQBFrZ2L+rQ0NDAjh07UEqRSCT88tC+vr6SMeTLPRehEp7n4UzyPxFXNh2BwndK6xpcXToRMqTHGChyr4UY8/+d4wBB0YRLAnQcKTIl25b7GzwKJZ09hbXQjBLbQCemyzAzSNXnz68AcMV+pB5B6L7p/TYwlPkCg7EWKnUjqTTwyxMT5aklbx5KsYAr/6xM2sKwUTDi4RoopXAcZ1bDp4mJwvCdeDy+6NHZACL/M6zkc7Oa4nhoJDpwF8J5zx8O5D8n2lBiC8lkhmxe0xY9U/U4Wu4E3EK3SQE2osT8mNeaPGGEThKo0lbX1RBzJS2WKokOhEVuuhWvxNWKPC6KACdTLeyrHaNWlhpBRx2bWqm5tXa2yAkKCFqaMdeZ7jWRmfWa8dRPFyQeYGNGHpa6Zikl0WiUaDTqjyEvFhOxWAzHcXj33Xd930Q0Gl3cNNcqaK3JqKvEc/8fGRWmXhYE7wT30aZ7/G4lYbmNKZrIqULUISjakNMmyiztZEUTQfWvOECeAIKdCNGEm08i3BihcOuc/gZX7EHoGJae/huZNb+iGQgj1SkEhe+lEnvIhL9OaiqAlIMV91uOZVk0NzfT3Nxc2EdZNOjChQslAs4b/e4NjluIeDDjuAsYz8PaYMRDFSpFG7w/8N7eXi5cuICUkttuu21xf8Q6hUz9CdJ5HW1tR6vN5LO9hOyZuyAtOkDUI6fDuOUIPUoiEaYmNEG0ZhIt2tFyC6DJZy4QsifQCLR1GOEeq14nrzVZramTWZg2PbpaEFcCraFWFso6NYLWQPVeFDntEkASFAFaAi4tdYWyuqyGq24QV4OjodPO+Ya5crJaM+kqolacIJKrilmvbeEt4vHPkXGO0lz/KFZg7gqMlYw8bKSohhCC+vp66uvr2b59O7FYjO7ubtra2vywe/EYck9MLGUMudaas5m/YMiJEJEZpMjjsI+kO0qLmOm5EJGdjE03OgOIBnb47aovqxo6AzMVFQIHdC9ag2YXAakQZHHkIQTO9GTNGWHqyINY6kTF77/ABX0ZIRqx1OvTZZjbcK33kwv+exC1KDW4aEFVHg0qF3D9/f24rkt9fcEYOjExQXNz8zXbVBvPwwyKJbanXgXPQzab5Z577uHYsWO8++67HDx40H/u+PHjPPHEE7z11lu0tbXx6U9/ms9//vMrvqalYsRDBapFG6ampujq6kIpxb333ss777yzqLtD4byHlfwiQhXq2YUq3NWEbAphVdmOJox0zyCmO+rNWqO2iU1tL6mkEHoY4Q77+8q4+wiGWkGngDogNms/KaUICDHL/2AJTcu0gXHUldQKTUYLco6gVipqil6e04KhfIjO4OwoARRmZ9RLTVZDi5UnqSSTboCJfD2b7RQNgYIx9KoLtnCJTh83JBUpp4Y6a8Y42iJDbA9PIMQrEHyFbPrLxPJNJN1bCNqP0FD3byqKiY0YeYCVFyeWZbFt2za2bduG1ppUKuVf2MrHkDc1NdHQ0DBvMaG1JhkY46rzHgHp0hmy0FoypJppt+2SrFgKgdIz389a4aCUYID9ZNVJAnp2G28pjxDiNFLkC6mMoq6USmxF0Y4WtVjqVFXhrGgC0VzSitoJ/Dvy9uO++WYhXoRrUS7gvNHvY2NjTExM0NvbSzabnTUTpbwjrYk8bCw+//nPs2XLFo4dKx3pPjk5yQc+8AEefvhhXnzxRbq6uvj4xz9OY2Mjn/zkJ9dotfPDiIciiqMNntGrfHR2Z2cn+/btQ0pZvbFT1QPkkZlvIzPfnzWIZ+Y1CaARy327kLKQu9CyBXQa4V5AkCKR6cCSzpwlmBPpvdSHB5DOjPjQcnthVDE5HKeLrFbUTb/HSmQUpLWkbdosGSk626eUIOY0kiNDWKiqwgHgqiuISkWdLHxWEamIyBybAwXPhINk3NEIVGHKRtFylA4BaQIINlk1BMqaT4WkpiN0FfgXJt1f4Cb+I0P5FhLuLdSFfoPNDQ9sqOhAMavRnrr4sxFCEIlEiEQibN261b+weWLi9OnTZLPZWZNDq90la62Jt79CELC0ICIGSfJ+Jp0z7LJb/OY8lthOwnmzaMsAluplTBwhkf8VjdY+BDMpOU0A27oLWx2j6k2jToGYwJpOgziiA8RmQCPVMJJhP5Uh9bnp/UbIhv4QN/BrJbsqNkgvN97o97a2Ns6dO8d9991XccCaNxMlm80SjUb92RbLTV9fH1/5yld47bXXGBoaYsuWLXzkIx/hS1/6UolHZj3dLeslVlvoFY48/PjHP+bll1/m7//+7/nxj39c8twPfvADcrkcL730EsFgkFtvvZX33nuPr3/960Y8bBTKh1l5wqF8dHbxyGgp5fzFg3MGmfmL6emTlYVDLNFJQ10cOV1yKVCgLiDUBaDQ8Glk4ibqagOEwg5aJRCUG8fq0dZuGmqOzdq/UP0I+tFiG5oQtsiQ0BqhNWEhCBRdSOIu1EhokpXXGhYaV4fpDMawBEy4NVikCAoXS1hYQpBRNmeSUe6oH4cqExCv5GposR3aA3kKV4IAaQUpLUiqMAHhUidsmmRojpJDGJv2YkgrTZN9GbiMq1/mn0//Jq77IFeuXKG9vZ36+voNKyZWgrk+C+/CVltb6w8vKxYT1xpD3pc8CTWDBKXLFrsRF4fLuX4CIoiaNjEC5OUBcGdSGA2B/bh6kHGnUFXRYEX9KIWrw0jrHoQ6V3Xdrtg9HYmYEc5SD4Ee8n935L0IsmgRRakaEBaZ8J+i5e5Z+1tJ8eCveTq6IYQgHA7T0dFBR0cHUBiw5pkw//Zv/5YXX3yRaDTKX/zFXzA2NsaDDz7Inj17luV7ffr0aZRSfPe732Xv3r10d3fz+OOPk0wm+drXvgasv7vl5ZqqOTk5WfJ4KBRa8uC64eFhHn/8cf7hH/6hoth74403ePDBB0uE2SOPPMLzzz9PLBYrud6sN2548bDQ0dnFzCvyoBUy+1fI9J8jyBfmTFi7gFrQVxGqD6hBW/tpqqtePpbJNeOoEO2N03lhVRgGpOV+tIiCngQVQIhRpDtbOHiowGGE001IZIGZKgutNWmlyGuBhUNE2thV/h7TCtLaojM0U+3RYKXxLv4APdl6AtSjyZLTkqCYLUL68620BmIERelnWCOhBk2jTDPohGmUocLIcK0BgSzujqkhrQRtFbwYloD3d/5XXss1MDXVwJUrhfV6F7mmpqY5+yCsB9ZiaNVc1NTUUFNTw+bNm4FCLjcWi1UcQ/5m+DuEp3s6dNhZBvJ7cPU5tod2An2FHcrDaF160o6IOsa5CUUhahAuSrdNiMM0uP9ckMxiE7lcK1oJGmqSBBjCkXci1Am/VHPWe8ZCy4ME1Eykw7HuIxv8Y5D1FbdZiJFxscx1jGAw6M9E+epXv8rnPvc5HnzwQTo6OnjppZf4vd/7Pb761a/yB3/wB0tex6OPPsqjjz7q/7579256enr4zne+44uHjXy3PBfbt28v+f3ZZ5/lueeeW/T+tNY89thj/O7v/i5Hjhyhr69v1muGhobYtWtXyWPe/KOhoSEjHtYrc43O7urqIplMzhqdXcw1x2i7/Vip/wXpzLjABemSVtLKup3CSGxJMtNGbWiU8vP5+NQuGiODhMvGDBcG/pwBbLR1B4IT0yWdnaSTw9QGryBE2fwL5+2KSxVCgNYEBYSljdIwqQRZLZBaErUcbAHjrqReKpplZdGktWZKCfYGp7DEFIQKkYGksoi5AQJoamSelLbZbo9V3AdAUoFLLdvtFAVRMvOhxJxaBnMh2uwpQtKhaY7mUkGheGD3/8mgexeHGt/vO99jsRgXLlxACLFuxcRqTdVcCqFQqOQu2Qu5d8V/gSsvERAa2w0xmowSk4VoQYN0QYGglp5Mln2h0ZJYnKXjxPIFs21A1COnyybHOUKAotbmeoSgXXhdRoGw7iPknkWIasKhAcRmv38DQM7+n8jbn4Yqs1hgdSMP86G5uZnx8XE++9nPctttt5FOp8nnK3s6lgPPxOmx3u6Wl6vaor+/n2g06j9eLerw1FNP8fzzz8+5z1OnTvHyyy8zNTXF008/vei1rWduSPEwV7RhYGCAU6dO0d7ezsGDB2cZlYqZK20hsv83VupPSmrIS9aAjQ7cgXDe9dMYkTAoHUVbO9HaIpMewXEsWuovVH8vcgegCyWY4I/mjoQKIV5hHZiefxGrOv9Ca01CayJi5q5eCogKTSFerEi5kqu68HhKCaTUBMqusTHHps7KEC27gxICIsIlIl3GHBspJGEUg04rE7k820NJ6qyZMtRxV9AgNQFR+bOrt9I4OkxbwEFMryelBQJNRBQaUXnkpudppN0/Iqv+n5LSxeI+COViYj4dGleD9RZ5uBahUIj29nZ+lPsnmqb7c2yxtzCsZtISbraHgA0T+duRpFF6ZthVWG7hKs0oCn6e5sBOBMdJso/h/DH22qV3aTOEsfQ5HLmLoJ4deXPpxCKHnC7V1ITIhv4DbuA3rvmelFLXrH5YKgvpLqmUKunz4EWDVoLe3l5eeOEFP+oA6+9uebnSFt654Vp85jOf4bHHHpvzNbt37+a1117jjTfemCVCjhw5wu/8zu/w13/913R0dDA8PFzyvPe7J8jXKzeceKgWbchms5w4cYJ4PM4dd9zhd5Cbi4ppCzWGlfpj0GNoay+4FxFMlK7Bu+BXiAJIMQnuceKJTiI1E9SEQtMDeCRCDSJ04Ys1U4J5vGqItnDhDxfNv6hHWTsozL8YA3WRvA6S0y71VSIJAKOpVtxAko7gTNVDXgsuZtpIORbN4XEcHaDZymJXuYNTGkbytWyyU37pZRNjbAkU+kdkdZgpN4sLNFuzhYlHwpWkdD13RmaiMLVSU1tk5uzN1uHoQhMsW04SsqYIBa4ynH6HHXUPznzWZX0QPDERi8VKOjR6YqKpqani7IiNWsmxUh0m34z/I4pBP4KWtiyULgiJJmsTgcB7uM5mzjpDtGUbKG4WGmYLI86MH6JOBMjrRgacOBZBLF3Z6yCtOxDqbbSO4crdWHpGcCuaCTAKBHDlLWjRQt7+n1HWzfN6P67rrnhDrYX2eAAWVG0x37vlm266yf99YGCARx99lA9+8IM8/vjj8z7W9Y6XQroWf/Znf8Yf/dEf+b8PDg7yyCOP8MMf/pB77rkHgPvuu48vfelL5PN5/0b1lVde4cCBA+s6ZQE3kHioFm2Aglo+ceIEzc3N1xydXUx52kLkXsFKfQVRVHKmEWi5Ay1aQWdARBDuu1VLx1wVZCK5lWY/2pAAd3xmf6IdLXeBsBHOyarCIZ3fhiWzBN3ilMmUP/8CwA28j4DOTvGcsAAAIABJREFUExAWyh1C6oHSzwyBDhymOfwOVplx0haaHeEREk6AuA6xKZBixIkQUUk0kgbLxZq+eAxnw9Tago5g5UiCJSDlSiISaqRGaZhSAoc60m6O1kCWoABXK2wh2WRNVNyPZ5zcHUwU9YawGXUijLoBlNODm9+MZe+ruH2xmCju0BiLxRgfH/fFhBeVaGpq2pADt4pZbvGgteaNif/ClmmhqaZ2Eo/OiIFNdh1oGJU7QVxma1OwpGRzMJZBRmfamdv6MsN6D45+h9bA7cDsqILjNhEWJwrvB4WrFUKLQkRPhAn4PR+yQJBs6BkQzbP2U431lrbwxMNC+jzM927ZY3BwkIceeoj777+f733veyWvW293y+t1tkVnZ2fJ757Y27NnD9u2bQPgwx/+MF/+8pf5xCc+wRe+8AW6u7v51re+xTe+8Y0VWdNyckOIB6012WyW3t5edu3ahWVZJaOzR0dHufnmm+c1OruYmWFWk1jp/4jM/WjWawQa1EUQGZAN4L4NcidKNIFOItR5xHQedzLZgW1ni4RDhfciOxDuCQTT8y/kVrTsAJ1HuJeASXTgLsL6Xd/vMGsf1KKt/VjOWyWPu7qRyWQjth2mNpRHSKvQoKrKOe1SphmpcmyrTQCwzU54eyKjJIP5Wi4k62ixs9wcnN1jonBM6Eo1c3ttbHqyZyE1Ui80MEWTLBgic9pFIYi5Nq0ij11mwEyrQsvrSsbJtkCOtkCOpPob7Ox/JpkOMckusO6hLvTfEQ50ztoGKouJqampEjGhlCKXKwi4hU61nA8bLW3xs6v/gGIcWyi0rqf8FBMWY7jibgYyhTSG5NKM30HXEYgO+L8H8i3kSBBTXQgJwbwLFbKISm1BMNNgSujzuPJ92Oo9ZJFIzwf+e3LBz4FY2Fj31RAPC4k8JJNJLMtaUCXAfO+WoRBxeOihhzh8+DDf//73Z7339Xa3vFxpi7WgoaGBl19+mSeeeILDhw/T2trKM888syGMp9e9eHBdl3w+j+M4nDt3js7OTgKBAKOjo3R3d1NfX8/Ro0fnPTq7GCklof+fvTcPkiu7zjt/974t98zaUYXCvjXQ3QB6RbOhESlaVkeLokPjmNBEtESJEoMxHHM0ClthURo6OJQo0cGRQgpxgjOS5aFJj2gHbTOsMOmho7mIUpO9kujGWqjCVgBqRe2Zldtb7p0/Xu6VCaCAAtAE64voaORS9918+fLd757zne/IU5jZ/wXRUAbWCmU8iQjO1wycUJdqXFdjUfR2s7LqEHdyRKxONtUJtLFnTSWFUJMIFUYMtNgS2lBrTdHfhWNMYsjmzpxK7g0bBDU0JKrCEMt0JZZRxhFEMAk6gjKOsrS8gm9PM+CEoWet4WwhwyOxJcyO3TRDU6if7grPSz6wwr4VWhKTAV3Sp6hNJssxjsYX244BMO9bGIKaKHJQlgm05FIpyWpgsTOSw8cjISHToawUwlTGLruAIRS2UaCLs8BZdOmLLKsYy+zFdv4pGedwxzEa3QIhvOGfOHEC27aZn5/n4sWLd9Ui+35joyMbvvJ5M/st+isuqQV1iIxTL5d0RAz0HCOl8LgZowfVqE8wnkUFf1972B/fQU4JRCW95zQ4UlZRcodI2KNNz2l6MEQkjNIxB0hc+xP41j++o891P6ot1ttR83abba0Xk5OTvO9972PHjh38yZ/8CXNz9ftRNarwbtst/7iQh507d7b9zR0+fJhXXnnlvsxhI/HQkgetNb7v1wyfqtEG13W5ePHiHbfOrh+gxFDq39Ad+SbQVdElGOFiXtMlZNDGMDLo7LlfdNNoXWBLVygQU9pBGweol3JeQcsDCL1w8xJM4ygiGEMG4WIds0BriZZ70DIDQRFkAhH8qG2L4nC+YUSiRix0DhHM0VOpYJsqxxCyBAKG7EJH4jDjRTCFZq+zWnsubnjEgeq+ZMJzkEBBmUyUYww7a1MaC4EgY/hrjmMIxZ5IDlcJsipBxvBYVZKsDtMpSalrKZO8ksz50aa5NEIIkJQpBydYLv6/ZJw/bvu+dpBSYts23d3dDA8PN0Um5ubmamSiMc2xnpv+/TaJult8a+GreLpIyigR8Ci5YIEuu2HxsQdY1oMUK9UTfVZdnCZFHzmlaVw+Y9pjNgiJcUJuw5ZXaYX2TYTTcJ50FEeWEep1AJQYouz8EcroTApvhXdb2qJqTX0vyMO3vvUtLl68yMWLF2uh9Sqq1+OP8255ExuHh5I8VEWRvu8jhKjpG6SU/PCHPyQWi91x62wA4Z/ByP8ePdHxygEXEUF996zFAMo4gNAlRHCxwxxhMbebruQEsqG0TIoyVKoiwoqMZ0AX0GI7qAhCX28ehyTa2NU2kiCEAnUJ9BYQCQhOgLEbRTr0hQguI0VY5aDkHoQutB2nijk3woF4sVLN4DJRijNVSGIKxcH0IhHhc8FNstte7UgsAg3TvsOwFaZqhir/X/ZtPOJIsYwlNIEWNXvsdphxI5S1yQ4nTN9kGlqG+1oy4TpkAxNHKnbY+U7DcM2z8FgmIhXFBj3InaAxMlFtkZ3NZlleXr5jMvHjkrZwVZmz+beIiQBPO9zwPHZaiSYHSEskOVc8W3uckEV05Wtb1I8SF0sEta/cYJUIgQ5/V2mjH08XKTNAVI9jiBzCOEwqfrb2WSQWlvDD3hdA0d9DVvxL4tHdd5XVfrelLe6VuyTAhz/84VtqI+DdtVv+cYk8PGx4KMlD1R2yShqCIODChQsEQcDw8DCPPPLIHUYbfGTpL5Glf127Qa15CzG0HMLw6+FXLYfRYgBwEcE4ri8pu6mb2ktrsQ2ERDbZ9oIWXWi5HZCgFUJPIittu9uhGpGopVWCC7UbaaAtfHEAYQ4g1Aw0lMw1IlAWV0oDHEk2h42HI3mGI+HCnA8iTAYRBDDhxui3imu6ac6UYyRMxbC11so6Y7qAS04ZWAQgNYuBwNNJIqJAuqGUc8pPkTHyxIz2ltgGipI2OBDJYQgoK8m05+DrNIPWHLYI9RMXPUFELtZ2u0l5DS8oYxl35ypXhZSy5iHRSCYaIxOmaTalOe5VOLoTNupY/3n2P5IN8ux1lnA5TEFdJyb9mv+p0DbX3GaRndBX0IAU2zmbn+bpaN10LGPuYSmoX49RkWNOb2fFPwFIHLmbnUaCbHE3MecGjiw2OaSulN/LuYmXWF6eROuJJgfMZDK5LjKwkb0tNuIY9zJt8eOITfLwYPBQkgeoE4iVlRVOnTqFaZpEIhH6+/vv+EcnvJeR3t/RyWpZGfsRagUZNDtFCjWBIFx4F1d3ErED4ok+FMmKYLK+CGoN2nwKEZxG6LWVFEIvQbAamkKpd0D0oYwnAI0IriMIKzMCHadQ3kIy0jmSIGUGDI2oEB1NrOJ+Ga2VciJ34rpZ9sbW5purOLncw654vkEwWYkweBEKQRdFv0QhMHg8sUTUaH/uQuFkD0diC7USv4ihgdB9MBuYLAYWZS0ZsorEOpSWljSUdawpTeFIxTa7CIT6j1XlcMX1SJrNVRum8BjPv8K+1M92/Kx3g0YyATSRidnZWS5cuNBEJkzTvOfVHBuxAK36eU5k3yRhegS6ixn3Oo6wKVMX/sasZ1jyXq897jJ6UTq8Nqf8XfSZLpp6GaYUvZTVqwAYxNBqjqxfTVsoIiJOSRdYDWySegAhLXyRRuhlfOuDmPFf5XA3TV0sl5aWuHr1KlprUqlUjbDdqg35/Upb3K4AstHjYRObeFB4aMmDUooLFy5w5coV9uzZw65du3jttdfW18iqBdr+eXz750EtI/y3KK58F0O9RdReRJtHEP6Jjn0rfBUlVxigOzFemWCYftCYaGM/mhTF4hICiIn2LpBAJepAzRQKfQPRsEPTcggl9lIurxAx26dMgIoo8hIiqOekBQVEUAkDA9p4DihQ8gzKAjLWQtMYrhKM5rfyeHpiTdtsQ8CgVaJozDPmpXgyucCVUoqoNLDNHN2GV/NymPMcsoHD0Xjz+I3wtCBl+HQboXp+1o1yw48iUeyJZokIxVIgiEpNWrYvCQWY9xLEjBXisr3ifr70XfYmfgYh761ADprJxK5duwiCoJbmmJ2dZWVlBa01Z8+erRGKaDS6YTvOjSIm/27qPxAxCyRkmSL9wBK7Ir3oitFTzNhLIWj+XfRZoZBGyoNcKEzxWGy4qWSzqOqW1V3mbpZFBF2xqzZRmPod4HG2xaYxjSJo0DpF2fksgfme2t+262KZz+drZKLaEruVTDSmEB60PXUrqpGHTYQIbezupjHWJu4EDy15GBsbY3Z2lueee67mGmYYBr7fPt2wLsgM2v6HrKjDXLp0ieeP7UH4byDlEHhv1ASTVWSLwzjWKl1V4tAAgQ/BGNo4QsScAbyKeU281vtCoCqLeSUi0dG330TLQaT/fWKmQmuBlttxgy5KhSXikRsYhmwWRbYdpxttDCCDcKfYVdnkLHoO10uJ8EhCETMCHk92jkhMeFGSUnAkGZKCfbH6Tt/XMBdYZINeyn6RfdHlTsNw1Y0yZJWwGnQUA3aRgaqXgIYZX2IIyCuBkBqnRXNRVoJJP8PWip1xt+Gz3HLXMBEci3wXq/BtllU/rnEE2/w54tZP3RcyUdVDdHV1sWvXLpaWljhz5gzRaJTZ2VnGxsawLKv2nkwmc1dkYiMiD4vuCheLPyJmaizZx2oQluSmjTL5AFAWY26U3ZGlRmNp4rKAVgYXyhlgnrjIN3TZ3E4xGKm9NyYcJv06EU7KOD3WYyT0aURF66LEnkpjq+b+BK0QQpBIJEgkEmvakC8tLTE5OYnneU1k4t2WttiMPDRjM23xYPDQkoe9e/eyZ8+eph/kulto3wI1e2pjAG38IwLnH4UvBOPgvk5h+TuUS8v0pUcRHQSEYQnm3nAxr0614cYZukIeABGrtOTuQBzEVhB2k2ulEBrUNRxxDScOSu5HCwuEgZIHEerKmq6cyngMoa4jG+ZQRbdVptsq86NsL/tjK+QCi9H8VrJln22xLFsi9cX8optkj52rVT20g6ske+xpsKGkDC6XEgTaYthZICE1PlDU8ZsKHuc9B4TNFrNuLKQ1zPkOK4GFKRQGPobwa8QBICoDZlyHiBEuaQkMuo0oUoSRjQFjGpgG/79Rcg2W2UJBfpCB+P1z2qvqdqrmPdXIxNLSEjMzM4yOjmLbdpNmYr1k4m7Jw19PfZWYWUIrKOnwOxAIyiqMOuQL+1gxChSCZpIp9BU88RxTlR4WQl+rvabFPmh4XMQi0MuV9yn6jS0kGko88/7zkPociPXvxm/WhnxpaYnp6Wl832dkZISenh4ymQzpdHrD7arXU6q5SR428W7AQ0seLMtaE2UwTXNDyUMnMpIr9HDq1DaE+HUOP/44fnQC6b+J8F5H+D9CVHLvyjiAUEs3jwIYuxBqDFHpPBgKJndQt6ueqXXKFLrcfgwk2niy4mwZNDzf0JVTZUGkkMEPO85lxbcYL6V4KhU2tIoaAf32JFTuY9PFBIHpsBT47LTyHYlDNogR4LLVqs83IgMOROuRiaUgdLgExZxv0WN4a1Ij5wsZhpw8KSPX9LwQ0GeW6TPLXCrHGbR8lgOLKS9NztXsi80hBSgcoEyfdIgJq+NCaomAVW8KJf6MJfcFuuxmU6l7qUtonFNjZALCBafaqnl6erpGJhqrOSKRyE1amd9d5GG6uMBE+SRRA5JWAlXpfrnD6cfX17H1Lt4Wq+yLDKKqXTSBbqMXmOREISQEGSNFULGTNkQ/ri7XRKwxMcxKhXgYWrDXipAQk2i6UXKYK1O7sTP/Mz13QBzaobUNudaav/3bv2VgYIB8Ps/o6CjlcplEIlE7z+l0+qY9cG4H66222CQPdWxGHh4MHlry0A4bHXlotafWWnP16lUuXLjAjh072Lt3byXycRBlHoTIr1WcIM+Adxrpfw90+4qL0HPhwFrxpV5CVELDmkwoltQKbTwCwXUEiy3jDIBsTwpqXTnlDhAK1LVKyiQGeqmWMgEoBTspqxmOJDrrEmZKUQ6mlxm2wt37nO+QVwmyLuyIZEmbHidyvTyeWMLq4H4ZaJj3e+gzF5BCUxU5FpVkwbcJtCAuPVaCLh6JtTfUAnC1ZNKNsscJoxYDsgyUwQatLZaUjQSGZBRLGB0X0VUlmfRdTFnCAEZX/ojn+v6y43E3ErciJYZh0N3dXet4eDtkorGB0t2Snn879R+IW2UWSnESZj3t1GeBp5KcLzkginQZOkxh1F5PMhscoqynANhi1/0esvogKTlTK9k0jWEK/utEMNhnG9i1r6mEZ32I8RtRDnTdu5RC9Rxt2bKlJmgslUq1yMSFCxcoFotNZCKTyaybTNxJtcUmQmyShweDh5Y8tFsM7gV5qI5XLBY5ffo0xWKRp59+urNNq7DQ5hNgPkHAr4IuhUJL7w28wis48iLa2FNxgXy7/RiAkocQenrNe0peH4VyiqhjUCgFdCdnEGq2wyigWnQUojVlInexnBUkovP0timxBCgFkpPLfRzraT5On1mmr7Jgr/gWb6z0YwjNvNdNjzXXsBCEWPRs5v0o+6NrCUpUKoZlieXAxNOSLVaWs4UMgRb0WSUGG5p25QIBwmaX0z7dERpDGWy3ytgyrGhQOkyTXC5m2BPNYQnFtG+Q0znMhpLTIfMVFt0rdNudujs+OHQiE9Xw++joKI7j1IiE67p3HHkYz88w7Z4jahr0O0k0Df1c9CSr+hArKiwPVjS7r2qR4HypUcPgggIpMowWlnkqWifUJZUjIyx2maIWeVJiuKJv2ItSP7ineoTq5qDxGJFIpG0b8uXlZS5fvlwzcWokE7fql7PeyMPQ0NAdfqJNbGJj8NCSh3a4V5qHqakpzp07x8DAAE8++eT68qEigraeR1vPM7v8PzI1OcozR0D4ryG9NxCqOTKhsdHG4/VqixZErDkcq4DHLrrNs2EfDdkNqthUFhq6X27tOE44txiCIt2J0GI460e5XIwRaMGgU2DIKTBdTlHyWUMcGnGhkCJpeBxL1zUHgYb5wMLTEXKewNOw1S6xP9q+6RXAdS9Cv+GSqXg+PBqrpz2KyqagfVwFSUORkO2JTqBhJUiTMVZqi5EQAkHY3PGR2ArFwOCSLzDlyprUiy0Dxlb+iOf6/nXn87aBuJu0ws3IxOTkJNlsFsMwOHfuXC0dcrs27f9m4j+TtotMFbvZlVEsVzKEA1YXQjiMFCpOp9qhGNRLMA0RYazUHB0z9BQBUOJxBmyNrvSjMMRu3OACA2boqmIDJbGPIPqvQITRCq31fScPrai2Ia+2pXZdt0YmxsfHWV1dJRaLNZGJ1rLM9Woe1tNR82HHZuThweAnjjyUy+11AXeC6o1lZGSExx9/vHbzuFNIKfH8CNp+D9r+mTBhoOYQ3htI/w0IriD04k0XfCX3IXQWW58J3f3UFYQK88lhWeg+FFsqHTbPdh6nWsrZUDmSMoscTdZ3+K+uDJAwoOxCVHpsibb00agIJ3dHc20spqHX8Ai0x41yNweiy0y4CcbLSTJCsD06X1vcfS2Y8iJst5vHb4QgQACDVvidFJTDtGcigB6zTNrwWQ0MrpfSHLxJL405L8KkqxiKrDDr28SMtQLVrearzJcv0Ou07865UdhoLUUrmbh48SKrq6s4jsPk5CTnz5/HcZw1molWjOWuM+ePYQQxolKy7Ne7sfZZPbyZq4sd+2n+e0s+w7JXT6HFZJRAjyCIcaawwmOxdK12zhO7KeurXPY1WoMtDPanv4QU9THvtQfD7ZCHVti2TX9/P/39/QB4nlcjE9euXePs2bNEo9EmoetmtcWdQ2uBvgsCcDd/+5OMh5Y8dEpbbEipJjA/P8/p06cBOHbs2IbsBKSUTRqK8Mk+tPMLBM4vhI+D6wj/daT3JnhvIKnqH9qLIpsh0KSQwfcRaDROqHEQcVBLFZLhoI1HbpoyWfEtrpZSPJ9ujjZcLySYLsYZSmossUxZm+x3ch1GgWwg8TA4UlnM90bqtf2eMsgqhas1ghTDVueIxHgpTtII6GlIq8RkmT1OnSiOlcPvR2mDVd8mYa4lBZOeha9zDEXKlTHCRav1UrJkwMXsZ+nt+zc/1i5/UkoikQh79uwBwPf9pshEI5moLnKRSIS/uv5fSFpFltwunkh1k1OhdsEWESZdD7/h+ksYpVodfdx4hMWWn9+g1Q1ofPEEBTVHVAQEGgzRS0n5tep9IaCMiTSayYhS6p5+B1VycjfHsCyrqaul7/s1MjExMcHIyAhaa65cuUJfX1/tPHc6ZjUtsokQ79aW3A87Hlry0A4bkbYIgoCxsTEmJiY4cOAA586d27Cyrduan7ENJYe5OnuM0dF/yL5dml1bZxFqHOl+s3PTq6rddUPUQlBu0jiEYskoINBi25o+GgDn82m6rTKH2wgnt8VW2RZb5Uqxn7StEDrgQjmBVFH6rSWSZn3lmHG76bKWSAlvzTgQLtBBIOg2wBQrlCqCSV8LEjI0ixICTua7ORRbavKAaITScNlNsMdeDVMQzipKg6tNZn0DRwT0GR455WPJ1aaOz0npMeM7xI210aoh8w0C5aMooe+hzcz97G1hmiY9PT309PQAzWSiushNOVmWE+MYQTdKeFhymaovWkQ8wpzXHM0S1iwaMEWcE6s2B+Ml3AYCkTEUQkc5XchjYKBUmOIo8CiOXsRrOLe2WNtS+n6kLTZ6fNM06e3tpbe3FwgjE6+88gqRSISpqSnOnz9fK8FtZw62mbbYxLsBm+RhHchms5w6dQrDMHj++eeJx+OMjIxsmI6ibeShBa7rcvr0abLZLE8++RQ9PT2hgRSgYv8bIjiL8N5Au68h/HcwpI8yn0T4Z29SygnaeBoRvNPUs6PaRyNfKGEb8+REP3tj5zs2vSoHgreXB3i2ewYpIIlPv1kGVvG14FIxxbwbAaI8kZzA7jBOUVmcXe7i6e66RiIiFVsbdAzZIMpYMY4tFXNelCF7ratkLjBYDuw1HTWlABufbZZPLpC42qeg3TWloAAJGaDaRB9sGTBXPoed+QqZ1HeYXhlGy2OY5gfpizy5IYv+/eiqeTO0IxP/7Oz/hSWgjEdSGSx610FAWu+jEAToBofVPpFEybDMsqAPs+jPUVbNpNMW85R4ilV1g21OL5oRBBHOFpY4ErncdN4T5tE18/9xJA+tqF4ru3btwrKspqqZRtvyiYkJJibC89lYNbPRKJfLHDt2jJMnT/L2229z9Gj9vJ86dYqPf/zjvPXWW/T19fGbv/mb/M7v/M49m8vtYFPz8GDwE0Ue7tTnQWvN5cuXuXTpErt372b37t21G0pruebd4FbkYW5ujtOnT9PV1cXx48fXKriFiTaPoM0jlOWv8Xffe5l/+L4BDPU6aB+Cs2siE3U3yTalnJWyUMfoItBJYkxxerUH0Gxz8vTa9cX8eiFBKTB5rmdmzTgAptBYKAadAtsjN/CUZN63KGmJQYQeI4stNVdLCRKGaCIOrZj1beJS8XRivvbcom+jSCBYJioVnraRVHtatMeUZ5GUZaQQFFWcuLG2bXdC+h2jDwvuSRxrmoj08dUEXnCduP73TJdiLAZ7ycT+CcOxn+l4/AeN9fo8vL5wiVlvFsswiFgBh9I9LKsp4qqPH+VzHJAFaKgg7BHh7SVuPM5ry3P0mglKqq6PMDFRepZThXAh7K9E8JR8gpSh8HWhidB1R/6HpvlUfyv3MjpzP9wlq5+jKphsJ3TNZrNcuXKFr3/965w+fZrf+I3f4Ctf+Qrvfe97+YVf+AV27dq46p/f+Z3fYWhoiJMnTzY9n81m+bmf+zl+9md/lr/4i7+ozSOTyTzQdtybmocHg4eWPGxUqWahUODUqVO4rsuxY8dIp9N3PWYndBqrMVVy8OBBtm7dessbppQSpS0C40mE82yYjdCrCO+HoZW2/wYaB6Em2rpJVqGMw0h1EVuG2oonkvXXJkpxZt0YQsfZYt9gX7KzxfSJbC+H4ktEKo2xLKnorZVAlikpg9ey3USkwpQKX4HZcs/WGq56UbZZxTVVEN2mCyyiNcwrSVx4zHgx5nynJpiswlOwEsTpNVZqO9t+M2AxMHBaGm5pLUlKn6BN9CHvnSdpLjDn28SlS6LyedJGgbRxikvFr9w1ebjXmor1jP+vJ15GCE3ECs+RlEs4Osakl0SJPDJRoLG1iwwWwEvxg6wHAgbteFOCZ9DuocwWCpVS4rhcQSnBaMln2I6jlEBW/kJriFtPNM3nTsSM68X9aopVbeTXDlVzsA996EP8yq/8Cnv37uUP/uAPWFhY4Otf/zrpdHrDyMM3v/lNXn75Zb72ta/xzW9+s+m1r3zlK7iuyxe/+EVs2+bRRx/lnXfe4U//9E8fKHnYxIPBQ0se2mE9C73WmsnJSUZGRti6dSsHDhxoW0pVs6jeALSLPORyOU6ePNmUKrndsYDm8UQCbb8Pbb+vUsmxgPDfDEtC/TcQqm4hrImgjUPI4ASd7p1dVok5L8oTqXECLbi4mma+HCVqeDySWsGRPgUlWQh6eDLV2dCppCwul+K8p+E9Wc/iai7NUGIRR4QzygY2O28SScj5UQJRpq/S72B3g8/Dgm+zHNgIHSPvF3kkvtT0t7bQlHUCh7ow0yFKwhCAxtWKsg4oaEWxskJqdRFPFunp0BrcaXBVvBPcj7TF7S6M35oeYTmYJeOE13qflWDRv0xEPM4Nb5ZhJ0NB1b0bLGFgROYZX91HUVQcVfPziIZUfVo6nMqHYlmBAHUZKY8w761wMAKFxktXrK36qJ6fe00e7nVTrGp043aJXLFY5Pnnn+fw4cN88pOf3LB5zM7O8tGPfpS/+Zu/aWtC9dprr/HTP/3TTRHPF154gc997nMsLS119ra5x9hMWzwYPNTkQQjRdAO+XfLgui5nzpxhZWWFo0eP1lTS7bCRkQcpZS2PC3Dt2jXGxsZa3Cpvfyzg5imUa90kAAAgAElEQVQV2YO2XySwXwwfB5NhVMI7gQ4uYQQnOv7p5WISRyqeSIapA0No9iZW2JsIF19fSUZKKTRhE6qyEjhy7WI471tEpcGhWHPUImV5PJ4Ox14JIMBGIbjqRklJny6zWWg5VkyxxfLIGO0/b4/phrtYESC1YKrczZDTXLI5ZLosBhEiskRSRLFqMXOBIwwcDFKA0pqy9ok5Jykps21FBkCXnN2wttf3AushJ1+a+DaGEJhVYhaLY8mDfH8pjBoMRiLMNwghtzu9lNwMk9QJXDxVaiIE1xY8itEwHdQnUyhGue4mgAJSX6URttyyZk73I21xPyIP6yEo1a6gG11tobXmwx/+MB/72Md4+umnGR8fX/OemZmZNRGOann6zMzMAyMPm2mLB4OHmjy04nZKNW/cuMGZM2c66wrajLmRmgcIUyUjIyOsrq7y1FNP1XKf60E1DLquuRlb0cY/5sbqezl16hSDfasc2LVMefV7RM0zmLKA0nAi18fhxAK2bD+20nBhZSv7MhM1cWUpMDiXT5EPTLrMMjsiWWa9fgbtGxgdKi4CDXNeD/3WAlK4dDfcX3OBwZSbxlWKkjJ4MrFw0yZcC76FEIqMkSdd0ZrlVYJc4NFluKEmQ2gKaoBB88ZNF6QARUF7GALihkdZSXLKprclAhE3XJbcMbqdA50ndgvcz2qLTvgvE6dYCubpjdbLW20j4M2lepRGiBwoFapREURkhtfccaiUwaWMGAV1of73IsVKrFDzdEh5ASW9lav6BkkdJdBjCEyqb4ibT6+ZV7VM88edPKxHV1EsFtFa33a1xe/+7u/yuc997qbvGRkZ4eWXXyaXy/F7v/d7tzXuJjbxE0celFJtb5q+7zM6Osr09DQHDx5kaGjotm5KG615AHj99dfp6enh+PHjd9Vw53aqNxqhlOLixYtcvXqVRx55hOHhYYQQTM0eJ5db4eijFl+78m/Zbp0g6MDWF8oOk8Ukh7uayzwjRsChSqpgwXO4sjpI1PSZ9h2SUpKUxSZx3Hwpwkw5zmPp9r00kkbAFivPnO/weHyZWTdKNsiQNor0281RjDnPxpY+SaOZOMZlgbgEX0vmA5OcMugySigE7faBWmuK2qOgm8dxpKIQtN/FL5TfuGPycD/SFrdzjf/bie+CltiVqEOvmeBK3qNcOQ8RaVEsX+U3uy+SND2ue3HG3TyDpsO0HwcE2yPJpjEd8Rg5/Vbt8VAGZr09UJqhX4bui6JBIaELz+LabhOZv9eVFnD/BJO3G3nI58NIzu1GHn77t3+bD3/4wzd9z+7du/nud7/La6+9tsb58umnn+aXf/mX+fKXv8yWLVuYnW32dqk+rlp1Pwjou0xbbEYe7gwPNXlol7aA8IbQ6M2wvLzMqVOncByH559/fl1NZzZK8xAEAefPnwdgz5497Nix4653VOshD4VCgZMnTxIEAe95z3uadjZhBAO0+Rhj3s/wL6+kMUXAkcQCzyZneW/XInsiM5zPdTMYyXM4M9/xOOdWM2xxiuxPTTc9v+zbTLqh9TVKM+yUOhIHgCnPISXrxlIDdpGBShOtlUAggaShmfUcooZHQnaOOLkaQLDXLgElCoHJ1XISQyj67VXSMkCjyakyHu3PZ1S0Hz9X+BF+7KUNb+G8UbjVNfYfr75DTuVI2/XoUK+zlfP50drjZyJ5fq33HPEKOTvoZDnoZHkxGUaIxr0YS3qRKa/MsrZJGDvIt5AtSZGxUrgwDsYlXmAiRf1cT101uXDm+009I0zTvC8L+/0gKOshD0KI2y7VbDSnuhk+//nP84d/+Ie1x1NTU7zwwgt89atf5dixYwC85z3v4ZOf/CSe59U2Nd/61rc4cODAA0tZQKXU/C549r2l6A8v3p13tHuE6g28Sh6UUly6dIkrV66wd+9edu3ate4FeyPSFlX/iOr8+vr6NiQUe7vkYXp6mrNnzzI0NNRWGFrVYgAMRMKeAr42+FGunx/l+vnGUjeXJ/M83TXDT/VO8XzPFAdTC02RBF/D27k+nkzOY7Txd8iYLknD5XShm8cTSyy5cd5aHEAAj2UWiFQWf6Xhmhdlh1VsqzMASBuhM+RM0ENeFUmbnS3J53ybqAwYaHCcjBk+B2N1QeW8D6a4uRlURAaUlcRpSeUINcYrr7xCKpVqauF8u4vFvU5b3Or1L098hwBJygnPz6C9h6yfrb3+8/FJfqV/rK1HBoQ+GV2Gy2PmRUQU8kowUi5xVicpVk5Vv5VmWcXQhITSYJKy2IWk2hPD4tgz/6CpZ8SVK1dqC+nY2Fjt3N5ta+xWvNvSFlVr6o2+LrZvb24zX9087Nmzh+HhYQBeeuklfv/3f5+PfOQjfOITn+DMmTP8+Z//OX/2Z3+2oXPZxI8HfqLIQ1XRHAQBq6urnD59miAIeO6550ilUrceoA3uJm3R2MJ7586d7Nmzh+9+97sbpqG4lebB931GRka4cePGTXtzNI7T3xJ+Blj1SxQCi7+f38bfz28D4B/0dHEsfZZHtv2QbVaeILB45iYVFwuew3LgcLRiVd3r5OltqJYoaocpV6KQbL0JcQDIKYtAB2wxFsAATwumvTgFZZA0oEuuYgjFjZqeov04gdJMBTYJmas0zwojGlpr/DZEoqBNHJptr3si8zzy3HMsLS2xvLzMyMgInufVyERXVxepVKrt4vGg0xZ/ceF1iqpE3PZAaNJGDxOFEqY5QwyXDyYn+GDveMfzV9awFNgMW3XyllWSGVWiGIzXnuu1MpzJh/4PCRnqHZb9bXRX7k62HAz/39Iz4saNG4yOjtZ8WPL5PIlEoqlnxN2SiXebYLLajvtBiHDT6TQvv/wyH//4x3nqqafo7e3lU5/61AMv01SEv827+ftNrB8PNXlo9wOTUjIxMcHVq1fZtm0b+/btu6tSrDtNW5RKJU6fPk2hUGhq4b1encKt5tZprGw2yzvvvIPjOBw/fvym3RQbIw/9zlqSteIVCd2B6ud70Xf46ondPJIKUxh+YSd98irPpmZ5NjXLQEPJ5axvEZWaPVaWTvC0waBVIiZV6OXg2xR1hoJfYpu9SsxQzLkRrubSPNU9i2i431tCs9WqH2+skGLRjdDnKFaNCAlZWrMArvgmY6UI+2OdUzCt8PXaRabLyIJVYmhoiKGhoVA3USyytLRUs30OgqC24HV1dZFIJO7JgnUt+wbdwafIKpsV/Sgr5h4i/HTb9wZK8Z+mvw+mYDCmAJOcm2Q4ZmGzwm8PnKbPLJP1LcaLKcrKoN8usD2yihCwEoS/qS2ViI7WMOZZjHgWoZohDxUz8KKK4VecTYftDKY8QEA9rZW0fqrtHE3TxLIsDhwINSXVyMTS0hKXLl2q2Tg3drNcL5m4n6Wat4NCobCutOqdYufOnW3J6+HDh3nllVfu+fHXg81qiweDh5o8tKJUKqGUYmJigieffLJmu3s3uJPIw+zsLGfOnKGvr4+jR4823dA2mjy03gAaox1Vt8xb7WJuFXlQaNIRh5VSfddd1D4zCz5PySR5lSOQGb6+IPn6Qljq9f50hPTCJT5waJ5Hk6NEO1Ru+ApOLG/hma6ZWrRBCOg1XeAGWOAqwRu5PmyhiJk+AQKzTWRgJTBZDKLsjubYH6sTlZIyWQpMfA1x6YcW2qKwLuIAtN2BSwFz5dfZbr5YmbsgFosRi8XYunVrrfSuSiauXr2K1pqurq5aam0jyj3PzH2Rw85fErV9wvjSFAx/i7L6V4wvDJHVj9MV/e/oj74XQ0b43Nm/RUmftCEJRJE+4yDv5Cd5oWeKX0qfIFL5vlKmx+FkXZtSVJJpz8IUkKoYbrla8N1ChlJDVMZE4QKWiDLj1l1Ju0yfOb8fR9QFtxGzveC0tSlWa2TCdd1axKeVTHR1dZFOp29JJt6NmocHFXl4t0Jpgdj0ebjv+IkhDzMzM5w9exYpJYcOHdoQ4gAhefC89qWGrWis6Dh06BBDQ0Ntx7tXplPVvhi5XK4p2nE747RqHlqRcZrJQz5wAUFCD5Anh+E3lzGOuynOjj7GgqnZt28V3z1ETF/jifg8j8cWicqAmWKUJS/Ks93tLa8htKVe9CMcS9ZTIq4yWFYaHwNPGaSMMlNenB1WgV322i6fEakYlC5FJbgRmKQMj0k3xaKXZDiyQrylBFMIgdBrFRCOaP+95dy3If5i29eEECQSCRKJBNu2bUNrzerqKktLS8zMzJDP5/n+97/fFJlYz+LhBWXOz/0ezyX/ru3rjlTsdSY4lS+yl2/iFiQ3gj4eTSbIM8CSGqLX2stby9f57eGTfDB9tWOaAmAhsNhplWvvmfUtvl3oYUlZDFt1Xw1DBKAhaR5k0av7idiizIXSEgedugA1YrRvfX6rhd22bQYGBmrpuHK5XItMXLx4kUKhQDKZbEpztApbW8XV9wLriW5stuPexLsFDz158DyPkZER5ubmOHToEJcvX95Q1m4YBqVSe4fBRqysrHDq1Cls2+b48eMd1dL3Km2xsLDAqVOnyGQy6y4BbYw8RAyLtBWtpCrqSNrNl9KKG+a53WwCkmDpZi1AQZUByeiMYN8+wSo9fGPB5j8s7MVA8UImhrcyzvsHruMq2dZTYs5PYVFqauUNYdOqsKBPMaVMisrCEYprXoyU9Og1y00LoKdh0g99GoYq5lM9lTTHvBcFbv39AsSEV2kn3fy8Uudv6+8hPNfJZJJkMonjOFy/fp19+/axtLTE3NwcFy9exDTNGpHo6urq2L55uTTB/PJv8VxyvOPxsr7JlJvgiUqXVFsohs1ZXuqb5aW+S5SUZKSU5hfTBgcindNKhcDgQj7DkVQ9CnHdc/hvhV5K2gA0gRY1sawhFKaIUPTr140jbPIqjmYRq1ZpIYkYe9oec72lmo7jrCET1chEI5loTHO82wSTm+2410Lru6y22Cy3uCM81ORhaWmJEydOEI/Ha3n9a9eubdjOHm6tedBaMz4+zsWLF28rTbDR5CEIAkZHR7l27VqTd8N6x2lMf/Q7yTXkIWo175yyXpmksLhyxSVzGHoyCcjWG0+tBiUgxviCxhQR4mZ9/ADJWHkLL19J85dXjhA1PP6n/dP8zNAZ+owF+o0y170o261sx12w1jAfSAbMUmXBqpOXFd/hSjGJrwRbowERY4Gt5tqunAC9VpEZ3yHR0hhLINZUX0gBucAiaTRHoqI0uyXeLqrpinQ6TTqdZufOnSilam2yp6enGR0dxbbtNWRiufTfSHt/SG+8zLnVLnK+Rdp02RtfqRl3XSuFXUkfiXXuSVJQBjucVborn6moJPO+Q1lJzECyPZpj1o1SUmYTcXinnOT7xQy6poMRuMokWhnHRBGRBzFEnmIlyDBo93C+eCMkBZWSWFsOI9tYU8PatMV64TgOW7ZsqXkUNJKJCxcuUCwWMU2TcrlcE2LeiyhEEARr/BU64X5pHn6csKl5eDB4qMmD53ns3LmzyTNhI9MC1fE6LfalUolTp05RKpV45plnyGQytzXeRs1Pa82lS5cwTXONd8N60Fq10R9JcmG1ueulZa79AUYdyfRCjAxgtvgsrPplDBH6OjgMQIuttN8QqSgGFl8Y3UZff8Dl3CQOPjvtIstK0S1ybG9pub3i2vgyQp/ZfqecNsvsjfpcKHYxaC+yqkxm/QgaRVJ6xFvmahAFOpd7NsLVBtBMHrqNeQIVIIVkKv/nuAyyNfrz2MZa/citIKWskQSg1r55aWmJyclJzp8/T//O/8KTfa9gVuzADyXqZadlZXGpFGPOjdBnFRlqqGhpxYQXoddwa/oGgKhUbJN14ngi2xvOA4lEMxTJ871iF+fdtdeapw2ilXNjCs2J5SJHUnXTISEylPV1LOHV9C0RY2/H+W10VKCVTFR/v1prLly4QKlUakpzpNPpDSETm2mLTfw44qEmDwMDA2u0DfeCPLQbr6qx6O/v58knn7ztm8xGRR6mpqZYXl4mk8nw9NNP33VFSVPkoY3uod3wmXScydksT8kECHfN6+mEzWLORXm92HbzglvSZRovT08Jil4XMEkZk1E3yRUvxrduPEWPWeJobJ4n4vPsshQJucKQ3TnEPuOm8FVQ68uRkAGJhm6aS36ac4UoB6I3SBg+3UaJFS2xG0yLJLTttNluE+NIn7nSK+D9AREmiACLuf+dxWCQQBwh7byfoegLmHLt7vNWO+vG9s2BKrCU+yg7zM5pElN4FAKLn0qHi3Y+MLlQTlBSBludMr1mSMSuejF2WIWb6hveWunjaHIeq0JSbpSjfGlxmFIHn3BP1y8SU0iipkFRhcRGYJALQj1KXNavhZuRh3vtMBmJRLAsiy1btjA4OEipVKppJkZHRymXyxtCJtabtrjTTcDDis3Iw4PBQ00eNqot983QOp7v+5w/f56ZmRkee+yxddu23q1jZaN3Qzqdpr+//65LzVoJTb/TZscs1hKeWDwsy0vQS0CZamleFcmYxWLOJZtP0h1ZIFySQxSDEtB8k5zNp6BhfXV1AQks+BG+kx3mO9lhdor9XJyY5Ff3TvBzw6/TY0giDb0zLpXjbLPy2LLzOc4pi/2xG8QND6U1Ghe00fQZhRBtk6VWGwfKsgbcf4LV4EJpCcWAOQlMgv//Mbb4B6ya/4xnMy/V3rMenwfXH2El/9tsN2Y7vmfZs1kspHgiXa8iiRs+BxvSFiuBwQ0/giU0i4FFr7lWDOxpGC+neCZdF6m+nevln557H+/deZZeo300I2goZRWU2RmJUP0WusyD5PwzAGQayEfEbC+WhPvnwVA9RiQSWROZqKY5GslEoxnY7ZCJ9VRbbKYt1mKz2uLB4KEmD+1wO82x1oPGxX5lZYWTJ0/WvBNu10K2dbw7jTxUjx+JRDh+/DhjY2MbEsVotfluF3nI5tfu9G0nvLxEOUVZTgLpptfj0fD1meUoPT1FoB6OzfnVx/Uf9o1cmt6WzXnSMFkJ6t+nYSiu5tP8H2dSdPedRYunuJCfYp+To8co80y0c0MvX2uueRaDVmMoPbSficuA1mVUN80uhCNdVgOIylA4uaoEEtVEHFpxudzN9SCF9E93fM/NoN2vkHT/T7pMj7ISLAYWvhbEhUXGWEUKuFRIETN8dqc7l5/OuhEsI2BfQypjVRksBjZKC1LSwxSKkjbZ1yCe/E+ze/jDK89Qci181XkRNGS9L4UUmqS5wrIf6kdKKoaqeD3EjB4gTIs5HSot4O41D7eDm0UFIpEIg4ODDA6GJlbFYrFtZKKxNLQdSVgPCSoUCh3N3DaxifuJn0jycC8iD5cuXeLy5cvs2bPnjmyuG8db74Lfybtho1IgreO0K9cs67U7VGmF56CQi+A6eVrJg+OEN8yLswaP7M7TSB4UirRjsVKuL7qTy1H6ew0U9e8vpjX13o5haSJAORCYbEcInyk/xpQf7tb+JruNfeZW3OJVjqVnOZqcw5GKVSVYDmDQar9rNoRgxTeJNTTXCr/jOqlSuqJ2kLCqNYGSSEAKgaX1mhSH0oKTpUGyOCDAVc39PurHaA+tNbL0z4gFf1d7nyM1g7KaIiqz5NmcWOkjbvoMtWhDGjFSyLDdyRE3mn8bYUon1DjM+A6BFhSV5EIxTUx4fGn6EP9u5gDVagpPdV4ELdG8cAZqAoC0+QhQwgsgbH8efhaBjSObbZMbcb8jD7dCNBolGo22JRMjIyO4rksqlWpKc1TvH+vxedhMWzRjs9riweAnkjzcri/D7cD3fUqlEpOTkzz77LOk0+lb/9FNsN60Rblc5syZM229GzaKPLQKJgfaGEVp2wCa511Ncc8tGES6S9hC4Db8Ui07XCTGZhSBbq7eAOiK2E3kIe9rIv4ABXOq9lxvPMZ0ru7dUHLzQKjOn1vupjfd7OugEEz7ffynyRR/Ofk4jvT5/YMzJM0T7LRWUbq92ROA1bKQt76telUprRFIYg0RDqXB0yY5ZWFoA1OUOVkexG9YUIVYaDKEulnaQqtlzOJLRJhdK7yoINBwoZDhH/RO1p5bLse55jtoDVvsAn1WiXfyvRyJz9+0pfm4G2PYKtYqNbKBz/96/r28lQ13wZYUuAi8m0QeWqtTfL0COFwq2uyNhl4eaXMvpjiL0uAYuxDiJuPdh66ad0NQGsmE1ropzdFIJkqlEoVC4bZIRLFY3ExbtCAkD3ejedjAyfwE4aEmD+12baZpbljkYXp6mjNnwjzt888/vyHK6/Us+PPz85w+fZqurq623g236m2xnjk1LmQZubZ0Lkwz2E3PBZXF8+qU4sA+6LFNpst14iYr5ZmeEhjEaaUfKaf5RrpYyJGdS2IO1p+LG803didRn8P4SoZU9BrQbIZlNugdysrkRG4Hydg1TpR7sQl4b8xlr92uvFJQVGGlgEGo0Gg8ux4gqbzWogGRAmx8egyfpSDNW6WtyBaWYgiXa8VxdsR2tTl2Hcp7C7P0T7FEniYf7gYUlCDrZ3g23VwVk3HyZCppiUJg8E6+B0MozhW62Wqv0m01C1t9DRNejJ12vZR12o/wmWtP1IgDgFV1/9RJoH031EA3/+5MEZA29nOxUGTVDgmh1Gm0Ds2kbiaWhPuTttgoe+pqJ8xoNFqzKa+SibGxMa5du8bly5dv2UBt0+dhLTYFkw8G95a2vwuxEWkL3/c5deoU586dY//+/QAbVv99O2kLpRSjo6O8/fbb7Nu3jyNHjrQ1fboXkYeVlRVOvvkjoqL58+YDF6tlh1auLBbT8x6OiJBu8YJoLM/Ufi+9TjP5iLWQh6IOWC02u3JGWoYsq/riN7raixNZqzXI5RabHo/n64O4GIx57UPlSSNAYWCIcBcdoHGVQOlwkTVrxKHtnwMw5SeYDkysDm6UF3Knmh6vWRzdvyLufpyoLGIISaAVi0GCKd8hX0kZzPsmCskWe4lOmC5HWfQjPJlY4Eh8kcfji3RbLouBxbgb47oXZd43mfedJuJwppTi/1naxYzbvPsVlc8zuzaAVIPfQi4NobhWirEvlgQ0cWMLUTmPrphydXKWrOLdlrZYD6pkYmhoCCklR44c4dixYwwODlIsFjl37hx///d/z4kTJ7h8+TITExOsrq7e01LN//pf/yvHjh0jGo3S1dXFL/7iLza9fu3aNT7wgQ8Qi8Xo7+/nn//zf76h+rFN/HhhkzysE8vLy/zgBz+gXC5z/PhxBgYG0FpvWAfEWy34hUKBN954g/n5ed7znvfc1PRpIzUPAOPj47z55pts27aNwdhaz4quaLOaMbSoBhAkZS8pq/ly8xsW0EIhTbfVTEgiLXwsr3xOXmz+rI7RfN6Lqu4G+aNZgdJFaAmXJxPN87y8GDS9ZUE5XCm1Tz95OlwAhRCYQhA1wKgQCUGYylBtLgWlYcIdYlmH+oa4sbZ0FWCmPFr7d+M1pbVGFD9GzP2/kQ3xGUNIuo1Vhswycam44kYoaINsYFAI2ruIjhQyJEyP4TYeD92Gx067gCMCbBE2FauSiW+t9vMfc9vwkGvSE6ISgymrziS6EDQvNFEZ40JhiS6zVPnbbaTMetTiVuTh3Z62WM8xTNMkFosxNDTEo48+yvHjxzl27BgDAwMUi0W+8IUvsH37dmZmZvjGN77B9773vdtytr1dfO1rX+NDH/oQv/7rv87Jkyf5wQ9+wEsv1St/giDgAx/4AK7r8uqrr/LlL3+ZL33pS3zqU5/asDncKfQG/Hcv8bCSsp+4tMWdkgelFJcvX+bKlSvs3buXnTt3IoSo6Sc2ygP/ZvObmpri3LlzDA0NceDAgVuGUzeKPFTnMz4+XtNV9C+luJxvVu6nHZsb+frWM+fXF0jDSxNrWcvchvqFGysxMt3Ngr5yqVmvEGjNSt4kIXtZVeGxrZb0QCEoUa2D8JVAMEwcizz1H6NsEQUWpYGtunGNMCJRLK/w3fwOPrKlOQoAkJY+qsHfwVOKMs36BynA1wJfh5UaGs10kKAo6kZTjvTxfVEzcqrNRa1Nl2h1A6v4yzgs3lTfMO077LLrC4rSgkuFFAtehKj02RXNcv5GP08MTt1U33DVjTJklbAq+oaY8vlabpgLbl3r0koedKUM1w1u9hto/qyeCr8HX09iiTij+SwHI/VrwHnAaQut9T0nD9VjtP6WWxuo/dEf/REvvfQSv/Ebv8Hc3BwvvfQSi4uLfP7zn7/rlti+7/Nbv/Vb/PEf/zEf+chHas8fOnSo9u+XX36Zc+fO8e1vf5uBgQGOHj3KZz7zGT7xiU/w6U9/Gtu22w19X/BuTlt87Wtf46Mf/Sif/exnef/734/v+7VUN9RJ2ZYtW3j11VeZnp7mV3/1V7Esi89+9rP3bF4bgc3Iw22gUCjw5ptvMj09zbFjx5qqKao/+nvVzArqaZKRkREOHz7MoUOHbisP266r5nqxtLTEm2++CcCxY8dqgsx2oslYS1pi2S3WRHLl1SjRlqutqOqL6ZU5k2QLuZBtSiqTcRvD3Vp7bIhm8WuAItEQwciWBkkKq+U9LX02AheLupBCmB7fWd7ZNoIQlYqcCiMXy76xhjhUYQpNRCp8BDltUWTtzVW1+UtLNvs0pKInMQv/PULPdfwu80qyENgMW80umFJo9sSyPJu+we7YCqP5LlJ2iVP5XkaLKcqq+fiBDoWRO+xijTjM+TZ/tby7iTjAWvJQqhABN+h8XUqhW8RpBbbYcYpqHkceYF/MxqwIJKVIYhs390i51wt79Xd4L49RvW/c6hhSSh577DGWl5f5zGc+w+TkJKdOneLFF9s3XFsPTpw4weTkJFJKnnjiCQYHB3nxxRebFrnXXnuNxx9/vKlM9IUXXiCbzXL27Nm7nsPDiEZS9rGPfYz9+/dz6NAhfumXfqn2niop++u//muOHj3Kiy++yGc+8xm+8IUv4Lrto5PvFjz05KF1Z7Jen4epqSleffVVkskkzz//PKlUc5lidfx7RR5WVlZ49dVXKZVKHD9+vNZu+Py52FsAACAASURBVE7GWg+01ly+fJkf/vCH7Ny5E6CJsLQr14y0kAdPKeKRcNFcXDSxWnb8q0F9sRuZ1kRbLKoTybU+GdGoxeJCPWUixNrKmUy0Th7GV7qIt9yYPd0c7tVAsVgXVfqUWPDinCn0rRkbQCA5U+jBkl5b4gBhmiKrDALAbGOgFY6zFgkrR9YLPRSSzhc5tPXzREQJu7KoetqmrHw8HYT9O3wTjaDf7HyjmSzFmHNjPJWeY3/vIk8k5jkQzQKCsWKat1d7OV9IcbGUbtI3jJYT/NXybhaCtc6XnUjCzciDEKLJZTIqPfp8F6Elp3N5hu0CskI2OzXDasS9TlvcD/JQPcZ67amFEOzfv59t27bd9RwuX74MwKc//Wn+xb/4F3zjG9+gq6uL973vfSwuhtG4mZmZNf4S1cczM5273t4XvEvzFg87KXvoyUMrbjfy4HkeJ0+erO32H3300bY/cCHEHXkz3Gp+WmuuXLnCG2+8wdatW3nmmWeIRNo3COqEOyUP5XKZH/7wh1y/fp1nn32WHTt2ADSN1e+sJQ+tekio6wsmpjVGS8+IsEIj/OWuliGfbVH6r7FlAidiMjpeJwe6Tc+JRIOK8sRslFiLgtFVa3PFS6vNtfNpy+Q7yzvXvK+kJGXtkzKKjBX7uFrKUGrZhbtaMhvEECLMMhjomiagEe2Mo6SA87kfIQu/xpbIf25KLwghsISLI00sYbCqk3hIlgKTRd9sW3J2JtdNwvTZGV3bityRiv3RFXrMIl2mxzZ7lUkvwhU3xt/me/n32e2UdftFbY0ZVOXYN09bgKvrr0uh6U+UsPxdLAYltDuGW66YT7mP3pLkP0yRh9tJv2it11Vt8bu/+7uhydlN/jt//nztc/7/7L15kFxnff77OVvvy+xaRqPdlizLlm150wgDTvHDBTYJN8BN3VTATgoqOA5VgHHiWyEmgeJH2BJIFSQUVLApfrm5hMtNKoYLmBhiIsm2jD2j1dql0Yxmn57eu896/+jtnNOne7pnWsZY81Sp7J4+/Z5z+pw+7/N+l+f5i7/4C97znvewd+9evv3tbyMIAv/6r/+6/JN7rVBOWyz3X0VTPpVKOf4Vi6352TTCbzwpWwKr5MEDiUSCAwcOoGkab3rTm5Zc7XdSeEoURXRd51e/+hWXLl3ijjvuYNu2bcvK7S6HPMzPz3Pw4EEURWF4eJh4PO6pOzDgkbYQxPrZK1wudLg4pYNrsjQsi2iwFs4vFJyhfdWqX00rPpFjFwyUstOilz5E2FaYOTIDsuW8zVWrgHtKnE45iVmXIvFfixtRbaJHi0aYeUMjKBbpVTJcH5xlU2ARRTCZKnYznhlgVveTMmWHC6cggEL9/REU68lREI3b5f+ToHWs4TUvtU/6iYpp1skqQ0qRHlmnYIlc0f1c1vwsGjKvpNewM5Ig3iQqcTTbQ79SYI0vT0gy6JeLHC708IvcGpsjpscxGN457mKDIs0KLNy5qUkmiTCg+JH9CXyKBpbAxNgWnnvuOQ4fPszZs2eZn5+v+41d7ZqHyvhXm6BIktTSeRQKBUzTbFkk6tFHH+XkyZNN/23durUqamWvcfD7/WzdupWxsTEA1q5dy/S0M6VWed2uBP/rFUNDQ1UH23g8zuc+9znP7a4ZUrYE3tAFk1AvrSzLMqZpOsR4KjBNk3PnznHx4kWuu+46hxtnM6zUj8KOTCZDJpOp2oh7tWC2inbIg2VZnD17losXL9ZZd1d+EPax+j38LUyP9kN/OQpgmiAaPtyOk2G/QLo8/yu+PsjXOgBKnRPO1IUgC5iWQNjayCKn0aw84IyCBHy1a2YiklPDIDrls2OKREKrHe90SmEnCmb5+KKyyHnTx+H0OvbHJziZ3UCP/6KntLUkWKz1J8iIQSzRIGMq+F1kQcHEPYUPyovExCKqJZEyA8zpIe4KJpAFAcOSkDw0HHKmQtakrr4BSvUYQbGIZsGM7meDP8Vo2fVy0J9mbaAWcTEsOJLt49ZIreh1Ug3x/2bWMW0sHeEqGM7fRYVoFJukLQBE/IC9KDLCxcIiv9UVIyDeiMWLKNKt3HPre1BVjUQi4ZB7ruggdHd3t2UotRy8Fp0W7fpaAC1HHvr7++nv90692bF37178fj+nTp3iTW96E1CKvF68eLEaddy3bx+f/exnmZmZqS6mnnnmGWKxmIN0/DrQKYXJy5cvO9LSjWzSH330UR566KGmY27dupXJyZJi7FKkrFJTVsFvCil7w5MHN+wFjvbuiFwux+joKIZhcPfddxONtm6X3Im0hWmanDlzhkuXLqEoCnv27FnxqqpV8lCxHi4Wiw3Pvc5ZU47Ro4RZ0GqTvWbVh5klX+3ha2n15EGyRSMSWdkRC8sYedzkoRIyyCX7IH6aopkBBrBXEPhcd3WiEAaXKF/MLzvIg6xIhFhLhssARMoW4/9fYiuKlGNL8HzdudmhWwLThSgbo7P4BYMZfYC4XJuYJcG05VZN1koZQugIAvgEk4iosUFOIwuQLOdhLaOLsJzFJ0j4kJjWA3RJFv1NIgkpQ0JHYLBMLvp9tcjMRD7M1EIUKaZiCYKDOLyc6eOJsTvY2z/W9Dyh1MVhuoKWVjVt0ZzsqpaMferL6qVxBpRFcmYPAdHCEvYjCGKdRXY+n6+SiStXrqCqKpcuXSKfz9PT00M0Gu3oZP9akYd2HDWBjitMxmIxPvzhD/OpT32KoaEhNm3axBe/+EUA3ve+9wHw9re/nV27dvH+97+fL3zhC0xNTfHJT36SRx55pOEk+1qhU90WsVisrqbNC9cKKVsK1zx5sCyLiYkJTp48yeDgYEstkF5jriTyUCEupmmye/duTp8+3ZFwbCvkYXZ2liNHjtDf39/UOtw9VjTg53ptLc9zrvq3glk/qQly7TyKORm3nVRPb5SJRMmdYnLeAttvUjU1grJIXq/tV6+qVgZZFy+1QUZlH2m9RkpkV+HleDqAz00eZOcDW/YJGGof+ErkIVT+Gp5Pb+Botp+3dWncoJzlhp6jDmvuCs4VBtgaLak5CgKsUWZIGUrVvVMu1zxI6AxK6Wo3gx2K7ZJbFkyYBQ4nrmNXYBoRkxdyW3hrDPrES6yXC/hcY0zrCjHRINbAMXQwmMUMi4g+k3W+LGPFCPOan+O5br41fSMGIoYlIHkcmx3e/hXlwmFLbCrxXTCdBHNRX0QghCxkSRk+JKkHUbzF87NuhcYXXniBeDxONptlfHwc0zSJx+PVyEQ0Gl3R7+hqRzagPQXLiqPm1TimL37xi8iyzPvf/37y+Tx33XUXzz77bLW7SpIknn76aR5++GH27dtHOBzmwQcf5NOf/nTHj+WNgt90UrYUrjnyIIoigiBgGAaapnH8+HEWFha45ZZbWmKTjcZcLnm4cuUKx48fZ8OGDVx//fVkMpmOFV82Iw+VSMfY2Bi7du1icHDQc7sK3OkfQRAQzylgK4rP6vWhdNNWB5FKKoQlAbs0UcCmInl+WiPc7yIXAR8TmVq4XS2rVr58yuSBG0QsTLpkxUEeRBd5OJ3wsdtlRBiSnZOKKEMyHcPXW3pt7/zImn5Gsxt57tJW/mBfgtv8VwjYij9P53vZGnTKQAPEJK2q92BYImEKDEi5hhOr/cdoArrVx2m1n9Nq7b48rg0yrxURsVgnF9ko5xmS85gIbJALTdUtjyR72RpMEfGXvqu1So7/NXsdP0psru3XFJCk5uRB9yAP9rCxZSng0QUDoLniywFRZXswTNr0E5N0CtzM7tBNTfcPtQLD/v5+ent7q8WElcjEpUslvYyKCVV3d3e1S6FVvB4jD6FQ6KrUeSiKwpe+9CW+9KUvNdxm06ZN/OhHP+r4vlcMW9Hjsj9/lfBGJmVvePLQSChqYWGBs2fPEo1G2b9//4pY3nLSFrquc+LECWZnZ9mzZ081ZNXJ+olG5CGfzzMyMoJpmuzbt6+lAiyvsaS0xFZ/P+eLswAktTwlU6rad67a6iAujuvEtkLWdnqSUptMEjmL9XKEpF6jF7GAzIRNO6pQTo2k8xBlAynGiCoS2BooLFftxXRWZo+lYNgmtLCLPCBZXJ4NsK1MHvyu2gbV0jgzK1GwQrxUHGSvf46gmGVSjTLoT9IIsmAhCxZpQ2SNlMUSan4YlkW1m6Lkvln7XM4SyRfqW1XN8oPORGBCDzChBzhENzImG+QCG5UCQ3KefkmtjmdacDg5wO3x2WpUYU4L8BeX7uJEvscxvmGJKB6dIXZ42W7bw8Z5QyTSYD50a1sERY01foVj2RneEgswZ9yAT2ztt2hv1RQEgUgkQiQSYWhoCMuySKfTJBIJFhYWOH/+PKIoOsjEUhNxp3wtmqHdmodVU6x6vJ5dNX+jSdkSeMOTBzcqxZInTpxgx44dbNy4ccVMvt20RTKZZHR0lEAgwP79+x0tmJ1s+/Sa8Kenpzl27Bhr165l586dLT+43JEHgP7uMPnpKOe7SuRBswyiPoW0WluV28PU4zOwbTtO9yvXKrdP7CZpi01EXP4WWVuEQc2shchYnTmW4Vr1Zg2DgNZF1jdb/VtAdj0xRItTEyLbdpZe+lyh/4KlYhLCJ6ylYI1zTL2Hfl4gJBfrtrXDtEqtm71y6Zzsd5qGyLwWIiblCIsmVlm50rJg0ZSxpO668VKZXMU01AEdkYt6iItl6/EecQ2/uuLn7vgkfb489/Vdrm57PNPDX1y+k3m9MTlpBt2qZwZ2QS21ibOme5UXFDUkQaFoaWhWH92+3Uvuv7rPJpEBQRCqOexNmzZhmmaVTMzOznL27FlkWa4Sie7uboLBYMvjdwrtEJRKm+bVNgP7jcNKtRpWXTWXhWuKPGSz2Wptwa5duzoisAKtRwssy+LixYucPXuWrVu3snXr1roHQaUw0asbZDnHVSEPFTOtiYkJbrzxxmp71nLGqqC/O8Jzz53D9y6pmk7oCvgd5CFZrBXsaYaApCvYiyYN18Qb0p1RkIDi/A7SWi01MjYRZmAHhFxay6UWz1rhngWQi4GNPPhcc4IhmEwkTHxCBNXKlJUraxvljCIQwtD7QBpHE2T+9sq9bA/Mcn1whh3BGdb7Fh3Rg7ThwydonjUSUJLW7pJy+ASBedOPgEVEMJAFCwORohWi7snW4kRzZl7nmfnreGa+ZPI14MuxLzjDULbAPwsbkULex2R4EAM3PCMPNrXKprbcrls6IGqMF0vV5Vc0H78V27Pk/itop1VTFMVqC97mzZsxDINUKkUikWBycpJTp07h9/urjpbd3d2vu7TFauRhFa8nvOHJQ2XFPD4+zquvvsqGDRuwLKujWuytRB6KxSJHjx4lm81yxx130NVVbywFNUGaTnhlVNorK6QJStbhy3kAeUYeeiLkUzo7pfUc0ctdCn5ntf2imke0qSpYqgJKjTxoru4LIet3NFj4XV9BSisSFRRMC156Fe7fIdS1TxZd5AEgnwmD7St3Rws0dEDAZ65FFc4iCir2JX7B1JAEyOTj+COAlUezQpzMr+NkvkTEupNDbAme5n9se46IKIKVR/HQvqieix4gKIKJgVG21Vq0xCpfyJoKuBo8BS8lLg/kXOUnM2qI/0ztonBCJHjHPFKD1ITRQuShWcFk4/crWzm/D1GwSOoJ/EKMhB4kKtdHWxphJQqTkiRVIw5Q+r0tLi6SSCSqBdSKoiCKItPT03R3d18V/4Z20hardtzeeD17W7yR8YYnD6qqMjo6yuLiIrfeeit9fX288MILHasrgKVTDXNzcxw5coSenh6Gh4ebajdUHiSdcsM0TZNDhw5VO0mW+7D1ijz0dZejBKdF2Fr6X7e/Rd4yiYkyRjmurRVkx7xesJzkQUsrDvLgVbwXjfhJpoukchBhEFzkoWSO5XzIJlNB7A2okos8FMvGWWq+p9TWKRRx5weiAZnpZJiNETDJAb2O900hwv996no2D53DL/ZwIBHkvb2H6ZbyCEDE5qRZNBX6ZA2/aHC80EtYrne4THrcowVLw12u4QXTqv9pV66BZTYeQBKWfiTUF0xajnSH2sRZ06ugUxF1uuWtbAzuWHLfdnQyMiBJEr29vfT2lq6pruucOXOmWnx5/PhxwuFwlXB0dXWtSIOlgna7LVbJQwOsph5ec7zhycPU1BSWZbF///7qyqGTipDNxjNNk9OnT3P58mVuuOEGBgcHlwyzVh6GKyUPhmFw5swZAHbv3r1iwZFGNQ8A515M0L0jRELLIZj1Wg+xaIBEspS+MNMK9lk8axSws4lcSkAcEDArTwMP4alwyEcyXVpa65m1+ONOuem8WUQSSkJIFcwv+h3kQXCpXRbMEomZS0aIhbxlr8NBmQsLChsHQbfqJ3u/ImCYAn5hDbq1yKLRy9niAH1Kmu/P3cGNwQD/W8//g4JJXDJQBBPTEni10M/eSP14aSsPLkOtgqERaeFXK8n1RYd5TUNGgqbkYemJzJ22KIlZtZa2EAQwLQnRdl19goFqClwf8m7RbISrqTBZscg2DIPdu3ejaTXBqnPnzpHL5YhGo1Ui0dXVtaxIYbtpi1XysIrXC97w5GHjxo2sW7fO8ZDpNHkQRbHOAa2SKrAsq+WOBvBWc2wXmUyGkZGR6opmuS2odjSNPJgCm/V+ElyikK+fBCNhX5U86AkR1tfeS+kFSrdh6froQL/SxbSWKA9d3/IXCNTIxrlLPm7YXd/t0BWQmc/XCIJhScTEHlJmSVO+ZKhlIy2GCvi4OO3j5nVgWDncCPklTk4LvOUm0K0cIjiC/0q5CNMw+tDECURgRo3hFzVAYEaPM6eGEQT4r4mdyKJFb0+Wy2qcmy2xzl5co5485Ix8S+Qh49EpaZWHbxam1Q3JnfGp38ZVF2G47EebmWMBaJaM30YeuqQuUmaetf6NzXdsw2tlWlUZX1EUBgYGql1RxWKRRCLB4uIiZ86coVAoVMlEd3c38Xi8pYiCYRgtd3qtpi28sZq2+PXgDU8eKpOxHVc78mDXblhOqmC5x2cXvNq0aRObN2/m2Wef7UjLmReh6YoGkSUR3TBJHcvCjRDvikIy4dguEKjdZoWiwDolzqRWmvBVUyeoyOTLao+aYNKtx5mmNIbm4W8h24ooR88obNy6CMQd28QCioM8IINf7wOxRB5KYtG1WbLk8KlwYkLg5ltA8yAPAZ9IIi/gE7pQrUW6FZl5rbaPSoolk4/jC0NM9jGhdhFXctVzmch1kdN9zKbioMDlYBywUE0ZxZbWMC2h9NoVyClaKgISlodXhmM7w+OBWIk4NOGlWc0gtoQ6tehiF27r8maRB4CiKeC3/SREBIYCW5vv1IVKFOy18J3wglv9slAoVCMTJ0+eRFVVh2BVLBbzPNZ2Ui+rBZMNsNpt8WvBG548eKFdW+5WxjNNs6F2Q7tYjqFVZd9zc3NVwSt7p8VK4ZanLv1NoDsWZDaRZfakTuAmGcujRsFna7csWCZDxRiTYi1aEIv4yCfy5fcN5LQfykGNglmkbvWdrzlEJvMi0eAayDhTF6LhfG1KoKai1aJJgyL2ugjDsgj4ZNJ5g6DQR96aQ8LZVeove2aI5hoQFonLios8lL7n6UyIoTDEZIWxQojxYqkoTzVVzqTWMJ7pJpsNs7YriU4p5J8zfYRt5EGzJE/jLBDwi2EKZsrjvRo0j/RDZbHfrOZBb2EVJgnNQxPaEs6a7siFSG5ZKQtozY1yuWhnYg8EAqxbt45169ZhWZZDSnt8fBzDMOrULytdWu0UTPb19a3klFaxio7hmiUPnY48FItFDh48SDAYrNNuaBftkodUKsXIyAiBQIDh4eHqvisP1k6QB3fkoaJQ6ZdLfzNUi+3SmmrtgB2iLVKQ0Q2YEMDWJRsJykyXgxU5Q6MwLVTJQ9aoD92HY2GYqE20+Uwch0oUEI8EIFVrE1VNjSuXLcJl8qBZ3jUNBdVAMvpAnKPbJzNnazv1lefMfLEXIQAxRQC7qWdFOjuhMLQGopIECFwulorwCmaBg9NbuZTqY0hKsVFcoFBuB00aAfqVmhqWjkhA1BCw6twtFSFEgebkwW1cBVQjDs1EcVrRedBc5MMvydi5uCQ0D8ObrsiFT8ywaRnFknD1Iw/LqWMQBIFQKEQoFGJwcBDLssjlclUyMTY2hmVZdHV1kcvliEQiLbVmV7ZdhRsCNHGAbe3zq2gXb3jy0EhhUtO85XPbhWVZzM/Pk0wmuf7669myZctrJjplWRaXL1/m1KlTbNmypc66u2In3OnIQ6FQYGRkBF3X2TK0hvHZiwD4p/wkBuvD/ZZtYWVYkDmvOchDKFjbIK2qzF02q7LXWaOAJMQdxY9K0Dn5TEz5Ie6UtY4EFewzuyEJjI1L3FBWPi7o9bUZoYDMfLJIId8F4ZItt508SOVfy2wqykAAIi59CassWX1qTuBNQKgqXlVRhTQ5t7gOA4EZM4JfqdVdLBoRoGZUpVsSolDSQcibTvI0MVcgtkRHo2fqoDzpC00iD2YLOg8Fzck+FEHAHvvVzebkQRBCQC3yJIvdLXV52FG5F69m5MEwjI60ZwqCQDgcJhwOV1vFM5kMiUSCZDLJ2NgY4+PjDsEqL/XL1bRFA6ymLX4tuLoKKK9TyLLckchDsVjkpZdeYn5+nlAo5Cn6tBy0MuFrmsbIyAjnzp1j7969bN++3XPfnSIPlcjD7OwsBw4cIBKJsG/fPtYN1MQTxl9Kk3GlC6BmZlWBmRdZ46u51/lsFtrJYpHpizn8Yo0guCdp3VVYOHIaQqJz8lFcCpK6aDE5Bz6hFJUxBL2OOUvl41xIlR7QUZd5llhOyZyfK40Rcs3PZjnJMZsDRYgQ9Ji/pbKYVgo/ou08ZrWwIyKglRlXUKyv+dCXKEi0f96BcjQiIjWe3FvReci50hK6q8MmpzUfI+0iH0OBB5bcpxuVlMLrJW3RDgRBIBqNsnHjRgKBALt27WLPnj1Eo1FmZ2c5fPgwBw4c4NixY0xMTJBOpzFN86p1W5w+fZrf+Z3foa+vj1gsxpve9CZ+/vOfO7YZGxvj/vvvJxQKMTAwwGOPPdbR1O8qfvNwTZKHTqQtKpOoz+dj165dHX2ILTXhJ5NJDh48iGEY7N+/n56enobbdpI8zM7OMjIyws6dO9m9ezeSJNHfXQujZuZV+sVoXS9/0WXVHYgqrNdrpEOxpTV00yQY9jMg1pbWXa5IQ8FyXrvZpEVMdBZMSi5zrIJlAgJRq1aH0uVWoCq3b56+VPqv33XcVlkb4shk6WcTcJEiwyZ4JVsDdf4YAFJ1mSNQUGur2nk9imqb8HUak4d8fcalDl4qkJWIg9Vkcm8lbZHXndsYrqVbWm++lFNtFZaGFWRX5HeW3KcbV7NN076Pq+1tUUmNVJQvb731Vt785jeze/duwuEw09PT/O3f/i3bt29nZmaGV155hbGxpW3T28EDDzyArus8++yz/OpXv2LPnj088MADTE1NAaUIzP3334+qqhw8eJCnnnqKJ598kieeeKKjx7FsWB34t4q28YYnD43SFsslD6Zp8uqrrzIyMsL111/PzTffjN/v73jrp9d4FXnrF198kY0bN7J3794lw6qdIA+FQoGFhQUymQx33323w4HTTh4AuhIRugPOlW3OcKaI5JCEPGWbuGXn8YVjfoSEzVkz4qwfyRv1Kaduw0WgXCJQucrqOF8jLTGXoFW8q3QuY4ul/Um6M4qiGqVZez4HPqEHf51KpU05U+9G8dCokG2tDpmiH6s80ZpI5K3atawUFYY8yEMrEtJeKo++MqHQjMZPy5a8LVxju8nDUq2aim01L4s3Iortiy2tRF2yVbxW8tRuglIx8NqyZQu33XYbH//4x/nKV76CZVn813/9F1u3bmX79u388z//84r3Pzc3x5kzZ3j88ce5+eabue666/ibv/kbcrkcx44dA+CnP/0pJ06c4Lvf/S633HIL73jHO/jMZz7D1772tboW9V8LKq6aK/m3irbxhicPXlguechmszz//PMsLCywb98+NmzYUK0ruNqKlaqq8vLLL3Px4kVuv/32lmsrVkoe5ufnOXjwIJIksX79eqLRqOP9/h5nGHX+SIG430lo0i6rbtEnMnesVhthutMaooY5XyMXIcV5m2YNj/bNpDMXbLlEoHKmAYJFOlGTr4y6xpXK0o3zGRG/EKU/7jy3TKFW0KjlexBNJ7komrXzTOWjZX8M13EKtYl2LhvFZ9jbRWukS6+kLaT6MVoqavRIW6jF0vdc0BqHm93FmV7wsuS2o7hEt4VsI1WbfL+95P688FqZVr0evC2i0Sjvete7KBaLfPWrXyWRSPD3f//33HjjjSvef29vLzt27OA73/kO2WwWXdf5xje+wcDAAHv37gXg0KFD3HTTTaxZU/O1v++++0ilUhw/fnzFx7BSVFw1V/JvFe3jDV8wCfXqiMtp1ZyYmODEiROe2g2ddMKE+gk/kUgwOjpKPB5n//79bcniLpc8WJbFuXPnuHDhAjt37iSdTnuSlT5X5GH6fIa+253VfAm1gA8RoTwxGTLMX8zSq4SZ17Lorok+EPEjpmvn6HfpMSfVIpJrksvPyFAro0CnJMxUPR8gEvYzMWHSXxapCrtqGgRbm6liDdT5X/htEZDFVIxQaB67RHXBRh5enQBTn8chpwnIglkNkyb1OIN6Aa3MGRaNEBtYLB+/VN1eEXQ0m9y029baC54TfKXboknBZCs1DzouYuL6jLoEeZDKfh95Lcb4cYu5wCF6enqqao2tFCm+FmmLdtQfl4t2UiOZTIZIJEI0GuWd73xnR/YvCAI/+9nPePe7311tHx0YGODHP/5x1fdjamrKQRyA6utKamMV1x6uCfLgRjuRBy/9hEbjdcIJE2ppC8uyOH/+POfPn+f6669fln34cshDsVjkyJEj5PN57rrrLmKxGK+++qrnOL3xUNVGGkBAIFJ0pi1006Q7ECBXKK2idcFEQGCD2cM8F72SzwAAIABJREFUWQouIahwd5ipM7NQ7oyQXWmNgqHTrfhRtdrf8ymBmBQmZZS6KIpWvTdFOOTjzIUMA3eUGiCDrrvfstVJ6MUuFL/L/8JUgdK5pY01rIulIWN739Ko+GqfnoWh7jQoTvIQ9UnMljnGlBbiupxalZuY0yIQLKUs7BGAkKiStE/ILcxnmkdqQ6iSh8afa6XbYqnIw1Jpi8ru4/797L/nHhYXF1lYWODChQtks1kikQjd3d309PQQj8c92yXfCJEHy7KumkjU448/zuc///mm25w8eZIdO3bwyCOPMDAwwC9/+UuCwSDf+ta3eNe73sXhw4fbdt/9tWC126JlmKbJ2bNnmZmZqXuev/nNb25rrFXy0ATJZJLR0VGCwaBDP8FrPOhcgZUkSaiqyksvvUQ+n+fOO+8kHo8v/UEPtCt1vbCwwOjoKN3d3dx6663VB3ej1IwsS/TEQ8wv1tIQsbSCe3Eajfiq5CFvlsbxzSjQC4v5NA43LEUgNacxUCYDgkfhYTTsZ37RJrIgiwwYvaTIlvdRTx4CQZnpGYiJfSTN2bpuCMPW/ZBMR+kNLmA/kbyNPJyb9XP9YIG6yAImOhJThSChgI5bCFJTi9UxEoaCqddErmfUGKZVS1lUEBRVkkZt0pCVpScb0+unXdF+aNaqudS4llCX2vALflTbiTYzxgKwBAPTEtgd/d+RZZm+vr6q+JGqqiQSCRYWFjh16hTFYpFYLOaQfa60Df+mk4fK77IdY6xWdR4effRRHnrooabbbN26lWeffZann36aRCJBLFYK3X3961/nmWee4amnnuLxxx9n7dq1vPjii47PTk+XbNRX6pnTEay0buEaqXl4/vnn+f3f/30uXbpUJ/gnCELbqfdrgjy40xZLtWpWChPPnj3Ltm3blqwvsNtod4I8qKrK1NQU/f39jgl8OWg18mBZFhcuXODcuXPs2LGDoaGhOs2IRuP0dUcc5EGYNhz+FVBa9VOe2HNGKU0xfywLb4GCK21hlNMH/UIXKbJ19QuV8ezkwcBEmg9WswglZ80Y9tSFL1C6Nj61D+RZFFdHhm6bAKcW/PStUbGTmpKJVwQQeGXC4s4t84AzEhWQIGNCwVJQNaEuSiCJpo1QCOQLPnxlgasCfoqWguH6UFDSsDuXSy1ID6imWKd9I7RAHqwlIg+a4TTBAsgU9ZLjVW1P6KaELDb6jQmkja30+rfVvePz+VizZk01LF5RalxYWGBiYgLDMKqOlqZpdiza54Wr3W1ReQa1sg9VVdF1vWXy0N/f35KnTS5X+t26SZL9ubFv3z4++9nPMjMzU1XNfeaZZ4jFYuzataul41nFrx8f/vCHuf322/nhD39Y5/e0HFwT5MGNSo2C14OnErLP5XLccccddHV1NRjFOR6sXMnRNE3OnTvH3Nwc3d3d7NmzZ8UXuBXyoKoqR48eJZPJNIxyeMlTV9DfHeHUhZnaeGmdwWCUCZuMtM/mb5EsqgSAuXM5wvf6yJoqsiigV2y7y0WFgWQEwqB7+Fv4A84HroZF4qxZJQ+6ZRCSJXJ67dwlX+kzucUI9IHiimgUbUYS56ZFdt9QxE4eTCxkAXQL8rqIrtfrJZiGAWVp6HzeByHLMbFKkumIRmS1GnkAyBr+qt5EBYrL4MLe1eEFXRexXPeNZVGtObG81CfLEJZw1fRqAfW6K3RTbkIeoEe5t+l+KggGgwSDQdavX49lWWSzWRKJBJOTk+RyOX75y18uKa60XFztyEOFPLRyvNlsiXh3Wudh3759dHd38+CDD/LEE08QDAb55je/yYULF7j//vsBePvb386uXbt4//vfzxe+8AWmpqb45Cc/ySOPPNKyqdfVhGCV/q3k89cCzpw5w/e//322b9/ekfGu2W4LoC76YNdu2L9/f0vEAehIx0WhUODw4cNMT08zODhIOBzuWP1Eo0kfYHFxkYMHDyIIAsPDww3TI81ISMWau4JsUWPIdK6QZF/tVsuqGoIkICCwWSqFq2Ph2nK6UNZXWDhROu6ih5S04nPy3oKhM3Y8h8+mVBh36UNUdKSmrpT+LjWw5Qa4MG2C5XE9bdc4sRBA0J3fiWxLfaSzEdzNEm5ikFGdD99FI+hIW6S0AP985i50tfY3wbeEgJhXzYH9FmgSecBYIvLgUe/gdXeZVuN1iW6K3NX97qb78YIgCEQiEYaGhhgaGqKrq6sqrjQzM8Phw4c5ePAgJ06cYHJykkKhXrCsHbwWaQtJkn6t5KGvr48f//jHZDIZfuu3fovbb7+d//7v/+bf//3f2bNnD1B6Xj799NNIksS+ffv4gz/4Az7wgQ/w6U9/uqPHsmys6jy0hLvuuouzZ892bLxrNvIApWJIWZYxTZPTp09z+fJldu3axfr165dVmLhc8jAzM8PRo0cZGBjghhtu4OLFi+Tz+aU/2OJxeU36lmVx6dIlzpw5w3XXXcemTZuanrM79WOHu+MimSmwdlqpmlABuNWH4z1BFmdzhJJ+CEE0LLOQLpGEjF6acS8eSdN3d6icgnDuQ1Kcx5rTNEwD1on9XDImAYgFJCZrwY+qTPar5wzuuBkEUccegi/VNJSIhYnA2Fg9afFLpcgDwEwigtJrotq6NiRbN0XB7EJSCxi+2mQuuYo/U4azLmNejxAuM47LuS7+r/O3oxkK6YUg3WtL1ZmiCJomoyjeHUO6V7eDPa/b5DZV3RaZ7rGXcMysoGiKNC7t20JYjjV8txVUJt54PF4VWDIMg2QySSKRqLrLhkIhR2SinU6l1yLy0E6xZCAQuCpplNtvv52f/OQnTbfZtGkTP/rRjzq+71VcXRw5cqT6/x/5yEd49NFHmZqa4qabbqr7Ldx8881tjX1NkAf3pFiRtTUMg2w2y+joKADDw8PLZvbLade0k5Ybb7yR9evXV4+vU7oRXuRB0zSOHj1KKpVqOTXTNPLQ45zYU9kCsVcFuLv2t7zmXAWG4wEWZ3MULhhwI4RtaY2UWkSh1FK4QV/LKeEipZYE23V0PUPTRRURCCYjVZ4R8jkfzEa5RTCdsYiJfQho2E230lrJlruCZEJ0ECAAyWbjMJuJ44sXsSdV7DUN44t+egJOEhgOSY4OjXkzgKXXyNW0FmOdL8mvFob48fiNpXMWILUYrpIHAFVvTB4E6osiZKH2XTRr1VxKQ8Ir8uAFT2OuMm6OvKOlMZrBq1VTkiR6enqqiquaprG4uEgikeDChQscO3aMaDRaJRJdXV0NJ+NKWvNqk4d2HDU7mZJ5Q2G1YLIhbrnllrqF3x/90R9V/7/y3mrBZBsQRZHJyUkuXLjA0NAQ119//YoeFO0KT+VyOUZHRzFNs460dFI3wj3pJ5NJRkZGiEQiDA8Pt2z80yzy4E5bAAhpgz5/iLliqSArXXQaZvkipUl6cjSFtFvE769996lCkd7yJK2P+TA3mcT9PpLFWg7AFF2SyEWVLkEgOyZCuYYr6IpOqLZeAr/ahxnIYCcPOiaCZVXrBUwrjmiYmFLt2Hw+oWrgOZWPstnIYSccomhVycNsIcSAueA4hop5VgVZwY9Q9INcinIsGiF+cXEHz6Z2OrbLF6PAdPV1UZMJB/GE7pEykBBrZ99kYl/qN+COPJQ6U+vHUxtEKIpGgDvjb226j1bQysSuKIqjcLBYLFadLe2dHBWNiVgsVh3ztXLtbJc8rMIDq62aDXHhwoWrNvY1SR50Xa92VDTSbmgX7UQLpqamOHbsGOvXr2fHjh2e8rSdJg+WZTE2Nsbp06db6iBpNI4X3BLVAJF4iI2WyBwl0iBHgthbBuSyyIJWMNnk68E+z1tAJBYgkyxw7oUs4iaRroDsIA+ah/RzOOrj8pEcwq7SGH5XhLpgM3Can/BBf5K6dIhgoZcjHFfm/PiCJgUbeSiqtQ6MGS3KTnHG+XlbTcOcHkZ2iSrIivtJJZBMycTDlRSJyJXkmrpOibTqJGiedQ1l5DzqKU078WtyawlLTJYBwdWu3ODB6+nqCUTlPYjiykPvy0kp+P1+1q5dy9q1a7Esq9rJkUgkGB8fxzRNurq66O7urnY1vJ7SFp2qg1rFtYNNmzZV//+5555jeHi4rntP13UOHjzo2LYVXBPkwf6DW1xcrKYpbrzxxo4QB2gtWmAYBqdOneLKlSvs3r27YY90p9MWuq4zOjpKIpFg7969TY20GqF5zYNHqkcB40IayjYYbn8Ly8YWunMRdNcqOhzzk0kWyCUNdsprmHWZWBXM+u/HH5CZnynSnwmRjeQQXQTDfgynXtXZ3FNfV2KZRqmoAJjLhAgZSQq2n4komdXJ1xQkiqozchMMCFDmAToyfjGEfbbWzfqZPZ/1E6dmER4KiNUxKljMKhiaiKSUxvJKTVRQ0OsnJE03q/ERyctxs4wmthel48g77/FGmzciD/d0vbf5DlrEShUmBUEgFAoRCoUYHBysdnIsLCyQSCQ4f/48ACdOnKhGJoLBYEcn73bSFlfLUfMNgdXIQ0u49957mZycrLbbVpBMJrn33ntX0xaNYNcx2L59O1euXOnoqmKptEU2m2VkZARRFBkeHm4aguxk2kLTNGZmZojH4wwPDy+7tapZ5CHgV4iG/aSztRmvoOVRxoUqeUi6ah4Me9rhigDXO8f2R2phg/B8nFzE+Qt3kxGAufkMAgKZ0wbCbXDm5ARINans6WSaYLlYYjYRYFug/nqJ1OoJF7QwXUbC+b4rXZLM+qGvVvVguZw45xKATa1b9OiUyOec16So1YtP6aaJlo0hdZXkq00PglCBV1TCzvv0Jp2eWjP5STxIQYN8sWjWC6oVjF42hTrTJtbpYsZKJ0ckEmHjxo1kMhkOHz5MJBJhenqa06dP4/P5qvUSPT09K25TbDdtsUoeGmCVPLSERpoo8/Pzy7q3rgnyUCgUeOWVVxzaDTMzMx03s2o03pUrVzh+/HjLtRWdSFtYlsX4+DiTk5NEo1Fuv/32Fa/UmrV89ndHHOQh0h1n6vlxYm8KkdKKpDWVmOjDKFfzF22r8dljWaI7nCtpX6h2a04d0Qm/2XmrprX6NjzTMpGQMKZ9yBQRZMPxYNDl2g+ooMloSRnJNDFs10OwtVoaloxacHpmCC5hqWTGR9hWMhkMS5CqvZ8v+lBsOg6iUn9ds3nnJCTZohsVBPwSi6kQa8vkoaA3vj+8Vv0hwaYW0UyeegnfDLc0daNbIqfWP1qGAm9qOnY7eC0UJiVJYsuWLWzZsqXaybGwsMD4+PiKOzmg/bTFas1DA6wWTDbF7/7u7wKlZ/hDDz3kIL2GYXDkyBGGh4fbHveaIA+JRAKfz+dQa1yOOVYzeKUaDMPg5MmTTE9Ps2fPnrpwUTtjtQO7H0dFXOdqi03FI87JX7dKIsbblC5e0UqFfvFogIVkKVWQtS1/k5MFek1n3kKwFVBOvJpl9z3OVMuiWiCAXBU+ArDKSs/GQgCZNHJQAHudpkDVewIgOxUiGICM7fktiJaDcBTyPux/iERkFmxj5vN+wrb2iaLhzDdkNB/dNvIgyJajKBMgX3BOOpGAiFsHSpQFMvlafUazrgivjohCwUAuJy4EhNIpeQyx1F1nuYoxZVHE8LgtUrpzcN0SeWv37y4xeut4LdQf3eZ3jTo5zp8/Ty6Xa7mTw76P1cjDKq42Kto9lmURjUYJBmvPWp/Px913382HPvShtse9JsjD+vXr62oblmvL3QjuVEM6nWZ0dBRFUdi/f39DX4xWxmoH6XSakZER/H4/w8PDTE5OkkwmlzWWHY3kqSvmXZbm7KbIln0s4vNiVaQxEvZVyUNadU6ygYIrh+/olBCwEs7VuQn4ZQnVtgIPRHzoiwZGTkHIC4gB00keSiNV/z+3EEbq10Gu7TsYUSjatSGMENjqEfJqEWwKBqpr4sel46AJYRyhCMCPRcE2c+dcRmKaUa8vkTc05lMBKkF/scmk46nF4Lp0liUgeErrNSeZkuQ836CoOJQ5q8fg1pqwNhNVVqbtYIdpmm2v9Nsdv1lUoFEnx8LCAq+++iqqqhKPx6tkwt7JYd/Has3DyrGqMNkc3/72twHYvHkzn/jEJzp2H10T5MELV4M8VJwwKwI1mzdvZtu2bW2HV5ebtqjYhtv3264xVrNjcqctNE3jyJEjZDIZbrhuEyPnaoIkyWxptT394ym6fy9AQi0QsNlYJnIFh/OEOescW3c9UwsTprsxAnQD+2SXKxTxIZf+NiGj93hElmxzYz7fhWw42YWBiV1Ewki7bLtd3RKqptiDGQiutERC8+OONwUkKNg2k2QFM+9HDBbLr+uvV9AvM7coYRgCkmTh8zW+p2TRIxfv0nawTBC8hhAETFOoq+2oQHeJ0jbSlBJcj5Y90fsbHu9ycLXTFu1GNtrp5Kh0cyyn22IVHliteWgJn/rUp4CSKOGpU6cA2LFjR8sRcTeuWfKwlDlWuxBFsTqZzs/Pc+utt1adApczVjsTvmEYnDhxgpmZmbrW0061fbpJiFsvInPwjGP7ZKZAVJHQMjp7Emv5RXgSxaa0qJsm4ZifXKqsb3AuD9FaLF11BdDzZ9NItwgYtl+6rurgq60+Lak2QepXFKRBr8rA2uenE35i69KOd10LayQzgI5tGxc5MEQBKykhdJWO113TkNOVuona0DSQbBO8DJkFhdhg6bsIBHEHK0CwsBBIJ0N09WQxhcbXNJPzeBp6RB4aPTUNS0Bs8F5Wcw5UMLxTf4aNgBWNEHfGW/OyaBWvhXT0csf36uTIZDJVMnHhwgVEUUSSJMLhMLlcbslOjmw2S3d3d8P3V7GKpZBOp/mTP/kT/uVf/sVhyvZ7v/d7fO1rX2vbufma8Lbw+lF2OvKg6zqTk5Ooqsr+/fuXTRzaPbZMJsOhQ4fIZrPs37+/Lj3TKfJQiTxYlsXly5d58cUXGRoa4rbbbkNRFM92za7eUnh/4t8n2BCMIbpEmyJdtVTO9KtporZCnrzpnJR01WJnsNe1B+cEZ3eCNmZ9pXSJ+9xtK2pVU9ALztVlvuhMGaRTzs+LbpkDGUjV0h6CzxWdwUJLOFMyCm4CYpFP1c7dEutJT65cI5JKlb5T1cNptAJPgSa3qmST1ZY7amBHwVVroTW4t4q2uosu+baO6xOstFWzlfE7RU4EQSAajbJx40b27NnDPffcw0033YQkSWSzWV544QUOHjzIyZMnmZqaolj0SFvl86uRh1WsCB/84Ad54YUXePrpp1lcXGRxcZGnn36al156iT/+4z9ue7xrgjx4oVPkoeIRceXKFYLBILfffvuKW7jsE3UzTE5OcujQIfr7+7nzzjs96yo6SR4Mw+Do0aOcOXOG2267ja1bt1Yf4G6JaihJUANYhsW2CwHc8gKBaG1StUxYF6yNkXX1E2qWQP+CO8ft/H4s2RZ5SAbABMVVzed2nFZzru/MtQtdE5zFi34XYVFAtHVLCIrlJCyigJZwDiq5ogYqBlquVsRUaud0Xfsy6VlMlSYQUWp87+pettruyEMTiWq1SSunu9uiEYp6iYBYlsC9Pb/X0mfawWshHX21xhdFka6uLoLBIENDQ7z5zW9m586dKIrC5cuXOXDgAM8//3xVun5ubq5jCpOf/exnq63ijWTpx8bGuP/++wmFQgwMDPDYY4/VFZf/4he/4LbbbsPv97N9+3aefPLJFR/bciFQq3tY1r9f25G/tnj66af5p3/6J+677z5isRixWIz77ruPb37zm/zHf/xH2+OtkocVQNM0RkZGOH/+PENDQx3TnndL5LphGAbHjx/nxIkT7Nmzhx07djR80C3lqtkqCoUChmGQy+UYHh6mt9cZBfBSmfTbnDLHn5kkojtXtErI+brXlqtP5Jy1CMlMgeIri84duPLypr0OwJBgRkRxfYduAmNlnRO7pbjJgQiLtQ+ZslViOhUIAmrCdV6uCqxi0kkmZRcxUPwShk1BUhAsJPclK59rMlOaQCTZwmxAADQvESjPtIU3zCYEwU1MrAaP3ly5aKVQGCB3RSWRSHRMu6R0jK/ftEU7+5AkCUmS6O3tZfv27dxxxx3cc889bN26Fcuy+Ld/+ze2b9/OyMgI//mf/8nPfvazFZnmqarK+973Ph5++GHP9w3D4P7770dVVQ4ePMhTTz3Fk08+yRNPPFHdpmLXfe+99zIyMsJHP/pRPvjBDy5prrWKXy96e3s9UxOVwt52cU2Qh6uRtqhYWZumyf79+6sFUJ1AI8twKBVOvfDCC6RSKfbt27dksUsnIg/T09OMjIwANIxwREI+Ai6bbMlW4yAA5oiTEIh+5+0XLtZe5wwD0VbDYJoWhfE8/f7a6ss9R5o+Z6beuqIQcqVK3LYPxrzzteWKPJgyCEnnjtxB/VzCeR5+13GpGWfawm3LrYsWmbRzx373LVt+nc4Hy6RBQNe9VSY1j8iD4C6YbMInjSZRCcv1pTeqVC+UhaoG5WHy+TzHjh3jl7/8JaOjo4yNjZHJZFZEan+T0haN0Ci6oSgKAwMD7Nixg4985COMjIywdu1acrkcf/iHf0h3dzd/93d/t6x9/vVf/zUf+9jHuOmmmzzf/+lPf8qJEyf47ne/yy233MI73vEOPvOZz/C1r30NVS3pmfzjP/4jW7Zs4ctf/jI33HADf/qnf8p73/veZR/TilHReVjJv2sAn/zkJ/n4xz/O1NRU9W9TU1M89thj/OVf/mXb412zBZPL1XmoeGKcPXuW7du3s3nzZgRB6GgNRaPIQ8UTY3BwsGm0wT3WcslDxfVzfHycHTt2cOLEiYYPbEEQ6O+JcHmqFh0wXIeXu5hG2FYLyJuuu0+fL4CNl0S6AqTma6uscDzI+nSAWV+JhFgSjhW1JeLQcTBmfCibnRNUIKLg6CrNyNjzEparZsGSBayUy3vENMDmd6G5oxe6Djb/BtGKArUfbMgnYLfi1AWTZFJ2dm3oBtg16MuRBxORQi5MKJKhUJDw8jXzIg91wlBNCILRJPKgukWiBG/BCNWUUA0/92/8P1BEpU7++cKFC0iS5FBsbKed+Y0QeWhV52Hz5s0Ui0U+8YlP8N73vpezZ89etWM7dOgQN910E2vWrKn+7b777uPhhx/m+PHj3HrrrRw6dIi3ve1tjs/dd999fPSjH70qx7QkVrstWsI//MM/cPbsWTZu3MjGjRuBUorK7/czOzvLN77xjeq2L7/88pLjXTPkwa2QuJzJXlVVjh49SiaTqbOy7qSktCAIju4G0zQ5deoUExMTTT0xvLBc8lAoFBgdHUXTNPbt24csy5w4caKp4FR/t5M8qK56g8RslnU3dXElVyIEmmvZmp5YdJCLUNTvIA/+qJ/ZlxerVt+mAqKrtqzUk1B2xVwMoKtFCNRmWE00sQfcLER8WRE1XDpWy6NcJaQFyFE7Dskl4awbIlZBQAiUjtwdWcjlZEfHhazgIA+WCIYhoGZ9+COlN0S3TLRtrkjMBwlFMqia98SjWVL9fO4iC4ogUadEVTk/0fuxYFlCvQKlJXiLTVkiFHejiGVhKpf8s2mapFIpFhYWuHLlCqdOnSIYDFaJRFdXV1Mdh9dbq+bV3ofdkvu66667asc0NTXlIA5A9XVlxdpom1QqRT6fd4gQreL1g3e/+90dHe+aIQ9utEseFhYWGB0dpauri+Hh4boHW6e7NyoFivl8npGRESzLWtITo9E47ZKHhYUFRkZG6OvrY+/evciyXA1ZNluRuTsuskXV8do0LdYIPq6UJ+K8q83P7w+zPmIxkSm1RgYiru/YJ2EczcGdfhAFTF89ebBDTytEZJ1Z298Mn13FAQhICFPAttJLSykJSdlz+bl553V1ayBYooCZUJDWlc43oAikbPNytqCjLyooPVr5PLHrTpXGkEDNBqrkQXG3YtqKIBaTIQYBvYGzpluLAaiLPGhFE1+D4n1R8H4saIaImylIguhon61BYJf8P7x3QK1osKuri61bt6LrerWV8dy5c+Tz+apiY09PD/F43HHfvZHTFm5YlkUul6s6fbrx+OOP8/nPf77pGCdPnmTnzp1Nt/mNxWrkoSVUdB46hWuWPLSq81BRUDx//jw7duxgaGjI86HVSSdMKJGR+fl5zp07x9q1a9m5c+eyVkLtkAe7eZj7XCsPuab+Fq6Oi8VMvf9E2FbrlXKpTGaLOmvEMBNlXQU54Lw9M5kiki4QmbHIrBUw/QI4ZRrwBST0YuUYBbJXDNhYe78omIRsk6shgzIvUtxW+45kATTbaSpCCM0mvKDUkQewUgqUyYPlSodZEmhJf5U8WB4rflkWIV9To5Rcs70ii1Xli8VsiUA2Ig+aUP/3upqHJmkLrcHtormVu5ogJEjcENna8vayLNcpNlZSHMePH0fXdbq6uqoOl1ezGwJe24LJVtDM2+LRRx/loYceavr5rVtbuxZr167lxRdfdPxtenq6+l7lv5W/2beJxWK/lqjD61lh8vTp0zz22GMcOHAAVVW5+eab+cxnPsO999Z0T8bGxnj44Yf5+c9/TiQS4cEHH+Rzn/tcnXV2J7C4uMj3v/99zp07x2OPPUZPTw8vv/wya9asYXBwsK2xrhnysJy0RbFY5MiRI+Tzee666y5iscbyup1MW5imiWEYnD59mt27d7N+/fplj9UqedA0jaNHj5JKpbjzzjvrqnKX6gCB+o6LVFkoytBq37O0aFSNphayOeyL30Qyx6ZM7eEjuAoqFxbKEYmzRTJrgxCqf7gXCyqSUItYGCln9MLwgWWZCOUcgimA6Cp4NHUDpNpPo1CwkPICBEv3Tygss2iLHARCEn41jFEOJ0ii6TCJMCUwc0Eoe2CoHrbcummSz/qrXpqyK/KgWbUBk/kglgmWR22DYQiYHpGHABKOOFAT8pDTTbxM273IimGZtUING/b7B1YUGfD7/axbt45169ZVV94LCwssLCxw4cIFDMPg4sWL5PP5ql12J2EYxlV5eLv30Q55aBT6ncQAAAAgAElEQVR5sJOulWLfvn189rOfZWZmplqM/cwzzxCLxdi1a1d1mx/96EeOzz3zzDPs27evI8fQNl7HkYcHHniA6667jmeffZZgMMhXvvIVHnjggeqisNLdsnbtWg4ePMjk5CQf+MAHUBSF//k//2dHj+XIkSO87W1vIx6Pc/HiRT70oQ/R09PDD37wA8bGxvjOd77T1njXRLeFF5YiD3Nzcxw4cACfz8fw8HBT4tDKeK2iUCjw4osvYpomu3btWhFxgNbIQyqV4tChQ5imyfDwsGc7T2UiaBZ5aCYUVYGZ1gjL5TY+w0S2dWSomoGcsH2HrpR3vliadMMTpdeaAlYTESgAMeW6xUWh7mHhcxU8itRP3IKNYAjuFlEJFqdqn4lEnJNOIKKQXqidZyzsMWFIFvPztX1E3PLTElQO3LQksukAhkeVuJcdNzi7S0uvm7RqNqg+rxu7gbmWiMBvBwY7KrIUDocZGhqqiixJkkQwGGRycpLnn3+eQ4cOcerUKWZmZtC0JkIVLeJqRx4sy2p5H7quo6pqR0SixsbGGBkZYWxsDMMwGBkZYWRkhEymRGzf/va3s2vXLt7//vczOjrKT37yEz75yU/yyCOPVPVrPvzhD3P+/Hn+7M/+jFdffZWvf/3rfO973+NjH/vYio/vjYS5uTnOnDnD448/zs0338x1113H3/zN35DL5Th27BjQWndLp/Dxj3+chx56iDNnzjiKk9/5znfy3HPPtT3eNRN5cKMSKXAXAJqmydmzZ7l06RI33HADg4ODLa2gOkEeZmdnOXLkCAMDA+i6js+rlL5N2AWnvM6jYi+8ZcsWtm3b1rSbYimfDC+hqFA8wPxULbeQzRfpRyFbXppHuwIkZmrLeCGhQZm7aO70gFySVPanBMSCiRkQkSzLMdWbItj1k5SMWDJgEGvnJbgIkFGwkBIWRndpG6FOfApISrC+NHC+WABq16ZgmUiZGgExXeqPeV3Dl7HZ4HqoQwaDCrl0bRvJvY1rjkklw8S6XIUTgK57/6R13TXTN7PlbkAs6uy4TfBiD3t7BpEt4arVJFQm3A0bNhCJRNB1ncXFxWpU4tixY0Sj0WqKIx6Pt53yu9oFk5XfUSv7qEzsjSIP7eCJJ57gqaeeqr6+9dZbAfj5z3/OW9/6ViRJ4umnn+bhhx9m3759hMNhHnzwQT796U9XP7NlyxZ++MMf8rGPfYyvfvWrbNiwgW9961vcd999Kz6+ZaFDkYdUymVg5/evSPCvt7eXHTt28J3vfKcqqPWNb3yDgYEB9u7dC7TW3dIpHD582NFRUcHg4KCjfbNVXNPkAZzhyXw+z5EjR6odBu38WCuT9HJWLJZlcfbsWS5evMiuXbsYHBysRgJWCnu6wf6gstuFt+rDsRR56OuqXxkFwk4ClCuYxLJA+TcZcpEHiiZRn4+0qlJ0+VtYcslzW0AgNK6R2e7HJ4kUHNsITl9pQcA/a1BcU7vVJdG5iSVYKDMCRnflIy4Rp4BMoBggXw78Cy4FJ0O00HNKdSVuii4SKQloGV+148LwqHkoWgZC1l9t1/TLIh5mlVUk0yE29tWLBQl4E05Dd/KPZiJRcoNui7q0RYMxPrHrHuaOnr6qBY32bgtZlunr66vew3aHy5MnT6JpGvF4vGqpHYlEljy2qx15qCw0WtlHriyY1gny8OSTTy6pBrlp06a6tIQbb33rW3nllVdWfDydQKdqHoaGhhx//9SnPsVf/dVfLX9cQeBnP/sZ7373u4lGo4iiyMDAAD/+8Y+rokytdLd0Cn6/v44gQakuYzlpr2uGPLgfFpWJVNd1ZFlmZmaGo0ePsmbNGm644Ya2Vx2V7dt96BQKBY4cOUKxWOTuu+8mGi1lvTtVgFk5bzt5yOVyjIyMIAgCw8PDLeeLl1Kr7I6FkCQRw9aiKfqc32M6reIfN2Fb6dbzhZ0pA184wFBQ4IS6UNeNUSIPJQSvmGS2g67pYOt8sRQBis7PxBZh1vb7tEwDbNfXEi0CKYVCZVKXLMdKpmgY+OZrfxAUC1vnJoKvJDRjpRSEuEYw4Lz+hmBhGiJ6WkGJa3XmWVBKjSiWVG3XLKoF3DaigmBVJ/1kJoRqTdeNY7qtsKtvOF/6PIoqq8fSIFqquT0zPMjDmkCEHbF+Zq1TV408LEXS3Q6XuVyuSiYuXryIKIoOfQmv+//1Rh58Pt9Vr8G41nH58mVHerpR1KHV7pYdO3bwyCOPMDAwwC9/+UuCwSDf+ta3eNe73sXhw4dZt25dR49/Kfz2b/82n/70p/ne974HlOaGsbEx/vzP/5z3vOc9bY93zd6NFbtqTdO4cOEC4+Pj3HjjjcuuMfCKZCyF+fl5RkdH6e3t5bbbbnN8rlMFmO5Cx5mZGY4cOcL69evZuXNnWw/IpSIPoijQ1xVmer6WpkjnnKF1ywLmVKTrFAzTQg64JiRFpEstHVPG5W9hKjbyMFOazC3dcJAHOeKDjNNbIpwSHe2abitqSxLwZX1UdA8E0XIWPMogqn7McmuH4LbM9pUmSSkfwIxrFHVnF0lF1VJPBRqSh0rto5UNQUQtFV26NxNqpCaZD6FTTy5z9Q0u1Y/aIXn6cZegtZi2UEQJzXAO/IEtpTDr1dRhqBDYVshJpV4iHA6zYcMGTNMknU6zsLDA9PQ0p0+fxu/3V6MSXV1d+Hy+10SESpKkls4hm80SDoevaiTnNxorVYksf7bi97AUWu1uefbZZ3n66adJJBLVcb/+9a/zzDPP8NRTT/H444+31N3SKXz5y1/mve99L/39/eTzed7ylrcwNTVVLZJtF9cseYDSBD06OoooigwPD6+oIKlSE9Bq++e5c+e4cOECO3fuZMOGDXUPhk4aWkGJ1Jw6dYqxsTF27969LNbbik9Gf7eTPKge34c/5GNLPM7ZxGIpUmCDLoA8r0EIkoWCoxsDSayKQAUSIqJuYbnqInTRpeMASFM69lvdH/Hh4DSKgDZTGycUlSnYbDSEoEhxvGYyHYzKsFB7X8UkiIiQ8QNpfC6hxMqCXSyEgTSibCFYFpbtmlccR9MJhcAakCWzLm0h2Go9NUOmqNanKAq6t8aD4KpN0AzLXY9a27zBg9h0SVPLkgi266uIEr+/+RaApmJiK0Xld7GcyV0UReLxOPF4nC1btqDrOslkshqVyGQyRKNRCoUC2Wy2rY6IdtBOq2mnTLHesHiNuy1a7W6ppJvc19n+bG+lu6VTiMfjPPPMMxw4cIDR0VEymQy33XZbnVpoq7hmyIP7QTY1NYWu64TDYfbs2bPiVYYgCC1N+KqqMjo6umT7Z6fIQ+W8R0dH0XW97VoO91hLHVNd0aRSP8HJQZk+Q+EsoLvqB/KajnYhAzdCXteJySKGXttnhTwICATH9boFR1EwcQcbzZyBb0FA7SmnqnCqTCoRH2R1lKSAFvcgJBJgisg5GT2ko4rudEqpkDM1ZRHeDqLLedOSSsedmhXpL4sDyphoNpojlws6TTUCzCLJpiP9AtSFD6xCFDc8tR88LpmqtU8egpIzvK+77oW3rd3mSJNdzbQFLI88uCHLMr29vVWjN1VVWVhYqCq6jo2NVY2Denp6iEajHTmvdts0VyMPv3nYt28f3d3dPPjggzzxxBMEg0G++c1vVo3FwNnd8oUvfIGpqam67pZOwDRNnnzySX7wgx9w8eJFBEFgy5Yt1dTecu6ta65Vs+JIeezYMfx+P0NDQx0LTy7VcbGwsMCBAwdQFGXJ9s9OtX4mEgmgZLazEuIAS0ceLMtCFpyphqSHUJQliUhTpaKBouU8x3ReJXFyDrl8TUR3mt12qYJXjDr6a/nEOtMnS4DgVG0/7loKtTy7+mdKPyDNpbFgiqVzM+ZKrwVf/XdgiaClSgeje3RKCAJkbdbcbonrYvlapxZLZEvystz+/9l78/i47vre+3222bQvtizbsi1vsrzEm2xHviwhhKQlJSxNHspTtoY83FDoLUuBXOACCU1voU0hXPoqvQ88DTzh8pSHFu5Dw9M2kFIIMUmIJUvebUW2bNlaR6NtljNnuX+MztE5Z86MZqSR7CB9Xq+8Ys3MWebMOb/f5/ddPh/P8z0QVUir7guUVZcAviHdfAVmWRLUM0jq7tdlR92EADy087bZQy5B5GEx9h8IBFizZg2KorBr1y4OHz7MqlWrmJycpLOzk1/84hd0d3fT399PPB6ft7lXqQSiVrBAO+4FFlvmQ319Pf/8z//M1NQUt99+O21tbTz77LP8z//5P9m7dy+A3d0iSRLt7e28853v5N3vfreru2WhME2Te+65hwceeID+/n727NnDrl27uHz5Mu9973t561vfOq/9LpvIA2Ranpxpis7OzpKrQvrtz6ncuH37djZs2DDnwLfQyINpmly+fJkLFy4giiLbtm1bcMFVvnNSVZWuri5E011tNz6VpMITPUjpJmrXMNwaJu6paxgbT6CkdNaVlXN5cgJVVREct6mZabgAIDxoEm8Er5Iz3oJISSA0bDBu/e25DLZB1xCwDVSfNgdThIgWZppJdFnHK3JgipCeccYUfGoaBFlAnZiNwiiC6e4SmTnd6GjmM7K3roJsfYnxqTJUVUEJzN5zvjoPPj+Z4nUtc33c/96cTLvvbc3xmx6oWUuVI19zs6YtijmGLMtEIhEikYhdLzE1NZVVL2FFJWpqagpury42bVEKjYffWNzEIlFtbW1zWpUX0t2yEDzxxBP8/Oc/56c//alL2RLgmWee4S1veQvf/va3efe7313UfpdN5GFoaIhjx45RX1/PkSNHiEQii+ZH4YSqqhw/fpwrV65w+PBhNm7cWNCgupBuC03T6Ozs5NKlSxw6dAhFURZkf2zBq9JpwRKZEkWRQ/t2Zb1f5RGKiic1pq5OsKoswnjKHZtPazrlNRFWzSQfdM/M51xEh6ICwTKf4LtnVW+KEIw6tDw8m6hCRgdDsqy3lezvGAhJGNb7Ioie62CIYKoyZkJCkLNHMw0T0xAhnvleioeEmTPpm7SqkE7ISHL2bx+R3KxnLBHJMsfyjTz4FECqedpAc6UtUp6CyeQMmRCAT+2eHZRKmVbww2KbYoF/t4UoilRWVrJp0yYOHDjAa17zGlpaWlAUhcuXL/Pss8/ywgsvcPHiRUZHR/M+v/NJW6xgBfPBd7/7XT71qU9lEQeA22+/nYceeojvfOc7Re932UQeKioq2Ldvn6vQZb623Lng7ZCIxWJ0dnZSWVnpa6Y1177mo5Q3OTlJR0cH4XCYo0ePEggESlp86d1Pf38/p0+fZvPmzWzevJlodDqrXbO8Okx0cMpxjmmCskhTMMKJsVGqcEfkK1eVI44bIGbaKJ1NBYGyAGYs85uJhoDeH4dKtyKm29ZqppsiLhBKCiRDJqanlTJTiWgixzMdF5KPAqSBSXxodk0ug1vueWaT9JhCIKwTFE1SjklbmqlpiA9LRDb6+GM4DhmPhSivj+NFUkvjFKdSdYVUyn1PeTsiZk4+C17FSdd7OSIPmp/VN7C5vJYtFXWzh1vEtIK1/xtBHryQJCmrXsJqCT137hypVMrWl6ipqbF7/a39F+uouYIcWGjq4TfcGKurq4svfelLOd//7d/+bb761a8Wvd9lQx4ikciiO2Fa+3OmDLZt21ZwtMGJ+Uz41kS+adMmtm7d6jK1KlXxpbWqNAyDs2fPcv36dZfIVF1dOXu3NnL8XL+9XTDiDuWaJtStrSY0bqCbJhVVQabGZyMQoaow4+djsAPkoACOeVSQ3fqPwahBPKt0xF+ZMjJskmwCwy+yLJiYqkgwLqJK2YRSNQyUWCCTIhFBNPSM2tQMpIAACZAnQrA2iaBpIM4eSMNARkSNBYhsjFMWklwFkYKj62Q6FqaqcQpbMcr+UPZpxxPuoiq/yENIlLMTMXnkqcUck1qWwuTM/z+y41Xu14topZwPFttRc75ib4FAgIaGBhoaGjBNk0QiYZOJvr4+ANvcK5lMFvwdViIPc+AmTlvcDIhGo1lCVE40NDTYtXHFYNmQBz8sRtpCVVU6OzsZHx+nra3NVhKbz74KPTfDMDhz5gwDAwNZ0RVrX6WMPCSTSTo7OzEMg/b29qxV0eEd61zkQQxmT0bl9eVMXYjBZiirCbvIgxwJEH2uD7bXktI1QjgnYXeuLRhzcQvAvYoHS1xKpzIK0SbQArNdG/Z+yhTUuIFwzcDcKmDLQdr7NDFTIgzIsFZDFN3XUxQzRt7xIZHyHSB5R6SZc0qNB2c+71HPdEYexjNdDQHTRHVOMFL2KBebck8qae+XB1JJPat9NZ+3hSzlUJjMynIK1BFk7ZRBLBCjsrLSVVS7mN0Wi13vAAtLuwiCYNdLrFu3DtM0bX2J4eFhYrEYgiBw5swZu2YiV73ESs3DHFghD3kxl/bQfCPwy4Y8+A1khdpyFwrDMOjp6aG6utpOGcwXhU74llokkFMtspSRh6mpKc6dO8eqVavYuXOnb+h1X3MDQUUiNZMTN8Xsax8sD3LpuasEt68hVO6OCKmGDmmTwGgqU5/gWKEnNR0nVQlPyIxpOsiz5xGqDJJ2WHWbSoY86JdTsDcIooCEJ5o/c45SNBOlkEUBzTGoRMoCpOMaXFdgrUYkLLsEmaSQhIZmF01KQnbdBUBqMnNPpDUVmP2tdMG0CY0+nemIkU0D1TFh+4lCRqfd3TNpn9SC144bvF/eDa/wkwW/yMO9Da3E43H6+/sxDIOamhq7i+iVmrZYjIJMQRBsEaJNmzZx4cIF4vE4iqJw5coVTp8+TVlZmZ3iqK6utgf8eDxuK8+uYAXFwjRN3vve9+Zs/UylvD3hhWHZkAc/lCryYJomV65cIRaL2WqRCx04C1GYtIy01qxZQ2tra87BrhTkwTRNkskk0WiU1tZWmpqacn7HbXua2Lm+no7ejFKan1CUIYmYmsGmyioU1U0eBgcyCk3BYZV0hfsWzRABh/y1JhAY11DrZmdWTcgQAHsbMZNuUeIiUtxAj4gZN05HH2g8pSIjEUmFmSaOmdbBwdat5gRzOIBAAsUTBUjP9ChoMx0Vsmi4VjTWnJ6cMb/ykguEmeiFAdFo5riiYboUr0IhCXXSvdm0Vu36WxZ8Bgi/moc8inzJHM+EIMiu71QhBXjwwKvtdJbViTAykulpff755+1VdW1tbVE1P/mw2GmLpejmME2TSCTC1q1bAUin03aK4/z586RSKXRd5yc/+QmxWKwkltuPPvooTz31FJ2dnQQCAWKxmOv9EydO8Od//uc8++yzjIyMsGnTJh588EH++I//2PW5n/3sZ3z0ox/l1KlTNDU18ZnPfGZOxcXFRKm8LX5T8Z73vGfOzxTbaQEr5GHBtqeapnHy5EnGxsaor6+nsrKyJANbvrSF00irEEnthZIH6zsmEgk2bNjAhg0b8n5ekkR2rqmxycN0yscIaiYqUaeKGAH39YqNJwgBwdE0qXpPvYQi4ZVeDI6mUeucrpUGoqdAwMRERCB8XWNqSyCra8ReVI/P6EtguMSfdSVTcmCMKci6gJpScT4+CUMjgoipSRiTEpJDShpm0xKmLmHEA4hS9u9hmAYCIrohY8RDyJ6qRr9ayMl0GE2TkGe6MyZVI1ti0++nz2fJnUvnwcBVd7GjbLV9rwuCQEVFBRUVFaxevZpjx47R0tJiKzeeOnXKdrqsra2lqqpq3pPzUkQeLNG3xTyGMzKpKAqrV6+2VQYTiQSdnZ2cO3eO559/nh/96EecOnWKO+64gze+8Y1s2bKl6GOqqsp9991He3s73/zmN7Pef+mll1i9ejVPPvkkTU1NPPfcc7z//e9HkiQ+9KEPAdgCRw8++CDf+c53+OlPf8oDDzxAY2PjjXPVXEFe/N3f/d2i7HfZk4eFRB68nQ09PT0lS4Pkijw4FSqdRlr5sBDyMD09TUdHB4FAgLq6OpcPfD60rKmlLBRgOqkyPp0tFDU+mXnNvBpH3+6ueLQ8LIJjBnrYPROaipilIRCIuslJSksT9rpLziwvykZgaguEwxIJB280ZSAF2oSJkIJQRHYZRCV0LZMuMUWU4QBpIXfNgh5VMjURhv/7iaiM5EMeTGF2FTQ1FkL2zPopwy2zDaBpApPjFdTUZVaRWhZzwJcoFNttYZqge0jxHY1b/befqUlwdiI4nS5PnTqFpmkufYRiFBSXouZhsbs55tJ5CIfDtLe384Mf/IC3ve1tdlHyj370I6LRKJ/73OeKPubDDz8MkNNV8/7773f9vXnzZo4dO8Y//uM/2uTh61//Os3NzTz22GMAtLa28uyzz/LlL395hTwsMywb8uA3MM23UMQ0Ta5evcrZs2dpbm5my5aMLG8pCzD9Jnyr9bOqqoqjR48WLPpUiKy0HwYHB+nu7qapqYlt27bR3d1d8H72vaaFrS+e58TVEWKTCcolEcPRvjkyOoUiCUQ7BwltcxeDmUEFEwhOgREQ3XJMgpBV7Fiblhl1bq9kD8qWuFT5pMwgkIynQJ4lQlJYgemM3bcyArIsuHoxndpL6T4RocbE6axtOH4KLaYQLBNcARIneVBjAYJ1PveJIyMzGQ0iB711E9nXPpnSGR6P2ORB90pykiMsmyfyoPu8pWkS3naP2zdu9t3eTyDK63Q5PT1NNBpldHSUnp4eZFm2oxL5igdh8dMWxQg4LeQYhbZqJhIJWlpaeN/73scnPvGJRT0vL8bHx6mtrbX/PnbsWJYXwl133cWHP/zhJT0vF1YKJm8Ilg15gGyRo/lM9pqmcfr0aUZGRjhw4IC9srL2t9A0iAUneTBNk76+Ps6fPz+v1s9iIw+maXLhwgUuX77Mnj17bHe3QoyxLFTWlLFOkjkx83dVXYSxoVmtB8MwqW2sZvTqGFXeSkBRwMRANEWUWBpRUFw5esFT7ZiIJpBjAbTqTOrCCPqQh5nrZY7oiEm3zDXgMuiqTIaZSqaAWXJhKLOaksZwAGFVwr2940nSYwpl9QI4zLecHZTmdBh51UTWOTpn+enxMHKDx53TZz4zERhNzpaQpoXsRzqsKHhjP0Kemge/t9Kat4UFagP+2gNzqUsKgkB5eTnl5eVs2LABXdcZHx9nbGzMLh4sLy93pTicE+1SpC2WQkeiGJGohcjKzxfPPfccf//3f89TTz1lvzYwMJDV9tfQ0MDExASJRMK3YHuxsVLzcGOwrMiDF8WSh6mpKTo7O21vCm8Iv5SRB2tfzpqK+bZ+FkMerLRIMpnM8sIoNoKxqa6CNZNTDESnqKgOu8gDQEV9GaNXxwj5FPuaMzWP4dE0hiFmivVmoOs6stNSWhYJDaeYmiEPelDKEooKVwRIxzQEIHxdw5Tcg4YqzhpFmUMmRqXndxQFBDJJf2NcQcRNHgx5tv0zPRFAJze5SI0pRJr9JbAtTE+EqFzjmfJ9WjURBKKp2chN0hSy9SB8vS3ykYfsiVPzkAdREJByTLDFRgYkSbKJwpYtW1xiS2fOnCGdTttiS7W1tUtml72YKJWr5kMPPcQXv/jFvNufOXOGHTt2FHV+J0+e5M1vfjOf+9znuPPOO4vadgXLAyvkocDJ3hJg2rhxI1u3bvV98BciKZ1rX8eOHSMYDHL06NF5u6wVSh7Gx8fp6OigqqqK9vb2rLRIMZEHgLbbd/H8/3mdASBYlh2GFmYiBOZoIuu9YGUIbVylJiUxgeYiD6GKINqU4/vIMtVJEZuaSELG38LxG03HUwRm6gHCgwZmcxjVUWyui7OTvz5sQg1ZltimaSAIEiBijkm4bCnFmUnbBG0qQNpwRxacaYupcYU6H/8Lp4xCfCpEjbfSUQKvpwbAqBqZOT+r08SNRFJD8HhoGnluU787xfQaguQoqsx8dmG+Fl6xpXg8TjQaZWxsjEuXLgGZNuvr169TW1tbUvdBuLkiD9b3zxV5+NjHPjZnp8Pmzf7ppVw4ffo0r3/963n/+9/PZz7zGdd7a9asYXBw0PXa4OAglZWVNyTqYGMlerDkWNbkoRCdB13XOXPmDIODg74CTE4U0l5ZKEZHR0mn0zQ1NeUkK4WiEPJw9epVzpw5w5YtW2hubvYd/IuNPDTvWsfU8SuU7W5ADGQPlMkZU6yrv7qMWR1BcLZOxpMEENEuT2NsCLnkidKGpx9AluBqHPaUO14ScMoVBCqCMJphA6FRmN7uo/shiei6iTAtgZjdISLKIpYJqDkmw2r3+1bBo6mJmEmPJoLjSTM0GTOdoy7D+rcpkk4q4JwzRPy4A6qmMD0VIhTSs98EZES8d7nhV9jgOE6WuKXoJn9iHnJQyoJGQRAoKyujrKyMpqYmDMPg/PnzxGIx+vv7OXPmDGVlZXbxpVMfYb5YqoLJUnhbrFq1qiRtnBZOnTrF7bffznve8x4effTRrPfb29uzTJyefvpp2tvbS3YORWOl5uGGYFmRh2JrHqanp+ns7ESSpJwCTE6UIm1hyT5fu3YNgO3bty9of5A/YmAYBqdPn2ZwcDCrhsNvP8V8P0EQ2H14C2XKrE6CE0o4MyDqAykoC4BDidKURUiDMp1Z8TuhahpB560rCAgTGmJCwwhnXpcCInpq9jvrkmD3IQSmJCbSGnhW45qaRpBkBFNETJDV8qgEZdT4jPBVLJBNHhwFj0ZcynrPJNOKCaBPZT96ouyekMVU2E0emCEn3nlbE4iOl7NKmsIPzuswe0K+H7WOgmlICA5b8LSnT7RGye21sJgFjaIoEgwGqaysZOfOnb76CM4UR0VFRdHnslQFk4Ueo1Ty1H19fbZUtq7rtrjc1q1bKS8v5+TJk9x+++3cddddfPSjH2VgYADIjGsWQXnwwQf52te+xic+8Qnuv/9+nnnmGb73ve+56iJWsDywrMiDF/m6La5fv87Jkydpampi+/btBT3oCyUPVm+3aZocPHiQ559/viTWxqIo+ppsOY9XCDnKtZ98OHj7Tl780x9Sfmdr1nux8YywtACIE63JCLkAACAASURBVCnMVbPhZ6UyBIkkIgLytA4O7ytTyv4tBEkgNJQivjFzSyenEojKbE2Kapq2nqNggjCsYXpEi0xhtk5CnBbB45khBBw+G0kxayIXldkOizI9kq234NCukrRw1vI+EJbQxmdn9diYCB4uJwjeag5AE4inq0ils820YEZpO+tVwavA7d6lLuAMFpnOdhITHmp9vf+GLDxtMReckQ2vPkI8Hs/yk7DaQWtrawsKrd9MaQtd10kmkyUhD5/97Gf51re+Zf+9f/9+AP7t3/6N2267je9///sMDw/z5JNP8uSTT9qf27hxo50uam5u5qmnnuIjH/kIjz/+OOvXr+cb3/jGDW3TXCmYvDFY9uTBa4LjXPnv3bvXHpQKwUL0FEZGRjhx4gQNDQ20trbaJKQUxVt+5zU6OsqJEydYvXo1ra2tBR2jmLSFaWZsrne1b2H6+jhrfQr0RkankU0TURBQJlVUR/RVZbbXQZ7S0Z3kQc7elxSUqY6b9tzuPZwpu/UhAuMmyXr3Z8SgaLdfitNCFnnQHE6YgiCgpATU0OxrhqYjzTCG8SEdGr3kZHag0qZCyAEDzdFpkpGlmp201LiCqx8U/0oDUxcY08uo93ZEzO44x+sCiP4jp+4JFU0kZnfSFKnl1aty59EXmzzki2w4/SQMw7D9JAYGBjh//jyhUMiOStTU1PimOG4GnQcL09OZlp1SdFs88cQTOTUeAD7/+c/z+c9/fs793HbbbXR0dCz4fEqGlbTFDcGyIg/eAceaMK0H2fKJEASBo0ePFm2DO5/Ig2ma9PT00NvbS2trK+vXr7dft86tlOTBNE0uXbrExYsX2bFjB01NTUXtp5CCSdM0bXfRSEWI1kObGfl1H4Igkr25AUhIntC64fCqUOKmK2dvKFnOFGhpHf3SJLRmBlm/tkZZFrB+nkDMJFHv1osQgxLGzFwtTGfvIKnrrkRHOC2ihmbPzHlMY9rnN3OkNcZHROS1hkvUKanpBBzkQU/KeMmD70hnCPSnAuwUcgh45eis8I9IzBzbowOhzpAJAYEv7P7tHFvN7PcmEXESRZGqqiqqqqpobm5G0zRisRjRaJSenh4SiQSVlZXU1NRQV1dnW2YvNnmwFiyFPNfxeIYOrxhj5cZK5OHGYFmRBy+c5CEajdLd3c26detoaWmZ1+BRLHlQVZWuri7i8ThHjhyxDYWc51ZKN0xN0+ju7mZ8fJzDhw9TVVU198YOFBJ5sAZGawAWBIG9r9nOd774Y9bvWMOgHEB1TFlKWEFPGkimgDAex6ya6RwIKhgzUQnJI51h+pAHUxQITOiIuokhCb7kIa2mEaXM9B+cFJENdy2G0zdDTmY/GrpgojjOXR9VoWJ2AgiWKeipzPbphAy64bLtdp5TPKagNKZc+gteN21RFzNpEMepKA4CZCGsBIgaQWI+0hEAXhuN2QO6PUBcb3lqHCxTrFsq17GzKre9LyxN2mI+hFqWZerr6237eMurJRqNuoy9LPKzWN/DeoYKJQ+KopS8o2QFK1goljV5sCa38+fPMzQ0xO7du21BpPnur9DJ3mqLrKyspL29Pcs0SBCEeStD+p2XqqocO3aMUCg0b8fPuSIPVsTBSRwAfutdr+Lfv/c8V85cR0+lYP0qWJNRrUupaeSZ1XcomSZh8RlRwBQyrQWSKSIbJprlzhmQMElndVyIKZ3AYILk2kimu8FTzhIoC6AlZ+yiEZDG0uh1DrtvYbZMQTAE5EkdrcJZxOnen+TRpxCCDiErU0JO6mjOBaNjPtbTMgFDc9VFeN20DVFAGhfR62bvgUBAIplw/waalhHBGpr2lyo3TcE3wiAhYubIafiRB8kQeWTPb/l+3r3t4htXlWL/oVCItWvXsnbtWpdl9rVr10gmkxw7dsyV4iiVsZe1wCg0bRGJRBb1er7isZK2uCFY3MTeTY5EIqMvMD4+Tnt7+4KIA8xGHuaaYPv6+njhhRfYuHEj+/fvzzkolUo3YnJyklgsxurVq2lra5u3VXguMmNFGzRNyyIOAJGKEI//7NO8/t425EAA6dJ16B/ObOtYmYuT7tneKgcQAHNktpPAlEQE7xM/k+YI92fW8oZPXQSy+3YPTLqvbcrT0BgY9xhTeciDmHYfI+Epvg0kPOZcnqdtesLzvs9CVJpwb2T4jHSqljnvgXQOn5Mc/FNP575PBU+1p2ZK/IfyLTSGK3NsMYulqHkodVrBsszetGkTq1atsiOQkiTR29vLL37xC1588UV6enoYGxtbEKkvljyspCzmgFmC/1ZQNJZV5ME5oA0NDdHd3Y0oiuzcubMkD6gz1eAXknRKWx88eNClGZ9rfwsZpAzD4MKFC/T39xOJRGhpaZn3vsA/8uCsb7A+k2vi+OBf/T57XrWdr330f5DqG8IIBjAVGWYcNlFNiKcgMqMUaRqIM/xWnlLRHbWrgoStuQCAImOaJuHrKcaAQGUQryZzKq0hOdbg8rS3zsJ93vI07vcV9/uCLoBhZgSiyBRUOtMaFQSIOwwyQhEZLT77ewoeLQgvOQEQJ7wRgGxzLN0UkEwYFHPcwzlqHmRB9niHzkLw5FAkIcAf736N//69h1vCbovFgGEYyLKcZexlpThOnTqFrutUV1fbkYliogPW+FDI5+PxeNG1VytYwVJgWZEHmJ1Q+/r62LVrFz09PSUTdnLWUHjJw1zS1n5YSPeGqqp0dnaSSqXYtm2b3bO9EHjPx6++YS685m2H2NDayH9565eZ6OlHap219xYAKRZHnyEPgYoQ5nhmNS8lPQWSmo4kuLUeEEBJmIRiKilZIOxZPUtBGVKzk6Wiuid/Q7FMtzKQVU9kwPO+IAoo0wbpipntPXxRn9bB0dGRSKgojkdOSrlrDkyHxLUFccpjMCWJWT4VCAKCCrqPp0fmxPxflgQxZyNGUjVczSZrpVoaQmHS6bT9W+eawG+Wgsn5Qtf1rOhcMBiksbGRxsZGX2MvRVHsdtC5jL2K1XhYSVvkx0rB5I3BsiIPiUSC48ePk06nbd+GS5culVRSGrKLHAcGBuju7mbDhg1s27at4IFjvmkLq56iurqaAwcOMDo6WhKC5BTZckYcCiUOkPkNBsav8oFv3Mv/94Wfcb7rKmZdHYKSuRWVad1eC2vmbEmApOPSRTAwsmQUlJCCltRQeidI3FKHNx5pCIYrTycgoExopKtn0kaigCAY9kpdNEWkuIEemZHRFgDDcMley9MmVrbA8GSfQikRnCt7z9MmeD3URPBKSApx0fVSQk0D2cVzgipiBn1+4zwDo5o2cnZbGJ4cS/uqbXYkzHlPWr+9k0y8Umoe8u0/XzFjLmMvS1tiLmOvYjqoVtIWBWCl5uGGYFmRh8nJSSKRCDt37rQf3lKaWVkDqFOj4dy5c/T393PLLbdkudHNhfmkLa5cucLZs2fZunUrmzZtss+plF0b1gRSLHGIRqN0dXXR0NBAS0sLR/+lnfhkgq995El+9WI/gigipQFNB1kijWkTBFGQECcSGFY3hiRkrajVpIqISNmAyuR+AdMwEMTZc1MNg5BnulQm9VnyAJkOCYdMdiCmk4jMTqSCZ5kiO2w5vGmH5HjaFdlQyhVwiECJaQ+58IMpIE2L6OUzXzYX78yh3SUY4F8uCZpmkqsE0PQcaOOaVfZq2vr9DcOwo08WrHvklVbzsJD9O429gJzGXnV1ddTU1BRNHlbSFiu4GbGsyENDQ0NWnUEh/hbFwCIjyWSSzs5OdF2nvb19XquHYiZ9y4NjaGgoS2a6VORBEATb6dMiJYVMEqZpcuXKFS5cuEBLS4utZQEQqQjziW/8H/ztZ/+Rf/3RSQRAGU+QritHrgzBxGzhgTylos6QBykogddPSxJBh8AEiHFtJkowe4ubgewWT2XaUxRpaIgO8qBMuw8jKSK6oy7S2XFhKoIr329KAoojMqFLbtFJwU/c1NM9KQVEIpMyk+UzYYocok5oDhEJ5+7yeVgYud8LKO6we4U8K1IkiqIryuCMQhmGYQsbFZLimA9u9rRILmOvaDRKb28vkHmWCjH2KpU09W80ViIPNwTLijz4oZSRB8gMrNFolJdffpn6+np27do1b5GnQif9RCJBR0eHLW7lracoBXkwTRNFUUgkEvzyl7+0++Vra2vzGhHpus7Zs2ftItHq6mrfz/3HR97GxZP9vNw7hnR9inRtGSnTfYNWygojM/9OpzUk3BOcKYqgZ0Lxkatx8L6vSJim7iI8iqeAwDuOZOoSZiEGJXRt9lrKmld4LMNZINM9oUyYdk1E0tAp8yZO0mA6lv9OFUrIGFClh01otA6AP7QcRMBffT2DPLeE7olWVCj+CofWJGuptZ49e5bR0VH27NmT2c8cKY754JUU2fAz9urt7WVgYMBl7GW1g9bU1LjGixXyMDdWah5uDJZVq6bfgFNK8mCtvM6fP8+2bdvYs2fPgtQhCzm3kZERnnvuOaqqqjhy5IhvIeZCyYO1siwvL+e1r32tTYguXLjAz372M37961/T29vL5OSkqxsjmUzy61//munpaY4cOZKTOFh49LsfoCIsIQkS4rUxCGWEoiwkBh3tmrLPravMXuvwtRRZVEAQkDzbiaZI0BHyF7zmVIaI4piYve2UkilmUhMz0B3/RhBcHR2G7D4fAQHJGz3xjGQp0yCSdJCgXJGHHBEGRcx9/5l5Ig/T6dn7TjNE6gM1OT8LGZLQ1dVFNBrlyJEj1NXVEQgECAQCyLJsd+pYkat0Om239haLpSiYXKz9i6JIKBSivLyctrY2Xv3qV9Pc3Iyu65w/f56f//znHD9+nN7eXp599lmmpqZKQh4effRRWzV3rudwdHSU9evXIwgCsVjM9d7PfvYzDhw4QDAYZOvWrXnlrlfwm42VyEOJyEM6naarqwtN02hpaSlK9jkX8k36pmnS29tLT0+PS9Y6134KkZX2O4Y14EOGfDlb2FpaWkgkEoyMjDAyMsLLL7+MoijU1dURDofp6+tj1apVtLa2FjQYB4Iyf/XDD/GHv/UVtKsxUo01mI5qQVGQIZnOkApFzGrFzGg9ZJhAaDgNmwRUL38QBVxe3UB5AlIzq3+5TMFwtGgKgDyaJt2QeVRSmu5q99SAUEIgaY3vguniLPlqIgCkJGiOtobysgDxCYfktQTGqOMeyPHE5iICoinkrKoI5CEWYWmWsFSLtxKRc+fdrc4eQRA4dOiQXRvhjEqAO8Vh1c5Y97czDTbXvXKzpy3mgpOc+Bl7WbUS73rXuxBFkbVr1/KNb3yDN7zhDWzcuHFex1RVlfvuu4/29na++c1v5v3s+973Pm655Rb6+/tdr/f29nL33Xfz4IMP8p3vfIef/vSnPPDAAzQ2Nt5QY6yVtMWNwbKKPPihFORhYmKC5557DoCKioqSScnmIg+aptHZ2UlfXx+HDx/OSxzy7ScfrEHeSRz8IjfhcJimpib279/P6173Onbt2kUymaSnp4d0Ok08Hufy5ctZUYlcqF1dxZ8+cT+hgIJ0dZRAZDamLwoCUmzG+iroM4sGFHscEA3Qrk1nfSTt46KavjYb0RBC2fuVJ2evne6z8hfHZ/dpet53RRYkIUvRsUrwpFY8+zYVAWMahJnaClPyv4a5iiJVNffvbuYxSJ1OZn53VQ/zvo1/kPNz8XicF154gVAoxIEDB/K2KIqiiCRJBAIBQqEQwWAQWZZdLc6apqGqqh2V8LtvX0lpi1z7zxWRjEQirF+/nje84Q309fVx55130tDQwBNPPMGWLVv44Ac/OK9jPvzww3zkIx+x00m58Dd/8zfEYjH+5E/+JOu9r3/96zQ3N/PYY4/R2trKhz70Ie69916+/OUvz+ucSgUrbbGQ/1ZQPFYiD5JEKpWa+4M5cPXqVc6cOcPmzZvZvHkzL774YklbP737mpqaoqOjoyiZaYs8FCrek0tmuhAMDg4yOTnJwYMHCYfDjI6OMjIyQm9vL5IkuWolcilrbr2lif/0xft4/KNPkqytcmsjTKnogBAJkBV6EKxqw8z5VsRh3PvdfBoclKQjkiBlm0XJjroH3+iBgyAEwgralLOjQnBbd3sKIhPRNDjdRA0N5xmYQoa4SeMi2mrDV4USMs6a/q/nNr/S1NzdFumZObs1cnfOqEMsFqOzs5PGxka2b99e9ITuV3hpEQbTNNFmiJ43KnEjJ/dSoNC0SCAQwDRN7rrrLj796U8zPj6elUYoJU6fPs0jjzzC888/z8svv5z1/rFjx7jjjjtcr9111118+MMfXrRzKggrkYcbgmVFHkpZ86DrOqdPn2Z4eNjV3bBQVUjvuTn3ZelFbNy4kW3bthU8WFsDVSHkwRlOLoY4pFIpurq60HWdI0eOEA6HAVi/fj3r16/HMAxisZid3uju7rbb1+rr66moqHAd61VvOoCeUHn8cz8Ap2HYzIpYz2FcpARltBkhKDGmZtQrHbUQyEIWeRBNCTGuYURkVIwsFQVRlxBVAyMg+spey8nZ0UcKimhTzrSDQDAhkIxkPhNQJNKqm1w4Ry9V15E8j6UpgRzLkAdk/5HOzEUR8tyKZp73DFPAUFdz3+a3+L4/NDTEyZMn2bp1Kxs2bPD9TDHwS3E4/3M+o06isRgkYinSFoWSE2fBpOUQuhhIpVK84x3v4C/+4i/YsGGDL3kYGBjIajdvaGhgYmKCRCJhP/MrWB5YVuTBD/MhD9PT03R2diJJUlZ3QykLMK3Ig1WEefXq1XnpRThXd/lUAZ31DcUQh/HxcU6cOEFNTY1LQ8N7Ds5e+GQyycjICKOjo1y6dAlJkmwiUVdXh6IovPZ/uxVTEHj8v/7/CDNRCjktIJgmpiBgmgaC4D5WKplGEmbIkm4SGJxEXT9bIKYEJYyUe9YUgPBgiulmmbRoZpEHASi/qjGxOYAUzm73FB1KlGnPe3JERhhPw4xWhKpqLt8IwdMl4U17QEa5Uhqf+U45nlhdBMkgKxE531ZNRJHXr/p933ugr6+Pixcvsnv3bjtXX2o4oxKA7Z1y6dIlIFMrYEUmrM+WasJfishGof4y+USiHnroIb74xS/m3f7MmTPs2LFjzuP85//8n2ltbeWd73xnQed1U2El8nBDsOzIg1MlEYrXeRgcHMxr3V0qMytrX6lUil//+teoqrogvQjIbe/t9afIVd/gh2vXrnHmzBl7BVrodqFQKCsqMTo6Sm9vLydPnqSyspL6+nr237mDV/3yPL881pf5LopCeSLNZCSAHBQxvHl7EddgoAwnXOQhkUgR9AnWl11Pk2oy0RQxq50ToGpKZkozSQs+5EIXbTGopK4RcJADXYIaVSFhhTu8Ltg6LiEpv7SEFXmwv59H5dLasaAKmCHPSJg38pD7twqam7i1vs39edPkwoULXLt2jQMHDsxZtV9KCIJAT08Pw8PDHDx4kLKyMvuezZfimA9upm6OeDxOebl/m+zHPvYx3vve9+bdfvPmzQUd55lnnqG7u5vvf//7APZYUF9fz6c//Wkefvhh1qxZw+DgoGu7wcFBKisrb2jUQSB3aq7Q7VdQPJYdefCi0EiB0xNjz549OR04Sxl5SKfTDAwMsHr1ag4cOJBXTyEf8pGH+dY3WNGQgYEB9u3b5xKlms/5WVGJbdu2kUwm7VqJy5cvc/AtTXS8eIm4lvkeqUujsLORVEpFET1TuSRldK2tP1Mm4mQKoyLzOVOR/NUYRYlVgxrX1yn4XQJTFGkYgOvrTKdK9sw+BQIxA7VWyvK3SJsmxmAKNioz+zERHLeHIIpICdBnOKEveRBBnpxR1BSzGjpm9+VHHnKYYuV9Ly3yXw7e53pJ13VOnTrFxMQEhw4dWlLtAV3XOXnyJNPT0xw6dMieqApJcRSrLWGlRG6Wmop8xlirVq1i1apVvu8Vi3/4h3+wXYYBXnzxRe6//35+8YtfsGXLFgDa29v58Y9/7Nru6aefpr29vSTnsIJXFlbIQwGTfSqVorOz0+WJkW9/pRBkunLlCv39/ZSXl7N3794FVZdbg6f3vOZb36CqKl1dXaTTaQ4fPlxy+dxQKMS6detYt24dhmEwPj7OOz8K//3PfwGiiDKZRoWZNk4PZAkcHRWiKFI9kSRqkYeABHGf7QIyQm8cubocJSiRtlIbM0whaRgEzieRGsJ4/ScQBcquz5CHOQoqQxEFddIjcR0X8pIHTBAMAWkK9EoQMX3bL4V09u9XoQSY8vksQFDxf/xfG97HxqpZMphOp+ns7MQ0TQ4fPjxvS/f5wHnsQ4cO+RbZegsvgbzy2flSHNZnb4aaB0udMt94Uyj6+vps7w1d1+ns7ARg69atlJeX2wTBwshIRo6ttbXVjjA9+OCDfO1rX+MTn/gE999/P8888wzf+973eOqppxZ8fgvCStrihmDZkQdv2mIu8hCNRjlx4gS1tbUcPHhwztX/Qrs3nIWYTU1NJJPJkrSlOcnDQuobJicn6ezspLKykn379s07GlIoRFGkpqaG3/rd2/jVjy/QdXIICRFhMokpZp+zqciQdLdjSoPT0FgBoogZlDFJZ4cqBQFRlqi9nCJZHQBDIDCWIjitsXrPGnpikyAI1PcbJATwBjtDI5lwgF9NgqjOaEtIAkIgu93DSS7EgM93mplnAlMSiUo992DnQx7iEyp+RloAoo+rZiAe5pO3v9H+2zKTKysrW7DoWbFIJpMcP36cSCRS8LGtSd9PPrsQbQnrvZuh2wJKpzD52c9+lm9961v23/v37wfg3/7t37jtttsK2kdzczNPPfUUH/nIR3j88cdZv3493/jGN26sxgMrCpM3CsuOPHiRizyYpsmlS5e4ePGiLfpUyAS7kJqHeDxOZ2cnoihy9OhRhoeHicfj89qX33l5fQiguPqGgYEBTp8+TXNzs226tVQYGhriVb/XTO8XhpjQQ8gD45ihQLavVED2xgUwTQl5cAqtsTJTW6BrIGXf+mkTpGEVWTfZUlPFne9s46637GdqeoL/9/s/59+fHWSyJ4HQFMiSiZYlifCwjlbjM+lIAoFJE7U6UxPh1WSICDLxGR1pv0yCFc0oSwdJEEfIwR4kQ8y6HPk6KtKa6foapgl/vPVulJmJc3x8nM7OTtvIbCl/76mpKY4fP059fT07duyYdyTAr4vD6cPhTXE4aycWC8WmLUpBHp544omi1CBvu+02X12W2267jY6OjgWfzwpe+VgRiZIke8CwYIVKL1++zOHDh4sqBJxv2mJ4eJhjx45RXV3N4cOHCYVCJTO0gllSY63AijW2unDhAmfOnGHPnj00Nzcv2URimiYvv/wyJ0+eZM8te3jsex9EFk3k6DShmuxBVRBFRMl9bppuErw62x/vm+4AgmUBtmxdzWOP3MvXnngf9/zeYYaGB+js7OSeNx3hW998gMMHmykb0FyS1JBxzKwYyOhEePdvSBCMZl5L+8zmij47kWiiT13KzPcxxmYIn+/Zg+BTyyHkKYpMqW6qsUFdz53Nu4DM/fjSSy+xcePGJScOY2NjvPjii6xbt65gddJCIYoiiqLY0tle+eypqSmbRMxXPnsuFBp5MAyjZGmL32iYJfhvkVCILHhfXx933303kUiE1atX8/GPfzxrTroZZcGXHXnwDoKWoY81SExOTnLs2DF0Xefo0aNF91UXWzBpmiY9PT10dnayY8cOdu7c6VotlbJzwxoMi0lTpNNpOjo6GB4e5vDhwyUr0CoEuq7T3d1Nf38/hw4doqGhgfo11Xzyz+8llDJRU/4SiZKSvaqTp3XkwcnMv4P+q76dLQ089nd/wM69GzAMg7Nnz9LT08OBAwdYu3YtgYDMZ7/wFr74p79L7ZiRWarPQJMgNKCDbmaFQU1ZJDSaedFbUAmgxh0aBj7lBFbkQYtaap/+o52W9nk9z9wXdDiOkhb5wqHfBTLCZ11dXezcufOGRJg6OjrYtm0bW7ZsWdRjW4qXiqIQDAaZnp7m7NmzbNq0CZhtD1VVlXQ6bRPvhaLQmgcr6rhCHgrATUgcYFYW/AMf+IDv+7quc/fdd6OqKs899xzf+ta3eOKJJ/jsZz9rf8aSBX/d615HZ2cnH/7wh3nggQf4l3/5l8U9+Tmw7NMWVs5e13WuX79uh+XnO3AVM+Gn02m6u7uZnJzkyJEjVDrEkKB0bpimaRIOh+ns7KS2ttZWefQz0XJiamqKzs5OysvLOXz48KLXNzhhWZpLksSRI0dcRXptt+/k/f/lzTz5dBcTk16DC9DSabLW54pCqGeUqdXlGfMrj0p1QBL46KfuBmZ/l2Qy6RK8srB7z3r+8e8/yKce/SHPXb0OgkAak4ABZdd0ZEVx1mxiKIIdefCtiXAab8mWfoXoeg1MpMmZ13LclqbPWsDM022hpgysb7YtsQ5xKsG5a4N2K2ZNTX4zrFLDsm1fTP2IXBgeHqa7u5vt27fbcu9zpTjmqy1RaNrCIg8rrpqvXDz88MMAOSMF//qv/8rp06f5yU9+QkNDA/v27eMLX/gCn/zkJ/n85z9PIBBwyYJDpoj12Wef5ctf/vINrTdZdpEHL6yH+PTp05w9e5Z9+/axdevWea94Cp3wrQiHYRi0t7dnEYdi9pULTn+K/fv309bWRlVVFdevX+fZZ5/l2LFjXLhwgbGxsazjDA4O8sILL9DY2MjevXuXlDjEYjGef/55KioqOHjwoG91/53vfjW7tjX6bO1xtpyBoMhI8TTKlVjGutuDXVsrGRq5xvXr13nhhRcAOHz4cN7+9T/79Ft4w65mAFRMTEzKrhvonlyxIQtImoAyafp2Y2g6iKnZbfzuPEEWENMiQjJ35MHw2TJfMZg+85NLqswDGw9x9uxZ+vr6CIVCjI6OEovFFiVs74UVfbt48SIHDhxYcuJw7do1uru72bVrl8snxi/FIUmSneKYb1Si0LTF9PQ0kiSVzCvnNxWvZG+LY8eOsWfPHpfw31133cXExASngjTiBwAAIABJREFUTp2yP+MnC37s2LElPVcvln3kweptnpqa4ujRowsWOykk8nD9+nVOnjzJpk2b8hKVhRRfevUbRFGksrKSyspKmpubSafTtpZCV1cXhmHYbpmTk5Ncu3bthqwALdGpbdu2zVmkeucb9/Hcv/dmT5mimF1ICSBLRPpiJLYHkR23fhB4/0ffwODgAJcuXUIQBMrLyxkcHKSuri5vhObTH/ot+j7z/3AuGsOQBIIxSJUbMw6fGZiygCAKhEZN1HX+K055GtQ8c4SGgYSAPCHmlm7wWc3mizxYKY3XRvZhxFOEw2F27drF5OQko6OjdoukFa2a61rMB1Z6aHR0lEOHDi15iP7y5cu8/PLL7Nu3z1Y/9UMx8tn5tCWsKEahkYdIJLKkaaNXJErUqjkxMeF6ORgMLjpxyyX5bb2X7zM3WhZ82ZEH54M4NDREd3c3oiiya9eukvwI+ciDYRicO3eO/v5+9u7dO+fEPN/iy0L0GxRFYc2aNaxZswbTNJmYmGBoaIjz58+jaRplZWVMTEwQCASoqqpa9AHMKsrs7+8vWHRqf9tmmmpDXI16UheKBH6/gawgpFIoI3HM6gpb6emd77wVURSIxWLs2LGDyspKRkZG6O/v58yZM5SVldmTZ3V1ddaE8N8+ey+/9yffJi6pCDooUyZpT22UGJKoHIdr6w1C3lYNPO6bftdHAjSQJgU02fStZdAFE0nH1QkimLl6MzIKk+FUmP9AFVJAsltvKyoqWLt2rX1fjI6O2tciEom4rsVCWhp1Xaerq4tkMsmhQ4dKTkzywTRNLl68SH9/PwcOHCi6tslPPrsQbYliWkEtaeoV8pAfpWrVbGpqcr3+uc99js9//vNZny+lLPgrGcuOPMDsRHX58mV27drF+fPnC7KLLgS5JnxLaErTtIJlpotNW8xXv0EQBGRZZmhoiKqqKlpaWpiYmGBkZISOjg4EQXD5TpRaJMhZY3D48OGicrx/9Z3/yPvf/Dgxdfa1jNZDNnkQFJn1TdU8+F/vY2PrWs50XeXK5RF2Hazl3LlzLtJSVVXFli1bUFWVaDTKyMgI3d3dGIZBbW2tfT1CoRCBgMzffvY+/tOn/p7JwTjBuJFFHlRNRxgwMPcqWTUNkIk82Ocv+hRdzmhaiBMC4moBVHwgIKYEjMjsxookkaOuFNMUODi9nvo1tb7tkIIg2GZMmzdvJp1O29fi1KlTpNNp+1rU1dUVtUpWVZXOzk4EQaCtrS2nw+piwDRNzpw5Y0c7SlFT4OcQ6iefnU7n8UH3IJ+65ApKjytXrrjSx7miDqWUBV+zZo2dJrVgSYBbKsY3qyz4siMPqVSK48ePk0wmbbXInp6erNaY+cIv1TA2NmYXK+7evbvg1VoxaYuF6DcMDw9z8uRJ1q9fb6dRysrKaGxsxDAMm0hcvnyZU6dO2b4Tfm6YxcIyGQuHwzkVBPMhEJD56v94kPf/7l+TtEyyAgomKQTTZE1jJb/9+7ey58gWNrSscZ3r3kMbkcKTDA4O5iQtgUDAFaGZnJxkZGSE69evc/bsWcrKymwi8eH7X8cX/uwpRNVETBsYimNlKpooqoAy7uNeBQSHBSa3kbsYcuarRZIKcTH3vSqoAjjIQz5KXKYGeNeuWwtuvVUUhYaGBhoaGjBNk+npaUZGRhgeHub8+fOEQiGbSNTW1uask0kkEnR0dFBWVlbU81AKeKWuFyPakU9b4urVq8iyjGEYqKqaN8UxPT29krYoBCVKW1hp3blQSlnw9vZ2Hn30UYaGhuxI9NNPP01lZSU7d+60P3MzyoIvO/IwNjaGoijs37/fHtxK2RLp3JdpmvT19XH+/Hm2b99elF6EtS9r5ZJvOydxKIY0mKZJb28vly5dYufOnb5+HaIoUl1dTXV1NVu3bnX5TlhumBaRqK2tLWryHx0dpauri3Xr1hVlMe5FZU0Zf/mN9/LYp/+ByckU8aRB45Z63vuJ32ZP+1bfbaxuDlmWC5ZcFgTBHmCslfjo6Cijo6N0d3ej6zob11dwuX8SZdogVe0gD7IIGISG/c2zRV2kelQgVq+DaGbVbETKAmhTKkbUQN+Y5171RCR03SuZNXM8A7507+sKXiF5YdWFlJeXs2nTJnRdJxqNMjo6yoULF0gkElRXV9vEqry8HEEQmJycpKOjg1WrVrFjx44lnRg1TePEiRPouk5bW9uSyWxbBKGnp4f+/n7279+PoihZKQ4niRBFsWQCUb/puJkVJueSBb/zzjvZuXMn73rXu/jSl77EwMAAn/nMZ/jgBz9oRz5uVlnwZUceGhsbqa+vd71WavJgmibpdNoOjba1tc2r7c0ZBs21OpuvP4WmaS6jo4qKioK28/pOxGIxRkZG6Onpobu7m+rqaptM5MrXWt4dFy5coLW1lbVr1xZ07HxYv3k1X/6ufy+1F5ZyojWBzVeEyFs3Mjk5yeqGdXzq0/8yQx5mP2t1WYSiBqlKMWs6N4MiwbMavIpMYMJzO04lU4QQICEQCMvEcyigey2+Nd3MUrTENPnwq9to27mt2K+cE5IkuVZk8XjcJla9vb1IkkRFRQVjY2Ns2LBhQR1N84Gqqhw/fpxAILAgk7n5wDRNzp07x9DQEG1tba6i0Hzy2dFodCXq8ArHXLLgkiTxT//0T3zgAx+w09nvec97eOSRR+xtblZZ8GVHHvxQrC13PlgT0fPPP4+iKLS3t887NGrty09UxlqxOI18Ch1o4vE4J06cIBAIZGkoFHt+lhvm9u3bSSQSjIyM2GQiEAjYK08rjG0YBmfOnGFkZISDBw8uqa0zzEpsb9mypehIUD5YUYnduyr5/d8b5//+7q+QVAM9kPkNTSVznOAYqDVkFTwaikBoEMLTIoGAiDc1bsiZ7QVEV1tnFjzkQUTMiui+umk9//vr2lhMRCIRIpEITU1NGIZBb28vvb29BAIBLl26RDQatWtoKisrF9WIyvLnqKioYPfu3Yt6LC+s+31sbMzlCGohV4pjfHycr3/960XVSCxb3MTGWIXIgm/cuDErLeHFzSgLvkIeKG3kIRqNAlBdXe1Si5wPcllpL6S+wUoVrF27lm3btpV0IA2HwzQ1NdHU1ISu63ZUwhnGTiQSSJI0p4ZCqeFM0ezZs2dRlTLf/nuHefonp1BWl3EyNgaArmS8MCVNIKQLJD0/lyGALIuUndNJ1BqIuNM/llAUgBrVIZzj0dXdOzZ0d3HmqkCYv3rP3Qv7gkXi6tWrXL58mb1797Jq1SpSqZSd+rpy5Qqmadq1EqVuB7U8Mm5EmsQwDLq7u5menqatra2g7yWKImNjY7z1rW+lubmZH/zgB0twpq9w3MTk4TcZy448+A0epSAPltBNb28vkKm2XejEbEUTnOTBq99QTH2D1dO+Y8eOkqQK8kGSJHsyaGlpYWhoiFOnTiGKIqqq8tJLL9npjZqamkV3MTx9+jSxWKyoFM1C8Nd//U5OXxzgP/33mRWFJGSSq6aANAH4dAamTYPwNYFkdfZoZijYNS1iHGxpSNOkYVghGVMRdRMEkURQJL3WQNBxEQfBhMff9cYl9SXp6enh6tWrHDhwwI4yBYNB1q5d62oH9bbGWvdOTU3NvJ+jWCxGZ2cnTU1NbN68eUmJg67rnDhxgnQ6XVR9xcDAAPfccw+bN2/me9/73pK2r65gBcVg2ZEHPyyUPKTTabq6upienubWW2/l+eefL2kaxCIP861vsCbPsbExDh48WHRP+0IxODjIqVOn2LRpE83NzRiGYbf8nTlzBlVVXbLZpYxIpFIpTpw4AWQUI5dKrS8YVNi3cz1hXSAhzfhaiAKSDvKIhhhRMBT372dKApIKVWMiE16tJEGw3ULFuAgzMhjVF02kwRSzZXUCZb+OMNlskqpOuhZVt2/exPZGd73PYsEK10ej0bztkM520C1btuRtB62vry+4ddESP9u6dSsbNmwo5VebE5axHsDBgwcLrq/o6+vjd37nd2hra+Pb3/72khV0vtJxMxdM/iZjhTzg76xZKKzq8bKyMtrb21EUpaRumNa5OeVviyEOiUSCEydO2B4RSyl1azliXr582aVW6Syuc7b8DQ4Ocu7cOVuIqL6+3leUqVBMTk7S2dlpp5CWsiXQUk587bYa/vniKIhCpt1Sh8pwkHfecYC//veX3NvMnJ4waEBEzNiHOyAHRIy0iZjIvF7RZxAZ9IlSTGhU9Csk1ZDdaFEuKTzy9teX/Hv6wVp1p1KpotshC20HtSJWfhPzwMAAp06dYufOnTQ2+kuYLxaswsxgMMgtt9xS8D134cIF7rnnHu644w7+9m//dkkLOl/xWElb3BAsuzs0V9oilcpRvp4H165d49SpU1lGWovlhmn9XSii0ShdXV00NDTQ0tKypIViVj/9XN0c3pY/TdPsfLjV/miFsAsx87JgGR1Z0Y6lDFlbkShVVfnYf3wTh17o5c++93NMSSAUkHj8sbezpqGKf37xPD3xSXs7QwESIGkCwXGTVI3nnGUgDWJcoGoUIn25Rz1jJE2ZJjC9NjN5/fHttxJcgglJVVU6OjqQJGnB4k/52kHPnTtHMpm0u3vq6uooLy/n6tWrXLhwgb1792Z1VS02kskkx48fp7y8vKjCzNOnT/OmN72J++67j6985StL+pyuYAXzxbIjD34odrK3VpXXr19n3759WcV3pSIPpmkiiiKXLl2isbGRurq6ggYWZytkS0uLy+xnKWBFO2RZLrqbQ5Zl18pzamoqS5TJikpUVVX5egdYtR27du3K0oRfbFgCSJbolSzL3PmaVtY2VPFnX/tX/uT+17GmIZM2euyP3sS9f/Y/0GYWpxlRqQxJDI0ZpKoFW0IbQBcFBExEXSR0Op2lUulFKGZiyDobttTz1iM7F+X7OrHYXQ252kFHRkZ4+eWXgcyz2dzcXJDYTykRj8d56aWXqKuro7W1tWCyevz4cd785jfz4IMP8oUvfGGFOMwDgmkiLEAheCHbLmcsS/IgCIJLjrqYyd4SF9J1nfb2dt8c7EIMrSxYtQ27du1iaGiIl19+mZMnT9orrVWrVvmqz+m6ztmzZ29YK6RVpLZ69eoFaShA5neqqKigoqIiy8zrxIkTdpW+RSZkWXa1gS51bYelH9HQ0MD27dtd3313y1qefPzdrtdW11Xwp++4g0vXo6xbVcX6hiqefvo0P332PIm0RmDCRK2a/X1FedanQhDFgsKt4RGTP/3k4qcrJiYm6OjosKNcSxHpsdpB169fz9mzZxkcHKShoYGhoSF6e3uprKy0o1aL6c8yNTXFSy+9xJo1a9i+fXvBx3nuuee49957+eQnP8lDDz20oukwX6ykLW4IliV58KJQnQdLZrquro5du3blzGfO19AKsvUbqqqqqK6udukoDA8P09PTQzAYtIlETU0Nqqpy4sQJBEHgyJEjS16p3d/fz9mzZ9m+fXuWyUwp4GfmZbX7nTp1CkmSkCSJnTt3LvnK0yoK3bp1a043UD8i9Zq2LbyGLfbfLe9v4EPvfx1PP3Oaf/hJF8fNmB19SBuG/cAKIQkzrs054WxorGR1dWhOldKFwGr/bW5uZuPGjUveDmmJnR05csQutk0mk3bh5WK2g46Pj9PR0VF0R8czzzzDO97xDh599FH+6I/+aIU4LAArBZM3BivkgbkjD1Yo3EoDzGUVPd+0hVe/wTvZeHUUotEow8PDdlW6aZpUVlayZ8+eJSUOhmFw4cIFrl+/zv79+/NaG5cKzir9NWvWcPz4cRRFIRwOc/LkSQRBsCMSdXV1i2a85EyTlNLC/A237+QNt+/kvj99kstaxjVLF0z7gdUxfbw5s/Gm2zfwq1/9ikAgYF+LfL4TxcIqTiyVUmgxsAozVVXl0KFDrvRYKBQqqB10IUW50WiUEydO2IJjheKf/umf+IM/+AO++tWvcv/9968QhxW8IrEsyYNf2iJXt4Ul4xyNRguWmZ4PeShWv8GZ/71y5Qrnzp2jrq6OdDrNL3/5S8rLy121AYs1QFnFgalUisOHDy+5C6C16nWaehmGwfj4OCMjI/T29nLy5Emqqqrs62H5LCwUVu3L8PAwbW1tixLt+PjbXssfffcpTEmwJa4tmJKAkCfA1dRYzZvvfi26rjM2NsbIyAjnz58nmUxSU1NjT57ztX2+fPkyPT09N6Q4MZ1O09HRgSiKtLW15SVDfu2gTk8STdPsVmHLHXQuWAW5LS0trFu3rqBzNk2T73//+/zhH/4h3/zmN3n729++QhxKgZW0xQ3BsiQPXuSa7Kenp+no6EBRFI4ePVpwm2OxbpjOVEUxbZjW5DU0NMSBAwfsFb+qqoyOjjI8PGxbai/GKtxyxIxEIhw+fHjJ28uuXLnC+fPns1a9oihSU1NDTU0N27ZtI5lMMjIy4vJZcF6P+Zy3pmku0rRYapmHdzbxidcf5UvPPDcjUT070hmKgJA0ct4vf3T/awFc3xcyxX3W9cglI54PlqX9tWvXbkhtidXVEIlE2LNnT9EtuN7019TUFKOjowwNDXHu3DlCoZB9b/i1g1rRlt27dxdckGuaJt/+9rf5+Mc/zne/+13uueeeos55Bbmxkra4MVghD/iTh6GhIXtF6y1+K2R/hdQ8LMSfIpVK0dXVha7rrlwvZGykGxsbbUtt7yq8EPOquWC1UjpX/EsFwzA4f/48AwMDHDhwYM5oUCgUYv369axfv37eZl5OJBIJOjs7CQaDdkfFYuJ3b7sFTdP58s+et4WigCwdCCfW1Fewd5d/l00kEmHDhg1s2LDBjkp43TCd7Y/O62EYhkutc6ldH6enpzl+/Di1tbW0trYuuDvBWZRrtQpb18NqB7WiNHV1dcRisaJbQU3T5G/+5m945JFH+OEPf8gdd9yxoHNewQpuBixL8uCdHLw22hcvXuTSpUvs3r17XiIzhaQt5qpvyIfx8XFOnDhhD6D5Vl7eVbjXvMoquixUJtqZ429tbV1yEZ50Ok13dzfJZHJeaZJCzLycFuPe61EqR85i8fY79qNqOt/+/q8xHCk3UxYQfG61B9/96oL264xKtLS0uNofe3p6UBTFJhJVVVWcPn3arjFYSsExyHR0HD9+nHXr1i0aYZVlOWc76MWLF+3CS03TSKfTc0bxTNPkL//yL/nKV77Cj3/8Y171qleV/JyXPVbSFjcEy5I8eGHZaKdSKbq7u4nH49x6663z9kCwhJ1yYb7+FJARpjpz5owtu1vsAOpXdOmUiXa2PnqLLnVdtyWHb0S42tJQCIVCHDp0qCTpF+/1sGoDzp07RyqVoqamxr4eU1NTnDx5ks2bNy95V4FpmhzaVE7N27bw0jmVF073kzT0TOoibSA4ohAb19XS3tY8r+M43TD9zM1kWWbDhg2oqkogEFiya2AVJzY3N7Np06YlOSZkrkc4HEZVVWKxGFu3biWRSNDb20t3dzdVVVU520ENw+Dhhx/miSee4Omnn6atbXGdTJcrVtIWNwYr5AHssPOxY8eorKy0ZabnC0mSUFU16/WF1jdYofp9+/ZRV1c37/NznqdTJtpPkGnVqlU2kejq6sI0TQ4fPrzkbaBjY2OcOHHC7qVfjBW/cxVumqZdG2BJI5umSX19PRUVFRiGsWRy15Za59TUFK9/3av4nTdmUlT/7f/6d3747ClwXIqAIvHY595akuNa5mbhcJjh4WE7AhGNRrl8+TKyLLtqJRaro2VoaIiTJ08WVZxYKpimaT93hw4dorx81nQkmUzahZd9fX0IgkBNTQ3Hjh3jzjv/F3vnHhdVnf//14DcYYbbICB3L1zkfhXzVqIopptmW7umZpRJ6jfITN1Ka7MyrbVaM7fN0t/uum61miB4R9DyDgx3EJX7zeEywAww1/P7w/2cZrjIDMwF4zwfj3nsxhxmzozDfN7n8369X6/52L9/P3766SdkZWVh6tSpej1vBgZdwxQPeCCAAgAXFxeNTF4GY6C2xUj0DRKJBAUFBZBKpTqbaOhryEREly0tLcjLy4NMJoOFhQV8fHz0mhEB/Lrboiv/iIFgsViwsrKChYUFuru70dXVBS8vL3R3d9Nb97oK81JGIpGAx+OBxWL1G0fc+OJsdHWLkXmjAsayB3YQ76QsgI219go7Yv7k4uKCyZMng8ViwcPDAwqFgtYGEO0ImWhxcHCAjY2NVnYl6uvrUV5ertUxWHWhKIoOlIuKiur3d2dubo4JEyZgwoQJoCgKHR0dqKysxMGDB7F582aYmJhg1apVuH//PiZPnswEXekKpm1hEMZk8UC+1JRtplksFiZMmKCVL7y+xcNI9A2dnZ3Iz88Hh8NBWFiY3hZuIrpksVi4f/8+3NzcMG7cOFRXV6OkpAQcDofelRiu6HIoiP6krq5Oa7stmkAmKnp7e1VEqboM81Kmu7sbubm5YLPZg5qS/WnDfHR81IP84nosmO2P6FCvET8vobW1Ffn5+fDx8enXKjAyMqK364l2hBSbyhMt5Jjh7EpUVVWhsrISoaGhevEOUUahUKCwsBAikQiRkZFD7rSxWCzY2tpi6tSp8Pf3B0VRWL9+PXJycrBixQqEh4fj5MmTejr7sQfTetA/Y7J4AH61mVYoFIiNjcXVq1d1EqM9En1DY2MjSktL6T6vvnvsd+/eRW1tLYKDg2kB2UCiSyIyJE6X2ihwyFZ9V1cXoqOj9a7q7+3tRV5eHkxNTfvpK/oGNinHSCuHeZHFczgtHmLzrc5u2K6tS/Cv/97A88tjhvVaB6KxsRElJSVqJ1NaWFgMONFCJnzYbDZdXA21K0FGQRsbGxEREaF3t1Bl86nIyEi1dwx6enqwatUq1NbWIjMzE87OzgAevB6BQKDLU2Zg0Dtjsnhoa2vDrVu3wOVy6ahmbSZhkscibQpNCwfy5VlfX4+goKB+wVu6RiaT0T32vn1eYGjRJdnO53K5w1o4SWE3btw4REdH6327l2zVqztR0TdGuqurS8XNUNmwi81mD/l4pMdPRLFDwWKxtFY4kGkacsU/nN0e5YkWACo+G9XV1Sq7Fg4ODir/vgqFghblRkZG6r1olEql4PF4AICIiAi1d0yEQiGeffZZiEQiXLx4UeV9I1oIBh1BUQ9uI/l9Bo0Zk8WDsbFxvwwCXcRok8fTpHDoO4qo7y9P4mFgamqKmJiYIb88+4ouyXZ+U1MTysvL6RRMLperltMlGYV0dHTUyhy/phDnwOFOVLBYLLDZbLDZbPj4+KhoR3g8Xr8wr76FUU1NDe7cuWOwHj8RB2rzir+vzwbxHamqqkJxcTEdYGVvb4+qqir09vYiKipK76JciUSC3NxcmJqaIiQkRO0dNIFAgKeffhqmpqY4d+6c3qeQxjrMtIVhGJPFg62tbb9FWd1wrKGgKAomJiYQiUS4ceMGvbCqIyDr6upCfn4+rK2tDeLY2NbWhoKCgmFPNAy0na+8cAJQWTj7FiYkXMoQo5DArwu3NqO8lQ27iKiupaUFNTU1KC4uVhn1a25uRmNjI8LDw/WehqpQKFBUVITOzs4BxYHaYiD3T+KGWllZCQDgcrlob2/vtyuhS4hrpbW1tUZx4nw+H0uXLgWXy8WxY8f0XuwzgBFMGogxWTwMhDZ2Hoi+wdraGjNnzqS/FMlYG7kCH8h8iCycnp6eGqXzaYu6ujqUl5fD19cXbm4DOxNqSl8b4L5XnMp5E/fv30d1dbVB2jRkDLa5uVmn/hVEVGdra4tJkyZBLBarLJwURYHL5aK3t1ctAyJtIZPJkJ+fD5lMpvc2EbGCrq2thZ2dHby8vNDe3o7q6up+Wgk2m62TvwsiTLWzs0NAQIDaz9HY2IjFixfD19cXR48e1btpFgODIWGKh/8xkuJhIP8GMzMzOtWPjLUpmw/Z29uDy+XCwcEB9fX1qKmpMchWtaZWz8Ol78JJ+uAkXpyiKPpqXy6X622qRCaTobCwED09PTrNqBgIMzMzcLlc1NfX0yOyZNxPV2FefRGLxbQwNCIiQu+7XT09PcjJyQGHw8HUqVNpPYRycUV2algsFr1LM1DLZzgIhULk5OTQu23qvsdVVVVYvHgxYmNj8d133+mt0GPoD0uBhwbEqfP7DJozJouHgb4gRhKjPZR/Q9+xNqILIP4FLBYLrq6uMDMzA0VRett1kEgkKCwshEQi6ZePoWvMzc3B5XLR0NAAGxsbeHh4oKOjQ6W40rWHAhFmmpiYaM2xUhN6enqQm5sLKysrOuDJyclJJcyLTCyQnSt1w6vUgeREkCtufetLyMI9fvx4+Pr69vvc9y3ASaw2afkQrcRwk2M7OjqQl5cHd3d3jXb7bt++jcWLFyMhIQH79+/Xu+8JQx+YtoVBGJPFw0A8LJZ7MJTHMFksllpfvkQXwGKxUF9fDzs7Ozg7O6OtrQ25ubkwMjJSaW/o6kpQKBSCx+PBxsYGISEher/i7OrqAo/Hg62tLT3xQnQBfT0UiOiSLBLaWOS6urqQl5cHBwcHgwgziTB0sIWzr8iQ7FwRm+iRRmqThVOXOREPQyAQIC8vD56envD29h7y+Y2MjAZs+bS2tvYTojo4OAzZQmhvbwePx6P1NepSVFSExYsXY8WKFfjkk0/0/rlhYBgtMMXD/9B052Ek/g18Ph9FRUUqiZR95+MrKiroRD9ixqStK3Dy/O7u7pg4caLeFw4y0TCQvuNhosv8/HzaIposEsPZuibPbwj/DOXnV1cYqrxzRcKrNAnzGuz51R0F1Tbk+SdPnjxsx1DlXQmip2ltbUVtbS2Ki4thY2OjEuilvMiT558yZYpG+p5bt27hqaeewsaNG7Fjxw6mcBglMNMWhoFFUWNzyFUsFqv8d3l5OWQy2ZAe9CPJp6AoCpWVlaiqqkJAQABtIjMY5Aqcz+dDIBCoZE0MZ5uWoijatU+d59c2FEWhpqYGd+/eHdbzK4suW1paIBQKwWaz6fdEHV1AbW0tKioqDPJoOsgjAAAgAElEQVT6gV+FqVOnTtXK8xOfDSK8lEgkKmFefacmSKtMW8+vKcR8SpfPrzwe29raSu9KODg40BofTZ//559/xjPPPIO33noLmzdv1nvBydCfzs5OcDgcRC95H+NMhj/WK5P24kbqO+jo6NC7IdmjDFM8/I+7d+9CJBIhODh40N/pq29gsVhqf4nIZDIUFxejs7MToaGhGid2Kl+Bt7S0AADd3nBwcBiy7SCXy2mf/tDQUL3/kRArcD6fj9DQUK1MNCjrAtra2h460UI8DBobGxEaGqr3UUhlx87Q0FCdCFOVw7xaWlrQ3t4OCwsL+gq8s7MT1dXVCAkJ0bvdM/DrKGxISIjerMYpiqK1Eo2Njejp6YGFhQXGjx+vdhvs/PnzWLFiBXbt2oVXX32VKRxGCUzxYFjGbNuCxWJBuW4aqm1BCge5XK62voHQ3d0NHo8HMzMzxMTEDGurXXnsUdloh4QSKbc3+l5t9vb2Ij8/HywWCzExMXofKZNKpfQoYExMjNbMfwbSBfD5fJU4bS6XC1tbW9y5c4eeqNCVh8FgKBQKFBcXQyAQDOjYqS1ImJeVlRU8PT0hk8lo98+CggLI5XLY2dmhu7sbFhYWehPIksKprq5O71HuLBYLHA4HAoEAUqkUISEhkMvldG4HRVG0OLevlThFUUhLS0NiYiL279+PVatWMYXDKIRpWxiGMVs89OVhxcNI9A0k78DV1RWTJ0/WSp+0r9FO3+hoS0tLupBgsVjIz883mGOjSCQCj8eDlZUVQkNDdSbMVNYFkCtwPp9Px4sbGRlhwoQJEIvFMDc319v7oFw4RUdH67VwI5HZjY2NMDU1hZ+fH7q6ulQi18miqa0wr75QFEXvOEVGRuqscHrY89+7dw+1tbUIDw+nCxcizu3s7ERrayttJW5lZQUejwd3d3cIBAKkpKTg0KFDWL58OVM4jFaYaQuDwBQP/2OwGO2R6Buqq6tx7949+Pn5wdXVVRenDQCwtLSEh4cHPDw8IJPJ6P53Xl4e5HI5bGxsYG9vD7lcrtfiobW1FQUFBSrCUH1ArsAVCgVqamrg7OwMR0dHlavNh1lEawviWmhhYaHTwmkwSOGiUCho8ydHR0d4e3urtMEKCwuhUChUxmO1UeQQ18quri5ERUXpdRQYULXbHqhwIbsSHA4HPj4+9Hty+PBh7Ny5kw5lEwgEqKur01scPAPDo8CYLR6Galuo498wGHK5nN6m1vc27bhx4+Dk5ITOzk4AwJQpUyCVSmlXR1tbW5UobV1BhIH+/v46LZwGgyyKyqOAylebxC+gpKSEdjHkcrlaM2Mio6COjo5qhWtpG5IKam5uPmCUe1/3T/Ke1NfXo6SkhJ5WGK44V9m1MioqSu/hZhRFoaSkBG1tbWrbbZOAs4CAAJw4cQL79u2ji4mNGzfi/v37TE98FMK0LQzDmBVMSqVSujAAHiw2JSUlmDVr1oj0DT09PcjPz4exsTGCg4P1ri8gjond3d0IDQ1VKRBIlDafz0d7ezttDUx0AdpY4JSFiSEhIQZJE9RkokIsFtMCw9bWVhUzJgcHh2EZAJEdFy8vL4OMggqFQuTl5cHe3n5YrSrlaYWWlhba2VHd8ViJRIK8vDyMGzfOIB4iZMdDKBQiPDxcbY2NQqHA7t27sW/fPqSnpyM2Npa+TygU6r3lwvBwiGByWsKfRyyYvJaxnRFMasiY3XnoC9l5GIm+YaTBUiOFCDPNzc0RHR3dzzFROUqbiOnIzLtCoYCDgwM9vTGcK0WZTIaCggI6EVTfwkTlwkXdcCkzMzNMmDABEyZMUDFjun37Ni26HGzscSDIKGRAQABcXFy08bI0QiAQgMfjwc3NbdgeHoOFeZG8CWXb7L6Bb6RVQ1wz9f03IJfLkZ+fD4lEgsjISLU/xwqFAu+88w7+9a9/4fz58wgPD1e5nykcRi/MzoNhYIqH/0GKh+EUDhRF0Ve72gyW0gRSuLi4uKglzCTtDScnJ5Vt6+rqajq0Srm9MdR70dPTQ2+TG8LqWS6Xo7CwECKRaNiFS18zJmWfDSJEJYtm350aIsyrqalBWFiYQUYhtWG+1JeBMknIrkRVVRWMjY3p98Tc3BwFBQW0a6e+d1xkMhny8vIAABEREWp/BuVyOTZt2oSMjAxkZ2fD399fl6fJwPCbYMxapCl/sVEURRcPN2/eRE1NDUQiEdTp6BB9Q2VlJSIiIvReOJDCJS8vD5MnT4avr++worQ5HA4mTpyIadOmYcaMGXBxcUF7ezuuX7+OX375BWVlZWhtbVVp9RAEAgGuX78Oe3t7hIaG6r1wEIvFuHXrFqRSqVZ3PMjIY0REBObMmYOJEydCKpWisLAQ2dnZKCgoQENDA3p7e1FSUoL6+npERUUZpHCoq6tDYWEhpk6dqlNhn7m5OSZMmICQkBDMmTMHQUFBMDExQUVFBW7cuAHgwQ6XUChU6+9HW0gkEuTk5MDY2Bjh4eFqfwalUimSkpJw/vx5rRYO7777Lu0DQ25+fn70/b29vVi/fj0cHBxgbW2Np59+Gs3NzSqPUVNTg0WLFsHS0hJOTk7YvHlzPwv9rKwshIeHw8zMDJMmTcKhQ4e0cv6PFJQWbgwaM+Z3Hoi+wcTEBI899hg9qXDv3j069XAwTUBf/wRt+Reoi7LxUkREhNaMj5T9E4iDIZ/PR3FxMWQyGd3ecHR0REtLC0pLSzFlyhSDqNFJRoauw53GjRuH8ePHY/z48f1El8XFxTAyMoK7uzsUCoVew82Ia2l1dTXCwsL0qjExMjKCvb09KIpCXV0dvL29YWZmhpaWFty7dw8mJiZaD/MaiOG2SsRiMV588UWUlZUhOztb65/fqVOn4vz58/R/K7/+lJQUpKen44cffgCHw8GGDRuwbNky/PLLLwAeXJQsWrQIzs7OuHLlChobG7Fq1SqYmJjgww8/BABUVlZi0aJFWLduHf71r3/hwoULeOmll+Di4oL4+HitvpbRDNO2MAxjVjApk8kgk8kGbVMoL5p8Ph8KhULF0VEoFKKgoMBg/gkSiQQFBQWQyWQICQnRyxgcRVHo6uoCn89HS0sLPdHh6uoKDw8PncVGDwaZqPDw8NAoFVFbkImGcePG0eFmfUWXulw0lT0UwsPDDdKXb25uRlFRUb+pGrlcTue0tLS00GFeyvoRbfx7kUhvOzs7jf4Oe3p6sGLFCjQ1NeHMmTN0HLy2ePfdd/HTTz+Bx+P1u6+jowNcLhdHjhzB8uXLAQBlZWXw9/fH1atXMW3aNJw6dQpPPvkkGhoa6HM7cOAAtmzZAj6fD1NTU2zZsgXp6ekoKiqiH/u5556DQCDA6dOntfp6RiNEMDk9fuSCyStnGMGkpozZtsW1a9cgFAoH1TcYGxuDy+UiICAAs2bNQnh4OCwsLFBZWYmsrCzcunULtra28PLy0nvh0NXVhevXr8PU1FSv8/MsFgtsNhteXl4wNzeHubk5PR9/48YN/PzzzygrK0NLS8uw4s01oa6uDvn5+fDz8zNIuJdQKMTNmzfBZrMREREBd3d3eit/6tSpMDY2RkVFBbKyspCTk4Oamhp0d3dr7fmJMLC9vR3R0dEGKRzq6upQXFyM4ODgfuO4xsbGtHbkscceQ2xsLLhcLlpbW3Ht2jW6FTaSzwr5N3B0dNRo16mrqwvLli2DQCBAZmam1gsHQkVFBVxdXeHj44MVK1agpqYGAJCTkwOpVIq4uDj6WD8/P3h4eODq1asAgKtXryIoKEjl3OLj49HZ2Yni4mL6GOXHIMeQxxgzKKiR33TEBx98gOnTp8PS0nLAneH8/Hz84Q9/gLu7OywsLODv74/PP/+833GjsT01JtsWMpkML7zwApqamvDEE08gISEBCxcupB0Z+0I0ATY2NpBIJOjt7YWLiwtEIhGuXr1KO/VxudxhzcRrwv3791FUVAQvLy+1ooy1TW9vL3g8HoyNjVWstuVyOW0PXVpaCqlUCnt7e7q9oa2RVYqiUFFRgYaGBoSHhxtkFLStrQ35+fkD7ngMJbokWRMjGY+VSqX0Fa0hxKkkYK2qqkrtVgmxzfbw8KB39UjLSyKRqBhUqVMMd3Z2Ijc3V+Opkvb2dixbtgwWFhY4e/aszq40Y2JicOjQIfj6+qKxsRHvvfceZs6ciaKiIjQ1NcHU1LTfYjJ+/Hg0NTUBAJqamvoVNeS/hzqms7OTzvAYE4xih0mJRIJnnnkGsbGxOHjwYL/7c3Jy4OTkhH/+859wd3fHlStXsHbtWhgbG2PDhg0ARm97akwWD+PGjcPt27eRl5eH1NRU/P3vf8eGDRsQExODhIQEJCQkYMqUKSpfSGKxmHbri42NpfUNxJWOODoaGRmptDeG4xMwEMqJnFOnTtXZ1dLD6OzsBI/Ho9X0ygufsuqeoigIhULadKi0tBQ2NjZ0IdF3vE9d5HK5imOhLk2uBoOkQvr5+WHChAlDHj9Q1gSZipDL5SrjseoUWKS/b2lpiaCgIK19vtSlr2ujpgFvwK+7elwuFxRF0QVWc3MzysvLYWlpSftK2NnZ9Suw2tvbwePx6Eh1dbl//z5+97vfwdXVFceOHdPp4rpw4UL6/wcHByMmJgaenp74/vvvx86izoD33nsPAAbdKXjxxRdV/tvHxwdXr17FsWPH6OLhwIED8Pb2xqeffgoA8Pf3x88//4y9e/cyxYMhMDIyQkREBCIiIvDuu++itrYWaWlpSEtLw/vvvw8PDw8sXLgQixYtglgsxq5du7B7924EBwerfGH3DawSCAT0VaZYLFa5+h6uoJJMdHR0dCAqKmpYX9gjpbm5GcXFxfDx8YGnp+dDF38WiwUbGxvY2NjA29sbEomEvvquqqp6aPrlYIjFYvB4PBgZGdFWy/pEOc48JCQEjo6OGj9G3/FYoh+pra1VcXXkcrkDFlhCoRC5ubkGc61UKBQoKSmhA760MdXCYrFgbW0Na2treHl50fbqLS0tKCoqglwuV9mVIFqjKVOmaDTZ1NDQgCeffBJTp07FkSNH9G7eZmtriylTpuDOnTuYN28eJBIJBAKByu5Dc3MzbWrm7OxMT68o30/uI//bd0KjubkZbDZ7TBUoLIxQMPm//yUaLoKZmZnePyfAA02M8sTWYO2p5ORkfZ+aCmO2eFCGxWLBw8MD69evx6uvvoquri6cOXMGaWlpWLZsGSQSCZ544glUVlZi0qRJgwoDifrc3t4eU6ZMoa+oSBARufrWxAZ5sDaBvlDe8QgMDISTk5PGj2FqagpXV1e4uroOmH45VIFFHBNtbW0xdepUgyyaRJioreKN6EfYbDYmTpyoUmDV1NTQO1jE1ZFMlRhKHCqXy2kDsKioKJ19qfadaiE7WI2NjSgtLQUA2nuE6JWGorKyEk8++SRmzpyJb7/9Vu+Ol8CDz/Ddu3excuVK2oPiwoULePrppwEA5eXlqKmpoV0tY2Nj8cEHH+D+/fv039y5c+fAZrMREBBAH5ORkaHyPOfOnVNxxhwTUNSD20h+H+g3bbNjxw68++67Izgxzbly5Qr+85//ID09nf7ZaG1PMcVDH8iX+lNPPYXLly/DzMwM7733HhoaGvD+++8jMTERs2fPptsbEyZMGFQnoXxF1ffq28TEhC4kBtqaBR74J+Tn54PL5RrkSlMul6O0tBTt7e1aWzT7pl/2LbCsra3pQoLNZtPmV4ZaNIndN4nz1tUfat8Ci0wqkMh1iqIwfvx4ODs76/09UNZYREZG6k1jobyDZWZmhs7OTri7u0MikfQLOBus7VNWVoYlS5Zg8eLF2Ldvn97aPG+88QYWL14MT09PNDQ0YMeOHTA2NsYf/vAHcDgcJCYm4vXXX4e9vT3YbDY2btyI2NhYTJs2DQAwf/58BAQEYOXKldi9ezeamprw9ttvY/369fTrXLduHfbt24c333wTL774IjIzM/H999+rLDwM6lNbW6uigRmsQN66dSs+/vjjhz5WaWmpiq+HOhQVFeF3v/sdduzYgfnz52v0u4aAKR4GgQj/bt68CR8fHwDAJ598grKyMqSmpuK///0v3njjDQQFBSEhIQGLFi1CcHDwoAu88uKgLC4k3gnkKpOkPBKbY+IWqO8FQyKRgMfjgaIonUVJD1RgEf1ITU0NbRXu7u5ukIwIsVhMj2LqU5iovINlYWGB27dvw8XFBWKxGFevXqVFl4NpArSJWCxGbm4uzM3N+7Xs9EVNTQ3u3Lmj4typ7LVRW1uL4uJiOuCsp6cHfn5+KCkpwZIlS7B69Wp8/PHHei2+6+rq8Ic//AGtra3gcrmYMWMGrl27Bi6XCwDYu3cvjIyM8PTTT0MsFiM+Ph779++nf9/Y2BgnT55EUlISYmNjYWVlhdWrV+PPf/4zfYy3tzfS09ORkpKCzz//HG5ubvjmm2/GlMcDoD2fB7ITOBSbNm3CCy+88NBjyJqhLiUlJZg7dy7Wrl2Lt99+W+W+0dqeGrM+DyOFoijw+Xykp6cjLS0N586dg62tLa2TmDVrlloLrnLvm8/nQygUwtTUFFKpVG1RnrYhbQIOh0OPHeoTMlFRW1tL97l7e3thZ2dH70ro+o9GJBIhNzfXYK0SiqJw9+5d1NbWIiwsjO6NE9El8U8gpl3ajNImdHd30++BLg24BoO0zIjl98PSacViMa2VePbZZyEQCGBiYoLHH38cX3311bA0KgyjG+LzMOPxdzFu3Ah8HmS9+Pniuzr1eTh06BCSk5MhEAj63VdcXIwnnngCq1evxu7du/vdv2XLFmRkZKCwsJD+2R//+Ee0tbUZ1M+DKR60RE9PDy5cuIC0tDScPHkSXV1dmDt3LhISErBgwQLY29sPeeVMtoe7u7thaWmJjo4OWFhYqLhc6vrqm8/no6ioyKC99eLiYnR2diIsLIyeqFAeeRQIBLCysqILCW2Px7a3tyM/Px8TJkzApEmT9P4eKBQKlJaWoq2tDWFhYYN6OJDCkxQS5MuPFBJsNnvY597V1YXc3Fw65E3f7wEpIBsbGxEREaGRj0VmZibeeOMNuLm50cLLadOm4cKFCwYRwDHoBlI8zJyzY8TFw+Ws93RSPNTU1KCtrQ2pqanYs2cPLl++DAC0dq6oqAhPPPEE4uPjsWfPHvr3yEQS8ECzExgYiPXr19Ptqf/7v/9Denq6QXeZmOJBBygUCty6dQupqak4efIkioqKEBsbS+skBlqQRCIReDweLC0tERgYCBMTExXlOZ/PBwCVMVBtCr8oikJNTQ3u3r2rVpS1LiCtEgAIDQ0dVByqPB5LIqNJITHS94VMlWiq5tcWysLEsLAwjSZ0iK6GxIv3FV2q+76QUUhDRYpTFIXS0lK0trYiIiJCo6mOM2fOYOXKlfjkk0/wyiuvgMViob6+HlevXqXdHBl+GzwKxcMLL7yAw4cP9/v5xYsXMWfOHLz77rv0OKcynp6eqKqqov87KysLKSkpKCkpgZubG955550hWye6hikedAxFUaiurkZqairS0tKQnZ0NHx8fWicRFRWFtLQ0VFRUYOnSpYNe6ZJoZNLe6O7upqcUuFzuiHI1lKcJQkNDH7o9rCuEQiF4PB7YbLZGrRKFQkFHRpP3hbQ3uFyu2u0N8u907949BAUF0VW/PiHFE4vFGnHAmLLosqWlhX5fhrKHJh4UhiqeFAoFioqKIBQKER4ervbnmqIonDhxAi+//DIOHDiA559/Xu9FD4N+oYuHWVooHi7ppnj4LcMUD3qEFACnT59GWloaMjIyYGxsDKFQiFdeeQVvvfWW2tuzfbfxyZTCYB4BgyGVSlFQUACJRKLxla62II6N7u7uI7aa7u7upt+X9vZ2WFpa0rsSg7V9KIpCeXk5mpubDVY89fT0IDc3F9bW1ggMDNS6zqSnp4feqWlvb6dD35RFl0SkGxgYaBATMrLrIhaLER4ervZYMkVROHLkCJKTk/H//t//o8cfGX7bkOJh1sztIy4eLl3+M1M8aMiYzbYwBCwWC7a2tnjuuefw7bffYunSpaAoCsuWLUN6ejo8PT3x9NNP4+DBg2hoaHhopDFxLYyMjMTs2bPh6ekJkUiEnJwcXL58GSUlJeDz+Q/NDRCJRLhx4waMjY0RFRVlkMKhvr4eeXl58PX11Yq+wNLSEh4eHiox2sQdNDs7m7YHlkqlAH5dsFpbWxEdHW2QwqGrqws3btyAg4ODziYaLCws4OHhgfDwcMyZMwdTpkyh9SVZWVm4cuUKSkpKDOZeKpPJkJeXB6lUioiICI0Kh4MHD+L111/Hjz/+qLPCYdeuXWCxWCrGPEysNsNYhhnVNBAHDx5EQUEB8vPz4ebmRovkTpw4gX//+99ISUlBaGgo3d54mOLfxMQELi4ucHFxUTFhKisrg0QioS2QuVwu/aVMrvYnTJiAyZMnG6SvrTxNoOyopi36Gg6Rtk9lZSWKiorA4XDQ29sLExMTREVF6d2AC/j130Gf+gJjY2Pa6ZJ87pqammBlZYWioiJUVVXR2pqRiC7VRSKR0COxERERahdPFEXhiy++wK5du5CWloY5c+bo5Pxu3ryJv/3tbwgODlb5OROrPUoYxdkWv2WYtoWBkMvlkEgkA/bkKYpCU1MTMjIykJqaivPnz4PL5dJjoDNmzFBroSMOfcoR2mw2G6ampmhpaYGfn5/BRIFkoiI0NNQgiZDEfIrFYkEqldJTLaS9oY+xRCLO9PX1NchIrrIwMTw8HFZWVipeG62trWCxWCpW4tr2uiA+EiSrQ933XaFQ4KOPPsKBAweQkZGBmJgYrZ4XgWgv9u/fj507dyI0NBSfffYZE6s9CqDbFo+9M/K2xS/vM20LDWF2HgyEsbHxoGI+FosFFxcXJCYmIjExESKRCBcuXEBqaipefvll9PT0IC4uDgkJCYiPjx+0l6/s0Ofj44Pe3l4UFxfTEwpVVVUQiUQjSnjUFOWJCkNkVAAPnDsLCgrg6uqKyZMn0ymPRCyoUCjo3RpHR0edmEMR4yNDiTMVCgUKCwshEolUWlampqYqu1hEjEqcLm1tbWnRpZWV1Yh2JXp6epCTk6Oxj4RCocCf/vQnfP/998jMzERISMiwz2Eo1q9fj0WLFiEuLg47d+6kfz5UrPa0adMGjdVOSkpCcXExwsLCRm1uAQPDUDDFwyOAlZUVlixZgiVLlkAul+PGjRtITU3F3r178corr2D69Ol0e2OwmG6ZTIbS0lKIxWJMnz4dZmZm/RZM5TFQXSyYIpEIeXl5Gk9UaBMSaT5p0iR4eHgA6B9Y1dnZCT6fj+rqahQXF4PD4dCFxEgXTIqicOfOHdTX1yMiIsIgGguZTIb8/HzI5XJERkYOWsAZGRnBzs4OdnZ2mDx5Mnp6emgx6t27d2FmZqbidKnJvyfR5zg5OcHX11ft91QulyM5ORlnz55FVlaWxhbAmnD06FHk5ubi5s2b/e5jYrVHD9pymGTQDKZ4eMQwNjZGbGwsYmNj8eGHH+LevXv0GOjbb78NX19fur1B+sfl5eW4c+cOXFxcVGyWlWORyYJJ9ADKbo7aSE8kvX03NzeDGC8Bv17tPyzgi8VigcPhgMPhYNKkSejt7e23YPadUlAXkkpJskIMESlO9AUmJiYIDw/XyBPDwsIC7u7ucHd3p3drWlpaUFpaSmtrSDHxMPFtZ2cncnNz4ebmptF0jVQqxbp163Dz5k1cunQJ3t7eap+7ptTW1uK1117DuXPnDCIkZtAALQVjMWgGUzw8wrBYLEycOBEpKSm09WlGRgbS0tKwdOlSmJmZYfr06bhw4QLWrFmDnTt3DrjY9V0wyVgfiRa3srKidyWG4+ZIRgANZbdN3AobGhoQHh7e72rxYZibm8PNzQ1ubm4q7Y3i4mLI5XKVBfNhLRi5XI78/HyIxWKDTbaQcVAbGxsEBgaOqE1FHPBI8amcfkkCzsj7ovyZIQZU3t7e8PLyUvv5xGIxXnjhBVRUVCA7O1vnn6OcnBzcv38f4eHh9M/kcjkuXbqEffv24cyZM0ysNsOYhikefiOwWCzY2dlhxYoVWLFiBcRiMXbs2IFPP/0Uvr6++Prrr3Hnzh3aLnv8+PGDFgFkrM/Dw0PFzTEvL492LSTtjYdtVVMUhXv37qGmpgahoaFwcHDQ1csfFGVx5kiv9vsumCSTpLa2FiUlJWCz2fT9yu0NcrVvbGys11RKZYRCIXJzc+mEVm3u/Chra7y9vWnRZUtLC/Ly8mjRpZmZGWpqauDr66uRULe7uxt//OMf0dLSguzsbL1oRObOnauSJQAAa9asgZ+fH7Zs2QJ3d3cmVnuUwFI8uI3k9xk0h5m2+I3y1VdfYdu2bfj+++8RFxeHwsJCpKWlIS0tDTk5OYiIiKB1EurGfRPXQrIrIRaLaZfLvlvVCoUCxcXFEAgED81n0CUkK4SiqIfaXWsDsVhMT7W0trbC1NSUNuyqrKwEm80e8dX+cOno6EBeXh7c3d31nldCRJfV1dW0xbqtra3aGpLOzk4888wzUCgUOHnyJOzs7PR16v2YM2cOPW0BAElJScjIyMChQ4foWG0AuHLlCoAHhWtoaChcXV3pWO2VK1fipZdeUhnVHI25BY8CZNpiTvRbI562yLrxATNtoSFM8fAbpaamBkKhkL7CIVAUhYaGBpw8eRJpaWnIzMyEs7MzXUhMnz5drStjiqLQ3d1NFxIdHR2wsbGhJzfu3LlDL9qGCCMiW/RWVlYICgrSqziTRK7X19fj/v37KuOO2k6+HIrW1lbk5+erCET1TUNDA8rKyhAUFARra2vaMrutrY0usgYSXba1tWHp0qVgs9n46aefYGNjY5DzJ/QtHnp7e7Fp0yb8+9//VonVVs6Fqa6uRlJSErKysuhY7V27dqloTUZjbsGjAF08RGmheLjJFA+awhQPYxyhUIizZ88iLS0N6enpkEqlmD9/PhISEjB//ny1TYJIKFNjYyPa2o0Z7goAACAASURBVNpgZGQEFxcXjB8/XmNh4Ujp6OgAj8fD+PHjNVLya5PW1lYUFBTAy8sLDg4O9ILZ2dlJF1lcLhfW1tY6O7+mpiYUFxcjICAALi4uOnmOoSAi1dDQ0H5GYMqiy5aWFkgkEgiFQlRUVGD27NnYuHEjPDw88MMPPzD9f4Z+MMWDYWGKBwYauVyOq1ev0mmgd+7cwYwZM+g0UE9Pz4cudCTK2sXFBfb29vSUgkwmo8VzQwkLRwoZPfXx8RnyfHVFY2MjSkpK4O/vD1dXV5X7SJFFTJjGjRtHX3nb29trbYektrYWFRUVCA4OhqOjo1YeUxMoikJlZSWqq6sRHh4+5EgqRVEQiUQ4c+YMPv74Y5SWloLNZuOVV17BkiVLEBMTY5DRXobRCykeHo/804iLh4u3PmSKBw1higeGASETCmQM9MqVK/D396fbG2FhYSq7CXV1dSgvL+8nhlMWFvL5fAiFQto3gQgLtQU5h6lTpxokUhx4sE199+5dtRZtZStxPp8PiUQyqIZEXZQX7bCwMI0mS7QF+ew0NjYiPDxco3bD3bt38eSTT2LmzJlYsGABTp8+jVOnTuHll1/Grl27dHjWDI8adPEQsW3kxUPOR0zxoCFM8cAwJBRFoa2tDenp6UhLS8PZs2dhZWWFhQsXIiEhAefOncPt27dx+PDhIScqent76cWyra2NtoUmY6DDaW8o52SEhoYaRFSnPA4aFhamsfkTufImosuOjg46KdXR0VGt9pFyOmhERIRBRKoDWV6rS0lJCZYsWYJly5bhiy++oD8LcrkcIpGI+WJnUIEpHgwLUzwwaExvby+ys7Nx7NgxHDlyBEZGRpg9ezY9BsrlctVqF8hkMto3gSjxlcdA1TEwGg1THeQcOjo6EBYWppXdlL4ZE0ZGRnQhMdCIrPI5REREGEQjQM6hs7MTERERGu2c8Hg8LFmyBC+//DI++OADg0ylMDxa0MVD+DaMMx5B8SDvxcVcpnjQlDH9F/rll1/Cy8sL5ubmiImJ6WfowjAw5ubmiIqKQllZGfz8/PDDDz8gPDwc33zzDSZNmoR58+bhL3/5C8rKyh4aK05soadOnYrZs2fTkxl3795FVlYWcnNzUVtbi97e3gF/XyqVIjc3FyKRCNHR0QYpHEiUNMmI0FYbhmRMBAcHY/bs2fTEyO3bt1Xem56eHsjlcvB4PPocDFE4EBMsoVCosQnWtWvXsGjRIqSkpODDDz/USuHw1VdfITg4GGw2G2w2G7GxsTh16hR9PxOn/duBRVEjvjFozpjdefjPf/6DVatW4cCBA4iJicFnn32GH374AeXl5YNaFzP8SlFREXbv3o0DBw7Q9tUURaGuro72k7h48SLc3d1pu+xp06apbZAkEoloYaFAIOi3hU/SGC0sLBAUFKSRzbK2EIvFtNVzSEiI3s5Bub0hEAjAYrFgamqKgIAA2Nvb610kKpPJwOPxoFAoEBYWppEJVnZ2Np599lm8//77+L//+z+tnXtaWhqMjY0xefJkUBSFw4cPY8+ePcjLy8PUqVORlJSE9PR0HDp0iI7TNjIyUonTDg0NhbOzM/bs2UPHab/88sv9PBrWrVuHl156CRcuXEBycjLj0aAnyM7DE2FbR7zzkJm3i9l50JAxWzzExMQgKioK+/btA/Bgy9Xd3R0bN27E1q1bDXx2jz7EsvjMmTNIS0tDRkYGFAoF4uPjkZCQgLi4ONjY2Ki1WEilUpUJBRaLBblcDjs7OwQFBRnEsbG7uxu5ubngcDiYOnWqQbbZe3t7kZubCyMjI1haWtLtDTLVom7rZyRIpVLaPVPTAiojIwMvvPACPvvsMyQmJuq86LG3t8eePXuwfPlyJk77NwBdPIRuxTjj4XunyORiZPKY4kFTxmTbQiKRICcnRyUK18jICHFxcbh69aoBz+y3A7EsXr58OQ4fPozGxkYcP34cLi4ueP/99+Hp6YmnnnoKf/vb31BbW/vQ9oaJiQm9hR8YGAi5XA4bGxuIRCJcunQJPB4P9fX1kEgkenltHR0duHHjBpycnAzmGikSiXDz5k1wOBxER0fT7Y3g4GCYmJiotH5qamrQ09Oj9XMQi8W4desWTE1NERoaqnbhQFEUjh07htWrV+Pvf/+7zgsHuVyOo0ePQiQSITY2dsg4bQCDxml3dnaiuLiYPmagOG3mO0TPkGCskdwYNGZMZlu0tLRALpcPGIVbVlZmoLP6bTNu3DjMmjULs2bNwieffIKysjKkpqbi2LFj2Lx5MwIDA5GQkIAnn3wSwcHBAy7IJGCLmB6R3Q0+n4/6+nraG2CgfAlt0dLSgoKCAvj4+GgU7KRNOjs7kZeXB1dXV5WEUuUI7SlTpqg4gN6+fRuWlpYqky0jeW96enqQk5MDW1tbBAQEqF1AURSFf/7zn9i0aROOHDmC3/3ud8M+h6EoLCxEbGwsent7YW1tjePHjyMgIAA8Ho+J02ZgGCFjsnhgMCwsFgv+/v7w9/fHm2++iZaWFtou+69//StsbW1pncTMmTNhamqKvXv3IigoCJGRkbRToXIgk4+Pj0q+xL179+j4bGKZPdIdgr7FiyEg0ebqpFJaWlrC09MTnp6ekEql9GQLj8cDAJX2hiatH5FIhJycHI1DtiiKwtdff40dO3bg+PHjmDdvntrPORx8fX3B4/HQ0dGBH3/8EatXr0Z2drZOn5PBACgAjOQagQnGGhZjsnhwdHSEsbHxgFG4hjIXGquwWCxwuVysWbMGa9asQU9PDzIzM5GWlob169ejo6MDPj4+aGhowNGjRx/q4WBmZjZgfHZhYSEUCoXKGKgmiyVFUaiurkZlZaXB0kEB4P79+ygqKoKvr6/GkdQmJiYYP348xo8fD4qi0NHRAT6fj8rKShQVFcHOzo5+f4gAdiC6urqQk5ODCRMmqOx6DAVFUdi7dy8+/fRTpKenY+bMmRqd/3AwNTXFpEmTAAARERG4efMmPv/8czz77LNMnPZviJFOTDDTFsNjTBYPpqamiIiIwIULF/DUU08BeCCYvHDhAjZs2GDgsxvbWFhYYNGiRVi0aBEEAgEWLFiAqqoq+Pj4ID4+HrGxsbRd9sMWr77x2Z2dnf0WSzK98bDFkqIo3L59G01NTYiIiDCYoKq+vh7l5eUIDAwc8TQQi8WCra0tbG1tMXnyZPT09NA7NhUVFbRxl6Ojo8qOjUAgQF5eHry8vODt7a328ykUCuzcuRPffPMNzp49i6ioqBGd/3BRKBQQi8WIiIhg4rR/S4xUt8AUD8NiTAomAeD111/H3//+dxw+fBilpaVISkqCSCTCmjVrVI67dOkSFi9eDFdXV7BYLPz0008q91MUhe3bt8PFxQUWFhaIi4tDRUWFyjFtbW1YsWIF2Gw2bG1tkZiYCKFQqHJMQUEBZs6cCXNzc7i7u2P37t26eeGPEM8++yzYbDZu376Na9eu4c6dO/j973+PixcvIjo6GhEREXjrrbdw5cqVfvP3yrBYLHA4HEyaNAmxsbF47LHHwOVywefzceXKFVy5cgUVFRUQCAQqwk2FQoHCwkLw+XxERUUZrHCoqqrC7du3ERoaqpMxYgsLC3h4eCA8PBxz5szB5MmTIZVKUVhYiOzsbBQWFqKiogI5OTmYNGmSxoXD1q1bcfjwYVy8eFFvhcO2bdtw6dIlVFVVobCwENu2bUNWVhZWrFgBDoeDxMREvP7667h48SJycnKwZs0axMbGYtq0aQCA+fPnIyAgACtXrkR+fj7OnDmDt99+G+vXr6dTUdetW4d79+7hzTffRFlZGfbv34/vv/8eKSkpenmNDAyGZEzuPAAPFiY+n4/t27ejqakJoaGhOH36dD8BlEgkQkhICF588UUsW7as3+Ps3r0bX3zxBQ4fPgxvb2+88847iI+PR0lJCW2Us2LFCjQ2NuLcuXOQSqVYs2YN1q5diyNHjgB4IICbP38+4uLicODAARQWFuLFF1+Era0t1q5dq/s3Y5Syb98+eHl50S0GLy8vbNy4ERs2bEBnZydOnz6NtLQ0/P73v4exsTEWLFiAhIQEzJ0796GGUWSx9PDwgFQqpZ0c8/Ly6FFHe3t71NfXQy6XIzo6WqdhXoOhnBGhr10PYtzl5ORE79hUVVWhqqoKwAORoFwup9sbD2tbyGQyvPbaa8jMzER2djamTJmi8/Mn3L9/H6tWrUJjYyM4HA6Cg4Nx5swZWmexd+9eGBkZ4emnn1aJ0yYYGxvj5MmTSEpKQmxsLB2n/ec//5k+xtvbG+np6UhJScHnn38ONzc3fPPNN4zHg75hdh4Mwpj1eRgOLBYLx48fp1sdFEXB1dUVmzZtwhtvvAHgwRjf+PHjcejQITz33HO0wO7mzZuIjIwEAJw+fRoJCQmoq6uDq6srvvrqK7z11ltoamqiF6mtW7fip59+YqY/1EAqleKXX37BiRMncPLkSdTW1mLOnDlISEjAwoUL6V2joVAoFBAIBGhqakJDQwMoioKDgwOcnJyGHVQ1XBQKBUpLS9HW1qZxRoQ2aWhoQFlZGQIDA8Fms+n2RltbGy1IdXR07Be7LpVKsXbtWuTl5eHs2bMGm0xh+O1CfB7m+m8asc/DhdJPGZ8HDRmzbQttUFlZiaamJpVZbw6Hg5iYGJV5cVtbW7pwAIC4uDgYGRnh+vXr9DGzZs1SubqNj49HeXk52tvb9fRqHl1MTEwwZ84c7N27F7dv30Zubi5mz56N//znP/D398esWbPw0UcfoaCgAArF4NJqIyMjmJmZobW1FePHj8e0adNgb2+PxsZG/Pzzz7h+/Tru3buHrq6uh/pSjBS5XI6CggJ0dnZq1fJaU2pra1FWVoaQkBA4OTnRLbWwsDDMmTMHvr6+kMvlKCoqQnZ2NrKzs7F//35UVVXh+eefR3FxMbKzs5nCgYHhN8iYbVtoAzLvPdCst/IseN8+9bhx42Bvb69yTN8+svJMuSFSIh9VWCwWAgICEBAQgK1bt6K5uRnp6elITU3FX/7yFzg6OtJjoDNmzKD718ADbUpBQYHKJIGNjQ28vLwgkUhol8uqqiqYmJjQgsy+V90jQSqVIj8/HwqFApGRkQZxzwQeFMZVVVUIDw8fMNa7ryC1q6sLly9fxtdff40tW7bA0tISycnJaGtrg7Ozs94tsxnGEMyopkFgigeG3ywsFgvOzs5ITExEYmIiuru7cf78eaSlpWHt2rXo6elBXFwcEhIS0Nvbi08++QQ//fQTPd6njKmpKVxdXeHq6gq5XI729nbw+XwUFxdDJpPBwcGB3sIfrj6CZGWYmpoiLCysX3KmPqAoCnfu3EFDQwMiIyNhY2Mz5O+wWCyw2WzMmDEDXC4XTk5OeOaZZ5CZmYlPP/0UTz/9NP7xj3/o4ewZxiLMqKZhYIqHEUDmvZubm1VMg5qbmxEaGkofc//+fZXfI1HUQ82LKz8Hw8ixtLTEkiVLsGTJEsjlcty8eROpqanYvn07mpubMWvWLJw6dQoJCQnw8fF56BgoMVjy8/NDV1cX+Hw+ampqUFJSAg6Ho+JyqQ7EsdGQWRkURaGsrAwtLS2IjIzUqF3S2tqKp556Cvb29jh+/Disra3x2muv0WOgDAwMvy0YzcMI8Pb2hrOzMy5cuED/rLOzE9evX1eZFxcIBMjJyaGPyczMhEKhwI0bNxAVFYXvv/8eqampWLJkCcrLywE8mBf39fWFhYUFEx2sA4yNjRETEwMrKysIhUIcPnwYixcvxtmzZxEREYHo6Gjs2LED169fh1wuH/RxyFX3xIkTMW3aNMyYMQPOzs5oa2vD1atX8csvv+D27dtob28fVG8hFApx8+ZNODo6GiwrQ6FQoKioCG1tbRoXDk1NTVi4cCHc3NyQlpamMulCJlsYGHQGk21hEJjiYQiEQiF4PB5t6VtZWQkej4eamhqwWCwkJydj586dSE1NRWFhIVatWgVXV1d6IsPf3x8LFizAyy+/jBs3buCXX37Bhg0b8NxzzyEvLw/r169HVlYW7OzskJubi8cffxyHDx/G559/jtdffx0pKSlIS0vDDz/8gOzsbDQ0NKiMjMrlcixatAgSiQRXrlzB4cOHcejQIWzfvp0+prKyEosWLcLjjz8OHo+H5ORkvPTSSzhz5ox+38xRRk9PD37++WdcunQJf/zjH5GcnIzz58+jubkZb731Furq6rBs2TJMmjQJSUlJOHnyJEQi0UMfk4gK+3om5Ofn49KlSygqKkJzczNd3AkEAty8eRNubm7w9fU1iDaACDSFQiEiIyM1ckesqanB/PnzERQUhB9//FFrEykfffQRoqKiYGNjAycnJzz11FN0YU3o7e1lCmsGQEGN/MagMcyo5hBkZWXh8ccf7/fz1atX49ChQ6AoCjt27MDXX38NgUCAGTNmYP/+/Soz7W1tbdiwYQPS0tLo2fIvvvhC5QqtoKAAa9euxfXr1+Ho6Ig33ngD69atY6KDDYxEIsHly5fpMdCmpiY8/vjj9Bjo+PHj1VrwlS2h+Xw+uru7YW1tDaFQCB8fH/j4+Ojh1fRHJpMhPz8fcrkcYWFhGgk0KyoqsGTJEsybNw9/+9vftKrRWLBgAZ577jlERUVBJpPhT3/6E4qKilBSUkLviiQlJSE9PR2HDh0Ch8PBhg0bYGRkhF9++QXAg6IoNDQUzs7O2LNnDxobG7Fq1Sq8/PLL+PDDDwE8KKwDAwOxbt06vPTSS7hw4QKSk5ORnp7O+DWMcsioZtzE5BGPap6/+xkzqqkhTPEwirhz5w4mT56MwsJCBAYGIjMzE3PnzkV7e7uK4t3T0xPJyclISUnB9u3bkZqaSu+MAA++EH18fJCbm4uwsDDMmjUL4eHh+Oyzz+hjvvvuOyQnJ6Ojo0Ovr/FRRqFQoLi4GCdOnEBaWhpycnIQHh6OhIQELFq0CP7+/mq3HKqqqnDnzh1YWlrShQQRXLLZbL3sQEilUuTl5cHY2BghISFqR2oDQElJCRYvXozf//73tOGSLuHz+XByckJ2djZmzZqFjo4OprAe49DFg89rIy8e7n3OFA8awrQtRgkKhQLJycl47LHHEBgYCAC0aZSuo4MZ1MPIyAhBQUF4++23ce3aNVRXVyMxMRG3bt3C7NmzERQUhM2bNyMrKwsSiWTQx6mpqcG9e/cQFhaG6dOnY/bs2fD09IRIJEJubi4uX76MkpIS8Pn8h+otRoJYLMatW7dgamqK0NBQjQqH3NxcxMfHIzExUS+FAwC6yCWJqjk5OZBKpSoeK35+fvDw8FDxWAkKClL57MfHx6OzsxPFxcX0McqPQY4hj8HwKDBSvQNz/TwcmGmLUcL69etRVFSEn3/+2dCnwqAGLBYLEyZMwCuvvIJXXnkFQqEQ586dQ1paGtasWQOJRIL58+cjISEB8+bNA4fDAUVROHHiBOzs7BAREQEOhwPggcmVi4sLXFxcoFAo6DHQsrIySCQSlTFQZV+K4dLT04Pc3Fyw2WyNJzuuXLmC5cuXY+vWrdiyZYtedkgMWVgz6ZiPAIw9tUFgdh5GARs2bMDJkydx8eJFuLm50T93dnamo4OV6RsdPNSYJxMdrHusra2xdOlSfPvtt2hoaMDJkyfh5eWF3bt3w8vLC08++SSWLFmClJQU+Pn50YVDX4yMjODg4AA/Pz/MmDED0dHR4HA4qK+vx+XLl3Hjxg1UVlZCKBQOy+VSJBLh1q1bsLe313iyIzMzE0uXLsX777+vt8IB+LWwPnr0qF6ej4FBW3zwwQeYPn06LC0tBzRbU6a1tRVubm5gsVj9vvNHo6iXKR4MCEVR2LBhA44fP47MzMx+LpPK0cGEgaKDCwsLVbwkBooOVn4McgwTHawbjI2N8dhjj+Hjjz9GUVER8vLyIBAIcOvWLQDAU089hffeew+3bt0acgzUxsYG3t7eiI6OxsyZM+Hq6oqOjg5cv34dv/zyC8rLy9HW1vZQ221CV1cXbt26BWdnZ/j5+Wm0+J88eRLPPfccPv/8c2zYsEFvhQNTWDMMySietpBIJHjmmWeQlJQ05LGJiYkIDg7u9/PROi3HFA8GZP369fjnP/+JI0eOwMbGBk1NTWhqaqJ1CNqIDv7qq69w4sQJFBUVwczMDKGhoVi/fj0dHcyMu+kWhUKBTZs2wdjYGHfu3EFpaSk2b96MyspKLF68GL6+vtiwYQNOnTo1pP7EzMwMbm5uCA0NVcmWUI7ObmpqglQq7fe7pHjx8PDA5MmT1V78KYrC999/jzVr1uDgwYNYs2aNXgoHprBmUBtKMfKbjnjvvfeQkpKCoKCghx731VdfQSAQ0AGLyhw4cADe3t749NNP4e/vjw0bNmD58uXYu3evrk5bPSgGg4EHSp1+t++++44+pqenh3r11VcpOzs7ytLSklq6dCnV2Nio8jhVVVXUwoULKQsLC8rR0ZHatGkTJZVKKYqiqNTUVCo9PZ36xz/+Qfn5+VFGRkYUAGrnzp0URVHUunXrKHd3d+rChQvUrVu3qGnTplHTp0+nH1smk1GBgYFUXFwclZeXR2VkZFCOjo7Utm3b6GPu3btHWVpaUq+//jpVUlJC/fWvf6WMjY2p06dP6/Dde3T417/+RXV2dvb7eU9PD3XmzBnq1VdfpTw8PCgrKyvqySefpL766iuqsrKSEgqFlEgkGvImFAqphoYGKj8/nzp//jx14sQJ6tKlS1RpaSnF5/OpmpoaKi0tjSorK1Pr8ZQfd//+/ZSVlRWVmpqq1/csKSmJ4nA4VFZWFtXY2Ejfuru76WPWrVtHeXh4UJmZmdStW7eo2NhYKjY2lr6ffHbnz59P8Xg86vTp0xSXyx3ws7t582aqtLSU+vLLL5nP7iNCR0cHBYCK83iVWuCVMuxbnMerFACqo6NDZ+f63XffURwOZ8D7iouLKWdnZ6q6upq6ePEiBYBqb2+n7585cyb12muvqfzOt99+S7HZbJ2drzowo5pjEHt7e+zZswfLly9nxt1GCQqFAvn5+UhNTUVaWhp4PB6ioqKQkJCAhIQE+Pr6qq1PIJbQfD4f7e3toCgKjo6O8Pb2BofDUduXYv/+/Xj//fdx/PhxzJ07d6QvUSMGO8fvvvsOL7zwAoAHJlGbNm3Cv//9b4jFYsTHx2P//v0qlu7V1dVISkpCVlYWrKyssHr1auzatUtluiQrKwspKSkoKSmBm5sb3nnnHfo5GEYv9KimexLGGY1gVFMhxvnar1BbW6syqmlmZqYVgTIAHDp0CMnJyf3abGKxGNHR0di8eTOef/552ldIeTx/ypQpWLNmDbZt20b/XkZGBhYtWoTu7m6DtdeYtsUYQi6X4+jRoxCJRIiNjWXG3UYRRkZGCAsLw44dO3Dz5k1UVlZi5cqVuHLlCh577DGEhoZiy5YtuHTp0oBtCWWIJbSrqyuAB74gJiYmyMvLw6VLl1BcXIz79+8PqregKAp79uzBRx99hFOnTum9cCDnMNBNeVE3NzfHl19+iba2NohEIhw7dqxfFoynpycyMjLQ3d0NPp+PTz75pN9Y6pw5c5CXlwexWIy7d+8yhcOjhpY0D+7u7uBwOPTto48+GvDptm7dChaL9dBbWVmZWqe+bds2+Pv74/nnn9fa26EvmFHNMUBhYSFiY2PR29sLa2trHD9+HAEBAeDxeMy42yiExWLB3d0dr776Kl599VV0dXXhzJkzSEtLw8qVK6FQKBAfH4+EhATExcXBxsam35V6bW0tKioqEBYWBgcHBwAPdjcEAgH4fD5u374NsVgMe3t7cLlc2Nvbw9LSEgqFAu+++y4OHz6Mc+fOISIiwhBvAQOD3hlo52EgNm3aNGSBqa5jbGZmJgoLC/Hjjz8CAD1B5ejoiLfeegvvvffeqBX1MsXDGMDX1xc8Hg8dHR348ccfsXr1amRnZxv6tBjUxMbGBsuXL8fy5cshk8lw5coVpKamYufOnUhMTMSsWbPo9oabmxs+/PBD+Pj4YOHChSqFoZGREezt7WFvb48pU6bQV+ONjY3YtGkTKioqMGHCBBQWFuLixYu0pwIDw6hGSz4PbDZbLYdJkpirDf773/+qCKVv3ryJF198EZcvX8bEiRMBPBD1ZmRkqPzeaBD1Mm2LMYCpqSkmTZqEiIgIfPTRRwgJCcHnn3/OjLs9gowbNw6zZs3CJ598gtLSUuTn52PevHn0blJYWBj27dsHAA/9ImSxWLCysoKXlxeioqKwZ88eTJkyBaWlpRCJREhISKD9FRgYRjUURpiqqbtTq6mpoYMU5XI5HbIoFAoBABMnTkRgYCB9I1NF/v7+cHJyAgCsW7cO9+7dw5tvvomysjLs37+fnpYzJEzxMAZRKBQQi8U6GXfbtWsXWCwWdu3aRT8GMw6qG1gsFvz8/PDmm2/i4sWLWL16NVpaWjBr1iwkJyfDz88Pr732Gs6ePYve3t5BH0cikeDtt99GeXk5rl27htbWVnz99degKAqtra16fEUMDL8ttm/fTmuZhEIhwsLCEBYWRnu+qIO3tzfS09Nx7tw5hISE4NNPP8U333xj8OA2ZtriN862bduwcOFCeHh4oKurC0eOHMHHH3+MM2fOYN68eUhKSkJGRgYOHToENpuNjRs3AnhgQwz8mkzo6uqK3bt3o6mpCStXrsRLL73UL5lw2bJluHjxIgCgoaEBp06dQnx8PJN+qAd27dqFgwcP4vz58/D09ERPTw8uXryI1NRUpKenQyAQYO7cuUhISMCCBQvg4OAAFouFnp4erFq1CnV1dThz5kw/wSEDw2iFnrZwXotxRqbDfhyZQoLzTV8zwVgawhQPv3ESExNx4cIFNDY2gsPhIDg4GFu2bMG8efMAaG/c7dSpU1i6dCnkcjnGjRuHmTNn4uzZs0z6oZ7o6OhAT0/PgIu/QqFAbm4uUlNTcfLkSRQUFGDatGmIi4vD6dOnQVEUMjIyaGElA8OjAF080CM5RQAADCxJREFUOL008uLh/jdM8aAhTNviN87BgwdRVVUFsViM+/fv4/z583ThAGhv3O3o0aNISkqCVCpFTEwM3dJgxkH1A4fDGXTXwMjICJGRkfjzn/+MnJwc3L17F8899xyOHTuGe/fu4ezZs1ovHC5duoTFixfD1dUVLBYLP/30k8r9FEVh+/btcHFxgYWFBeLi4lBRUaFyTFtbG1asWAE2mw1bW1skJibSvWJCQUEBZs6cCXNzc7i7u2P37t1afR0MjwAj0juMUGw5hmGKB4YRc/ToUeTm5g44F83Eio8uWCwWPD09sWHDBuTn56Ourm7QkK6RIBKJEBISgi+//HLA+3fv3o0vvvgCBw4cwPXr12FlZYX4+HgVbcaKFStQXFyMc+fO4eTJk7h06RLWrl1L39/Z2Yn58+fD09MTOTk5/7+9e4+psv4DOP4+cDgyLSAxOJ5aShdRIANE0GUuwu0Ep62SpRIlUcAiULkYtVlE2shpKdkKZtMOLWHKKqblAC+DSkCNxoaXKIokp3RZkoMhBzjP7w92np9PeRnXg/J5bc/G4flynu/3/HM+fC+fD5s3byYvL4/t27eP+HiEEFpyVFMMy2+//caaNWs4cOAA7u7uzu6OGASdTofBMPTp3muJjo4mOjr6ivcURaGgoIDXXnuNxx9/HIBPPvkEX19fysvLWbFiBadPn6aiooLjx48TFhYGwPvvv09MTAzvvPMOJpOJXbt2YbPZ2LlzJwaDgcDAQBobG9myZYsmyBA3OSnJ7RQy8yCGpaGhgT/++IPQ0FD0ej16vZ6amhq2bduGXq/H19dXjoMKjdbWVtrb2zXLUJ6enkRERGiWsry8vNTAAWDJkiW4uLhw9OhRtc3ixYs1AZDZbKa5uZkLFy6M0WiE043jqpo3MwkexLBERUXR1NSknl9ubGwkLCyM+Ph49Wepfigu51iKutIy1OXLVI5z7g56vZ6pU6cOarlLCDE6JHgQw3LrrbdqkpwEBQUxZcoUvL29CQoKGpGy4nl5eWzatIkTJ06oueONRqOUFRdCoCj2YV9i8CR4EKNu69atPPbYY8TGxrJ48WKMRiOff/65et/V1ZUvv/wSV1dXFi5cyDPPPMPKlStZv3692iYwMJDPPvuMwMBA3NzccHd3VxOlZGZmsm/fPsrKyqipqeHcuXMsXbpU/dv+/n4sFgs2m43a2lqKi4uxWq3k5uaqbVpbW7FYLERGRtLY2EhGRgZJSUlUVlaOzYc0gTiWoq60DHX5MtXlM1EAfX19/P3334Na7hITgDLMJQvZ8zAksmFSjLjq6mrNa8dx0KvtvIf/Hwe9Gr1ez9KlSzVBAQzkN9ixYwclJSU88sgjwEDZ5jlz5lBfX8+CBQuoqqri1KlTHDx4EF9fX4KDg9mwYQOvvPIKeXl5GAwGioqK8PPz49133wUG0sN+++23bN26VZJQjTA/Pz+MRiOHDh0iODgYGDg5cfToUVJTU4GBZaqOjg4aGhrU4lyHDx/GbrcTERGhtlm3bh29vb24ubkBA0tZ/v7+3HbbbU4YmRATh8w8iBvCTz/9hMlk4u677yY+Pp62tjZA8kiMV52dneoeGBiY2XHk+NfpdGRkZPDWW2+xd+9empqaWLlyJSaTiSeeeAIYCN4effRRkpOTOXbsGEeOHCE9PZ0VK1aopcaffvppDAYDL7zwAidPnmT37t289957ZGVlOW3cwgkkz4NTyMyDGPciIiKwWq34+/tz/vx53nzzTR566CFOnDgxZnkk5ETH4Hz33XdERkaqrx1f6AkJCVitVnJycujq6iIlJYWOjg4WLVpERUWF5rjvrl27SE9PJyoqChcXF2JjY9m2bZt639PTk6qqKtLS0pg3bx7Tpk0jNzdXjmlONHY76Iaxb0H2PAyJBA9i3Ls8X8DcuXOJiIhgxowZ7NmzR77Ux6mHH36Ya2W+1+l0rF+/XrOv5d+mTp1KSUnJNZ8zd+5cvvnmmyH3UwgxNLJsIW44Xl5ezJo1i5aWFikrLsREJ8sWTiHBg7jhdHZ28vPPPzN9+vRRKSt+eRvJIyHE+KbY7cO+xOBJ8CDGvbVr11JTU8Ovv/5KbW0tTz75JK6ursTFxY1IHgmAF198kZaWFgICAvDy8sJgMFBaWorFYlH7IcWchBiHZObBKSR4EOPe2bNniYuLw9/fn2XLluHt7U19fT233347MDJ5JLy8vPD09OT333+nq6sLo9FIdnY2MTExahsp5iSEEAN0yrV2NQkxQbz66qscOXLkqpvvFEXBZDKRnZ3N2rVrgYEcE76+vlitVrWYU0BAgKaYU0VFBTExMZw9exaTyURhYSHr1q1TT4k4nl1eXs4PP/wwNoMV4iZw8eJFPD09eWTSMvS6oRd461NsHO7Zwz///IOHh8cI9vDmJjMPQgB79+4lLCyMp556Ch8fH0JCQvjoo4/U+1LM6fo++OADZs6cibu7OxERERw7dszZXRITgaIMHLcc8iX/Pw+FBA9CAL/88guFhYXcd999VFZWkpqayurVqykuLgakmNP17N69m6ysLN544w2+//57HnjgAcxm839STAshbg4SPAgB2O12QkNDyc/PJyQkhJSUFJKTkykqKnJ2124IW7ZsITk5mcTERAICAigqKmLy5Mns3LnT2V0TNznFrgz7EoMnwYMQwPTp09Vjmw5z5sxR02BLMaers9lsNDQ0aJZ0XFxcWLJkiaT3FqNvWEsWdskwOUQSPAgBPPjggzQ3N2t+9+OPPzJjxgxAW8zJwVHM6fJ8Eo5iTg5XKub09ddf09vbq7a50Ys5/fXXX/T3919zSUcIcXOR4EEIIDMzk/r6evLz82lpaaGkpITt27eTlpYGMCLFnGbOnMlLL73EhQsXMBgM6HQ6dDodmzdvJisri0uXLpGWloa3tze33HILsbGx/5mlaGtrw2KxMHnyZHx8fHj55Zfp6+vTtKmuriY0NJRJkyZx7733YrVax+QzFMIZZNnCOSR4EAKYP38+X3zxBaWlpQQFBbFhwwYKCgqIj49X2+Tk5LBq1SpSUlKYP38+nZ2dVyzmNHv2bKKiooiJiWHRokVqDofjx49z/vx5Dh06RHh4uFpGOjExkZSUFDIzM9m3bx9lZWXU1NRw7tw5TQny/v5+LBYLNpuN2tpaiouLsVqt5Obmqm1aW1uxWCxERkbS2NhIRkYGSUlJVFZWjtpnN23aNFxdXa+5pCPEaOlTeuizD+NSepw9hBuTIoRwijVr1ij33HOPYrfblY6ODsXNzU0pKytT758+fVoBlLq6OkVRFGX//v2Ki4uL0t7errYpLCxUPDw8lJ6eHkVRFCUnJ0cJDAzUPGf58uWK2Wwe1bGEh4cr6enp6uv+/n7ljjvuUN5+++1Rfa6YuLq7uxWj0agAw76MRqPS3d3t7CHdUKSqphBOYLPZ+PTTT8nKykKn09HQ0EBvb69m0+Hs2bO56667qKurY8GCBdTV1XH//fdr9haYzWZSU1M5efIkISEh1NXVad7D0SYjI2NUx5OVlUVCQgJhYWGEh4dTUFBAV1cXiYmJo/pcMXG5u7vT2tqKzWYb9nsZDAbNDKK4PgkehHCC8vJyOjo6eO655wDUjJNeXl6adv/OI3G9HBFXa3Px4kW6u7tHrULo8uXL+fPPP8nNzaW9vZ3g4GAqKir+0xchRpK7u7t86TuJBA9COMGOHTuIjo7GZDI5uysjJj09nfT0dGd3QwgxBmTDpBBj7MyZMxw8eJCkpCT1d0ajEZvNRkdHh6btv/NIXC9HxNXaeHh4jNqsgxBi4pHgQYgx9vHHH+Pj46Mp9z1v3jzc3Nw0eSSam5tpa2vT5JFoamrSJKI6cOAAHh4eaoKrhQsXat7D0cbxHkIIMRKkqqYQY8hut+Pn50dcXBwbN27U3EtNTWX//v1YrVY8PDxYtWoVALW1tcDAUc3g4GBMJhObNm2ivb2dZ599lqSkJPLz84GBo5pBQUGkpaXx/PPPc/jwYVavXs1XX32F2Wwe28EKIW5aEjwIMYaqqqrUKpqzZs3S3Lt06RLZ2dmUlpbS09OD2Wzmww8/1ORKOHPmDKmpqVRXVzNlyhQSEhLYuHEjev3/ty9VV1eTmZnJqVOnuPPOO3n99dfVjZlCCDESJHgQQgghxKDIngchhBBCDMr/AKvKP9gHUeW/AAAAAElFTkSuQmCC\n", "text/plain": ["
"]}, "metadata": {}, "output_type": "display_data"}], "source": ["%matplotlib notebook\n", "from mpl_toolkits import mplot3d\n", "\n", "fig = plt.figure()\n", "ax = plt.axes(projection='3d')\n", "\n", "Z[np.isnan(Z)] = 0.0\n", "\n", "S = ax.plot_surface(X, Y, -Z, cmap='viridis', edgecolor='none')\n", "cbar = fig.colorbar(S)\n", "cbar.ax.set_ylabel('Depth');"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "slide"}}, "source": ["## Other Python plotting libraries \n", "\n", "There are several other great plotting libraries for Python\n", "\n", " * [Bokeh](https://bokeh.pydata.org/en/latest/)\n", " * [Holoviews](http://holoviews.org/)\n", " * [Plotly](https://plot.ly/)\n", " * [Altair](https://altair-viz.github.io/)"]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["[Bokeh](https://docs.bokeh.org/en/latest/index.html) is a modern plotting library that is best used for creating interactive two-dimensional visualizations that are intended to be displayed in Jupyter Notebooks and/or HTML web sites. It has a simple interface that allows for quickly creating great looking figures.\n", "\n", "[Holoviews](http://holoviews.org/) is a plotting package with a similar interface to Bokeh, but allows you to chose the backend to be either Bokeh (best for web) or Matplotlib (best for print publications) from a unified front end.\n", "\n", "[Plotly](https://plot.ly/) is another modern plotting library primarily targeting web-based visualizations and offers built in dashboarding capabilities.\n", "\n", "[Altair](https://altair-viz.github.io/), the newest of the group, is based on [Vega-Lite](https://vega.github.io/vega-lite/), a Javascript visualization grammar similar to the [Grammar of Graphics](https://vita.had.co.nz/papers/layered-grammar.html) implementation in the R programming language."]}, {"cell_type": "markdown", "metadata": {"slideshow": {"slide_type": "skip"}}, "source": ["## Further Reading\n", "\n", "Further reading on Matplotlib can be found in the [official documentation](https://matplotlib.org/)."]}, {"cell_type": "code", "execution_count": 13, "metadata": {"hide_input": true, "init_cell": true, "javascript_last_cell": true, "jupyter": {"source_hidden": true}, "slideshow": {"slide_type": "skip"}, "tags": ["remove_cell"]}, "outputs": [{"data": {"application/javascript": ["function hideElements(elements, start) {\n", "for(var i = 0, length = elements.length; i < length;i++) {\n", " if(i >= start) {\n", " elements[i].style.display = \"none\";\n", " }\n", "}\n", "}\n", "var prompt_elements = document.getElementsByClassName(\"prompt\");\n", "hideElements(prompt_elements, 0)\n"], "text/plain": [""]}, "metadata": {}, "output_type": "display_data"}], "source": ["%%javascript\n", "function hideElements(elements, start) {\n", "for(var i = 0, length = elements.length; i < length;i++) {\n", " if(i >= start) {\n", " elements[i].style.display = \"none\";\n", " }\n", "}\n", "}\n", "var prompt_elements = document.getElementsByClassName(\"prompt\");\n", "hideElements(prompt_elements, 0)"]}], "metadata": {"celltoolbar": "Edit Metadata", "kernelspec": {"display_name": "Python 3", "language": "python", "name": "python3"}, "language_info": {"codemirror_mode": {"name": "ipython", "version": 3}, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.8.1"}, "rise": {"auto_select": null, "autolaunch": false, "controls": true, "enable_chalkboard": false, "footer": "", "progress": true, "scroll": true, "slideNumber": false, "theme": "simple"}}, "nbformat": 4, "nbformat_minor": 4}