{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "\n", "# Week 39: Optimization and Gradient Methods\n", "\n", " \n", "**Morten Hjorth-Jensen**, Department of Physics, University of Oslo and Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University\n", "\n", "Date: **Sep 25, 2020**\n", "\n", "Copyright 1999-2020, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license\n", "\n", "\n", "\n", "## Plan for week 39\n", "\n", "* Thursday: Repetition of Logistic regression equations and discussion of Gradient methods\n", "\n", "* Friday: Stochastic Gradient descent with examples and automatic differeantion\n", "\n", "Reading suggestions for both days: [Aurelien Geron's chapter 4](https://github.com/CompPhysics/MachineLearning/blob/master/doc/Textbooks/TensorflowML.pdf) and [Murphy sections 8.3 and 8.5](https://github.com/CompPhysics/MachineLearning/blob/master/doc/Textbooks/MachineLearningMurphy.pdf) \n", "\n", "## Thursday September 24\n", "\n", "[Overview Video, why do we care about gradient methods?](https://www.uio.no/studier/emner/matnat/fys/FYS-STK3155/h20/forelesningsvideoer/OverarchingAimsWeek39.mp4?vrtx=view-as-webpage)\n", "\n", "## Optimization, the central part of any Machine Learning algortithm\n", "\n", "Almost every problem in machine learning and data science starts with\n", "a dataset $X$, a model $g(\\beta)$, which is a function of the\n", "parameters $\\beta$ and a cost function $C(X, g(\\beta))$ that allows\n", "us to judge how well the model $g(\\beta)$ explains the observations\n", "$X$. The model is fit by finding the values of $\\beta$ that minimize\n", "the cost function. Ideally we would be able to solve for $\\beta$\n", "analytically, however this is not possible in general and we must use\n", "some approximative/numerical method to compute the minimum.\n", "\n", "\n", "## Revisiting our Logistic Regression case\n", "\n", "In our discussion on Logistic Regression we studied the \n", "case of\n", "two classes, with $y_i$ either\n", "$0$ or $1$. Furthermore we assumed also that we have only two\n", "parameters $\\beta$ in our fitting, that is we\n", "defined probabilities" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\begin{align*}\n", "p(y_i=1|x_i,\\boldsymbol{\\beta}) &= \\frac{\\exp{(\\beta_0+\\beta_1x_i)}}{1+\\exp{(\\beta_0+\\beta_1x_i)}},\\nonumber\\\\\n", "p(y_i=0|x_i,\\boldsymbol{\\beta}) &= 1 - p(y_i=1|x_i,\\boldsymbol{\\beta}),\n", "\\end{align*}\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "where $\\boldsymbol{\\beta}$ are the weights we wish to extract from data, in our case $\\beta_0$ and $\\beta_1$. \n", "\n", "## The equations to solve\n", "\n", "Our compact equations used a definition of a vector $\\boldsymbol{y}$ with $n$\n", "elements $y_i$, an $n\\times p$ matrix $\\boldsymbol{X}$ which contains the\n", "$x_i$ values and a vector $\\boldsymbol{p}$ of fitted probabilities\n", "$p(y_i\\vert x_i,\\boldsymbol{\\beta})$. We rewrote in a more compact form\n", "the first derivative of the cost function as" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\frac{\\partial \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}} = -\\boldsymbol{X}^T\\left(\\boldsymbol{y}-\\boldsymbol{p}\\right).\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "If we in addition define a diagonal matrix $\\boldsymbol{W}$ with elements \n", "$p(y_i\\vert x_i,\\boldsymbol{\\beta})(1-p(y_i\\vert x_i,\\boldsymbol{\\beta})$, we can obtain a compact expression of the second derivative as" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\frac{\\partial^2 \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}\\partial \\boldsymbol{\\beta}^T} = \\boldsymbol{X}^T\\boldsymbol{W}\\boldsymbol{X}.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "This defines what is called the Hessian matrix.\n", "\n", "## Solving using Newton-Raphson's method\n", "\n", "If we can set up these equations, Newton-Raphson's iterative method is normally the method of choice. It requires however that we can compute in an efficient way the matrices that define the first and second derivatives. \n", "\n", "Our iterative scheme is then given by" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{\\beta}^{\\mathrm{new}} = \\boldsymbol{\\beta}^{\\mathrm{old}}-\\left(\\frac{\\partial^2 \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}\\partial \\boldsymbol{\\beta}^T}\\right)^{-1}_{\\boldsymbol{\\beta}^{\\mathrm{old}}}\\times \\left(\\frac{\\partial \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}}\\right)_{\\boldsymbol{\\beta}^{\\mathrm{old}}},\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "or in matrix form as" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{\\beta}^{\\mathrm{new}} = \\boldsymbol{\\beta}^{\\mathrm{old}}-\\left(\\boldsymbol{X}^T\\boldsymbol{W}\\boldsymbol{X} \\right)^{-1}\\times \\left(-\\boldsymbol{X}^T(\\boldsymbol{y}-\\boldsymbol{p}) \\right)_{\\boldsymbol{\\beta}^{\\mathrm{old}}}.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The right-hand side is computed with the old values of $\\beta$. \n", "\n", "If we can compute these matrices, in particular the Hessian, the above is often the easiest method to implement. \n", "\n", "\n", "## Brief reminder on Newton-Raphson's method\n", "\n", "Let us quickly remind ourselves how we derive the above method.\n", "\n", "Perhaps the most celebrated of all one-dimensional root-finding\n", "routines is Newton's method, also called the Newton-Raphson\n", "method. This method requires the evaluation of both the\n", "function $f$ and its derivative $f'$ at arbitrary points. \n", "If you can only calculate the derivative\n", "numerically and/or your function is not of the smooth type, we\n", "normally discourage the use of this method.\n", "\n", "## The equations\n", "\n", "The Newton-Raphson formula consists geometrically of extending the\n", "tangent line at a current point until it crosses zero, then setting\n", "the next guess to the abscissa of that zero-crossing. The mathematics\n", "behind this method is rather simple. Employing a Taylor expansion for\n", "$x$ sufficiently close to the solution $s$, we have" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "\n", "
\n", "\n", "$$\n", "f(s)=0=f(x)+(s-x)f'(x)+\\frac{(s-x)^2}{2}f''(x) +\\dots.\n", " \\label{eq:taylornr} \\tag{1}\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "For small enough values of the function and for well-behaved\n", "functions, the terms beyond linear are unimportant, hence we obtain" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "f(x)+(s-x)f'(x)\\approx 0,\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "yielding" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "s\\approx x-\\frac{f(x)}{f'(x)}.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Having in mind an iterative procedure, it is natural to start iterating with" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "x_{n+1}=x_n-\\frac{f(x_n)}{f'(x_n)}.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Simple geometric interpretation\n", "\n", "The above is Newton-Raphson's method. It has a simple geometric\n", "interpretation, namely $x_{n+1}$ is the point where the tangent from\n", "$(x_n,f(x_n))$ crosses the $x$-axis. Close to the solution,\n", "Newton-Raphson converges fast to the desired result. However, if we\n", "are far from a root, where the higher-order terms in the series are\n", "important, the Newton-Raphson formula can give grossly inaccurate\n", "results. For instance, the initial guess for the root might be so far\n", "from the true root as to let the search interval include a local\n", "maximum or minimum of the function. If an iteration places a trial\n", "guess near such a local extremum, so that the first derivative nearly\n", "vanishes, then Newton-Raphson may fail totally\n", "\n", "\n", "## Extending to more than one variable\n", "\n", "Newton's method can be generalized to systems of several non-linear equations\n", "and variables. Consider the case with two equations" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\begin{array}{cc} f_1(x_1,x_2) &=0\\\\\n", " f_2(x_1,x_2) &=0,\\end{array}\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "which we Taylor expand to obtain" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\begin{array}{cc} 0=f_1(x_1+h_1,x_2+h_2)=&f_1(x_1,x_2)+h_1\n", " \\partial f_1/\\partial x_1+h_2\n", " \\partial f_1/\\partial x_2+\\dots\\\\\n", " 0=f_2(x_1+h_1,x_2+h_2)=&f_2(x_1,x_2)+h_1\n", " \\partial f_2/\\partial x_1+h_2\n", " \\partial f_2/\\partial x_2+\\dots\n", " \\end{array}.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Defining the Jacobian matrix ${\\bf \\boldsymbol{J}}$ we have" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "{\\bf \\boldsymbol{J}}=\\left( \\begin{array}{cc}\n", " \\partial f_1/\\partial x_1 & \\partial f_1/\\partial x_2 \\\\\n", " \\partial f_2/\\partial x_1 &\\partial f_2/\\partial x_2\n", " \\end{array} \\right),\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "we can rephrase Newton's method as" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\left(\\begin{array}{c} x_1^{n+1} \\\\ x_2^{n+1} \\end{array} \\right)=\n", "\\left(\\begin{array}{c} x_1^{n} \\\\ x_2^{n} \\end{array} \\right)+\n", "\\left(\\begin{array}{c} h_1^{n} \\\\ h_2^{n} \\end{array} \\right),\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "where we have defined" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\left(\\begin{array}{c} h_1^{n} \\\\ h_2^{n} \\end{array} \\right)=\n", " -{\\bf \\boldsymbol{J}}^{-1}\n", " \\left(\\begin{array}{c} f_1(x_1^{n},x_2^{n}) \\\\ f_2(x_1^{n},x_2^{n}) \\end{array} \\right).\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We need thus to compute the inverse of the Jacobian matrix and it\n", "is to understand that difficulties may\n", "arise in case ${\\bf \\boldsymbol{J}}$ is nearly singular.\n", "\n", "It is rather straightforward to extend the above scheme to systems of\n", "more than two non-linear equations. In our case, the Jacobian matrix is given by the Hessian that represents the second derivative of cost function. \n", "\n", "\n", "\n", "## Steepest descent\n", "\n", "The basic idea of gradient descent is\n", "that a function $F(\\mathbf{x})$, \n", "$\\mathbf{x} \\equiv (x_1,\\cdots,x_n)$, decreases fastest if one goes from $\\bf {x}$ in the\n", "direction of the negative gradient $-\\nabla F(\\mathbf{x})$.\n", "\n", "It can be shown that if" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\mathbf{x}_{k+1} = \\mathbf{x}_k - \\gamma_k \\nabla F(\\mathbf{x}_k),\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "with $\\gamma_k > 0$.\n", "\n", "For $\\gamma_k$ small enough, then $F(\\mathbf{x}_{k+1}) \\leq\n", "F(\\mathbf{x}_k)$. This means that for a sufficiently small $\\gamma_k$\n", "we are always moving towards smaller function values, i.e a minimum.\n", "\n", "\n", "## More on Steepest descent\n", "\n", "The previous observation is the basis of the method of steepest\n", "descent, which is also referred to as just gradient descent (GD). One\n", "starts with an initial guess $\\mathbf{x}_0$ for a minimum of $F$ and\n", "computes new approximations according to" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\mathbf{x}_{k+1} = \\mathbf{x}_k - \\gamma_k \\nabla F(\\mathbf{x}_k), \\ \\ k \\geq 0.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The parameter $\\gamma_k$ is often referred to as the step length or\n", "the learning rate within the context of Machine Learning.\n", "\n", "\n", "## The ideal\n", "\n", "Ideally the sequence $\\{\\mathbf{x}_k \\}_{k=0}$ converges to a global\n", "minimum of the function $F$. In general we do not know if we are in a\n", "global or local minimum. In the special case when $F$ is a convex\n", "function, all local minima are also global minima, so in this case\n", "gradient descent can converge to the global solution. The advantage of\n", "this scheme is that it is conceptually simple and straightforward to\n", "implement. However the method in this form has some severe\n", "limitations:\n", "\n", "In machine learing we are often faced with non-convex high dimensional\n", "cost functions with many local minima. Since GD is deterministic we\n", "will get stuck in a local minimum, if the method converges, unless we\n", "have a very good intial guess. This also implies that the scheme is\n", "sensitive to the chosen initial condition.\n", "\n", "Note that the gradient is a function of $\\mathbf{x} =\n", "(x_1,\\cdots,x_n)$ which makes it expensive to compute numerically.\n", "\n", "\n", "\n", "## The sensitiveness of the gradient descent\n", "\n", "The gradient descent method \n", "is sensitive to the choice of learning rate $\\gamma_k$. This is due\n", "to the fact that we are only guaranteed that $F(\\mathbf{x}_{k+1}) \\leq\n", "F(\\mathbf{x}_k)$ for sufficiently small $\\gamma_k$. The problem is to\n", "determine an optimal learning rate. If the learning rate is chosen too\n", "small the method will take a long time to converge and if it is too\n", "large we can experience erratic behavior.\n", "\n", "Many of these shortcomings can be alleviated by introducing\n", "randomness. One such method is that of Stochastic Gradient Descent\n", "(SGD), see below.\n", "\n", "\n", "\n", "## Convex functions\n", "\n", "Ideally we want our cost/loss function to be convex(concave).\n", "\n", "First we give the definition of a convex set: A set $C$ in\n", "$\\mathbb{R}^n$ is said to be convex if, for all $x$ and $y$ in $C$ and\n", "all $t \\in (0,1)$ , the point $(1 − t)x + ty$ also belongs to\n", "C. Geometrically this means that every point on the line segment\n", "connecting $x$ and $y$ is in $C$ as discussed below.\n", "\n", "The convex subsets of $\\mathbb{R}$ are the intervals of\n", "$\\mathbb{R}$. Examples of convex sets of $\\mathbb{R}^2$ are the\n", "regular polygons (triangles, rectangles, pentagons, etc...).\n", "\n", "## Convex function\n", "\n", "**Convex function**: Let $X \\subset \\mathbb{R}^n$ be a convex set. Assume that the function $f: X \\rightarrow \\mathbb{R}$ is continuous, then $f$ is said to be convex if $$f(tx_1 + (1-t)x_2) \\leq tf(x_1) + (1-t)f(x_2) $$ for all $x_1, x_2 \\in X$ and for all $t \\in [0,1]$. If $\\leq$ is replaced with a strict inequaltiy in the definition, we demand $x_1 \\neq x_2$ and $t\\in(0,1)$ then $f$ is said to be strictly convex. For a single variable function, convexity means that if you draw a straight line connecting $f(x_1)$ and $f(x_2)$, the value of the function on the interval $[x_1,x_2]$ is always below the line as illustrated below.\n", "\n", "## Conditions on convex functions\n", "\n", "In the following we state first and second-order conditions which\n", "ensures convexity of a function $f$. We write $D_f$ to denote the\n", "domain of $f$, i.e the subset of $R^n$ where $f$ is defined. For more\n", "details and proofs we refer to: [S. Boyd and L. Vandenberghe. Convex Optimization. Cambridge University Press](http://stanford.edu/boyd/cvxbook/, 2004).\n", "\n", "**First order condition.**\n", "\n", "Suppose $f$ is differentiable (i.e $\\nabla f(x)$ is well defined for\n", "all $x$ in the domain of $f$). Then $f$ is convex if and only if $D_f$\n", "is a convex set and $$f(y) \\geq f(x) + \\nabla f(x)^T (y-x) $$ holds\n", "for all $x,y \\in D_f$. This condition means that for a convex function\n", "the first order Taylor expansion (right hand side above) at any point\n", "a global under estimator of the function. To convince yourself you can\n", "make a drawing of $f(x) = x^2+1$ and draw the tangent line to $f(x)$ and\n", "note that it is always below the graph.\n", "\n", "\n", "\n", "**Second order condition.**\n", "\n", "Assume that $f$ is twice\n", "differentiable, i.e the Hessian matrix exists at each point in\n", "$D_f$. Then $f$ is convex if and only if $D_f$ is a convex set and its\n", "Hessian is positive semi-definite for all $x\\in D_f$. For a\n", "single-variable function this reduces to $f''(x) \\geq 0$. Geometrically this means that $f$ has nonnegative curvature\n", "everywhere.\n", "\n", "\n", "\n", "This condition is particularly useful since it gives us an procedure for determining if the function under consideration is convex, apart from using the definition.\n", "\n", "## More on convex functions\n", "\n", "The next result is of great importance to us and the reason why we are\n", "going on about convex functions. In machine learning we frequently\n", "have to minimize a loss/cost function in order to find the best\n", "parameters for the model we are considering. \n", "\n", "Ideally we want the\n", "global minimum (for high-dimensional models it is hard to know\n", "if we have local or global minimum). However, if the cost/loss function\n", "is convex the following result provides invaluable information:\n", "\n", "**Any minimum is global for convex functions.**\n", "\n", "Consider the problem of finding $x \\in \\mathbb{R}^n$ such that $f(x)$\n", "is minimal, where $f$ is convex and differentiable. Then, any point\n", "$x^*$ that satisfies $\\nabla f(x^*) = 0$ is a global minimum.\n", "\n", "\n", "\n", "This result means that if we know that the cost/loss function is convex and we are able to find a minimum, we are guaranteed that it is a global minimum.\n", "\n", "## Some simple problems\n", "\n", "1. Show that $f(x)=x^2$ is convex for $x \\in \\mathbb{R}$ using the definition of convexity. Hint: If you re-write the definition, $f$ is convex if the following holds for all $x,y \\in D_f$ and any $\\lambda \\in [0,1]$ $\\lambda f(x)+(1-\\lambda)f(y)-f(\\lambda x + (1-\\lambda) y ) \\geq 0$.\n", "\n", "2. Using the second order condition show that the following functions are convex on the specified domain.\n", "\n", " * $f(x) = e^x$ is convex for $x \\in \\mathbb{R}$.\n", "\n", " * $g(x) = -\\ln(x)$ is convex for $x \\in (0,\\infty)$.\n", "\n", "\n", "3. Let $f(x) = x^2$ and $g(x) = e^x$. Show that $f(g(x))$ and $g(f(x))$ is convex for $x \\in \\mathbb{R}$. Also show that if $f(x)$ is any convex function than $h(x) = e^{f(x)}$ is convex.\n", "\n", "4. A norm is any function that satisfy the following properties\n", "\n", " * $f(\\alpha x) = |\\alpha| f(x)$ for all $\\alpha \\in \\mathbb{R}$.\n", "\n", " * $f(x+y) \\leq f(x) + f(y)$\n", "\n", " * $f(x) \\leq 0$ for all $x \\in \\mathbb{R}^n$ with equality if and only if $x = 0$\n", "\n", "\n", "Using the definition of convexity, try to show that a function satisfying the properties above is convex (the third condition is not needed to show this).\n", "\n", "## Standard steepest descent\n", "\n", "\n", "Before we proceed, we would like to discuss the approach called the\n", "**standard Steepest descent** (different from the above steepest descent discussion), which again leads to us having to be able\n", "to compute a matrix. It belongs to the class of Conjugate Gradient methods (CG).\n", "\n", "[The success of the CG method](https://www.cs.cmu.edu/~quake-papers/painless-conjugate-gradient.pdf)\n", "for finding solutions of non-linear problems is based on the theory\n", "of conjugate gradients for linear systems of equations. It belongs to\n", "the class of iterative methods for solving problems from linear\n", "algebra of the type" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{A}\\boldsymbol{x} = \\boldsymbol{b}.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "In the iterative process we end up with a problem like" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{r}= \\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x},\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "where $\\boldsymbol{r}$ is the so-called residual or error in the iterative process.\n", "\n", "When we have found the exact solution, $\\boldsymbol{r}=0$.\n", "\n", "## Gradient method\n", "\n", "The residual is zero when we reach the minimum of the quadratic equation" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "P(\\boldsymbol{x})=\\frac{1}{2}\\boldsymbol{x}^T\\boldsymbol{A}\\boldsymbol{x} - \\boldsymbol{x}^T\\boldsymbol{b},\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "with the constraint that the matrix $\\boldsymbol{A}$ is positive definite and\n", "symmetric. This defines also the Hessian and we want it to be positive definite. \n", "\n", "\n", "## Steepest descent method\n", "\n", "We denote the initial guess for $\\boldsymbol{x}$ as $\\boldsymbol{x}_0$. \n", "We can assume without loss of generality that" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{x}_0=0,\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "or consider the system" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{A}\\boldsymbol{z} = \\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_0,\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "instead.\n", "\n", "\n", "## Steepest descent method\n", "One can show that the solution $\\boldsymbol{x}$ is also the unique minimizer of the quadratic form" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "f(\\boldsymbol{x}) = \\frac{1}{2}\\boldsymbol{x}^T\\boldsymbol{A}\\boldsymbol{x} - \\boldsymbol{x}^T \\boldsymbol{x} , \\quad \\boldsymbol{x}\\in\\mathbf{R}^n.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "This suggests taking the first basis vector $\\boldsymbol{r}_1$ (see below for definition) \n", "to be the gradient of $f$ at $\\boldsymbol{x}=\\boldsymbol{x}_0$, \n", "which equals" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{A}\\boldsymbol{x}_0-\\boldsymbol{b},\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "and \n", "$\\boldsymbol{x}_0=0$ it is equal $-\\boldsymbol{b}$.\n", "\n", "\n", "\n", "## Final expressions\n", "We can compute the residual iteratively as" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{r}_{k+1}=\\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_{k+1},\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "which equals" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{b}-\\boldsymbol{A}(\\boldsymbol{x}_k+\\alpha_k\\boldsymbol{r}_k),\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "or" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "(\\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_k)-\\alpha_k\\boldsymbol{A}\\boldsymbol{r}_k,\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "which gives" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\alpha_k = \\frac{\\boldsymbol{r}_k^T\\boldsymbol{r}_k}{\\boldsymbol{r}_k^T\\boldsymbol{A}\\boldsymbol{r}_k}\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "leading to the iterative scheme" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{x}_{k+1}=\\boldsymbol{x}_k-\\alpha_k\\boldsymbol{r}_{k},\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Steepest descent example" ] }, { "cell_type": "code", "execution_count": 1, "metadata": {}, "outputs": [], "source": [ "%matplotlib inline\n", "\n", "import numpy as np\n", "import numpy.linalg as la\n", "\n", "import scipy.optimize as sopt\n", "\n", "import matplotlib.pyplot as pt\n", "from mpl_toolkits.mplot3d import axes3d\n", "\n", "def f(x):\n", " return 0.5*x[0]**2 + 2.5*x[1]**2\n", "\n", "def df(x):\n", " return np.array([x[0], 5*x[1]])\n", "\n", "fig = pt.figure()\n", "ax = fig.gca(projection=\"3d\")\n", "\n", "xmesh, ymesh = np.mgrid[-2:2:50j,-2:2:50j]\n", "fmesh = f(np.array([xmesh, ymesh]))\n", "ax.plot_surface(xmesh, ymesh, fmesh)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "And then as countor plot" ] }, { "cell_type": "code", "execution_count": 2, "metadata": {}, "outputs": [], "source": [ "pt.axis(\"equal\")\n", "pt.contour(xmesh, ymesh, fmesh)\n", "guesses = [np.array([2, 2./5])]" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Find guesses" ] }, { "cell_type": "code", "execution_count": 3, "metadata": {}, "outputs": [], "source": [ "x = guesses[-1]\n", "s = -df(x)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Run it!" ] }, { "cell_type": "code", "execution_count": 4, "metadata": {}, "outputs": [], "source": [ "def f1d(alpha):\n", " return f(x + alpha*s)\n", "\n", "alpha_opt = sopt.golden(f1d)\n", "next_guess = x + alpha_opt * s\n", "guesses.append(next_guess)\n", "print(next_guess)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "What happened?" ] }, { "cell_type": "code", "execution_count": 5, "metadata": {}, "outputs": [], "source": [ "pt.axis(\"equal\")\n", "pt.contour(xmesh, ymesh, fmesh, 50)\n", "it_array = np.array(guesses)\n", "pt.plot(it_array.T[0], it_array.T[1], \"x-\")" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Conjugate gradient method\n", "In the CG method we define so-called conjugate directions and two vectors \n", "$\\boldsymbol{s}$ and $\\boldsymbol{t}$\n", "are said to be\n", "conjugate if" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{s}^T\\boldsymbol{A}\\boldsymbol{t}= 0.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The philosophy of the CG method is to perform searches in various conjugate directions\n", "of our vectors $\\boldsymbol{x}_i$ obeying the above criterion, namely" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{x}_i^T\\boldsymbol{A}\\boldsymbol{x}_j= 0.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Two vectors are conjugate if they are orthogonal with respect to \n", "this inner product. Being conjugate is a symmetric relation: if $\\boldsymbol{s}$ is conjugate to $\\boldsymbol{t}$, then $\\boldsymbol{t}$ is conjugate to $\\boldsymbol{s}$.\n", "\n", "\n", "\n", "## Conjugate gradient method\n", "An example is given by the eigenvectors of the matrix" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{v}_i^T\\boldsymbol{A}\\boldsymbol{v}_j= \\lambda\\boldsymbol{v}_i^T\\boldsymbol{v}_j,\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "which is zero unless $i=j$.\n", "\n", "\n", "\n", "\n", "## Conjugate gradient method\n", "Assume now that we have a symmetric positive-definite matrix $\\boldsymbol{A}$ of size\n", "$n\\times n$. At each iteration $i+1$ we obtain the conjugate direction of a vector" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{x}_{i+1}=\\boldsymbol{x}_{i}+\\alpha_i\\boldsymbol{p}_{i}.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We assume that $\\boldsymbol{p}_{i}$ is a sequence of $n$ mutually conjugate directions. \n", "Then the $\\boldsymbol{p}_{i}$ form a basis of $R^n$ and we can expand the solution \n", "$ \\boldsymbol{A}\\boldsymbol{x} = \\boldsymbol{b}$ in this basis, namely" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{x} = \\sum^{n}_{i=1} \\alpha_i \\boldsymbol{p}_i.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Conjugate gradient method\n", "The coefficients are given by" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\mathbf{A}\\mathbf{x} = \\sum^{n}_{i=1} \\alpha_i \\mathbf{A} \\mathbf{p}_i = \\mathbf{b}.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Multiplying with $\\boldsymbol{p}_k^T$ from the left gives" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{p}_k^T \\boldsymbol{A}\\boldsymbol{x} = \\sum^{n}_{i=1} \\alpha_i\\boldsymbol{p}_k^T \\boldsymbol{A}\\boldsymbol{p}_i= \\boldsymbol{p}_k^T \\boldsymbol{b},\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "and we can define the coefficients $\\alpha_k$ as" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\alpha_k = \\frac{\\boldsymbol{p}_k^T \\boldsymbol{b}}{\\boldsymbol{p}_k^T \\boldsymbol{A} \\boldsymbol{p}_k}\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Conjugate gradient method and iterations\n", "\n", "If we choose the conjugate vectors $\\boldsymbol{p}_k$ carefully, \n", "then we may not need all of them to obtain a good approximation to the solution \n", "$\\boldsymbol{x}$. \n", "We want to regard the conjugate gradient method as an iterative method. \n", "This will us to solve systems where $n$ is so large that the direct \n", "method would take too much time.\n", "\n", "We denote the initial guess for $\\boldsymbol{x}$ as $\\boldsymbol{x}_0$. \n", "We can assume without loss of generality that" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{x}_0=0,\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "or consider the system" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{A}\\boldsymbol{z} = \\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_0,\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "instead.\n", "\n", "\n", "\n", "\n", "## Conjugate gradient method\n", "One can show that the solution $\\boldsymbol{x}$ is also the unique minimizer of the quadratic form" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "f(\\boldsymbol{x}) = \\frac{1}{2}\\boldsymbol{x}^T\\boldsymbol{A}\\boldsymbol{x} - \\boldsymbol{x}^T \\boldsymbol{x} , \\quad \\boldsymbol{x}\\in\\mathbf{R}^n.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "This suggests taking the first basis vector $\\boldsymbol{p}_1$ \n", "to be the gradient of $f$ at $\\boldsymbol{x}=\\boldsymbol{x}_0$, \n", "which equals" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{A}\\boldsymbol{x}_0-\\boldsymbol{b},\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "and \n", "$\\boldsymbol{x}_0=0$ it is equal $-\\boldsymbol{b}$.\n", "The other vectors in the basis will be conjugate to the gradient, \n", "hence the name conjugate gradient method.\n", "\n", "\n", "\n", "\n", "## Conjugate gradient method\n", "Let $\\boldsymbol{r}_k$ be the residual at the $k$-th step:" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{r}_k=\\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_k.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Note that $\\boldsymbol{r}_k$ is the negative gradient of $f$ at \n", "$\\boldsymbol{x}=\\boldsymbol{x}_k$, \n", "so the gradient descent method would be to move in the direction $\\boldsymbol{r}_k$. \n", "Here, we insist that the directions $\\boldsymbol{p}_k$ are conjugate to each other, \n", "so we take the direction closest to the gradient $\\boldsymbol{r}_k$ \n", "under the conjugacy constraint. \n", "This gives the following expression" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{p}_{k+1}=\\boldsymbol{r}_k-\\frac{\\boldsymbol{p}_k^T \\boldsymbol{A}\\boldsymbol{r}_k}{\\boldsymbol{p}_k^T\\boldsymbol{A}\\boldsymbol{p}_k} \\boldsymbol{p}_k.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Conjugate gradient method\n", "We can also compute the residual iteratively as" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{r}_{k+1}=\\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_{k+1},\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "which equals" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{b}-\\boldsymbol{A}(\\boldsymbol{x}_k+\\alpha_k\\boldsymbol{p}_k),\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "or" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "(\\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_k)-\\alpha_k\\boldsymbol{A}\\boldsymbol{p}_k,\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "which gives" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{r}_{k+1}=\\boldsymbol{r}_k-\\boldsymbol{A}\\boldsymbol{p}_{k},\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "\n", "## Revisiting our first homework\n", "\n", "We will use linear regression as a case study for the gradient descent\n", "methods. Linear regression is a great test case for the gradient\n", "descent methods discussed in the lectures since it has several\n", "desirable properties such as:\n", "\n", "1. An analytical solution (recall homework set 1).\n", "\n", "2. The gradient can be computed analytically.\n", "\n", "3. The cost function is convex which guarantees that gradient descent converges for small enough learning rates\n", "\n", "We revisit an example similar to what we had in the first homework set. We had a function of the type" ] }, { "cell_type": "code", "execution_count": 6, "metadata": {}, "outputs": [], "source": [ "x = 2*np.random.rand(m,1)\n", "y = 4+3*x+np.random.randn(m,1)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "with $x_i \\in [0,1] $ is chosen randomly using a uniform distribution. Additionally we have a stochastic noise chosen according to a normal distribution $\\cal {N}(0,1)$. \n", "The linear regression model is given by" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "h_\\beta(x) = \\boldsymbol{y} = \\beta_0 + \\beta_1 x,\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "such that" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{y}_i = \\beta_0 + \\beta_1 x_i.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "\n", "## Gradient descent example\n", "\n", "Let $\\mathbf{y} = (y_1,\\cdots,y_n)^T$, $\\mathbf{\\boldsymbol{y}} = (\\boldsymbol{y}_1,\\cdots,\\boldsymbol{y}_n)^T$ and $\\beta = (\\beta_0, \\beta_1)^T$\n", "\n", "It is convenient to write $\\mathbf{\\boldsymbol{y}} = X\\beta$ where $X \\in \\mathbb{R}^{100 \\times 2} $ is the design matrix given by (we keep the intercept here)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "X \\equiv \\begin{bmatrix}\n", "1 & x_1 \\\\\n", "\\vdots & \\vdots \\\\\n", "1 & x_{100} & \\\\\n", "\\end{bmatrix}.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The cost/loss/risk function is given by (" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "C(\\beta) = \\frac{1}{n}||X\\beta-\\mathbf{y}||_{2}^{2} = \\frac{1}{n}\\sum_{i=1}^{100}\\left[ (\\beta_0 + \\beta_1 x_i)^2 - 2 y_i (\\beta_0 + \\beta_1 x_i) + y_i^2\\right]\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "and we want to find $\\beta$ such that $C(\\beta)$ is minimized.\n", "\n", "## The derivative of the cost/loss function\n", "\n", "Computing $\\partial C(\\beta) / \\partial \\beta_0$ and $\\partial C(\\beta) / \\partial \\beta_1$ we can show that the gradient can be written as" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\nabla_{\\beta} C(\\beta) = \\frac{2}{n}\\begin{bmatrix} \\sum_{i=1}^{100} \\left(\\beta_0+\\beta_1x_i-y_i\\right) \\\\\n", "\\sum_{i=1}^{100}\\left( x_i (\\beta_0+\\beta_1x_i)-y_ix_i\\right) \\\\\n", "\\end{bmatrix} = \\frac{2}{n}X^T(X\\beta - \\mathbf{y}),\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "where $X$ is the design matrix defined above.\n", "\n", "## The Hessian matrix\n", "The Hessian matrix of $C(\\beta)$ is given by" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\boldsymbol{H} \\equiv \\begin{bmatrix}\n", "\\frac{\\partial^2 C(\\beta)}{\\partial \\beta_0^2} & \\frac{\\partial^2 C(\\beta)}{\\partial \\beta_0 \\partial \\beta_1} \\\\\n", "\\frac{\\partial^2 C(\\beta)}{\\partial \\beta_0 \\partial \\beta_1} & \\frac{\\partial^2 C(\\beta)}{\\partial \\beta_1^2} & \\\\\n", "\\end{bmatrix} = \\frac{2}{n}X^T X.\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "This result implies that $C(\\beta)$ is a convex function since the matrix $X^T X$ always is positive semi-definite.\n", "\n", "\n", "\n", "\n", "## Simple program\n", "\n", "We can now write a program that minimizes $C(\\beta)$ using the gradient descent method with a constant learning rate $\\gamma$ according to" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "$$\n", "\\beta_{k+1} = \\beta_k - \\gamma \\nabla_\\beta C(\\beta_k), \\ k=0,1,\\cdots\n", "$$" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We can use the expression we computed for the gradient and let use a\n", "$\\beta_0$ be chosen randomly and let $\\gamma = 0.001$. Stop iterating\n", "when $||\\nabla_\\beta C(\\beta_k) || \\leq \\epsilon = 10^{-8}$. **Note that the code below does not include the latter stop criterion**.\n", "\n", "And finally we can compare our solution for $\\beta$ with the analytic result given by \n", "$\\beta= (X^TX)^{-1} X^T \\mathbf{y}$.\n", "\n", "## Gradient Descent Example\n", "\n", "Here our simple example" ] }, { "cell_type": "code", "execution_count": 1, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "[0.32017409 4.33901633]\n", "[[4.35923237]\n", " [2.73841882]]\n", "[[4.35923237]\n", " [2.73841882]]\n" ] }, { "data": { "image/png": "iVBORw0KGgoAAAANSUhEUgAAAYwAAAEWCAYAAAB1xKBvAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4yLjEsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy+j8jraAAAgAElEQVR4nO3deXwV9b3/8dcnCQECuAUEXBLErXVfqEsFi9VWaxe7V4tae73yq7a1i62t9dZqK73dq3fxetFarKRaq9XW6m319gYIKCIouAFurILsKEvYks/vj5nA4XCWSTLnzDkn7+fjcR7JObN9zmQyn5nvNubuiIiI5FOVdAAiIlIelDBERCQSJQwREYlECUNERCJRwhARkUiUMEREJBIlDCk6M1toZueEv3/PzO5MKI7RZrY0iW33FKl/ayl/ShiyGzO70MyeNrNNZrYy/P0qM7NCbM/df+zu/9zd9ZjZMDNzM6uJI66kmdkEM7s56ThEUilhyE5mdg1wK/BzYAgwGPgScAZQm2WZ6qIFKCKJUsIQAMxsb+CHwFXu/oC7b/DAc+4+xt23hvNNMLP/MrPHzGwTcJaZfdjMnjOzd8xsiZndmLbuS8xskZmtMbPr06bdaGYTU96fZmZPmtl6M5tjZqNTpk0ysx+Z2TQz22Bmj5vZwHDylPDnejPbaGanZ/iOfcP415nZy8B70qYfYGYPmtkqM1tgZlenTDvFzGaG33GFmf0qZdrIlJiXmNll4ee9zewXZrY4XOZ2M+sbThttZkvN7JrwTm65mX0xnDYWGANcG36XR7L8zd5lZk+Y2Vozm29mnw0/PzT87KSU77W6Y1+a2RfNbG64D98ws/+Xss6OuK5NievjZna+mb0Srvd7aX+/B8zsD+H6njWz47PEW2Vm3zWz18Nj4X4z2y/TvFKi3F0vvQDOA3YANXnmmwC8TXDXUQX0AUYDx4bvjwNWAB8P5z8K2AicCfQGfhVu55xw+o3AxPD3A4E1wPnhuj4Qvh8UTp8EvA4cAfQN3/8knDYM8FzxAz8BWoD9gIOBF4Gl4bQqYBZwA8Hd1HDgDeDccPpTwCXh7/2B08LfG4ANwEVAL6AeOCGcdgvwl3B7A4BHgH8Np40O98MPw+XOBzYD+6bs55tzfJd+wBLgi0ANcBKwGjg6nH4FMBeoA/4O/CJl2Q8DhwIGvC/c7klpcd0QxnUFsAr4ffgdjga2AMNT/n7bgU+H838LWAD0CqcvTPlbfx2YDhxEcCz8N3Bv0se+Xp04TyQdgF6l8QIuBt5K++xJYD3QCpwZfjYB+F2edd0C/Dr8/QbgvpRp/YBtZE4Y3wHuSVvX34EvhL9PAv4lZdpVwN/C34eRP2G8AZyX8n4suxLGqcDitPmvA34b/j4FuAkYmGGehzJsy4BNwKEpn50OLAh/Hx3u15qU6SvZlYgmkDthfA5oSfvsv4EfpLz/C/AC8DzQO8e6Hga+lhZXdfh+QLhfT02Zfxa7LghuBKanTKsClgOjwvepCWMucHbKvEMJkk3OixS9SudVERWEEos1wEAzq3H3HQDu/l6AsCVRavHlktQFzexUgqv3YwiuznsDfwwnH5A6v7tvMrM1WWJoBD5jZh9N+awX0Jzy/q2U3zcTXO1HtVsswKK0bR9gZutTPqsmuCMBuJzgbmCemS0AbnL3vxLcqbyeYVuDCK7uZ6W0F7BwnR3WdOzrLnyfRuDUtHhrgHtS3t9BkDTGelikCGBmHwJ+QHCnVhXG+UJaXG3h763hzxUp01vT4kz9+7aHx8sBWWJ+yMzaUz5rI6grezPL95QSooQhHZ4CtgIXAA/mmTd9iOPfA/8BfMjdt5jZLUBH3cJy4N0dM5pZHUGxTSZLCO4wruhk7JliymQ5wQn+pfB9Q9q2F7j74RlX7v4qcJGZVQGfBB4ws/pwuVMyLLKa4MR6tLt35WSY7/ssASa7+wcyTTSz/gR3er8BbjSzB919rZn1Jvj7Xgr82d23m9nDBMmsqw5O2W4VQZHTsiwx/5O7T+vGtiRBqvQWANx9PUGRy21m9mkz6x9WUp5AUIyUywBgbZgsTgE+nzLtAeAjYcVwLcFVerbjbiLwUTM718yqzaxPWAl7UISvsApoJ6h7yOZ+4Doz2zdc51dTps0A3jGz74SV49VmdoyZvQfAzC42s0Hu3k5QTAfB1XETcI6ZfdbMasys3sxOCOe7A/i1me0fruNAMzs3wneB4Io+13f5K3CEBQ0KeoWv95hZR3K+FZjlQZPlR4Hbw8877gBXATvCu40PRowpm5PN7JMWNGn+OsGFx/QM890OjDOzRgAzG2RmF3Rz21JEShiyk7v/DPgmcC1BefoKgnLx7xDUZ2RzFfBDM9tAUGdxf8o6XwK+THAXshxYB2TsLOfuSwjucL5HcEJbAnybCMepu28GxgHTwtZKp2WY7SaCYqgFwOOkFN+ERTAfBU4Ip68G7gT2Dmc5D3jJzDYSnIwvdPct7r6YoML6GmAtMBvoaCX0HeA1YLqZvQP8L3Bkvu8S+g1wVPhdHs7wfTcQnOgvJLiafwv4KdA7PAmfR9AkGoK/6UlmNiZc7mqCv9E6guT+l4gxZfNngjqVdcAlwCfdfXuG+W4Nt/V4eKxMJ6g7kjJh7nqAkoh0jQVNqA9z94uTjkUKT3cYIiISiRKGiIhEoiIpERGJRHcYIiISSVn1wxg4cKAPGzYs6TBERMrKrFmzVrv7oO6up6wSxrBhw5g5c2bSYYiIlBUzW5R/rvxUJCUiIpEoYYiISCRKGCIiEokShoiIRKKEISIikShhiIhIJEoYIiISiRKGiIhEooQhIiKRKGGIiEgkBU8YZnaXma00sxczTPuWmbmZDcy0rIiIlI5i3GFMIHhc5G7M7GDgA8DiIsQgIiLdVPCE4e5TCJ51nO7XBM+O1gM5RETKQCJ1GGb2MeBNd58TYd6xZjbTzGauWrWqCNGJiEgmRU8YZlYHXA/cEGV+dx/v7iPcfcSgQd0ezl1ERLooiTuMQ4FDgDlmthA4CHjWzIYkEIuIiERU9AcoufsLwP4d78OkMcLdVxc7FhERia4YzWrvBZ4CjjSzpWZ2eaG3KSIi8Sv4HYa7X5Rn+rBCxyAiIt2nnt4iIhKJEoaIiESihCEiIpEoYYiISCRKGCIiEokShoiIRKKEISIikShhiIhIJEoYIiISiRKGiIhEooQhIiKRKGGIiEgkShgiIhKJEoaIiESihCEiIpEoYYiISCRKGCIiEokShoiIRKKEISIikShhiIhIJAVPGGZ2l5mtNLMXUz77uZnNM7PnzewhM9un0HGIiEj3FOMOYwJwXtpnTwDHuPtxwCvAdUWIQ0REuqHgCcPdpwBr0z573N13hG+nAwcVOg4REemeUqjD+Cfgf7JNNLOxZjbTzGauWrWqiGGJiEiqRBOGmV0P7ACass3j7uPdfYS7jxg0aFDxghMRkd3UJLVhM/sC8BHgbHf3pOIQEZFoErnDMLPzgO8AH3P3zUnEICKSV1MTDBsGVVXBz6ashSHFWU/CCn6HYWb3AqOBgWa2FPgBQauo3sATZgYw3d2/VOhYREQia2qCsWNhc3hNu2hR8B5gzJjir6cEWDmVBo0YMcJnzpyZdBgi0hMMGxac3NM1NsLChcVfTzeY2Sx3H9Hd9ZRCKykRkdKzeHHnPi/0ekqAEoaISCYNDZ37vNDrKQFKGCIimYwbB3V1u39WVxd8nsR6SoAShohIJmPGwPjxQV2DWfBz/PjOV1THtZ4SoEpvEZEKp0pvEREpKiUMEcmvQjqeSfckNjSIiJSJCup4Jt2jOwwRye3663cliw6bNwefS4+ihCEiuVVQxzPpHiUMEcmtgjqeSfcoYYhIbhXU8Uy6RwlDRHKroI5nRVdhrcvUSkpE8hszRgmisyqwdZnuMERECqECW5cpYYiIFEIFti5TwhCR0lTu5f8V2LpMCUNESk9H+f+iReC+q/y/nJJGBbYuU8IQkdJTCeX/Fdi6TMObi0jpqaoK7izSmUF7e/HjKXNlM7y5md1lZivN7MWUz/YzsyfM7NXw576FjkNEykgFlv9XgmIUSU0Azkv77LvAP9z9cOAf4XsRkUAFlv9XgoInDHefAqxN+/gC4O7w97uBjxc6DhEpI6VU/h9Xa61yb/VFkeowzGwY8Fd3PyZ8v97d90mZvs7dMxZLmdlYYCxAQ0PDyYsWLSp4vCIiwJ69tSG40+ls8sq1Hggq8xcvDorcxo2LPTHGVYdR8gkjlSq9RaSohg0LmvSma2yEhQu7v576emht7X5CymDTyk1Mv3s+Ux97hxsnnVUeld5ZrDCzoQDhz5UJxSEiSSvlopq4emtnm3/NmtiaD6+ev4aHr3uaa0ZM4pT+L7H34N6cc+1J3DTpzE6vK5ukBh/8C/AF4Cfhzz8nFIeIJKnUB+hraMh8Z9DZ1lrZ1pNNnoTk7c7CqUuZ+vtFtExup+WNA5m37VCgnt5s4ZS95nPt6VMZdV4/3nvZEezT2Llws2/YvaAv4F5gObAdWApcDtQTtI56Nfy5X5R1nXzyyS4iFaSx0T3ocbH7q7GxsNudODHYhlnwc+LE7PPV1e0eW11d9vlzbS/TeurrI33/tu1tPueP8/0/PzfJL2yY5gdWLds5696s9/MHzfB/PbfZW/5zjreua91j88BMj+N8HsdKivVSwhApQ7lOzmaZT5hmhY2nM0kganKJst309WSJZdsdE3zqbXP8X89t9g/v/7TvY+t2Tj6gapl/7uBp/h+fmeRz/jjfd2zdkXfTShgiUvrynZyTuMNI6q4mm4kTve3Ag70d87W9B/tNfX7svWl1cL+Iib6UA7wd8w39B/uKf7nV29vaO72JuBKGxpISkcLJNyZUoTvoZapQL4Fhx5fPXsEfv/kUVx8/mROvOJleby6ginYGbV3KX6s/xlUnTWfGR26iqc8VHMgyDKf/xhXs/6vrsHt/X7Q402ksKREpnChjQl11VdCMtK0NqquDSu/bbuv+trP1fejbN2idlK6zTWUj8nbn1ScWMvW+pbRMhZaFDby+I6iFrmMTp+07n1HHvcPI8/fitEuPoP+Q/sGCcTXpJb5+GHpEq4gUTr5WRk1NcPfdQbKA4Ofdd8MZZ3S/lVS2u5u+fYPEkZ5Ist3VNDV1qmPdji07mPPAq7Q8uJKpz9Qy6M3ZfIefchmL+QAHcv9e/wxnvo9RnxzEiZ87gl51J2VeUbZWVUl2Xo6jXKtYL9VhiJSZJOswclWoR63IvvLKPdeTVkG+ec1mb/71c/7D9zf7B+uf8f68s3PWq+1W32K9cy6fVXV15virqzu9K1Clt0gJi6tlTSVIqpVUd5PRxIlZ49u09xD/9nua/bT+z3svtgYh0+bH9pnvVx0zyX//lWm+ZMay7sWQabmOVycpYYiUqrja7ndme+WanAp5hxHh7qBLsYG3Yd6Lrf7eAXP8O6c2+yPff9rXvrFuz3V0JyHGuG+UMERKVTGbbRY7OcWtUPFnWq9ZkERyaNve5i8+/Kr/10WTvZ0sJ3vw1n2H+uY1m/PH0Z1jIcZ9o4QhUqqK2Rmt1PoUdEUh7pCy7Zfq6t3Wv3XDVn/qjhf8Z+c3+0cHT/f9bM3OWRdzUPa/Y9QYu3vSj2nfxJUw1KxWJG4xNofMS48yzSzbfgHaevXhT8Ov4bYVn+Lp9UfSStAP5PBeCxg1bCkjR8KoMQ0cunwq9v/SmuWawZe+FL3Zb1MTfO1ru5rx1tfDrbcWfZwsNasVKVXjxmVu/1+Ip8XFNThepckx2F/19i2cMv8eftJ3DGNPeIaR769l5BcOZchxhwCHpMzZCEbXn1WRqR9Ia2tXv1FpiOM2pVgvFUlJ2ShWRXS512HEqL2t3V/7x0L/7eUtPn7I930zfTMXKYG3pxYPFupvVULFhcRUJKU7DJFCGDOmOMUOHdso8BPbSlHbtjZeeOg1Wv74Fi1P1zJ12SEsb28EGtnXjubtATV8c8NNVLFn0Zyldhws1PDqJTAESdxUh5GETvYcFRHYsn4Lz0ycT8tf1tHyXD+eXH0E77A3AAdXv8mogxYy8vQ2Rn12KEd99FCqaqryP2K1kPVNxazLykN1GOWq1B8YI1Ii1i96m2m/fYWpf99Ey0v78cyGI9nG8QAc1fs1Lnr3HEa+r5pRFzfSeMZBwIF7rmTMGJg2bfexqr7whV3/a4W8CyhmXVaxxFGuVaxXRdRhlFC5pkgpWfrMMr/3q9P8y8dO8uP6zHOjzcG9hm1+ar8X/Fsjmv3P35vuq+atjr7SpIYm6agX6WjK27HO9PqRItV1oX4YZSqJB8aIlJj2tnaf++jrPv6SyX7J8BY/pGbRzn+Ffmzwc/ab6Ted1ez/98tnfdOqTV3fUL6EUIhGA1HXWcQGC3ElDNVhFFsJlWuKFMv2zduZ/cdXafnTSpg8mc+8fScH8iaLaeAnfJdVB5zAyPdsYdQn9+eEzx5BTZ+YSsuj9FOJu04x6v94Ec8FcdVhJH7X0JlXRdxhqBmklLL0IpIrr+xSkcnGFRv9f382y28c3exn7zvL+7HBIXiC3Ka05q7t2a6+4yiqSaIIOGopQhFLG1CRVBkr58HipHJluphJf6Wf3MNjud3MN+01xCcOu95P6feC17AtOPfR5sf3medfOXaS/+Hr03z7kCzDbaSewDPF0auXe3195/9nkrhAi5qkipjMKiJhAN8AXgJeBO4F+uSav2IShkgpyjE66253BA0NvqBliU95//f3eNbDRur8pj4/9utOb/bHbprh6xet330bUa6qo8SRwHhMkVVwHUaSyeJAYAHQN3x/P3BZrmWUMEQKKNvJPO3Vhjm4L6Ax8zy5rpCjXFVHjKOkWxZGTVJl1kqqqtuVIN1TA/Q1sxqgDliWcDwiPVfE8afWVO/Pf3xmMo3WhT4M48YFfRFSpfdNiDoOVin3mB4zJqi4bm8PfmarRI86X4lILGG4+5vAL4DFwHLgbXd/PH0+MxtrZjPNbOaqVauKHaZIxXtn6Tv87eaZ3F97MVvos9u09PZFXlfHoLt/yZfvf9+u4TXS5TrhjxkTdKJrbAxaKjU27up13SFTUunsdqQw4rhN6coL2Bf4P2AQ0At4GLg41zIqkhLpvuVzVvj933jSv3rcJD+x78texQ4H92q2+/W9fupreg32dsx3DD1o91ZS9fW7VzxfeWXhyuBTi2rq691ra/cskqqv79y2enBjEyqgDuMzwG9S3l8K3JZrGSUMkc5pb2v3Vx5f4L+5bIpfdtgUP7Rm4a5zOxv9/fvO8hvObPYnfjrLNyzfkH1F2Spou9jsttMmTgwSRKbK8o76jFzb7uHN2eNKGIl13DOzU4G7gPcArcCE8Ev9e7ZlKqLjnlSeEhpMcseWHcx54FWm/mklLTNqmbr8UFa07w9Ava1h5ODXGDWilZEfH8hJFx1Jr7pe0VZcCh1Os8XQIXVQwajL9pAOs3F13Eu0p7eZ3QR8DtgBPAf8s7tvzTa/EoYkLj05nH8+3H139tFQC6x1bStP/24+LY+sZ+qc/jy55kg2MgCAxuqljGpYyKj3tjPyswfwrvOHByO4dkUpPNkvx1P0dsqWAEoh/gRVRMLoLCUMSVSmobLNMp+ICnTluvb1dUyb8Cotf99My9x6Zm08ku3UAnBM71cZddhyRp1Vw8iLh3HwqQfEt+Ekr9A7knSuu4sO2RKA7jCKMzQI8L/A8XGUf3X3pToMiSS9wrQrPYQzidixbY+OaN2w6Mml3nTVVP/SUZP96N6v7Fx9L7b6ewfM8WtPafZHvv+0r31jXSzby6qQdQC5KqOj9D6P0jdDdRjFqfQGTiJozfRbYGgcG+3qSwlD8sp3gunOSSJqh7KoncrSTpRtv7vHX3z4Vb/985N9zLCp3lC9ZOfqBvC2n1v/jN98TrNPuuU537xmc9e+Q5ZtR9onhWhl1NXhx1MrvKP+bdVKqvAJY+eM8ClgDvADwt7ZxX4pYUheUe4CutpDuDN3GFdemXtdEyd6e9/dT5Sb6OsXMdHBfXDVCv/0gU/6rZ+c5LMmvuzbW7d3LeYs2y6Zq+18Pb9zJYsenAA6K66EEakOw8wMOBoYCdwMbAGuc/d7ul0m1gmqw5C8olSMdrWis5t1GBvf2shTE+bT8tgGrpr6eYb48j0W29hvMG/9+WkOPasBq7LOxxhFKZXn56qMvuceuOSSotYRVaq46jDyNpkws6nAm8CvCcZ/ugwYDZxiZuO7G4BIrKL0/u1qD+FMvZSzJafFi1n50ir+dO10vnHSZEb0e5l9hvbhg9edzLiWUezvb2VcrP/mlRx2dmPhkkUYW6c+T9XUFCScqqrgZ1NT92LJ1Vv8+uuzJ5OuPOY07th7ony3IMAxhK2pMkybG8dtTtSXiqQkr0LWYWSSpUhlKQfsfNuHzf6+vZ/zfxnZ7H+7+Rl/e8nbyT6qt6vbLvbT6XLVGcW5nR6AUujpDQyPI4ioLyUMiVRuXahWUinrbjfzrQMP8NmHXOCtaUN8b6Kv/3zATf7TDzX7tNuf9y1vb8m8nqROYF3ddqGff53+N4pze0km6BJQEgmj2K8emzAqsXKvq610EjrJtq5r9bmX/ti3Vu35/IffcqmvrA7GX9o66ABv+9090Vaa5N+1K9su9vPo4/x7Fzv2EqOE0VNU4q10qV3hZrBu4Xp/9MYZ/t3Tmv2MAXO8li1de/5DJUniKr2cH9VaQpQwylln/gmSPNALdQXc1e9UwKvEpc8s8/uunuZfPnaSH9dnnhttDu41bPNT+73g3xrR7O307KvUsr54KefYY6CEUa46e+AmdStdyH+wrn6nmJJne1u7z330dR9/yWS/dHiLH1KzaOeq+rHBz9lvpt90VrP/4xfP+sYVG2Pffk6lXvzYER+4V1fv+v6lFmcmpb5vC0gJo1x19qST1B1GpqGko2w3yj9lV75TtuGtIySx7a3bfcaEl/yXH2v2jw99ygfaqp2LD7KV/omhT/mvLmj2Z+5+KXcHuUJfpZbLVXC5xCk7KWGUq85eXSfxzzlxYuYY890FRI21s98pW1PZ/v0ztoDauGKj/+MXz/qNo5v97H1neT827FxkeM1Cv3R4i99x6RSf99jr3t7W3vl9U6ir1HIpZy+XOGUnJYxyle2frb4+9wBsxbyVzjUERq6TQmdOJHHU46Ql363W2/+l9idew7ZgMm1+fJ95/pVjJ/l9V0/zpc8s68ZOKYJyaclTLnHKTkoY5SrT1XJtrXuvXrt/lu+Ku5AJJFeHqVzbKtSJpBOD/i23oX7d6c3+2E0zfN3C9d3bbrGVy5V7ucQpOylhlLP0E35n6guKUUSV6y6oK8t19kSSsn/aGxp8+4B9IieMsr7KTbozX9SLENVhlB0ljErSmSvzYrXU6coJIYYTybY7JviO2j67raOVXr6F2t0+a+9KkVk5SKIlT1f+bj24xVE5UsJIUtz/LJ1JAlGSSxzxdXUdnVzu7SVv+99ufsavP6PZz9z7OV/IwRm/3/a99vH2hoZd673ySl3lxkVFTBVPCSMpxR6ALV2+CukSP5Eun7PC7//Gk3718ZP8xL4vexU7HNyr2e4j6l7qXOe4uBN3T71qViV2xVPCSEqxB2DLNF+u0Viz/fMncLXY3tburzy+wH9z2RT/4uFT/LBeC3aG05dNftY+z/oNZzb7Ez+d5RuWbwi+W0dnsGLH35PL5XWHUfEqImEA+wAPAPOAucDpueYviYRRCldjqb1to76KEN+OrTt81sSX/ZZPTPJPHfikD65asXPz9bbaLxgy3X/+4WaffucLvm3Ttj2/U7ZEWIwTd08+afbkZNlDxJUwIj1xr1DM7G6gxd3vNLNaoM7d12ebvySeuFcOTyvLpADxta5tZcY982l5ZD0ts/vz1Joj2MBeweaqlzKqYSEjT29n1OcO4F3nD6eqJsfzurLt1+pquPvu4OFFhZTryW9deTpfuWlqCh5YtHhx8PCiceMKv8+laOJ64l5iCcPM9iJ4RvhwjxhESSSMTI/prKsLnsRW7H+wbCfZ9MeGxhTf2tfXMW3Cq0x9fDMtL9czc+ORbKcWgGN6v8qow5Yz6qwaRl48jINPPSD3ytJPUJm+R8d3KcYJu5QuBERiFlfCSLI46gRgBjABeA64E+iXYb6xwExgZkNDQ0w3aN1UKpWj2YoSrrwyll7ji6e/6U1XTfUvHTXZj+n9ys5N9GKrn97/eb/2lGZ/5PtP+5rX1nY/7qTrXrJ1qIzz4UsiCaHc6zCAEcAO4NTw/a3Aj3ItUxJ1GKUmpg5Xbdvb/KU/v+q3f36yjxk21Rurl+ycZQBv+7n1z/iPzm72Sbc855vXbO5ezBGH+ih6OXrqvqyv71zve5ESVgkJYwiwMOX9KODRXMucXFurq73uyHKiXlE1xOtttYP7RUz0xRzkbZi/3Xewv3Hlz3KP4NoVuYb6KIU7N/eeXQkuFSeuhJGjFrKw3P0tYImZHRl+dDbwcs6Ftm0L/m0XLQrqEa66Kih7rqoKfjY1xRtkU1Nh119EG9/aiC9anHHawPYVfOywl2k+8wYm9r6Cg1lKFc5erSs45O4bqXnwD/EG09CQ+fOO+oL29uBnkpWuizPvq6yfi/QEcWSdrr4I6jFmAs8DDwP75pr/5GIWYZR6U8M8RVErXlzpD377Kf/6iZN8RN1LXs32/I8YLdRos5mWLcS+jbNuSXcYUkEo9yKprrz2SBiF/Icu5RNGhhNuW+++Pnn09/3yI6b4Eb3e2DmpN61+5t7P+fVnNPvsT//Q2/v2zX6ijtrHJI4TfiF6aceZhEr9gkGkE5Qwsr3i6qBWCh30smhvaMgY2wIafR9b5x/Z/2n/yXnNPu32533L21t2XzjXiTpqkkwqmcYRe1zbEykjShiFboZZQncYretafcq/z/Yff7DZPzRohrdlGW+p3czbtrdlX1G+E2DUq+okkmm+2Eo4wYskrWcmjNRWUoUeZC/BIol1C9f7ozfO8O+e1uwj95rttWzZGcK7a1/z1TWDO5/MonyfiRN3fzZHfX3nBkAsZDLNt80SSvAipaZnJoz0fhjp7ebj7mRVpCKJN2ct9/uunuZfPnaSH99nnhttDu41bPNT+73g15zc7A9fN91XzfZJ+TAAAAxgSURBVFu9K67OJrN8J9TOrDOJZJrvDkJ1DiJZKWGkKqOTRXtbu8999HW/49IpfunwFj+kZtHOkPuxwc/Zb6Y/8O7rffM+Q709V6LqbDLLd8Lt7BV6scv3o8SnOgeRjOJKGIkOPthZWceSKuFxgHZs2cFzf3iFqQ+tpGVGH6a+dSirfBAAg2wVI4e8zqhTtjDyE/tzwmcOp9dD9xdmrKp8+6jUB98rpTG8RMpM2Y8l1ZVX1juMEqrw3LRqk//jF8/6jaOb/Zz9Zno/NuwMZ3jNQr90eIvfcekUn/fY697e1r7nCnI9T7s7V8/57sLKoQ5AdxAiXYKKpFIkeLJb/coaf/i66X7Nyc1+ar8XvIZtQa6izY/vM8+/fOwkv+/qab70mWXRVphr2IzuFrnlOuF2t1hPJ3ORkqWEkapIdRjtbe2+oGWJ3/OlqT72XZP93bWv7dxcLVt85F6z/brTm/3RG2f4uoXru7aRzjwYKe6E2J3neJdJHZJIT6SEka4AV7ht29v8+Qfm+20XTvaLGqf6QdVv7jwf7sV6/9CgGf7jDzb7lH+f7a3rWru9PXfP/wjWuIvc4thv5VCcJdKDxZUwKqPSu6vSHuKz44abmLH9JFoeXsPUZ+uYtupw1vm+AAyteotRB77BqFO3M+ozQzjm44dRXVsdXyw54mLjRlizZs/5ulupH1dFcqlXmIv0cKr07q6JE/cYV2kjff0iJjq4H1n7uo8f8n3f0H+wt5sFw3GU2oOSuhtPXHcGusMQKWmU+/DmSXjr+ZU8cM1TfO2EySy75NtYa+tu0/vRyh17fYsVL65i3l1PccU7v6T/xhWYO7Z4cXA1nsQQ52PGBFf9jY3BVXtjYzzNSeMawnvcuODOJFVdXfC5iFSMii2S8nbntX8sYuq9S9j22BN8ZMVdDGUZi2ngRn7AXVxOFTmKUUq4b0ds4vyO6cVo48apf4RIiYirSKpiEkbbtjbm/PEVWh5cydQZtUxdPpy32gdzEU3cyRXUsetuwvvWYXV9c9cL9IRyeXWGE+kR4koYNXEEk4TWta3MuGc+LY+sp2V2fw5cM5sbuJmvsphPcQB/Hng5NR88my8+cS21q3YverLWzVDXNzg5pp8sO4pRGhoyX31ne1pcOepICrozEJEo4qgIKdbrsKHv8mtPafbT+z/vvdi6s2712upf+BbrnblSOFcv8EJ2ZBMRKRH0xGa1ZiO8F08yov98Rh21hpEfrOOMyw5nv7NPzF4WD10vp1e5vIhUgB5Zh3HkwUf5c8/NpG5gWoucXPUN99yjcnoR6dHiShhl1ax2wOC6IFk0NQUtfKqqgp/77Zd5gYaG7E1SYfd1JNFcVkSkjCSeMMys2syeM7O/Rlqgo2XPokXBXcWiRfDOO1Bbu/t8qRXYY8YExU/t7buKodLXkVQfCxGRMpF4wgC+BsyNPPf11+9evASwfTsMGBC9Y1umdWzeHHzek6XfuSmBikiKRJvVmtlBwIeBccA3Iy2UrRfy2rWwenW0DcfVw7mSpPfJ6LjrAtX1iAiQ/B3GLcC1QNaecGY21sxmmtnMVatWZe8H0Zn+EXGso9LorktE8kgsYZjZR4CV7j4r13zuPt7dR7j7iEGDBsUzbpHGPtqT7rpEJI8k7zDOAD5mZguB+4D3m9nEvEvFMRBfoQbzK2e66xKRPEqiH4aZjQa+5e4fyTVf7M/DkF00rpRIxeqR/TCkgHTXJSJ5lMQdRlS6wxAR6TzdYYiISFFVdsLoiR3ReuJ3FpGiKNvnYeTVEzui9cTvLCJFU7l1GD3hEavpeuJ3FpG8VIeRT0/siNYTv7OIFE3lJoye2BGtJ35nESmayk0YPXH4j574nUWkaCo3YfTEjmg98TuLSNFUbqV33PR8bxEpU3FVeldus9o4qbmqiEgFF0nFSc+KEBFRwohEzVVFRJQwIlFzVRERJYxI1FxVREQJIxI1VxURUSupyMaMUYIQkR5NdxgiIhKJEoaIiESihCEiIpEoYYiISCSJJQwzO9jMms1srpm9ZGZfSyoWERHJL8k7jB3ANe7+buA04MtmdlQikeg52CIieSXWrNbdlwPLw983mNlc4EDg5aIGooEFRUQiKYk6DDMbBpwIPJ1h2lgzm2lmM1etWhX/xjWwoIhIJIknDDPrDzwIfN3d30mf7u7j3X2Eu48YNGhQ/AFoYEERkUgSTRhm1osgWTS5+58SCUIDC4qIRJJkKykDfgPMdfdfJRWHBhYUEYkmyTuMM4BLgPeb2ezwdX7Ro9DAgiIikeiZ3iIiFS6uZ3onXuktIiLlQQlDREQiUcIQEZFIlDBERCQSJQwREYlECUNERCJRwhARkUiUMEREJBIlDBERiUQJQ0REIlHCEBGRSJQwREQkEiUMERGJRAlDREQiUcIQEZFIlDBERCQSJQwREYlECUNERCJRwhARkUiUMEREJJJEE4aZnWdm883sNTP7bpKxiIhIboklDDOrBv4T+BBwFHCRmR2VVDwiIpJbkncYpwCvufsb7r4NuA+4IMF4REQkh5oEt30gsCTl/VLg1PSZzGwsMDZ8u9XMXixCbN01EFiddBARKM74lEOMoDjjVi5xHhnHSpJMGJbhM9/jA/fxwHgAM5vp7iMKHVh3Kc54lUOc5RAjKM64lVOccawnySKppcDBKe8PApYlFIuIiOSRZMJ4BjjczA4xs1rgQuAvCcYjIiI5JFYk5e47zOwrwN+BauAud38pz2LjCx9ZLBRnvMohznKIERRn3HpUnOa+R7WBiIjIHtTTW0REIlHCEBGRSEoiYeQbIsQC/xZOf97MToq6bJHjHBPG97yZPWlmx6dMW2hmL5jZ7LiauHUjztFm9nYYy2wzuyHqskWO89spMb5oZm1mtl84rSj708zuMrOV2fr/lNCxmS/OUjk288VZKsdmvjhL4dg82MyazWyumb1kZl/LME+8x6e7J/oiqPB+HRgO1AJzgKPS5jkf+B+CvhunAU9HXbbIcb4X2Df8/UMdcYbvFwIDS2R/jgb+2pVlixln2vwfBf4vgf15JnAS8GKW6YkfmxHjTPzYjBhn4sdmlDhL5NgcCpwU/j4AeKXQ585SuMOIMkTIBcDvPDAd2MfMhkZctmhxuvuT7r4ufDudoG9JsXVnn5TU/kxzEXBvgWLJyt2nAGtzzFIKx2beOEvk2IyyP7Mpqf2ZJqljc7m7Pxv+vgGYSzCCRqpYj89SSBiZhghJ/9LZ5omybFw6u63LCTJ7BwceN7NZFgx3UihR4zzdzOaY2f+Y2dGdXDYOkbdlZnXAecCDKR8Xa3/mUwrHZmcldWxGlfSxGVmpHJtmNgw4EXg6bVKsx2eSQ4N0iDJESLZ5Ig0vEpPI2zKzswj+KUemfHyGuy8zs/2BJ8xsXngVk0SczwKN7r7RzM4HHgYOj7hsXDqzrY8C09w99YqvWPszn1I4NiNL+NiMohSOzc5I/Ng0s/4ECevr7v5O+uQMi3T5+CyFO4woQ4Rkm6eYw4tE2paZHQfcCVzg7ms6Pnf3ZeHPlcBDBLeEicTp7u+4+8bw98eAXmY2MMqyxYwzxYWk3fIXcX/mUwrHZiQlcGzmVSLHZmckemyaWS+CZNHk7n/KMEu8x2ehK2YiVNzUAG8Ah7Cr8uXotHk+zO4VNzOiLlvkOBuA14D3pn3eDxiQ8vuTwHkJxjmEXZ02TwEWh/u2pPZnON/eBGXJ/ZLYn+E2hpG9kjbxYzNinIkfmxHjTPzYjBJnKRyb4X75HXBLjnliPT4TL5LyLEOEmNmXwum3A48R1Pa/BmwGvphr2QTjvAGoB24zM4AdHoxkORh4KPysBvi9u/8twTg/DVxpZjuAVuBCD46iUtufAJ8AHnf3TSmLF21/mtm9BC13BprZUuAHQK+UGBM/NiPGmfixGTHOxI/NiHFCwscmcAZwCfCCmc0OP/sewcVBQY5PDQ0iIiKRlEIdhoiIlAElDBERiUQJQ0REIlHCEBGRSJQwREQkEiUMERGJRAlDREQiUcIQ6YbweQQfCH+/2cz+LemYRAol8Z7eImXuB8APw4HmTgQ+lnA8IgWjnt4i3WRmk4H+wGgPnksgUpFUJCXSDWZ2LMGTz7YqWUilU8IQ6aLwyWVNBE8q22Rm5yYckkhBKWGIdEH4pLU/Ade4+1zgR8CNiQYlUmCqwxARkUh0hyEiIpEoYYiISCRKGCIiEokShoiIRKKEISIikShhiIhIJEoYIiISyf8HCuLEIPBylWsAAAAASUVORK5CYII=\n", "text/plain": [ "