{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "5f6f8760",
   "metadata": {},
   "source": [
    "# Defining common integrated photonic components"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "a0655b15",
   "metadata": {},
   "source": [
    "This notebook contains predefined functions used to construct commonly used photonic integrated circuit (PIC) components, including straight waveguide, linear taper, ring, race track, s-bend, circular bend, and directional coupler. \n",
    "\n",
    "These components are defined using the [Photonforge](https://docs.flexcompute.com/projects/photonforge/en/latest/) library (`pf.Path`) as it offers a convenient and flexible way to construct curved paths with variable width. Each path is converted to a polygon via `path.to_polygon().vertices` and used to instantiate a Tidy3D [PolySlab](https://docs.flexcompute.com/projects/tidy3d/en/latest/api/_autosummary/tidy3d.PolySlab.html), which is then wrapped into a [Structure](https://docs.flexcompute.com/projects/tidy3d/en/latest/api/_autosummary/tidy3d.Structure.html). Users can directly copy these predefined functions to their own scripts and use them in building simulations. More importantly, users can learn the workflow from these examples and build their own Tidy3D Structures using the same principles.\n",
    "\n",
    "PhotonForge also provides a complete set of tools for photonic design automation, including **PDK integration, parametric components, connectivity management, and technology definitions**. You can check the many applications of this powerful tool [here](https://docs.flexcompute.com/projects/photonforge/en/latest/examples.html)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "id": "327ff859",
   "metadata": {},
   "outputs": [],
   "source": [
    "import matplotlib.pyplot as plt\n",
    "import numpy as np\n",
    "import photonforge as pf\n",
    "import tidy3d as td"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "c507c933",
   "metadata": {},
   "source": [
    "## Straight Waveguide "
   ]
  },
  {
   "cell_type": "markdown",
   "id": "4b5b614d",
   "metadata": {},
   "source": [
    "Straight strip waveguides are the most fundamental building block of any PIC. The function `straight_waveguide` returns a Tidy3D [Structure](https://docs.flexcompute.com/projects/tidy3d/en/latest/api/_autosummary/tidy3d.Structure.html) of a straight waveguide. The waveguide is specified by the starting position and the ending position. It only supports waveguides parallel to the $xy$ plane."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "id": "525d359d",
   "metadata": {},
   "outputs": [],
   "source": [
    "def straight_waveguide(x0, y0, z0, x1, y1, wg_width, wg_thickness, medium, sidewall_angle=0):\n",
    "    \"\"\"\n",
    "    This function defines a straight strip waveguide and returns the tidy3d structure of it.\n",
    "\n",
    "    Parameters\n",
    "    ----------\n",
    "    x0: x coordinate of the waveguide starting position (um)\n",
    "    y0: y coordinate of the waveguide starting position (um)\n",
    "    z0: z coordinate of the waveguide starting position (um)\n",
    "    x1: x coordinate of the waveguide end position (um)\n",
    "    y1: y coordinate of the waveguide end position (um)\n",
    "    wg_width: width of the waveguide (um)\n",
    "    wg_thickness: thickness of the waveguide (um)\n",
    "    medium: medium of the waveguide\n",
    "    sidewall_angle: side wall angle of the waveguide (rad)\n",
    "    \"\"\"\n",
    "\n",
    "    # Define the path from (x0, y0) to (x1, y1)\n",
    "    path = pf.Path(origin=(x0, y0), width=wg_width)\n",
    "    path.segment((x1, y1))\n",
    "\n",
    "    # Define geometry as a PolySlab directly from the path vertices\n",
    "    wg_geo = td.PolySlab(\n",
    "        vertices=path.to_polygon().vertices,\n",
    "        axis=2,\n",
    "        slab_bounds=(z0 - wg_thickness / 2, z0 + wg_thickness / 2),\n",
    "        sidewall_angle=sidewall_angle,\n",
    "    )\n",
    "\n",
    "    # Define tidy3d structure\n",
    "    wg = td.Structure(geometry=wg_geo, medium=medium)\n",
    "\n",
    "    return wg"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "id": "8fa68089",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAygAAAHWCAYAAACc862xAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjYuMCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy89olMNAAAACXBIWXMAAA9hAAAPYQGoP6dpAABVYElEQVR4nO3de3zP9f//8ft7sgM7GDYzW45lTkOMiJzm9JFMRYkcPuKbQ5Ffn0r1wZzGh9DnI1SfmEiFwidyZtOSHEoOSRRiaIjNqU3b6/eHz94fb9vsYHu/3u/3btfL5X2pvd7P1+v9eL1f9d77sef99XpZDMMwBAAAAAAOwM3sAgAAAAAgEw0KAAAAAIdBgwIAAADAYdCgAAAAAHAYNCgAAAAAHAYNCgAAAACHQYMCAAAAwGHQoAAAAABwGDQoAAAAABwGDQqcVlxcnCwWi+Li4swuBQAAAIWEBgUOb86cOYqNjTW7jAJZsmSJZs2aZXYZkqRJkybp0UcfVYUKFWSxWDRu3Lh8rZ+amqpXXnlFwcHB8vLyUtOmTbVx48Zsx27fvl0tWrRQqVKlFBQUpBdeeEFXrlwphL0AAACuzmIYhmF2EcCd1K1bV+XLl88yU5KRkaG0tDS5u7vLzc0xe+1HHnlEBw4c0PHjx80uRRaLRUFBQapfv77Wr1+vsWPH5qtJ6dWrl5YvX66RI0fqvvvuU2xsrHbt2qWtW7eqRYsW1nF79+5Vs2bNVKtWLQ0ePFinTp3S9OnT1aZNG61du7YI9gwAALiSe8wuAHlz9epVlS5d2uwyHIqbm5s8PT3NLsNpHDt2TFWqVNH58+cVEBCQr3V37typjz/+WNOmTdNLL70kSerbt6/q1q2rl19+Wdu3b7eOfe211+Tv76+4uDj5+vpKkqpUqaJBgwZpw4YN6tChQ+HtFAAAcDmO+WdnF5eYmKiBAwcqODhYHh4eqlq1qoYMGaK0tDRJUmxsrCwWi+Lj4zV06FAFBgYqJCTEuv6cOXNUp04deXh4KDg4WMOGDdOlS5dsXuPIkSN6/PHHFRQUJE9PT4WEhOipp55ScnKydczGjRvVokULlSlTRt7e3qpZs6Zee+21XOvPy3qpqakaO3asatSoIQ8PD4WGhurll19Wampqlu0tXrxYTZo0UalSpeTv76+HH35YGzZskHTzi+3BgwcVHx8vi8Uii8Wi1q1bS8r5HJRly5apUaNG8vLyUvny5dWnTx8lJibajOnfv7+8vb2VmJioqKgoeXt7KyAgQC+99JLS09NzfQ9WrVqlLl26WI9h9erVNWHCBJt1W7durTVr1ujEiRPW2qtUqZLjNvv3728dd/sjv3Gs7NzptXOzfPlylShRQoMHD7Yu8/T01MCBA/X111/r5MmTkqSUlBRt3LhRffr0sTYn0s1mxtvbW0uXLi1wDQAAoHhgBsXOTp8+rSZNmujSpUsaPHiwwsLClJiYqOXLl+vatWtyd3e3jh06dKgCAgI0ZswYXb16VZI0btw4RUdHKzIyUkOGDNHhw4c1d+5c7dq1S1999ZVKliyptLQ0dezYUampqXr++ecVFBSkxMRErV69WpcuXZKfn58OHjyoRx55ROHh4Ro/frw8PDx09OhRffXVV3esPy/rZWRk6NFHH1VCQoIGDx6sWrVqaf/+/Zo5c6Z++uknrVy50jo2Ojpa48aNU/PmzTV+/Hi5u7vrm2++0ZYtW9ShQwfNmjVLzz//vLy9vfX6669LkipUqJBjfbGxsRowYIAiIiIUExOj3377TW+99Za++uorfffddypTpox1bHp6ujp27KimTZtq+vTp2rRpk958801Vr15dQ4YMueP7EBsbK29vb40aNUre3t7asmWLxowZo5SUFE2bNk2S9Prrrys5OVmnTp3SzJkzJUne3t45bvP//u//FBkZabNs3bp1+vDDDxUYGGhddv78+TvWlsnHx0ceHh55Gpub7777Tvfff79N0yFJTZo0kXQz1hUaGqr9+/frzz//VOPGjW3Gubu7q0GDBvruu+8KpR4AAODCDNhV3759DTc3N2PXrl1ZnsvIyDAMwzAWLFhgSDJatGhh/Pnnn9bnk5KSDHd3d6NDhw5Genq6dfns2bMNScb8+fMNwzCM7777zpBkLFu2LMc6Zs6caUgyzp07l6/687LeokWLDDc3N+PLL7+0WT5v3jxDkvHVV18ZhmEYR44cMdzc3Izu3bvb7I9h/O+9MAzDqFOnjtGqVassr7N161ZDkrF161bDMAwjLS3NCAwMNOrWrWtcv37dOm716tWGJGPMmDHWZf369TMkGePHj7fZZsOGDY1GjRrd+U0wDOPatWtZlv3f//2fUapUKeOPP/6wLuvSpYtRuXLlXLeXnSNHjhh+fn5G+/btbf47kJSnx4IFC7Ld7rlz5wxJxtixY/NcS506dYy2bdtmWX7w4EFDkjFv3jzDMAxj2bJlhiRj27ZtWcb26NHDCAoKyvNrAgCA4omIlx1lZGRo5cqV6tq1a5a/MEs3T2K+1aBBg1SiRAnrz5s2bVJaWppGjhxpc1L4oEGD5OvrqzVr1kiS/Pz8JEnr16/XtWvXsq0lcyZh1apVysjIyPM+5GW9ZcuWqVatWgoLC9P58+etj7Zt20qStm7dKklauXKlMjIyNGbMmCwnud/+XuTF7t27lZSUpKFDh9qcm9KlSxeFhYVZ359bPffcczY/t2zZUr/88kuur+Xl5WX998uXL+v8+fNq2bKlrl27ph9//DHftd/u6tWr6t69u/z9/fXRRx/Z/HewcePGPD06dux413Vkun79erazMZnv8/Xr123+mdPYzOcBAAByQsTLjs6dO6eUlBTVrVs3T+OrVq1q8/OJEyckSTVr1rRZ7u7urmrVqlmfr1q1qkaNGqUZM2boww8/VMuWLfXoo4+qT58+1ublySef1L///W89++yzevXVV9WuXTs99thjeuKJJ+54Ray8rHfkyBEdOnQoxxOxk5KSJEk///yz3NzcVLt27Ty9H7nJ6f2RpLCwMCUkJNgs8/T0zFKjv7+/Ll68mOtrHTx4UG+88Ya2bNmilJQUm+duPc+noAYNGqSff/5Z27dvV7ly5Wyeuz0GZg9eXl7Znj/0xx9/WJ+/9Z85jb21sQMAAMgODYoDu5svc2+++ab69++vVatWacOGDXrhhRcUExOjHTt2KCQkRF5eXtq2bZu2bt2qNWvWaN26dfrkk0/Utm1bbdiwweYv9rfXlNt6GRkZqlevnmbMmJHtNkJDQwu8X4Upp33MzaVLl9SqVSv5+vpq/Pjxql69ujw9PfXtt9/qlVdeydeMVHbeeustffTRR1q8eLEaNGiQ5fmzZ8/maTt+fn6F1hBUrFgxy4UGJOnMmTOSpODgYOu4W5ffPjZzHAAAQE6IeNlRQECAfH19deDAgQKtX7lyZUnS4cOHbZanpaXp2LFj1ucz1atXT2+88Ya2bdumL7/8UomJiZo3b571eTc3N7Vr104zZszQDz/8oEmTJmnLli3WCFZOcluvevXq+v3339WuXTtFRkZmeWTOcFSvXl0ZGRn64Ycf7vh6eY175fT+ZC67/f0pqLi4OF24cEGxsbEaMWKEHnnkEUVGRsrf3z/L2PxG1b788ku99NJLGjlypHr37p3tmIoVK+bp8cknnxRo/7LToEED/fTTT1lmi7755hvr89LNe9bcc8892r17t824tLQ07d27N9uGCwAA4FY0KHbk5uamqKgoff7551m+wEmSkcs9MyMjI+Xu7q5//vOfNmPff/99JScnq0uXLpJuXur1zz//tFm3Xr16cnNzs0Zvfv/99yzbz/zymF08J1Ne1uvZs6cSExP13nvvZRl7/fp16xXJoqKi5ObmpvHjx2eZdbh1/0qXLp3lMsrZady4sQIDAzVv3jybfVi7dq0OHTpkfX/uVubMy601pqWlac6cOVnGli5dOs+RrzNnzqhnz55q0aKF9Upg2Snqc1DOnz+vH3/80eb8pSeeeELp6el69913rctSU1O1YMECNW3a1Dor5ufnp8jISC1evFiXL1+2jl20aJGuXLmiHj16FKgmAABQfBDxsrPJkydrw4YNatWqlfUSvGfOnNGyZcuUkJBgcxnc2wUEBGj06NGKjo5Wp06d9Oijj+rw4cOaM2eOIiIi1KdPH0nSli1bNHz4cPXo0UP333+//vzzTy1atEglSpTQ448/LkkaP368tm3bpi5duqhy5cpKSkrSnDlzFBISYnNX8NvlZb1nnnlGS5cu1XPPPaetW7fqoYceUnp6un788UctXbpU69evV+PGjVWjRg29/vrrmjBhglq2bKnHHntMHh4e2rVrl4KDgxUTEyNJatSokebOnauJEyeqRo0aCgwMtJ5wf6uSJUtq6tSpGjBggFq1aqVevXpZLzNcpUoVvfjiiwU9bDaaN28uf39/9evXTy+88IIsFosWLVqUbYPZqFEjffLJJxo1apQiIiLk7e2trl27ZrvdF154QefOndPLL7+sjz/+2Oa58PBwhYeHSyr4OSiLFi3SiRMnrI3Htm3bNHHiREk3j1nmDNPs2bMVHR2trVu3Wu8507RpU/Xo0UOjR49WUlKSatSooYULF+r48eN6//33bV5n0qRJat68ufW/8VOnTunNN99Uhw4d1KlTpwLVDgAAihFTryFWTJ04ccLo27evERAQYHh4eBjVqlUzhg0bZqSmphqG8b/LDGd3KWLDuHlZ4bCwMKNkyZJGhQoVjCFDhhgXL160Pv/LL78Yf/3rX43q1asbnp6eRtmyZY02bdoYmzZtso7ZvHmz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kiVLbGbMn3vuOT333HOaM2eOJk6cKA8PD7Vv316VKlXSxYsXc60903vvvac6depo4MCBWr16tfr166egoCDNmDHDZlzDhg114sSJXLc3duxYjRs3Lsfnjx49qs8++0w9evSw/neWkzNnzqhChQqyWCw2yytWrCjpZvOdOe7W5beP/f3335WamioPD49c64d9EPECigDRLgDOICMjQytXrlTXrl2z/evy7V/8Bg0aZPOlcdOmTUpLS9PIkSNtvswPGjRIvr6+WrNmjSTJz89PkrR+/Xpdu3Yt21oyZxJWrVqljIyMPO9DXtZbtmyZatWqpbCwMJ0/f976aNu2rSRp69atkqSVK1cqIyNDY8aMyXKS++3vRV7s3r1bSUlJGjp0qLU5kaQuXbooLCzM+v7c6rnnnrP5uWXLlvrll19yfa1bP/MvX76s8+fPq2XLlrp27Zp+/PHHfNeeKSgoSG+//bY2btyoli1bau/evZo/f36W8/I+/PBDbdy4MddH3745Xyzm2rVr6tGjh7y8vDRlypRca7t+/Xq2TUXme339+nWbf+ZlLBwDMyhAISPaBcBZnDt3TikpKapbt26exletWtXm58y/mNesWdNmubu7u6pVq2Z9vmrVqho1apRmzJihDz/8UC1bttSjjz6qPn36WJuXJ598Uv/+97/17LPP6tVXX1W7du302GOP6YknnrjjFbHyst6RI0d06NAhBQQEZLuNpKQkSdLPP/8sNzc31a5dO0/vR25yen+km7NMCQkJNss8PT2z1Ojv76+LFy/m+loHDx7UG2+8oS1btiglJcXmuVvP8ymIp556SosXL9aaNWs0ePBgtWvXLsuYhx566K5eIz09XU899ZR++OEHrV27VsHBwbmu4+Xlle05RH/88Yf1+Vv/mZexcAw0KEAhItoFwJXdzZe4N998U/3799eqVau0YcMGvfDCC4qJidGOHTsUEhIiLy8vbdu2TVu3btWaNWu0bt06ffLJJ2rbtq02bNiQY9wnL+tlZGSoXr16WWJJmUJDQwu8X4Upt0hTTi5duqRWrVrJ19dX48ePV/Xq1eXp6alvv/1Wr7zySr5mpLJz4cIF7d69W5L0ww8/KCMjI0vTeO7cuTydg+Lt7Z3teS+DBg3S6tWr9eGHH1pntnJTsWJFbd26VYZh2MxwZUa6MpuczGhX5vJbnTlzRmXLliXe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",
      "text/plain": [
       "<Figure size 1000x500 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "Si = td.material_library[\"cSi\"][\"Li1993_293K\"]\n",
    "\n",
    "wg = straight_waveguide(\n",
    "    x0=1,\n",
    "    y0=2,\n",
    "    z0=1,\n",
    "    x1=5,\n",
    "    y1=8,\n",
    "    wg_width=0.45,\n",
    "    wg_thickness=0.22,\n",
    "    medium=Si,\n",
    "    sidewall_angle=15 * np.pi / 180,\n",
    ")\n",
    "\n",
    "fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 5))\n",
    "wg.plot(z=1, ax=ax1)\n",
    "wg.plot(x=2, ax=ax2)\n",
    "ax2.set_xlim(2, 5)\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "a02f2f77",
   "metadata": {},
   "source": [
    "## Linear Waveguide Taper "
   ]
  },
  {
   "cell_type": "markdown",
   "id": "1fee1f1b",
   "metadata": {},
   "source": [
    "Linear waveguide tapers can be defined in a similar way. Two parameters - width at the start and width at the end of the taper, need to be specified."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "id": "35ef5af1",
   "metadata": {},
   "outputs": [],
   "source": [
    "def taper_waveguide(\n",
    "    x0, y0, z0, x1, y1, wg_width_0, wg_width_1, wg_thickness, medium, sidewall_angle=0\n",
    "):\n",
    "    \"\"\"\n",
    "    This function defines a linear waveguide taper and returns the tidy3d structure of it.\n",
    "\n",
    "    Parameters\n",
    "    ----------\n",
    "    x0: x coordinate of the waveguide starting position (um)\n",
    "    y0: y coordinate of the waveguide starting position (um)\n",
    "    z0: z coordinate of the waveguide starting position (um)\n",
    "    x1: x coordinate of the waveguide end position (um)\n",
    "    y1: y coordinate of the waveguide end position (um)\n",
    "    wg_width_0: width of the waveguide in the beginning (um)\n",
    "    wg_width_1: width of the waveguide in the end (um)\n",
    "    wg_thickness: thickness of the waveguide (um)\n",
    "    medium: medium of the waveguide\n",
    "    sidewall_angle: side wall angle of the waveguide (rad)\n",
    "    \"\"\"\n",
    "    # Define path with linearly interpolated width from wg_width_0 to wg_width_1\n",
    "    path = pf.Path((x0, y0), wg_width_0)\n",
    "    path.segment((x1, y1), width=(wg_width_1, \"linear\"))\n",
    "\n",
    "    # Define geometry from path vertices\n",
    "    taper_geo = td.PolySlab(\n",
    "        vertices=path.to_polygon().vertices,\n",
    "        axis=2,\n",
    "        slab_bounds=(z0 - wg_thickness / 2, z0 + wg_thickness / 2),\n",
    "        sidewall_angle=sidewall_angle,\n",
    "    )\n",
    "\n",
    "    # Define tidy3d structure of the taper\n",
    "    taper = td.Structure(geometry=taper_geo, medium=medium)\n",
    "\n",
    "    return taper"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "id": "3398ad4e",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 1000x500 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "taper = taper_waveguide(\n",
    "    x0=1,\n",
    "    y0=2,\n",
    "    z0=1,\n",
    "    x1=5,\n",
    "    y1=8,\n",
    "    wg_width_0=0.25,\n",
    "    wg_width_1=1,\n",
    "    wg_thickness=0.22,\n",
    "    medium=Si,\n",
    "    sidewall_angle=15 * np.pi / 180,\n",
    ")\n",
    "\n",
    "fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 5))\n",
    "taper.plot(z=1, ax=ax1)\n",
    "taper.plot(x=2, ax=ax2)\n",
    "ax2.set_xlim(2, 5)\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "a3e47485",
   "metadata": {},
   "source": [
    "## Ring "
   ]
  },
  {
   "cell_type": "markdown",
   "id": "6c514feb",
   "metadata": {},
   "source": [
    "Rings are commonly used structures in PIC to construct resonators. Due to the hole, we can not define one single structure for the ring. Instead, we define two half rings and combine them to make one full ring."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "id": "320793eb",
   "metadata": {},
   "outputs": [],
   "source": [
    "def ring_resonator(\n",
    "    x0,\n",
    "    y0,\n",
    "    z0,\n",
    "    R,\n",
    "    wg_width,\n",
    "    wg_thickness,\n",
    "    medium,\n",
    "    sidewall_angle=0,\n",
    "    reference_plane=\"middle\",\n",
    "):\n",
    "    \"\"\"\n",
    "    This function defines a ring and returns the tidy3d structure of it.\n",
    "\n",
    "    Parameters\n",
    "    ----------\n",
    "    x0: x coordinate of center of the ring (um)\n",
    "    y0: y coordinate of center of the ring (um)\n",
    "    z0: z coordinate of center of the ring (um)\n",
    "    R: radius of the ring (um)\n",
    "    wg_width: width of the waveguide (um)\n",
    "    wg_thickness: thickness of the waveguide (um)\n",
    "    medium: medium of the waveguide\n",
    "    sidewall_angle: side wall angle of the waveguide (rad)\n",
    "    reference_plane: reference plane for the sidewall angle, either 'bottom', 'middle', or 'top'\n",
    "    \"\"\"\n",
    "    # Top half ring: arc from 0° to 180° (counterclockwise)\n",
    "    path_top = pf.Path((x0 + R, y0), wg_width)\n",
    "    path_top.arc(0, 180, R)\n",
    "    ring_top_geo = td.PolySlab(\n",
    "        vertices=path_top.to_polygon().vertices,\n",
    "        axis=2,\n",
    "        slab_bounds=(z0 - wg_thickness / 2, z0 + wg_thickness / 2),\n",
    "        sidewall_angle=sidewall_angle,\n",
    "        reference_plane=reference_plane,\n",
    "    )\n",
    "\n",
    "    # Bottom half ring: arc from 0° to -180° (clockwise)\n",
    "    path_bottom = pf.Path((x0 + R, y0), wg_width)\n",
    "    path_bottom.arc(0, -180, R)\n",
    "    ring_bottom_geo = td.PolySlab(\n",
    "        vertices=path_bottom.to_polygon().vertices,\n",
    "        axis=2,\n",
    "        slab_bounds=(z0 - wg_thickness / 2, z0 + wg_thickness / 2),\n",
    "        sidewall_angle=sidewall_angle,\n",
    "        reference_plane=reference_plane,\n",
    "    )\n",
    "\n",
    "    # Define ring structure combining both halves\n",
    "    ring = td.Structure(\n",
    "        geometry=td.GeometryGroup(geometries=[ring_bottom_geo, ring_top_geo]), medium=medium\n",
    "    )\n",
    "\n",
    "    return ring"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "id": "c364052e",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAA1QAAAG1CAYAAAD+5rVTAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjYuMCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy89olMNAAAACXBIWXMAAA9hAAAPYQGoP6dpAACpbElEQVR4nOzdd1gUV9sG8Hv7LixVqYqgYi/Yexc0xq4xxdijJpbEksTYotEkGmNLsb0xGoy9RU3sKPbYW+yKFRFUlLaUXdid7w/ifhJRcRhYcO/fde2Vl2HOmZtx34Fnz5kzMkEQBBAREREREdErk9s6ABERERERUWHFgoqIiIiIiEgkFlREREREREQisaAiIiIiIiISiQUVERERERGRSCyoiIiIiIiIRGJBRUREREREJBILKiIiIiIiIpFYUBEREREREYnEgopIInv37oVMJsPevXttHYWIiIiI8gkLKqJXNG/ePISGhto6higrVqzADz/8YOsYAIBvv/0WHTp0gJeXF2QyGb766qtXam80GvHFF1/A19cXOp0OdevWRVhYWLb7/v3332jUqBEcHBzg7e2NTz75BAaDQYKfgoiIiOydTBAEwdYhiAqTypUro2jRos+MRFksFphMJqjVasjlBfOzinbt2uH8+fO4deuWraNAJpPB29sbQUFB2LFjByZOnPhKRdV7772HdevWYfjw4ShTpgxCQ0Nx/Phx7NmzB40aNbLud+bMGdSvXx8VKlTAwIEDcffuXcyYMQPNmzfHtm3b8uAnIyIiInuitHUAKpySk5Ph6Oho6xgFilwuh1artXWMQuPmzZsICAhAbGwsPDw8XqntsWPHsGrVKkyfPh2fffYZAKBXr16oXLkyRo0ahb///tu679ixY+Hm5oa9e/fC2dkZABAQEIABAwZg586daNWqlXQ/FBEREdmdgvkxOuWrqKgofPDBB/D19YVGo0HJkiUxaNAgmEwmAEBoaChkMhn27duHwYMHw9PTE8WLF7e2nzdvHipVqgSNRgNfX18MGTIE8fHxWY5x7do1dO3aFd7e3tBqtShevDjeffddJCQkWPcJCwtDo0aN4OrqCr1ej3LlymHs2LEvzZ+TdkajERMnTkRgYCA0Gg38/PwwatQoGI3GZ/pbtmwZ6tSpAwcHB7i5uaFJkybYuXMngMw/xC9cuIB9+/ZBJpNBJpOhWbNmAJ5/D9XatWtRs2ZN6HQ6FC1aFD169EBUVFSWffr06QO9Xo+oqCh06tQJer0eHh4e+Oyzz2A2m196DjZt2oS2bdta/w1Lly6Nr7/+OkvbZs2aYcuWLbh9+7Y1e0BAwHP77NOnj3W//75edXpedl507JdZt24dFAoFBg4caN2m1WrxwQcf4PDhw4iMjAQAJCYmIiwsDD169LAWU0Bm8aXX67FmzRrRGYiIiIgAjlDZvXv37qFOnTqIj4/HwIEDUb58eURFRWHdunVISUmBWq227jt48GB4eHhgwoQJSE5OBgB89dVXmDRpEoKDgzFo0CBcuXIF8+fPx/Hjx3Ho0CGoVCqYTCa0bt0aRqMRH3/8Mby9vREVFYXNmzcjPj4eLi4uuHDhAtq1a4eqVati8uTJ0Gg0iIiIwKFDh16YPyftLBYLOnTogIMHD2LgwIGoUKECzp07h9mzZ+Pq1avYuHGjdd9Jkybhq6++QoMGDTB58mSo1WocPXoU4eHhaNWqFX744Qd8/PHH0Ov1GDduHADAy8vruflCQ0PRt29f1K5dG1OnTsX9+/fx448/4tChQzh9+jRcXV2t+5rNZrRu3Rp169bFjBkzsGvXLsycOROlS5fGoEGDXngeQkNDodfrMXLkSOj1eoSHh2PChAlITEzE9OnTAQDjxo1DQkIC7t69i9mzZwMA9Hr9c/v88MMPERwcnGXb9u3bsXz5cnh6elq3xcbGvjDbE05OTtBoNDna92VOnz6NsmXLZimSAKBOnToAMqf5+fn54dy5c8jIyECtWrWy7KdWq1GtWjWcPn1akjxERERkxwSya7169RLkcrlw/PjxZ75nsVgEQRCE3377TQAgNGrUSMjIyLB+/8GDB4JarRZatWolmM1m6/Y5c+YIAITFixcLgiAIp0+fFgAIa9eufW6O2bNnCwCEhw8fvlL+nLRbunSpIJfLhQMHDmTZvmDBAgGAcOjQIUEQBOHatWuCXC4XOnfunOXnEYT/PxeCIAiVKlUSmjZt+sxx9uzZIwAQ9uzZIwiCIJhMJsHT01OoXLmykJqaat1v8+bNAgBhwoQJ1m29e/cWAAiTJ0/O0mf16tWFmjVrvvgkCIKQkpLyzLYPP/xQcHBwENLS0qzb2rZtK/j7+7+0v+xcu3ZNcHFxEUJCQrK8DwDk6PXbb79l2+/Dhw8FAMLEiRNznKVSpUpCixYtntl+4cIFAYCwYMECQRAEYe3atQIAYf/+/c/s261bN8Hb2zvHxyQiIiLKDqf82TGLxYKNGzeiffv2z3yCD2QuGvC0AQMGQKFQWL/etWsXTCYThg8fnmURhgEDBsDZ2RlbtmwBALi4uAAAduzYgZSUlGyzPBmp2bRpEywWS45/hpy0W7t2LSpUqIDy5csjNjbW+mrRogUAYM+ePQCAjRs3wmKxYMKECc8sKvHfc5ETJ06cwIMHDzB48OAs91a1bdsW5cuXt56fp3300UdZvm7cuDFu3Ljx0mPpdDrr/05KSkJsbCwaN26MlJQUXL58+ZWz/1dycjI6d+4MNzc3rFy5Msv7ICwsLEev1q1b5zrHE6mpqdmOdj05z6mpqVn++7x9n3yfiIiISCxO+bNjDx8+RGJiIipXrpyj/UuWLJnl69u3bwMAypUrl2W7Wq1GqVKlrN8vWbIkRo4ciVmzZmH58uVo3LgxOnTogB49eliLrXfeeQe//vor+vfvj9GjR6Nly5bo0qUL3nrrrReumJeTdteuXcOlS5eeu/DBgwcPAADXr1+HXC5HxYoVc3Q+XuZ55wcAypcvj4MHD2bZptVqn8no5uaGuLi4lx7rwoULGD9+PMLDw5GYmJjle0/fpybWgAEDcP36dfz9998oUqRIlu/9d1pgftDpdNne/5aWlmb9/tP/fd6+TxeiRERERGKwoKIcy80fnzNnzkSfPn2wadMm7Ny5E5988gmmTp2KI0eOoHjx4tDpdNi/fz/27NmDLVu2YPv27Vi9ejVatGiBnTt3ZhkR+W+ml7WzWCyoUqUKZs2alW0ffn5+on8uKT3vZ3yZ+Ph4NG3aFM7Ozpg8eTJKly4NrVaLU6dO4YsvvnilEb/s/Pjjj1i5ciWWLVuGatWqPfP9mJiYHPXj4uIiWQHj4+PzzMIeABAdHQ0A8PX1te739Pb/7vtkPyIiIiKxOOXPjnl4eMDZ2Rnnz58X1d7f3x8AcOXKlSzbTSYTbt68af3+E1WqVMH48eOxf/9+HDhwAFFRUViwYIH1+3K5HC1btsSsWbNw8eJFfPvttwgPD7dOyXuel7UrXbo0Hj9+jJYtWyI4OPiZ15MRpNKlS8NiseDixYsvPF5Op/897/w82fbf8yPW3r178ejRI4SGhmLYsGFo164dgoOD4ebm9sy+rzp18cCBA/jss88wfPhwvP/++9nu4+Pjk6PX6tWrRf182alWrRquXr36zGjc0aNHrd8HMp8ZplQqceLEiSz7mUwmnDlzJtsCkYiIiOhVsKCyY3K5HJ06dcJff/31zB+cACC85JnPwcHBUKvV+Omnn7Lsu2jRIiQkJKBt27YAMpeuzsjIyNK2SpUqkMvl1qlYjx8/fqb/J3/sZjdd64mctHv77bcRFRWFhQsXPrNvamqqdcXCTp06QS6XY/Lkyc+M6jz98zk6Oj6zLHx2atWqBU9PTyxYsCDLz7Bt2zZcunTJen5y68nI1tMZTSYT5s2b98y+jo6OOZ4CGB0djbfffhuNGjWyrhSYnby+hyo2NhaXL1/Ocv/dW2+9BbPZjF9++cW6zWg04rfffkPdunWto44uLi4IDg7GsmXLkJSUZN136dKlMBgM6Natm6hMRERERE9wyp+dmzJlCnbu3ImmTZtalxSPjo7G2rVrcfDgwSzLev+Xh4cHxowZg0mTJuGNN95Ahw4dcOXKFcybNw+1a9dGjx49AADh4eEYOnQounXrhrJlyyIjIwNLly6FQqFA165dAQCTJ0/G/v370bZtW/j7++PBgweYN28eihcvjkaNGj03Q07a9ezZE2vWrMFHH32EPXv2oGHDhjCbzbh8+TLWrFmDHTt2oFatWggMDMS4cePw9ddfo3HjxujSpQs0Gg2OHz8OX19fTJ06FQBQs2ZNzJ8/H9988w0CAwPh6elpXeDiaSqVCtOmTUPfvn3RtGlTvPfee9Zl0wMCAjBixAix/2xZNGjQAG5ubujduzc++eQTyGQyLF26NNuCuGbNmli9ejVGjhyJ2rVrQ6/Xo3379tn2+8knn+Dhw4cYNWoUVq1aleV7VatWRdWqVQGIv4dq6dKluH37trVQ2r9/P7755hsAmf9mT0bw5syZg0mTJmHPnj3WZ37VrVsX3bp1w5gxY/DgwQMEBgZiyZIluHXrFhYtWpTlON9++y0aNGhgfY/fvXsXM2fORKtWrfDGG2+Iyk5ERERkZdM1BqlAuH37ttCrVy/Bw8ND0Gg0QqlSpYQhQ4YIRqNREIT/XzY9u6XVBSFzmfTy5csLKpVK8PLyEgYNGiTExcVZv3/jxg2hX79+QunSpQWtViu4u7sLzZs3F3bt2mXdZ/fu3ULHjh0FX19fQa1WC76+vsJ7770nXL169YXZc9rOZDIJ06ZNEypVqiRoNBrBzc1NqFmzpjBp0iQhISEhy76LFy8Wqlevbt2vadOmQlhYmPX7MTExQtu2bQUnJycBgHUJ9f8um/7E6tWrrf25u7sL77//vnD37t0s+/Tu3VtwdHR85uebOHGikJP/mx46dEioV6+eoNPpBF9fX2HUqFHCjh07nsljMBiE7t27C66urgKAFy6h3rRp0+cugf4qS5yL6f/pzE/OwX/Pa2pqqvDZZ58J3t7egkajEWrXri1s374922MdOHBAaNCggaDVagUPDw9hyJAhQmJiYq5/BiIiIiKZILxkXhcRERERERFli/dQERERERERicSCioiIiIiISCQWVERERERERCKxoCIiIiIiIhKJBRUREREREZFILKiIiIiIiIhEKtQP9rVYLLh37x6cnJwgk8lsHYeIyG4IgoCkpCT4+vpCLudnc0REZL8KdUF17949+Pn52ToGEZHdioyMRPHixW0dg4iIyGYKdUHl5OQEIPMXurOzs43TEBHZj8TERPj5+Vmvw0RERPaqUBdUT6b5OTs7s6AiIrIBTrcmIiJ7x4nvREREREREIrGgIiIiIiIiEokFFRERERERkUgsqIiIiIiIiERiQUVERERERCQSCyoiIiIiIiKRCvWy6US2lpqaigcPHiAuLi7bV3x8PNLS0mA0GmEymWAymZCWloY0owlGoxFmiwVOekc4OzlBr9fD0dERer0+R//byckJRYsWhVzOz0WIiIiIbIUFFdELxMXF4cqVK7hz5w4iIyNx584d3LlzBzdu3kbk3UjEPYrNtp1S6wilzglyrSOgUAMKJSBXQpArIVOoAIUSMoUWgBxCfBqEjATI0o1ARhqE9DQIpjSYTWnIMKZAsJifm0+pUsHbpxj8S/ihZIA/SpQogRIlSsDPzw8lS5ZEYGAgVCpVHp0dIiIiImJBRXZPEAQ8ePAAFy9exMWLF3Hp0iWcv3ABFy5eQuyD+9b9lBoHqF08AH1RyJ28oKhYCUWcPaBwdINcq///l8YRMrlCsmwwZ8CSngYhPRUW0/8XXBZTCsxJj5CY+BCnHz/E6TunYUkKgzEh1lqEKZRKlCwViCqVKqJSpYqoUKECKlasiHLlykGn00mSkYiIiMieyQRBEGwdQqzExES4uLggISEBzs7Oto5DhURsbCyOHz+OY8eO4cjRozh69BjiHj8CAMgVSmiKFIPMrThURUpAVaQ4VEX8oHTxhEzjCJlMZuP0LydYzDAb4pARfw/pj+4i/VEkzI8iYY67C2NC5oiaTCZDmbLl0aB+XdSpUwd16tRBlSpVoFarbZyeCgtef4mIiDKxoKLXmtlsxtmzZ7Fv3z4cO3YMhw4fReTtmwAAlYMzVN5loPIuA7VnKaiK+kHp6gOZ4vUduLWkGZD+KBKm2DswxUTA8iACqfdvQDCboVJrUK1aNdSvVxf16tVD8+bN4e3tbevIVEDx+ktERJSJBRW9VgRBwJUrV7B7927s3h2O3eHhSEyIh0Klgca7NBReZaDxKQu1T1koXb0LxYhTXrOkG5H+4CaM0Vdhir6aWWTF3gUAlC1fAa1DgtGiRQs0a9YMrq6utg1LBQavv0RERJlYUFGh9/jxY2zZsgU7d+7Ezl278SAmGnKFEtpi5aHyqwKtfxA0vuUyF4OgHDEnxyHt9j9Iu30WGXfPI+3xPcjlclStVh2tgluiXbt2aNCgARQKae4Vo8KH118iIqJMLKioULp9+zY2bdqE9Rs24OCBA7CYzXDwDYSyeNXMAqp4JcjVWlvHfG1kJNxH2u2zSLt9FumR52BKegw39yLo1LEDOnXqhJCQEC5yYWd4/SUiIsrEgooKBUEQcO7cOWzYsAHr/tiA8/+chVypgtY/CNrAutAF1oVS727rmHZBECwwRV9DyrXDSL9+DKkP70Crc0DrViHo3Lkz2rdvD3d3/lu87nj9JSIiysSCigq0u3fvYvny5fhtye+4cukilFpHaErVgi6wHnSlakKucbB1RLuX/uguUiKOwBRxFCl3L0GlUqNt2zfRq1cvvPnmm9BoNLaOSHmA118iIqJMLKiowElKSsL69euxZMnv2LdvL+RKNbSBdeFQqTl0AdV4L1QBlmF4jJRLB5B2aQ9SoyPg7OKK7u+9i549e6J+/fpcBOQ1wusvERFRJhZUVCAIgoC9e/fil18WYsPGjTAa0+DgXxW6Cs3gUK4hR6IKIVPsHSRfCIfx8n4Y4x+gREBJ9OvTG/3790exYsVsHY9yiddfIiKiTCyoyKbi4+OxZMkSzJk3HxFXr0DrUQLaii3gWLEplM4eto5HEhAEC4yR55F8YQ/SrhyEJcOEDh06YMjgwWjRogXkcrmtI5IIvP4SERFlYkFFNnHixAnMmzcPK1augindBIeyDaCv1gYavyqcFvYasxhTkHxhD1LObkPag1soWToQQwcPQp8+fbiQRSHD6y8REVEmFlSUbzIyMrB27VpMnzETp0+dhMbVE7oqraGv2goKvZut41E+EgQBxrsXYDizDalXDkGpVKL7e+/i888/R8WKFW0dj3KA118iIqJMLKgoz6WlpSE0NBRTp32PO7duwqFkdThWbwdd6VqQyflgWHtnTo6H4VwYUs9sgTEhFh06dsTYMWNQt25dW0ejF+D1l4iIKBMLKsozCQkJWLBgAWbMnIXY2IdwLN8ITnW6QuMdaOtokhAEAebkOGTE3UNGwgMIplRY0lMhmNJgMaVCSDdav5ZlpAEZRiA9DZZ/v282pcGSkQ6FWguFRgu5WgeZSgsotYBKAyi1kP27Ta7W/vvfzK8VOmco3byhdPWBXP16PFBXMKcj+cIeJB//A2mxd9GkaTOMGzsGISEhnAZaAPH6S0RElIkFFUkuNjYWs2bNwk9z5iA1NQ0OlVrAuU4XqNwL38pugmCBOSkW6XHRyIiLziye4qOBxBgYH0fDbEqz7qtSqaFzcICDox56vSP0jo5wcnKCs5NT5td6vfXl6Jj5tUqlQkpKCpKTk2EwGKyv5ORkJCYlISnJgKQn2wzJSElJRmpKMp7+v63G2R0KVx/InH2gcvOB0tUbSjdfqNx8INfqbXHackWwmJF67SgMx9Yh9d5VBFWrji/Hj0Pnzp25gEUBwusvERFRJhZUJJmkpCTMnj0b30+fDmO6BQ5Bb8CpVkconYrYOtpLCeZ0mB7ehin6KtIfR8EcHw0hIQbGuGhYMtIBAHK5HMX8SqBc2TIoExiIwKdeJUuWhE6XPyNFgiAgNjYW169fR0REhPV1+co1RFyPQELcY+u+akcXKN18IHPOHM1SeQZA41MGCiePAj/qIwgC0m6fheHoOqTcOoOgatXx3dQpaN26dYHPbg94/SUiIsrEgopyLS0tDfPnz8fX33yLhMQkOFZ/Ey71ukHh4GLraNkSBAsyHt+DMfoqTDHXYL5/DWkxN2DJMEGuUMA/oBTKlw1EmTJlshRN/v7+UKvVto7/UnFxcdZi68l/r1y9hqvXruHRwwcAALWTO5RegVB5l4HGpyzUPmWh0DnZOPnzpUWeR9KB35ESeRENGzXGtO+momHDhraOZdd4/SUiIsrEgopEy8jIQGhoKCZM/AoxMTFwrBIMlwbvFrjnRwmCgIy4e0i7fRbGO2eRHnkepuQEAECp0mVQv14d1KlTB7Vr10a1atXybaTJFqKjo3H8+HEcO3YMR48dw9Gjx5CUmHkudF4BUBavCq1/ELQlKkOucbRx2qwEQUDajRNIOrgUqTE30ObNNzF1yhQEBQXZOppd4vWXiIgoEwsqEmXbtm34eNhwXL92FfoKTeDc6P0CdY+UOTkOqTdOIe3OWWRE/gNjQiwUSiVq166DkOCWaNy4MWrXrg1XV1dbR7UpQRBw/fp1HDlyBHv27MGOsF2IirwDmUwOnW8ZKP2qQhtQDdrilSBTKG0dF0DmCGPKpQMw/L0CaY+i8P77PfD999Pg6+tr62h2hddfIiKiTCyo6JVERERg2PDh2LplCxz8g+DSvB/UXqVtHQsAkP4oEinXjsJ0/ShSoi5DBqBy1SC0Cm6Jli1bolGjRnByKrjT2gqKGzduIDw8HLt27UbY7t14HPsQKp0e6pI1oQusC12pWpBrHGwdE4I5A4Zzu2A4tAxKIR0TJ0zA8OHDC8W0zNcBr79ERESZWFBRjhgMBkyZMgUzZsyE3NEVTk37waFcQ5suDiAIAkz3riDl2mGYrh9FWuxdaLQ6tG7dCp07dULbtm3h4VGwph8WNoIg4MyZM9i0aRPWb9iI8/+chVyhhNa/KrSB9eBQpr7NH8psSTMg/uByGE5vRclSpTDnpx/Rpk0bm2ayB7z+EhERZWJBRS8kCAJWrVqFkZ9+hgcPY+FUpyuc63WFXKW1WSZzchwM58ORdn4X0mIj4V6kKDp36oiOHTsiODj4tb4HytZu376NP//8E+v/2IADB/ZDEACHwNpwqBICXSnbPqjZ9PAWEsIXIuXWWbRt1w4//vADSpcuGKOnryNef4mIiDKxoKLnioyMRJ8+fREevhuOZRvApXk/qFy9bZJFsJiRdvMUkv/ZiZTrx6BUKNG1Sxf07/8BmjVrBoXCdn/I26vHjx9j1apVWPDLQpw7ewZq5yLQVmoJfZUQqNx8bJJJEASkXDmEpH2LYUmOxzfffI1PP/2U7488wOsvERFRJhZU9AxBEPD7779jyMcfI0OuhUurodCVqmmTLOnxMUj+JwxpF3fDmBCLSlWq4sMB/fH+++/D3d3dJpnoWadOncKiRYvw+9JlMCQlwiEgCLrKwXAo2wBylSbf81jS05BwcAUSj29AvXr1sWzp7xytkhivv0RERJlYUFEWDx48wICBA/Hnpk3QV24Jt5YDINfq8zWDkGFCytXDSDkXhpRbZ+Do5ISe77+P/v37o0aNGnyoawGWmpqK9evX43+/LMTBA/uh0umhrdAU+qqtofYqle950iLPI377j5CnJWDWzJn48MMP+f6RCK+/REREmVhQkdWGDRvQf8BAJKWlw7XVEDiUbZCvxzc9vAXD2R1Iu7QX6SlJaNCwET4cOABvvfUWHBxsv6ocvZpr165h8eLFWLT4Nzx8cB86n0DoqrSCY8Vm+bpKoMWUirg9i2A4sx2tWrfG4kWLUKxYwVniv7Di9ZeIiCgTCypCfHw8PvlkGJYu/R2OZevBrdUQKBzzb+U20/3rSPx7JZKvHkERD0980LcP+vXrh3LlyuVbBso7GRkZ2Lp1Kxb++iu2bt0KhVoHXVAbONfqkK/vs9TrJxC/82dokIEF8+fhvffe42hVLvD6S0RElIkFlZ3btWsXevXug4eP4+HSYiAcK7fItz8yjTERSPp7FZKvHUHJ0oH4asKXeO+996BSqfLl+JT/oqKi8MMPP2De/PkwmjKgqxwM5zqd822xE3NqEuJ3LYDh4j506doV/1uwAEWLFs2XY79ueP0lIiLKxILKTqWkpGDUqFGYO3cuHAKqwa3NJ1A6e+bLsY3R15D090okRxxDqcAymDRxAt59910olcp8OT7ZXlxcHObNm4eZs2YjPj4ejuUbw6neW1B7BOTL8ZMvHUDCrvlwcdTit8WL0K5du3w57uuE118iIqJMLKjs0JEjR/B+z164fecOnJv0gVONtpDJ5Hl+XGP0VST+vRIpEcdRukxZayHFJa3tV0pKChYvXoxp30/H3buR0FcJhkujHlA6FcnzY2cYHiNux89IiTiOfv36Yfbs2byOvAJef4mIiDKxoLIj6enpmDRpEqZOnQqNTxm4tRkBVZHieX5c470rmVP7rh9HYNlymDRxAt555x0WUmSVnp6OX375BV9OmIhEQzL0tTrDuW4XyNV5+5BmQRBg+GcnEvcsgrdnUSxb+juaNm2ap8d8XfD6S0RElIkFlZ24f/8+unR9C0eOHIZzg+5wrvcWZPK8LWiMUZczR6RunETZcuXx1cQJePvtt1lI0XMlJCTgu+++w8xZsyHTOELfoDv0VUPy/L2aHh+D+G0/IO3uRUybNg2ffvopF6x4CV5/iYiIMrGgsgNHjhxBp85dEJdshFuH0dAWr5inx8tIuI/4PYuRfOUQypWvgK8mTkC3bt1YSFGO3b59G+PGjcfy5cug9QyAc5M+0JaqmadFjmAxI/7AUiQeWYe3334bixcvhqOjY54dr7Dj9ZeIiCgTC6rX3MKFCzFkyFAovUrDvcPoPL03xZKehsQj62E4/geKFnHHjOnf47333mMhRaKdPHkSw0eMxMED++FQsjpcmvbN8wcEJ18+iPjtP6JM6VL4c9NGBAYG5unxCitef4mIiDLl/UoEL2A2m/Hll1+iZMmS0Ol0KF26NL7++msU4hqvwDAajRgwYAAGDhwIbeWW8Hh3Sp4VU4IgIPnSATxYPBgpx9dj1GcjEXHtKnr06MFiinKlZs2a2L9vL/7880/4KpMRvWQYHm39ARlJsXl2TMfyjeDx/gzcvB+PGjVrYdu2bXl2LCIiIir8bFpQTZs2DfPnz8ecOXNw6dIlTJs2Dd9//z1+/vlnW8Yq9KKjo9GocRMsDl0C9zc+gXurIZAp8ubZTumPIhG7eixi/5yGkMZ1cenSRUyZMgV6vT5Pjkf2RyaToX379rh44TzmzZ0L9b0ziPn1Q8QfXA4hIz1Pjqn28IdHj5kwe5ZF27Zt8e233/KDHiIiIsqWTaf8tWvXDl5eXli0aJF1W9euXaHT6bBs2bJn9jcajTAajdavExMT4efnxyknT7lw4QJav9EGDxNT4d5xDDS+5fLkOIJgQdLJv5C4/3f4l/DDvLlz0Lp16zw5FtHTEhMT8d1332H69BlQFfGD65sjoPYsmSfHEgQLEg6uRMLfK9G7dx/88sv/oFar8+RYhQ2n/BEREWWy6QhVgwYNsHv3bly9ehUAcPbsWRw8eBBt2rTJdv+pU6fCxcXF+vLz88vPuAVeeHg46jVogMfpKni8PyPPiqmMhAeIXfMl4nYvxJBBH+LcP2dZTFG+cXZ2xpQpU3DixHGULOqA+7+PQMKRtRAsZsmPJZPJ4dr4fRRp9ymWLluGNm3eREJCguTHISIiosLLpiNUFosFY8eOxffffw+FQgGz2Yxvv/0WY8aMyXZ/jlA935IlS/BB//7QlKiKIh1GQ65xkPwYgiAg+dwuJOxZCM8i7lj6+xK0aNFC8uMQ5ZTRaMRXX32Fad9/D61vObi1GQ6Ve7E8OVbanX/weOMUlA4ogR3bt6FEiRJ5cpzCgiNUREREmWw6QrVmzRosX74cK1aswKlTp7BkyRLMmDEDS5YsyXZ/jUYDZ2fnLC97JwgCJk2ahD59+kBXsQWKdpmQJ8WUOTkOjzZ8i0fbfsT777yNixfOs5gim9NoNJg6dSoOHjgAL5UR95cMQ9KpLXlyv5O2RFV4dJ+OmzGPUbtOXZw6dUryYxAREVHhY9MRKj8/P4wePRpDhgyxbvvmm2+wbNkyXL58+aXt7f0T0oyMDPTvPwBLloTCtUkvONfrlifP6Um+cggJYfPgrFNj0a8L0bFjR8mPQZRbBoMBn3/+ORYsWACHktXh9sYwKJ2LSn4csyEOjzZ8DcRH4Y/16/DGG29IfozCwN6vv0RERE/YdIQqJSUFcnnWCAqFAhaLxUaJCo+MjAz06NEDS5ctRZF2n8Kl/tuSF1PmNAMebZ6B2I1T8WZIc1y6eIHFFBVYer0e8+fPx44dO+Ccdh/3Q4fCcGGP5KNVCr0bir4zBXLfSujQoSO2bNkiaf9ERERUuNi0oGrfvj2+/fZbbNmyBbdu3cKGDRswa9YsdO7c2ZaxCrwnxdTadevg3n4U9JWaS36M1Jun8DB0KBB5Cr///js2/PEHPDw8JD8OkdRatWqFixfO4+3OHfFo80w82jQV5hRpF5KQq7Uo0mkM1CVronPnLiyqiIiI7JhNp/wlJSXhyy+/xIYNG/DgwQP4+vrivffew4QJE3K0NLE9Tjn5bzHlWK6hpP0L5gzE7V2MpBN/okWLlggN/Y2rKVKhtW7dOgwY+CFS0gW4vjkSupLVJe1fMKfj0Z/fw3TzJDZs+ANt27aVtP+CzB6vv0RERNmxaUGVW/b2Cz2viylzmgGPN30H493zmDVzJoYOHfrMlEyiwiYmJga9evfGrrBdcGnaC851uko6PdZeiyp7u/4SERE9D/9aLiTyuphKfxyF2OWfQRV/G2E7d+KTTz5hMUWvBW9vb2zbuhVjxoxG/N5QPPrre1hMqZL1L1OoUKTDKE7/IyIislP8i7kQyOtiKvXWGTxc9in83B1x4vgxNG8u/T1ZRLakUCjw7bffYv369RDunMLD5Z8jPe6eZP2zqCIiIrJfLKgKuLwuppJOb8XDtRPRrHEDHDt6BIGBgZL2T1SQdOnSBcePHYOvkxIPl45E6vUTkvXNooqIiMg+saAqwPKymBIsZjwOm4/HO+fh46FDsHXLFri6ukrWP1FBVbFiRZw8cRzBzZvg4R9fw/BPmGR9s6giIiKyPyyoCqi8LKbMaQbErvsKKf/swIIFC/Djjz9CqVRK1j9RQefq6oq//vwTH/Tri0fbfkTC0XWSPa+KRRUREZF9YUFVAOVlMfVk8Qnl45sI27kTH374oWR9ExUmCoUCv/zyC8aPH4/4vaGI27MIgiDNQ8VZVBEREdkPFlQFjMViQc9evfKkmEq9fRYPl3+G4m4OXHyCCIBMJsPXX3+Nn376CYYTm/B4y2wI5gxp+v5PUbVjxw5J+iUiIqKChQVVATNmzBisWrUK7u0+l7SYMpzbjYdrJqBpw3o4fuwoypQpI1nfRIXdxx9/jBUrViDtykHEbvgGFlOaJP0+KapU/kHo0rUrzpw5I0m/REREVHCwoCpAFixYgO+//x5uzfvDsXwjyfpNPPkXHm2djQ/69cW2rVu5+ARRNt59911s3boFQvQlxK4dD3NqoiT9yhQqFGk/CoKzD95o8ybu3r0rSb9ERERUMLCgKiC2bt2KIUOGwKlmezjX7ihZvwlH1iJu1//w6aef4pdffuHiE0QvEBISgv379kKb8hCxK0cjI/GhJP3K1Tq4d5mA+DQz3mjzJhITpSnWiIiIyPZYUBUAp06dwlvd3oaudB24tegvSZ+CICBu/++I37cEX331FaZPnw6ZTCZJ30Svs1q1auHI4b9RVAvErhgFU+wdSfpV6t3h3mUirkTcQNe33kJ6erok/RIREZFtsaCysTt37qDNm20BV1+4t/sMMrki130KggVxu39B4uE1mDFjBiZOnMhiiugVlC1bFkePHEapYp6IXTkaxqhLkvSr9vCHe8cxCA8Px0cffSTZUu1ERERkOyyobMhgMKDNm22RYAKKdJkAuVqb6z4FQUDc7oUwnNqMBQsW4NNPP5UgKZH98fX1xaGDB1CrWhU8XPMl0u5elKRfXUA1uLX+BIsXL8b06dMl6ZOIiIhshwWVjQiCgH79+uFqxA24d/4SCkc3SfpNPLwGSSf/wvz58/mMKaJccnNzw66wnahXpzYerZ8EY0yEJP3qq7SEc71uGDNmDHbu3ClJn0RERGQbLKhsZMaMGVi7di1c2wyD2sNfkj6TzmxH/IGlmDx5MospIok4ODhg65bNqFqpAh6tmyjZPVWujXtAG1Ad3d5+Bzdv3pSkTyIiIsp/LKhsICwsDKNHj4ZzvW6SPWsq5erfiNs5D4MHD8b48eMl6ZOIMjk7OyNs5w6UCfDDo7VfIj0uOtd9yuQKuLf7DEaFDh06dkJKSooESYmIiCi/saDKZzdv3kS3t9+BNqA6XBv3kKTPtDvn8OivGXjrra746aefuAAFUR5wd3dH+O5d8PN0x6O145GRGJvrPhU6J7h3HItLV66if/8BXKSCiIioEGJBlY9SUlLQsVNnpMm0kq3oZ7p/A482fIOmjRth6dKlUChy3ycRZc/Lywt7wnfDQ6/Bo/UTYTEm57pPtWdJuLX+GCtXrsCPP/4oQUoiIiLKTyyo8tHQoUNx8fJluHcaA4XOKdf9pcfH4NH6iahcoRw2bdoIjUYjQUoiehE/Pz/sCtsJVVo8Hv01HYLFnOs+HSs2hXPtzvj0s8/w999/S5CSiIiI8gsLqnyyadMm/Pbbb3Bp8SHUnqVy3Z85OQ6P1k5Acc8i2LF9G5yccl+gEVHOlCtXDuvXrUXardOI27NYkj5dm/WBxqcM3u/REwaDQZI+iYiIKO+xoMoHDx8+xAf9B8CxTF3oq4bkuj+LMQWP1k+Ci8qCXWE74enpKUFKInoVISEh+OnHH5F0YhOSzu7IdX8yuQJubUYgMuoePv/8cwkSEhERUX5gQZXHBEHAwA8/RGKqCW6thuZ6wQghIx2PNn4LRfIDhO3cgZIlS0qUlIhe1ZAhQ/DRRx8hPmwe0u78k+v+VO7F4NK0DxYsWMDnUxERERUSLKjy2PLly7Fxwwa4BA+CQp+7h/cKgoDHW2cjI/oKtm7ejKpVq0qUkojE+umnn9C0SVM83vSdJMup66u/CYeS1dC7T1/ExcVJkJCIiIjyEguqPBQZGYlBQ4ZAX6kZHMs3ynV/icf+gOHSfixfthSNGzeWICER5ZZKpcL69evg5+OJxxu+zvXKfzKZHG5vDENsfCKGDv1YopRERESUV1hQ5RFBENC3Xz+ky9RwDf4o1/2l3jyNhH1LMHbsWLz11lsSJCQiqbi5uWHrls1QGRPw6M/vc73yn9LZAy4tBmLFiuVYv369RCmJiIgoL7CgyiPz58/H7l274NL6Eyi0+lz1lR4fg7jN0xHSKgSTJ0+WKCERScm68t/tM5Ks/OdYqTkcyzVA/wEDERMTI0FCIrI3e/fuhUwmw969e20dhei1xoIqD1y7dg0jP/0MTtXfhK5kjVz1ZUlPQ9ymKfD1LIJVK1fywb1EBViWlf/ObM9VXzKZDG6thiAlXUD/AQMgCIJEKYnodTNv3jyEhobaOoYoK1aswA8//GDrGAAyb9WYNGkS6tSpAzc3NxQtWhTNmjXDrl27ctyHxWLB999/j5IlS0Kr1aJq1apYuXJltvteunQJb7zxBvR6Pdzd3dGzZ088fPhQqh+H8hELKomZzWb06NkLcHCDa7N+uepLEATEbZ8DISEGf27aCDe33C1qQUR5z7ry3675uV75T+HgApdWQ7Bl8+ZC+8cSEeW95xVUTZo0QWpqKpo0aZL/oXKoIBVUmzZtwrRp0xAYGIhvvvkGX375JZKSkhASEoLffvstR32MGzcOX3zxBUJCQvDzzz+jRIkS6N69O1atWpVlv7t376JJkyaIiIjAlClT8Nlnn2HLli0ICQmByWTKix+P8pBMKMQfeyYmJsLFxQUJCQlwdna2dRwAwHfffYexY8fBs/t30BavmKu+DOd249HW2Vi5ciXeffddiRISUV5LT09HSKtWOHzqPDz7/AyFLncP3n609QcIN4/gwvnz8Pf3lyhl7hTE6y/Zt+TkZDg6Oto6hk1UrlwZRYsWLZRT+9q1a4fz58/j1q1bto6CCxcuwMvLC0WLFrVuMxqNqFatGgwGAyIjI1/YPioqCiVLlsTAgQMxZ84cAJkfjjdt2hQ3b97ErVu3rDONBg8ejNDQUFy+fBklSpQAAOzatQshISH43//+h4EDB+bRT0l5gSNUEvrnn3/w5ZcT4FSnS66LqYzEB0gI/wU9evRkMUVUyKhUKixbuhQapCN+14Jc9+fWcgAylA7o1acPLBaLBAmJCraoqCh88MEH8PX1hUajQcmSJTFo0CDrJ/ehoaGQyWTYt28fBg8eDE9PTxQvXtzaft68eahUqRI0Gg18fX0xZMgQxMfHZznGtWvX0LVrV3h7e0Or1aJ48eJ49913kZCQYN0nLCwMjRo1gqurK/R6PcqVK4exY8e+NH9O2hmNRkycOBGBgYHQaDTw8/PDqFGjYDQan+lv2bJlqFOnDhwcHODm5oYmTZpYn1UXEBCACxcuYN++fZDJZJDJZGjWrBmA599DtXbtWtSsWRM6nQ5FixZFjx49EBUVlWWfPn36QK/XIyoqCp06dYJer4eHhwc+++wzmM0vX3hn06ZNaNu2rfXfsHTp0vj666+ztG3WrBm2bNmC27dvW7MHBAQ8t8/ffvsNMpkMixdnvU91ypQpkMlk2Lp160tzvUilSpWyFFMAoNFo8Oabb+Lu3btISkp6YftNmzYhPT0dgwcPtm6TyWQYNGgQ7t69i8OHD1u3r1+/Hu3atbMWUwAQHByMsmXLYs2aNbn6OSj/KW0d4HVhNBrR/f0eUBYpDtdG7+eqL0GwIG7bT/Bwd8XPP/8kUUIiyk/FixfH/Hlz0aNHD2jL1M/VoxPkGke4vDEM+1eNw88//4xhw4ZJmJSoYLl37x7q1KmD+Ph4DBw4EOXLl0dUVBTWrVuHlJQUqNVq676DBw+Gh4cHJkyYgOTkzEcWfPXVV5g0aRKCg4MxaNAgXLlyBfPnz8fx48dx6NAhqFQqmEwmtG7dGkajER9//DG8vb0RFRWFzZs3Iz4+Hi4uLrhw4QLatWuHqlWrYvLkydBoNIiIiMChQ4demD8n7SwWCzp06ICDBw9i4MCBqFChAs6dO4fZs2fj6tWr2Lhxo3XfSZMm4auvvkKDBg0wefJkqNVqHD16FOHh4WjVqhV++OEHfPzxx9Dr9Rg3bhwAwMvL67n5QkND0bdvX9SuXRtTp07F/fv38eOPP+LQoUM4ffo0XF1drfuazWa0bt0adevWxYwZM7Br1y7MnDkTpUuXxqBBg154HkJDQ6HX6zFy5Ejo9XqEh4djwoQJSExMxPTp0wFkTo9LSEjA3bt3MXv2bACAXv/8hbz69u2LP/74AyNHjkRISAj8/Pxw7tw5TJo0CR988AHefPNN675xcXE5KvwcHBzg4ODwwn1iYmJytN/p06fh6OiIChUqZNlep04d6/cbNWqEqKgoPHjwALVq1Xqmjzp16uS6MKT8x4JKIjNnzsSlSxfh1XM2ZEpVrvpKOrUFKbfOYOPOnVkubERUuHTv3h1/bNiAv7bPh6Z4RSj17qL70vkHwalme3wxegy6dOkCPz8/CZMSFRxjxoxBTEwMjh49muUPzsmTJz+zOIu7uzt2795tnUb18OFDTJ06Fa1atcK2bdsgl2dOxClfvjyGDh2KZcuWoW/fvrh48SJu3ryJtWvXZnkUyYQJE6z/OywsDCaTCdu2bXtm1OJFctJuxYoV2LVrF/bt24dGjf7/w5bKlSvjo48+wt9//40GDRogIiICkydPRufOnbFu3TrrzwPAei46deqE8ePHW0eaXiQ9PR1ffPEFKleujP3790Or1QIAGjVqhHbt2mH27NmYNGmSdf+0tDS88847+PLLLwEAH330EWrUqIFFixa9tKBasWIFdDqd9euPPvoIH330EebNm4dvvvkGGo0GISEhKFasGOLi4l6a/YmFCxeiUqVK+OCDD7B582b07t0b3t7emDVrVpb9qlevjtu3b7+0v4kTJ+Krr7567vcjIiLwxx9/oFu3bi9dGCw6OhpeXl6QyWRZtvv4+ADI/LDgyX5Pb//vvo8fP4bRaIRGo3lpfioYOOVPApGRkfj6m2+hr9EBaq9Sueor/XEUEveHYvDgwQgJCZEoIRHZgkwmw/8WLICLgwZxO37O9Up9ro17QlDp8Omnn0qUkKhgsVgs2LhxI9q3b5/tp/f//UN1wIABWf7I3bVrF0wmE4YPH56l+BgwYACcnZ2xZcsWAICLiwsAYMeOHUhJSck2y5MPNDdt2vRKU21z0m7t2rWoUKECypcvj9jYWOurRYsWAIA9e/YAADZu3AiLxYIJEyZk+XmAZ89FTpw4cQIPHjzA4MGDrcUUALRt2xbly5e3np+nffRR1mdpNm7cGDdu3HjpsZ4uppKSkhAbG4vGjRsjJSUFly9ffuXsT3h7e2Pu3LkICwtD48aNcebMGSxevPiZezmXL1+OsLCwl7569er13GOlpKSgW7du0Ol0+O67716aLTU1Ndsi6Mm5Tk1NzfLfnOxLhQNHqCTw+eefw6LUwKXhe7nqR7CYEbd1NkoUL47vv/9eonREZEtFixbF4kW/okOHDjD8EwanoFai+5JrHODUpDfWrp2NvXv3Wu+TIHpdPHz4EImJiahcuXKO9i9ZsmSWr5+MSJQrVy7LdrVajVKlSlm/X7JkSYwcORKzZs3C8uXL0bhxY3To0AE9evSwFlvvvPMOfv31V/Tv3x+jR49Gy5Yt0aVLF7z11lvPFDdPy0m7a9eu4dKlS/Dw8Mi2jwcPHgAArl+/DrlcjooVc3df9hPPOz9A5ijewYMHs2zTarXPZHRzc0NcXNxLj3XhwgWMHz8e4eHhSExMzPK9p+9TE+Pdd9/FsmXLsGXLFgwcOBAtW7Z8Zp+GDRvm6hhmsxnvvvsuLl68iG3btsHX1/elbXQ6Xbb3wKWlpVm///R/c7IvFQ4sqHJp3759WL16NYq8OQJyzYvn1r5M4tH1MEZfxfKDB+12pSKi11H79u3Rt29fLF3xK7T+VaFy9Rbdl2Ol5kg5ux1Dhn6Ms2dOQ6nkZZzsV27+6Jw5cyb69OmDTZs2YefOnfjkk08wdepUHDlyBMWLF4dOp8P+/fuxZ88ebNmyBdu3b8fq1avRokUL7Ny587nTv3LSzmKxoEqVKs9MU3uioEzpFfvsy/j4eDRt2hTOzs6YPHkySpcuDa1Wi1OnTuGLL77I9eI6jx49wokTJwAAFy9ehMVieabIffjwYY7uodLr9dnetzVgwABs3rwZy5cvt44cvoyPjw/27NkDQRCyjCA+meL3pCh7MtXvyfanRUdHw93dndP9ChlO+cuFjIwMDB4yFLri5eFYuXmu+jLdv4HEQyvwxRdfoH79+hIlJKKC4ocffoC3Z1HEb/8RgiD+jwmZTA6Xlh/i4sULmD9/voQJiWzPw8MDzs7OOH/+vKj2Tx4rcOXKlSzbTSYTbt68+cxjB6pUqYLx48dj//79OHDgAKKiorBgwf+vzCmXy9GyZUvMmjULFy9exLfffovw8HDrlLzneVm70qVL4/Hjx2jZsiWCg4OfeT0ZQSpdujQsFgsuXrz4wuPldPrf887Pk21SPZZh7969ePToEUJDQzFs2DC0a9cOwcHB2T5PU8zUxSFDhiApKQlTp07FwYMHs32OVe3ateHj4/PS14wZM55p+/nnn+O3337D7Nmz8d57OZ99VK1aNaSkpODSpUtZth89etT6fQAoVqwYPDw8rEXh044dO2bdjwoPFlS5sGDBAly8eAEuLT6ETCb+VAoZ6YjbOgsVKlTAxIkTJUxIRAWFs7Mzlv6+BCm3zyHpxJ+56kvjHQh91VYYN/5LPHz4UKKERLYnl8vRqVMn/PXXX9n+sfmy+xCDg4OhVqvx008/Zdl30aJFSEhIQNu2bQFkPkctIyMjS9sqVapALpdbp2E9fvz4mf6f/KGb3VStJ3LS7u2330ZUVBQWLlz4zL6pqanWFQs7deoEuVyOyZMnPzOq8/TP5+jo+Myy8NmpVasWPD09sWDBgiw/w7Zt23Dp0iXr+cmtJyNbT2c0mUyYN2/eM/s6Ojq+0hTAdevWYfXq1fjuu+8wevRovPvuuxg/fjyuXr2aZT+x91BNnz4dM2bMwNixY1+4ompCQgIuX76cJXvHjh2hUqmy/JyCIGDBggUoVqwYGjRoYN3etWtXbN68OcuzrXbv3o2rV6+iW7duOT4fVDBwrohIjx49wthx46GvGgKNT5lc9RV/cDkyHkdhRdgJDvESvcaaNWuGESNG4Mef50JbsgbURUu8vNFzuDbphftXD2Hs2LHZ/lFGVFhNmTIFO3fuRNOmTa1LikdHR2Pt2rU4ePDgC1e/9fDwwJgxYzBp0iS88cYb6NChA65cuYJ58+ahdu3a1pXkwsPDMXToUHTr1g1ly5ZFRkYGli5dCoVCga5duwLIXFVw//79aNu2Lfz9/fHgwQPMmzcPxYsXz7Iy33/lpF3Pnj2xZs0afPTRR9izZw8aNmwIs9mMy5cvY82aNdixYwdq1aqFwMBAjBs3Dl9//TUaN26MLl26QKPR4Pjx4/D19cXUqVMBADVr1sT8+fPxzTffIDAwEJ6entlOU1OpVJg2bRr69u2Lpk2b4r333rMumx4QEIARI0aI/WfLokGDBnBzc0Pv3r3xySefQCaTYenSpdkWxDVr1sTq1asxcuRI1K5dG3q9Hu3bt8+23wcPHmDQoEFo3rw5hg4dCgCYM2cO9uzZgz59+uDgwYPWqX9i7qHasGEDRo0ahTJlyqBChQpYtmxZlu+HhIRYl6TfsGED+vbti99++w19+vQBkPm4jOHDh2P69OlIT09H7dq1sXHjRhw4cADLly/PMoVy7NixWLt2LZo3b45hw4bBYDBg+vTpqFKlCvr27fvK2cm2WFCJ9N133yHVmA7vxs9fHSYn0u5eROKx9Zg6ZQqqVq0qUToiKqi+/fZbbNm6DZHbZsOj+3TIFOIuwwoHF+jrv4fFixfhs88+y/Ymc6LCqFixYjh69Ci+/PJLLF++HImJiShWrBjatGnz0ucAAZnPofLw8MCcOXMwYsQIuLu7Y+DAgZgyZQpUqszHmgQFBaF169b466+/EBUVBQcHBwQFBWHbtm2oV68eAKBDhw64desWFi9ejNjYWBQtWhRNmzbFpEmTrAtXZCcn7eRyOTZu3IjZs2fj999/x4YNG+Dg4IBSpUph2LBhKFu2rLW/yZMno2TJkvj5558xbtw4ODg4oGrVqujZs6d1nwkTJuD27dv4/vvvkZSUhKZNmz73vp8+ffrAwcEB3333Hb744gs4Ojqic+fOmDZtmmSPailSpAg2b96MTz/9FOPHj4ebmxt69OiBli1bonXr1ln2HTx4MM6cOWOdYufv7//cgmrQoEEwGo3WB/w+OdYvv/yCjh07YsaMGRg1apTo3GfPngWQuWjI0+f3iT179rzwGV9A5t+Hbm5u+N///ofQ0FCUKVMGy5YtQ/fu3bPs5+fnh3379mHkyJEYPXo01Go12rZti5kzZ/LD9UJIJuR2HV8bSkxMhIuLCxISEp5ZLjMvRUVFoVTpQOhqdoZrY/EP8RXM6Xjw21BUDfTD34cOir75k4gKlxMnTqBuvXpwbvg+XOq/LbofIcOE+4s+QoeQplizZo2ECV/OVtdfIiKigob3UIkwefJkCAo1nOt0ylU/Sae3whQXjUW/LmQxRWRHatWqhRHDhyPpyBpkJMaK7kemVENf/12sXbsWp06dkjAhERER5RQLqlcUERGBRYsXw7HOW5BrxC9tbk4zwHB4Nfr165fj520Q0etjwoQJcHNxRsK+0Fz141i5JbRF/TB23DhpghEREdErYUH1iiZMmAiFgyucauRuJZzEw2ughBmTJ0+WKBkRFSbOzs74ftp3MFzci7S7F0T3I5MroG/4PnZs344DBw5ImJCIiIhyggXVK/jnn3+watVK6Ou/A7lK/A2D6fExMJz6C6O/GGV9uBsR2Z/evXujRs1aSAxfCMHy8gdQPo9DuQbQ+QRi1BejX7qsNBEREUmLBdUrGP/ll9C4+UBfJSRX/STu/x1FixTBp59+KlEyIiqM5HI55s2dg9ToCBj+CRPdj0wmh1Ojnjhy+G/s2LFDwoSF3/79+9G+fXv4+vpCJpNh48aNOW576NAhKJVKPmSTiIheiMum59D58+fx159/okibYaKXOQYA470rMFzajx8XLYKjo/h7sIjo9VC3bl307NkLq/5YCscKTSDXvHxZ6OxoS9aArnh5fP3Nt3jjjTckTll4JScnIygoCP369UOXLl1y3C4+Ph69evVCy5Ytcf/+/Vc6psViwb179+Dk5GRd2pmIiPKeIAhISkqCr6+v9Zlk+YHLpudQz569sPav7fAa8AtkCpWoPgRBQOzK0QhwluGfs2e4sh8RAQAiIyNRqlRp6Bt2h0u9bqL7Sbl2BA//+AYHDx4U9VDLV1EYl02XyWTYsGEDOnXq9NJ93333XZQpUwYKhQIbN27EmTNncnycu3fvws/PT3xQIiLKlcjISBQvXjzfjscRqhy4desWVqxcAZdm/UQXUwCQeu0wUiIvYPaOHSymiMjKz88P/ft/gEVLV8KpRjvI1TpR/egC60Dr6Y8pU6diy+bNEqe0H7/99htu3LiBZcuW4Ztvvnnp/kajEUaj0fr1k88pIyMjC02xSUT0OkhMTISfnx+cnJzy9bgsqHJg5syZUGj10Fdt/fKdn0MwpyNp/xKEtGqFVq1aSZiOiF4HY8aMwa+/LkLS6S1wqfuWqD5kMjkca3fB1i2zce7cOVSpUkXilK+/a9euYfTo0Thw4ACUypz9ipw6dSomTZr0zHZnZ2cWVERENpDf0625KMVLPHjwAL8s/BUO1dtBrtaK7ifpzHaY4qIxc8YMCdMR0euiRIkS6NevL5KPb4DFlCq6H8cKTaFx9cR3302TMJ19MJvN6N69OyZNmoSyZcvmuN2YMWOQkJBgfUVGRuZhSiIiKmhYUL3ETz/9BAtkcKrRTnQfljQDDIdXoU+fPvzEmIiea+zYsRCMKUg6vVV0HzKFEg61OmPV6lW4efOmhOlef0lJSThx4gSGDh0KpVIJpVKJyZMn4+zZs1AqlQgPD8+2nUajsY5GcVSKiMj+sKB6geTkZPz08xzoqrSCQid+LmbC0fVQWNLx9ddfS5iOiF43/v7+6Nu3D1JObIDFlCa6H33VECi1esyePVvCdK8/Z2dnnDt3DmfOnLG+PvroI5QrVw5nzpxB3bp1bR2RiIgKIJsXVFFRUejRoweKFCkCnU6HKlWq4MSJE7aOBQBYuXIlkpIS4Vyrg+g+LGkGpJzZgk8+HgpfX18J0xHR62js2LEwpxlyNUolV2mhrdoai0NDYTAYJExX+BgMBmtxBAA3b97EmTNncOfOHQCZ0/V69eoFIPO5YJUrV87y8vT0hFarReXKlfmoCyIiypZNC6q4uDg0bNgQKpUK27Ztw8WLFzFz5ky4ubnZMhaAzFWa5sydB4fStaB08RLdT9LprZBZzBg+fLh04YjotRUQEIC+ff4dpUoXP0rlFPQGkg0GrFy5UsJ0hc+JEydQvXp1VK9eHQAwcuRIVK9eHRMmTAAAREdHW4srIiIiMWz6HKrRo0fj0KFDOHDgQI72/+/StE+WRsyL56AcO3YMdevWhcdbE+FQuraoPizpRtz/pT/6vv82FixYIGk+Inp93bp1C4FlysC5cW841+ksup/Y9ZNR2tGEM6dPSb7iUWF8DlV+4bkhIrINW11/bTpC9eeff6JWrVro1q0bPD09Ub16dSxcuPC5+0+dOhUuLi7WV14+OHH+/PnQuHlBV7KG6D6Sz+1CRkoCPv/8cwmTEdHrLiAgAL179ULy8T9yNUrlWK0N/jl7BseOHZMwHRERET3NpgXVjRs3MH/+fJQpUwY7duzAoEGD8Mknn2DJkiXZ7p9fS9M+fvwYK1augq5Ka8jk4h7AK1jMSD6xAd26vY3SpUtLnJCIXnfjxo2DOS0JhjPbRfehLVkDGjdvzJs3T8JkRERE9DSbFlQWiwU1atTAlClTUL16dQwcOBADBgx47vS4/FqaNjQ0FBkZGdBXFf8A3pTLB2CMi8Ho0V9ImIyI7EWpUqXQq2dPJB9fD0u68eUNsiGTK6Cr+gZWrlqNR48eSZyQiIiIABsXVD4+PqhYsWKWbRUqVLDpDcKCIGDu/AXQlW0AhaOr6H5SzmxF8+YtUK1aNcmyEZF9GTNmDExJcUi5+rfoPvRVQ2C2WJ478k9ERES5Y9OCqmHDhrhy5UqWbVevXoW/v7+NEmUuRnEj4hocczE6lf4oEimRF/HhhwMlTEZE9qZMmTJo3KQpUs+Fie5D4eACXWAdLA5lQUVERJQXbFpQjRgxAkeOHMGUKVMQERGBFStW4JdffsGQIUNslmnp0qXQOBeFtkQV0X0Y/gmDi6sbOnXqJF0wIrJLHw4cgJTb/yA97p7oPhwqtsCFc//g3LlzEiYjIiIiwMYFVe3atbFhwwasXLkSlStXxtdff40ffvgB77//vk3ymEwmLF+xEpryTcQvRmFOR9rFPejTuxc0Go3ECYnI3nTp0gV6J2cY/hE/SqUrVQMqRxcsW7ZMwmREREQE2LigAoB27drh3LlzSEtLw6VLlzBgwACbZdmxYwfi4x7DsVJz0X2kRhyHyRCHDz74QMJkRGSvdDodevfqibSL4RAsZlF9yBQqaMo2wpKly2A2i+uDiIiIsmfzgqog+f33pdB5lYLas6ToPlLOhaFmrdqoUkX8lEEioqd98MEHMCU+QuqNE6L70FdqhvvR97B3717pghERERELqifi4+Ox6c8/oanQTHQfGYmxSLlxEh8OtN0oGxG9fqpXr46gatWRkotpf2rf8tAWKYalS5dKmIyIiIhYUP1r/fr1SE83wbFiU9F9GM7vgkarxTvvvCNhMiIiYOCA/ki5fhwZhsei2stkMmjKN8XadeuQkpIicToiIiL7xYLqX2vXrYNDiSpQOhUR1V4QLEg7vwvvvvN2nj1wmIjsV/fu3aFSqZB8frfoPhwrNEFKcjLCwsSPdBEREVFWLKgAJCYmInx3ODSB9UT3kXb7HxjjYtC/f38JkxERZXJ1dUW3t95C2vldEARBVB+qIsWh8yiBjRs3ShuOiIjIjrGgArB9+3akp5vgUEZ8QZX8z04Eli2HBg0aSJiMiOj/DRjQH2mPomCMPC+6D1Xputi46U9kZGRImIyIiMh+saACsGHDRuh8AqF08RTV3pyaiNRrh/HhgP6QyWQSpyMiytSkSRMElCqN5H92iu7DoUw9xMc9xqFDhyRMRkREZL/svqAymUz4a8tmqEvVEd1H8sV9kEFAr169JExGRJSVTCbDhwP6I/Xq37AYk0X1ofYpA7VzEWzatEnidERERPbJ7guqvXv3IjkpCQ5lxU/3M149hFatWsHTU9wIFxFRTvXo0QPmdCNSrx8X1V4mk0Ndqg7W/bFB9L1YRERE9P/svqDauHEjtG7eUHmIe5ivOSUBqZEX0aVzZ4mTERE9q3jx4giqXgOpEUdF9+FQph4ib9/CuXPnJExGRERkn+y6oBIEAX9u3gJVqdqi733K/JRYQPv27aUNR0T0HF07d4Lx5kkIGemi2mv9q0KpccCWLVskTkZERGR/7LqgunHjBqIi70AbUE10H2kRR1G7Tl14eXlJF4yI6AU6duyIjLQUpN35R1R7mUIFdfFK2LVb/DOtiIiIKJNdF1Th4eGQyeTQ+lUW1d6Snoa0W6fQtQun+xFR/qlSpQr8/AOQcu2I6D40Jarg4MFDMBqNEiYjIiKyP3ZdUO3atRs63zKQaxxFtU+7dRZmkxEdO3aUOBkR0fPJZDJ07dwJ6TeOQxAsovrQ+leDyZiGw4cPS5yOiIjIvthtQSUIAnbt3g2lX1XRfaReP4ZSgWVQrlw5CZMREb1cx44dYUyMhen+DVHtVZ4BUDu6IDw8XOJkRERE9sVuC6oLFy7g8aNYaP2DRPeREfkP2rZ5Q8JUREQ506BBA2h1Dki7fUZUe5lMDpVfZYTt4n1UREREuWG3BdXu3bshV6qgKVZeVPv0+BikPY5Gy5YtJU5GRPRyarUaTZo0humO+KXPNSWCcPz4MRgMBgmTERER2Re7LajCw8OhLVYecpVWVPu02/9ALpejadOmEicjIsqZ4JYtYbx7AYJZ7PLpQTBnZODgwYMSJys49u/fj/bt28PX1xcymQwbN2584f5//PEHQkJC4OHhAWdnZ9SvXx87duzIn7BERFQo2WVBJQgCDh0+AqVvBdF9GO+cRVC16nB1dZUuGBHRK2jZsiXMpjQY710R1V7p5gu1owuOHhX/kOCCLjk5GUFBQZg7d26O9t+/fz9CQkKwdetWnDx5Es2bN0f79u1x+vTpPE5KRESFldLWAWzh7t27ePTwATwalxXVXhAEZNw9h1aDBkicjIgo54KCguDs4oq022dFPf5BJpNB6V0GR17jgqpNmzZo06ZNjvf/4Ycfsnw9ZcoUbNq0CX/99ReqV6+ebRuj0Zhl+fnExERRWYmIqHCyyxGqY8eOAQDUPuIKqvRHkTAmPkaLFi2kjEVE9EoUCgVatmiB9Ejx91GpvMvgyNFjEARBwmSvD4vFgqSkJLi7uz93n6lTp8LFxcX68vPzy8eERERka3ZbUGlcPaDUP/8X5IsYI89DrlCgYcOGEicjIno1zZs3Q1rUZQgZ4u6j0viURfzjR7h165aUsV4bM2bMgMFgwNtvv/3cfcaMGYOEhATrKzIyMh8TEhGRrdllQXX4yFEovMqIbm+MvoqKlSrD0VHcA4GJiKRSt25dWMwZMD0Q9zyqJyP1T0bu6f+tWLECkyZNwpo1a+Dp6fnc/TQaDZydnbO8iIjIfthdQWU2m3Hy5AnR0/0AwPIgAg3q1ZUwFRGROEFBQVCqVDDFXBPVXuHgAq27Dwuq/1i1ahX69++PNWvWIDg42NZxiIioALO7gury5ctISU6GRmRBZTGlIu3BHdSpU0fiZEREr06j0aBylaowRl8V3YfcKxCHj7y+C1O8qpUrV6Jv375YuXIl2rZta+s4RERUwNldQXXmzBkAgNqrtKj2pvvXIQgW1K5dW8JURETiNahXF5b7EaLbq71K4+zZM6/lwhQGgwFnzpyxXvtv3ryJM2fO4M6dOwAy73/q1auXdf8VK1agV69emDlzJurWrYuYmBjExMQgISHBFvGJiKgQsLuC6uLFi9C6ekCuEXf/kyn6KrQ6B1SsWFHiZERE4tSuXRupsZGwGJNFtVcV9UdKcjLu3r0rcTLbO3HiBKpXr25d8nzkyJGoXr06JkyYAACIjo62FlcA8MsvvyAjIwNDhgyBj4+P9TVs2DCb5CciooLP7p5DdfHiJcjdiotub4y+hho1akCptLtTR0QFVJ06dQBBgDEmAjr/oFduryqSucz3pUuXXrslv5s1a/bCkbfQ0NAsX+/duzdvAxER0WvH7kao/jl/Hgr3XPzBEBeJGtWrSZaHiCi3ypUrB7Vag/TYOy/fORtKZw8o1BpcvHhR4mRERESvP7sqqEwmE27dvAFV0RKi2guCBcbH0ShTRvyS60REUlMoFCgREICMuHui2svkCmiK+LGgIiIiEsGuCqpr167BYjZDVUTclD9z0mOY040IDAyUOBkRUe6UL1sW5vho8R24FcP5CyyoiIiIXpVdFVRPPn0VO0KVEZ/56S8LKiIqaMqUCYSQECO6vbpICVy4cOG1XOmPiIgoL9lVQXXp0iWo9a5Q6MQ9xT49LhpyuRwBAQHSBiMiyqXSpUvDGBcDwWIW1V5VxA+JCfF48OCBxMmIiIheb3ZVUN26dQtKV2/R7TPiouFTzA9qtVrCVEREuRcYGAiLOQMZiQ9FtX9ybbx9+7aUsYiIiF579lVQ3b4NOBYV3T4j/h7KleV0PyIqeJ5MRc6IFzftT+HsAQBZnslEREREL2dXD1O6ees2lEWqiu8g8T7KlgmRLhARkUT8/f2hUCozV/oLqPbK7eVaPZQaHQsqonxw5swZ7N6929YxCqWmTZuiVq1ato5BlIXdFFSCIOBeVBQcS7YQ3d70+B4XpCCiAkmpVKK4nz/i4sSt9CeTyaBy8UBkZKTEyYjov37++Wf8FroESo3O1lEKlQxTKt57510sX77M1lGIsrCbgio2NhYmYxpc/p3W8qosyfHIMKayoCKiAqtc2UAcvCF+6XSZvihHqIjymCAI2L4zDPoa7eDecoCt4xQqcXtDsSMsDIIgQCaT2ToOkZXd3EP15I8EhbOnqPbpXDKdiAq4smXKQEgUv3S6XF8UN27eki4QET0jIiIC9+5GQitiaq690wZUw6OHD3D+/HlbRyHKwm4KqifTWJQiR6gy4jL/SClVqpRkmYiIpBQYGAjT43sQBIuo9gpnD9zhlD+iPBUWFga5QgmtX2VbRyl0tMUrQqHSICwszNZRiLKwm4Lq3r17kCkUkIt8BlVG3D14+RSDTsf5zkRUMAUGBsKcboLZ8FhUe6VTETyOfYj09HSJkxHREzt27oS2WHnI1fx74lXJlGpoilfEjp07bR2FKAu7KagMBgOUGgfRc27T46NRJrC0xKmIiKRTunTmNSpD5MIUcq0TACA+Pl6qSET0lIyMDISH74GqRJCtoxRaav9q2L//AIxGo62jEFnZTUGVnJwMRW4+DUozwNtL3P1XRET5wcMjc0qzJS1JVHu5Vg8AiIuLkywTEf2/EydOwJCUCF1AdVtHKbR0AdWQlpqCw4cP2zoKkZXdFFQGgwFytVZ8B2Yj9Hq9dIGIiCT25BplSRf3ya1c6wiABRVRXgkLC4NKp4fap4ytoxRaKs+SUOtdeR8VFSh2VVBBlYuCKj0Njo6O0gUiIpKYWq2GXKGAYEoV1Z4jVER5a/uOnVD5VYFMrrB1lEJLJpND5VcV23bwPioqOOymoEpOTgaU4gsqwZTKESoiKtBkMhkcHBxhMaWJai/XZF7jeA8VkfQMBgOOHj0CrX81W0cp9DT+1XDm1El++EMFht0UVAaDAYJSI7q9JT2NBRURFXgOjnoI6eJGqGRqHWRyBf9IIcoD+/btgzkjg8+fkoCuZDUIgoDw8HBbRyECYEcFVWJiEmS5mPJnNnLKHxEVfI6ODhBE3kMlk8mgcnBiQUWUB8LCwqBx9YLSzdfWUQo9pbMntEWLYyeXT6cCwm4KqiRDsuhnPgiCgAxO+SOiQkCvd4JF5D1UACBXazOnSBORpLbvCIOqRJDox7dQVkq/IOzYucvWMYgA2FVBlQSZStyUPyHDCAgCCyoiKvCcnfQQ0sXdQwUAcoWKz3chkti9e/dw5fJFTveTkC6gGm7fuoGbN2/aOgqR/RRUBoMBMrEjVP/e4M0pf0RU0Dnp9bkaoYJCCZPJJF0gIsKuXZkjKVp/PtBXKlr/qpDJFVw+nQoEuymoUlJSIBd5D5Xl3097OUJFRAWdk5MesoxcjDDJWVARSS0sbBd0PoFQOLjYOsprQ65xhNa3LMLCOO2PbK/AFFTfffcdZDIZhg8fnif9pyQni16UQmBBRUSFhF6vBzLET/mTvWZT/vbv34/27dvD19cXMpkMGzdufGmbvXv3okaNGtBoNAgMDERoaGie56TXlyAI2BGWef8USUtdIghhu3bBbDbbOgrZuQJRUB0/fhz/+9//ULVq1Tzp32w2w5iWCrlaZEH17/QZTvkjooLO0dERyMU9VMJrNkKVnJyMoKAgzJ07N0f737x5E23btkXz5s1x5swZDB8+HP3798eOHTvyOCm9ri5cuICH92P4/Kk8oA2ohoT4OJw+fdrWUcjOKV+1Qe/evfHBBx+gSZMmkgQwGAx4//33sXDhQnzzzTeS9PlfKSkpADI/JTKnJr5ye7MhcwlhFlREVNDp9XqY05JFXesAwGxMsfkIVYsWLdC0aVNMnDgxy/a4uDh07dr1lZ4906ZNG7Rp0ybH+y9YsAAlS5bEzJkzAQAVKlTAwYMHMXv2bLRu3TrH/RA9sWvXLsiVamiKV7R1lNeOxrc8lBoH/Pnnn6hVq5at45Ade+WCKiEhAcHBwfD390ffvn3Ru3dvFCtWTHSAIUOGoG3btggODn5pQWU0GrP8ok9MzNkfDAaDATK5HI+3/4zH238WndVisYhuS0SUHxITE2GMf4C7P3UX3UdycqCEiV7d3r17ce7cOZw+fRrLly+3fphlMpmwb9++PD324cOHERwcnGVb69atXzgdXezvJrIPO3buhLZ4RchFrjRMzydTKKHyLY81a9dh8uTJto5DduyVC6qNGzfi4cOHWLp0KZYsWYKJEyciODgYH3zwATp27AiVSpXjvlatWoVTp07h+PHjOdp/6tSpmDRp0qtGhk6ng2CxQFemHlTuxV+5fUbCfaRcPgC5vEDMkCQiei5BEAAAznXfEtU+5fIB6HTiVkSV0q5du/Dhhx+iXr16+OuvvxAQEJAvx42JiYGXl1eWbV5eXkhMTERqamq250bs7yZ6/T35EEBT+21bR3ltKYuWwI2z2577/0+i/PDKBRUAeHh4YOTIkRg5ciROnTqF3377DT179oRer0ePHj0wePBglClT5oV9REZGYtiwYQgLC4NWm7N7m8aMGYORI0dav05MTISfn99L2z35dNOhTH3oq7TM0bGelnb3AlIuH0Bamvj7EoiI8oNarYaDVwDcmvUR1T7j/jVoNLb/JN3Hxwf79u1D3759Ubt2baxduxYVKlSwdaxsif3dRK+/w4cPIzUlBS58/lSe0VcJQdLxjThw4ABatWpl6zhkp3I15BIdHY2wsDCEhYVBoVDgzTffxLlz51CxYkXMnj37hW1PnjyJBw8eoEaNGlAqlVAqldi3bx9++uknKJXKbFds0Wg0cHZ2zvLKCZVKBZVKDSFd3LNZ5KrMTzySk5NFtSciyi8Gg0H0iqYAAHOGzQsqmUwGIPOav2LFCgwbNgxvvPEG5s2bl+fH9vb2xv3797Nsu3//PpydnZ/76bfY3030+tu1axdUji5Qe5WydZTXlqpoCWici1if9UVkC688QpWeno4///wTv/32G3bu3ImqVati+PDh6N69u/WXyIYNG9CvXz+MGDHiuf20bNkS586dy7Ktb9++KF++PL744gsoFIpXjfZCDo6OsJjEjTDJ/l0d0GAwSBmJiEhyycnJEJS5KIgsGVCr1dIFEuHJtMUnxo8fjwoVKqB37955fuz69etj69atWbaFhYWhfv36eX5sev1s27ETKr+qkMl4y0BekclkUPpVxbYdO/H999/bOg7ZqVcuqHx8fGCxWPDee+/h2LFjqFat2jP7NG/eHK6uri/sx8nJCZUrV86yzdHREUWKFHlmuxQcHPVIEbmU8JNPe1lQEVFBl5RkgKDMxQhVASiobt68CQ8PjyzbunbtivLly+PEiROv1JfBYEBERESWvs+cOQN3d3eUKFECY8aMQVRUFH7//XcAwEcffYQ5c+Zg1KhR6NevH8LDw7FmzRps2bIl9z8Y2ZW4uDicPnkCrq2G2DrKa08bUB3nt8zCw4cPn7l2EOWHVy6oZs+ejW7dur3wvidXV1fcvHkzV8Gk5ujoAINJ7JQ/FlREVDgkJiVZR9VFMafbfMqfv79/ttsrVaqESpUqvVJfJ06cQPPmza1fP7nXqXfv3ggNDUV0dDTu3Llj/X7JkiWxZcsWjBgxAj/++COKFy+OX3/9lUum0yvbu3cvLBYLdAHVbR3ltaf99x613bt3491337VtGLJLr1xQ9ezZMy9yAMi8+OQVvV6PGNEjVJl/XPAeKiIq6JIMBshVRUW3F8y2H6GSUrNmzZ6ZQvi00NDQbNvwQaGUW2FhYdAWKQali6eto7z2lHp36DwDsHPnThZUZBN2M6nX2ckJFrEFlVwBhVrDESoiKvByuyiFJT2NSw8TSWDb9p1QlgiydQy7oSwRhO07w174AQpRXrGbgspJr4cgclEKAFCodSyoiKjAMxiSIVeLL4jSUwxwc3OTMBGR/bl16xZu3bwOHZdLzze6gGqIjrqLa9eu2ToK2SH7Kaic9JBl5K6g4pQ/IiroUlOSRY9QWdKNsGSYWFAR5dKuXbsgk8mhLVHV1lHshsavMuQKJcLCwmwdheyQ3RRUer0eyDCKbi9TaTlCRUQFXkpyMuQiF6WwpGVe4162SisRvdjOnWHQ+ZaFXKu3dRS7IVfroC1WHjtZUJEN2E1B5ejoCIi8hwoAwIKKiAq49PR0pKebIFOJm/JnMWaOwnOEikg8i8WCsF27eP+UDahKBGF3eDgyMjJsHYXsjN0UVHq9HkKuCioNp/wRUYH25Boldtn0JyNULKiIxDtz5gzi4x7z/ikb0AVUR3JSEo4fP27rKGRn7KagcnR0hDkXi1JA5YBHjx9LF4iISGJxcXEAALnaQVR7FlREuRcWFgaFWgtNsfK2jmJ31D5loNLpsWvXLltHITtjNwWVXq9HRlqK6PZKFy9ci7ghYSIiImnduJF5jVK6eolqz4KKKPe279gJjV9lyBQqW0exOzK5Aiq/Kti+Y6eto5CdsZuCytPTE5YMk/UegVeldPPB3cjbSE9PlzgZEZE0IiIiIJMroHQW9yBRc/Jj6J2codWKf44VkT1LTU3FoUOHoPGvZusodkvrXw1Hjx7hfe+Ur+ymoPLz8wMAZCQ+FNVe6eYLc0YG7ty5I2UsIiLJREREQOvmBZlCKaq9OfEhiv97rSSiV3fw4EGkm4zQ8v4pm9EGVIM5IwP79u2zdRSyI3ZTUJUoUQJA5h8MYqjcfABk/sFCRFQQXbsWAZmLt+j25sSHKBXgL2EiIvsSFhYGtZM7VEX5/yNbUbr5QuPqxedRUb4S9zFmIeTj4wO5QoGMpFhR7RVORSFXKHH9+nWJkxERSePKtWuQuwSI7yD5Efz9a0qWh8je7Nq9BxkZGXi4frKto9i1dJMRYbvDbR2D7IjdFFQKhQJe3r5IFjlCJZMroHH34QgVERVIgiDg5o0bcGhQX3Qf6YkPrdOjiejVjRk9CsuXL7d1DKrsi7ffftvWKciO2E1BBQAB/iXwT4K4ggoAZC7euHbtmoSJiIikER0dDWNaKpz/nZ78qiymVKQnJ1qnRxPRq+vWrRu6detm6xhElM/s5h4qACgZ4A9B5JQ/AFC4eOPyVRZURFTwPBk9V7n6impvTsy8NrKgIiIiejV2VVCVKFEClqQHotsr3Xxx++ZNmM1mCVMREeVeREQEIJOJfgZVRmLmtZEFFRER0auxq4KqfPnySIu7D4spTVR7lasP0tNNiIqKkjgZEVHuREREQOviAZlSLap9+qNIaLQ63kNFRET0iuyqoKpYsSIAIP3xXVHtlVw6nYgKqIiICMhdxN0/BQDpsXdQrlx5yOV29WuBiIgo1+zqN2f58uUBZH4SK4bSxRMyuYIFFREVOJevXIPcVfwzqCxxd1GlckUJExEREdkHuyqonJyc4O1bHOmxd0S1lylU0Lp5saAiogJFEARcvxFhHUUX0z79UaR1FJ+IiIhyzq4KKgCoUrkiMkSOUAGAzLUY/jl3TsJERES5ExkZiRSDASr34qLaW5LjkZ6SxIKKiIhIBLsrqCpVrAghTtw9VACg8g7EsWPHIQiChKmIiMQ7fvw4AEDtU1ZU+yfToCtUqCBZJiIiInthdwVVxYoVkfboHoSMdFHt1T5lEff4EW7duiVtMCIikY4dOwaNqweUendR7dMf3YFSpULp0qUlTkZERPT6s7uCqkqVKhAEC0yxt0W113iXAZD5BwwRUUFw5NgxKDwDRbc33b+BcuUqQKlUSpiKiIjIPthdQVWtWjUolEqYoq+Kaq9wdIXWzcs6xYaIyJYsFgtOnDgherofAJgfRKBB/boSpipY5s6di4CAAGi1WtStW/elH4j98MMPKFeuHHS6zOdyjRgxAmlp4p5fSERErz+7K6i0Wi0qV6kK470rovtQeJXB4SNHJUxFRCTOlStXkGIwiC6oLKY0pN2/hTp16kicrGBYvXo1Ro4ciYkTJ+LUqVMICgpC69at8eDBg2z3X7FiBUaPHo2JEyfi0qVLWLRoEVavXo2xY8fmc3IiIios7K6gAoAG9erC8uCa6PYq7zI4deoUMjIyJExFRPTqnoy2aLzFTfkz3Y+AIFhe24Jq1qxZGDBgAPr27YuKFStiwYIFcHBwwOLFi7Pd/++//0bDhg3RvXt3BAQEoFWrVnjvvfc4zZuIiJ7LLguqOnXqIPVhJCzGZFHtNcUqIi01BadOnZI4GRHRq9m/fz90XgGQaxxFtTdFX4VW5/BaLpluMplw8uRJBAcHW7fJ5XIEBwfj8OHD2bZp0KABTp48aS2gbty4ga1bt+LNN9987nGMRiMSExOzvIiIyH7YbUEFQYAxRtwDejU+ZaDUOCA8PFziZEREOScIAnaE7YKyeFXRfRijr6FGjRqv5YIUsbGxMJvN8PLyyrLdy8sLMTEx2bbp3r07Jk+ejEaNGkH178qHzZo1e+GUv6lTp8LFxcX68vPzk/TnICKigs0uC6py5crBQa8XvTCFTKGEunglhO3aJXEyIqKcu3nzJqIi70AbECS6D8v9a6hf7/VdkOJV7d27F1OmTMG8efNw6tQp/PHHH9iyZQu+/vrr57YZM2YMEhISrK/ISPEPjyciosLn9ftIMgcUCgVq1aqFE1GXRfehKVEFBw+ugNFohEajkTAdEVHO7N69GzKZHFq/yqLamw1xSIuLeW3vnypatCgUCgXu37+fZfv9+/fh7e2dbZsvv/wSPXv2RP/+/QFkPmojOTkZAwcOxLhx4yCXP/s5pEaj4e8BIiI7ZpcjVADQolkzpN+9AMFiFtVe618NJmPac+fhExHltd27w6ErVlb0/VNpd/4BADRp0kTKWAWGWq1GzZo1sXv3bus2i8WC3bt3o379+tm2SUlJeaZoUigUADKnWBIREf2X3RZULVu2RHqqAab7N0S1V3kGQO3owvuoiMgmBEFA2O7dUBavIrqPtNtnUa5CxeeO1rwORo4ciYULF2LJkiW4dOkSBg0ahOTkZPTt2xcA0KtXL4wZM8a6f/v27TF//nysWrUKN2/eRFhYGL788ku0b9/eWlgRERE9zS6n/AGZC1NodQ5Iu3MWGp8yr9xeJpND5VcZ23fsxOTJk/MgIRHR8507dw6PYx/Cs6X4+6cy7p5Dq/ffkjBVwfPOO+/g4cOHmDBhAmJiYlCtWjVs377dulDFnTt3soxIjR8/HjKZDOPHj0dUVBQ8PDzQvn17fPvtt7b6EYiIqICz24JKrVajSZPGOHjtH6CuuD8otCVr4cT2n3D//v1nVpEiIspLf/75J5RaB2iLVxLVPj0+BmmPo9GyZUuJkxU8Q4cOxdChQ7P93t69e7N8rVQqMXHiREycODEfkhER0evAbqf8AUBwy5YwRl6AYE4X1V4XWAeADJs3b5Y2GBHRS6zfsBGakjUhU6pEtU+7/Q/kcjmaNm0qcTIiIiL7YtcFVcuWLWFON8J474qo9goHF+j8KuKPDRskTkZE9Hx3797FmVMnoQsUv9y58c5ZBFWvAVdXV+mCERER2SG7LqiCgoLg7OKKtFtnRfehKV0Hu3btRnJysoTJiIie788//4RMoYCuVC1R7QVByLx/Kvj1n+5HRESU1+y6oFIoFGjdqhVMt06I7kNXph5MxjTs3LlTwmRERM+3YeNG6PyqQK7Vi2pviomAMfExWrduLXEyIiIi+2PXBRUAdO7cCan3riEj8aGo9io3X+g8/bFp0yaJkxERPSshIQF79+yFJhfT/VKuHYGziysaN24sYTIiIiL7ZPcF1ZtvvgmlUoXUiKOi+1CXrof1f2xAamqqhMmIiJ61YcMGZJgz4FBGfEGVfuMoOnXsAKXSbhd6JSIikozdF1QuLi5o1rwZ0nJRUDlWaQlDUiLWr18vXTAiomz875eFcAioBqWzp6j26XH3kHr/Fjp27ChxMiIiIvtk9wUVAHTp3Bmpd/6BOc0gqr3KzRcOAUH4ZeGvEicjIvp/ly9fxpHDf8OhSivRfaReOwK1Rsv7p4iIiCTCggpAhw4dIJjNSL1+XHQfusrBOLB/HyIiIiRMRkT0/xYtWgSVowscytQT3Ycx4ihCQoLh6OgoYTIiIiL7xYIKQLFixVCjVm2kRRwR3YdD2QZQ6fRYvHixhMmIiDKZTCYsDl0CbYVmoh/ma06OR8rdi+jSubPE6YiIiOwXC6p/devaBWk3TsBiTBHVXq7SQFuhKX5d/BsyMjIkTkdE9m7z5s14HPsQ+qohovtIufo35HI52rVrJ2EyIiIi+8aC6l/vvfcezCYjUq4dFt2HvmprPLwfg23btkmYjIgIWPjrr3AoVh5qjwDRfaRd3IOQkBB4eopb0IKIiIiexYLqX/7+/mjUuAlSL+4V3YfaqxR0PoH4ZeFC6YIRkd27e/cudu7YAW3lYNF9pMdFI+XuJfTu1UvCZERERMSC6il9evdCyq0zyEiKFd2HrkorbN26FdHR0RImIyJ7FhoaCrlKA8cKTUT3kXxhDxz0ei6XTkREJDEWVE/p2rUrVCo1ki/uF92HY4UmkMmVWLJkiYTJiMheWSwW/G/hr9CWbQi5xkFUH4IgwHhpL95+6y04OIjrg4iIiLLHguoprq6u6NihA4yX9oruQ67VQ1e2Af638FcIgiBdOCKyS3v27MHdO7fhWFX8c6NM964g7fE99OzZU8JkREREBLCgekavXj2Rev8GTA9uiu7DsWor3LpxHfv3ix/pIiICgIULf4XWww+aYuVF92G4sAfevsXQrFkz6YIRERERABsXVFOnTkXt2rXh5OQET09PdOrUCVeuXLFlJLzxxhtwcy8Cw7ldovvQ+FWGtkgxLFz4q4TJiMjePH78GH9s2ABd5RDIZDJRfVjSjTBeOYDePXtALudnaERERFKz6W/Xffv2YciQIThy5AjCwsKQnp6OVq1aITk52WaZVCoV+n/QD2kXw2FJN4rqQyaTQVulFdasWYN79+5JnJCI7MWcOXNgEQDHSi1E95Fy5SDSUxLRv39/CZMRERHREzYtqLZv344+ffqgUqVKCAoKQmhoKO7cuYOTJ0/aMhY+/PBDpKckIeXyAdF9OFV7A4JChdmzZ0uYjIjsRUJCAmbMnAWHoDegcHQV3U/qmW0IDglBYGCgdOGIiIjIqkDN/0hISAAAuLu7Z/t9o9GIxMTELK+8ULp0aYS0aoWUs+If0CvXOMKh2puYN38+4uLiJExHRPbgp59+QkpqGpzrdhXdh+n+daREXcaQwYMlTEZERERPKzAFlcViwfDhw9GwYUNUrlw5232mTp0KFxcX68vPzy/P8gwZPBipUVdgjIkQ3YdzrQ5IM6Zj3rx5EiYjotddQkICps+YCYeqraDUZ/8BU04knd4Kb99iaNeunYTpiIiI6GkFpqAaMmQIzp8/j1WrVj13nzFjxiAhIcH6ioyMzLM8bdu2hbdvMRhObxXdh8LRDQ5VgjFz1mykpKRImI6IXmc///wzklNS4Vz3LdF9WIzJSL20D4M+HAilUilhOiIiInpagSiohg4dis2bN2PPnj0oXrz4c/fTaDRwdnbO8sorSqUSgz/6EKmX98GSZhDdj3OdLoiPj8fixYslTEdEr6vExERMnzETjkGtoXQqIrofw/lwCOZ0LkZBRESUx2xaUAmCgKFDh2LDhg0IDw9HyZIlbRnnGf379wcsZhj+CRPdh8rVG47lG+PbKVM5SkVEL/Xzzz/DkJycq3unBMGC1DNb0aljR/j6+kqYrnCaO3cuAgICoNVqUbduXRw7duyF+8fHx2PIkCHw8fGBRqNB2bJlsXWr+NkKRET0erNpQTVkyBAsW7YMK1asgJOTE2JiYhATE4PU1FRbxrLy8fFB9/e6I+XUJggZ6aL7cW7UHQ8ePMAPP/wgXTgieu1YR6eqtobSqajoflKvHUFabCQ+++wzCdMVTqtXr8bIkSMxceJEnDp1CkFBQWjdujUePHiQ7f4mkwkhISG4desW1q1bhytXrmDhwoUoVqxYPicnIqLCwqYF1fz585GQkIBmzZrBx8fH+lq9erUtY2UxevQXMCbEIvniHtF9qNx84Vi9Lb6dMgX379+XMB0RvU7mzJmDJIMhV/dOCYIAw9F1aNS4CerXry9husJp1qxZGDBgAPr27YuKFStiwYIFcHBweO407MWLF+Px48fYuHEjGjZsiICAADRt2hRBQUH5nJyIiAoLm0/5y+7Vp08fW8bKomLFimjfoQOSj2+AYDGL7selwTtIt8jw1VdfSReOiF4bSUlJ+H76DDhUaQWls/jRqbQ7/yD13lWMGztGwnSFk8lkwsmTJxEcHGzdJpfLERwcjMOHD2fb5s8//0T9+vUxZMgQeHl5oXLlypgyZQrM5udf//PrkR5ERFQwFYhFKQq6sWPGIC02EinXjojuQ6Fzhr7e2/hl4UJcunRJwnRE9DqYO3cukgwGuNQTPzoFAIaj61Claua0NnsXGxsLs9kMLy+vLNu9vLwQExOTbZsbN25g3bp1MJvN2Lp1K7788kvMnDkT33zzzXOPk5+P9CAiooKHa+nmQL169dC4SVOcOLYeDmUbQCaTierHqUZ7pJzdhs9HjcLmv/6SOCURFVYGgwHTvp8OhyohUDp7iO7HGBOBlJunMW7VKtHXKXtnsVjg6emJX375BQqFAjVr1kRUVBSmT5+OiRMnZttmzJgxGDlypPXrhIQElChRgiNVRET57Ml1VxCEfD0uC6ocGj9uLFq3bo2022ehC6gmqg+ZUgWnRr2w5c9p2LNnD5o3by5tSCIqlGbNmoXExET45HJ0KunoWviXLIW33spdP6+LokWLQqFQPHPv6v379+Ht7Z1tGx8fH6hUKigUCuu2ChUqICYmBiaTCWq1+pk2Go0GGo3G+nVsbCwAcKSKiMhGHj16BBcXl3w7HguqHAoJCUFQteq4dngVtP5Boj/9dSjfCLqTmzBi5Kc4dfIE5HLOuiSyZ3fu3MGUqd9BX7MDlM6eovsxPbyN5Ct/Y9aCBVmKAXumVqtRs2ZN7N69G506dQKQOQK1e/duDB06NNs2DRs2xIoVK2CxWKzX56tXr8LHxyfbYio77u7uADL/bfPzF7pYiYmJ8PPzQ2RkZJ4+31EqzJu3mDdvMW/eejJD4Ml1OL+woMohmUyGb76ejPbt2yPt5inoStUU3Y9zs344u3wUVqxYgR49ekiclIgKk88//xyCSgeXBu/mqp/Eg8vgV8K/QC3qUxCMHDkSvXv3Rq1atVCnTh388MMPSE5ORt++fQEAvXr1QrFixTB16lQAwKBBgzBnzhwMGzYMH3/8Ma5du4YpU6bgk08+yfExnxRiLi4uheIPkCecnZ2ZNw8xb95i3rxV2PLm94AFC6pX0LZtW9StVx//HFwKbcnqkMnE/WNpi1eEY7mG+GL0GHTt2hU6nU7ipERUGOzbtw9r1qxBkTdHQK5xEN2P8d4VJF89jPm//57jURR78c477+Dhw4eYMGECYmJiUK1aNWzfvt26UMWdO3ey/OL18/PDjh07MGLECFStWhXFihXDsGHD8MUXX9jqRyAiogKOBdUrkMlk+H7ad2jatClSrvwNx/KNRPfl0rQ3YhYNwo8//ojRo0dLmJKICoOMjAwMGfoxdMXKw7Fy7u6nTDywFOUqVET37t0lSvd6GTp06HOn+O3du/eZbfXr18eRI+JXdSUiIvvCG3heUZMmTRDSqhUMh5bn6rlUKjdfOFZri2++/RYPHz6UMCERFQYLFy7EhfPn4NJigOjRbgBIvXUGKbfO4Lsp3/LeqQJCo9Fg4sSJWRaqKMiYN28xb95i3rzFvDkjE/J7XUEJJSYmwsXFBQkJCfk6r/PkyZOoVasWirQZBn3VENH9mFMTEbNwILp364olS0KlC0hEBdq9e/dQoWIlWErUQpE3h4vuRxAEPFz+GSr6OOP4saP5ulS6ra6/REREBQ1HqESoWbMmunTtCsPhlRAyTKL7Ueic4dLsA/z++xJs2rRJwoREVFAJgoB+H3yANIscrs375aqv1GtHkBp1BdO+m8rnThEREdkICyqRpnz7LdKTHiHxRO4KIccqwXAsUxcf9B/AqX9EduDXX3/Fju3b4dL6Yyh04kd2hIx0JO0PRfMWLdGyZUsJExIREdGrYEElUrly5fDJxx/DcGQNMpJiRfcjk8ng1mooElNNGPjhh/n+ZGciyj83btzAsOEjoA9qBYfStXPVV+LJTTDFx+Dnn36UKB0RERGJwYIqF7766iu4OOmRsDc0V/0o9G5wCRmMjRs2YPny5dKEI6ICxWw2o2ev3rBonODWvH+u+spIegTD4TX4eOhQVKpUSaKEREREJAYLqlxwcXHB99O+g+HiXqTdvZCrvhzLNYS+UjMMGjIEkZGREiUkooLihx9+wN9/H4LrG8Ny9cwpAEjYFwpnvQO++uoracLRc5nNZnz55ZcoWbIkdDodSpcuja+//vqlswn27t2LGjVqQKPRIDAwEKGhoc/sM3fuXAQEBECr1aJu3bo4duyYTfL+8ccfCAkJgYeHB5ydnVG/fn3s2LEjyz5fffUVZDJZllf58uVtknfv3r3PZJHJZIiJicmyX0E5v3369Mk279MfhuTV+QWApKQkDB8+HP7+/tDpdGjQoAGOHz/+wja2ev+KyWvL96+YvLZ8/4rJm5/v3/3796N9+/bw9fWFTCbDxo0bs3xfEARMmDABPj4+0Ol0CA4OxrVr117a78vOZVpaGoYMGYIiRYpAr9eja9euuH///itlZ0GVS3369EHNWrWRuPuXXC2jDgCuwR8hXaZG3379OPWP6DVy4cIFjBkzFk61OkJbokqu+kq7exGGC3vw/bTv4OrqKk1Aeq5p06Zh/vz5mDNnDi5duoRp06bh+++/x88///zcNjdv3kTbtm3RvHlznDlzBsOHD0f//v2z/JG3evVqjBw5EhMnTsSpU6cQFBSE1q1b48GDB/med//+/QgJCcHWrVtx8uRJNG/eHO3bt8fp06ez7FepUiVER0dbXwcPHsxVVrF5n7hy5UqWPJ6entbvFaTz++OPP2bJGRkZCXd3d3Tr1i3LfnlxfgGgf//+CAsLw9KlS3Hu3Dm0atUKwcHBiIqKynZ/W75/xeS15ftXTN4nbPH+FZM3P9+/ycnJCAoKwty5c7P9/vfff4+ffvoJCxYswNGjR+Ho6IjWrVsjLS3tuX3m5FyOGDECf/31F9auXYt9+/bh3r176NKly6uFFwqxhIQEAYCQkJBg0xxHjx4VAAjurQYL/l9sztXL8+3JAgBh7ty5Nv2ZiEgaRqNRqBpUTdB6lBBKfPpHrq4PJT7fJOi8SwvVa9QUzGazTX+ugnL9zWtt27YV+vXrl2Vbly5dhPfff/+5bUaNGiVUqlQpy7Z33nlHaN26tfXrOnXqCEOGDLF+bTabBV9fX2Hq1Kn5njc7FStWFCZNmmT9euLEiUJQUFCusmVHTN49e/YIAIS4uLjn7lOQz++GDRsEmUwm3Lp1y7otr85vSkqKoFAohM2bN2fZXqNGDWHcuHHZtrHl+1dM3uzk1/tXTF5bvn+lOL/59f4FIGzYsMH6tcViEby9vYXp06dbt8XHxwsajUZYuXLlc/t52bmMj48XVCqVsHbtWus+ly5dEgAIhw8fznFejlBJoE6dOujTpw+SDi6DOTk+V33pStaAU/U3MfLTz3I0jElEBds333yD8+fPwfXNkZAp1bnqy3BmG1JjrmP+vLmQy3n5zg8NGjTA7t27cfXqVQDA2bNncfDgQbRp0+a5bQ4fPozg4OAs21q3bo3Dhw8DAEwmE06ePJllH7lcjuDgYOs++Zn3vywWC5KSkuDu7p5l+7Vr1+Dr64tSpUrh/fffx507d3KVNbd5q1WrBh8fH4SEhODQoUPW7QX9/C5atAjBwcHw9/fPsj0vzm9GRgbMZjO0Wm2W7Tqd7rkjCLZ8/4rJ+1/5+f7NTV5bvH+lOL/5+f592s2bNxETE5PlvLi4uKBu3brPPS85OZcnT55Eenp6ln3Kly+PEiVKvNL55m9kiUybNg16rQpxO+fmerqea7N+kDm4oUfPXjCbczeNkIhs5/jx4/h2yhQ41XsHGu/AXPWVHheNxP1LMHDgQNStW1eihPQyo0ePxrvvvovy5ctDpVKhevXqGD58ON5///3ntomJiYGXl1eWbV5eXkhMTERqaipiY2NhNpuz3ee/91HkR97/mjFjBgwGA95++23rtrp16yI0NBTbt2/H/PnzcfPmTTRu3BhJSUn5ntfHxwcLFizA+vXrsX79evj5+aFZs2Y4deoUABTo83vv3j1s27YN/ftnXZgmr86vk5MT6tevj6+//hr37t2D2WzGsmXLcPjwYURHR2fbxpbvXzF5/ys/379i8try/Zvb85vf79+nPfnZX+W85ORcxsTEQK1WPzOF/lXPtzLHe9ILeXp6YtGvC9GlSxdoL4RDX1n8c2Hkai1c2ozA8RVfYPr06Rg9erSESYkoP6SmpqL7+z2g8SoNl/pvv7zBCwgWM+K3zYavjzdmzpwpUULKiTVr1mD58uVYsWIFKlWqZL2nxNfXF71797Z1vGfkNu+KFSswadIkbNq0Kcs9HU+PwFStWhV169aFv78/1qxZgw8++CBf85YrVw7lypWzft2gQQNcv34ds2fPxtKlS0Vnyau8T1uyZAlcXV3RqVOnLNvz6vwCwNKlS9GvXz8UK1YMCoUCNWrUwHvvvYeTJ0/mqt+8kpu8+f3+FZPXlu9fMXmfZov3b2HBESoJde7cGT169ETC7l+QkZi7Gwe1xSvAqU4XfPnlhGdurCSigm/UqFG4cfMW3NqMgEyRu8+uEo9vQOrdS1j2+xLo9XqJElJOfP7559ZRiSpVqqBnz54YMWIEpk6d+tw23t7ez6wQdf/+fTg7O0On06Fo0aJQKBTZ7uPt7Z3veZ9YtWoV+vfvjzVr1jwz5eu/XF1dUbZsWURERNgs79Pq1KljzVJQz68gCFi8eDF69uwJtfrF03+lOr8AULp0aezbtw8GgwGRkZE4duwY0tPTUapUqWz3t+X7V0zeJ2zx/s1N3qfl1/s3N3lt9f594snP/irnJSfn0tvbGyaTCfHx8TnuNzssqCT2888/wcPdFXHbfoIgWHLVl2uj96Hy8EfHTp3x6NEjiRISUV5btGgR5syZA9fmH0BV1C9XfZke3kLiweX47LPP0LhxY4kSUk6lpKQ8c7+aQqGAxfL863v9+vWxe/fuLNvCwsJQv359AIBarUbNmjWz7GOxWLB7927rPvmZFwBWrlyJvn37YuXKlWjbtu1Lj2MwGHD9+nX4+PjYJO9/nTlzxpqlIJ5fANi3bx8iIiJy9Im9VOf3aY6OjvDx8UFcXBx27NiBjh07ZrufLd+/YvICtnv/is37X/n1/s1NXlu/f0uWLAlvb+8s5yUxMRFHjx597nnJybmsWbMmVCpVln2uXLmCO3fuvNr5zvHyFQVQQV1lKiwsTAAguAV/mOtV/4p9tFhQOboILVq0FNLT0239oxHRS+zdu1dQKlWCU/U2QolRf+VuVb/PNgg679JC+QoVhdTUVFv/aFkU1Ouv1Hr37i0UK1ZM2Lx5s3Dz5k3hjz/+EIoWLSqMGjXKus/o0aOFnj17Wr++ceOG4ODgIHz++efCpUuXhLlz5woKhULYvn27dZ9Vq1YJGo1GCA0NFS5evCgMHDhQcHV1FWJiYvI97/LlywWlUinMnTtXiI6Otr7i4+Ot+3z66afC3r17hZs3bwqHDh0SgoODhaJFiwoPHjzI97yzZ88WNm7cKFy7dk04d+6cMGzYMEEulwu7du2y7lOQzu8TPXr0EOrWrZttv3l1fgVBELZv3y5s27ZNuHHjhrBz504hKChIqFu3rmAymbLNa8v3r5i8tnz/islry/evmLxP5Mf7NykpSTh9+rRw+vRpAYAwa9Ys4fTp08Lt27cFQRCE7777TnB1dRU2bdok/PPPP0LHjh2FkiVLZvn92KJFC+Hnn3+2fp2Tc/nRRx8JJUqUEMLDw4UTJ04I9evXF+rXr/9K2VlQ5ZHBgwcLCrVG8B3wv1wXVV7vThFkckWWCzYRFTzXr18XXN3cBYeAIKHEZxtz/f995/rvCAqlUjh16pStf7RnFOTrr5QSExOFYcOGCSVKlBC0Wq1QqlQpYdy4cYLRaLTu07t3b6Fp06ZZ2u3Zs0eoVq2aoFarhVKlSgm//fbbM33//PPPQokSJQS1Wi3UqVNHOHLkiE3yNm3aVADwzKt3797Wfd555x3Bx8dHUKvVQrFixYR33nlHiIiIsEneadOmCaVLlxa0Wq3g7u4uNGvWTAgPD3+m74JyfgUhc2lmnU4n/PLLL9n2m1fnVxAEYfXq1UKpUqUEtVoteHt7C0OGDMlSbBSk96+YvLZ8/4rJa8v3r5i8gpB/798nS8o/79/SYrEIX375peDl5SVoNBqhZcuWwpUrV7L04e/vL0ycODHLtpedy9TUVGHw4MGCm5ub4ODgIHTu3FmIjo5+pewyQSi8T5BNTEyEi4sLEhIS4OzsbOs4WSQnJ6NqUDVEpynh0X0aZHJFrvpLPL4RceG/YvXq1VlWriGigiEhIQF169XH7YeJKPr+DCh0Trnqz3jvCu4v+xyTJ0/C+PHjJUopnYJ8/SUiIspPvIcqjzg6OmL5sqUwRl9F4tH1ue7PqVZH6Cs2Q+8+fXHu3DkJEhKRVMxmM955911cvx0J987jc11MWdLTEL9tNmrUrMlVPomIiAo4FlR5qF69evjiiy+QeGgFTPdv5KovmUwGtzeGQubijTfavIm7d+9KlJKIcuvzzz/Hzp1hcG//BVRFcrcIBQDE71sCS1Isli39HUoln25BRERUkLGgymNfffUVKlasiLitsyBkpOeqL7lKC/cuE/Ao2YTgkFZ4/PixRCmJSKxff/0Vs2fPhmuL/tCVrJ7r/lJvnUHSyb8w/ftpKF++vAQJiYiIKC+xoMpjarUay5ctRcbjKMQfXJ7r/pRORVHkrcm4EXkPb7Zth5SUFAlSEpEY+/btw0eDBsGp+ptwqtEu1/1ZjMlI2PETmjRrhqFDh0qQkIiIiPIaC6p8ULVqVXzzzddIPLYeaXcv5ro/VZHiKNJ1Ik6ePoO3unVDenruRr6I6NVdv34dnTp3gcavMtxaDoRMJst1n3G7foHSnIqlS5Y886wbIiIiKpj4GzuffPbZZ6hbtx7it8yAOSUh1/1pfMrCveMY7NixE/37D0AhXqyRqNBJSEjAm23bIU2ug3v7LyBT5P4+J8OFPTCc3405P/2EEiVKSJCSiIiI8gMLqnyiUCiwds1qOCosePzXdAgWc6771JWsAfc3R+D335fgiy++kCAlEb1MWloaOnfught37sK985e5XtEPAEz3ryN+xxz06tUbvXv3liAlERER5RcWVPnIz88P69etRVrkOcTvWyJJn44Vm8Kt5UBMnz4dM2bMkKRPIspeeno63urWDfsPHUKRzuOhKlI8132aUxLweNMUVKlcCQsWzJdk6iARERHlHxZU+axZs2aYOWMGEo/9geRL+yXp07lWBzjXfxuff/45fv/9d0n6JKKszGYzevTogW3btqNIx7HQ+lXOdZ+CxYzHm2f8X3t3Hh1VlWhx+FeVsTJCZpAwEwbBMEeIzCgiIrSKUQYZFGxFWkFtQVGQtkEfaqOioqAgtLMYUEAUwyCCAoIggggBgiFhSEjInFRV6r4/0vLkaXdrrMrNsL+1aoG3i3N2LXsdszm3ziXA4mT1qmRsNpsbkoqIiEhV0gNOTHDPPfewc+cu3l35HD4RjfGNbPqHx6zXawyu4vOMnzCB8PBwhgwZ8seDiggALpeLSZMm8d77K4m47kFszbu4Zdzzny+n9MdvWbNhg743JSIiUkNph8oEFouFJUsW07Z1HDmr/k55aaFbxgy7ajK2Ft254cYRbN++3Q1JRcQwDKZNm8Zrr71G2OB7CGjd0y3jFn2/lfwdK5n/P/9Dv3793DKmiIiIVD0VKpMEBATw4epV+LtKyVk9D6P8jx99brF6EXbt/XhFteDqwdewY8cONyQVqbtcLhdTp07l2WefJeyquwhq398t45adOkLu+mdJSkpi6tSpbhlTRKSyli9fTnh4OGVlZRddHz58OGPGjDEplUjNoUJlombNmvHh6lU4Mr4nZ/1Ctxx9bvXxI/z6RygPvYT+AwawefPmPx5UpA6y2+2MHj2GZ597jrCr7iK40zVuGdeZd4ac5Dl07hjP0qVLdQiFiJhuxIgRlJeX8+GHH164dvbsWdauXcuECRNMTCZSM6hQmax3794sW7aUwu9SyNv+tlvGtPoFEn7jHIhqxaCrB7Nu3Tq3jCtSVxQWFnLt0KG88957RFz3oNvKVHlpIedWPkaD8Hqs+ehDHUIhItWCzWZj5MiRLF269MK1f/7znzRu3Ji+ffuaF0ykhlChqgZGjhzJ448/Tt4Xb1D4XYpbxrT6+hNx/aP4NO7IsGHDef/9990yrkhtl52dTd9+/dn0+RdE3DibwDZXuGVco9xBzqq5+DkK+PST9URFRbllXBERd5g4cSKffvopGRkZACxbtoxx48ZpF13kN1ChqiYeeughJkyYQO765yk5sc8tY1q8fQkfNh2/uJ4kJSWxbNkyt4wrUludOHGCHj0T2X8olYikudiaxLtlXMMwyFn/PI7MQ3z04Wri4uLcMq6IiLt06tSJ+Ph4li9fzu7duzlw4ADjxo0zO5ZIjaBj06sJi8XCokWLOPHjj2xZPY/IW57EN7LJHx/Xy5vwIdPI8fFn/PjxpKWl8eijj2K1qkuL/NyBAwcYeOVV5JYaRIx8Ep/6Dd02dsXu80beeustevXq5bZxRUTc6fbbb2fBggVkZGQwcOBAYmNjzY4kUiPop+pqxMfHhw9WrqR1i2ace28mjux0t4xrsXoRNuhu6vW+lccee4ykpCSKi4vdMrZIbbBt2zZ6JCaSZ/i7v0x99R5529/miSee4Oabb3bbuCIi7jZy5EhOnjzJ4sWLdRiFyO+gQlXNhISEsGljCi1iG5L97kPuK1UWC6E9biJy+EMkf7iGxCt6XbhPWqQuW7NmDf0HDKQ8NJaIm+fhHRTmtrHzvnqP81teZ9asWTz44INuG1dExBNCQ0O54YYbCAoKYvjw4WbHEakxVKiqocjISLZs3uT2UgUQ0LonUSOf5Ptj6XTu0pWvv/7abWOL1DTLli1j2PDh+DTpRMSIOVj9At029s/L1OzZs902roiIJ2VkZDBq1Cj8/PzMjiJSY6hQVVOeLFW+0S2IGP00Bd71SLyiF++++67bxhapCQzD4O9//zvjx48noP1AwodNx+Lt67bxVaZEpKbJzc0lOTmZzZs3M3nyZLPjiNQoKlTVmCdLlXdQGBFJf8enRQJJSUnMnj3bLQ8WFqnuCgoKuOHGG5k5cyahibcQNuhuLFYvt42vMiUiNVGnTp0YN24cTz75JK1btzY7jkiNYjFq8E/R+fn5hIaGkpeXR0hIiNlxPCYrK4s+fftxND2TiJvm4hPhvlN3DMMg/8t3Ob91BSNGjGDZsmUEBAS4bXyR6uTIkSMMvW4YR9NOUH/wVALierh1/LpUpurK+isiIvLfaIeqBvDkTpXFYiG0ZxIRw2fwweqPuKJXbx1WIbXS2rVr6dy1KyeyC4ka9bTKlIiIiLiFClUN4clSBRDYOpHIW57gwNETdOnajZ07d7p1fBGzlJeXM2fOHIYOHYoR3Y7I0U+7dZcXVKZERETqMhWqGsTTpcovpiWRo58h3yuUHj17Mnv2bBwOh1vnEKlKR48e5YpevZk1ezYhiSMJ/9NDWP3ce0urypSIiEjdpkJVw3i6VHkHhRF5yxMEJ9zEnL89TveEyzl48KBb5xDxNMMwWLRoER0ui+ebH44Tfcs86iXegsXi3iVPZUpERERUqGqg/1+q7Flpbh3f4uVNvV6jiB49n0Mns+jYqTPPPPMMLpfLrfOIeEJGRgaDrr6aO++8E6+4XkSNfQ7/2PZuncMwDPK2v6MyJSIiItWjUL3wwgs0bdoUf39/EhIS9P2d3+CnUhXXNJasNx+kJG2v2+fwaxBH5JgF+F92Nffddx+9+/Tl+PHjbp9HxB0Mw+DNN9+kbbtL2fLVbqJunE34oLux+trcO4+rnJxPX+D81hU89thjKlMiIiJ1nOmF6p133mHatGnMmjWLPXv2EB8fz6BBgzh79qzZ0aq9yMhItn2xlX69E8l+fxaF+z9z+xxWHz/CBkwk+pa5fH3gMO07dGDJkiV6ZpVUK9nZ2dw4YgSjRo3CaNSRqHELsbXo6vZ5XGXFZK+cQ8l3n/Hqq6/y6KOPun0OERERqVlMfw5VQkIC3bp1Y+HChQC4XC5iY2OZMmUK06dP/49/Vs9BqeBwOLjrrrtYsmQJoT1vIfSKkVgsFrfP4yorJnfjYgq/3cDga67h1SVLaNCggdvnEfk91qxZw/gJt5FXVErowDsJbNvLI/M4C7LJ+eBvWIvOkrxyJVdeeaVH5qkptP6KiIhUMHWHym63s3v3bgYOHHjhmtVqZeDAgXz55Ze/eH9ZWRn5+fkXvQR8fHx45ZVXmDdvHnnb3yJn3T8wyt1/Op/VL4DwwfcQecMjpGz9irbtLuXdd991+zwiv0V+fj4TJkxg6NChlIQ2IWr8Qo+VKfvZ42S/8QD1rKV8uW1bnS9TIiIi8n9MLVTZ2dmUl5cTHR190fXo6GhOnz79i/fPmzeP0NDQC6/YWPc+S6Yms1gsTJ8+nbfeeouyH74g+71ZlJd4pnAGtEwgatzzOGPakZSURFLSzZw6dcojc4n8f4ZhsG7dOi5t34EVb75D2NVTCL/+UbyDwjwyX8mx3WS99SBxTRry9a6ddOjQwSPziIiISM1k+neofo8ZM2aQl5d34ZWe7t4jw2uDm2++mZSUz/AryCBrxTTsZ455ZB6vgFDCr5tO+LX3kbx2PS1btWL+/PnY7XaPzCcCsHfvXgYMGMiQIUPI8apP1LjnCI4f5JFbXA3DIO/Ldzn7/myu7N+XbV9spWHDhm6fR0RERGo2UwtVREQEXl5enDlz5qLrZ86cISYm5hfv9/PzIyQk5KKX/FKvXr34Zs9u2jRpwNk3H6DwwCaPzGOxWAi6tB/Rty3Cq01/Hpw+g3aXtmfdunUemU/qrpMnTzJ27Dg6d+7Ml/uPEHnDI0Tc9Dg+9X65TriDq6yYc6uf4Pzny3lk5kzWfPQRwcHBHplLREREajZTC5Wvry9dunQhJSXlwjWXy0VKSgo9evQwMVnN16RJE77cvo2RSUmcW/M0OSmLMcqdHpnLyxZM2MA7iBn3LKecAQwZMoRrhgzhyJEjHplP6o6CggJmzpxJi5atePuD1dS/8k6ixj1PQMsEj+xKAThyMsh68wHI2EdycjJz5szBaq1Rm/kiIiJShbzNDjBt2jTGjh1L165d6d69OwsWLKCoqIjx48ebHa3Gs9lsvP76Mrp378a9U6dSnnWMsKEP4hVYzyPz+UY2JeKmxyk+vJ2NW16jbbt2jBs7locffphmzZp5ZE6pnZxOJ0uWLGHmI49yPi+fwK7DCE24EatfgEfnLU7dSe7ap2kaewkfbdlFmzZtPDqfiIiI1HymH5sOsHDhQubPn8/p06fp2LEjzz33HAkJCf/1z+nY3t9u69at/On6Gyh0QL3BU/FvcplH53M5yij8Zi1Fu5IpLy1g7K238vDDD9O8eXOPzis1m2EYrF27lmn33c+RI4cJurQ/ob1G4x0S6dl5nQ7Ob3uD/K/e57phw1ixfLnWlP9C66+IiEiFalGoKkv/Qf99MjIyuPmWkXyx9XOCu1xHvT5jsfr4eXROl6OUwm8+pujrZJzFedw6ZkzFLVwtWnh0Xql59uzZw9T77uPzzZsJaBpPSJ/x+MW09Pi89rPHOb/uHzjOpfO3v83hr3/9q27x+w20/oqIiFRQoapjXC4Xzz33HA9On4E1JJJ6g6fi1yDO8/M6Sincu56iXR/gLM5jzOgxzJz5MC1bev4HZqnevvnmG+bNe4L33nsX/8jGBPcZj615V499R+onhquc/J0fkP/FG7Rp04Y33/gn8fHxHp2zNtH6KyIiUkGFqo76/vvvGTV6DHv37iXk8hGE9rwZi5fnv1LncpRRuG89RTtX4izOY9TIUTzyyExatWrl8bml+jAMgy1btjB33jw2fPopfmENCOx2A0GXXYnF6uXx+R05GeR+vIDSzB/46wMP8Nhjj+Hn59nd2tpG66+IiEgFFao6zOFwMHfuXP72+OP4Rjal3uCp+EY2qZK5K4rVJxTtWomzMJeR/ypWcXGe3y0T87hcLj766CP+Pnceu3buwBbdnMDuNxDQ5ooqKVKGYVD4zTrytiyl0SUNeWPFchITEz0+b22k9VdERKSCCpWwe/duRo0eQ2rqUYKvGE1It2FV8sMtgOG0U7Dvk4odq8IcrhkyhEkTJzJ48GC8vU0/hFLc5MyZMyxfvpxFryzmWOoRAhq3J6j7DfhXwa19P3HmZ5O7/lmKj3/Dn//8Z+bPn09QUFCVzF0baf0VERGpoEIlAJSWljJz5kyeeeYZbLGXUm/wvR57aOqvMZx2Cvd/Rsn+Tyk5lUpUdAy3TRjPhAkT9D2rGsrpdPLJJ5+weMkS1qxZg4EVW1wPgjoNwb9RuyrLYRgGRQc3k5fyMuGhwby+bCmDBg2qsvlrK62/IiIiFVSo5CJbtmxhzK1jyTxzltC+txEUP6jKdhB+UnY6lcJvN1B6aAvOkkJ69e7DHZMmcv3112Oz2ao0i/x+x44d47XXXmPJa0s5cyoTW0xz/NtfSWC7vnjZgqs0S3lxHrmfvkDRD9sZOXIUCxc+T/369as0Q22l9VdERKSCCpX8QkFBAVOnTuXVV18loEVX6g+agndweJXncDnKKD68nZL9Gyg+8S3BIaHcOmY0t912G506daryPPLvlZaWkpyczMuvLGbL5k14+wfi36Y3QfGD8I1uUeWlHKD4yA7yPl1IgI+Fxa+8zI033ljlGWozrb8iIiIVVKjk31q7di3jJ9xGbn4hwT1uJrjL0Co5CfDXOHIzK3atDm7Enn+O+I6dmDTxdkaOHEm9evVMySSwb98+Xn31VV5fvoL8vPMENO6ArcNAAlonYvXxNyWT4/xp8ja9StHhLxly7bUsWbyYmJiqu321rtD6KyIiUkGFSv6jnJwcZs6cycsvv4xveCNC+k3E1sy83SHDVU7Jsa8p/nYDxUd34ePjw6BBV/Gn4cO59tpriYyMNC1bXWAYBnv37mXVqlWsTF7Fgf3f4hschn+7fgR1uBKf8EamZXM5Ssn/6n0Kdn5AVGQE/3jmaZKSkkzZHasLtP6KiIhUUKGS32Tfvn1MvnsK277YSmBcD0L73Valh1b8GmdhDkUHNmE/uoPik99jtVi4vEdPrv/TcIYNG6bDLNzE4XCwZcsWVq9ezQerVpN5Mh0fWxC+zboQ0KZXxUN4Tdq5hIqSV/zDNgq2vIar6DwPPHA/Dz30EIGBgaZlqgu0/oqIiFRQoZLfzDAM3nnnHe6ddh/Z2ecI6nY9IQk3YPU159aunysvyqU4dSdlqTsoSduLy2mnVes2XH3VlfTv358+ffroMILfyDAMDh06xMaNG0lJ2ciGzz6jsCAfv3pR+Dbvjq3V5fjHtje1RP3EnpVG3sbFFKftY8i11/LsggW0aNHC7Fh1gtZfERGRCipU8rsVFhYyb9485s9/Cot/IIEJNxHc8WosXj5mRwPAZS+lNG0PJUe/xnnyO0pzMrFarVzWsRNXDRxA//79SUxM1DOI/sUwDNLS0ti8eTMpKSl8+lkKWWdOY/Xyxv+SNvjEXkZAqwR8oppXm9vnHOdPk//FGxQe3Ezz5i1Y+PxzDB482OxYdYrWXxERkQoqVFJpaWlpzJo1m3/+cwU+oVEE9biFwEv7VtlDgX8rZ94ZSk/so/TEPhzp+7EX5GC1Wolr3ZYel3ene/eKV4cOHfDxqR6l0JPOnTvHrl272LlzJzt27OCrnbvIyc4Ci4WABi3xbtQB/ybx+DW6tFrsPv6cszCHvO3vUPztJ4SHhzN71qPcfvvt+Pr6mh2tztH6KyIiUkGFSv6wgwcP8vDMmaxKTsY/sjHBiaOxxfWoNrsZP2cYBo5z6ZRlHMJ+6jCus6mUnDmO4SrHx9eP+Ph4LuvQnpYtW154tWjRosb9/8vlcpGZmcnRo0dJTU0lNTWVI0eOsPPrPaSfOA6AT0AwPjGt8IluhW+DOPwatavy50T9VuUlBeTvWEnRNx8RaLPx0IzpTJkyhYCAALOj1Vlaf0VERCqoUInb7Nq1ixkzHiIl5TNsDeMIuvwmbC27Y7FYzY72H7kcZTjOHqPs1GHsp1MxzmfiyMnEUVJw4T1hEZG0atmS1nGtLipaLVu2JCwszJTc5eXlpKenXyhMFaUplUOHD5N2/Dj2stKKN1os+NePxhoSg1dEE/waxOHbIA7vejHVsvT+XHlJPgW7P6Joz0f4WFxMmzqV+++/X0flVwNaf0VERCqoUInbbdq0iZmPPMr2bV/gH9WEwG7XE9i2T7U4xOD3KC8pwJmbifP8KRy5p3CeP4WRdxrn+VPYC3IvvC8ktB5Nmzajfv16hAQHERRU8QoMDPzV3//8n319fSkqKqKoqIjCwkIKCwsv+v2v/XNeQSGnT58h/cc0nA4HABYvL/zrx2AJicGrXgO86zfAu35DfOo1wDs0Got3zbqV0ZmfRf6uVRR/+wneVgt/vmMSM2bMIDo62uxo8i9af0VERCqoUInHbNu2jbnz5rFu7Vr86kUR0PVPBF12pWkPfHUnV1nx/xWt3EyceWdx2UswHCVYnGXgKAVnKS57KS57Cc6yElxOx28e39vPhpevDauvPxYff/DxB++KXy0+flhtIfjUb3ihOHmHRFa7765VhuNcOvk7VlJ8cDOBgYHce89fmDJlip4vVg1p/RUREamgQiUet3//fp544knefudtvPyDCOh0LcHxV+MVVLeOMTfKnRiOipJlOEpwOcownA6svn5YfH4qTzYsPr7V/jZJdzIMg7KMgxR+vZqiw18SHR3DA/ffx6RJkwgOrp7f6RKtvyIiIj9RoZIqc/z4cZ566imWvPoaDqeDgLieBHW8Br/Y9tX+uzzifq6yYooObKJ438eUnk2jeYuWzJj+IGPGjMHPz8/sePJfaP0VERGpoEIlVS43N5fXX3+dhS++xNEjh7FFNcH/sqsJat8fq1+g2fHEw+xnj1HwzTpKv/8cl7OMoUOHMvmuuxgwYABWa93ZmavptP6KiIhUUKES0xiGwaZNm3jxxRdZtXo1WL2xtelNYIcB+F3STrtWtYirrJjiH76geP8GSk5+T3RMA/58xyRuv/12GjVqZHY8qQStvyIiIhVUqKRaOHXqFEuWLGHRK4vJPJmOX/0Y/Nv0IbB9f3zCLjE7nlSCUe6k5Pgeig9upjR1By6nnX79+jN58l0MHTq0TjxEuTbT+isiIlJBhUqqFZfLxdatW1mxYgVvv/suRQUF2C5pjX/bvgS27Y1XQKjZEeU/MAwD++kjFB3YRNkPW7EXnqdNu0sZP/ZWRo4cqd2oWkTrr4iISAUVKqm2SkpKWLNmDa8vX8769esxDAP/xh3wb3k5tpaX4x0SYXZEAQxXOWWZP1By5CvsR3dQei6DyOgYbh09itGjRxMfH6/bN2shrb8iIiIVVKikRsjKyuK9997jgw+S2bxlM+VOJ7aGcfi1SMDW6nJ8Ihrrh/YqZDjtlJzYR8nhL7Ef24W9MJewiEhu+NNwbrzxRgYMGICXV81/Lpb8e1p/RUREKqhQSY1z/vx51q1bR3LyKtZ9vI7ioiL8wy/Bp2ln/Jt0xL9xe50W6GaGYeDMzaT0xD5KT+zFnvYNzrISmrVoyYgbrmfYsGEkJCSoRNUhWn9FREQqqFBJjVZaWsqmTZtYtWoVaz9eT0b6j1gsVmwNW+Ed2wH/xvH4NWqL1cff7Kg1jjM/i9IT31J6Yi/Ok/spy8vGy9ubrl27Mey6oQwfPpw2bdpoZ7CO0vorIiJSQYVKag3DMDh+/DgbN24kJSWFTz9LISc7C6u3D/4NW+MdE4dvw9b4NYjDKzhCReBnjHIH9qwT2E8dpizzMOWnvqf0XAYWi4X2l8Vz1cABDBgwgCuuuILg4GCz40o1oPVXRESkggqV1FqGYXDgwAE2btzI5s1b+GrHTk5lngTALyQMr+hW+MbE4dsgDt+oZlgDQutEyTJc5ThzT1F2+gj2U4cpP5NK6emjuJx2vLy9ubR9B67o2YP+/fvTt29fwsPDzY4s1ZDWXxERkQoqVFKnnDp1il27drFz506+2rGDHTt2UliQD4BvYCjeYY2whsXiEx6LT0TFrzV1N8twOnDkZuDI/hFHdjqOnHSM3JOUncvA5XQA0LR5SxJ7JNC9e3e6d+9OfHw8NpvN5ORSE2j9FRERqaBCJXWay+UiNTWV7777joMHD3Lw4EH2f3eQw4d/wF5WCoC3nw2f0CgsQRFYgyPxConAOyQS75BIvEKi8Aqsh8Xbr0pLl1HuxGUvprzgHM78LMrzs3AWZOHMz4LCbFwF2ZSdz8IwXACER0Zxabu2tL/0Utq1a0fbtm3p2LEjYWFhVZZZahetvyIiIhVUqER+RXl5OWlpaXz//fccOnSIH3/8kR9/TOd42gl+TP+R8znnLnq/1dsHH1swXrYg8A3E8A3E4h+Il38QFi9f8PbBYvXG8rNfsXqDxYrhKMVwlOJylGLYSzAcZbjsJRiOUizOMnCWwr+uldtLKLeXXthh+omXtzcxDS6haZPGNGvahNjYWJo1a0bbtm1p27atbtsTt9P6KyIiUkGFSqQSiouLOXnyJCdOnODs2bPk5ub+4pV9Loec3POUlpZgt9uxl9mxO+w47HYcDgcOexkAfv42AgIDCQgIICgoiOCgYIKDAgkJCSYwMJCgoCCCgoJ+9feXXHIJjRs3Jjo6WkeWS5XS+isiIlLB2+wAIjVRQEAAcXFxxMXFVXoMwzAwDAOr1erGZCIiIiJSlVSoRExisVhq5GEXIiIiIvJ/9FfjIiIiIiIilaRCJSIiIiIiUkkqVCIiIiIiIpWkQiUiIiIiIlJJKlQiIiIiIiKVpEIlIiIiIiJSSSpUIiIiIiIilVSjn0NlGAYA+fn5JicREalbflp3f1qHRURE6qoaXagKCgoAiI2NNTmJiEjdVFBQQGhoqNkxRERETGMxavBfL7pcLjIzMwkODsZisZgdp9Ly8/OJjY0lPT2dkJAQs+NUKX12ffa69tmhdnx+wzAoKCigYcOGWK26e1xEROquGr1DZbVaadSokdkx3CYkJKTG/nD1R+mz67PXRTX982tnSkRERIdSiIiIiIiIVJoKlYiIiIiISCWpUFUDfn5+zJo1Cz8/P7OjVDl9dn32uqiuf34REZHapEYfSiEiIiIiImIm7VCJiIiIiIhUkgqViIiIiIhIJalQiYiIiIiIVJIKlYiIiIiISCWpUFUjaWlp3HbbbTRr1gybzUaLFi2YNWsWdrvd7Gge88ILL9C0aVP8/f1JSEhg586dZkfyuHnz5tGtWzeCg4OJiopi+PDh/PDDD2bHMsUTTzyBxWLh3nvvNTtKlcjIyGD06NGEh4djs9no0KEDX3/9tdmxRERE5A9QoapGDh06hMvl4uWXX+bAgQP84x//YNGiRTz00ENmR/OId955h2nTpjFr1iz27NlDfHw8gwYN4uzZs2ZH86gtW7YwefJkvvrqKzZs2IDD4eCqq66iqKjI7GhVateuXbz88stcdtllZkepErm5uSQmJuLj48PHH3/MwYMHefrpp6lfv77Z0UREROQP0LHp1dz8+fN56aWXOHbsmNlR3C4hIYFu3bqxcOFCAFwuF7GxsUyZMoXp06ebnK7qZGVlERUVxZYtW+jdu7fZcapEYWEhnTt35sUXX+Txxx+nY8eOLFiwwOxYHjV9+nS2bdvG1q1bzY4iIiIibqQdqmouLy+PsLAws2O4nd1uZ/fu3QwcOPDCNavVysCBA/nyyy9NTFb18vLyAGrlv+d/Z/LkyQwZMuSif/+13YcffkjXrl0ZMWIEUVFRdOrUicWLF5sdS0RERP4gFapqLDU1leeff5477rjD7Chul52dTXl5OdHR0Rddj46O5vTp0yalqnoul4t7772XxMRE2rdvb3acKvH222+zZ88e5s2bZ3aUKnXs2DFeeuklWrVqxSeffMKdd97JX/7yF15//XWzo4mIiMgfoEJVBaZPn47FYvmPr0OHDl30ZzIyMrj66qsZMWIEEydONCm5eNrkyZP57rvvePvtt82OUiXS09O55557eOONN/D39zc7TpVyuVx07tyZuXPn0qlTJyZNmsTEiRNZtGiR2dFERETkD/A2O0BdcN999zFu3Lj/+J7mzZtf+H1mZib9+vWjZ8+evPLKKx5OZ46IiAi8vLw4c+bMRdfPnDlDTEyMSamq1t13382aNWv4/PPPadSokdlxqsTu3bs5e/YsnTt3vnCtvLyczz//nIULF1JWVoaXl5eJCT2nQYMGtGvX7qJrbdu2ZeXKlSYlEhEREXdQoaoCkZGRREZG/qb3ZmRk0K9fP7p06cLSpUuxWmvnJqKvry9dunQhJSWF4cOHAxV/g5+SksLdd99tbjgPMwyDKVOmkJyczObNm2nWrJnZkarMgAED2L9//0XXxo8fT5s2bXjwwQdrbZkCSExM/MXx+IcPH6ZJkyYmJRIRERF3UKGqRjIyMujbty9NmjThqaeeIisr68L/Vht3baZNm8bYsWPp2rUr3bt3Z8GCBRQVFTF+/Hizo3nU5MmTefPNN1m9ejXBwcEXvjMWGhqKzWYzOZ1nBQcH/+K7YoGBgYSHh9f675BNnTqVnj17MnfuXG666SZ27tzJK6+8Umt3oUVEROoKFapqZMOGDaSmppKamvqLW8Bq4+n2SUlJZGVl8eijj3L69Gk6duzI+vXrf3FQRW3z0ksvAdC3b9+Lri9duvS/3hoqNVe3bt1ITk5mxowZzJkzh2bNmrFgwQJGjRpldjQRERH5A/QcKhERERERkUqqnV/QERERERERqQIqVCIiIiIiIpWkQiUiIiIiIlJJKlQiIiIiIiKVpEIlIiIiIiJSSSpUIiIiIiIilaRCJSIiIiIiUkkqVCIiIiIiIpWkQiUiIiIiIlJJKlQiIiIiIiKVpEIlIiIiIiJSSSpUIlUsKyuLmJgY5s6de+Ha9u3b8fX1JSUlxcRkIiIiIvJ7WQzDMMwOIVLXrFu3juHDh7N9+3Zat25Nx44dGTZsGM8884zZ0URERETkd1ChEjHJ5MmT+eyzz+jatSv79+9n165d+Pn5mR1LRERERH4HFSoRk5SUlNC+fXvS09PZvXs3HTp0MDuSiIiIiPxO+g6ViEmOHj1KZmYmLpeLtLQ0s+OIiIiISCVoh0rEBHa7ne7du9OxY0dat27NggUL2L9/P1FRUWZHExEREZHfQYVKxAQPPPAA77//Pvv27SMoKIg+ffoQGhrKmjVrzI4mIiIiIr+DbvkTqWKbN29mwYIFrFixgpCQEKxWKytWrGDr1q289NJLZscTERERkd9BO1QiIiIiIiKVpB0qERERERGRSlKhEhERERERqSQVKhERERERkUpSoRIREREREakkFSoREREREZFKUqESERERERGpJBUqERERERGRSlKhEhERERERqSQVKhERERERkUpSoRIREREREakkFSoREREREZFK+l+SEBFFF9EFawAAAABJRU5ErkJggg==",
      "text/plain": [
       "<Figure size 1000x500 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "ring = ring_resonator(\n",
    "    x0=2,\n",
    "    y0=4,\n",
    "    z0=1,\n",
    "    R=5,\n",
    "    wg_width=0.5,\n",
    "    wg_thickness=0.22,\n",
    "    medium=Si,\n",
    "    sidewall_angle=15 * np.pi / 180,\n",
    ")\n",
    "fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 5))\n",
    "ring.plot(z=1, ax=ax1)\n",
    "ring.plot(x=2, ax=ax2)\n",
    "ax2.set_xlim(8, 10)\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "24c7ac68",
   "metadata": {},
   "source": [
    "## Race Track"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "a777c99e",
   "metadata": {},
   "source": [
    "Similar to rings, race tracks are commonly used to construct resonators. The way to define a race track is similar to defining a ring. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "id": "c51c6344",
   "metadata": {},
   "outputs": [],
   "source": [
    "def race_track_resonator(\n",
    "    x0,\n",
    "    y0,\n",
    "    z0,\n",
    "    R,\n",
    "    wg_length,\n",
    "    wg_width,\n",
    "    wg_thickness,\n",
    "    medium,\n",
    "    sidewall_angle=0,\n",
    "    reference_plane=\"middle\",\n",
    "):\n",
    "    \"\"\"\n",
    "    This function defines a race track and returns the tidy3d structure of it.\n",
    "\n",
    "    Parameters\n",
    "    ----------\n",
    "    x0: x coordinate of center of the race track (um)\n",
    "    y0: y coordinate of center of the race track (um)\n",
    "    z0: z coordinate of center of the race track (um)\n",
    "    R: radius of the circular part (um)\n",
    "    wg_length: length of the straight waveguide (um)\n",
    "    wg_width: width of the waveguide (um)\n",
    "    wg_thickness: thickness of the waveguide (um)\n",
    "    medium: medium of the waveguide\n",
    "    sidewall_angle: side wall angle of the waveguide (rad)\n",
    "    reference_plane: reference plane for the sidewall angle, either 'bottom', 'middle', or 'top'\n",
    "    \"\"\"\n",
    "    x_start = x0 + wg_length / 2 + R\n",
    "\n",
    "    # Top half: right quarter arc → top straight segment → left quarter arc\n",
    "    path_top = pf.Path((x_start, y0), wg_width)\n",
    "    path_top.arc(0, 90, R)  # right quarter arc (0° → 90°)\n",
    "    path_top.segment((x0 - wg_length / 2, y0 + R))  # top straight segment\n",
    "    path_top.arc(90, 180, R)  # left quarter arc (90° → 180°)\n",
    "    race_track_top_geo = td.PolySlab(\n",
    "        vertices=path_top.to_polygon().vertices,\n",
    "        axis=2,\n",
    "        slab_bounds=(z0 - wg_thickness / 2, z0 + wg_thickness / 2),\n",
    "        sidewall_angle=sidewall_angle,\n",
    "        reference_plane=reference_plane,\n",
    "    )\n",
    "\n",
    "    # Bottom half: right quarter arc → bottom straight segment → left quarter arc\n",
    "    path_bottom = pf.Path((x_start, y0), wg_width)\n",
    "    path_bottom.arc(0, -90, R)  # right quarter arc (0° → -90°)\n",
    "    path_bottom.segment((x0 - wg_length / 2, y0 - R))  # bottom straight segment\n",
    "    path_bottom.arc(-90, -180, R)  # left quarter arc (-90° → -180°)\n",
    "    race_track_bottom_geo = td.PolySlab(\n",
    "        vertices=path_bottom.to_polygon().vertices,\n",
    "        axis=2,\n",
    "        slab_bounds=(z0 - wg_thickness / 2, z0 + wg_thickness / 2),\n",
    "        sidewall_angle=sidewall_angle,\n",
    "        reference_plane=reference_plane,\n",
    "    )\n",
    "\n",
    "    # Define race track structure combining both halves\n",
    "    race_track = td.Structure(\n",
    "        geometry=td.GeometryGroup(geometries=[race_track_bottom_geo, race_track_top_geo]),\n",
    "        medium=medium,\n",
    "    )\n",
    "\n",
    "    return race_track"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "id": "f25e68dd",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 1000x500 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "race_track = race_track_resonator(\n",
    "    x0=2,\n",
    "    y0=4,\n",
    "    z0=1,\n",
    "    R=5,\n",
    "    wg_length=8,\n",
    "    wg_width=0.5,\n",
    "    wg_thickness=0.22,\n",
    "    medium=Si,\n",
    "    sidewall_angle=15 * np.pi / 180,\n",
    ")\n",
    "fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 5))\n",
    "race_track.plot(z=1, ax=ax1)\n",
    "race_track.plot(x=2, ax=ax2)\n",
    "ax2.set_xlim(8, 10)\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "003fa866",
   "metadata": {},
   "source": [
    "## Waveguide Cosine S-bend"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "94704969",
   "metadata": {},
   "source": [
    "Waveguide s-bends are commonly used in various PIC devices. The function `cosine_sbend` defines an s-bend using the `pf.Path.s_bend()` method, which internally uses a cosine profile to smoothly connect two points. The bend direction can be controlled by the `mirror` parameter, and the `orientation` parameter selects whether the bend propagates along the $x$ or $y$ direction."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "id": "c46daa1c",
   "metadata": {},
   "outputs": [],
   "source": [
    "def cosine_sbend(\n",
    "    x0,\n",
    "    y0,\n",
    "    z0,\n",
    "    wg_width,\n",
    "    wg_thickness,\n",
    "    bend_length,\n",
    "    bend_height,\n",
    "    medium,\n",
    "    orientation=\"x\",\n",
    "    mirror=False,\n",
    "    sidewall_angle=0,\n",
    "):\n",
    "    \"\"\"\n",
    "    This function defines a cosine waveguide bend and returns the tidy3d structure of it.\n",
    "\n",
    "    Parameters\n",
    "    ----------\n",
    "    x0: x coordinate of the bend starting position (um)\n",
    "    y0: y coordinate of the bend starting position (um)\n",
    "    z0: z coordinate of the bend starting position (um)\n",
    "    wg_width: width of the waveguide (um)\n",
    "    wg_thickness: thickness of the waveguide (um)\n",
    "    bend_length: length of the bend (um)\n",
    "    bend_height: height of the bend (um)\n",
    "    medium: medium of the waveguide\n",
    "    orientation: orientation of the bend, either 'x' or 'y'\n",
    "    mirror: whether to mirror bend (reverses the transverse direction)\n",
    "    sidewall_angle: side wall angle of the waveguide (rad)\n",
    "    \"\"\"\n",
    "    path = pf.Path((x0, y0), wg_width)\n",
    "\n",
    "    if orientation == \"x\":\n",
    "        # S-bend from (x0, y0) to (x0+bend_length, y0 ± bend_height)\n",
    "        end_y = y0 - bend_height if mirror else y0 + bend_height\n",
    "        path.s_bend((x0 + bend_length, end_y))\n",
    "\n",
    "    elif orientation == \"y\":\n",
    "        # S-bend from (x0, y0) to (x0 ± bend_height, y0+bend_length)\n",
    "        end_x = x0 - bend_height if mirror else x0 + bend_height\n",
    "        path.s_bend((end_x, y0 + bend_length))\n",
    "\n",
    "    # Define geometry from path vertices\n",
    "    bend_geo = td.PolySlab(\n",
    "        vertices=path.to_polygon().vertices,\n",
    "        axis=2,\n",
    "        slab_bounds=(z0 - wg_thickness / 2, z0 + wg_thickness / 2),\n",
    "        sidewall_angle=sidewall_angle,\n",
    "    )\n",
    "\n",
    "    # Define tidy3d structure of the bend\n",
    "    bend = td.Structure(geometry=bend_geo, medium=medium)\n",
    "\n",
    "    return bend"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "id": "7af6f9f8",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 1000x500 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "bend = cosine_sbend(\n",
    "    x0=2,\n",
    "    y0=4,\n",
    "    z0=1,\n",
    "    wg_width=0.45,\n",
    "    wg_thickness=0.22,\n",
    "    bend_length=10,\n",
    "    bend_height=5,\n",
    "    medium=Si,\n",
    "    orientation=\"x\",\n",
    "    mirror=False,\n",
    "    sidewall_angle=15 * np.pi / 180,\n",
    ")\n",
    "\n",
    "fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 5))\n",
    "bend.plot(z=1, ax=ax1)\n",
    "bend.plot(x=7, ax=ax2)\n",
    "ax2.set_xlim(5, 8)\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "b2c06223",
   "metadata": {},
   "source": [
    "## Waveguide Circular Bend"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "ede9721d",
   "metadata": {},
   "source": [
    "Circular bends with an arbitrary bending angle and radius can be defined using the `circular_bend` function. Similar to the s-bend, the circular bend here interfaces with waveguides in the $x$ or $y$ direction and its bend direction can be controlled by the `mirror` parameter."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "id": "2207f24f",
   "metadata": {},
   "outputs": [],
   "source": [
    "def circular_bend(\n",
    "    x0,\n",
    "    y0,\n",
    "    z0,\n",
    "    R,\n",
    "    bend_angle,\n",
    "    wg_width,\n",
    "    wg_thickness,\n",
    "    medium,\n",
    "    orientation=\"x\",\n",
    "    mirror=False,\n",
    "    sidewall_angle=0,\n",
    "):\n",
    "    \"\"\"\n",
    "    This function defines a circular waveguide bend and returns the tidy3d structure of it.\n",
    "\n",
    "    Parameters\n",
    "    ----------\n",
    "    x0: x coordinate of the bend starting position (um)\n",
    "    y0: y coordinate of the bend starting position (um)\n",
    "    z0: z coordinate of the bend starting position (um)\n",
    "    R: radius of the circular bend (um)\n",
    "    bend_angle: angle of the bend (rad)\n",
    "    wg_width: width of the waveguide (um)\n",
    "    wg_thickness: thickness of the waveguide (um)\n",
    "    medium: medium of the waveguide\n",
    "    orientation: orientation of the bend, either 'x' or 'y'\n",
    "    mirror: whether to mirror bend\n",
    "    sidewall_angle: side wall angle of the waveguide (rad)\n",
    "    \"\"\"\n",
    "    # Convert bend_angle from radians to degrees for pf.Path.arc\n",
    "    bend_angle_deg = np.degrees(bend_angle)\n",
    "\n",
    "    path = pf.Path((x0, y0), wg_width)\n",
    "\n",
    "    if orientation == \"x\":\n",
    "        # Arc starting at -90° (path going in +x direction), sweeping by bend_angle\n",
    "        path.arc(-90, -90 + bend_angle_deg, R)\n",
    "        if mirror:\n",
    "            path.mirror((x0 + 1, y0), (x0, y0))\n",
    "\n",
    "    elif orientation == \"y\":\n",
    "        # Arc starting at 180° (path going in +y direction), sweeping by -bend_angle\n",
    "        path.arc(180, 180 - bend_angle_deg, R)\n",
    "        if mirror:\n",
    "            path.mirror((x0, y0 + 1), (x0, y0))\n",
    "\n",
    "    # Define geometry from path vertices\n",
    "    bend_geo = td.PolySlab(\n",
    "        vertices=path.to_polygon().vertices,\n",
    "        axis=2,\n",
    "        slab_bounds=(z0 - wg_thickness / 2, z0 + wg_thickness / 2),\n",
    "        sidewall_angle=sidewall_angle,\n",
    "    )\n",
    "\n",
    "    # Define tidy3d structure of the bend\n",
    "    bend = td.Structure(geometry=bend_geo, medium=medium)\n",
    "\n",
    "    return bend"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "id": "838c2fd7",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAA1kAAAG1CAYAAAALGD7jAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjYuMCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy89olMNAAAACXBIWXMAAA9hAAAPYQGoP6dpAAB/b0lEQVR4nO3dd1gUV9sG8Ht2YQsdpEkERIyoWDCoWGMjYi+xRGOPXRM1xFjeJBpbfI01iS1FxVhiS9TYK9i7YqyosaMIqLDUBXbn+8PX/UIAhXWXXdj7d117GWbPOXPvSEYezswZQRRFEURERERERGQQElMHICIiIiIiKk1YZBERERERERkQiywiIiIiIiIDYpFFRERERERkQCyyiIiIiIiIDIhFFhERERERkQGxyCIiIiIiIjIgFllEREREREQGxCKLiIiIiIjIgFhkERWjqKgoCIKAqKgoU0chIiIiIiNhkUVkBIsXL0ZERISpY+hl7dq1WLBggaljAABmzJiBDh06wMPDA4Ig4Ouvvy5Sf7VajfHjx8PLywtKpRIhISHYt29fvm2PHz+ORo0awcbGBp6enhg1ahRSU1MN8CmIiIjI0giiKIqmDkFU2lSrVg2urq55Zqy0Wi2ysrIgk8kgkZjn7zjatWuHy5cv4+7du6aOAkEQ4OnpiZo1a2LPnj2YPHlykQqtnj17YtOmTRgzZgzefvttRERE4MyZM4iMjESjRo107aKjo1G/fn1UqVIFQ4YMwcOHDzFnzhw0a9YMu3btMsInIyIiotLMytQBqPRKS0uDra2tqWOYFYlEAoVCYeoYJcadO3dQvnx5JCYmws3NrUh9T58+jXXr1mH27NkYO3YsAKBv376oVq0axo0bh+PHj+va/uc//4GzszOioqLg4OAAAChfvjwGDx6MvXv3omXLlob7UERERFTqmeev0snsxMbGYuDAgfDy8oJcLoefnx+GDx+OrKwsAEBERAQEQcChQ4cwYsQIuLu7o1y5crr+ixcvRmBgIORyOby8vDBy5EgkJSXl2sfNmzfRpUsXeHp6QqFQoFy5cujRoweSk5N1bfbt24dGjRrByckJdnZ2CAgIwH/+85/X5i9MP7VajcmTJ6NixYqQy+Xw9vbGuHHjoFar84y3evVq1K1bFzY2NnB2dsa7776LvXv3Anjxw/mVK1dw6NAhCIIAQRDQtGlTAAXfk7Vx40YEBwdDqVTC1dUVvXv3RmxsbK42/fv3h52dHWJjY9GpUyfY2dnBzc0NY8eOhUajee0x2Lp1K9q2bav7O/T398e0adNy9W3atCl27NiBe/fu6bKXL1++wDH79++va/fvV1Ev7cvPq/b9Ops2bYJUKsWQIUN02xQKBQYOHIgTJ07gwYMHAACVSoV9+/ahd+/eugILeFGQ2dnZYcOGDXpnICIiIsvEmSx6rUePHqFu3bpISkrCkCFDULlyZcTGxmLTpk1IT0+HTCbTtR0xYgTc3NwwadIkpKWlAQC+/vprTJkyBaGhoRg+fDhiYmKwZMkSnDlzBseOHYO1tTWysrIQFhYGtVqNTz75BJ6enoiNjcX27duRlJQER0dHXLlyBe3atUONGjUwdepUyOVy3Lp1C8eOHXtl/sL002q16NChA44ePYohQ4agSpUquHTpEubPn48bN25gy5YturZTpkzB119/jQYNGmDq1KmQyWQ4deoUDh48iJYtW2LBggX45JNPYGdnhy+++AIA4OHhUWC+iIgIDBgwAHXq1MHMmTPx5MkTfPfddzh27BguXLgAJycnXVuNRoOwsDCEhIRgzpw52L9/P+bOnQt/f38MHz78lcchIiICdnZ2CA8Ph52dHQ4ePIhJkyZBpVJh9uzZAIAvvvgCycnJePjwIebPnw8AsLOzK3DMoUOHIjQ0NNe23bt3Y82aNXB3d9dtS0xMfGW2l+zt7SGXywvV9nUuXLiASpUq5SqcAKBu3boAXlwi6O3tjUuXLiEnJwe1a9fO1U4mkyEoKAgXLlwwSB4iIiKyICLRa/Tt21eUSCTimTNn8ryn1WpFURTFFStWiADERo0aiTk5Obr34+PjRZlMJrZs2VLUaDS67QsXLhQBiMuXLxdFURQvXLggAhA3btxYYI758+eLAMSEhIQi5S9Mv1WrVokSiUQ8cuRIru1Lly4VAYjHjh0TRVEUb968KUokErFz5865Po8o/v+xEEVRDAwMFJs0aZJnP5GRkSIAMTIyUhRFUczKyhLd3d3FatWqiRkZGbp227dvFwGIkyZN0m3r16+fCECcOnVqrjFr1aolBgcHv/ogiKKYnp6eZ9vQoUNFGxsbMTMzU7etbdu2oq+v72vHy8/NmzdFR0dH8b333sv1fQCgUK8VK1bkO25CQoIIQJw8eXKhswQGBorNmzfPs/3KlSsiAHHp0qWiKIrixo0bRQDi4cOH87Tt1q2b6OnpWeh9EhEREYmiKPJyQXolrVaLLVu2oH379nl+0w+8WJjgnwYPHgypVKr7ev/+/cjKysKYMWNyLfQwePBgODg4YMeOHQAAR0dHAMCePXuQnp6eb5aXMzpbt26FVqst9GcoTL+NGzeiSpUqqFy5MhITE3Wv5s2bAwAiIyMBAFu2bIFWq8WkSZPyLFzx72NRGGfPnkV8fDxGjBiR616ttm3bonLlyrrj80/Dhg3L9XXjxo1x+/bt1+5LqVTq/jslJQWJiYlo3Lgx0tPTcf369SJn/7e0tDR07twZzs7O+O2333J9H+zbt69Qr7CwsDfO8VJGRka+s2Ivj3NGRkauPwtq+/J9IiIiosLi5YL0SgkJCVCpVKhWrVqh2vv5+eX6+t69ewCAgICAXNtlMhkqVKige9/Pzw/h4eGYN28e1qxZg8aNG6NDhw7o3bu3rgD74IMP8Msvv2DQoEGYMGECWrRogffffx9du3Z95Up9hel38+ZNXLt2rcDFFeLj4wEAf//9NyQSCapWrVqo4/E6BR0fAKhcuTKOHj2aa5tCociT0dnZGc+fP3/tvq5cuYIvv/wSBw8ehEqlyvXeP+9709fgwYPx999/4/jx4yhTpkyu9/59SWFxUCqV+d5Pl5mZqXv/n38W1PafxSkRERFRYbDIIoN6kx9I586di/79+2Pr1q3Yu3cvRo0ahZkzZ+LkyZMoV64clEolDh8+jMjISOzYsQO7d+/G+vXr0bx5c+zduzfXzMm/M72un1arRfXq1TFv3rx8x/D29tb7cxlSQZ/xdZKSktCkSRM4ODhg6tSp8Pf3h0KhwPnz5zF+/PgizQzm57vvvsNvv/2G1atXIygoKM/7cXFxhRrH0dHRYEVN2bJl8yweAgCPHz8GAHh5eena/XP7v9u+bEdERERUWLxckF7Jzc0NDg4OuHz5sl79fX19AQAxMTG5tmdlZeHOnTu691+qXr06vvzySxw+fBhHjhxBbGwsli5dqntfIpGgRYsWmDdvHq5evYoZM2bg4MGDusv5CvK6fv7+/nj27BlatGiB0NDQPK+XM03+/v7QarW4evXqK/dX2EsHCzo+L7f9+/joKyoqCk+fPkVERARGjx6Ndu3aITQ0FM7OznnaFvWyxyNHjmDs2LEYM2YMevXqlW+bsmXLFuq1fv16vT5ffoKCgnDjxo08s3anTp3SvQ+8eKaZlZUVzp49m6tdVlYWoqOj8y0aiYiIiF6FRRa9kkQiQadOnbBt27Y8P4QCgPiaZ1mHhoZCJpPh+++/z9V22bJlSE5ORtu2bQG8WEY7JycnV9/q1atDIpHoLuN69uxZnvFf/gCc36VeLxWmX/fu3REbG4uff/45T9uMjAzdSomdOnWCRCLB1KlT88z+/PPz2dra5lmiPj+1a9eGu7s7li5dmusz7Nq1C9euXdMdnzf1cgbsnxmzsrKwePHiPG1tbW0Lffng48eP0b17dzRq1Ei3QmF+jH1PVmJiIq5fv57rfr6uXbtCo9Hgp59+0m1Tq9VYsWIFQkJCdLOTjo6OCA0NxerVq5GSkqJru2rVKqSmpqJbt256ZSIiIiLLxcsF6bW++eYb7N27F02aNNEtb/748WNs3LgRR48ezbXE+L+5ublh4sSJmDJlClq1aoUOHTogJiYGixcvRp06ddC7d28AwMGDB/Hxxx+jW7duqFSpEnJycrBq1SpIpVJ06dIFADB16lQcPnwYbdu2ha+vL+Lj47F48WKUK1cOjRo1KjBDYfr16dMHGzZswLBhwxAZGYmGDRtCo9Hg+vXr2LBhA/bs2YPatWujYsWK+OKLLzBt2jQ0btwY77//PuRyOc6cOQMvLy/MnDkTABAcHIwlS5Zg+vTpqFixItzd3XWLaPyTtbU1Zs2ahQEDBqBJkybo2bOnbgn38uXL49NPP9X3ry2XBg0awNnZGf369cOoUaMgCAJWrVqVb5EcHByM9evXIzw8HHXq1IGdnR3at2+f77ijRo1CQkICxo0bh3Xr1uV6r0aNGqhRowYA/e/JWrVqFe7du6crng4fPozp06cDePF39nKmb+HChZgyZQoiIyN1zyQLCQlBt27dMHHiRMTHx6NixYpYuXIl7t69i2XLluXaz4wZM9CgQQPd9/jDhw8xd+5ctGzZEq1atdIrOxEREVkwk65tSCXGvXv3xL59+4pubm6iXC4XK1SoII4cOVJUq9WiKP7/Eu75LfMuii+WbK9cubJobW0tenh4iMOHDxefP3+ue//27dviRx99JPr7+4sKhUJ0cXERmzVrJu7fv1/X5sCBA2LHjh1FLy8vUSaTiV5eXmLPnj3FGzduvDJ7YftlZWWJs2bNEgMDA0W5XC46OzuLwcHB4pQpU8Tk5ORcbZcvXy7WqlVL165Jkybivn37dO/HxcWJbdu2Fe3t7UUAuuXc/72E+0vr16/Xjefi4iL26tVLfPjwYa42/fr1E21tbfN8vsmTJ4uF+V/52LFjYr169USlUil6eXmJ48aNE/fs2ZMnT2pqqvjhhx+KTk5OIoBXLufepEmTApdjL8py6/qM/8/ML4/Bv49rRkaGOHbsWNHT01OUy+VinTp1xN27d+e7ryNHjogNGjQQFQqF6ObmJo4cOVJUqVRv/BmIiIjI8gii+JrrvYiIiIiIiKjQeE8WERERERGRAbHIIiIiIiIiMiAWWURERERERAbEIouIiIiIiMiAWGQREREREREZUKl/TpZWq8WjR49gb28PQRBMHYeIyGKIooiUlBR4eXlBIuHv9IiIyHKU+iLr0aNH8Pb2NnUMIiKL9eDBA5QrV87UMYiIiIpNqS+y7O3tAbz4R97BwcHEaYiILIdKpYK3t7fuPExERGQpSn2R9fISQQcHBxZZREQmwEu1iYjI0vAieSIiIiIiIgNikUVERERERGRALLKIiIiIiIgMiEUWERERERGRAbHIIiIiIiIiMiAWWURERERERAbEIouIiIiIiMiASv1zsorixx9/RExMDKysrCCVSmFlZZXr9c9t1tbWsLOzg729fb4vW1tbSCSsYYmIiIiILA2LrP+5d+8ehg0bBrmTOyTWckCrgfiP14uvtRC1Gmg1Gmg12YAoFjieIAhQ2tjA1s4eDg4O8HB3h6eHO1xdXeHm5pbvy9XVFXK5vBg/NRERERERGRqLrP/RarUAAMewUVCWD3pte1EUIeaoIWZlQJuVoftTm5UBUZ2u25aVlYF4dRrinicj+vE9IPMStOnJyE5LhiZbnWdcB0cnvFXOG36+PvDx8Ya3tzd8fHzg7f3iv9966y0WYkREREREZoxFlp4EQYBgrQCsFZDaOhe5vyiKELMzoUlPhjZDBW16MjTpKmhSn+JBSiLu3UgALlxHtioB2WmqXH3LuLnD29sbVSsHoGrVqggMDETVqlVRoUIFWFnxr5SIiIiIyJT4E7mJCIIAQaaERKYEnDxf2VablQlNSgJyVIn/+zMBN1UJuHEkGhs3/4nsjFQAgLVMjopvV0LN6i+KrpcFmL+/P6ytrYvjYxERERERWTyTFlmHDx/G7Nmzce7cOTx+/BibN29Gp06d8m07bNgw/Pjjj5g/fz7GjBlTrDlNTSJTQFLGG9ZlvPO8J4oiNGnPkZ14H9mJ9/Hg6X3cO34Zv/+5E9npL2bArKytUcG/IoJqVM9VfFWsWBEymay4Pw4RERERUalm0iIrLS0NNWvWxEcffYT333+/wHabN2/GyZMn4eXlVYzpSgZBEGBl5wIrO5dc95KJoghtehKyEx8g++l9PEp8gIenrmPLzr3ISk0CAEitrOBXoSJqVg/UXXJYo0YNBAQEcGVEIiIiIiI9mbTIat26NVq3bv3KNrGxsfjkk0+wZ88etG3b9rVjqtVqqNX/v6CESqV6RevSSxAESG2dIbV1hsK3Rq73NOnJyH76ANmJ9/Ek8T52nbuF7fsioVY9AwDY2TsgJKQu6terh3r16iEkJASurq6m+BhERERERCWOWd+TpdVq0adPH3z++ecIDAwsVJ+ZM2diypQpRk5WskltHCG1cYTCu1qu7ZqMFGQ9+RtZj2/gxL3rOHJqEbKmTwcA+JSvgMYN6yMkJAT16tVDzZo1eakhEREREVE+zLrImjVrFqysrDBq1KhC95k4cSLCw8N1X6tUKnh7572XifKSKu2hLB+ku+xQFEXkJD9B1qMYPH8Ug82HzuG39RugzcmGTCZH3ZAQtGjeDE2bNkW9evWgUChM+wGIiIiIiMyA2RZZ586dw3fffYfz589DEIRC95PL5XyOlIEIggBrJ09YO3nCtmoTAICYk42s+NtQx17HhYeXcWr2fEyZMgXW1rI8RZdSqTTxJyAiIiIiKn5mW2QdOXIE8fHx8PHx0W3TaDT47LPPsGDBAty9e9d04SyYYGUNuVcA5F4BQJ2OEEUtshPuIfP+JUQ/uITTcxZg6tSpuYqu5s2bo0GDBlxGnoiIiIgsgtkWWX369EFoaGiubWFhYejTpw8GDBhgolT0b4IggczdDzJ3P6B2hwKLLhs7O7QMDUWbNm3QunVrlCtXztTRiYiIiIiMwqRFVmpqKm7duqX7+s6dO4iOjoaLiwt8fHxQpkyZXO2tra3h6emJgICA4o5KhZRf0ZX15DYybp/F3nPnsXXrnxBFLSpXDUSHdm3RunVrNGzYkLNcRERERFRqmLTIOnv2LJo1a6b7+uWCFf369UNERISJUpEhCYIEcs+KkHtWBBr0gCYjBZl3L+DB7bNYsPhnfPvtt7lmuTp27Ah3d3dTxyYiIiIi0psgiqJo6hDGpFKp4OjoiOTkZDg4OBTY7vHjxyhXrhy0ogiJRApBavW/P6UQJFJA8uJP3X9LrQGZErBSANZKCDIlJDIFBJkNJDIlJLL/bZPbQqJ0gNTGAVIbRwhy2yIt5FGa/XOWK/vueWQ8vA5BAJo0aYqePXvg/fffzzObSUQlR2HPv0RERKUNi6x/iIqKwo0bN5CTk/PKV3Z2NjIyMpCamoqUlBQkq1RIVqVApVIhNTUNaakpSEtLRU52dp59CFIpZLYvnlMFhQOgeFGASWycYGVfBlIHd1g5uEFq7wqJtWWtkqhJT0b6jRPIjDmCjHuXIJFK0KJFC/T44AN07twZTk5Opo5IREXAIouIiCwViywjUqvVSEpKQmJiIhISEnSvf3795Ek84uLjkZCQgKcJ8bn6y+ycYOXgBtiWgdTB7UXx5eAOKydPWDt7QSK3KdbPU5w0ac+RHnMcmTFHkf7gMqykVmgZ1hI9e/RAhw4d+AMbUQnAIouIiCwViywzolarERsbi/v37+teDx48wN1793Dn7n3EPryP9LQ0XXu5gwukTm9B4lQWVi7lYO3yFqxdvGDl5PnicsZSIiclEekxx6COOYr0h9dgLZOjbZvW6NGjB9q1awdbW1tTRySifJSk8y8REZEhscgqQURRRFJSEv7++2/cuHEDMTExuHHjBq5ei8GtWzd0BZggSKBw8YTg/BasXMu/WO3PzQ9WLl4v7ikrwXJU8Ui/fhTqG0eRHnsDcoUS7du1Q48eH6BNmzZ8ADKRGSlN518iIqKiYJFVSoiiiLi4ONy4cUNXgF2+cgXR0X/hSdwjAIDUWg65mw+EMr6QufnB2v1FASZVlszjkp0Upyu4Mh7fgo2tLTp26IgePT5AWFgY5HLLuqeNyNxYyvmXiIjo31hkWYCnT5/ir7/+0r3OXYjGtatXkaXOBADIHd0g9agIWdkAyL0qQeb5NiSykjUjlP0sFmnXjyDrxjFkPLkDW3t7dOncGR9++CFCQ0MhlZbsGTyikojnXyIislQssixUTk4Obt26hb/++gvnz5/H8RMnce7cWaSnpb243NDdF1KPtyErWwlyrwBYu/qUmEsNsxLvI/1lwZVwH17lvDFsyGAMGDAA5cqVM3U8IovB8y8REVkqFlmko9FocO3aNZw6dQqnTp3CseMncf3aFWi1WljJlZB5vg3rcoFQ+FSH3KsyBCuZqSO/kiiKyHp8A6l/7UHm9SPQZqvRqnVrDB0yBG3atIGVlUmfxU1U6vH8S0RElopFFr1Samoqzp07h9OnT+PYsWOIOnQYyUnPIbGSQfFWZViXqwaFbw3IywZAsDLfFQ216nSkXTuMjEt7kfHoBjw8y2LQwI8wcOBA+Pn5mToeUanE8y8REVkqFllUJFqtFpcuXUJkZOSLV9QhpKiSXyyq8e+iS2qeM0VZT/5GysU9yLx2CBp1Opq3aIHhw4ahY8eOnN0iMiCef4mIyFKxyKI3otFo8NdffyEqKgoHDh7EoUOHkZqigpXCFnLfIMj9gqGsEAwr+zKmjpqHNisT6dePIOPSXqQ/vAavct4Y/cnHGDRoEFxcXEwdj6jE4/mXiIgsFYssMiiNRoPz589j165d2L5jJ86eOQ1RFKH0rADr8u9AWaH2i/u5zGyWK+vJ30g5+yfSrx+GtZUV+vfri1GjRqFq1aqmjkZUYvH8S0RElopFFhnV06dPsXfvXuzcuRM7d+3Gs6eJulkuRYVgKCuGQGrjaOqYOpq050iJ3o2Mi7uQlfIMLUJD8emYMWjdujUkEomp4xGVKDz/EhGRpWKRRcVGq9Xi3LlzuWa5AAFKn2qQv10fNpXqw8re1dQxAQCiJhtp148i/fw2ZDy6AT//ivh09Cj0798f9vb2po5HVCLw/EtERJaKRRaZTHx8PLZu3YqNmzbh4MGD0OTkQFmuMuQV68MmoCGsnTxNHRGiKEIdex1p57chLeYYbO1sMfqTTzB69Gi4ubmZOh6RWeP5l4iILBWLLDILSUlJ2LZtGzb9/jt2796DLHUmlJ7+kFWsB9uARrB29TZ1ROSoEqA6uxUZf+2BVACGDB6EsWPHwsfHx9TRiMwSz79ERGSpWGSR2UlNTcXu3buxadPv2LZ9G9LT0qB8qxKUgaGwqfIupAo7k+bTZKiQcm470i9shzYrHb179caECeNRuXJlk+YiMjc8/xIRkaVikUVmLTMzEzt27MCKiAjs2rULECRQvl0PtoEtoPCrBUEiNVk2bVYGUi/uQdrZLchOeYqOnTrhi//8B7Vr1zZZJiJzwvMvERFZKhZZVGI8efIEq1evxs/LliPm2lXIHVwhr9IUdtVamPRyQjEnG6lXDiL9zB/IfBqL5s1bYPLkSXj33XdNlonIHPD8S0RElopFFpU4oiji/PnziIiIwKrVa5Cc9Bw2b1WGIrC5SS8nFLUapMccR9rpTciI+xvNm7fAjBnTUa9ePZPkITI1nn+JiMhSsciiEk2tVmP79u1Ytnw59uzZAwjSF5cTVmsBRfkgk1xOKIoiMm6eQMqxtciMv4vWbdpg+rRpeOedd4o9C5Ep8fxLRESWikUWlRqPHz/GmjVr8Muy5Yi5fu3F5YRVm8KuWiisy5Qr9jyiVoP060eReuI3ZCY+RMdOnTBt6lRUr1692LMQmQLPv0REZKlYZFGpI4oizp07p7ucUJWcBJtyVaAIbAHbyo0gKebLCUWtBmlXopB6ch2ynsehe/fumDJlCgICAoo1B1Fx4/mXiIgsFYssKtXUajX+/PNPLF+xAnv37IEgtYaycmPY1+4AmXuFYs0ianKQemk/0k6uR3bKU/Tu3QdTp06Br69vseYgKi48/xIRkaVikUUW4/Hjx1i5ciW+X7gIj2Mfwsa3OmzfaQ9lxZBivXdLzMlCysU9SDu1AaI6HeGfjsHEiRPh6OhYbBmIigPPv0REZKlYZJHFycnJwebNmzFv/gKcPHEccmdP2AS1gV2NlsV6KaFWnQ7V6T+QenYzHOzsMG3qFAwZMgTW1tbFloHImHj+JSIiS8UiiyzauXPnsGDBd1i3bh1EiRTKwOZwCG4P6zLF99ytnJREJB9ZjdTLB1Cx4tuYO2c22rdvD0EQii0DkTHw/EtERJaKRRYRgLi4OCxduhQLFy3G08QE2PrXgX39DyB/q3KxZch6chvJUcuRfjca7zZpgnlz5yI4OLjY9k9kaDz/EhGRpWKRRfQParUa69evxzcz/4uY69dg41cL9g16QlGuarHsXxRFZN4+C9XhCGTG30OvXr0xc+Y38PYuvpk1IkPh+ZeIiCwViyyifGi1Wvz++++Y/PUUXLt6BTbla8K+fg8ofIrnGVeiVoPUv/Yi9dhaSDRqTJs6BaNHj+b9WlSi8PxLRESWikUW0StotVps2bIFk7+egsuX/oKNTzXYNegJhU+NYrlnSqtOR9KRVUg9vwNVAwPxy88/oV69ekbfL5Eh8PxLRESWSmLqAETmTCKR4P3338dfF6OxdetWVCojQ/y6L5D423hk3DkPY/+OQiK3gUvoUHj0mYvbTzPQoEEDDBs2DElJSUbdLxERERHpjzNZREUgiiJ27dqFSZO/xrmzZ6B8qzLs638ARYXaRp/ZErUapJzfjpSja+DkYIfvv1uAHj16cBVCMls8/xIRkaXiTBZREQiCgDZt2uDM6VPYvXs3qpdzQvymKUhY/RnSb50y6syWIJHCoXZHeHy0GBkuFfHhhx+iZVgY/v77b6Ptk4iIiIiKjkUWkR4EQUBYWBhOnjiO/fv3o5afOxJ+n4aEVZ8i/cZxiKLWaPu2cnCFa6f/wK3LJBw5cxFVA6thxowZyMrKMto+iYiIiKjweLkgkYFERUVh8tdTcPhQFJQeFWBbrztsAhpAEIz3uwxtViaSj61FytmtePvtt/HzTz/i3XffNdr+iIqC518iIrJUnMkiMpCmTZviUFQkDh8+jAbVKiBx638RHzEK6TdOGO0yQolMAedmH8Gz3wI8SAOaNGmCAQMG4OnTp0bZHxERERG9HossIgNr3Lgx9u/fh+PHj6NhjYpI2DwDiesmQv34ptH2KXP3g9uH38IlbCTWrN+EtysFYOXKlUZf/ZCIiIiI8mKRRWQk9evXx/59+7Br1y742GoR9+uneLp9DnJU8UbZnyBIYB/UGh4DlyDbszr69++Pps2a4fr160bZHxERERHlj0UWkZG1atUKl/66iJ9++gmK+Kt4/PMwPD8UAa063Sj7k9o6o0z7sXDvPg2nL99C9eo1MGnSJGRmZhplf0RERESUGxe+ICpGKSkpmD17Nr6dPQeilRx29XvCLqgVBInUKPvTZquhOrkRKac2wdfXF2vXrEa9evWMsi+if+P5l4iILBVnsoiKkb29PaZOnYpbN2+gZ5dOeL5/KeIjPkbG7XNG2Z/EWg6nxr3hOeAHxKmt0bBRI8yYMQMajcYo+yMiIiIizmQRmdSFCxcw5tNPcfjQIdhWqg+n5oNg5ehhlH2JmhwkH/sNySc3oGHDRli7ZjV8fHyMsi8igOdfIiKyXJzJIjKhWrVqISoyEuvWrYOd6i7ilo1A0rHfIOYY/sHCgtQKTu/2gUfPmTh7OQbVqtfAxo0bDb4fIiIiIkvHIovIxARBwAcffICbN2IQPmYUUk+ux5MVHyPj7zNG2Z/Cuxrc+n0P0as6unfvjo8++gipqalG2RcRERGRJeLlgkRm5tq1axg58mNERh6E7dv14Nh8EKydPA2+H1EUkXZpP5IP/gSfcm9h/brfULt2bYPvhywXz79ERGSpOJNFZGaqVKmCAwf2Y8OGDXBIe4Any0ca5RJCQRBgV+M9uPddgMcZEtSrXx/ffvsttFqtQfdDREREZGlYZBGZIUEQ0K1bN9yIuY7PP/sUaSc3IH7laGQ+uGzwfVm7vAW3D2fBNrgTxk+YgOYtQhEbG2vw/RARERFZChZZRGbMzs4OM2fOxMWL0ajh/xaerJ2AZ3sXG/xBxoLUGs5N+8P9g+k4cf4SAqtVx5YtWwy6DyIiIiJLwSKLqASoWrUqjh87iu+//x45MYfwZMUIpN86ZfD9KH1rwr3/98hxr4zOnTtj6NChSE83bEFHREREVNpx4QuiEub+/fsYMnQo9uzeDdsqjeHcYgikts4G3Ycoiki9uAfJkT+jQvny2LB+HYKCggy6Dyr9eP4lIiJLxZksohLGx8cHu3buxOrVq2EddwVPlo9A6qUDMOTvSwRBgH1QK3j0WYCHqhzUrRuC+fPnc1EMIiIiokJgkUVUAgmCgF69euFGzHV069QBT3fOR+LGSchRJRh0P9au3nDrNQeKoDYIDw9HWKtWiIuLM+g+iIiIiEobFllEJZibmxvWrFmNnTt3wiHzCZ5EfILUK5GGndWysoZL80Fw7z4Vh0+eRfUaNXH06FGDjU9ERERU2pi0yDp8+DDat28PLy8vCIKQazWz7OxsjB8/HtWrV4etrS28vLzQt29fPHr0yHSBicxU69atcfXK5RezWtvn4umfs6DJUBl0H0q/d+De73ukK93RtFkzLFq0yKDFHBEREVFpYdIiKy0tDTVr1sSiRYvyvJeeno7z58/jq6++wvnz5/HHH38gJiYGHTp0MEFSIvPn7OyMtWvXYN26dZA+voz4iE+QcfucQfchtXWGa/fpsKnZBh9//DH69x+AjIwMg+6DiIiIqKQzm9UFBUHA5s2b0alTpwLbnDlzBnXr1sW9e/fg4+OTbxu1Wg21Wq37WqVSwdvbm6tbkUWJjY3FgI8+wr69e2Ffqw2cmn4EiUxh0H2kXolE0p6FqF4tEFs2/wFfX1+Djk8lH1cXJCIiS1Wi7slKTk6GIAhwcnIqsM3MmTPh6Oioe3l7exdfQCIz8dZbb2HP7t1YtGgRsq5FIuHX0VDHXjfoPuwCm8G917e4dvcRar0TjIMHDxp0fCIiIqKSqsQUWZmZmRg/fjx69uz5yt+ITpw4EcnJybrXgwcPijElkfkQBAEjRozAXxejEejnhSdrxiHp6FqIWo3B9iHz8Idbn3lQO3rjvffew7x583ifFhEREVm8ElFkZWdno3v37hBFEUuWLHllW7lcDgcHh1wvIktWqVIlnDxxHJMnT0LKiXUvlnpPeWqw8aVKB7h2nQK7Ou/js88+Q8+ePZGenm6w8YmIiIhKGrMvsl4WWPfu3cO+fftYNBHpwcrKCpMnT8aBAwdgl/EECb+ONuiiGIJECuem/eHacQI2bd6KRo3fxePHjw02PhEREVFJYtZF1ssC6+bNm9i/fz/KlClj6khEJVrTpk1x6a+LaNowBPEbJ+P5oQiDXj5oW7kR3D+chSt/30Nw7Tq4ePGiwcYmIiIiKilMWmSlpqYiOjoa0dHRAIA7d+4gOjoa9+/fR3Z2Nrp27YqzZ89izZo10Gg0iIuLQ1xcHLKyskwZm6hEc3d3x66dO/Hf//4XqWc2I3HdROSoEgw2vszDH2695iIJNqjfoCG2bdtmsLGJiIiISgKTLuEeFRWFZs2a5dner18/fP311/Dz88u3X2RkJJo2bVqofXAJYaKCHT9+HN26f4CE5yo4tR4Nm4ohBhtbm5WJZzvmIv3mScyZMweffvopBEEw2Phk/nj+JSIiS2U2z8kyFv4jT/Rqz549Q7/+/bF92zY41OkMp6b9IUikBhlbFLVIOvQrVKc2YfDgwVi0aBGsra0NMjaZP55/iYjIUpn1PVlEZHwuLi74c+tWzJs3D6nn/0Tipq+hyUw1yNiCIIFz0/4o03o0li1fjlatWiMpKckgYxMRERGZKxZZRARBEPDpp59i7549sHp2B4mrP0P2U8M9Y86uxntw6z4NR06eRt2Qerh9+7bBxiYiIiIyNyyyiEinRYsWOH/uLHzdHBC/eiwy/j5rsLEVPjXg1msOHjxNRUi9+roFb4iIiIhKGxZZRJSLv78/Tp86iZYtmiLh96lQnf4Dhrp109rlLbh++C3SrJ3QqHFjREZGGmRcIiIiInPCIouI8nBwcMCfW7di/PhxeB65HM92LoCYY5hHJ0htHOH6wQyI7pUQFtYKmzZtMsi4REREROaCRRYR5UsqlWLmzJlYvXo11DeOImH9f5CT+swgY0tkSri+/xXkb9dH9+7dsWTJEoOMS0RERGQOWGQR0Sv16tULx44egUNOMhJXh0P9+KZBxhWk1nBp9xns3mmPESNGYPLkyQa7LJGIiIjIlFhkEdFr1alTB+fPnUW1t/2Q8NsEpF09ZJBxBUEC5xaD4dSkH6ZOnYqhQ4dCo9EYZGwiIiIiU2GRRUSF4uXlhSOHD6FH925I3DYbzw//ClHUvvG4giDAsV43lGk9Gr8sW44uXbsiMzPTAImJiIiITINFFhEVmlKpxKpVv2LWrFlIObkRTzd/A6063SBj29V4D66d/4PtO3ahbbt2yMjIMMi4RERERMWNRRYRFYkgCBg3bhy2bdsGPL6MhLXjkJ0UZ5CxbSqGwLXrZBw6fBTt2rdnoUVEREQlEossItJL27Ztceb0aXjaSpCw+jNk3v/LIOMqfGqw0CIiIqISjUUWEemtSpUqOHf2DBrVDUbChq+QEr3LIOOy0CIiIqKSjEUWEb0RFxcX7N27ByOGD8ezPYuQdOw3gyzFzkKLiIiISioWWUT0xqysrPD9999j+vTpSD66Bs8jl7HQIiIiIovFIouIDEIQBHzxxRdYuHAhUs5swbPd30PUvvkzr1hoERERUUnDIouIDGrkyJH49ddfkX7lIJ7++S3EnOw3HpOFFhEREZUkLLKIyOD69OmDP37/HVl3ziJx8zRos9784cIstIiIiKikYJFFREbRsWNH7N61E2JcDJ5unARtZuobj8lCi4iIiEoCFllEZDTNmzdHVORBWKc+RuL6/0CT9vyNx2ShRUREROaORRYRGVXdunVx9Mhh2IvpSPxtAnJU8W88JgstIiIiMmcssojI6KpVq4bjx47C3c4aiWvHI/vpgzcek4UWERERmSsWWURULPz9/XHi+DGUL+uKxHUTkfXk7zcek4UWERERmSMWWURUbLy8vHDs6BFUC6iIhHX/QeaDy288JgstIiIiMjcssoioWJUpUwZRkQfRoF4dJG6ajIy/z77xmP8stDp07IisrCwDJCUiIiLSD4ssIip29vb22LNrF1q1fA+Jm6ch7dqRNx5T4VMDZbpMwsHIKPTr1w9ardYASYmIiIiKjkUWEZmEQqHA5j/+QI8PeiBx27dIubjnjcdU+taES9vPsG79eoSHh0MURQMkJSIiIioaK1MHICLLZW1tjVWrfoWjowOWLPkBgsQKdtVbvNGYtpUbQZuhwnfffYeyZcti/PjxBkpLREREVDicySIik5JIJFi0aBEGDhyIZ7u+Q/qN4288pn2tNnBs0BMTJkzAihUrDJCSiKh0ioqKgiAIiIqKMnUUolKFRRYRmZwgCPjxxx/Rpcv7eLptNjLuRr/xmI6NPoRdUCsMGjwY27Zte/OQREQl2OLFixEREWHqGHpZu3YtFixYYOoYuSxbtgxVqlSBQqHA22+/jR9++KHQfdVqNcaPHw8vLy8olUqEhIRg3759+bY9fvw4GjVqBBsbG3h6emLUqFFITU011McgI2KRRURmQSqVYs2aNQht0RzPtsyAOvb6G40nCAJc3hsOZcUQdO3WHcePv/kMGRFRSVVQkfXuu+8iIyMD7777bvGHKiRzK7J+/PFHDBo0CIGBgfjhhx9Qv359jBo1CrNmzSpU//79+2PevHno1asXvvvuO0ilUrRp0wZHjx7N1S46OhotWrRAeno65s2bh0GDBuGnn35Ct27djPGxyMAEsZTfGa5SqeDo6Ijk5GQ4ODiYOg4RvUZ6ejpC32uJsxcuwrXHTMjc/d5oPDEnC4kbJ8Eq+SGOHzuKwMBAAyWl1+H5l8xNWloabG1tTR3DJKpVqwZXV9cSeVlgu3btcPnyZdy9e9fUUZCRkQFvb2/Uq1cP27dv123v3bs3tmzZggcPHsDZ2bnA/qdPn0ZISAhmz56NsWPHAgAyMzNRrVo1uLu75/qFYJs2bRAdHY3r16/rzqG//PILBg8ejD179qBly5ZG+pRkCJzJIiKzYmNjg107d6BKpYp4umkSsp8/eqPxBCsZynT+EtkKF4S+1xKxsbEGSkpEphQbG4uBAwfCy8sLcrkcfn5+GD58uO45eRERERAEAYcOHcKIESPg7u6OcuXK6fovXrwYgYGBkMvl8PLywsiRI5GUlJRrHzdv3kSXLl3g6ekJhUKBcuXKoUePHkhOTta12bdvHxo1agQnJyfY2dkhICAA//nPf16bvzD91Go1Jk+ejIoVK0Iul8Pb2xvjxo2DWq3OM97q1atRt25d2NjYwNnZGe+++y727t0LAChfvjyuXLmCQ4cOQRAECIKApk2bAij4nqyNGzciODgYSqUSrq6u6N27d57zZ//+/WFnZ4fY2Fh06tQJdnZ2cHNzw9ixY6HRaF57DLZu3Yq2bdvq/g79/f0xbdq0XH2bNm2KHTt24N69e7rs5cuXL3DMFStWQBAELF++PNf2b775BoIgYOfOna/N9SqRkZF4+vQpRowYkWv7yJEjkZaWhh07dryy/6ZNmyCVSjFkyBDdNoVCgYEDB+LEiRN48OABgBe/pNq3bx969+6d65dUffv2hZ2dHTZs2PBGn4OMj6sLEpHZcXR0xL69e9CgYSM83PgVXHvMgpWDq97jSRR2cOn6NRLXjEWbtu1w/NhRi/1tNlFp8OjRI9StWxdJSUkYMmQIKleujNjYWGzatAnp6emQyWS6tiNGjICbmxsmTZqEtLQ0AMDXX3+NKVOmIDQ0FMOHD0dMTAyWLFmCM2fO4NixY7C2tkZWVhbCwsKgVqvxySefwNPTE7Gxsdi+fTuSkpLg6OiIK1euoF27dqhRowamTp0KuVyOW7du4dixY6/MX5h+Wq0WHTp0wNGjRzFkyBBUqVIFly5dwvz583Hjxg1s2bJF13bKlCn4+uuv0aBBA0ydOhUymQynTp3CwYMH0bJlSyxYsACffPIJ7Ozs8MUXXwAAPDw8CswXERGBAQMGoE6dOpg5cyaePHmC7777DseOHcOFCxfg5OSka6vRaBAWFoaQkBDMmTMH+/fvx9y5c+Hv74/hw4e/8jhERETAzs4O4eHhsLOzw8GDBzFp0iSoVCrMnj0bAPDFF18gOTkZDx8+xPz58wEAdnZ2BY45YMAA/PHHHwgPD8d7770Hb29vXLp0CVOmTMHAgQPRpk0bXdvnz58Xqhi0sbGBjY0NAODChQsAgNq1a+dqExwcDIlEggsXLqB3794FjnXhwgVUqlQpz+x+3bp1Aby4RPBl5pycnDz7kclkCAoK0uUgMyaWcsnJySIAMTk52dRRiKiI7t+/L75VzltUuPmI5T5ZI/qO3/5Gr7IDfhCt5DZih44dRY1GY+qPV+rx/EvG0rdvX1EikYhnzpzJ855WqxVFURRXrFghAhAbNWok5uTk6N6Pj48XZTKZ2LJly1zngYULF4oAxOXLl4uiKIoXLlwQAYgbN24sMMf8+fNFAGJCQkKR8hem36pVq0SJRCIeOXIk1/alS5eKAMRjx46JoiiKN2/eFCUSidi5c+c857WXx0IURTEwMFBs0qRJnv1ERkaKAMTIyEhRFEUxKytLdHd3F6tVqyZmZGTo2m3fvl0EIE6aNEm3rV+/fiIAcerUqbnGrFWrlhgcHPzqgyCKYnp6ep5tQ4cOFW1sbMTMzEzdtrZt24q+vr6vHe+lx48fiy4uLuJ7770nqtVqsVatWqKPj0+ec5Gvr68I4LWvyZMn6/qMHDlSlEql+e7Xzc1N7NGjxyuzBQYGis2bN8+z/cqVKyIAcenSpaIoiuLGjRtFAOLhw4fztO3WrZvo6en5usNAJsbLBYnIbHl7e+Pggf2wFTPw9PevoVWnv9F4Mnc/OLcbi21/bsPEiRMNlJKIipNWq8WWLVvQvn37PL/lB14sevNPgwcPhlQq1X29f/9+ZGVlYcyYMZBIJLnaOTg46C73cnR0BADs2bMH6en5n3tezuhs3boVWq220J+hMP02btyIKlWqoHLlykhMTNS9mjdvDuDFZWsAsGXLFmi1WkyaNCnX5wHyHovCOHv2LOLj4zFixAgoFArd9rZt26Jy5cr5Xg43bNiwXF83btwYt2/ffu2+lEql7r9TUlKQmJiIxo0bIz09Hdev67/4kaenJxYtWoR9+/ahcePGiI6OxvLly/PMHq1Zswb79u177atv3766PhkZGblmSv9JoVAgIyPjldkyMjIgl8vz7fvy/X/+WVDb1+2HTI+XCxKRWatUqRL279uLxk2a4OkfU1Gm6xRIrPP+o1NYNhXrwqnZQHz77beoVKkSBg4caMC0RGRsCQkJUKlUqFatWqHa+/nlXjzn3r17AICAgIBc22UyGSpUqKB738/PD+Hh4Zg3bx7WrFmDxo0bo0OHDujdu7euAPvggw/wyy+/YNCgQZgwYQJatGiB999/H127ds1T8PxTYfrdvHkT165dg5ubW75jxMfHAwD+/vtvSCQSVK1atVDH43UKOj4AULly5Twr4CkUijwZnZ2d8fz589fu68qVK/jyyy9x8OBBqFSqXO/98743ffTo0QOrV6/Gjh07MGTIELRokfdB9w0bNizyuEqlUnff379lZmbmKhwL6p/fPXWZmZm69//5Z0FtX7cfMj0WWURk9oKCgrB75060CH0PT//8L1w7fQFBqv/py752B+Q8f4ihw4ahQoUKaNasmQHTEpE5eZMfRufOnYv+/ftj69at2Lt3L0aNGoWZM2fi5MmTKFeuHJRKJQ4fPozIyEjs2LEDu3fvxvr169G8eXPs3bs31wzavzO9rp9Wq0X16tUxb968fMfw9vbW+3MZUkGf8XWSkpLQpEkTODg4YOrUqfD394dCocD58+cxfvz4Is0M5ufp06c4e/YsAODq1avQarV5Ct+EhIRC3ZNlZ2enuw+sbNmy0Gg0iI+Ph7u7u65NVlYWnj59Ci8vr1eOVbZs2XwXYHr8+DEA6PqXLVs21/Z/t33dfsj0eLkgEZUIDRs2xNYtm5F1NxrPds6HqH39P4wFEQQBzi2GQu5dHZ06v48bN24YMCkRGZObmxscHBxw+fJlvfr7+voCAGJiYnJtz8rKwp07d3Tvv1S9enV8+eWXOHz4MI4cOYLY2FgsXbpU975EIkGLFi0wb948XL16FTNmzMDBgwd1l/MV5HX9/P398ezZM7Ro0QKhoaF5Xi9nmvz9/aHVanH16tVX7q+wlw4WdHxebvv38dFXVFQUnj59ioiICIwePRrt2rVDaGhovsuf63PZ48iRI5GSkoKZM2fi6NGj+T5nq06dOihbtuxrX3PmzNH1CQoKAgBdAffS2bNnodVqde8XJCgoCDdu3Mgzc3fq1Klc41erVg1WVlZ59pOVlYXo6OjX7odMj0UWEZUYYWFh+O23tUi/fgTP9y+F+AaP+ROkVijTYTyyZA4Ia90GT58+NWBSIjIWiUSCTp06Ydu2bXl+AAXw2vNCaGgoZDIZvv/++1xtly1bhuTkZLRt2xbAiyW0c3JycvWtXr06JBKJ7hKuZ8+e5Rn/5Q+/+V3m9VJh+nXv3h2xsbH4+eef87TNyMjQrZTYqVMnSCQSTJ06Nc/szz8/n62tbZ4l6vNTu3ZtuLu7Y+nSpbk+w65du3Dt2jXd8XlTL2fA/pkxKysLixcvztPW1ta2SJcPbtq0CevXr8d///tfTJgwAT169MCXX36Z5xdq+tyT1bx5c7i4uGDJkiW5xlqyZAlsbGxyHZ/ExERcv3491z19Xbt2hUajwU8//aTbplarsWLFCoSEhOhmKB0dHREaGorVq1cjJSVF13bVqlVITU3lA4lLAF4uSEQlSteuXfHzzz9j4MCBEOS2cG7SX++xJAo7uLw/CbGrP0Onzu/jwP59Bd7QTETm45tvvsHevXvRpEkT3fLmjx8/xsaNG3H06NFcS4z/m5ubGyZOnIgpU6agVatW6NChA2JiYrB48WLUqVNHt/z2wYMH8fHHH6Nbt26oVKkScnJysGrVKkilUnTp0gUAMHXqVBw+fBht27aFr68v4uPjsXjxYpQrVw6NGjUqMENh+vXp0wcbNmzAsGHDEBkZiYYNG0Kj0eD69evYsGED9uzZg9q1a6NixYr44osvMG3aNDRu3Bjvv/8+5HI5zpw5Ay8vL8ycORPAiyXGlyxZgunTp6NixYpwd3fXLaLxT9bW1pg1axYGDBiAJk2aoGfPnrol3MuXL49PP/1U37+2XBo0aABnZ2f069cPo0aNgiAIWLVqVb5FcnBwMNavX4/w8HDUqVMHdnZ2aN++fb7jxsfHY/jw4WjWrBk+/vhjAMDChQsRGRmJ/v374+jRo7rLBvW9J2vatGkYOXIkunXrhrCwMBw5cgSrV6/GjBkz4OLiomu7cOFCTJkyBZGRkbrnkoWEhKBbt26YOHEi4uPjUbFiRaxcuRJ3797FsmXLcu1rxowZaNCgge77/OHDh5g7dy5atmyJVq1aFTk7FTNTLm1YHLiEMFHpNG/ePBGA6NSk/xsv7e7Ra5YokVqJI0eONPXHKlV4/iVjunfvnti3b1/Rzc1NlMvlYoUKFcSRI0eKarVaFMX/X8I9v2XeRfHFku2VK1cWra2tRQ8PD3H48OHi8+fPde/fvn1b/Oijj0R/f39RoVCILi4uYrNmzcT9+/fr2hw4cEDs2LGj6OXlJcpkMtHLy0vs2bOneOPGjVdmL2y/rKwscdasWWJgYKAol8tFZ2dnMTg4WJwyZUqe/6+WL18u1qpVS9euSZMm4r59+3Tvx8XFiW3bthXt7e1FALrl3P+9hPtL69ev143n4uIi9urVS3z48GGuNv369RNtbW3zfL7JkyeLhfkR89ixY2K9evVEpVIpenl5iePGjRP37NmTJ09qaqr44Ycfik5OTiKAVy7n/v7774v29vbi3bt3c23funWrCECcNWvWa3MVxk8//SQGBASIMplM9Pf3F+fPn59ryXxR/P/j8O9jm5GRIY4dO1b09PQU5XK5WKdOHXH37t357ufIkSNigwYNRIVCIbq5uYkjR44UVSqVQT4DGZcgim9wvU0JoFKp4OjoiOTk5DxLdxJRyTZp0iRMmzYNru0/h23VJm80VsqFnXi2dzEiIiLQr18/AyW0bDz/EhGRpeI9WURUYk2ZMgW9evXG893fQ/345huNZRfUGnY13sPgIUNx7tw5AyUkIiIiS8Qii4hKLEEQ8MsvPyOoZg083zoDOal5byYvylgu7w2HlasvOnbqjISEBAMmJSIiIkvCIouISjSFQoE/t26Bk9Iaz7Z8AzEn/4dEFoZgJYNLx4lISEpBt+4f5FlZjIiIiKgwWGQRUYnn5eWFbX9uhSbxLp7tWfhGS7tbObjBuf14HD58GBMnTjRgSiIiIrIULLKIqFSoU6cOVixfhtTLB5FyZvMbjaXwqQ6nph9hzpw5WLdunYESEhERkaXgc7KIqNT48MMPcenSJcya9S2sy/hA6V9b77Hsa3dAdtxNDPhoIKpWrYoaNWoYMClZOq1Wi0ePHsHe3h6CIJg6DhGRxRBFESkpKfDy8tI9M80YuIQ7EZUqGo0GHTp2xN4DUXDvPQfWZbz1HkubnYnEtePgYSPg0sVo2NnZGTBp6cfzb8EePnwIb2/9vzeJiOjNPHjwAOXKlTPa+CyyiKjUUalUqBtSD/cSVHDtPRdShf7FUfbzR4hfORq9e36AFStWGDBl6cfzb8GSk5Ph5OSEBw8e8NgQERUjlUoFb29vJCUlwdHR0Wj74eWCRFTqODg4YMf2bQiuXQfP/pwF165fQ5BI9RrL2tkLji2GIiJiAVq3bo3u3bsbOC1ZopeXCDo4OLDIIiIyAWNfqs2FL4ioVPL398cfv29C5v2/8Pzgsjcay7ZaC9hWaYyBgwfj3r17BkpIREREpZVJi6zDhw+jffv28PLygiAI2LJlS673RVHEpEmTULZsWSiVSoSGhuLmzZumCUtEJU7z5s3x/XffIeXcn0i5uFfvcQRBgHPLkciWKPBhr97QaDQGTElERESljUmLrLS0NNSsWROLFi3K9/1vv/0W33//PZYuXYpTp07B1tYWYWFhyMzMLOakRFRSjRgxAoMHD0bSvsXIfHhV73GkCjs4tQnHiePHMXPmTAMmJCIiotLGbBa+EAQBmzdvRqdOnQC8mMXy8vLCZ599hrFjxwJ4caOwh4cHIiIi0KNHj0KNyxuviSgrKwvNW4TiTPRluPWZCysHd73HSjqyGimnNuLokSOoX7++AVOWPjz/FozHhojINIrr/Gu292TduXMHcXFxCA0N1W1zdHRESEgITpw4UWA/tVoNlUqV60VElk0mk2HzH7/D3dkezzbPgDZL/9lwx4Y9IS9bCR/0/JDnFyIiIsqX2RZZcXFxAAAPD49c2z08PHTv5WfmzJlwdHTUvfgcEiICADc3N+zYvg1QxeHZrvkQRa1e4wgSKZzbfobHT+IxYsRIA6ckIiKi0sBsiyx9TZw4EcnJybrXgwcPTB2JiMxEjRo1sGb1KqRdPwbV6c16j2Pt5AnH0OFYs2Y11qxZY8CEREREVBqYbZHl6ekJAHjy5Emu7U+ePNG9lx+5XK577gifP0JE/9a5c2eMGzcOqiO/Qh17Xe9x7AKbwS6wKYYOG4bbt28bMCERERGVdGZbZPn5+cHT0xMHDhzQbVOpVDh16hRvNieiNzJ9+nQEB9fG8+3fQpOZqvc4zu8NR47MHj0/7IWcnBwDJiRDed2jQv7tjz/+wHvvvQc3Nzc4ODigfv362LNnT642X3/9NQRByPWqXLmyET8FERGVNCYtslJTUxEdHY3o6GgALxa7iI6Oxv379yEIAsaMGYPp06fjzz//xKVLl9C3b194eXnpViAkItKHtbU1Nm5YD7mYhee7voO+i6xK5LZwbhOOM2fOYNq0aQZOSYbwukeF/Nvhw4fx3nvvYefOnTh37hyaNWuG9u3b48KFC7naBQYG4vHjx7rX0aNHjRGfiIhKKCtT7vzs2bNo1qyZ7uvw8HAAQL9+/RAREYFx48YhLS0NQ4YMQVJSEho1aoTdu3dDoVCYKjIRlRK+vr74dWUEOnXqBNn57XAIbq/XOPK3qsChQQ9Mnz4doaGhaNy4sYGT0pto3bo1WrduXej2CxYsyPX1N998g61bt2Lbtm2oVauWbruVldUrL10nIiLLZtKZrKZNm0IUxTyviIgIAC+enTV16lTExcUhMzMT+/fvR6VKlUwZmYhKkY4dO2L06NFIjloOddwtvcdxrN8dinJV0fPDXkhKSjJcQDI5rVaLlJQUuLi45Np+8+ZNeHl5oUKFCujVqxfu37//ynH4eBEiIstitvdkEREVh1mzZqFG9epI2vYttOp0vcZ4sax7OJ48fY4hQ4boffkhmZ85c+YgNTUV3bt3120LCQlBREQEdu/ejSVLluDOnTto3LgxUlJSChyHjxchIrIsLLKIyKLJ5XJs2rgB0uwUPNvzg94FkpWDO5zeG4mNGzdi5cqVBk5JprB27VpMmTIFGzZsgLu7u25769at0a1bN9SoUQNhYWHYuXMnkpKSsGHDhgLH4uNFiIgsC4ssIrJ4/v7+WP7LL0i7dgSpf+3VexzbKo1hVz0UI0Z+jFu39L/8kExv3bp1GDRoEDZs2IDQ0NBXtnVyckKlSpVe+XfOx4sQEVkWFllERAC6d++OgQMHQhX5C7KfP9Z7HOcWQ6BVOGDQYF42WFL99ttvGDBgAH777Te0bdv2te1TU1Px999/o2zZssWQjoiISgIWWURE/zN//nx4eXogadd8iFqNXmNI5DZwDB2OQ1GRWL16tYETUlG96lEhwIvL+Pr27atrv3btWvTt2xdz585FSEgI4uLiEBcXh+TkZF2bsWPH4tChQ7h79y6OHz+Ozp07QyqVomfPnsX62YiIyHyxyCIi+h97e3usWb0KGQ+vQXX6D73HUfq9A7sq72LMp+F49uyZARNSUZ09exa1atXSLb8eHh6OWrVqYdKkSQCAx48f51oZ8KeffkJOTg5GjhyJsmXL6l6jR4/WtXn48CF69uyJgIAAdO/eHWXKlMHJkyfh5uZWvB+OiIjMliCW8utZVCoVHB0dkZyczGvgiahQJkyYgNlz5sKjzzzIPCroNYYm9Tnilg9Hvw8/wC+//GLghCUDz78F47EhIjKN4jr/ciaLiOhfpkyZgipVquD5znkQc7L0GkNq5wyHxn2xbNkyHD161MAJiYiIyJyxyCIi+he5XI7f1q6B5vkjJB1epfc4dkGtoHyrMgYNHoKsLP2KNSIiIip5WGQREeWjevXqmDFjOlRntyDz/iW9xhAECZxajsCNGzcwd+5cAyckIiIic8Uii4ioAOHh4WjQoCGSds2HVp2m1xgy9wqwD+6Ar6dMxe3btw2ckIiIiMyRlakDEBGZK6lUijWrVyGwWjU8j1qBMmEf6zWOY6MPob55DMNHjMDuXbsgCIKBkxKRJYqNjUX7Dh2h0ZbqNcwgCED4mNG5HrdAZO5YZBERvUL58uXx7axZ+Pjjj2FbtSkU3tWKPIZEpoRD86HY+8c0bNy4Ed27dzdCUiKyNPPmzcOlq9ehqNzY1FGMKis2BlOnz0Dv3r0hkfAiLCoZuIQ7EdFraLVaNGjYCBdvPYB7v+8hWMn0Gidx8wzYJN3GzRsxcHR0NHBK88Pzb8F4bOhNPXv2DOW8fWBdow2cm/QzdRyjynxwGU/WTsDu3bsRFhZm6jhUwnEJdyIiMyGRSLB82S/QJMcj6dhveo/j1GIInien4IsvvjBgOiKyRIsWLUJWdg4canc0dRSjk5cLhLJsRSz47jtTRyEqNBZZRESFULVqVXz55RdIOf0HsuL1W8DCysEN9g0/xOLFi3H69GkDJyQiS5GWloZ58xfApnoopLZOpo5jdIIgwKZWO+zetQs3btwwdRyiQmGRRURUSBMmTEDlypWRtOcHiFqNXmPYB7eHwqMCBg0egpycHAMnJCJLsGzZsheXOtV939RRio1tlXchs3PCDz/8YOooRIXCIouIqJBkMhlWLF+GzMe3kHJ2q15jCBIpHN8bgUuX/sL3339v4IREVNplZWXhv9/Ohk2Vd2Hl6GHqOMVGsJJBWT0My1esgEqlMnUcotdikUVEVAQhISEYNWoUVMfWIPv5Y73GkHsFwL5WW3z51STcv3/fwAnpnw4fPoz27dvDy8sLgiBgy5Ytr+0TFRWFd955B3K5HBUrVkRERESeNosWLUL58uWhUCgQEhLCyz+p2KxduxaPYx/CIaSLqaMUO7tarZGZmYkVK1aYOgrRa7HIIiIqounTp6OshweS9i6Cvgu0Or3bBxorBT7+5BMDp6N/SktLQ82aNbFo0aJCtb9z5w7atm2LZs2aITo6GmPGjMGgQYOwZ88eXZv169cjPDwckydPxvnz51GzZk2EhYUhPj7eWB+DCMCLlU5nzPwvbN6uC5lbeVPHKXZW9q5QVmqI+d99D61Wa+o4RK9U5CKrX79+OHz4sDGyEBGVCHZ2dvhx6RKk341Gxo0Teo0hkdvCodlgbPvzT2zdqt+lh6VV8+bNMWXKlDzbnz9/jubNmxdprNatW2P69Ono3LlzodovXboUfn5+mDt3LqpUqYKPP/4YXbt2xfz583Vt5s2bh8GDB2PAgAGoWrUqli5dChsbGyxfvrxI2YiKauvWrbh1Iwb2dbuZOorJ2Ad3wL07t7Fr1y5TRyF6pSIXWcnJyQgNDcXbb7+Nb775BrGxscbIRURk1tq0aYNWrVtDdWg5xJwsvcawCWgIG//aGPnxJ8jIyDBwwpIrKioKCxcuRKdOnZCWlqbbnpWVhUOHDhl13ydOnEBoaGiubWFhYThx4oQuw7lz53K1kUgkCA0N1bXJj1qthkqlyvUiKgpRFDHjm5mw8akGRbkqpo5jMjKvACi9KmHe/AWmjkL0SkUusrZs2YLY2FgMHz4c69evR/ny5dG6dWts2rQJ2dnZxshIRGSWFsyfj5yURKjObNGrvyAIcGo+GI8fP8J3fP5LLvv370dcXBzq1auHu3fvFtt+4+Li4OGRezEBDw8PqFQqZGRkIDExERqNJt82cXFxBY47c+ZMODo66l7e3t5GyU+lV2RkJM6dPQO7EMudxQL+t5z7O+1x8MB+XL161dRxiAqk1z1Zbm5uCA8Px8WLF3Hq1ClUrFgRffr0gZeXFz799FPcvHnT0DmJiMxOQEAARo8ahdRTG5GTkqjXGNYub8E2qA2mz5iBhIQEAycsucqWLYtDhw6hevXqqFOnDqKiokwd6Y1MnDgRycnJuteDBw9MHYlKmBnfzITS0x8Kv3dMHcXkbAMaQWbvzOXcyay90cIXjx8/xr59+7Bv3z5IpVK0adMGly5dQtWqVXNdv05EVFp99dVXcLCzRfLhX/Uew7FBD6g1yPc+JEskCAIAQC6XY+3atRg9ejRatWqFxYsXG33fnp6eePLkSa5tT548gYODA5RKJVxdXSGVSvNt4+npWeC4crkcDg4OuV5EhXXu3DkcPLAftnW76P7/sGSClTWUNVojYuWveP78uanjEOWryEVWdnY2fv/9d7Rr1w6+vr7YuHEjxowZg0ePHmHlypXYv38/NmzYgKlTpxojLxGRWXFycsJ/Z36D1MsHoY69rtcYUhtH2IV0w5KlS3H9un5jlCb/XrHxyy+/xJo1azB37lyj77t+/fo4cOBArm379u1D/fr1Abx4VlpwcHCuNlqtFgcOHNC1ITK0b2bOhNzFCzYBDU0dxWzYB7VGVlYWF5whs1XkIqts2bIYPHgwfH19cfr0aZw9exbDhg3L9Vu5Zs2awcnJyZA5iYjM1kcffYTqNWoiOfIXiKJ+ywo7BLeHtYMrPh83zsDpSp47d+7Azc0t17YuXbrg1KlTRf6BKjU1FdHR0YiOjtaNHR0drXs+2cSJE9G3b19d+2HDhuH27dsYN24crl+/jsWLF2PDhg349NNPdW3Cw8Px888/Y+XKlbh27RqGDx+OtLQ0DBgwQM9PTFSwmJgYbP7jD9jWeR+CRGrqOGZDaucMZeXGWPD9D9BoNKaOQ5RHkYus+fPn49GjR1i0aBGCgoLybePk5IQ7d+68aTYiohJBKpVi4Q/fIyP2OtKuROk1hmAlg32jvti+bVuJv//oTfn6+uZ7SVRgYCD69etXpLHOnj2LWrVqoVatWgBeFEi1atXCpEmTALy47P2fD4T28/PDjh07sG/fPtSsWRNz587FL7/8grCwMF2bDz74AHPmzMGkSZMQFBSE6Oho7N69O89iGESGMGvWLFjbOcOuWtEeX2AJ7IPb4+H9e9i2bZupoxDlIYj6PkmzhFCpVHB0dERycjKvgScio+revTu27jkIj4FLIZEpi9xfFEUkrBmLSm42OH/uLCSSkv28eJ5/C8ZjQ4Xx8OFD+PlVgF2j3nAM6WLqOGYpfs3nqOPvgUNRkaaOQiVEcZ1/S/a/4EREZmT27NmAOg3JJzfq1V8QBDg0/QgXoy9g7dq1Bk5HRCXN3LlzIVjLYR/U2tRRzJZtrXY4fCgKly5dMnUUolysTB2AiKi08PX1xfhxn+ObmbNgV6MlrJ0KXm2uIIpygbANaIBx4yegS5cuUCqLPiNGRCXfs2fPsGDBAghyW6RePvD6DpZKq4EgkeC7777DL7/8Yuo0RDossoiIDGj8+PH4+ZdlSI5aDtdO/9FrDMd3++HxshFYunRprgUXiMhyODo6wtHJGclJz5F2OMLUccyatZU1ynn7mDoGUS4ssoiIDMjW1hZz58xGr169YHfvLyh8axR5DGuXt2BbrQVmfDMTgwcPhp2dnRGSEpE5k0qlSHr+zNQxiEhPvCeLiMjAevbsiZB69aGK/AWiVr+lhR0b9MDz58+xcOFCA6cjIiIiY2ORRURkYIIgvFjS/cltpF7co9cYVo7usKnREv+d9S1UKpWBExIREZExscgiIjKC2rVro3///kg5tgaazFS9xnCs3x0pqWlYsGCBYcMRERGRUbHIIiIykpkzZ8IaOUg+qt9y7Fb2rrANao1v58zBs2e8N4OIiKikYJFFRGQknp6emDxpElIv7ED20wd6jeFYrysy1dmYO3eugdMRERGRsbDIIiIyotGjR6Ns2bJQnVivV3+prTNsa7XD/AULkJCQYOB0REREZAwssoiIjEgul+OL/0xE2tXDyH4Wq9cYDiHvI1sLzJo1y8DpiIiIyBhYZBERGdlHH30Edw8P/WezlA6wfacjfli4CE+ePDFwutJv0aJFKF++PBQKBUJCQnD69OkC2zZt2hSCIOR5tW3bVtemf//+ed5v1apVcXwUIiIqIVhkEREZmUKh+N9s1iFkP3+k1xj2dTpCK0i40mARrV+/HuHh4Zg8eTLOnz+PmjVrIiwsDPHx8fm2/+OPP/D48WPd6/Lly5BKpejWrVuudq1atcrV7rfffiuOj0NERCUEiywiomIwaNAguLq6QnVyo179pQo72NRohR8WLkRSUpJhw5Vi8+bNw+DBgzFgwABUrVoVS5cuhY2NDZYvX55vexcXF3h6eupe+/btg42NTZ4iSy6X52rn7OxcHB+HiIhKCBZZRETFQKlUYuKE8Ui/chDZSXF6jWFfpxMyMrOwePFiA6crnbKysnDu3DmEhobqtkkkEoSGhuLEiROFGmPZsmXo0aMHbG1tc22PioqCu7s7AgICMHz4cDx9+vSV46jVaqhUqlwvIiIqvVhkEREVk6FDh8LZ2UXv2SwrOxfYVGuBufPmIz093cDpSp/ExERoNBp4eHjk2u7h4YG4uNcXuqdPn8bly5cxaNCgXNtbtWqFX3/9FQcOHMCsWbNw6NAhtG7dGhqNpsCxZs6cCUdHR93L29tbvw9FREQlAossIqJiYmNjg/HjPkf65QPISc7/nqDXcQjpgufPnhV4uRsZzrJly1C9enXUrVs31/YePXqgQ4cOqF69Ojp16oTt27fjzJkziIqKKnCsiRMnIjk5Wfd68EC/56YREVHJwCKLiKgYDR8+HI6Ojkg+tUmv/tZOnrCt8i7+O+tbZGdnGzhd6eLq6gqpVJpnRcYnT57A09PzlX3T0tKwbt06DBw48LX7qVChAlxdXXHr1q0C28jlcjg4OOR6ERFR6cUii4ioGNnZ2WHc52ORfmkfclSJeo1hX68rYh8+wNq1aw2crnSRyWQIDg7GgQMHdNu0Wi0OHDiA+vXrv7Lvxo0boVar0bt379fu5+HDh3j69CnKli37xpmJiKh0YJFFRFTMRo4cCXs7O6j0nM2SuZWH7dsh+Gbmf6HVag2crnQJDw/Hzz//jJUrV+LatWsYPnw40tLSMGDAAABA3759MXHixDz9li1bhk6dOqFMmTK5tqempuLzzz/HyZMncffuXRw4cAAdO3ZExYoVERYWViyfiYiIzB+LLCKiYmZvb4+xn4Uj7a+9yEl59ap0BY4R0hU3Yq5j69atBk5XunzwwQeYM2cOJk2ahKCgIERHR2P37t26xTDu37+Px48f5+oTExODo0eP5nupoFQqxV9//YUOHTqgUqVKGDhwIIKDg3HkyBHI5fJi+UxERGT+BFEURVOHMCaVSvXi/ofkZF4DT0RmIzk5Gd4+vkClpnBpMVivMRLWTUSghw1Onzpp4HSGwfNvwXhsiIhMo7jOv5zJIiIyAUdHR3wW/inSL+6GJvW5XmPYBnfCmdOncPr0aQOnIyIiojfBIouIyERGjRoFhUIG1ek/9Oqv9K8NuUtZLFjwnYGTERER0ZtgkUVEZCLOzs74dPRopF3cBU1aUpH7CxIpbILaYsPGDXj06JHhAxIREZFezLrI0mg0+Oqrr+Dn5welUgl/f39MmzYNpfw2MiKyIGPGjIHcWgrVmS169ber8R4EqQxLliwxbDAiIiLSm1kXWbNmzcKSJUuwcOFCXLt2DbNmzcK3336LH374wdTRiIgMokyZMhg9ahTSondAk55c5P4SuS2Ugc2xeMlSZGZmGiEhERERFZVZF1nHjx9Hx44d0bZtW5QvXx5du3ZFy5YteZM3EZUq4eHhsJYISDm/Xa/+9sHt8expIn777TcDJyMiIiJ9WJk6wKs0aNAAP/30E27cuIFKlSrh4sWLOHr0KObNm1dgH7VaDbVarftapVIVR1QiIr25urriowH98cuvv8GxXncIVtZF6m/t8hZs/Otg3vwF6N+/PwRBMFJSMpSXl73z3ygiouL18rxr7NuPzLrImjBhAlQqFSpXrgypVAqNRoMZM2agV69eBfaZOXMmpkyZUowpiYje3KhRo7B48WKkXT8Mu2otitzfLrg9Lm+YhMOHD6NJkyZGSEiG9PTpi4dQe3t7mzgJEZFlevr0KRwdHY02vlkXWRs2bMCaNWuwdu1aBAYGIjo6GmPGjIGXlxf69euXb5+JEyciPDxc97VKpeI/YkRk9gICAtAyLAxHzm+DbWDzIs9GKcrXgsLNB/MXLGCRVQK4uLgAAO7fv2/Uf+QN5eW/pQ8ePCgRD09mXuNiXuNiXuNKTk6Gj4+P7jxsLGZdZH3++eeYMGECevToAQCoXr067t27h5kzZxZYZMnlcsjl8uKMSURkEJ+OGYO9rVtDHXsVinKBReorCAJsarXDtj+X4sGDB/zlkpmTSF7cEu3o6Fgifih5ycHBgXmNiHmNi3mNq6TlfXkeNtr4Rh39DaWnp+c5AFKpFFqt1kSJiIiMp2XLlvB/uxJSz/2pV3/bqk0hsZZj+fLlBk5GRERERWHWRVb79u0xY8YM7NixA3fv3sXmzZsxb948dO7c2dTRiIgMTiKRIHzMaKTfOIkcVXzR+8ttoKjcGD/9/As0Go0REhIREVFhmHWR9cMPP6Br164YMWIEqlSpgrFjx2Lo0KGYNm2aqaMRERlF3759YWtri5TzO/Tqb1cjDI9iH2Lv3r0GTkaGJJfLMXny5BJzeTvzGhfzGhfzGhfz5k8Qjb1+oYmpVCo4OjoiOTm5RF0nSkSW67PPPsMPS3+G59AVkMgUReoriiISVo5Gy/o1sGXzZiMlLByef4mIyFKZ9UwWEZEl+vjjj6HJTEPa1cgi9xUEAYrq72H79u2Ii4szQjoiIiJ6HRZZRERmxs/PD63btEHGX3v06m8X2AwQpIiIiDBsMCIiIioUFllERGZo6JAhyHh8C+q4W0XuK1HYQRnQEEt+/ImrsRIREZkAiywiIjPUunVreHiWRepf+i1gYVszDPfv3kFkZNEvOSQiIqI3wyKLiMgMWVlZYdDAj5B57RC0WZlF7i9/qyoUbj746aefjZCOXkWj0eCrr76Cn58flEol/P39MW3aNLxunamoqCi88847kMvlqFixYrFd7qlP3qioKAiCkOdVXPcBpqSkYMyYMfD19YVSqUSDBg1w5syZV/Yx1fEFip63OI/v4cOH0b59e3h5eUEQBGzZsiXX+6IoYtKkSShbtiyUSiVCQ0Nx8+bN1467aNEilC9fHgqFAiEhITh9+rTZ5v3666/zHOvKlSsXS94//vgDLVu2RJkyZSAIAqKjows17saNG1G5cmUoFApUr14dO3fuNNu8EREReY6vQlG0RZ30yZudnY3x48ejevXqsLW1hZeXF/r27YtHjx69dlxDfP+yyCIiMlMDBw5ETmYa0mOOFbmvIAhQVm+JzZs3IykpyfDhqECzZs3CkiVLsHDhQly7dg2zZs3Ct99+ix9++KHAPnfu3EHbtm3RrFkzREdHY8yYMRg0aBD27NHvvjxj530pJiYGjx8/1r3c3d2NnhcABg0ahH379mHVqlW4dOkSWrZsidDQUMTGxubb3pTHV5+8LxXH8U1LS0PNmjWxaNGifN//9ttv8f3332Pp0qU4deoUbG1tERYWhszMgn/5s379eoSHh2Py5Mk4f/48atasibCwMMTHF/35f8WRFwACAwNzHeujR4++cdbC5E1LS0OjRo0wa9asQo95/Phx9OzZEwMHDsSFCxfQqVMndOrUCZcvXzbLvADg4OCQ6/jeu3fvjbO+zFNQ3vT0dJw/fx5fffUVzp8/jz/++AMxMTHo0KHDK8c02PevWMolJyeLAMTk5GRTRyEiKrIWLUJFG++qou/47UV+vTVipQhBEFesWGGS7JZ6/m3btq340Ucf5dr2/vvvi7169Sqwz7hx48TAwMBc2z744AMxLCzMKBn/SZ+8kZGRIgDx+fPnRk6XV3p6uiiVSsXt27fn2v7OO++IX3zxRb59THl89clrquMLQNy8ebPua61WK3p6eoqzZ8/WbUtKShLlcrn422+/FThO3bp1xZEjR+q+1mg0opeXlzhz5kyzzDt58mSxZs2aBs2Wn3/n/ac7d+6IAMQLFy68dpzu3buLbdu2zbUtJCREHDp0qAFS/j9D5V2xYoXo6Oho0Gz5eVXel06fPi0CEO/du1dgG0N9/3Imi4jIjA0ZMhjpD64iO/FBkfta2ZeBjU81/LZunRGSUUEaNGiAAwcO4MaNGwCAixcv4ujRo2jdunWBfU6cOIHQ0NBc28LCwnDixAmjZgX0y/tSUFAQypYti/feew/HjhV9xlUfOTk50Gg0eS43UiqVBc4+mPL46pP3JVMc33+6c+cO4uLich07R0dHhISEFHjssrKycO7cuVx9JBIJQkNDjX689cn70s2bN+Hl5YUKFSqgV69euH//vlGzvglTfj/rKzU1Fb6+vvD29kbHjh1x5coVk+RITk6GIAhwcnLK931Dfv+yyCIiMmMdO3aEs0sZpOi5nLuiUiMcOHAAT58+NXAyKsiECRPQo0cPVK5cGdbW1qhVqxbGjBmDXr16FdgnLi4OHh4eubZ5eHhApVIhIyPD7PKWLVsWS5cuxe+//47ff/8d3t7eaNq0Kc6fP2/UrABgb2+P+vXrY9q0aXj06BE0Gg1Wr16NEydO4PHjx/n2MeXx1SevKY/vP728Byy/Y1fQ/WGJiYnQaDRF6mMo+uQFgJCQEERERGD37t1YsmQJ7ty5g8aNGyMlJcWoefVV0PezuT4bMSAgAMuXL8fWrVuxevVqaLVaNGjQAA8fPizWHJmZmRg/fjx69uwJBweHfNsY8vuXRRYRkRmTy+UY0L8f1FcjIeZkF7m/TUADaDVa/PHHH0ZIR/nZsGED1qxZg7Vr1+L8+fNYuXIl5syZg5UrV5o6Wr70yRsQEIChQ4ciODgYDRo0wPLly9GgQQPMnz+/WDKvWrUKoijirbfeglwux/fff4+ePXtCIjHPH2uKmtfUx9fStG7dGt26dUONGjUQFhaGnTt3IikpCRs2bDB1tFKhfv366Nu3L4KCgtCkSRP88ccfcHNzw48//lhsGbKzs9G9e3eIooglS5YUyz7N82xEREQ6gwYNQlZaMtJvnSpyX6mtM5Tla+C333jJYHH5/PPPdbND1atXR58+ffDpp59i5syZBfbx9PTEkydPcm178uQJHBwcoFQqzS5vfurWrYtbt4r+XDd9+Pv749ChQ0hNTcWDBw9w+vRpZGdno0KFCvm2N+Xx1Sdvforz+L7k6ekJAPkeu5fv/ZurqyukUmmR+hiKPnnz4+TkhEqVKhX78S6sgr6fjX18DeXljHlxHd+XBda9e/ewb9++AmexAMN+/7LIIiIyc1WqVEFw7TrIuBalV39FpUY4dCjKICt70eulp6fnmaGQSqWvfDB0/fr1ceDAgVzb9u3bh/r16xsl4z/pkzc/0dHRKFu2rCGjvZatrS3Kli2L58+fY8+ePejYsWO+7Ux5fP+psHnzY4rj6+fnB09Pz1zHTqVS4dSpUwUeO5lMhuDg4Fx9tFotDhw4YPTjrU/e/KSmpuLvv/8u9uNdWOby/awvjUaDS5cuFcvxfVlg3bx5E/v370eZMmVe2d6Q379WeiUmIqJi1a9vH4z5NByaDBWkyoJ/C5cfm4AGeL5vCX7//XcMHz7cSAnppfbt22PGjBnw8fFBYGAgLly4gHnz5uGjjz7StZk4cSJiY2Px66+/AgCGDRuGhQsXYty4cfjoo49w8OBBbNiwATt27DDLvAsWLICfnx8CAwORmZmJX375BQcPHsTevfo9PLuo9uzZA1EUERAQgFu3buHzzz9H5cqVMWDAgHzzmvL46pO3OI9vampqrhmFO3fuIDo6Gi4uLvDx8cGYMWMwffp0vP322/Dz88NXX30FLy8vdOrUSdenRYsW6Ny5Mz7++GMAQHh4OPr164fatWujbt26WLBgAdLS0nSf19zyjh07Fu3bt4evry8ePXqEyZMnQyqVomfPnkbP++zZM9y/f1/37KaYmBgAL2arXs6c9O3bF2+99ZZudnn06NFo0qQJ5s6di7Zt22LdunU4e/YsfvrpJ7PMO3XqVNSrVw8VK1ZEUlISZs+ejXv37mHQoEFGzVu2bFl07doV58+fx/bt26HRaHT3Vbm4uEAmkwEw4vdvkdYiLIEsdQlhIipdnjx5IkqkUtGl5Qi9lnO3qRAsNmr8brFmttTzr0qlEkePHi36+PiICoVCrFChgvjFF1+IarVa16Zfv35ikyZNcvWLjIwUg4KCRJlMJlaoUKHYlt7XJ++sWbNEf39/UaFQiC4uLmLTpk3FgwcPFkteURTF9evXixUqVBBlMpno6ekpjhw5UkxKSiowryia7vjqk7c4j+/L5eL//erXr58oii+WRf/qq69EDw8PUS6Xiy1atBBjYmJyjeHr6ytOnjw517YffvhB9PHxEWUymVi3bl3x5MmTZpv3gw8+EMuWLSvKZDLxrbfeEj/44APx1q1bxZJ3xYoV+b7/z3xNmjTRtX9pw4YNYqVKlUSZTCYGBgaKO3bsMNu8Y8aM0X0veHh4iG3atBHPnz9v9Lwvl5nP7xUZGakbw1jfv4IovuYR9CWcSqWCo6MjkpOTX3kNJhGRuWvdpg0OX74Htw+/LXLf1L/24dnu7/Hw4UN4eXkZIV1ePP8SEZGl4j1ZREQlRN8+fV48Myup6Mv0KivVhyCRYtOmTUZIRkRERP/EIouIqITo0KEDlDY2SLsaVeS+UoUdlH7vYC1XGSQiIjI6FllERCWEra0tunbpAvW1Q9DnSm9F5cY4dfIEHjx4YIR0RERE9BKLLCKiEqR3797ITHyArCd/F7mvTcUQSKxk2LhxoxGSERER0UsssoiISpDmzZvDzd0DaVcii9xXIreBskIwLxkkIiIyMhZZREQliJWVFXp92BPqmCMQxaI9LBYAlAGNcO7sGdy5c8cI6YiIiAhgkUVEVOJ07doVWSnPoI69XuS+yop1IZXJsWHDBiMkIyIiIoBFFhFRiVO/fn24unsg/cbxIveVyJRQVKiNNbxkkIiIyGhYZBERlTASiQTduryPrFsn9FplUBnQGJcuRuPmzZtGSEdEREQssoiISqAuXbpA/fyJXqsMKv1rw0quxPr1642QjIiIiFhkERGVQO+++y4cnZz1u2TQWgG5f11eMkhERGQkLLKIiEoga2trdO7UEdm3TurVX/l2fVy/egV37941bDAiKpV+/fVXlClTBmq1Otf2Tp06oU+fPiZKRWS+WGQREZVQXbp0QUbCfWQl3i9yX6VfLQgSKXbt2mWEZERU2nTr1g0ajQZ//vmnblt8fDx27NiBjz76yITJiMwTiywiohIqNDQUNnZ2SI85VuS+ErktlOWqYsfOnUZIRkSljVKpxIcffogVK1botq1evRo+Pj5o2rSp6YIRmSkWWUREJZRCoUD7tu2QpeclgzK/d3Dw4ME8l/8QEeVn8ODB2Lt3L2JjYwEAERER6N+/PwRBMHEyIvPDIouIqAR7//3OyIj7Gzmq+CL3VVYIRkZ6Oo4cOWKEZERU2tSqVQs1a9bEr7/+inPnzuHKlSvo37+/qWMRmSUWWUREJVjLli0hkUqRcft8kftau/lB7uDK+7KIqNAGDRqEiIgIrFixAqGhofD29jZ1JCKzxCKLiKgEc3JyQkhIPajvnC1yX0EQYOVbC9t28L4sIiqcDz/8EA8fPsTPP//MBS+IXoFFFhFRCdeubRuo7/0FUZNd5L7KCsG4GXOdS7kTUaE4OjqiS5cusLOzQ6dOnUwdh8hsscgiIirhWrdujRx1OjIfXi1yX2X5IC7lTkRFEhsbi169ekEul5s6CpHZYpFFRFTCBQUFwdXdA5m3zxW5r0Rhx6XciahQnj9/js2bNyMqKgojR440dRwis8Yii4iohBMEAe3atEb23aIvfgEAsvK1cPBgJLKzi365IRFZjlq1aqF///6YNWsWAgICTB2HyKyxyCIiKgVat26NjPi7yFElFLmvwrcmMtLTcO5c0WfCiMhy3L17F8nJyRg7dqypoxCZPRZZRESlwHvvvQeJRIIMPS4ZlHn4w0pug6ioKMMHIyIiskAssoiISgFnZ2eE1Kuv31LuUivI3qqCg5GRRkhGRERkeVhkERGVEm1at4L6/iWIWk2R+8q8q+Po0aO8L4uIiMgAWGQREZUSzZo1Q05mGrKe3C5yX4VPdWSkp/O+LCIiIgNgkUVEVErUqVMHCqUNMu//VeS+vC+LiIjIcFhkERGVEjKZDA0bNkDWg8tF7sv7soiIiAyHRRYRUSnSvFkzZMVe4X1ZREREJsQii4ioFHlxX1Y6suJuFbkv78siIiIyDBZZRESlSO3ataG0sUHmg0tF7sv7soiIiAyDRRYRUSlibW2NRo0aIet+0YssQWoFmVclHD9+3AjJiIiILAeLLCKiUubFfVnXIGpyitzX2jMAx06chCiKRkhGRERkGVhkERGVMk2bNkWOOh1ZT/4ucl/ZW5XxLDEBd+/eNXwwIiIiC8Eii4iolAkODn7xvKwHV4rcV162EgDg1KlTho5FRERkMVhkERGVMtbW1njnnXeQHXejyH2lNo5QlvHCyZMnjZCMiIjIMrDIIiIqhRrUrwfNk5t69ZV4vI3jJ1hkERER6YtFFhFRKRQSEoLM50+gSX1e5L4yr8qIvnABarXaCMmIiIhKP7MvsmJjY9G7d2+UKVMGSqUS1atXx9mzZ00di4jIrIWEhAAA1I9jitxX7hWA7OwsREdHGzgVERGRZTDrIuv58+do2LAhrK2tsWvXLly9ehVz586Fs7OzqaMREZm1cuXKwdXdA+pHRS+yZO5+kFjJuPgFERGRnqxMHeBVZs2aBW9vb6xYsUK3zc/P75V91Gp1rktcVCqV0fIREZkrQRDQoF497P+r6ItfCFJrKDz9cfLkSYwaNcoI6YiIiEo3s57J+vPPP1G7dm1069YN7u7uqFWrFn7++edX9pk5cyYcHR11L29v72JKS0RkXurVC0FW3E2IWk2R+0o9K+H4Cc5kERER6cOsi6zbt29jyZIlePvtt7Fnzx4MHz4co0aNwsqVKwvsM3HiRCQnJ+teDx48KMbERETmIyQkBDmZ6ch+FlvkvjI3X9y/dwcZGRlGSEZERFS6mfXlglqtFrVr18Y333wDAKhVqxYuX76MpUuXol+/fvn2kcvlkMvlxRmTiMgs1a5dG4IgIOtRDGSuPkXqa13GB6IoIiYmBkFBQcYJSEREVEqZ9UxW2bJlUbVq1VzbqlSpgvv375soERFRyeHg4ICKlSpDHVf052VZu7641PrKlSuGjkVERFTqmXWR1bBhQ8TE5F4Z68aNG/D19TVRIiKikqX2O0HQJt4tcj+J3BZyRzdcvXrV8KGIiIhKObMusj799FOcPHkS33zzDW7duoW1a9fip59+wsiRI00djYioRKhRowayEu5CFMUi95W6lMOVKyyyiIiIisqsi6w6depg8+bN+O2331CtWjVMmzYNCxYsQK9evUwdjYioRKhRowZyMtOhUcUXua+0jA/+uszLBYmIiIrKrBe+AIB27dqhXbt2po5BRFQi1axZEwCQFX8HVo4eReprXcYb985vQ2ZmJhQKhTHiERERlUpmPZNFRERvxsvLC45OzsiKv1PkvtauPtBqtbhxo+gPNCYiIrJkLLKIiEoxQRBQs2YNZCfcLXJf6/8t+87FL4iIiIqGRRYRUSlXKygI4tN7Re4nVdhB7lCGy7gTEREVEYssIqJSrkaNGsh4GgttVmaR+0pdvLnCIBERURGxyCIiKuVq1KgBiCKyE/WYzSrjjb8uXzZCKiIiotKLRRYRUSkXGBgIiUSCLH3uyyrjjTu3/4ZarTZ8MCIiolKKRRYRUSmnVCrhVc4HOc9ii9zX2tUHWo0GN2/eNEIyIiKi0olFFhGRBahSuRJynj8qcj+uMEhERFR0LLKIiCxA5YAAiMlFL7KkSgfI7J1ZZBERERUBiywiIgtQqVIlqJ8+gqjVFLmvlYs3l3EnIiIqAhZZREQWoFKlStBqcpCjSihyX2kZb1y8xCKLiIiosFhkERFZgICAAADQb/GLMj64/fdNZGdnGzoWERFRqcQii4jIAnh7e0MmkyNbrxUGvaHJyeEKg0RERIXEIouIyAJIJBL4+fsj57l+M1kAVxgkIiIqLBZZREQWomrlytDosYy7xMYRVnIb3LlzxwipiIiISh8WWUREFiIgoBK0SY+L3E8QBFg7uuLBgwdGSEVERFT6sMgiIrIQfn5+UCcn6LWMu2DnxiKLiIiokFhkERFZCG9vb4haDTSpz4rcV2JXBnfu3TdCKiIiotKHRRYRkYXw8XmxgIVez8py4EwWERFRYbHIIiKyEN7e3gAAjR5FlpW9K54lJiAzM9PQsYiIiEodFllERBbCwcEBdvYOes9kAcDDhw8NHYuIiKjUYZFFRGRBynn76FVkWf2vyOIlg0RERK/HIouIyIJUKO8LbYoeM1n2ZQCwyCIiIioMFllERBbE19cHSHta5H4SawVkto4ssoiIiAqBRRYRkQXx9vZGdnK8Xn2tHPhAYiIiosJgkUVEZEF8fHyQnZ4CrTq96J2VTkhIKPqlhkRERJaGRRYRkQXx9PQEAGjSk4rcV1A6IO6JfrNgREREloRFFhGRBXF2dgYAaDPTitxXonTAk3gWWURERK/DIouIyIL8f5GVWuS+UhtHJCYmGjoSERFRqcMii4jIgrxJkSVROkCV9BwajcbQsYiIiEoVFllERBbEwcEBgiBAq9ZvJksURTx9WvQl4ImIiCwJiywiIgsikUhg7+Co30yWjSMA8JJBIiKi12CRRURkYRydnPRa+EL6vyKLy7gTERG9GossIiIL4+Lsovc9WQCLLCIiotdhkUVEZGHKlHHWr8hS2EKQSFlkERERvQaLLCIiC+Pi7AxkFb3IEgQJrG0deE8WERHRa7DIIiKyMM7OzoC66PdkAYBUboOUlBQDJyIiIipdWGQREVkYZ2dniHoWWYJMySKLiIjoNVhkERFZGGdnZ2j0uCcLAGDNIouIiOh1WGQREVkYZ2dnZKenQhS1Re9spWCRRURE9BossoiILIyzszNEUQsxK6PonWVKJKtUhg9FRERUirDIIiKyMM7OzgCg3zLuMiWSk1lkERERvQqLLCIiC/MmRZZgrYCKlwsSERG9EossIiIL87LI0mfxC4nMBqkpei6aQUREZCFYZBERWRgnJycAgJhZ9GXcBZkSqWmcySIiInoVFllERBbmZZGl10yWXImMtDSIomjgVERERKUHiywiIgsjlUpha2ev9z1ZoigiMzPTCMmIiIhKBxZZREQWSK5QANqcIvcThBf/bOTkFL0vERGRpWCRRURkgaQSKUStpugdJVIAgEajR18iIiILwSKLiMgCSa2sAD2KLOF/RRZnsoiIiArGIouIyAJZWVm90UwWiywiIqKCscgiIrJAVlZSzmQREREZCYssIiIL9KYzWbwni4iIqGAlqsj673//C0EQMGbMGFNHISIq0aysrABRW+R+goSrCxIREb1OiSmyzpw5gx9//BE1atQwdRQiohJP75ksLuFORET0WiWiyEpNTUWvXr3w888/w9nZ2dRxiIhKPCuuLkhERGQ0VqYOUBgjR45E27ZtERoaiunTp7+yrVqthlqt1n2tUqmMHY+IqMSxtrZG5u2LSNw+t0j91I9vAmCRRURE9CpmX2StW7cO58+fx5kzZwrVfubMmZgyZYqRUxERlWzhY0Zj4aLFAIpWLOXYe6Nbt3BUq1bNOMGIiIhKAUEURdHUIQry4MED1K5dG/v27dPdi9W0aVMEBQVhwYIF+fbJbybL29sbycnJcHBwKI7YRESEF+dfR0dHnn+JiMjimHWRtWXLFnTu3BlSqVS3TaPRQBAESCQSqNXqXO/lh//IExGZBs+/RERkqcz6csEWLVrg0qVLubYNGDAAlStXxvjx419bYBERERERERU3sy6y7O3t81z3b2trizJlyvB+ACIiIiIiMkslYgl3IiIiIiKiksKsZ7LyExUVZeoIREREREREBeJMFhERERERkQGxyCIiIiIiIjIgFllEREREREQGVOLuySqql48BU6lUJk5CRGRZXp53zfhxjEREREZR6ouslJQUAIC3t7eJkxARWaaUlBQ4OjqaOgYREVGxEcRS/itGrVaLR48ewd7eHoIgvLKtSqWCt7c3Hjx4AAcHh2JKaD4s/fMDPAYAj4Glf37AcMdAFEWkpKTAy8sLEgmvTiciIstR6meyJBIJypUrV6Q+Dg4OFvvDFcDPD/AYADwGlv75AcMcA85g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",
      "text/plain": [
       "<Figure size 1000x500 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "bend = circular_bend(\n",
    "    x0=2,\n",
    "    y0=4,\n",
    "    z0=1,\n",
    "    R=10,\n",
    "    bend_angle=np.pi / 2,\n",
    "    wg_width=0.45,\n",
    "    wg_thickness=0.22,\n",
    "    medium=Si,\n",
    "    orientation=\"y\",\n",
    "    mirror=True,\n",
    "    sidewall_angle=15 * np.pi / 180,\n",
    ")\n",
    "\n",
    "fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 5))\n",
    "bend.plot(z=1, ax=ax1)\n",
    "bend.plot(x=0, ax=ax2)\n",
    "ax2.set_xlim(8, 12)\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "3961958f",
   "metadata": {},
   "source": [
    "## Directional Coupler "
   ]
  },
  {
   "cell_type": "markdown",
   "id": "0b9ebc83",
   "metadata": {},
   "source": [
    "A directional coupler (DC) composes of two waveguides brought into close proximity for a certain length. The function `directional_coupler` defines a symmetric DC."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "id": "0665ba5f",
   "metadata": {},
   "outputs": [],
   "source": [
    "def directional_coupler(\n",
    "    x0,\n",
    "    y0,\n",
    "    z0,\n",
    "    wg_width,\n",
    "    wg_thickness,\n",
    "    wg_spacing_in,\n",
    "    wg_spacing_coup,\n",
    "    wg_length,\n",
    "    coup_length,\n",
    "    bend_length,\n",
    "    medium,\n",
    "    sidewall_angle=0,\n",
    "):\n",
    "    \"\"\"\n",
    "    This function defines a directional coupler and returns the tidy3d structure of it.\n",
    "\n",
    "    Parameters\n",
    "    ----------\n",
    "    x0: x coordinate of directional coupler center (um)\n",
    "    y0: y coordinate of directional coupler center (um)\n",
    "    z0: z coordinate of directional coupler center (um)\n",
    "    wg_width: width of the waveguide (um)\n",
    "    wg_thickness: thickness of the waveguide (um)\n",
    "    wg_spacing_in : spacing between the input straight waveguides (um)\n",
    "    wg_spacing_coup: gap size of the coupling region (um)\n",
    "    wg_length: length of the input straight waveguides (um)\n",
    "    coup_length: length of the coupling region (um)\n",
    "    bend_length: length of the bending (um)\n",
    "    medium: medium of the waveguide\n",
    "    sidewall_angle: side wall angle of the waveguide (rad)\n",
    "    \"\"\"\n",
    "    # Y positions: input/output and coupling region\n",
    "    y_in = wg_spacing_in / 2 + y0\n",
    "    y_coup = (\n",
    "        y0 + (wg_spacing_coup + wg_width) / 2\n",
    "    )  # center-to-center gap = wg_spacing_coup + wg_width\n",
    "\n",
    "    # X positions\n",
    "    x_start = x0 - wg_length - bend_length - coup_length / 2\n",
    "    x_bend_in_end = x0 - coup_length / 2\n",
    "    x_bend_out_start = x0 + coup_length / 2\n",
    "    x_end = x0 + wg_length + bend_length + coup_length / 2\n",
    "\n",
    "    # Upper waveguide: straight in → s-bend approach → coupling → s-bend exit → straight out\n",
    "    path_top = pf.Path((x_start, y_in), wg_width)\n",
    "    path_top.segment((x_start + wg_length, y_in))  # straight input\n",
    "    path_top.s_bend((x_bend_in_end, y_coup))  # smooth approach to coupling gap\n",
    "    path_top.segment((x_bend_out_start, y_coup))  # coupling region\n",
    "    path_top.s_bend((x_bend_out_start + bend_length, y_in))  # smooth exit from coupling gap\n",
    "    path_top.segment((x_end, y_in))  # straight output\n",
    "\n",
    "    # Lower waveguide: mirror of upper around y=y0\n",
    "    path_bottom = path_top.copy().mirror((x0 + 1, y0), (x0, y0))\n",
    "\n",
    "    # Convert paths to PolySlab geometries\n",
    "    dc_top_geo = td.PolySlab(\n",
    "        vertices=path_top.to_polygon().vertices,\n",
    "        axis=2,\n",
    "        slab_bounds=(z0 - wg_thickness / 2, z0 + wg_thickness / 2),\n",
    "        sidewall_angle=sidewall_angle,\n",
    "    )\n",
    "    dc_bottom_geo = td.PolySlab(\n",
    "        vertices=path_bottom.to_polygon().vertices,\n",
    "        axis=2,\n",
    "        slab_bounds=(z0 - wg_thickness / 2, z0 + wg_thickness / 2),\n",
    "        sidewall_angle=sidewall_angle,\n",
    "    )\n",
    "\n",
    "    # Define tidy3d structure of the directional coupler\n",
    "    dc = td.Structure(\n",
    "        geometry=td.GeometryGroup(geometries=[dc_top_geo, dc_bottom_geo]), medium=medium\n",
    "    )\n",
    "\n",
    "    return dc"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "id": "5b74606c",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAA1sAAAEKCAYAAADkcU9+AAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjYuMCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy89olMNAAAACXBIWXMAAA9hAAAPYQGoP6dpAACDmklEQVR4nO3dd1hT1/8H8HcCZLD3lOFGRQRREUdRQXHvXRX3nrR1b624R+tuFRUHjipWcQAKDtwD68StiGzZm+T8/vBnvk0JCEoSAp/X89zHcs+5N+9c0pBP7rnnchhjDIQQQgghhBBCyhVX2QEIIYQQQgghpDKiYosQQgghhBBC5ICKLUIIIYQQQgiRAyq2CCGEEEIIIUQOqNgihBBCCCGEEDmgYosQQgghhBBC5ICKLUIIIYQQQgiRAyq2CCGEEEIIIUQOqNgihBBCCCGEEDmgYosQJQgPDweHw0F4eLiyoxBCCCGEEDmhYosQOdq6dSv27Nmj7Bjf5ODBg9i4caOyYwAAfv31V3Tv3h1mZmbgcDhYvHhxmbbPy8vDrFmzYGlpCaFQCFdXV4SEhMjse+3aNbRq1QqampowNzfH1KlTkZmZWQ7PghBCCCFVDYcxxpQdgpDKysHBAcbGxkXOYInFYuTn54PH44HLrZjfeXTt2hWPHj3C27dvlR0FHA4H5ubmaNSoEc6fP49FixaVqeAaNGgQjh07hunTp6N27drYs2cPbt++jbCwMLRq1UrSLzIyEm5ubqhXrx7Gjh2LDx8+YO3atWjbti3Onj0rh2dGCCGEkMpMXdkBSOWXlZUFLS0tZceoULhcLgQCgbJjqIw3b97Azs4OSUlJMDExKdO2t27dQkBAANasWYOff/4ZADBs2DA4ODhg5syZuHbtmqTv3LlzYWBggPDwcOjq6gIA7OzsMGbMGAQHB6NDhw7l96QIIYQQUulVzK/USYUVExODUaNGwdLSEnw+H9WrV8eECROQn58PANizZw84HA4uXbqEiRMnwtTUFNWqVZNsv3XrVjRo0AB8Ph+WlpaYNGkSUlNTpR7jxYsX6NOnD8zNzSEQCFCtWjUMHDgQaWlpkj4hISFo1aoV9PX1oa2tjbp162Lu3LlfzV+a7fLy8rBo0SLUqlULfD4f1tbWmDlzJvLy8orsb//+/WjWrBk0NTVhYGCAH374AcHBwQA+f0h//PgxLl26BA6HAw6HgzZt2gAo/pqto0ePwsXFBUKhEMbGxhgyZAhiYmKk+gwfPhza2tqIiYlBz549oa2tDRMTE/z8888QiURfPQYnT55Ely5dJL/DmjVrYtmyZVLbtmnTBkFBQXj37p0ku52dXbH7HD58uKTff5eyDvmTpaTH/ppjx45BTU0NY8eOlawTCAQYNWoUrl+/jujoaABAeno6QkJCMGTIEEmhBXwuzLS1tXHkyJFvzkAIIYSQqonObJFS+/jxI5o1a4bU1FSMHTsW9vb2iImJwbFjx5CdnQ0ejyfpO3HiRJiYmGDhwoXIysoCACxevBhLliyBp6cnJkyYgKioKGzbtg23b99GREQENDQ0kJ+fDy8vL+Tl5WHKlCkwNzdHTEwMTp8+jdTUVOjp6eHx48fo2rUrHB0dsXTpUvD5fLx8+RIREREl5i/NdmKxGN27d8fVq1cxduxY1KtXDw8fPsSGDRvw/PlzBAYGSvouWbIEixcvRosWLbB06VLweDzcvHkTFy9eRIcOHbBx40ZMmTIF2tramDdvHgDAzMys2Hx79uzBiBEj0LRpU/j6+iI+Ph6bNm1CREQE7t+/D319fUlfkUgELy8vuLq6Yu3atQgNDcW6detQs2ZNTJgwocTjsGfPHmhra8PHxwfa2tq4ePEiFi5ciPT0dKxZswYAMG/ePKSlpeHDhw/YsGEDAEBbW7vYfY4bNw6enp5S686dO4cDBw7A1NRUsi4pKanEbF/o6OiAz+eXqu/X3L9/H3Xq1JEqoACgWbNmAD4PHbS2tsbDhw9RWFiIJk2aSPXj8XhwcnLC/fv3yyUPIYQQQqoQRkgpDRs2jHG5XHb79u0ibWKxmDHGmJ+fHwPAWrVqxQoLCyXtCQkJjMfjsQ4dOjCRSCRZv3nzZgaA7d69mzHG2P379xkAdvTo0WJzbNiwgQFgiYmJZcpfmu38/f0Zl8tlV65ckVq/fft2BoBFREQwxhh78eIF43K5rFevXlLPh7H/HQvGGGvQoAFzd3cv8jhhYWEMAAsLC2OMMZafn89MTU2Zg4MDy8nJkfQ7ffo0A8AWLlwoWeft7c0AsKVLl0rt09nZmbm4uJR8EBhj2dnZRdaNGzeOaWpqstzcXMm6Ll26MFtb26/uT5YXL14wPT091r59e6nXAYBSLX5+fjL3m5iYyACwRYsWlTpLgwYNWLt27Yqsf/z4MQPAtm/fzhhj7OjRowwAu3z5cpG+/fr1Y+bm5qV+TEIIIYQQxhijYYSkVMRiMQIDA9GtW7ci3/wDnycw+LcxY8ZATU1N8nNoaCjy8/Mxffp0qQkhxowZA11dXQQFBQEA9PT0AADnz59Hdna2zCxfzvCcPHkSYrG41M+hNNsdPXoU9erVg729PZKSkiRLu3btAABhYWEAgMDAQIjFYixcuLDIBBf/PRalcefOHSQkJGDixIlS13J16dIF9vb2kuPzb+PHj5f6uXXr1nj9+vVXH0soFEr+OyMjA0lJSWjdujWys7Px7NmzMmf/r6ysLPTq1QsGBgY4dOiQ1OsgJCSkVIuXl9d35/giJydH5lmyL8c5JydH6t/i+n5pJ4QQQggpLRpGSEolMTER6enpcHBwKFX/6tWrS/387t07AEDdunWl1vN4PNSoUUPSXr16dfj4+GD9+vU4cOAAWrduje7du2PIkCGSQmzAgAH4888/MXr0aMyePRseHh7o3bs3+vbtW+LMfqXZ7sWLF3j69GmxkzAkJCQAAF69egUul4v69euX6nh8TXHHBwDs7e1x9epVqXUCgaBIRgMDA6SkpHz1sR4/foz58+fj4sWLSE9Pl2r793Vx32rMmDF49eoVrl27BiMjI6m2/w41VAShUCjzervc3FxJ+7//La7vv4tUQgghhJDSoGKLyMX3fDBdt24dhg8fjpMnTyI4OBhTp06Fr68vbty4gWrVqkEoFOLy5csICwtDUFAQzp07h8OHD6Ndu3YIDg6WOpPy30xf204sFqNhw4ZYv369zH1YW1t/8/MqT8U9x69JTU2Fu7s7dHV1sXTpUtSsWRMCgQD37t3DrFmzynSmUJZNmzbh0KFD2L9/P5ycnIq0x8XFlWo/enp65VbcWFhYFJlkBABiY2MBAJaWlpJ+/17/375f+hFCCCGElBYNIySlYmJiAl1dXTx69Oibtre1tQUAREVFSa3Pz8/HmzdvJO1fNGzYEPPnz8fly5dx5coVxMTEYPv27ZJ2LpcLDw8PrF+/Hk+ePMGvv/6KixcvSob5Fedr29WsWROfPn2Ch4cHPD09iyxfzjzVrFkTYrEYT548KfHxSjuksLjj82Xdf4/PtwoPD0dycjL27NmDadOmoWvXrvD09ISBgUGRvmUdDnnlyhX8/PPPmD59On788UeZfSwsLEq1HD58+JuenyxOTk54/vx5kbN4N2/elLQDn++Jpq6ujjt37kj1y8/PR2RkpMzikRBCCCGkJFRskVLhcrno2bMnTp06VeTDKACwr9wb29PTEzweD7/99ptU3127diEtLQ1dunQB8Hn67cLCQqltGzZsCC6XKxne9enTpyL7//JBWNYQsC9Ks13//v0RExODP/74o0jfnJwcycyKPXv2BJfLxdKlS4ucDfr389PS0ioytb0sTZo0gampKbZv3y71HM6ePYunT59Kjs/3+nJG7N8Z8/PzsXXr1iJ9tbS0Sj2sMDY2Fv3790erVq0kMxrKIu9rtpKSkvDs2TOp6/369u0LkUiEnTt3Stbl5eXBz88Prq6ukrOVenp68PT0xP79+5GRkSHp6+/vj8zMTPTr1++bMhFCCCGk6qJhhKTUVqxYgeDgYLi7u0umRY+NjcXRo0dx9epVqanJ/8vExARz5szBkiVL0LFjR3Tv3h1RUVHYunUrmjZtiiFDhgAALl68iMmTJ6Nfv36oU6cOCgsL4e/vDzU1NfTp0wcAsHTpUly+fBldunSBra0tEhISsHXrVlSrVg2tWrUqNkNpths6dCiOHDmC8ePHIywsDC1btoRIJMKzZ89w5MgRnD9/Hk2aNEGtWrUwb948LFu2DK1bt0bv3r3B5/Nx+/ZtWFpawtfXFwDg4uKCbdu2Yfny5ahVqxZMTU0lk238m4aGBlatWoURI0bA3d0dgwYNkkz9bmdnhxkzZnzrr01KixYtYGBgAG9vb0ydOhUcDgf+/v4yi2UXFxccPnwYPj4+aNq0KbS1tdGtWzeZ+506dSoSExMxc+ZMBAQESLU5OjrC0dERwLdfs+Xv7493795JiqjLly9j+fLlAD7/zr6c+du8eTOWLFmCsLAwyT3NXF1d0a9fP8yZMwcJCQmoVasW9u7di7dv32LXrl1Sj/Prr7+iRYsWktf4hw8fsG7dOnTo0AEdO3b8puyEEEIIqcKUOhciUTnv3r1jw4YNYyYmJozP57MaNWqwSZMmsby8PMbY/6Z+lzU9PGOfp3q3t7dnGhoazMzMjE2YMIGlpKRI2l+/fs1GjhzJatasyQQCATM0NGRt27ZloaGhkj4XLlxgPXr0YJaWlozH4zFLS0s2aNAg9vz58xKzl3a7/Px8tmrVKtagQQPG5/OZgYEBc3FxYUuWLGFpaWlSfXfv3s2cnZ0l/dzd3VlISIikPS4ujnXp0oXp6OgwAJJp4P879fsXhw8fluzP0NCQ/fjjj+zDhw9Sfby9vZmWllaR57do0SJWmv+lIyIiWPPmzZlQKGSWlpZs5syZ7Pz580XyZGZmssGDBzN9fX0GoMRp4N3d3Yudxr0s07R/y/7/nfnLMfjvcc3JyWE///wzMzc3Z3w+nzVt2pSdO3dO5mNduXKFtWjRggkEAmZiYsImTZrE0tPTv/s5EEIIIaTq4TD2lfFfhBBCCCGEEELKjK7ZIoQQQgghhBA5oGKLEEIIIYQQQuSAii1CCCGEEEIIkQMqtgghhBBCCMLDw8HhcBAeHq7sKIRUGlRsEUIIIYRUIVu3bsWePXuUHeObHDx4EBs3blR2DAkOhyNzWblyZam2z8vLw6xZs2BpaQmhUAhXV1eEhITI7Hvt2jW0atUKmpqaMDc3x9SpU5GZmVmeT4fIAc1GSAghhBBShTg4OMDY2LjIGSyxWIz8/HzweDxwuRXz+/iuXbvi0aNHePv2rbKjAPhcbLVv3x7Dhg2TWu/s7IwGDRp8dftBgwbh2LFjmD59OmrXro09e/bg9u3bCAsLk7p3aGRkJNzc3FCvXj3JfSDXrl2Ltm3b4uzZs+X+vEj5qVI3NRaLxfj48SN0dHTA4XCUHYcQQqoMxhgyMjJgaWlZYT/EkaolKysLWlpayo5RoXC5XAgEAmXHUDl16tTBkCFDyrzdrVu3EBAQgDVr1uDnn38GAAwbNgwODg6YOXMmrl27Juk7d+5cGBgYIDw8HLq6ugAAOzs7jBkzBsHBwejQoUP5PBlS/pR6ly8Fi46OLvbGqLTQQgsttMh/iY6OVvafAlIJffjwgY0cOZJZWFgwHo/H7Ozs2Pjx41leXh5jjDE/Pz8GgIWHh7MJEyYwExMTpq+vL9l+y5YtrH79+ozH4zELCws2ceJElpKSIvUYz58/Z71792ZmZmaMz+czKysrNmDAAJaamirpExwczFq2bMn09PSYlpYWq1OnDpszZ85X85dmu9zcXLZw4UJWs2ZNxuPxWLVq1dgvv/zCcnNzi+zP39+fNW3alAmFQqavr89at27Nzp8/zxhjzNbWtsj/l+7u7owxxsLCwhhQ9MbwR44cYY0bN2YCgYAZGRmxH3/8kX348EGqj7e3N9PS0mIfPnxgPXr0YFpaWszY2Jj99NNPrLCw8KvHIDAwkHXu3FnyO6xRowZbunSp1LaybnBva2tb7D53797NALBdu3ZJrf/1118ZABYUFPTVXF8DgE2aNIllZ2eznJycMm37yy+/MDU1NZaWlia1fsWKFQwAe//+PWOMsbS0NKaurs5++eUXqX55eXlMW1ubjRo16vueBJGrKnVmS0dHBwAQHR0t+VaAEEKI/KWnp8Pa2lryPkxIefn48SOaNWuG1NRUjB07Fvb29oiJicGxY8eQnZ0NHo8n6Ttx4kSYmJhg4cKFyMrKAgAsXrwYS5YsgaenJyZMmICoqChs27YNt2/fRkREBDQ0NJCfnw8vLy/k5eVhypQpMDc3R0xMDE6fPo3U1FTo6enh8ePH6Nq1KxwdHbF06VLw+Xy8fPkSERERJeYvzXZisRjdu3fH1atXMXbsWNSrVw8PHz7Ehg0b8Pz5cwQGBkr6LlmyBIsXL0aLFi2wdOlS8Hg83Lx5ExcvXkSHDh2wceNGTJkyBdra2pg3bx4AwMzMrNh8e/bswYgRI9C0aVP4+voiPj4emzZtQkREBO7fvw99fX1JX5FIBC8vL7i6umLt2rUIDQ3FunXrULNmTUyYMKHE47Bnzx5oa2vDx8cH2trauHjxIhYuXIj09HSsWbMGADBv3jykpaXhw4cP2LBhAwBAW1u72H2OGDECx48fh4+PD9q3bw9ra2s8fPgQS5YswahRo9C5c2dJ35SUFIhEohIzAoCmpiY0NTWLZN+6dSsYY6hXrx7mz5+PwYMHf3Vf9+/fR506dYp8Jm3WrBmAz0MHv2QuLCxEkyZNpPrxeDw4OTnh/v37X30sokTKrvYUKS0tjQEo8g0CIYQQ+aL3XyIvw4YNY1wul92+fbtIm1gsZoz978xWq1atpM6UJCQkMB6Pxzp06MBEIpFk/ebNmxkAtnv3bsYYY/fv32cA2NGjR4vNsWHDBgaAJSYmlil/abbz9/dnXC6XXblyRWr99u3bGQAWERHBGGPsxYsXjMvlsl69ekk9H8b+dywYY6xBgwaSs1n/9t8zW/n5+czU1JQ5ODhInbU5ffo0A8AWLlwoWeft7c0AsKVLl0rt09nZmbm4uJR8EBhj2dnZRdaNGzeOaWpqSp2969KlS4lns/4rNjaWGRoasvbt27O8vDzm7OzMbGxsirwXyTrjJ2tZtGiR1HYtWrRgGzduZCdPnmTbtm1jDg4ODADbunXrV7M1aNCAtWvXrsj6x48fMwBs+/btjDHGjh49ygCwy5cvF+nbr18/Zm5uXurjQRSPBs4TQgghRCWJxWIEBgaiW7duRb71B1Dk+uwxY8ZATU1N8nNoaCjy8/Mxffp0qWsJx4wZA11dXQQFBQEA9PT0AADnz59Hdna2zCxfzvCcPHkSYrG41M+hNNsdPXoU9erVg729PZKSkiRLu3btAABhYWEAgMDAQIjFYixcuLDItZHfcq36nTt3kJCQgIkTJ0pdy9WlSxfY29tLjs+/jR8/Xurn1q1b4/Xr1199LKFQKPnvjIwMJCUloXXr1sjOzsazZ8/KnP0Lc3NzbNmyBSEhIWjdujUiIyOxe/fuImeTDhw4gJCQkK8u/50IIyIiAtOmTUP37t0xfvx43L17Fw4ODpg7dy5ycnJKzJaTkwM+n19k/Zdj/WX7L/8W1/drj0OUq0oNI5QlKytL8ialTHw+HwKBAAKBAAYGBjAzM4O2tjZN5EEIKZZIJEJSUhISEhKQmZmJ3Nxc5OXlobCwUKm5TExM4OrqqtQMpGpITExEeno6HBwcStW/evXqUj+/e/cOAFC3bl2p9TweDzVq1JC0V69eHT4+Pli/fj0OHDiA1q1bo3v37hgyZIikEBswYAD+/PNPjB49GrNnz4aHhwd69+6Nvn37ljgpTGm2e/HiBZ4+fQoTExOZ+0hISAAAvHr1ClwuF/Xr1y/V8fia4o4PANjb2+Pq1atS6wQCQZGMBgYGSElJ+epjPX78GPPnz8fFixeRnp4u1ZaWllbW6FIGDhyI/fv3IygoCGPHjoWHh0eRPi1btvyux/iCx+Nh8uTJksLr3zMK/pdQKEReXl6R9bm5uZL2f/9bXN9/F6qk4qnyxdb06dPx559/KjuGTHyBEJZW1eBQvx7q1bNH/fr10axZM9StW5dm8yKkCsnMzMSdO3dw7949PHv2DI+fPMXzFy/wKSmxTN+gKwqHw8GdO3fQuHFjZUchRMr3fChdt24dhg8fjpMnTyI4OBhTp06Fr68vbty4gWrVqkEoFOLy5csICwtDUFAQzp07h8OHD6Ndu3YIDg6WOqP230xf204sFqNhw4ZYv369zH1YW1t/8/MqT8U9x69JTU2Fu7s7dHV1sXTpUtSsWRMCgQD37t3DrFmzvvt9Ljk5GXfu3AEAPHnyBGKxuMjnqMTExFJds6WtrV3idWLA/34fnz59KrGfhYUFYmJiiqyPjY0FAFhaWkr6/Xv9f/t+6UcqpipfbCUlJUFg6wjjrr8oLQMDA0SFYIX5YIX5EOVmQJyVClFWKpLSE3Dh8QeERNxC7qc4AIC2ji5cXZuhQ/v28PLygqOjI50BI6QSyczMRFhYGM6fP48LYeF4/uwpxGIx1Hh88I2sAX1LaNRqB31nI6hp6UNNUw8cniY46hrgqPHA4X7bB57yUJiegDj/n0r1TTYh38vExAS6urp49OjRN21va2sLAIiKikKNGjUk6/Pz8/HmzRt4enpK9W/YsCEaNmyI+fPn49q1a2jZsiW2b9+O5cuXA/g8dbqHhwc8PDywfv16rFixAvPmzUNYWFiRff3b17arWbMmHjx4AA8PjxL/3tesWRNisRhPnjyBk5NTsf1K+5nh38fny5DFL6KioiTt3ys8PBzJyck4fvw4fvjhB8n6N2/eFOn7LZ93Jk2ahIyMDPj6+mLOnDnYuHEjfHx8pPo0bdpUciavJIsWLcLixYtL7PNl2GRxZyK/cHJyQlhYGNLT06WGNd68eVPSDny+L5q6ujru3LmD/v37S/rl5+cjMjJSah2peKp8sQUAHHUe1LQNlB3jq8R5WciLfYH8j1G4/uYpwhcswqxZs2BiZo7+fftg8ODBcHNzo8KLEBWUlpaGEydO4MDBgwgPC0dhYQEEhhZQr9YQ+h3agW9ZFxpG1kotpEpDXFh0mAsh8sLlctGzZ0/s378fd+7cKXLdFmOsxL+Jnp6e4PF4+O2339CxY0dJ3127diEtLQ1dunQB8Hk2TU1NTair/+9jU8OGDcHlciVDuz59+gRDQ0Op/X/5sCxr+NcXpdmuf//+OHPmDP744w+MHTtWqm9OTg7EYjG0tLTQs2dPzJo1C0uXLsWxY8ekzt78+1hoaWkhNTW12ExfNGnSBKampti+fTtGjhwpuWbo7NmzePr0KRYuXPjVfZTGlzNijDHJuvz8fGzdurVIXy0trTINKzx27BgOHz6M3377DVOmTMGDBw8wf/58dO3aFXXq1JH0O3DgQKmuffp3UZ6YmFikoMrIyMDGjRthbGwMFxcXyfov19nZ2NhIZjPs27cv1q5di507d0rus5WXlwc/Pz+4urpKzpDp6enB09MT+/fvx4IFCySzuvr7+yMzMxP9+vUr9fEgikfFlgrh8rUgtHOC0M4JAMAKC5D74TFyXt3Gn/sPY8uWLbCytsHY0aMwevRoOq1MSAXHGEN4eDi2bt2Kk3+fQkFBPjRtHKDTZiSE1RtD3cCSvjwh5CtWrFiB4OBguLu7S6ZFj42NxdGjR3H16lWpqcn/y8TEBHPmzMGSJUvQsWNHdO/eHVFRUdi6dSuaNm0quVHtxYsXMXnyZPTr1w916tRBYWEh/P39oaamhj59+gAAli5disuXL6NLly6wtbVFQkICtm7dimrVqpV43U5pths6dCiOHDmC8ePHIywsDC1btoRIJMKzZ89w5MgRnD9/Hk2aNEGtWrUwb948LFu2DK1bt0bv3r3B5/Nx+/ZtWFpawtfXFwDg4uKCbdu2Yfny5ahVqxZMTU2LnLkCAA0NDaxatQojRoyAu7s7Bg0aJJn63c7ODjNmzPjWX5uUFi1awMDAAN7e3pg6dSo4HA78/f2liq8vXFxccPjwYfj4+KBp06bQ1tZGt27dZO43ISEBEyZMQNu2bTF58mQAwObNmxEWFobhw4fj6tWrkoL0W67Z2rJli2SCFhsbG8TGxmL37t14//49/P39pW47sHnzZixZsgRhYWFo06YNAMDV1RX9+vXDnDlzkJCQgFq1amHv3r14+/Ytdu3aJfVYv/76K1q0aCF5nX/48AHr1q1Dhw4d0LFjxzJnJ4pDxZYK46hrSIov1m4U8qIfI+1xGJatWImly5ahZ48e+Pnnn9G8eXNlRyWE/EtOTg52796Njb/9jpfPoyAwsYF2yx+hWe8HqOsYKzseISrFysoKN2/exIIFC3DgwAGkp6fDysoKnTp1KnI/JFkWL14MExMTbN68GTNmzIChoSHGjh2LFStWQENDAwDQqFEjeHl54dSpU4iJiYGmpiYaNWqEs2fPSv7Gdu/eHW/fvsXu3buRlJQEY2NjuLu7Y8mSJZJJNGQpzXZcLheBgYHYsGED9u3bhxMnTkBTUxM1atTAtGnTpM7QLF26FNWrV8fvv/+OefPmQVNTE46Ojhg6dKikz8KFC/Hu3TusXr0aGRkZcHd3l1lsAcDw4cOhqamJlStXYtasWdDS0kKvXr2watWqEgvZsjAyMsLp06fx008/Yf78+TAwMMCQIUPg4eEBLy8vqb4TJ05EZGQk/Pz8sGHDBtja2hZbbE2YMEFypujLF1dGRkbYuXMnevTogbVr12LmzJnfnLtly5a4du0a/vzzTyQnJ0NLSwvNmjXD7t27iz2e/7Vv3z4sWLAA/v7+SElJgaOjI06fPi01nBIAGjdujNDQUMyaNQszZsyAjo4ORo0aJSmgScXFYbK+Nqik0tPToaenh7S0NMnY2F69euH8ww8w7btYueHKkTgvC5mPLiIn8gxyk6LRrp0HFi1aWOR/XEKIYmVlZWHHjh1YuWo1khIToVm3BbSdu4Bv7VBpzmAVpMbh447RCA0NlZrxS9b7LyGEEFLZ0ZmtSojL14KuSzfoNO6C7KhruH7jCNzd3eHVsSM2rF+PevXqKTsiIVWKSCTC3r17MXvOXCQnJ0GzQTtY9OwHDQMa6ksIIYRUZlW+2HJ2dkZgYCCi1/ZUag6uuga46jxwNfjgaukDAj1wdYygYWAFdaNq4JnYQV235Flt/ovD4ULLvhU067ZAdtQ1hF/ZC4eGDTFh/HgsX7683E7/E0KKd/XqVUycNBkP/3kA7fruMO81FBr65t+0LyYqQH7iOxQkR6PwUwwKUmOB7FQgOxWinAyIC/MhLiwAE399+mJ5Yfg8WKI0w7cIIYSQyq7KDyMEgG3btsm8CFNRGGPIz89HXl4eMjMzkZCQgNjYOLx5+w4vX75AXu7/3zlczwRq5rUhsGsMzVquZZ5BkRUWIP3uKWTeCIChni527tiOHj16yOMpEVLlpaenY/bs2di2bRuEVvbQazsafCv7Mu2DMTHyPz5H9ssbKIx5gry4VxAVfJ6dzMTMHLVr1YJ1NSuYm5vDyMgIAoEAfD5fasY0ZTA3N0fv3r2l1tEwQkIIIVURFVsVnFgsRkxMDO7du4cbN27g0uUruHnjOsSMQdPKHryartCs7QoNo9Lf0LAwPQkpIVuQ/fI2BgwYgO3bt9NZLkLKUVhYGIYMHYaEpGTotB4GncZdwOGU7kbkrLAAue8eIPvFDeS/voX8jE8wMDRCe08PuLm5oXnz5mjQoIFk6l9VoYrvv4QQQsj3omJLBSUnJyMoKAgnTpzAufPByM3JhtC8BjQb94BW/R/AUdP46j4YY8h+egmpodthYWqMv44eQdOmTRWQnpDKSyQSYdmyZVi6dCmENo4w6DQV6npmpdq2MC0e6bdPIudxKApzs2FbvQb69u6Fnj17ws3NTXIfGlVVWd5/CSGEkLKgYkvF5eTkICQkBNt37MDZM2fA1zWG0LkrdJw6givQ/ur2BalxSDm1GgUJb7Bp00ZMnDhRAakJqXySk5PRp28/XL50CbotB0HPrX+pbkCcF/scmbcDkfXsKnT19DBp4gQMHjwY9evXrzQzFAKq8f57+fJlrFmzBnfv3kVsbCxOnDiBnj17lmrbiIgIuLu7w8HBAZGRkXLNSQghRHVQsVWJPHnyBOvXr8e+ff5gXHVoOnpBr+VAcPlaJW7HRAVICduNjLunMHHiRGzatEnp13wQokqePXuGjp274GNCMgy7zYLA1vGr2+R+eIqMK3uR/f4RbKvXwMyff4K3tze0tEr+/1VVqcL779mzZxEREQEXFxf07t271MVWamoqXFxcUKtWLcTHx5ep2BKLxfj48SN0dHQqVXFNCCGqgDGGjIwMWFpaSm5wXd6o2KqE4uLisHnzZmzYuBGFXB503EdCq36br/4hz4g8i9TQ7WjXrh2O//WXyl0TQogyXLx4ET169UKhwBCGveZ/daZBUXYaUsP9kPkwFI2cnLFwwXz06NFD5YcJfo2qvf9yOJxSF1sDBw5E7dq1oaamhsDAwDIVWx8+fIC1demvuSWEEFL+oqOjUa1aNbnsm05fVELm5uZYvnw5xo8fDx8fHxw9ug45D4Oh5zEePBPbYrfTceoEdQNLhAeuQDsPT5w/dxaGhoYKTE6Iavn777/Rt28/aFg3hEn3WeDyi5/unIlFyPwnGBlX9kGooYZt27ZhzJgxlb7Iquz8/Pzw+vVr7N+/H8uXL/9q/7y8POTl5Ul+/vJ9Z3R0tEoUoYQQUpmkp6fD2tparicYqNiqxKpVq4YjR44gJCQE4ydMxNu9U6HdrA/0Ww4GR032r15o2wjGA37Fg2OL8IN7G1wIDYGZWeku8CekKjl06BCGDB0KYa3mMOr2c4kT0xQkRyPl7EbkxERh+PDhWL16NUxMynbfPFLxvHjxArNnz8aVK1dKPfTa19cXS5YsKbJeV1eXii1CCFESeQ7jls/gRDmJiYnBkCFDYGRkBKFQiIYNG+LOnTvKjlXhtW/fHk8eP8LiRYuQdfs4EgPmoDAtodj+fPNaMB7oixfvYuDh2R4pKSkKTEtIxXf8+HEMGTIEmvXcYdR9ZomFVuaji0jw94GVJsPVq1fh5+dHhVYlIBKJMHjwYCxZsgR16tQp9XZz5sxBWlqaZImOjpZjSkIIIcqmMsVWSkoKWrZsCQ0NDZw9exZPnjzBunXrYGBQthv7VlV8Ph8LFizA1StXYMTJQsK+acj98LjY/jxjGxj1W4bnr9/Bq2MnZGZmKjAtIRVXcHAwBgwYCM26rWDYaVqxMw4ysQifQrYjOWg9Bg/oj/v37qJly5YKTkvkJSMjA3fu3MHkyZOhrq4OdXV1LF26FA8ePIC6ujouXrwoczs+ny85i0VnswghpPJTmWGEq1atgrW1Nfz8/CTrqlevrsREqql58+b450EkevbqhYgjC2HY9Sdo1mkhsy/PxBZGfRfj/uF56NO3L84EBdH1JaRKu3//Pnr07AWerRMMu8wottASF+ThU9A65Ly4ge3bt2PcuHEKTkrkTVdXFw8fPpRat3XrVly8eBHHjh2jv0+EEEIAqNCZrb///htNmjRBv379YGpqCmdnZ/zxxx8lbpOXl4f09HSphQAGBgYIPn8evXt2R2KgLzLuBRXbl29RB4Y95iAkOAQzZ85UYEpCKpa4uDh06doNHH0rGPWYVezQQVFOBpKPLkThu/sIDAykQkuFZGZmIjIyUjKb4Js3bxAZGYn3798D+DwEcNiwYQAALpcLBwcHqcXU1BQCgQAODg6Vdgp/QgghZaMyxdbr16+xbds21K5dG+fPn8eECRMwdepU7N27t9htfH19oaenJ1loet3/4fP5CAgIwPRp0/ApZBtSLu1FcXcBEFZvDP12o7F+/Xrs2bNHsUEJqQDy8vLQo2cvJGfmwrDXPHA1BDL7FaYnIOnQLPAyYxEedhHdunVTcFLyPe7cuQNnZ2c4OzsDAHx8fODs7IyFCxcCAGJjYyWFFyGEEFIaKnOfLR6PhyZNmuDatWuSdVOnTsXt27dx/fp1mdv8d4rdL9M7qsp9XhRl/fr1+Omnn6DbtBf0246UOSMLYwyfzv2O/KjLuHf3Dho0aKCEpIQoh4+PDzb99jtMB68C37KuzD6FGUlICpgDU20eQoLPo25d2f2qKlW7z5ai0HEhhBDlUcR7sMqc2bKwsED9+vWl1tWrV6/EbxnpQuTS8fHxwW+//Yb02yeQfv2IzD4cDgcGnuPA1TNHn379kZ2dreCUhCjH6dOnsWHDBui1GVFsoSXKTkPysUUwEqrh6pXLVGgRQgghBIAKFVstW7ZEVFSU1Lrnz5/D1rb4m/SS0psyZQqWLVuG1Cv+yHx4QWYfrgYfBl1/wctXr/DTTz8pOCEhihcfH4+hw7yhVasZdFy6y+zDCgvw6cSv0BRlIeziBdjY2Cg4JSGEEEIqKpUptmbMmIEbN25gxYoVePnyJQ4ePIidO3di0qRJyo5WacybNw8jR45ESvBm5H54KrMPz8QWuj8Mx/bt23H58mUFJyREsaZMmYKsfBEMOk0rfnjt+c0oSHiFM0Gny3S/JUIIIYRUfipTbDVt2hQnTpzAoUOH4ODggGXLlmHjxo348ccflR2t0uBwONi2bRuau7oi5e8VEGWnyeyn07gLhNXqYdToMcjNzVVwSkIU49SpUzh69Cj02o2BmqaezD4Z904j89EF+O3eBVdXVwUnJIQQQkhFpzLFFgB07doVDx8+RG5uLp4+fYoxY8YoO1Klw+Px8Nexo9BU5yAleIvMGQo5HC70vabg9evXWLNmjRJSEiJfOTk5mDBxEjRruECznrvMPvkJr5EWvhtTpkyhL30IIYQQIpNKFVtEMczNzfHHzh3IirqGrCfhMvvwjG2g7dIdvitXITY2VrEBCZGzDRs2IDY2FvoeY2UOHxQX5CHl9BrUr1cPq1evVkJCQgghhKgCKraITH379sXgwT8i7cIOFKYnyeyj59YfhRx1zJ8/X8HpCJGf+Ph4/LpiBbScu0DD0Epmn7RrhyBKjcfhgEMQCGTfc4sQQgghhIotUqzNm3+Hsb4uUs5tkjmckCvQhrbbQPj5+eH58+dKSEhI+fP19UWBmAO9FgNltufHv0LGrRNYtGhhkdtREEIIIYT8GxVbpFgGBgbY47cb2W/uI/up7JkHdRp5QUPHEL6+vgpOR0j5S0hIwPYdO6HZuBvUhDpF2hljSA3dDnt7e8ycOVMJCQkhhBCiSqjYIiXy8vJCt+7dkXF1H1hhfpF2jjoPWi494b9/P969e6eEhISUn40bN0LEOMXeUys7KgI5H57i9982QUNDQ8HpCCGEEKJqqNgiX7V2zRoUZiQj/e4pme3aTp3A5Wni999/V3AyQspPdnY2Nm/ZCk1HL9lntUSFyLiyF506d4aHh4cSEhJCCCFE1VCxRb6qTp06GDF8OLLvBEJckFekncsTQNjAA3/u2o2cnBwlJCTk+wUEBCAjIx3ajbvIbM96cgl5n2KxkobMEkIIIaSUqNgipTJ79mwUZqch859gme3aTh2RlpqCo0ePKjgZIeVj85at0KzhAg198yJtTCxC1q1j6NK1KxwdHZWQjhBCCCGqiIotUio1a9bEgAEDkX3vbzAmLtKuYWgFzerO2PnHn0pIR8j3efjwIe7fuwutRh1ltue8voPcpGjMnzdPwckIIYQQosqo2CKlNnXqFOR9ikXu63sy24X2P+BaxFV8/PhRwckI+T4BAQHQ0NSBsIaLzPasyLNwbuyC5s2bKzgZIYQQQlQZFVuk1FxdXdHQsRGyHpyT2a5Zxw0crhoNJSQqhTGGA4cCwK/lBo5a0RkGC9Pikf36LiZPmqiEdIQQQghRZVRskVLjcDgYO2Y0sl/fhignvUg7V6ANYQ0XHD5CxRZRHf/88w/evXkNTftWMtuznlyCQCDEgAEDFJyMEEIIIaqOii1SJn379gWHMWQ/vy6znV/dBTdv3kB6etFijJCKKDg4GGo8AQTWDWW250VdRY/u3aGlpaXgZIQQQghRdVRskTIxNzdH6x/ckfv8msx2QfXGEItECA8PV2wwQr7RuXPnwbduCI560SGEBZ9ikBP/GgMG9FdCMkIIIYSoOiq2SJl179YVedGPwArzi7Rp6JtDYGiB8+fPKyEZIWWTnZ2NK1evgm/rJLM95809qKtroEOHDooNRgghhJBKgYotUmbt27eHqCAPuR+eyGxXt3HC2fOy78dFSEVy5coVFOTnQVDdWWZ7/rtINHdzoyGEhBBCCPkmVGyRMnNwcICxqRly396X2S60c8abVy/x7t07BScjpGxCQkLA1zOGhpF1kTYmKkRe9CN09KKzWoQQQgj5NlRskTLjcDjo5NUBBe8fyGwX2DqCo6aGoKAgBScjpPQYYzh56jTUrZ3A4XCKtOfFPkdhbhYNISSEEELIN6Nii3yTDh06ICf2JURZqUXauAJtCG2dcPBQgOKDEVJKDx8+xMvnUdCybymzPffNfejpG6Bx48YKTkYIIYSQyoKKLfJN2rdvDwDIeX1HZrvQvjWuRVxFTEyMImMRUmoBAQHQ0NSBwM5JZnv+2zvo0L491NTUFBuMKM3ly5fRrVs3WFpagsPhIDAwsMT+x48fR/v27WFiYgJdXV24ubnR5ECEEEKkULFFvomZmRlatGyFnKirMts167iBq8HH7t27FZyMkK8rKCjArt1+4NdpBY6ajCnfUz4i5+ML9OvXVwnpiLJkZWWhUaNG2LJlS6n6X758Ge3bt8eZM2dw9+5dtG3bFt26dcP9+7KvZyWEEFL1qCs7AFFdgwcNxPVp0yDKToOapp5UG5evBaH9D9i6fQfmzJkDdXV6qZGK4++//0ZCfBwsOneS2Z799AqEmpro0qWLgpMRZerUqRM6dZL9mpBl48aNUj+vWLECJ0+exKlTp+DsLHuGS0IIIVWLyp7ZWrlyJTgcDqZPn67sKFVW3759wWEM2c9kn93Sdu6MuI8xOHnypIKTEVKyjZt+g7BaPfBMaxRpY4wh99kldO/WHZqamkpIR1SVWCxGRkYGDA0Ni+2Tl5eH9PR0qYUQQkjlpZLF1u3bt7Fjxw44OjoqO0qVZmZmhi5duyLnn/NgjBVp55vXgqatI5Yt/1VmOyHKcO3aNVy9chnaTXrJbM/78Bi5ie8xZsxoBScjqm7t2rXIzMxE//79i+3j6+sLPT09yWJtXfS2A4QQQioPlSu2MjMz8eOPP+KPP/6AgYGBsuNUeRMnTEBO/Gvkf3wms127eX88iLyPc+fOKTgZIbItW74cAlNbCOs0l9meGXkW1WvWQtu2bRWcjKiygwcPYsmSJThy5AhMTU2L7TdnzhykpaVJlujoaAWmJIQQomgqV2xNmjQJXbp0gaen51f70nAN+evQoQNs7Koj495pme0C20YQVquH2XPmQiwWKzgdIdIuX76Mc2fPQtu1Pzicom9/hRnJyImKwOSJE8DlqtzbI1GSgIAAjB49GkeOHPnq3yY+nw9dXV2phRBCSOWlUp8mAgICcO/ePfj6+paqPw3XkD8ul4uZP/+E7KdXUJDysUg7h8OBrvtI/PMgEv7+/kpISMhnYrEY02f4QGhZB5r1Wsvsk377BDS1NDFq1CgFpyOq6tChQxgxYgQOHTpEE6oQQggpQmWKrejoaEybNg0HDhyAQCAo1TY0XEMxRo4cCSNjY6TfOCazXVCtHrTsW2HW7M+/D0KUYffu3bh/7y5024yUeVZLlJ2G7AfnMH3qVOjp6cnYA6nsMjMzERkZicjISADAmzdvEBkZiffv3wP4/Ddl2LBhkv4HDx7EsGHDsG7dOri6uiIuLg5xcXH0PkcIIURCZYqtu3fvIiEhAY0bN4a6ujrU1dVx6dIl/Pbbb1BXV4dIJCqyDQ3XUAyhUIhZM39B9uMLKEiJldlHv+1IJKekYdasWQpORwjw9u1bTJs+HdoNPSGwdpDZJ/3WcfDU1TBt2jQFpyMVxZ07d+Ds7CyZtt3HxwfOzs5YuHAhACA2NlZSeAHAzp07UVhYiEmTJsHCwkKy0GuIEELIFxymItPEZWRk4N27d1LrRowYAXt7e8yaNQsODrI/QP1beno69PT0kJaWRoVXOcvOzkbNWrWRoVcdxj3myOyTce80PoVsR1hYGNq0aaPYgKTKEovFcG/TFrcfRcHU+3dw+UWncy9Mi0fsn+OxYN5cLF68WPEhqwB6/5WNjgshhCiPIt6DVebMlo6ODhwcHKQWLS0tGBkZlarQIvKlqamJVSt9kfUsArkfnsjso+3cGZq2DTH4xyH49OmTghOSqmrTpk24euUy9L2mySy0ACDt0l4YGxnhl19+UXA6QgghhFRmKlNskYpvyJAhcHJujPQLO8BEhUXaORwuDDr/hKTUDIwYOZLuvUXk7unTp5g1ew50mvSAwFb2ffly3/2DzKeXsdJ3BbS0tBSckBBCCCGVmUoXW+Hh4di4caOyY5D/x+Vy8ecfO5GX8AbpdwJl9lHXNYZ+x6n4++TJUs8qSci3SE1NRfcePaGmZwb9H4bJ7CMuyENayBa0bNUa3t7eCk5ICCGEkMpOpYstUvG4uLhgxowZyIg4hIJPMTL7aNZuDr2WgzBv3jwEBgYqNiCpEkQiEQYMHIh3MbEw7DkPXA2+zH5pEYcgykjCrj//oPtqEUIIIaTc0acLUu6WLFkCa+tqSAlaByYqkNlHr+UgaNm3xMBBgxEREaHghKQyY4xh3LhxCAkJhUG3WdAwtJLZL/fdP0i/9ReWLF6EunXrKjglIYQQQqoCKrZIudPS0sLRwwEoSHiD1Ev7ZPbhcLgw7OwDNbNa6Ni5s+S+NoR8D8YYfv75Z+zatQuGnaZCaOcks58oOw0pZ9bjB3d3zJw5U7EhCSGEEFJlULFF5KJJkyZYvXoV0m+fQPaLGzL7cDX4MOq1ACItM7Rp2w7Xrl1TcEpSmYhEIkyfPh3r16+Hgec4aDt4yOzHxCJ8CloPbQ3g0IEDUFNTU3BSQgghhFQVVGwRuZk+fTp69e6NlKD1yE98K7MPl68Jo/7LUKBrhbbtPHDy5EnFhiSVQm5uLgYMGIDff98Mww4ToevSrdi+qeF7kPsuEgGHDsLS0lKBKQkhhBBS1agrOwCpvDgcDvz37UNztxZ4cWI5TIasg5qmXpF+agJtGPdbiuSgdejduze2bt2KcePGKSExUUUpKSno1r0Hbty8BeOec6BZx63YvpkPQ5F++wQ2bdqE9u3bKzAlIaSiKCwsxKBBg1BQIPua4qps69atCvkSKikpCaNHj5b746gaLpeLgIAA8Hg8ZUch5YiKLSJXWlpaOH3qb7g0aYrkv5bAuP9ymTeW5ajzYNRtJlIu/onx48cjOjoaS5cupRniSInev38Pr46d8OrdBxj3Xw5BtXrF9s1+dRsp53/H6NGjMWXKFAWmJIRUJHfv3sWxY8cgsHEEp5iZSquinFe30bt3bwwbJvtWGeXpwoULOHnyJIQ1mwDgyP3xVAETFSD3bSRu3LiBH374QdlxSDmiYovIna2tLUJDgtHa3R3JJ5bBqM9imVNxc7hqMPAYCzUdY/y6YgVu3rqF/f7+MDMzU0JqUtH9/fffGDrMG3lcAUwGr4KGkXWxfXPfP8SnkyvRtWtXbNu2DRwO/XEnpKoKCQmBukALpgOWgcOlaza/SNg3HcHBIQoptoKDgyE0tYVp38VyfyxVwZgYsVuGIiQkhIqtSoZOGxCFcHJywrkzZyBOeIXkwF8hzs+V2Y/D4UDPtQ9M+y3F5et30NCxEU6cOAHGmIITk4oqNTUVEydORI8ePSAys4fJ0A0lF1rRj5B8fBncW7fCkcOHoa5O3zERUpWdDw4Bz7ohFVr/oWHTCOdDQuT+95YxhnPBIVC3biTXx1E1HA4XGtaOOBccouwopJxRsUUUpmXLljgTdBosLgrJxxZCnJdVbF9hdWeYeG9Cto4NevfujU6dO+PVq1cKTEsqGsYY9u/fj9p16uKP3Xth4DkORj3nQU2oU+w2Oa/uIOnoIrRyc8XJk4Hg82nIECFVWWZmJm5cvw6+LX3Q/y+BrROSEuLx+PFjuT7Oy5cv8fFDNATF3JqjKhPYNsK9O7eRmpqq7CikHFGxRRSqbdu2uHghFGppMUg6PA+FGcnF9lXXNoRRn4Uw6TUP4TfuoV79BliyZAlyc2WfFSOV1+PHj/GDexsMHToUOcZ1YTZqK3RdupU4HDDrSTiSTixHp44dcPbsGWhrayswMSGkIrp8+TIKCwsgtHNWdpQKh1+tPrjqPISEyPfMSkhICDhqahBYO8j1cVSRsLozxGIxwsLClB2FlCMqtojCNW/eHFevXIYespF04Cfkxb0sti+Hw4FmHTeYjtgKYePuWLpsOerWq4+dO3ciJydHgamJMjx//hzjx49HIycn3Hn6Gqb9l8G4+yyo6xgXuw1jYqRe2Y+kU2sx5McfcfyvvyAQCBSYmhBSUYWGhoKvbwp1QytlR6lwuBp8CKzrI1jOxVZwSAiEVvVkTpZV1anrmUFgZIXQ0FBlRyHliIotohSOjo64d/cOGtSyQ+KhWch6cqnE/lyeAAbu3jAf8TuS+RYYN348qlnbYOnSpUhKSlJQaqIIjDFERESgR8+esLe3h9/Bo9BpNQSm3r9DWL3kb6PFedlIPrkK6dcPY+XKldizxw8aGhoKSk4IqejOng+GurUjTZJTDJ6NEy5duoT8/Hy57L+wsBAXLlyEhg0N4yyOurUjzp4LVnYMUo6o2CJKY2FhgatXLqNfn95IOrUGyec3Q1yQV+I2GkbWMO45F5ZjdqDA1hVLf12BatY2mDBhAiIiIiASiRSUnpS3T58+Yd++fXBt7oZWrVoh+Np9GHhNgfnYP6Hn2hcc9ZKLpvz4V0j0nwHEPMDx48cxa9Ys+kBFCJGIi4vDsyePaQhhCQR2TsjJzsaNGzfksv+7d+8iMyMdQrpeq1hCO2e8ef0S7969U3YUUk6o2CJKJRQKcfDAAezYsQP5T8ORdOAX5Me//up2GgaWMGw/ARbj/SBo2ge7DxxBq1atYGpmjtGjR+PUqVM0zFAFvHv3Dr/99hvc27aFiakpvL298Tg+ByZ9F8F0xGboNOoAjnrJN3dkYhHSb51A/P6fUdfaFJH376Nnz56KeQKEEJXxZWiWgCbHKBbPrAY0tPTkdt3Wl2n3eRZ15LL/yoBv6wgOh0tDCSsRDqtCc2qnp6dDT08PaWlp0NXVVXYc8h///PMPBg4ajKioZ9Bu1hf6LQZ89YP2F0wsQt7H58h5eQP5r24iN+kDBEJNuLv/gBZubmjevDkcHBxgYWFBZzuUJC8vD69evcKdO3dw48YNhF++gqePH4GrrgGBjSMEtZtDWLMZ1HWMSr3P/MR3SD3/O3I/RmHatGlYuXIlzThYQdH7r2x0XBRn+PDhOHL+Cky9f1N2lAot8eQq1NfNx+2b5X92q/UP7rgXlw+T3vPLfd+VScL+n9C9lTMCAg4pO0qlp4j3YCq2SIWSn5+PlStXYtmy5VDXM4VOm5EQ1mxW5gKpIDka2S9uIP/DYxTERqEgOwMAoKmtjVo1a8O6mhXMzc1gbGwMoVAIPp8PDQ0NKsS+k1gsRl5eHvLy8pCRkYH4+HjExsbh1Zu3iIl+B7FYDAAQmtqAa1oHwhouENZwKfOF0uK8LKRdO4zMu3+jZs2a2OO3Gy1atJDHUyLlhN5/ZaPjohiMMZhbWiHXujkM2o1SdpwKLePBeaQGb0FycjL09fXLbb+ZmZkwMDCETpuR0HXpVm77rYxSLvtDLSoUSYkJ4HJpEJo8KeI9mO7uSSoUHo+HhQsXok+fPpg6dRou/rUMmnZO0GszAjyzmqXej4aRNfSMrAH0A2MMhSkfUZAcjYJPMXid8hEvoxKAyBdguRkQF+aDFeZDLCqU3xOrMjjgqmuAq84DlycAhHqAUB/qpk7Qt+8CDaNq0DCxg5rg26ZhZ6ICZP4TgoyIA1ATF2DxooX45ZdfaLZBQkiJnj59ioS4WJi2dlJ2lApPaOeET/8//XivXr3Kbb807X7pCe0aIf76YTx48ADOznS8VB0VW6RCatCgAUJDQxAUFITpPj/h1Z5p0KrtCh23AeCXcaw3h8OBhqEVNGiqX5XFCvOR+U8Ism7/hfy0RAwb5o0VK36FpaWlsqMRQlRAaGgouOoa4Fs3UHaUCu/f04+XZ7FF0+6XHt+yHtR4AoSGhlKxVQnQuUlSYXE4HHTt2hXPnjzGvn37YI4UxO3zQeLheciKigAT08yDlV1hRjJSrx5E3B9jkHphB3p38sSjR4+wZ48fFVqEkFI7HxwMgVV9cDXoLHhpyGP6cZp2v/Q46hrgV2uA8+dpCvjKgIotUuGpq6tj6NChiHr6BIcPH4ajhRaSAn0Rv3MUUi/7Iz/pvbIjknLECguQ/fw6kgJ98XH7SOTfD8SIQX3x9OlTHDx4APXr11d2REKICikoKEB4eDh4NAthqZX39OM07X7Z8W2dcOXqVeTm5io7CvlOKlNs+fr6omnTptDR0YGpqSl69uyJqKgoZcciCqSmpob+/fvj+rUIREZGYvjAPhA9OovYXRORsGcqUq8FIC/2ORgTKzsqKSNxbiayoiKQdGYjYrcOReKJX2HHy8BvmzYiLjYW27dvR506NFUwka/Lly+jW7dusLS0BIfDQWBg4Fe3CQ8PR+PGjcHn81GrVi3s2bNH7jlJ2dy8eRPZWVkQ0L2dSq28px+naffLTmDnhPy8XERERCg7CvlOKlNsXbp0CZMmTcKNGzcQEhKCgoICdOjQAVlZWcqORpSgUaNG2L59O5ISExAYGIhu7k1ReP8k4vb5IG7rUCSeXIX0WyeQ++HJV2+UTBSvMCMJ2VHXkBLuh8SDM/Hh9x+RFOgLi7xozP55Bp48eYJH/zzA5MmTaYY2ojBZWVlo1KgRtmzZUqr+b968QZcuXdC2bVtERkZi+vTpGD16NM6fPy/npKQsQkJCoKGpU6ZJlqo6NYE2BJa1ERxcPvfbCgkJgdC8BtS09Mtlf1WBhokdeDqGcrvnGVGcMk/97u3tjVGjRuGHH36QV6ZSSUxMhKmpKS5dulTqLDTFbuVWUFCAGzdu4Pz587hwMQz37t1Dfl4uOBwuBEYW4OhbQd3ACmo6RlDT0gdXUx9cviY46jxw1DQArhqNJf9OjDGgsABM9HmGR1FOOkRZqRBnpaIwLR7ilA8o/BSD/Kw0AIC5pRVaurmhQ4f28PLygq2trZKfAZEXeb7/tmvXDu7u7li0aJHU+pSUFPTp0wcXL14s8z45HA5OnDhR4g2yZ82ahaCgIDx69EiybuDAgUhNTcW5c+dK9Tj0d0n+mru1wMMULkx6zlF2FJVSXtOPS6bdt3GDQduR5Ziw8ks6tRa1+OmIvHdX2VEqrQo59XtaWho8PT1ha2uLESNGwNvbG1ZWip9ZJi3t84c1Q0PDYvt8ud/PF+np6XLPRZRHQ0MDrVu3RuvWrbEcn4uvR48e4e7du3j27BmePHmCx08fIOFRHHJzspUdt8rgcDjQMzBEDRsbNPzBGfb2g9CgQQO4urrSJBekXISHh+Phw4e4f/8+Dhw4AC0tLQCf79t36dIluT3u9evX4enpKbXOy8sL06dPL3Yb+rukWGlpabh9+xb0PccrO4rKKa/px/837T4NISwrgZ0T/jm7CcnJyTAyMlJ2HPKNylxsBQYGIjExEf7+/ti7dy8WLVoET09PjBo1Cj169ICGhoY8ckoRi8WYPn06WrZsCQcHh2L7+fr6YsmSJXLPQyomDQ0NODs7S/5IMMYQFxeHjx8/4u3bt3j16hU+ffqE7OxsZGdnIz8/X8mJVR+Xy4VAIICmpia0tLRgZWWF2rVrw9LSEjY2NpIPwYSUt9DQUIwbNw7NmzfHqVOnYGdnJ/fHjIuLg5mZmdQ6MzMzpKenIycnB0KhsMg29HdJsS5dugSxSAQBTcxQZuU1/ThNu//tBLZOYIzh4sWL6Nevn7LjkG/0TffZMjExgY+PD3x8fHDv3j34+flh6NCh0NbWxpAhQzBx4kTUrl27vLNKTJo0CY8ePcLVq1dL7Ddnzhz4+PhIfk5PT4e1tbXccpGKIzc3F/fv38etW7dw9+5dPHz8BM+jniH7P9f4qWnwwVXXAEddAxyuGjigYYTfgzExmKgQ4sICiArzwETS0/NbWFZD/fr2cGzYEM2aNYOrqyvs7Oxo+Cb5bhYWFrh06RJGjBiBpk2b4ujRo6hXr56yYxVBf5cUKyQkBAJDC2jomys7isr59/Tjv/zyyzfvh6bd/3bqusYQmtggODiYii0V9l03NY6NjUVISAhCQkKgpqaGzp074+HDh6hfvz5Wr16NGTNmlFdOicmTJ+P06dO4fPkyqlWrVmJfPp8PPp9f7hlIxSMWi3H//n2cO3cOZ86ew61bN1FYUACuOg8Cs+rgGFqD17QftAyrQU3HGGqa+lDT0vt8rRaRC8YYWH42RFmpEGWloDAtHlnJ0bj+7gMi7gVgw4YNAAAjE1N07NAeHTt2RIcOHWBqaqrk5ETVfCnW+Xw+Dh48iOXLl6Njx46YNWuWXB/X3Nwc8fHxUuvi4+Ohq6sr86zWl4z0d0lxPt/biYavfavP048fQG5uLgSCshdLkmn3XfrIIV3VoG7TCOeCQ8AYoy8mVVSZi62CggL8/fff8PPzQ3BwMBwdHTF9+nQMHjxYcmHZiRMnMHLkyHItthhjmDJlCk6cOIHw8HBUr1693PZNVBNjDHfv3sWhQ4dw4FAA4mM/Ql2gCb5NI+i4jwTf0h48UzsqqJSEw+GAw9cCl68FDUMrwFp6yK8oOw15sc+R9+Exjl+8iQMHDoDD4aBlq9YY8uNg9O3bl8aok1L57zxP8+fPR7169eDt7S3Xx3Vzc8OZM2ek1oWEhMDNzU2uj0tKJzo6Gq9ePIdxj97KjqKyBNWdkRK2CxEREfDw8Cjz9l+m3delYZzfTGDnhA93T+H169eoWZNm1FRFZS62LCwsIBaLMWjQINy6dQtOTk5F+rRt2xb6+vrlEO9/Jk2ahIMHD+LkyZPQ0dFBXFwcAEBPT6/YbxBJ5ZSWlgZ/f3/8tnkLXkQ9A0/bAPw6LWHWZgr4VvXAUfuuE7ZEQdQ09aBZsyk0azYFAIiyUpDz6g7uRV1BxISJmDR5Mnr17InJkyfjhx9+oG/0SLHevHkDExMTqXV9+vSBvb097ty5U+r9ZGZm4uXLl1L7jYyMhKGhIWxsbDBnzhzExMRg3759AIDx48dj8+bNmDlzJkaOHImLFy/iyJEjCAoKKp8nRr5LaGgowOFAYOuo7CgqS8PYVjL9+LcUW/+bdr+GHNJVDQLrhuBw1RASEkLFlooq89Tv/v7+6Nev3zedTv4exX3Q8vPzw/Dhw0u1D5piV7W9f/8eq1evxm4/P+Tm5kGzTnNoNewAgZ0TOFw1Zccj5UiUlYKsJ5eR88855CZFo659PcyeNRM//vijQibhIeVPFd5/w8PD0bZt2yLrvb29sWfPHgwfPhxv375FeHi41DYzZny+N1y1atWwYMGCUv9NAlTjuKiqwYN/xMlLd2AydL2yo6i075l+nKbdLx+JB2eiY1N7/PXXX8qOUuko4j24zMWWKqM/aqrpzZs3+PXXX7F37z5w+JrQdOoM7UZeUNcxVnY0ImeMMeS+/wdZ904h6/kNWNvYYv68uRgxYgQVXSqG3n9lo+MiH2KxGCZm5iis5Q4D9+HKjqPSMh+G4tPZTUhMTCzT0O60tDQYGhlB33M8dJw6yTFh5Zd69QDYo7P4lJwENTX6crk8Vcj7bBGiKGlpafj111+xceMmcPha0G41FDrOncDllc+w0S833WWFBWCiAkAs+vpG5Ks4av8/u6OGAFyhDjicb78ZJofDgdC2EYS2jaCb8AafbhzBuPHjsXrtOmxcvw5dunSh4YWEkCIePXqET0mJMPWka4W+l8Du26Yfp2n3y4/AzhnxEYdw7949NG3aVNlxSBlRsUUqHMYY9uzZg59/mYm0jAxoN+sD3WZ9wOWVfegqE4tQkByNvI/PUZD8HqKUj2DpcSjM+ISCnEw5pCf/xuGqgaetDzUdY3D0LaFuaAWeaQ3wLetCTVOvTPvimVaHcfdZ0G3eD7Fhu9CtWze0a+eB7du3yfVWE4QQ1RMSEgI1Hh8Cq4o3/b+qUdf5tunHadr98sO3qAN1gSZCQkKo2FJBVGyRCuXNmzcYPXoMLl68AO0GbWA+YHiZhwuKMlOQ/fImcl/eRH7MYxTmZoPL5aKajR0a1KuLOnXcYGVlBTMzMxgbG0MoFILP50NdXZ3OknwnsViM/Px85OXlISMjA/Hx8YiLi8O7d+/w9FkUnj0MQmJqCgBAYGQJDVtnCGu7QWDtUOqJTXimNWDcfzlyXt1CxMU/4dDQEcuXLcWMGTOgrk5vaYSQz/d24ldrAI46T9lRKoVvmX787Dmadr+8cNTUwavmgHPngzF37lxlxyFlRJ9MSIXAGIOfnx8mTZ4CxteGab8lENZwKfX2BZ9ikP3iOvJf3kR2zDNw/38K8U6j5sPNzQ1NmjSBtra2HJ8BKQ3GGN69e4cbN27g6tWrOHHyb3y8FwQNoTZ4NZpAWKs5hDVcvjpUlMPhQLOWKwQ2jZB6dT9mzZqNw0eO4uiRw3RbCEKquLy8PFy+fAXC5oOUHaXSKOv049HR0Xj1kqbdL098O2fcuOSHrKwsaGlpKTsOKQMqtojSZWZmYvz4CThwYD+0HTvAoN1ocPmaX92OMYbct/eRefsEst/cB18gRKeOXuj162x06dKF7tFUAXE4HNjZ2cHOzg4DBw7E77//jsjISJw8eRLHjp/A45MroSHUhtCxI3Rcun71rCaXJ4Bhu9HQqtsKj4LWwdHJCXv9/NC7N/2BJ6SqunbtGvJyc2Bo56TsKJVGWacfp2n3y5/Q1gkpBfm4cuUKOnbsqOw4pAy+/cp1QsrBy5cv4dKkKQKO/QWjrj/BqNPUrxZaTFSAzEcXkLh3KhKOLERtPeDAgQP4lJyEEydOYNiwYVRoqQgOhwNnZ2csXrwYj/55gFevXmH65AkQPTmP2B2jkRy0HvkJb766H76VPUyHbQCzaIg+ffrgl19+gUhEE54QUhWFhoaCp60PDVM7ZUepNLh8TQit6iIkJKRU/UNCQqFpURtqQpphs7yoG1UDX8/4cyFLVAoVW0RpwsPD0aRpM7xPyoDZ0PXQblD0/jb/xhhD5sMLiNs5BslBG9DGpR4uXryI+/fuYvDgwdDU/PrZMFKx1ahRA6tXr8bHDx+wZvUq6KY8R6zfFCT9tQQFn2JK3JYr0IZRj9kwaDca69atR/cePZCRkaGg5ISQiuLs+WBo2DT6rplQSVEaNk4IvXDxq19kicVinA8JgboNXa9VnjgcDtStnXD2XLCyo5AyonciohT79++HZ/v2KNC3hfGQddAwsi6xf37iWyQdmo3kMxvQs6MHHj9+jDNBQWjbti1NalEJ6erqwsfHB2/fvMaBAwdgmJ+AOL/JSL2yH+KCvGK343A40G3aEyZ9FiL4QhjcWrREbGysApMTQpTp06dPiLx3FwJb+qBf3gR2TkhPS8XduyXf3Pjhw4f4lJQIAQ3jLHcCu0Z48vgh4uPjlR2FlAEVW0Thtm3bhqFDh0JYrw2M+y6GmqD4iSvEedn4dOEPxO2ZBithIS5cuIDDhwNQv359BSYmyqKhoYHBgwfj2dMnmDt7FrJvH0fCnsnIfnmrxO2ENZvAZPAavIyORYtWrfHu3TsFJSaEKFNYWBgYY/RBXw6+TD/+tWFsoaGhNO2+nAj//3V94cIF5QYhZULFFlGotWvXYuLEidBx6Q7DTlNLnO47590DxO+eiILHIVjx63I8evgP2rVrp8C0pKLQ1NTEsmXL8OjRQ7Rq3ACJfy1F8smVEOcWf680noktjAauRGxqNtxatMTLly8VmJgQogzBwcEQGFeDuq6psqNUOv+efrwkNO2+/KhpGUBoVr3U186RioGKLaIw27Ztwy+//AJdt/4w8BhT7Hh6JhYh9coBJByejxaNG+LZ0yeYPXs2eDx6467q6tSpg5DgYBw6dAj4+A8S9k1H3seoYvtr6JvDeOBKpORz0badBz58+KDAtIQQRTsfHAoNulZIbvh2zrhx/TqysrJktn+Zdp9n46TYYFXIv+95RlQDFVtEIQ4cOIBJkyZBp0kP6LceWux1VuKCXCSf9EX6jcNYtnQpQkNDYGtrq+C0pCLjcDgYOHAg/omMhENNayQcmo2sZ1eL7a+uYwSjfsuQmJmHdh6eSExMVGBaQoiivHnzBu/evobAzlnZUSotoZ0TCv5/+nFZvky7L6zupNhgVYjQzhlxH2MQFVX8F42kYqH7bBG5Cw8Ph/fw4dBy8IBBu1HFFlqinHQkH18GlvwOp0+dQufOnRWclKiS6tWr41rEVQwfPgKHAlZBlPkJuk26y+yrrmsMo75L8S5gNrp07YYrly+Bz+crODEhRJ6+TBqQeHw5NIR0E3t5+HI25eHDhzLv9ZSeng4ASDw0m2aDlBMmFgP4/Duwt7dXchpSGlRsEbl6/fo1evXuA341Bxh2nFLsm29hWjySjy2GJsvBuUvhaNq0qYKTElXE4/Gwf78/qlWzwpo1ayDKSIJ+m+EyX2cahlYw7Dkfdw/Nwdix47Bnjx/NZElIJdK8eXMcPnwY0dHRyo5SqXE4HIwbN05mW48ePfDHH38gLS1NwamqFoFAgN69eys7BiklKraI3GRlZaFrt+7I5Qph3H0WOFw1mf3yE14j+dhiWBjrIzT4ImrVqqXgpESVcblcrF69GlZWVpgxYwbEmZ9g2Hm6zMlX+JZ1YdhpKvbtWwsnp0aYMWOGEhITQuSlf//+yo5Q5Y0ePVrZEQipUOgcL5GbKVOm4PnLVzDsOR9qQh2ZfQqSo5F0ZAHq1bTFrRvXqdAi32zatGkICAhA7vMIfDq7EYyJZfbTqt8Gus1645eZM3HrVslTyBNCCCGEfA8qtohcHDx4EH5+ftD3nAANY9k3LC5MS0Dy0YWoaWOFC6EhMDWlqXrJ9+nfvz8OHNiPrKeXkRK6o9jZmvR/GAaeWS307T+AhrsQQgghRG6o2CLlLjo6GmPHjYN2g7bQcpB9XyxxXjaSjy+Fmb4WLoSGwMjISMEpSWXVv39/7NyxAxn3gpBxO1BmH46aOgy6/ozYhCRMnjxFsQEJIYQQUmVQsUXKFWMM4ydMQAFXAIP242VOQMCYGJ+C1kMtOwlnzwTB0tJSCUlJZTZ69GjMnj0bqeF+yHl1W2YfDX1z6LUdjf37/XH+/HkFJySEEEJIVUDFFilXR48exZmgIOh5jAOXryWzT/r1o8h+eRNHDh9G/fr1FZyQVBW//vorOnfpjJSgdSjMSJLZR8vBA5p2ThgzdlyxN+kkhBBCCPlWVGyRcpOVlYUpU6dBq44bNOu4yeyT++Ep0iIOYt68eXQfLSJXXC4X+/buhaGeDlLO/S7z+i0OhwP9DpPwMTYOvr6+SkhJCCGEkMqMii1SbtasWYOk5GTotR0ls12cl43UM+vQrFkzLFq0SMHpSFVkaGiIPX67kf36LjIjz8rso2FgAa0mPbBm7Tq6Pw8hhBBCypXKFVtbtmyBnZ0dBAIBXF1daermCuLjx49YtXoNtBt3g4a+ucw+qVf8wclNx6GDB6CuTrd4I4rRsWNHjB07Fmnhu1GQ8lFmHz3XvoCGEHPnzlNwOkIIIYRUZipVbB0+fBg+Pj5YtGgR7t27h0aNGsHLywsJCQnKjlblrVy5EiKOGvTcZN9QMi/mKTLuncaKX5ejevXqCk5Hqrp169ahmqUFUs/Ivv8Wl68J7RaDcODAfjx79kwJCQkhhBBSGalUsbV+/XqMGTMGI0aMQP369bF9+3Zoampi9+7dyo5WpcXHx2PHzj+g6dwNXIF2kXbGxEi7+AecnJwxdepUJSQkVZ22tjb27d2D7A9PkPUoTHafhu3B0zWCr+9KBacjFU1ZR1Bs3LgRdevWhVAohLW1NWbMmIHc3FwFpSWEEFKRqUyxlZ+fj7t378LT01OyjsvlwtPTE9evX5e5TV5eHtLT06UWUv42bNgAMYcLHZduMtuznlxCzsfn+G3TRqipqSk4HSGf/fDDD+jTty8yI/whLij6QZijrgFNl17Yf2A/3r59q/iApEIo6wiKgwcPYvbs2Vi0aBGePn2KXbt24fDhw5g7d66CkxNCCKmIVKbYSkpKgkgkgpmZmdR6MzMzxMXFydzG19cXenp6ksXa2loRUauU7OxsbN22HZqOHaEm1CnSzkSFyIzYjx49e6J169ZKSEjI/6xetQri7HRk3D0ls127kRfU+JrYsmWLgpORiqKsIyiuXbuGli1bYvDgwbCzs0OHDh0waNAgup6YEEIIABUqtr7FnDlzkJaWJlloprHyd+TIEWSkp0HbqZPM9qzHYchLicfyZcsUnIyQomrUqIERI4Yj++5JmWe3uDwBBPXb4c9du2kYWBX0LSMoWrRogbt370qKq9evX+PMmTN0awtCCCEAVKjYMjY2hpqaGuLj46XWx8fHw9xc9ux3fD4furq6UgspX5u3bIVmDRdoGFgUaWNiEbJu/4Vu3bvDwcFBCekIKWr27NkozMlA5oPzMtt1nDohNeUTjh07puBkRNm+ZQTF4MGDsXTpUrRq1QoaGhqoWbMm2rRpU+wwQhreTgghVYvKFFs8Hg8uLi64cOGCZJ1YLMaFCxfg5ib7BrpEvp4+fYq7d25D07GDzPac13eRm/QBc+fMUXAyQopXvXp1DBwwEDn3T8ucmVDDqBo0bRvCz2+P4sMRlRMeHo4VK1Zg69atuHfvHo4fP46goCAsK+ZsPg1vJ4SQqkVlii0A8PHxwR9//IG9e/fi6dOnmDBhArKysjBixAhlR6uSDh8+DHWBJjRrNpXZnhV5Fo2cnOHq6qrgZISUbNKkicj9FIvcN/dltgvs3REeHlbkTDqp3L5lBMWCBQswdOhQjB49Gg0bNkSvXr2wYsUK+Pr6QiwuWszT8HZCCKlaVKrYGjBgANauXYuFCxfCyckJkZGROHfuXJEhH0T+GGM4cCgA/FrNwVHnFWkvTE9A9us7mDxpIjgcjhISElI8Nzc3NGjoiKwH52S2a9ZxA+Nw8Ndffyk4GVGmbxlBkZ2dDS5X+k/pl1lXGWNF+tPwdkIIqVpUqtgCgMmTJ+Pdu3fIy8vDzZs36ayJkjx//hwvn0dBs24rme1ZT6+Ax+NjwIABCk5GyNdxOByMGjEcOa/vQJybWaRdTVMPQttG+Ov4cSWkI8r0tREUw4YNw5x/DY3u1q0btm3bhoCAALx58wYhISFYsGABunXrRre6IIQQAnVlByCqKTg4GFw1dQhsHGW25z2/ii6dO0FHp+h08IRUBP369YOPjw+yX9yEdkOPIu18u8a4csUfOTk5EAqFSkhIlGHAgAFITEzEwoULERcXBycnJ6kRFO/fv5c6kzV//nxwOBzMnz8fMTExMDExQbdu3fDrr78q6ykQQgipQDhM1jiHSio9PR16enpIS0ujoRvfqUvXrgh//AEmA4p+oChMT0DMtpEICAigM1ukQnNr0RIPk0Qw7r2gSFt+4jvE7p6E8+fPo0MH2ZPAkNKj91/Z6LgQQojyKOI9WOWGERLly8/PR3h4OHg2jWS257yJBJfLpQ+opMLr2qUz8qIfgokKi7RpGNuAr2eM4OBgJSQjhBBCSGVAxRYpsxs3biA7KwuC6o1ltue9uw/nxi4wMDBQcDJCyqZ9+/YozM1GXuzzIm0cDgfq1o1w9jwVW4QQQgj5NlRskTILCQkBT0sPPLMaRdoYEyP//T/o6EVntUjF5+LiAl09feS+LWYKeDsnPHn0kKaAJ4QQQsg3oWKLlNlfJwKhYesEDqfoyyc//jUKstJoCCFRCWpqamjv6YmCd5Ey24XVG4PD4eLvv/9WbDBCCCGEVApUbJEyefr0KZ4+fgRN+9Yy23Pf3IOmlhaaN2+u4GSEfBsvrw7IiYkqYQp4Rxw8FKCEZIQQQghRdVRskTI5dOgQ1AVaEFZ3kdme//o2PDw8wOMVvdExIRWRl5cXGBMj5/Udme2Cuq1w+VI4YmNjFZyMEEIIIaqOii1SaoWFhdj55y4I6rYGR12jaHtaArI/PMVAmu6dqBAbGxs0beaKnGdXZbZr2bcCR10Du3fvVnAyQgghhKg6KrZIqZ06dQrxsR+h49xZZnvWsyvg8QXo1q2bgpMR8n0GDxqInDd3ZQ4l5Aq0IbT/AVu374BIJFJCOkIIIYSoKiq2SKmtW78Bwmr2xcxCyJD3NAzdunaBjo6OEtIR8u369+8PiEXIenZFZru2cxd8/BCNEydOKDgZIYQQQlQZFVukVK5evYqIq1eg3bSPzPa8mCfIiX+LcePGKTgZId/P0tISnTp3Rs6Dc2CMFWnnm9eCpl0jLFv+q8x2QgghhBBZqNgipbJ02TIITO0grO0qsz3z/hnY1agJDw8PBScjpHxMmjgROXGvkP8xSma7dvP++OdBJIKCghScjBBCCCGqioot8lUXLlxASHAwtN0Gyry3VmFGEnKiIjB54gRwufSSIqrJy8sLNnbVkXFX9j21BDaO0LRxwMxZs+naLUIIIYSUCn0yJiUSiUSYPsMHmtXqQ7NuS5l90m+dgJaWFsaMGaPgdISUHy6Xi9kzf0H2s6so+BRTpJ3D4UC3zSg8ffKYZiYkhBBCSKlQsUVKtHnzZjx6+A9024wEh8Mp0i7KTkP2P+cwY/o06OrqKiEhIeVnxIgRMDE1RfrNYzLb+Ra1od2gLWbNnoOkpCQFpyOEEEKIqqFiixTr2bNnmDlrNnRcuoFvZS+zT9r1I+BrqGPq1KkKTkdI+RMIBJg9ayayHl1EQfIHmX30245EZm4+pk+foeB0hBBCCFE1VGwRmQoLC/HjkKHg6phA391bZp+CTzHIuh+EeXPnwsjISMEJCZGPCRMmwMrKCmmX9shsV9MygG6bUThwYD9Onz6t2HCEEEIIUSlUbBGZfH19cf/+feh3mg6uhkBmn7RLe2Fubo4ZM+gbflJ5CAQCrF2zGlkvbiDn3QOZfbQcPKBVqxmGeQ9HbGysghMSQgghRFVQsUWKuHPnDpYsXQpd177gW9aV2Sf71W1kPb+GtWtWQygUKjghIfLVv39/uDZ3Q/qF7WCFBUXaORwODDpNQ1Yh8OOPQ2h2QkIIIYTIRMUWkRIXF4fuPXqCZ1oDei0HyuwjzstGeug2tO/QAQMHyu5DiCrjcDjY9ecfKEyJQ9r1IzL7qGnqQb+zD8IvXcLMmTMVnJAQQgghqkAliq23b99i1KhRqF69OoRCIWrWrIlFixYhPz9f2dEqldzcXHTv0RPJmbkw7DkXHDUNmf1SL+8FJy8TO3fskDlDISGVQYMGDTBnzmxk3DyK/IQ3MvsIbRtBv91orF+/nqaDJ4QQQkgRKlFsPXv2DGKxGDt27MDjx4+xYcMGbN++HXPnzlV2tEqjoKAA/fr3x73ISBj2mAt1HWOZ/bJf3ETGvSCsWb0KdnZ2ig1JiILNmzcP9vb2SDm9BuL8XJl9dBp3hbZTR4wZOxanTp1ScEJCCCGEVGQcxhhTdohvsWbNGmzbtg2vX78u9Tbp6enQ09NDWloa3RPqX0QiEYYN80bA4cMw7r0AwhouMvsVpichYe9UdPRsg5OBgXRWi1QJT58+RWOXJlCv0wpGHWXf4oCJRUj+ezXy39zB2TNB8PDwUHDKio/ef2Wj40IIIcqjiPdglTizJUtaWhoMDQ1L7JOXl4f09HSphUjLyclBn759cejQIRh2+anYQosVFuDTqVUwNtDFHj8/KrRIlVGvXj1s3bIZmQ+CkfkwVGYfDlcNRl1/hkY1B3Tq3AXHjx9XcEpCCCGEVEQqWWy9fPkSv//+O8aNG1diP19fX+jp6UkWa2trBSVUDZ8+fUI7D0+cPnMWxr3nQatea5n9GGP4dH4zChNeI/D4X18tcgmpbIYPH47Ro0cjJXgLcj88ldmHo64B417zwavZDH379sWWLVsUnJIQQgghFY1Si63Zs2eDw+GUuDx79kxqm5iYGHTs2BH9+vXDmDFjStz/nDlzkJaWJlmio6Pl+XRUyvv37+HWoiXu/vMYJgNWQLOWa7F9028dR+ajC9jjtxvNmjVTYEpCKgYOh4MtW7bArXlzpJxcgcK0eNn91DVg1O0XaLt0x+TJkzF37lyo6EhtQgghhJQDpRZbP/30E54+fVriUqNGDUn/jx8/om3btmjRogV27tz51f3z+Xzo6upKLeTzfbSauTbHu8Q0mAxeXey9tAAg858QpIb7Ye7cuRg8eLACUxJSsfB4PJw4/hcsjPWRfHQhRJkpMvtxOFwYeoyBQdtR8PX1xdChw5Cdna3gtOR7bNmyBXZ2dhAIBHB1dcWtW7dK7J+amopJkybBwsICfD4fderUwZkzZxSUlhBCSEWmrswHNzExgYmJSan6xsTEoG3btnBxcYGfnx+4XJUcAalUjDFs3LgRM2fOgoZZDZgMmg81bYNi+2dFReDTud8xduxYLF++XIFJCamYTExMEHbxAtxatETysYUwGrACakIdmX11m/WCmo4RAo5uwt179/DXsaOoX7++ghOTsjp8+DB8fHywfft2uLq6YuPGjfDy8kJUVBRMTU2L9M/Pz0f79u1hamqKY8eOwcrKCu/evYO+vr7iwxNCCKlwVGI2wpiYGLRp0wa2trbYu3cv1NTUJG3m5ual3k9VnvXpxYsXmDBxIi6EhkKnaU8YuHsXex8tAMh6egWfgtaiX9++OHDggNQxJ6Sqe/LkCVq2ao08vgGM+i2FmqZesX3zE98h5dRqsIwELFm8CDNmzACPx1Ng2opBVd5/XV1d0bRpU2zevBkAIBaLYW1tjSlTpmD27NlF+m/fvh1r1qzBs2fPoKFR/HtqcVTluBBCSGVEsxH+v5CQELx8+RIXLlxAtWrVYGFhIVlIyXJycrBgwQI0aOCAq3cfwbTvYhi2G11ioZX5TzCST63BwAED4e/vT4UWIf9Rv359XL4UDi1RBpICZqMwPanYvjwTW5gMXQeeQwfMmTsPDR0bISwsTIFpSWnl5+fj7t278PT0lKzjcrnw9PTE9evXZW7z999/w83NDZMmTYKZmRkcHBywYsUKiEQimf1pllxCCKlaVKLYGj58OBhjMhdSvNOnT6NuvfpYsXIVNJv0gumIzRDWbFJsf8YY0q4fQfLZ3zB27Bj4++/7pm9qCakKGjZsiGsRV2HEB5ICZiE/8W2xfbkaAhh6jIG59wZ8yOaiXbt2GDz4R8TGxiouMPmqpKQkiEQimJmZSa03MzNDXFyczG1ev36NY8eOQSQS4cyZM1iwYAHWrVtX7NBrmiWXEEKqFpUYRlheqsJwDbFYjKCgIKxavQYRV69As0Zj6HuMg4ahVYnbscJ8fDr3GzIfh2PRokVYtGgR3UuLkFKIjo5G5y5d8ez5Cxh0/QWatUqesZMxMbIeXUTG5T1QE+dj7JgxmD59Ouzs7BQTWElU4f3348ePsLKywrVr1+Dm5iZZP3PmTFy6dAk3b94ssk2dOnWQm5uLN2/eSEYBrF+/HmvWrJFZTOfl5SEvL0/yc1paGmxsbBAdHV1hjwshhFRW6enpsLa2RmpqKvT0ir8k4HsodYIMUn5yc3Ph7++PVWvW4tWL59C0rg+T3gsgrNXsq0VTYVoCPp1aDVHSWxw6dAgDBw5UUGpCVJ+1tTWuX4vA4B9/xKnjy6Dfagh03fqBw5E9cIDD4UK7oSeEtZsj/dYJbP3DD7///jv69u2LX375BU2aFH/2mciXsbEx1NTUEB8vPbV/fHx8sdcHW1hYQENDQ2q4db169RAXF4f8/Pwi1+fx+Xzw+XzJz0lJn4eg0hkuQghRnuTkZCq2SFEikQg3btxAYGAgdvvtwadPydCq4wazH8dAUK1eqfaR/eIGUs9tgpmRAY5fuYymTZvKOTUhlY+2tjYCT5zA4sWLsXz5cuR/eATDLj9BTUu/2G3UBNow+GEo9Jr3Q9ajC/g79CSOHDmCFi1bYciPg9G9e3dYWZV8RpqULx6PBxcXF1y4cAE9e/YE8Hm0wIULFzB58mSZ27Rs2RIHDx6EWCyWzJL7/PlzWFhYlGoilC83iX///r3c/tCXpy/fAqvKmTjKK3+qlpnyypeq5f0yuuDLe7E80DBCFZObm4vQ0FCcPHkSxwNP4lNSInjaBuDXaQmdJt2hYWBZqv2I87KReskPGffPonuPHtjj5wcDg+KngSeElE5oaCgGDhqMjLxC6HlOgGadFqXajolFyHlxE1kPziDn3UMwsQguTZqiT+9e6NGjB+rVq6fSQ3tV5f338OHD8Pb2xo4dO9CsWTNs3LgRR44cwbNnz2BmZoZhw4bBysoKvr6+AD4PI23QoAG8vb0xZcoUvHjxAiNHjsTUqVMxb968rz6eqhyXLyivfKlaXkD1MlNe+aK8RdGZrQosPT0dz58/R1RUFO7fv4+rEddw/9495OfnQWBkBV6tH2Dm1Rx8yzrgcEs/Y2D2q9tID9kKtcJsbNmyBRMmTFDpD3GEVCSenp54+M8DjBk7FkEnVkDbvhX0PcdBTavkLzM4XDVo1m0BzbotIMrNRM6r23j28gYWLlmGuXPnwtTcAi3d3NC8uSscHBxQp04d2NnZQV2d3sbL04ABA5CYmIiFCxciLi4OTk5OOHfunGTSjPfv30vd59Ha2hrnz5/HjBkz4OjoCCsrK0ybNg2zZs1S1lMghBBSgVT5M1u3b9/Ghg0blJqLMYa8vDzk5OQiIzMTsXFxSIiPR2bG/6YEFhiYgWteB3wLewirN4a6UbUyF0gFyR+QdskPWS9uooOXF3bu2AFbW9vyfjqEEHz+//rIkSOYOGky0rNyoN28P3RduoOjXrYZPllhPnLfPUDuh8cojH2O/LgXKMzLAQBw1dRgZGwCMzNzmJoYQUtTE3w+H+rq6kr9AsXc3BwrV66UGkanat92KoqqHRfKK1+qlhdQvcyUV74ob1FV/ivRFStW4NT5C+Cb1VBqDsbVANQ1wFXng2vQAOrVWsJYxxjqBlbQMLQCl6/5zfsuzPyE9BtHkRV5BpaWVth9+DD69etHZ7MIkSMOh4MBAwbA09MTixcvxtZt25Dz4Bx0Wg2Bpn2rUp+N5qjzIKzZFMKan6+nZEwMUUYSCj59RGHKR+RnpeBtVipef8gAE2WAIyoEmOx7PCkCK8xHzoen6NKlCzw8PJSWQ1Xw+XwsWrRIatKMiozyypeq5QVULzPllS/KW1SVP7PVq1cvnH/4AaZ9Fys3nBwUpich/eYxZP0TDKGQj/lz52L69OkQCATKjkZIlfPkyRP8/MsvOHvmDATG1tBy7Qut+m3KNARYFRSkxuHjjtEIDQ2VKrZU7dtOQgghpDxU+TNblQ1jDHnvHyIz8gxyXlyHjo4uFi+cjylTpkBfX1/Z8QipsurXr48zQUG4desWli5bhqDTG5B51R+Chl7QbuQFdW35zYRECCGEEOWgYquSKEiJRdbTS8h7egm5SdGoXacupmzYgOHDh0NHR0fZ8Qgh/69Zs2Y4feoU/vnnH2zevBn++w8g43rA56GC9u4Q1moKrgadfSaEEEIqAyq2VBQTi5D38Tly39xD/tu7yPn4HEJNLfTu2ROjR49CmzZt6JosQiowR0dH7Ny5E6tXr8a+ffuwd58/7v29Cup8TfCrNwbfrvHnyXB0jZUdlRBCCCHfiIotFcAYgygjCfmJb5H/MQoFcc9REPscBTmZ0NXTR5f27dGv3zJ07doVmprfPpEGIUTx9PX1MXXqVEydOhUvX75EQEAATv59CnfP/45PjEFoXA1cs9rgW9YFz7w2NIysv2vCHEIIIYQoDvfrXSq/nFd3kPXsqvKWp1eQ+egiMh6cR/rdU0i9ehDJwVuReGIFEv1n4OOm/ojZNgKJx5aA+ywEbezNsWDOTFy/fh2fkpNw9OgR9O/fnwotQlRcrVq1MH/+fNy+dRNJSUkICAjAiP7dUZufjrSwPxHn/xOiN/ZH3PYRSDw8D0mn1yHl4i6k3fwLGffPIPOfEGQ9CUfW0ytKez/LeXVb2YdRqS5fvoxu3brB0tISHA4HgYGBX90mPDwcjRs3Bp/PR61atbBnz54ifbZs2QI7OzsIBAK4urri1q1bSsl7/PhxtG/fHiYmJtDV1YWbmxvOnz8v1Wfx4sXgcDhSi729vVLyhoeHF8nC4XAQFxcn1a+iHN/hw4fLzNugQQNJH3kdX19fXzRt2hQ6OjowNTVFz549ERUV9dXtjh49Cnt7ewgEAjRs2BBnzpyRameMYeHChbCwsIBQKISnpydevHihlLx//PEHWrduDQMDAxgYGMDT07PI71rW76Bjx45Kybtnz54iWf47yVlFOr5fRlX9d+nSpYukj7yO77Zt2+Do6AhdXV3Je9PZs2dL3EZhr11WhaSlpTEALC0tTbIuLCyMAagwi4YGjxmbmrH6Dg2ZZ/v2bNSoUWzt2rXs9OnT7PXr10wsFivxCBJClCUnJ4fdvn2b+fv7s3nz5rF+/foxtxYtmV2NmkxLW4dx1dSU/v71ZdHV02evXr2Syi/r/bcyOnPmDJs3bx47fvw4A8BOnDhRYv/Xr18zTU1N5uPjw548ecJ+//13pqamxs6dOyfpExAQwHg8Htu9ezd7/PgxGzNmDNPX12fx8fEKzztt2jS2atUqduvWLfb8+XM2Z84cpqGhwe7duyfps2jRItagQQMWGxsrWRITE78767fk/fI3PioqSiqPSCSS9KlIxzc1NVUqZ3R0NDM0NGSLFi2S9JHX8fXy8mJ+fn7s0aNHLDIyknXu3JnZ2NiwzMzMYreJiIhgampqbPXq1ezJkyds/vz5TENDgz18+FDSZ+XKlUxPT48FBgayBw8esO7du7Pq1auznJwchecdPHgw27JlC7t//z57+vQpGz58ONPT02MfPnyQ9PH29mYdO3aUOr6fPn36rqzfmtfPz4/p6upKZYmLi5PqU5GOb3JyslTWR48eMTU1Nebn5yfpI6/j+/fff7OgoCD2/PlzFhUVxebOncs0NDTYo0ePZPZX5Gu3yhdbjH1+c1P2kpOTI/XmTwghZVVQUMAyMzOV/n6WnZ1dJFtVKbb+rTQfrmfOnMkaNGggtW7AgAHMy8tL8nOzZs3YpEmTJD+LRCJmaWnJfH19FZ5Xlvr167MlS5ZIfl60aBFr1KhR+QUrRlmKrZSUlGL7VOTje+LECcbhcNjbt28l6xR1fBMSEhgAdunSpWL79O/fn3Xp0kVqnaurKxs3bhxjjDGxWMzMzc3ZmjVrJO2pqamMz+ezQ4cOKTzvfxUWFjIdHR22d+9eyTpvb2/Wo0ePcs0mS2ny+vn5MT09vWLbK/rx3bBhA9PR0ZEq0BR1fBljzMDAgP35558y2xT52qVrtgDo6ekpOwIhhHw3dXV1qKvT27oquX79Ojw9PaXWeXl5Yfr06QCA/Px83L17F3PmzJG0c7lceHp64vr164qMKpNYLEZGRgYMDaVvXfDixQtYWlpCIBDAzc0Nvr6+sLGxUVJKwMnJCXl5eXBwcMDixYvRsmVLABX/+O7atQuenp6wtbWVWq+I45uWlgYARX63/3b9+nX4+PhIrfPy8pIMl3zz5g3i4uKkXuN6enpwdXXF9evXMXDgQIXm/a/s7GwUFBQU2SY8PBympqYwMDBAu3btsHz5chgZGZVb1rLkzczMhK2tLcRiMRo3bowVK1ZIhpVW9OO7a9cuDBw4EFpaWlLr5X18RSIRjh49iqysLLi5ucnso8jXLl2zRQghhChJXFwczMzMpNaZmZkhPT0dOTk5SEpKgkgkktnnv9cdKcPatWuRmZmJ/v37S9a5urpiz549OHfuHLZt24Y3b96gdevWyMjIUHg+CwsLbN++HX/99Rf++usvWFtbo02bNrh37x4AVOjj+/HjR5w9exajR4+WWq+I4ysWizF9+nS0bNkSDg4OxfYr7vX75dh9+Vfex7e0ef9r1qxZsLS0lPpA3bFjR+zbtw8XLlzAqlWrcOnSJXTq1AkikUjheevWrYvdu3fj5MmT2L9/P8RiMVq0aIEPHz4AqNjH99atW3j06FGR1688j+/Dhw+hra0NPp+P8ePH48SJE6hfv77Mvop87dJXoIQQQggps4MHD2LJkiU4efIkTE1NJes7deok+W9HR0e4urrC1tYWR44cwahRoxSasW7duqhbt67k5xYtWuDVq1fYsGED/P39FZqlrPbu3Qt9fX307NlTar0iju+kSZPw6NEjXL16tVz2J2/fknflypUICAhAeHi41KQT/z5j0bBhQzg6OqJmzZoIDw+Hh4eHQvO6ublJnZlp0aIF6tWrhx07dmDZsmXlkqU0vuX47tq1Cw0bNkSzZs2k1svz+NatWxeRkZFIS0vDsWPH4O3tjUuXLhVbcClKlSq2GGMAgPT0dCUnIYSQquXL++6X92Hymbm5OeLj46XWxcfHQ1dXF0KhEGpqalBTU5PZx9zcXJFRpQQEBGD06NE4evRokWGQ/6Wvr486derg5cuXCkpXsmbNmkk+NBobG1fI48sYw+7duzF06FDweLwS+5b38Z08eTJOnz6Ny5cvo1q1aiX2Le71++XYffk3Pj4eFhYWUn2cnJwUnveLtWvXYuXKlQgNDYWjo2OJfWvUqAFjY2O8fPmyXIqtb8n7hYaGBpydnSW/64p6fLOyshAQEIClS5d+tW95Hl8ej4datWoBAFxcXHD79m1s2rQJO3bsKNJXoa/dMl3hpeKio6OVPksXLbTQQktVXqKjo5X9p0BhgNJNkOHg4CC1btCgQUUmyJg8ebLkZ5FIxKysrJQ2gcPBgweZQCBggYGBpdpvRkYGMzAwYJs2bfrOhNJKm/e/PD09Wa9evSQ/V7Tjy9j/Jvb498xoxSmv4ysWi9mkSZOYpaUle/78eam26d+/P+vatavUOjc3tyKTDKxdu1bSnpaWVi4TOHxLXsYYW7VqFdPV1WXXr18vVf/o6GjG4XDYyZMnvzUqY+zb8/5bYWEhq1u3LpsxY4ZknxXt+DL2eWIPPp/PkpKSvtq3vI6vLG3btmXe3t4y2xT52q1SZ7YsLS0RHR0NHR0dcDicUm2Tnp4Oa2trREdHQ1dXV84JKyc6huWDjuP3o2P4/b71GDLGkJGRAUtLSzmmU77MzEypMwxv3rxBZGQkDA0NYWNjgzlz5iAmJgb79u0DAIwfPx6bN2/GzJkzMXLkSFy8eBFHjhxBUFCQZB8+Pj7w9vZGkyZN0KxZM2zcuBFZWVkYMWKEwvMePHgQ3t7e2LRpE1xdXSXXLgiFQslkUz///DO6desGW1tbfPz4EYsWLYKamhoGDRqk8LwbN25E9erV0aBBA+Tm5uLPP//ExYsXERwcLNlHRTq+X+zatQuurq4yr4+R1/GdNGkSDh48iJMnT0JHR0fyu9XT04NQKAQADBs2DFZWVvD19QUATJs2De7u7li3bh26dOmCgIAA3LlzBzt37gQAcDgcTJ8+HcuXL0ft2rVRvXp1LFiwAJaWlkWGRyoi76pVq7Bw4UIcPHgQdnZ2km20tbWhra2NzMxMLFmyBH369IG5uTlevXqFmTNnolatWvDy8lJ43qVLl6J58+aoVasWUlNTsWbNGrx7905yHVRFO75f7Nq1Cz179iwy6YU8j++cOXPQqVMn2NjYICMjAwcPHkR4eLjkPoBKfe2WqTSrgqridMXljY5h+aDj+P3oGH4/OoYlK+7ejV++XfX29mbu7u5FtnFycmI8Ho/VqFFD6p40X/z+++/MxsaG8Xg81qxZM3bjxg2l5HV3dy+xP2Ofp663sLBgPB6PWVlZsQEDBrCXL18qJe+qVatYzZo1mUAgYIaGhqxNmzbs4sWLRfZbUY4vY5+nlxYKhWznzp0y9ymv4ysrJwCp16O7u3uRMwVHjhxhderUYTwejzVo0IAFBQVJtYvFYrZgwQJmZmbG+Hw+8/DwYFFRUUrJa2trK3ObL/cxy87OZh06dGAmJiZMQ0OD2drasjFjxhS5t5Wi8k6fPl3yujQzM2OdO3eWuqcdYxXr+DLG2LNnzxgAFhwcXGSf8jy+I0eOZLa2tozH4zETExPm4eEhlUGZr10OYzSAviTp6enQ09NDWloafRP+jegYlg86jt+PjuH3o2NICCGElB5N/U4IIYQQQgghckDF1lfw+XwsWrQIfD5f2VFUFh3D8kHH8fvRMfx+dAwJIYSQ0qNhhIQQQgghhBAiB3RmixBCCCGEEELkgIotQgghhBBCCJEDKrYIIYQQQgghRA6o2CKEEEIIIYQQOaBiqwzs7OzA4XCklpUrVyo7VoW3ZcsW2NnZQSAQwNXVFbdu3VJ2JJWxePHiIq85e3t7Zceq8C5fvoxu3brB0tISHA4HgYGBUu2MMSxcuBAWFhYQCoXw9PTEixcvlBO2gvraMRw+fHiR12bHjh2VE5YQQgipoKjYKqOlS5ciNjZWskyZMkXZkSq0w4cPw8fHB4sWLcK9e/fQqFEjeHl5ISEhQdnRVEaDBg2kXnNXr15VdqQKLysrC40aNcKWLVtktq9evRq//fYbtm/fjps3b0JLSwteXl7Izc1VcNKK62vHEAA6duwo9do8dOiQAhMSQgghFZ+6sgOoGh0dHZibmys7hspYv349xowZgxEjRgAAtm/fjqCgIOzevRuzZ89WcjrVoK6uTq+5MurUqRM6deoks40xho0bN2L+/Pno0aMHAGDfvn0wMzNDYGAgBg4cqMioFVZJx/ALPp9Pr01CCCGkBHRmq4xWrlwJIyMjODs7Y82aNSgsLFR2pAorPz8fd+/ehaenp2Qdl8uFp6cnrl+/rsRkquXFixewtLREjRo18OOPP+L9+/fKjqTS3rx5g7i4OKnXpZ6eHlxdXel1WUbh4eEwNTVF3bp1MWHCBCQnJys7EiFEAfbt2wcjIyPk5eVJre/ZsyeGDh2qpFSEVExUbJXB1KlTERAQgLCwMIwbNw4rVqzAzJkzlR2rwkpKSoJIJIKZmZnUejMzM8TFxSkplWpxdXXFnj17cO7cOWzbtg1v3rxB69atkZGRoexoKuvLa49el9+nY8eO2LdvHy5cuIBVq1bh0qVL6NSpE0QikbKjEULkrF+/fhCJRPj7778l6xISEhAUFISRI0cqMRkhFU+VH0Y4e/ZsrFq1qsQ+T58+hb29PXx8fCTrHB0dwePxMG7cOPj6+oLP58s7KqmC/j2My9HREa6urrC1tcWRI0cwatQoJSYjVd2/h1s2bNgQjo6OqFmzJsLDw+Hh4aHEZIQQeRMKhRg8eDD8/PzQr18/AMD+/fthY2ODNm3aKDccIRVMlS+2fvrpJwwfPrzEPjVq1JC53tXVFYWFhXj79i3q1q0rh3SqzdjYGGpqaoiPj5daHx8fT9d5fCN9fX3UqVMHL1++VHYUlfXltRcfHw8LCwvJ+vj4eDg5OSkpleqrUaMGjI2N8fLlSyq2CKkCxowZg6ZNmyImJgZWVlbYs2ePZJZSQsj/VPliy8TEBCYmJt+0bWRkJLhcLkxNTcs5VeXA4/Hg4uKCCxcuoGfPngAAsViMCxcuYPLkycoNp6IyMzPx6tUrGhP/HapXrw5zc3NcuHBBUlylp6fj5s2bmDBhgnLDqbAPHz4gOTlZqoAlhFRezs7OaNSoEfbt24cOHTrg8ePHCAoKUnYsQiqcKl9sldb169dx8+ZNtG3bFjo6Orh+/TpmzJiBIUOGwMDAQNnxKiwfHx94e3ujSZMmaNasGTZu3IisrCzJ7ISkZD///DO6desGW1tbfPz4EYsWLYKamhoGDRqk7GgVWmZmptTZvzdv3iAyMhKGhoawsbHB9OnTsXz5ctSuXRvVq1fHggULYGlpKflSgJR8DA0NDbFkyRL06dMH5ubmePXqFWbOnIlatWrBy8tLiakJIYo0evRobNy4ETExMfD09IS1tbWyIxFS8TBSKnfv3mWurq5MT0+PCQQCVq9ePbZixQqWm5ur7GgV3u+//85sbGwYj8djzZo1Yzdu3FB2JJUxYMAAZmFhwXg8HrOysmIDBgxgL1++VHasCi8sLIwBKLJ4e3szxhgTi8VswYIFzMzMjPH5fObh4cGioqKUG7qCKekYZmdnsw4dOjATExOmoaHBbG1t2ZgxY1hcXJyyYxNCFCg1NZVpamoyHo/HAgIClB2HkAqJwxhjyir0CCGEEEKI6ho2bBiCgoLw8eNHmiyMEBlo6ndCCCGEEPJNYmJi8OOPP1KhRUgx6MwWIYQQQggpk5SUFISHh6Nv37548uQJzcpMSDFoggxCCCGEEFImzs7OSElJwapVq6jQIqQEdGaLEEIIIYQQQuSArtkihBBCCCGEEDmgYosQQgghhBBC5ICKLUIIIYQQQgiRAyq2CCGEEEIIIUQOqNgihBBCCCGEEDmgYosQQgghhBBC5ICKLUIqsMTERJibm2PFihWSddeuXQOPx8OFCxeUmIwQQgghhHwN3WeLkAruzJkz6NmzJ65du4a6devCyckJPXr0wPr165UdjRBCCCGElICKLUJUwKRJkxAaGoomTZrg4cOHuH37Nvh8vrJjEUIIIYSQElCxRYgKyMnJgYODA6Kjo3H37l00bNhQ2ZEIIYQQQshX0DVbhKiAV69e4ePHjxCLxXj79q2y4xBCCCGEkFKgM1uEVHD5+flo1qwZnJycULduXWzcuBEPHz6EqampsqMRQgghhJASULFFSAX3yy+/4NixY3jw4AG0tbXh7u4OPT09nD59WtnRCCGEEEJICWgYISEVWHh4ODZu3Ah/f3/o6uqCy+XC398fV65cwbZt25QdjxBCCCGElIDObBFCCCGEEEKIHNCZLUIIIYQQQgiRAyq2CCGEEEIIIUQOqNgihBBCCCGEEDmgYosQQgghhBBC5ICKLUIIIYQQQgiRAyq2CCGEEEIIIUQOqNgihBBCCCGEEDmgYosQQgghhBBC5ICKLUIIIYQQQgiRAyq2CCGEEEIIIUQOqNgihBBCCCGEEDmgYosQQgghhBBC5OD/AHeiNFPJfZomAAAAAElFTkSuQmCC",
      "text/plain": [
       "<Figure size 1000x500 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "dc = directional_coupler(\n",
    "    x0=5,\n",
    "    y0=2,\n",
    "    z0=1,\n",
    "    wg_spacing_in=10,\n",
    "    wg_width=0.45,\n",
    "    wg_thickness=0.22,\n",
    "    wg_spacing_coup=0.1,\n",
    "    coup_length=5,\n",
    "    bend_length=6,\n",
    "    wg_length=2,\n",
    "    medium=Si,\n",
    "    sidewall_angle=15 * np.pi / 180,\n",
    ")\n",
    "\n",
    "fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 5))\n",
    "dc.plot(z=1, ax=ax1)\n",
    "dc.plot(x=5, ax=ax2)\n",
    "ax2.set_xlim(1, 3)\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "bsgrkrng1lg",
   "metadata": {},
   "source": [
    "## Multimode Interference (MMI) Coupler"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "m7mis5t2nh",
   "metadata": {},
   "source": [
    "A multimode interference (MMI) coupler consists of a wide multimode waveguide connected to single-mode input and output waveguides via s-bends. Power splitting occurs through the self-imaging effect: the multimode region supports many guided modes whose interference pattern reproduces the input field at periodic distances along the propagation direction. The function `make_mmi_shape` builds a symmetric 2×2 MMI and returns the Tidy3D [PolySlab](https://docs.flexcompute.com/projects/tidy3d/en/latest/api/_autosummary/tidy3d.PolySlab.html) geometry, which can then be wrapped into a [Structure](https://docs.flexcompute.com/projects/tidy3d/en/latest/api/_autosummary/tidy3d.Structure.html)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "id": "365d62ee",
   "metadata": {},
   "outputs": [],
   "source": [
    "def make_mmi_shape(\n",
    "    l_mmi,\n",
    "    w_mmi,\n",
    "    w_wg,\n",
    "    s_bend_length,\n",
    "    s_bend_offset,\n",
    "    center=(0, 0),\n",
    "    slab_bounds=(-0.11, 0.11),\n",
    "    sidewall_angle=0,\n",
    "    reference_plane=\"top\",\n",
    "):\n",
    "    \"\"\"\n",
    "    Build a symmetric 2x2 MMI coupler and return its Tidy3D PolySlab geometry.\n",
    "\n",
    "    The MMI body is a rectangle of size (l_mmi, w_mmi) centered at the origin.\n",
    "    Four s-bend waveguides are attached symmetrically: two at the input (left)\n",
    "    and two at the output (right) faces. All parts are merged into a single\n",
    "    polygon via boolean union before creating the PolySlab. The resulting\n",
    "    geometry must be wrapped in a td.Structure by the caller.\n",
    "\n",
    "    Parameters\n",
    "    ----------\n",
    "    l_mmi: length of the MMI multimode region (um)\n",
    "    w_mmi: width of the MMI multimode region (um)\n",
    "    w_wg: width of the access waveguides (um)\n",
    "    s_bend_length: longitudinal length of the s-bend transitions (um)\n",
    "    s_bend_offset: transverse offset of the s-bends — controls port separation\n",
    "        at the input/output relative to the MMI edge (um)\n",
    "    center: (x, y) position of the MMI center (um)\n",
    "    slab_bounds: (z_min, z_max) of the slab in the z direction (um)\n",
    "    sidewall_angle: sidewall angle of the waveguide (rad)\n",
    "    reference_plane: reference plane for the sidewall angle, either 'bottom', 'middle', or 'top'\n",
    "    \"\"\"\n",
    "    # MMI multimode region: rectangle centered at the origin\n",
    "    mmi = pf.Rectangle(size=(l_mmi, w_mmi))\n",
    "\n",
    "    # Access waveguides connect at the top and bottom edges of the MMI face\n",
    "    x_out = l_mmi / 2  # x position of the output face\n",
    "    y_out = w_mmi / 2 - w_wg / 2  # y offset: waveguide centered near the MMI edge\n",
    "\n",
    "    # Output upper s-bend: starts at the output face, bends upward\n",
    "    bend_out_up = pf.Path(origin=(x_out, y_out), width=w_wg)\n",
    "    bend_out_up.s_bend((s_bend_length, s_bend_offset), relative=True)\n",
    "    bend_out_up.segment((10, 0), relative=True)  # straight output section\n",
    "\n",
    "    # Output lower s-bend: mirror of upper across the x-axis\n",
    "    bend_out_down = bend_out_up.copy().mirror()\n",
    "\n",
    "    # Input upper s-bend: mirror of output upper across the y-axis\n",
    "    bend_in_up = bend_out_up.copy().mirror((0, 1))\n",
    "\n",
    "    # Input lower s-bend: mirror of output lower across both axes\n",
    "    bend_in_down = bend_out_down.copy().mirror((0, 1))\n",
    "\n",
    "    # Boolean union of all parts into a single connected polygon\n",
    "    polygons = pf.boolean(\n",
    "        [\n",
    "            mmi,\n",
    "            bend_out_up,\n",
    "            bend_out_down,\n",
    "            bend_in_up,\n",
    "            bend_in_down,\n",
    "        ],\n",
    "        [],\n",
    "        \"+\",\n",
    "    )\n",
    "\n",
    "    assert len(polygons) == 1, \"Expected a single polygon for the union.\"\n",
    "    polygon = polygons[0]\n",
    "    assert len(polygon.holes) == 0, \"Expected no holes.\"\n",
    "\n",
    "    # Translate to the requested center position\n",
    "    polygon.translate(center)\n",
    "\n",
    "    geometry = td.PolySlab(\n",
    "        vertices=polygon.vertices,\n",
    "        axis=2,\n",
    "        slab_bounds=slab_bounds,\n",
    "        sidewall_angle=sidewall_angle,\n",
    "        reference_plane=reference_plane,\n",
    "    )\n",
    "\n",
    "    return geometry"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "id": "vrdug0sv24b",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 1000x500 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "mmi_geo = make_mmi_shape(\n",
    "    l_mmi=3,\n",
    "    w_mmi=1,\n",
    "    w_wg=0.45,\n",
    "    s_bend_length=4,\n",
    "    s_bend_offset=1,\n",
    "    center=(0, 0),\n",
    "    slab_bounds=(-0.11, 0.11),\n",
    "    sidewall_angle=5 * np.pi / 180,\n",
    "    reference_plane=\"top\",\n",
    ")\n",
    "\n",
    "mmi = td.Structure(geometry=mmi_geo, medium=Si)\n",
    "\n",
    "fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 5))\n",
    "mmi.plot(z=0, ax=ax1)\n",
    "mmi.plot(x=0, ax=ax2)\n",
    "ax2.set_xlim(-4, 4)\n",
    "plt.show()"
   ]
  }
 ],
 "metadata": {
  "description": "This notebook contains predefined functions used to construct commonly used photonic integrated circuit (PIC) components.",
  "feature_image": "",
  "kernelspec": {
   "display_name": "base",
   "language": "python",
   "name": "python3"
  },
  "keywords": "photonic integrated circuit, PIC, waveguide, linear taper, ring, race track, s-bend, circular bend, directional coupler, tidy3d, fdtd",
  "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.7"
  },
  "title": "Defining Common Integrated Photonic Components | Flexcompute"
 },
 "nbformat": 4,
 "nbformat_minor": 5
}
