InverseKinematics.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "xFK-rz5y0P0n"
   },
   "source": [
    "# Section II. MODELING\n",
    "    \n",
    "# Chapter 6. Inverse Kinematics"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "anP49LQs0P0t"
   },
   "source": [
    "As opposed to forward kinematics, which computes the workspace\n",
    "coordinates of the robot given a configuration as input, inverse\n",
    "kinematics (IK) is essentially the reverse operation: computing\n",
    "configuration(s) to reach a desired workspace coordinate. This operation\n",
    "is essential to many robotics tasks, like moving a tool along a\n",
    "specified path, manipulating objects, and observing scenes from a\n",
    "desired vantage point. Because it is so important, inverse kinematics\n",
    "has been studied extensively, with many techniques available to solve it\n",
    "quickly and (relatively) reliably.\n",
    "\n",
    "However, unlike forward kinematics, inverse kinematics cannot be solved\n",
    "in a closed-form expression (in general). We shall see there may be no\n",
    "solutions, multiple solutions, or even an infinite number of solutions\n",
    "to an IK problem. As a result, the subtleties of IK must be understood\n",
    "in order to apply it effectively in practice. This chapter will discuss\n",
    "several general issues regarding IK, including the notions of task\n",
    "space, redundancy, and singularities. Both analytical and numerical\n",
    "methods to solve inverse kinematics will be presented.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "f5f0prW00ZZb"
   },
   "source": [
    "General discussion\n",
    "------------------\n",
    "\n",
    "<a id=\"constraint-equation\"></a>\n",
    "If we express the coordinates of some point $X$ attached to the robot as\n",
    "a vector $\\mathbf{x}$, forward kinematics allows us to compute a map\n",
    "$\\mathbf{x}(\\mathbf{q}) \\equiv f(\\mathbf{q})$ where $\\mathbf{q}$ is the robot's\n",
    "configuration. Note that this map is vector-valued. The goal of IK is to\n",
    "produce an inverse of the map $f$, or more specifically, given a desired\n",
    "value $\\mathbf{x}_D$, calculate one or more solutions $\\mathbf{q}$ such that\n",
    "$\\mathbf{x}_D = \\mathbf{x}(\\mathbf{q}) \\equiv f(\\mathbf{q})$ hold. We also say that\n",
    "$\\mathbf{x}(\\mathbf{q}) - \\mathbf{x}_D = 0$ is the *constraint equation* that $\\mathbf{q}$\n",
    "must meet.\n",
    "\n",
    "************\n",
    "\n",
    "![fig:2RIK](https://github.com/krishauser/RoboticSystemsBook/blob/master/figures/modeling/ik_2R.png?raw=1)\n",
    "\n",
    "<div class=\"figcaption\"><a name=\"fig:2RIK\">Figure 1</a>.\n",
    "Illustrating the IK problem for a 2R planar manipulator. (a) The goal\n",
    "is to find one or more configurations $\\mathbf{q}$ so that the end effector\n",
    "position $\\mathbf{x}(\\mathbf{q})$ is matched to a target position $\\mathbf{x}_D$. IK\n",
    "problems may have more than one solution, and in this case there are two\n",
    "solutions (b,c) given by $(q_1^A,q_2^A)$ and\n",
    "$(q_1^B,q_2^B)$.</div>\n",
    "\n",
    "************\n",
    "\n",
    "For instance, suppose $X$ is a point on link $N$ and has local\n",
    "coordinates $\\mathbf{x}_N$ (relative to link $N$). After the robot moves,\n",
    "link $N$ has coordinate frame $T_N(\\mathbf{q})$ relative to the world frame.\n",
    "Hence, $X$ has world coordinates $$\\mathbf{x}(\\mathbf{q}) = T_N(\\mathbf{q}) \\mathbf{x}_N.$$\n",
    "\n",
    "Given $\\mathbf{x}_D$ specifying some desired coordinates of $X$ in the world\n",
    "frame, IK would compute some $\\mathbf{q}$ so that\n",
    "$T_N(\\mathbf{q}) \\mathbf{x}_N = \\mathbf{x}_D$. Depending on the value of $\\mathbf{x}_D$ and\n",
    "the kinematic structure of the robot, there may be no solution, such as\n",
    "when the desired point is out of reach. There may also be multiple\n",
    "solutions, as illustrated in\n",
    "[Fig. 1](#fig:2RIK). A third case is when infinite solutions may\n",
    "occur, such as when the robot is *redundant*, which means that it\n",
    "possesses more degrees of freedom than the dimension of the workspace.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "XtqKzHPf0bJt"
   },
   "source": [
    "### Nonlinear mapping between C-space and workspace\n",
    "\n",
    "The big challenge in inverse kinematics is that the mapping from configuration space to workspace is *nonlinear*.  This means that straight lines in the joint space map to curves in the workspace, and vice versa.   In other words, the direction of motion in workspace changes continuously as the configuration moves. The plots below show some examples for the 2R robot with unit lengths.  \n",
    "\n",
    "The significance of this is that we cannot simply use the tools of linear algebra to solve IK problems.  We will need to use more sophisticated geometric and mathematical manipulations in order to find solutions.  Moreover, whereas the solution to linear systems of equations may be unique points or linear subspaces of solutions, the solution to nonlinear equations can be multiple points, or even nonlinear manifolds.  \n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "cellView": "form",
    "code_folding": [
     0
    ],
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 299
    },
    "id": "nypVDni80P0x",
    "outputId": "42928169-e16d-45b4-9327-e90fc41f02ef"
   },
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAArUAAAGNCAYAAAAPYYkcAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjcuMSwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/bCgiHAAAACXBIWXMAAA9hAAAPYQGoP6dpAABOGklEQVR4nO3de3zO9f/H8ee1zWbGNmwjGXYox4g5jpxyLEqFRcoKleirSKjvlxStpIOvpDPyzSEKUYkccyw0IcdyasrZxrDN9vn98fntYjZrp2ufXdce99vtc/tc1+f6XNfn9bmsd8+99/68PzbDMAwBAAAATszN6gIAAACA/CLUAgAAwOkRagEAAOD0CLUAAABweoRaAAAAOD1CLQAAAJweoRYAAABOj1ALAAAAp0eoBQAAgNMj1KLQ7N+/Xx06dJCfn59sNpsWLlyo6dOny2az6dChQ1aXl2erV6+WzWbT6tWrrS4FAAqdzWbT4MGDrS4DINQWN7///rueeOIJhYaGqmTJkvL19VXz5s01adIkXbp0yaHH7tu3r3bs2KHx48dr5syZatiwoUOPV9Dee+89TZ8+3eoyAMDuiy++kM1m04IFCzK9Vq9ePdlsNq1atSrTa1WqVFFkZGRhlAgUGg+rC0Dh+eabb9SjRw95eXnpkUceUZ06dZScnKx169Zp+PDh2rVrlz788EOHHPvSpUvauHGjXnzxxQy/0T/88MN68MEH5eXl5ZDjFqT33ntPAQEBio6OzrC9ZcuWunTpkjw9Pa0pDECx1aJFC0nSunXrdN9999m3JyQkaOfOnfLw8ND69evVpk0b+2tHjx7V0aNH9eCDDxZ6vYAjEWqLiYMHD+rBBx9U1apVtXLlSt1000321wYNGqQDBw7om2++cdjxT548KUny9/fPsN3d3V3u7u4OO+6NGIahy5cvy9vbO9+f5ebmppIlSxZAVQCQO5UqVVJISIjWrVuXYfvGjRtlGIZ69OiR6bX05+mBOC8Ksg0FCgrDD4qJCRMm6MKFC/rkk08yBNp04eHhGjJkiP35lStX9MorrygsLExeXl6qVq2aXnjhBSUlJWV4X7Vq1dSlSxetW7dOjRs3VsmSJRUaGqrPPvvMvs9LL72kqlWrSpKGDx8um82matWqSVKWY2rT0tL00ksvqVKlSipVqpTatGmj3377TdWqVcvQS/rSSy/JZrNlOpesPjO9zu+//14NGzaUt7e3PvjgA0nStGnT1LZtWwUFBcnLy0u1atXS1KlTM53nrl27tGbNGtlsNtlsNrVu3VrSjcfUzps3TxEREfL29lZAQID69OmjuLi4DPtER0erdOnSiouLU7du3VS6dGkFBgbqueeeU2pqaqZzu96WLVvUsWNHBQQEyNvbWyEhIXrsscfsrx86dEg2m00TJ07U22+/rapVq8rb21utWrXSzp07M3zWr7/+qujoaPvQlIoVK+qxxx7T6dOnMx03Li5O/fr1U6VKleTl5aWQkBANHDhQycnJ9n3OnTunZ555RsHBwfLy8lJ4eLhef/11paWl/eN5Aci5Fi1a6JdffskwhGz9+vWqXbu2OnfurE2bNmX47279+vWy2Wxq3rx5rtv6rNrQrIwbN05ubm6aPHmyfdvkyZNVu3ZtlSpVSmXLllXDhg01a9Ys++vpbfqePXvUs2dP+fr6qnz58hoyZIguX76c4fNz0m6n++6779SqVSuVKVNGvr6+atSoUYbjStLmzZvVqVMn+fn5qVSpUmrVqpXWr1+fzbeOooie2mJi8eLFCg0NzfEYqv79+2vGjBnq3r27hg0bps2bNysmJka7d+/ONHbrwIED6t69u/r166e+ffvq008/VXR0tCIiIlS7dm3df//98vf317PPPqtevXrprrvuUunSpW947FGjRmnChAnq2rWrOnbsqO3bt6tjx46ZGrXc2rt3r3r16qUnnnhCAwYMUPXq1SVJU6dOVe3atXXPPffIw8NDixcv1lNPPaW0tDQNGjRIkvTOO+/o6aefVunSpfXiiy9KkipUqHDDY02fPl2PPvqoGjVqpJiYGB0/flyTJk3S+vXr9csvv2TosU5NTVXHjh3VpEkTTZw4UT/88IPefPNNhYWFaeDAgTc8xokTJ9ShQwcFBgZq5MiR8vf316FDh/TVV19l2vezzz7T+fPnNWjQIF2+fFmTJk1S27ZttWPHDvt5LF++XH/88YceffRRVaxY0T4cZdeuXdq0aZP9F4hjx46pcePGOnfunB5//HHVqFFDcXFxmj9/vi5evChPT09dvHhRrVq1UlxcnJ544glVqVJFGzZs0KhRo/TXX3/pnXfeydW/HYAba9GihWbOnKnNmzfbf9lev369IiMjFRkZqfj4eO3cuVN169a1v1ajRg2VL19e0dHROW7rb9SGXu/f//63Xn31VX3wwQcaMGCAJOmjjz7Sv/71L3Xv3t0eUn/99Vdt3rxZvXv3zvD+nj17qlq1aoqJidGmTZv03//+V2fPns3QWZKTdlsy2+LHHntMtWvX1qhRo+Tv769ffvlFS5cutR935cqV6ty5syIiIjRmzBi5ubnZQ/OPP/6oxo0b5+8fCIXHgMuLj483JBn33ntvjvaPjY01JBn9+/fPsP25554zJBkrV660b6tataohyVi7dq1924kTJwwvLy9j2LBh9m0HDx40JBlvvPFGhs+cNm2aIck4ePCgYRiG8ffffxseHh5Gt27dMuz30ksvGZKMvn372reNGTPGyOpH+PrPvLbOpUuXZtr/4sWLmbZ17NjRCA0NzbCtdu3aRqtWrTLtu2rVKkOSsWrVKsMwDCM5OdkICgoy6tSpY1y6dMm+35IlSwxJxujRo+3b+vbta0gyXn755QyfWb9+fSMiIiLTsa61YMECQ5Lx888/33Cf9O/d29vb+PPPP+3bN2/ebEgynn32Wfu2rL6H2bNnZ/r3feSRRww3N7csj5uWlmYYhmG88sorho+Pj7Fv374Mr48cOdJwd3c3jhw5ku25Aci5Xbt2GZKMV155xTAMw0hJSTF8fHyMGTNmGIZhGBUqVDCmTJliGIZhJCQkGO7u7saAAQPy1NZn1YZKMgYNGmQYhmEMGzbMcHNzM6ZPn55hn3vvvdeoXbt2tueR3qbfc889GbY/9dRThiRj+/bt9m05abfPnTtnlClTxmjSpEmGttgwrrZVaWlpxi233GJ07NjRvi3980NCQoz27dtnWzOKFoYfFAMJCQmSpDJlyuRo/2+//VaSNHTo0Azbhw0bJkmZxt7WqlVLd9xxh/15YGCgqlevrj/++CPXta5YsUJXrlzRU089lWH7008/nevPul5ISIg6duyYafu1Y8Li4+N16tQptWrVSn/88Yfi4+NzfZwtW7boxIkTeuqppzKMtb377rtVo0aNLMcuP/nkkxme33HHHf/4/aX39i5ZskQpKSnZ7tutWzfdfPPN9ueNGzdWkyZN7P/WUsbv4fLlyzp16pSaNm0qSdq2bZskc2jIwoUL1bVr1yxnr0jvzZ03b57uuOMOlS1bVqdOnbIv7dq1U2pqqtauXZttvQByrmbNmipfvrx9rOz27duVmJho/8tcZGSk/U/pGzduVGpqqlq0aJHrtv5GbahkjrEdPHiwJk2apP/973/q27dvhtf9/f31559/6ueff/7H87m2p1W62v7fqL26Ubu9fPlynT9/XiNHjsx03UN6WxUbG6v9+/erd+/eOn36tL2tSkxM1J133qm1a9cyZMqJEGqLAV9fX0nS+fPnc7T/4cOH5ebmpvDw8AzbK1asKH9/fx0+fDjD9ipVqmT6jLJly+rs2bO5rjX9s68/drly5VS2bNlcf961QkJCsty+fv16tWvXTj4+PvL391dgYKBeeOEFScpTqE0/h6z+NFejRo1M31/JkiUVGBiYYVtOvr9WrVrpgQce0NixYxUQEKB7771X06ZNyzQWTpJuueWWTNtuvfXWDOOOz5w5oyFDhqhChQry9vZWYGCg/TtL/x5OnjyphIQE1alTJ9va9u/fr6VLlyowMDDD0q5dO0nm0AkABcNmsykyMtI+dnb9+vUKCgqyt6PXhtr0dYsWLXLd1t+oDZXMIU5TpkzR5MmT1atXr0yvjxgxQqVLl1bjxo11yy23aNCgQTccs3p9exUWFiY3N7cM7VVO2u3ff/9dkrJtr/bv3y/JnHLy+vbq448/VlJSUp7+PwBrMKa2GPD19VWlSpUyXRj0T7K6CCsrN5q9wDCMXB0vt25U340usMrqKt3ff/9dd955p2rUqKG33npLwcHB8vT01Lfffqu33367UH5Dz+vsDzabTfPnz9emTZu0ePFiff/993rsscf05ptvatOmTdmOW85Kz549tWHDBg0fPly33367SpcurbS0NHXq1CnX30NaWprat2+v559/PsvXb7311lx9HoDstWjRQosXL9aOHTvs42nTRUZGavjw4YqLi9O6detUqVIlhYaG2l/PaVuf3UwHzZs3V2xsrN5991317NlT5cqVy/B6zZo1tXfvXi1ZskRLly7Vl19+qffee0+jR4/W2LFjsz3u9fUVZLudvu8bb7yh22+/Pct9ctuWwjqE2mKiS5cu+vDDD7Vx40Y1a9Ys232rVq2qtLQ07d+/XzVr1rRvP378uM6dO2efycAR0j/7wIEDGXoFTp8+nannMr3n9ty5cxkuvLq+dyE7ixcvVlJSkr7++usMPc5ZTVae04Y//Rz27t2rtm3bZnht7969Bf79NW3aVE2bNtX48eM1a9YsPfTQQ5ozZ4769+9v3ye9N+Ja+/bts89Ccfbs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",
      "text/plain": [
       "<Figure size 800x400 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "#@title Code for generating the figures below\n",
    "%matplotlib inline\n",
    "import matplotlib.pyplot as plt\n",
    "import numpy as np\n",
    "import math\n",
    "\n",
    "fig = plt.figure(figsize=(8,4))\n",
    "axjoint = fig.add_subplot(121)\n",
    "axwork = fig.add_subplot(122)\n",
    "\n",
    "L1,L2=1,1\n",
    "def fk(q1,q2):\n",
    "    c1 = np.cos(q1)\n",
    "    s1 = np.sin(q1)\n",
    "    c12 = np.cos(q1+q2)\n",
    "    s12 = np.sin(q1+q2)\n",
    "    return (c1*L1+c12*L2,s1*L1+s12*L2)\n",
    "\n",
    "def plotlines(qa,qb,divs=40,**kwargs):\n",
    "    q1 = np.linspace(qa[0],qb[0],divs)\n",
    "    q2 = np.linspace(qa[1],qb[1],divs)\n",
    "    x,y = fk(q1,q2)\n",
    "    axjoint.plot(q1,q2,**kwargs)\n",
    "    axwork.plot(x,y,**kwargs)\n",
    "\n",
    "axjoint.set_xlim(-math.pi,math.pi)\n",
    "axjoint.set_ylim(-math.pi,math.pi)\n",
    "axjoint.set_title(\"Configuration space\")\n",
    "axjoint.set_xlabel(r'$\\theta_1$')\n",
    "axjoint.set_ylabel(r'$\\theta_2$')\n",
    "axwork.set_xlim(-2.5,2.5)\n",
    "axwork.set_ylim(-2.5,2.5)\n",
    "axwork.set_title(\"Workspace\")\n",
    "axwork.set_xlabel('x')\n",
    "axwork.set_ylabel('y')\n",
    "plotlines((0,0),(math.pi/2,0),color='k')\n",
    "plotlines((math.pi/2,0),(math.pi/2,-2),color='b')\n",
    "plotlines((math.pi/2,-2),(-math.pi/2,-3),color='r')\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "S3RSDoME0P05"
   },
   "source": [
    "### Task space\n",
    "\n",
    "The coordinates $\\mathbf{x}$ are known as *task coordinates* which define the\n",
    "robot's intended goal that it should perform in Cartesian space. In the\n",
    "example above, the task consisted only of Cartesian position, but it\n",
    "could generalize to also include orientation of the final link through a\n",
    "different choice of $f$. To define a combination of position and\n",
    "orientation goal, we would append some rotation parameterization like\n",
    "Euler angles to $\\mathbf{x}$, and define the forward kinematic map:"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "Y761Y1GW0P07"
   },
   "source": [
    "$$\\mathbf{x} \\equiv \\begin{bmatrix}\n",
    "  \\mathbf{x}_p \\\\\n",
    "  \\mathbf{x}_o\n",
    "\\end{bmatrix}=f(\\mathbf{q}) \\equiv\n",
    " \\begin{bmatrix}\n",
    "   T_N(\\mathbf{q})\\mathbf{x}_N \\\\\n",
    "   R_{ea}^{-1}(R_N(\\mathbf{q}))\n",
    " \\end{bmatrix}$$ "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "vrp_MClo0P09"
   },
   "source": [
    "\n",
    "where $R_N(\\mathbf{q})$ is the 3x3 rotation matrix of the $N$'th link, and\n",
    "$R_{ea}^{-1}(R)$ computes the euler angle representation of the rotation\n",
    "matrix $R$ (according to some chosen convention). Here $\\mathbf{x}_p$ is the\n",
    "position of $X$ and $\\mathbf{x}_o$ is the Euler angle representation of the\n",
    "orientation of the link on which it resides.\n",
    "\n",
    "It is also possible to define more exotic task spaces to accomplish\n",
    "different goals. Suppose for example that $X$ is a point in the middle\n",
    "of the robot's gripper, and it is supposed to lift a cup of liquid\n",
    "without tipping it. If we define a local direction $\\mathbf{d}_N$ as an \"up\"\n",
    "direction perpendicular to the gripper opening direction, and $\\mathbf{z}$\n",
    "being the up direction in world coordinates, then we can specify a\n",
    "directional task constraint:\n",
    "$$\n",
    "  \\mathbf{d}(\\mathbf{q}) - \\mathbf{z} = R_N (\\mathbf{q}) \\mathbf{d}_N - \\mathbf{z} = 0\n",
    "$$\n",
    "where\n",
    "$\\mathbf{d}(\\mathbf{q})$ is the direction of the desired \"up\" vector attached to\n",
    "the gripper, but expressed in world coordinates.\n",
    "\n",
    "In general, the task space may consist of any number of position and\n",
    "orientation constraints on the robot. For example, for a $k$-legged\n",
    "robot, up to $k$ leg positions and orientation may be constrained to be\n",
    "fixed while the body moves. In any of these cases we can still express\n",
    "the constraint as a vector equation $\\mathbf{x}(\\mathbf{q}) - \\mathbf{x}_D = 0$ by\n",
    "stacking each individual constraint into a larger vector.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "6jtmf0HR1OZJ"
   },
   "source": [
    "### Analytical vs numerical IK\n",
    "\n",
    "There exist two general approaches for solving IK problems. In the\n",
    "*analytical* approach, the equation $\\mathbf{x}_D = f(\\mathbf{q})$ is\n",
    "mathematically inverted into a closed-form expression through symbolic\n",
    "manipulations. In the *numerical approach*, we are given an initial\n",
    "guess $\\mathbf{q}_0$ and then calculate a sequence of configurations\n",
    "$\\mathbf{q}_0,\\mathbf{q}_1,\\mathbf{q}_2,\\ldots$ such that the error\n",
    "$\\| f(\\mathbf{q}) - \\mathbf{x}_D \\|$ approaches 0. This section will focus on\n",
    "analytical methods.\n",
    "\n",
    "The advantages of the analytical method include:\n",
    "\n",
    "-   Computes all IK solutions, and determines whether no solution\n",
    "    exists.\n",
    "\n",
    "-   Once the equations are derived, solutions are very fast to compute.\n",
    "\n",
    "-   No need to define solution parameters or initial guesses $\\mathbf{q}_0$\n",
    "\n",
    "Disadvantages of the analytical method include:\n",
    "\n",
    "-   Often difficult or tedious to derive.\n",
    "\n",
    "-   Must be derived independently for robots with different kinematic\n",
    "    structures.\n",
    "\n",
    "-   Only applicable to nonredundant robots (\\# DOFs = \\# of task space\n",
    "    dimensions).\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "49XUxqEc1Q8B"
   },
   "source": [
    "### Choosing from a set of solutions: incorporating extra constraints\n",
    "\n",
    "It is important to note that when multiple solutions exist, neither IK\n",
    "approach specifies which solution is \"best.\" Also, it is important to\n",
    "note that many of the solutions produced by IK techniques may be\n",
    "infeasible for a robot to undertake. For example, IK solutions may\n",
    "exceed joint limits, cause the robot to self-collide, or cause the robot\n",
    "to collide with environmental obstacles. In fact, the notion of \"best\"\n",
    "or \"feasible\" must be defined by some criterion external to the choice\n",
    "of task. The requirement of producing high-quality solutions can be\n",
    "considered as a *soft constraint*, while strict requirements are\n",
    "considered *hard constraints*.\n",
    "\n",
    "Soft constraints can be expressed as seeking an IK solution that\n",
    "minimizes some scalar function $g(\\mathbf{q})$. To handle soft constraints,\n",
    "in the analytical case where multiple solutions exist, we may simply\n",
    "loop through all solutions; in the numerical case, there are some\n",
    "solution techniques that (locally) minimize $g(\\mathbf{q})$ among possible\n",
    "solutions. To handle hard constraints in the analytical solution case,\n",
    "they may be checked after solving for all solutions. In the numerical\n",
    "case, it is preferable to use solution techniques that enforce these\n",
    "additional constraints.\n",
    "\n",
    "Throughout this chapter, however, additional constraints will not be\n",
    "considered unless otherwise specified.\n",
    "\n",
    "### Counting solutions\n",
    "\n",
    "For *almost all* task parameters $\\mathbf{x}$ (in a sense to be made more\n",
    "precise later) and \"usual\" kinematic structures, it is possible to coarsely\n",
    "determine the number of solutions simply by examining the number of DOFs\n",
    "of the robot and the number of constraints. Letting $n$ be the number of\n",
    "DOFs and $m$ be the number of task constraints, we have the following\n",
    "general rules:\n",
    "\n",
    "-   If $n < m$, then no solutions to $\\mathbf{x} = f(\\mathbf{q})$ exist.\n",
    "    (Overconstrained system of equations.)\n",
    "\n",
    "-   If $n = m$, then a finite number of solutions exist.\n",
    "\n",
    "-   If $n > m$, then either no solutions or an infinite number of\n",
    "    solutions exist. (Underconstrained system of equations.)\n",
    "\n",
    "In the overconstrained case, there is insufficient flexibility in the\n",
    "choice of $\\mathbf{q}$ to attain arbitrary values of $\\mathbf{x}$. In the\n",
    "underconstrained case, the robot is also called *redundant*. When the\n",
    "task exceeds the reach of the robot, there is no solution, but whenever\n",
    "a solution exists, there is a *continuum* of solutions that attain the\n",
    "same task. In fact, the solution set in general will have intrinsic\n",
    "dimension $n-m$ -- that is there will be $n-m$ independent directions of\n",
    "flexibility in configuration space while maintaining the task as fixed.\n",
    "It is often the case in redundant robots that it is difficult to\n",
    "characterize all of the solutions for a given task, although we shall\n",
    "describe methods for doing so when describing parallel robots.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "GzWQkqA11SqT"
   },
   "source": [
    "### Singularities\n",
    "\n",
    "The counting rules hold almost everywhere except for certain unstable\n",
    "settings of the parameter $\\mathbf{x}$, which are known as *singularities*.\n",
    "We have already discussed singularities in the context of 3D rotations,\n",
    "where a rotation may have multiple representations. In nonredundant IK,\n",
    "a singularity occurs when the task has an infinite number of solutions,\n",
    "or precisely one solution. In redundant IK, a singularity is observed as\n",
    "a change in the intrinsic dimensionality of the solution set.\n",
    "\n",
    "Singularities are *unstable* in the sense that any open neighborhood\n",
    "containing a singular task point $\\mathbf{x}$ will have different numbers of\n",
    "solutions. In other words, if $\\mathbf{x}$ were perturbed slightly, the\n",
    "number of solutions will almost certainly change. Non-singular points do\n",
    "not have this problem: for a non-singular point $\\mathbf{x}$, there will\n",
    "exist an open neighborhood of $\\mathbf{x}$ for which the number of solutions\n",
    "remains constant.\n",
    "\n",
    "In practical terms, singularities usually avoided during IK for a number\n",
    "of reasons: as a singularity is approached in task space, the\n",
    "solution configurations change increasingly rapidly, and the solution\n",
    "set may change size, making it challenging to produce smooth movements.\n",
    "There is a straightforward way of computing whether a configuration is\n",
    "at a singularity via a condition about the task's *Jacobian matrix*.\n",
    "This will be discussed in the [section on Jacobians](#The-Jacobian-matrix). \n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "lMqkjTck0P0-"
   },
   "source": [
    "Analytical IK in 2D\n",
    "-------------------\n",
    "\n",
    "Let us begin by deriving analytical solutions for most common planar\n",
    "robots.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "FQlM6yMP1aBK"
   },
   "source": [
    "### 2R manipulator\n",
    "\n",
    "************\n",
    "\n",
    "![fig:2RIKb](https://github.com/krishauser/RoboticSystemsBook/blob/master/figures/modeling/ik_2Rb.png?raw=1)\n",
    "\n",
    "<div class=\"figcaption\"><a name=\"fig:2RIKb\">Figure 2</a>\n",
    "The key steps for solving the planar 2R IK problem. (a) Determine a\n",
    "value for $q_2$ that puts the end effector point on the circle centered\n",
    "on the origin with radius equal to the distance between the origin and\n",
    "the target point. Here there are 2 solutions. Then, determine the values of $q_1$\n",
    "that the end effector is rotated onto the target, with $q_2$ fixed to\n",
    "its first (b) and second (c)\n",
    "solutions.</div>\n",
    "\n",
    "************\n",
    "\n",
    "Consider a 2R manipulator with the first joint located at the origin,\n",
    "and at the reference configuration the second joint is located $L_1$\n",
    "distance away along the $x$ axis. The end effector is located $L_2$\n",
    "distance away from the second joint along the $x$ axis.\n",
    "\n",
    "With this definition, the forward kinematics equations in the previous\n",
    "chapter show that the world coordinates of the end effector at\n",
    "configuration $\\mathbf{q} = (q_1,q_2)$ are given by:\n",
    "$$\\begin{split}\n",
    "\\mathbf{x}(\\mathbf{q}) &= R(q_1)\\left(R(q_2) \\begin{bmatrix} L_2 \\\\ 0 \\end{bmatrix} + \\begin{bmatrix} L_1 \\\\ 0 \\end{bmatrix} \\right) \\\\\n",
    " & = R(q_1) \\begin{bmatrix}L_1 + c_2 L_2 \\\\ s_2 L_2 \\end{bmatrix} = \\begin{bmatrix} c_1(L_1 + c_2 L_2) - s_1 s_2 L_2 \\\\ s_1(L_1 + c_2 L_2) + c_1 s_2 L_2 \\end{bmatrix}\n",
    "\\end{split}\n",
    "$$\n",
    "where $c_i = \\cos q_i$ and $s_i = \\sin q_i$, for $i = 1,2$.\n",
    "\n",
    "Suppose we wish to move this $\\mathbf{x}$ to the target point $\\mathbf{x}_D$.\n",
    "Thinking geometrically, we observe that the only joint controlling the\n",
    "norm $\\| \\mathbf{x}(\\mathbf{q}) \\|$ (i.e., the distance from the end effector to\n",
    "the origin) is $q_2$. See\n",
    "[Fig. 2](#fig:2RIKb)(a) for an illustration. As a result,\n",
    "$\\| \\mathbf{x}(q_1,q_2) \\| = \\| \\mathbf{x}(0,q_2) \\|$ which results in the\n",
    "simplified calculation:\n",
    "$$\n",
    "  \\| \\mathbf{x}(q_1,q_2) \\| = \\sqrt{(L_1 + c_2 L_2)^2 + (s_2 L_2)^2}.\n",
    "$$\n",
    "Since\n",
    "this norm must match the norm of $\\mathbf{x}_D$, we require:\n",
    "$$\n",
    "  \\| \\mathbf{x}_D \\|^2 = (L_1 + c_2 L_2)^2 + (s_2 L_2)^2 = L_1^2 + 2 c_2 L_1 L_2 + c_2^2 L_2^2 + s_2^2 L_2^2 = L_1^2 + 2 c_2 L_1 L_2 + L_2^2\n",
    "$$\n",
    "where in the last equality we've used the fact that $c_i^2 + s_i^2 = 1$.\n",
    "Now, the only unknown quantity in this equation is $c_2$. Solving for\n",
    "$c_2$, we obtain:\n",
    "$$c_2 = \\frac{\\| \\mathbf{x}_D \\|^2 - L_1^2 - L_2^2}{2 L_1 L_2}.$$\n",
    "\n",
    "Based on the properties of the cosine, the right hand side (r.h.s.) of\n",
    "this equation must be in the range $[-1,1]$ for a solution to exist. If\n",
    "it were identically $\\pm 1$, then one solution would exist, namely 0 or\n",
    "$\\pi$, and otherwise two solutions exist, namely\n",
    "$$q_2 = \\pm \\cos^{-1} \\left( \\frac{\\| \\mathbf{x}_D \\|^2 - L_1^2 - L_2^2}{2 L_1 L_2} \\right).$$\n",
    "The positive and negative solutions are known as *elbow down* and *elbow\n",
    "up* solutions, respectively (with \"down\" and \"up\" indicating the\n",
    "direction that the elbow is facing, not the rotation of the forearm).\n",
    "For robots with anthropomorphic joint limits it is possible to restrict\n",
    "further consideration to only one of these solutions; otherwise, both\n",
    "solutions must be considered.\n",
    "\n",
    "Examining the case in which no solution exists, if the r.h.s. were\n",
    "greater than 1, then $\\| \\mathbf{x}_D \\|^2 - L_1^2 - L_2^2 > 2 L_1 L_2$, or\n",
    "in other words:\n",
    "$$\n",
    "  \\| \\mathbf{x}_D \\|^2 > L_1^2 + 2 L_1 L_2 + L_2^2 = (L_1 + L_2)^2\n",
    "$$\n",
    "which\n",
    "indicates that the desired point exceeds the reachable range of the\n",
    "manipulator.\n",
    "\n",
    "If on the other hand, the r.h.s. were less than -1, then\n",
    "$\\| \\mathbf{x}_D \\|^2 - L_1^2 - L_2^2 < - 2 L_1 L_2$, in other words\n",
    "$$\n",
    "  \\| \\mathbf{x}_D \\|^2 < L_1^2 - 2 L_1 L_2 + L_2^2 = (L_1 - L_2)^2.\n",
    "$$\n",
    "For this to be possible, we must have the link lengths unequal, and the\n",
    "target point is within a circle of radius $|L_1 - L_2|$ centered at the\n",
    "origin.\n",
    "\n",
    "If we have determined that there exists one or more solutions for the\n",
    "second joint, $q_2^{(k)}$ with $k=1$ or $2$, for each solution we can\n",
    "determine a value of $q_1^{(k)}$ so that the end effector reaches the\n",
    "proper heading toward $\\mathbf{x}_D$. Let the heading of $\\mathbf{x}_D$ be denoted\n",
    "$\\theta \\equiv atan2(x_y,x_x)$.\n",
    "\n",
    "Observe that if $q_1^{(k)}$ were to be set to 0, then the end effector\n",
    "would have heading\n",
    "$\\theta^{(k)} = atan2(L_2 \\sin q_2^{(k)}, L_1 + L_2 \\cos q_2^{(k)})$. We\n",
    "simply choose $q_1^k$ to compensate for the difference:\n",
    "$q_1^{(k)} = \\theta - \\theta^k$. See\n",
    "[Fig. 2](#fig:2RIKb)(b) and (c) for an illustration of this procedure.\n",
    "\n",
    "The above description can be converted into a procedure that computes\n",
    "the set of all solutions, with pseudocode listed in \n",
    "Algorithm 2RIK below.\n",
    "\n",
    "*******************\n",
    "**Algorithm 2RIK**\n",
    "\n",
    "1. $c_2 \\gets \\frac{\\| \\mathbf{x}_D \\|^2 - L_1^2 - L_2^2}{2 L_1 L_2}$.\n",
    "\n",
    "2. **if** $|c_2|>1$ **then** **return** $\\emptyset$.\n",
    "\n",
    "3. **if** $c_2 = 1$ **then** **return** $\\{ (atan2(x_y,x_x),0) \\}$. \n",
    "\n",
    "4. **if** $c_2 = -1$ and $\\mathbf{x}_D \\neq 0$ **then** **return** $\\{ (atan2(x_y,x_x),\\pi) \\}$.\n",
    "\n",
    "5. **if** $c_2 = -1$ and $\\mathbf{x}_D = 0$ **then** **return** $\\{ (q_1,\\pi) \\quad | \\quad q_1 \\in [0,2\\pi) \\}$\n",
    "\n",
    "6. Otherwise, let $q_2^{(1)} \\gets \\cos^{-1} c_2$ and $q_2^{(2)} \\gets -\\cos^{-1} c_2$.\n",
    "\n",
    "7. Compute $\\theta = atan2(x_y,x_x)$.\n",
    "\n",
    "8. **for** $k \\in \\{1,2\\}$ **do**\n",
    "\n",
    "9. &nbsp;&nbsp;&nbsp; $q_1^{(k)} = \\theta - atan2(L_2 \\sin q_2^{(k)}, L_1 + L_2 \\cos q_2^{(k)})$.\n",
    "\n",
    "10. **return** $\\{ (q_1^{(1)}, q_2^{(1)}), (q_1^{(2)}, q_2^{(2)}) \\}$.\n",
    "\n",
    "*******************\n",
    "\n",
    "Note that the implementation of this function in\n",
    "a programming language will need to handle the return value with some\n",
    "care; in particular, the return value in line 5 is an infinite set. A\n",
    "practical way of doing so would be to return some status flag indicating\n",
    "whether the result is finite or infinite."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "hAqiWur_1dBH"
   },
   "source": [
    "### RP manipulator\n",
    "\n",
    "As a second example, consider a manipulator with one revolute and one\n",
    "prismatic joint extending along the $x$ axis. If the reference position\n",
    "has both the revolute and prismatic joint at the origin, the\n",
    "configuration $(q_1,q_2)$ simply gives the polar coordinates of the\n",
    "second link. Suppose the end effector were specified with a distance\n",
    "$L_2$ from the origin on the $x$ axis.\n",
    "\n",
    "Then, if the polar coordinates of the target point $\\mathbf{x}_D$ are\n",
    "$(\\theta,d) \\equiv (atan2(x_y,x_x),\\|\\mathbf{x}_D\\|)$, then the two solutions\n",
    "are $\\mathbf{q}^{(1)} = (\\theta, d - L_2)$ and\n",
    "$\\mathbf{q}^{(2)} = (\\theta + \\pi, - d + L_2)$. \n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "A7C3nH-t0P0_"
   },
   "source": [
    "Analytical IK in 3D\n",
    "-------------------\n",
    "\n",
    "In 3D, either 3 or 6 DOF are required of the robot to achieve position\n",
    "or position+orientation task spaces, respectively. Here we shall cover a\n",
    "few simple cases, since more general cases may not have closed-form\n",
    "solutions."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "7l5ct5xC1hJc"
   },
   "source": [
    "### 3R manipulator\n",
    "\n",
    "We consider a 3R manipulator with the first joint rotating about the $z$\n",
    "axis, the second joint rotating about the $y$ axis with an offset of\n",
    "$L_1$ along the $z$ axis, and with both axes intersecting. The third\n",
    "joint is offset by a distance $L_2$ along the $x$ axis at the reference\n",
    "configuration, and rotates about the $y$ axis as well. The end effector\n",
    "is offset by a distance $L_3$ about the $x$ axis.\n",
    "\n",
    "With this definition the end effector's world coordinates are:"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "bPifkYs30P1B"
   },
   "source": [
    "$$\n",
    "\\begin{aligned}\n",
    "\\mathbf{x}(\\mathbf{q}) = & R_z(q_1) R_y(q_2) \\begin{bmatrix} L_2 + c_3 L_3 \\\\ 0 \\\\ -s_3 L_3 \\end{bmatrix}   \\\\\n",
    "= &R_z(q_1) \\begin{bmatrix}c_2 (L_2 + c_3 L_3) - s_2 s_3 L_3 \\\\ 0 \\\\ -s_2 (L_2 + c_3 L_3) - c_2 s_3 L_3 \\end{bmatrix} \n",
    "\\\\\n",
    "= & \\begin{bmatrix} c_1 (c_2 (L_2 + c_3 L_3) - s_2 s_3 L_3) \\\\ s_1 (c_2 (L_2 + c_3 L_3) - s_2 s_3 L_3) \\\\ L_1 - s_2 (L_2 + c_3 L_3) - c_2 s_3 L_3 \\end{bmatrix}. \\end{aligned}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "UtG8mryI0P1C"
   },
   "source": [
    "We wish to match this to the target\n",
    "$\\mathbf{x}_D = (x_D,y_D,z_D)$.\n",
    "\n",
    "************\n",
    "\n",
    "![fig:3RIK](https://github.com/krishauser/RoboticSystemsBook/blob/master/figures/modeling/ik_3R.png?raw=1)\n",
    "\n",
    "<div class=\"figcaption\"><a name=\"fig:3RIK\">Figure 3</a>. \n",
    "(a) Inverse kinematics for a 3R robot reaching a point in space. (b)\n",
    "The first joint angle is determined by the heading of the target point\n",
    "in the $x-y$ plane (up to an addition of $\\pi$). (c) The second and\n",
    "third angles are determined by rotating the frame of reference to the\n",
    "plane containing the target point and the $z$ axis, and determining\n",
    "solutions for the planar 2R IK problem in this plane. (Note that since\n",
    "$q_2$ and $q_3$ rotate about the $y$ axis, they are measured by the\n",
    "clockwise angle.)</div>\n",
    "\n",
    "************\n",
    "\n",
    "\n",
    "Imagine observing the robot along a plane orthogonal to the 2nd and 3rd\n",
    "joint axes. The rotated $x$ coordinate is the term\n",
    "$\\sqrt{x_D^2 + y_D^2}$, and the rotated $z$ coordinate remains the same,\n",
    "$z_D$. In this rotated system, we can use the planar 2R solution to\n",
    "calculate the possible values of $q_2$ and $q_3$. However, we should\n",
    "accommodate the fact that joints 2 and 3 rotate about the $y$ axis, and\n",
    "positive rotations about the $y$ axis causes a negative movement in $z$.\n",
    "Namely, we should compute all values of\n",
    "$$\n",
    "  (q_2,q_3) \\in 2RIK(L_2,L_3,(\\sqrt{x_D^2 + y_D^2},-z_D+L_1)).\n",
    "$$\n",
    "This contributes up to 2 solutions. For each of those solutions, the value\n",
    "$q_1 = atan2(y_D,x_D)$ orients the first joint in the proper direction.\n",
    "[Fig. 3](#fig:3RIK) illustrates these solutions.\n",
    "\n",
    "However, there is a small catch: we could have also modified $q_1$ by a\n",
    "factor of $\\pi$, giving a flipped coordinate system for the 2R solution\n",
    "where the robot \"reaches backwards\". As a result, there are 2 additional\n",
    "solutions:\n",
    "$$(q_2^\\prime,q_3^\\prime) \\in 2RIK(L_2,L_3,(-\\sqrt{x_D^2 + y_D^2},-z_D+L_1)).$$\n",
    "each associated with the value $q_1^\\prime = atan2(y_D,x_D) + \\pi$.\n",
    "Hence, altogether, up to 4 solutions exist."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "KrgZeU2S1mdw"
   },
   "source": [
    "### 2RP spherical manipulator\n",
    "\n",
    "For the 2RP robot [described in\n",
    "the last chapter](Kinematics.ipynb#Examples) we obtained the end effector point"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "87mYmFCL0P1D"
   },
   "source": [
    "$$\n",
    "\\mathbf{x}(\\mathbf{q}) = \\begin{bmatrix} c_1 c_2 q_3 \\\\ s_1 c_2 q_3 \\\\ -s_2 q_3 \\end{bmatrix}.\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "07bceLU60P1H"
   },
   "source": [
    "To match a target point $\\mathbf{x}_D = (x_D,y_D,z_D)$ we can observe that\n",
    "the norm $\\| \\mathbf{x}(\\mathbf{q}) \\|$ is simply $|q_3|$. It is very likely that\n",
    "only positive values of $q_3$ are valid joint values, and if so we can\n",
    "simply set $q_3 = \\| \\mathbf{x}_D \\|$.\n",
    "\n",
    "If $\\mathbf{x}_D = 0$, then we have a singularity in which any setting of\n",
    "$q_1$ and $q_2$ will satisfy the IK constraint. Otherwise, we solve the\n",
    "term $s_2 = z_D/\\|\\mathbf{x}_D\\|$ with $q_2 = \\sin^{-1}(z_D/\\|\\mathbf{x}_D\\|)$ and\n",
    "the alternative solution\n",
    "$q_2^\\prime = \\pi - \\sin^{-1}(z_D/\\|\\mathbf{x}_D\\|)$. Finally, we see the\n",
    "direction in $x-y$ plane is controlled by the first joint. So, $q_1$ can\n",
    "be solved with $atan2(y_D/c_2,x_D/c_2)$. The exception is if\n",
    "$x_D = y_D = 0$, in which any solution of $q_1$ works."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "rpKw_rO71qBn"
   },
   "source": [
    "### 3P3R manipulators (6-axis CNC) \n",
    "\n",
    "Consider a 6DOF gantry that which consists of a $x,y,z$ translation\n",
    "stage and then a rotation stage with a wrist about axes $z,y,z$, all\n",
    "three of which are collocated. Without loss of generality, let\n",
    "$(q_1,q_2,q_3)$ be properly offset to give the center of the wrist in\n",
    "world coordinates. Suppose the tool center point is at point\n",
    "$(x_W,y_W,z_W)$ in wrist coordinates. Typically, for drilling and other\n",
    "rotary operations we have $x_W=y_W$ so that $q_6$ can operate as the\n",
    "drilling degree of freedom.\n",
    "\n",
    "In this problem the target is not just to reach a single point\n",
    "$(x_D,y_D,z_D)$ in space, but also a desired tool orientation $R_D \\in$\n",
    "SO(3). Here, the target task coordinate $\\mathbf{x}_D$ contains both position\n",
    "and orientation and represents a 6D task space because the inherent\n",
    "dimensionality of SO(3) is 3.\n",
    "\n",
    "Since the only degrees of freedom that affect orientation are $q_4$,\n",
    "$q_5$, and $q_6$, we can solve for the ZYZ euler angles to achieve\n",
    "$R_D$. First, let us derive the forward kinematics:  "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "BV_Q3KHU0P1J"
   },
   "source": [
    "$$\\begin{aligned}\n",
    "R(q_4,q_5,q_6) &= R_z(q_4)R_y(q_5)R_z(q_6) \\\\\n",
    " & = \\left[\\begin{array}{ccc}\n",
    "   c_4 & -s_4 & 0\\\\\n",
    "   s_4 & c_4 & 0\\\\\n",
    "   0 & 0 & 1\n",
    "   \\end{array} \\right]\n",
    "   \\left[\\begin{array}{ccc}\n",
    "   c_5 & 0 & s_5\\\\\n",
    "   0 & 1 & 0\\\\\n",
    "   -s_5 & 0 & c_5\n",
    "   \\end{array} \\right]\n",
    "   \\left[\\begin{array}{ccc}\n",
    "   c_6 & -s_6 & 0\\\\\n",
    "   s_6 & c_6 & 0\\\\\n",
    "   0 & 0 & 1\n",
    "   \\end{array} \\right] \\\\\n",
    " & = \\left[\\begin{array}{ccc}\n",
    "   c_4 & -s_4 & 0\\\\\n",
    "   s_4 & c_4 & 0\\\\\n",
    "   0 & 0 & 1\n",
    "   \\end{array} \\right]\n",
    "   \\left[\\begin{array}{ccc}\n",
    "   c_5 c_6  & -c_5 s_6 & s_5 \\\\\n",
    "   s_6      & c_6 & 0\\\\\n",
    "   -s_5 c_6 & s_5 s_6 & c_5\n",
    "   \\end{array} \\right] \\\\\n",
    " &\n",
    "  = \\left[\\begin{array}{ccc}\n",
    "   c_4 c_5 c_6  -s_4 s_6  & -c_4 c_5 s_6 - s_4 c_6 & c_4 s_5 \\\\\n",
    "   s_4 c_5 c_6  +c_4 s_6  & -s_4 c_5 s_6 + c_4 s_6 & s_4 s_5 \\\\\n",
    "   -s_5 c_6 & s_5 s_6 & c_5\n",
    "   \\end{array} \\right].\n",
    "\\end{aligned}\n",
    "\\label{eq:ZYZEulerAngles}$$ "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "kiJM0LC30P1L"
   },
   "source": [
    "Let us denote\n",
    "$$R_D = \\left[\\begin{array}{ccc}\n",
    "r_{11} & r_{12} & r_{13} \\\\\n",
    "r_{21} & r_{22} & r_{23} \\\\\n",
    "r_{31} & r_{32} & r_{33} \n",
    "\\end{array}\n",
    "\\right].$$\n",
    "The simplest entry to solve is $r_{33} = c_5$, so\n",
    "$q_5 = \\pm \\cos^{-1}(r_{33})$. If $r_{33}$ is 1, then $q_5 = 0$ is a\n",
    "singularity and there are an infinite number of solutions for $q_4$ and\n",
    "$q_6$ that satisfy $q_4 + q_6 = atan2(r_{21},r_{11})$. Otherwise, we can\n",
    "calculate the two possible values $s_5 = \\sin q_5$ and determine\n",
    "$q_4 = atan2(r_{23},r_{13})$ and $q_6 = atan2(r_{32},-r_{31})$.\n",
    "\n",
    "Once these values are determined, it remains to be seen where to place\n",
    "the *wrist* so that the tool is at $(x_D,y_D,z_D)$. We know that\n",
    "$$\\mathbf{x}(\\mathbf{q}) = \\begin{bmatrix}q_1 \\\\ q_2 \\\\ q_3 \\end{bmatrix} + R(q_4,q_5,q_6)\\begin{bmatrix}x_W \\\\ y_W \\\\ z_W \\end{bmatrix}$$\n",
    "which should be equated to $(x_D,y_D,z_D)$. Since we know\n",
    "$R(q_4,q_5,q_6) = R_D$, we can compute the matrix-vector multiply and\n",
    "subtract from both sides to obtain\n",
    "$$\\begin{bmatrix}q_1 \\\\ q_2 \\\\ q_3 \\end{bmatrix} = \\begin{bmatrix}{x_D} \\\\ {y_D} \\\\ {z_D} \\end{bmatrix} - R_D\\begin{bmatrix}x_W \\\\ y_W \\\\ z_W \\end{bmatrix}.$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "irgvk85u1tiz"
   },
   "source": [
    "### 6R manipulators with orthogonal axes\n",
    "\n",
    "*************\n",
    "\n",
    "![fig:6RIK](figures/modeling/ik_6R.png)\n",
    "\n",
    "<div class=\"figcaption\"><a name=\"fig:6RIK\">Figure 4</a>\n",
    "(a) A 6DOF industrial robot with two shoulder DOFs, an elbow, and\n",
    "three wrist DOFs. The order of rotational axes from base to tip are\n",
    "ZYYXYX. The task space consists of both position and orientation. (b)\n",
    "The first step solves $q_1$, $q_2$, and $q_3$ by determining the wrist\n",
    "location and solving a 3R IK problem. (c) Then, the residual relative\n",
    "rotation between the end effector and \"forearm\" is solved using the\n",
    "solution to XYX Euler angles.</div>\n",
    "\n",
    "*************\n",
    "\n",
    "Most 6R industrial manipulators are structured so that there is one\n",
    "elbow joint, a shoulder with 2 orthogonal intersecting axes, and a wrist\n",
    "with 3 orthogonal intersecting axes. One such layout is shown in\n",
    "[Figure 4](#fig:6RIK)(a). Another possible layout is a shoulder with 3\n",
    "axes, and a wrist with 2 axes. But let us first consider how to address\n",
    "the former, and we leave deriving an analytical solution for the 3-axis\n",
    "shoulder, 2-axis wrist manipulator as an exercise.\n",
    "\n",
    "An end effector position for an industrial manipulator is also known as\n",
    "the *tool center point* . Since the origin of the last link's\n",
    "coordinates are inside its joint, the tool center point is defined by\n",
    "some local coordinates $\\mathbf{x}_6$ given its offset from the last link,\n",
    "which are measured or calibrated for any end effector attachment. From\n",
    "this information we define the world coordinates of the tool center\n",
    "point $$\\mathbf{x}_{tcp}(\\mathbf{q}) = T_6(\\mathbf{q})\\mathbf{x}_6$$ We wish to match\n",
    "$\\mathbf{x}_{tcp}$ with a desired position $\\mathbf{x}_D$ and the last link should\n",
    "have orientation $R_D$.\n",
    "\n",
    "The basic idea of the solution technique is that the wrist position can\n",
    "be first uniquely determined from this information. Specifically, we\n",
    "assume that we will eventually be able to solve the rotation\n",
    "$R_6(\\mathbf{q}) = R_D$. Then, the constraint equation becomes\n",
    "$$\\mathbf{x}_D = \\mathbf{x}_{tcp}(\\mathbf{q}) = R_6(\\mathbf{q}) \\mathbf{x}_6 + \\mathbf{t}_6(\\mathbf{q})$$\n",
    "Where $\\mathbf{t}_6(\\mathbf{q})$ is the wrist position. In other words,\n",
    "$\\mathbf{t}_6(\\mathbf{q}) = \\mathbf{x}_D - R_D \\mathbf{x}_6$.\n",
    "\n",
    "We then notice that the wrist position is only affected by the first\n",
    "three links: $q_1$, $q_2$, and $q_3$. In fact, this is simply a matter\n",
    "of solving a 3R IK problem with target $\\mathbf{x}_D - R_D \\mathbf{x}_6$! As\n",
    "before, we have up to 4 solutions for $(q_1,q_2,q_3)$.\n",
    "\n",
    "Now, once we have determined a set of these values, we can determine a\n",
    "rotation of the third link, $R_3(q_1,q_2,q_3)$. The remaining job for\n",
    "$q_4$, $q_5$, and $q_6$ is to rotate the rest of the way to $R_D$. Since\n",
    "all of the reference frames are oriented with the world frame, we need\n",
    "to satisfy\n",
    "$$\n",
    "  R_6(\\mathbf{q}) = R_3(q_1,q_2,q_3) R_x(q_4) R_y(q_5) R_x(q_6) = R_D.\n",
    "$$\n",
    "By\n",
    "premultiplying by $R_3(q_1,q_2,q_3)$, we obtain an XYX Euler angle\n",
    "conversion problem from the relative rotation matrix\n",
    "$R_3^{-1}(q_1,q_2,q_3)R_D$. This conversion is similar to the solution\n",
    "for the ZYZ Euler angle conversion problem described above, and has 2\n",
    "solutions (except at singularities).\n",
    "\n",
    "In all, since there are up to 4 solutions for $(q_1,q_2,q_3)$, and for\n",
    "each solution there are 2 solutions for $(q_4,q_5,q_6)$, there are a\n",
    "total of 8 solutions for $\\mathbf{q}$ (except at singularities). "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "0GKOmVTd0P1N"
   },
   "source": [
    "Finding all solutions for redundant and parallel robots\n",
    "-------------------------------------------------------\n",
    "\n",
    "In the case of redundant robots, we may wish to determine some\n",
    "representation of the entire IK solution set. This operation is also\n",
    "useful for determining the configuration space of parallel robots.\n",
    "\n",
    "<a id=\"self-motion-manifold\"></a>\n",
    "The set of solutions is known as the *self-motion manifold*, and\n",
    "instantaneous motions that preserve the task coordinate are known as\n",
    "*null-space motions*. A *manifold* is defined as a set that is locally\n",
    "homeomorphic to a disk in Cartesian space. We have already seen the\n",
    "topological spaces $R^n$, $S_2$, $SO(3)$ etc., which are also manifolds."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "d6mw614E12F-"
   },
   "source": [
    "### Redundant robots\n",
    "\n",
    "The $n-m$ degrees of freedom remaining in a redundant robot span the\n",
    "dimensions of the self-motion manifold. It is possible to choose $n-m$\n",
    "joints of the robot, say $q_1,\\ldots,q_{n-m}$, and fix them at certain\n",
    "values, and then solve an analytical IK problem to determine the\n",
    "solution for the remaining $m$ DOFs. The former values\n",
    "$q_1,\\ldots,q_{n-m}$ are known as the independent DOFs while the\n",
    "remainder are known as the dependent DOFs.\n",
    "\n",
    "The choice of independent DOFs is somewhat arbitrary, but is usually\n",
    "best chosen to lead to simple analytical IK solutions for the dependent\n",
    "DOFs. In any case, the independent joints *parameterize* the self-motion\n",
    "manifold. The main difficulty in expressing this solution space is to\n",
    "determine a suitable domain of the independent DOFs *such that an\n",
    "analytical solution exists* for the depending DOFs.\n",
    "\n",
    "As a very simple example, let us consider the planar 2R robot with a\n",
    "task where only the $x$ coordinate of its end effector is constrained to\n",
    "some value $x_D$.\n",
    "\n",
    "That is, we wish to determine the set of solutions to the constraint\n",
    "$$x_D = c_1(L_1 + c_2 L_2) - s_1 s_2 L_2  = c_1 L_1 + c_{12} L2$$\n",
    "$c_{12} = \\cos (q_1 + q_2)$ and with $x_D$ fixed at some value. Plotted\n",
    "in the plane $(q_1,q_2)$, the solution set is an ovoid-like 1D curve in\n",
    "2D space.  "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "cellView": "form",
    "code_folding": [
     0
    ],
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 295
    },
    "id": "ytJ-qR260P1O",
    "outputId": "9b29e6f1-e2e1-4680-866f-df3523c8c1eb"
   },
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 400x400 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "#@title Code for generating the distance to constraint figure\n",
    "import matplotlib\n",
    "L1 = 1\n",
    "L2 = 1\n",
    "xD = 1\n",
    "def distance(q1,q2):\n",
    "    c1 = np.cos(q1)\n",
    "    c12 = np.cos(q1+q2)\n",
    "    return L1*c1 + L2*c12 - xD\n",
    "plt.figure(figsize=(4,4))\n",
    "X,Y = np.meshgrid(np.linspace(-math.pi,math.pi,40),np.linspace(-math.pi,math.pi,40))\n",
    "plt.title('Distance to constraint')\n",
    "CS = plt.contour(X,Y,distance(X,Y),linewidths=[1,1,1,1,1,2,1,1,1],colors=('r','r','r','r','r','k','b','b','b'))\n",
    "plt.clabel(CS, inline=1, fontsize=10)\n",
    "plt.xlabel('q1')\n",
    "plt.ylabel('q2')\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "FKroamH10P1P"
   },
   "source": [
    "To characterize this set, we could choose $q_1$ as the independent DOF\n",
    "and then solve for $q_2$ analytically. Doing so, we find:\n",
    "$$\n",
    "  q_2 = \\pm \\cos^{-1}((x_D - c_1 L_1) / L_2) - q_1.\n",
    "$$\n",
    "The top of the\n",
    "manifold is given by the positive cosine term, while the bottom is the\n",
    "negative cosine term. Since the domain of $\\cos^{-1}$ is $[-1,1]$,\n",
    "solutions only exist for the range of $q_1$ such that\n",
    "$|x_D - c_1 L_1| \\leq  L_2$, or in other words,\n",
    "$(x_D - L_2)/L_1 \\leq c_1 \\leq (x_D + L_2) /L_1$.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "cellView": "form",
    "code_folding": [
     0
    ],
    "id": "3uMC33S50P1R",
    "outputId": "5f167611-d38d-4387-f6af-4c0c2016ac5b"
   },
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAXsAAAGJCAYAAABrZJMZAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjcuMSwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/bCgiHAAAACXBIWXMAAA9hAAAPYQGoP6dpAABPnklEQVR4nO3deXhM5//G8fdkm0QiQUUiBEkQOxF7VWwVSy2llLb2femXKkppUVrU1la1qK1FbbW11trVFg1S+07shMgmkfX8/ji/jKaxJDGTk8x8Xtc1VyaTmTl3RtyZnPOc59EpiqIghBDCrFlpHUAIIYTpSdkLIYQFkLIXQggLIGUvhBAWQMpeCCEsgJS9EEJYACl7IYSwAFL2QghhAaTshRDCAkjZC5ED7dmzB51Ox549e7J1u/Xr16d+/fovvZ9Op2PQoEGmDySMRsreQsXGxjJ79myaNGlC4cKFyZs3L35+fvz4448kJydrHS9X+Oqrr1i/fr3WMQRw5MgRBgwYgL+/P7a2tuh0Oq0j5ThS9hbqypUrfPjhhyiKwtChQ5k2bRpeXl4MGDCAHj16aB0vVzBl2derV4+4uDjq1atnkuc3N5s3b2b+/PnodDq8vb21jpMjSdlbKHd3d06ePMn27dsZPnw4ffv2Ze3atXTv3p1ffvmFS5cuaR0RgMePH2sdIVs9efKElJQUrKyssLe3x8pK/otmRP/+/YmMjCQ4OJg333xT6zg5kvwkmaH9+/dTvXp17O3t8fHxYe7cuYwbNy7Nn7YFCxakfPny6R779ttvA3D27NkXbuPatWvodDqmTZvGzJkzKV68OA4ODgQEBHDq1Kk09z1x4gTdunXD29sbe3t73N3d6dGjBw8fPkxzv9SMZ86c4b333iN//vzUrVs3S89x4cIFPvjgA1xcXHB1deWzzz5DURRu3LhB69atcXZ2xt3dnenTp6f73uLj4xk7diwlS5ZEr9fj6enJiBEjiI+PN9xHp9Px+PFjfv75Z3Q6HTqdjm7duhm+fuvWLXr06IGbmxt6vZ7y5cuzcOHCNNtJ3S+/YsUKxowZQ5EiRciTJw9RUVHp9tkvXrzYsJ3/Xv67j33p0qX4+/vj4OBAgQIF6NixIzdu3Ej3fc6bNw8fHx8cHByoUaMGf/3117P/sV9g2bJl+Pr6Ym9vj7+/P/v27TN8bffu3eh0OtatW5fucb/++is6nY5Dhw698PlPnz5Nw4YNcXBwoGjRokycOJGFCxei0+m4du2a4X5ubm44ODhkOr8lsdE6gDCukydP0qRJE1xdXRk3bhxJSUmMHTsWNze3DD3+7t27gPrLICN++eUXoqOjGThwIE+ePOHbb7+lYcOGnDx50rDN7du3c+XKFbp37467uzunT59m3rx5nD59msOHD6fbv9q+fXtKlSrFV199ReoM3Jl9jnfffZeyZcsyefJkNm3axMSJEylQoABz586lYcOGTJkyhWXLljFs2DCqV69u2F2SkpJCq1at2L9/P3369KFs2bKcPHmSmTNncuHCBcNumyVLltCrVy9q1KhBnz59APDx8QHg3r171KpVy3AQ09XVlS1bttCzZ0+ioqIYMmRImqwTJkzAzs6OYcOGER8fj52dXbrXuV69eixZsiTNbaGhoYwZM4ZChQoZbvvyyy/57LPP6NChA7169SIsLIxZs2ZRr149jh8/Tr58+QBYsGABffv2pU6dOgwZMoQrV67QqlUrChQogKenZ4b+7ffu3cvKlSv53//+h16v54cffqBp06YcOXKEChUqUL9+fTw9PVm2bJnhTUSqZcuW4ePjQ+3atZ/7/Hfv3qVBgwYkJSUxcuRIHB0dmTdvnpR6VinCrLRp00axt7dXQkNDDbedOXNGsba2Vl72zx0fH6+UK1dO8fLyUhITE19436tXryqA4uDgoNy8edNwe1BQkAIoH330keG22NjYdI9fvny5Aij79u0z3DZ27FgFUDp16pTu/pl9jj59+hhuS0pKUooWLarodDpl8uTJhtsfPXqkODg4KF27djXctmTJEsXKykr566+/0mxrzpw5CqAcOHDAcJujo2Oax6bq2bOnUrhwYeXBgwdpbu/YsaPi4uJi+F52796tAIq3t3e67y/1a7t37073/IqiKHFxcYq/v7/i4eGh3LlzR1EURbl27ZpibW2tfPnll2nue/LkScXGxsZwe0JCglKoUCGlSpUqSnx8vOF+8+bNUwAlICDgmdv8N0ABlODgYMNtoaGhir29vfL2228bbhs1apSi1+uViIgIw233799XbGxslLFjx75wG0OGDFEAJSgoKM1jXVxcFEC5evXqMx83cODAl/6sWyLZjWNGkpOT2bZtG23atKFYsWKG28uWLUtgYOBLHz9o0CDOnDnD999/j41Nxv7o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",
      "text/plain": [
       "<Figure size 400x400 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "#@title Code for generating the solution figure as a function of q1\n",
    "c1min = (xD - L2)/L1\n",
    "c1max = (xD + L2)/L1\n",
    "def q2_up(q1):\n",
    "    c1 = np.cos(q1)\n",
    "    return np.arccos((xD-c1*L1)/L2)-q1\n",
    "def q2_down(q1):\n",
    "    c1 = np.cos(q1)\n",
    "    return -np.arccos((xD-c1*L1)/L2)-q1\n",
    "plt.figure(figsize=(4,4))\n",
    "x = np.linspace(-np.arccos(c1min),np.arccos(c1min),50)\n",
    "plt.title('q2 parameterized by q1')\n",
    "plt.plot(x,q2_up(x),color='r')\n",
    "plt.plot(x,q2_down(x),color='g')\n",
    "plt.xlabel('q1')\n",
    "plt.ylabel('q2')\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "Au8XepYM0P1S"
   },
   "source": [
    "We note that the independent DOF could have also been chosen to be\n",
    "$q_2$. In this case, we must find a solution $q_1$ to\n",
    "$$\n",
    "  s_1 (- s_2 L_2) + c_1 (L_1 + c_2 L_2) - x_D = 0\n",
    "$$\n",
    "assuming the parenthesized terms are fixed. This type of equation\n",
    "$$a \\sin \\theta + b \\cos \\theta + c = 0$$\n",
    "has the general solution:\n",
    "$$\\theta = \\pm \\cos^{-1} \\frac{c}{\\sqrt{a^2+b^2}} + atan2(a,b).$$\n",
    "Hence, replacing this in the above equation, we get the solution for $q_1$:\n",
    "$$q_1 = \\pm \\cos^{-1}\\frac{-x_D}{\\sqrt{L_1^2 + L_2^2 + 2 c_2 L_1 L_2}} + atan2(- s_2 L_2, L_1 + c_2 L_2).$$\n",
    "The inverse cosine only has a solution when\n",
    "$x_D^2 \\leq L_1^2 + L_2^2 + 2 c_2 L_1 L_2$, or in other words,\n",
    "$c_2 \\geq (x_D^2 - L_1^2 - L_2^2)/(2 L_1 L_2)$.\n",
    "\n",
    "In more complex cases, particularly with $n-m \\geq 2$, the domain of\n",
    "valid independent DOFs becomes more geometrically complex and difficult\n",
    "to characterize.\n",
    "\n",
    "### Parallel robots\n",
    "\n",
    "To define the configuration space of parallel mechanisms, it is useful\n",
    "to first define an open, possibly branched chain by first imagining\n",
    "certain loop closure constraints as being broken, and then treating the\n",
    "broken constraints as IK tasks. Then, $n-m$ of the open DOFs may be\n",
    "represented as independent DOFs while the remaining $m$ are treated as\n",
    "dependent DOFs.\n",
    "\n",
    "Some of the joints of the mechanism will be independently *actuated*. It\n",
    "is convenient to choose a convention of independent vs dependent DOFs\n",
    "matching the actuated joints, which are also known as *active* joints,\n",
    "vs non-actuated joints, which are also known as *passive* joints. It is\n",
    "also prudent to design joint stops so that singularities of the passive\n",
    "chain are never reached, because otherwise the mechanism may \"lock up\"\n",
    "or exhibit non-deterministic behavior as singularities are reached."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "VY5DDREd0P1T"
   },
   "source": [
    "The Jacobian matrix\n",
    "-------------------\n",
    "\n",
    "The Jacobian matrix is a fundamental concept in robotics that relates\n",
    "joint velocities to task space velocities. It also has uses in\n",
    "estimating the effects of joint positioning errors in terms of workspace\n",
    "accuracy, as well as in numerical IK methods."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "4QpgoX6w15l0"
   },
   "source": [
    "### Partial derivative review\n",
    "\n",
    "The Jacobian uses the concept of partial derivatives, which is a\n",
    "generalization of the standard derivative to functions with multiple\n",
    "arguments. This section gives a short introduction to partial\n",
    "derivatives. More information can be found in [Appendix A.2](Calculus.ipynb).\n",
    "\n",
    "Given a two-argument function $f(x,y)$, the partial derivative with\n",
    "respect to $x$, evaluated at $(x,y)$ is denoted\n",
    "$\\frac{\\partial f}{\\partial x}(x,y)$. It is defined like the normal\n",
    "derivative, but keeping $y$ constant:\n",
    "$$\\frac{\\partial f}{\\partial x}(x,y) = \\lim_{\\Delta x \\rightarrow 0} \\frac{f(x+\\Delta x,y) - f(x,y)}{\\Delta x}.$$\n",
    "\n",
    "This can also be thought of as defining an auxiliary function, keeping\n",
    "$y$ constant, and taking the derivative of that:\n",
    "$$\n",
    "  \\frac{\\partial f}{\\partial x}(x,y) = \\frac{d}{dx} g_y(x)\n",
    "$$\n",
    "where $g_y(x)$ is defined as:\n",
    "$$\n",
    "  g_y(x) \\equiv f(x,y)\n",
    "$$\n",
    "\n",
    "Similarly we can take the partial derivative with respect to $y$:\n",
    "$$\n",
    "  \\frac{\\partial f}{\\partial y}(x,y) = \\lim_{\\Delta y \\rightarrow 0} \\frac{f(x,y+\\Delta y) - f(x,y)}{\\Delta y} = \\frac{d}{dy}h_x(y)\n",
    "$$\n",
    "where $h_x(y) \\equiv f(x,y)$.\n",
    "\n",
    "In general, the partial derivative of a multi-argument function with\n",
    "respect to some argument is calculated by *treating the remaining\n",
    "arguments as constant* and simply calculating the regular derivative.\n",
    "The differential $\\frac{\\partial f}{\\partial x}$ is the function\n",
    "obtained by partial differentiation of $f$ treating all other arguments\n",
    "as constants.\n",
    "\n",
    "Most of the standard derivative rules apply to partial derivatives:\n",
    "\n",
    "-   Additive:\n",
    "    $\\frac{\\partial (f+g)}{\\partial x}(x,y) = \\frac{\\partial f}{\\partial x}(x,y) + \\frac{\\partial g}{\\partial x}(x,y)$\n",
    "\n",
    "-   Scalar multiplication:\n",
    "    $\\frac{\\partial (cf)}{\\partial x}(x,y) = c \\frac{\\partial f}{\\partial x}(x,y)$\n",
    "\n",
    "-   Multiplicative:\n",
    "    $\\frac{\\partial (f(x,y)g(x,y))}{\\partial x} = \\frac{\\partial f(x,y)}{\\partial x} g(x,y) + \\frac{\\partial g(x,y)}{\\partial x}f(x,y)$\n",
    "\n",
    "There are also generalizations of the chain rule:\n",
    "\n",
    "-   If $h(x,y) = f(g(x,y))$, then\n",
    "    $\\frac{\\partial h(x,y)}{\\partial x} = f^\\prime(g(x,y)) \\frac{\\partial g(x,y)}{\\partial x}$\n",
    "\n",
    "-   If $h(x,y) = f(g(x),y)$, then\n",
    "    $\\frac{\\partial h(x,y)}{\\partial x} = \\frac{\\partial f(g(x),y)}{d g} g^\\prime(x)$\n",
    "\n",
    "Also if a function is not dependent on some variable, then its partial\n",
    "derivative with respect to that variable is nil:\n",
    "$$\\frac{\\partial f(y)}{\\partial x} = 0$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "N7TBAxU817mQ"
   },
   "source": [
    "### Jacobian definition\n",
    "\n",
    "The Jacobian of an arbitrary vector function $\\mathbf{x} = f(\\mathbf{q})$, with\n",
    "$f: \\mathbb{R}^n \\rightarrow \\mathbb{R}^m$ is given as the following\n",
    "*matrix of partial derivatives*:"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "4jlH0R5b0P1T"
   },
   "source": [
    "$$J(\\mathbf{q}) \\equiv \\frac{\\partial f(\\mathbf{q})}{\\partial \\mathbf{x}} \\equiv \\begin{bmatrix}\n",
    "\\frac{\\partial f_1(\\mathbf{q})}{\\partial q_1} & \\cdots & \\frac{\\partial f_1(\\mathbf{q})}{\\partial q_n} \\\\\n",
    "\\vdots & \\ddots & \\vdots \\\\\n",
    "\\frac{\\partial f_m(\\mathbf{q})}{\\partial q_1} & \\cdots & \\frac{\\partial f_m(\\mathbf{q})}{\\partial q_n} \n",
    "\\end{bmatrix}$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "adH-7iJK0P1U"
   },
   "source": [
    "where $f$'s component functions are given by the individual $f_i$'s:\n",
    "\n",
    "$$f(\\mathbf{q}) \\equiv \\begin{bmatrix} f_1(\\mathbf{q}) \\\\ \\vdots \\\\ f_m(\\mathbf{q}) \\end{bmatrix}.$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "StLJ7z2w0P1U"
   },
   "source": [
    "Observe that each of the rows of the Jacobian correspond to each of the\n",
    "component functions, and each column corresponds to derivatives of a\n",
    "single joint coordinate. It is also important to note that the Jacobian\n",
    "is dependent on the configuration.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "RDTb4xne2ABP"
   },
   "source": [
    "#### Single joint example\n",
    "\n",
    "As an example, let us consider a single joint planar robot with its\n",
    "joint at the origin, and an end effector at $L_1$ distance away from the\n",
    "origin. The world coordinates of the end effector are:\n",
    "$$\\mathbf{x}(\\mathbf{q}) = \\begin{bmatrix}{L_1 \\cos q_1} \\\\ {L_1 \\sin q_1} \\end{bmatrix}.$$ \n",
    "\n",
    "The Jacobian\n",
    "of this point is a $2\\times 1$ matrix obtained by taking the derivative\n",
    "with respect to each of the joint coordinates, which is just $q_1$ in\n",
    "this case.\n",
    "$$J(\\mathbf{q}) \\equiv \\frac{\\partial \\mathbf{x}}{\\partial \\mathbf{q}}(\\mathbf{q}) = \\begin{bmatrix}{\\partial (L_1 \\cos q_1) / \\partial q_1} \\\\ {\\partial (L_1 \\sin q_1) / \\partial q_1} \\end{bmatrix} = \\begin{bmatrix}{-L_1 \\sin q_1} \\\\ {L_1 \\cos q_1} \\end{bmatrix}.$$\n",
    "\n",
    "\n",
    "Note that this is perpendicular to the direction from the joint to the\n",
    "end effector, with the same magnitude.\n",
    "\n",
    "The significance of the Jacobian in this case is that *it gives the\n",
    "instantaneous velocity of the point* $\\mathbf{x}$, in world coordinates, as\n",
    "$q_1$ rotates at 1 rad/s. If $q_1$ rotates at another velocity\n",
    "$\\dot{q}_1$ (the dot denotes time derivative), then the end effector\n",
    "velocity is given by: $$\\dot{\\mathbf{x}} = J(\\mathbf{q}) \\dot{q}_1.$$ This holds\n",
    "as a consequence of the chain rule. Note that this equation only holds\n",
    "in the 1 joint case; let us now discuss a more general case."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "PZKocZ-L2B-0"
   },
   "source": [
    "#### Two joint example\n",
    "\n",
    "Now consider the two joint planar arm [described above](#2R-manipulator). The end effector has world position\n",
    "$$\\mathbf{x}(\\mathbf{q}) = \\begin{bmatrix}{c_1(L_1 + c_2 L_2) - s_1 s_2 L_2} \\\\ {s_1(L_1 + c_2 L_2) + c_1 s_2 L_2} \\end{bmatrix}.$$\n",
    "The first column of the Jacobian is the partial derivative with respect\n",
    "to $q_1$, keeping $q_2$ constant:\n",
    "$$\\frac{\\partial \\mathbf{x}}{\\partial q_1}(\\mathbf{q}) = \\begin{bmatrix}{-s_1(L_1 + c_2 L_2) - c_1 s_2 L_2} \\\\ {c_1(L_1 + c_2 L_2) - s_1 s_2 L_2} \\end{bmatrix}.$$\n",
    "The second column is the partial derivative with respect to $q_2$,\n",
    "keeping $q_1$ constant:\n",
    "$$\\frac{\\partial \\mathbf{x}}{\\partial q_2}(\\mathbf{q}) = \\begin{bmatrix}{-c_1 s_2 L_2 - s_1 c_2 L_2} \\\\ {- s_1 s_2 L_2 + c_1 c_2 L_2} \\end{bmatrix}.$$\n",
    "Overall, the Jacobian matrix is a $2\\times 2$ matrix as follows:\n",
    "$$J(\\mathbf{q}) = \\begin{bmatrix}{-s_1(L_1 + c_2 L_2) - c_1 s_2 L_2} & {- c_1 s_2 L_2 - s_1 c_2 L_2} \\\\ {c_1(L_1 + c_2 L_2) - s_1 s_2 L_2} & {-s_1 s_2 L_2 + c_1 c_2 L_2} \\end{bmatrix}.$$\n",
    "Observe that the first column is simply a vector perpendicular to\n",
    "$\\mathbf{x}$ with the same magnitude. The second column is a bit more\n",
    "challenging to interpret, but with a bit of scrutiny it can be seen as a\n",
    "vector perpendicular and with the same magnitude as the displacement\n",
    "vector from the second joint position to $\\mathbf{x}$.\n",
    "\n",
    "This means that if $q_1$ were to rotate at velocity $\\dot{q}_1$ while\n",
    "$q_2$ is held constant, then the end effector would have instantaneous\n",
    "velocity: $$\\dot{q}_1 \\frac{\\partial \\mathbf{x}}{\\partial q_1}(\\mathbf{q}).$$\n",
    "Likewise, if $q_2$ were to rotate at velocity $\\dot{q}_2$, and $q_1$\n",
    "were to be held constant, then the velocity would be:\n",
    "$$\n",
    "  \\dot{q}_2 \\frac{\\partial \\mathbf{x}}{\\partial q_2}(\\mathbf{q}).\n",
    "$$\n",
    "If both were\n",
    "to rotate simultaneously, then the velocity would be\n",
    "$$\n",
    "  \\dot{\\mathbf{x}}(\\mathbf{q}) = \\dot{q}_1 \\frac{\\partial \\mathbf{x}}{\\partial q_1}(\\mathbf{q}) + \\dot{q}_2 \\frac{\\partial \\mathbf{x}}{\\partial q_2}(\\mathbf{q}) = J(\\mathbf{q})\\dot{\\mathbf{q}}.\n",
    "$$\n",
    "[Fig. 6](#fig:Jacobian2R) illustrates this concept. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "Hm2nNmqQ0P1X"
   },
   "source": [
    "\n",
    "************\n",
    "\n",
    "![fig:Jacobian2R](https://github.com/krishauser/RoboticSystemsBook/blob/master/figures/modeling/jacobian_2R.png?raw=1)\n",
    "\n",
    "<div class=\"figcaption\"><a name=\"fig:Jacobian2R\">Figure 5</a>.\n",
    "The Jacobian relates joint space velocities to Cartesian velocities.\n",
    "The first column of the Jacobian gives the velocity at which the end\n",
    "effector would move if the first joint moves at unit speed, and the\n",
    "second column gives its velocity if the second joint moves at unit\n",
    "velocity. The linear combination of Jacobian columns, weighted by joint\n",
    "speed, gives the overall Cartesian velocity.</div>\n",
    "\n",
    "************\n",
    "\n",
    "\n",
    "### Formula for arbitrary branched robots\n",
    "\n",
    "In general, using the forward kinematics formula given in Chapter 4:\n",
    "$$T_i(\\mathbf{q}) = T_{p[i]}(\\mathbf{q}) T_{i\\rightarrow p[i]}^{ref} L_{z_i,\\mathbf{a}_i}(q_i)$$\n",
    "we can derive the Jacobian of an end effector point on any link $n$. Let\n",
    "$A(n)$ denote the set of *ancestors* of link $n$, that is, $n$, its\n",
    "parent, its parent's parent, and so on down to the root. Let the task\n",
    "space $\\mathbf{x} = f(\\mathbf{q})$ be given by the position of an end effector on\n",
    "the $n$'th link, and $\\mathbf{x}_n$ are its local coordinates.\n",
    "\n",
    "If $j \\notin A(n)$, then joint $j$ does not affect the end effector. In\n",
    "this case, the $j$'th column of the Jacobian is zero.\n",
    "\n",
    "Otherwise, the $j$'th column of the Jacobian is given by:\n",
    "$$\\frac{\\partial f}{\\partial q_j}(\\mathbf{q}) = T_{p[j]}(\\mathbf{q}) T_{j\\rightarrow p[j]}^{ref} \\frac{d L_{z_j,\\mathbf{a}_j}}{d q_j}(q_j) T_{n\\rightarrow j}(\\mathbf{q}) \\mathbf{x}_n$$\n",
    "where $T_{n\\rightarrow j}(\\mathbf{q}) = T_j^{-1}(\\mathbf{q}) T_n(\\mathbf{q})$ is the\n",
    "transform from local coordinates on link $n$ to local coordinates on\n",
    "link $j$, at configuration $\\mathbf{q}$. Note that\n",
    "$T_{n\\rightarrow j}(\\mathbf{q})$ only depends on the joint angles of $j$'s\n",
    "descendants, not including $j$.\n",
    "\n",
    "#### Planar robots\n",
    "\n",
    "For 2D revolute joints, we have no joint type nor axis, so the local\n",
    "transform is given as: $$L_{z,\\mathbf{a}}(q) \\equiv R(q) = \n",
    "\\left[\\begin{array}{ccc}\n",
    "\\cos q & -\\sin q & 0 \\\\\n",
    "\\sin q & \\cos q & 0 \\\\\n",
    "0 & 0 & 1\n",
    "\\end{array}\\right]$$ in homogeneous coordinates, and hence the matrix\n",
    "derivative is given by $$\\frac{d}{dq} R(q) = \n",
    "\\left[\\begin{array}{ccc}\n",
    "-\\sin q & -\\cos q & 0 \\\\\n",
    "\\cos q & -\\sin q & 0 \\\\\n",
    "0 & 0 & 0\n",
    "\\end{array}\\right].$$ (Note that the bottom left entry dropped from 1 to\n",
    "0, indicating that the derivative of a position quantity is a\n",
    "directional quantity).\n",
    "\n",
    "A more compact expression of this derivative is as follows:\n",
    "$$\\frac{d}{dq} R(q) = R(q)\n",
    "\\left[\\begin{array}{ccc}\n",
    "0 & -1 & 0 \\\\\n",
    "1 & 0 & 0 \\\\\n",
    "0 & 0 & 0 \n",
    "\\end{array}\\right]\n",
    "$$\n",
    "and hence we obtain the compact expression for the Jacobian\n",
    "$$\\frac{\\partial f}{\\partial q_j}(\\mathbf{q}) = T_j(\\mathbf{q})\n",
    "\\left[\\begin{array}{ccc}\n",
    "0 & -1 & 0 \\\\\n",
    "1 & 0 & 0 \\\\\n",
    "0 & 0 & 0 \n",
    "\\end{array}\\right]\n",
    "T_{n\\rightarrow j}(\\mathbf{q}) \\mathbf{x}_n.$$\n",
    "This shows that the Jacobian column corresponding to a revolute joint is perpendicular to the vector from\n",
    "the joint to the end effector (rotated $90^\\circ$ CCW).\n",
    "[Fig. 6](#fig:Jacobian3R) illustrates this principle.\n",
    "\n",
    "\n",
    "*************\n",
    "\n",
    "![fig:Jacobian3R](https://github.com/krishauser/RoboticSystemsBook/blob/master/figures/modeling/jacobian_3R.png?raw=1)\n",
    "\n",
    "<div class=\"figcaption\"><a name=\"fig:Jacobian3R\">Figure 6</a>.\n",
    "The Jacobian of a planar 3R robot. Its columns are determined by\n",
    "taking the perpendicular vector to the displacement vector from the\n",
    "joint center to the end effector. The Jacobian is different for\n",
    "different configurations (a) and (b).\n",
    "</div>\n",
    "\n",
    "*************\n",
    "\n",
    "For a prismatic joint, we have a local transform: $$L_{z,\\mathbf{a}}(q) = \n",
    "\\left[\\begin{array}{ccc}\n",
    "1 & 0 & a_x q \\\\\n",
    "0 & 1 & a_y q \\\\\n",
    "0 & 0 & 1\n",
    "\\end{array}\\right]$$ and hence the derivative is\n",
    "$$\\frac{d}{dq} L_{z,\\mathbf{a}}(q) = \n",
    "\\left[\\begin{array}{ccc}\n",
    "0 & 0 & a_x \\\\\n",
    "0 & 0 & a_y \\\\\n",
    "0 & 0 & 0\n",
    "\\end{array}\\right].$$\n",
    "\n",
    "Since this matrix wipes out the $x$ and $y$ coordinates of whatever\n",
    "homogeneous point it multiplies and replaces it with $(a_x,a_y,0)$, we\n",
    "can express the Jacobian column with the simplified expression\n",
    "$$\\frac{\\partial f}{\\partial q_j}(\\mathbf{q}) = T_j(\\mathbf{q}) \\begin{bmatrix}a_{j,x} \\\\ a_{j,y} \\\\ 0\\end{bmatrix}.$$ "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "LNTevkp_0P1Z"
   },
   "source": [
    "Note that since the homogeneous coordinate is 0, the translation of the\n",
    "transform $T_j$ does not affect the result, and hence the Jacobian\n",
    "column is simply the world direction of the joint axis $\\mathbf{a}_j$."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "38INzv4v2IT2"
   },
   "source": [
    "### 3D robots\n",
    "\n",
    "For 3D revolute joints, the local transform is given by an axis-angle\n",
    "rotation:\n",
    "$$\n",
    "  L_{z,\\mathbf{a}}(q) \\equiv R_{aa}(\\mathbf{a},q)\n",
    "$$\n",
    "The velocity of a point $X$ being rotated along with the rotation frame at unit velocity\n",
    "$\\dot{q}$ is given by its cross product with the rotation axis:\n",
    "$$\n",
    "  \\frac{d}{dt} \\mathbf{x} = \\mathbf{a} \\times \\mathbf{x}.\n",
    "$$\n",
    "Here $\\mathbf{x}$ is the post-rotation coordinates of the point. Since multiplication with a\n",
    "rotation matrix $R_{aa}(\\mathbf{a},q)$ converts pre-rotation coordinates to\n",
    "post-rotation coordinates, the angular velocity of a point given with\n",
    "pre-rotation coordinates $\\mathbf{x}_L$ is given by\n",
    "$$\n",
    "  \\frac{d}{dt} \\mathbf{x} = \\mathbf{a} \\times R_{aa}(\\mathbf{a},q) \\mathbf{x}_L.\n",
    "$$\n",
    "Since the cross product axis and the rotation axis are the same, Rodrigues'\n",
    "formula can be used to switch the order of the cross product:\n",
    "$$\n",
    "  \\mathbf{a} \\times (R_{aa}(\\mathbf{a},q) \\mathbf{x}_L) =  R_{aa}(\\mathbf{a},q) (\\mathbf{a} \\times \\mathbf{x}_L).\n",
    "$$\n",
    "Finally, using the skew-symmetric product notation $\\hat{\\cdot}$ used in\n",
    "Chapter 2 we obtain\n",
    "$$\n",
    "  \\frac{d}{dt} R_{aa}(\\mathbf{a},q) \\mathbf{x}_L = R_{aa}(\\mathbf{a},q) \\hat{\\mathbf{a}} \\mathbf{x}_L\n",
    "$$\n",
    "and since this holds for all $\\mathbf{x}_L$, we see that\n",
    "$$\n",
    "  \\frac{d}{dt} R_{aa}(\\mathbf{a},q) = R_{aa}(\\mathbf{a},q) \\hat{\\mathbf{a}}.\n",
    "$$\n",
    "Replacing this in the Jacobian expression and converting to homogeneous\n",
    "coordinates, we obtain the simplified expression:\n",
    "\n",
    "\\begin{equation}\n",
    "\\frac{\\partial f}{\\partial q_j}(\\mathbf{q}) = T_j(\\mathbf{q})\n",
    "\\left[\\begin{array}{c|c}\n",
    "\\hat{\\mathbf{a}} & 0  \\\\\n",
    "\\hline\n",
    "0 & 0  \n",
    "\\end{array}\\right]\n",
    "T_{n\\rightarrow j}(\\mathbf{q}) \\mathbf{x}_n.\n",
    "\\label{eq:JacobianRevolute3D}\n",
    "\\end{equation}\n",
    "\n",
    "Another way to interpret this is that\n",
    "the $j$'th column of the Jacobian is the cross-product between the axis\n",
    "of joint $j$ and the vector pointing from joint $j$ to the end effector\n",
    "(both given in world coordinates). To see this, note that the axis in\n",
    "world coordinates is $R_j\\mathbf{a} = T_j \\begin{bmatrix} \\mathbf{a} \\\\ 0 \\end{bmatrix}$ and the\n",
    "displacement vector is $T_n \\mathbf{x}_n - \\mathbf{t}_j$. Here, $R_j$ is the\n",
    "orientation of link $j$, $\\mathbf{t}_j$ is its origin, we have implicitly\n",
    "assumed dependence on $\\mathbf{q}$, and we slightly abuse notation to convert\n",
    "freely between homogeneous and standard coordinates. The displacement\n",
    "vector could also be expressed as\n",
    "$R_j T_{n\\rightarrow j} \\mathbf{x}_n + \\mathbf{t}_j - \\mathbf{t}_j = R_j T_{n\\rightarrow j} \\mathbf{x}_n$.\n",
    "\n",
    "Hence, by the distributive property of the cross-product,\n",
    "$$R_j\\mathbf{a} \\times R_j T_{n\\rightarrow j} \\mathbf{x}_n = R_j (\\mathbf{a} \\times T_{n\\rightarrow j} \\mathbf{x}_n) = R_j \\hat{\\mathbf{a}} T_{n \\rightarrow j} \\mathbf{x}_n$$\n",
    "which is equivalent to $\\eqref{eq:JacobianRevolute3D}$.\n",
    "\n",
    "For prismatic joints, a derivation similar to the planar case gives the\n",
    "simplified expression:\n",
    "$$\\frac{\\partial f}{\\partial q_j}(\\mathbf{q}) = T_j(\\mathbf{q}) \\begin{bmatrix}\\mathbf{a}_j \\\\ \\hline 0 \\end{bmatrix}.$$\n",
    "Similar derivations exist for helical and other exotic joint types."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "o9DVlHbR3cEB"
   },
   "source": [
    "#### Orientation jacobians\n",
    "\n",
    "For task spaces that include orientation components, the Jacobian of the\n",
    "orientation components can also be computed in a straightforward manner.\n",
    "The orientation Jacobian $J_\\theta$ converts joint velocities into the\n",
    "angular velocity of the link containing the end effector. In 2D, angular\n",
    "velocity is simply a scalar and hence $J_\\theta$ is a $1\\times n$\n",
    "matrix. In 3D, angular velocity is a 3D vector, and hence $J_\\theta$ is\n",
    "a $3 \\times n$ matrix.\n",
    "\n",
    "First, any prismatic joints do not affect orientation, and hence the\n",
    "columns of the orientation Jacobian corresponding to such joints are\n",
    "zero.\n",
    "\n",
    "For revolute joints in 2D, each joint affects the orientation of the end\n",
    "effector equally. Hence, each column of $J_\\theta$ corresponding to a\n",
    "revolute joint is 1.\n",
    "\n",
    "In 3D, an angular velocity vector is a vector $\\boldsymbol{\\omega}$ such that for\n",
    "any point $\\mathbf{x}$ expressed in world coordinates but attached to link\n",
    "$n$, its instantaneous velocity will be:\n",
    "$$\\boldsymbol{\\omega}\\times (\\mathbf{x} - \\mathbf{t}_n) + \\dot{\\mathbf{t}}_n$$\n",
    "where $\\mathbf{t}_n$ is the origin of link $n$. Hence, the angular velocity at the end\n",
    "effector is simply the angular velocity of link $n$. The angular\n",
    "velocity of each revolute joint are summed to obtain the angular\n",
    "velocity of the end effector:\n",
    "$$\\boldsymbol{\\omega} = \\sum_{j\\text{ is revolute}} J_{\\theta,j}(\\mathbf{q})\\dot{q}_j$$\n",
    "Hence the $j$'th column of the Jacobian is:\n",
    "$$J_{\\theta,j}(\\mathbf{q}) = T_j(\\mathbf{q}) \\begin{bmatrix}\\mathbf{a}_j \\\\ \\hline 0 \\end{bmatrix}$$\n",
    "where the multiplication orients the local axis to the world coordinate frame.\n",
    "\n",
    "It is important to note that $\\boldsymbol{\\omega}$ is usually not the derivative\n",
    "of a given rotation representation, like Euler angles. Instead, it is\n",
    "that an additional transformation is typically necessary to obtain the\n",
    "derivative of the orientation representation used in the task coordinate\n",
    "$\\mathbf{x}$."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "eb_gURhJ2hVv"
   },
   "source": [
    "### Significance and interpretation"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "BTxbmexe2jWa"
   },
   "source": [
    "#### Relating joint and task velocities\n",
    "\n",
    "The general formula relating joint space velocities to task space\n",
    "velocities is: $$\\dot{\\mathbf{x}} = J(\\mathbf{q}) \\dot{\\mathbf{q}}$$ where $J$ is the\n",
    "Jacobian of the task space map. In other words, the $i$'th column of $J$\n",
    "gives the velocity at which the end effector would move if the $i$'th\n",
    "joint were to move at unit velocity."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "GYydJ2NN2lCy"
   },
   "source": [
    "#### As a Taylor expansion\n",
    "\n",
    "Another interpretation of the Jacobian is as an $n$-dimensional analogue\n",
    "of Taylor expansion. Recall that the 1st order Taylor expansion of a\n",
    "normal 1-D, differentiable function is the linear approximation:\n",
    "$$f(x + \\Delta x) = f(x) + f^\\prime(x)\\cdot \\Delta x + O(\\Delta x^2)$$\n",
    "where $O(h^2)$ denotes a term smaller than a constant times $h^2$ as $h$\n",
    "decreases asymptotically to 0. This means that a function is\n",
    "increasingly better approximated with the line\n",
    "$y = f(x) + \\Delta x f^\\prime(x)$ as $\\Delta x$ shrinks toward 0.\n",
    "\n",
    "The Jacobian appears in the $n$-dimensional Taylor expansion of a\n",
    "multidimensional differentiable function:\n",
    "$$f(\\mathbf{x} + \\Delta \\mathbf{x}) = f(\\mathbf{x}) + J(\\mathbf{x}) \\Delta \\mathbf{x} + O(\\|\\Delta \\mathbf{x}\\|^2).$$\n",
    "This states that an arbitrary function is well-approximated as a\n",
    "hyperplane $$\\mathbf{y} = f(\\mathbf{x}) + J(\\mathbf{x}) \\Delta \\mathbf{x}$$ as\n",
    "$\\Delta \\mathbf{x}$ shrinks toward 0.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "C1nq96lb2Mkp"
   },
   "source": [
    "#### Use in error propagation\n",
    "\n",
    "Another important use of the Jacobian is in error propagation. Suppose\n",
    "that at a robot has configuration $\\mathbf{q}$ but with a joint space error\n",
    "$\\boldsymbol{\\epsilon}$. Then the task-space error\n",
    "$$\n",
    "  f(\\mathbf{q}+\\boldsymbol{\\epsilon}) - f(\\mathbf{q})\n",
    "$$\n",
    "is approximated by the Taylor\n",
    "expansion\n",
    "$$\n",
    "  f(\\mathbf{q}+\\boldsymbol{\\epsilon}) - f(\\mathbf{q}) \\approx J(\\mathbf{q}) \\boldsymbol{\\epsilon}\n",
    "$$\n",
    "if $\\epsilon$ is small. In terms of absolute magnitude, the task space\n",
    "error is $\\| J(\\mathbf{q}) \\boldsymbol{\\epsilon}\\|$. We can also bound the error:\n",
    "$$\n",
    "  \\| J(\\mathbf{q}) \\boldsymbol{\\epsilon}\\| \\leq \\sum_{i=1}^n |\\epsilon_{i}| \\|J_i(\\mathbf{q})\\|\n",
    "$$\n",
    "where $J_i$ is the $i$'th column of the Jacobian. As a result if joint\n",
    "$i$ had an error, the norm of $J_i$ approximates the corresponding error\n",
    "in task space.\n",
    "\n",
    "In general, in $n$R planar robots, the $i$'th column of the Jacobian is\n",
    "simply the vector from the $i$'th joint to the end effector, rotated by\n",
    "$90^\\circ$ CCW. This has the significance that if the end effector is\n",
    "farther from revolute joint $i$ than joint $j$, then the magnitude of\n",
    "the $i$'th column is greater than the magnitude of the $j$'th column.\n",
    "Usually, this means that errors and movements of joints close to the\n",
    "robot's base have a larger effect than joints closer to the end\n",
    "effector.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "mcq_tNvB2OCT"
   },
   "source": [
    "### Manipulability and singularity identification\n",
    "\n",
    "TODO\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "_-8bqVXH2Pjw"
   },
   "source": [
    "### Null-space motion computation\n",
    "\n",
    "TODO "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "xV57-a8O0P1b"
   },
   "source": [
    "\n",
    "Numerical IK\n",
    "------------\n",
    "\n",
    "Numerical IK methods are highly general techniques that can accommodate\n",
    "arbitrary robot mechanisms and task spaces, without any need for\n",
    "mechanism-specific mathematics besides forward kinematics and Jacobian\n",
    "computations. As a result they are preferable for use in software\n",
    "packages that are compatible with multiple robot types. However, they\n",
    "have a few drawbacks: they involve much more computation than analytical\n",
    "approaches, only provide point solutions, and may fall prey to local\n",
    "minima. Robotics practitioners must be aware of these drawbacks when\n",
    "building systems based on numerical IK techniques.\n",
    "\n",
    "All numerical approaches share a common iterative structure. First, let\n",
    "$f(\\mathbf{q})$ denote the task space error (rather than task coordinate).\n",
    "These methods are given a seed configuration $\\mathbf{q}_0$, and iteratively\n",
    "improve it to obtain a sequence $\\mathbf{q}_1,\\mathbf{q}_2,\\ldots,\\mathbf{q}_k$ with\n",
    "decreasing error values $\\|f(\\mathbf{q}_i)\\|$. The iteration can terminate\n",
    "when the error decreases below some threshold, or when $i$ exceeds an\n",
    "iteration limit $k$. However, they differ in their approach for\n",
    "calculating these iterates."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "oTJ6FtbS5G-Z"
   },
   "source": [
    "### Cyclic Coordinate Descent\n",
    "\n",
    "Cyclic Coordinate Descent (CCD) is an appealing numerical method that\n",
    "only uses geometric reasoning to derive subsequent iterates. The idea is\n",
    "to move each joint independently so that it minimizes error between the\n",
    "end effector and the target (coordinate descent), and iterate through\n",
    "all the joints repeatedly (making it cyclic).\n",
    "\n",
    "*********************\n",
    "\n",
    "<a name=\"alg:CCD\">**Algorithm CCD**</a>\n",
    "1. **for** $i=1,\\ldots,k$ **do**\n",
    "2. &nbsp;&nbsp;&nbsp;$\\mathbf{q}_i \\gets \\mathbf{q}_{i-1}$\n",
    "3. &nbsp;&nbsp;&nbsp;**for** all joints $j = 1,...,n$ $do$\n",
    "4. &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;Compute $q_j^* = \\arg \\min_{q_j} \\|f(\\mathbf{q}_i)\\|$\n",
    "5. &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;Set $\\mathbf{q}_{i,j} \\gets q_j^*$\n",
    "6. **return** $\\mathbf{q}_k$\n",
    "\n",
    "*********************\n",
    "\n",
    "CCD iterates by performing $k$ passes through the joints as listed in\n",
    "[Algorithm CCD](#alg:CCD). On each pass, it loops through the $n$ joints, and\n",
    "modifies each joint $j$ assuming the rest of the robot is fixed.\n",
    "Specifically, line 4 finds the value that minimizes the error keeping\n",
    "the rest of $\\mathbf{q}_i$ constant, and this is updated in $\\mathbf{q}_i$ in line 5.\n",
    "This procedure iterates until $N$ passes have been made, or\n",
    "convergence has been reached. Note that the error $\\|f(\\mathbf{q}_i)\\|$ will\n",
    "never increase. However, it may terminate without convergence in the\n",
    "case that a singularity is reached.\n",
    "\n",
    "To make CCD converge quickly, the single-joint minimization in Line 4\n",
    "should be fast. In many cases there are closed-form solutions to this\n",
    "problem. For 2D robots with positioning tasks, this consists of finding\n",
    "the angle $\\theta_j$ between the $j$'th joint and the end effector and\n",
    "the angle $\\theta_j^\\prime$ between the $j$'th joint and the target.\n",
    "Then $q_j$ is displaced from its current value by\n",
    "$\\theta_j^\\prime - \\theta_j$.\n",
    "\n",
    "The figure below shows the result of CCD for a 2R manipulator reaching the point (1,0.5).  The first plot shows the sequence of configurations starting from $q_0=(0,0)$, the second shows the end effector point for the sequence, and the third shows the error at each iteration.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {
    "cellView": "form",
    "code_folding": [
     0
    ],
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 297
    },
    "id": "Sn5u3SFk0P1c",
    "outputId": "07a84f7a-b349-48b8-aefb-5b6c1403a822"
   },
   "outputs": [
    {
     "data": {
      "image/png": "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ysoKrq6uEqYiIqLGYvXq1Xj06BGio6MRFRUFpVIpdSQiItKg06dP49ChQzAzM1PfunTpAuDxe4knPD09n7nvzz//jKFDh8LBwQEtW7bEpEmTcOfOHZSXl9f68TMzM+Ho6KhuSAGAm5sbLC0tkZmZqd7m5OSkbkgBgJ2dHW7dulWnWonYlCIiIiJqRLKzs3Hz5k2oVCr12iNERNR0lJaWIiAgAGlpaVVuFy9exKBBg9TjWrRoUeV+V65cwR/+8Ad0794d33//PU6ePImIiAgADV8IvTpGRkZV/i2TyaBSqTT+ONS08et7RDrWsWNHGBkZISkpCe3btwcA/Pbbb7hw4QJ8fX0lTkdERPqsoqICEydORFBQEFxdXTF9+nScPXsWbdu2lToaERHVg0KhQGVlZZVtvXr1wvfffw8nJycYGtb+LfvJkyehUqnw6aefQi5/fP7Jzp07X/h4T3v55Zdx7do1XLt2TX22VEZGBgoLC+Hm5lbrPES1wTOliHTMzMwMoaGhWLBgAQ4ePIj09HRMmTJFPXEAwN27d5GWloaMjAwAQFZWFtLS0pCXlydVbCIi0gMffvghioqKsG7dOrz//vtwcXHBtGnTpI5FRET15OTkhKSkJFy5cgUFBQVQqVQIDw/H3bt3MX78eCQnJyM7Oxv79+/H1KlTa2woderUCQ8fPsTnn3+Oy5cvY+vWreoF0H//eKWlpYiLi0NBQUG1X+vz8/ODu7s7goODcerUKZw4cQIhISHw9fVF7969Nb4PqHljU4pIAqtWrcLAgQMREBAAPz8/DBgwoMp3wvfs2YOePXti1KhRAIBx48ahZ8+ez0wqRETUfMTHx2Pt2rXYunUrzM3NIZfLsXXrVvzyyy/48ssvpY5HRET1MH/+fBgYGMDNzQ3W1ta4evUq7O3tkZiYiMrKSgwbNgzu7u6YM2cOLC0tq3yQ/bQePXpgzZo1+OSTT9CtWzdERUU9czGMfv36YebMmQgKCoK1tfUzC6UDj7+Gt3v3brRq1QqDBg2Cn58fnJ2d8d1332m8fiKZEEJIHYKIgMGDB8PDwwNr166VOgoRERERERGR1vFMKSIiIiIiIiIi0jk2pYiIiIiIiIiISOf49T0iIiIiIiIiItI5nilFREREREREREQ6x6YUERERERERERHpHJtSRERERERERESkc2xKERERERERERGRzrEpRUREREREREREOsemFBERERERERER6RybUkREREREREREpHNsShERERERERERkc6xKUVERERERERERDr3f90WNoMlSLQMAAAAAElFTkSuQmCC",
      "text/plain": [
       "<Figure size 1200x400 with 3 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "#@title Code for generating the CCD figure\n",
    "xD = np.array([1.,0.5])\n",
    "q0 = np.array([0.,0.])\n",
    "L = [1,1]\n",
    "def fk_all(q):\n",
    "    theta = 0\n",
    "    res = []\n",
    "    joint = np.array([0.,0.])\n",
    "    for i in range(len(L)):\n",
    "        theta += q[i]\n",
    "        ci = np.cos(theta)\n",
    "        si = np.sin(theta)\n",
    "        joint = joint + np.array([ci*L[i],si*L[i]])\n",
    "        res.append(joint)\n",
    "    return res\n",
    "def error(q):\n",
    "    return np.linalg.norm(fk_all(q)[-1] - xD)\n",
    "def CCD_i(q,i):\n",
    "    xs = fk_all(q)\n",
    "    ee = xs[-1]\n",
    "    #joint positions\n",
    "    js = [np.array([0,0])] + xs[:-1]\n",
    "    jointi = js[i]\n",
    "    theta_target = np.arctan2(xD[1]-jointi[1],xD[0]-jointi[0])\n",
    "    theta_ee = np.arctan2(ee[1]-jointi[1],ee[0]-jointi[0])\n",
    "    dtheta = theta_target - theta_ee\n",
    "    qnext = np.copy(q)\n",
    "    qnext[i] += dtheta\n",
    "    return qnext\n",
    "iterates = [q0]\n",
    "for i in range(10):\n",
    "    iterates.append(CCD_i(iterates[-1],1))\n",
    "    iterates.append(CCD_i(iterates[-1],0))\n",
    "e = [error(q) for q in iterates]\n",
    "xy = [fk_all(q)[-1] for q in iterates]\n",
    "iterates = np.vstack(iterates)\n",
    "fig = plt.figure(figsize=(12,4))\n",
    "ax1 = fig.add_subplot(131)\n",
    "ax1.plot(iterates[:,0],iterates[:,1],color='k',zorder=1)\n",
    "ax1.scatter(iterates[:,0],iterates[:,1],c=range(len(iterates)),zorder=2)\n",
    "ax1.set_xlabel('q1')\n",
    "ax1.set_ylabel('q2')\n",
    "ax2 = fig.add_subplot(132)\n",
    "ax2.plot([v[0] for v in xy],[v[1] for v in xy],zorder=1)\n",
    "ax2.scatter([xD[0]],[xD[1]],color='r',zorder=2)\n",
    "ax2.set_xlabel('x')\n",
    "ax2.set_ylabel('y')\n",
    "ax3 = fig.add_subplot(133)\n",
    "ax3.semilogy(range(len(e)),e)\n",
    "ax3.set_xlabel(\"Iteration\")\n",
    "ax3.set_ylabel(\"Error\")\n",
    "fig.tight_layout()\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "HlHKVkhg0P1g"
   },
   "source": [
    "In 3D, the situation is similar, except the\n",
    "angles are calculated on the plane orthogonal to the joint axis. When\n",
    "combined position and orientation tasks are considered, the derivation\n",
    "of the optimal solution is more difficult because the solution must\n",
    "trade off between the two competing objectives. We refer the interested\n",
    "reader to external readings for more details.\n",
    "\n",
    "CCD in general is not as sensitive to the initial seed as other methods,\n",
    "and reduces error quickly in the first few iterations. However, it may\n",
    "be slow in converging to tight tolerances. The reason is that certain\n",
    "end effector motions can only be attained by a coordinated, simultaneous\n",
    "motion of two or more joints, and individual moves along either\n",
    "coordinate axis increases error (the error function contains a diagonal\n",
    "\"valley\").  An example of this is shown in the below figure, where a 4R serial manipulator with unit lengths\n",
    "is used to get toward the point (4,0).  The start configuration is $q=(\\pi/2,\\pi/2,\\pi/2,\\pi/2)$, and the solution\n",
    "is straightened out, $q=(0,0,0,0)$.  Even after 40 iterations, the method still has a relatively large error.\n",
    "\n",
    "Due to this behavior, CCD is often used as a precomputation step to\n",
    "get reasonably close to the target, and then some other numerical\n",
    "procedure is used for the final steps.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {
    "cellView": "form",
    "code_folding": [
     0
    ],
    "id": "FK98q2HF0P1g",
    "outputId": "804de607-5cc3-49af-a5fa-dfa955578315"
   },
   "outputs": [
    {
     "data": {
      "image/png": "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T0REREREsaOKrVBERERERJTcGFgQEdG01dzcjJUrV6KyshLXX389LBZLopdERKRaqtkKRUREFG0PPPAA/vVf/xW33norent72W6ciCgCDCyIiGhaeu+996DX63HrrbcCcNfyERFR+LgVioiIktL+/fuxZs0alJSUQJIk7N69e8Ix9fX1KC8vR1paGpYtW6a0HA/G2bNnkZmZiTVr1uCmm27Ck08+GcXVExFNP8xYTEF0lhoYGEjwSoiIYkf8H5dM3fQsFguqqqrw4IMP4p577pnw8127dqGurg47duzAsmXLsH37dqxatQqnT59GYWEhAKC6uhoOh2PCbV955RU4HA68+eabaGxsRGFhIT7ykY9gyZIl+PCHP+x3PVarFVarVfm+v78fAN8fiCi1hfT+INOkWltbZQC88MILL9Pi0tramuj/dv0CIL/00ktjrlu6dKlcW1urfO90OuWSkhJ569atQd3nW2+9Jd9xxx3K99/73vfk733vewGP37JlS8L/fnjhhRdeEnUJ5v2BGYsplJSUoLW1FVlZWZAkKejbDQwMoKysDK2trcjOzo7hCtWJr09gfG0mx9cnsEheG1mWMTg4iJKSkhitLrpsNhsaGhqwadMm5TqNRoOamhocOHAgqPtYsmQJOjs7ceXKFZjNZuzfvx9///d/H/D4TZs2oa6uTvne5XKht7cXM2bMCOn9AeDv8WT42kyOr09gfG0mF+7rE8r7AwOLKWg0GsyaNSvs22dnZ/OXexJ8fQLjazM5vj6BhfvamM3mGKwmNrq7u+F0OlFUVDTm+qKiIpw6dSqo+9DpdHjyySfxwQ9+ELIs44477sBHP/rRgMcbjcYJXaNycnJCXrsv/h4Hxtdmcnx9AuNrM7lwXp9g3x8YWBAR0bS1evVqrF69OtHLICJKCewKRUREqpOfnw+tVouOjo4x13d0dKC4uDhBqyIimt4YWMSI0WjEli1bOGwpAL4+gfG1mRxfn8Cm02tjMBiwaNEi7N27V7nO5XJh7969WL58eQJXFpzp9HcVKr42k+PrExhfm8nF4/WRPN02iIiIksrQ0BCampoAADfeeCO2bduGlStXIi8vD7Nnz8auXbuwbt06/OxnP8PSpUuxfft2/PKXv8SpU6cm1F4QEVHsMbAgIqKktG/fPqxcuXLC9evWrcMzzzwDAPjJT36C73//+2hvb0d1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",
      "text/plain": [
       "<Figure size 800x400 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "#@title Code for generating the 4R CCD figure\n",
    "q0 = np.array([math.pi/2,math.pi/2,math.pi/2,math.pi/2])\n",
    "xD = np.array([4,0])\n",
    "L = [1,1,1,1]\n",
    "iterates = [q0]\n",
    "for i in range(10):\n",
    "    for k in range(3,-1,-1):\n",
    "        iterates.append(CCD_i(iterates[-1],k))\n",
    "e = [error(q) for q in iterates]\n",
    "xy = [fk_all(q)[-1] for q in iterates]\n",
    "iterates = np.vstack(iterates)\n",
    "fig = plt.figure(figsize=(8,4))\n",
    "ax2 = fig.add_subplot(121)\n",
    "ax2.plot([v[0] for v in xy],[v[1] for v in xy],zorder=1)\n",
    "ax2.scatter([xD[0]],[xD[1]],color='r',zorder=2)\n",
    "ax2.set_xlabel('x')\n",
    "ax2.set_ylabel('y')\n",
    "ax3 = fig.add_subplot(122)\n",
    "ax3.semilogy(range(len(e)),e)\n",
    "ax3.set_xlabel(\"Iteration\")\n",
    "ax3.set_ylabel(\"Error\")\n",
    "ax3.set_ylim(1e-6,10)\n",
    "fig.tight_layout()\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "V2RzxVw-0P1i"
   },
   "source": [
    "### Root-finding methods\n",
    "\n",
    "The class of root-finding methods attempt to solve for a zero of the\n",
    "error function $f(\\mathbf{q})=0$ using iterative solutions of the 1st Taylor\n",
    "expansion. In particular, we will discuss the Newton-Raphson method, a\n",
    "multi-dimensional analogue of Newton's method in 1D."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "qDiKpiiE4_BD"
   },
   "source": [
    "#### Derivation from Taylor expansion\n",
    "\n",
    "For a 1D function $f(x)$, Newton's method repeatedly approximates the\n",
    "curve at an iterate $x_i$ as a line through $(x_i,f(x_i))$ using Taylor\n",
    "expansion, and solves for the intersection of the line and the $x$ axis.\n",
    "The iteration in Newton's method sets\n",
    "$$\n",
    "  x_{i+1} = x_i - f(x_i) / f^\\prime(x_i).\n",
    "$$\n",
    "If the line is locally a\n",
    "good fit to $f$, then the next iteration gets very close to the root. In\n",
    "this case we say that the method *converges*. In fact, it can be proven\n",
    "to obtain a quadratic order of convergence for most \"well-behaved\"\n",
    "functions.\n",
    "\n",
    "In the multidimensional case, we seek the next iterate\n",
    "$\\mathbf{q}_{i+1} = \\mathbf{q}_i + \\Delta \\mathbf{q}_i$ to solve the following Taylor\n",
    "expansion:\n",
    "\\begin{equation}\n",
    "  0 = f(\\mathbf{q}_i) + J(\\mathbf{q}_i) \\Delta \\mathbf{q}_i.\n",
    "  \\label{eq:NewtonRaphson}\n",
    "\\end{equation}\n",
    "In the nonredundant case\n",
    "where $n = m$, the Jacobian is square and this system of linear\n",
    "equations can be solved via matrix inversion as long as $J(\\mathbf{q}_i)$ is\n",
    "invertible. The matrix is invertible as long as the robot is not at a\n",
    "singularity.\n",
    "\n",
    "However, in the redundant $n > m$ case, the Jacobian is not even square.\n",
    "Here there is a linear subspace of values of $\\Delta \\mathbf{q}_i$ that\n",
    "satisfy this equation. Luckily there is generalization of the matrix\n",
    "inverse known as the *pseudoinverse* that allows for solving for a\n",
    "unique value of $\\Delta \\mathbf{q}_i$ that not only\n",
    "solves $\\eqref{eq:NewtonRaphson}$ but also minimizes the amount of deviation\n",
    "from the previous iterate. See\n",
    "[Appendix A.1](LinearAlgebra.ipynb#Matrix-pseudoinverse) for more information. The pseudoinverse\n",
    "solution $\\Delta \\mathbf{q}_i = -J(\\mathbf{q}_i)^+ f(\\mathbf{q}_i)$ is the solution\n",
    "that minimizes the joint space deviation $\\| \\Delta \\mathbf{q}_i \\|$.\n",
    "\n",
    "The below figures show how quickly Newton-Raphson finds a very accurate solution for the 4R manipulator that CCD had trouble with above.  Within 8 iterations the error is less than 1/1000 units, and in 15 iterations the error is approximately 10<sup>-7</sup> units."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {
    "cellView": "form",
    "code_folding": [
     0
    ],
    "id": "0UNaIiu70P1i",
    "outputId": "3e4ab06d-a04a-4a4f-b10e-fde3f2668917"
   },
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 800x400 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "#@title Code for the Newton-Raphson example \n",
    "\n",
    "q0 = np.array([math.pi/2,math.pi/2,math.pi/2,math.pi/2])\n",
    "\n",
    "def fk_jac(q):\n",
    "    xs = fk_all(q)\n",
    "    js = [np.array([0.,0.])] + xs[:-1]\n",
    "    cols = []\n",
    "    for i in range(len(L)):\n",
    "        d = xD - js[i]\n",
    "        cols.append([-d[1],d[0]])\n",
    "    return np.array(cols).T\n",
    "\n",
    "def basic_newton(q0,N):\n",
    "    #uses standard pseudoinverse to determine newton step\n",
    "    trace = [q0]\n",
    "    for i in range(N):\n",
    "        q = trace[-1]\n",
    "        J = np.linalg.pinv(fk_jac(q))\n",
    "        f = fk_all(q)[-1] - xD\n",
    "        dq = -np.dot(J,f)\n",
    "        qnext = q+dq\n",
    "        trace.append(qnext)\n",
    "    return trace\n",
    "\n",
    "trace = basic_newton(q0,20)\n",
    "xy = [fk_all(q)[-1] for q in trace]\n",
    "err = [error(q) for q in trace]\n",
    "fig = plt.figure(figsize=(8,4))\n",
    "ax1 = fig.add_subplot(121)\n",
    "ax1.plot([v[0] for v in xy],[v[1] for v in xy])\n",
    "ax1.scatter([xD[0]],[xD[1]],color='r',zorder=2)\n",
    "ax1.set_xlabel('x')\n",
    "ax1.set_ylabel('y')\n",
    "ax1.axis('equal')\n",
    "ax2 = fig.add_subplot(122)\n",
    "ax2.semilogy(range(len(err)),err)\n",
    "ax2.set_xlabel('Iterations')\n",
    "ax2.set_ylabel('Error')\n",
    "fig.tight_layout()\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "4xzDuU6M0P1j"
   },
   "source": [
    "There is also a variant of the pseudoinverse called the *weighted\n",
    "pseudoinverse* in which the solution does not minimize $\\| x \\|$ but\n",
    "rather minimizes a weighted norm $x^T W x$ where $W$ is a symmetric\n",
    "weight matrix. In the context of IK, $W$ is usually a diagonal matrix\n",
    "that weights the relative movement of each joint, with higher weights\n",
    "penalizing larger movements. \n",
    "\n",
    "#### Step direction and size, divergence\n",
    "\n",
    "In total, the Newton-Raphson method chooses the step direction as\n",
    "follows:\n",
    "$$\\label{eq:NewtonRaphsonStep}\n",
    "\\Delta \\mathbf{q}_i = - J^+(\\mathbf{q}_i) f(\\mathbf{q}_i)\n",
    "$$\n",
    "\n",
    "Unfortunately, Newton's method does not always converge if the initial\n",
    "guess is too far from a root. The sequence of iterates may oscillate or\n",
    "even diverge toward infinity. The step size may also become huge as the\n",
    "robot approaches a singularity, where taking the inverse effectively approaches\n",
    "dividing by zero. \n",
    "\n",
    "In the following example, the 4R robot is asked to reach the point (2,0.001) from the outstretched configuration $q=(0,0,0,0)$.  Since the robot starts at a singularity, the initial step size is huge!  It moves over 1,000 rad, which almost certainly would not be a preferred solution."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {
    "cellView": "form",
    "code_folding": [
     0
    ],
    "id": "EC4TqL-u0P1j",
    "outputId": "49bf7eb3-efb0-48e8-a2fb-c89a121d80d8"
   },
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 1200x400 with 3 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "#@title Code for the large step size Newton-Raphson example\n",
    "\n",
    "xD = np.array([2.0,0.001])\n",
    "q0 = np.array([0,0,0,0])\n",
    "\n",
    "trace = basic_newton(q0,10)\n",
    "xy = [fk_all(q)[-1] for q in trace]\n",
    "err = [error(q) for q in trace]\n",
    "fig = plt.figure(figsize=(12,4))\n",
    "ax1 = fig.add_subplot(131)\n",
    "ax1.plot(range(1,len(trace)),[np.linalg.norm(trace[i]-trace[i-1]) for i in range(1,len(trace))])\n",
    "ax1.set_ylabel('Step size')\n",
    "ax1.set_xlabel('Iteration')\n",
    "ax2 = fig.add_subplot(132)\n",
    "ax2.plot([v[0] for v in xy],[v[1] for v in xy])\n",
    "ax2.scatter([xD[0]],[xD[1]],color='r',zorder=2)\n",
    "ax2.set_xlabel('x')\n",
    "ax2.set_ylabel('y')\n",
    "ax2.axis('equal')\n",
    "ax3 = fig.add_subplot(133)\n",
    "ax3.semilogy(range(len(err)),err)\n",
    "ax3.set_xlabel('Iterations')\n",
    "ax3.set_ylabel('Error')\n",
    "fig.tight_layout()\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "tPlIPh3n0P1k"
   },
   "source": [
    "<a id=\"line-search\"></a>\n",
    "There are multiple ways of keeping the step size small. One\n",
    "straightforward method is known as a *line search*, in which the entire\n",
    "step $\\Delta \\mathbf{q}_i$ is not taken, but rather a scaled step\n",
    "$$\n",
    "  \\mathbf{q}_{i+1} = \\mathbf{q}_i + \\alpha_i \\Delta \\mathbf{q}_i\n",
    "$$\n",
    "is taken, with\n",
    "$\\alpha_i > 0$ a parameter chosen at each step. The step size is usually\n",
    "taken to obtain a sufficient decrease in the error function value. One\n",
    "simple way of doing this is to start with some value of $\\alpha_i$, and\n",
    "if it increases the error function value, then to scale it by some\n",
    "number $< 1$. This repeats until a suitable step size is found. A\n",
    "decrease will be eventually found as $\\alpha_i$, unless the problem is\n",
    "at a local minimum, or a numerical error has occurred.\n",
    "\n",
    "Another method is to penalize steps that are too large in the\n",
    "pseudoinverse itself, which is known as a *damped pseudoinverse* method. In this method, the step size is allowed to deviate from solving the\n",
    "root finding problem by instead minimizing the regularized least squares\n",
    "function:\n",
    "$$\n",
    "  \\min_{\\Delta \\mathbf{q}} \\| f(\\mathbf{q}) + J(\\mathbf{q})\\Delta \\mathbf{q} \\|^2 + \\gamma^2 \\| \\Delta \\mathbf{q} \\|^2.\n",
    "$$\n",
    "The $\\gamma$ term affects how much the step length is penalized compared\n",
    "to the error term. It can be shown that the result is simply\n",
    "$$\n",
    "  J^+_\\gamma = V (\\Sigma + \\gamma I)^{-1} U^T\n",
    "$$\n",
    "where $U \\Sigma V^T$ is the SVD of $J(\\mathbf{q})$.\n",
    "\n",
    "As the figure below shows, the damped pseudoinverse regulates the step size more strongly as $\\gamma$ increases.  However, this comes at a cost of a slower convergence rate.  Adding a line search is extremely helpful, as the initial step size is not too large and the error is guaranteed not to increase on each step.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {
    "cellView": "form",
    "code_folding": [
     0
    ],
    "id": "mYMQG62p0P1k",
    "outputId": "41029699-6814-4afc-bdf7-9d172c8dd7ac"
   },
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAABKUAAAGGCAYAAACqvTJ0AAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjcuMSwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/bCgiHAAAACXBIWXMAAA9hAAAPYQGoP6dpAAEAAElEQVR4nOzdeVxU1fvA8c+dYd8FBARRUUHFBXEByV1RM5dcUjNT07I0tYw2bTEr09IyK/1lmVumuZVaWm64K24oKOIuAorsm+zLzO8PkuLrBjIwoM/79bqvYO695zx3kpk7z5zzHEWr1WoRQgghhBBCCCGEEKISqfQdgBBCCCGEEEIIIYR4/EhSSgghhBBCCCGEEEJUOklKCSGEEEIIIYQQQohKJ0kpIYQQQgghhBBCCFHpJCklhBBCCCGEEEIIISqdJKWEEEIIIYQQQgghRKWTpJQQQgghhBBCCCGEqHSSlBJCCCGEEEIIIYQQlc5A3wFUBRqNhpiYGCwtLVEURd/hCCFEhdBqtdy6dQtnZ2dUKvlOorzkvUMI8biQ9w/dkvcPIcTjoLTvHZKUAmJiYnB1ddV3GEIIUSmio6OpXbu2vsOo9uS9QwjxuJH3D92Q9w8hxOPkQe8dkpQCLC0tgaIny8rKSs/RCCFExUhPT8fV1bX4NU+Uj7x3CCEeF/L+oVvy/iGEeByU9r1DklJQPGzWyspK3hiEEI88mSqgG/LeIYR43Mj7h27I+4cQ4nHyoPcOmRQuhBBCCCGEEEIIISqdJKWEEEIIIYQQQgghRKWTpJQQQgghhBBCCCGEqHRSU0pUS4WFheTn5+s7DCGqFENDQ9Rqtb7DEEIIIYQQQohSkaSUqFa0Wi2xsbGkpqbqOxQhqiQbGxucnJykGK0QQgghhBCiypOklKhWbiekHBwcMDMzkw/eQvxDq9WSlZVFfHw8ALVq1dJzREIIIYQQQghxf5KUEtVGYWFhcULKzs5O3+EIUeWYmpoCEB8fj4ODg0zlE0IIIYQQQlRpUuhcVBu3a0iZmZnpORIhqq7bfx9Sc00IIYQQQghR1UlSSlQ7MmVPiHuTvw8hhBBCCCFEdSFJKSGEEEIIIYQQQghR6SQp9ZC0BQXkXLxIdkiIvkMRQgghhBBCiLvS5OZSKCtXCyGqKL0mperVq4eiKHdsEydOBCAnJ4eJEydiZ2eHhYUFgwcPJi4urkQbUVFR9OnTBzMzMxwcHHj77bcpKCio8NgLb90iov/TXHt2OFqp3SKEEEIIIYSoQjQZGSR+MY3L7VpxsZ0fUUN7k7FvL1qtVt+hCSFEMb0mpY4fP87NmzeLt507dwIwZMgQAN544w3+/PNP1q9fz759+4iJiWHQoEHF5xcWFtKnTx/y8vI4fPgwK1asYPny5UyfPr3CY1ebmxf/rMnMrPD+hLht//799OvXD2dnZxRFYdOmTfoOSQghhBBCVBGazEySPn+Xyx19SVi2icJsDQCZp68R/coErvboTMqaNWiysyuk/8Jbt0jftp30bdvIvXQJbV5ehfQjhHg0GOiz85o1a5b4/fPPP6dBgwZ07tyZtLQ0lixZwurVq+nWrRsAy5Yto0mTJhw5coR27dqxY8cOwsPD2bVrF46OjrRs2ZJPP/2Ud999lxkzZmBkZFRhsStGRihGRmjz8tBkZqK2samwvoT4r8zMTLy8vBg7dmyJJK0QQgghhHh8aTIzSfluBknrtlKYVTQaytCyEPu+rTHzakHKymWkXlDIu55A7IyPSfjqS2yGj6DGiOcwdHQsV9/58fFk7N7NrV2BZB49Cv+dSaJWY1SnDsYNG2BUvwHGDRtg3KABRm5uqExNy9WvEKL602tS6r/y8vL45ZdfCAgIQFEUgoODyc/Px9/fv/iYxo0bU6dOHYKCgmjXrh1BQUE0b94cx/+8iPbq1YsJEyZw9uxZvL2979pXbm4uubm5xb+np6c/VMwqc3MK8/IozMzE8KFaEI8LDw8P7Ozs2L17N6b/vPlqtVr8/Pzo2rUrs2fPLnVbvXv3pnfv3hUVqhBCCCGEqEY0mRmkfDudpHXbKMz+TzKqvw/Wk75AqeECgGPvydjv/pq01UtJDjcg/1YmST/+SNKSJVg9+SS2o0dh2qJFqfvNjYggIzCQWzt3kR0aWmKfUf36qCwtyLt8BU1mJnkREeRFRAC7/j1IUTB0cSlKUDUoSlQZN6iPUUN31BbmCCEeD1UmKbVp0yZSU1N54YUXAIiNjcXIyAib/xmB5OjoSGxsbPExjv+T1b/9++1j7mb27Nl8/PHH5Y5ZZW5OYUqKTN/TE61WS3Z+oV76NjVUoyhKqY9fu3Yt7dq149ChQ8WJ1lWrVhEZGcl7773HrFmzmDVr1n3bCA8Pp06dOuWKWwghhBBCPBo0mRmkfvMBiRt2/DsyykKD/dPtsJ78BYqNEwA5/9wvmxhboO79IbYdx1Nj7xwyNq8i+bwJWQnGpG/dSvrWrZh6e2M7ehSW/v4oBiU/Kmq1WnLCznJr1y5uBe4i7/KVEvtNvFpg2d0fS//uGNevX3xOQVwcuVeukHflCrmXr5B79Qp5ly5TmJZG/vXr5F+/Dvv2FbejGBpi2ftJbEeMwKRFizLdcwshqp8qk5RasmQJvXv3xtnZucL7mjZtGgEBAcW/p6en4+rqWuZ2VP/UldJkZuksNlF62fmFeE7frpe+wz/phZlR6f98vL29admyJefPn8ff35+srCymTZvGzJkzsbS0ZPz48QwdOvS+bVTG34YQQgghhKjaNBnppH7zPom/7aLwn48hhhYazPr4cW3gVA5lmRCxP4mriVFcTcjgRmo2BiqFYW1dmdi1IbWsa6L0nYvlExOw3P0ZOQc2kXzBgrQoU7JPneLGqVMY1KqF7fMjsB44kNyLF7m1cxe3AgMp+O8X/wYGmPv4YNnDH4tu3e46BVBRFAydnDB0coL27Ysf12q1FCYn35Gsyr18mcKERNL/+JP0P/7EpGlTajz3HFZ9nkJlYlLRT60QQg+qRFIqMjKSXbt28fvvvxc/5uTkRF5eHqmpqSVGS8XFxeHk5FR8zLFjx0q0dXt1vtvH3I2xsTHGxsbljvvfpJSMlBIP5uHhwYULFwCYM2cO9vb2jBkzBgBbW1tsbW31GZ4Qj53vv/+e77//nmvXrgHQtGlTpk+fLtNjhRBCVDkarYa89CRS5n/Irc37ipNRanMNF1t4MqPWsyTmWsCaK3c9P79Qyy9Holh3/DrP+rjyapeGONnWh2eWYPLEZJx3zcDh7D5SLpuTcsWcgps3iZ/7JfFzvyzRjmJmhkXHjlj6d8eic2fUVlYPdT2KomBgZ4eBnR3mPj4l9mWfOUPKqtWk//UXOWfPcvP994mfMwfrZwZTY/hwjGrXfqg+hRBVU5VISi1btgwHBwf69OlT/Fjr1q0xNDQkMDCQwYMHA3DhwgWioqLw8/MDwM/Pj88++4z4+HgcHBwA2LlzJ1ZWVnh6elZ43MVJqYyMCu9L3MnUUE34J7301ndZNWrUiP3793P9+nXmzp3L1q1bUamKFsCU6XtCVL7atWvz+eef4+7ujlarZcWKFTz99NOcOnWKpk2b6js8IYQQotieb7/mwtnmwCBoU7TQjUYBjaIACqOSARQUAKXov4pS9IiigKGlIUdrws6ENH4OimTNsWiG+7jyateGODq3hFGbMLiym5q7ZmB3PZT0SFOSL9mQm6KgrlEDi25dsfT3x9zPr8JHLJk2b47p57NxePcdUjdsIPXXNeTHxJC8ZCnJS5dh0akTNUY8h3mHDigqvS4mL4TQAb0npTQaDcuWLWP06NEY/GfesrW1NS+++CIBAQHY2tpiZWXF5MmT8fPzo127dgD07NkTT09PRo4cyZw5c4iNjeWDDz5g4sSJOhkJ9SAyUkq/FEUp0xQ6ffPw8GDx4sVMnTqVnj170qVLl+J9Mn1PiMrXr1+/Er9/9tlnfP/99xw5ckSSUkIIIe5ry5YtvPnmm2g0Gt59911eeumlCu0v17UW2nMl73sV4K5fk2r//a8WLVogNzUP73To27UBqxKTORaZwoqgSH49Hs1zPnV4tUsDHBp0A7cuqM7+js3uT7F2u0ZBtgoDZ2OU7t7QtDNUYhLIoEYN7MeNw27sWDL27Sdl1SoyDx0iY98+Mvbtw7BuHWo8OxybQQNRW1tXWlxCCN3S+yf6Xbt2ERUVxdixY+/Y9/XXX6NSqRg8eDC5ubn06tWL//u//yver1ar2bJlCxMmTMDPzw9zc3NGjx7NJ598Uimxq8zNANBkSVJKPJiHhwfR0dFs2LCBsLCwEvvKMn0vIyODy5cvF/8eERFBSEgItra2MpJKiIdUWFjI+vXryczMLB6NK4QQQtxNQUEBAQEB7NmzB2tra1q3bs3AgQOxs7OrsD679RlCWNL3KO38uGWQR1JOEsk5SSTnJJOYnURKTjJJ2Ukk56SQW5hT4lyVVo1PVF/ck1pzPTCGJ5vmMu75pvxwIIYTkSksP3yNX49F8ZxvHSZ0boBD82egSX+U4OUY7vsCUiPgtxfh4HzoPh3cexQNw6okilqNZbeuWHbrSm5EBKlr1pD6+0byI6OI/+ILEr75Bqu+fbB97jlMKmG2jBBCtxStVqt98GGPtvT0dKytrUlLS8OqDPOi42bPJnnFz9iNewmHN9+swAgFQE5ODhEREbi5uWFSDQsdZmVlYWFhQUBAAF9++eWDT7iHvXv30rVr1zseHz16NMuXLy9HhOJRcL+/k4d9rXuUnTlzBj8/P3JycrCwsGD16tU89dRTdz02NzeX3Nzc4t9vL5Ihz6cQ4lEn7x8lHT58mLlz57Jx40YApkyZgq+vL8OHDy/V+RX5fGq1WjLyM0jITiAxK5HE7EQSshM4cfMEqcdV+ET2Q4WKRItoCnpEUt+uPX8eN+FkZCoAxgYqnm9Xl1c618fB0gRyM+DI93D4W8hNL+qkzhPg/xHUaafT2MtCk5VF2p9bSFm9mtx/arYCmHh6YtW/H9Z9+mBQs6be4hNClP61TibhloNM3xNlkZOTg1arZdSoUeVqp0uXLmi12js2SUgJUXaNGjUiJCSEo0ePMmHCBEaPHk14ePhdj509ezbW1tbF28Os2iqEEEL/9u/fT79+/XB2dkZRFDZt2nTHMQsXLqRevXqYmJjg6+tbYnGlmJgYXFxcin93cXHhxo0blRH6AymKgqWRJfWt6+NTy4en6j/F6Kaj+c7/O+a9/gEm/ePJM8zGPsMVqy1erA76lhzHz3iu50Wa1dWQW6BhycEIOs3Zw8wt4STkGULnt+H1UHhiMhiYQNRhWNoLVg2F2LAHB1UBVGZm1Bg2FLdNG6m76hesnnoKDA3JCQ8n/vMvuNS5C1HjXibtzy1osmSldCGqMklKlYMkpURZhIaGYmRkRJMmTfQdihDiH0ZGRjRs2JDWrVsze/ZsvLy8+Oabb+567LRp00hLSyveoqOjKzlaIYQQupCZmYmXlxcLFy686/61a9cSEBDARx99xMmTJ/Hy8qJXr17Ex8dXcqS6VdOsJuOeeo4xH3bFzFGNWb4l/cMnYXWpLn9GLSXK7H182v1GQ7fL5BTk8tPBCDrO2U3A2hD2RBeQ3/0TmHwSWo0GRQ2XtsOiDvDbS5B8VS/XpCgKZq1b4zLvK9z378Pxww8w9fICjYbMAweIefttLnXoSMy7U8k8fBhtYaFe4hRC3Jvea0pVZ7eTUoWSlBKlEBoaiqenJ4aGhvoORQhxDxqNpsQUvf8yNjaulEU0hBBCVKzevXvTu3fve+6fN28e48aNY8yYMQAsWrSIrVu3snTpUqZOnYqzs3OJkVE3btzAx8fnnu3dbfq3Ptk4mPH8ex3Y/fM5LgfH0zFiCI01Ldno9D3n0o6DyXEcm1pikN2am9eb8/spDb+fukENM0N6N69FvxYf4eM3GfXez+DsRjizvui/rUZD53fA0kkv12VQowa2I0ZgO2IEedeukfbHn6T9+Sf50dGkbd5M2ubNGDg4YNW3L9ZP98ekUSO9xCmEKElGSpWDjJQSZTFlyhROnTql7zCEEP+YNm0a+/fv59q1a5w5c4Zp06axd+9eRowYoe/QhBBC6EleXh7BwcH4+/sXP6ZSqfD39ycoKAgAHx8fwsLCuHHjBhkZGfz999/06tXrnm1WxenfhsZqer7UFL+BDVAUqBnpzrs3/4+XG7yKo5kjWYW3SDfai3n97/BssRU7S0jJymf10SiGLz7CE4sj+cTkHc7334K2oT9oCuDEEvimJeyaAdkper0+o3r1qPnaZBrs2E7d1auxeXYYKmtrCuLjSV66lIinB3D16QEkLVlKflycXmMV4nEnSaly+DcpJfOUhRCiuomPj2fUqFE0atSI7t27c/z4cbZv306PHj30HZoQQgg9SUxMpLCwEEdHxxKPOzo6EhsbC4CBgQFfffUVXbt2pWXLlrz55pv3XXmvqk7/VhSFVr3q0neSF8ZmBqRE5WDxR3OWt1zHIv9FPFnvSdSKmuj8A7g1X8b8EXUY2qY2liYGxKXnsvRQBE+uS6dTzER+9fyeLMfWUJANB7+Gb7zgyCLQ85paiqJg1sqbWjNm4H5gP7UXfIdljx4ohobkXrhA/Ny5XO7SlegJr5Jz7pxeYxXicSXT98pBZfZPUiojQ8+RCCGEKKslS5boOwQhhBDVVP/+/enfv3+pjq3q07/rNLVjyLQ2/PX9GZJjMvlzfigdh3kwt/Ncjt08xlv73uJCygW+zJrAnE5z+HSAP/svJvJnaAw7w+OITs5mWrI10whgZI1wXlfWYJ91Bba9C9ePQ//vwMhM35eJysgIS39/LP39KUxLI33bdtL++IPs4GAy9uwhY88eLJ98kpqvTca4fn19hyvEY0NGSpWDTN8TQgghhBDi0WFvb49arSbuf6Z0xcXF4eSkn1pJlcG6phmD32lNg1Y10RRq2bf6Ant+OU9r+zas7buWpnZNSctNY8KuCfxybjn+TRz4drg3wR/6891wb3p6OmKkVrMypSk+yR8zI38UBaghbAMZ33cnN/Gavi+xBLW1NTWGDaXeql+o/9dfWPXpA4rCrW3buNq3HzFTp5FXRUa0CfGok6RUOagsJCklhBBCCCHEo8LIyIjWrVsTGBhY/JhGoyEwMBA/Pz89RlbxjEwM6DWuGe0G1AcFwg/GsOnrk1jm27Ki9woGNhyIRqth/sn5vLnvTTLzMzEzMqCflzM/jmrD8Q/8mftMCzp4OLJS25vnct8jUWuFRUo4md91YM73i1l+KIKrCRlo9Tyt77+M67vh8tWXuG3ahIV/d9BoSNu0iSu9n+LmjBlSc0qICiZJqXIoHimVlVWlXliFEEIIIYQQd5eRkUFISAghISEAREREEBISQlRUFAABAQEsXryYFStWcO7cOSZMmEBmZmbxanyPMkVRaP1kPfpOLKozFXs1nbUzjxFz9hYfP/ExH7b7EAOVATsjdzJi6wiupV0rPtfa1JAhbVz5eawPx9/3Z8Sw4fyfxxLClQbYKrcIiH2Ha3/No9tXe+k0dw/vbzzD9rOx3MrJ198F/4dJIw9cFyyg3vp1mLdvDwUFpK5Zy5WevYj7/AsKkpP1HaIQjyRFK9kU0tPTsba2Ji0tDSsrq1Kfp8nM5ELrNgA0OhmMykz/c6UfZTk5OURERODm5oaJiYm+wxGiSrrf38nDvtaJu5PnUwjxuHjUXu/27t1L165d73h89OjRLF++HIAFCxYwd+5cYmNjadmyJd9++y2+vr466b+6PJ+p8VlsXxxGYnRR/dzmnV14YnBDwlLPELA3gITsBCwMLZjVYRZd69z5fN6mzcsibd1EbC7/DsDvmk5MyxtLLkYAGKgUWtWtQWePmnT2qIlnLStUKqXiL/ABso4fJ37+N2QHBwOgmJlhO2okdmPHoq7C/9+EqCpK+1onSSke/o1Bq9Vy3rMpaLW4H9iPQc2aFRilkKSUEA8mSanKI8+nEOJxIa93ulWdns/CfA1Bm68QuquovpKtszk9X2qKtkYOb+59k5PxJwEY7zWeCV4TUCn3mIij1cKR72HHB6AtJM22OT/V+oQ/rylcSyq5krmduRHt6tvRrr4tfg3saFDTAkXRT5JKq9WSefAQCfPnk3P2LAAqKyvsxo7FduTzxTNnhBB3kqRUGZTnjeFC6zZoMjNpsO1vjOrVq5gABSBJKSFKQ5JSlUeeTyHE40Je73SrOj6fkWeTCFweTvatfNSGKjo80xCP9g58Gfwlv57/FYCOLh35vNPnWBnd55qu7oX1L0B2CpjXhKEribLwYt+lBPZfTODw5UQy8wpLnGJvYVycoPKrb4ebvXmlJ6m0Wi23du0i8dtvyb10GQC1rS32EyZQ4/kRekuaCVGVSVKqDMrzxnCpU2cK4uOp99sGTJs2raAIBUhSSojSkKRU5ZHnUwjxuJDXO92qrs9nVnoegSvCiTpbVFvJzcuebiObsCPubz4J+oTcwlxcLV35pus3uNdwv3dDKddgzQiICwOVAfSeA21fBCCvQMPp66kEXUki6GoSwZEp5BZoSpzuaGX8z0iqoiRVXTuzSksKaQsLSf/rLxK+W0D+PzXIHN9/H9uRz1dK/0JUJ6V9rZNC5+VUXOw8Q1bgE5Vn4cKF1KtXDxMTE3x9fTl27NgDz9m/fz/9+vXD2dkZRVHYtGlTxQcqhBBCCCEeCWZWRvSd6EX7ZxqiUitEhCayZuYxWhV05OfeP+Ns7kz0rWhG/DWCbde23buhGvXgxR3QdCBoCmBrAPz5OhTkYmSgok09WyZ3d2f1uHacntGTtS+3Y4q/O75uthipVcSl57I5JIZpv5+hy5d7eeLz3byxNoR1x6OJSqrYBagUtRrrfv1osHUL9hMnAhA/bx55/ySohBBlJ0mpcipOSmVKUkpUjrVr1xIQEMBHH33EyZMn8fLyolevXsTHx9/3vMzMTLy8vFi4cGElRSqEEEIIIR4likqhpX8dnnm3DTaOZmSm5rJ5/inSDxizuvevtKvVjuyCbN7e9zYLQ+5zz2lkDs8sA/8ZgALBy2FFP7gVW+IwYwM1vvXtmOLvwdpX/Dg9oyerx/nyWreG+NSzxVCtcDMth42nbvDOb6fpNHdPcZJqzbEoIhIzKyRJpRgaYj/xVcx8fdFmZ3PzvffRajQPPlEIcQeZvkf5htBGvjCGrCNHcJ47F+t+fSsoQgHVe/qeh4cHdnZ27N69G1NTU6Bobrqfnx9du3Zl9uzZpW7L19eXtm3bsmDBAgA0Gg2urq5MnjyZqVOnlqoNRVHYuHEjAwYMKPO1iKpNpu9VHnk+hRCPC3m9061H5fnMzy3kwLqLnDt0EwBHNyu6j2nM8ujFLA1bCsD8LvPpXrf7/Ru6tAt+Gws5aWBZC4b9ArXblCqG7LxCgiNTCLqayJGryYRGp1KgKfnx1tHKGF83O3zr29Kuvh31dViTKu/6da72fxptVhaO772H7aiROmlXiEeBTN+rJDJSSpTG2rVrOXnyJIcOHSp+bNWqVURGRvLee+8xa9YsLCws7rtFRUWRl5dHcHAw/v7+xe2oVCr8/f0JCgrSx6UJIYQQQojHkKGxmm4jm9BrXDOMTA2Ii0hn/axg+hQOZ0zTMQBMPzyd2MzY+zfk7g/j9kDNxnDrJizrDZcDSxWDqZGaDu72vN2rMb9NeILTM3ryy4u+TP5nJNXt6X5/hMbw/sYwun+1D59ZgUxcfZKVRyK5FHerXCOpjGrXxvHtt4B/pvFFRj50W0I8rgz0HUB1pzI3AyQppRdaLeRnPfi4imBoBmX4hsXb25uWLVty/vx5/P39ycrKYtq0acycORNLS0vGjx/P0KFD79uGs7Mz8fHxFBYW4ujoWGKfo6Mj58+ff6hLEUIIIYQQ4mE1bO2AQz1Ldi0N5+aVNHYuDaeZb09a1DjF6bQQph2Yxk89f0KtUt+7EbsG8NIu+O0luLgN1o6E0X+UesTUbWZGBnRwt6eDuz0AOfmFnIxK4cjVZI5eTeJUdCoJt3LZevomW08XjfCyMzeiXQM7OjS0p0NDe1xtzcrUp82wYaRv30HWkSPEvPc+dVf+jKKSsR9ClJYkpcpJRkrpUX4WzHLWT9/vxRTNhS8DDw8PLly4AMCcOXOwt7dnzJiib5FsbW2xtbXVeZhCCCGEEEJUNCs7UwYEeHPi70hObI3g0tF4nqoznst13uRE3Al+OvMTr3i9cv9GjC1h6M+weihc3QurnoGx26Fmo4eOy8RQzRMN7Hmiwb9JqpDoVI5eTeZoRNHqfkmZeSWSVPXszIoSWw1r4tfADmtTw/v2oahU1Jo5k4j+/ckODiZl5UpsR49+6JiFeNxICrec1JKUEqXUqFEjLly4wPXr15k7dy5ff/01qn++RSnt9D17e3vUajVxcXEl2o6Li8PJyUkflyWEEEIIIQQqtQqfvm4MeLMVhsZqUqNyCXD4EIDvQ78nJD7kwY0YGMOwVeDcCrJTYOVASLuusxhNDNW0q2/H6/7/ru637hU/Xu/uTuu6NVCrFK4lZfHLkSjG/xKM9yc7GPh/h5i34wLHIpLJL7x7MXOj2i44vPMOAPFfzyfv2jWdxSzEo05GSpVT8UipLElKVTpDs6IRS/rqu4w8PDxYvHgxU6dOpWfPnnTp0qV4X2mn7xkYGNC6dWsCAwOLi5RrNBoCAwOZNGlSmWMSQgghhBBCl5wb2tCskwundkZhGOpEn3Z92Hp1K+/uf5f1/ddjZfSA4u7GFjBiAyztBUmXihJTY7aBuZ3OYzU2UOPjZouPmy1v9PAgPSefI1eSOHg5kYOXErmamMmpqFRORaXy7e7LmBsVJbU6uNvT0d2eBjUtioum2wwbyq0d28k8HPTvND71faYsCiEASUqVm0zf0yNFKfMUOn3y8PAgOjqaDRs2EBYWVmJfWabvBQQEMHr0aNq0aYOPjw/z588nMzOzeCogwIIFC9i4cSOBgf8WiczIyODy5cvFv0dERBASEoKtrS116tQp59UJIYQQQghRxKu7K6F7orl5JY2X+71OaHwo1zOu82nQp8zpNOfBq9+Z28HIjUWJqcSLsHoIjPqjKGFVgaxMDOnZ1ImeTYtmINxIzebQpUQOXE7k0OVEkjPzCDwfT+D5eABqWZvQpZED3Rs70L6hPbU+/ZSr/Z8m++RJkleuxO6FFyo0XiEeBZKUKqfbSanCjAw9RyKqOg8PDwAmTZpEw4YNH7qdYcOGkZCQwPTp04mNjaVly5Zs27atRPHzxMRErly5UuK8EydO0LVr1+LfAwICABg9ejTLly9/6HiEEEIIIYT4L3MbYxr7OhF+6CbndifwxZAvGP33aLZd28YTzk8w0H3ggxuxcf03MXUjGNY+D8+tLZriV0lcbEwZ2taVoW1d0Wi0hN9MLx5FdexaMjfTcvj1WBS/HovCyEDFEw3sGPbMWOqt+I6Er+dj0bkzxm5ulRavENWR1JQqJ5V5UbZek6mnVeBEtZGTk4NWq2XUqFHlbmvSpElERkaSm5vL0aNH8fX1LbF/xowZXPufuexdunRBq9XesUlCSgghhBBC6Jp3z7qgwLXTibjk1Wei90QAZh+bTURaROkaqdmoaCqfoTlc3QMbXwFNYQVGfW8qlUIzF2vGd27ALy/5cvqjniwf05bRfnWpXcOUvAINey8kMCG1DidreqDNzeX4hACOX0mg4B61qIQQkpQqN5m+J0orNDQUIyMjmjRpou9QhBBCCCGEqFA2jmY0aFkTgFM7ohjbbCy+Tr5kF2Tz7v53ySvMK11DtdvAsJWgMoSzG+Hvd0CrrcDIS8fEUE2XRg58/HQzDrzTlR1vdGJq78b4uNnxbashZBkYY3ftPL++M4c2n+3i9TWn2Bxyg9SsUl63EI8JSUqVkySlRGmFhobi6emJoeH9l5UVQgghhBDiUeDdqy4Al47HkZGcy6yOs7AxtuFc8jm+OflN6Rtq2B0G/QAocPwn2Pt5xQT8kBRFwcPRkvGdG7BuvB/bZw8lfWzRyLDR57djHneDzSExvL4mhFaf7mTooiB+2HeFqwlSAkYISUqVkySlRGlNmTKFU6dO6TsMIYQQQgghKoVjPStqN66BRqMldFc0DmYOfNr+UwB+Dv+ZgzcOlr6xZoPhqblFP+/7HI7+WAER64aNmRFd3ngJ8w4dMCrM54eYvxjfsR6NHC3RaOHYtWRm/32ebl/to/tXe/n87/MER6ag0eh/BJgQlU2SUuUkSSkhhBBCCCGEuLtWPYtGS4UfiiE7I48url0Y3ng4AO8ffJ/E7MTSN+YzDjpPLfr573fgzAZdh6sziqJQ69NPUFlYoD4XxrjYo2x/oxMH3unKx/2b0qGhPQYqhSsJmSzad4XB3x/GZ1YgU387TeC5OHLy9VM7S4jKJkmpclKZmwGgzc1FW1Cg52iEEEIIIYQQouqo3aQGNetYUpCn4cye6wC82eZN3Gu4k5yTzAcHP0CjLUMh8C5Toe04QFtU+PzyrooJXAcMa9XCceq7ACR88w25V6/iamvG6Cfq8ctLvgR/2INvnm1JPy9nLI0NSMzIZc3xaF5ccQLvT3byysoTbAi+TnKm1KESjy5JSpWT+p+RUiCjpYQQQgghhBDivxRFwbtnHQBO771Ofm4hxmpj5naai4nahEMxh1gZvrIsDULvOdB0EGgKYO1IuH6igqIvP+vBgzHv2BFtXh4x06ahLfx3BJS1qSFPt3Thu+HeBH/Yg5Uv+jDKry61rE3Izi9k+9k43lofSpuZOxn6QxCL918lMkk+c4pHiySlykkxMkL5p3C1JkMK1QkhhBBCCCHEfzVo5YBVTVNyMwsIPxhT9JhNA95u+zYA80/O52zS2dI3qFLBwB+gQTfIz4JVz0D8+YoIvdz+O40vJ/Q0ycuW3fU4IwMVHd1r8snTzTg8tRtbJnfgte7uNKllVVSHKiKZz/46R+e5e+n19X6+2nGBM9fT0FaBlQiFKA+9J6Vu3LjB888/j52dHaampjRv3pwTJ/7NdGu1WqZPn06tWrUwNTXF39+fS5culWgjOTmZESNGYGVlhY2NDS+++CIZlZggul1XqlBGSgkhhBBCCCFECSqVQqt/RkuF7IqisLBout4QjyH41/GnQFPAu/vfJSs/q/SNGhjB0JXg0gayU+CXQZAaXRHhl5uhkxOO06YBkPDtd+ReuXLf4xVFoZmLNQE9PPj79Y4ceKcrM/p58kQDO9QqhQtxt/hu92X6LThI+893M+OPsxy+nEh+YRmmQQpRReg1KZWSkkL79u0xNDTk77//Jjw8nK+++ooaNWoUHzNnzhy+/fZbFi1axNGjRzE3N6dXr17k5OQUHzNixAjOnj3Lzp072bJlC/v37+fll1+utOtQWVgAMn1PCCGEEEIIIe6mUTsnTK2MyEjJ5dLxOKAo+TLjiRk4mjkSmR7JrKOzytaosQWMWA/2jSD9BqwZDnllSGxVIutBAzHv3OmfaXzvlakesautGS+0d2P1uHYEf+DP18O86N3MCVNDNTFpOSw/fI3nfjpKm5m7CFgbwrawm2TlSb1jUT3oNSn1xRdf4OrqyrJly/Dx8cHNzY2ePXvSoEEDoGiU1Pz58/nggw94+umnadGiBT///DMxMTFs2rQJgHPnzrFt2zZ++uknfH196dChA9999x1r1qwhJiamUq7j3xX4quYLoBBCCCGEEELok4GhmpbdXQE4uT0KraZo2pm1sTWfd/wclaJi85XN/B3xd9kaNrOF538DM3uIPQNbA6AKTmlTFIVan3yCytKSnNOnSVm16qHasTEzYqB3bb5/vjWnpvdgyeg2DGvjip25EWnZ+fx+6gbjfzmJ9yc7eWnFcdYdjyYpI1fHVyOE7ug1KfXHH3/Qpk0bhgwZgoODA97e3ixevLh4f0REBLGxsfj7+xc/Zm1tja+vL0FBQQAEBQVhY2NDmzZtio/x9/dHpVJx9OjRu/abm5tLenp6ia08/k1KyUgpIYQQQgghHmXR0dF06dIFT09PWrRowfr16/UdUrXRtJMLRiZqUm5mcu1MYvHjbZzaMK75OAA+CfqEuMy4sjVs4wrPLAVFBaG/wvGfdBm2zhg6OuLwZgAAyatXl7selImhmu5NHPnimRYce9+f9eP9GNfRjTq2ZuQWaNh1Lp53fjtN2892MXRRED8duEpUkgykEFWLXpNSV69e5fvvv8fd3Z3t27czYcIEXnvtNVasWAFAbGwsAI6OjiXOc3R0LN4XGxuLg4NDif0GBgbY2toWH/O/Zs+ejbW1dfHm6uparuuQpJQQQgghhBCPBwMDA+bPn094eDg7duxgypQpZMrngFIxNjWgWWcXAE5ujyyRlBnvNZ7m9s3JyM9gRfiKsjdevzP4f1z087apEHX3AQr6Zt2vH4qZGfmRUWSfOqWzdtUqhbb1bHm/jyf73u7CtikdCejhQTOXfwqlX0tm5tZzdJq7hyfn72fezoucjZFC6UL/9JqU0mg0tGrVilmzZuHt7c3LL7/MuHHjWLRoUYX2O23aNNLS0oq36OjyFcSTpJQQQgghhBCPh1q1atGyZUsAnJycsLe3Jzk5Wb9BVSMturmiNlARezWdm5fTih83UBkwwWsCABsubiAtN+1eTdzbE5PBcwBoCmDdKLhVxhFXlUBlbo5Vjx4ApG3aXCF9KIpCYycrXuvuzpbJHTk0tVuJQunnY2/xbeAl+nx7kA5f7OHjP89y5GoSBVIoXeiBXpNStWrVwtPTs8RjTZo0ISoqCih6kQeIiyv5YhIXF1e8z8nJifj4+BL7CwoKSE5OLj7mfxkbG2NlZVViKw+VuRkgSSlReRYuXEi9evUwMTHB19eXY8eOlfu8/fv3069fP5ydnVEUpbhumxBCCCFEdVKae5qHvZf6X8HBwRQWFpZ75sXjxNzamEZ+RZ/TTu6ILLGvg0sHPGp4kF2QzZrza8reuKLA0wuhZmPIiIX1o6EwXxdh65T1wAEApP/9N5r/LOBVUVxsTIsLpZ9435+vhnjR09MRE0MVN1KzWXboGs/+eIS2n+3i7fWh7AyPIye/sMLjEgL0nJRq3749Fy5cKPHYxYsXqVu3LgBubm44OTkRGBhYvD89PZ2jR4/i5+cHgJ+fH6mpqQQHBxcfs3v3bjQaDb6+vpVwFf8dKZVRKf2Jx9vatWsJCAjgo48+4uTJk3h5edGrV687krNlPS8zMxMvLy8WLlxYGZchhBBCCFEhHnRPU5p7qZYtW9KsWbM7tv8upJScnMyoUaP48ccfK/yaHjXePeqgKBB5JonE6/9+hlIUhbHNxgKw+vxqcgoeImFjbAHDfgFjK4gKgh0f6CpsnTHz8cGgVi00t26RsXt3pfZdw9yIwa1r8+OoNpz6sCc/jmzN4Fa1sTEzJCUrn/XB1xn38wm8P9nJ+JXB/H7yOqlZeZUao3i86DUp9cYbb3DkyBFmzZrF5cuXWb16NT/++CMTJ04Eil6UpkyZwsyZM/njjz84c+YMo0aNwtnZmQEDBgBFI6uefPJJxo0bx7Fjxzh06BCTJk3i2WefxdnZuVKuQ6bviQfx8PDAz8+P7Ozs4se0Wi3t2rVj2rRpZWpr3rx5jBs3jjFjxuDp6cmiRYswMzNj6dKl5Tqvd+/ezJw5k4EDB5b9AoWohmbPnk3btm2xtLTEwcGBAQMG3PFFiRBCiOrnQfc0pbmXCgkJISws7I7t9ueL3NxcBgwYwNSpU3niiSfuG4+uF1l6FNg4mFHfu6gu8Kn/GS3Vq14vXCxcSM5JZtPlTQ/Xgb07DPynJMzRRXB6XTmi1T1FpcK6f38AUjdXzBS+0jA1UtOzqRNfDfXixPv+rB7nywtP1MPFxpTs/EK2nY0lYF0orWfuYsRPR/g56Bo307If3LAQZaDXpFTbtm3ZuHEjv/76K82aNePTTz9l/vz5jBgxoviYd955h8mTJ/Pyyy/Ttm1bMjIy2LZtGyYmJsXHrFq1isaNG9O9e3eeeuopOnToUKnfWKgtLABJSol7W7t2LSdPnuTQoUPFj61atYrIyEjee+89Zs2ahYWFxX23qKgo8vLyCA4OLrEipUqlwt/fv3hFyrt52POEeJTt27ePiRMncuTIEXbu3El+fj49e/aUYrVCCPEI08U9kVar5YUXXqBbt26MHDnygcfrepGlR0WrXnUAuHQinvTEfxMdBioDRnmOAmD52eUUaAoeroPGfaDjW0U///EaxJ4pV7y6Zv300wBkHjxEQUKCnqMBA7WKJxrYM6N/Uw6+25UtkzvwWreGNHK0pFCj5dDlJKZvPovf7N08veAgC/dc5nL8LX2HLR4BBvoOoG/fvvTt2/ee+xVF4ZNPPuGTTz655zG2trasXr26IsIrldsjpQrlg0yl0mq1ZBfoJ1NvamCKoiilPt7b25uWLVty/vx5/P39ycrKYtq0acycORNLS0vGjx/P0KFD79uGs7Mz8fHxFBYW3nVFyvPnz9/z3MTExIc6T4hH2bZt20r8vnz5chwcHAgODqZTp056ikoIIURF0sU90aFDh1i7di0tWrQorle1cuVKmjdvftfjp02bRkBAQPHv6enpkpgCHOpa4dqkBtHnUgjZFU2nZz2K9w10H8ii0EXcyLjBjms7eKr+Uw/XSdf3IOYUXAmEtc/Dy3vBtIZuLqCcjOu7YeLVgpzQ06Rt2YrdmBf0HVIxRVFo5mJNMxdrAno24lpiJjvCY9l+No6TUSmEXk8j9Hoac7dfoH5Nc3p6OtGrqSNetW1QqUr/GUkIqAJJqUeBTN/Tj+yCbHxXV07dsP919LmjmBmalekcDw+P4qlBc+bMwd7enjFjxgBFiVVbW1udxymEKL20tKJVfu71t5ibm0tubm7x7zL9QgghHk8dOnRAoyn9KmXGxsYYGxtXYETVl3evukSfS+HcoRja9qmHqaURUPQF8HNNnmNhyEKWhi2lt1vvMn0hXEylhsE/wY+dIeUa/DYOnlsHKr1OGCpmM2AAsaGnSdu0qUolpf5XPXtzXu7UgJc7NSD+Vg67wuPZfjaWw1cSuZqQyaJ9V1i07wqOVsb08HSkV1MnfN3sMDKoGs+zqNrkX4kO/JuUytJzJKIqa9SoERcuXOD69evMnTuXr7/+GtU/b4ilnb5nb2+PWq2+74qUd/Ow5wnxuNBoNEyZMoX27dvTrFmzux4j0y+EEKL6k3uiqqV2oxo41LWkIF/D6T3XS+wb3ng4pgamXEi5wOGYww/fiZltUeFzAxO4vBP2fV7OqHXHqndvFENDci9cIOfcOX2HUyoOliY851uHFWN9OPlhD74d7k2fFrUwN1ITl57LL0eiGLnkGK1n7mTKmlP8feYmWXkPOQVTPBZkpJQOqMxkpJQ+mBqYcvS5o3rru6w8PDxYvHgxU6dOpWfPnnTp0qV4X2mn7xkYGNC6dWsCAwOLi/1rNBoCAwOZNGnSPc81MjJ6qPOEeFxMnDiRsLAwDh48eM9jZPqFEEJUf3JPVLUoioJ3z7psXxzGmb3X8e5ZByOToo+o1sbWDHYfzC/nfmFp2FLau7R/+I5qeUG/b2DjK7DvC3BuBY2e1NFVPDy1jQ0WXbtya8cO0jZtxqRJE32HVCaWJob093Kmv5czuQWFHL6cxPazsewMjyMpM49NITFsConB2EBFR3d7ejZ1wr+JI7bmRvoOXVQhkpTSAZm+px+KopR5Cp0+eXh4EB0dzYYNGwgLCyuxryzT9wICAhg9ejRt2rTBx8eH+fPnk5mZWTwVEGDBggVs3LiRwMDAUp+XkZHB5cuXi4+PiIggJCQEW1tb6tSpU55LF6JKmzRpElu2bGH//v3Url37nsfJ9AshhKgeHnRPU5p7KVF56nvXxNrBlLT4bMIPxtDS/9/7ztFNR7Pm/BqOxR4jLDGMZvZ3H81cKl7PwvUTcHwx/P4yvLwH7Bro4ArKx3rAgKKk1JYtOLz1Joqhob5DeijGBmq6Nnaga2MHPhuo5WRUCtvDYtkeHkt0cja7zsWz61w8KgV83Gzp6elEz6aO1K5RfT7PiYohSSkdkKSUKA0Pj6LijZMmTaJhw4YP3c6wYcNISEhg+vTpxMbG0rJlS7Zt21aiYGdiYiJXrlwp03knTpyga9euxcffHhEyevRoli9f/tDxClFVabVaJk+ezMaNG9m7dy9ubm76DkkIIYQOPOiepjT3UqLyqFQKrXrWZc8v5wnZFU3zLrVR/1OLyMnciafqP8UfV/5gadhS5nWZV77Oes2C2NMQfbSo8PlLu8DIXAdX8fAsOnZAbWtLYVISGQcPYvmff7vVlVql0LaeLW3r2fJ+nyacj73F9rNFhdLP3UznyNVkjlxN5pMt4TRzsaKXpxM9mzrh4WjxcLXDRLWmaLVarb6D0Lf09HSsra1JS0vDysqqzOfnx8VzuXNnUKlofDZM/pAqSE5ODhEREbi5uWFiYqLvcMosOTkZOzs7QkNDadGihb7DEY+o+/2dlPe17lHz6quvsnr1ajZv3kyjRo2KH7e2tsbU9MFTdOX5FEI8LuT1Trfk+bxTYb6Gnz84TFZaHt1GNaHJE7WK911OuczAPwaioLB5wGbcrMv5JVL6zaLC5xlx0GwwDF4Cev78FjtrFik/r8TyySepPf9rvcZS0aKTs9h+NpYdZ+M4HpnMf7MR9ezM6NW0KEHl7Sor+VV3pX2tk0LnOqC2+Ce7rtGgzc7WbzCiygoNDcXIyIgm1WyuuBCPqu+//560tDS6dOlCrVq1ire1a9fqOzQhhBDisaI2VOHVvahO46kdkWg1/2YqGtZoSJfaXdCiZcXZFeXvzKoWDFkBKgMI+w2OfF/+NsvJ5p/6ZhmBgRT+sxrwo8rV1oyXOtZn3Xg/jr/vzxeDm9OtsQNGahXXkrL4Yf9VBn9/GN/Zgby38Qz7LiaQV1D61S5F9SNJKR1QzMyKs+syhU/cS2hoKJ6enhhW03niQjxqtFrtXbcXXnhB36EJIYQQj51mHV0wMjUgJTaL6xdTSuwb23wsAH9c+YOErITyd1bXr2gqH8COD+DavRc6qQzGTZpg7OGBNj+f9L+36TWWymRvYcywtnVY+kJbTk7vwYLnvOnn5YylsQEJt3JZfTSK0UuLVvJ7fc0p/jpzk8xcWcnvUSNJKR1QFAWVWVGBNklKiXuZMmUKp06d0ncYQgghhBBCVDlGpgY08K4JQOSZpBL7vB288XbwJl+Tz8pzK3XToc/L0HwoaAth3WhIjdJNuw9BURSsn34agLRNm/QWhz5ZGBvQt4Uz3w335sSH/iwf05bhPnWwtzDmVk4Bm0NieHXVSbw/3clLK46z7kQ0yZl5+g5b6IAkpXTkdrHzQklKCSGEEEIIIUSZ1W1mB0BkWNId+8Y2Kxottf7Cem7l3Sp/Z4oC/b4Bp+aQlQi/Pge5GeVv9yFZ9esLKhXZISHkRkToLY6qwNhATZdGDswe1Jyj73Vnw3g/xnV0o46tGXkFGnadi+edDadpM3Mnw34IYunBCG6kShmd6kqSUjoiK/AJIYQQQgghxMOr3cQWlUohNS6LtISsEvs61e5EQ5uGZORnsPaCjuo/GpnBs7+CeU2IOwMbXwGNfuoXGTo4YN6hPQBpf/yhlxiqIrVKoU09W97v48m+t7vw9+sdecPfA89aVmi0cDSiaBW/9p/vpu93B/gu8BIX424h67lVH5KU0hFJSgkhhBBCCCHEwzM2NaBWQ2sAIsOSS+xTKSrGNBsDwC/hv5BbmKubTm1cYdgqUBvB+S2wd7Zu2n0IxVP4Nm9Gq6fkWFWmKApNalnxur87f73ekQPvdOWDPk3wqWeLokDYjXS+2nmRnl/vp9tX+5j99zlORqWg0UiCqiqTpJSO/JuUynrAkUIIIYQQQggh7qbOfabw9XbrjZO5E0k5SfxxRYejier4Fk3lA9g/p2hVPj2w7N4dlYUFBTE3yTp+Qi8xVCf/u5Lf54Oa07VRTYzUKiISM/lh31UG/d9h/D4P5INNZzhwKYH8Qkn2VTWSlNKR4qRUhv7mIQshhBBCCCFEdXa7rtSNiynk5xWW2GeoMmSU5ygAloctp1BTeMf5D63lc/DE5KKfN70KN07qru1SUpmYYNX7SeDxLXj+sOwtjHnWpw7LxvgQ/KE/3w33pm+LWlgYGxCXnssvR6IYueQYrT/dyRtrQ9gWdpOsPFnJryqQpJSOyPQ9IYQQQgghhCgf21rmWNqaUJiv4caFlDv2D3YfjLWxNVG3ogiMCtRt5/4fg3tPKMiBNc9B+k3dtl8K1gMGAHBr+3Y0WTIL52FYmhjSz8uZBc+1IvhDf5a90JZn27piZ25Eek4BG0/dYPwvJ2n16U7G/XyCDcHXSc2Slfz0RZJSOqKykKSUEEIIIYQQQpSHoijFo6Wi7jKFz8zQjOGNhwOwNGypbgtaq9QweAnUbAy3bhYlpvIrd1U301atMHR1RZOVxa1duyq170eRsYGaro0d+HxwC46978+6V/x4sYMbtWuYkpOvYWd4HG+tD6X1zF2M+OkIPwddIzYtR99hP1YkKaUjahkpJYQQQgghhBDldjspdS0s6a5Jp+caP4eJ2oSzSWc5GntUt52bWMHwX8G0BsSchD8mQyWu5KYoyr8Fz2UKn06pVQo+brZ82NeTA+905a/XOvJ6d3caO1lSqNFy6HIS0zefpd3sQJ5eeIj/23uZKwlSnqeiSVJKR4qn72VJUkoIIYQQQgghHpZLoxqoDVTcSsohNe7OKWw1TGow0H0gAEvPLNV9ALb1YejPoDKAM+vh4Ne67+M+rAcUJaUyg46Qf7PypxA+DhRFwdPZijd6eLBtSif2vd2F959qQuu6NVAUCI1OZc62C3T/ah/+8/Yxd/t5Tl9P1e3IPAFIUkpnpKaUEEII8eiSm1AhhKg8hsZqXDxsALh25s4pfACjm45GragJuhlEeFK47oNw6wS95xT9HPgJnP9L933cg1Ht2pi1aQNaLWl/bqm0fh9nde3MGdepPr9NeIKj73Xns4HN6ORRE0O1wuX4DBbuuUL/BYdo//luZvxxlsNXEimQlfx0QpJSOnI7KVUoSSlRCRYuXEi9evUwMTHB19eXY8eO6eS8B+3fv38//fr1w9nZGUVR2CRDioUQj4GfDlzF44O/Gb30GH+duUlegdyECiFERavzzxS+yLvUlQJwsXDhSbeileqWhS2rmCDavghtXwK08Ps4iDtbMf3cxe3RUmmbNskXI5XMwdKEEb51+XmsD8Ef9uCbZ1vyVHMnzIzUxKTlsPzwNZ5bfJS2n+3irfWh7AyPIydfhytBPmYkKaUjMlJKVJa1a9cSEBDARx99xMmTJ/Hy8qJXr17Ex8eX67zStJuZmYmXlxcLFy6s0GsUQoiqRK1SyC/Usu9iAq+uOonf7EA+2xrO5fhb+g5NCCEeWbfrSt28nEpedsFdjxnTdAwAOyJ3EJ0eXTGBPPl50aipvAz49VnITKyYfv6H5ZNPopiYkHf1KjlhYZXSp7iTlYkhT7d04f9GtObkhz34aVQbhrSuTQ0zQ1Ky8tkQfJ1xP5+g1ac7mfBLMJtO3SAtO1/fYVcrkpTSkX+TUrJsp7iTh4cHfn5+ZGf/u3qHVqulXbt2TJs2rUxtzZs3j3HjxjFmzBg8PT1ZtGgRZmZmLF16//n0DzqvNO327t2bmTNnMnDgwDLFLIQQ1dlov3oM9HYp/j0pM4/FByLwn7efwd8fZt3xaDJz7/6BSQghxMOxcTDD2sEUTaGW6+dT7npMI9tGdHDpgEarYUX4iooJRG0IQ1ZADTdIjYK1I6Egr2L6+m+3FhZY+vsDkLZxU4X3Jx7MxFCNv6cjc4d4cfx9f34d144XnqiHs7UJWXmF/B0Wy5S1IbSZuZNRS4+x6mgk8bdkJb8HkaSUjhQnpTKkOn9l0Wq1aLKy9LKVdQjt2rVrOXnyJIcOHSp+bNWqVURGRvLee+8xa9YsLCws7rtFRUWRl5dHcHAw/v+8QQGoVCr8/f0JCgq6Z/8POu9h2xVCiMeBSqUw55kW+DdxKH7M1dYUtUohODKFd347jc9nu5j622lORqXINAshhNCRusVT+O49Omlss7EAbLy0kcTsChrFZGYLz60FYyuIOgx/vVkpK/LdXoUvfetWNHkVnwgTpWegVuHXwI4Z/ZtyaGo3/pzUgUldG+LuYEF+oZb9FxN4f2MYvrMCGfz9YX7cf4XIJJlVdTcG+g7gUaEytwBk+l5l0mZnc6FVa7303ehkMIqZWamP9/b2pmXLlpw/fx5/f3+ysrKYNm0aM2fOxNLSkvHjxzN06ND7tuHs7Ex8fDyFhYU4OjqW2Ofo6Mj58+fveW5iYuJ9z3vQfiGEeNwZqlUseK4Vo5Ye41hEMlm5hax6yZeTUSmsOx7NtaQs1hyPZs3xaDwcLRjWtg4DvV2wNTfSd+hCCFFt1W1mx+nd14kMS0Kr1aIoyh3HtHFsQwv7FpxOPM2v539lsvfkigmmZiN4ZimsHgonfwaHptBufMX09Q/zJ/wwcHCgID6ejH37sOrRo0L7Ew9HURSa17ameW1r3urViKsJGWw/G8e2s7GERqcSHJlCcGQKs/46T2MnS3o2daJXU0c8a1nd9d/040ZGSumI1JQSD+Lh4cGFCxcAmDNnDvb29owZUzQP3tbWloYNG953MzCQHLIQQuiTiaGan0a3oZmLFUmZeby5LpSB3i7seasLa15uxyBvF4wNVFyMy+DTLeG0mxXIxNUn2X8xAY1GRk8JIURZObvbYGCkIjMtj6Qbd5+RoigKo5uOBuD3S7+Tr6nAej7uPaDHJ0U/b58GlwMrri9AUaux7t8PgLRNmyu0L6E79WtaMKFLAzZPbM+Rad355OmmtG9oh1qlcD72Ft8GXqLPtwfpNHcPM7eEc/xaMoWP8X2CfMrVEZV50agZbW4u2oICFEkgVDjF1JRGJ4P11ndZNWrUiP3793P9+nXmzp3L1q1bUamK8sKzZs1i1qxZ9z0/PDwcJycn1Go1cXFxJfbFxcXh5OR0z3Pt7e3ve96D9gshhChiZWLIijE+DPkhiKsJmTz/01HWj3+CdvXtaFffjo/6N+WP0BjWHo8i7EY6W0/fZOvpm7jYmDKkTW2GtHHFxabs7yFCCPE4MjBUU7uxLddOJxIZloR9bcu7Hte1TlfsTe1JzE5kb/ReetStwBFFfpMg/hyErIL1Y2BcINi7V1h31k8/TdJPS8jYt4+C5GQMbG0rrC+he07WJozyq8cov3qkZuUReC6e7Wdj2X8pgejkbH46GMFPByOwtzCih6cjPZs68UQDO4wN1PoOvdLISCkdUf8zUgpktFRlURQFlZmZXraHGWZ5e6TU1KlT6dmzJ126dCneN378eEJCQu67OTs7Y2RkROvWrQkM/PdbGY1GQ2BgIH5+fvfs+0HnPWy7QgjxOLKzMGbli77UsjbhSkImLyw7RsY/hc6tTQ0Z2a4uWyZ3ZMvkDozyq4uViQE3UrOZv+sSHb7Yzailx/jrzE3yCjR6vhIhhKj6/q0rlXTPYwxVhgxsWLQQz/oL6ys2IEWBvl+Dqy/kpsHqYZCVXGHdGbu7Y9K0KRQUkL71rwrrR1Q8GzMjBreuzY+j2nDywx4ser41g7xdsDIxIDEjj1+PRTNm2XHafLqLyb+eYsvpmOL7i0eZDOfREcXICMXQEG1+PprMTNTW1voOSVQxHh4eREdHs2HDBsL+Z1lXW1tbbEv5rUdAQACjR4+mTZs2+Pj4MH/+fDIzM4unAgIsWLCAjRs3lkgyPei80rSbkZHB5cuXi3+PiIggJCQEW1tb6tSp81DPixBCVEcuNqasfNGXoT8Ecfp6GuNWnGDZmLaYGP77zWYzF2uauVjz3lNN2BYWy9rj0QRdTWL/xQT2X0zA1tyIQd4uDGvrirvj3b/9F0KIx93tpFTslTRyMvMxMTe863GDPQbz05mfCLoZRFR6FHWsKvDe1MAYhq2CxV0h+QqsHw3P/160Ul8FsB4wgJyzZ0nbtAnbkc9XSB+icpkZGfBkMyeebOZEfqGGI1eT2H42lh1n44i/lcufoTH8GRqDkYGKjg3t6dXUCX9Px0eyVqUkpXRIZW5OYWqqjJQSd+Xh4QHApEmTaNiw4UO3M2zYMBISEpg+fTqxsbG0bNmSbdu2lShSnpiYyJUrV8p0XmnaPXHiBF27di3+PSAgAIDRo0ezfPnyh74mIYSojho6WLBijA/DFx8h6GoSk389xfcjWmGgLjkQ3cRQzQBvFwZ4u3AtMZP1wdGsP3Gd+Fu5xcP2W9WxYVhbV/q2cMbcWG7PhBDiNktbE2ydzUmOyST6XDLubRzvepyLhQvtXdpz8MZBNlzaQEDrgIoNzKImDF8DS3tBxH746+2iEVQVULjaqs9TxH3xBTlnz5J76RLG7hU3XVBUPkO1io7uNenoXpNP+jcj5HpqcYIqIjGTwPPxBJ6PR/U7tK1nS6+mTvRq5vTIlANQtLJuMenp6VhbW5OWloaVldVDt3O5uz/5N25Qb82vmLZsqbsABQA5OTlERETg5uaGiYmJvsMps+TkZOzs7AgNDaVFixb6Dkc8ou73d6Kr1zpRRJ5PcduRq0mMWnqMvAINg1vVZu4zLVCp7v+hpKBQw76LCaw5Hs3u8/HFBU7NjdT0beHMMB9XvF1tZFUeUSXI651uyfNZdod/v8ypHVE0aueE/wue9zxud9RuXt/zOrYmtux6ZheGFTRyqYQLf8OvwwEt9J4Dvq9USDfREyeRERiI3Usv4vDWWxXSh6hatFotl+Iz2B4Wy7azsZyNSS+xv5mLFb08i0ZbNXSwqHL3DKV9rZOaUjp0ewW+wgwZKSXuFBoaipGREU2aNNF3KEIIIXSoXX07Fj7XCrVK4beT15m59RwP+s7PQK2iexNHFo9qQ9DUbrz7ZGPc7M3JzCtk7YloBv3fYXp+vZ+fDlwlOTOvkq5ECFFaWVlZ1K1bl7ckOVApbk/hizqbhPY+q5R1qt0JBzMHknOSCYyq2JXxijXq/e+KfNumwqVdFdKN9dP9AUj7c8sD32PEo0FRFDwcLZnc3Z2tr3XkwDtd+bCvJz5utqgUCLuRzlc7L9Lj6/10/2ofn/99nlNRKdVuxV+9JqVmzJiBoigltsaNGxfvz8nJYeLEidjZ2WFhYcHgwYPvWB0sKiqKPn36YGZmhoODA2+//TYFBfopBqaysACk0Lm4u9DQUDw9PTE0rIRvbIQQQlSqHp6OzH2maBTs0kMRLNh9+QFn/MvByoQJXRqw+83OrH25HYNauWBiqOJSfAYzt57Dd9YuJq46yb6LCY/1ktFCVCWfffYZ7dq103cYjw2nBtYYmajJvpVPfOStex5noDJgkPsgANZdXFdZ4cETk6Hl86DVwIYxkHBB511YdOmCYmJCQVwcef9TpkM8HlxtzXixgxvrXvHj+Pv+fDG4Od0aO2CkVnE1MZNF+64w8P8O4/d5IB9uCuPgpUTyC6v+oip6HynVtGlTbt68WbwdPHiweN8bb7zBn3/+yfr169m3bx8xMTEMGjSoeH9hYSF9+vQhLy+Pw4cPs2LFCpYvX8706dP1cSnFI6UkKSXuZsqUKZw6dUrfYQghhKggg1rVZnrfomklX+28yM9B18p0vqIo+Na3Y97Qlhx735+ZA5rR3MWa/EItW8/cZPTSY3Sas4evd17kekpWBVyBEKI0Ll26xPnz5+ndu7e+Q3lsqNUqXD2LFgWKDEu877GD3QejUlQcjz1ORFpEZYT3z4p886DOE5CbDquH6nxFPpWREWatvAHIPHpUp22L6sfOwphhbeuw9IW2nJzegwXPedO3RS0sjA2IS89l5ZFInl9ylDYzdxGwNoRtYbFk5xXqO+y70ntSysDAACcnp+LN3t4egLS0NJYsWcK8efPo1q0brVu3ZtmyZRw+fJgjR44AsGPHDsLDw/nll19o2bIlvXv35tNPP2XhwoXk5VX+UHdJSgkhhBCPt7Ed3Hi9e1EB2umbz7I55MZDtWNlYsjz7ery5+QObH2tA6P96mJlYsCN1Gy+CbxExzl7GLnkKFtP3yS3oGreZAqhD/v376dfv344OzujKAqbNm2645iFCxdSr149TExM8PX15dixY2Xq46233mL27Nk6iliU1u0pfJFhSfc9zsnciU4unQDYcHFDhcdVzMAYhq0Em7qQcg3WjoQC3X4mNfPxBSDriCSlxL8sjA3o28KZBc+1IvhDf5a90JZn27piZ25EWnY+v5+6wfhfgvH+dAcv/3yC309eJy0rX99hF9N7UurSpUs4OztTv359RowYQVRUFADBwcHk5+fj7+9ffGzjxo2pU6cOQUFBAAQFBdG8efMSq4P16tWL9PR0zp49e88+c3NzSU9PL7HpgsrcDJCklBBCCPE4m+Lvzmi/ugC8uS6U3efjHnDG/TV1tubjp5tx7H1/vnm2JU80sEOrhQOXEpm4+iTtZgXy6ZZwLsbde0qLEI+LzMxMvLy8WLhw4V33r127loCAAD766CNOnjyJl5cXvXr1Ij4+vviYli1b0qxZszu2mJgYNm/ejIeHR/GqyqLy1GlalJSKj7xFVvr9kz1DGg0BYPOVzeQW5lZ4bMXM7eG5tWBkCZEH4a83QYf1n8zb/ZOUOnYMrabqT8sSlc/YQE3Xxg58PrgFx973Z90rfrzYwY3aNUzJydewIzyOgHWhtJ65k+d/OsrKoGvEpuXoNWa9rjns6+vL8uXLadSoETdv3uTjjz+mY8eOhIWFERsbi5GRETY2NiXOcXR0JDY2FoDY2NgSCanb+2/vu5fZs2fz8ccf6/ZikJFSQgghhCiahvdRv6akZeezKSSGCb+cZOWLvvi42ZarXRNDNU+3dOHpli5EJmWy/sR11gdHE5eey5KDESw5GIF3HRuGtXGlr5czFsZ6vc0TQi969+5932l18+bNY9y4cYwZMwaARYsWsXXrVpYuXcrUqVMBCAkJuef5R44cYc2aNaxfv56MjAzy8/OxsrK6b/mQ3NxccnP/TYzo6gvxx425tTE161iSEHWLqPAkGrerdc9j2zu3p5Z5LW5m3mRn5E761u9beYE6NIEhy4qm8J38GWo2Ab9XddK0SdOmqMzMKExLI/fCBUxkASVxH2qVgo+bLT5utnzQpwnhN9PZfjaO7WGxXIi7xcHLiRy8nMiHm8/S0tWGXk2d6NXUkfo1LSo1Tr2OlOrduzdDhgyhRYsW9OrVi7/++ovU1FTWravYonTTpk0jLS2teIuOjtZJu5KUEkIIIQSASqUwd4gX3Rs7kFug4cXlxwm7kaaz9uvamfNWr0YcercbS0a3oaenIwYqhVNRqUz9/Qw+n+3inQ2hBEemyCpNQvwjLy+P4ODgEjMxVCoV/v7+xTMxHmT27NlER0dz7do1vvzyS8aNG/fAerazZ8/G2tq6eHN1dS3XdTzOSjuFT61SFxc8X39hfYXHdQf3HtBzZtHPO96Hizt00qxiaIhp2zYAZMoUPlEGiqLQ1NmagB4ebH+jE3vf6sK03o1pVccGgJDoVL7Ydp5uX+2jx7x9fLn9Ameup1XKPYTep+/9l42NDR4eHly+fBknJyfy8vJITU0tcUxcXBxOTk4AODk53bEa3+3fbx9zN8bGxlhZWZXYdEEtSSkhhBBC/MNQrWLhiFb4uNlyK7eA0UuPcTUhQ6d9GKhVdG/iyI+j2nB4Wjem9m5MfXtzsvIKWXfiOoO/P0yPr/fz04GrJGVU4hQWIaqgxMRECgsL7zrT4n6zLMqror4QfxzdTkpFhyejecCqYoPcB6FW1JyMP8nllNKviKoz7V6FVqP+WZFvLMSf00mz5rfrSkmxc1EO9ezNeaVzA35/tT3H3uvOzAHN6Ohuj4FK4VJ8Bgv2XKbfgoN0+GIPM/44y5Gr908El0eVSkplZGRw5coVatWqRevWrTE0NCQwMLB4/4ULF4iKisLPzw8APz8/zpw5U2IO+M6dO7GyssLT07PS4789UqowU7c3nEIIIYSonkwM1fw0ug1Nna1Iysxj5JJj3EzLrpC+HCxNGN+5AYFvdmbdK34MblUbE0MVl+MzmLn1HO1mB/LqqmD2XoinUCOjp4QorxdeeIEvv/zygcdV1BfijyOHelYYmxuQm1VAbMT9p0E6mDnQxbULABsuVWLB89sUBZ76Cup2gLxbsHoYZN5/5cDSMLtdV+r4cbQFBeVuTwgHKxOeb1eXlS/6EvxBD74e5sWTTZ0wNVRzIzWb5Yev8fnf5yusf70mpd566y327dvHtWvXOHz4MAMHDkStVjN8+HCsra158cUXCQgIYM+ePQQHBzNmzBj8/Pxo164dAD179sTT05ORI0cSGhrK9u3b+eCDD5g4cSLGxsaVfj0qi6K5lzJSSgghhBC3WZkYsmKsD/XtzbmRms3zPx0lObPiVglWlKIaEl8N9eLY+/58NrAZLWpbk1+o5a8zsbyw7Dgdv9jNvJ0XiU7OqrA4hKhq7O3tUavVd51pcb9ZFqLqUKkU6niWbgofwBCPooLnf1z5g+yCivlC4L4MjIpW5KvhBqmRsPZ5KCjfqFWTxo1RWVujycwkJzxcR4EKUcTazJCB3rVZNLI1p6b34MeRrRncqjaDW9eusD71mpS6fv06w4cPp1GjRgwdOhQ7OzuOHDlCzZo1Afj666/p27cvgwcPplOnTjg5OfH7778Xn69Wq9myZQtqtRo/Pz+ef/55Ro0axSeffKKX6/m3ppTc4AkhhBDiX/YWxqx8yZda1iZcScjkhWXHyMit+G+4rUwMGeFblz8mdeCv1zrywhP1sDY1JCYth28DL9Fp7h5GLjnKltMx5BYUVng8QuiTkZERrVu3LjETQ6PREBgYWDwTQ1R9pa0rBeDn7IeLhQu38m6x/dr2ig7t7sxsi1bkM7aCqCDYElCuFfkUtRozqSslKoGJoZqeTZ34aqgXI9vVrbB+9JqUWrNmDTExMeTm5nL9+nXWrFlDgwYNivebmJiwcOFCkpOTyczM5Pfff7/jW4y6devy119/kZWVRUJCAl9++SUGBvpZbUZlJjWlhBCiuti/fz/9+vXD2dkZRVHYtGmTvkMSjzgXG1NWvuiLrbkRp6+nMW7FCXLyKy8R5OlsxYz+TTn6Xne+ebYl7RvaodXCgUuJTFp9inazAvnkz3AuxN6qtJiE0LWMjAxCQkKKV9CLiIggJCSEqKgoAAICAli8eDErVqzg3LlzTJgwgczMzOLV+ETVV6epLSiQdD2DjJT7jzpSKSqe8XgGgPUX9VDw/LaajYpW5FNUEPILHP6uXM2Z+xbNHMo6ckQX0QmhV1WqplR1J6vvCSFE9ZGZmYmXlxcLFy7UdyjiMdLQwYIVY3ywMDYg6GoSk389RcEDivXqmomhmqdburDqpXbsf7srk7s1xMnKhJSsfJYeiqDX/P0MWHiIX49FVcpoLiF06cSJE3h7e+Pt7Q0UJaG8vb2LV8gbNmwYX375JdOnT6dly5aEhISwbdu2O4qfi6rL1MIIJ7eiulxRZx88WmpAwwEYKAacTjjNheQLFR3evTX0hyc/L/p553S48PdDN2Xm6wNA1smTaPMqbjq4EJVBklI6JEkpISpGly5dmDJlyh0/P+oep2vVh969ezNz5kwGDhyo71DEY6Z5bWsWj2qDkYGKneFxTP39DBo9FR6vY2fGmz0bcWhqN5a90JZeTR0xUCmERKcy7fcz+Hy2i7fXhxIcmVwpy0ILUV5dunRBq9XesS1fvrz4mEmTJhEZGUlubi5Hjx7F19dXfwGLh3J7Ct+1Mw8uHG5vak+3Ot0APY+WAvB5GdqMBbTw20sQG/ZQzRi7u6O2tUWbk0P26dO6jVGISiZJKR36b1JKbtxERVq4cCH16tXDxMQEX19fjh07ppPzHrS/Kkx3+v333/n0008rvV8hcnNzSU9PL7EJ8bD8GtixYLg3apXChuDrzNx6Tq/3DmqVQtfGDvwwsg1B07ozrXdj6tubk5VXyPrg6wz+Pgj/eftYvP8qiRnlK9IrhBDlVbeZPQDXz6dQmP/g0aZDGhUVPN9ydQtZ+Xqs/6so0HsOuHWCvAz49VnIiH/weXc0oxSPlso8KnWlRPUmSSkdup2UQqNBm5Oj32DEI2vt2rUEBATw0UcfcfLkSby8vOjVqxfx8fd/Q3vQeaVpVxfTnbp06VLi28qysrW1xdLS8qHPryryZKh1tTN79mysra2LN1dXV32HJKq5nk2dmDO4BQBLD0WwYPdlPUdUpKalMa90bkDgm51ZP96PZ1rXxtRQzZWETD776xztZgUy4Zdg9lyIp1BPI7yEEI83+9oWmFkZkZ9bSMyV1Ace7+PkQx3LOmTmZ/J3xMNPm9MJtSEMWQG2DSAtumhFvvyyf3b8t66UJKVE9SZJKR1SmZkW/yxT+MR/eXh44OfnR3b2v0vRarVa2rVrx7Rp08rU1rx58xg3bhxjxozB09OTRYsWYWZmxtKlS8t1XmnarQrTnf53SluXLl147bXXeOedd7C1tcXJyYkZM2aUOEej0TB79mzc3NwwNTXFy8uLDRs2lDhmw4YNNG/eHFNTU+zs7PD39yfzn7/jB52/bds2OnTogI2NDXZ2dvTt25crV67cEfekSZOYMmUK9vb29OrVq7jtOXPm0LBhQ4yNjalTpw6fffZZidjvd22i8kybNo20tLTiLTo6Wt8hiUfA4Na1md7XE4Cvdl5kZdA1/Qb0H4qi0LaeLV8O8eLY+92ZNbA5XrWtKdBo+TssljHLjtPhi93M23mR6GRZeVgIUXkUlUKdMqzCp1JUDPEoGi2l9yl88O+KfCbWEH0U/ny9zCvy3R4plR0SgkYGRIhqTJJSOqSoVKjMzADQZGToOZpHn1arJT+3UC9bWadYrF27lpMnT3Lo0KHix1atWkVkZCTvvfces2bNwsLC4r5bVFQUeXl5BAcH4+/vX9yOSqXC39+foKCge/b/oPMett2qYsWKFZibm3P06FHmzJnDJ598ws6dO4v3z549m59//plFixZx9uxZ3njjDZ5//nn27dsHwM2bNxk+fDhjx47l3Llz7N27l0GDBhX/f37Q+ZmZmQQEBHDixAkCAwNRqVQMHDgQjUZzR5xGRkYcOnSIRYsWAUWJjs8//5wPP/yQ8PBwVq9eXaLY6oOuTVQeY2NjrKysSmxC6MLYDm681t0dgOl/nGVzyA09R3QnSxNDnvOtw+ZJHfj79Y688EQ9rE0NuZmWw7eBl+g0dw8jlxzlz9AYcgsqb0VBIcTjq27ToqRUVCmSUgBPN3waQ5UhZ5POEp4UXpGhlY69e9GIKUUNp9fAwXllOt2oXj0MHB3R5ueTfepUBQUpRMUz0HcAjxqVhQWarCwKZaRUhSvI0/Dj6/v00vfL33TG0Fhd6uO9vb1p2bIl58+fx9/fn6ysLKZNm8bMmTOxtLRk/PjxDB069L5tODs7Ex8fT2Fh4R0rxDg6OnL+/Pl7npuYmHjf8x60v6pr0aIFH330EQDu7u4sWLCAwMBAevToQW5uLrNmzWLXrl34+fkBUL9+fQ4ePMgPP/xA586duXnzJgUFBQwaNIi6desC0Lx5c4BSnT948OAS8SxdupSaNWsSHh5Os2bNih93d3dnzpw5xb/funWLb775hgULFjB69GgAGjRoQIcOHUp1bUKIR8cb/u6kZeWxIiiSN9eFYmViSNfGDvoO666a1LJiRv+mTO3dmB3hcaw7Hs3By4kcuFS02ZgZMtDbhWFtXWnsJMlbIUTFcPW0RVEppMRmkZaQjXVN0/seX8OkBv51/fk74m/WX1zPR34fVVKk99GgKzw1B7a+CYGfgJ07ePYv1amKomDezpe0zX+QeeQo5v/cpwpR3chIKR2TFfjEvXh4eHDhQtEytHPmzMHe3p4xY8YARXWSGjZseN/NwKB65pD/dxTYgQMHGD9+/B2jwMqjRYsWJX6vVatWcS2sy5cvk5WVRY8ePUr0+fPPPxdPsfPy8qJ79+40b96cIUOGsHjxYlJSUkp9/qVLlxg+fDj169fHysqKevXqAdxxXa1bty7x+7lz58jNzaV79+4PdW2ifDIyMggJCSEkJASAiIgIQkJCyv3vUYiHoSgKH/VrytMtnSnQaBn/SzDHIpL1HdZ9mRiq6e/lzC8v+XLgna681q0hTlYmpGbls+zQNZ6cf4CnFx7i12NR3MrJ13e4QohHjLGpAbUaWAMQdbZ0o6VuT+HbenUrGXlVZGZL25eKVuUD2PgK3Awt9almPkUrR2ZJsXNRjVXPT7lVmCSlKo+BkYqXv+mst77LqlGjRuzfv5/r168zd+5ctm7dikpV1M6sWbOYNWvWfc8PDw/HyckJtVpNXFxciX1xcXE4OTnd81x7e/v7nveg/eXxv6PARowYweDBgxk0aFDxY87OzuXqw9DQsMTviqIUT53L+Gcq7datW3FxcSlxnLGxMQBqtZqdO3dy+PBhduzYwXfffcf777/P0aNHS3V+v379qFu3LosXL8bZ2RmNRkOzZs3uKGZufnsxhH+Ymt7/G70HXZsonxMnTtC1a9fi3wMCAgAYPXp0uYrxC/GwVCqFL4d4cSungN3n43lx+XF+fbkdzVys9R3aA7namhHQsxGv+3uw/2ICa49Hs+tcHKHRqYRGp/LJn+H0bVGLYW1daV23Boqi6DtkIcQjoG4zO2IupRIZlkTzLrUfeHwbxza4WbsRkRbBXxF/MbTR/WcqVJpesyHpMlzZDb8Oh3G7wfLB9+Dm7YqSUtlnzlCYkYnawvwBZwhR9chIKR37NyklBT8rmqIoGBqr9bI9zM307ZFSU6dOpWfPnnTp0qV43/jx44tHbNxrc3Z2xsjIiNatWxMYGFh8rkajITAwsHhq2d086LyHbbc0/ncUmKmpKQ4ODpU2CszT0xNjY2OioqLuGH3239XTFEWhffv2fPzxx5w6dQojIyM2btz4wPOTkpK4cOECH3zwAd27d6dJkybFo6wexN3dHVNT0xLPu6g8Xbp0QavV3rFJQkrok6Faxf+NaIVPPVtu5RYweukxriZUkW/zS0GtUuja2IFFI1sTNK077z3VmAY1zcnOL2R98HWeWRSE/7x9/Lj/CokZufoOVwhRzdX9p9j59QspFOQ9uJ6doiglCp6XtU5shVEbwDPLwN4D0m/AmucgP/uBpxm6uGBYuzYUFpJ9MrgSAhVC92SklI7JSClxLx4eHkRHR7NhwwbCwsJK7LO1tcXW1rZU7QQEBDB69GjatGmDj48P8+fPJzMzs3gqIMCCBQvYuHFjiWTHg84rTbsZGRlcvvzvkuW3pzvZ2tpSp06dh3peKpqlpSVvvfUWb7zxBhqNhg4dOpCWlsahQ4ewsrJi9OjRHD16lMDAQHr27ImDgwNHjx4lISGBJk2aPPD8kSNHYmdnx48//kitWrWIiopi6tSppYrNxMSEd999l3feeQcjIyPat29PQkICZ8+e5cUXX6zgZ0YIUVWZGKr56YU2PPvDEcJvpjNyyTE2TPCjlvWDR1dWJTUtjXm5UwPGdaxPcGQKa49Hs+X0Ta4kZDLrr/PM2XYB/yaODPNxpZN7TdQqGT0lhCgbW2dzLGoYk5GSy42LqcVJqvvp36A/84Pncz75PGGJYTSv2bwSIi0FUxsYvgZ+6g43gmHzRBi8BB7wZbhZO1/SNlwn88hRLDp1qpxYhdAhSUrpmCSlxL14eHgAMGnSJBo2bPjQ7QwbNoyEhASmT59ObGwsLVu2ZNu2bSWKlCcmJhbXOyrteaVpt7pOd/r000+pWbMms2fP5urVq9jY2NCqVSvee+89AKysrNi/fz/z588nPT2dunXr8tVXX9G7d+8Hnq9SqVizZg2vvfYazZo1o1GjRnz77bclRsLdz4cffoiBgQHTp08nJiaGWrVqMX78+Ip6KoQQ1YSViSE/v+jD0EVBXE3MZOSSY6x7xQ9bcyN9h1ZmiqLQpp4tberZMr2fJ3+G3mTtiWhCo1PZdjaWbWdjqWVtwjOtazO0jSuutmb6DlkIUU0oikLdZnacPRBDZFhSqZJS1sbW9KrXiz+v/sm6i+uqTlIKwK4BDF0JKwdA2G9QszF0fue+p5j7+pK24TepKyWqLUVbZcYs6k96ejrW1takpaWVe4nvmzNmkLpmLfYTJ1Jz8iQdRSgAcnJyiIiIwM3NDRMTE32HU2bJycnY2dkRGhp6R/FqIXTlfn8nunytE/J8ispxPSWLIYuCuJmWQ4va1qwe1w4L40fjO8XzsemsPR7NxlM3SM36txB6h4b2DG3rSk9PR0wMS7/Srag48nqnW/J86lZEaAJ/fX8GK3sTnv/Ur1RlNk7Fn2LU36MwUZsQODQQK6Mq9v8heAX8+VrRz0OWQ9OB9zw0Py6ey507g6LgcSQItXXVr0MoHg+lfa2TmlI6VjxSKqP61H8QlSM0NBQjIyOaNGmi71CEEEJUE7VrmLHyRR9qmBly+noa41acICf/wXVTqoPGTlZ81K8pR9/rznfDvenobg/AwcuJvPbrKdrNDmTGH2c5dzNdz5EKIaqy2o1tURkopCfmkBpXurq+LWu2pKFNQ3IKc9hyZUsFR/gQWo+GdhOLft44AW6cvOehho4OGLm5gVZL1vHjlRSgELojSSkdU1tYAKDJkul7oqTQ0FA8PT3vWE1NCCGEuJ+GDpasGOuDuZGaoKtJvPbrKQoKH51VOI0N1PTzcmbli74ceKcrr3VrSC1rE1Kz8ll++Bq9vznA0wsOsupoJLdy8h/coBDisWJorMbFowYAkWFJpTqnyhY8/6+en4J7TyjILlqRLz3mnoea/bMKX+bRY5UVnRA6I0kpHZOaUuJepkyZwqlTp/QdhhBCiGqoRW0bFo9ug5GBih3hcUz9/QwaTRX8EFVOrrZmBPRsxMF3u7F8TFt6N3PCUK0Qej2N9zeG4fNZIG+tD+X4teSq+SFSCKEXdTyLFgy6fr50KyAD9G3QFxO1CZdTLxOSEFJBkZWDSl1U6LxmY8iIhV+fhby7jwQz920HQNaRI5UZoRA6IUkpHbudlCqUpJQQQgghdOiJBvYsGO6NWqWwIfg6n/117pFNzKhVCl0aOfD9860Jmtad959qQkMHC7LzC9kQfJ0hi4LoPm8fP+y7QsKtXH2HK4TQs9sjpW5eTi11wt7KyIon3Z4EYP2F9RUWW7mYWBWtyGdmBzdDYdN40Nw5UtbM1weA3EuXKEgq3WgxIaoKSUrpmIyUEkIIIURF6dnUiS8GFy2WseRgBAv3XNZzRBXP3sKYcZ3qs/ONTvw2wY+hbWpjaqjmakIms/8+j9/sQF5ZeYI95+MpfARHjwkhHsyutgVGpgbk5RSSdL30tX2HegwFYPu17SRlV9Fkjq0bDPsFVIYQvhn2zrrjEIMaNTBu1AiArGMyhU9UL5KU0rF/k1KlK7InhBBCCFEWz7SuzYd9PQH4csdFVgZd029AlURRFFrXtWXOM14c/8Cfzwc1p6WrDQUaLdvPxjFm+XHaf76br3ZcIDpZ7sOEeJyoVAq1GhatOnfjYumn8DWzb0Zz++bkafJYd2FdRYVXfnWfgH7fFP28fy6cvnNk1+3RUplHj1ZmZEKUmySldExGSgkhhBDlk3P+PLGffMrVpweQ9uef+g6nSnqxgxuvdWsIwPQ/zrI55IZ+A4oMgsPf3bPeia5ZGBvwrE8dNk1sz/YpnRjb3g0bM0Ni03P4bvdlOs7Zw4ifjrA55MYjs1qhEOL+nBvaABBzKbXU5yiKwkjPkQCsubCG3MIqPB3YewQ88VrRz5snwvUTJXabt7tdV0qSUqJ6kaSUjklSquI9qvUzhNAF+fsQ1ZUmM5PUDRuIGDqMiAEDSVm9mtwLF4h5+x1uzpiBJi9P3yFWOW/08GCUX120WnhzXSh7zsfrtP18TT6Td09mwKYBBEYF3v31pTAfdn0My3rDjg/gl0GQnarTOB6kkZMl0/t5cvS97ix4zpuO7vYoChy6nMTra0LwnRXIjD/Ocu5meqXGJYSoXM4eNgDEXE5FW4apvP51/XE0cyQ5J5m/rv5VQdHpiP8MaPQUFOYWrciXdr14l1mbNqBSkXftGvlxcfqLUYgykqSUjklSquIYGhoCkJUlQ/KFuJfbfx+3/16EqOqyw85y86MZXOrUmZsffEjO6dNgaIjlk09iO3o0KAqpa9YS+dwI8q7reTRQFaMoCjP6NeXpls4UaLSM/yWYYxHJOmv/m+Bv2Bu9lytpV5iyZwqvBr5KVHrUvwekXIOlT8LBeYAWDEwgKgiW94UM3SbISsPYQE3fFs6sfNGXA+905fXu7jhbm5CWnc/yw9fo/c0B+i84yKqjkaTn5Fd6fEKIilWzjiUGxmpyMwtIvln6z2KGKkOea/IcACvPrazaX/Cp1DDoR3BsBpnxsPpZyC2qoaW2ssLEs2hqd5ZM4RPViIG+A3jU3E5KaXNy0BYUoBjIU6wrarUaGxsb4uOLbnTNzMxQFEXPUQlRNWi1WrKysoiPj8fGxga1Wq3vkIS4p8KMDNK3bCV13TpywsOLHzeqWxeboUOwHjAAAzs7AMw7tCfm7XfICQsjYvBgnL/4HMsuXfQUedWjUil8OcSLWzkF7D4fz4vLj7PmlXY0dbYuV7t7ovawInwFAE+5PcWOyB0cvHGQAZsHMLbZWF5S22Oy9W3ITQdja+j/Ddg1hJWDIO4MLO0FIzdBjbo6uMqyq13DjDd6ePBad3cOXEpg3YlodobHcfp6Gqevp/HplnD6NHdmWFtX2tarIfcTQjwC1GoVtepbEX0uhZhLqdi5WJT63MHug1kUuohLKZc4GnuUdrXaVWCk5WRsCcN/hcXdil5vf3/5n0LoKsx8fcgJCyPzyFGs+/fXd6RClIqirdKp4MqRnp6OtbU1aWlpWFlZlastbV4e51t4AeBx9Ahq6/LdFIqStFotsbGxpKam6jsUIaokGxsbnJyc7voBS5evdUKez7LSarXknD5Nyrp1pP/1N9rsbAAUQ0Mse/XCZsgQzHza3vXfbn5MDNffeIOc0NMA2I1/hZqTJ6NI8rVYdl4ho5Ye5fi1FOwtjFg//gnc7M0fqq0bGTcY8ucQbuXdYqTnSN5p+w7X0q4x6+gsgm4GAeCSX8DUpBS62LeAwT+BTZ2ik5OuwM8DIC0KLJ1h5EZwaKyjqyyfpIxcNp66wdrj0VyK/3d1rvr25gxt68rgVrWpaWmsxwirLnm90y15PivOib8iOPpHBA1aOfDky83KdO6so7P49fyvdKrdiYXdF1ZQhDoUfQyW94HCPOjwBvjPIOPAAaLHvYyhiwsNA3fpO0LxmCvta91DJ6Xy8vKIiIigQYMGGFTz0UC6fmM437wF2vx8Gu4OxNDZWQcRiv9VWFhIfr4MvRfivwwNDe87QkpugnVLns/SKUxPJ+2PP0ldv57cCxeKHzdq0IAaQ4dg1b8/BjVqPLAdbV4ecV/MIWXVKgDM2rXD5cu5GNjbV1js1U1adj7DfzxC+M10XGxM2TDBj1rWpmVqI78wn9HbRnMm8QzN7Zuz4skVGKqLpgNn/v0rZzbMYoFHAaFORfd+nV068a7vVFwtXf9tJD0GVg6EhPNgWgOe/w1cWuvsOstLq9VyMiqVdcej+fN0DFl5RYXQDVQK3Ro78KyPK53ca2KglioXt8nrnW7J81lxYi6lsvGrk5haGTHmi/ZlGgUZlR5F34190aJl84DN1LeuX4GR6kjoWtj4ctHPAxahce/PBd92UFBAg107MapdW7/xicdaaV/rypxNysrKYvLkyaxYUTSk++LFi9SvX5/Jkyfj4uLC1KlTHz7qR4TK3JzC1FSpK1WB1Gq1TE8SQogqSqvVkn3qFKlr15G+fTvanBwAFGNjrJ58EpuhQzBt1apMHxYUIyOcPvwA01be3PxwOllHjhAxaDAuX8/DrHXVSXjok7WpISvG+jD0hyAiEjMZueQY617xw9bcqNRtzAuex5nEM1gZWfFl5y+LElJaLXlb5xL97lKsCxXePwS3nE35yz2bg433MeDmEV5q/hJjmo3BxMAErJxhzN+w6hm4EQwr+sOzq6F+5wq8+tJTFIXWdWvQum4NPuznyZbQGNaeiOZUVCo7wuPYER6Ho5UxQ1q7MrSNK3XszPQdshCilBzqWaI2UJGdnkdqXBY1nEo/YrSOVR06u3Zmb/ReVoWv4kO/DysuUF3xGgaJF+DAV/Dna6hGu2HavDnZp06RdfSoJKVEtVDmr4CmTZtGaGgoe/fuxcTEpPhxf39/1q5dq9Pgqispdi6EEOJxVJCSQvKKFVzt24/I50aQtnkz2pwcjD08cPzgA9z378P5i88xa936oWv4WPfpg9v6dRg1aEBBfDyRo0aTtHRZ1S5MW4lqWhqz8kUfnKxMuByfwZhlx8jILSjVuYGRgfxy7hcAPuvwGc4WzpCZhHb1s8R++T3aQgUDCwMwMMAy5hbD9hXw3Q+FzFiSRdSPCxizoh/7r+8vaszMFkZtBrdOkJdRlKA6t6WiLvuhWRgb8KxPHTa+2p4db3TixQ5u1DAzJC49lwV7LtNp7h6eW3yEzSE3yMkv1He4ooqIiIiga9eueHp60rx5czLlnr/KMDBU4+hWNCIj5lJqmc8f5TkKgD+u/EFqTtnP14uuH0DjvkXT+NaMwMyraMp05hEpdi6qhzInpTZt2sSCBQvo0KFDiRvKpk2bcuXKFZ0GV13dTkoVyhuUEEKIR5xWqyXz6DFuvPU2lzt3IW725+RduYJiaor14EHUW7sGt82bsH1+hM7qLBo3aIDburVY9e0LhYXEz5nDjddeo/DWLZ20X93VrmHGyhd9qGFmSOj1NF7++cQDEyrRt6L58FDRqIAXmr5AF9cuELEfFrUnfcc+MmNNUAzV1Fn3Bx6HDlLrs88wb98e1GoaxsKo3Rqmz71O4guv8MNHA4mODCsqxvvc+n8/LK0bCadWVcIz8HA8HC35sK8nR97rzsLnWtHR3R5FgcNXknh9TQi+swL5aHMY4THp+g5V6NkLL7zAJ598Qnh4OPv27cPYWGqRVSXO7jbAwyWl2ji2obFtY3IKc9hwaYNuA6soKlXRinxOzSErEfO0P4CiFfjkCxtRHZQ5KZWQkICDg8Mdj2dmZsrKJf+QkVJCCCEedQVJSSQtWcLV3k8RNXo06Vu2oM3Lw9izCU4zPsL9wH6cP/sMUy+vCrk/UJmb4zx3Dk4fTUcxNOTWzl1EPPMMOefP67yv6sjd0ZLlY3wwN1Jz+EoSk389RUGh5q7H5hXm8fa+t7mVfwuvml685vUq7J4JK/pTkBBHXEhRzS/7Sa9hXN8NtbU1NoMHUWfJT7jv34fTR9Mxbt0KrQJNrkOntedJf3IIh4f0ImHjJgp7fgstnwetBja/CkFVu4CwsYGaPi1qsfJFXw6805XXu7vjYmNKWnY+K4IieerbA/T77iC/HIkkPUfqWz5uzp49i6GhIR07dgTA1ta22tfXfdQ4e9gARUmpsiZlFEVhpOdIAH499yv5hdXkb9zIHIavAQtHTNWXUNQKBfHx5EVc03dkQjxQmZNSbdq0YevWrcW/377R/Omnn/Dz89NdZNXYv0mpLD1HIoQQQuiOVqMh8/Bhrk95g0tduhI/90vyrl1DZWaGzdCh1Nuwgfq//06NZ59FbVH6pbgflqIo1Bg+nLqrV2HgXIv8yCiuDXuW1N83Vnjf1YGXqw2LR7fByEDFzvA43tlwGo3mzg9oX534irNJZ7E2tuZL7zcw/Plp2D8X0BJ3zYvCXDBu1Ai7sWPuONfAzo4aw4dTf9Uq3PfsQf36S8TUtUClhRpnokic/jEXOnUmepuGNMP+FOYrsP29oqRXNfgGv3YNM97o4cH+d7ry81gf+jSvhaFa4cyNND7YFIbPZ7sIWBfC0atJMiKhiti/fz/9+vXD2dkZRVHYtGnTHccsXLiQevXqYWJigq+vL8eOHSt1+5cuXcLCwoJ+/frRqlUrZs2apcPohS441bdGpVLISMnlVlJOmc/vXa83NU1rEp8dz/bI7RUQYQWxrg3P/orKxARTu6Lrzjp6RM9BCfFgZU7rz5o1i969exMeHk5BQQHffPMN4eHhHD58mH379lVEjNVOcVIqI+MBRwohhBBVX0FCAqm/byR1wwbyo6OLHzdp0QKbIc9g/dRTxe99+mDavDluv/1GzLvvkrn/ADffe4+sk8E4ffABqv/Uv3wcPdHAnoXPtWL8L8H8fuoGliYGzOjftPhLxR3XdrD6/GoAZrn2x2nFQMhJA2MrMpwnkL5mJahU1Jo5E8XQ8L59GTo54THhTdzHB7Dz8C8E//odLU/fol58IRl795IBKIa1sXDKwCr6OyzSE1H1n1c09aSKU6sUOnnUpJNHTZIyctl46gZrj0dzKT6D30/e4PeTN6hvb86QNq4Mbu2Cg+Xj/e9OnzIzM/Hy8mLs2LEMGjTojv1r164lICCARYsW4evry/z58+nVqxcXLlwong3SsmVLCgrurMW2Y8cOCgoKOHDgACEhITg4OPDkk0/Stm1bevToUeHXJkrH0EiNQz1LYq+mE3MpFSv7sq1Caqg25NnGz/Ldqe/4+ezP9HHrU31mBNVuDQP+D7OQ18iKNyZz2zpqDB+u76iEuK8y3wV06NCBkJAQCgoKaN68OTt27MDBwYGgoCBal2P1m88//xxFUZgyZUrxYzk5OUycOBE7OzssLCwYPHgwcXFxJc6LioqiT58+mJmZ4eDgwNtvv33XN5HKpLKQ6XtCCCGqN21hIRkHDnB98mQude1Gwtdfkx8djcrCghrPPYfbpo24rVtLjSFD9JqQus2gRg1cFy2i5pTXQaUibcNvXBv+HHlRUfoOTe96eDry1RAvFAVWBEUyb+dFAKLTo/no8EcAjDWpQ6ednxUlpFzaUDhyOzeX7wLAdvRoTJs3K3V/iqLQs/1IJs/bTdhXY3nzZUPWd1C4aaugzS/kVrQpNw7ZcumDv7kxvAu3dgeizcvT/YVXEDsLY17qWJ8db3Ti91efYFgbV8yM1FxNzOSLbefxm72bcT+fIPBc3D2nTIqK07t3b2bOnMnAgQPvun/evHmMGzeOMWPG4OnpyaJFizAzM2Pp0qXFx4SEhBAWFnbH5uzsjIuLC23atMHV1RVjY2OeeuopQkJC7htTbm4u6enpJTZRsZzdi6Yd33iIulIAQzyGYKw25lzyOYLjgnUYWSVoNhjzXkMAyAoJR3t1v54DEuL+HmoCdIMGDVi8eLHOgjh+/Dg//PADLVq0KPH4G2+8wdatW1m/fj3W1tZMmjSJQYMGcejQIQAKCwvp06cPTk5OHD58mJs3bzJq1CgMDQ31OpRWakoJIYSorvLj4kj97TdSN2ygIOZm8eOm3t7YDB2K1ZO9UJmW7VvnyqKoVNiPH4+plxc33nyL3HPniBj8DM6zZ2Hp76/v8PRqgLcLt3Ly+XDzWb7bfRkzIy17bk0nIz8D70IVk84dBBTo8AZ0fY+E2XMouHkTw9q1qTl50kP1aWFkwdtt32ZAwwF8dvQz1seeoG48PHXFkk5h+ZCUSXpoAumvTkJlZYVVr55YPfUUZj4+KGq1bp+ACqAoCq3q1KBVnRpM7+fJ1tM3WXM8ipNRqewMj2NneByOVsY807o2Q9u4UtdO/8nbx11eXh7BwcFMmzat+DGVSoW/vz9BQUGlaqNt27bEx8eTkpKCtbU1+/fv55VXXrnvObNnz+bjjz8uV+yibJzdbTi5PZKYiykPdX4Nkxr0a9CPDRc3sDJ8JW2c2ug4woplOvJzlG93UpgLuT+8gMm7u8C2vr7DEuKuyjxSqlu3bnd9UU1JSaFbt25lDiAjI4MRI0awePFiatSoUfx4WloaS5YsYd68eXTr1o3WrVuzbNkyDh8+zJEjRXNjd+zYQXh4OL/88gstW7akd+/efPrppyxcuJA8PX7jJkkpIYQQ1Ym2oIBbu/cQPeFVLnftRuK331EQcxOVtTU1Ro2k/p9/UO/X1dgMHFBlE1L/Ze7nh9vG3zFt1QrNrVtcnzSZuLlz0ep5JLW+jfSrx9u9GgEw/9RXnEs+R41CDXNuRGNo4QijNoH/R2SdDiNlVdEqeU4fz0BlZlauft1ruLOs1zJmd/qcjLr2fP9EBsPH5bB5UiOMm+RiYFKIJj2d1PUbiBozlkuduxD76UyygoPRaqrHSCNzYwOGtnXl91fbs/ONTrzUwQ1bcyPi0nNZuOcKnefuZfiPR9h06sYDV0IUFScxMZHCwkIcHR1LPO7o6EhsbGyp2jAwMGDWrFl06tSJFi1a4O7uTt++fe97zrRp00hLSyveov8zDVpUjFoNrFEUSE/MISOl7HWlAEY2KSp4vid6D9Hp1ev/mWJigllbXwCyonJg9bNFI2GFqILKnJTau3cvCxYsYMCAAWT+J+mSl5f3UDWlJk6cSJ8+ffD/n28wg4ODyc/PL/F448aNqVOnTvE3GUFBQTRv3rzEG0uvXr1IT0/n7Nmz9+yzoofQqiUpJYQQohrIv3GDhG+/5XJ3f66/+ioZe/aARoNZ27Y4z51TtLLae+9h7O6u71DLzNDRkborlmP7wgsAJC9ZSuQLL5AfH6/fwPTs1S4N6NfmKka2RV/wzUpIxKl+d5hwGOp3QZuXx80PPwStFusBA7Bo314n/SqKQt/6fflz4J883+R5VCo1qyyv8OygGuwfo8G5ayI2zY1RW1tTmJhIyqpVRI54nsvduhP3xRyyz4RVm0Li7o6WfNDXkyPTuvN/I1rRyaMmigJBV5OYsjYEn892MX1zGGdj5ANiddW7d2/OnDlDWFgY8+bNe+DxxsbGWFlZldhExTIyNcDe1RIoWoXvYdS3qU97l/Zo0bLq/CodRlc5zP5ZhCwz2QoSL8D6MVD4eH85I6qmh6osuWvXLmJjY2nXrh3Xrl176M7XrFnDyZMnmT179h37YmNjMTIywsbGpsTj//0mIzY29q7fdNzedy+zZ8/G2tq6eHN1dX3oa7ib4pFSWZKUEkIIUbVo8/NJ37mTqJdf5rJ/DxL/73sK4uJQ16iB7dix1P/rL+qu/Bnrfv1QGRvrO9xyUQwNcZz6Li7ffIPK3JzsE8FEDBpM5tHSr7T1qIk6t5Hjt34AYGzKLfZlDGFv6+/A3B6AxMWLybt8BbWtLQ7vvqPz/i2NLHnX513W9V2Ht4M32Zo85tuY8nwbByJbx+D+bC6uX8/EesAAVBYWFMTGkrxsGdeGDOFKryeJnz+fgpSHm45T2YwMVDzVvBY/j/Xh4LvdmOLvjouNKek5BfwcFEmfbw/S97sDrDwSSVp2NVl2vpqzt7dHrVbfUaM2Li4OJycnPUUlKoqzhw3w8EkpgFGeowDYeGkj6XnVqxaYebt2AGQlmqNVmcKVQNjxgZ6jEuJOD5WUqlWrFvv27aN58+a0bduWvXv3lrmN6OhoXn/9dVatWoVJJa+MU9FDaGX6nhBCiKomLzqa+Hlfc6lbN25Mfo3M/QdAq8XMrx0u876i4b7/Z+++45uu9j+Ov7LaJt17QxkdlFVoy1DxsqcTVFyAOO6VKw7AhQPcqKjgT1HcAl6GKOJCpuBklELZtJRVulu6kzZNk+/vj28HtYxCM1o4z8ejD0ly8j0nCDR955zPZwuBTz6Bc8cOjl6q1XmMGE6Hb7/BOSoKc2EhGZMnU/jxJ23maJhVmGsw/voKM/6aiV6pIL5GQaXHa3xiGsWD/9tN0okijOnpFC6UA6ug555FfUZZBWuL9olm0chFvHrNq/i4+HBCreSB4ECecCpFOvQcIdMnEfnXn4S9/x4eo0ehcHHBlJHB6YUfkf/mXJuty1ZCvbQ8NjSK358cxOJ7+zCmRzAalYL9WWU8v3o/fV/byPQVKWw7drrN7Ahri5ycnIiPj2fTpk3191ksFjZt2kT/2l0lwuUjpLMX0LJQqn9wfzp7dcZQY2BV2irrLMxOXLp0QenmhkVvoCruefnO7R/Czs/P/0RBsLOLLnRe1w7T2dmZpUuX8sorrzBy5Eieeuqpi7pOcnIy+fn59O7du/4+s9nM77//zvvvv8+6deuorq6mpKSk0W6pMz/JCAoKYseOxp921n3ycb5PO5ydnXG24ae/daGUWYRSgiAIQitgPHaM4zePRTIaG92v9PREqqyiZPVqyjduQunhjsrdA6W7OyoPd/m/7mf+1wOVhzsKF5e20x67llNEBBErlpP74kuUrl5NwTvvULl7NyGvz0Hl6eno5dlWaSZ8+wBv6A+R6uGOj0LDm+O+xcutPWlLdrIltYD7Pt/O8gNfoDCZcBs4EPdRo2y+LIVCwQ2dbmBg+EAW7F7A8sPLWefmSnhNKY9+MQrl3d/gPnQo7kOHUrjwIwrmzweFAvcRw22+NltRKRVcG+XPtVH+FOmr+W53FiuSMkjLq2DV7ixW7c6ig58rtyaEcUvvMAI87PvB7eWgoqKC9PT0+tvHjx8nJSUFHx8f2rVrx/Tp05k0aRIJCQn06dOH+fPno9frmTx5sgNXLdhCSKQXAMW5Bgxl1eg8nC76GgqFggmxE5j992yWHl7K3bF3o1ZeUq8wu1Oo1egSE6nYvBlDgQvaQc/B5ldgzRPg0wk6/svRSxQE4BJCqX9+evPcc8/RpUsXJk2adFHXGTJkCPv27Wt03+TJk4mJieGpp54iPDwcjUbDpk2bGDduHACpqalkZGTUf5LRv39/Xn31VfLz8wkICABgw4YNeHh4EBsbe7EvzWrqd0pViFBKEARBcDylVos6KBDTyYxG91tKS6m8QCvzs1Kr5ZDKwx2V2z/+6+6B0t1N/q/H2UMtpZsbCuUlbdZuEaVWS/Cc19DG9ybv5Veo2LyZ4+NuIfTd+Wi7drX7euzi0I/w/VTWqKpZGeCHApgz9H0CvOQdcR/eFc+kz3cQ8OuPKA7sA62OoNmz7Bo6ejh5MLPvTELcQnhr51scc/eH4nRYdAPcsYyydCMF774LQMCTT+I+cOAFrylZJHatP8meTae4+pZIovu2vqNZPq5O3HdNB+69OoKUUyWsSDrFj3uyOV6o5821qby9Po1B0QHcnhjOwGh/1Cr7/51pi3bu3MmgQYPqb0+fPh2ASZMm8eWXXzJ+/HgKCgqYNWsWubm5xMXFsXbt2iYlQYS2z8VVg2+oK6ez9GQfKaFzfMAlXWdMxzG8u+tdcvQ5bMzYyMiIkVZeqe3o+vahYvNm9Nu243vvR3JtqX0r4euJcP8m8Ovs6CUKwsWHUsePH8fPz6/RfePGjSM6Oprk5ORmX8fd3Z1u3bo1us/V1RVfX9/6+++77z6mT5+Oj48PHh4ePPzww/Tv359+tedjhw8fTmxsLBMmTODNN98kNzeX5557joceesimO6EuROnqBojje4IgCELroAkOpvO6dUgmE+aKCizl5ZjLyxv+W1aOubwMS3mF/N+ycswV5Y3/WzseiwVqajAXF2MuLuZSK+Eo3dwuIdRyR+Uh7+RSOl38J94gf+rtfeutaLt2JfPRxzCdOsXJO+4k8Nln8brt1ja3A+ycTJWw7lnY+RnHNWpeDAoFJP7d4z9cFXJV/TCtk4qFI8M4uWANAF/1GMMUF0/CHLDkMDd51sKASFCFwPHfqXx3PNm/+oMk4XXH7fjcc+EPQfWlRjZ+cZDMw3LtqSp9667XpFAo6NXOm17tvHn+ulh+3pvDip2nSD5ZzMZDeWw8lEeAuzO3xIdxW0I4EX6ujl5yqzZw4MALHoGcOnUqU6dOtdOKBEcKifSWQ6n0Sw+lnFXO3BZ9Gwv3LGTJwSVtKpSqryuVnIxUU4Pihveh6Dhk7YRl4+H+jaC13VFtQWiOiw6l2rdvf9b7u3Xr1iRkaql58+ahVCoZN24cRqORESNG8MEHH9Q/rlKp+Omnn5gyZQr9+/fH1dWVSZMm8dJLL1l1HRdL1JQSBEEQWiOFRiPXCbrEWkGSJGHRG7BUlGMuK2scbpWdEWqdJ9yqO0JoqajAUlFBDTmX9lqcnS891HJzx7lLFzp8+w3ZT8+k4tdfyZ09m8pdyQS98AJKrfaS1tRq5B+Cb+6F/INUKRTMiIjBUFNGYlAiU3pOaTRUkiT0r7+Gi8nI0cCOLA1K5K9Pt7Pywavwd7fvB3x+OvlDz4KqIrjzB0yf3c2p1XuRqk249uxE0LPPXjA0PLGvkE2LDlFVIQdRMf2D6DHQERHbpXF1VnNbYji3JYaTnl/OiqRTrNqVRX65kQ+2HOWDLUfp19GH8YnhjOoWjItG5eglXxSTyYRWqyUlJcXqPzcIwtmERHqxb0sm2WklLbrO+OjxfLbvM/YW7GVPwR56+ve0zgJtzDkqCpWXF+aSEir37UfXuxfcvhQ+GQyn0+HrSXD3t6DSOHqpwhWsWaHU2LFj+fLLL/Hw8GDs2LHnHbtq1aUXgPtnwXQXFxcWLFjAggULzvmc9u3bs2bNmkue0xbODKUkSbp8PnUVBEEQrmgKhQKVmysqN1c0l9ipylJdfUaIdfE7tiwVFQBIRiPmAiPmgsJLezEqFSo3N5RubvV3lX7/A1UHDxH6f+/i3KENFnyXJEj+EtbOhJpKcPXn9e6DOJK3DV8XX94Y8AYqZeMQo/yXX6jYsgWFRkPc/DcJWZfHidMGJn6+g+UP9MNTZ78fVPy1/gAUVhZSU1nNqZ+MmKtUOHuZCO38J4oD30DP28/6XLPJwt/fpbP318z6+zrHBzBoQhcUyrb5PqxzgDvPjonliRExbDqUx/KkU/x+pIBtx4rYdqyIWd8f4Ka4UMYnhtMttG3URdNoNLRr1w6z2ezopQhXiLq6UqezK6jSm3BxvbR/0/y0fozpOIbV6atZcnAJPf/VNkIphVKJrk8fytevx7BjuxxKuQfCncvhsxFw/DdY+zSMedvRSxWuYM0KpTw9PeuDFc/LvRioFdSFUlgsSFVVKNr6J66CIAiCYCVKJyeUvr6ofX0v6fmS2YxFr8dcVt50x9Y/Q62zhVvl5VBTA2Yz5tJSzKWlja5vPHKEE7fcSvCrr+IxcoQ1XrJ9VBbDj4/Cwe/l252G8GP8OL5Neh0FCl6/9nX8df6NnlJTXEzuK68C4Pvgf/Dv1ZX/hUdwy8KtHMopY/KXO/jq/r7onOxT1Ne3Ws3MxVm0z62m5PnuGJ1cUPt6Ej7gKCqNBGnrzhpKFefqWf/ZAQpPVdTfF9HDj6H3xqJso4HUmZzUSkZ1D2ZU92CySir5ZmcmX+88RVZJJUu2nWTJtpN0C/VgfEI4N8SF4qlt3Tsenn32WZ555hmWLFmCj4+Po5cjXOZ0Hk54B+kozjWQk15Ch57+F37SOUyIncDq9NVsOLmB7IpsQtxCrLhS29H1lUMp/bbt+D34oHxnUHcY+zGsuBuSPgX/GOjzgGMXKlyxFJLoO0tZWRmenp6Ulpbi4eHR4utJFguHY+WCqZF//oH6HzW4BEEQHMHa/9ZdDhYsWMDcuXPJzc2lZ8+evPfee/Tp06dZzxW/n22TJElIVVWYsrPJfuppqvbvB8Bt0CACHp9B7gsvYkhKAsBn0kQCZsxAcYn1q+wmYxt8ez+UngKlGobM5ljsaG5fcyeVNZX8t+d/mRI3pcnTsp+eSenq1ThHdqbDt9/Wv85DOWWM/2grZVU1DIj049NJCTirbXxMrHNnOHq00V0SUBOkQfMfLYT3g1u/AI+GHwIlSeLQ3zn8sSKNmmpL/f1hMd6MeagH6jZ2tO1iWCwSfx0tZEXSKdYfyKPaLL9+Z7WS0d2DGZ8YTt8OPlbbrW/Nf+969epFeno6JpOJ9u3b4+rauEbWrl27WnT9tkB8/7Cvzf87zME/suk5NJxrbols0bXuX38/23O2Myl2Eo8nPm6lFdqW8ehRjo25DoWTE1FJO1CeWXv5z3mw8QVQqOCuldB5iMPWKVx+mvtv3UV/9FVZWYkkSeh0OgBOnjzJd999R2xsLMOHt90WvdakUCpR6nRYDAa5rpQIpQRBEFqdFStWMH36dBYuXEjfvn2ZP38+I0aMIDU1tb6jq3D5USgUVKUfJWv6dEynToFaTcCMGfjcMwmFQkG7Lz6n4N13Of3JpxQtWkzlnr2Ezp93yccVbcpihj/egS1zQDKDdwe45TMMAV2YseYuKmsq6Rvcl3/3+HeTp1b89Relq1eDQkHQSy81Ct66BHvw5b19uPvT7fxxpJBHl6Xw/p29ztv9rbzKRHp+BUfyKyirNFFjkagxWzCZJWosFmosEi5qFTonFTpnNd46DR393Ojg54o2NrpJIFVHk2uCL9zh2E+Nap4YDSa2LE0lfWd+o/HBnT0ZPeXyDqQAlEoFAyL9GRDpT7G+mu92Z7Ei6RSpeeV8tzuL73ZnEeGr47bEcG7pHUaAh4ujl1zvpptucvQShCtMaKQXB//IJudISYuvNTF2IttztvPtkW+ZEjcFV03rbzzg1LEjKn8/zAWFVO5OwbVf34YHr34MCtJgz1JYOVkufO4f5bC1Clemi94pNXz4cMaOHcuDDz5ISUkJ0dHRODk5UVhYyDvvvMOUKU0/iWvtbPFpxZEB11JTUECHVd/iEhtrlWsKgiC0hPhktrG+ffuSmJjI+++/D4DFYiE8PJyHH36Yp59++oLPF7+fbY8kSRQv+Yq8uXPBZEITEkLovHfQ9mxaG6T811/JfuppLOXlqLy9CXlrLm5XX+2AVZ9DWTas+jec+EO+3f02uSaIiwfP//U8q9NX46f1Y+X1K/HTNv5wzGIwcOyGGzFlZuJ9990EPffsWaf480gh936ZRLXZwi3xYbw5rgf66ho5fMqrIC2vnCP5FRzJKye7tOqSXoZrZRn7/+9OAM67p6ekBGpLSOQcLWXDZwcoL2o8Z0B7d258rBdOWvscN2xtJEliT2YpK5Iy+CElG321XLdJpVQwKNqf8Ynt6C6dxi8mCrXq4n6PxL931iV+P+2roriKRTP/RqGA+9+5tkX/RlgkCzeuvpETZSd4us/T3NXlLiuu1HayZjxO2c8/4/ffKfg/8kjjB2uMsOgGOLVN/nDjgV9BJ47WCi1ns51Su3btYt68eQB88803BAUFsXv3br799ltmzZrVJkMpW1C6ukJBgejAJwiC0ApVV1eTnJzMzJkz6+9TKpUMHTqUrVu3nvU5RqMRY23nOJC/0Qpth7m0lJznnqN8w0YA3IcNJfiVV1Cdo1am++DBdFj1LZmPPorx4CFO3f8Afg9Pxe/BB1Eoz71jyC4Or4Hv/yvXkdK4wnXv1Nda+j79e1anr0apUPLGgDeaBFIABe+9jykzE3VIMP6PPXbOaa6J9OP/7ujFQ0t38U1yJpsP53NaX33O8f7uzkQFuuHn5oxaqUSjUqBWKVArlaiUCow1ZgxGM4ZqM/nlVRwt0PPJkpfPH0bVGTMGy+9/sGvtSXb8dBzJIqFUKrBY5M9WfUNduf6RuCs2kAJ5F2BcuBdx4V48O7oLy3bv45cdvxN45Hd6roPM9YM44hpNwNXbuGXSvY5eLsnJyRw6dAiArl270qtXLwevSLhcuXm74OHnQllhFTnHSmnf9dJqGgIoFUru7nI3r2x/ha8OfsXt0bc3aSDRGun69aXs55/Rb9uO/z8yKdTOcPv/4JNBUHwcvp4Id68CdSs/ui5cNi76O7fBYMDd3R2A9evXM3bsWJRKJf369ePkyZNWX2BbVdfNx1xRcYGRgiAIgr0VFhZiNpsJDAxsdH9gYCCHDx8+63PmzJnDiy++aI/lCVZWuWcPWdOmY8rORqHREPDkk3jffdcF6+04hYcTsWwZea+8SsnKlRT+33tU7k4h5M03UHt722n1ZzBVwYbnYcfH8u3gnnDLF+DbCYD04nRe2fYKAFN6TqFPcNP6aJX79lO0aJH89BdeQOV2/qMnI7sF8ea4HsxYuac+kKoLnyID3IkMdCMq0J3IADe8dBf3A4wkSZg/KW/W2KrsQtbO301WbVv30CgvinL0VJab8ArUccOjvS65q1ZbZzAZSC9JJ604jRMn91KdvBv3AyfpfNLEDGNnTkaMotg7BgOgkMyYD51w6Hrz8/O5/fbb2bJlC15eXgCUlJQwaNAgli9fjr//pReiFoRzCYn0oqwwl+y0khaFUgDXd7qe91LeI7Miky2ZWxjSrvXXYXLt1w+Ayr17sRgMKGtL8TQM8IM7VsBnw+QduGseh+vfBdFFXrCDiw6lOnfuzOrVq7n55ptZt24d06ZNA+RvMGL7aYO6DnwWvcHBKxEEQRCsYebMmUyfPr3+dllZGeHh4Q5ckXAhkiRR9MWX5L/zDtTUoAkPJ3TePLTdujb7GkpnZ4Jffglt797kvvgi+j/+4PjYcYS9Ox9tjx42XP0/FKTBN/dC3j75dv+pMGSW/Ak3cjAx47cZVJmr6B/cnwe6N+2iJJlM5Dz3HFgseFx3HW7XXtusqcfFhxEd5E6lyXxJ4dO5KBQK1BHtISvzgmM3xU4iK60EtbOKPmM6cGhrDpXlJjz8XLjxsTh0Hpf/J/oWyUJWRRZpxWnyV1EaORkH8TyYRZcMC7GnJMYUygXii71jON5+FMe8OstPlsz4uh/FrX8wY8Y6Nlx/+OGHKS8v58CBA3Tp0gWAgwcPMmnSJB555BGWLVvm0PUJl6eQSG8Ob80l2wp1pXQaHbdG3cqn+z5l8YHFbSKU0oSFoQkJwZSdjSF5F24Drmk6KDAWbvkclt0OuxbJHfn6/9f+ixWuOBcdSs2aNYs777yTadOmMWTIEPr37w/Iu6bEttsGDaGUOL4nCILQ2vj5+aFSqcjLy2t0f15eHkHnKGjt7OyM85kda4RWraa4mJyZz1CxZQsA7qNGEvzSS6hqd3tfLK+bb8IltgtZjzxK9cmTnLjrbgKffgrvO++0Woezs5Ik2L0EfnkKTAbQ+cFNH0LU8DOGSLyy7RWOlR4jQBvAnAFzznqc5PTnX2BMTUXl5UXgMzObPH4+3ULPfsyxxX7+GWp3y5yNBFS4+nMyJAH/du78645otiw9THGOHlcvZ258rBdu3q2niLe1lFeXc6T4SEMAVZzGkeIjOBfric2QiM2QuC5DIqSo4TkSUOjTlWOdRlLh2hEApVIitn8gvUZ3wsN3mGNezD+sXbuWjRs31gdSALGxsSxYsEA0TRJsJjTKC4D8k2WYqs1onFp25O726Nv5cv+X7MrfxYHTB+jq2/wPOxxBoVCg69eP0lWrMGzfdvZQCiBqBAx/BdY9A+ufBd/Ojb7fCIItXHQodcstt3DNNdeQk5NDzzMKgw4ZMoSbb77Zqotry0QoJQiC0Ho5OTkRHx/Ppk2b6jtBWSwWNm3axNSpUx27OKHFDLt2kTXjcWpyclA4ORH4zEy8xo9vcXjkEh1NxLffkPPMs5SvX0/ey69QmbyL4Jdfqv++b1VVpfDjY3BglXy740C4+SNwbxycrk5fzY/HfpTrSF37Br7apkdTjMePU7hgAQCBM59G7dNKith6ekKnTnD0KBKNi53XdeL586qH6DE8goSREfz8wR4KT1Wgdddw42NxePhpHbBo6zFbzGSUZ5BanEpaUVp9EJWtzwbAr1QOoPpnSNyXIRFU0vj5EhJqLzPl7bqS5nszRZK8e1OlUdJ1QAi9hrXHzbt1hekWiwWNpulRS41Gg8ViccCKhCuBu68Lbt7OVBQbyT1WSnhMy/4NDHQNZGSHkfx07CeWHFzC6wNet9JKbce1bx9KV61Cv237+Qf2+y8UHIZdi+UduvdvgIAu53+OILTAJVWDDAoKavJJcp8+TesWXMmUrvI5XRFKCYIgnN+kSZO47777uLaZR4msZfr06UyaNImEhAT69OnD/Pnz0ev1TJ482a7rEKxHslg4/elnFLz7LpjNOLVvT+j8ebh0sd6baZWbG6Hvzqd48WLy5r5F2Zo1VKWmEvbufJw7d7baPJxKgm/vhZIMUKph8HNw1aPwjyLracVpvLr9VQCmxk0lISihyaUki4XcWbORqqtxveYaPG64wXrrtIb0dOjcGcXRo43urnD1Z0ffe4mdN5XQSC9+WrCH3GNlOOvU3PBoL7yDWn8r9jOVVJU02vmUVpxGekk6RnNtAwVJIrAEYjMkbs6Q6JapxLfE3PgiCgkXLxO6gGpcAszkdryN5NLhFJW4gARqZxXdrw0lbli7VnukcfDgwTz66KMsW7aMkJAQALKysupPYQiCLSgUCkIivUjbkUf2kZIWh1IAE2In8NOxn1h3fB2P9X6MINez77RuLXR9+wJQdfAg5rIyVOcqvaNQwOi34fQxOPknLB0vd+Rzbdo4QxCs4cptUWJjYqeUIAhC85SWljJ06FDat2/P5MmTmTRpEqGhoTafd/z48RQUFDBr1ixyc3OJi4tj7dq1TYqfC21DTVER2U89jf6PPwDwuO46gppRyPtSKBQKfCZNwqV7d7Iem0b10aMcv208wS+9hOd1Y1p2cYsF/poHv74Kkhm82ss1PsKahk16k54ZW2ZgNBu5OvRq7ut+31kvWfLNNxiSklBotQS98IJtjxteqvR0KC1l3Z3voTBWodf5oLr2aoY8EIeLTsOahfvISi1B46Li+kfi8Atzc/SKz8lkNnG87Hjjo3dFR8ivzG88UJIILoK4LDWJ2To6nqhCV1x5xgCzHEL5mHD1N6ILqEYb6owiZhhHlDeSvM+P4pNyoOXkoqL7oDB6DglH69Y6w6g677//PjfccAMRERH1dflOnTpFt27d+Oqrrxy8OuFyVh9K1TZMaKlY31gSgxJJyk1i2eFlTIufZpXr2oomKAiniAiqT5zAsHMn7oMHn3uw2gnGL4FPBssd+VbcDRO/r69jKAjWJEIpGxGhlCAIQvOsXr2agoIClixZwqJFi5g9ezZDhw7lvvvu48YbbzzrMQ9rmTp1qjiudxkwJCXJx/Xy81E4OxP0/HN4jhtn8/BF17s3Hb5bRdbjj2PYuo3sxx+nclcyAU8/jdLpEoKBshz47j9w/Df5drdxcN08cGlaz0mSJF7a+hInyk4QoAtgzjVzUCqUTcaZ8vLJn/sWAAGPPYpTmO0D30vm6Yli7M0c3ZVPvxs7ETc0HEmSWPfpATIOnEatUXLdQz0JjGgdjXUkSeJ01WnSihrvfjpaepQaS83ZnkC8IZCr8jyIOlmDX1o+qqIywAzU7pZSgtZHDqB0/tXo/KpR+odD9C2YO40gNbczyRuyKCuoBIw469T0HBJOj0FhOOvaRvfB8PBwdu3axcaNG+u7nXbp0oWhQ4c6eGXC5S4k0guAvONlmE0WVJqm/2ZerImxE0nKTWJl2kr+0+M/6DS6Cz/JgXT9+lJ94gT6bdvOH0oB6HzgzhXw6VDI2Ao/TYcb3xcd+QSrE6GUjahEKCUIgtBs/v7+TJ8+nenTp7Nr1y6++OILJkyYgJubG3fffTf//e9/iYyMdPQyhVZGMps5/fHHFLz3PlgsOHXsKB/Xi4qy2xrUvr60+/RTCt5/n9MfLqR46TIq9+0nbP48NBez4y9tPax+EAynQaOD0XMh7q5zvvn/9si3rDm+BpVCxdxr5+Lt4n3WcXmvvIylvByX7t3xvvvuS3mJdjVsciwD74rGyUWNxSKxadEhju0uQKlWMHpKj/ofKu3NaDZytORok8LjRVVFZx3vpnEjyjOSeIM/XTMkAtNOo9mbhqU4G8iuH6dQK9H6W9D5lKMLMKL1NaFUSxCaANEjIXo0Zu8YDm3NIfnLk1QUpQPg4qYhbmg43f8VhpO27bydN5lMaLVaUlJSGDZsGMOGtY7i68KVwStQh9bDicqyavJOlFnl35Nrw66lvUd7Tpad5Lv077iry10tX6gNufbrR8nyFRguVFeqjn803PoF/O9WSPlKvn31I7ZdpHDFaTvfxdoYpZu8rdysr3DwSgRBENqOnJwcNmzYwIYNG1CpVIwePZp9+/YRGxvLm2++ybRprXtrvGA/NYWFZD/5JPq/twLgedNNBM16HqXO/p9SK1QqAh59FF2vXmQ/8SRV+/ZxfOw4Qua+iduFaqXVGGHjC7DtA/l2YHf5uJ7/uYO11KJU5myfA8DDvR6md2Dvs44rW7+e8g0bQa0m+JWXUaha1m3KHhRKBU4uaiRJ4relqaTtyEOpVDDy390Jj7V9cXZJksgz5JFWnEZqUWp9AHWy7CRmydxkvFKhpJ17O6K8o4jy7EzXYldCj5Sg3pFK5c5kzKVJ9WMtgMJJjTZUh86jAJ1vOVrfapQqQK2FjkMgepTc/co9CFO1mYN/ZLN7/Vb0pdUA6Dyc6DW8HV0HhKJxbv3/P/9Jo9HQrl07zOamv5eCYGsKhYKQzl4c3ZVP9pESq4RSSoWSCV0m8Mr2V/jq4FfcHn37Wbuftha62jrQxrQ0aoqKmtf0ovNQGPk6/PIkbJgld+SLGW3jlQpXkksKpVJTU3nvvfc4dOgQIG+5ffjhh4mOjrbq4toycXxPEASheUwmEz/88ANffPEF69evp0ePHjz22GPceeedeNQW4fzuu++49957RSglAKDfto2sx5/AXFgo10maNQuvm29y9LJwu/ZaOqz6lszHplG1bx+n/v0ffKc8iP/UqWcPhArT4ZvJkLtXvt13Cgx9ATQu55yjorqCGb/NoNpSzYDQAUzudvbC/OayMnJffhkA3wfux6UNvUeTJIk/Vx7h4J/ZKBQw9N5YOvSwfoFdg8lAekl6k+Lj5dXlZx3v6exJtHe0HEB5RxHl3onQHCPmXXsxrE3CsOsLLOXlVJ3xHIXWBV1Hf3S+Feic0tF6G1HU/VFwC5QDqOjR0OFf4CQHqtVVNexff5KUDRlUlpvkod7O9Brentirg1G3sJW9oz377LM888wzLFmyBJ/W0gVSuGKERNaFUsVAhFWueX2n63kv5T0yKzLZcmoLQ9q33oL9ah8fnKOiMKalYdixA4+RI5v3xD7/hoJU2PkZfHs/3LcegrrZdrHCFeOiQ6lvv/2W22+/nYSEBPr37w/Atm3b6NatG8uXL2fcuHFWX2Rb1BBKGRy8EkEQhNYtODgYi8XCHXfcwY4dO4iLi2syZtCgQXh5edl9bULrIpnNFC74gMIPPwRJwjkyktB571i3610LaUJDaf+/r8h//XWKly7j9IcLqUxJIfStt1D7+sqDJAlSlsKaJ8CkB60P3PShfFzrPCRJ4sWtL3Ky7CRBrkG8ds1rZ60jBZA/9y3MBYU4deiA34MPWvtl2tT2H46x99dMAAZN6EJkQsuaD1gkC1nlWU3Cp1Plp5CQmoxXK9REeEYQ7XNGAOUdhZ/Kk6oDBzEkJWFIWkPlrl3kGBq/z1O6uaGN7YBrEOg0R3BRHUOhPNYwILAbRMnH8gjp1aiborGyhn2bM9mz6RRVejmMcvd1IX5ke2L6BVul/k1r8P7775Oenk5ISAjt27fH1bVxM4Jdu3Y5aGXClSA0yguAnGNlmM0WVKqW/73SaXTcFnUbn+z7hMUHF7fqUArkulLGtDT027Y1P5RSKGDUG3A6Xa57uOx2uSOfW4BtFytcES46lHryySeZOXMmL730UqP7Z8+ezZNPPilCqVpip5QgCELzzJs3j1tvvRUXl3PvDvHy8uL48eN2XJXQ2pjy8sl+4gkMO3YA4HXrLQQ+8wxKrdbBK2tK6eRE0KxZaHv1JmfWLAxbt3F87DhC581DF9sJfp4O+1bKgyMGwNiPwSPkgtddmbaStSfWolaomXvtXLxcvM46Tr99ByUr5esHv/wSSue20y0pee0Jkn85CcC1t0fR5argi3p+eXU5R4qPNKn9ZKg5+4eEflq/RsFTlHcUHTw74KRywlJdTdXevRh+SMKQ9Dlpu1OQKisbPV/p4YGuV090Ee7o3HNxKf8bhTHtjAFqiLhGDqGiRoJ3+yZrqNKb2PPrKfZtzsRokAukewZoiR8ZQVTfQKv80Nya3HTTTY5egnAF8wl2xdlVjVFfQ0FGOUEdmjaSuBS3x9zOFwe+YFf+LvYV7KO7f3erXNcWXPv1o3jxkubXlaqj0sBti+TC56fTYfldMOnH8+7uFYTmuOhQKicnh4kTJza5/+6772bu3LlWWdTlQIRSgiAIzTNhwgRHL0Fo5Sr+/IvsJ5/EXFSEUqcj6MUX8bz+Okcv64I8r78Oly4xZD7yKNXHjnFywgQC+oJP+CkUShUMegaumQbNqD9y6PQh3tjxBgCP9n6UuIC4s46zVFWRM+t5ALxuH48uIcFqr8fW9mw6xbbV8q6i/mM70X1g2DnHmi1mTpaflIOnorT6ICpbn33W8U5KJzp5dWoIn3yiiPSKxFfrWz/GUlVFZcoeSpM+xpCUROWePUhGY6PrqLy80CUmoOsWic6nHGfDThQZ34Gxur6BHi5eEDlcrg/VechZuycCVJZXk7LxFPt+y8RUJddY8g7SkTA6gs7xASgvszAKoKamBoVCwb333ktY2Ln//wqCrSiUcl2p43sKyT5SYrVQKkAXwOgOo/nh6A8sObiEN//1plWuawu6hARQKqk+cQJTbi6aoKDmP1nrDXesgE8HQ+YO+PERuPkj0ZFPaJGLDqUGDhzIH3/8Qed/bJX/888/GTBggNUW1taJUEoQBEEQWkaqqaHg/97j9McfA+AcEyMf1+vQwcEraz7nzp3psGI5OQ/dQdmOo+T/DZUdQgl+5wNUXQY26xrl1eX1daQGhg1kUtdJ5xxbuOADTCczUAcEEDBjhpVehe0d/DObP1ceASBxTAS9hzfsKCquKq4PnVKL5eLjR0uOYjQbz3qtINeg+vCprgZUO492qJWN3/ZaDAYq/vqr9jjeTqr27kUymRqNUfn6oktMRJeQgK6DO85V+1Ac+QVyFkPOGQO9O0DMGDmICu8HqnO/xdaXGtm9IYMDv2dRU20BwDfUjYTREXTq5Y9Cefn+cKdWq5k7d+5ZP+AWBHsJiWwIpc78t6alJsRO4IejP7D+5HqmVUwj2O3idnrai8rDA5fYWKr278ewfTueN954cRfw6wy3LYYlY2HvCrkj34C28/1GaH0uOpS64YYbeOqpp0hOTqZfv36AXFNq5cqVvPjii/zwww+Nxl6p6kIpqaoKqaYGhVo0OhQEQRCE5jLl5pI143Eqk5MBeddP4MyZbeooGgDleSi/+w8hHf5AW6Mjb4835ccljI+9Tuj/heASfe4ueyDXkXrh7xc4VX6KENcQXrnmFRTn+ES66tAhTn/+OQBBL8xG5e5u9ZdjC6nbc9n8v8MAtB/gRl7sQd5JXi0fvSs6Qn5l/lmfp1VrifSKJNI7sj6EivSOxNP57DsfzBUVVO7aJYdQO5KoPHAAamoajVEHBMghVGIiul49cCIDRdovkPYypJ+ZQikgvK8cQkWPAr+oC+4UKC+qYvf6DA7+mY25Rg6j/Nu5kzA6gg49/C7rMOpMgwcP5rfffiMiIsLRSxGuUHVd93KOlGCxSCit9HcvxieGvkF92Z67naWHlzIjofUGNa79+lK1fz/67TsuPpQC6DgQRs+Vj6Nvegl8IyH2yv3ZX2iZi05K/vvf/wLwwQcf8MEHH5z1MZBbbl7J7V6VZxRttBgMqGo7SAmCIAiCcH4Vv/1G9lNPYy4pQenqSvArL+MxapSjl3Xx0jfCdw+CvgCFRovPjDloVXFkTptO9cmTnBg/nqDZs8/bOXB56nLWn1wv15H619xzBi5STQ05zz0PZjPuI0fiPniwjV5Uy0mSxOmq06QWpXJw5ymMa/1QSEoOBv3FQtPX8GfT54S7hzep/RTmHnbOQu8gdyA0JCdjSNqJYccOqg4eBIul0Rh1SDCudSFUYiIaHy2K9PWQ+gN88xiYzqhFpXGFzoPl+lCRw8G1eR0ByworSV53ksN/52Axy4XVgzp6kDC6A+26+pwzZLxcjRo1iqeffpp9+/YRHx/fpND5lfyhtmAffuHuaFxUVFeZOZ1ZgX876wX4E7tOZHvudr5J+4YHez6Iq8b1wk9yAF3ffpz+9DP027YiSdKl/TuUeJ/ckW/HR/Ddf+SaecE9rb9Y4bJ30aGU5R/fzIWzUzo5gUYDJhMWvV6EUoIgCIJwAZLJRP78+RR9Ju/2cYmNJXT+PJzatXPwyi5SjRF+fRn+fk++HdAVbvkcAmLQAh1WfUv2k0+h/+MPcmbOpHLXLgKfe7bJLrADpw8wN0mu1zktfho9/Hucc8qiRYupOnAApYcHQc8+Y6tXdtGMZiNHS442KTxeVFVEeHEMI1MfQCUpSfXfzu8RK3Fzcqvf8XTm7qfm/GBXU1xMZXIyhqQk9ElJGA8dljsdnkETFtawE6pPH5xCQ+QfqlLXwIaPIDMJzuzI5x7SsBsqYsBFFfQtyTOQvPYEqdvzkCzyNUOjvEgYHUFotPcVF0bVqfsQ+5133mnyWFv5UHvevHl8+umnSJLE0KFDeffdd6/Y/59tkVKpILiTFxkHTpN9pMSqodQ1odcQ4RHBibITfHfkO+6Ovdtq17YmXXxvUKupyc7BlJmJU3j4pV1oxGty0fOjm2DZHXJHPveLqFElCFxCKHWmqqqq83ZLutKpXF0xl5Rgqahw9FIEQRAEoVUzZWWRNX0GlXv2AOB9990EPPmE/CFPW3L0V1jzJJyW6yOR+AAMf6VRmKH29ib8o4UULlxI4XvvU7JyJZUH9hP27rv1PxiUVZcxY8sMTBYTg8MHMyH23A0BqjMyKHhPDsACn3oStb+/7V7fOUiSRK4+t1H4lFacxsmyk5ilpiFDaFkkI9MeQCWpUXQq5+bb+vG07ySCXYOb/cN9zenT8i6opCQMSUkY09KajHFq3x5dnzN2QgUHg9kEGVth//vw7S9Q/I/OnsE9G7rlBfe86AK+Rdl6dv5ygvSdefWZWHgXbxJGd6g/NnQla+sfcBcUFPD+++9z4MABNBoN1157Ldu2baN///6OXppwEUKjGkKpnkMuMZA5C6VCyYTYCby87WW+OvQVd8TcgaoZzSzsTanToe3Zk8rkZPTbtl16KKVSw61fwKfDoDBVDqYmrwFN6+uMK7ReFx1Kmc1mXnvtNRYuXEheXh5paWl07NiR559/noiICO677z5brLNNUtaFUqLYuSAIgiCcU/mmTWQ/8yyW0lKU7u4Ev/oKHsOHO3pZF6c0E9Y9Awe/l2+7BsB186DL2bsEKpRK/P/7X7Q9e5L9+BMYDx7i+LhbCHl9Dm6DBjH7r9lkVWQR6hbKS1e/dM6gRpIkcmbPRqqqQtevH55jx9rqFdYzmAykl6TXB0+pRakcKT5Cuan8rOM9nT3rC45HeUcRWBHBvi9KqbFYiOjuy8j/DESlvnCnOVN+fn0AZUjaSfXRo03GOHXqJHfHS0xEl5CIJjBAfqCyRD5O+dcvkL4BqkobnqRygg7/guiRchDleWld4Qozy9m55gRHdxfUb7Zq392XhNERVuvw1ZaNHj2aZcuW4ekp/168/vrrPPjgg3h5eQFw+vRpBgwYwMGDBx24yuapqamhqqoKAJPJREBAgINXJFysuoA4+0gJkkWyak236ztdz3u73yOrIotfT/3KsPbDrHZta3Lt20feXbptO9633nrpF3LxhDuXwyeDIXsXrP6vvDtY7B4UmumiQ6lXX32VRYsW8eabb/LAAw/U39+tWzfmz58vQqkz1NWVMotQShAEQRCakKqryX/7bYoWLQbApUcPQt95G6e21Cq+phq2LYDf3pTrDymU0Oc/MGim/Eb9AtyuvpoOq74la9p0KlNSyPzvQ+TefBW/Rm1Hrdbw1r/eOmcdKYDS71Zj2LoNhbMzwS+9aNUjRBbJQlZ5VpPdT6fKTyEhNRmvVqjp4NWhSe0nf61//boKMspZ/cFuaqothMV4M+Lf3c4ZSJlychpCqB1JVJ882WSMc1RUw3G8xATUvr4NDxafgG0fQuovcPIvsJxR1FznC5Ej5GN5nQaB86Uf38k/WUbSzyc4sbew/r6Ocf4kjI6w6rGgtm7dunUYjQ0dE1977TVuu+22+lCqpqaG1NTUFs/z+++/M3fuXJKTk8nJyeG7777jpptuajRmwYIFzJ07l9zcXHr27Ml7771Hnz59mnV9f39/Hn/8cdq1a4darebBBx+kU6dOLV63YF/+7dxROymp0psoytXjG+JmtWtr1Vpui76Nj/d+zOIDi1ttKKXr2w8++BD9ju2XXleqjk9HGP8VLL4RDqwC/xgY+JT1Fitc1i46lFq8eDEff/wxQ4YM4cEHH6y/v2fPnhw+fNiqi2vr6kIpsVNKEARBEBqrzswka9p0qvbtA8DnnnsImD4NRVs6rnd0M6x5ouGoXrv+MPotCOp2UZfRBAfTfvEi8t56i+LFSwj67m+ebwfmFx6mm9+5r1VTWEjeG28A4P/Iwy2qvVVeXc6R4iPyzqfi1PraT5U1lWcd76f1q9/9VFf/qaNnRzQqzTnnKMrW88P/pVBdWUNwZ09GT+mBWtNwrKU6M+uMnVBJmE6danwBhQLnmBh0iQm49umDNj4etbd3w+MWC5xKgrRf5CAq/x87bvyi5d1Q0aMhLBFaeKQm52gpO9ccJ+NAUe36oHN8AAmjIvANtd4PuJcL6R/1vf5521r0ej09e/bk3nvvZexZdg6uWLGC6dOns3DhQvr27cv8+fMZMWIEqamp9Tue4uLiqPlHZ0aA9evXo9Vq+emnnzhx4gRarZZRo0bx+++/c+2119rk9Qi2oVIrCeroSebhYrLTSqwaSgHcEXMHX+z/gpSCFPYU7KGnf+srAK6N64nC2RlzQSHVx47h3NJwNeIaeYfwDw/DltfALxK62X73rtD2XXQolZWVRefOnZvcb7FYMJlMVlnU5aIhlDJcYKQgCIIgXDnK1q0n57nnsJSXo/T0JGTOHNwHD3L0spqvNAvWPwsHvpNvu/rLdaN6jL/k4woKJye0Mx7inepfuH1VIV0zQPXkV+jf6YXrOXZw5L76KpbSUpxju+AzaVKz5qmx1JBRniHveipKqw+isvXZZx3vpHSik1enhp1PPlFEekXiq/U96/hzKck38P27u6mqMBHQ3p0x/+2BlJtJSW0ApU9KoiY7p/GTlEpcYmMbdkLF90bl+Y9dY9UGOLZFLlSetg70+Q2PKVRyUFhXqNzXOrtZstKKSfr5BFmpxfI0SgVRiYHEj2qPd1Dr7LR1JRk1ahSjztOt85133uGBBx5g8uTJACxcuJCff/6Zzz//nKeffhqAlJSUcz5/5cqVdO7cGR8fHwDGjBnDtm3bRCjVBoVEesmhVHoJ3Qdad4eun9aPMR3HsDp9NUsOLqHnv1pfKKV0dkbbuxeGrdvQb9vW8lAKoPdEuXnE1vdh9RS5I19ofMuvK1zWLjqUio2N5Y8//qB9+/aN7v/mm2/o1auX1RZ2ORA7pQRBEAShgcVoJP+NNyleuhQAba9ehL79FpqQEAevrJlqqmHbB7VH9fS1R/X+DQNngtarRZeWJInn/3qezR1KyP1vKM//6EzN0WNkTL6XgGmP4XPffY2OVpT/+ivlv6wFlYqQV15BoW76lq64qrjJ0bujJUcxmo1NxgIEuwY3OXrXzqMdamWL+uJQdrqS7+fvxlBajZdrDQkFq8gY+Tg1+fmNB6rVaLt2rS9Mru3dG5XbWXYvlOdC2lp5N9SxLVBT1fCYkztEDpV3Q3UeCjqfFq29jiRJZB4qJmnNcXLS5XpUSqWC6P5BxI9sj6e/zirzXM4UCkWT40H27lhXXV1NcnIyM2fOrL9PqVQydOhQtm7d2qxrhIeH8/fff1NVVYVGo2HLli38+9//Pu9zjEZjo6OLZWVll/YCBKuqryuVVtLy42tnMSF2AqvTV7Ph5Ib6GoGtjWvffhi2bsOwbTs+d91lnYsOewkK0+DIelh2J/x7M3i0ke/zgkNc9LuMWbNmMWnSJLKysrBYLKxatYrU1FQWL17MTz/9ZIs1tlkilBIEQRAEWfXJk2ROm4bx4CEAfO+/D/9HH0WhOfdxr1bl2Bb5qF5hbYe38L4w5m0I6m6Vyy85uITNpzajUWp46tZ36TSxA7kvvkjp9z+Q/9bbGHbtJuT1Oag8PDBXVJD74ksA+N47GVV0ZJPwKa0ojYLKgrPOpVVrifSKJNI7kmgf+QheZ6/O561ddbEkiwVjejqn/0pmww5X9JIbOkMe3f6aR1VdQXSNBm2PHg2FyePi6t87Nb6YBHkH5BAqdY1cSPdMnu0adkO1vxrU1jsCKkkSJ/edZucvJ8g7LgcJSrWC2KtC6DWiHR6+osNUc0mSxD333IOzszMgd/F+8MEHca39f35maGMrhYWFmM1mAgMDG90fGBjY7DIk/fr1Y/To0fTq1QulUsmQIUO44YYbzvucOXPm8OKLL17yugXbCOzggUqtxFBWTWl+JV6B1g2Xo7yj6B/cn605W1l6aClPJD5h1etbg66vvBPXsGMHksWCQnnhphMXpFTBuM/gs+FQcAiW3Q6T14KTCO+Fs7voUOrGG2/kxx9/5KWXXsLV1ZVZs2bRu3dvfvzxR4YNa51F3BxFhFKCIAiCAGVr1pDz/Cwsej0qb29C3ngdt7Zy1KUsG9Y9KxduBdD5wfCXocftYI0378Cegj3MS54HwBOJT9DVtysAwa+/jrZ3PHmvvELFr79yfNwtuL4xm9zl/8MlL48yf1deiPiTtKVfUWNpWv8GINw9vMnupzD3MJQK66y9jmSxYExLw7CjtibUzp1UVlSzO24aelc3XCoL6XXwQ7x6dak/jqeN64nSxeXsF6yphpN/1gZRv0DpP+pLhcbXBlGjISDW6l2eJIvEsT0F7FxzgsJTFQCoNEq6Dgih17D2uHk7W3W+K8Gkfxwxvfvuu5uMmThxor2W0yKvvvoqr776arPHz5w5k+nTp9ffLisrIzw83BZLEy6CWqMisIMH2UdKyD5SYvVQCmBi14lszdnKt0e+ZUrPKbg5ta56c9pu3VDqdJhLSzGmpuLSpYt1Luzi0dCRL2cPfPcfuHWR1b5vCpeXS9qPPWDAADZs2NDiyT/88EM+/PBDTpw4AUDXrl2ZNWtW/TnwqqoqZsyYwfLlyzEajYwYMYIPPvig0acbGRkZTJkyhc2bN+Pm5sakSZOYM2cO6rNsY7c3pVttKFVR4eCVCIIgCIL9WaqqyJvzOiUrVgCgTYgn9O230fxjl0KrZDbJndu2vN5wVC/xfhj0bIuP6p2p1FjKE789QY1Uw/D2w7k9+nYAjGYjR0uOkhbvRN7zI+k5fz2ep06RP+F+XMzyc+cNq+RgRToA7hr3+oLjUT5R9bufXDW2qXEkmc1UHTrcUJg8ORlLaWn94ya1lj29HkPvGoxWY2LMre3xv2YDSufzhDmGIjiyQd4Nlb4JqssbHlO7QMdBchAVNQLcg2zyuiwWiaO78tm55gRF2fKHimpnFd2vDSVuWDt0Hm2oEH8r88UXXzh6Cfj5+aFSqcjLy2t0f15eHkFBtvkzBeDs7Fy/Q0xoXUIivcg+UkLWkWJir7H+EbOrQ66mk2cnjpYeZdWRVUzs2rqCV4VGgzYxAf1vv6Pftt16oRSAdwSM/x8svgEO/SAXPx/8nPWuL1w2Ljq56dixI0lJSfj6Ni5wWVJSQu/evTl27FizrxUWFsbrr79OZGQkkiSxaNEibrzxRnbv3k3Xrl2ZNm0aP//8MytXrsTT05OpU6cyduxY/vrrLwDMZjNjxowhKCiIv//+m5ycHCZOnIhGo+G111672JdmdSqxU0oQBEG4QhmPHSdr2jSMqamgUOD74H/wf+ihs9Y+anWO/y4f1SuoPc4T1kc+qhfcw6rTSJLEs38+S44+B7VSTZh7GE/+/iRpxWmcKDuBRbLUj3WdKDH1JwXx6XLHstSrwxl80y08WLv7Kdg12Kb1eSSTiaqDB+uLklcm72ryoZtSp0Pbuzea3n34Iy+K8jwzWncNN8/oe+4C4KePyiFU6i+QsQ0kc8NjrgFyt7yoUdBxoE2PfljMFo4k5bHzl5OU5MkNapxcVHQfFEbPIeFo3UQYdTlwcnIiPj6eTZs2cdNNNwFys6ZNmzYxdepUxy5OcAhb15VSKBRMiJ3AC1tf4H+H/sedXe5scZ0+a3Pt2w/9b79j2LYN38n3WPfi7fvD9e/KRc9/nyt3Qe1xq3XnENq8i/4bceLECcxmc5P7jUYjWVlZF3Wt66+/vtHtV199lQ8//JBt27YRFhbGZ599xtKlSxk8eDAgf8LSpUsXtm3bRr9+/Vi/fj0HDx5k48aNBAYGEhcXx8svv8xTTz3FCy+8gJOD20rXH98ziFBKEARBuHKU/vADOS+8iGQwoPL1JeTNN3C7+mpHL+vCynJg/XOw/xv5ts5PLtja8w6bHDn49si3/Jb5GyB3xft8/+eNHvdy9iLaO7phB9S4zvj8nIT5yFGuf+opVB4eVl9THam6msr9+xuO4+3ejWRo3E1Y6eaGLj6+vjC5S2wsZouCnxbsoSCvBGedmhse7dU4kLKY4dSO2m55axtqdNUJ6NpQHyqkt82PephrLKRuzyV57UnKCioBcNap6TkknB6DwnDWtZGaZ0K9iooK0tPT628fP36clJQUfHx8aNeuHdOnT2fSpEkkJCTQp08f5s+fj16vr+/GJ1xZgjp6olQpqCg2UlpQiVeA9cPvMR3H8H+7/49sfTYbMzYyMmKk1edoifq6Ujt3ItXUWP/Do7g75Y58f82H7x+Sd1CFJ1p3DqFNa/afuB9++KH+1+vWrcPzjJa8ZrOZTZs2ERERcckLMZvNrFy5Er1eT//+/UlOTsZkMjF06ND6MTExMbRr146tW7fSr18/tm7dSvfu3Rsd5xsxYgRTpkzhwIEDDu8GKGpKCYIgCFcSS2Ulua+8Qum3cv0lXd++hMx9E01AgINXdgFmE2xfKB/Vq66Qj+ol3AeDnwWtt82mzTPIR4jUCjUdvDoQ5R1FtHd0fe0nP61f00/t77FOYfV/shiNVO7ZU3scbyeVKSlIVVWNxig9PdElJNQXJneJiUGhUtU/bjZZ+OWjfWSllqBxUXH9I3H4hbmBsRyO/gqpa+HIOjCcPuOiaoi4Rt4NFT1S/mHFDmpMZg7/nUPyupNUFMkFtl3cNMQNDaf7v8Jw0raunQxC8+3cuZNBgwbV366r5TRp0iS+/PJLxo8fT0FBAbNmzSI3N5e4uDjWrl3bpPi5cGXQOMt1pXLSS8lKLbZJKOWidmF89Hg+3PMhiw8sZkT7EXbvPHk+LjExKD09sZSWUnXgANqePa0/yZDZUHgEUn+G5XfCA7+Cl6irJsia/R23bourQqFoUqhQo9EQERHB22+/fdEL2LdvH/3796eqqgo3Nze+++47YmNjSUlJwcnJCS8vr0bjAwMDyc3NBSA3N/es3TPqHjsXe7VlrQulzCKUEgRBEC5zxvR0Mh97jOr0o6BQ4PfQQ/hNebBRaNEqHf8D1jx+xlG9RBj9FoTE2XzqKT2ncHPnm/HX+qNR2XdHjqWyUg6handCVe7Zg1Rd3WiMytu7NoRKRNcnEeeoqHN2ZrKYLaz//AAZB06j1ii57p5gAvNXwJ9r5eOQ5jOu7eIJkcPl3VCdh8q37cRUbebgH9nsXn8Sfam8Jp2HE72Gt6PrgFA0zq38z6twQQMHDkSSpPOOmTp1qjiuJ9QLi/EhJ72UzMPFdB0QapM5bou+jc/2fca+wn3sKdhDXECcTea5FAqVCtc+iZRv2Ih+23bbhFJKJYz9GD4fCXn7YNkdcO9acG5dhd8Fx2h2KGWxyHUNOnToQFJSEn5+flZZQHR0NCkpKZSWlvLNN98wadIkfvvtN6tc+1zs1ZZV7JQSBEEQLneSJFG66jtyX34ZqaoKlb8foXPfwrVfX0cv7fzKcmDD87BvpXxb5wtDX4S4u+zWHUipUBLiZv3Cumdj0esx7E6pL0xeuW8fmEyNxqj8/Op3QbkmJuLUuXOzPs2XLBKbFh3i2O4ClEoLo9stImT16saDvDvInfKiR0G7fmDnEK66qob9v2eRsiGDynL5dbt5O9NreHtirw5G7STCKEG4UoXFeJP003EyU4uRLBIKpfV3Mflp/biu03WsOrKKxQcXt6pQCkDXtx/lGzZi2L4N/vNv20zi7AZ3LINPBsnB1Kp/w/ivREc+4eJrSh0/ftyqC3BycqJz584AxMfHk5SUxLvvvsv48eOprq6mpKSk0W6pM7tjBAUFsWPHjkbXq+umcb4OGvZqy9oQShkuMFIQBEEQ2h6LXk/uSy9R+r18xN/1qqsImfsm6n80Q2lVzCbY/lHtUb1yQAGJ98ld9XQ+jl6d1ZgrKqhMTq4vTF514CDU1DQaow4MlHdB1X45dYi4uCMlpiqkY7+z5dss0jLao6SGkR5vEq5PAhQQ3qe2PtRo8IsCBxxXMVbWsG9zJns2naJKL4dR7r4uxI9sT0y/YFQa8cOQIFzpAiM8UDurqKowcTq7Ar8wd5vMM6HLBFYdWcWmjE2cKj9FuHvrOb5W90GSIXkXlupqlLaqzewVDrcvhS+vk4/y/foSDH3BNnMJbUazQ6mtW7dy+vRprrvuuvr7Fi9ezOzZs9Hr9dx000289957LW53arFYMBqNxMfHo9Fo2LRpE+PGjQMgNTWVjIwM+vfvD0D//v159dVXyc/PJ6C2XsWGDRvw8PAgNjb2nHPYqy2r2CklCIIgXK6qUtPImjaN6mPHQKnE/5FH8P33A+c83tUqnPgTfn4cCg7Jt0MTYMxbEOLYGpTWYC4txZCcXH8cr+rQIbBYGo3RhITUH8XTJSaiCQ+/+Lom+kJIWwepa5DSN/NX0W0cNNyAAjNDfT+kQ/dAiP5APp7n5m/FV3hxqvQm9vx6in2bMzEa5DDOM0BL/MgIovoGolK14j+ngiDYlUqtJKSzFxkHTpN5uNhmoVRn785cHXI1f2X/xdJDS3mqz1M2medSOHXqhMrPD3NhIZUpKbj26WO7ycL7wI3vw6oH4M958ocWcXfabj6h1Wt2KPXSSy8xcODA+lBq37593Hfffdxzzz106dKFuXPnEhISwgsvvNDsyWfOnMmoUaNo164d5eXlLF26lC1bttQXUr/vvvuYPn06Pj4+eHh48PDDD9O/f3/69esHwPDhw4mNjWXChAm8+eab5Obm8txzz/HQQw/ZJXS6EKWrfEbWUlFhkxajgiAIgmBvkiRRsnIlea++hmQ0og4MJPTtt9AlJDh6aedWngvrn4d9X8u3tT4w7EWIu7vNHhuoKS7GsHNnfWFy4+HD8I86Opp27Rodx9OEXkKtFEmSO+SlroHUX+TOecjzbC+/kz2GGwAYNEJB5HXLQOPS0pfWIpXl1aRsPMW+LZmYjHK3aO8gHQmjI+gcH4BShFGCIJxFWLS3HEqlFhM3tJ3N5pkYO5G/sv9i1ZFVTImbgoeT7bqoXgyFQoFrnz6UrVmDYfsO24ZSAD1ukzvy/fEW/PCIfMS7fX/bzim0Ws0OpVJSUnj55Zfrby9fvpy+ffvyySefABAeHs7s2bMvKpTKz89n4sSJ5OTk4OnpSY8ePVi3bh3Dhg0DYN68eSiVSsaNG4fRaGTEiBF88MEH9c9XqVT89NNPTJkyhf79++Pq6sqkSZN46aWXmr0GW6rbKYXFglRVhUKrdeyCBEEQBKEFzBUV5M6aTdmaNQC4XjuAkDfeQO1tuw51LWKugR0fw+bXGo7qJdwLg59rc0f1agoL5RCqdieU8ciRJmOcIiIa74Q6TymD8zLXQMZWOYRKXQPF/yjdENSDZPP9JOfKR0+uvT2KLgPDLm0uK9GXGtm9IYMDv2dRUy3vEPMNdSNhdASdevnbpEaMIAiXj7AY+ftYdloJZrPFZrsp+4f0p7NXZ9JL0vk27Vsmd5tsk3kuha5fX8rWrEG/fRv+D9uhEcCgZ+UPPQ79ACvuggc2g3d7288rtDrNDqWKi4sbdbr77bffGDVqVP3txMRETp06dVGTf/bZZ+d93MXFhQULFrBgwYJzjmnfvj1rat8ctzZKXUMIZdHrUYpQShAEQWijqg4eJHPaNEwnM0ClImD6NHwmT269x/VO/i0f1cs/IN8OjZe76oX2duy6msmUl19flNyQlCQfk/wHp86d6ndBaRMS0NSWMrgkVaWQvlEOoo5sgKqShsdUTtDhWrk+VNRI9uyU2LZSDsX6j+1EdwcGUuVFVexen8HBP7Mx18hhVEB7dxJGRxDR3U+EUYIgNItfmBsurhqq9CbyT5QT3Mk2XUEVCgUTYycy6+9ZLD28lLtj70ajtG/jh3NxrT2NVLlnLxaDAaVOZ9sJlUq4eSGUnIScPbDsdrh3Hbi0jt1jgv00O5QKDAzk+PHjhIeHU11dza5duxp1sCsvL0ejaR1/oVoLhVKJUqfDYjDIdaWs1LFQEARBEOxFkiSKly0jf87rSCYT6uBgQt95G12vVlqHqTwPNsyCvcvl21ofuYhqrwmt+qieKTu7vii5ISlJDv/+wTk6+ozC5AmofVq426v4BKSulXdDnfwLLGcUQtf6QNRIiB4JnQaDs1xj5eCf2fy58jAAiWMi6D3cMZ9qlxVWkrzuJIf/zsFilo8TBnX0JGFMBO1ifUTJBEEQLopCqSA02oujuwrIPFxks1AKYHTH0czfNZ9cfS4bT25kVIdRF36SHWjCw1GHBFOTnYNh127crrna9pM6ucLty+CTwZB/EL69X+7QpxQdUa8kzQ6lRo8ezdNPP80bb7zB6tWr0el0DBgwoP7xvXv30qlTJ5sssi1Turo2hFKCIAiC0IaYy8vJee55ytetA8Bt8GBCXnsV1RldcVsNcw0kfSIf1TOWAQqIvweGzGp1R/UkScKUlVV/FM+QlIQpM7PxIKUSl5iYhuN48fEt/323WCB7V219qLUNu8jq+EXV7oYaJRei/ccPBWk7ctn8PzmQihvWjsTrOrRsPZegJM9A8toTpG7PQ7LIYVRolBcJoyMIjfYWYZQgCJcsLNqbo7sKyEotJnGM7f59c1Y5c3vM7XyQ8gGLDixiZMTIVvFvl1xXqi+lq1dj2L7dPqEUgGco3LEUvhgNR9bJHyyNeNU+cwutQrNDqZdffpmxY8fyr3/9Czc3NxYtWoTTGa0iP//8c4YPH26TRbZlSldXKCgQoZQgCILQplTu20/WtGlyWKLREDBjOj6TJrWKN85NnNwKax6HvP3y7ZBeMOZt+cheKyBJEqaTJ+t3QRmSdlKTk9N4kEqFS2xsfT0oXXw8KncrdICqNsCxLXIQlbYO9PkNjymU0O4qOYiKHgW+5/5w8djuAjZ+eQgk6HZtKFeN7WTXPwtF2Xp2/nKC9J159fXcw7t4kzC6AyGRXnZbhyAIl6+wGPkDjJxjpZiqzWicbLdbZ3z0eD7b9xkHTh9gd/5uege2jqPlun5yKKXfvt2+E4fGw00fwjeTYev74B8NvSfadw2CwzQ7lPLz8+P333+ntLQUNzc3VKrGf0lXrlyJm5ub1RfY1tUVOzeLUEoQBKHVePXVV/n5559JSUnBycmJkpISRy+p1ZAkieIlS8ib+xaYTGhCQwmd9w7aHj0cvbSmKvLlT1T3LJNva71hyGz5jawDt/5LkkT1sWNyAFW7G6qmoKDxILUabbdu9TuhtL16o3Jztc4CynMhba28G+rYZqipanjMyR0ih8q7oSKHNWsX2ckDp1n36X4ki0RMvyCuvT3KboFUYWY5O9ec4Ojugrqmf7Tv7kvC6AiCOtjueI0gCFcezwAtbt7OVBQbyU0vJTzWdrtsfVx8uL7T9XyT9g2LDy5uNaGUa9++AFTt34+5vNw6H440V7excuHzLXPgp2ng0xEirrHf/ILDNDuUquPpefY3AD4trWtwmaoLpcROKUEQhNajurqaW2+9lf79+1+w6caVxFxaSvazz1KxcRMA7sOGEfzqK6g8WlnRUXMN7PwMfn3ljKN6k+RAygFH9SSLBeOR9IbC5Dt3Yj59utEYhUaDS88eDYXJ4+KsV0RWkiDvAKT9Ihcqz0pu/LhnO7k2VPQoaH8NqJ3Ofp2zyEot5peF+7CYJTr1DmDQhBi7FA/PP1lG0s8nOLG3sP6+jnH+JIyOwL+dHX9IEgThiqFQKAiL9ubwtlwyU4tsGkoBTOgygW/SvuHXjF85VXaKcI9wm87XHJrgYJzat6f65EkMSTtxHzzIvgv411NQkAoHVsGKCfDAJjmcEi5rFx1KCRdHhFKCIAitT12jji+//NKxC2lFKvfsIWvadEzZ2Sg0GgKeegrvu+5sfcf1MrbBzzMaH9Ub/TaE2e+onmQ2Y0xLw7BjB/qkJCp3JmP+x247hbMz2ri4+sLk2p49ULq4WG8RNdVycfLU2iCq9B+F0UN6Q/RoOYgK7AqX8P8x91gpP32wF7PJQkR3X4bdG4vSRm3S6+QcLWXnmuNkHCiS71BA5/gAEkZF4BsqduQLgmBbYTG1odThYpvP1dGrIwNCB/BH1h8sObSEZ/o+Y/M5m0PXr58cSm3fZv9QSqGAmz6QG3Fk74Klt8P9G8BF7Iy9nIlQysaUtUcaLRUilBIEQRBaH8lioejLReS/8w7U1KBp147Qd95B262ro5fWWEU+bJgNe5bKt128YOhs6D3J5kf1pJoaqg4dbtgJlZyMpays0RiFVouuV6/6mlAu3bujdGr+jqRmMRRB+ka5PlT6ptpdYrXULtBxYG2h8pHgHtSiqQoyyvnxvT3UGM2ExXgz4t/dUKltE0hJkkR2WglJa06QlSr/IKhQKohKDCR+VHu8g6x0rFEQBOECQqPl3VEFGeUYDSacdbbtLj+x60T+yPqD1emreSjuITydHR++uPbtQ8mKFei373DMAjRauQPfx4OgMBVWToY7vwaViC4uV+L/rI0pXeWt+WKnlCAIQttmNBoxGo31t8v+EUq0RTXFxeQ8PZOK334DwH3USIJffhlVa6oRaa6BnZ/XHtUrle/rPRGGvACuvjaZUjKZqDpwoL4weWXyribfx5U6Hdr4+NqdUAlou3VDobHBDy+njzbshsrYCpK54TFXfzmAih4tB1JO1jkOWJSt54f/S6G6sobgzp6MntIDtcb6wZ8kSZw6VMTONSfISZf/3yqVCqL7BxE/sj2e/lY63igIgtBMbt7OeAXqKMkzkJVWQsc4f5vO1zeoL1HeUaQVp/FN2jfc1/0+m87XHLo+fQAwHj5MTXExam9v+y/CPQjuXA6fj4Sjm2D9szDqDfuvQ7ALEUrZmDi+JwiCYB9PP/00b7xx/jcshw4dIiYm5pKuP2fOnPpjf5cDw65dZE2fQU1uLgonJwKfeQav8be1ruN6GdthzQzI3SffDo6Tu+qFJVh1Gkt1NVX79jUUJk9JQTIYGo1Rurujqwuh+iTi0qULCrUN3kZZzJCZJO+GSv1FLvp6poDY2m55o+Ujekrr7l4qyTfw/bu7qaowEdDenese6onG2bqBlCRJnNx3mp2/nCDvuBzuKtUKYq8KodeIdnj4aq06nyAIwsUIi/GmJM9A5uFim4dSCoWCibETee6v51h6aCkTYyeiUdl2d9aFqP38cI6MxHjkCIbtO/AYOcIxCwnuCTd/BF9PgO0LwS8KEh0f2gnWJ0IpGxOhlCAIgn3MmDGDe+6557xjOna89GKZM2fOZPr06fW3y8rKCA93fFHSiyVZLJz+9DMK3n0XzGacIiIInT8Pl0sM62yiogA2vgApX8m3XbxgyCyIv8cqR/UsRiOVKXvqj+NVpqQgnbELDkDl6Yk2MQHX2ppQztHRKFQ2OiZorICjv8oh1JF1YDijSLpSDe2vrq0PNRK8I2yzBqC8qIrv5+/GUFqNb6gr1z8Sh5PWem8VJYvEsT0F7FxzgsJTFQCoNEq6Dgih17D2uHk7W20uQRCESxUW483+37LIPFxkl/lGdRjF/F3zya/MZ93JdVzX8Tq7zHs+un79MB45gn77NseFUgCxN8Dg5+HXl2HNE+DbGTr+y3HrEWxChFI2phKhlCAIgl34+/vj72+7TzSdnZ1xdm7bPzTXnD5N9lNPo//zTwA8rr+eoNmzUbm1kpo9FnPtUb2Xoar2qF6vCTD0BXD1u/TLVlZSmZJSvxOqcu9epOrqRmNUPj71Rcl1iYk4R3ZGYeVdSI2UZjV0yzv+O5jPWI+LJ0QOl3dEdRoCWi/braOWvtTI9/N2U1FkxCtQxw2P9sLF1Tqf1lssEkeT89n5ywmKsuX3Q2pnFd2vDSVuWDt0HlauvSUIgtACoVHeoIDiXAP6UiOunrb93u+kcuKOmDt4b/d7LD6wmDEdxjh817Jrv74UL1mCYdt2h64DgAEz5I58+76GryfC/ZvAr7OjVyVYkQilbEzslBIEQWh9MjIyKCoqIiMjA7PZTEpKCgCdO3fGrTXVU7Ii/Y4dZM94nJqCAhQuLgQ9/xyeY8c6/I1vvVM75K56uXvl20E9YMw7EJ540Zey6PUYdu1u2Am1fz+YTI3GqPz95F1QffqgS0zEqWNH2/5eSBLk7JFDqLRf5F+fyTsCosfIu6Ha9Qc7Ht+orKjm+/kplBZU4u7rwo2PxVklKLKYLaQl5ZH8y0lK8uTjkE4uKroPCqPnkHC0biKMEgSh9XFx1eAf7k5BRjmZh4uJ7tuyxhHNcWvUrXyy9xMOFR1iZ95OEoMu/nufNekSEkChoPr4cUx5+WgCAxy3GIUCbngPio/Lx9uXjYf7N4LWAbWuBJsQoZSNiVBKEASh9Zk1axaLFi2qv92rVy8ANm/ezMCBAx20KtuQzGYKP/qIwvcXgMWCU6dOhM57B5eoKEcvTaYvhI2zYXfdUT3P2qN6k5t9VM9cXo4hObk2hNpJ1YEDYDY3GqMOCqovSq5LTMQpIsL2gZypCk78IdeHSlsHZVlnPKiA8D4Nhcr9o+U33nZmNJj44d0UinP0uHo5c+NjvXDzdmnRNc01FlK35ZK89gRlhVUAOOvU9BwSTo9BYTbvZiUIgtBSYdHeciiVap9QytvFmxs63cDXaV+z+OBih4dSKk9PXGJjqTpwAMOO7Xhef71D14PGBW5fKnfkO50OX0+Cu7+16wc4gu2IUMrG6kIps0GEUoIgCK3Fl19+yZdffunoZdhcTUEBWU8+iWHrNgA8b76ZoOefQ6lrBV3NLGZI/gI2vXTGUb27YeiLFzyqZy4pkUOoHfJOqKrDh8FiaTRGExracByvTyKasDD77ArTF8oBVNovkP4rmM74/q/RQafB8rG8yBHgZtsCuhdSXVXDT+/vofBUBVp3DTc+Foen/6UXGa8xmTn0Vw671p+kokiu0eXipiFuaDjd/xVm1fpUgiAIthQW483uDRlkHi5CkiS7fP+YEDuBr9O+5rdTv3Gi9AQRnhE2n/N8dP36yp1ot21zfCgF4BYAd66Az4bD8d/gl6fk5ietZce3cMnEuwMbU9YeA7FUiFBKEARBsB/91q1kPfEk5sJCFFotQbNn4XXTTY5elixzJ/w8veEIW1D32qN6fc46vKa4uH4XlCEpCWNqqnwc7gya9u3QJSbWFybXhITY+lXIJEnukJdaWx/q1HbgjLW5B8shVNQo6HCt/GlvK1BTbWbNh3vJPVaGs07NDY/2wjvo0mqLmarNHPwjm93rT6IvlWtj6Tyc6DW8HV0HhFq9e58gCIKtBXf2QqlSUFFkpKywEk9/23+YE+EZwcCwgWzJ3MJXh77iuX7P2XzO83Ht14+izz5vHXWl6gR1g3GfwvI7Yedn4B8Dff/t6FUJLSRCKRsTx/cEQRAEe5LMZgoXfEDhhx+CJOEcGUnou/NxbkHnQavRF8pd9XYvkW87e8KQ5yHh3kZH9WoKC+vrQRmSkjAeSW9yKacOHerrQekSE9AEBtrpRQDmGji1rTaIWgNFxxo/HtRDDqKiR0FwXKv7FNdssvDLR/vJSi1B46Li+kfi8Au7+Fpq1VU17P8ti5SNGVSWyzW73Lyd6TW8PbFXB6N2EmGUIAhtk8ZZRWAHD3LSS8k8XGyXUApgYteJbMncwvfp3zM1bipeLl52mfdsdL17g1qNKSuL6sxMnMLCHLaWRmJGw7AXYcMsWPsU+HaCzkMcvSqhBUQoZWMilBIEQRDsxZSXT/bjj2NISgLA69ZbCXz2GZQuDt6dYzFD8pe1R/VK5Pvi7pKP6rn5Y8rLqz+KZ0hKovr48SaXcI7s3HAcLyEBtQ07LZ5VVSmkb5KDqCPrG14HgMoJIgbU7ogaCV7h9l3bRbCYLaz//AAZB06j1ii57qGeBEZ4XNQ1jJU17Nt8ipRNpzDqawBw93UhfmR7YvoFo9LYsGuhIAiCnYTF+NSHUl0HhNplzoTABLr4dOFQ0SFWpq3kgR4P2GXes1G6uqLt3p3K3bsxbN/eekIpgKsekTvypfwPVk6G+zfItRmFNkmEUjZWF0pJVVVINTUo1OK3XBAEQbC+ij/+JPuppzAXFaHU6Qh68UU8r7/O0cuCzOTao3op8u3A7pgSnkafVYNhznwMSTsxZWQ0fo5CgXN0dKPC5GpvB3TZKT4JaWvl3VAn/gRLTcNjWh+IGiEHUZ0Gg7O7/dd3kSSLxKbFhzi2uwClWsHoKT0IifRq9vOr9Cb2/HqKvb9mUl0p/154BmiJHxlBVN9AVCoRRgmCcPkIi/Em6afjZKYWI1kkFErb73pVKBRMiJ3AM38+w9LDS5nUdRJOKsd1KtX160vl7t3ot23Ha9w4h62jCYUCrpsn71TO2ApLx8MDv4LOx9ErEy6BSEhsrC6UArAYDKg8Lu7TSEEQBEE4H6mmhoJ3/4/Tn3wCgHNMDKHz3sG5QwfHLkx/Gja9iJS8GJNeiaHIF4OyF4bfSzC9+0TjsUolLl261Bcl18XHo/L0tP+aLRbI3i2HUKm/QP6Bxo/7RtYeyxst179qZnfA1kCSJLYsSyVtex5KpYKRD3QjPLZ5b94ry6tJ2XiKfVsyMRnlrobeQToSRkfQOT4ApQijhMvUzTffzJYtWxgyZAjffPNNo8d++uknZsyYgcVi4amnnuL+++930CoFWwmM8EDtrKKqwsTpbP0lHXO+FCMjRjI/eT75lfmsPbGWGzrdYJd5z8a1Tx9Of7gQQ1KS3Qq+N5vaGcZ/BZ8MguLjsGICTPgO1I4L8YRLI0IpG1M6OYFGAyYTFr1ehFKCIAiC1Zhycsia8TiVu3YB4H3nHQQ89RRKZ2eHrUky11C95l0M332AIasGQ34ANZV14c1B+T8qFS7dutYXJdf27o3K3UE7jaoNchef1DVy17yKvIbHFEpo17+hULlfZ8essYUkSeKvlekc/CMbhQKG3htLh54XPv6oLzWye0MGB37PoqZa7m7oG+ZGwqgIOvXyt8uuAUFwpEcffZR7772XRYsWNbq/pqaG6dOns3nzZjw9PYmPj+fmm2/G19fXQSsVbEGlVhLS2ZOMA0VkHi6yWyilUWm4o8sdvLvrXRYfWMz1Ha93WBikjYsDjYaa3FxMmZk4hbey4+mufnBHbUe+k3/Cmsfh+ndbXS1H4fxEKGUHKp0Oc2mpqCslCIIgWE35li3kPPU05tJSlG5uBL/yMh4jR9p9HZIkUX30qFwP6rf16JN2YNZbAKfaL0CjQdutW+1OqD7oesU12klsd+V5tcfyfoFjW6CmsuExJ3e5YGr0aIgcdlkcBdj+wzH2/HoKgEETuhCZcP6i8OVFVexed5KDf+VgrpHDqID27iSMjiCih1/r+qRcEGxo4MCBbNmypcn9O3bsoGvXroSGynWGRo0axfr167njjjvsvELB1sKifeRQKrWYuKHt7DbvrVG38vHej0ktTmVH7g76Bve129xnUmq1aLt1k+tK7UhqfaEUQGAs3PI5LBsPuxbJtaX6P+ToVQkXQYRSdqB0dRWhlCAIgmAVkslE/rz5FH3+OQAuXbsSOu8dnNrZ582yZLFgPHKkoTD5zp2Yi4oajVEoJbSRYegGXYeub1+0cXEotVq7rO+sJAnyD9Yey1sLWTsbP+4Z3tAtr/01l9XW/+S1J0j+5SQA194eRZergs85tqywkuR1Jzn8dw4WswRAUEdPEsZE0C7WR4RRQqvy+++/M3fuXJKTk8nJyeG7777jpptuajRmwYIFzJ07l9zcXHr27Ml7771Hnz59Wjx3dnZ2fSAFEBoaSlZWVouvK7Q+YTFyPcPstBLMZovdaud5OntyY6cbWZ66nMUHFzsslALQJSbWhlI78Bo31mHrOK+o4TD8FVj3DKx/Tj5uHzXc0asSmkmEUnagdJO3eopQShAEQWgJU1YWWdNnULlnDwDeEyYQ8MTj8lFxG5HMZqoOH67tjLeTyp07MZeWNhqjUElofavRBRjR9R+AdtKbKP3s94nyWdVUw8m/GgqVl/yjmHpIb3k3VPRICOx2WW7137PpFNtWHwOg/9hOdB949s5JJXkGkteeIHV7HpJFDqNCo7xIGB1BaLS3CKOEVkmv19OzZ0/uvfdexo5t+oPyihUrmD59OgsXLqRv377Mnz+fESNGkJqaSkBAAABxcXHU1NQ0ee769esJCQmx+WsQWj+/MDdcXDVU6U3knygnuJP96h3eHXs3K1JX8Hvm7xwrPUZHz452m/tMuj59OP3xx/WdfVutfv+FgsOwazF8cy/ct17eRSW0eiKUsoO6IwrmigoHr0QQBEFoq8o3bSJ75jNYyspQengQ8tqruA8davV5pJoaqg4datgJlZyMpby80RiFTocuthM6lxPonI+j9alGEdwVxrwF7a+y+pqazVAE6RvlY3npG8FY1vCY2gU6DoSokfKXx7l3DF0ODv6ZzZ8rjwCQOCaC3sPbNxlTlK1n5y8nSN+ZhyRnUYR38SZhdIeL6sonCI4watQoRo0adc7H33nnHR544AEmT54MwMKFC/n555/5/PPPefrppwFISUm5pLlDQkIa7YzKyso67w4so9GI0Wisv11WVnbOsULrolAqCI324uiuArJSi+waSrX3aM/A8IFsPrWZrw5+xaz+s+w295l0veJApcKUnY0pKwvNGbsEWxWFAka/DUXH4cQf8nG+BzbLdaeEVk2EUnZQF0pZ9AYHr0QQBEFoa6TqavLeeovixUsAcOnZg9C338EpzDpvCiWTicr9+zEk7cSQlETlrl1NdvYq3dzQxveWC5N3j8Yl9xsUuxcBEjh7wKCXIPEBUDngbcXpow31oU7+DZK54TFXfzmAih4lB1JODqxjZUdpO3LZ/L/DAMQNDSfxusadGAszy9m55gRHdxdAbRgV0d2X+NERBHVwQNdDQbCy6upqkpOTmTlzZv19SqWSoUOHsnXr1hZfv0+fPuzfv5+srCw8PT355ZdfeP755885fs6cObz44ostnldwjLBob47uKiDzcDEJo+3b2XZS10lsPrWZH47+wMO9Hsbbxduu84P8s6xLt65U7dmLPikJr9YaSoF8/P62xfDJ4NqOfHfDxO/lTn1CqyVCKTtoCKXE8T1BEASh+apPnSJr2nSq9u8HwGfyZAKmPYaiBcf1LNXVVO3dW3scLwnD7hSkyspGY5QeHuji4+sLk7vERKNQKmH3Etg4ESpra0j1GA/DXgL3oEtez8W/ADNkJskhVOovUJja+PGA2NogajSExoPSPvU/WotjuwvY+OUhkKDbtaFcNa5z/fG7/JNlJP18ghN7C+vHd+zlT8KoCPzbOaj7oSDYQGFhIWazmcDAxkX9AwMDOXz4cLOvM3ToUPbs2YNerycsLIyVK1fSv39/1Go1b7/9NoMGDcJisfDkk0+et/PezJkzmT59ev3tsrIywltjwWjhrMJi5IYXOcdKMVWb0TipLvAM6+kd0Juuvl05cPoAX6d+zX96/sduc5/JNTGRqj3yewevf9Rua3V0PnDn1/DpUMjYCj9NgxsXXJbH9C8XIpSyAxFKCYIgCBerbO06cp57DktFBSpPT4LnzMF98KCLvo6lqorKlD31IVTlnj1IZxwjAVB5eaFLTJBDqMREnKOiUKjOeNOdvRt+fryhQHhALIx+CyKubslLbD5jBRzbLIdQaWvBcLrhMaVaPjIYPVoOo3zs+yl2a3LywGnWfbofySIR0y+Ia2+PQqFQkHO0lJ1rjpNxoDZMVEDn+AASRkXgG2qfFueC0BZt3LjxnI/dcMMN3HDDDc26jrOzM87OYqdGW+UZoMXN25mKYiO56aWEx9qvK6tCoWBi7ESe+uMplh1exj3d7sFZZf8/S7rERE5/+hmGpJ0XHtwa+EfBrV/A/26FlP/JHfmuftTRqxLOQYRSdiBCKUEQBKG5LEYj+W+8QfHSZQBoe/Ui9J230QQ3rwaSxWCgMiUFfW0IVbVnL5LJ1GiMyte3NoCSgyjnzp3lnVD/ZCiCX1+BnZ8DEji5w6CZ0OffoNK09KWeX2lWw7G847+D+YwgzcUTOg+Tj+V1HgpaL9uupQ3ISi3ml4X7sJglOvUOYNCEGLKPlJC05gRZqcWAXBslKjGQ+FHt8Q66Mo4yClcmPz8/VCoVeXl5je7Py8sjKMiOOzuFy4JCoSAs2pvD23LJTC22aygFMCxiGO8kv0OeIY81x9Zwc+TNdp0fQBsv7zw2ZWRgystD849diK1S5yEw8nX45QnYMFvuyBcz2tGrEs5ChFJ2oHTVASKUEgRBEM6v+sQJMqdPx3jwEAC+DzyA/yMPo9CcOwAyV+ip3L2rvjB55f798I9uUuqAgPpdULo+iTh16HD+jmoWi/zJ4sbZDbuSut8Gw1+23VE9SYLcvbXH8tZAzp7Gj3tH1HbLGwXt+ts+FGtDco+V8tMHezGbLER09yWmfxCr5+0mJ13ukqhUKojuH0T8yPZ4+uscvFpBsD0nJyfi4+PZtGkTN9UeNbJYLGzatImpU6c6dnFCmxQaUxtKHS4COtl1bo1Sw11d7uKd5HdYfHAxN3W+ye5dUVVubrh06ULVgQMYdiThef11dp3/kvV5QO7It/Mz+PZ+uSNfUDdHr0r4BxFK2YHYKSUIgiBcSOnPP5M7azYWvR6Vtzchb76B24ABTcaZy8owJCfXFyavOngQzOZGY9TBwfW7oFz79EHTrl3z38Bmp8Cax+W6TQD+XeSuehHXtPAVnkWNEY7/IYdQaWuhLOuMBxUQliiHUNGj5a33oh5EEwUZ5fz43h5qjGbUGiXlxUZ+XrAXAKVaQexVIfQa0Q4PX62DVyoI1lVRUUF6enr97ePHj5OSkoKPjw/t2rVj+vTpTJo0iYSEBPr06cP8+fPR6/X13fgE4WKERcu7owoyyjEaTDjr7PvByLiocXy450PSS9LZmrOVq0Ls3+lWl5hYG0rtaDuhlEIBo96A0+lw/DdYdjs88Cu4BTh6ZcIZRChlByKUEgRBEM7FUlVF3mtzKPn6awB0CQmEvP1W/dZ4c0kJhp1yAKVPSsJ46LC8q+gMmrCwRjuhNKGhF/8pamUx/Pqq/GmiZAEnNxg4E/r+x7q7kvSn4cg6OYg6uhmqK854ITroNFgOoiJHgJu/9ea9DBVl6/nh/1KorpR3xtWYLJzOrEClUdJ1QAi9hrXHzVvUsREuTzt37mTQoIY6e3WFxCdNmsSXX37J+PHjKSgoYNasWeTm5hIXF8fatWubFD8XhOZw83bGK1BHSZ6BrLQSOsbZ9/uTh5MHYyPH8r9D/2PxgcWOCaX69KHoyy8xJCXZfe4WUWngtkVy4fPT6bD8Tpj0E2hcHL0yoZZDQ6k5c+awatUqDh8+jFar5aqrruKNN94gOjq6fkxVVRUzZsxg+fLlGI1GRowYwQcffNDoG0pGRgZTpkxh8+bNuLm5MWnSJObMmYNa3ToyN5WbXETUoq+4wEhBEAThSmI8doysx6ZhTEsDhQLfB/+D9x13ULlrN6dra0IZ09KaPM+pfXt0fRLrg6jm1ps6K4sF9iyV6y0Yaruydb8Vhr0MHi24bh1JgsIjDbuhTm2XQ6867sEN3fI6DACN2NHTHCX5Br5/dzdVFQ31wtTOKrpfG0rcsHboPC69Q6MgtAUDBw5E+kdA/09Tp04Vx/UEqwmL8aYkz0Dm4WK7h1IAd3W5i2WHl/FX9l+kF6fT2buzXefXJcSDQkH1iROY8vPRBLSh3UZab7kj3yeD5Z3gPzwMYz8WO7BbCYemNr/99hsPPfQQiYmJ1NTU8MwzzzB8+HAOHjyIa+3uomnTpvHzzz+zcuVKPD09mTp1KmPHjuWvv/4CwGw2M2bMGIKCgvj777/Jyclh4sSJaDQaXnvtNUe+vHp1O6XMYqeUIAiCUKv0++/JefElJIMBAKeICMo3bOD0hwubjHXq1KmhO15CIppAK70RzNkjd9XL3CHf9o+Ru+p1aHps8KKYa+DUttr6UL9A0dHGjwd1b+iWFxwHZyuyLpyTxWzhh3dTMJRWA+DkoqL7oDB6DglH6ybCKEEQBFsIi/Fm/29ZZNY2j7C3cPdwBocPZmPGRr469BUvXPWCXedXeXjgHBOD8dAhKnfuRDO6jRUN9+0Ety2Gr8bCvq/lsgDXPu7oVQk4OJRau3Zto9tffvklAQEBJCcnc+2111JaWspnn33G0qVLGTx4MABffPEFXbp0Ydu2bfTr14/169dz8OBBNm7cSGBgIHFxcbz88ss89dRTvPDCCzg5Of7NmTi+JwiCINSxVFaS+/IrlK5a1ej+6uPH63/tHBXVcBwvMQG1r691F1FZAptfhaRPzziq9zT0ffDSj+pVlUH6Rnk3VNo6qCppeEypgQ7XysfyokaCV7g1XsUVq7rSjNFQg7NOTc8h4fQYFGb3+iaCIAhXmtAob1BAcY4efakRV0/7H4+e2HUiGzM28uPRH3mk9yP4uNi3E6AuMQHjoUPok5LwaGuhFEDHf8HoufDTNPj1ZfCLgtgbHL2qK17rON9Wq7RU7hLj4yP/5UpOTsZkMjF06ND6MTExMbRr146tW7fSr18/tm7dSvfu3Rsd5xsxYgRTpkzhwIED9OrVy74v4iwaQimDg1ciCIIgOFrRkq8aB1IKBc4xMWfshEpA7e1tm8ktFtizDDbMajiq120cDH8FPEIu/nolGZC6Vj6ad+JPsDQcJUPrLQdQUSPlOlEuHtZ5DQIubhomvXYVSrUCtUbl6OUIgiBcEVxcNfiHu1OQUU7m4WKi+9qoG+15xPnH0c23G/tP72dF6gqm9Jxi1/l1iYkUL17S9upKnSnhXihIhe0L4bv/gFc7CIlz9KquaK0mlLJYLDz22GNcffXVdOsmt2nMzc3FyckJLy+vRmMDAwPJzc2tH/PPgoV1t+vG/JPRaMRoNNbfLisrs9bLOCuxU0oQBEGo49q/P5VDhuDUrp0cQsX3RuXpafuJc/bKXfVObZdv+0XLXfU6XNv8a1gskLO74Vhe3v7Gj/tGQnRtfaiwPqBqNW8zLjtOWvF7KwiCYG9h0d5yKJXqmFBKoVAwsetEnvz9SZYfXs693e7FWWW/HVu6hAQAqtOPUlNUhNrHvju1rGb4q3K9y6ObYNkd8O/N4G7//5+CrNW8o3nooYfYv38/f/75p83nmjNnDi+++KLN56lzZiglSdLFd0QSBEEQLhva7t0IX/C+/SasLIHNr0HSJ/JRPY1rw1E9dTOOuJsq4dhvDYXKK/IaHlMooV3/2kLlo8Av0mYvQxAEQRAcLSzGm90bMsg8XOSwn+uGth9KkGsQufpc1hxbw82RN9ttbrW3N86RkRiPHMGQtBOPEcPtNrdVqdRw6xfw6TAoTJWDqclrRLMVB2kVlUWnTp3KTz/9xObNmwkLC6u/PygoiOrqakpKShqNz8vLIygoqH5MXl5ek8frHjubmTNnUlpaWv916tQpK76apupCKcxmpDN2aAmCIAiCzUgSpCyD9xNgx0dyINV1LExNgqsfOX8gVZEPuxbLb9Le6ADLxsOuRXIg5eQGsTfCzR/BE0flN3FXPyICKUEQBOGyF9zZC6VKQUWRkbLCSoesQaPUcGfMnQAsPrj4gl0orU3Xpw9A2z7CB+DiCXcul8sNZO+C1f+V3zsJdufQUEqSJKZOncp3333Hr7/+SocOHRo9Hh8fj0ajYdOmTfX3paamkpGRQf/+/QHo378/+/btIz8/v37Mhg0b8PDwIDY29qzzOjs74+Hh0ejLlpQ6Xf2vxRE+QRAEweZy98MXo2D1g6AvkAt5Tvxe/lTQM7TpeEmCvIPw+1vwyRB4K0pul5y6BmoqwSMMEh+Au1fBk8fk7jU9bwddG922LwiCIAiXQOOsIrCD/LNj5mHHdOEDGBc1Dq1aS3pJOltzttp1bl1iIgCGHTvsOq9N+HSE8V/JDVkOrILf3nD0iq5IDj2+99BDD7F06VK+//573N3d62tAeXp6otVq8fT05L777mP69On4+Pjg4eHBww8/TP/+/enXrx8Aw4cPJzY2lgkTJvDmm2+Sm5vLc889x0MPPYSzs/07IpyNQqlEqdNhMRiwVFSAtbsoCYIgCAJAVSlsngM7PgbJLB/V+9eT0O+/TXdGmU1w8q/a+lBr5KLlZwrpJdeGih4Fgd1AHD0XBEEQBMJifMhJLyXzcDFdB5zlgx478HDyYGzkWP536H8sObiEq0KustvcukS5rpQxLY2a4mLbNWexl4hr4Lp35A/jtsyRd353G+foVV1RHBpKffjhhwAMHDiw0f1ffPEF99xzDwDz5s1DqVQybtw4jEYjI0aM4IMPPqgfq1Kp+Omnn5gyZQr9+/fH1dWVSZMm8dJLL9nrZTSL0tVVDqXETilBEATB2iQJ9q6A9c+DvnbncOxNMOJV8Gw4Fk9lMRzZKIdQ6ZvAWNrwmMoZOg6UQ6iokeARbM9XIAiCIAhtQliMN0k/HScztRjJIqFQOuZDm7ti7mLpoaX8mfUnR0uO0smrk13mVfv64tSpE9VHj1KZnIz70KF2mdemek+UO/JtfV8+xucdAaHxjl7VFcOhoVRzzr+6uLiwYMECFixYcM4x7du3Z82aNdZcmtUpXV2hoECEUoIgCIJ15R2Anx+HjL/l276RMHoudBok3y461tAt7+Tf8g6qOjq/hm55HQeCk6vdly8IgiAIbUlghAdqZxVVFSZOZ+vxC3NzyDrCPcIZ3G4wmzI2seTgEl646gW7za1LTKD66FEMSUmXRygFMOwluSPfkXWw7E544NezlzwQrK5VFDq/EtQVOzeLUEoQBEGwhqpSWDsTFg6QAymNDoa+AA/+If964wuwoC/8Xy9Y9wyc+EMOpPy7wDXT4b4N8Hga3LgAYsaIQEoQBEEQmkGlVhLS2ROAzMNFDl3LxNiJAPx07CeKquy3lrq6Uvq2Xuz8TEoVjPsUAmKhIheW3wHV4md3e3DoTqkrSV0oJXZKCYIgCC0iSbBvJax/Tu6GB9B5GEQOg5y9MK8bGAobxitUEHG1vBsqaiT4dDj7dQVBEARBaJawaB8yDhSRmVpM3NB2DltHr4BedPXtyoHTB/g69Wse7PmgXeatC6WMhw5jLitDZePGYXbj4gF3LIdPBkPOHvjuQbh1ESjFXh5bEr+7diJCKUEQBKHF8g7Cl2Ng1QMNgZTGFY7/Dr88CSlfyYGUsyd0uwXGfQZPHoVJP0K/KSKQEgRBEAQrCIuRi3tnp5VgNlsctg6FQlG/W2rZ4WUYzUa7zKsJCMCpfXuQJAzJyXaZ026828sd+VROcOgH2PKao1d02ROhlJ00hFIGB69EEARBaHOqymDtM7DwGrlj3plMejAbwas99J0CE3+Qg6hbPoPut4C2jXfFEQRBEIRWxi/MDWdXNSajmfwT5Q5dy7CIYQTqAimqKmLNMfvVWdb16QOAIWmn3ea0m/b94fp35V//Phf2rnTsei5zIpSyE7FTShAEQbgk+76B9xNg24LGRcpRQFgiDJkF/90Gj+6BUa9Dx3+BSuOw5QqCIAjC5U6hVBAWJX/ok5Xq2LpSGqWGu7rcBcCSQ0ua1UzMGnR95CN8hh077DKf3cXdCVc/Jv/6+4fg1GX6OlsBEUq1QKmxlL0Fe5s1VukmQilBEITW4MSJE9x333106NABrVZLp06dmD17NtXV1Y5eWlMnt8K3951xVE8H0WPghvflIuX3b4QBMyCgCygc05JaEARBEK5EdUf4Mg8XO3glMC5qHFq1liPFR9iWs80uc9bVlao6eBBzRYVd5rS7IbMh5jp5R/ryO6Ekw9EruiyJUOoSZZRlcM3ya7h//f3UWGouOL5+p9Tl+hdWEAShjTh8+DAWi4WPPvqIAwcOMG/ePBYuXMgzzzzj6KU15dMRIkdA/D1w59fw5DG4Yyn0ngBuAY5enSAIgiBcscJifADIOVaKqdp8gdG25eHkwc2dbwZg8cHFdplTExSEJjwcLBYqd+2yy5x2p1TCzR9BYHfQF8CyO8Aofp63NhFKXaIw9zDcNe5U1lSSXpJ+wfEqcXxPEAShVRg5ciRffPEFw4cPp2PHjtxwww08/vjjrFq1ytFLa8o9EO76Wq5rEDUCNFpHr0gQBEEQBMAzQIubtzOWGonc9FJHL4e7u9yNAgV/Zv3JsZJjdpmzbreUISnJLvM5hLMb3LEMXAMgb7/cbMbiuOL2lyMRSl0ipUJJV7+uAM06widqSgmCILRepaWl+Pj4OHoZgiAIgiC0EQqFgrDo2iN8Dq4rBRDuEc6g8EGAXFvKHupDqR2XcSgF4BUOty8FlTOkroFNLzp6RZcVEUq1QHe/7gDsK9x3wbEilBIEQWid0tPTee+99/jPf/5z3nFGo5GysrJGX4IgCIIgXLlaU10pgIldJwLw49EfKa6y/ZrqQqnKAwewGC7zLvPhiXDjAvnXf82HlKUOXc7lRIRSLdDDvwcA+wqaH0qZDSKUEgRBsIWnn34ahUJx3q/Dhw83ek5WVhYjR47k1ltv5YEHHjjv9efMmYOnp2f9V3h4uC1fjiAIgiAIrVxotLzLOj+jnCq9ycGrgd4Bvenq2xWj2cjXqV/bfD6nsFA0ISFQU4Nh926bz+dwPW6Fa5+Qf/3DI3JDGqHFRCjVAt38ugFwrPQYFdXnL3gmdkoJgiDY1owZMzh06NB5vzp27Fg/Pjs7m0GDBnHVVVfx8ccfX/D6M2fOpLS0tP7r1KlTtnw5giAIgiC0cm7ezngF6kCC7CMljl4OCoWCCbETAFh2eBnVZtt3Fr4i6kqdaeAz0OUGsJhgxV1QfNLRK2rzRCjVAn5aP0JcQ5CQOHD6wHnHNoRSl/m2RkEQBAfx9/cnJibmvF9OTk6AvENq4MCBxMfH88UXX6BUXvjbobOzMx4eHo2+BEEQBEG4srW2I3zDI4YToAvgdNVp1hxfY/P5dH2ukLpSdZRKuHkhBPcEw2lYOh6qREmHlhChVAt1929eXSmlmxsgdkoJgiA4Wl0g1a5dO9566y0KCgrIzc0lNzfX0UsTBEEQBKGNaQilHF/sHECj1HBXl7sAWHJwCZIk2XS++rpS+/Zhqay06VythpMr3LEc3IKg4BB8ez9YzI5eVZslQqkWqit2fqEOfHU7paTKSqSaGpuvSxAEQTi7DRs2kJ6ezqZNmwgLCyM4OLj+SxAEQRDq3HzzzXh7e3PLLbc0uv/UqVMMHDiQ2NhYevTowcqVKx20QqE1CI3yBgUU5xrQlxgdvRwAxkWOQ6vWklacxvbc7TadSxMejjowEEwmKvfsselcrYpHCNyxDNQucGQdbJjl6BW1WSKUaqH6YueF+86bQteFUsDl35lAEAShFbvnnnuQJOmsX4IgCIJQ59FHH2Xx4sVN7ler1cyfP5+DBw+yfv16HnvsMfTiNMQVy8VVg3+4OwCZqa3jCJ+nsyc3db4JgMUHmv4ZtiaFQtFQV+pKOcJXJ7Q33PSh/Out70PyIseup40SoVQLdfHpglqhprCykFz9uY9+KJ2cQKMBxBE+QRAEQRAEQWjtBg4ciLu7e5P7g4ODiYuLAyAoKAg/Pz+KilrH0S3BMVrbET6Au7vcjQIFf2T9wbHSYzad64ordn6mbmPl4ucAP0+H4384dj1tkAilWshF7UKkdyQAewvPf4RPpdMBIpQSBEEQBEEQhJb4/fffuf766wkJCUGhULB69eomYxYsWEBERAQuLi707duXHTt2WH0dycnJmM1mwsPDrX5toe0Ii24odt5adl6382jHoPBBAHx18CubzlVfV2rPHizG1nGE0a7+9SR0GweWGvh6AhTZNgS83IhQygrqj/AVXKDYeX0HPhFKCYIgCIIgCMKl0uv19OzZkwULFpz18RUrVjB9+nRmz57Nrl276NmzJyNGjCA/P79+TFxcHN26dWvylZ2d3aw1FBUVMXHiRD7++GOrvCah7Qru7IVSpaCi2EhpQesp9j0hdgIAPxz9geIq2x0tdOoQgcrfD6m6mqq959+ocVlSKODGBRDSGyqLazvylTp6VW2GCKWsoK7Y+QU78IlQShAEQRAEQRBabNSoUbzyyivcfPPNZ338nXfe4YEHHmDy5MnExsaycOFCdDodn3/+ef2YlJQU9u/f3+QrJCTkgvMbjUZuuukmnn76aa666qoLji0rK2v0JVxeNM4qgjp6AvJuqdYiPjCeWN9YjGYjX6d+bbN5FAoFrrW7pfRX4hE+AI0Wbl8K7iFQmAYrJ4NZNDhrDhFKWUFdKHWo6BA1lnP/wasLpcwilBIEQRAEQRAEm6iuriY5OZmhQ4fW36dUKhk6dChbt25t8fUlSeKee+5h8ODBTJgw4YLj58yZg6enZ/2XOOp3eWqoK9V6QimFQsHE2IkALE9dTrW52mZzXdF1pep4BNd25NPC0U2w/llHr6hNEKGUFUR4RuCucaeyppL0kvRzjhM7pQRBEARBEATBtgoLCzGbzQQGBja6PzAwkNzcczcm+qehQ4dy6623smbNGsLCwuoDrb/++osVK1awevVq4uLiiIuLY9++c5+YmDlzJqWlpfVfp06durQXJrRqdXWlslKLkSyto64UwPCI4QToAiisLOS7I9/ZbJ76ulK7U5CqbRd+tXohcTD2I/nX2xdC0mcOXU5bIEIpK1AqlHT16wrA3oJzn6FVurkBIpQSBEEQBEEQhNZu48aNFBQUYDAYyMzMpH///gBcc801WCwWUlJS6r+6d+9+zus4Ozvj4eHR6Eu4/AR08EDjrKJKb6Iwq8LRy6mnUWq4r9t9ACzcuxCDyWCTeZw6dULl44NUVUXl/v02maPNiL0RBj8n/3rNE3DsN8eup5UToZSVNKeuVP1OqQoRSgmCIAiCIAiCLfj5+aFSqcjLy2t0f15eHkFBQQ5alXC5U6mUhER6Aa3rCB/ArVG3EuYWRmFlIV8dsk0nPoVCgS4hAQDDjiv4CF+dAY9D91tBMsPXE6Hw3CeqrnQilLKS5nTgE8f3BEEQBEEQBMG2nJyciI+PZ9OmTfX3WSwWNm3aVL/bSRBsITS69dWVAtCoNDzc62EAvtj/hc068Ym6UmdQKOCG9yE0AapKYNl4uTOf0IQIpaykbqfUsdJjVFSffbum0lUHiFBKEARBEARBEFqioqKi/ugcwPHjx0lJSSEjIwOA6dOn88knn7Bo0SIOHTrElClT0Ov1TJ482YGrFi53dcXOs9NLMNdYHLyaxkZ2GEkXny5UmCr4ZN8nNplD16c2lNq9G8lksskcbYrGRe7I5xEGp9Ph60lgFr8v/yRCKSvx1foS6haKhMT+02c/Qyt2SgmCIAiCIAhCy+3cuZNevXrRq1cvQA6hevXqxaxZswAYP348b731FrNmzSIuLo6UlBTWrl3bpPi5IFiTX6gbLm4aaoxm8k+UOXo5jSgVSh7t/SgAyw8vJ7si2+pzOEdGovL0RDIYqDp40OrXb5PcA+HO5aBxheO/wdqnHb2iVkeEUlZUt1tqf6EIpQRBEARBEATBVgYOHIgkSU2+vvzyy/oxU6dO5eTJkxiNRrZv307fvn0dBpX+AwAAN7tJREFUt2DhiqBQKgiNqj3Cl9r6jmpdFXIVfYP6YrKYWJCywOrXVyiVaBNr60qJI3wNgrrD2I8BBSR9Cjtss1OtrRKhlBV18+sGnLsDn0qEUoIgCIIgCIIgCJetuiN8ra2uFMjFyB+LfwyAH4/+SFpxmtXncK2tK6UXoVRjXa6DobPlX//yFKRvOv/4K4gIpayovth54T4kSWryuNgpJQiCIAiCIAiCcPmqC6Vyj5ViMpodvJqmuvl1Y1j7YUhI/N+u/7P69euKnVfuTEaqqbH69du0qx+DnnfIHflWToYC64eCbZEIpayoi08X1Ao1hZWF5OpzmzyudHMDwGIQoZQgCIIgCIIgCMLlxtNfi5uPMxazRE56iaOXc1aP9HoElULFb5m/sStvl1Wv7RwdjdLdHYteT9Whw1a9dpunUMD170J4PzCWwtLbwFDk6FU5nENDqd9//53rr7+ekJAQFAoFq1evbvS4JEnMmjWL4OBgtFotQ4cO5ciRI43GFBUVcdddd+Hh4YGXlxf33XcfFRVn735nay5qFyK9IwHYW9j0CF/dTilzhQilBEEQBEEQBEEQLjcKhYKw6NZ7hA8gwjOCsZFjAZiXPO+sp3wulUKlQhcfD4i6UmeldobxX4FXOyg+DismQE21o1flUA4NpfR6PT179uT/27vz+Cire4/jn5lJJvtCSEISCAkgi0DYIQStokSQKiJYREsR0YtXhVaKtFVvEb1Xi1pUCqIoVkXUsrigoqIYNpUdjIAsQgwkkIUkkB2yzDz3j4GRCIQEJpmQfN+v1+NMnu38cpw8D+c355xn7txzT7L23HPPMXv2bObNm8emTZvw8/NjyJAhnDx50rnPmDFj+PHHH1m5ciXLly9n3bp13HffffX1K5zFOYQvZ+dZ2zR8T0REREREpHFr1SkEaJiTnZ92f/f78bZ4k5yTzOr01S499+khfEpKnYd/GNy5GKwBcOhb+GwKuDAxeLlxa1Jq6NChPPXUU4wYMeKsbYZhMGvWLP7+978zfPhwunXrxttvv01GRoazR9WePXtYsWIFr7/+OvHx8Vx99dXMmTOHRYsWkZHh+kdc1sTpJ/DtzK0+KeXKbLSIiIiIiIg0DKd7SuWkF3GypMLN0ZxbuG84f+j8BwBmb5+Nze66+a98+/UDoHjdOjIfn06Fm9rmDVmlNRJj5OtgMsP3C2GD65+GeCbDbseWn1+nZVysBjunVGpqKllZWSQmJjrXBQUFER8fz4YNGwDYsGEDwcHB9OnTx7lPYmIiZrOZTZs21XvMAHFhjqTU7rzdVNirXoBOJ6Ww2TDKyuo7NBEREREREaljfsFeNIvwBQOO/NRwe0uN7zqeIK8gUgpS+CTlE5ed17tLZwJvvhlsNvKXLOHAkBvJfOKJBpecMmw2itas4ciUh8mc9jjlBw/WeZnlBw9y+KHJ7E8YQOqjr1Hc8tQor6/+DvtWuLw8wzAoWr2a1OHD+al/Akem/oXyw4ddXs6laLBJqawsx0ThLVq0qLK+RYsWzm1ZWVmEh4dX2e7h4UFISIhzn3MpKyujsLCwyuIqsYGxBHgGcNJ2kgPHD1TZZvb1db7XED4REREREZHGyTmEr4HOKwUQaA1kQtwEAOYmz+Vk5ckLHFEzJrOZljP/Scy77+Cb0B8qKshftNiRnHrySSqqaavXh4rsbHLmzuVA4g0cvv8BCj//nPylS0m56WYyp02jIjPT5WVW5uWR9b//R8rNwyj68ksAyvbsIX3mJ6Rt68rJ4xb44F7I2uWyMk/s2EHaXeM4/MCDlO135CYKly/n56G/JXvGM1QebxifzQablKpLM2bMICgoyLlER0e77Nxmk5muoV2Bs4fwmcxmTKcSU0pKiYiIiIiINE6tOjXsyc5Pu6PTHUT4RZBdms2ivYtcem7f3r2JefNNYha+jW98vCM59Z9FpNwwmKz//T8qsrNdWl51DJuN4nXrSJ84iQPXDyJ3zktUZmZiCQqi2V1j8bv2GkfPrqXvkzJ4CFlP/4PK3NxLLtdeWkrOyy+TcsNgjr/3HlRW4nfNb4h5ZyEh4+4CT09K9h8j9ctwjqz1oOK10VB89JLKLE9L4/Cf/8zB20dTumULJquV5v91r+P/Q0J/jIoKji1YQMrgIeTOn4/9pGuSkRerwSalIiIiAMj+1Qc1OzvbuS0iIoKjR6v+D6usrOTYsWPOfc7l0UcfpaCgwLmkp6e7NPbzJaUAzH5KSomIiIiIiDRmUe2DMZkgP7uU4uMNd+oWL4sXE3tMBGD+zvkUlrtuFNFpvn37ErPgLVq/vQDfvn0xKio4/t57juTUU09TkX1pSZjqVGQfJfeVV0i5YTDp9/03xUlJYLPh06c3Uf98jivWrSXiscdo/eqrxLz37i/xLVzIgRsGc/SFF7EVFNS6XKOykuOLl3BgyBByZ8/BXlqKd5cutH7rTVq/9hq+ffrQ4tFHaff5ZwTedBMAhYd8SVlkI/v+m7Dl1j5hV3nsGFlPPU3Kb2+i6IsVYDIRdOuttFvxBeFTp+Lbty+t33iD6Pnz8erYEXtRETnPv0DKjUPJ//AjDJvr5hWrjQablGrTpg0REREkJSU51xUWFrJp0yYSEhIASEhIID8/n23btjn3WbVqFXa7nfj4+POe28vLi8DAwCqLK1X3BD6Lnz+gpJSIiIiIiEhj5e3nSVjrAAAO7zvm5miqN6ztMK4IvoLC8kLe3PVmnZXj168fMQvfpvVbb+HTpzdGeTnH33mHlBtuIOvpf1Bx1DXJKcNup/ibb0ifNIkD119Pzr9mU5GRgflUr6i2yz8l9p13CBo2DLOXl/M43169aP32AqL//TrecXEYJ06Q99prHEi8gdx582rUhjcMg6KkJH6+ZThZ06djy8nFs1Urop6fSezSJfj1719lf2t0NC2fn0ns++/j26sbht3Esa3FHEgcRN7rr2OvwVzU9tJScufNc/TGeucdR2+s3/yGNss+IuqZGXhGRTn3NZlM+P/matp8+AGRz8zAIzKSyqwsMh97jNQRIylet67eH8pmMtz4GLji4mIOHHCMbezZsycvvPAC1113HSEhIbRu3Zpnn32WZ555hgULFtCmTRumTZvGjh072L17N97e3oDjCX7Z2dnMmzePiooKxo8fT58+fXjvvfdqHEdhYSFBQUEUFBS4JEGVdyKPgUsGYsLE+jvX42/1d25Lve13nPzxR1rNe4WAgQMvuSwRkZpy9bWuqVN9ikhToeuda6k+m44NHx1g+5dpdOwfQeLdnd0dTrVWp63mT6v/hLfFm89Gfka4b/iFD7oEhmFQunEjOXNe4sT27QCYvLxodsdoQsaPxxIUVOtz2goKKFj2MflLl1Jx5IhzvU+vXjQbfTsBQ4ZgPpVHqEl8xatWkTPrX5Tt3w+AJSSE5vdNoNmdd1ZJZp12IjmZ7H/O5MSpTjOW4GBCH3yA4DvuwGy11qjMkiVzOfrCLMoKPAHwiIok7E9/ImjYMEwWS9X9KyvJ/+gjcmfPoTInBwDvzp0J/8tU/E515LkQe1kZx995h9xXX8N+aq5t3/79CZ86FZ+uXWp0jvOp6bXOrUmpNWvWcN111521fty4cbz11lsYhsH06dN57bXXyM/P5+qrr+bll1+mQ4cOzn2PHTvGpEmT+PTTTzGbzdx2223Mnj0bf3//s857PnVxY7jxgxs5UnyE+YPn0z/yl2zoobvGUbp5M1HPzyToVDc9EZH6oH8Eu5bqU0SaCl3vXEv12XSk7z7GJ7OT8Qv2YtyMAZhMJneHdF6GYTBuxTi+P/o9v+vwO6YnTK+3cks3bHAkp77/3mXnNQcGEjR8OM1uH4VX+/YXH5/NRuHnX5Dz0hwqDqUB4BERQegDDxA8cgQmT0/KUlPJeXEWRV99BTiSayHjxtF8wn9hCQiofZmb5lMwdxo5OwOpPOFIRHl16kT4ww/jd/VVABSvXsPRF56n/EAKAJ4tWxL25z8T+NuhmMy1HxBny88n99XXOP7OOxgVFQAE3nQTYX+ejLVVq1qfDy6TpFRDURc3hr+s/QsrDq7gTz3/xIRuE5zr0x94kOLVq4n43ydpdvvtLilLRKQm9I9g11J9ikhToeuda6k+m46KchuvT1mHvdJgzJP9CW7he+GD3Oj7o99z1xd3YTFZ+Gj4R7QJalNvZRuGQcl368l96SVOJCdf9Hl8evQgePRoAm8cgtnHx3XxVVSQv2wZuXNfpvLU0wM9W7fGt2dPCpYvB5sNzGaCRtxK2B//iGc1c1zXyBd/w/7dPI6lBJP3Uyj2klIA/AYkYJRXULp1KwCWoCCaP3A/zX7/+xr1xrqQ8sNHyJn9Lwo/XQ6GAZ6ehPz+Tprffz8ezZrV6lw1vdZ5XGrQcm5xoXGsOLiCHbk7qqw3+/kBOD9UIiIiIiIi0vh4Wi1Etg3iyE/5HN57rMEnpXqG92Rgq4GsObyGOd/P4YWBL9Rb2SaTCf+rr8L/6qscT4Oz22t/ErO5xsPzasvk6UmzUaMIuuUW8hcvJvfV16hIS6MgzdF7yv/aawl7eAreZ4zquiSDn8acd4BQj68J7upDXuXvOP7+J5Ss3+CIx8uLkLvucvTGcmFy29qqJS2fe47md9/N0ZnPU7J+PccWvE3xmrW0/eLzi+qFdSFKStWRMyc7NwzD2VXzl6SUJjoXERERERFpzFp1anYqKXWcrtde3DCo+vSnXn9i7eG1rDy0kp05O4kLi6v3GOoqseQK5lPJoODbbuPYO+9yctdOmv1hLH7x/VxbkMUDfvcG/HswHjl7aRH5Dc0+/oC8N98GDw9C77sPz8hI15Z5Bu/OnWn9xr8p/u47js58nuDf3VYnCSlQUqrOdArphIfJg7yTeWSVZBHp7/jAKCklIiIiIiLSNLTsGAKkcvin4xh2A5O54c4rBdC+WXtuaXcLH6d8zKzts3h98OsNei4sdzH7+RH63/fVbSHeQXDnInh9EGQmY93yv0Q+uQDqKDl0Lv5XXeWYNP1ieq7VUP39Nk2Mt4c37Zs5JlQ7cwif2c/RZVNJKRERERERkcYtPDYATy8LZSWV5B4udnc4NTKxx0SsZiubszazPmN9vZZdbisnpzSnXsts0ELawOh3wOwJez6B1U/XewgmsxmTR931Z1JSqg6dOYTvNPWUEhERERERaRosFjNRHYIBSN97zL3B1FCkfyR3dLoDgBe3vYjdqLteMqcdLDjIzC0zGbR0ENcvvZ5blt3C7O2z+THvR+ry2Wzphem8/9P7fLT/I7JKsuqsnNMq7ZUkH03m7R/fZm36WkorajDXdMwAuGW24/03M+GHxbUqs7i8mFVpq1i4eyE7c3Zis9suIvK6o+F7dSguNI7F+xazM/eXpJTF3x9QUkpERERERKQpaNWxGYd25nFk73F6DY5xdzg1MiFuAh/u/5B9x/fx9ManGX7FcLqGdsVscl2/lgpbBUnpSSzdt5TNWZurbEstSGX+zvnM3zmfKL8oBsUMIrF1It3DumMxWy66zKLyIjZnOnqArc9Yz+Hiw1W2twlqw4CoAQyIGkCfFn3w9bz0yekPFx1mfcZ6NmRsYFPmJooqipzbPMwe9Ajr4SyzU0inc/9+PX4POfvgu1nw8UTH0L6ON56zPJvdxo95PzrL/CHnB2zGL4moQGsg/SP7O8s8PdWQuygpVYdOTwq3O283FfYKPM2ev/SUKr48um6KiIiIiIjIxWvVKQSAjAP52CrtWDwa/oClYO9gJnSbwIvbXmTJT0tY8tMSmns359roaxnYaiD9o/rj4+FzUedOL3L0Tlp2YBnHTjp6j5kw8ZtWv+H2DrfTI7wH3x35jq/TvubbI9+SUZLBwt0LWbh7Ic29m3N96+tJjEmkb0RfPM2e1ZZVaa9kV+4uNmRsYH3Genbm7qySoPEwedAtrBs2w8bO3J2kFqSSWpDKu3vexcPsQc/wngyIGkBCVAJXhlxZo6RccXmxc+jjhowNpBWlVdkeaA2kR3gPUvJTOFJ8hK3ZW9mavZXZ388m2CvYmTBKiEogwi/ilwMHTYf8NPjxQ1gyFka/Cx0GA5BRnOFMtG3M3EhReVGVMmMCY2gd0Jrko8kUlhfy1aGv+OrQVwDEBsY6E1R9I/q6JBFXGyajLvvCXSYKCwsJCgqioKCAQBc+TtFu2Ln6P1dTVFHEkpuXcGXzKylet470+/4br85X0vbDD11WlojIhdTVte5ydMstt5CcnMzRo0dp1qwZiYmJPPvss0RFRdX4HKpPEWkqdL1zLdVn02PYDd7827ecKKpgxMO9iGof7O6QasQwDL489CVfH3Ikh0oqfhnt42Xxon9kfwZGD+TaVtcS5htW7bkq7BWsTV/L0p+WVpmnKswnjJHtR3Jb+9vO2WPnZOVJvsv4jqRDSaxJX1Oll1GANYDroq9jUOtBDIgagLeH46l91fVMAkcSJiEqwZmE8fN0dBwpKCtgS9YWZ3LnSPGRKsc182pG/8j+zmNb+LUALtwz6XTi63Tip3Pzzs7eUOmF6c7yNmdtpriiaueVtkFtnQmqPi364Gv2hPfvoWTvp2zx82d9t2FsKDnMwcKDVY4LsAY4Y02ITKBVgOPJj79O0u3I3VFleGaNe27VQE2vdUpKUbc3hvu+uo8NmRuY1n8at3e8ndJt2zg05g94xrTmii+/dGlZIiLV0T+Cf/Hiiy+SkJBAZGQkR44cYerUqQCsX1/zyTxVnyLSVOh651qqz6bpy9d3cWDrUfreFEu/YW3dHU6tVdgq2Jq9lTXpa1iTvoaMkowq27s278rA6IEMjB5Ih2YdnE/syyzO5P39jjmbck44JjA3YWJA1ABGdRjFNdHXXLC305kxbMnawsq0laxKW+XsZQXg4+FD34i+HCo8xKHCQ1WOO3O4WkJUAlH+F/4S0jAM0ouqJozOTMoBtAtqR3RgNNuzt1NYXlhlW0xgDAmRvyS+/K3+F/797BVn9er6dcKoV3gvbPZKfji6ncozjrWYLHQP6+5IQkUl0KV5FzzMFx4YV1heyJZMRyLuu4zvzkrEne65dU2raxjWbtgFz1fl3EpK1Vxd3hjmfD+H13a8xvB2w3nq6qc4uXcvqbeOwBIaSodvv3FpWSIi1dE/gs/vk08+4dZbb6WsrAxPz5r9w0j1KSJNha53rqX6bJp+/OYIa97dR+QVQYyc2tvd4VwSwzDYn7+fNelrWJu+tsrT5gEi/SK5ttW1ZJRk8O2Rb52JlRDvEEZcMYLbOtxGdED0JcVgs9tIzknm60Nfk5SWRGZJpnNbdT2TLlaFvYKdOTudvaF25e2qkjA6X8+kS3GhnlutsZJQmMeAMht9b5lPQIdzzzFVG2f23NqUtcmZiOsf2Z/5g+fX6lxKStVCXd4Y1qavZdKqSbQLaseyW5dRnp5Oyg2DMfn40On77S4tS0SkOvpH8LkdO3aMBx54gCNHjvDtt9+ed7+ysjLKysqcPxcWFhIdHa36FJFGr6neP0aMGMGaNWsYNGgQ77///lnbS0tLufLKKxk1ahQzZ86s8Xmban02dQU5pbwzbSNms4l7X/gNVu/GM71zTmkO6w6vY83hNWzM2MhJ28kq2+Mj4xnVYRTXR1+Pp6VmX/7VhmEY7M7bzZasLcQExtS4Z9KlKCgrYFPmJjJLMukR3qPGPZMu1umeWxszN2Iymegf2Z9on3BYPBb2fwkePvCH9yH2apeVebrn1vqM9cQGxnJT25tqdXxNr3WN5y+hgeoa2hWAnwt+pri8GO9TE50bJ05g2GyYLJeWsRURkYvzt7/9jZdeeonS0lL69+/P8uXLq91/xowZPPnkk/UUnYiIuNtDDz3EPffcw4IFC865/emnn6Z///71HJVcrgJDfQgI8abo2EkyDxQQ07W5u0NymTDfMG7rcBu3dbiNE5Un2JS5iW+PfEuANYBbr7iVmMC6feKgyWSiS2gXuoR2qdNyzhTkFcTg2MH1Vp7JZKJ1YGtaB7auumH0Qlg0Bg6shHdvdySmYga4pExPsyc9w3vSM7ynS853Pg1/2v/LXHOf5rT0b4mBwa68Xc6n7wHYS0vdGJmISOPyyCOPYDKZql327t3r3P8vf/kL33//PV999RUWi4W77rqL6joPP/rooxQUFDiX9PT0+vi1RETETQYOHEhAQMA5t+3fv5+9e/cydOjQeo5KLlcmk4lWnZoBcHjvsQvsffny8fBhYPRA/t7/7zzU66E6T0g1eR5eMPodaHc9VJTAu6MgbaO7o6oVJaXqQVxoHAA7c3Zislrh1Hwl9pKS6g4TEZFaePjhh9mzZ0+1S9u2v0wsGhoaSocOHbjhhhtYtGgRn3/+ORs3nv8m7uXlRWBgYJVFRETcY926dQwbNoyoqChMJhPLli07a5+5c+cSGxuLt7c38fHxbN682WXlT506lRkzZrjsfNI0OJNS+467ORJpVDy94Y73oO1AKC+Gd34H6VvcHVWNafhePYgLjWPFwRXsyN2ByWTC4uuLraAAe3HxhQ8WEZEaCQsLIyys+scRn4/d7pio8sw5o0REpOEqKSmhe/fu3HPPPYwcOfKs7YsXL2bKlCnMmzeP+Ph4Zs2axZAhQ9i3bx/h4eEA9OjRg8rKyrOO/eqrr4iKOv/TuT7++GM6dOhAhw4davXUVpGWHR1Jqdz0Yk4Ul+Pjb3VzRNJoePrAHf+B926Hg9/AOyNh7DJo1fAn1VdS6hIYhoG90sDiWX2Hs25h3QBHTynDMDD7+TmSUuopJSJS7zZt2sSWLVu4+uqradasGSkpKUybNo127dqRkJDg7vBERKQGhg4dWu3QuRdeeIEJEyYwfvx4AObNm8dnn33GG2+8wSOPPAJAcnLyRZW9ceNGFi1axNKlSykuLqaiooLAwEAef/zxc+5/rgdlSNPkF+RFs0g/jmeWcGRfPlf0Dnd3SNKYWH3h94sdc0sd+hYWjoC7lkHLXu6OrFoavneRKitsfP3mbla+8SOGvfoHGHYK6YSHyYO8k3lklmQ655VSUkpEpP75+vry4YcfMmjQIDp27Mi9995Lt27dWLt2LV5eXu4OT0RELlF5eTnbtm0jMTHRuc5sNpOYmMiGDRsu+fwzZswgPT2dgwcPMnPmTCZMmHDehNTp/YOCgpxLdHT0Jccgl6/TQ/g2ffIzRw8pQSkuZvVzJKZaD4CyAlh4K2QkuzuqaikpdZGOZZRwYPtRUr7PYfPy1Gr39fbwpkNIBwB25O5wJqVsSkqJiNS7uLg4Vq1aRV5eHidPniQ1NZVXXnmFli1bujs0ERFxgdzcXGw2Gy1atKiyvkWLFmRlZdX4PImJiYwaNYrPP/+cVq1aXXRCSw/KkDN1u64VvkFW8rNL+eDZbWz9/CB2m93dYUlj4uUPY5ZAdDycPJWYytrp7qjOS0mpixQeE8h1YzoBsPXzg+zfkl3t/mdOdq6eUiIiIiIiDdvXX39NTk4OpaWlHD58+JxDvO+++25mzpxZ7Xn0oAw5U3C4L3dOi6ddrzDsdoNNn/zMR89/T0GOnswuLuQVAGPeh1Z94cRxWHALZP/o7qjOSUmpS9ApIZKeN7QGIOntPWSnnr/75emk1K7cXUpKiYiIiIjUkdDQUCwWC9nZVb80zs7OJiIiwk1RifzC29+TIRO6knj3lVi9LWT9XMDip7aw+7sMDKP6qWFEasw7EP7wAbTsDSeOwYJhkLPP3VGdRUmpS9R/RDti45pjq7Dz+bwdFB8/95Ob4sIcSandebvB1wcAe4my4SIiIiIirmS1WunduzdJSUnOdXa7naSkJD3QQhoMk8lEx/6RjJ7Wj6j2wVSU2Vi9cC9fzNtJaWG5u8OTxsI7CP7wIUT1hNI8x+TnBYfdHVUVSkpdIrPZxA33dCEkyo/SgnI+f2UHFeW2s/aLDYwlwDOAk7aTFHk6Hj2rnlIiIiIiIrVXXFxMcnKy8wl6qampJCcnk5aWBsCUKVOYP38+CxYsYM+ePTzwwAOUlJQ4n8Yn0lAENvdh+J97kjCyHWaLidQfcln0f5s4uCPX3aFJY+ET7EhMhXaEwiOOxFTpMXdH5aSklAtYfTy46cFuePt7kpNWRNJbe856Ip/ZZKZraFcAjlIEKCklIiIiInIxtm7dSs+ePenZsyfgSEL17NnT+RS80aNHM3PmTB5//HF69OhBcnIyK1asOGvyc5GGwGw20WtwDKMe7UNIlB8niir47OUdrH53L+UnK90dnjQGviEw9kMIbAW5P8G7v4OyYndHBSgp5TKBoT4M/e84zBYTKduPsuWzs5/Id3oI3xG7IytpL24YHwIRERERkcvJwIEDMQzjrOWtt95y7jNp0iQOHTpEWVkZmzZtIj4+3n0Bi9RAaKsARj3ah+6J0QDs/iaDJU9vIevnAjdHJo1CUCsY+xH4hMCRbbBkLFS6f6ioklIuFNU+mGt/3xGALZ8dZP/WqpMrdgvtBsChyqOAekqJiIiIiIjILzw8LVz9u/YMn9wD/2ZeFOSc4MOZ29n06c/YbHZ3hyeXu7AOjqfyefpByipYdj/Y3fu58nBr6Y1Q56uiOJZZwg9fp5O0YA9BYT6Exzge+3q6p9RhWx6gpJSIiIiIiIicrVWnEO6Y1o91i37ip83ZbP3sIGm78ug9NBaLh/qWyKWIhb4LYc0M2JYKRf+EPveCyXTeI3wCPJ15DVdTUupSfPsihHeGKxLBbHGuHjDyCvKzSjm0K4/PX97BqEf74hfsRYh3CC39W3LCKx1QUkpERERERETOzcvXkxvu6UJst1DWvrePo4eK+GLeTneHJY2CCXjM8XYTsGlHtXvHxDXn5ond6yQSJaUuVmEmJP0fGDYIiobe46DnXRDQArPZxOB7u/D+c9s4nlnC56/sYMTDvfCwWugW2o1066mkVKmSUiIiIiIiInJ+7fu0ILJdMOs/PEB+dqm7w5HGpCQHCg473gdHg2/oOXcLCvOpsxCUlLpYJjP0fwC+fwcK0mHVU7DmGeh0M/S5B2uba7jpwW68/8xWjh4qYtXbe7jh3i50De3KT9bPAbCpp5SIiIiIiIhcgH8zLwbf28XdYUhjtPofsPZZwATD34QuI+q1eA1GvVgBLWDI0/DwXhjxKkTHg70Sdi+Dt2+Bl/oQtP/f3DguBrPZxP6tR9n6+UG6hXXjhJfjFBq+JyIiIiIiIiJuM/BR6HMPYMAHEyBldb0Wr6TUpfL0ge53wL1fwf3fOiYIs/pD3gH46n9o+XEfrum0BYDNn6bidSiMCi9HBzV7cQmGYdRbqEZ5OWWpqZzYuQtbgR4rKiIiIiIiItKkmUzw25nQ+VawV8CiMXBkW70V32iG782dO5d//vOfZGVl0b17d+bMmUO/fv3qN4iIOLj5BbjhSdj5Pmz9N2TtpMuxpznmew87Soex7q09dOjVD/gGbDaMsjJM3t4uC8FWXExFWhrlaemUp6dRkZZOeXo6FWlpVGRlVXnco6V5c7zatMHapg3Wtm3xaut479myJSaLpZpSRERERERERKRRMFtg5Gtw4jikroV3R8E9X0Jo+zovulEkpRYvXsyUKVOYN28e8fHxzJo1iyFDhrBv3z7Cw8PrPyCvAOgzHnrf7cgwbn2Dq3YuIr+yJWnlvejy/RDKrD/gVV5I5sOTMAcGY/YNwOTjj8nHG7OXFyarFyYvL0xeVsze3qd+tjq2eXlhlJWdM/Fky8+vNjSTjw9mfz9sObnY8vIozcujdOvWqvtYrVhjYk4lq9rg1bat432bNlj8/euu3kRERERERESk/nl4wR3vwoJhkPE9LBzhSEwFtazTYk1GfY4fqyPx8fH07duXl156CQC73U50dDR//OMfeeSRRy54fGFhIUFBQRQUFBAYGFijMg3DoNxmx2oxYzKZLnzAieOUbVnCBx8EcbwsHJ+Sg/TbNguLvaJG5dWGJSQEa3Q0nq1bn3qNxnrqvSU0FJPJhK24hPKDBylP/Zmyn3+mPPUg5T//TPnBgxjl5ec/d2goHmFheDRvjkfzECzNQx3vQ5tjCTn12rw5Hs2aYfL0dPnvJiIX72KudXJ+qk8RaSp0vXMt1aeINGglufDGEMeURGGdYPwX4BtS69PU9Fp32feUKi8vZ9u2bTz66KPOdWazmcTERDZs2FBn5Z6ssHPl4ysAsHqY8bKYHa8ejlfHe4vjvXNbb/zi7LRNzueEXyxfXTMRb/thzHbbqcV+xquBxW7DbLNjsTnWe9jsmO12LJV2MNk56WOnzMdOhY+NCh8blX52Kv1MmKwWLGYTZlMWlspjeBzag+mIFx6bfTB5+mC2eGMymR1jR00maG6G0Fjo2xYTYCk8iefxYjyPF+F5rBjPY0V45hXhUXICTgBp+Y6FlGrryO7jjc3PB7u/DzY/Xww/bzCfYxqzmiT1wNGl0GzGMJvA4/R7M5hNGBYLWE5ts5zaZjE7yjv9eqoYw3zq98b0Sx2YHOtNZ/586n0NozunGiUsRS6Cl78v14y8091hiIiIiIhIY+IXCmM/gn8Phpy98N7tcNfHYPWrk+Iu+6RUbm4uNpuNFi1aVFnfokUL9u7de85jysrKKCsrc/5cWFhY63LLK+1V3pdX2qGsmgPOEO0Fo2wmvIz2GOb22Mxgq3UEv1IJFIDp1PzltlPLJffD8gRanFoulYELflERAbCezOSake6OQkREREREGp3g1o7E1Bs3wuEtsOQuuHMRWFw/GuqyT0pdjBkzZvDkk09e0jkCfTz4YfpgyivtlFXaHIkpm52yCsfrmevLKu1VXsttdo4dOUx5Ri6GHUeyxn5qMUynXk+vN2Eyfll/+r3j1XAsGJgMA5Nhd7xiYDJO7cvpVxMmR/cfnH1/nAM3TWf8t+o7J+PX+1TvdPmmU+/NBpgMF/QaMs4dg+lXg1BNp/at8vN5znfWcSKXAbNR6u4QRERERESksQq/EsYshQW3QFRPMNdN+uiyT0qFhoZisVjIzs6usj47O5uIiIhzHvPoo48yZcoU58+FhYVER0fXqlyTyUSQz6VkCdtdwrEiIiIiIiIiInUouh9M2uzoOVVHzjHBz+XFarXSu3dvkpKSnOvsdjtJSUkkJCSc8xgvLy8CAwOrLCIiIiIiIiIicoY6TEhBI+gpBTBlyhTGjRtHnz596NevH7NmzaKkpITx48e7OzQRERERERERETmHRpGUGj16NDk5OTz++ONkZWXRo0cPVqxYcdbk5yIiIiIiIiIi0jA0iqQUwKRJk5g0aZK7wxARERERERERkRq47OeUEhERERERERGRy4+SUiIiIiIiIiIiUu+UlBIRERERERERkXqnpJSIiIiIiIiIiNQ7JaVERERERERERKTeKSklIiIiIiIiIiL1TkkpERERERERERGpd0pKiYiIiIiIiIhIvfNwdwANgWEYABQWFro5EhGRunP6Gnf6mieXRvcOEWkqdP9wLd0/RKQpqOm9Q0kpoKioCIDo6Gg3RyIiUveKiooICgpydxiXPd07RKSp0f3DNXT/EJGm5EL3DpOhrzyw2+1kZGQQEBCAyWRydzgNVmFhIdHR0aSnpxMYGOjucBo81VfNqa5q52LryzAMioqKiIqKwmzW6O1L1VDvHfp7qluq37ql+q07l1K3un+41sXeP/T3UT3Vz/mpbqqn+qleXbc91FMKMJvNtGrVyt1hXDYCAwP1x1oLqq+aU13VzsXUl77hdp2Gfu/Q31PdUv3WLdVv3bnYutX9w3Uu9f6hv4/qqX7OT3VTPdVP9eqq7aGvOkREREREREREpN4pKSUiIiIiIiIiIvVOSSmpMS8vL6ZPn46Xl5e7Q7ksqL5qTnVVO6ovqY4+H3VL9Vu3VL91R3V7+dP/w+qpfs5PdVM91U/16rp+NNG5iIiIiIiIiIjUO/WUEhERERERERGReqeklIiIiIiIiIiI1DslpUREREREREREpN4pKSUX9MQTT2AymaosnTp1cndYDca6desYNmwYUVFRmEwmli1bVmW7YRg8/vjjREZG4uPjQ2JiIvv373dPsG52obq6++67z/qs3Xjjje4J1s1mzJhB3759CQgIIDw8nFtvvZV9+/ZV2efkyZNMnDiR5s2b4+/vz2233UZ2drabIpaG6ODBg9x77720adMGHx8f2rVrx/Tp0ykvL3d3aJetuXPnEhsbi7e3N/Hx8WzevNndIV32anK9E9d55plnMJlMTJ482d2hSC3o2nNuaqdUpXZJ9dQWOT93tj2UlJIa6dKlC5mZmc7l22+/dXdIDUZJSQndu3dn7ty559z+3HPPMXv2bObNm8emTZvw8/NjyJAhnDx5sp4jdb8L1RXAjTfeWOWz9p///KceI2w41q5dy8SJE9m4cSMrV66koqKCwYMHU1JS4tznz3/+M59++ilLly5l7dq1ZGRkMHLkSDdGLQ3N3r17sdvtvPrqq/z444+8+OKLzJs3j8cee8zdoV2WFi9ezJQpU5g+fTrbt2+ne/fuDBkyhKNHj7o7tMtaTa534hpbtmzh1VdfpVu3bu4ORWpB157qqZ3yC7VLqqe2yPm5te1hiFzA9OnTje7du7s7jMsCYHz00UfOn+12uxEREWH885//dK7Lz883vLy8jP/85z9uiLDh+HVdGYZhjBs3zhg+fLhb4mnojh49agDG2rVrDcNwfI48PT2NpUuXOvfZs2ePARgbNmxwV5hyGXjuueeMNm3auDuMy1K/fv2MiRMnOn+22WxGVFSUMWPGDDdG1fj8+nonrlFUVGS0b9/eWLlypXHttdcaDz30kLtDkhrStef81E45P7VLqqe2SPXqs+2hnlJSI/v37ycqKoq2bdsyZswY0tLS3B3SZSE1NZWsrCwSExOd64KCgoiPj2fDhg1ujKzhWrNmDeHh4XTs2JEHHniAvLw8d4fUIBQUFAAQEhICwLZt26ioqKjy2erUqROtW7fWZ0uqVVBQ4PwcSc2Vl5ezbdu2Kn9zZrOZxMRE/c252K+vd+IaEydO5KabbqryGZaGT9eeC1M7pWbULqkZtUUc6rPt4XFJR0uTEB8fz1tvvUXHjh3JzMzkySef5De/+Q27du0iICDA3eE1aFlZWQC0aNGiyvoWLVo4t8kvbrzxRkaOHEmbNm1ISUnhscceY+jQoWzYsAGLxeLu8NzGbrczefJkrrrqKrp27Qo4PltWq5Xg4OAq++qzJdU5cOAAc+bMYebMme4O5bKTm5uLzWY75/V87969boqq8TnX9U4u3aJFi9i+fTtbtmxxdyhSS7r2VE/tlJpTu+TC1BZxqO+2h5JSckFDhw51vu/WrRvx8fHExMSwZMkS7r33XjdGJo3NHXfc4XwfFxdHt27daNeuHWvWrGHQoEFujMy9Jk6cyK5du5r0HAlS1SOPPMKzzz5b7T579uypMtnrkSNHuPHGGxk1ahQTJkyo6xBFLoqud66Xnp7OQw89xMqVK/H29nZ3OCIupXaKuJLaIg71fS/W8D2pteDgYDp06MCBAwfcHUqDFxERAXDWUwmys7Od2+T82rZtS2hoaJP+rE2aNInly5ezevVqWrVq5VwfERFBeXk5+fn5VfbXZ6tpePjhh9mzZ0+1S9u2bZ37Z2RkcN111zFgwABee+01N0Z++QoNDcViseh6XofOd72TS7Nt2zaOHj1Kr1698PDwwMPDg7Vr1zJ79mw8PDyw2WzuDlGqoWtP7aidcn5ql9ReU2yLuKPtoaSU1FpxcTEpKSlERka6O5QGr02bNkRERJCUlORcV1hYyKZNm0hISHBjZJeHw4cPk5eX1yQ/a4ZhMGnSJD766CNWrVpFmzZtqmzv3bs3np6eVT5b+/btIy0tTZ+tJiAsLIxOnTpVu1itVsDRQ2rgwIH07t2bN998E7NZt/6LYbVa6d27d5W/ObvdTlJSkv7mLtGFrndyaQYNGsTOnTtJTk52Ln369GHMmDEkJyc3qSEplyNde2pH7ZTzU7uk9ppSW8SdbQ8N35MLmjp1KsOGDSMmJoaMjAymT5+OxWLhzjvvdHdoDUJxcXGV7HlqairJycmEhITQunVrJk+ezFNPPUX79u1p06YN06ZNIyoqiltvvdV9QbtJdXUVEhLCk08+yW233UZERAQpKSn89a9/5YorrmDIkCFujNo9Jk6cyHvvvcfHH39MQECAc6x2UFAQPj4+BAUFce+99zJlyhRCQkIIDAzkj3/8IwkJCfTv39/N0UtDcTohFRMTw8yZM8nJyXFu07eitTdlyhTGjRtHnz596NevH7NmzaKkpITx48e7O7TL2oWud3JpAgICzpqfy8/Pj+bNm2versuErj3np3ZKVWqXVE9tkfNza9vjkp7dJ03C6NGjjcjISMNqtRotW7Y0Ro8ebRw4cMDdYTUYq1evNoCzlnHjxhmG4Xj86rRp04wWLVoYXl5exqBBg4x9+/a5N2g3qa6uSktLjcGDBxthYWGGp6enERMTY0yYMMHIyspyd9huca56Aow333zTuc+JEyeMBx980GjWrJnh6+trjBgxwsjMzHRf0NLgvPnmm+f9LMnFmTNnjtG6dWvDarUa/fr1MzZu3OjukC57NbneiWtde+21xkMPPeTuMKQWdO05N7VTqlK7pHpqi5yfO9seplMBiIiIiIiIiIiI1BtNLCEiIiIiIiIiIvVOSSkREREREREREal3SkqJiIiIiIiIiEi9U1JKRERERERERETqnZJSIiIiIiIiIiJS75SUEhERERERERGReqeklIiIiIiIiIiI1DslpUREREREREREpN4pKSXSgMXGxjJr1ix3hyEiIiIiIo2Q2hvibkpKiZxy9913c+uttwIwcOBAJk+eXG9lv/XWWwQHB5+1fsuWLdx33331FoeIiIiIiNQNtTdEzubh7gBEGrPy8nKsVutFHx8WFubCaEREREREpDFRe0Mud+opJfIrd999N2vXruVf//oXJpMJk8nEwYMHAdi1axdDhw7F39+fFi1aMHbsWHJzc53HDhw4kEmTJjF58mRCQ0MZMmQIAC+88AJxcXH4+fkRHR3Ngw8+SHFxMQBr1qxh/PjxFBQUOMt74okngLO706alpTF8+HD8/f0JDAzk9ttvJzs727n9iSeeoEePHixcuJDY2FiCgoK44447KCoqqttKExGROpOTk0NERAT/+Mc/nOvWr1+P1WolKSnJjZGJiMjFaOztjffff5+4uDh8fHxo3rw5iYmJlJSU1FFtyuVOSSmRX/nXv/5FQkICEyZMIDMzk8zMTKKjo8nPz+f666+nZ8+ebN26lRUrVpCdnc3tt99e5fgFCxZgtVr57rvvmDdvHgBms5nZs2fz448/smDBAlatWsVf//pXAAYMGMCsWbMIDAx0ljd16tSz4rLb7QwfPpxjx46xdu1aVq5cyc8//8zo0aOr7JeSksKyZctYvnw5y5cvZ+3atTzzzDN1VFsiIlLXwsLCeOONN3jiiSfYunUrRUVFjB07lkmTJjFo0CB3hyciIrXUmNsbmZmZ3Hnnndxzzz3s2bOHNWvWMHLkSAzDqIuqlEZAw/dEfiUoKAir1Yqvry8RERHO9S+99BI9e/as8k31G2+8QXR0ND/99BMdOnQAoH379jz33HNVznnmePHY2Fieeuop7r//fl5++WWsVitBQUGYTKYq5f1aUlISO3fuJDU1lejoaADefvttunTpwpYtW+jbty/guJm89dZbBAQEADB27FiSkpJ4+umnL61iRETEbX77298yYcIExowZQ58+ffDz82PGjBnuDktERC5CY25vZGZmUllZyciRI4mJiQEgLi7uEmpLGjv1lBKpoR9++IHVq1fj7+/vXDp16gQ4vi04rXfv3mcd+/XXXzNo0CBatmxJQEAAY8eOJS8vj9LS0hqXv2fPHqKjo503CIDOnTsTHBzMnj17nOtiY2OdNwiAyMhIjh49WqvfVUREGp6ZM2dSWVnJ0qVLeffdd/Hy8nJ3SCIi4kKNob3RvXt3Bg0aRFxcHKNGjWL+/PkcP3685pUgTY6SUiI1VFxczLBhw0hOTq6y7N+/n2uuuca5n5+fX5XjDh48yM0330y3bt344IMP2LZtG3PnzgUcExO6mqenZ5WfTSYTdrvd5eWIiEj9SklJISMjA7vd7px7REREGo/G0N6wWCysXLmSL774gs6dOzNnzhw6duxIamqqy+OQxkHD90TOwWq1YrPZqqzr1asXH3zwAbGxsXh41PxPZ9u2bdjtdp5//nnMZkceeMmSJRcs79euvPJK0tPTSU9Pd357sXv3bvLz8+ncuXON4xERkctPeXk5f/jDHxg9ejQdO3bkv/7rv9i5cyfh4eHuDk1ERC5CY25vmEwmrrrqKq666ioef/xxYmJi+Oijj5gyZUqNzyFNh3pKiZxDbGwsmzZt4uDBg+Tm5mK325k4cSLHjh3jzjvvZMuWLaSkpPDll18yfvz4ai/wV1xxBRUVFcyZM4eff/6ZhQsXOickPLO84uJikpKSyM3NPWc328TEROLi4hgzZgzbt29n8+bN3HXXXVx77bX06dPH5XUgIiINx//8z/9QUFDA7Nmz+dvf/kaHDh2455573B2WiIhcpMba3ti0aRP/+Mc/2Lp1K2lpaXz44Yfk5ORw5ZVX1q6CpMlQUkrkHKZOnYrFYqFz586EhYWRlpZGVFQU3333HTabjcGDBxMXF8fkyZMJDg52fiNxLt27d+eFF17g2WefpWvXrrz77rtnTU47YMAA7r//fkaPHk1YWNhZExeC4xuHjz/+mGbNmnHNNdeQmJhI27ZtWbx4sct/fxERaTjWrFnDrFmzWLhwIYGBgZjNZhYuXMg333zDK6+84u7wRETkIjTW9kZgYCDr1q3jt7/9LR06dODvf/87zz//PEOHDq155UiTYjL0bEYREREREREREaln6iklIiIiIiIiIiL1TkkpERERERERERGpd0pKiYiIiIiIiIhIvVNSSkRERERERERE6p2SUiIiIiIiIiIiUu+UlBIRERERERERkXqnpJSIiIiIiIiIiNQ7JaVERERERERERKTeKSklIiIiIiIiIiL1TkkpERERERERERGpd0pKiYiIiIiIiIhIvVNSSkRERERERERE6t3/A+Jf0TyyYbbSAAAAAElFTkSuQmCC",
      "text/plain": [
       "<Figure size 1200x400 with 3 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "#@title Code for the damped pseudoinverse + line search figures\n",
    "\n",
    "def damped_pinv(A,gamma):\n",
    "    u,s,vh = np.linalg.svd(A)\n",
    "    #only take the first K rows\n",
    "    vh = vh[:len(s),:]\n",
    "    s += np.array([gamma]*len(s))\n",
    "    sinv = np.divide(1.0,s)\n",
    "    return np.dot(np.dot(vh.T,np.diag(sinv)),u.T)\n",
    "\n",
    "def damped_newton(q0,N,gamma):\n",
    "    #uses damped pseudoinverse to determine newton step\n",
    "    trace = [q0]\n",
    "    for i in range(N):\n",
    "        q = trace[-1]\n",
    "        J = damped_pinv(fk_jac(q),gamma)\n",
    "        f = fk_all(q)[-1] - xD\n",
    "        dq = -np.dot(J,f)\n",
    "        qnext = q+dq\n",
    "        trace.append(qnext)\n",
    "    return trace\n",
    "\n",
    "def damped_newton_linesearch(q0,N,gamma):\n",
    "    #uses damped pseudoinverse and simple line search with bisection to determine newton step\n",
    "    trace = [q0]\n",
    "    for i in range(N):\n",
    "        q = trace[-1]\n",
    "        J = damped_pinv(fk_jac(q),gamma)\n",
    "        f = fk_all(q)[-1] - xD\n",
    "        dq = -np.dot(J,f)\n",
    "        alpha = 1.0\n",
    "        f0 = np.dot(f,f)\n",
    "        while alpha > 1e-6:\n",
    "            qnext = q+alpha*dq\n",
    "            f = fk_all(qnext)[-1] - xD\n",
    "            fnext = np.dot(f,f)\n",
    "            if fnext < f0:\n",
    "                break\n",
    "            else:\n",
    "                alpha *= 0.5\n",
    "        trace.append(qnext)\n",
    "    return trace\n",
    "\n",
    "fig = plt.figure(figsize=(12,4))\n",
    "ax1 = fig.add_subplot(131)\n",
    "ax2 = fig.add_subplot(132)\n",
    "ax3 = fig.add_subplot(133)\n",
    "\n",
    "N=20\n",
    "gammas = [1,0.1,0.01,0.001]\n",
    "for gamma in gammas:\n",
    "    label = '$\\gamma$='+str(gamma)\n",
    "    trace = damped_newton(q0,N,gamma)\n",
    "    xy = [fk_all(q)[-1] for q in trace]\n",
    "    err = [error(q) for q in trace]\n",
    "    ax1.plot(range(1,len(trace)),[np.linalg.norm(trace[i]-trace[i-1]) for i in range(1,len(trace))],label=label)\n",
    "    ax2.plot([v[0] for v in xy],[v[1] for v in xy])\n",
    "    ax2.scatter([xD[0]],[xD[1]],color='r',zorder=2)\n",
    "    ax3.semilogy(range(len(err)),err)\n",
    "label = '$\\gamma$=0.001 + linesearch'\n",
    "trace = damped_newton_linesearch(q0,N,0.001)\n",
    "xy = [fk_all(q)[-1] for q in trace]\n",
    "err = [error(q) for q in trace]\n",
    "ax1.plot(range(1,len(trace)),[np.linalg.norm(trace[i]-trace[i-1]) for i in range(1,len(trace))],label=label)\n",
    "ax2.plot([v[0] for v in xy],[v[1] for v in xy])\n",
    "ax2.scatter([xD[0]],[xD[1]],color='r',zorder=2)\n",
    "ax3.semilogy(range(len(err)),err)   \n",
    "\n",
    "ax1.set_ylabel('Step size')\n",
    "ax1.set_xlabel('Iteration')\n",
    "ax1.legend()\n",
    "ax2.set_xlabel('x')\n",
    "ax2.set_ylabel('y')\n",
    "ax2.axis('equal')\n",
    "ax3.set_xlabel('Iterations')\n",
    "ax3.set_ylabel('Error')\n",
    "\n",
    "fig.tight_layout()\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "mgvTMQsd0P1l"
   },
   "source": [
    "### Minimization methods\n",
    "\n",
    "Minimization methods attempt to minimize the error function\n",
    "$\\| f(\\mathbf{q}) \\|$ (usually expressed as minimizing squared error\n",
    "$\\| f(\\mathbf{q}) \\|^2$ for ease of computation). They are similar to\n",
    "root-finding methods, but produce more \"reasonable\" results when a\n",
    "solution does not exist, since the result should be as close as possible\n",
    "to attaining the target task. The simplest method is *gradient descent*\n",
    "but higher-order methods are also available as described in\n",
    "[Appendix B.2](Optimization.ipynb#Gradient-descent).\n",
    "\n",
    "### Incorporating other constraints\n",
    "\n",
    "Soft preferences, such as minimizing $g(\\mathbf{q})$ can designate other\n",
    "desired criteria to be achieved in redundant systems. In minimization\n",
    "methods, preferences can be formulated by augmenting the objective\n",
    "function with a small cost term: $\\|f(\\mathbf{q})\\|^2 + \\epsilon g(\\mathbf{q})$.\n",
    "The drawback of this approach is that if $\\epsilon$ is too large, the\n",
    "optimum of the augmented objective will no longer meet the task\n",
    "constraint, but if it is too small then it will not significantly affect\n",
    "the descent direction. In root finding methods, the direction of each\n",
    "step can be optimized in the null space of the task Jacobian to move in\n",
    "the gradient descent direction $-\\nabla g(\\mathbf{q})$ while also respecting\n",
    "the constraint. Specifically, the null space projection is given by\n",
    "$-(I - J^+ J ) \\nabla g(\\mathbf{q})$ which can be added onto the step\n",
    "direction (with some scaling factor).\n",
    "\n",
    "The easiest type of hard constraint to incorporate is joint limits,\n",
    "where each joint $q_i$ is limited to the range $[a_i,b_i]$. In numerical\n",
    "methods each iterate can be limited to the hyper-box\n",
    "$[a_1,b_1] \\times \\cdots \\times [a_n,b_n]$ simply by projecting each\n",
    "joint value into its range. For even faster convergence when a joint is\n",
    "meeting its joint limit, higher order methods (Newton-Raphson, Newton,\n",
    "and Quasi-Newton methods) will eliminate the direction of motion from\n",
    "consideration when determining the step size. In Newton-Raphson, this is\n",
    "done by setting the column of the Jacobian matrix corresponding to\n",
    "constrained joints to zero before computing the pseudoinverse. In\n",
    "Newton and Quasi-Newton optimization, both the row and column of the\n",
    "Hessian matrix are eliminated before inversion.\n",
    "\n",
    "More complex constraints, such as obstacle avoidance, may be expressed\n",
    "in the form $h(\\mathbf{q}) \\leq 0$, but are harder to accommodate. It is not\n",
    "appropriate to simply check the feasibility of the solution after\n",
    "optimizing, since it will very likely be infeasible. More sophisticated\n",
    "constrained optimization models, like nonlinear programming, express all\n",
    "constraints simultaneously and solve them using more advanced methods\n",
    "like sequential quadratic programming. Such methods are outside of the\n",
    "scope of this book.\n",
    "\n",
    "### Local minimum issues\n",
    "\n",
    "All numerical methods presented above suffer from the issue of *local\n",
    "minima*, in which the error cannot be reduced with local movements, but\n",
    "instead a large step is needed to make progress toward a solution.\n",
    "Imagining an error \"landscape\", the landscape may potentially have many\n",
    "peaks and valleys, and one valley will contain the true optimal\n",
    "solution. When an iterate is near a local minimum, the method would need\n",
    "to choose a step direction to jump out of the local minimum. However,\n",
    "such a direction is not obvious from local information.\n",
    "\n",
    "This is indeed a problem with numerical IK techniques, particularly in\n",
    "the presence of joint limits, because in practice, some significant\n",
    "fraction of seed configurations will not converge to a solution. The\n",
    "problem of finding a global solution is known as *global optimization*.\n",
    "\n",
    "#### CCD + optimization\n",
    "\n",
    "As mentioned above, CCD rarely falls into local minima, so an effective\n",
    "solution would be to combine CCD to get relatively close to an optimum,\n",
    "with some other optimization technique for the final convergence steps.\n",
    "\n",
    "#### Random restarts\n",
    "\n",
    "Another effective technique is known as *random restart* optimization.\n",
    "In this method, if the initial seed fails to yield a solution after\n",
    "local optimization, then a new seed is picked at random. This restart\n",
    "process is repeated up to $N$ times or until a solution is found.\n",
    "\n",
    "If the fraction of seed configurations that lead to failure is $p$, then\n",
    "the probability that this method leads to a failure is $p^N$, which is\n",
    "quite small for large $N$. In fact, the expected number of restarts\n",
    "needed to find a solution is $1/p$. The main drawback of random restarts\n",
    "is when the task is infeasible, then the entirety of the $N$ random\n",
    "restarts is required, which may be computationally expensive if $N$ is\n",
    "large.\n",
    "\n",
    "#### Simulated annealing\n",
    "\n",
    "Another method is simulated annealing, which uses random jumps in\n",
    "configuration space and accepts error-increasing steps with some\n",
    "probability. This and other related methods, like evolutionary\n",
    "algorithms, are known as metaheuristics, and can lead to high-quality\n",
    "solutions where other techniques fail. However, in practice, these\n",
    "techniques are much slower to converge than competing techniques.\n",
    "\n",
    "#### IK databases\n",
    "\n",
    "The final approach we will mention is a data-driven method. First, in a\n",
    "preprocessing step, IK solutions are tabulated for a large number of\n",
    "points in task space, computed exhaustively using some other global\n",
    "optimization method. Then, when a new IK problem is queried, the nearest\n",
    "task point to the query point is retrieved, and the prior solution is\n",
    "used as a seed. When a large number of solutions have been previously\n",
    "computed, the retrieved solution is likely to be very close to the\n",
    "globally optimal solution to the new problem."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "yuJbX3JD4nkf"
   },
   "source": [
    "Applying IK in practice\n",
    "-----------------------"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "9trIXS5J0P1l"
   },
   "source": [
    "### Programming task spaces\n",
    "\n",
    "One issue we have not yet addressed is how to define IK problems on a\n",
    "computer rather than mathematically. This is not so much of a problem\n",
    "with analytical methods --- you have spent hours deriving the solution\n",
    "and coding it up so you know exactly what the inputs and outputs need to\n",
    "be. But the strength of numerical methods is that you can very easily\n",
    "change the IK problem you'd like to solve. If your robot is supposed to\n",
    "pick up a cup, hold it upright during transit, and then place it\n",
    "somewhere on a table, you will need to solve three entirely different IK\n",
    "problems! How should they be specified?\n",
    "\n",
    "Each IK software library has some data structure to specify a primitive\n",
    "*task*, which is usually a Cartesian goal for one link of the robot. So,\n",
    "in basic form a task is specified by a link index $L$, and a desired\n",
    "rigid transform $T_L$ (from link to world coordinates). However, the\n",
    "user can configure which Cartesian components should be included to\n",
    "obtain different effects. The typical types of tasks available are\n",
    "position only, position and orientation, or orientation only. More\n",
    "sophisticated tasks may include position about some axes, orientation of\n",
    "some axis, or some combination of the two. These are enabled or disabled\n",
    "according to various flags.\n",
    "\n",
    "Taking our cup-picking problem as an example:\n",
    "\n",
    "-   To pick up a cup, the robot's hand should be constrained to a\n",
    "    position $\\mathbf{x}_G$ and orientation $R_G$ so that it makes contact\n",
    "    with the cup (a grasp pose). This would be a *fixed* constraint,\n",
    "    with a 6D task space.\n",
    "\n",
    "-   Next, while keeping the cup oriented upward, the orientation of the\n",
    "    hand about the $z$ axis should be kept constant. This means that our\n",
    "    constraint is the $z$ axis in the hand's local frame, $R_G^T \\mathbf{z}$,\n",
    "    should be matched to $\\mathbf{z}$ in world coordinates. Since we don't\n",
    "    care about position, and we don't care how the robot rotates about\n",
    "    $z$, this would be an *axis* constraint, which has a 2D task space.\n",
    "\n",
    "-   Finally, while putting the cup down on a flat surface, we don't care\n",
    "    too much about where on the surface the cup gets placed, but we do\n",
    "    need the cup to stay upright and the bottom of the cup to be at a\n",
    "    height $z_S$. So, we need to include the prior orientation\n",
    "    constraint, plus an additional 1D position constraint. To implement\n",
    "    this, we can compute one point on the bottom of the cup in local\n",
    "    coordinates of the hand. Let's say we recorded such a point\n",
    "    $\\mathbf{x}_B$ in world coordinates back when we first picked up the cup.\n",
    "    In hand-local coordinates, this point is $R_G^T(\\mathbf{x}_B - \\mathbf{x}_G)$.\n",
    "    Now, the new world coordinates of this point need to be at height\n",
    "    $z_S$, which is a *plane* constraint.\n",
    "\n",
    "To implement an axis constraint, a local direction $\\mathbf{d}_L$ is matched\n",
    "to a world direction $\\mathbf{d}_D$. Such a constraint can be specified with\n",
    "a flag and either 1) $\\mathbf{d}_L$, $\\mathbf{d}_D$, or 2) $T_L$ and either\n",
    "direction (the other quantity can be derived from $T_L$).\n",
    "\n",
    "To implement a plane constraint, $T_L$ and the normal to the plane in\n",
    "world coordinates $\\mathbf{n}$ must be specified.\n",
    "\n",
    "Support of these various tasks is mixed in various software packages.\n",
    "Klamp't supports arbitrary numbers of tasks, each of which can have\n",
    "position and orientation components enabled or disabled. The data\n",
    "structure that specifies each task is called an IKObjective. Orocos KDL\n",
    "only supports tasks that define a full Cartesian transform of a link.\n",
    "\n",
    "The OpenRAVE ikfast module supports several task types, each of which\n",
    "constrains some combination position and orientation components (11 as\n",
    "of time of writing). This module is noteworthy in that it provides a\n",
    "method to derive analytic IK expressions for your robot; after a few\n",
    "minutes to an hour of computation, it generates code that can be\n",
    "compiled to solve IK problems very quickly (and exhaustively). It does\n",
    "require that you know your task spaces well in advance, and it does\n",
    "sometimes fail to generate expressions for certain kinematic structures."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "5B3bDIHx4yLw"
   },
   "source": [
    "### Common problems\n",
    "\n",
    "Using IK can be fraught with bugs if used carelessly. Usually when an\n",
    "engineer uses IK, he/she is trying to program a high-level specification\n",
    "of some application as quickly as possible, and can quickly gloss over\n",
    "*whether enough information is available* to employ IK properly.\n",
    "\n",
    "Let us recap all of the items necessary to employ IK on a robot.\n",
    "\n",
    "-   The robot's kinematic structure is known.\n",
    "\n",
    "-   The coordinates of the tool center point are known.\n",
    "\n",
    "-   The coordinate frame of the end effector link is known.\n",
    "\n",
    "-   A rotation matrix defining the desired orientation of the end\n",
    "    effector link is known.\n",
    "\n",
    "-   All coordinates are given with respect to the assumed reference\n",
    "    frame (and units) of the solver.\n",
    "\n",
    "Minor positioning errors can occur if any of these values are not\n",
    "properly *calibrated*, i.e., measured to high accuracy. We will revisit\n",
    "calibration a later chapter. However, major errors can result if\n",
    "reference coordinate frames are misunderstood or interpreted\n",
    "incorrectly.\n",
    "\n",
    "For example, suppose the reference frame of the end effector link has\n",
    "the gripper fingers pointing in the $z$ direction and open by traveling\n",
    "along the $x$ axis direction. But, suppose the programmer assumed that\n",
    "fingers point in the $x$ direction and $z$ is the local axis as though\n",
    "the robot were picking up a cup. Then by specifying the identity matrix\n",
    "as the end effector orientation, --- a seemingly sensible orientation to\n",
    "lift a cup with this mistaken frame convention --- the programmer will\n",
    "have asked the robot to grab the cup with fingers pointing straight\n",
    "upward! This is why it is so important to adopt strict and explicit\n",
    "coordinate conventions, and also to test in simulation. Now, a careless\n",
    "programmer might test the solver on the real robot\\... and if the IK\n",
    "solver succeeds, then the robot will be driven straight through the\n",
    "table! It is much better to start in simulation: ideally the IK solver\n",
    "will succeed with a bizarre configuration, which, upon inspection, suggests a bug. If the IK\n",
    "solver fails, the programmer needs to do more digging to discover the\n",
    "root of the problem. To help this, visualization tools can be used in\n",
    "the process of *visual debugging* to inspect reference frames and\n",
    "variables in a more intuitive way than looking at numbers.\n",
    "\n",
    "Moreover, if analytical IK is being used, the following must also hold:\n",
    "\n",
    "-   The task space defined by the IK subroutine match that of your\n",
    "    application.\n",
    "\n",
    "-   The robot structure matches that assumed by the IK subroutine\n",
    "    (including joint axes, link frame conventions, etc).\n",
    "\n",
    "-   Joint values are 0 at the robot's assumed reference position.\n",
    "\n",
    "-   The first joint (or the first set of intersecting joints) of the\n",
    "    robot is at the origin of the world frame.\n",
    "\n",
    "If any of these do not hold, it is the responsibility of the user of the\n",
    "subroutine to calculate the appropriate Cartesian transformations to\n",
    "transform the input appropriately, and to apply the appropriate joint\n",
    "offsets to transform the output appropriately."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "VXk3fXjY4uMg"
   },
   "source": [
    "### IK and Cartesian motion\n",
    "\n",
    "IK is commonly used in two ways:\n",
    "\n",
    "* To determine an endpoint for a motion.\n",
    "\n",
    "* To move a robot's end effector along a given task space path, such as a straight line in workspace. \n",
    "\n",
    "In Case 1, we may simply determine a desired joint space value $q_D$ that matches the end effector\n",
    "$\\mathbf{x}(q_D)$ maps to the task space coordinates $\\mathbf{x}_D$.  Then, the robot can move from the current value\n",
    "of $q$ to $q_D$ in a straight line in joint space. However, as [we have seen before](#Nonlinear-mapping-between-C-space-and-workspace),\n",
    "such a motion does not usually move in a straight line in workspace due to the nonlinearity of forward kinematics.  If we want the end effector to move in a designated Cartesian trajectory, then we must be more careful.\n",
    "\n",
    "Case 2 is a *Cartesian path following* problem, which asks to generate a trajectory $q(t)$ so that $\\mathbf{x}(q(t)) = \\mathbf{x}_D(t)$ for $t\\in[0,1]$.  It may be tempting to simply write an algorithm like this:\n",
    "\n",
    "*************\n",
    "\n",
    "<a name=\"alg:NaivePathFollowing\">Algorithm 1</a>. **Naive Cartesian path following**\n",
    "\n",
    "1. Let $q_0$ be the current configuration\n",
    "\n",
    "2. **For** $i=1,\\ldots,N$:\n",
    "\n",
    "3. &nbsp;&nbsp;&nbsp;Let $t=i/N$.\n",
    "\n",
    "4. &nbsp;&nbsp;&nbsp;Use a IK solver to find $q$ satisfying $\\mathbf{x}(q) = \\mathbf{x}_D(t)$, picking the solution closest to $q_{i-1}$.\n",
    "\n",
    "5.  &nbsp;&nbsp;&nbsp;$q_i \\gets q$.\n",
    "\n",
    "6. **Return** the joint space path connecting $q_0,q_1,\\ldots,q_N$\n",
    "\n",
    "*************\n",
    "\n",
    "For example, in step 4, a numerical IK method may simply use $q_{i-1}$ as the initial seed.  An analytical method for a nonredundant robot should enumerate all solutions and pick the closest one.  The choice of the resolution $N$ is also important, because it will determine how closely $\\mathbf{x}(q(t))$ tracks the desired trajectory.  For example, if a long screw needs to be drilled along a precise path, a very fine resolution will be needed.  In fact, industrial robot controllers will solve these problems at or near the control frequency (several hundreds of times per second)\n",
    "\n",
    "It is important to note that there are a number of caveats that may cause this procedure to fail or to create unusual artifacts: \n",
    "\n",
    "1.  The configuration may run into joint limits, preventing further progress.\n",
    "\n",
    "2.  Picking an IK solution that causes collisions.\n",
    "\n",
    "3.  Passing through or near singularities, causing the desired joint\n",
    "    velocities to exceed their limits.\n",
    "\n",
    "4.  Tolerances of numerical methods can cause small but noticeable\n",
    "    oscillations (or large jumps near singularities).\n",
    "\n",
    "Making naive Cartesian tracking more robust is a topic studied deeply in motion planning and robot control engineering, and is beyond the scope of an introductory text."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "15R6OSw70P1o"
   },
   "source": [
    "Summary\n",
    "-------\n",
    "\n",
    "### Key takeaways\n",
    "\n",
    "-   Inverse kinematics (IK) attempts to find a configuration (or\n",
    "    configurations) for an end effector to reach a Cartesian target.\n",
    "\n",
    "-   The task space defines whether the Cartesian target indicates\n",
    "    position, orientation, or some subset of those parameters. The task\n",
    "    space can also include targets for multiple end effectors.\n",
    "\n",
    "-   Analytical IK inverts the forward kinematics equations using\n",
    "    geometric and/or algebraic reasoning. They produce all solutions for\n",
    "    non-redundant robots, but rely on analysis of a known structure and\n",
    "    task space.\n",
    "\n",
    "-   The Jacobian is the matrix of partial derivatives of the forward\n",
    "    kinematics function. It relates joint velocities to task space\n",
    "    velocities.\n",
    "\n",
    "-   The Jacobian can be used for a variety of calculations, including\n",
    "    singularity identification and numerical IK.\n",
    "\n",
    "-   Numerical IK methods iteratively move a guessed configuration toward\n",
    "    an IK solution by progressively reducing the error of the constraint\n",
    "    function.\n",
    "\n",
    "-   Numerical IK methods are prone to falling into local minima. Random\n",
    "    restarts or good initial guesses are needed to improve reliability.\n",
    "\n",
    "-   Some robot developers provide analytical IK solvers specific to\n",
    "    their mechanism. Many robotics software packages provide numerical\n",
    "    IK solvers for general mechanisms."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Glossary\n",
    "- [Inverse kinematics (IK)](#General-discussion): The process of calculating one or more solutions to the inverse of a kinematics problem.  Specifically, attempts to find a configuration such that Cartesian position / orientations on robot links match corresponding positions/orientations in the world (or on other links of the robot).\n",
    "- [Task space](#Task-space): The specification of a class of inverse kinematics objectives, constraining one or more target Cartesian positions and/or orientations of elements on the robot.  The set of possible Cartesian positions and/or orientations that may be specified as targets is the task space.\n",
    "- [Constraint equation](#constraint-equation): The vector-valued equation that should be met at a configuration that solves a given IK problem.\n",
    "- [Multiplicity of solutions](#Counting-solutions): Depending on the number of DOF of the robot and the values of the IK query, an IK query can have zero, a finite number, or an infinite number of solutions.  When a finite number of solutions exist, they are often composed of combinations of joint value pairs (e.g., shoulder-left/shoulder-right, elbow-up/elbow-down, and wrist-left/wrist-right).\n",
    "- [Singularity / singular configuration](#Singularities): A robot is at a singularity when the number of IK solutions for the given task space is unstable, i.e., the multiplicity of solutions may change if the configuration were perturbed by an infinitesimal value.  A singularity can be identified by a drop in the rank of the task Jacobian matrix.\n",
    "- [Redundancy](#Redundant-robots): A robot has redundancy when it has more DOF than the task space. A redundant robot can move its configuration while leaving the task coordinates unchanged. \n",
    "- [Self-motion manifold](#self-motion-manifold): The set of all configurations for a redundant robot that leave the task space coordinates unchanged. \n",
    "- [Jacobian matrix](#Jacobian-definition): The matrix of partial derivatives of a robot's task space variables with respect to its configuration variables.  Multiplication by this matrix relates joint-space velocities to task-space velocities.\n",
    "- [Analytical IK](#Analytical-vs-numerical-ik): Any IK approach that solves the constraint equation via mathematical manipulations.  \n",
    "- [Numerical IK](#Analytical-vs-numerical-ik): Any IK approach that solves the constraint equation by iteratively moving a guessed configuration to minimize the constraint error.\n",
    "- [Cyclic coordinate descent](#Cyclic-coordinate-descent)\n",
    "- [Newton-Raphson method / Jacobian pseudoinverse method](#Root-finding-methods): A numerical method based on driving the task-space error vector to zero via root-finding.  Uses the Jacobian pseudoinverse to solve the Taylor expansion of the constraint equation, and achieves superlinear convergence speeds.\n",
    "- [Line search](#line-search): A technique employed in many numerical IK techniques that prevents divergence and oscillation by shrinking the step direction computed at each iteration.\n",
    "- [Minimization methods](#Minimization-methods): Numerical methods that attempt to reduce the magnitude of the error function. If a solution does not exit, these methods are able to find the (locally) closest solution.\n",
    "- [Random restarts](#Random-restarts): A common method for avoiding local minima in numerical IK solvers that simply attempts IK solution from random initial guesses.\n",
    "- [Cartesian path following](#IK-and-Cartesian-motion): The process of generating a joint-space path that smoothly follows a given Cartesian path. A naive implementation of repeated numerical IK solving is adequate for many cases, but more elaborate methods are needed to achieve high reliability near singularities.  "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "dShTD-RH0P1p"
   },
   "source": [
    "Exercises\n",
    "---------\n",
    "\n",
    "1.  Consider a planar \"spider robot\" with 3 arms, each consisting of a     2R manipulator, connected at a center point. Each of the \"hands\" (end effectors of each arm) must be placed at locations $\\mathbf{x}_1,\\mathbf{x}_2,\\mathbf{x}_3$, respectively. Define a configuration\n",
    "    space of the robot. What is the task space of the IK constraints?\n",
    "    What is the intrinsic dimension of the self-motion manifold? For\n",
    "    what values of $\\mathbf{x}_1,\\mathbf{x}_2,\\mathbf{x}_3$ would the solution space be\n",
    "    empty?\n",
    "\n",
    "2.  Derive an analytical IK solution for a 3R planar manipulator with\n",
    "    both position and orientation tasks. Hint: start by considering the\n",
    "    desired location of the third joint, and use the planar 2R solution\n",
    "    to place the third joint there.\n",
    "\n",
    "3.  Derive an analytical IK solution for the 3R 3D manipulator (ZYY) in\n",
    "    the general case where the end effector has local coordinates\n",
    "    $\\mathbf{x}_3$ on the third link, and the task is to place the end\n",
    "    effector at coordinates $\\mathbf{x}$.\n",
    "\n",
    "4.  Derive the configuration space for a closed 4-bar linkage with link\n",
    "    lengths $L_1,\\ldots,L_4$, assuming the first bar is fixed in world\n",
    "    coordinates.\n",
    "\n",
    "5.  Perform error propagation to derive an expression relating joint\n",
    "    space error to the maximum possible Cartesian end effector\n",
    "    positioning error of an $n$R planar serial robot with unit length\n",
    "    links. At what configurations is the maximum error achieved?\n",
    "\n",
    "6.  (Implementation) Experimentally evaluate how often a numerical IK solver falls into\n",
    "    local minima on a 6DOF manipulator. (For example, use the\n",
    "    `puma760.rob` or `tx90l.rob` model in Klamp't) To do so, sample some\n",
    "    number of reachable end effector transforms by sampling a\n",
    "    configuration at random. Then, for each of those transforms, and\n",
    "    attempt numerical IK using a seed configuration sampled at random.\n",
    "\n",
    "7.  (Implementation) Implement the naive Cartesian path following algorithm\n",
    "    for a simple robot (the 2R robot, for example).  Give it an input path $\\mathbf{x}_D(t)$ \n",
    "    so that all points along the path are reachable.  How finely do you need to discretize\n",
    "    the path so that the configuration space path, when interpolated, deviates from $\\mathbf{x}_D(t)$ \n",
    "    no more than 1mm?  Now input a path that goes unreachable.  What happens to the configurations\n",
    "    as you approach the limit?"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "tags": [
     "remove_cell_html"
    ]
   },
   "source": [
    "## Interactive quiz"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "code_folding": [
     0
    ],
    "tags": [
     "remove_cell_html"
    ]
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<link rel=\"stylesheet\" href=\"//stackpath.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css\"/>"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "application/vnd.jupyter.widget-view+json": {
       "model_id": "53efd4e2f03b4695a86049c6cf56f841",
       "version_major": 2,
       "version_minor": 0
      },
      "text/plain": [
       "VBox(children=(HTML(value='<style>\\n            .correct { background:#8f8;padding:10px 25px 10px 25px;width:4…"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "#This code must be run from the RoboticSystemsBook folder\n",
    "\n",
    "# If you are running on Google Colab, uncomment the following code:\n",
    "#\n",
    "# %cd ~\n",
    "# !git clone --depth 1 https://github.com/krishauser/RoboticSystemsBook\n",
    "# %cd RoboticSystemsBook\n",
    "\n",
    "from rsbook_code.assessment import quiz\n",
    "quiz.show('inverse_kinematics')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "tags": [
     "remove_cell_html"
    ]
   },
   "source": [
    "## Interactive examples\n",
    "\n",
    "The following interactive examples require that you run this notebook via Binder or a local Jupyter Notebook installation.  Google Colab is not compatible. See [these instructions](Book.ipynb#Options-for-Working-with-Jupyter-Notebook) for more details."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Planar 2R manipulator IK"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {
    "code_folding": [
     0
    ],
    "colab": {
     "referenced_widgets": [
      "4afb3f061b6745d38aaa995b57e76e9a",
      "08b282032baa4806958bb4a7971f99b5"
     ]
    },
    "id": "lPEpLgpN0P1q",
    "outputId": "32653af4-34fb-4229-8f26-d93bc40db4d2",
    "scrolled": false,
    "tags": [
     "remove_cell_html"
    ]
   },
   "outputs": [
    {
     "data": {
      "application/vnd.jupyter.widget-view+json": {
       "model_id": "4ab6a976f0d4461d84e54b9aea8d26b2",
       "version_major": 2,
       "version_minor": 0
      },
      "text/plain": [
       "KlamptWidgetAdaptor(height=400, rpc={'type': 'multiple', 'calls': [{'near': 0.1, 'target': {'y': 0, 'x': 0, 'z…"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "application/vnd.jupyter.widget-view+json": {
       "model_id": "c99d229c81774f2a886be5bf28ca98c5",
       "version_major": 2,
       "version_minor": 0
      },
      "text/plain": [
       "VBox(children=(FloatSlider(value=0.0, description='x', max=2.0, min=-2.0, step=0.001), FloatSlider(value=0.0, …"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "#Code for the interactive example (run me!)\n",
    "import time\n",
    "from klampt import *\n",
    "from klampt.math import so3,vectorops\n",
    "from klampt.model import ik\n",
    "import math\n",
    "from IPython.display import HTML,clear_output\n",
    "import ipywidgets as widgets\n",
    "from klampt.vis import ipython as ipyklampt\n",
    "\n",
    "world = WorldModel()\n",
    "world.readFile(\"data/planar2R.rob\")\n",
    "robot = world.robot(0)\n",
    "ee_local = (1,0,0)  #end effector coordinates\n",
    "robot.link(0).appearance().setColor(0.4,0.4,0.4)\n",
    "robot.link(1).appearance().setColor(0.2,0.2,0.2)\n",
    "#joint limits\n",
    "qmin = [-math.pi/2,-math.pi/2]\n",
    "qmax = [math.pi/2,math.pi/2]\n",
    "robot.setJointLimits(qmin,qmax)\n",
    "vis.init(\"IPython\")\n",
    "vis.resizeWindow(400,400)\n",
    "vis.add(\"world\",world)\n",
    "\n",
    "#look down\n",
    "vis.setViewport({u'near': 0.1, u'target': {u'y': 0, u'x': 0, u'z': 0}, u'far': 1000, u'position': {u'y': 6.702563444149367, u'x': 0.27057631353305844, u'z': -0.049312632332197764}, u'up': {u'y': 0.44113772676914204, u'x': -0.003726563135538217, u'z': -0.897431679153433}})\n",
    "#add a ghost\n",
    "vis.add(\"ghost\",robot.getConfig(),color=(0,1,0,0.5))\n",
    "\n",
    "EPSILON = 1e-8\n",
    "L1 = 1.0\n",
    "L2 = 1.0\n",
    "\n",
    "def ik_2R_analytical(L1,L2,x,y):\n",
    "    \"\"\"Solve IK for a 2R robot with link lengths L1 and L2.\n",
    "    \n",
    "    Returns a pair (N,solutions)\n",
    "    - N: number of solutions (can be 0, 1, 2, or infinity)\n",
    "    - solutions: a tuple of solution configurations. If N=infinity,\n",
    "      solutions is the tuple (None,q2).\n",
    "    \"\"\"\n",
    "    r2 = x**2+y**2\n",
    "    c2 = (r2-L1**2-L2**2)/(2*L1*L2)\n",
    "    if c2 > 1.0 or c2 < -1.0:\n",
    "        return (0,())\n",
    "    q2_1 = math.acos(c2)\n",
    "    q2s = [q2_1]\n",
    "    if abs(q2_1) > EPSILON and abs(q2_1-math.pi) > EPSILON:\n",
    "        q2s.append(-q2_1)\n",
    "    solns = []\n",
    "    for q2 in q2s:\n",
    "        ex = 1.0+math.cos(q2)\n",
    "        ey = math.sin(q2)\n",
    "        if abs(ex)<EPSILON and abs(ey) < EPSILON:\n",
    "            #infinite solutions\n",
    "            return (float('inf'),(None,q2))\n",
    "        theta = math.atan2(y,x)\n",
    "        etheta = math.atan2(ey,ex)\n",
    "        solns.append((theta-etheta,q2))\n",
    "    return (len(solns),solns)\n",
    "\n",
    "def ik_2R_numerical(q0,x,y):\n",
    "    robot.setConfig(q0)\n",
    "    obj = ik.objective(robot.link(1),local=ee_local,world=(x,y,0))\n",
    "    solver = ik.solver(obj)\n",
    "    solver.solve()\n",
    "    return q0\n",
    "\n",
    "#called whenever configuration is edited\n",
    "link0_vis_path = vis.getItemName(robot.link(0))\n",
    "link1_vis_path = vis.getItemName(robot.link(1))\n",
    "def point_update_cb(point):\n",
    "    global L1,L2\n",
    "    N,solns = ik_2R_analytical(L1,L2,point[0],point[1])\n",
    "    if N == 0:\n",
    "        #no solution\n",
    "        vis.setColor(link0_vis_path,1,0,0)\n",
    "        vis.setColor(link1_vis_path,1,0,0)\n",
    "    elif N == 1 or N == 2:\n",
    "        vis.setColor(link0_vis_path,0.4,0.4,0.4)\n",
    "        vis.setColor(link1_vis_path,0.2,0.2,0.2)\n",
    "        robot.setConfig(solns[0])\n",
    "        vis.add(\"ghost\",solns[1],color=(0,1,0,0.5))\n",
    "    else:\n",
    "        #infinite solutions\n",
    "        vis.setColor(link0_vis_path,1,1,0)\n",
    "        vis.setColor(link1_vis_path,1,1,0)\n",
    "        robot.setConfig((0,solns[0][1]))\n",
    "    vis.update()\n",
    "pt = [0,0,0]\n",
    "point_widget = ipyklampt.EditPoint(pt,[-2,-2,-1],[2,2,1],klampt_widget=vis.nativeWindow(),callback=point_update_cb)\n",
    "\n",
    "vis.show()\n",
    "display(point_widget)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "o2NPk4vN0P1r"
   },
   "source": [
    "### 6R manipulator IK"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {
    "code_folding": [
     0
    ]
   },
   "outputs": [
    {
     "data": {
      "application/vnd.jupyter.widget-view+json": {
       "model_id": "0a500ed624164e668dc652e774f90784",
       "version_major": 2,
       "version_minor": 0
      },
      "text/plain": [
       "KlamptWidgetAdaptor(height=400, rpc={'type': 'multiple', 'calls': [{'type': 'add_xform', 'name': 'edited_xform…"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "application/vnd.jupyter.widget-view+json": {
       "model_id": "1cfb6cfcf38343478a3ca94687589a0d",
       "version_major": 2,
       "version_minor": 0
      },
      "text/plain": [
       "VBox(children=(FloatSlider(value=6.283185307179586, description='roll', max=6.283185307179586, step=0.001), Fl…"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "#Code for the interactive example (run me!)\n",
    "import time\n",
    "from klampt import *\n",
    "from klampt.math import so3,se3,vectorops\n",
    "from klampt.model import ik\n",
    "import math\n",
    "from IPython.display import HTML,clear_output\n",
    "import ipywidgets as widgets\n",
    "from klampt.vis import ipython as ipyklampt\n",
    "\n",
    "world = WorldModel()\n",
    "world.readFile(\"data/tx90l.rob\")\n",
    "robot = world.robot(0)\n",
    "\n",
    "ee_link_index = robot.numLinks()-1\n",
    "ee_link = robot.link(ee_link_index)\n",
    "ee_local = (0,0,0)  #end effector coordinates\n",
    "vis.init(\"IPython\")\n",
    "vis.createWindow()\n",
    "vis.resizeWindow(400,400)\n",
    "vis.add(\"world\",world)\n",
    "\n",
    "#called whenever configuration is edited\n",
    "def point_update_cb(xform):\n",
    "    R,t = xform\n",
    "    obj = ik.objective(ee_link,R=R,t=t)\n",
    "    res = ik.solve(obj)\n",
    "    vis.clearText()\n",
    "    if res:\n",
    "        vis.addText(\"IKstatus\",\"IK solved!\",position=(5,5))\n",
    "    else:\n",
    "        txt = ','.join('%.2f'%(v,) for v in ik.residual(obj))\n",
    "        vis.addText(\"IKstatus\",\"IK failed, residual %s\"%(txt,),position=(5,5))\n",
    "    vis.update()\n",
    "xform = ee_link.getTransform()\n",
    "xform_widget = ipyklampt.EditTransform(xform,[-1.5,-1.5,0],[1.5,1.5,3],klampt_widget=vis.nativeWindow(),callback=point_update_cb)\n",
    "\n",
    "vis.show()\n",
    "display(xform_widget)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "colab": {
   "name": "InverseKinematics.ipynb",
   "provenance": []
  },
  "kernelspec": {
   "display_name": "Python 3 (ipykernel)",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.11.3"
  },
  "latex_envs": {
   "LaTeX_envs_menu_present": false,
   "autoclose": false,
   "autocomplete": false,
   "bibliofile": "biblio.bib",
   "cite_by": "apalike",
   "current_citInitial": 1,
   "eqLabelWithNumbers": true,
   "eqNumInitial": 1,
   "hotkeys": {
    "equation": "Ctrl-E",
    "itemize": "Ctrl-I"
   },
   "labels_anchors": false,
   "latex_user_defs": false,
   "report_style_numbering": false,
   "user_envs_cfg": false
  },
  "toc": {
   "base_numbering": 1,
   "nav_menu": {},
   "number_sections": true,
   "sideBar": true,
   "skip_h1_title": true,
   "title_cell": "Table of Contents",
   "title_sidebar": "Contents",
   "toc_cell": false,
   "toc_position": {
    "height": "calc(100% - 180px)",
    "left": "10px",
    "top": "150px",
    "width": "278.517px"
   },
   "toc_section_display": true,
   "toc_window_display": true
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}