{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Auto Color Scale" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## TL;DR\n", " * use `plot_by_id(run_id, auto_color_scale=True, cutoff_percentile=(0.5, 0.6)` to enable automatic color scaling\n", " * this maximally cuts 0.5% of the low valued data points and 0.6% of the high valued data points.\n", " * You can also use it for matplotlib with the supplied auto scaling function. \n", " * Set your defaults in `qcodesrc.json`." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Table of contents\n", "1. [Introduction to the problem and risks](#Introduction-to-the-problem-and-risks)\n", "2. [Using the automatic color scale](#Using-the-automatic-color-scale)\n", " 1. [Example 1: outliers in homogeneous data](#Example-1:-outliers-in-homogeneous-data)\n", "3. [Details of the calculation](#Details-of-the-calculation)\n", "4. [Cutoff Percentiles](#Cutoff-Percentiles)\n", " 1. [Example 2: data on noisy background with outliers](#Example-2:-data-on-noisy-background-with-outliers)\n", "4. [Defaults and customizing the auto color scaling](#Defaults-and-customizing-the-auto-color-scaling)\n", "5. [Using auto color scaling in custom plotting](#Using-auto-color-scaling-in-custom-plotting)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Introduction to the problem and risks\n", "It is a fairly common issue that a heat map plot does not properly show the right details due to some outliers that push the range of the color scale beyond the desired limits, as it is shown in the image below:\n", "![](./files/auto_color_scale_swamped_small.png)\n", "Here there are two pixels (black and white) corresponding to high and low outliers. The remaining data is uniformly displayed as red and the actual structure of it is drowned. \n", "One can of course specify the limits of the color bar manually to view the full structure as shown here:\n", "![](./files/auto_color_scale_clean_small.png)\n", "But for measurements that takes a lot of time to perform, manual intervention becomes an unwieldy task.\n", "\n", "\n", "In this notebook an *automatic color scaling* is presented that tries to empower the experimenter to circumvent this difficulty, while keeping possible risks in mind.\n", "\n", "\n", "The risk narrowing the color scale is clearly that the image representing the data saturates in some regions and is no longer fully representative of the actual data. Especially for automatic color scaling this can become risky because without a theoretical model describing the specific measurement one cannot scientifically argue for the choice of the new limits of the color scale and possible meaningful features might be disregarded.\n", "\n", "\n", "For this reason automatic color scaling is deactivated by default and has to be activated manually." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Using the automatic color scale\n", "The following section presents an example of the usage of the automatic color scaling with the new `DataSet` and the `plot_dataset` function for plotting. Let's first make the necessary imports:" ] }, { "cell_type": "code", "execution_count": 1, "metadata": {}, "outputs": [], "source": [ "# store data in a separate db in order not to spam the actual measurement db\n", "from qcodes.dataset import (\n", " initialise_or_create_database_at,\n", " load_or_create_experiment,\n", " new_data_set,\n", " plot_dataset,\n", ")\n", "\n", "initialise_or_create_database_at('../example.db')\n", "\n", "# create an experiment for this tutorial\n", "load_or_create_experiment(experiment_name='tutorial_auto_color_scale', sample_name=\"outliers\")\n" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Example 1: outliers in homogeneous data\n", "Here we basically reproduce the images of the introduction, where we have some smoothly structured data with some outliers that lie far outside of the range of the remaining data:" ] }, { "cell_type": "code", "execution_count": 2, "metadata": {}, "outputs": [], "source": [ "# first we generate a fake dataset with outliers.\n", "import numpy as np\n", "\n", "from qcodes.dataset.descriptions.dependencies import InterDependencies_\n", "from qcodes.dataset.descriptions.param_spec import ParamSpecBase\n", "\n", "\n", "def dataset_with_outliers_generator(ds, data_offset=5, low_outlier=-3,\n", " high_outlier=1, background_noise=True):\n", " x = ParamSpecBase('x', 'numeric', label='Flux', unit='e^2/hbar')\n", " t = ParamSpecBase('t', 'numeric', label='Time', unit='s')\n", " z = ParamSpecBase('z', 'numeric', label='Majorana number', unit='Anyon')\n", "\n", " idps = InterDependencies_(dependencies={z: (x, t)})\n", " ds.set_interdependencies(idps)\n", " ds.mark_started()\n", "\n", " npoints = 50\n", " xvals = np.linspace(0, 1, npoints)\n", " tvals = np.linspace(0, 1, npoints)\n", " for counter, xv in enumerate(xvals):\n", " if background_noise and (\n", " counter < round(npoints/2.3) or counter > round(npoints/1.8)):\n", " data = np.random.rand(npoints)-data_offset\n", " else:\n", " data = xv * np.linspace(0,1,npoints)\n", " if counter == round(npoints/1.9):\n", " data[round(npoints/1.9)] = high_outlier\n", " if counter == round(npoints/2.1):\n", " data[round(npoints/2.5)] = low_outlier\n", " ds.add_results([{'x': xv, 't': tv, 'z': z}\n", " for z, tv in zip(data, tvals)])\n", " ds.mark_completed()\n", " return ds" ] }, { "cell_type": "code", "execution_count": 2, "metadata": {}, "outputs": [], "source": [ "# create a new dataset with outliers\n", "ds = dataset_with_outliers_generator(new_data_set('data_with_outliers'),\n", " low_outlier=-3, high_outlier=3,\n", " background_noise=False)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "by plotting it simply by `plot_dataset` we get the full range" ] }, { "cell_type": "code", "execution_count": 3, "metadata": { "scrolled": true }, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "D:\\source\\repos\\Qcodes\\src\\qcodes\\dataset\\data_set_cache.py:85: UserWarning: Trying to mark a run completed that was already completed.\n", " self.load_data_from_db()\n" ] }, { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "ax, cb = plot_dataset(ds)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "By adding the keyword `auto_color_scale=True` one activates the scaling:" ] }, { "cell_type": "code", "execution_count": 4, "metadata": {}, "outputs": [ { "data": { "image/png": "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1xEcHIyRI0eatNuzZw82bNiAsWPHQqfT4aOPPsKzzz6Lw4cPo2HDhgCAxMREPPXUU8ZgyNPTEz/88AOGDh2K1NTUXJd258yZAycnJ0ycOBGZmZlm/+q8desWnnvuOfTp0wevvPIKli9fjj59+mDNmjUYP348Ro4ciX79+mHx4sV4+eWXcfXqVZQvX96icS1YsABarRYTJ05ESkoKFi1ahP79++PQoUMAgKlTpyIlJQV///033n//fQBAuXLl8h37F198gWHDhqFFixYYMWIEACAgICDf7Qvbx59//om2bdvCzc0Nb731FsqUKYOPP/4YHTp0MAZ+Dxs9ejQ8PT0xY8YMpKWl5bvPVatWoVy5cggPD0e5cuWwe/duzJgxA6mpqVi8eHGhxv+or776Cunp6Rg1ahQqV66Mw4cPY8mSJfj777/x1VdfFaovT09PLF++HKNGjcILL7yAF198EQDQuHFjAMCuXbvQpUsX1KxZEzNnzsS9e/ewZMkStG7dGkePHi3UZOihQ4di1apV6NKlC4YNG4bs7Gzs3bsXBw8eNLmSvHr1arz88st44403cOjQIcyfPx8nT57E5s2b8+373r176NChA86dO4ewsDDUqFEDX331FQYPHozbt29j3LhxJtuvXLkSGRkZGDFiBHQ6HSpVqiQd/40bN9C5c2d4enpi8uTJqFChAi5duoSvv/660Me5fPlyNGjQAD169ICjoyO+++47jB49GgaDAWPGjMl3DAaDAT169MC+ffswYsQI1KtXDydOnMD777+PM2fOSOeV7d+/H5UrV0b16tVNlicmJqJVq1ZIT0/H2LFjUblyZaxevRo9evTAxo0b8cILL0jPz8MK+z3Py7x58zB9+nT06tULw4YNQ1JSEpYsWYJ27drht99+M17dBx5MDO7SpQv69OmDV199Fd7e3gV+vwAgMDAQ77//Pv7880/j72QqJKGilStXCgBi165dIikpSVy9elVs3LhReHp6Cp1OJ65evWrctn379qJ9+/a5+hg0aJCoXr268eeLFy8KAKJy5cri5s2bxuXffvutACC+++476biOHDkidu7cKZYtWyYAiC+//FLs3LlTDB48WPj5+YmdO3eKnTt3iiNHjuTZ/tdffxUAxMqVKwt8LvKScyz5vQ4cOGDcNi0tTTz++OOiQYMGIiMjQ3Tr1k24ubmJy5cvm/SZ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r7/EiBEjRIUKFURCQoLaQ1Od7NwMGDBATJ482bj9ggULhJOTk9i4caO4fv268XXnzh21DkEVhT1vjyqN2VKFPWdXrlwR5cuXF2FhYeL06dPi+++/F15eXmLu3LlqHYIqCnveIiIiRPny5cW6devEhQsXxI8//igCAgJEr1691DqEYuXOnTvit99+E7/99psAICIjI8Vvv/0mLl++rPbQyAKlOrgRQoglS5aIatWqCScnJ9GiRQtx8OBBtYdUbJg7N+3btxeDBg0y/ly9enUBINcrIiKi6AeussKct0eVxuBGiMKfs/3794ugoCCh0+lEzZo1xbx580R2dnYRj1p9hTlv9+/fFzNnzhQBAQHC2dlZ+Pn5idGjR4tbt24V/cCLoZ9++inP32Hmvq9UfGmE4PVIIiIiKjlK7ZwbIiIiKpkY3BAREVGJwuCGiIiIShQGN0RERFSiMLghIiKiEoXBDREREZUoDG6IiIioRGFwQ0RERCUKgxsiG+jQoQPGjx9fJPtq164d1q5da1Hbc+fOwdvbGy4uLvjll1+sNqaZM2eiadOmZrex5TmKjo42eSApEZUuDG6ILDB48GBoNJpcr3PnzhXpOLZs2YLExET06dOn0G3/+ecfdOrUCW3atMHQoUPx3HPP4cSJEybb3L9/H5MmTUKjRo3g6uqKKlWqYODAgfjnn39y9Xfv3j24uroW+TnIy5AhQ3D06FHs3btX7aEQkQoc1R4Akb169tlnsXLlSpNlnp6eRTqGDz/8EKGhobme9ixz69YthISEoG3btli5ciUcHBxQrlw5hISE4JdffkGNGjUAPHiS9NGjRzF9+nQ0adIEt27dwrhx49CjRw8cOXLEpM+dO3eievXqePzxx612fIUlhIBer4eTkxP69euHDz/8EG3btlVtPESkDl65IbKQTqeDj4+PycvBwSHPbTUaDb755huTZRUqVMCqVasAAJ9//jnKlSuHs2fPGtePHj0adevWRXp6ep59JiUlYffu3bluv9y+fRvDhg2Dp6cn3Nzc8Mwzz+D48ePG9enp6ejWrRtat26N1atXG8c8f/58jBkzBp07d8aNGzcAAO7u7ti5cyd69eqFOnXq4KmnnsLSpUsRHx+PK1eumOz322+/RY8ePUyWffHFF/D394e7uzv69OmDO3fumKzPzs5GWFgY3N3d4eHhgenTp+Phx919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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "ax, cb = plot_dataset(ds, auto_color_scale=True)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "and the actual structure of the data becomes visible.\n", "\n", "Please note two further details:\n", " - The triangles that appeared at the top and the bottom of the color bar: These indicate that the color bar does not cover the full range of the data spectrum.\n", " - The clipped regions are marked with colors that are clearly not part of the color scale in order to clearly separate those regions where we cannot make any claim about any structure.\n", " " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Details of the calculation\n", " \n", "The new limits are calculated in three steps:\n", " - Determine the inter quartile range (IQR), i.e. the distance between the first (q1) and the third (q3) quartile (see image below).\n", " - Expand the region spanned by [q1, q3] by 1.5 x the IQR (yet not beyond the original limits of the min/max of the data).\n", " - Limit the amount of data points clipped on each side to an amount that is described by the lower (pl) and upper (pu) cutoff percentiles. E.g. for pu=pl=0.5%, no more the white and gray areas may not take up more than half a percent each of the total area.\n", " \n", "To understand how this works lets consider the histogram of the previous example:" ] }, { "cell_type": "code", "execution_count": 5, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "" ] }, "execution_count": 5, "metadata": {}, "output_type": "execute_result" }, { "data": { "image/png": "iVBORw0KGgoAAAANSUhEUgAAAigAAAGdCAYAAAA44ojeAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguMSwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/SrBM8AAAACXBIWXMAAA9hAAAPYQGoP6dpAAAi4UlEQVR4nO3de1BU58HH8R+IgIK7iJVdGQHJpVEaLwlG3Wjf8UIlhrE60jRmrKGpo42z2CpTY+h4i6bBOmm0OqhJatFMdUxsR22MwQuJOlMBldSpwYTG1AxEspDGwirvKyDs+0fqJustrkLOA34/M2eGPefZPc8544RvDrtnQ3w+n08AAAAGCbV6AgAAAFciUAAAgHEIFAAAYBwCBQAAGIdAAQAAxiFQAACAcQgUAABgHAIFAAAYJ8zqCdyK1tZWVVdXq0ePHgoJCbF6OgAA4Cb4fD6dP39e8fHxCg298TWSDhko1dXVSkhIsHoaAADgFlRVValv3743HNMhA6VHjx6SvjxAm81m8WyAzqWhQYqP//Ln6mopKsranTc0NCj+v+uqq6sV1cYTau/Xv8GOr3miLT3/QDvzer1KSEjw/x6/kQ4ZKJf/rGOz2QgUoI116fLVzzbbt/wL8ho77/K1dTabrc0Dor1f/wY7/urnr51oS88/8C25mbdn8CZZAABgHAIFAAAYh0ABAADGIVAAAIBxCBQAAGAcAgUAABiHQAEAAMYhUAAAgHEIFAAAYBwCBQAAGIdAAQAAxiFQAACAcQgUAABgHAIFAAAYJ8zqCQDAtQxYVKj/C49Ua9NFq6cCwAJBX0E5e/asfvKTn6hXr17q1q2bBg4cqOPHj/u3+3w+LV68WH369FG3bt2Ulpamjz76KOA1zp07p2nTpslmsykmJkYzZszQhQsXbv9oAABApxBUoPznP//RyJEj1bVrV7399ts6deqUfve736lnz57+MStXrtSaNWu0YcMGlZaWKioqSunp6bp48av/C5o2bZrKy8u1f/9+7d69W4cPH9asWbPa7qgAAECHFtSfeH77298qISFBBQUF/nXJycn+n30+n1avXq2FCxdq0qRJkqTXXntNDodDO3fu1NSpU/XBBx+osLBQx44d09ChQyVJa9eu1aOPPqoXX3xR8fHxbXFcAACgAwvqCspf//pXDR06VI899pji4uL0wAMP6NVXX/VvP3PmjDwej9LS0vzr7Ha7hg8fruLiYklScXGxYmJi/HEiSWlpaQoNDVVpaek199vY2Civ1xuwAACAziuoQPnXv/6l9evX695779XevXs1e/Zs/eIXv9DmzZslSR6PR5LkcDgCnudwOPzbPB6P4uLiAraHhYUpNjbWP+ZKeXl5stvt/iUhISGYaQMAgA4mqEBpbW3Vgw8+qBdeeEEPPPCAZs2apZkzZ2rDhg3tNT9JUm5ururr6/1LVVVVu+4PAABYK6hA6dOnj1JSUgLWDRgwQJWVlZIkp9MpSaqpqQkYU1NT49/mdDpVW1sbsP3SpUs6d+6cf8yVIiIiZLPZAhYAANB5BRUoI0eOVEVFRcC6f/7zn0pKSpL05RtmnU6nioqK/Nu9Xq9KS0vlcrkkSS6XS3V1dSorK/OPeeedd9Ta2qrhw4ff8oEAAIDOI6hP8cybN08PP/ywXnjhBf34xz/W0aNH9corr+iVV16RJIWEhGju3Ll6/vnnde+99yo5OVmLFi1SfHy8Jk+eLOnLKy6PPPKI/09Dzc3Nys7O1tSpU/kEDwAAkBRkoDz00EPasWOHcnNztWzZMiUnJ2v16tWaNm2af8wzzzyjhoYGzZo1S3V1dRo1apQKCwsVGRnpH7NlyxZlZ2dr3LhxCg0NVWZmptasWdN2RwUAADq0EJ/P57N6EsHyer2y2+2qr6/n/ShAG2tokKKjv/z5wgUpKsqanQ+Y92f/re6rVv3ov/O5oKg2nlBDQ4Oi/7vP9nj9G+z4mifa0vMPtLNgfn/zZYEAAMA4BAoAADAOgQIAAIxDoAAAAOMQKAAAwDgECgAAMA6BAgAAjEOgAAAA4xAoAADAOAQKAAAwDoECAACMQ6AAAADjECgAAMA4BAoAADAOgQIAAIxDoAAAAOMQKAAAwDgECgAAMA6BAgAAjEOgAAAA4xAoAADAOAQKAAAwDoECAACMQ6AAAADjECgAAMA4BAoAADAOgQIAAIxDoAAAAOMQKAAAwDgECgAAMA6BAgAAjEOgAAAA4xAoAADAOAQKAAAwDoECAACMQ6AAAADjECgAAMA4BAoAADAOgQIAAIxDoAAAAOMQKAAAwDgECgAAMA6BAgAAjEOgAAAA4xAoAADAOAQKAAAwDoECAACME1SgLF26VCEhIQFL//79/dsvXrwot9utXr16KTo6WpmZmaqpqQl4jcrKSmVkZKh79+6Ki4vT/PnzdenSpbY5GgAA0CmEBfuE733vezpw4MBXLxD21UvMmzdPb731lrZv3y673a7s7GxNmTJFf/vb3yRJLS0tysjIkNPp1JEjR/TZZ5/pySefVNeuXfXCCy+0weEAAIDOIOhACQsLk9PpvGp9fX29Nm7cqK1bt2rs2LGSpIKCAg0YMEAlJSUaMWKE9u3bp1OnTunAgQNyOBwaMmSIli9frgULFmjp0qUKDw+//SMCAAAdXtDvQfnoo48UHx+vu+66S9OmTVNlZaUkqaysTM3NzUpLS/OP7d+/vxITE1VcXCxJKi4u1sCBA+VwOPxj0tPT5fV6VV5eft19NjY2yuv1BiwAAKDzCipQhg8frk2bNqmwsFDr16/XmTNn9P3vf1/nz5+Xx+NReHi4YmJiAp7jcDjk8XgkSR6PJyBOLm+/vO168vLyZLfb/UtCQkIw0wYAAB1MUH/imTBhgv/nQYMGafjw4UpKStIbb7yhbt26tfnkLsvNzVVOTo7/sdfrJVIAAOjEbutjxjExMfrud7+r06dPy+l0qqmpSXV1dQFjampq/O9ZcTqdV32q5/Lja72v5bKIiAjZbLaABQAAdF63FSgXLlzQxx9/rD59+ig1NVVdu3ZVUVGRf3tFRYUqKyvlcrkkSS6XSydPnlRtba1/zP79+2Wz2ZSSknI7UwEAAJ1IUH/i+dWvfqWJEycqKSlJ1dXVWrJkibp06aInnnhCdrtdM2bMUE5OjmJjY2Wz2TRnzhy5XC6NGDFCkjR+/HilpKRo+vTpWrlypTwejxYuXCi3262IiIh2OUAAANDxBBUon376qZ544gl98cUX6t27t0aNGqWSkhL17t1bkrRq1SqFhoYqMzNTjY2NSk9P17p16/zP79Kli3bv3q3Zs2fL5XIpKipKWVlZWrZsWdseFQAA6NCCCpRt27bdcHtkZKTy8/OVn59/3TFJSUnas2dPMLsFAAB3GL6LBwAAGIdAAQAAxiFQAACAcQgUAABgHAIFAAAYh0ABAADGIVAAAIBxCBQAAGAcAgUAABiHQAEAAMYhUAAAgHEIFAAAYBwCBQAAGIdAAQAAxiFQAACAcQgUAABgHAIFAAAYh0ABAADGIVAAAIBxCBQAAGAcAgUAABiHQAEAAMYhUAAAgHEIFAAAYBwCBQAAGIdAAQAAxiFQAACAcQgUAABgHAIFAAAYh0ABAADGIVAAAIBxCBQAAGAcAgUAABiHQAEAAMYhUAAAgHEIFAAAYBwCBQAAGIdAAQAAxiFQAACAcQgUAABgHAIFAAAYh0ABAADGIVAAAIBxCBQAAGAcAgUAABiHQAEAAMYhUAAAgHFuK1BWrFihkJAQzZ0717/u4sWLcrvd6tWrl6Kjo5WZmamampqA51VWViojI0Pdu3dXXFyc5s+fr0uXLt3OVAAAQCdyy4Fy7Ngxvfzyyxo0aFDA+nnz5unNN9/U9u3bdejQIVVXV2vKlCn+7S0tLcrIyFBTU5OOHDmizZs3a9OmTVq8ePGtHwUAAOhUbilQLly4oGnTpunVV19Vz549/evr6+u1ceNGvfTSSxo7dqxSU1NVUFCgI0eOqKSkRJK0b98+nTp1Sn/60580ZMgQTZgwQcuXL1d+fr6ampra5qgAAECHdkuB4na7lZGRobS0tID1ZWVlam5uDljfv39/JSYmqri4WJJUXFysgQMHyuFw+Mekp6fL6/WqvLz8mvtrbGyU1+sNWAAAQOcVFuwTtm3bpvfee0/Hjh27apvH41F4eLhiYmIC1jscDnk8Hv+Yr8fJ5e2Xt11LXl6ennvuuWCnCgAAOqigrqBUVVXpl7/8pbZs2aLIyMj2mtNVcnNzVV9f71+qqqq+tX0DAIBvX1CBUlZWptraWj344IMKCwtTWFiYDh06pDVr1igsLEwOh0NNTU2qq6sLeF5NTY2cTqckyel0XvWpnsuPL4+5UkREhGw2W8ACAAA6r6ACZdy4cTp58qROnDjhX4YOHapp06b5f+7atauKior8z6moqFBlZaVcLpckyeVy6eTJk6qtrfWP2b9/v2w2m1JSUtrosAAAQEcW1HtQevToofvvvz9gXVRUlHr16uVfP2PGDOXk5Cg2NlY2m01z5syRy+XSiBEjJEnjx49XSkqKpk+frpUrV8rj8WjhwoVyu92KiIhoo8MCAAAdWdBvkv0mq1atUmhoqDIzM9XY2Kj09HStW7fOv71Lly7avXu3Zs+eLZfLpaioKGVlZWnZsmVtPRUAANBB3XagHDx4MOBxZGSk8vPzlZ+ff93nJCUlac+ePbe7awAA0EnxXTwAAMA4BAoAADAOgQIAAIxDoAAAAOMQKAAAwDgECgAAMA6BAgAAjEOgAAAA4xAoAADAOAQKAAAwDoECAACMQ6AAAADjECgAAMA4BAoAADAOgQIAAIxDoAAAAOMQKAAAwDgECgAAMA6BAgAAjEOgAAAA4xAoAADAOGFWTwAAbtaARYUKDY+UJH2yIsPi2QBoT1xBAQAAxiFQAACAcQgUAABgHAIFAAAYh0ABAADGIVAAAIBxCBQAAGAcAgUAABiHQAEAAMYhUAAAgHEIFAAAYBwCBQAAGIdAAQAAxiFQAACAcQgUAABgHAIFAAAYh0ABAADGIVAAAIBxCBQAAGAcAgUAABiHQAEAAMYhUAAAgHEIFAAAYBwCBQAAGIdAAQAAxgkqUNavX69BgwbJZrPJZrPJ5XLp7bff9m+/ePGi3G63evXqpejoaGVmZqqmpibgNSorK5WRkaHu3bsrLi5O8+fP16VLl9rmaAAAQKcQVKD07dtXK1asUFlZmY4fP66xY8dq0qRJKi8vlyTNmzdPb775prZv365Dhw6purpaU6ZM8T+/paVFGRkZampq0pEjR7R582Zt2rRJixcvbtujAgAAHVpYMIMnTpwY8Pg3v/mN1q9fr5KSEvXt21cbN27U1q1bNXbsWElSQUGBBgwYoJKSEo0YMUL79u3TqVOndODAATkcDg0ZMkTLly/XggULtHTpUoWHh7fdkQEAgA7rlt+D0tLSom3btqmhoUEul0tlZWVqbm5WWlqaf0z//v2VmJio4uJiSVJxcbEGDhwoh8PhH5Oeni6v1+u/CnMtjY2N8nq9AQsAAOi8gg6UkydPKjo6WhEREXr66ae1Y8cOpaSkyOPxKDw8XDExMQHjHQ6HPB6PJMnj8QTEyeXtl7ddT15enux2u39JSEgIdtoAAKADCTpQ7rvvPp04cUKlpaWaPXu2srKydOrUqfaYm19ubq7q6+v9S1VVVbvuDwAAWCuo96BIUnh4uO655x5JUmpqqo4dO6bf//73evzxx9XU1KS6urqAqyg1NTVyOp2SJKfTqaNHjwa83uVP+Vwecy0RERGKiIgIdqoAAKCDuu37oLS2tqqxsVGpqanq2rWrioqK/NsqKipUWVkpl8slSXK5XDp58qRqa2v9Y/bv3y+bzaaUlJTbnQoAAOgkgrqCkpubqwkTJigxMVHnz5/X1q1bdfDgQe3du1d2u10zZsxQTk6OYmNjZbPZNGfOHLlcLo0YMUKSNH78eKWkpGj69OlauXKlPB6PFi5cKLfbzRUSAADgF1Sg1NbW6sknn9Rnn30mu92uQYMGae/evfrBD34gSVq1apVCQ0OVmZmpxsZGpaena926df7nd+nSRbt379bs2bPlcrkUFRWlrKwsLVu2rG2PCgAAdGhBBcrGjRtvuD0yMlL5+fnKz8+/7pikpCTt2bMnmN0CAIA7DN/FAwAAjEOgAAAA4xAoAADAOAQKAAAwDoECAACMQ6AAAADjECgAAMA4BAoAADBO0F8WCAAm6PfsW1et+2RFhgUzAdAeuIICAACMQ6AAAADjECgAAMA4BAoAADAOgQIAAIxDoAAAAOMQKAAAwDgECgAAMA6BAgAAjEOgAAAA4xAoAADAOAQKAAAwDoECAACMQ6AAAADjECgAAMA4BAoAADAOgQIAAIxDoAAAAOMQKAAAwDgECgAAMA6BAgAAjEOgAAAA4xAoAADAOAQKAAAwDoECAACME2b1BACgrfR79q2Ax5+syLBoJgBuF1dQAACAcQgUAABgHAIFAAAYh0ABAADGIVAAAIBxCBQAAGAcAgUAABiHQAEAAMYhUAAAgHEIFAAAYBwCBQAAGIdAAQAAxgkqUPLy8vTQQw+pR48eiouL0+TJk1VRUREw5uLFi3K73erVq5eio6OVmZmpmpqagDGVlZXKyMhQ9+7dFRcXp/nz5+vSpUu3fzQAAKBTCCpQDh06JLfbrZKSEu3fv1/Nzc0aP368Ghoa/GPmzZunN998U9u3b9ehQ4dUXV2tKVOm+Le3tLQoIyNDTU1NOnLkiDZv3qxNmzZp8eLFbXdUAACgQwsLZnBhYWHA402bNikuLk5lZWX6n//5H9XX12vjxo3aunWrxo4dK0kqKCjQgAEDVFJSohEjRmjfvn06deqUDhw4IIfDoSFDhmj58uVasGCBli5dqvDw8LY7OgAA0CHd1ntQ6uvrJUmxsbGSpLKyMjU3NystLc0/pn///kpMTFRxcbEkqbi4WAMHDpTD4fCPSU9Pl9frVXl5+TX309jYKK/XG7AAAIDO65YDpbW1VXPnztXIkSN1//33S5I8Ho/Cw8MVExMTMNbhcMjj8fjHfD1OLm+/vO1a8vLyZLfb/UtCQsKtThsAAHQAtxwobrdb77//vrZt29aW87mm3Nxc1dfX+5eqqqp23ycAALBOUO9BuSw7O1u7d+/W4cOH1bdvX/96p9OppqYm1dXVBVxFqampkdPp9I85evRowOtd/pTP5TFXioiIUERExK1MFQAAdEBBXUHx+XzKzs7Wjh079M477yg5OTlge2pqqrp27aqioiL/uoqKClVWVsrlckmSXC6XTp48qdraWv+Y/fv3y2azKSUl5XaOBQAAdBJBXUFxu93aunWrdu3apR49evjfM2K329WtWzfZ7XbNmDFDOTk5io2Nlc1m05w5c+RyuTRixAhJ0vjx45WSkqLp06dr5cqV8ng8WrhwodxuN1dJAACApCADZf369ZKk0aNHB6wvKCjQT3/6U0nSqlWrFBoaqszMTDU2Nio9PV3r1q3zj+3SpYt2796t2bNny+VyKSoqSllZWVq2bNntHQkAAOg0ggoUn8/3jWMiIyOVn5+v/Pz8645JSkrSnj17gtk1AASt37NvXbXukxUZFswEQLD4Lh4AAGAcAgUAABiHQAEAAMYhUAAAgHEIFAAAYBwCBQAAGIdAAQAAxiFQAACAcQgUAABgHAIFAAAYh0ABAADGIVAAAIBxCBQAAGAcAgUAABgnzOoJAMC3qd+zbwU8Ll802pqJALghrqAAAADjECgAAMA4BAoAADAOgQIAAIxDoAAAAOMQKAAAwDgECgAAMA6BAgAAjEOgAAAA4xAoAADAOAQKAAAwDoECAACMQ6AAAADjECgAAMA4BAoAADAOgQLgjjZgUWHAz/2efcvC2QC4jEABAADGIVAAAIBxCBQAAGAcAgUAABiHQAEAAMYhUAAAgHEIFAAAYBwCBQAAGCfM6gkAgGmuvFnbJysyLJoJcOfiCgoAADAOgQIAAIxDoAAAAOMQKAAAwDgECgAAMA6BAgAAjBN0oBw+fFgTJ05UfHy8QkJCtHPnzoDtPp9PixcvVp8+fdStWzelpaXpo48+Chhz7tw5TZs2TTabTTExMZoxY4YuXLhwWwcCAAA6j6ADpaGhQYMHD1Z+fv41t69cuVJr1qzRhg0bVFpaqqioKKWnp+vixYv+MdOmTVN5ebn279+v3bt36/Dhw5o1a9atHwUAAOhUgr5R24QJEzRhwoRrbvP5fFq9erUWLlyoSZMmSZJee+01ORwO7dy5U1OnTtUHH3ygwsJCHTt2TEOHDpUkrV27Vo8++qhefPFFxcfH38bhAACAzqBN34Ny5swZeTwepaWl+dfZ7XYNHz5cxcXFkqTi4mLFxMT440SS0tLSFBoaqtLS0mu+bmNjo7xeb8ACAAA6rza91b3H45EkORyOgPUOh8O/zePxKC4uLnASYWGKjY31j7lSXl6ennvuubacKgDctCtvfS9x+3ugvXWIT/Hk5uaqvr7ev1RVVVk9JQAA0I7aNFCcTqckqaamJmB9TU2Nf5vT6VRtbW3A9kuXLuncuXP+MVeKiIiQzWYLWAAAQOfVpoGSnJwsp9OpoqIi/zqv16vS0lK5XC5JksvlUl1dncrKyvxj3nnnHbW2tmr48OFtOR0AANBBBf0elAsXLuj06dP+x2fOnNGJEycUGxurxMREzZ07V88//7zuvfdeJScna9GiRYqPj9fkyZMlSQMGDNAjjzyimTNnasOGDWpublZ2dramTp3KJ3gAAICkWwiU48ePa8yYMf7HOTk5kqSsrCxt2rRJzzzzjBoaGjRr1izV1dVp1KhRKiwsVGRkpP85W7ZsUXZ2tsaNG6fQ0FBlZmZqzZo1bXA4AACgMwg6UEaPHi2fz3fd7SEhIVq2bJmWLVt23TGxsbHaunVrsLsGAAB3iA7xKR4AAHBnIVAAAIBxCBQAAGCcNr2TLADcKa68uyx3lgXaFldQAACAcQgUAABgHAIFAAAYh0ABAADGIVAAAIBxCBQAAGAcAgUAABiHQAEAAMbhRm0A0AauvHGbxM3bgNvBFRQAAGAcAgUAABiHQAEAAMYhUAAAgHEIFAAAYBw+xQMA7eTKT/bwqR7g5nEFBQAAGIdAAQAAxiFQAACAcQgUAABgHAIFAAAYh0ABAADGIVAAAIBxCBQAAGAcbtQGAN+Sr9+4rVvTRX1g4VwA03EFBQAAGIdAAQAAxiFQAACAcQgUAABgHN4kCwAWG7CoUP8XHilJKl/ENx4DEldQAACAgQgUAABgHAIFAAAYh0ABAADGIVAAwCADFhUG/Pz1u88CdxICBQAAGIdAAQAAxiFQAACAcQgUAABgHAIFAAAYh1vdA4DhrvwkzycruB0+Oj+uoAAAAOMQKAAAwDgECgAAMI6lgZKfn69+/fopMjJSw4cP19GjR62cDgAAMIRlgfL6668rJydHS5Ys0XvvvafBgwcrPT1dtbW1Vk0JAAAYwrJAeemllzRz5kw99dRTSklJ0YYNG9S9e3f98Y9/tGpKAADAEJZ8zLipqUllZWXKzc31rwsNDVVaWpqKi4uvGt/Y2KjGxkb/4/r6ekmS1+tt/8kCd5iGhq9+9nqllhZrdt7S+L9q9bWqtemif11r4/9KvtY23WV7v/71tDRd1OX/gl0+1i/nEyr9d0trY8M155M4b/tV695/Lr29pgq0mcu/t30+3zcP9lng7NmzPkm+I0eOBKyfP3++b9iwYVeNX7JkiU8SCwsLCwsLSydYqqqqvrEVOsSN2nJzc5WTk+N/3NraqnPnzqlXr14KCQlp0315vV4lJCSoqqpKNputTV+7s+Fc3TzO1c3jXN08ztXN41wFp73Ol8/n0/nz5xUfH/+NYy0JlO985zvq0qWLampqAtbX1NTI6XReNT4iIkIREREB62JiYtpzirLZbPwjvkmcq5vHubp5nKubx7m6eZyr4LTH+bLb7Tc1zpI3yYaHhys1NVVFRUX+da2trSoqKpLL5bJiSgAAwCCW/YknJydHWVlZGjp0qIYNG6bVq1eroaFBTz31lFVTAgAAhrAsUB5//HF9/vnnWrx4sTwej4YMGaLCwkI5HA6rpiTpyz8nLVmy5Ko/KeFqnKubx7m6eZyrm8e5unmcq+CYcL5CfL6b+awPAADAt4fv4gEAAMYhUAAAgHEIFAAAYBwCBQAAGIdAuYEf/vCHSkxMVGRkpPr06aPp06erurra6mkZ55NPPtGMGTOUnJysbt266e6779aSJUvU1NRk9dSM9Jvf/EYPP/ywunfv3u43HOyI8vPz1a9fP0VGRmr48OE6evSo1VMyzuHDhzVx4kTFx8crJCREO3futHpKxsrLy9NDDz2kHj16KC4uTpMnT1ZFRYXV0zLS+vXrNWjQIP/N2Vwul95++23L5kOg3MCYMWP0xhtvqKKiQn/5y1/08ccf60c/+pHV0zLOhx9+qNbWVr388ssqLy/XqlWrtGHDBv3617+2empGampq0mOPPabZs2dbPRXjvP7668rJydGSJUv03nvvafDgwUpPT1dtba3VUzNKQ0ODBg8erPz8fKunYrxDhw7J7XarpKRE+/fvV3Nzs8aPH6+Gr38rJiRJffv21YoVK1RWVqbjx49r7NixmjRpksrLy62ZUNt8/d+dYdeuXb6QkBBfU1OT1VMx3sqVK33JyclWT8NoBQUFPrvdbvU0jDJs2DCf2+32P25pafHFx8f78vLyLJyV2ST5duzYYfU0Ooza2lqfJN+hQ4esnkqH0LNnT98f/vAHS/bNFZSbdO7cOW3ZskUPP/ywunbtavV0jFdfX6/Y2Firp4EOpKmpSWVlZUpLS/OvCw0NVVpamoqLiy2cGTqT+vp6SeK/T9+gpaVF27ZtU0NDg2VfQUOgfIMFCxYoKipKvXr1UmVlpXbt2mX1lIx3+vRprV27Vj//+c+tngo6kH//+99qaWm56m7SDodDHo/HolmhM2ltbdXcuXM1cuRI3X///VZPx0gnT55UdHS0IiIi9PTTT2vHjh1KSUmxZC53XKA8++yzCgkJueHy4Ycf+sfPnz9ff//737Vv3z516dJFTz75pHx3yM13gz1XknT27Fk98sgjeuyxxzRz5kyLZv7tu5VzBeDb5Xa79f7772vbtm1WT8VY9913n06cOKHS0lLNnj1bWVlZOnXqlCVzueNudf/555/riy++uOGYu+66S+Hh4Vet//TTT5WQkKAjR47cEd+6HOy5qq6u1ujRozVixAht2rRJoaF3Tv/eyr+rTZs2ae7cuaqrq2vn2XUMTU1N6t69u/785z9r8uTJ/vVZWVmqq6vj6uV1hISEaMeOHQHnDFfLzs7Wrl27dPjwYSUnJ1s9nQ4jLS1Nd999t15++eVvfd+WfVmgVXr37q3evXvf0nNbW1slSY2NjW05JWMFc67Onj2rMWPGKDU1VQUFBXdUnEi39+8KXwoPD1dqaqqKior8v2xbW1tVVFSk7OxsayeHDsvn82nOnDnasWOHDh48SJwEqbW11bLfeXdcoNys0tJSHTt2TKNGjVLPnj318ccfa9GiRbr77rvviKsnwTh79qxGjx6tpKQkvfjii/r888/925xOp4UzM1NlZaXOnTunyspKtbS06MSJE5Kke+65R9HR0dZOzmI5OTnKysrS0KFDNWzYMK1evVoNDQ166qmnrJ6aUS5cuKDTp0/7H585c0YnTpxQbGysEhMTLZyZedxut7Zu3apdu3apR48e/vcz2e12devWzeLZmSU3N1cTJkxQYmKizp8/r61bt+rgwYPau3evNROy5LNDHcA//vEP35gxY3yxsbG+iIgIX79+/XxPP/2079NPP7V6asYpKCjwSbrmgqtlZWVd81y9++67Vk/NCGvXrvUlJib6wsPDfcOGDfOVlJRYPSXjvPvuu9f8N5SVlWX11Ixzvf82FRQUWD014/zsZz/zJSUl+cLDw329e/f2jRs3zrdv3z7L5nPHvQcFAACY7856owAAAOgQCBQAAGAcAgUAABiHQAEAAMYhUAAAgHEIFAAAYBwCBQAAGIdAAQAAxiFQAACAcQgUAABgHAIFAAAYh0ABAADG+X9IfWnMCjLx/QAAAABJRU5ErkJggg==", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "import matplotlib.pyplot as plt\n", "\n", "data = ds.get_parameter_data()[\"z\"][\"z\"]\n", "\n", "pl, q3, q1, pu = np.percentile(data, [97,75, 25, 3])\n", "fig, ax = plt.subplots(1,1)\n", "ax.hist(data, bins=100)\n", "# IQR\n", "ax.axvline(q3, color='k')\n", "ax.axvline(q1, color='k')\n", "# cut off\n", "ax.axvline(q1-1.5*(q3-q1), color='b')\n", "ax.axvline(q3+1.5*(q3-q1), color='b')\n", "# limit through percentiles\n", "ax.axvline(pl, color='r')\n", "ax.axvline(pu, color='r')" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The black lines mark q1 and q3 and the blue lines correspond to the interval widened by 1.5 x IQR. The red lines present the lines of the percentile cutoff, in this case 3% on each side. The red lines limit how much of the data may be cut away through the blue lines. In this specific case of 3% they are not limiting the cutoff through the IQR estimation. Please also note the barely filled bins at +-10, that represent the outliers. The new color scale therefore roughly corresponds to a threefold increase of the steepness of color gradient." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Cutoff Percentiles" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Limiting the effect of an automatic color scale by the cutoff percentiles can be very important. To understand that consider the following example:" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Example 2: data on noisy background with outliers" ] }, { "cell_type": "code", "execution_count": 6, "metadata": {}, "outputs": [], "source": [ "# create a new dataset with outliers\n", "ds = dataset_with_outliers_generator(new_data_set('data_outside_iqr'),\n", " data_offset=2, low_outlier=-2,\n", " high_outlier=3)" ] }, { "cell_type": "code", "execution_count": 7, "metadata": {}, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "D:\\source\\repos\\Qcodes\\src\\qcodes\\dataset\\data_set_cache.py:85: UserWarning: Trying to mark a run completed that was already completed.\n", " self.load_data_from_db()\n" ] }, { "data": { "image/png": "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gVq5cqUaM2aMSkhIUCtXrlQrV65UGzZsEPt5//33FQD13nvvGe8MF8rei7vHunXrHK/Nz89XLVu2VB06dFBFRUXqqquuUuHh4erQoUNOfZa1PXvshw4dUkFBQeq6665zPHfHHXeouLg4lZWV5dR++PDhKiIiQhUUFCillPrhhx8UANWiRQvHc2XKYj/88IPjuf79+ysAavHixY7ndu7cqQAok8mkfvvtN8fzK1asUADU/PnzPR5Xu3btVHFxseN1r776qgKgtm3b5njuqquucvoOGQkJCVGjR48u9/y538UyKSkp6tyfmrs+hg0bpqxWq9q3b5/juWPHjqmwsDB1ySWXOJ4r++307dtX2Ww2pz7KYgcOHHA8d+5no5RSd999twoODlZFRUWG70Hiqu+ZM2cqTdOcvn8V/Q1nZmYqAColJaXca7t27apiYmLUiRMnHM9t3bpVmUwmNWrUqAqPefXq1QqAmjx5crmYrutKKaW2bNmiAKg777zTKf7QQw8pAGr16tVu39srr7ziOHaUKSkpUb1791ahoaHq1KlTSqn//cbDw8NVRkZGhcevlFKfffaZAqD++OMPr96nUq4/w8GDB6sWLVo4PXfu+3z//feVyWRSP/30k9Pr5s6dqwCoX375RXwPffv2Vd27dy/3/P33368AOPWbl5enmjdvrhITE5XdbldKuf6uK+X62OPud172GZx9nDn3N3vw4EFlNpvVM88849R227ZtymKxOD1fdoybO3eu02sr8nmV+fXXXxUAtXTpUsPX1gV+ceknOTkZ0dHRSEhIwI033oiQkBAsW7bMcSrbE7fccovTGZmyy0n79+83bNu9e3ckJyfDZrMhPj4eI0eORHJyMjIzMzFw4EAkJycjOTkZ3bt3d9vHzp07MXHiRPTu3RujR4/2+H0AwPjx47Fy5cpyj/bt2zteExwcjAULFmDHjh245JJLsHz5crz88sto2rRpuf569+7tNPamTZvi2muvxYoVK2C326GUwieffIKhQ4dCKeW4DJaVlYXBgwcjNzcXmzZtcupz9OjRqFevXoXeT2hoKIYPH+74d9k9QO3atXM6Y1D232WfmSfjGjt2rNPZncp8D2qa3W7Hd999h2HDhqFFixaO5+Pi4jBixAj8/PPPOHXqlFObu+66q0L3o5z92eTl5SErKwv9+vVDQUEBdu7c6dW4z+47Pz8fWVlZuPjii6GUwubNm73q+2zHjx/Hli1bMGbMGKczDp07d8bll19eqZTOTz75BJqmISUlpVys7JR/WX9Tpkxxij/44IMAUO4yxNm+/vprNGrUCLfeeqvjuYCAAEyePBmnT58ud8b2hhtucFzyqqiyv+C/+uorlJaWunxNRd4n4PwZll367t+/P/bv3+90iftcH330Edq1a+e4HF72KLu34ocffhDfw4kTJ1yeOf/666/Rs2dP9O3b1/FcaGgoxo8fj4MHD1b40lhV+fTTT6HrOm6++Wan99moUSO0atWq3PsMDAzE2LFjnZ6ryOdVpmyfuDqTXhf5xaWfN998E61bt0Zubi7mzZuHH3/80euMhXP/B132wZ88eVJsd/r0aRQVFQEAVq5ciYsuughZWVnQdR0//fQTnn76aWRlZcFsNru9NJWWloarrroKERER+Pjjj72+sbFVq1Yur+Geq0+fPrj33nvx5ptvYvDgwS6vfZb1d67WrVujoKAAmZmZMJlMyMnJwdtvv423337bZR8ZGRlO/27evHkF3skZTZo0KXf9NyIiAgkJCeWeA/73mWVmZlZ6XJ5+D3whMzMTBQUFaNOmTblYu3btoOs6UlNTnS4lVnS///3333jsscewevXqcpMd6X9EFXH48GFMnz4dy5YtK7dfve37bIcOHQIAt/tnxYoVjhuKjezbtw/x8fHiJZZDhw7BZDKVy0Zp1KgRIiMjHeNx17ZVq1YwmZz/FmzXrp3TeylTmd9Pmf79++OGG27AjBkz8PLLL2PAgAEYNmwYRowY4Th+VuR9AmdShFNSUrBu3ToUFBQ4xXJzcx2/xXPt2bMHO3bscDvJOvf36IpycR/GoUOHXCYtnL3/avKSyJ49e6CUcnnsBFDudoLGjRuXu/xdkc+rTNk+8UUtF3/kFxOVnj17Oq6VDhs2DH379sWIESOwa9cux3VETdNcfqHd3QzobnLgqo+zTZo0qdwNb2dfQ5w8eTImT56MZs2auSyolZubiyFDhiAnJwc//fQT4uPjxe1VpeLiYsc9M/v27avUneZn03UdAHDbbbe5PRtUds9AmYqeTQHcfzZGn5kn4/L0e+AJdweVqrhh1Z2K7PecnBz0798f4eHhePLJJ5GUlISgoCBs2rQJU6dOdexXT9jtdlx++eXIzs7G1KlT0bZtW4SEhODo0aMYM2aMU9+V/Q37i5r4n0Vlfj9lNE3Dxx9/jN9++w1ffvklVqxYgXHjxuGll17Cb7/9VuF7MPbt24eBAweibdu2mD17NhISEmC1WvH111/j5ZdfFr8fuq6jU6dOmD17tsv4uX98nKthw4Ze/dFQU785XdehaRq++eYbl8eUc/e1q8+zMp9X2T6Jioqq0vdRW/nFROVsZrMZM2fOxKWXXoo33njDkctev359l6frpb9qPPHwww/jtttuw4EDBzB+/Hj8+9//RlxcHP7zn//g66+/dlQvdPVFLCoqwtChQ7F79258//33TpdmakJKSgp27NiBF198EVOnTsUjjzyC1157rdzr9uzZU+653bt3Izg42PGXUVhYGOx2e4XO5NSU6OjoahlXZf9H5O719evXR05OTrnnXX1HXfURHR2N4OBg7Nq1q1xs586dMJlMhgd+V9asWYMTJ07g008/xSWXXOJ4/sCBA5Xu61zbtm3D7t27sXDhQowaNcrx/MqVK8u9tqK/YXf7t+yGS3f7JyoqqkJnU4AzNy+vWLEC2dnZbs82NGvWDLquY8+ePY6/5IEzN3rm5OSUuwH03LZ//vkndF13OqtSdplNaltZF110ES666CI888wzWLx4MUaOHIklS5bgzjvvrND7/PLLL1FcXIxly5Y5nYE0umwDnNmPW7duxcCBAz2a0LVt2xaffPJJueebNWvm9nMuiwP/O0N67u+uor+5ikpKSoJSCs2bN0fr1q097geQP68yZb/Ns793dZlf3KNyrgEDBqBnz5545ZVXHJdhkpKSsHPnTmRmZjpet3XrVvzyyy9Vuu327dsjOTkZFosF9evXx2233Ybk5GScOnUKffv2ddyf0qdPH6d2drsdt9xyC9atW4ePPvoIvXv3rtJxGfn999/x4osv4v7778eDDz6If/zjH3jjjTfKXQsHztSCOftejtTUVHzxxRcYNGiQowbHDTfcgE8++QR//fVXufZnfwY1qbrGFRISUqlLFCEhIS4nJElJScjNzcWff/7peO748eMus0Nc9WE2mzFo0CB88cUXTmfr0tPTsXjxYvTt2xfh4eEVHufZ/QLOZ5FKSkrwr3/9q9J9VaRvpRReffXVcq+t6G+47CzgufsnLi4OXbt2xcKFC51if/31F7777juXRRHdueGGG6CUchSWO1vZeynr79xqpmVnD6666iq3/V955ZVIS0tzyha02Wx4/fXXERoaiv79+1d4rO6cPHmy3Bmqrl27AoAjNbgi79PVZ5ibm4v58+cbjuHmm2/G0aNH8c4775SLFRYWiplowJn75U6ePFluAnvllVdi/fr1WLduneO5/Px8vP3220hMTHT8EViWLXd2eQW73e7y0nBlf+dnu/7662E2mzFjxoxy+1wphRMnThj2UZHPq8zGjRsRERHhdcbo+cLvzqiU+cc//oGbbroJCxYswD333INx48Zh9uzZGDx4MO644w5kZGRg7ty56NChQ7lr7lXhl19+caTBAmfS6B566CG3r3/wwQexbNkyDB06FNnZ2eUKvJ1dsG3BggUYO3Ys5s+f71Q/w51Nmza5LBiXlJSE3r17o6ioCKNHj0arVq3wzDPPADhTg+LLL7/E2LFjsW3bNqe/NDt27IjBgwc7pSeXtSkza9Ys/PDDD+jVqxfuuusutG/fHtnZ2di0aRO+//57ZGdnG467OlTHuLp3746lS5diypQpuPDCCxEaGoqhQ4eKr//+++8xe/ZsxMfHo3nz5ujVqxeGDx+OqVOn4rrrrsPkyZNRUFCAOXPmoHXr1uVu8nXXx9NPP42VK1eib9++mDBhAiwWC9566y0UFxfj+eefr/R7A87U+Klfvz5Gjx6NyZMnQ9M0vP/++1Vy+att27ZISkrCQw89hKNHjyI8PByffPKJy9P5Ff0N16tXD+3bt8fSpUvRunVrNGjQAB07dkTHjh3xwgsvYMiQIejduzfuuOMOR3pyRESEU60VI5deeiluv/12vPbaa9izZw+uuOIKx31ol156KSZNmoQuXbpg9OjRePvttx2Xz9avX4+FCxdi2LBhuPTSS932P378eLz11lsYM2YMNm7ciMTERHz88cf45Zdf8MorrzjS7b2xcOFC/Otf/8J1112HpKQk5OXl4Z133kF4eLhjklWR9zlo0CBYrVYMHToUd999N06fPo133nkHMTExOH78uDiG22+/Hf/5z39wzz334IcffkCfPn1gt9uxc+dO/Oc//8GKFSscl/Vdueqqq2CxWPD99987UvUB4JFHHsGHH36IIUOGYPLkyWjQoAEWLlyIAwcO4JNPPnGcperQoQMuuugiTJs2zXHWaMmSJbDZbOW2Vdnf+dmSkpLw9NNPY9q0aTh48CCGDRuGsLAwHDhwAJ999hnGjx8v/v8BqNjnVWblypUYOnQo71EpU0PZRS6VpZa5Stey2+0qKSlJJSUlOdIvP/jgA9WiRQtltVpV165d1YoVK9ymJ7/wwgvl+oSblEdX2rZtq5566imllFJHjhwxTCsrS0lz9zjb66+/rgCob7/9VhyDUXpyWXrrAw88oMxms/r999+d2m/YsEFZLBZ17733Ou2DiRMnqg8++EC1atVKBQYGqm7dujml8ZVJT09XEydOVAkJCSogIEA1atRIDRw4UL399tuO15SlAX700Ufl2rtLT+7QoUO51zZr1kxdddVV5Z4vG29VjctVKuLp06fViBEjVGRkpAJgmJ67c+dOdckll6h69eo5fQ5KKfXdd9+pjh07KqvVqtq0aaM++OADl+nJUh+bNm1SgwcPVqGhoSo4OFhdeuml6tdff3VqL/12XKVs/vLLL+qiiy5S9erVU/Hx8erhhx92pH+f/fl4kp68fft2lZycrEJDQ1VUVJS666671NatW8vtZ6Uq9htW6kx6Zvfu3ZXVai33u/3+++9Vnz59VL169VR4eLgaOnSo2r59e6XGrJRSNptNvfDCC6pt27bKarWq6OhoNWTIELVx40bHa0pLS9WMGTNU8+bNVUBAgEpISFDTpk1zSulWynXqdXp6uho7dqyKiopSVqtVderUqdz+kI5XRjZt2qRuvfVW1bRpUxUYGKhiYmLU1VdfXa5sQkXe57Jly1Tnzp1VUFCQSkxMVM8995yaN29eue+Rq/dZUlKinnvuOdWhQwcVGBio6tevr7p3765mzJihcnNzDd/HNddcowYOHFju+X379qkbb7xRRUZGqqCgINWzZ0/11VdfuXxdcnKyCgwMVLGxseqf//ynWrlyZbnvtrvfeUXSk8t88sknqm/fviokJESFhISotm3bqokTJ6pdu3Y57SNXx7iKfl47duxwlO2gMzSlWPqupt188804ePCgYx2hmqRpGiZOnIg33nijxrdNRHSun376CQMGDMDOnTvdZtXUJffffz9+/PFHbNy4kWdU/ssv71E5nymlsGbNGjz99NO+HgoRkc/169cPgwYN8vjS5vnkxIkTePfdd/H0009zknIWv71H5XylaVqFagsQ+Vp2djZKSkrcxs1mc6WLlFU3u91ueFN1aGhopcun17TMzEwxxdZqtVaozH5t8c033/h6CH6hYcOGOH36tK+H4Xc4USEi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rF+/Hh9++CFmzpyJd9991+N+PZqo5ObmOuqmfPvtt7jhhhsQHByMq666Cv/4xz88HgwREVGdVcvvUbnzzjtRr149PPbYYygoKMCIESMQHx+PV1991VEMzhMeTVQSEhKwbt06NGjQAN9++y2WLFkCADh58iSCguRrgURERHR+GjlyJEaOHImCggKcPn0aMTExXvfp0UTl/vvvx8iRIxEaGopmzZphwIABAM5cEurUSb5pioiIiFyo5TfTlsnIyMCuXbsAnCmhHx0d7VV/Hk1UJkyYgF69euHw4cO4/PLLYTKduSe3RYsWePrpp70aEBERUV2kKePMO6P2vpSXl4cJEybgww8/dKwmbjabccstt+DNN99ERESER/16nJ7cvXt3dO/e3em5q666ytPuap5yfzHQ3LiR2LQkNECMazY5BVUrqSfGS1vId0cH/Pq33L5NEzFuySkU47b0DDEOTU4Ws8REiXFdSDHWIuX0ZFt/efVNc4Gcfmw6LKfAqibyaUpLvvyXgS1STpO07DkixrV4+bvnbfqxt+13jZ0jxtvMv9fjbWuBgXK8cxu5gz93iWFT+km5vVF6sdkgtTxaLgugZcrb1wz6NzdvKsblxHgAJoMkT4PUenflHMooYf9pBqnjKCwSw6bOckkIZZN/96UN5N+l9a9D7rete1myoDLOg3tUNm/ejOXLl6N3794AgHXr1uG+++7D3Xff7bhNpLIqnJ48a9YsFBbK/4Mr8/vvv2P58uUeDYiIiIhqn6+++grz5s3D4MGDER4ejvDwcAwePBjvvPMOvvzyS4/7rfBEZfv27WjatCkmTJiAb775BpmZ//vL1Gaz4c8//8S//vUvXHzxxbjlllsQFhbm8aCIiIjqnLJ7VLx5+FDDhg1dXt6JiIhA/fryGUdJhScq//73v/H999+jtLQUI0aMQKNGjWC1WhEWFobAwEB069YN8+bNw6hRo7Bz505ccsklHg+KiIiozqnlixI+9thjmDJlCtLS/lfKNy0tDf/4xz/w+OOPe9xvpe5R6dKlC9555x289dZb+PPPP3Ho0CEUFhYiKioKXbt2RVSUfG8CERERnT+6desG7az7l/bs2YOmTZuiadMz91QdPnwYgYGByMzMxN133+3RNjy6mdZkMqFr167o2rWrRxslIiKic9TCm2mHDRtW7duokkUJiYiIyEu1cKKSkpJS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Vi1atHB67qefflLh4eGqqKjI6fmkpCT11ltvVe5NulBYWKguuOACNWLECKfnf/nlFxUTE6PsdrtSSqmUlBQVHBysTp065XjNP/7xD9WrVy/Hv/v376/atWundF13PDd16lTVrl07t9v/448/FACVl5enlFLqhx9+UADU559/7vL19evXVwsWLKj8GyUiv8F7VIg8dOmll2LOnDmOf4eEhHjVX/369fHee+9h8ODBuPjii/HII4+Iry8sLERQUJDTc1u3bsXp06fRsGHDcq/dt2+fV+MrLS3FzTffDKWU0/sGzlz2ufrqq53ulUlMTERYWJjj33FxcU6XbQDgoosucjqr07t3b7z00kuw2+0wm83YuHEjnnjiCWzduhUnT56ErusAgMOHD6N9+/aOdj169HA55nr16rm9dEZEtQMnKkQeCgkJqfCNo5qmOd17AZz5H/+5fvzxR5jNZhw/fhz5+flO/6M/V1RUFE6ePOn03OnTpxEXF4c1a9aUe/3Zl2oqq2yScujQIaxevRrh4eFO8WXLlpW7rBMQEOD0b03THBONisjPz8fgwYMxePBgLFq0CNHR0Th8+DAGDx6MkpISp9e6myRmZ2fX+A3ORFS1eI8KUQ2Ijo7G8ePHHf/es2dPub/0f/31Vzz33HP48ssvERoaikmTJol9duvWDWlpaU6TlQsuuABpaWmwWCxo2bKl0yMqKsqjsZdNUvbs2YPvv/++3NmaPXv24NChQ7j88ssr3fe594/89ttvaNWqFcxmM3bu3IkTJ05g1qxZ6NevH9q2bVvujIxk3759KCoqQrdu3So9LiLyH5yoENWAyy67DG+88QY2b96MDRs24J577nE645CXl4fbb78dkydPxpAhQ7Bo0SIsXboUH3/8sds+u3XrhqioKKdCbcnJyejduzeGDRuG7777DgcPHsSvv/6KRx99tFw6cUWUlpbixhtvxIYNG7Bo0SLY7XakpaUhLS3NcVbjiy++QHJystubfiWHDx/GlClTsGvXLnz44Yd4/fXXcd999wEAmjZtCqvVitdffx379+/HsmXL8NRTT1W4759++gktWrRAUlJSpcdFRP6DExWiGvDSSy8hISEB/fr1w4gRI/DQQw85/Y/9vvvuQ0hICJ599lkAQKdOnfDss8/i7rvvxtGjR132aTabMXbsWCxatMjxnKZp+Prrr3HJJZdg7NixaN26NYYPH45Dhw4hNja20uM+evQoli1bhiNHjqBr166Ii4tzPH799VcArtOSK2rUqFEoLCxEz549MXHiRNx3330YP348gDNnoRYsWICPPvoI7du3x6xZs/Diiy9WuO8PP/wQd911l0fjIiL/oalzL5wTUa2RlpaGDh06YNOmTWjWrFmNbz8rKwtxcXE4cuSIRxOh6vL333/jsssuw+7duxEREeHr4RCRF3hGhagWa9SoEd57771yxddqSnZ2NmbPnu1XkxQAOH78OP79739zkkJ0HuAZFSIiIvJbPKNCREREfosTFSIiIvJbnKgQERGR3+JEhYiIiPwWJypERETktzhRISIiIr/FiQoRERH5LU5UiIiIyG9xokJERER+6/8B4mvzzsNCwfsAAAAASUVORK5CYII=", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "ax, cb = plot_dataset(ds)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "In this example dataset the region of interest shall be represented by the center region. Again there are outliers that render the color grading almost useless.\n", "\n", "\n", "Looking at the same plot with an automatic color scale without limiting cutoff percentiles (by setting the cutoff to 50% we basically deactivate them) does not give a better result:" ] }, { "cell_type": "code", "execution_count": 8, "metadata": {}, "outputs": [ { "data": { "image/png": "iVBORw0KGgoAAAANSUhEUgAAAjcAAAHHCAYAAABDUnkqAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguMSwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/SrBM8AAAACXBIWXMAAA9hAAAPYQGoP6dpAACWCklEQVR4nO3dd3xT1fsH8E+60j3obiltKaNltoJUliBUKiDDxRQoU5aAFQVkVPZQKwpIFb8MlaUsqyDIkCW7BUSgg9LSAp2U7pnk/v7g10ho8qRNQtPxvH3l9bL3yTk5ubk3nNx7nnNEgiAIYIwxxhirJwz03QDGGGOMMV3izg1jjDHG6hXu3DDGGGOsXuHODWOMMcbqFe7cMMYYY6xe4c4NY4wxxuoV7twwxhhjrF7hzg1jjDHG6hXu3DDGGGOsXuHODXtuTp48CZFIhJMnT+q7KQ3K1q1bIRKJkJSUVO2yISEh8PLy0nmb6ruePXuiZ8+e+m7Gc/e83me/fv0wceJEnddbFUlJSRCJRNi6dat826effgqRSFTjbXn06BEsLCxw6NChGn/t+kavnZuKL+GKh5GREdzd3RESEoIHDx7os2lyOTk5MDAwwJEjRwAA+/fvh1gsRmlpqcLzLl++jOnTp6N169awsLBAkyZNMGTIEMTFxWn82hUnnarHqlWrtHpv7IkdO3Zg7dq1VX7+ihUrcODAAa1eUxd11FdFRUX49NNPuVPcQPz999/4888/MWfOnOf6OtU9z/XB3t4eEyZMwMKFC/XdlDrPSN8NAIAlS5bA29sbJSUluHDhArZu3YqzZ8/i33//hampqV7bdunSJQBAYGAgAOD8+fMICAiAWCxWeN7q1avx999/45133kG7du2QlpaG9evX44UXXsCFCxfQpk0bjdswfPhw9OvXr9L2gIAAjeusCS+//DKKi4thYmKi76aQduzYgX///RezZs2q0vNXrFiBt99+G4MHD9b4NXVRhyqjRo3CsGHDKh2jdUVRUREWL14MAA3iakhD99lnn6F3795o1qzZc32d6pznCxYswNy5c59re1SZPHkyvv76a5w4cQK9evXSSxvqg1rRuenbty86duwIAJgwYQIcHBywevVqREZGYsiQIXpt26VLl9CyZUvY2toCeNK5qejoPC00NBQ7duxQ+Id86NChaNu2LVatWoWffvpJ4za88MILePfddzUuX9NKSkpgYmICAwMDvXdOG5LCwkJYWFjA0NAQhoaG+m4O05BEIoFMJqv1Pwp0ISMjAwcPHkRERIS+m6LAyMgIRka6++exqKgI5ubmVXqun58f2rRpg61bt3LnRgu1csxN9+7dAQAJCQnybaru9T47RqDiVs7nn3+O7777Dj4+PhCLxXjxxRdx+fLlKr1+bm4usrKykJWVhfPnz6N9+/bIyspCeno6oqKi4Ovri6ysLOTm5srLdOnSpdKXUfPmzdG6dWvcvn27Gu+++k6cOAEDAwMsWrRIYfuOHTsgEomwceNG+TaRSITp06dj+/btaNmyJUxNTdGhQwecPn26Ur0PHjzAuHHj4OzsDLFYjNatW2Pz5s0Kz6kYV7Nr1y4sWLAA7u7uMDc3R15entIxNz179kSbNm3wzz//oEePHjA3N0ezZs2wZ88eAMCpU6cQGBgIMzMztGzZEseOHdOqXT///DOWL1+Oxo0bw9TUFL1798adO3cU2nPw4EHcu3dPfruPGnMiEolQWFiIbdu2yZ8fEhICQPV4lWfv31N1AMDVq1fRt29fWFtbw9LSEr1798aFCxcU6qy4pXvq1ClMnToVTk5OaNy4sULs6TE3v/76K/r37w83NzeIxWL4+Phg6dKlkEqlKt9rVZ05cwbvvPMOmjRpArFYDA8PD3zwwQcoLi5WeF5VzuGkpCQ4OjoCABYvXizfP59++qn8+SdOnED37t1hYWEBW1tbDBo0SKNzTCaT4auvvkLbtm1hamoKR0dHvPbaa7hy5Yr8ORKJBEuXLpV/j3h5eeGTTz6pdFtamYyMDIwfPx7Ozs4wNTVF+/btsW3bNoXnPP19tXbtWvnr3Lp1q0rv4cqVKwgODoaDgwPMzMzg7e2NcePGVft9btmyBb169YKTkxPEYjFatWql8L1BKS0tRVhYGJo1ayb//D/++OMq7aODBw9CIpEgKCioUuzu3bt455130KhRI5ibm+Oll17CwYMHFZ6janzZs9891T3PVY25+emnn9ChQweYmZmhUaNGGDZsGFJSUhSeU/EdFxUVhZdffhnm5ub45JNPAFTt8wKAV199Fb/99hsEQVDZRkarFVdunlVxoNrZ2Wlcx44dO5Cfn4/33nsPIpEIa9aswZtvvom7d+/C2NiYLDto0CCcOnVKYdvu3bvl/z916lRMnToVPXr0IMcFCIKA9PR0tG7dWuP3ATzp9WdlZVXabmtrCyMjI/Tq1QtTp07FypUrMXjwYLzwwgtITU3F+++/j6CgIEyePFmh3KlTp7B7927MmDEDYrEY33zzDV577TVcunRJfvssPT0dL730krwz5OjoiD/++APjx49HXl5epUu7S5cuhYmJCWbPno3S0lLyV+fjx4/x+uuvY9iwYXjnnXewceNGDBs2DNu3b8esWbMwefJkjBgxAp999hnefvttpKSkwMrKSqN2rVq1CgYGBpg9ezZyc3OxZs0ajBw5EhcvXgQAzJ8/H7m5ubh//z6+/PJLAIClpaXKtv/444+YMGECOnXqhEmTJgEAfHx8VD6/unXcvHkT3bt3h7W1NT7++GMYGxvj22+/Rc+ePeUdv6dNnToVjo6OWLRoEQoLC1W+5tatW2FpaYnQ0FBYWlrixIkTWLRoEfLy8vDZZ59Vq/3P+uWXX1BUVIQpU6bA3t4ely5dwrp163D//n388ssv1arL0dERGzduxJQpU/DGG2/gzTffBAC0a9cOAHDs2DH07dsXTZs2xaeffori4mKsW7cOXbt2RXR0dLUGQ48fPx5bt25F3759MWHCBEgkEpw5cwYXLlxQuJK8bds2vP322/jwww9x8eJFrFy5Erdv38b+/ftV1l1cXIyePXvizp07mD59Ory9vfHLL78gJCQEOTk5mDlzpsLzt2zZgpKSEkyaNAlisRiNGjVS2/6MjAz06dMHjo6OmDt3LmxtbZGUlIR9+/ZV+31u3LgRrVu3xsCBA2FkZITffvsNU6dOhUwmw7Rp01S2QSaTYeDAgTh79iwmTZoEPz8/3LhxA19++SXi4uLUjis7d+4c7O3t4enpqbA9PT0dXbp0QVFREWbMmAF7e3ts27YNAwcOxJ49e/DGG2+o3T9Pq+55rszy5cuxcOFCDBkyBBMmTEBmZibWrVuHl19+GVevXpVf3QeeDAzu27cvhg0bhnfffRfOzs5V/rwAoEOHDvjyyy9x8+ZNrYY0NGiCHm3ZskUAIBw7dkzIzMwUUlJShD179giOjo6CWCwWUlJS5M/t0aOH0KNHj0p1jBkzRvD09JT/nZiYKAAQ7O3thezsbPn2X3/9VQAg/Pbbb2rbdeXKFeHo0aPChg0bBADCTz/9JBw9elQICQkRPDw8hKNHjwpHjx4Vrly5Qtbz448/CgCE//3vf+p3hhIV70XV4/z58/LnFhYWCs2aNRNat24tlJSUCP379xesra2Fe/fuKdRZUfbptt+7d08wNTUV3njjDfm28ePHC66urkJWVpZC+WHDhgk2NjZCUVGRIAiC8NdffwkAhKZNm8q3VaiI/fXXX/JtPXr0EAAIO3bskG+LiYkRAAgGBgbChQsX5NuPHDkiABC2bNmicbv8/PyE0tJS+fO++uorAYBw48YN+bb+/fsrHEPqWFhYCGPGjKm0/dljsUJYWJjw7Kmmqo7BgwcLJiYmQkJCgnzbw4cPBSsrK+Hll1+Wb6s4d7p16yZIJBKFOipiiYmJ8m3PfjaCIAjvvfeeYG5uLpSUlKh9DxRlda9cuVIQiUQKx19Vz+HMzEwBgBAWFlbpuf7+/oKTk5Pw6NEj+bbr168LBgYGwujRo6vc5hMnTggAhBkzZlSKyWQyQRAE4dq1awIAYcKECQrx2bNnCwCEEydOqHxva9eulX93VCgrKxM6d+4sWFpaCnl5eYIg/HeOW1tbCxkZGVVuvyAIwv79+wUAwuXLl7V6n4Kg/DMMDg4WmjZtqrDt2ff5448/CgYGBsKZM2cUnhcRESEAEP7++2/yPXTr1k3o0KFDpe2zZs0SACjUm5+fL3h7ewteXl6CVCoVBEH5sS4Iyr97VJ3nFZ/B098zz56zSUlJgqGhobB8+XKFsjdu3BCMjIwUtld8x0VERCg8tyqfV4Vz584JAITdu3erfS5TrlbclgoKCoKjoyM8PDzw9ttvw8LCApGRkfLL7JoYOnSowpWfiltdd+/eVVu2Q4cOCAoKgkQigZubG0aOHImgoCBkZmaid+/eCAoKQlBQEDp06KCyjpiYGEybNg2dO3fGmDFjNH4fADBp0iQcPXq00qNVq1by55ibm2Pr1q24ffs2Xn75ZRw8eBBffvklmjRpUqm+zp07K7S9SZMmGDRoEI4cOQKpVApBELB3714MGDAAgiDIb9FlZWUhODgYubm5iI6OVqhzzJgxMDMzq9L7sbS0xLBhw+R/V4xp8vPzU7gyUfH/FZ+ZJu0aO3aswlWk6hwHNU0qleLPP//E4MGD0bRpU/l2V1dXjBgxAmfPnkVeXp5CmYkTJ1ZpfM3Tn01+fj6ysrLQvXt3FBUVISYmRqt2P113YWEhsrKy0KVLFwiCgKtXr2pV99NSU1Nx7do1hISEKFzZaNeuHV599dVqpc/u3bsXIpEIYWFhlWIVtyMq6gsNDVWIf/jhhwBQ6RbJ0w4dOgQXFxcMHz5cvs3Y2BgzZsxAQUFBpSvDb731lvx2XFVVXCn4/fffUV5ervQ5VXmfgOJnWHFbvkePHrh7967C7fdn/fLLL/Dz85Pfqq94VIwV+euvv8j38OjRI6VX6A8dOoROnTqhW7du8m2WlpaYNGkSkpKSqnzbTlf27dsHmUyGIUOGKLxPFxcXNG/evNL7FIvFGDt2rMK2qnxeFSr2ibIr9qxqasVtqQ0bNqBFixbIzc3F5s2bcfr0aa0zPZ79R73iYHn8+DFZrqCgACUlJQCAo0eP4qWXXkJWVhZkMhnOnDmDZcuWISsrC4aGhipvm6WlpaF///6wsbHBnj17tB7c2bx5c6X3pJ/VtWtXTJkyBRs2bEBwcLDSe7kV9T2rRYsWKCoqQmZmJgwMDJCTk4PvvvsO3333ndI6MjIyFP729vauwjt5onHjxpXuZ9vY2MDDw6PSNuC/zywzM7Pa7dL0ONCHzMxMFBUVoWXLlpVifn5+kMlkSElJUbjNWdX9fvPmTSxYsAAnTpyo1EGi/vGqiuTkZCxatAiRkZGV9qu2dT/t3r17AKBy/xw5ckQ+qFqdhIQEuLm5kbd/7t27BwMDg0pZPC4uLrC1tZW3R1XZ5s2bw8BA8fejn5+fwnupUJ3zp0KPHj3w1ltvYfHixfjyyy/Rs2dPDB48GCNGjJB/f1blfQJP0rHDwsJw/vx5FBUVKcRyc3Pl5+Kz4uPjcfv2bZUds2fPR2UEJeNK7t27pzRx4+n9V5O3a+Lj4yEIgtLvTgCVhjq4u7tXujVflc+rQsU+0cdcO/VFrejcdOrUSX7vd/DgwejWrRtGjBiB2NhY+X1RkUik9CRQNSBSVYdCWR1Pmz59eqVBf0/fE50xYwZmzJgBT09PpZOk5ebmom/fvsjJycGZM2fg5uZGvp4ulZaWyscAJSQkVGuE/tNkMhkA4N1331V51aliDESFql61AVR/Nuo+M03apelxoAlVX0S6GLSrSlX2e05ODnr06AFra2ssWbIEPj4+MDU1RXR0NObMmSPfr5qQSqV49dVXkZ2djTlz5sDX1xcWFhZ48OABQkJCFOqu7jlcW9TEPzDVOX8qiEQi7NmzBxcuXMBvv/2GI0eOYNy4cfjiiy9w4cKFKo8pSUhIQO/eveHr64vw8HB4eHjAxMQEhw4dwpdffkkeHzKZDG3btkV4eLjS+LM/WJ5lb2+v1Q+NmjrnZDIZRCIR/vjjD6XfKc/ua2WfZ3U+r4p94uDgoNP30ZDUis7N0wwNDbFy5Uq88sorWL9+vXyuATs7O6W3EqhfT5r4+OOP8e677yIxMRGTJk3CDz/8AFdXV/z88884dOiQfBZLZQdvSUkJBgwYgLi4OBw7dkzhtlFNCAsLw+3bt/H5559jzpw5mDt3Lr7++utKz4uPj6+0LS4uDubm5vJfYFZWVpBKpVW6YlRTHB0dn0u7qvuPl6rn29nZIScnp9J2ZceosjocHR1hbm6O2NjYSrGYmBgYGBio/cdCmZMnT+LRo0fYt28fXn75Zfn2xMTEatf1rBs3biAuLg7btm3D6NGj5duPHj1a6blVPYdV7d+KQaeq9o+Dg0OVrtoATwZwHzlyBNnZ2Sqvanh6ekImkyE+Pl5+xQB4Mtg1Jyen0iDYZ8v+888/kMlkCldvKm4BUmWr66WXXsJLL72E5cuXY8eOHRg5ciR27dqFCRMmVOl9/vbbbygtLUVkZKTClU51t5SAJ/vx+vXr6N27t0adQF9fX+zdu7fSdk9PT5Wfc0Uc+O9K7LPnXVXPuary8fGBIAjw9vZGixYtNK4HoD+vChXn5tPHHaueWjHm5lk9e/ZEp06dsHbtWvktIh8fH8TExCAzM1P+vOvXr+Pvv//W6Wu3atUKQUFBMDIygp2dHd59910EBQUhLy8P3bp1k4+36dq1q0I5qVSKoUOH4vz58/jll1/QuXNnnbZLnYsXL+Lzzz/HrFmz8OGHH+Kjjz7C+vXrK93bB57M1fP02JSUlBT8+uuv6NOnj3yOlLfeegt79+7Fv//+W6n8059BTXpe7bKwsKjW7RMLCwulnRgfHx/k5ubin3/+kW9LTU1VmlWjrA5DQ0P06dMHv/76q8JVwfT0dOzYsQPdunWDtbV1ldv5dL2A4tWqsrIyfPPNN9Wuqyp1C4KAr776qtJzq3oOV1xtfHb/uLq6wt/fH9u2bVOI/fvvv/jzzz+VTnSpyltvvQVBEOSTBT6t4r1U1PfsrLYVVyn69++vsv5+/fohLS1NIctSIpFg3bp1sLS0RI8eParcVlUeP35c6UqYv78/AMjTsKvyPpV9hrm5udiyZYvaNgwZMgQPHjzApk2bKsWKi4vJDD7gyfi/x48fV+r09uvXD5cuXcL58+fl2woLC/Hdd9/By8tL/sOxIsvw6akspFKp0tvW1T3Pn/bmm2/C0NAQixcvrrTPBUHAo0eP1NZRlc+rQlRUFGxsbLTOtG3Iat2VmwofffQR3nnnHWzduhWTJ0/GuHHjEB4ejuDgYIwfPx4ZGRmIiIhA69atK40h0IW///5bnnIMPElZnD17tsrnf/jhh4iMjMSAAQOQnZ1dadK+pyfh27p1K8aOHYstW7YozG+iSnR0tNJJAH18fNC5c2eUlJRgzJgxaN68OZYvXw7gyRwhv/32G8aOHYsbN24o/KJt06YNgoODFVLBK8pUWLVqFf766y8EBgZi4sSJaNWqFbKzsxEdHY1jx44hOztbbbufh+fRrg4dOmD37t0IDQ3Fiy++CEtLSwwYMIB8/rFjxxAeHg43Nzd4e3sjMDAQw4YNw5w5c/DGG29gxowZKCoqwsaNG9GiRYtKA51V1bFs2TIcPXoU3bp1w9SpU2FkZIRvv/0WpaWlWLNmTbXfG/BkDiY7OzuMGTMGM2bMgEgkwo8//qiTW3O+vr7w8fHB7Nmz8eDBA1hbW2Pv3r1KbzVU9Rw2MzNDq1atsHv3brRo0QKNGjVCmzZt0KZNG3z22Wfo27cvOnfujPHjx8tTwW1sbBTmwlHnlVdewahRo/D1118jPj4er732mnxc3SuvvILp06ejffv2GDNmDL777jv5rb1Lly5h27ZtGDx4MF555RWV9U+aNAnffvstQkJCEBUVBS8vL+zZswd///031q5dK5/aQBvbtm3DN998gzfeeAM+Pj7Iz8/Hpk2bYG1tLe+YVeV99unTByYmJhgwYADee+89FBQUYNOmTXByckJqairZhlGjRuHnn3/G5MmT8ddff6Fr166QSqWIiYnBzz//jCNHjsiHHCjTv39/GBkZ4dixY/JpEQBg7ty52LlzJ/r27YsZM2agUaNG2LZtGxITE7F371751bDWrVvjpZdewrx58+RXp3bt2gWJRFLptap7nj/Nx8cHy5Ytw7x585CUlITBgwfDysoKiYmJ2L9/PyZNmkT++wBU7fOqcPToUQwYMIDH3GijhrKylKpI41OWGieVSgUfHx/Bx8dHnur6008/CU2bNhVMTEwEf39/4ciRIypTwT/77LNKdUJFeqkyvr6+wtKlSwVBEIT79++rTeGrSP9T9XjaunXrBADC4cOHyTaoSwWvSCX+4IMPBENDQ+HixYsK5a9cuSIYGRkJU6ZMUdgH06ZNE3766SehefPmglgsFgICAhRSJiukp6cL06ZNEzw8PARjY2PBxcVF6N27t/Ddd9/Jn1ORcvnLL79UKq8qFbx169aVnuvp6Sn079+/0vaK9uqqXcrSPgsKCoQRI0YItra2AgC1qdAxMTHCyy+/LJiZmSl8DoIgCH/++afQpk0bwcTERGjZsqXw008/KU0Fp+qIjo4WgoODBUtLS8Hc3Fx45ZVXhHPnzimUp84dZemxf//9t/DSSy8JZmZmgpubm/Dxxx/LU+2f/nw0SQW/deuWEBQUJFhaWgoODg7CxIkThevXr1faz4JQtXNYEJ6kwnbo0EEwMTGpdN4eO3ZM6Nq1q2BmZiZYW1sLAwYMEG7dulWtNguCIEgkEuGzzz4TfH19BRMTE8HR0VHo27evEBUVJX9OeXm5sHjxYsHb21swNjYWPDw8hHnz5imkzwuC8jT39PR0YezYsYKDg4NgYmIitG3bttL+oL6v1ImOjhaGDx8uNGnSRBCLxYKTk5Pw+uuvV5qioirvMzIyUmjXrp1gamoqeHl5CatXrxY2b95c6ThS9j7LysqE1atXC61btxbEYrFgZ2cndOjQQVi8eLGQm5ur9n0MHDhQ6N27d6XtCQkJwttvvy3Y2toKpqamQqdOnYTff/9d6fOCgoIEsVgsODs7C5988olw9OjRSse2qvO8KqngFfbu3St069ZNsLCwECwsLARfX19h2rRpQmxsrMI+UvYdV9XP6/bt2/IpUpjmRILAUyDWtCFDhiApKUm+blVNEolEmDZtGtavX1/jr80YY886c+YMevbsiZiYGJXZSA3JrFmzcPr0aURFRfGVGy3UyjE39ZkgCDh58iSWLVum76Ywxpjede/eHX369NH4tmt98ujRI3z//fdYtmwZd2y0VGvH3NRXIpGoSnM/MKZv2dnZKCsrUxk3NDSs9sRzz5tUKlU7sNzS0rLaU+/XtMzMTDKd2cTEpEpLNNQVf/zxh76bUCvY29ujoKBA382oF7hzwxhT6s0331SabVdB1VxP+pSSkqJ2QrywsLBqDT7WhxdffJGc5kLdunaMNXTcuWlgeIgVq6ovvviCnGBNk4nnnjcXFxelc+w87emlLWqr7du3V1pV/WnaLCrMWEPAA4oZY4wxVq/wgGLGGGOM1SsN7raUTCbDw4cPYWVlxaPRGWOMkQRBQH5+Ptzc3CothFqTcnNzUVJSAmdnZ721oS6pc7elTp8+jc8++wxRUVHyqe0HDx5c5fL379/XaH0exhhjDVdKSgoaN26st9dv37kv7sVdxYPkhCqvodaQ1bkrN4WFhWjfvj3GjRuHN998s9rlK6Y9d1/9CQxMTZU+x+wevVucrqlOjwWAxy1MyHiBN70Kc7Olt8h4uX8zMp4WqPx9yam5YCVWs0iv01l6HZW492zJuM/uUpUxg9LK06Y/rcyOfm8iKd1XF8enkfG0AfSChlJjMgzX0/TaNQYl9LHz6EV6FeD3xkyhG1CHbVtLTyxpfiaGjItc6V+0Kf3ptPXGW26Tcai50pvfg15QMasd/avf+2f6vJI0ogdwZ7cyJ+N5zelzQxDR8RbrH5DxBwNU/2h0uZBPlo0Pod+b6UPt/qny2nGffkJRicqQRFaGk9k/6WTJDE2dOXMGcf/8DSe3phj74Vf4OeITvbWlrqhznZu+ffuib9++GpevuBVlYGoKAzPl/1AaiundYmREf0kZiunOjYEp3bkxEtHlBSP6H3hDsXadG0P65WFkKCbjqvarvLyR6gYYSMrJsjI1712k5gvayIB+c4Ymavad2n2j+ksSAAwM6Z2v7vXNLKq/cGZdYWSs5rhRc16I1ByX6s4LdfWr69yoa7+hKf29oe68grrzXs2xY2CqpnNjoO7c0Xz/GhnS57W67wxDU+3+qVLXdhjQ38mAdquKa0MQBEyYPg+vDfsALdp2wfqFw5CzaipsbW310p66ot4PKC4tLUVeXp7CgzHGGKsLDh8+jNTkWLw27AO0fjEIXi0DMHomz+asTr3v3KxcuRI2NjbyB4+3YYwxVhfIZDJMnvkJXn93DszMn9wWe2viUvz5y9dIT0/Xc+tqt3rfuZk3bx5yc3Plj5SUFH03iTHGGFNrz549yM/JRK83Jsu3NWvzElp16IVR05frsWW1X73v3IjFYlhbWys8GGOMsdpMIpFg5uyFGDx2IUzEigOu35q4BCcjN5FLdDR09b5zwxhjjNU17y3cAkGQoVu/MZViHj5t0bHnmxg19dOab1gdUeeypQoKCnDnzh3534mJibh27RoaNWqEJk2aVLke42wjGKgYgW+sZlHW3KZ0VoXr5n/IuJsFnbJZ1KMVGb/f05CM28SRYVjdpzMX7r1DZ00UudLpyr6f0KnsRd1Up8w+7EbvG5+f6VRr3Ewgw7c2tCXjdtF09e5H6XTd9O72ZNwsk87KKLFruBNLGufR0wDAy50M355iS8ZbbKPTkdVlQ2UMpc9Lp3PZZDyrHb2Kt8SBnrvkcUs1qeAv0PuvVVgyGRds6avaj3rQ4xUbH1Q9BiS1D52m7/fRTTIeF0bve5+fi8i4zJZO446foXr+GllJCVDDmdclJSU4sHkJhk5dDSMj5fNPvDE+DPNHtcPt2x/Dz8+vZhtYB9S5KzdXrlxBQEAAAgICAAChoaEICAjAokWL9NwyxhhjTHvj53wDC6tG6NTrHZXPcXb3Qbd+IRgzdWENtqzuqHNXbnr27MkrWzPGGKuX8vPz8dsPqzBh3ia1yz0MHPMJ5gzzRVRUFDp06FBDLawb6tyVG8YYY6y+CgkNh7NHM7Tv0l/tcxs5uiPorakYO5VnLH4Wd24YY4yxWuDRo0f4Y2c43pm0rMozIvcf+THu3LyAU6dOPefW1S3cuWGMMcZqgdEzVqJZ65fgG9CjymUsbezRd3goJrw/j4dsPIU7N4wxxpiePXz4EMf2foO3Ji2tdtk+Q2YiPSUehw4deg4tq5vq3IBiXbGLEWBooryXm9NczeKGqhe1BgDcndOOjHsvo/ONH3SnPxa722p652p67+aJOWTcb4GaXHiplAyXBviQ8bwmqt+fiK4axW50umzeSy+Q8SaRdLqs5T/0yseFbemUVqfN9GcrCaRTNlO7q1ngrx6TmtJTHOS+SKdSm6XS521uc0syXtidTjd2P0mvSxc31o6MO1yjz8s7IfR57xFJnxxGOfT+u7WUTuVutZpOZc/zovfvo/ZOKmMu5+i2F/b0JePOF+l9V+JEnzeWUZlk3DtS9cKdEkkpamKqvFHTlqJd577w9q3+wGAzcyu8Pmoups6aj8S+fdUORG4IeA8wxhhjepSQkIAzh7bgrQmLNa6j1+DJKMh7hJ9//lmHLau7uHPDGGOM6dHED9egU68hcPPSfDI+E7EpBoUswEfzec0poAHflmKMMcZqA1uDTLzc5Qze9dFupmG/XiX4fUuJjlpVt3HnhjHGGNMzGQTIQC/PUpU62BPcuWGMMcb0TIAAqaBt50a78vUJj7lhjDHGWL3SYK/cZLUHDFRk/zleVZNKnU6vqp0SpHwV1wo5bweQcYlzGRm3PUinVaZ1olcPvjvckYx776FTSh+9QKe82sbRK/SaFKheVb1QzaycJjn0vhF50If04+Z0/EFPNzJukaIm3diLTkW3vUMfO96RdBx09XWa2dUkMm6cT68Knt2GPu7TXdX8qjWl48JZ+rdg033FZPxxS3rFe5TTx1ZKMF280VW6vPU9+ntNZqU6HRoAmhyhV1W/30v1ytuG5eqmp8gl46L0R2Q8rzs9/QRM6VRxoxxinIpUzdwfOiJA+9tKfFvqPw22c8MYY4zVFrL//08bAndu5Pi2FGOMMcbqFb5ywxhjjOmZIABSLdeG0rZ8fcKdG8YYY0zPBAhaj5nh21L/4c4NY4wxpmcyAFItOyfalq9PeMwNY4wxxuoVvnLDGGOM6ZnubkvRUwI0FA22c9NsWzaMDJXPfZDbvhFZ1rBYQsa9f6XjmQH0fBeNLqieBwYAZEZq5l1Qc2xLzOgTKH4UPY+NeRr9AgZl9Dw8ttsvqYxJxgeSZWVieg6eQlcyjMZ/0ftO/FMKGU97oxkZd/47m4xLbOi5RO68S3/29VnSpOZk3OYufdy2+PRfMv5wfFsyLojoYwtR18jwg7kvknEDNaet+1H6Qrr1tXQy/qiLCxk3/vMKGY9f+xIZt71Jt89z1wOVsZgP6BPToJz+zm06O5aMWzyg56eS3U8l43fDVE8gJSspAW6QxXVCppMBxTpqTD3QYDs3jDHGWG3xZBI/7etgT/CYG8YYY4zVK3zlhjHGGNMzGQQdZUvxmBuAOzeMMcaY3gnQfsyMjO9LyfFtKcYYY4zVK3zlhjHGGNMzGbQfUKxt+fqkwXZuRBIpRILylOVSK/qC1uPedCq3195HZLzMii7veINOJb/7Nv2xCeJyMt5qXiIZl2Y/JuOGzbzJOKT0KfbgfdXp3hapdNmH3ZSn78tf2pS+Lps0yJiMW7anU72LnMkwJOZ0SqtMTbax2X06jtZq4nWY7R36s099hY6ndWlFxp3P08eGeQZ93qROp1O9zehMbVil0PWnBNPntcRMTap3Ib1/8t7tTMZbLo8n48Uv0Od97EzV6dgtw26TZYu6tSDjd76m09TdTpFhpL0TQMbFWapjUjUp/LoiQASpluNlZDzeRq7Bdm4YY4yx2kIQtB8zw2Nu/sNjbhhjjDFWr/CVG8YYY0zPniycqe1tKVaBOzeMMcaYnsl4zI1O8W0pxhhjTM8EADJBpN1DB50bQRCwaNEiuLq6wszMDEFBQYiPpwebP23VqlUQiUSYNWuW1m3RBnduGGOMMQYAWLNmDb7++mtERETg4sWLsLCwQHBwMEpKStSWvXz5Mr799lu0a9euBlpKa7i3pcrLAKnyXq7jpRyyqNSKXrn5QZA9GffcSa88XeRHp3z6zqXTKjOG06sf53X3IeMyE7r3n+lP94mdrtB3fg2IjNgiZ7pu00wyDNs47dIFMjrS5a2S6H0jUnPT2yqdfoLUtOFeVra+nUfGbW6p+Wzv0udV6lj6Cze3KX1el7jQq923/F8BGU9804aMq1s1PL8xHS9qSbfPd1YMGU8bTs8zUG5Bv76YmAEjfRidpm/5kJ7+wncDkasN4PbHdmTcazd97Jg+UH3sSaSliCNL64bubktp/h0oCALWrl2LBQsWYNCgQQCAH374Ac7Ozjhw4ACGDRumsmxBQQFGjhyJTZs2YdmyZRq3QVf4yg1jjDGmZ0/muTHQ8qFd5ygxMRFpaWkICgqSb7OxsUFgYCDOnz9Plp02bRr69++vUFafGu6VG8YYY6weystTvBIlFoshFtMToAJAWloaAMDZWXG2UmdnZ3lMmV27diE6OhqXL1/WoLXPB1+5YYwxxvRM0HYwsSCCIIhQWFgIGxsbhcfKlSuVvub27dthaWkpf5SX07NoK5OSkoKZM2di+/btMDU11XY36AxfuWGMMcb0TBfz3EghgoWFBVJTUxW2q7pqM3DgQAQG/rccTmnpk4Ff6enpcHV1lW9PT0+Hv7+/0jqioqKQkZGBF1544b92SKU4ffo01q9fj9LSUhgaqll35jngzg1jjDGmZzKIIBW0u5ki+//y1tbWVXq+lZUVrKys5H8LggAXFxccP35c3pnJy8vDxYsXMWXKFKV19O7dGzdu3FDYNnbsWPj6+mLOnDl66dgA3LlhjDHGGCCfn2bZsmVo3rw5vL29sXDhQri5uWHw4MHy5/Xu3RtvvPEGpk+fDisrK7Rp00ahHgsLC9jb21faXpO4c8MYY4zpmQARZFoOg9XFJH4ff/wxCgsLMWnSJOTk5KBbt244fPiwwniahIQEZGXR6fn61mA7N6n9GsNQrHzwUyk9HQUa/1VExgs96HkGZI2syHiRC/2xSHvTc0Y8bk3PpSJJpC8Tuh94QMZTX3Mk48WO9Hwh5sRcLxZ7L5FlM6a/RMbzm9BfDs6X6MlEWm6i51qBQH+2QiYx2QcAUSN6Pg4YqbmE+x4drsvUzR8lOnuNjBu28yPjec3o88I0kz52/MIzyLgkIZGM27bpTMYbXX1MxjMDG5Fxt7/peW7UcdoSTcZjNtDzZ7VakqoyVtTWjSxrfukuGZfl0XMImSc4kXHxyStkHCbEsSeU0WV1pLYsvyASibBkyRIsWbJE5XOSkpLIOk6ePKl1O7TVYDs3jDHGWG0hCNqPudG2fH3Ce4Ixxhhj9QpfuWGMMcb07MmYG+1uK2m3+Ez9wp0bxhhjTM9k/7/8gja0LV+f8J5gjDHGWL3CV24YY4wxPZPpYECxjAcUyzXYzk1eMykMzJSnTlrH0+m4Rnl0OrFlijkZf9yWzjWXGdH3Xa3+zSTjLY6oTskEgKI+7ch43HQ6bVOcRLfvcXsJGXf+Jl9lTKZmNsuc9vTaJ6JiuvxdP7rt1tfoNHe37/8h43mv0ZNW2fxLp4onD6Jfvz7LfIE+b4r6diHjxqoPKwCA0yV6REJOc7q81N6SjKe+QbfP+h6dil7mYEHGHS7nkPG4cfSstM0kXmRcdPkWGW/8h5ppCkSqz63kPvQ/ui1PldBVN21Cxl3/psuX9qS/84zzVX+vSCUlAD1DhU7Ulnlu6osG27lhjDHGaosnyy/of56b+oKvYTHGGGOsXuErN4wxxpieCTrIltL2tlZ9wp0bxhhjTM9kgkjrAcEyLW9r1SfcuWGMMcb0jK/c6BbvCcYYY4zVK3zlhjHGGNMzXWRLaVu+PmmwnZuWXz2EkYFYaUyS8pAsK/LxIuM2icrnz6mQ8QI9X4T7SXoencyXncn4o/ZOZNw6gb5g1/yHx2S8zJGejyTpdRMyLkrLUh1rTU82Ypiv5pAV0XOZWF+m25bbgp6LJHMYPV+GSQFdXjCkv3xKHBvu6jAmuWrmoWlLz59kG0cfG6U29L43LiDDuDOCnoemZXgyGS/3pOcwetjVjIx77lJ93gCA3S1bMm5QRM8RFfs9fWz7zblLxhPfa6YyZp1AFoUgo8+bxy/ak/FG13Lo8oF2ZNwmSXVMIqG/z3VFF/PcCJwKLse3pRhjjDFWrzTYKzeMMcZYbaGL5Re0LV+fcOeGMcYY0zMB2s8wzLel/sOdG8YYY0zPZDDQwZUb7txU0Ps1rA0bNsDLywumpqYIDAzEpUv0CmVr165Fy5YtYWZmBg8PD3zwwQcoKaEXTWOMMcZYw6HXKze7d+9GaGgoIiIiEBgYiLVr1yI4OBixsbFwcqqc8bNjxw7MnTsXmzdvRpcuXRAXF4eQkBCIRCKEh4fr4R0wxhhj2uNJ/HRLr52b8PBwTJw4EWPHjgUARERE4ODBg9i8eTPmzp1b6fnnzp1D165dMWLECACAl5cXhg8fjosXL1b7te+GeMDQ1FRpzDi3CVnW4widKv2wK32ANf6LTslUd3xmdaVTYj330OVlJnTK7f0+dNpkgQ+dGumo5uMobat6/xa60Knappn0ZVfzNPq1pXT18P06nYwnv+1KxnNa0u2zOZhKxqXm9L6vz/K86X0nMqKPW6NSOm63/QrdgBd86TidrYyECfT3hs1dun1FLcvoFyinvzccrtG57LHvWZFx+zP0FBWyxvQUE15f3lAZE8rotue+FUDGbX5U86ViQU9PIe1Jn1dJr6v+p1BWbAScoF9eFwRB++UTeFXw/+itm1dWVoaoqCgEBQX91xgDAwQFBeH8+fNKy3Tp0gVRUVHyW1d3797FoUOH0K9fP5WvU1pairy8PIUHY4wxVpvI/v/KjTYP7tz8R29XbrKysiCVSuHsrDghnbOzM2JiYpSWGTFiBLKystCtWzcIggCJRILJkyfjk08+Ufk6K1euxOLFi3XadsYYY4zVXnXqBt3JkyexYsUKfPPNN4iOjsa+fftw8OBBLF26VGWZefPmITc3V/5ISUmpwRYzxhhj6gkwgEzQ/sGe0NuVGwcHBxgaGiI9XXGMQ3p6OlxcXJSWWbhwIUaNGoUJEyYAANq2bYvCwkJMmjQJ8+fPh4FB5Q9WLBZDLFa+zAJjjDFWG8gASLW8rcS3pf6jt26eiYkJOnTogOPHj8u3yWQyHD9+HJ07d1ZapqioqFIHxtDwySA4QWi4a/Iwxhhj7D96zZYKDQ3FmDFj0LFjR3Tq1Alr165FYWGhPHtq9OjRcHd3x8qVKwEAAwYMQHh4OAICAhAYGIg7d+5g4cKFGDBggLyTwxhjjNU1giDS+raSttlW9YleOzdDhw5FZmYmFi1ahLS0NPj7++Pw4cPyQcbJyckKV2oWLFgAkUiEBQsW4MGDB3B0dMSAAQOwfPnyar92mXM5DMyUd4h8vkoky8Z/2IKMN19+k4wLTd3JuMSKvo3W/Hs6FbzESXmKewWzB0Vk3KiQfn37f+kTyPS06pRQADAg0jYfvEzvW4v7ZBiN/qHTYQ0zc8h4YogHGXe+SKe0FjuqOaWU3Dp9mkl2w+2ke62gU7ULBrxAxo0K6SkKDD0bk/GEAXSqdFkjun5zNcemSE0que/7yhMpKtybTq/a7XidPjYNSuljzzqZTkW/M5TeP1In1eduy3WlZNlSa/o7xaw3/dmLcuj6ZWpOK5Mc1ftGWlIzNzieZEvxbSld0fvyC9OnT8f06dOVxk6ePKnwt5GREcLCwhAWFlYDLWOMMcZqhm6u3PCA4gq8JxhjjDEG4Mn41UWLFsHV1RVmZmYICgpCfHy82nIPHjzAu+++C3t7e5iZmaFt27a4ckXNxJnPEXduGGOMMT2TQQSpYKDVQxdjbtasWYOvv/4aERERuHjxIiwsLBAcHEyu4fj48WN07doVxsbG+OOPP3Dr1i188cUXsLPT34zrer8txRhjjDV0AkRaj5nRtrwgCFi7di0WLFiAQYMGAQB++OEHODs748CBAxg2bJjScqtXr4aHhwe2bNki3+bt7a1VW7TFV24YY4wxPRMEHVy5+f9/0p9dcqi0lB5wXSExMRFpaWkKyyLZ2NggMDBQ5bJIABAZGYmOHTvinXfegZOTEwICArBp0ybtdoiWuHPDGGOM1ROFhYWwsbFReFRMp6JOWtqTlYeVLYtUEVPm7t272LhxI5o3b44jR45gypQpmDFjBrZt26b5G9ES35ZijDHG9EwGHawKLgAWFhZITU1V2K5qlv7t27fjvffek/998OBBzV5XJkPHjh2xYsUKAEBAQAD+/fdfREREYMyYMRrVqa0G27lxPW4II2Plkx/cH0nPtdJs2T9kXFpAz7WS27YVGc9vQh/gTQ7lkvFCJ3pSB+MCE7q8qzEZt7upZmV1CT0Pz+3PvFTGbKLoqk0K6MlCRLcS6Nf+xo+MGz+kXz/bj943Non0XChxn9KfvWOUmpm2e9Dhuix2nT8Zdz5NnxcPBqiZSKbYiQybZNHFDYvVXOhW89HledPtL55Ez2NjF0+/P/Mr9Pxcsn7NyLhhMX3einPo7w2Te6rnx0rtTs+d5f676qsCAHD/deVL8lRovI8u7/gP3fasNqrbJ63aHR2tCf+/Krg2Km5LWVtbV+n5AwcORGBgoPzvittX6enpcHV1lW9PT0+Hv7+/ynpcXV3RqpXid5ufnx/27t1b1abrXIPt3DDGGGMNmZWVFays/pucURAEuLi44Pjx4/LOTF5eHi5evIgpU6aorKdr166IjY1V2BYXFwdPT8/n0u6q4DE3jDHGmJ49mcRP+4c2RCIRZs2ahWXLliEyMhI3btzA6NGj4ebmhsGDB8uf17t3b6xfv17+9wcffIALFy5gxYoVuHPnDnbs2IHvvvsO06ZN06o92uArN4wxxpiePUkF1+56g6CD5Rc+/vhjFBYWYtKkScjJyUG3bt1w+PBhmJr+t6xPQkICsrL+u4/74osvYv/+/Zg3bx6WLFkCb29vrF27FiNHjtS6PZrizg1jjDGmZ08m8dOuc6JteeDJ1ZslS5ZgyZIlKp+TlJRUadvrr7+O119/XevX1xW+LcUYY4yxeoWv3DDGGGN6Jgjap4ILOrhyU1802M6NzflkGBkoTw8sGNqULJs5jE7ZzPWhX9vyPh2X0lmTiB9Jp/m5/k2nI98LptMipY7lZPyxrw0ZLx/7Ahn3W5quMnb7EweyrNu8JDKeGuJPxpvspdNdy6zofF7bf7LJeMz79L5xuECGYfqY/uzqs6a76Pd+dwwdF8rpC9HWsfQUCYWeanK51WSaex7IJON5rRqRcas/b5LxmM/paQQEAzrV2/kC/Q/fvX7mZNz9FP29YPr3bZWxuMVtybLJb9Cp3k12JJHx2/M9yLjdDfqzz/MvUxmTFauO6ZJOVgXnmzFyDbZzwxhjjNUWMogg1XptKVaBu3mMMcYYq1f4yg1jjDGmZwK0n6dG2/L1CXduGGOMMT3TyZgbLcvXJ7wnGGOMMVav8JUbxhhjTM9keDKoWBu6mKG4vuDODWOMMaZngk5mKNZRY+qBBtu5iZ3jAQMzU6WxZjuKybLJwWZkvPnaO2Rc0tSVjMe/q7xdFZruoedqkVjSczq4XKATBq1PJZJxwZWeiyZ+DD2fx615qsu3WpGlMgYAuT3oSYTKLcgwLC4lkXHjlu5kXGpJfza2/9CnlOPxZDIeM7sxGa/PUrvSEzz5vn+DjEv86XleUrsYk/EWC+n6Y1a3JuN3hzmSccdr9Dw9ye/T82cZFNH/ctmcjCfj5b70XDC5PvT3mmBE/8Mb/6nquWwa/0W/9wJ3+rx51IteXVrdd7ZMTH8nAqqPPWmZDClqSuuCLsbcCHV4zE15eTnS0tJQVFQER0dHNGpE/zuiTt3dE4wxxhirs/Lz87Fx40b06NED1tbW8PLygp+fHxwdHeHp6YmJEyfi8uXLGtXNnRvGGGNMzwQ8SeXW6lGHxtyEh4fDy8sLW7ZsQVBQEA4cOIBr164hLi4O58+fR1hYGCQSCfr06YPXXnsN8fH0lclnNdjbUowxxlhtIYP2nZO6NKD48uXLOH36NFq3Vn67t1OnThg3bhwiIiKwZcsWnDlzBs2bN69y/dy5YYwxxvRMEHQxiZ+OGlMDdu7cWaXnicViTJ48udr1820pxhhjjNUrfOWGMcYY07OGPENxYWEhVq1ahePHjyMjIwMymWJG7927d6tdZ4Pt3FjcNYShivRAwysxZFnpQH8yfnsFnbbo+3kuGQfodOPsVnTKbEET+tpk4xN0Kvmjfi3IeGZHuv4W2/LIeH5TK5UxmSWdjmq5P4qM2zR2I+O3w7zJuNkDOmXUcx+dqu50kU6zTw9uQsZ9P6dTxbGdDtdl4mw6XtzNl4ybnrpJxs2atSfjIgtzMt58Op21YdSiKRnP6kynintupb/Ab4fRx86dD+jz1lrNvw9eX9Kp8NmD25Bx8weqb6mkvEr/o+t0mf5OaXQiiYyXtqTPe1E5fV46XCtUGZNISsiyulIxoFirOuro2lITJkzAqVOnMGrUKLi6ukIk0v59NNjODWOMMcb0748//sDBgwfRtWtXndXJnRvGGGNMzwQdZEvVpVTwp9nZ2Wk9ad+z6uYNOsYYY6weEQTt57kR6lC21NOWLl2KRYsWoaioSGd18pUbxhhjTM8E6CAVvI5eufniiy+QkJAAZ2dneHl5wdhYcamU6OjoatfJnRvGGGOM6c3gwYN1Xid3bhhjjDE9k+lkEr+6eeUmLCxM53U22M5NmS1gqCLj+tFwf7KsBZHyCAAFxnQ68e0Pbci4z046VTupHz1Uqul+eoVc49v0GrdmNqpTtQHAOsmOjKu78Wt9W3XO72N/e7KsbRx9yN6ZSK/q7bcwloxLc3LIeEpoIBk3fUyGUahm0e/bc+j212f5XvRxU+hOr+rtWdCSjIvobGDcWupFxn2n59AVZNNxh7/p91fclj44/NZkkPGH/el0aAk9wwREjWzJeE5L+nvPoEx1zPwh/Z1lXEivGg4TEzJc7EwfG7Zn1EyxICMODhnxxnSoIaeCV4iKisLt27cBAK1bt0ZAQIDGdTXYzg1jjDFWWzTkbKmMjAwMGzYMJ0+ehK2tLQAgJycHr7zyCnbt2gVHR3qOKGU4W4oxxhhjevP+++8jPz8fN2/eRHZ2NrKzs/Hvv/8iLy8PM2bM0KhOvnLDGGOM6VlFKri2ddRFhw8fxrFjx+Dn5yff1qpVK2zYsAF9+vTRqE7u3DDGGGN6pptVwevmbSmZTFYp/RsAjI2NK60zVVV8W4oxxhhjAABBELBo0SK4urrCzMwMQUFBiI+PJ8tIpVIsXLgQ3t7eMDMzg4+PD5YuXQqhipeSevXqhZkzZ+Lhw4fybQ8ePMAHH3yA3r17a/Q+uHPDGGOM6VlFtpRWDx0MKF6zZg2+/vprRERE4OLFi7CwsEBwcDBKSlQvILp69Wps3LgR69evx+3bt7F69WqsWbMG69atq9Jrrl+/Hnl5efDy8oKPjw98fHzg7e2NvLy8KtfxLL4txRhjjOmZLm5LaZsKLggC1q5diwULFmDQoEEAgB9++AHOzs44cOAAhg0bprTcuXPnMGjQIPTv3x8A4OXlhZ07d+LSpUtVel0PDw9ER0fj2LFjiImJAQD4+fkhKChI4/fSYDs33utiYCRSPndC6qhWZNncVvQ8NL4RhWS8zN6MjD94WUzGm+6n198ocaDL3wul5wORmtKXEpsvvE6Xf6EFGb//uq3KmHM0vW8TP6HnPXC+Qs+XkTiNfu+WKfR799h0i4wXvELX77D9H7p8v/ZkHO3ocF1m/y8dz3qBvvd+Zzx9IVqUS3+2lvH012HMen8y7ruxgIwLaua/MotKJONZr9PnlWEpGYZpNr3/kod5kHERfWrCNl51/ekv0WU9IukJooSsR2Q8PZCe48f2RDkZj1ngozImKy4BPiaL64QAkQ46J0/K5+XlKWwXi8UQi+l/FwAgMTERaWlpCp0KGxsbBAYG4vz58yo7N126dMF3332HuLg4tGjRAtevX8fZs2cRHh5epXbfvXsXTZs2xauvvopXX321SmXU4dtSjDHGWD1RWFgIGxsbhcfKlSurVDYtLQ0A4OzsrLDd2dlZHlNm7ty5GDZsGHx9fWFsbIyAgADMmjULI0eOrNLrNmvWDK+88gp++ukn8vZXdXDnhjHGGNMzAU8m4dPuAVhYWCA3N1fhMW/ePKWvuX37dlhaWsof5eX0FS5Vfv75Z2zfvh07duxAdHQ0tm3bhs8//xzbtm2rUvno6Gi0a9cOoaGhcHFxwXvvvYeLFy9q1JYK3LlhjDHG9EzQdjCx8N9tLWtra4WHqltSAwcOxLVr1+QPBwcHAEB6errC89LT0+Hi4qKy7R999JH86k3btm0xatQofPDBB1W+YuTv74+vvvoKDx8+xObNm5Gamoru3bujTZs2CA8PR2ZmZpXqeRp3bhhjjDE9E/Ckg6PtozqsrKzQrFkz+aNVq1ZwcXHB8ePH5c/Jy8vDxYsX0blzZ5X1FBUVwcBAsTthaGhY7TlqjIyM8Oabb+KXX37B6tWrcefOHcyePRseHh4YPXo0UlNTq1wXd24YY4wxBpFIhFmzZmHZsmWIjIzEjRs3MHr0aLi5uWHw4MHy5/Xu3Rvr16+X/z1gwAAsX74cBw8eRFJSEvbv34/w8HC88cYb1Xr9K1euYOrUqXB1dUV4eDhmz56NhIQEHD16FA8fPpRncFVFg82WYowxxmoLncxQrIN5bj7++GMUFhZi0qRJyMnJQbdu3XD48GGYmv63rHxCQgKysrLkf69btw4LFy7E1KlTkZGRATc3N7z33ntYtGhRlV4zPDwcW7ZsQWxsLPr164cffvgB/fr1k18N8vb2xtatW+Hl5VXl9yESqjqFYD2Rl5cHGxsbeHyxFAZmpkqf0+KHYrKOh90tybg4h26DYSm9y9N70DmXIgO6vOGjytNYP635jzlkXGZC93klNspT6CvcC6bjUmvV6dp+X2aTZXMCHMi4+DGdCm6cTw+YM8rMJ+MJo5zJuNU9MoyCJnTc+xc65XXExsV0BXXYjkFTyHjCh35k3DaePi+KnOgvflN61+NxG7p+00y6/jIburw9PUsAGv2VRMaz+niRccsH9LH/uAV93opz6PYLRKa7cQF9eyLzBTpN3ue7ZDL+uGtjNfXTn41NvOq4tKwE/2z5BLm5ubC2tibr0dSbb76JaOc8uAx+Uat6CuPTkL7kIDIyMnTUsprRvHlzjBs3DiEhIXB1dVX6nLKyMuzcuRNjxoypUp185YYxxhhjeqNueQcAMDExqXLHBuDODWOMMaZ3Ml3clqrD92FycnJw6dIlZGRkVBqIPHr06GrXx50bxhhjTN8EQNtBInV1kMlvv/2GkSNHoqCgANbW1hCJ/uvkiUQijTo3nC3FGGOM6ZkuJvETdDCgWB8+/PBDjBs3DgUFBcjJycHjx4/lj+xsehymKty5YYwxxpjePHjwADNmzIC5ubnO6uTODWOMMaZnFQtn1uQkfrVFcHAwrly5otM6ecwNY4wxpme1ZZ4bfejfvz8++ugj3Lp1C23btoWxseJ0JgMHDqx2nQ22c9N83j8wEimfDyZ+VQeyrI2arDWbhFIybnI1ga5ARM/nkduUPoC9v7xJxhNDW5Px0sb0fBg219XMo7OEnrCjuLvq91fga0+WNS6k58sodKEPaYe79P1bSbyaz8aAnufG8RJdf4FHIzJ+ZyT9/uuzhNn0cd/kT3q1YOPMAjJu6UrPUVLoSh/XBiX0edfoNj3HUr4HPZdLvgcZRuZHXmRcZkeftwV36HlsjIro18/zpt+/17dxKmNxHzcny7qcp/edLD2LjOd50hNINfqXHmlr+aBMZUwiUR3TtYY6oHjixIkAgCVLllSKiUQiSKX08aFMg+3cMMYYY0z/qrsGVVXwmBvGGGNMzwRB+4UzUUfH3KiSk5OjsIZVdei9c7NhwwZ4eXnB1NQUgYGBuHTpEvn8nJwcTJs2Da6urhCLxWjRogUOHTpUQ61ljDHGdE83A4r1/S504/jx4xgxYgRcXV0RFhamUR167dzs3r0boaGhCAsLQ3R0NNq3b4/g4GCV62KUlZXh1VdfRVJSEvbs2YPY2Fhs2rQJ7u7uNdxyxhhjjOlKSkoKlixZAm9vb/Tp0wcikQj79+9HWlqaRvXptXMTHh6OiRMnYuzYsWjVqhUiIiJgbm6OzZs3K33+5s2bkZ2djQMHDqBr167w8vJCjx490L59+xpuOWOMMaY7gvDfEgzaPOqS8vJy/PLLLwgODkbLli1x7do1fPbZZzAwMMD8+fPx2muvVcqcqiq9dW7KysoQFRWFoKCg/xpjYICgoCCcP39eaZnIyEh07twZ06ZNg7OzM9q0aYMVK1ZoNJKaMcYYqzWEinE3Wjz0/R6qyd3dHevWrcNbb72FBw8eYN++fXj77bd1UrfesqWysrIglUrh7KyYWuvs7IyYmBilZe7evYsTJ05g5MiROHToEO7cuYOpU6eivLxc5X250tJSlJb+l5qdl5cHAIj/sg0MzEyVlvH9SPnrVxCpWfZeeJxDxgt6+dLxxnTv2/I+GYbIgU43drxGdwbLEujDIqMHnXKKse3UvH6xylhBYzFZttCFTqd1vqwmn9WQ7s8XDH2JjHuvuEbGyzrT6cwGanadXayarIFudLguk1jS7z3Pkz42HOLpy9fZvRzIuO1dCRn3WfovGX80jL6CXKImy7/pN3fIeMaAZmQ8tzn9C7fJbzlkXCSh378onz63pI9zVcZ85tETtInatSDjGWNfIOOmj8gwGv2bT8ZT+qj+TpeWyoC/6Pp1oWLMjXaV1K0rNxKJBCKRCCKRCIaG9Hd7del9QHF1yGQyODk54bvvvkOHDh0wdOhQzJ8/HxERESrLrFy5EjY2NvKHh4eaySQYY4wx9tw9fPgQkyZNws6dO+Hi4oK33noL+/fvV1g4U1N669w4ODjA0NAQ6enpCtvT09Ph4uKitIyrqytatGih0MPz8/NDWloaysqUT7Q0b9485Obmyh8pKSm6exOMMcaYLuggFbyuLb9gamqKkSNH4sSJE7hx4wb8/PwwY8YMSCQSLF++HEePHtV42IneOjcmJibo0KEDjh8/Lt8mk8lw/PhxdO7cWWmZrl274s6dOwoT/sTFxcHV1RUmJspn3xSLxbC2tlZ4MMYYY7WJoKNHXeXj44Nly5bh3r17OHjwIEpLS/H6669XGrpSVXq9LRUaGopNmzZh27ZtuH37NqZMmYLCwkKMHTsWADB69GjMmzdP/vwpU6YgOzsbM2fORFxcHA4ePIgVK1Zg2rRp+noLjDHGmNYa8sKZTzMwMEDfvn2xZ88e3L9/H5988olG9eh1+YWhQ4ciMzMTixYtQlpaGvz9/XH48GF5Ty05ORkGBv/1vzw8PHDkyBF88MEHaNeuHdzd3TFz5kzMmTNHX2+BMcYYY9UkCILasTWOjo4IDQ3VqH69ry01ffp0TJ8+XWns5MmTlbZ17twZFy5ceM6tYowxxmqQLu4r1aH7Uq1bt8aiRYvw5ptvqhxWAgDx8fEIDw+Hp6cn5s6dW+X69d650ZeWazJhZKA8tfT2UjotURDTKavuh13JeFZ7+m6gIb2oOB51o1epNc90IuNWp+mUU0FNSqhRMZ3unOlPhnH3LdUpvTJr+rWbf0/Hy6zpdNj40XZkvPERMgxZkZp0WFM6ndHiIf3tI87T/QJydYXtbfq8KFMzXE6mZgoG40J632f401+H0kB/Mm6oZvFo13P0PACCk5opHHbfIOP2ao7NjImBZNw2gX4DiSPoD0CcrHplbs/f6FRsg5xCMu68k57/QuRKf+c9DqDz8F0uqf7SlUhKoXq9c13S/rZSHerbYN26dZgzZw6mTp2KV199FR07doSbmxtMTU3x+PFj3Lp1C2fPnsXNmzcxffp0TJkypVr1N9jODWOMMcb0o3fv3rhy5QrOnj2L3bt3Y/v27bh37x6Ki4vh4OCAgIAAjB49GiNHjoSdHf2jVBnu3DDGGGN6VjHLsHaV6KQpNapbt27o1k33s5Nq3LkpLy9HWloaioqK4OjoiEaN6EuqjDHGGFPh/+e50aqKepAtpSvVSgXPz8/Hxo0b0aNHD1hbW8PLywt+fn5wdHSEp6cnJk6ciMuXLz+vtjLGGGP1lOjJ8gnaPhiAanRuwsPD4eXlhS1btiAoKAgHDhzAtWvXEBcXh/PnzyMsLAwSiQR9+vTBa6+9hvj4+OfZbsYYY4wxpap8W+ry5cs4ffo0WrdurTTeqVMnjBs3DhEREdiyZQvOnDmD5s2b66yhjDHGWH2lizE3Wo/ZqUeq3LnZuXNnlZ4nFosxefJkjRvEGGOMNUgNsHMikUiwY8cOBAcHa7zUgjI6yZbKy8vDiRMn0LJlS/j50XOg1BpGRoCh8rfvOz+WLJr4QSsynkNPkwOnaHohMKvL9JwOQk4uGZe18ibjMYvoK2pN99IT7Vgm0/Np2Fym21fmpXrOiUetTcmyhjfp253mFuZkvFkxPQeR8eNiMq5uCTeDMnqeGokZfcqZX6M/+/rM6VwO/YSYu3RcoPd9kTM9HkGk5sN1PU/PU2NUTFdQbqXm61bLlZCTF9Dz2NjF0vvnYVfVE6kBgN8navZ/mer9c/sL+jvJ8xczMm6a8pCMlza2IeOFzvQIjNymqufekpYKwEmyuG400AHFRkZGmDx5Mm7fvq3TejVaW2rIkCFYv349AKC4uBgdO3bEkCFD0K5dO+zdu1enDWSMMcZYzdi3bx/69OkDe3t7iEQiXLt27bm/ZqdOnXT+OhpduTl9+jTmz58PANi/fz8EQUBOTg62bduGZcuW4a233tJpIxljjLF6rxbMc1NYWIhu3bphyJAhmDhxovYVVsHUqVMRGhqKlJQUdOjQARYWFgrxdu3aVbtOjTo3ubm58nltDh8+jLfeegvm5ubo378/PvroI02qZIwxxhosXazqrYvbUqNGjQIAJCUlaV1XVQ0bNgwAMGPGDPk2kUgkX1xTKlU3IKAyjTo3Hh4eOH/+PBo1aoTDhw9j165dAIDHjx/D1JQeM8EYY4yx5ycvL0/hb7FYDLFY9bgifUtMTNR5nRp1bmbNmoWRI0fC0tISnp6e6NmzJ4Ant6vatm2ry/YxxhhjDYMObksVFhbCxkZxgHVYWBg+/fRTLSt/fjw9PXVep0YDiqdOnYoLFy5g8+bNOHv2LAwMnlTTtGlTLFu2TKcNZIwxxhoGkZYPwMLCArm5uQqPefPmKX217du3w9LSUv44c+bMc313lB9//BFdu3aFm5sb7t27BwBYu3Ytfv31V43q0zgVvEOHDujQoYPCtv79+2taXc2TSaEqsTe/V0uyaIk7nRJqUGhIxgty6fj9JXS6st/cMjIe/64FGbeOp/u0BqevknGRCZ0yWvaS8okeK5jcSlFdtx+dph7zVTMybvCIbluTPyVk/P6b9OqzFoFdyHieDxmGzy95ZDy7p+5/wdQV5Y3odOC0D18g4x5rr5Fx5yv0eWNQSt/Xl4np8za9I31L3imKnmJBZkp/HT9+qw0ZV/erXyKmx2MY0rsHMKbbJ6OmqCilv3PE6fQUDPdn0J+9UQkZRl4r+rxv+b3q15dISlAj8+0L0Nk8N9bW1lV63sCBAxEY+N8UAu7u7rppQDVt3LgRixYtwqxZs7B8+XL5GBtbW1usXbsWgwYNqnadVb5ys2rVKhQX0wdghYsXL+LgwYPVbgxjjDHGaoaVlRWaNWsmf5iZ0T8wnpd169Zh06ZNmD9/PgwN//sR0bFjR9y4cUOjOqt85ebWrVto0qQJ3nnnHQwYMAAdO3aEo6MjgCczDN66dQtnz57FTz/9hIcPH+KHH37QqEGMMcZYg6OLKzc6uPKTnZ2N5ORkPHz4ZOLE2Ngnk9q6uLjAxcVF+xdQIjExEQEBAZW2i8ViFBYWalRnla/c/PDDDzh27BjKy8sxYsQIuLi4wMTEBFZWVhCLxQgICMDmzZsxevRoxMTE4OWXX9aoQYwxxljDUztWBY+MjERAQIB8mMmwYcMQEBCAiIgIretWxdvbW+kkfocPH9Z41YNqjblp3749Nm3ahG+//Rb//PMP7t27h+LiYjg4OMDf3x8ODg4aNYIxxhhryHSxcKYurtyEhIQgJCRE+4qqITQ0FNOmTUNJSQkEQcClS5ewc+dOrFy5Et9//71GdWo0oNjAwAD+/v7w9/fX6EUZY4wxxgBgwoQJMDMzw4IFC1BUVIQRI0bAzc0NX331lXyCv+rSycKZjDHGGNNSLbhyoy8jR47EyJEjUVRUhIKCAjg5OWlVH3duGGOMMX3TyZiZurcq+NMyMjLkA5hFIpE8aUkTDbZzEzfZGQZmyuelsL9GHyAiI3o+DN/V98h47Mf0XCbuB+mP5fZqurzv+/+ScZGtDRkvGNiJjKd2ptunbs4Jw5dUz2UjoafoQcuv6cqTBtFTjJv+fZuMN71Cl5c2o+eBkBlbkvGsAHr+iaxAeg6l+uzuKPq8cz5B/ywt69KKjJvGpZPx+295kHHLBzIyLqhJz3jYjT62PA/Sx7ZtTBEZz3pBTRqviG6g90Z6NpfbS7zJuGG+6v1n/Ij+bB/2tCLj7uEXyXjBmy+S8dxW9OvnNVN93krKjYAosjjTUn5+PqZOnYqdO3dCJntynhkaGmLo0KHYsGFDpRmXq0KjGYoZY4wxpjsiACJBu0ddvS01YcIE+fx4OTk5yMnJwe+//44rV67gvffe06hOra7c3LlzBwkJCXj55ZdhZmYmX8GTMcYYY9VQS+a50Yfff/8dR44cQbdu3eTbgoODsWnTJrz22msa1anRlZtHjx4hKCgILVq0QL9+/ZCamgoAGD9+PD788EONGsIYY4w1WAJqxTw3+mBvb6/01pONjQ3s7OglcVTRqHPzwQcfwMjICMnJyTA3N5dvHzp0KA4fPqxRQxhjjDHW8CxYsAChoaFIS0uTb0tLS8NHH32EhQsXalSnRrel/vzzTxw5cgSNGzdW2N68eXP5ap6MMcYYq4YGdFsqICBAYRhLfHw8mjRpgiZNmgAAkpOTIRaLkZmZqdG4G406N4WFhQpXbCpkZ2dDLKYzAhhjjDH2jDo8IFgTgwcPfq71a9S56d69O3744QcsXboUwJN8dJlMhjVr1uCVV17RaQOflxZrU2BkYKI09vBNOuXR7I7ycnLG9G712U2vri41pcv7zU0h43nBbch4Vlv6bqRIzQlmkkfHS5zoCrxPlqqMpXVSnp5fQWZC75vGJ+h02pjP6XThlpvodFuDQtVtBwDXQ7lkPCfQlS5/wpCMw5cO12XNx10h40nLu5Bx0yx6vEHui3Qav3E+GYZhGX1cN/k1g4xLE+ir2rJOrcn4vb6Vf1A+TSSl2yeSkGGUtm5Cxt3/pPfv/X6qX8D9CH1cW9ynvxMNWqmePgIAHgbRafotIwrIOIhEGImUPud1qgFduQkLC3uu9WvUuVmzZg169+6NK1euoKysDB9//DFu3ryJ7Oxs/P3337puI2OMMcYagIKCAvlcNxWsren5wZTRaEBxmzZtEBcXh27dumHQoEEoLCzEm2++iatXr8LHx0eTKhljjLGGSxeZUnU0WyoxMRH9+/eHhYWFPEPKzs4Otra2GmdLaTzPjY2NDebPn69pccYYY4z9v4pJ/LSqow7dlnrau+++C0EQsHnzZjg7O+tkvjyNOzclJSX4559/kJGRUekS0sCBA7VuGGOMMcbqv+vXryMqKgotW7bUWZ0adW4OHz6M0aNHIysrq1JMJBJBKqXXXmKMMcbYUxrwDMUvvvgiUlJS9N+5ef/99/HOO+9g0aJFcHZ21lljGGOMMdawfP/995g8eTIePHiANm3awNjYWCHerl27atepUecmPT0doaGhdbpjkzTGE4Zi5WnH7qfodOL7veh05dxOdMqpzXk6ldvIgL7feHsVnbJpmEmXFwzp7n3LjfTqyXHv0Z+7xxE659Tkoep06UI/eoy70c7KVwuflt2T3je+c+lVwUtfbEbGc3zoUfu5zel963GM3jfio9fIOKbS4bosbhO9srNZMl3e7AGdy31vGv3ZGebT543TL7FkPCeYztO3jLtLxuOH098rvmH0sZs1iH79rJfoY+9xNj1HmeljOt261WePVcbuDnciy9pcyibjWT0bk3EYl5PhQk961XGr84kqYwayMvq1dUXQwZgb3bSkxmVmZiIhIQFjx46VbxOJRPL1KjW5G6RR5+btt9/GyZMnOTOKMcYYY1oZN24cAgICsHPnTv0OKF6/fj3eeecdnDlzBm3btq10CWnGjBlaN4wxxhhrULRN5a6jY27u3buHyMhINGtGXzmvDo06Nzt37sSff/4JU1NTnDx5UqGXJRKJuHPDGGOMVUcDHlDcq1cvXL9+Xf+dm/nz52Px4sWYO3cuDAw0mgeQMcYYY09roJ2bAQMG4IMPPsCNGzeU3g3SZHoZjTo3ZWVlGDp0KHdsGGOMMaaVyZMnAwCWLFlSKabpgGKNeidjxozB7t27NSnKGGOMsWeIBN086iKZTKbyoem8eRpduZFKpVizZg2OHDmCdu3aVbqEFB4erlFjGGOMsQarjnZOaiONOjc3btxAQEAAAODff/9ViOkihasmyEwAqJjWobSRsfLA/3OKpnuSOT6GZFxiSs/FktGFnk/C/Xd6H+c3puMSCzKMh31dyLjPngIynuVvScZN01XPp2F1w4Qsm9eJnu8i/RV6Lo88z1ZkXEpP9QHvvTlk3OkyfTE0rzm9b8y9POgG1GOt5ieRcam3KxkX5RWScYNiegG+Zj+pnn8JAEQujmQ8tYeaf5l6dSTDvh/T89gIzehjw2HfLTJunknP/mpxKZ6Mx86lB3s+bql6LpumG+LIskJJKRm3jWtExrM6mNH101/JkPi4qY5JSoAMujzTjrLbUU9btGhRtevUqHPz119/aVKMMcYYY8o04Gyp/fv3K/xdXl6OxMREGBkZwcfHp+Y6N4wxxhjTrYa6KvjVq1crbcvLy0NISAjeeOMNjeqscufmzTffxNatW2FtbY0333yTfO6+ffs0agxjjDHWIAkiHUziVzeGhVSFtbU1Fi9ejAEDBmDUqFHVLl/lbCkbGxv5eBobGxvywRhjjLG6Z9++fejTpw/s7e0hEolw7do1tWU2bdqE7t27w87ODnZ2dggKCsKlS5e0bktubi5yc+mxcKpU+crNli1bsGTJEsyePRtbtmzR6MUYY4wxpkQtGXNTWFiIbt26YciQIZg4cWKVypw8eRLDhw9Hly5dYGpqitWrV6NPnz64efMm3N3phaQB4Ouvv1b4WxAEpKam4scff0Tfvn01eh/VGnOzePFiTJ48Gebm5hq9GGOMMcYqE6F2jJmpuAWUlJRU5TLbt29X+Pv777/H3r17cfz4cYwePVpt+S+//FLhbwMDAzg6OmLMmDGYN29eldvxtGp1bgShFux5HXE7UwYjI+V35VK70OnIhiV03S6X6CcYXYoh4/Z/0SmrcbPoVHKzNDIMAzrrEmXWdDzlVTqd2fVv+gViZ6pO2xTl0WnwDjfoNHz3Q/Qh/YjOBEeZI12/xNaUjBuevU7Gbe/bk/H4UB8yXp/dG9ecjHseyCTjEjc6XbjF5sdkPL0rXd7ltyQybneDThV3PptNxpNmtCbjtgn0929BT7q86990qnz8B/T+d75En5t5HqrHe8TOo+uW2ZaTcb+V9GfndIn+wf2gP10/9U+hrNgIuKimuC7o8MpNXl6ewmaxWAyxWM08FzpUVFSE8vJyNGpEn1MVEhMTdd6Gas9QXFfmsWGMMcYamsLCwkrjYFeuXFmjbZgzZw7c3NwQFBRUo6/7tGqngrdo0UJtByc7m/6FwhhjjDFFukgFt7CwQGpqqsJ2VVdttm/fjvfee0/+9x9//IHu3btr1YZVq1Zh165dOHnyJExN6SvdFQoLC7Fq1SocP34cGRkZkMkUrxLevXu32u2odudm8eLFnBHFGGOM6ZIOb0tZW6sZW/D/Bg4ciMDAQPnfVRn8S/n888+xatUqHDt2DO3atatyuQkTJuDUqVMYNWoUXF1ddXKHqNqdm2HDhsHJSfU024wxxhir/aysrGBlZaWTutasWYPly5fjyJEj6NiRXmrkWX/88QcOHjyIrl276qQtQDU7NzzehjHGGHtOakEqeHZ2NpKTk/Hw4UMAQGxsLADAxcUFLi5P1h0cPXo03N3d5WN5Vq9ejUWLFmHHjh3w8vJCWtqTrBZLS0tYWtIJKABgZ2dX5cHHVVWtAcX1KVuKMcYYqy1Egg4eOmhHZGQkAgIC0L9/fwBP7tYEBAQgIiJC/pzk5GSFcT0bN25EWVkZ3n77bbi6usofn3/+eZVec+nSpVi0aBGKiop08A6eqNaVm2cH+dRlj1qbwFBMp3yr0mTPQzKeOFL1CrMA4HWF7lPGfESv/uv1G53WKL5yh4wnfEznQzf77gEZlzWie+JZAfSYLJP7qmM+P9Hpvgnv0um2BmoyPh2v0anej4vo5YMTQujyZt0CybjrOTpN3uu3YjKOLnRYnR+7DyPjo87s0u4FtFDsqub7pYjeNxIP+rjLa0qnCz9uR3+2xY5eZNz7Z3rp6CJveooHwzIyrJbb2QIyXuhOr5zddG8+GS/wsiDjDrckKmOZhvQ/NZ7f0Ekoee3o815iSv+z7jcvmYxnvK56xXNpmQwpZOn6JSQkBCEhIeRzTp48qfB3debEUeaLL75AQkICnJ2d4eXlBWNjY4V4dHR0tevkhTMZY4wxpjeDBw/WeZ3cuWGMMcb0rZYsv6APYWFhOq+z2pP4PQ8bNmyAl5cXTE1NERgYWOUFt3bt2gWRSPRcen2MMcZYTalYfkHbB3tC752b3bt3IzQ0FGFhYYiOjkb79u0RHByMjAz6/nVSUhJmz56t9YRDjDHGmN4JOnowALWgcxMeHo6JEydi7NixaNWqFSIiImBubo7NmzerLCOVSjFy5EgsXrwYTZs2rcHWMsYYY6y202vnpqysDFFRUQrrTxgYGCAoKAjnz59XWW7JkiVwcnLC+PHj1b5GaWkp8vLyFB6MMcZYrcNXbnRGr52brKwsSKVSODs7K2x3dnaWTwL0rLNnz+J///sfNm3aVKXXWLlypcICYh4edJo1Y4wxVuNqyTw39UWdypbKz8/HqFGjsGnTJjg4OFSpzLx58xAaGir/Oy8vDx4eHnDZeAVGImOlZbLG03OV3B1Nz2MjsaC7z0ILTzJuUEYfog9epufn8TpZSMat1axBltaXXl/ELo6eqyW7HT1fiThLdZ/6Vig9F0irebFkPHZhczL+4BV633r9Rr+3Ig/lx4y8/KZ4Mg4j+pQr9aOPLW3pcx4bdVpspa+qyhxtyXipDb1vbWPoeVzSX1W+uGAFqRk9B1JpY3qeHakZ/VvS4iH9vWF78BYZvz+xNRn3+IWereXuOPqHX4mbmvm1UlWfG85XVM+BAwAxM+glfZwu0uetRTpdf9JE1fPYAIDHn6qPDYmkhCzLdOP+/fuIjIxEcnIyysoUJ30KDw+vdn167dw4ODjA0NAQ6enpCtvT09Pl0zw/LSEhAUlJSRgwYIB8W8XEgkZGRoiNjYWPj49CGbFYrHJFVMYYY6zWaKCp4MePH8fAgQPRtGlTxMTEoE2bNkhKSoIgCHjhhRc0qlOvt6VMTEzQoUMHHD9+XL5NJpPh+PHj6Ny5c6Xn+/r64saNG7h27Zr8MXDgQLzyyiu4du0a33JijDFWJ+kkDbyOdm7mzZuH2bNn48aNGzA1NcXevXuRkpKCHj164J133tGoTr3flgoNDcWYMWPQsWNHdOrUCWvXrkVhYSHGjh0LQHGBLlNTU7Rp00ahvK2tLQBU2s4YY4zVGQ14Er/bt29j586dAJ7chSkuLoalpSWWLFmCQYMGYcqUKdWuU++dm6FDhyIzMxOLFi1CWloa/P39cfjwYfkg4+TkZBgY6D1jnTHGGGPPgYWFhXycjaurKxISEtC69ZMxZFlZWRrVqffODQBMnz4d06dPVxp7doGuZ23dulX3DWKMMcZqWgO9cvPSSy/h7Nmz8PPzQ79+/fDhhx/ixo0b2LdvH1566SWN6qwVnRvGGGOsQdPB8gl1NRU8PDwcBQVPVrVfvHgxCgoKsHv3bjRv3lyjTCmgAXduDKwsYSBSnlJd5EqXNSyj40aF9CGW2p1OGXU9JyXj91+nU61LX/Un44860PUb5alJWU2lDxvLRLq83R3VaZumf9Jpl3ffb0nGAXrfWMfTbTMqoNNdTR7RmXcJM+hUdM9DRWTcOKuYjNdnyf1tybjnuptk/OFYXzLeIklNOvEt+rMt9KbPm7ujyDB8P8+hn5D0gAw/mNiOjIsf09WXNqPTrY3VzG9abkOnwpc5qT6vLW8/IssadnYm42k96FRv+yv0d5LXjodkPL+96teXlBsAUWRx3WmgV26eXmnAwsICERERWtfZYDs3jDHGGKs9ysrKkJGRIZ/ipUKTJk2qXRd3bhhjjDF9a8DZUnFxcRg/fjzOnTunsF0QBIhEIkil9FVTZbhzwxhjjOmZCDoYc1NHOzdjx46FkZERfv/9d7i6ukIk0n70EHduGGOMMaY3165dQ1RUFHx96XFz1cGdG8YYY0zfGvBtqVatWmk8n40qPDseY4wxVgs01FXBV69ejY8//hgnT57Eo0ePkJeXp/DQBF+5YYwxxvStAV+5CQoKAgD07t1bYTsPKNZAaUBTSI1MlcbsYum5UjI60v1jm1g6bp5Ff1CWcfSEFd67rMl4amfl8/dU8NlFzyXzqI3y/VIhoyM930XT7fTlxZhpdqqDgjlZ1ukyffban0gh47fnNibjxoUWZNz7l0wyjgJ6HpvsnnRKY2ZHet/XZ00+iybj0lL6uPU+QJ9XiW9YkXHPP+jPzui7JDKe34uegyl2InHcA2i6nz728lvSc734fpVDxmNm2pJxt+P0915BW/r1W6wvVRkrd6G/sxyv069t80csGY9d4kfGzTPoeXSs/slQGZPIVL8vpht//fWXzutssJ0bxhhjrNZowFduevToofM6uXPDGGOM6ZkI2o+ZqatjbioUFRUhOTlZvohmhXbt6Nm5leHODWOMMVYbNNArN5mZmRg7diz++OMPpXFNxtxwthRjjDHG9GbWrFnIycnBxYsXYWZmhsOHD2Pbtm1o3rw5IiMjNaqTr9wwxhhjelaRzq2VOnrl5sSJE/j111/RsWNHGBgYwNPTE6+++iqsra2xcuVK9O/fv9p18pUbxhhjrDYQtHzUUYWFhXByerJqvZ2dHTIzn2Sltm3bFtHRdBalKg32yk2pjRGkxsrf/qM2dJ/P/jp9FJVb0q9t9S+dKp3ei05btL9Bp6y6nqdf3+RWMhl3Pk9PmhT7VQAZfxRoT8btr6oe9lZKZ8viMZ1ti4xOdKp30710OqvJ1QQyHrOEnh7cPMWRjJfbkGHIbMrpJ9RjsmcGET7r/oIuZNyokK7fOF9NPJk+L0sDfMh4sQM9RYLrWTrd2eR+Dhm3SHQh41IbMzLu+RsZhmERfey12EjHDTNUT2FxJ5Q+L63j6O/ckuGtyXiz3fR3Yvx4YzJu0FP1d66spASYQxavV/bt24eIiAhERUUhOzsbV69ehb+/f5XL79q1C8OHD8egQYNw4MCBKpVp2bIlYmNj4eXlhfbt2+Pbb7+Fl5cXIiIi4OrqqtH7aLCdG8YYY6zWqCWp4IWFhejWrRuGDBmCiRMnVqtsUlISZs+eje7du1er3MyZM5GamgoACAsLw2uvvYbt27fDxMQEW7durVZdFbhzwxhjjNUCtWFV8FGjRgF40lGpDqlUipEjR2Lx4sU4c+YMcnJyqlz23Xfflf9/hw4dcO/ePcTExKBJkyZwcHCoVjsq8JgbxhhjTN+0HW+j53E3S5YsgZOTE8aPH1+tcuXl5fDx8cHt27fl28zNzfHCCy9o3LEB+MoNY4wxVq88u9ikWCyGWCx+bq939uxZ/O9//8O1a9eqXdbY2BglJfTSKprgKzeMMcaYnmm9Ivj/PwoLC2FjY6PwWLlypdLX3L59OywtLeWPM2fOVLvd+fn5GDVqFDZt2qTxlZZp06Zh9erVkEjohI/q4Cs3jDHGWG2gg9tKFhYW8sG5FVRdtRk4cCACAwPlf7u7u1f79RISEpCUlIQBAwbIt8lkTzIDjYyMEBsbCx8fOtPw8uXLOH78OP7880+0bdsWFhaKi8ju27ev2u1qsJ0bqZkIMFGekux8mZ7qudycXsHDafNV+sUdGtHhawVkPG4SfXnRNopOeyx8pQUZN1CXjSyomQpbzQmaFai6d+50jk6nLbOh933LD6+T8di17ck4xtAnobmalFWBbj5cz9I7t9xKzSk5gw7XZUZO9K++JuHXyHjuIHr9mbRu9IEZ8yGdruz7VRr9+n3plNU8GX3sWP+hemVqAGi8jn79e7P9ybjbGXp164SRdPtcj5uT8YJuqufAaPH9I7KsqIhum2BOf+fFTqLnkPBbmkrGb89WnWYvM6yhgSw6mMSvory1Nb0KewUrKytYWVlp9Zq+vr64ceOGwrYFCxYgPz8fX331FTw8PNTWYWtri7feekurdjyrwXZuGGOMMaYoOzsbycnJePjwIQAgNjYWAODi4gIXlyedwNGjR8Pd3R0rV66Eqakp2rRpo1CHra0tAFTarsqWLVt01Pr/8JgbxhhjrDaoBdlSkZGRCAgIkC95MGzYMAQEBCAiIkL+nOTk5Eq3vnQhMzMTZ8+exdmzZ+WzFGuKr9wwxhhj+lZLJvELCQlBSEgI+ZyTJ0+S8epOvFdYWIj3338fP/zwg3y8jqGhIUaPHo1169bB3Jy+JaoMX7lhjDHGmN6Ehobi1KlT+O2335CTk4OcnBz8+uuvOHXqFD788EON6uQrN4wxxpieiVA7ZijWh71792LPnj3o2bOnfFu/fv1gZmaGIUOGYOPGjdWukzs3jDHGmL7V8ZW9tVFUVARn58qLlzo5OaGoiF4UVRW+LcUYY4zpmyBApOUDQt3sHXXu3BlhYWEKMxUXFxdj8eLF6Ny5s0Z1NtgrN3bXH8PIUPncCaWudN6/YTFdtyygJRnPbGtBxtXNleIXdo+Mp/f1JOMGZXT9pvSUFBBn0w2UmNHlWy1MUhmL/ZieZ8bzD7rxsRF06qHv54/JeLGXLR1vRH95lDSi5+ExyaHbb5qhuxk665qMAc3IuDhHRsbtrtDZFdbx9KBE0a0EMn5/kj8Z9zpITyEvM6F/S4ps6LlJYpa5kXGI6GMrJ1XN9Psy+tizvE/PRZP2qurvhRQDe7KsQE/NhcZrLpNxk8cvknHp/Ydk3Pm86n0rLTNAClmaaeurr75CcHAwGjdujPbtn8xFdv36dZiamuLIkSMa1dlgOzeMMcZYrVILsqX0oU2bNoiPj8f27dsRExMDABg+fDhGjhwJMzM1v5ZV4M4NY4wxpmcVa0NpW0ddZW5ujokTJ+qsPu7cMMYYY7VBA7pyExkZib59+8LY2BiRkZHkcy0tLeHr6ws3NzW3Zp/CnRvGGGOM1ajBgwcjLS0NTk5OGDx4sNrnGxoaYs2aNfjggw+qVD9nSzHGGGP6Jvx3a0rjh77fQzXIZDI4OTnJ/596lJSUYNOmTVizZk2V6+crN4wxxlht0IBuS1WHiYkJ3nrrLfzzzz9VLtNgOzdxMyxgYGaqNOb3KZ1S+qg7fd+vtKUJGXfbFUfGy33pJeJvf9KYjLecdYWMI6QjGXbac5uMy5rT7Ysbp3y/VpCKVaf8tlwdT5a9tcybjHtE0r9dRGVSMp7ekT4lPD+7RsYfDW1PxtWlAxd40tMQ1GdGJfQ3s3UMncaPgkIynDDRiYzbxPuTcXW/io2v3yXjD8a1IuMFA5qQcZP79LHjcYxORc8IIMOwu0Yf+9l+dFyUrzpV3+US3TajAjqNPWU2nept/y89TcDdpXR5swzVMWlpXboeUrfdunULycnJKCtTPB4GDhwIKysrhIeHV7muBtu5YYwxxmqLhpwtdffuXbzxxhu4ceMGRCIRhP+fjFAketKxlErpH6XK8JgbxhhjrDYQdPCog2bOnAlvb29kZGTA3NwcN2/exOnTp9GxY0e1K5CrwlduGGOMMT1ryFduzp8/jxMnTsDBwQEGBgYwMDBAt27dsHLlSsyYMQNXr16tdp185YYxxhhjeiOVSmFl9WS8oYODAx4+fLJchqenJ2JjYzWqk6/cMMYYY/omoM4ufKmtNm3a4Pr16/D29kZgYCDWrFkDExMTfPfdd2jatKlGdXLnhjHGGKsFtL6tVEf7RgsWLEBh4ZNsxyVLluD1119H9+7dYW9vj927d2tUJ3duGGOMMX3TxYDgOtq5CQ4Olv9/s2bNEBMTg+zsbNjZ2ckzpqqrwXZuDDNNYGCqfD4aqbMNWdb+fDoZL/FqRMbT32hBxhvdLibjTfdKyPid5R3IuNdvdP0xK5uTcb9Pk8m4zw56HiCTfxNUxm5/Ts9jY6NmLg6r0/T92XuTWpJxry/oSaKSZ/iTcadoer6Ogib0HEDl5g13Tg3LZHoulPTu9mT8cTtbMt7yw+tkXNaOPu7vvW5BxkX2dmS88fY7ZDxmPn353eIBGUbiG/T8WjIxnU4rGNFzxVjGGZPxZrtVf34iKV13oQe9bz3+yCHjpS50eQMpPbzU4V/V561EQp/T7Plo1Ij+d1SdBtu5YYwxxmoLkQCI6D6g+jq0LF/Txo0bV6Xnbd68udp1c+eGMcYYqw3q6G0lTW3duhWenp4ICAiQT9ynK9y5YYwxxliNmzJlCnbu3InExESMHTsW7777rta3oyrwPDeMMcaYvuliVfA6duVnw4YNSE1Nxccff4zffvsNHh4eGDJkCI4cOaL1lRzu3DDGGGP6Jgi6edQxYrEYw4cPx9GjR3Hr1i20bt0aU6dOhZeXFwoKCjSul29LMcYYY3omQsNdfqGCgYGBfOFMTRbLfFqD7dz4fBELI5Hy1MnYxb5kWd8VaWS83MqRjJtn0B9ablM6XbjRzigy7mbhT8aLncRkHFAz5F7NQWcSc5+MS5o3Vhmz+odOZzXJp8/ehyPpVG/PHSlkPHVMO7r8Fjqd93EvOp03uxWd6u3wTx1Ld9AhqRn9dVTkQpe3ijMk4yUvtybjmS/Qqc5ljdWkBBfTqewp7zYj4+b0aQOHby+QcZcm7mRc1siKjJc5mJPxYkf63JNYqP787vekz2vrRDIMixT6JkOeF/3ZqUujl5qqrl9azjc4nqfS0lLs27cPmzdvxtmzZ/H6669j/fr1eO2112BgoPm+b7CdG8YYY6zWaICT+E2dOhW7du2Ch4cHxo0bh507d8LBwUEndXPnhjHGGKsFtL4tpZtm1JiIiAg0adIETZs2xalTp3Dq1Cmlz9u3b1+16+bODWOMMaZvulg4s44NKB49erTGyyuow50bxhhjjAF4cpUkIiICUVFRyM7OxtWrV+Hv76+2XE5ODubPn499+/YhOzsbnp6eWLt2Lfr166eyzNatW3XX8Gdw54YxxhjTM11kS+lizE1hYSG6deuGIUOGYOLEiVUqU1ZWhldffRVOTk7Ys2cP3N3dce/ePdja2mrfIA1x54YxxhjTt1oyoHjUqFEAgKSkpCqX2bx5M7Kzs3Hu3DkYGz/JXPPy8tK+MVposJ2btKG+MBQrT7m2VJOWKPVwJuMyQ/oeYrkFHc/srC6/n171u9CNrt88jT4DGkXTh4XUi87JNUzJJOPxo1WnuhvlkkUhM1KTSv1vORkXbCzJuEkevW9uLfck44Z5dPss6QXVG7QCd/q4s7lDfzbF9vS+Fx+NJuP24o5k3OOPIjL+8E16RXuXi3T5Ag96CgjDtvQ0B8h8TIbvvmNLxi3UpKK7nH5ExmOmqa7f5hZdd7ETHS9xMiPjzsdSyXjiu65k3OXnBJUxiazurQqel5en8LdYLIZYrG4KEM1FRkaic+fOmDZtGn799Vc4OjpixIgRmDNnDgwN6SkanpdakcC/YcMGeHl5wdTUFIGBgbh06ZLK527atAndu3eHnZ0d7OzsEBQURD6fMcYYq+10sfSCSHhyW8nGxkbhsXLlyufa9rt372LPnj2QSqU4dOgQFi5ciC+++ALLli17rq9L0XvnZvfu3QgNDUVYWBiio6PRvn17BAcHIyMjQ+nzT548ieHDh+Ovv/7C+fPn4eHhgT59+uDBAzWzNDHGGGO1lSAAMi0fggALCwvk5uYqPObNm6f0Jbdv3w5LS0v548yZMxo1XSaTwcnJCd999x06dOiAoUOHYv78+YiIiNBmj2hF77elwsPDMXHiRIwdOxbAk7z3gwcPYvPmzZg7d26l52/fvl3h7++//x579+7F8ePHMXr06BppM2OMMaZzOhpzY21tXaWnDxw4EIGBgfK/3d3pWa5VcXV1hbGxscItKD8/P6SlpaGsrAwmJvQM1c+DXq/clJWVISoqCkFBQfJtBgYGCAoKwvnz56tUR1FREcrLy3W2TDpjjDHWEFhZWaFZs2byh5kZPbZJla5du+LOnTuQyf5bPiYuLg6urq566dgAeu7cZGVlQSqVwtlZcYCus7Mz0tLo9ZsqzJkzB25ubgodpKeVlpYiLy9P4cEYY4zVKjoac6Ot7OxsXLt2DbduPRkFHhsbi2vXrin8mzx69GiFW11TpkxBdnY2Zs6cibi4OBw8eBArVqzAtGnTtG+QhvQ+5kYbq1atwq5du7B//36YmirPNFi5cqXCwCoPD48abiVjjDGmzpMxM1o/tBQZGYmAgAD0798fADBs2DAEBAQojJ9JTk5Gaup/GWoeHh44cuQILl++jHbt2mHGjBmYOXOm0qElNUWvY24cHBxgaGiI9PR0he3p6elwcaHTjT///HOsWrUKx44dQ7t2qldynjdvHkJDQ+V/5+XlcQeHMcZYraKLKy+6WMggJCQEISEh5HNOnjxZaVvnzp1x4QK9cn1N0mvnxsTEBB06dMDx48cxePBgAE9GXR8/fhzTp09XWW7NmjVYvnw5jhw5go4d6bkpVOX3S8wAQUXaf0ELeq6Uxgfp+SpymlmRcYtU+gj2+zKbjENCz4PT6D4954OBAz0+6fYCuvPnfFBN+9QsU29xT/W8B0b0roXzxXwybphbTMZlyXRWnWmTtmTcd9oNMp4/wJ+MS8zJMEQSOl6fGah57/Z/qZkkSM2v1pjwF8l489DLZLy4r5r5pRqTYeT70OMZmu0qJONZHWzJeF5TOzLu8/ltMv5wlB8ZL3Whv9f8vlA9v9W9IfSPVWP6tMa9oWr+1VczUY7pQ7p48jjVcwhJS0uAr+jyrPbRe7ZUaGgoxowZg44dO6JTp05Yu3YtCgsL5dlTo0ePhru7uzxPf/Xq1Vi0aBF27NgBLy8v+X3AilQ2xhhjrE6qBTMU1xd679wMHToUmZmZWLRoEdLS0uDv74/Dhw/LBxknJyfD4KkrARs3bkRZWRnefvtthXrCwsLw6aef1mTTGWOMMd0QAJGWY2Z0MaC4vtB75wYApk+frvI21LP39qqz3gVjjDHGGp5a0blhjDHGGjQBgEzts2jalq9HuHPDGGOM6ZlIELS+LcWDbv7DnRvGGGOsNuC+jc402M6Nx94UGBkozwW/tcCNLpyTS4bNM+i0xMyedKp5gQdd3usX5YuKVpAE0imdD3rSKal+4elkXCii87Wl2Y/JuG286lTzR61Vp4kDQOwk5ZM1VvCbnULGRUqmBXhakRP9+jlTXiDj5RZkGDI1M5Gbpetipoq6ySSfvqYeN6sJGTfNoPddIzqLH0lhgWS86Rc3ybhkgOp0YgAwSae/bh/70geP41n6vC+zcSbjIkP62HY9S8/envgGvV6R3W3Vr1/UvIws67fsERk3KHcl43k+9L/qJmpSzcuJRFu+01M3NdjODWOMMVZrCNB+hmEdzFBcX3DnhjHGGKsFtJ6hmPs2cty5YYwxxvRNF2tD8ZUbuTq9cCZjjDHG2LP4yg1jjDGmZyIBEGk5eplvS/2HOzeMMcaYvvGAYp3i21KMMcYYq1ca7JWbO5Mbw8BU+ZwpVnFq5hqxtSHD9tfo+SIAer4IcY6UjN8ZTc+D0+RIsZrXp6X3pOfLgIiOF7rTxaXEXC8ON+hfHmZZxmoqp/ed0Ez1HDsAUOxAf/am9HQccPvhNhkv6ehDxk2OX6VfYDgdrsskpvS+Nyyi4wb09FFwuJxDxs0zrch4zJfNybjrEfq3YloX+p5Dvidd3jy9Ef3639LHTuYwfzJunUTPReN2mo4nDVQ9j47Dafq8FdIzybjpY/o7p/QRve/UnZfxn/iqjMlKavBqCE/ipzMNtnPDGGOM1Ra6WH6Bx9z8hzs3jDHGmN7pIBWcL93I8ZgbxhhjjNUrfOWGMcYY0zcZtF/IihfCkuPODWOMMVYLaD/mhm9LVeDODWOMMaZvvPyCTjXYzo1g+OShjPu6aLJs+Yuq0wYBID6ETns0KKIPwMbH6LjPF3Rao0gsJuM2Ht5kvMSeTrmVKM+glzPJpeONf01VGZMmJZNly4JeoCtv4kqXdzCni+9Ooct7O5LxO3PoY6P5liwyHreyExmvz2xu0VMo2B5RfdwAQH7PFnS8BT0FQ04zegii4yk6nvoKPQ2B36p0Mv6ouxsZvzeMvudg7x5AxkvtyDDEefT31v1g+vVbzbujMlb0YlOybHlH+rOzPnCNjD9c35aM315Fp/Gbpqr+zpOWqJkahNVKDbZzwxhjjNUqnC2lM9y5YYwxxvRNAA8o1iFOBWeMMcZYvcJXbhhjjDE908UMxXxX6j/cuWGMMcZqA86W0hnu3DDGGGP6potUcL50I9dgOzfGj0UwFCtP8Xs4hU43drhJr47relz16rgAYPPrP2S8MJhOa5RmPybjkqCOZNxUzarjjQ4nkHHBxZ6Mx06iVy/ODVC9wm/Ra3Qqt8sPN8h4xgh63zmdp/ddZq/GZDyHzvRG83V0KnuhP71kevNVMfQL/EqH67L4sXSqdsuvi8j4g4H0cd1yEn3elYTQ543D0SQybhvrRMaT3qU/e+N8MgyXP03IuGEpPZq01JYeYml9k17y3t6engYhv3szlbECd/o70fX3NDJe3KMNGff7mt559/vQ30kFzSUqY7Ji1bH6aN++fYiIiEBUVBSys7Nx9epV+Pv7qy23du1abNy4EcnJyXBwcMDbb7+NlStXwtRUzdwhz0mD7dwwxhhjtUYtmcSvsLAQ3bp1w5AhQzBx4sQqldmxYwfmzp2LzZs3o0uXLoiLi0NISAhEIhHCw8O1bpMmuHPDGGOM6VstSQUfNWoUACApKanKZc6dO4euXbtixIgRAAAvLy8MHz4cFy9e1L5BGuJUcMYYY6wWqMiY0uYBAHl5eQqP0tLS59ruLl26ICoqCpcuXQIA3L17F4cOHUK/fv2e6+tS+MoNY4wxVk8UFhbCxsZGYVtYWBg+/fTT5/aaI0aMQFZWFrp16wZBECCRSDB58mR88sknz+011eErN4wxxpi+VYy50eYBwMLCArm5uQqPefPmKX3J7du3w9LSUv44c+aMRk0/efIkVqxYgW+++QbR0dHYt28fDh48iKVLl2q8O7TFV24YY4wxfRMAyLQcEPz/5a2t6czDCgMHDkRgYKD8b3d3OqNPlYULF2LUqFGYMGECAKBt27YoLCzEpEmTMH/+fBgY1Px1FO7cMMYYYw2QlZUVrKystK6nqKioUgfG0PBJ+r+gp4kFG2znRmIpQGaqfKfb36I/DNPkHDJeZkXPA2NgZUnGrS7Sc6Xc3kLPx+G3OJOMF7R3IeMwouekiJtAv78WP9BzTsSPUH0yWdwniyJlKj2PTZNdKXQFRvQhbx+dS8atUszp+mV0ukK5Jf0LJnWkH11/PdZybSoZj53hRsYtbiuft6pCUd8AMp7tT8+T4/C/DDJe0tGDjBe70/V7fUGft7kB9Dw6lr9fI+NZ8+j5ux72oeexcTtIfz4lTVV/L7icps+rhwPofZfbhp5rxiSTnsemzJY+L5vuVv3ZSCRSqPlW0Y1akgqenZ2N5ORkPHz4EAAQGxsLAHBxcYGLy5N/O0aPHg13d3esXLkSADBgwACEh4cjICAAgYGBuHPnDhYuXIgBAwbIOzk1rcF2bhhjjLFapRZ0biIjIzF27Fj538OGDQOgOCg5OTlZ4UrNggULIBKJsGDBAjx48ACOjo4YMGAAli9frnV7NMWdG8YYY0zfasnyCyEhIQgJCSGfc/LkSYW/jYyMEBYWhrCwMK1fX1c4W4oxxhhj9QpfuWGMMcb0TSfZUjppSb3AnRvGGGNM72SAoGXvRNvy9Qh3bhhjjDF9E1ArBhTXFw22c9N0xT8wEpkojd2bTaeMFrrQKZnOm6+S8fKOvmT8zgjl7apgf5ZOrYudSafMtlyTSMYl6XTKq0VyMzJ+Zyg9b4JxgeqU3RIHsijKXcvIeEwoPQlVkz/odFzTE9fJuLG4JRkvCqBTWo0L6F9WTrsvkXEMmUHH6zDBQqzmCXRY3TQA6X3oz8br13Iy/mhsIBk3LFPTQBF97MXMoL9XWsz9h4zLyuhzQ1Dzbe/y/TUyXvAqPQ1Drpfq7yUjbzpV2/Qxve9c58aR8eTJrci497JrZFxo21x1UErvV1Y7NdjODWOMMVZrCIL2Y274yo0cd24YY4wxfdPJbSmdtKRe4FRwxhhjjNUrfOWGMcYY07vasfxCfcGdG8YYY0zfdJUtRS+x1mBw54YxxhjTN0GmduHdKtXBnRsAPOaGMcYYY/VMg71ykxbSHoZiU6WxEld6Popya7pPmLOhNRn3W5FNxs1TXMi4oKZL6r2/hIzfXuBJxg2Lvcm4+ykJGTcuog8rp9NZKmPFTW3JsmanY8l44mx6Lg7xsSgyHr+mIxk3IuboAQC7WPqyslUy/dnkjKbnUqnPUvrTkxyZ5NDlhUePybjMmJ7nxvQCPZdKth99Xlsk0N8bZin0eVGs5ntH3S0Lo6b0eS0zpssX9G1Hxh8MoM973+k3VcZivvIjyzYff5mMS0X0l16ZLRmGyEz5d32FlFdVz80lLTUGoun6dYazpXSmwXZuGGOMsVpDF6uC84BiOe7cMMYYY/qmi4UzuXMjx2NuGGOMMVav8JUbxhhjTN8EAYKWq3prW74+4c4NY4wxpm+6WFuK+zZyfFuKMcYYY/VKg71y43oqG0aGYuWxjYlk2dSpdLqw/RH6tWPedyLjdqozKgEAUuXNlrsziv5YRSV0OrPFfTqe/Ab980CcQoYhKipWGcv1otOBzc7T783hH7ptZb3ak3EY0L+cfDY/JOO3Z9Np/OmdTci479wbZBwT6HBdJqWzdVHcmE5FhndjMtwotpSMJ82kU73N0+mXL7EzJOMWqWqmCUihf2tmjQwg4/ZbLpJxnx1mZPzuEFsy7vtFARmPW6x6GgbnE2RRFAx9iYzb3Moh4xJrOo0+Zm0zun5ihggD+rDRIc6W0qUG27lhjDHGag2ZoJsZihkA7twwxhhjtQNfudEZHnPDGGOMsXqFr9wwxhhjeiYIAgRtb0tpm21Vj3DnhjHGGNM3XSy/wItLyXHnhjHGGNM3XSy/wFdu5Ops52bDhg347LPPkJaWhvbt22PdunXo1KlTlcvLYu9CJjJWGrv/Eb0ys+MNOiW1xIHerT6/0CtDG8feJ+OClE57dN1aTsYT5tGr/xrnk2GglE55tf+XvrSa3kf16swGdNORE9ySjJs+UpMuLKLT3FuuzyDj+f50qrf9NXrfWCeVkfGSrvTqyfWZ/b/0cW29O5uMx0yjpxHw+JM+Lq2T6H8YzB7R7XvcjD7vi9zo+pv9RK9qfnuG6pWrAcBhOz3NQNIbtmRc3arhsRPo8i7nVZe3jqO/VBLesSHjBW6NyHjzqefIeEpYFzJuF6v6vJRI6HOW1U51ckDx7t27ERoairCwMERHR6N9+/YIDg5GRgb9DxNjjDFWKwkyHTz4yk2FOtm5CQ8Px8SJEzF27Fi0atUKERERMDc3x+bNm/XdNMYYY6z6BECQCdo9uHMjV+c6N2VlZYiKikJQUJB8m4GBAYKCgnD+/PlKzy8tLUVeXp7CgzHGGGOKysvLMWfOHLRt2xYWFhZwc3PD6NGj8fAhPTN7bVTnOjdZWVmQSqVwdnZW2O7s7Iy0tLRKz1+5ciVsbGzkDw8P1eM9GGOMMf0QdHNrSgtFRUWIjo7GwoULER0djX379iE2NhYDBw7U0XusOXV2QHFVzZs3D6GhofK/8/LyuIPDGGOsVnkyz412t5W0vS1lY2ODo0ePKmxbv349OnXqhOTkZDRp0kSr+mtSnevcODg4wNDQEOnpiqvYpaenw8WlciaLWCyGWKxmpUnGGGNMnwQBgLZrS+l+zE1ubi5EIhFsbW11XvfzVOc6NyYmJujQoQOOHz+OwYMHAwBkMhmOHz+O6dOnqy1f0bOVCKpzjqWldKq2pJxON5aU03f7JBK6fpGMTj0UZHRKKoj3BgCyEvr1pWoyH2XF9OtLyul0a2kZsX/oopCU0ye/RKJdKrhESi8BLClXt+/oVHB1aaWCQLevuLD+jhlTt2/VfTayYnXnLX3sqP3syunjXlpKf53KSuh/eNS/P+VTV8jLC/SxJVVz3ssM6PbJ1FxVkBBfO2rfm7rvJDUrc1Pf54D6906dlxXf189zsK6ZmRmSEIMHQqJW9cgghYNpo0pjSzX9kV9SUoI5c+Zg+PDhsLa21qptNU0k1MHh1bt378aYMWPw7bffolOnTli7di1+/vlnxMTEVBqL86z79+/zbSnGGGPVkpKSgsaNGz+Xuh89eoQrV67opK6DBw9i3bp1CtvCwsLw6aefVnru9u3b8d5778n//uOPP9C9e3cATwYXv/XWW7h//z5OnjzJnZuasn79evkkfv7+/vj6668RGEhPvgc8ucrz8OFDWFlZQSQSycfgpKSk1LkPT594v2mG95tmeL9VH+8zzTy73wRBQH5+Ptzc3GBgUPtzcEpLS1FaqnipS9WVm/z8fIUhHu7u7jAzM0N5eTmGDBmCu3fv4sSJE7C3t3/u7da1Otu50ZW8vDzY2NggNzeXvwCqgfebZni/aYb3W/XxPtNMQ99vFR2b+Ph4/PXXX3B0dNR3kzRS58bcMMYYY0z3ysvL8fbbbyM6Ohq///47pFKpfIqVRo0awcSEXuKjNuHODWOMMcbw4MEDREZGAgD8/f0VYn/99Rd69uxZ843SUIPv3IjFYoSFhXG6eDXxftMM7zfN8H6rPt5nmmnI+83Ly6veLOHQ4MfcMMYYY6x+qf1DvxljjDHGqoE7N4wxxhirV7hzwxhjjLF6hTs3jDHGGKtXGnznZsOGDfDy8oKpqSkCAwNx6dIlfTep1qjOvtm0aRO6d+8OOzs72NnZISgoqMHuS02PqV27dkEkEsnXTGtIqrvPcnJyMG3aNLi6ukIsFqNFixY4dOhQDbW29qjuflu7di1atmwJMzMzeHh44IMPPkCJmnWXGorTp09jwIABcHNzg0gkwoEDB/TdJKYNoQHbtWuXYGJiImzevFm4efOmMHHiRMHW1lZIT0/Xd9P0rrr7ZsSIEcKGDRuEq1evCrdv3xZCQkIEGxsb4f79+zXccv3S9JhKTEwU3N3dhe7duwuDBg2qmcbWEtXdZ6WlpULHjh2Ffv36CWfPnhUSExOFkydPCteuXavhlutXdffb9u3bBbFYLGzfvl1ITEwUjhw5Iri6ugoffPBBDbe8djp06JAwf/58Yd++fQIAYf/+/fpuEtNCg+7cdOrUSZg2bZr8b6lUKri5uQkrV67UY6tqB233jUQiEaysrIRt27Y9rybWSprsN4lEInTp0kX4/vvvhTFjxjS4zk1199nGjRuFpk2bCmVlZTXVxFqpuvtt2rRpQq9evRS2hYaGCl27dn2u7ayLuHNT9zXY21JlZWWIiopCUFCQfJuBgQGCgoJw/vx5PbZM/3Sxb4qKilBeXo5GjRo9r2bWOprutyVLlsDJyQnjx4+viWbWKprss8jISHTu3BnTpk2Ds7Mz2rRpgxUrVkAqldZUs/VOk/3WpUsXREVFyW9d3b17F4cOHUK/fv1qpM2M1aQGO0NxVlYWpFIpnJ2dFbY7OzsjJiZGT62qHXSxb+bMmQM3NzeFL9/6TpP9dvbsWfzvf//DtWvXaqCFtY8m+6xipeKRI0fi0KFDuHPnDqZOnYry8nKEhYXVRLP1TpP9NmLECGRlZaFbt24QBAESiQSTJ0/GJ598UhNNZqxGNdgrN+z5WbVqFXbt2oX9+/fD1NRU382ptfLz8zFq1Chs2rQJDg4O+m5OnSGTyeDk5ITvvvsOHTp0wNChQzF//nxERETou2m12smTJ7FixQp88803iI6Oxr59+3Dw4EEsXbpU301jTOca7JUbBwcHGBoaIj09XWF7eno6XFxc9NSq2kGbffP5559j1apVOHbsGNq1a/c8m1nrVHe/JSQkICkpCQMGDJBvk8lkAAAjIyPExsbCx8fn+TZazzQ51lxdXWFsbAxDQ0P5Nj8/P6SlpaGsrKxOrVysKU3228KFCzFq1ChMmDABANC2bVsUFhZi0qRJmD9/PgwM+Lcuqz8a7NFsYmKCDh064Pjx4/JtMpkMx48fR+fOnfXYMv3TdN+sWbMGS5cuxeHDh9GxY8eaaGqtUt395uvrixs3buDatWvyx8CBA/HKK6/g2rVr8PDwqMnm64Umx1rXrl1x584deUcQAOLi4uDq6togOjaAZvutqKioUgemooMo8BKDrL7R94hmfdq1a5cgFouFrVu3Crdu3RImTZok2NraCmlpafpumt6p2zejRo0S5s6dK3/+qlWrBBMTE2HPnj1Camqq/JGfn6+vt6AX1d1vz2qI2VLV3WfJycmClZWVMH36dCE2Nlb4/fffBScnJ2HZsmX6egt6Ud39FhYWJlhZWQk7d+4U7t69K/z555+Cj4+PMGTIEH29hVolPz9fuHr1qnD16lUBgBAeHi5cvXpVuHfvnr6bxjTQoDs3giAI69atE5o0aSKYmJgInTp1Ei5cuKDvJtUa1L7p0aOHMGbMGPnfnp6eAoBKj7CwsJpvuJ5VZ789qyF2bgSh+vvs3LlzQmBgoCAWi4WmTZsKy5cvFyQSSQ23Wv+qs9/Ky8uFTz/9VPDx8RFMTU0FDw8PYerUqcLjx49rvuG10F9//aX0O4w6X1ntJRIEvh7JGGOMsfqjwY65YYwxxlj9xJ0bxhhjjNUr3LlhjDHGWL3CnRvGGGOM1SvcuWGMMcZYvcKdG8YYY4zVK9y5YYwxxli9wp0bxhhjjNUr3Llh7Dno2bMnZs2aVSOv9fLLL2PHjh0alb1z5w6cnZ1hbm6Ov//+W2dt+vTTT+Hv708+53nuo4iICIUFSRljDQt3bhjTQEhICEQiUaXHnTt3arQdkZGRSE9Px7Bhw6pd9uHDh3j11VfRrVs3jB8/Hq+//jpu3Lih8Jzy8nLMmTMHbdu2hYWFBdzc3DB69Gg8fPiwUn3FxcWwsLCo8X2gzLhx4xAdHY0zZ87ouymMMT0w0ncDGKurXnvtNWzZskVhm6OjY4224euvv8bYsWMrrfaszuPHjxEcHIzu3btjy5YtMDQ0hKWlJYKDg/H333/D29sbwJOVpKOjo7Fw4UK0b98ejx8/xsyZMzFw4EBcuXJFoc6jR4/C09MTzZo109n7qy5BECCVSmFiYoIRI0bg66+/Rvfu3fXWHsaYfvCVG8Y0JBaL4eLiovAwNDRU+lyRSIQDBw4obLO1tcXWrVsBAD/88AMsLS0RHx8vj0+dOhW+vr4oKipSWmdmZiZOnDhR6fZLTk4OJkyYAEdHR1hbW6NXr164fv26PF5UVIT+/fuja9eu2LZtm7zNK1euxLRp09CnTx9kZGQAAGxsbHD06FEMGTIELVu2xEsvvYT169cjKioKycnJCq/766+/YuDAgQrbfvzxR3h5ecHGxgbDhg1Dfn6+QlwikWD69OmwsbGBg4MDFi5ciKeXu/vxxx/RsWNHWFlZwcXFBSNGjJC3DQBOnjwJkUiEP/74Ax06dIBYLMbZs2cBAAMGDEBkZCSKi4uV7j/GWP3FnRvGaoHRo0ejX79+GDlyJCQSCQ4ePIjvv/8e27dvh7m5udIyZ8+ehbm5Ofz8/BS2v/POO8jIyMAff/yBqKgovPDCC+jduzeys7MBAObm5jh37hwiIiIgEokUys6fPx/x8fFwcnJS2dbc3FyIRCLY2trKt8lkMvz+++8YNGiQfFtCQgIOHDiA33//Hb///jtOnTqFVatWKdS1bds2GBkZ4dKlS/jqq68QHh6O77//Xh4vLy/H0qVLcf36dRw4cABJSUkICQmp1Ka5c+di1apVuH37Ntq1awcA6NixIyQSCS5evKjyvTDG6ie+LcWYhn7//XdYWlrK/+7bty9++eUXjev79ttv0a5dO8yYMQP79u3Dp59+ig4dOqh8/r179+Ds7KxwS+rs2bO4dOkSMjIyIBaLAQCff/45Dhw4gD179mDSpEkatw8ASkpKMGfOHAwfPhzW1tby7RcuXAAABAYGyrfJZDJs3boVVlZWAIBRo0bh+PHjWL58ufw5Hh4e+PLLLyESidCyZUvcuHEDX375JSZOnAjgydiZCk2bNsXXX3+NF198EQUFBQr7fsmSJXj11VcV2mpubg4bGxvcu3dPq/fMGKt7uHPDmIZeeeUVbNy4Uf63hYWFVvXZ2dnhf//7H4KDg9GlSxfMnTuXfH5xcTFMTU0Vtl2/fh0FBQWwt7ev9NyEhASt2ldeXo4hQ4ZAEASF9w08uSX1+uuvK3S0vLy85B0bAHB1dVW4pQQAL730ksLVo86dO+OLL76AVCqFoaEhoqKi8Omnn+L69et4/PgxZDIZACA5ORmtWrWSl+vYsaPSNpuZmam8rccYq7+4c8OYhiwsLKo8eFYkEimMJQGedBaedfr0aRgaGiI1NRWFhYUKnYNnOTg44PHjxwrbCgoK4OrqipMnT1Z6/tO3kaqromNz7949nDhxQuGqDfAka+vZW07GxsYKf4tEInnnpCoKCwsRHByM4OBgbN++HY6OjkhOTkZwcDDKysoUnquqY5mdnV3jg7wZY/rHY24YqwGOjo5ITU2V/x0fH1/pisK5c+ewevVq/Pbbb7C0tMT06dPJOgMCApCWlqbQwXnhhReQlpYGIyMjNGvWTOHh4OCgUdsrOjbx8fE4duxYpatC8fHxuHfvXqXbQlXx7HiYCxcuoHnz5jA0NERMTAwePXqEVatWoXv37vD19a105YeSkJCAkpISBAQEVLtdjLG6jTs3jNWAXr16Yf369bh69SquXLmCyZMnK1zZyM/Px6hRozBjxgz07dsX27dvx+7du7Fnzx6VdQYEBMDBwUFh8r2goCB07twZgwcPxp9//omkpCScO3cO8+fPr5S6XRXl5eV4++23ceXKFWzfvh1SqRRpaWlIS0uTXz359ddfERQUpHLgMyU5ORmhoaGIjY3Fzp07sW7dOsycORMA0KRJE5iYmGDdunW4e/cuIiMjsXTp0irXfebMGTRt2hQ+Pj7VbhdjrG7jzg1jNeCLL76Ah4cHunfvjhEjRmD27NkKnYGZM2fCwsICK1asAAC0bdsWK1aswHvvvYcHDx4ordPQ0BBjx47F9u3b5dtEIhEOHTqEl19+GWPHjkWLFi0wbNgw+eDj6nrw4AEiIyNx//59+Pv7w9XVVf44d+4cAOUp4FU1evRoFBcXo1OnTpg2bRpmzpwpH/Ts6OiIrVu34pdffkGrVq2watUqfP7551Wue+fOnfKByYyxhkUkPDsQgDFWZ6SlpaF169aIjo6Gp6dnjb9+VlYWXF1dcf/+fY06T8/LzZs30atXL8TFxcHGxkbfzWGM1TC+csNYHebi4oL//e9/lSbUqynZ2dkIDw+vVR0bAEhNTcUPP/zAHRvGGii+csMYY4yxeoWv3DDGGGOsXuHODWOMMcbqFe7cMMYYY6xe4c4NY4wxxuoV7twwxhhjrF7hzg1jjDHG6hXu3DDGGGOsXuHODWOMMcbqFe7cMMYYY6xe+T8/DbrJNVJ+YAAAAABJRU5ErkJggg==", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "ax, cb = plot_dataset(ds, auto_color_scale=True, cutoff_percentile=50)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Here all the relevant region is considered as outliers. To make this clearer let's draw the histogram again:" ] }, { "cell_type": "code", "execution_count": 10, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "" ] }, "execution_count": 10, "metadata": {}, "output_type": "execute_result" }, { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "import matplotlib.pyplot as plt\n", "import numpy as np\n", "\n", "data = ds.get_parameter_data()[\"z\"][\"z\"]\n", "pl, q3, q1, pu = np.percentile(data, [99.5,75, 25, 0.5])\n", "fig, ax = plt.subplots(1,1)\n", "ax.hist(data, bins=100)\n", "# IQR\n", "ax.axvline(q3, color='k')\n", "ax.axvline(q1, color='k')\n", "# cut off\n", "ax.axvline(q1-1.5*(q3-q1), color='b')\n", "ax.axvline(q3+1.5*(q3-q1), color='b')\n", "# limit through percentiles\n", "ax.axvline(pl, color='r')\n", "ax.axvline(pu, color='r')" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The region of interest is represented by the right hand side structure around 0. The IQR induced limits (blue) does not capture these values. The percentile limits (0.5% here) however save the day:" ] }, { "cell_type": "code", "execution_count": 11, "metadata": {}, "outputs": [ { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "ax, cb = plot_dataset(ds, auto_color_scale=True, cutoff_percentile=0.5)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "There is some undesired clipping in the top right corner of the ROI but the structure within the ROI is relatively well resolved." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Asymmetric cutoffs\n", "Asymmetric cutoffs can be simply defined via a tuples. So for the data of the first example we can disregard the lower outliers that take up up to five percent of the data but not allow any clipping on the upper end:" ] }, { "cell_type": "code", "execution_count": 12, "metadata": {}, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "D:\\source\\repos\\Qcodes\\src\\qcodes\\dataset\\data_set_cache.py:85: UserWarning: Trying to mark a run completed that was already completed.\n", " self.load_data_from_db()\n" ] }, { "data": { "image/png": "iVBORw0KGgoAAAANSUhEUgAAAjIAAAHHCAYAAACle7JuAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguMSwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/SrBM8AAAACXBIWXMAAA9hAAAPYQGoP6dpAABvQklEQVR4nO3deVxUVf8H8M8AMmyCGKuGorjvhrmviZL6aLapaYq4ZcqjRj6VLeKSaVpomY+WpViuTy655obhkluCmpn7gqaCkAIKCsKc3x/E/ByBuTNzZ7gzzOf9vO7riTv3nHvunRn8cu75nqMSQggQERER2SAHpRtAREREZCoGMkRERGSzGMgQERGRzWIgQ0RERDaLgQwRERHZLAYyREREZLMYyBAREZHNYiBDRERENouBDBEREdksBjJkMQkJCVCpVEhISFC6KXYlLi4OKpUKV69eNbrs0KFDERwcbPY2lXedO3dG586dlW6GxVnqOnv27ImRI0eavV5DXL16FSqVCnFxcdp9U6ZMgUqlKvO2/P3333B3d8e2bdvK/Ny2TNFApugXbtHm5OSEqlWrYujQobhx44aSTdPKyMiAg4MDduzYAQDYsGED1Go1cnNzdY47ffo0Xn31VdSsWRNubm7w8fFBx44dsXnzZpPPXfQFK22bNWuWrGujQitXrsS8efMMPv6TTz7BTz/9JOuc5qijvMrJycGUKVMYANuJX3/9FTt37sS7775r0fMY+z1XwlNPPYURI0bgo48+UropNsVJ6QYAwLRp01CjRg08fPgQhw8fRlxcHA4cOIA//vgDLi4uirbt6NGjAIBWrVoBAA4dOoTmzZtDrVbrHJecnIx79+4hIiICVapUQU5ODtatW4c+ffrg66+/xqhRo0xuw2uvvYaePXsW29+8eXOT6ywLHTt2xIMHD+Ds7Kx0U/RauXIl/vjjD0yYMMGg4z/55BO88sor6Nu3r8nnNEcdpRk8eDAGDBhQ7DNqK3JycjB16lQAsIteDns3Z84cdO3aFbVq1bLoeYz5nn/44Yd47733LNqe0owePRpffvkl9uzZg+eee06RNtgaqwhkevTogRYtWgAARowYAR8fH3z66afYtGkT+vXrp2jbjh49irp166JSpUoACgOZoqDmcT179iwWbERFRSE0NBSxsbGyAplnnnkGr7/+usnly9rDhw/h7OwMBwcHxQNRe5KdnQ13d3c4OjrC0dFR6eaQifLz86HRaKz+DwBzuH37NrZu3YpFixYp3RQdTk5OcHIy3z+POTk5cHNzM+jY+vXro1GjRoiLi2MgYyCrHCPToUMHAMClS5e0+0p7NvvkM/2ixzGfffYZvvnmG4SEhECtVuPZZ5/Fb7/9ZtD5MzMzkZ6ejvT0dBw6dAhNmzZFeno6UlNTkZiYiHr16iE9PR2ZmZl663F0dERQUBAyMjIMOq+p9uzZAwcHB0yePFln/8qVK6FSqbBw4ULtPpVKhaioKKxYsQJ169aFi4sLQkNDsW/fvmL13rhxA8OGDYO/vz/UajUaNmyIJUuW6BxTNA5m9erV+PDDD1G1alW4ubkhKyurxDEynTt3RqNGjfD777+jU6dOcHNzQ61atbB27VoAwN69e9GqVSu4urqibt262L17t6x2/e9//8OMGTPw9NNPw8XFBV27dsXFixd12rN161YkJydrH9npGyOiUqmQnZ2NZcuWaY8fOnQogNLHlzz5vF1fHQBw/Phx9OjRA56envDw8EDXrl1x+PBhnTqLHsvu3bsXY8aMgZ+fH55++mmd1x4fI7Nx40b06tULVapUgVqtRkhICKZPn46CgoJSr9VQ+/fvx6uvvopq1apBrVYjKCgIb731Fh48eKBznCHf4atXr8LX1xcAMHXqVO39mTJlivb4PXv2oEOHDnB3d0elSpXwwgsv4MyZM0a3W6PR4IsvvkDjxo3h4uICX19fPP/88zh27Jj2mPz8fEyfPl37eyQ4OBjvv/9+sUfLJbl9+zaGDx8Of39/uLi4oGnTpli2bJnOMY//vpo3b572PH/++adB13Ds2DGEh4fDx8cHrq6uqFGjBoYNG2b0dS5duhTPPfcc/Pz8oFar0aBBA53fG/rk5uYiJiYGtWrV0r7/77zzjkH3aOvWrcjPz0dYWFix1y5fvoxXX30VlStXhpubG1q3bo2tW7fqHFPaeLAnf/cY+z0vbYzM8uXLERoaCldXV1SuXBkDBgzA9evXdY4p+h2XmJiIjh07ws3NDe+//z4Aw94vAOjWrRs2b94MIUSpbaT/ZxU9Mk8q+lB6e3ubXMfKlStx7949vPHGG1CpVJg9ezZeeuklXL58GRUqVNBb9oUXXsDevXt19q1Zs0b732PGjMGYMWPQqVOnYs/xs7Oz8eDBA2RmZmLTpk34+eef0b9/f5OvAyiM5tPT04vtr1SpEpycnPDcc89hzJgxmDlzJvr27YtnnnkGt27dwr///W+EhYVh9OjROuX27t2LNWvWYNy4cVCr1fjvf/+L559/HkePHkWjRo0AAKmpqWjdurU28PH19cXPP/+M4cOHIysrq1j37PTp0+Hs7IyJEyciNzdX71+Td+/exb/+9S8MGDAAr776KhYuXIgBAwZgxYoVmDBhAkaPHo2BAwdizpw5eOWVV3D9+nVUrFjRpHbNmjULDg4OmDhxIjIzMzF79mwMGjQIR44cAQB88MEHyMzMxF9//YW5c+cCADw8PEpt+w8//IARI0agZcuW2l62kJCQUo83to7Tp0+jQ4cO8PT0xDvvvIMKFSrg66+/RufOnbVB3uPGjBkDX19fTJ48GdnZ2aWeMy4uDh4eHoiOjoaHhwf27NmDyZMnIysrC3PmzDGq/U/68ccfkZOTgzfffBNPPfUUjh49ivnz5+Ovv/7Cjz/+aFRdvr6+WLhwId588028+OKLeOmllwAATZo0AQDs3r0bPXr0QM2aNTFlyhQ8ePAA8+fPR7t27ZCUlGTUQOXhw4cjLi4OPXr0wIgRI5Cfn4/9+/fj8OHDOj3Ey5YtwyuvvIK3334bR44cwcyZM3HmzBls2LCh1LofPHiAzp074+LFi4iKikKNGjXw448/YujQocjIyMD48eN1jl+6dCkePnyIUaNGQa1Wo3LlypLtv337Nrp37w5fX1+89957qFSpEq5evYr169cbfZ0LFy5Ew4YN0adPHzg5OWHz5s0YM2YMNBoNxo4dW2obNBoN+vTpgwMHDmDUqFGoX78+Tp06hblz5+L8+fOS48AOHjyIp556CtWrV9fZn5qairZt2yInJwfjxo3DU089hWXLlqFPnz5Yu3YtXnzxRcn78zhjv+clmTFjBj766CP069cPI0aMQFpaGubPn4+OHTvi+PHj2l57oHDQbo8ePTBgwAC8/vrr8Pf3N/j9AoDQ0FDMnTsXp0+f1v5OJj2EgpYuXSoAiN27d4u0tDRx/fp1sXbtWuHr6yvUarW4fv269thOnTqJTp06FasjIiJCVK9eXfvzlStXBADx1FNPiTt37mj3b9y4UQAQmzdvlmzXsWPHxK5du8SCBQsEALF8+XKxa9cuMXToUBEUFCR27doldu3aJY4dO1as7BtvvCEACADCwcFBvPLKKzrtMEbRtZS2HTp0SHtsdna2qFWrlmjYsKF4+PCh6NWrl/D09BTJyck6dRaVfbztycnJwsXFRbz44ovafcOHDxeBgYEiPT1dp/yAAQOEl5eXyMnJEUII8csvvwgAombNmtp9RYpe++WXX7T7OnXqJACIlStXavedPXtWe78OHz6s3b9jxw4BQCxdutTkdtWvX1/k5uZqj/viiy8EAHHq1Cntvl69eul8hqS4u7uLiIiIYvuf/CwWiYmJEU9+1Uqro2/fvsLZ2VlcunRJu+/mzZuiYsWKomPHjtp9Rd+d9u3bi/z8fJ06il67cuWKdt+T740QhZ9VNzc38fDhQ8lr0KekumfOnClUKpXO58/Q73BaWpoAIGJiYood26xZM+Hn5yf+/vtv7b6TJ08KBwcHMWTIEIPbvGfPHgFAjBs3rthrGo1GCCHEiRMnBAAxYsQIndcnTpwoAIg9e/aUem3z5s3T/u4okpeXJ9q0aSM8PDxEVlaWEOL/v+Oenp7i9u3bBrdfCCE2bNggAIjffvtN1nUKUfJ7GB4eLmrWrKmz78nr/OGHH4SDg4PYv3+/znGLFi0SAMSvv/6q9xrat28vQkNDi+2fMGGCAKBT771790SNGjVEcHCwKCgoEEKU/FkXouTfPaV9z4veg8d/zzz5nb169apwdHQUM2bM0Cl76tQp4eTkpLO/6HfcokWLdI415P0qcvDgQQFArFmzRvJYEsIqHi2FhYXB19cXQUFBeOWVV+Du7o5NmzZpu8pN0b9/f50enaLHVZcvX5YsGxoairCwMOTn56NKlSoYNGgQwsLCkJaWhq5duyIsLAxhYWEIDQ0tVnbChAnYtWsXli1bhh49eqCgoAB5eXkmXwcAjBo1Crt27Sq2NWjQQHuMm5sb4uLicObMGXTs2BFbt27F3LlzUa1atWL1tWnTRqft1apVwwsvvIAdO3agoKAAQgisW7cOvXv3hhBC+5gtPT0d4eHhyMzMRFJSkk6dERERcHV1Neh6PDw8MGDAAO3PRWOQ6tevr9PjUPTfRe+ZKe2KjIzU6R0y5nNQ1goKCrBz50707dsXNWvW1O4PDAzEwIEDceDAAWRlZemUGTlypEHjYR5/b+7du4f09HR06NABOTk5OHv2rKx2P153dnY20tPT0bZtWwghcPz4cVl1P+7WrVs4ceIEhg4dqtNj0aRJE3Tr1s2olNV169ZBpVIhJiam2GtFjxSK6ouOjtZ5/e233waAYo85Hrdt2zYEBATgtdde0+6rUKECxo0bh/v37xfr8X355Ze1j9QMVdQDsGXLFjx69KjEYwy5TkD3PSx6tN6pUydcvnxZ7yP0H3/8EfXr19c+bi/aisZ2/PLLL3qv4e+//y6x533btm1o2bIl2rdvr93n4eGBUaNG4erVqwY/ejOX9evXQ6PRoF+/fjrXGRAQgNq1axe7TrVajcjISJ19hrxfRYruSUk98VScVTxaWrBgAerUqYPMzEwsWbIE+/btk51x8eQ/4EUfjLt37+otd//+fTx8+BAAsGvXLrRu3Rrp6enQaDTYv38/Pv74Y6Snp8PR0bHEL2C9evVQr149AMCQIUPQvXt39O7dG0eOHDF5XoLatWuX+Az5Se3atcObb76JBQsWIDw8vMRnr0X1PalOnTrIyclBWloaHBwckJGRgW+++QbffPNNiXXcvn1b5+caNWoYcCWFnn766WL3wsvLC0FBQcX2Af//nqWlpRndLlM/B0pIS0tDTk4O6tatW+y1+vXrQ6PR4Pr162jYsKF2v6H3/fTp0/jwww+xZ8+eYsGQ1FgvKdeuXcPkyZOxadOmYvdVbt2PS05OBoBS78+OHTu0A56lXLp0CVWqVNH7CCc5ORkODg7FsmkCAgJQqVIlbXtKK1u7dm04OOj+rVi/fn2daylizPenSKdOnfDyyy9j6tSpmDt3Ljp37oy+ffti4MCB2t+fhlwnUJgCHRMTg0OHDiEnJ0fntczMTO138UkXLlzAmTNnSg3Cnvw+lkSUMA4kOTm5xKSKx+9fWT5yuXDhAoQQJf7uBFBsuELVqlWLPV435P0qUnRPlJjLxhZZRSDTsmVL7bPavn37on379hg4cCDOnTunfY6pUqlK/MCXNlixtL9SS6rjcVFRUcUG5D3+DHPcuHEYN24cqlevbtCEY6+88greeOMNnD9/vsRfwOaUm5urHbNz6dIlo0bKP06j0QAAXn/9dURERJR4TNGYhSKG9sYApb83Uu+ZKe0y9XNgitJ+6ZhjQG1pDLnvGRkZ6NSpEzw9PTFt2jSEhITAxcUFSUlJePfdd7X31RQFBQXo1q0b7ty5g3fffRf16tWDu7s7bty4gaFDh+rUbex32FqUxT8mxnx/iqhUKqxduxaHDx/G5s2bsWPHDgwbNgyff/45Dh8+bPAYkEuXLqFr166oV68eYmNjERQUBGdnZ2zbtg1z587V+/nQaDRo3LgxYmNjS3z9yT9OnvTUU0/J+qOirL5zGo0GKpUKP//8c4m/U5681yW9n8a8X0X3xMfHx6zXUV5ZRSDzOEdHR8ycORNdunTBV199pc3l9/b2LvFxgL6/ikzxzjvv4PXXX8eVK1cwatQofP/99wgMDMT//vc/bNu2TTv7o6G/eIoyN8z5l2lpYmJicObMGXz22Wd499138d577+HLL78sdtyFCxeK7Tt//jzc3Ny0f1lVrFgRBQUFBvUElRVfX1+LtMvYf6hKO97b27vEDLWSPqMl1eHr6ws3NzecO3eu2Gtnz56Fg4OD5D8MJUlISMDff/+N9evXo2PHjtr9V65cMbquJ506dQrnz5/HsmXLMGTIEO3+Xbt2FTvW0O9wafe3aEBoaffHx8fHoN4YoHBw9Y4dO3Dnzp1SeyuqV68OjUaDCxcuaHsCgMKBqBkZGcUGqD5Z9vfff4dGo9HplSl6jKevrLFat26N1q1bY8aMGVi5ciUGDRqE1atXY8SIEQZd5+bNm5Gbm4tNmzbp9GBKPRYCCu/jyZMn0bVrV5MCvnr16mHdunXF9levXr3U97nodeD/e1if/N4Z+p0zVEhICIQQqFGjBurUqWNyPYD+96tI0Xfz8c8dlc4qxsg8qXPnzmjZsiXmzZunfcwTEhKCs2fPIi0tTXvcyZMn8euvv5r13A0aNEBYWBicnJzg7e2N119/HWFhYcjKykL79u2142PatWunU66kLtRHjx7h+++/h6urq854Fks4cuQIPvvsM0yYMAFvv/02/vOf/+Crr74q9iweKJwL5/GxJNevX8fGjRvRvXt37RwkL7/8MtatW4c//vijWPnH34OyZKl2ubu7GxVouru7lxiwhISEIDMzE7///rt2361bt0rMbimpDkdHR3Tv3h0bN27U6e1LTU3FypUr0b59e3h6ehrczsfrBXR7ofLy8vDf//7X6LoMqVsIgS+++KLYsYZ+h4t6EZ+8P4GBgWjWrBmWLVum89off/yBnTt3ljhpZGlefvllCCG0E+89ruhaiup7cjbYot6HXr16lVp/z549kZKSopPtmJ+fj/nz58PDwwOdOnUyuK2luXv3brEermbNmgGANvXZkOss6T3MzMzE0qVLJdvQr18/3LhxA4sXLy722oMHD/Rm0gGF4/Xu3r1bLMDt2bMnjh49ikOHDmn3ZWdn45tvvkFwcLD292lRtt/j00cUFBSU+OjZ2O/541566SU4Ojpi6tSpxe65EAJ///23ZB2GvF9FEhMT4eXlpfMYmUpndT0yRf7zn//g1VdfRVxcHEaPHo1hw4YhNjYW4eHhGD58OG7fvo1FixahYcOGxZ75m8Ovv/6qTfMFCtMEJ06cWOrxb7zxBrKystCxY0dUrVoVKSkpWLFiBc6ePYvPP/9cp9swLi4OkZGRWLp0qc78IaVJSkrC8uXLi+0PCQlBmzZt8PDhQ0RERKB27dqYMWMGgMI5ODZv3ozIyEicOnVK5y/VRo0aITw8XCf9uqhMkVmzZuGXX35Bq1atMHLkSDRo0AB37txBUlISdu/ejTt37ki22xIs0a7Q0FCsWbMG0dHRePbZZ+Hh4YHevXvrPX737t2IjY1FlSpVUKNGDbRq1QoDBgzAu+++ixdffBHjxo1DTk4OFi5ciDp16hQbhFxaHR9//DF27dqF9u3bY8yYMXBycsLXX3+N3NxczJ492+hrA4C2bdvC29sbERERGDduHFQqFX744QezPF6rV68eQkJCMHHiRNy4cQOenp5Yt25diY8LDP0OFwX+a9asQZ06dVC5cmU0atQIjRo1wpw5c9CjRw+0adMGw4cP16Zfe3l56cw1I6VLly4YPHgwvvzyS1y4cAHPP/+8dhxcly5dEBUVhaZNmyIiIgLffPON9vHc0aNHsWzZMvTt2xddunQptf5Ro0bh66+/xtChQ5GYmIjg4GCsXbsWv/76K+bNm6edTkCOZcuW4b///S9efPFFhISE4N69e1i8eDE8PT21QZgh19m9e3c4Ozujd+/eeOONN3D//n0sXrwYfn5+uHXrlt42DB48GP/73/8wevRo/PLLL2jXrh0KCgpw9uxZ/O9//8OOHTu0wwZK0qtXLzg5OWH37t06k4a+9957WLVqFXr06IFx48ahcuXKWLZsGa5cuYJ169Zpe7kaNmyI1q1bY9KkSdpep9WrVyM/P7/YuYz9nj8uJCQEH3/8MSZNmoSrV6+ib9++qFixIq5cuYINGzZg1KhRev99AAx7v4rs2rULvXv35hgZQ5VRdlSJilLnSkpHKygoECEhISIkJESbXrp8+XJRs2ZN4ezsLJo1ayZ27NhRavr1nDlzitWJUlI6S1KvXj0xffp0IYQQf/31l2Ta3KpVq0RYWJjw9/cXTk5OwtvbW4SFhYmNGzcWO3b+/PkCgNi+fbveNkilXxel77711lvC0dFRHDlyRKf8sWPHhJOTk3jzzTd17sHYsWPF8uXLRe3atYVarRbNmzfXSVMskpqaKsaOHSuCgoJEhQoVREBAgOjatav45ptvtMcUpTn++OOPxcqXln7dsGHDYsdWr15d9OrVq9j+ovaaq10lpVrev39fDBw4UFSqVEkAkEw/Pnv2rOjYsaNwdXXVeR+EEGLnzp2iUaNGwtnZWdStW1csX768xPRrfXUkJSWJ8PBw4eHhIdzc3ESXLl3EwYMHdcrr++6UlJL666+/itatWwtXV1dRpUoV8c4772jT2x9/f0xJv/7zzz9FWFiY8PDwED4+PmLkyJHi5MmTxe6zEIZ9h4UoTD8NDQ0Vzs7Oxb63u3fvFu3atROurq7C09NT9O7dW/z5559GtVkIIfLz88WcOXNEvXr1hLOzs/D19RU9evQQiYmJ2mMePXokpk6dKmrUqCEqVKgggoKCxKRJk3RS1oUoObU8NTVVREZGCh8fH+Hs7CwaN25c7H7o+30lJSkpSbz22muiWrVqQq1WCz8/P/Gvf/2r2LQQhlznpk2bRJMmTYSLi4sIDg4Wn376qViyZEmxz1FJ15mXlyc+/fRT0bBhQ6FWq4W3t7cIDQ0VU6dOFZmZmZLX0adPH9G1a9di+y9duiReeeUVUalSJeHi4iJatmwptmzZUuJxYWFhQq1WC39/f/H++++LXbt2Fftsl/Y9NyT9usi6detE+/bthbu7u3B3dxf16tUTY8eOFefOndO5RyX9jjP0/Tpz5ox2WhIyjEoITh1Y1vr164erV69q13EqSyqVCmPHjsVXX31V5ucmInrS/v370blzZ5w9e7bUrCB7MmHCBOzbtw+JiYnskTGQVY6RKc+EEEhISMDHH3+sdFOIiBTXoUMHdO/e3eRHp+XJ33//jW+//RYff/wxgxgjWO0YmfJKpVIZNLcCkdLu3LmjdzJHR0dHoydxs7SCggLJQd8eHh5GT09f1tLS0vSmEDs7Oxu0jIGt+Pnnn5VuglV46qmncP/+faWbYXMYyBBRiV566aUSs96KGDqXUlm6fv265ORyMTExRg0MVsKzzz6rd2qJktZ5I7JXDGTsDIdEkaE+//xzvZOVmTKJm6UFBASUOIfN4x5f/sFarVixotjq4Y+Ts6AuUZGFCxdi4cKF2j9IGjZsiMmTJ6NHjx7KNsxIHOxLRERkhzZv3gxHR0fUrl0bQggsW7YMc+bMwfHjx21qDhsGMkRERAQAqFy5MubMmYPhw4cr3RSD2d2jJY1Gg5s3b6JixYocFU5ERHoJIXDv3j1UqVKl2CKg5nL+/HmzDXiuX78+WrdurbNPrVZLLsRcUFCAH3/8EdnZ2WjTpo1Z2lJWbK5HZt++fZgzZw4SExO107/37dvX4PJ//fWXSevVEBGR/bp+/Tqefvppi9T98ssv48KZLQgJriB9sB4ZmRr8dtKh2NIQ+ga4nzp1SjtDvIeHB1auXGnUch/WwOZ6ZLKzs9G0aVMMGzYML730ktHli6YG71QnCk6OpUSoUj01ElG5kCrvqP914SBRXuJlIfVXg1R5ifZJ3R857Zc6t9S9FVJ/MEmVl+qkk7g2qfNL1S//vZfZPpmv672/Um2XvDapc8srL/+zJe/88ttv4folqtc3K5nS762c8gW5D3H5y2lmWVai1PMLgaGvVcS4kZVk1ZN4Mhe9B+fi5s2bOvv19cbUrVsXJ06cQGZmJtauXYuIiAjs3bvX4usDmpPNBTI9evSQNaK66HGSk6PaigMZiW+l5D82DGRKP7fM8gxk9NNzf+XfG6lzyytf7gMZue+9RPXlNZDRVmFDQxGMWVzW2dkZtWrVAlC4HtVvv/2GL774Al9//bWlmmd2NhfIGCs3N1dnZVFLLDBJREQkh4BAgdDIqkMDeeWBwnGkT67Gbe3KfSAzc+bMEpewJyIishYCgEa630svY8tPmjQJPXr0QLVq1XDv3j2sXLkSCQkJ2LFjh6x2lLVyv9bSpEmTkJmZqd2uX7+udJOIiIgUd/v2bQwZMgR169ZF165d8dtvv2HHjh3o1q2b0k0zSrnvkTEk7YyIiEhJmn/+J4cwskfmu+++k3U+a1HuAxkiIiJrJwRQIHM2FLnlbZXNBTL379/HxYsXtT9fuXIFJ06cQOXKlVGtWjUFW2Y+KokPo5AYgi9ZXmL0vUrijwLhqP91SH2Z9J1f6g8SiXOrJE4tmdkh9/eAVHmppCTZ7ZdXgdR7L5n9oe8GSJ1b4tRS91byrZP6WEqeQCKrSeL0ku+tRHnp9ksUlyov9d5LZTXpKa+SGsQg9TtHKhHTguUl74uZCAjZY2SM7ZEpL2wukDl27Bi6dOmi/Tk6OhoAEBERgbi4OIVaRUREREqwuUCmc+fOXMGZiIjKFQ2AApk9KnLL2yqbC2SIiIjKG/M9WrKdifvMhYEMERGRwjRmGexrpsbYmHI/jwwRERGVX+yRISIiUljhzL7y67BHDGSo7On7tkmmJ8tLLZeVGg4U9v/qI7HopcXTwy2e3i3j9AqnHyt9fsmPnszzy22/FDnp2VJLCFl1enYZRQcaCDMN9rW/MTJ8tEREREQ2iz0yREREChOQP1hXqsO4vGIgQ0REpDAN5I+RKaNJiK0OAxkiIiKFCahQIHN8i8YOx8cAHCNDRERENow9MkRERAoTQv4YF46RIdshc4VouSm8slOYLUnh9GRLr16tkl5+WuJly66OrXdldItfmwTZ6c/yVqVXMv0ZgOwUZkl6rk9yVgQrTs8uq9WvC9dakvtoyT4xkCEiIlKYhmNkTMYxMkRERGSz2CNDRESkMAFAI/nsWb/CHhn7GyjDQIaIiEhh5nu0ZH+BDB8tERERkc1ijwwREZHCCifEk9e3ILdHx1YxkCEiIlKYECrZY2SEzPK2ioGMEqx5HhYzkDOXikruXB0S5M/zIuv0sucykd0+ufPgSFSvdy4RqaIyr016HhhZLxtwfokDNPpbaMl5XAAD7o8F52KRLGvN88yU0ZATc8wjY689MhwjQ0RERDaLPTJEREQK00CFApndchrZ3Xq2iYEMERGRwgRU0Mh8SGKvM/sykCEiIlIYlygwnX32QxEREVG5wB4ZIiIihQkhf4yM3PK2ioFMeSQ3vVuqvNzuS331S7VNMg1TIn1b7rVLtk9/eZWDRAquZAqyRP1S741kCrK865eTgiv32uSnT8srL/2tkZf7L1m/3PRpifrlXL/stimYni3VdnMpHCMjcx4ZM7XF1thn+EZERETlAntkiIiIFKYxyxIF9tk3wUCGiIhIYRozjJHhPDJERESkCM4jYzr7DN+IiIioXGCPDBERkcIKlyjghHimYCBDRpNMpXSUUbmFM78VXx1aisKrYyuZgiudOW7p1HP9JNsv0b8tXb/EEVKp+1L1K3j9Fk8dt2B6ttR9MxdhhsG+ch9N2SoGMkRERArTCJXswboamT06tso+wzciIiIqFxjIEBERKazo0ZKczdhHSzNnzsSzzz6LihUrws/PD3379sW5c+f0lomLi4NKpdLZXFxc5Fy6bAxkiIiIFFY02FfuZoy9e/di7NixOHz4MHbt2oVHjx6he/fuyM7O1lvO09MTt27d0m7JyclyLl02jpEhIiKyQ9u3b9f5OS4uDn5+fkhMTETHjh1LLadSqRAQEGDp5hmMPTJEREQKK5oQT84mZKZ1ZmZmAgAqV66s97j79++jevXqCAoKwgsvvIDTp0/LOq9c7JEhIiJSmDmWKCgqn5WVpbNfrVZDrVbrP79GgwkTJqBdu3Zo1KhRqcfVrVsXS5YsQZMmTZCZmYnPPvsMbdu2xenTp/H000/Lar+pGMiYQkhNxiEzBc7C9ask6hdW3H7Jtsv8i0R6rg2Z1yYxV4hKaq4QyXli5M21Ysn6LT3HjeR7I9EAmc0zQ/stXL+MuVQMOL3+uWAsWTcgffFS59dXv9S5zURA/oR2AipkZ2fDy8tLZ39MTAymTJmit+zYsWPxxx9/4MCBA3qPa9OmDdq0aaP9uW3btqhfvz6+/vprTJ8+3eS2y8FAhoiIqJxwd3fHrVu3dPZJ9cZERUVhy5Yt2Ldvn9G9KhUqVEDz5s1x8eJFo9tqLgxkiIiIFKaBgxkeLRX26Hh6ehp0vBAC//73v7FhwwYkJCSgRo0axp+zoACnTp1Cz549jS5rLgxkiIiIFKbEEgVjx47FypUrsXHjRlSsWBEpKSkAAC8vL7i6ugIAhgwZgqpVq2LmzJkAgGnTpqF169aoVasWMjIyMGfOHCQnJ2PEiBGy2i4HAxkiIiKFCSF/iQFjx9gsXLgQANC5c2ed/UuXLsXQoUMBANeuXYODw/8HSHfv3sXIkSORkpICb29vhIaG4uDBg2jQoIGstsvBQIaIiMgOCanEDAAJCQk6P8+dOxdz5861UItMw0CGiIhIYRqzPFqyz0UjGchQcZK5kPKq15fiLD+9WaK4g2VTz6XTt2WSm4KrZAq0VPqzxHsnOQ5SonFy3xvJT4al65dI3RcSqftKpmfLTZ+WOQZW+vx66i+r0EDAwQyrX9vnHLf2edVERERULrBHhoiISGEaAAUy+3/4aImIiIgUIYTKDI+WGMgQERGRAgoH+7JHxhQcI0NEREQ2iz0yRERECjPPoyX77JtgIENERKQwDVSy11riGBmyGSqJ2RiFpZ+TSs4GacHzW/rUlp6nRYrEXCEqiblCpOeJkahf4gol58HRU1z2PC5y5yKROIPsa5c9B4+88lLvrdTvBUvOMyN/Dh39L1tynhnJz52ZCKhkj3HhGBkiIiIiG8MeGSIiIoUJYYZHS3baN8FAhoiISGEamGH1a9lroNgm+wzfiIiIqFxQPJBZsGABgoOD4eLiglatWuHo0aN6j583bx7q1q0LV1dXBAUF4a233sLDhw/LqLVERETmJ/5Z/VrOxkdLClizZg2io6OxaNEitGrVCvPmzUN4eDjOnTsHPz+/YsevXLkS7733HpYsWYK2bdvi/PnzGDp0KFQqFWJjYxW4AiIiIvkK55GR+2jJPrOWFA1kYmNjMXLkSERGRgIAFi1ahK1bt2LJkiV47733ih1/8OBBtGvXDgMHDgQABAcH47XXXsORI0fKtN1WTypd0NGyp5dKVxQOeh7kquR9ESVT0zUS9cu9N5ZOb5Y8v/6XpVOA5bVfX3HrT3+Wee0yU4Rlp2dLfe/1fe9g2fRsqa+13Hsj+TtP6vz6Xi+jcSeF6dfyelQsPvWGlVKsHyovLw+JiYkICwv7/8Y4OCAsLAyHDh0qsUzbtm2RmJioffx0+fJlbNu2DT179iz1PLm5ucjKytLZiIiIqHxQrEcmPT0dBQUF8Pf319nv7++Ps2fPllhm4MCBSE9PR/v27SGEQH5+PkaPHo3333+/1PPMnDkTU6dONWvbiYiIzKlwZl95PSpyy9sqmxoZlJCQgE8++QT//e9/kZSUhPXr12Pr1q2YPn16qWUmTZqEzMxM7Xb9+vUybDEREZE0IQrHuMjZhJ0GMor1yPj4+MDR0RGpqak6+1NTUxEQEFBimY8++giDBw/GiBEjAACNGzdGdnY2Ro0ahQ8++AAODsXjMrVaDbVabf4LICIiMhOzLBppW30TZqPYVTs7OyM0NBTx8fHafRqNBvHx8WjTpk2JZXJycooFK46OhaMzheT6P0RERFTeKJq1FB0djYiICLRo0QItW7bEvHnzkJ2drc1iGjJkCKpWrYqZM2cCAHr37o3Y2Fg0b94crVq1wsWLF/HRRx+hd+/e2oCGiIjI1migQoHsRSPtk6KBTP/+/ZGWlobJkycjJSUFzZo1w/bt27UDgK9du6bTA/Phhx9CpVLhww8/xI0bN+Dr64vevXtjxowZSl1CiRRfnVqKVO+VzBRoOaRXSLZs2+W+d1a/OrZE9bLbry+zXrKotac/Wy413YCXLZ+eLfHlExKfLTkZzHJXNpd6tiDn3kr9TjIXAc4jYyrF11qKiopCVFRUia8lJCTo/Ozk5ISYmBjExMSUQcuIiIjI2ikeyBAREdk7swz2lVneVjGQISIiUpgGheNk5FB82IJCGMgQEREpTJhlQjwzNcbG2Gc/FBEREZUL7JEhIiJSmDnGyAgbGSPz6NEjpKSkICcnB76+vqhcubKs+mzjqomIiMoxAflLFMgdY2NJ9+7dw8KFC9GpUyd4enoiODgY9evXh6+vL6pXr46RI0fit99+M6lu9sgoQWrOBIXn9pM9D46S3yWpaWYkDhAaicbLfW8k7q3UXCSSj8Al5pmBo8w3R0b75c+TIjURi8Q8J0rPMyP12bLgXCjmKC/52dJXgcz5jaTInodGz+uSdZuJBvIDEWsd7BsbG4sZM2YgJCQEvXv3xvvvv48qVarA1dUVd+7cwR9//IH9+/eje/fuaNWqFebPn4/atWsbXD8DGSIiIrKY3377Dfv27UPDhg1LfL1ly5YYNmwYFi1ahKVLl2L//v0MZIiIiGyJEOaY2ddMjTGzVatWGXScWq3G6NGjja6fgQwREZHCOCGe6RjIEBERUZnIzs7GrFmzEB8fj9u3b0Oj0R2EdPnyZaPrZCBDRESksKKsJVl12MCikSNGjMDevXsxePBgBAYGQmWGRYoZyBARESlMmCFryZrTr4v8/PPP2Lp1K9q1a2e2OhnIWCOJFFeYIYK1KKkUXT1pqMLBuq9dbmq67BRjmdevkspgliov8bq+9stOLZfK+pd7bUzPtlh5lWTqtsRnQ+bQD1nXXkYDaIUwR4+MmRpjQd7e3rInwHuSfY4MIiIiojI3ffp0TJ48GTk5OWarkz0yREREChMwQ/q1DTxa+vzzz3Hp0iX4+/sjODgYFSpU0Hk9KSnJ6DoZyBARESlMY5Z5ZIwrP3PmTKxfvx5nz56Fq6sr2rZti08//RR169aV1Q59+vbta/Y6GcgQEREpTImspb1792Ls2LF49tlnkZ+fj/fffx/du3fHn3/+CXd3d1ltKU1MTIzZ62QgQ0REZIe2b9+u83NcXBz8/PyQmJiIjh07WvTciYmJOHPmDACgYcOGaN68ucl1MZAhIiJSmDnTr7OysnT2q9VqqNVqyfKZmZkAYPasosfdvn0bAwYMQEJCAipVqgQAyMjIQJcuXbB69Wr4+voaXSezloiIiBRWlH4tZxOicOZcLy8vnW3mzJmS59doNJgwYQLatWuHRo0aWew6//3vf+PevXs4ffo07ty5o139OisrC+PGjTOpTvbI2CJbn2dGBum5QuTNhqGSKC81T4ylyZ0rRWpVOZWDvLle9JWWO0eO3Pde7jw2Vj/PjMTL8ttnennpshJHyL12qeJ6Xpd6362Nu7s7bt26pbPPkN6YsWPH4o8//sCBAwcs1TQAhY+zdu/ejfr162v3NWjQAAsWLED37t1NqpOBDBERkcLMs/p1YXlPT0+jykVFRWHLli3Yt28fnn76aVltkKLRaIqlXANAhQoViq27ZCg+WiIiIlJYUdaSrM3IHmMhBKKiorBhwwbs2bMHNWrUsMzFPea5557D+PHjcfPmTe2+Gzdu4K233kLXrl1NqpM9MkRERAozR4+MsenXY8eOxcqVK7Fx40ZUrFgRKSkpAAAvLy+4urrKaktpvvrqK/Tp0wfBwcEICgoCAFy/fh2NGjXC8uXLTaqTgQwREZEdWrhwIQCgc+fOOvuXLl2KoUOHWuScQUFBSEpKwu7du3H27FkAQP369REWFmZynQxkiIiIFCagMrpHpVgdRpYXCqwyefnyZdSsWRPdunVDt27dzFInx8gQEREpTKBwHhh5m/WrVasWunTpguXLl+Phw4dmqZOBTDmkEkLvBg30b0Lo3STrL88k7p3kvRHQu6kkNun3Rqq8xKYRejfJ+mWQ23al751Ko39Tuv1S7bPoJvu9tfT3SmIrA0LuQF8hv0enLCQlJaFJkyaIjo5GQEAA3njjDRw5ckRWnQxkiIiIqEw0a9YMX3zxBW7evIklS5bg1q1b6NChAxo1aoTY2FikpaUZXScDGSIiIoUVdrqpZG+2wsnJCS+99BJ+/PFHfPrpp7h48SImTpyIoKAgDBkypNikfvowkCEiIlKYOR4tyV2rqSwdO3YMY8aMQWBgIGJjYzFx4kRcunQJu3btws2bN/HCCy8YXBezloiIiKhMxMbGYunSpTh37hx69uyJ77//Hj179oSDQ2G/So0aNRAXF4fg4GCD62QgQ0REZAVkPxqygUdLCxcuxLBhwzB06FAEBgaWeIyfnx++++47g+tkIENERKSwosdD8uowU2Ms6MKFC5LHODs7IyIiwuA6GciQ+Ul+mUo/QGqFX+Ggv3LpFY6lGidzdWyJ9qsk2i+5ura1/8Gl5/Jkr/4sd/Vqpc+v9OrZFr9/espKTXAiVbnk6xKtlyxf+gFltvr1P5n0sqqwgUAGADIyMnD06FHcvn272EKRQ4YMMbo+BjJERERUJjZv3oxBgwbh/v378PT0hOqxIFKlUpkUyDBriYiISGEC8mf2lezRtQJvv/02hg0bhvv37yMjIwN3797Vbnfu3DGpTvbIEBERKUyJtZaUcOPGDYwbNw5ubm5mq5M9MkRERAqzl3lkwsPDcezYMbPWyR4ZIiIiKhO9evXCf/7zH/z5559o3LgxKlSooPN6nz59jK6TgQwREZEVsIespZEjRwIApk2bVuw1lUqFgoICo+tkIENERKSwwkXMy/+EeE+mW5sDAxkiGyI1XYal5xKRmnFL5VB6/VY/z4vS5y/H88xYco4a85TXM7eVLXRzlAMZGRlYvnw5oqKijC7Lwb5EREQKK8pakrcpfRXGi4+Px8CBAxEYGIiYmBiT6mAgQ0REpDAhID9ryQYeLQHA9evXMW3aNNSoUQPdu3eHSqXChg0bkJKSYlJ9DGSIiIiUJorGycjYlL4GPR49eoQff/wR4eHhqFu3Lk6cOIE5c+bAwcEBH3zwAZ5//vliGUyG4hgZIiIisqiqVauiXr16eP3117F69Wp4e3sDAF577TXZdTOQISIiUpg5Zva15qyl/Px8qFQqqFQqODo6mrVuPloiIiJS2j/p13I3a3Xz5k2MGjUKq1atQkBAAF5++WVs2LBBZ9FIU7FHhsqe3ge5EimiGokUUQe5KabyEj31pXECgJBov0qi/VKLwimdgqsvPVtfarYhdSt9bYqfX+n0bMkG6jmD1Mmt+HWp+24uAvLHuFjzGBkXFxcMGjQIgwYNwqVLl7B06VKMGzcO+fn5mDFjBoYOHYrnnnvOpN4a9sgQERFRmQkJCcHHH3+M5ORkbN26Fbm5ufjXv/4Ff39/k+pjjwwREZHC7GX168c5ODigR48e6NGjB9LS0vDDDz+YVA8DGSIiIqWV42dLQgjJsTC+vr6Ijo42qX4+WiIiIiKLadiwIVavXo28vDy9x124cAFvvvkmZs2aZVT97JEhIiJSnBkeLZmpJeY2f/58vPvuuxgzZgy6deuGFi1aoEqVKnBxccHdu3fx559/4sCBAzh9+jSioqLw5ptvGlU/AxkiIiKFFc3OK68SszTF7Lp27Ypjx47hwIEDWLNmDVasWIHk5GQ8ePAAPj4+aN68OYYMGYJBgwZpJ8ozBgMZIiIipQn5g3WtfbBv+/bt0b59e7PXy0DGFskM2yXnk5CY6wSSc7VI1G+GCZDslUrivbfqeWb0zDEDcJ4ZWfO0FJ5AorzE61IjJiVPr2cOIYvfWwuWt9JeDvp/DGSIiIgUp5K/xICV98hYCgMZIiIihZljjIzsMTY2SvH06wULFiA4OBguLi5o1aoVjh49qvf4jIwMjB07FoGBgVCr1ahTpw62bdtWRq0lIiKyECFzs1OKBjJr1qxBdHQ0YmJikJSUhKZNmyI8PBy3b98u8fi8vDx069YNV69exdq1a3Hu3DksXrwYVatWLeOWExERkTHy8/Px/fffIzU11az1KvpoKTY2FiNHjkRkZCQAYNGiRdi6dSuWLFmC9957r9jxS5YswZ07d3Dw4EFUqFABABAcHFyWTSYiIjI/O8hacnJywujRo3HmzBmz1qtYj0xeXh4SExMRFhb2/41xcEBYWBgOHTpUYplNmzahTZs2GDt2LPz9/dGoUSN88sknKCgoKKtmExERWYbcR0s28HipZcuWOHHihFnrVKxHJj09HQUFBcVWu/T398fZs2dLLHP58mXs2bMHgwYNwrZt23Dx4kWMGTMGjx49QkxMTIllcnNzkZubq/05KyvLfBdhIskUWsn0ZzM2ppxRafS/LiRTx6XSROUleqokyiv93kulAMtJYZb8HVve07NlNtDi7ZP87kiU13tueW2X/ebKeF3qvpBxxowZg+joaFy/fh2hoaFwd3fXeb1JkyZG12lTWUsajQZ+fn745ptv4OjoiNDQUNy4cQNz5swpNZCZOXMmpk6dWsYtJSIiMpwQ9rH69YABAwAA48aN0+5TqVTahSVNecKi2N/2Pj4+cHR0LDboJzU1FQEBASWWCQwMRJ06deDo6KjdV79+faSkpJS6GNWkSZOQmZmp3a5fv26+iyAiIjIXBR4t7du3D71790aVKlWgUqnw008/6T0+ISEBKpWq2JaSkmLQ+a5cuVJsu3z5svb/TaFYj4yzszNCQ0MRHx+Pvn37AijscYmPj0dUVFSJZdq1a4eVK1dCo9HAwaEwBjt//jwCAwPh7OxcYhm1Wg21Wm2RayAiIjKfsu9Ryc7ORtOmTTFs2DC89NJLBpc7d+4cPD09tT/7+fkZVK569epGt1GKoqMtoqOjsXjxYixbtgxnzpzBm2++iezsbG0W05AhQzBp0iTt8W+++Sbu3LmD8ePH4/z589i6dSs++eQTjB07VqlLICIislk9evTAxx9/jBdffNGocn5+fggICNBuRZ0Lhvjhhx/Qrl07VKlSBcnJyQCAefPmYePGjUa1oYiigUz//v3x2WefYfLkyWjWrBlOnDiB7du3awcAX7t2Dbdu3dIeHxQUhB07duC3335DkyZNMG7cOIwfP77EVG0iIiKbYWMZS82aNUNgYCC6deuGX3/91eByCxcuRHR0NHr27ImMjAztmJhKlSph3rx5JrVF8cG+UVFRpT5KSkhIKLavTZs2OHz4sIVbRUREVIbMEYz8U/7J7FxzDrEIDAzEokWL0KJFC+Tm5uLbb79F586dceTIETzzzDOS5efPn4/Fixejb9++mDVrlnZ/ixYtMHHiRJPapHggUy5JLXhR3ld/lrh+/WmaMte5VfreSi52Ytn0bJVEernk/ZV7+/Rcv9z0YKtPz5a5erXVp4/LSUOWXFlb4nMr+bG13L2VfF/NxjyLRmZnZ8PLy0tnd0xMDKZMmSKv7n/UrVsXdevW1f7ctm1bXLp0CXPnzsUPP/wgWf7KlSto3rx5sf1qtRrZ2dkmtYmBDBERUTnh7u6uMyQDgMUTXlq2bIkDBw4YdGyNGjVw4sSJYoN+t2/fjvr165t0fgYyRERECjPH6tdFXU+PZxOVhRMnTiAwMNCgY6OjozF27Fg8fPgQQggcPXoUq1atwsyZM/Htt9+adH6TA5lHjx4hJSUFOTk58PX1ReXKlU2tioiIiMwUyBjj/v37uHjxovbnK1eu4MSJE6hcuTKqVauGSZMm4caNG/j+++8BFGYX1ahRAw0bNsTDhw/x7bffYs+ePdi5c6dB5xsxYgRcXV3x4YcfIicnBwMHDkSVKlXwxRdfaCfLM5ZRgcy9e/ewfPlyrF69GkePHkVeXp52Nr6nn34a3bt3x6hRo/Dss8+a1BgiIiIqO8eOHUOXLl20P0dHRwMAIiIiEBcXh1u3buHatWva1/Py8vD222/jxo0bcHNzQ5MmTbB7926dOqQMGjQIgwYNQk5ODu7fv2/wHDSlMTiQiY2NxYwZMxASEoLevXvj/fffR5UqVeDq6oo7d+7gjz/+wP79+9G9e3e0atUK8+fPR+3atWU1joiIyC4IMwz2NWG0fufOnSH0PNOKi4vT+fmdd97BO++8Y/R5nnT79m2cO3cOQOESBb6+vibXZXAg89tvv2Hfvn1o2LBhia+3bNkSw4YNw6JFi7B06VLs37+fgQwREZEBVDBDhpQNrH597949jBkzBqtWrYJGU5gK5+joiP79+2PBggXFMq4MYfCEeKtWrSo1iHmcWq3G6NGjMWzYMKMbQ0REZJfMMSGeDQQyI0aMwJEjR7B161ZkZGQgIyMDW7ZswbFjx/DGG2+YVKdZspaysrKwZ88e1K1b1+T0KbIeKomh81JzmSg7X7R+UnNhCIl5WCTnq7DwNDZy3xu588xIzmWid5Igy85zovQ8M1IsPs+L3PPLnQdHz8vS3zuJU+t/2YC5uyTK67s2GwgObMmWLVuwY8cOtG/fXrsvPDwcixcvxvPPP29SnSb9k9OvXz989dVXAIAHDx6gRYsW6NevH5o0aYJ169aZ1BAiIiK7JfD/42TkbFbuqaeeKvHxkZeXF7y9vU2q06RAZt++fejQoQMAYMOGDRBCICMjA19++SU+/vhjkxpCRERk1+zg0dKHH36I6OhopKSkaPelpKTgP//5Dz766COT6jTp0VJmZqZ23pjt27fj5ZdfhpubG3r16oX//Oc/JjWEiIjIbtlIIGKK5s2bQ/XY47sLFy6gWrVqqFatGoDCBaLVajXS0tJMGidjUiATFBSEQ4cOoXLlyti+fTtWr14NALh79y5cXFxMqZKIiIjKob59+1q0fpMCmQkTJmDQoEHw8PBA9erV0blzZwCFj5waN25szvYRERHZh3Kafh0TE2PR+k0KZMaMGYNWrVrh2rVr6NatGxwcCofa1KxZk2NkiIiIjGWOwbo2MNj3cffv39fOJVPElHWiTE6/Dg0NRWhoqM6+Xr16mVqdbZFM9bPyD5MVt18yvdiAJFP9J5D7i0JuCq3MJFq5b41EGqxUevbu75fofb1rxPBSX5P8HWvl6dlSJ5C6Ptnp0VI1yM3Plqze9PZJNq1A6gD9L8tN39Z7bbJXcqTHXblyBVFRUUhISMDDhw+1+4uWOyookPowFGdwIDNr1iyMHz8erq6uksceOXIE6enp9hPYEBERyWCOmX1lzwxcBl5//XUIIbBkyRL4+/vrDAI2lcGBzJ9//olq1arh1VdfRe/evdGiRQvt2gj5+fn4888/ceDAASxfvhw3b97UrpRJREREEsyRtWQDgczJkyeRmJiIunXrmq1Og+eR+f7777F79248evQIAwcOREBAAJydnVGxYkWo1Wo0b94cS5YswZAhQ3D27Fl07NjRbI0kIiIi2/fss8/i+vXrZq3TqDEyTZs2xeLFi/H111/j999/R3JyMh48eAAfHx80a9YMPj4+Zm0cERERlR/ffvstRo8ejRs3bqBRo0aoUKGCzutNmjQxuk6TBvs6ODigWbNmaNasmSnFiYiI6HHCDGNkzNMSi0pLS8OlS5cQGRmp3adSqcpmsC8RERFZkOz0a/M0w5KGDRuG5s2bY9WqVWU/2JeIiIgsxE4G+yYnJ2PTpk2oVauW2epkIFMeKT1PjMRcJdA3V4ml2yY1V4lGYq4Sk5ZZfax+qblIZE4GopIoL6Tur8R7FzZ4mP4D9FQv952VO8+K3HlmpEjNQyN3mhepz670PDYKtk9yDhuZbZP6nSNFz/dadt2k47nnnsPJkycZyBAREZU7dtAj07t3b7z11ls4deoUGjduXGywb58+fYyuU1Ygc/HiRVy6dAkdO3aEq6urdrAOERERGU5ljsG+NhDIjB49GgAwbdq0Yq+ZOtjXpI7yv//+G2FhYahTpw569uyJW7duAQCGDx+Ot99+25QqiYiIqJzTaDSlbqYEMYCJgcxbb70FJycnXLt2DW5ubtr9/fv3x/bt201qCBERkV0TMjc7ZdKjpZ07d2LHjh14+umndfbXrl0bycnJZmkYERGR3bCTrKWSHik9bvLkyUbXaVIgk52drdMTU+TOnTtQq9WmVElERGTX7GGMzIYNG3R+fvToEa5cuQInJyeEhISUXSDToUMHfP/995g+fTqAwgE6Go0Gs2fPRpcuXUypkowhmd5s2dOrJNNALTfgW/LcUnmeMpsmlYop9KWWA/LTy6VS6xVOz1bpuX65743c1HXZ6dlSJNK35aZnS5H6ZMm9P1IN1Jf+Lbttkh97iXsr9dnS87lm+rV5HT9+vNi+rKwsDB06FC+++KJJdZoUyMyePRtdu3bFsWPHkJeXh3feeQenT5/GnTt38Ouvv5rUECIiIrslVGaY2dc2s4Y9PT0xdepU9O7dG4MHDza6vEl/uzdq1Ajnz59H+/bt8cILLyA7OxsvvfQSjh8/jpCQEFOqJCIisl9yB/ra+IDfzMxMZGZmmlTW5HlkvLy88MEHH5hanIiIiP6hgm2McZHryy+/1PlZCIFbt27hhx9+QI8ePUyq0+RA5uHDh/j9999x+/ZtaDS6DxFNmZmPiIiIyre5c+fq/Ozg4ABfX19ERERg0qRJJtVpUiCzfft2DBkyBOnp6cVeM3VmPiIiIrtlJ+nXV65cMXudJo2R+fe//41XX30Vt27dMtvMfERERPasaJkCOZs9MqlHJjU1FdHR0fD39zd3ewjKpjcXnsDCKcT60hktnr4s8wALp09LpghL5rFab3q2vtRswID0bAkWTz+WrF+CVHq2VHlbXl1bbuMkM8Mtl77N9Gvzys7OxqxZsxAfH1/i0JTLly8bXadJgcwrr7yChIQEZigRERGZg508WhoxYgT27t2LwYMHIzAw0CwLTZsUyHz11Vd49dVXsX///hKX4R43bpzshhEREdkVOwhkfv75Z2zduhXt2rUzW50mBTKrVq3Czp074eLigoSEBJ2ISqVSMZAhIiIygjnGuNjCdHje3t6oXLmyWes0abDvBx98gKlTpyIzMxNXr17FlStXtJspz7eIiIio/Js+fTomT56MnJwcs9VpUo9MXl4e+vfvDwcHCy/qQ0REROXG559/jkuXLsHf3x/BwcHFhqYkJSUZXadJgUxERATWrFmD999/35TiRERE9Dg7Gezbt29fs9dpUiBTUFCA2bNnY8eOHWjSpEmxiCo2NtYsjSMiIrIH5liiwBbmkYmJiTF7nSYFMqdOnULz5s0BAH/88YfOa+ZIpSILs/A8MRadB0dyHhaJ4paeB0YjMdeH1NNYG59nRu+pJe6N1DwzkvVLtl2qvLzzS743smqH9Dw0EvPMSDVAep4YCXo+W7LmoAEsPg+NvrarJO47Kc+kQOaXX34xdzuIiIjsl508WrIEjtYlIiKyBsIMm5H27duH3r17o0qVKlCpVPjpp59kX0ZZM7hH5qWXXkJcXBw8PT3x0ksv6T12/fr1shtGRERElpWdnY2mTZti2LBhkv+2WyuDAxkvLy/t+BcvLy+LNYiIiMjuKDQhXo8ePdCjRw95J1aYwYHM0qVLMW3aNEycOBFLly61ZJuIiIjsj5nGyGRlZensVqvVUKvVMis3n7/++gubNm3CtWvXkJeXp/OaKVnPRg32nTp1KkaPHg03NzejT0REREQlM8cSBRCFj4qefGoSExODKVOmyKzcPOLj49GnTx/UrFkTZ8+eRaNGjXD16lUIIfDMM8+YVKdRgYyQTN0kg1g4/RlSy87LHeJtyfZbuO2SqeFSnbMy05vLe3q2vpcl773EvZF67+W+t5L/iEhmCEu8N5L1y0zfLpD6Xkq8bMH0bTmp21J1F9ZvwdRzG/tnz93dHbdu3dLZZ029MZMmTcLEiRMxdepUVKxYEevWrYOfnx8GDRqE559/3qQ6jf5ngfPEEBERmZk5Mpb+Cbo8PT11NmsKZM6cOYMhQ4YAAJycnPDgwQN4eHhg2rRp+PTTT02q0+h5ZOrUqSMZzNy5c8ekxhAREdktO5hHxt3dXTsuJjAwEJcuXULDhg0BAOnp6SbVaXQgM3XqVGYtERERmZNCWUv379/HxYsXtT9fuXIFJ06cQOXKlVGtWjV5DSpB69atceDAAdSvXx89e/bE22+/jVOnTmH9+vVo3bq1SXUaHcgMGDAAfn5+Jp2MiIiIrMexY8fQpUsX7c/R0dEACheHjouLM/v5YmNjcf/+fQCFHSP379/HmjVrULt2bZPXaTQqkOH4GCIiIgtR4NFS586dyzSRp2bNmtr/dnd3x6JFi2TXyawlIiIipdnZWkt5eXm4ffs2NBrdVFVTHmcZFcg8ecJyy9Lp0dZOwdWxLb06tVTby3t69i/PfKj39eeSZuivXvYyxPpKykzPlqpf4dW1peuXl1ovXb8ES6ZvK7jytkH16ynO1a/N6/z58xg+fDgOHjyos18IAZVKhYKCAqPrNGn1ayIiIjIfFcww2NcGYq7IyEg4OTlhy5YtCAwMNMuQFQYyRERESrOTR0snTpxAYmIi6tWrZ7Y65c7xahYLFixAcHAwXFxc0KpVKxw9etSgcqtXr4ZKpULfvn0t20AiIiILK1qmwORN6QswQIMGDUyeL6Y0igcya9asQXR0NGJiYpCUlISmTZsiPDwct2/f1lvu6tWrmDhxIjp06FBGLSUiIiI5Pv30U7zzzjtISEjA33//jaysLJ3NFIoHMrGxsRg5ciQiIyPRoEEDLFq0CG5ubliyZEmpZQoKCjBo0CBMnTpVJ5WLiIjIJplxiQJrFhYWhsOHD6Nr167w8/ODt7c3vL29UalSJXh7e5tUp6JjZPLy8pCYmIhJkyZp9zk4OCAsLAyHDh0qtdy0adPg5+eH4cOHY//+/XrPkZubi9zcXO3PpkZ8REREFmMnY2R++eUXs9epaCCTnp6OgoIC+Pv76+z39/fH2bNnSyxz4MABfPfddzhx4oRB55g5cyamTp0qt6lEREQWo4L8MS62MEamU6dOZq/TprKW7t27h8GDB2Px4sXw8fExqMykSZO0Uy4DhT0yQUFBlmpimZCc60TpeW4sOQ+N1FRGMudZkT1HkNxpViw8z8xziR/rP0DGfBuAIfPMmH5yqXlmpFh6HhrJOYak6pc6QO5cKUrOQyNnDhoDTi5nnpjCA2SUJZPk5OTg2rVr2gUkizRp0sTouhQNZHx8fODo6IjU1FSd/ampqQgICCh2/KVLl3D16lX07t1bu69okj4nJyecO3cOISEhOmXUarVVLWFORERUIjt4tJSWlobIyEj8/PPPJb5uyoR4ig72dXZ2RmhoKOLj47X7NBoN4uPj0aZNm2LH16tXD6dOncKJEye0W58+fdClSxecOHHC5ntaiIjIPslOvbaRwb4TJkxARkYGjhw5AldXV2zfvh3Lli1D7dq1sWnTJpPqVPzRUnR0NCIiItCiRQu0bNkS8+bNQ3Z2NiIjIwEAQ4YMQdWqVTFz5ky4uLigUaNGOuUrVaoEAMX2ExERkXXZs2cPNm7ciBYtWsDBwQHVq1dHt27d4OnpiZkzZ6JXr15G16l4INO/f3+kpaVh8uTJSElJQbNmzbB9+3btAOBr167BwUHxLHEiIiLLsoEeFbmys7Ph5+cHAPD29kZaWhrq1KmDxo0bIykpyaQ6FQ9kACAqKgpRUVElvpaQkKC3bFxcnPkbREREVJbsJP26bt26OHfuHIKDg9G0aVN8/fXXCA4OxqJFixAYGGhSnVYRyBAREdk7e1g0cvz48bh16xYAICYmBs8//zxWrFgBZ2dnkzsmGMjYIytOYZadWm7ha5PMnpZqn8Lp2VKERIqxFH0pvlIpspKfK9npzZZN35ZKz5as39rTtyXfHj3vvURRvanbgHT6tlT9MtK7VVK/U8gor7/+uva/Q0NDkZycjLNnz6JatWoGT6vyJA4+ISIiUpodLFHw6NEjhISE4MyZM9p9bm5ueOaZZ0wOYgD2yBARESlOm0Itsw5rVqFCBTx8+NDs9bJHhoiIyBqU496YImPHjsWnn36K/Px8s9XJHhkiIiIqE7/99hvi4+Oxc+dONG7cGO7u7jqvr1+/3ug6GcgQEREpzQ4eLQGFk9i+/PLLZq2TgQwREZE1sIN5ZJYuXWr2OhnIEBERUZlKS0vDuXPnABROkufr62tyXQxkLMGC86yUC/ruj8S9sfV5ZqRIziUidy4WqfsrcX+EjPujb44ZQwjZf25aeB4aiUV7pT6bkvVL3HuLz0MjQd/7I2cOmn8q1/+yVOPlzFOjKaNuDjuZ2Tc7Oxv//ve/8f3330OjKfyF4+joiCFDhmD+/Plwc3Mzuk5mLRERESlMBTOtgG3loqOjsXfvXmzevBkZGRnIyMjAxo0bsXfvXrz99tsm1ckeGSIiIqXZUAq1HOvWrcPatWvRuXNn7b6ePXvC1dUV/fr1w8KFC42ukz0yREREVCZycnLg7+9fbL+fnx9ycnJMqpOBDBERkdKEgErmJr1emfLatGmDmJgYnRl+Hzx4gKlTp6JNmzYm1clHS0RERNbADgb7fvHFFwgPD8fTTz+Npk2bAgBOnjwJFxcX7Nixw6Q6GcgQEREpzB7WWgKARo0a4cKFC1ixYgXOnj0LAHjttdcwaNAguLq6mlQnAxlrJDeF1spTlPW2356vHQa03wxJsnKoNKafXzjIPHd5T9+WICTuvdz0bekUZ6nPrr4Xpc4t9b3VX9yS6d22EBzYGjc3N4wcOdJs9TGQISIisgbl9NHSpk2b0KNHD1SoUAGbNm3Se6yHhwfq1auHKlWqGFw/AxkiIiKlmePRknlaYnZ9+/ZFSkoK/Pz80LdvX8njHR0dMXv2bLz11lsG1c+sJSIiIrIYjUYDPz8/7X/r2x4+fIjFixdj9uzZBtfPHhkiIiJrUE4fLRnD2dkZL7/8Mn7//XeDyzCQISIiUpi9ZC0V+fPPP3Ht2jXk5eXp7O/Tpw8qVqyI2NhYg+tiIENERGQN7KBH5vLly3jxxRdx6tQpqFQqiH8y1lT/ZJYVFEisvloCBjJU9mSsfs30bJntl0xTlXhdRvulVtaWwvRty6ZvS55fzv23ZGo3YNn0bhuYLdeWjB8/HjVq1EB8fDxq1KiBo0eP4u+//8bbb7+Nzz77zKQ6GcgQEREpzF4eLR06dAh79uyBj48PHBwc4ODggPbt22PmzJkYN24cjh8/bnSdzFoiIiJSmkBh74+czUQLFixAcHAwXFxc0KpVKxw9erTUY+Pi4qBSqXQ2FxcXg89VUFCAihUrAgB8fHxw8+ZNAED16tVx7tw5k9rPHhkiIiIrILtHxYTya9asQXR0NBYtWoRWrVph3rx5CA8Px7lz57Qp00/y9PTUCTpUUo+0H9OoUSOcPHkSNWrUQKtWrTB79mw4Ozvjm2++Qc2aNY2/ALBHhoiIyG7FxsZi5MiRiIyMRIMGDbBo0SK4ublhyZIlpZZRqVQICAjQbv7+/gaf78MPP4RGUzhgbtq0abhy5Qo6dOiAbdu24csvvzTpGtgjQ0REpDSBMs9aysvLQ2JiIiZNmqTd5+DggLCwMBw6dKjUcvfv30f16tWh0WjwzDPP4JNPPkHDhg0NOmd4eLj2v2vVqoWzZ8/izp078Pb2Nqpn53HskSEiIlKYShRm9sndACArK0tny83NLfGc6enpKCgoKNaj4u/vj5SUlBLL1K1bF0uWLMHGjRuxfPlyaDQatG3bFn/99ZfJ1165cmWTgxiAPTJERETlRnZ2Nry8vHT2xcTEYMqUKWapv02bNmjTpo3257Zt26J+/fr4+uuvMX369FLLDRs2zKD69T3SKg0DGVuk9FwkcudSsSRbvzcy56yQu2icMEMNJpN6b+x9HhrJuVTkfbYlL09injLJ74a+U8t8byw5T43cz51RzJA+7e7ujlu3bunsU6vVJR7r4+MDR0dHpKam6uxPTU1FQECAQeerUKECmjdvjosXL+o9Li4uDtWrV0fz5s21k+CZCwMZIiIipZlxHhlPT0+Djnd2dkZoaCji4+O1q1JrNBrEx8cjKirKoDoKCgpw6tQp9OzZU+9xb775JlatWoUrV64gMjISr7/+OipXrmzQOaRwjAwREZHS5M4hY+JcMtHR0Vi8eDGWLVuGM2fO4M0330R2djYiIyMBAEOGDNEZDDxt2jTs3LkTly9fRlJSEl5//XUkJydjxIgRes+zYMEC3Lp1C++88w42b96MoKAg9OvXDzt27JDdQ8MeGSIiIjvVv39/pKWlYfLkyUhJSUGzZs2wfft27QDga9euwcHh//s87t69i5EjRyIlJQXe3t4IDQ3FwYMH0aBBA8lzqdVqvPbaa3jttdeQnJyMuLg4jBkzBvn5+Th9+jQ8PDxMugYGMkRERApTQbklCqKiokp9lJSQkKDz89y5czF37lzTTvQYBwcH7aKRpiwUqVOX7NYQERGRPMJMmxXLzc3FqlWr0K1bN9SpUwenTp3CV199hWvXrpncGwOwR4aIiMgqyO6RMU8zLGLMmDFYvXo1goKCMGzYMKxatQo+Pj5mqZuBjBJkpghbPTkpyJa+N9aeni1Fbvq23BRdqdPL+lVq2T8nVRqZ6dNy07dlpk9Lser0bgVTuwtPL3Fxer5Xcr8TVGjRokWoVq0aatasib1792Lv3r0lHrd+/Xqj62YgQ0REpLSi1a9l1WG9QdeQIUNkzd6rDwMZIiIihZljsK81j5GJi4uzWN0c7EtEREQ2iz0yRERESlNg9evygoEMERGRwlRmXKLA3jCQISIiUpoQgKb8Dva1JI6RISIiIpvFHpnySOm5UqTom0tF7jwpUqTarvQ8LBafh8ay90/O9cubg8awM8ghdx4aKeV6nhpLzlFjCBnz2KgKyrCXg2NkTMJAhoiISGkcI2MyBjJERESKE+V6QjxL4hgZIiIislnskSEiIlKYWdKvzdMUm8NAhoiIyBpwsK9J+GiJiIiIbBZ7ZMhoFk3Plkovlht6y0yvtnT6d7lP39ZDbre45LXLbrpl/9y16/Ruyd8pplddWIHE6/raXla9HEL+959ZS0RERKQMAfl/aMgtb6MYyBARESlMJYT8if/sdJAMx8gQERGRzWKPDBERkTVgh4xJGMgQEREpTYAz+5qIgQwREZEV4FpLpmEgYwq5KbzlvP5ynZ4thenbpbPwyuYWn9VUonmyV4WX/F7Kq16lZ4XnwgMsl+MsZH4vLb2yt757r9LYaXRgQ6xisO+CBQsQHBwMFxcXtGrVCkePHi312MWLF6NDhw7w9vaGt7c3wsLC9B5PRERk9YQwz2aHFA9k1qxZg+joaMTExCApKQlNmzZFeHg4bt++XeLxCQkJeO211/DLL7/g0KFDCAoKQvfu3XHjxo0ybjkREZF5qASg0sjc7DOOUT6QiY2NxciRIxEZGYkGDRpg0aJFcHNzw5IlS0o8fsWKFRgzZgyaNWuGevXq4dtvv4VGo0F8fHwZt5yIiIiUpmggk5eXh8TERISFhWn3OTg4ICwsDIcOHTKojpycHDx69AiVK1e2VDOJiIgsqyhriY+WjKboYN/09HQUFBTA399fZ7+/vz/Onj1rUB3vvvsuqlSpohMMPS43Nxe5ubnan7OyskxvMBERkaVwHhmTKP5oSY5Zs2Zh9erV2LBhA1xcXEo8ZubMmfDy8tJuQUFBZdxKIiIi/YqWKJC3KX0VylA0kPHx8YGjoyNSU1N19qempiIgIEBv2c8++wyzZs3Czp070aRJk1KPmzRpEjIzM7Xb9evXzdJ2IiIiUp6ij5acnZ0RGhqK+Ph49O3bFwC0A3ejoqJKLTd79mzMmDEDO3bsQIsWLfSeQ61WQ61Wm7PZ5Z+C88zInotD7uqvnIdGXv16CI2FZ3pxUPbPUUvPYyMsfQYLzmOj5Bw2BpXW970vs3En5hjjYp9dMopPiBcdHY2IiAi0aNECLVu2xLx585CdnY3IyEgAwJAhQ1C1alXMnDkTAPDpp59i8uTJWLlyJYKDg5GSkgIA8PDwgIeHh2LXQUREZDIN5P8hJre8jVI8kOnfvz/S0tIwefJkpKSkoFmzZti+fbt2APC1a9fg4PD/4fLChQuRl5eHV155RaeemJgYTJkypSybTkREZDZye0Qt2aNqzRQPZAAgKiqq1EdJCQkJOj9fvXrV8g0iIiIim2AVgQwREZFdM8c8MOyRISIiIsVwsK9JbHoeGSIiIrJv7JGxRRZOj1by/HIHqzF928Lp2zLOb+mBiBZP75Zi4fRvyftn8e+9xMtyzi/7cy+zuJ70cFVBGfVyCDBryUQMZIiIiBRWNDuvLPb5ZImPloiIiKyCQotGLliwAMHBwXBxcUGrVq1w9OhRM1+YZTGQISIislNr1qxBdHQ0YmJikJSUhKZNmyI8PBy3b99WumkGYyBDRESkNLP0xhjfIxMbG4uRI0ciMjISDRo0wKJFi+Dm5oYlS5aY/xothIEMERGR0swRyPzzaCkrK0tny83NLfGUeXl5SExMRFhYmHafg4MDwsLCcOjQoTK5bHNgIENERKS0oqwlmVt2dja8vLx0tqK1Cp+Unp6OgoIC7ZJARfz9/bXrGNoCZi0RERGVE+7u7rh165bOPrVarVBrygYDmfJI8fkmZOQAymybzc9DI0WqD1XBeWLK5Px6KDyLjPLz2EiNj7Bw/7us757c753crGV95y/Dj7S5Fo309PQ06HgfHx84OjoiNTVVZ39qaioCAgJktaUs8dESERGR0hRIvXZ2dkZoaCji4+O1+zQaDeLj49GmTRtzXp1FsUeGiIjITkVHRyMiIgItWrRAy5YtMW/ePGRnZyMyMlLpphmMgQwREZHSBACNzOdYJpTv378/0tLSMHnyZKSkpKBZs2bYvn17sQHA1oyBDBERkdJkzMyrU4cJoqKiEBUVJe/cCmIgQ0REZA0UCmRsHQf7EhERkc1ij4wlKJ3+LMWa2yf3LwqF07elML27/JL87Cj9vS/Q/7Lsz6YsMj9XMv8k1/feqTSW/tL9wxyPlux0+WsGMkREREozy2Bfs7TE5jCQISIiUpwGEDIjEbnlbRTHyBAREZHNYo8MERGR0gSYtWQiBjJERERKE0L+GBk7DWT4aImIiIhsFntklGDtaZoKp0DLYuVtt3R6txTJFFtrHito66nhVv69l/3ZVLL9EqnlUqxi9WuzPFoyS0tsDgMZIiIixSm3RIGtYyBDRESkNHMN9lW4Q18JHCNDRERENos9MkREREoTGkDucghCY5c9MgxkiIiIrAEH+5qEgQwREZHSzLFopJ0O9uUYGSIiIrJZ7JGxRlY+34QkS/5VYOlrt/a/aGRev9Lz2MghNFb+uZdN4r2x9j87bfh7r+97oZI7266hzLH6tQ1/v+VgIENERKQ0ISBkrl4tt7ytsvYYn4iIiKhU7JEhIiJSmjkWjbTPDhkGMkRERMpj1pKpGMgQEREpTSPMMyGeHeIYGSIiIrJZ7JGxRbaeni2H0l2nSt9bpa/fkiTurS2njptFgf6XhdKfTYtS8L0vKMNz89GSSRjIEBERKUwIASH30VJZzXljZRjIEBERKc0cSxTY6WJLHCNDRERENos9MkREREozxxIFfLREREREihAa+enTdjrYl4+WiIiIyGaxR4aIiEhpAhAyHw0JO+2RYSBTHin9YS7P81kofW+tnZz3nvdWFsXn2Smn3/uyu6/CDI+W7HNmXwYyRERECiucR4Y9MqbgGBkiIiKyWeyRISIiUpoQAPhoyRQMZIiIiBS04doGoAZw4YWTsuoRRwFcMU+bbAkfLRERESno9s+3gb8AcdP0OsRDAInA7h92m61dtoKBDBERkYJ8fX2BZwD8KiN5LxGAH9C1a1cztsw28NESmZ+djpw3C1tPYeV7b7/K63svd0VqA2XsyEClgEpAMoBg48qKbADHgcMHDpu/YTaAPTJEREQK8/LyAloAOGhCTPgbgGpAq1atLNAy68dAhoiIyArk7MwBsgFcNLyMyARwCji18ZSlmmX1GMgQERFZAVdXVyz8bGFhr4yhT7SOAKgNNGrUyJJNs2oMZIiIiKzE8OHDC6eTOSN9rPgbwDng0tZLlm6WVWMgQ0REZCUqVKiA5QuWA4cBkS9x8CEADYGaNWuWRdOsFgMZIiIiKzJgwADAGcAfpR8jUgFcBW78fKOMWmW9bDaQWbBgAYKDg+Hi4oJWrVrh6NGjSjeJSD4huHHjZm1bGXN0dMTGJRuBo4DIK+WgXwE0BapUqVKWTbNKNhnIrFmzBtHR0YiJiUFSUhKaNm2K8PBw3L59W+mmERERyda7d2/AE8CJ4q+J6wBSgPQd6WXcKutkk4FMbGwsRo4cicjISDRo0ACLFi2Cm5sblixZonTTiIiIZFOpVNizcg9wDIXLD/xDCAAHAYQCTz31lFLNsyo2F8jk5eUhMTERYWFh2n0ODg4ICwvDoUOHih2fm5uLrKwsnY2IiMjadenSBQgAcOyxnVcAZABZO/hvWRGbC2TS09NRUFAAf39/nf3+/v5ISUkpdvzMmTPh5eWl3YKCgsqqqURERLIcXXsUOAGI7Md6Y1oCFStWVLhl1sPmAhljTZo0CZmZmdrt+vXrSjeJiIjIIM8++yxQHcBRAOcA5AIPtj9QuFXWxeYWjfTx8YGjoyNSU1N19qempiIgIKDY8Wq1Gmq1uqyaR0REZFZ/bPwDjZo2Ai4D3879Fi4uLko3yarYXCDj7OyM0NBQxMfHo2/fvgAAjUaD+Ph4REVFSZYX/6TS5RfkWrKZRERUDhT9WyEUSMMu0rBhQ6AugBQgIiJCsXZYK5sLZAAgOjoaERERaNGiBVq2bIl58+YhOzsbkZGRkmXv3bsHANh7/itLN5OIiMqJe/fuFa5QrRBxWrlAytrZZCDTv39/pKWlYfLkyUhJSUGzZs2wffv2YgOAS1KlShVcv34dFStWhEqlQlZWFoKCgnD9+nV4enqWQevLB9430/C+mYb3zXi8Z6Z58r4JIXDv3j1OPGfFVELJ/jIrkJWVBS8vL2RmZvLLbgTeN9PwvpmG9814vGem4X2zPeU+a4mIiIjKLwYyREREZLPsPpBRq9WIiYlhiraReN9Mw/tmGt434/GemYb3zfbY/RgZIiIisl123yNDREREtouBDBEREdksBjJERERksxjIEBERkc2y+0BmwYIFCA4OhouLC1q1aoWjR48q3SSrYcy9Wbx4MTp06ABvb294e3sjLCzMbu+lqZ+p1atXQ6VSadcQsyfG3rOMjAyMHTsWgYGBUKvVqFOnDrZt21ZGrbUext63efPmoW7dunB1dUVQUBDeeustPHz4sIxaa9327duH3r17o0qVKlCpVPjpp5+UbhIZStix1atXC2dnZ7FkyRJx+vRpMXLkSFGpUiWRmpqqdNMUZ+y9GThwoFiwYIE4fvy4OHPmjBg6dKjw8vISf/31Vxm3XFmmfqauXLkiqlatKjp06CBeeOGFsmmslTD2nuXm5ooWLVqInj17igMHDogrV66IhIQEceLEiTJuubKMvW8rVqwQarVarFixQly5ckXs2LFDBAYGirfeequMW26dtm3bJj744AOxfv16AUBs2LBB6SaRgew6kGnZsqUYO3as9ueCggJRpUoVMXPmTAVbZR3k3pv8/HxRsWJFsWzZMks10SqZct/y8/NF27ZtxbfffisiIiLsLpAx9p4tXLhQ1KxZU+Tl5ZVVE62Ssfdt7Nix4rnnntPZFx0dLdq1a2fRdtoiBjK2xW4fLeXl5SExMRFhYWHafQ4ODggLC8OhQ4cUbJnyzHFvcnJy8OjRI1SuXNlSzbQ6pt63adOmwc/PD8OHDy+LZloVU+7Zpk2b0KZNG4wdOxb+/v5o1KgRPvnkExQUFJRVsxVnyn1r27YtEhMTtY+fLl++jG3btqFnz55l0mYiS7HJ1a/NIT09HQUFBcVWzPb398fZs2cVapV1MMe9effdd1GlShWdX7TlnSn37cCBA/juu+9w4sSJMmih9THlnl2+fBl79uzBoEGDsG3bNly8eBFjxozBo0ePEBMTUxbNVpwp923gwIFIT09H+/btIYRAfn4+Ro8ejffff78smkxkMXbbI0OWM2vWLKxevRobNmyAi4uL0s2xWvfu3cPgwYOxePFi+Pj4KN0cm6HRaODn54dvvvkGoaGh6N+/Pz744AMsWrRI6aZZtYSEBHzyySf473//i6SkJKxfvx5bt27F9OnTlW4akSx22yPj4+MDR0dHpKam6uxPTU1FQECAQq2yDnLuzWeffYZZs2Zh9+7daNKkiSWbaXWMvW+XLl3C1atX0bt3b+0+jUYDAHBycsK5c+cQEhJi2UYrzJTPWmBgICpUqABHR0ftvvr16yMlJQV5eXlwdna2aJutgSn37aOPPsLgwYMxYsQIAEDjxo2RnZ2NUaNG4YMPPoCDA/+uJdtkt59cZ2dnhIaGIj4+XrtPo9EgPj4ebdq0UbBlyjP13syePRvTp0/H9u3b0aJFi7JoqlUx9r7Vq1cPp06dwokTJ7Rbnz590KVLF5w4cQJBQUFl2XxFmPJZa9euHS5evKgN+gDg/PnzCAwMtIsgBjDtvuXk5BQLVoqCQcEl98iWKT3aWEmrV68WarVaxMXFiT///FOMGjVKVKpUSaSkpCjdNMVJ3ZvBgweL9957T3v8rFmzhLOzs1i7dq24deuWdrt3755Sl6AIY+/bk+wxa8nYe3bt2jVRsWJFERUVJc6dOye2bNki/Pz8xMcff6zUJSjC2PsWExMjKlasKFatWiUuX74sdu7cKUJCQkS/fv2UugSrcu/ePXH8+HFx/PhxAUDExsaK48ePi+TkZKWbRhLsOpARQoj58+eLatWqCWdnZ9GyZUtx+PBhpZtkNfTdm06dOomIiAjtz9WrVxcAim0xMTFl33CFGXPfnmSPgYwQxt+zgwcPilatWgm1Wi1q1qwpZsyYIfLz88u41coz5r49evRITJkyRYSEhAgXFxcRFBQkxowZI+7evVv2DbdCv/zyS4m/w/R9X8k6qIRgnyIRERHZJrsdI0NERES2j4EMERER2SwGMkRERGSzGMgQERGRzWIgQ0RERDaLgQwRERHZLAYyREREZLMYyBAREZHNYiBDZAGdO3fGhAkTyuRcHTt2xMqVK00qe/HiRfj7+8PNzQ2//vqr2do0ZcoUNGvWTO8xlrxHixYt0lmMk4jKLwYyRCYYOnQoVCpVse3ixYtl2o5NmzYhNTUVAwYMMLrszZs30a1bN7Rv3x7Dhw/Hv/71L5w6dUrnmEePHuHdd99F48aN4e7ujipVqmDIkCG4efNmsfoePHgAd3f3Mr8HJRk2bBiSkpKwf/9+pZtCRBbmpHQDiGzV888/j6VLl+rs8/X1LdM2fPnll4iMjCy2qrGUu3fvIjw8HB06dMDSpUvh6OgIDw8PhIeH49dff0WNGjUAFK6YnJSUhI8++ghNmzbF3bt3MX78ePTp0wfHjh3TqXPXrl2oXr06atWqZbbrM5YQAgUFBXB2dsbAgQPx5ZdfokOHDoq1h4gsjz0yRCZSq9UICAjQ2RwdHUs8VqVS4aefftLZV6lSJcTFxQEAvv/+e3h4eODChQva18eMGYN69eohJyenxDrT0tKwZ8+eYo9QMjIyMGLECPj6+sLT0xPPPfccTp48qX09JycHvXr1Qrt27bBs2TJtm2fOnImxY8eie/fuuH37NgDAy8sLu3btQr9+/VC3bl20bt0aX331FRITE3Ht2jWd827cuBF9+vTR2ffDDz8gODgYXl5eGDBgAO7du6fzen5+PqKiouDl5QUfHx989NFHeHz5tx9++AEtWrRAxYoVERAQgIEDB2rbBgAJCQlQqVT4+eefERoaCrVajQMHDgAAevfujU2bNuHBgwcl3j8iKh8YyBBZgSFDhqBnz54YNGgQ8vPzsXXrVnz77bdYsWIF3NzcSixz4MABuLm5oX79+jr7X331Vdy+fRs///wzEhMT8cwzz6Br1664c+cOAMDNzQ0HDx7EokWLoFKpdMp+8MEHuHDhAvz8/Epta2ZmJlQqFSpVqqTdp9FosGXLFrzwwgvafZcuXcJPP/2ELVu2YMuWLdi7dy9mzZqlU9eyZcvg5OSEo0eP4osvvkBsbCy+/fZb7euPHj3C9OnTcfLkSfz000+4evUqhg4dWqxN7733HmbNmoUzZ86gSZMmAIAWLVogPz8fR44cKfVaiMj28dESkYm2bNkCDw8P7c89evTAjz/+aHJ9X3/9NZo0aYJx48Zh/fr1mDJlCkJDQ0s9Pjk5Gf7+/jqPlQ4cOICjR4/i9u3bUKvVAIDPPvsMP/30E9auXYtRo0aZ3D4AePjwId5991289tpr8PT01O4/fPgwAKBVq1bafRqNBnFxcahYsSIAYPDgwYiPj8eMGTO0xwQFBWHu3LlQqVSoW7cuTp06hblz52LkyJEACse6FKlZsya+/PJLPPvss7h//77OvZ82bRq6deum01Y3Nzd4eXkhOTlZ1jUTkXVjIENkoi5dumDhwoXan93d3WXV5+3tje+++w7h4eFo27Yt3nvvPb3HP3jwAC4uLjr7Tp48ifv37+Opp54qduylS5dkte/Ro0fo168fhBA61w0UPlb617/+pRNUBQcHa4MYAAgMDNR5LAQArVu31ukVatOmDT7//HMUFBTA0dERiYmJmDJlCk6ePIm7d+9Co9EAAK5du4YGDRpoy7Vo0aLENru6upb6aI6IygcGMkQmcnd3N3hgq0ql0hn7ARQGBk/at28fHB0dcevWLWRnZ+sEAk/y8fHB3bt3dfbdv38fgYGBSEhIKHb844+CjFUUxCQnJ2PPnj06vTFAYfbUk4+NKlSooPOzSqXSBiKGyM7ORnh4OMLDw7FixQr4+vri2rVrCA8PR15ens6xpQWRd+7cKfMB2ERUtjhGhqgM+Pr64tatW9qfL1y4UKyn4ODBg/j000+xefNmeHh4ICoqSm+dzZs3R0pKik4w88wzzyAlJQVOTk6oVauWzubj42NS24uCmAsXLmD37t3FensuXLiA5OTkYo92DPHk+JXDhw+jdu3acHR0xNmzZ/H3339j1qxZ6NChA+rVq1esR0efS5cu4eHDh2jevLnR7SIi28FAhqgMPPfcc/jqq69w/PhxHDt2DKNHj9bpsbh37x4GDx6McePGoUePHlixYgXWrFmDtWvXllpn8+bN4ePjozORXVhYGNq0aYO+ffti586duHr1Kg4ePIgPPvigWLq0IR49eoRXXnkFx44dw4oVK1BQUICUlBSkpKRoe0U2btyIsLCwUgcl63Pt2jVER0fj3LlzWLVqFebPn4/x48cDAKpVqwZnZ2fMnz8fly9fxqZNmzB9+nSD696/fz9q1qyJkJAQo9tFRLaDgQxRGfj8888RFBSEDh06YODAgZg4caLOP/zjx4+Hu7s7PvnkEwBA48aN8cknn+CNN97AjRs3SqzT0dERkZGRWLFihXafSqXCtm3b0LFjR0RGRqJOnToYMGCAdmCwsW7cuIFNmzbhr7/+QrNmzRAYGKjdDh48CKDktGtDDRkyBA8ePEDLli0xduxYjB8/Xjsg2dfXF3Fxcfjxxx/RoEEDzJo1C5999pnBda9atUo7aJiIyi+VePLBPRHZjJSUFDRs2BBJSUmoXr16mZ8/PT0dgYGB+Ouvv0wKlCzl9OnTeO6553D+/Hl4eXkp3RwisiD2yBDZsICAAHz33XfFJqcrK3fu3EFsbKxVBTEAcOvWLXz//fcMYojsAHtkiIiIyGaxR4aIiIhsFgMZIiIislkMZIiIiMhmMZAhIiIim8VAhoiIiGwWAxkiIiKyWQxkiIiIyGYxkCEiIiKbxUCGiIiIbNb/AUZnRI173WT0AAAAAElFTkSuQmCC", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "ds = dataset_with_outliers_generator(new_data_set('data_with_outliers'),\n", " low_outlier=-3,\n", " high_outlier=3,\n", " background_noise=False)\n", "ax, cb = plot_dataset(ds, auto_color_scale=True, cutoff_percentile=(0,5))" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Defaults and customizing the auto color scaling\n", "The defaults used by `plot_dataset` can be set in the `qcodesrc.json` files. The system default is described in `qcodes/config/qcodesrc.json` ([online](https://github.com/QCoDeS/Qcodes/blob/main/qcodes/config/qcodesrc.json))\n", "To override the default edit these values in your custom `qcodesrc.json` file in your home directory.\n", "\n", "The defaults are (for detailed description see the schema file)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "```\n", "\"auto_color_scale\":{\n", " \"enabled\": false,\n", " \"cutoff_percentile\": [0.5, 0.5],\n", " \"color_over\": \"white\",\n", " \"color_under\": \"gray\"\n", "}\n", "```" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Because of the possible risks due to auto color scaling it is deactivated by default. Please remember to change the colors marking the outliers in case you should use a color map the includes white and gray." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Using auto color scaling in custom plotting\n", "If you are using matplotlib but do not want to rely on `plot_dataset`, you can simply call:\n", "`qcodes.utils.plotting.apply_auto_color_scale(colorbar, ...)` and provide any matplotlib color bar to achieve the described effects.\n", "\n", "If you want to use the qcodes config system for defaults call\n", "`qcodes.utils.plotting.auto_color_scale_from_config(colorbar,...)` instead." ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [] } ], "metadata": { "kernelspec": { "display_name": "Python 3 (ipykernel)", "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.11.5" }, "toc": { "base_numbering": 1, "nav_menu": {}, "number_sections": true, "sideBar": true, "skip_h1_title": false, "title_cell": "Table of Contents", "title_sidebar": "Contents", "toc_cell": false, "toc_position": { "height": "1225px", "left": "1336px", "top": "111.133px", "width": "227px" }, "toc_section_display": true, "toc_window_display": true } }, "nbformat": 4, "nbformat_minor": 4 }