Assignment 2 - QSTP ML.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Programming Exercise 2: Logistic Regression\n",
    "\n",
    "## Introduction\n",
    "\n",
    "In this exercise, you will implement logistic regression and apply it to two different datasets. Before starting on the programming exercise, we strongly recommend watching the video lectures and completing the review questions for the associated topics.\n",
    "\n",
    "All the information you need for solving this assignment is in this notebook, and all the code you will be implementing will take place within this notebook. \n",
    "\n",
    "Before we begin with the exercises, we need to import all libraries required for this programming exercise. \n",
    "\n",
    "You can download all the required libraries by simply googling \"Anaconda install <library name>\" if you have anaconda, and then copy paste the code required in your anaconda prompt / terminal.\n",
    "   \n",
    "For any further queries, you can PM any of the mentors."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 175,
   "metadata": {},
   "outputs": [],
   "source": [
    "# used for manipulating directory paths\n",
    "import os\n",
    "\n",
    "# Scientific and vector computation for python\n",
    "import numpy as np\n",
    "\n",
    "# Plotting library\n",
    "from matplotlib import pyplot\n",
    "\n",
    "# Optimization module in scipy\n",
    "from scipy import optimize\n",
    "import utils\n",
    "\n",
    "# tells matplotlib to embed plots within the notebook\n",
    "%matplotlib inline"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 1 Logistic Regression\n",
    "\n",
    "In this part of the exercise, you will build a logistic regression model to predict whether a student gets admitted into a university. Suppose that you are the administrator of a university department and\n",
    "you want to determine each applicant’s chance of admission based on their results on two exams. You have historical data from previous applicants that you can use as a training set for logistic regression. For each training example, you have the applicant’s scores on two exams and the admissions\n",
    "decision. Your task is to build a classification model that estimates an applicant’s probability of admission based the scores from those two exams. \n",
    "\n",
    "The following cell will load the data and corresponding labels:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 176,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Load data\n",
    "# The first two columns contains the exam scores and the third column\n",
    "# contains the label.\n",
    "data = np.loadtxt(os.path.join('Data', 'ex2data1.txt'), delimiter=',')\n",
    "X, y = data[:, 0:2], data[:, 2]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 1.1 Visualizing the data\n",
    "\n",
    "Before starting to implement any learning algorithm, it is always good to visualize the data if possible. We  display the data on a 2-dimensional plot by calling the function `plotData`. You will now complete the code in `plotData` so that it displays a figure where the axes are the two exam scores, and the positive and negative examples are shown with different markers.\n",
    "\n",
    "To help you get more familiar with plotting, we have left `plotData` empty so you can try to implement it yourself. However, this is an optional (ungraded) exercise. We also provide our implementation below so you can\n",
    "copy it or refer to it. If you choose to copy our example, make sure you learn\n",
    "what each of its commands is doing by consulting the `matplotlib` and `numpy` documentation.\n",
    "\n",
    "```python\n",
    "# Find Indices of Positive and Negative Examples\n",
    "pos = y == 1\n",
    "neg = y == 0\n",
    "\n",
    "# Plot Examples\n",
    "pyplot.plot(X[pos, 0], X[pos, 1], 'k*', lw=2, ms=10)\n",
    "pyplot.plot(X[neg, 0], X[neg, 1], 'ko', mfc='y', ms=8, mec='k', mew=1)\n",
    "```"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 177,
   "metadata": {},
   "outputs": [],
   "source": [
    "def plotData(X, y):\n",
    "    \"\"\"\n",
    "    Plots the data points X and y into a new figure. Plots the data \n",
    "    points with * for the positive examples and o for the negative examples.\n",
    "    \n",
    "    Parameters\n",
    "    ----------\n",
    "    X : array_like\n",
    "        An Mx2 matrix representing the dataset. \n",
    "    \n",
    "    y : array_like\n",
    "        Label values for the dataset. A vector of size (M, ).\n",
    "    \n",
    "    Instructions\n",
    "    ------------\n",
    "    Plot the positive and negative examples on a 2D plot, using the\n",
    "    option 'k*' for the positive examples and 'ko' for the negative examples.    \n",
    "    \"\"\"\n",
    "    # Create New Figure\n",
    "    fig = pyplot.figure()\n",
    "\n",
    "    # ====================== YOUR CODE HERE ======================\n",
    "    # Find Indices of Positive and Negative Examples\n",
    "    pos = y == 1\n",
    "    neg = y == 0\n",
    "\n",
    "    # Plot Examples\n",
    "    pyplot.plot(X[pos, 0], X[pos, 1], 'k*', lw=2, ms=10)\n",
    "    pyplot.plot(X[neg, 0], X[neg, 1], 'ko', mfc='y', ms=8, mec='k', mew=1)\n",
    "    \n",
    "    # ============================================================"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now, we call the implemented function to display the loaded data:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 178,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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d9i6dSvvvvsuw4cP54gjjmDZsmU0NTWxc+dO1q1b1+1r9O/fn/r6+nbXv/a1r/Ff//VfzesvvfQSABMmTOCXv/wlAL/5zW/429/+1m0Z/CaqceSGEeU5MFmtILwoEFJVVcXZZ5/datu3vvUt3nvvPUaOHMmoUaO48sormThxYrevMWnSJF5//XXGjh3LQw89xD/90z/xq1/9qnmQ+u6776ampobRo0dz4oknNg90l5eX8/TTT3PKKaewcuVKjjrqqG7L4CdhqIBmGD0hqiG9GVcPoisTsqZNm8aECROYMWMGsViMpqYm7rrrLp555hlPCpJkMz2ZKBfltAyGEUbcTpTLagVh+EdPvhdLDW0Y6SWKM6kNIyWRjiM3jAhjCsIIPZZawzCCwRSEEXostYZhBIMpCCP0WGoNwwgGUxBG6IlyHLlhRJmsVhBeTb4SEWbOnNm8Pn/+fG666aYOj6murm6VHqM7dDV99/Lly7n11ltTXn/JkiXs2JGyZlO7JBMKekFU48gNI8pkrYLwcvJV3759eeyxx7r0sE6Hgugq3/zmN7nhhhtSXr87CsIwjMwiaxWEl0U8evXqxeWXX86dd955yL533nmH0tJSRo8eTWlpKdu2beO5555j+fLlXHvttYwdO5a333671TErVqzgS1/6EkVFRUyZMoX3338faD9999atWzn++OO59NJLOfnkkznvvPNYvXo1X/nKVxg5ciQvvPACkFAC11xzzSHXv+2226ipqeG8885j7NixfPTRR2zcuJGJEycybtw4zjjjDHbu3AnAxo0bGTNmDOPHj+e///u/u33PDMMIIW5Svoa1dTfdt6q3KXgPO+wwraur06OPPlpra2t13rx5Wl5erqqqZ511li5ZskRVVRcvXqxTp05VVdULL7ywOf13Wz744AM9ePCgqqouWrRIy8rKVLX99N1btmzReDyur7zyijY1Nekpp5yiF198sR48eFCrq6ubr9kybXjb60+cOFH/8Ic/qKrqgQMHdPz48bpr1y5VVV22bJlefPHFqqo6atQoXb9+vaqq/vjHP25OSd6WdKf7Ngyj+2DpvjvG68lXhx9+OBdccAF33313q6yqzz//fHPK7fPPP5/rrruu03Nt376d7373u+zcuZMDBw4w3BG8o/Tdw4cPZ9SoUQCcdNJJlJaWIiKMGjWKrVu3dumzvPXWW2za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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "plotData(X, y)\n",
    "# add axes labels\n",
    "pyplot.xlabel('Exam 1 score')\n",
    "pyplot.ylabel('Exam 2 score')\n",
    "pyplot.legend(['Admitted', 'Not admitted'])\n",
    "pass"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id=\"section1\"></a>\n",
    "### 1.2 Implementation\n",
    "\n",
    "#### 1.2.1 Warmup exercise: sigmoid function\n",
    "\n",
    "Before you start with the actual cost function, recall that the logistic regression hypothesis is defined as:\n",
    "\n",
    "$$ h_\\theta(x) = g(\\theta^T x)$$\n",
    "\n",
    "where function $g$ is the sigmoid function. The sigmoid function is defined as: \n",
    "\n",
    "$$g(z) = \\frac{1}{1+e^{-z}}$$.\n",
    "\n",
    "Your first step is to implement this function `sigmoid` so it can be\n",
    "called by the rest of your program. When you are finished, try testing a few\n",
    "values by calling `sigmoid(x)` in a new cell. For large positive values of `x`, the sigmoid should be close to 1, while for large negative values, the sigmoid should be close to 0. Evaluating `sigmoid(0)` should give you exactly 0.5. Your code should also work with vectors and matrices. **For a matrix, your function should perform the sigmoid function on every element.**\n",
    "<a id=\"sigmoid\"></a>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 179,
   "metadata": {},
   "outputs": [],
   "source": [
    "def sigmoid(z):\n",
    "    \"\"\"\n",
    "    Compute sigmoid function given the input z.\n",
    "    \n",
    "    Parameters\n",
    "    ----------\n",
    "    z : array_like\n",
    "        The input to the sigmoid function. This can be a 1-D vector \n",
    "        or a 2-D matrix. \n",
    "    \n",
    "    Returns\n",
    "    -------\n",
    "    g : array_like\n",
    "        The computed sigmoid function. g has the same shape as z, since\n",
    "        the sigmoid is computed element-wise on z.\n",
    "        \n",
    "    Instructions\n",
    "    ------------\n",
    "    Compute the sigmoid of each value of z (z can be a matrix, vector or scalar).\n",
    "    \"\"\"\n",
    "    # convert input to a numpy array\n",
    "    z = np.array(z)\n",
    "    \n",
    "    # You need to return the following variables correctly \n",
    "    g = np.zeros(z.shape)\n",
    "\n",
    "    # ====================== YOUR CODE HERE ======================\n",
    "    g = 1/(1+np.exp(-z))\n",
    "    \n",
    "\n",
    "    # =============================================================\n",
    "    return g"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The following cell evaluates the sigmoid function at `z=0`. You should get a value of 0.5. You can also try different values for `z` to experiment with the sigmoid function."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 180,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "g( 0 ) =  0.5\n"
     ]
    }
   ],
   "source": [
    "# Test the implementation of sigmoid function here\n",
    "z = 0\n",
    "g = sigmoid(z)\n",
    "\n",
    "print('g(', z, ') = ', g)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id=\"section2\"></a>\n",
    "#### 1.2.2 Cost function and gradient\n",
    "\n",
    "Now you will implement the cost function and gradient for logistic regression. Before proceeding we add the intercept term to X. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 181,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Setup the data matrix appropriately, and add ones for the intercept term\n",
    "m, n = X.shape\n",
    "\n",
    "# Add intercept term to X\n",
    "X = np.concatenate([np.ones((m, 1)), X], axis=1)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now, complete the code for the function `costFunction` to return the cost and gradient. Recall that the cost function in logistic regression is\n",
    "\n",
    "$$ J(\\theta) = \\frac{1}{m} \\sum_{i=1}^{m} \\left[ -y^{(i)} \\log\\left(h_\\theta\\left( x^{(i)} \\right) \\right) - \\left( 1 - y^{(i)}\\right) \\log \\left( 1 - h_\\theta\\left( x^{(i)} \\right) \\right) \\right]$$\n",
    "\n",
    "and the gradient of the cost is a vector of the same length as $\\theta$ where the $j^{th}$\n",
    "element (for $j = 0, 1, \\cdots , n$) is defined as follows:\n",
    "\n",
    "$$ \\frac{\\partial J(\\theta)}{\\partial \\theta_j} = \\frac{1}{m} \\sum_{i=1}^m \\left( h_\\theta \\left( x^{(i)} \\right) - y^{(i)} \\right) x_j^{(i)} $$\n",
    "\n",
    "Note that while this gradient looks identical to the linear regression gradient, the formula is actually different because linear and logistic regression have different definitions of $h_\\theta(x)$.\n",
    "<a id=\"costFunction\"></a>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 182,
   "metadata": {},
   "outputs": [],
   "source": [
    "def costFunction(theta, X, y):\n",
    "    \"\"\"\n",
    "    Compute cost and gradient for logistic regression. \n",
    "    \n",
    "    Parameters\n",
    "    ----------\n",
    "    theta : array_like\n",
    "        The parameters for logistic regression. This a vector\n",
    "        of shape (n+1, ).\n",
    "    \n",
    "    X : array_like\n",
    "        The input dataset of shape (m x n+1) where m is the total number\n",
    "        of data points and n is the number of features. We assume the \n",
    "        intercept has already been added to the input.\n",
    "    \n",
    "    y : arra_like\n",
    "        Labels for the input. This is a vector of shape (m, ).\n",
    "    \n",
    "    Returns\n",
    "    -------\n",
    "    J : float\n",
    "        The computed value for the cost function. \n",
    "    \n",
    "    grad : array_like\n",
    "        A vector of shape (n+1, ) which is the gradient of the cost\n",
    "        function with respect to theta, at the current values of theta.\n",
    "        \n",
    "    Instructions\n",
    "    ------------\n",
    "    Compute the cost of a particular choice of theta. You should set J to \n",
    "    the cost. Compute the partial derivatives and set grad to the partial\n",
    "    derivatives of the cost w.r.t. each parameter in theta.\n",
    "    \"\"\"\n",
    "    # Initialize some useful values\n",
    "    m = y.size  # number of training examples\n",
    "\n",
    "    # You need to return the following variables correctly \n",
    "    J = 0\n",
    "    grad = np.zeros(theta.shape)\n",
    "\n",
    "    # ====================== YOUR CODE HERE ======================\n",
    "    hypothesis_function = sigmoid(np.dot(X,theta))      \n",
    "    cost_function_proto = (-y*np.log(hypothesis_function))-((1-y)*np.log(1-hypothesis_function))\n",
    "    \n",
    "    J = sum(cost_function_proto)/m\n",
    "    \n",
    "    grad = 1/m * np.dot(X.transpose(),(hypothesis_function-y))\n",
    "    # =============================================================\n",
    "    return J, grad"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Once you are done call your `costFunction` using two test cases for  $\\theta$ by executing the next cell."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 183,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Cost at initial theta (zeros): 0.693\n",
      "Expected cost (approx): 0.693\n",
      "\n",
      "Gradient at initial theta (zeros):\n",
      "\t[-0.1000, -12.0092, -11.2628]\n",
      "Expected gradients (approx):\n",
      "\t[-0.1000, -12.0092, -11.2628]\n",
      "\n",
      "Cost at test theta: 0.218\n",
      "Expected cost (approx): 0.218\n",
      "\n",
      "Gradient at test theta:\n",
      "\t[0.043, 2.566, 2.647]\n",
      "Expected gradients (approx):\n",
      "\t[0.043, 2.566, 2.647]\n"
     ]
    }
   ],
   "source": [
    "# Initialize fitting parameters\n",
    "initial_theta = np.zeros(n+1)\n",
    "\n",
    "cost, grad = costFunction(initial_theta, X, y)\n",
    "\n",
    "print('Cost at initial theta (zeros): {:.3f}'.format(cost))\n",
    "print('Expected cost (approx): 0.693\\n')\n",
    "\n",
    "print('Gradient at initial theta (zeros):')\n",
    "print('\\t[{:.4f}, {:.4f}, {:.4f}]'.format(*grad))\n",
    "print('Expected gradients (approx):\\n\\t[-0.1000, -12.0092, -11.2628]\\n')\n",
    "\n",
    "# Compute and display cost and gradient with non-zero theta\n",
    "test_theta = np.array([-24, 0.2, 0.2])\n",
    "cost, grad = costFunction(test_theta, X, y)\n",
    "\n",
    "print('Cost at test theta: {:.3f}'.format(cost))\n",
    "print('Expected cost (approx): 0.218\\n')\n",
    "\n",
    "print('Gradient at test theta:')\n",
    "print('\\t[{:.3f}, {:.3f}, {:.3f}]'.format(*grad))\n",
    "print('Expected gradients (approx):\\n\\t[0.043, 2.566, 2.647]')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### 1.2.3 Learning parameters using `scipy.optimize`\n",
    "\n",
    "In the previous assignment, you found the optimal parameters of a linear regression model by implementing gradient descent. You wrote a cost function and calculated its gradient, then took a gradient descent step accordingly. This time, instead of taking gradient descent steps, you will use the [`scipy.optimize` module](https://docs.scipy.org/doc/scipy/reference/optimize.html). SciPy is a numerical computing library for `python`. It provides an optimization module for root finding and minimization. As of `scipy 1.0`, the function `scipy.optimize.minimize` is the method to use for optimization problems(both constrained and unconstrained).\n",
    "\n",
    "For logistic regression, you want to optimize the cost function $J(\\theta)$ with parameters $\\theta$.\n",
    "Concretely, you are going to use `optimize.minimize` to find the best parameters $\\theta$ for the logistic regression cost function, given a fixed dataset (of X and y values). You will pass to `optimize.minimize` the following inputs:\n",
    "- `costFunction`: A cost function that, when given the training set and a particular $\\theta$, computes the logistic regression cost and gradient with respect to $\\theta$ for the dataset (X, y). It is important to note that we only pass the name of the function without the parenthesis. This indicates that we are only providing a reference to this function, and not evaluating the result from this function.\n",
    "- `initial_theta`: The initial values of the parameters we are trying to optimize.\n",
    "- `(X, y)`: These are additional arguments to the cost function.\n",
    "- `jac`: Indication if the cost function returns the Jacobian (gradient) along with cost value. (True)\n",
    "- `method`: Optimization method/algorithm to use\n",
    "- `options`: Additional options which might be specific to the specific optimization method. In the following, we only tell the algorithm the maximum number of iterations before it terminates.\n",
    "\n",
    "If you have completed the `costFunction` correctly, `optimize.minimize` will converge on the right optimization parameters and return the final values of the cost and $\\theta$ in a class object. Notice that by using `optimize.minimize`, you did not have to write any loops yourself, or set a learning rate like you did for gradient descent. This is all done by `optimize.minimize`: you only needed to provide a function calculating the cost and the gradient.\n",
    "\n",
    "In the following, we already have code written to call `optimize.minimize` with the correct arguments."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 184,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Cost at theta found by optimize.minimize: 0.203\n",
      "Expected cost (approx): 0.203\n",
      "\n",
      "theta:\n",
      "\t[-25.161, 0.206, 0.201]\n",
      "Expected theta (approx):\n",
      "\t[-25.161, 0.206, 0.201]\n"
     ]
    }
   ],
   "source": [
    "# set options for optimize.minimize\n",
    "options= {'maxiter': 400}\n",
    "\n",
    "# see documention for scipy's optimize.minimize  for description about\n",
    "# the different parameters\n",
    "# The function returns an object `OptimizeResult`\n",
    "# We use truncated Newton algorithm for optimization which is \n",
    "# equivalent to MATLAB's fminunc\n",
    "# See https://stackoverflow.com/questions/18801002/fminunc-alternate-in-numpy\n",
    "res = optimize.minimize(costFunction,\n",
    "                        initial_theta,\n",
    "                        (X, y),\n",
    "                        jac=True,\n",
    "                        method='TNC',\n",
    "                        options=options)\n",
    "\n",
    "# the fun property of `OptimizeResult` object returns\n",
    "# the value of costFunction at optimized theta\n",
    "cost = res.fun\n",
    "\n",
    "# the optimized theta is in the x property\n",
    "theta = res.x\n",
    "\n",
    "# Print theta to screen\n",
    "print('Cost at theta found by optimize.minimize: {:.3f}'.format(cost))\n",
    "print('Expected cost (approx): 0.203\\n');\n",
    "\n",
    "print('theta:')\n",
    "print('\\t[{:.3f}, {:.3f}, {:.3f}]'.format(*theta))\n",
    "print('Expected theta (approx):\\n\\t[-25.161, 0.206, 0.201]')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Once `optimize.minimize` completes, we want to use the final value for $\\theta$ to visualize the decision boundary on the training data as shown in the figure below. \n",
    "\n",
    "![](Figures/decision_boundary1.png)\n",
    "\n",
    "To do so, we have written a function `plotDecisionBoundary` for plotting the decision boundary on top of training data. You do not need to write any code for plotting the decision boundary, but we also encourage you to look at the code in `plotDecisionBoundary` to see how to plot such a boundary using the $\\theta$ values. You can find this function in the `utils.py` file which comes with this assignment."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 185,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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U3r06CGNGjWS999/X0REDh06JC1btpRr165JcHCw1KxZU8LCwuS1116T2rVrS2BgoISFhUlcXJwkJibKgw8+KBERERIRESFbt24VEZFz585J9+7dJTw8XIYMGSL169eXs2fPluszGp28/wclsXr1arFYLPm+e0BMJpNUrlxZTCaT+Pj4yMKFC+0osW3ZuHGjeHt73/SZAPH29pbY2Fi7Xbuw+2mxWGT16tV2u6ambADxYsXY6xIWwLlzZ6lePX+YJ8CYMf+gcuU/F9ZsPUOKiYnh7rvvpmnTplSvXp0ff/yRFStWsG/fPnbv3s2cOXNISEigatWquesA9evXJz4+nm7dujFo0CCWLVvG9u3bGT9+fL5ze3p6MnnyZP7617+SkJDA2LFjeeqppxg5ciQJCQncddddPPfcc4wcOZIdO3awfPlyBg8eDMCkSZO48847+emnn+jduzdHjx4t1+dzNwr62XMIDg4utdvFaNhqAbk82GLdQmNsXEIBXL+ejpfXzds7d47g889n3vTjyMFaU3XRokX0798fgP79+7No0SLi4uJ45JFHsheeA4mOjs53TO/evQFo3bo1t99+O76+vgQEBGCxWMr8w1m/fj3Dhw8nPDyc3r17c+nSJVJSUoiLi8uNZ7/vvvuoVq1auT6fu1HQz57jXgkJCSm128WIOGsgLs+6hca1cAkF4OnpwbVrhe+7/fYIpk173eYzpPPnz7Nx40YGDx5Mw4YNmT59OkuWLEFEig1P9MrWVCaTKffvnNclLU4WJDMzk++++46EhAQSEhI4ceJEbmRReUMk3ZmCfvYLFy7wxhtv5CYvmc1mRo8eTUxMjJMlLRvOGojLs26hcS1cQgHUrBnAhQuKglUrRODChayB0NYzpGXLljFgwACOHDnC4cOHOXbsGCEhIVSvXp3FixeTkZHBqVOniI2NLfc1fH19b8omzvu6R48evPPOO7mvExISAOjcuTOffvopAF999RUXL14stwzuRExMDKNGjcqNxnLVAb8gzhqI3fV+av7EEArg6o3CQyZzKCnbd/ny/9l8hrRo0SIeeOCBfNseeughTp8+TZMmTWjdujVDhw4lMjKy3NeIiopiz549hIeHs2TJEu6//35WrFhBeHg4W7Zs4a233iI+Pp42bdpwyy238MEHHwAwYcIE4uLiaNeuHWvXrqV+/frllkFjHIrK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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Plot Boundary\n",
    "utils.plotDecisionBoundary(plotData, theta, X, y)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id=\"section4\"></a>\n",
    "#### 1.2.4 Evaluating logistic regression\n",
    "\n",
    "After learning the parameters, you can use the model to predict whether a particular student will be admitted. For a student with an Exam 1 score of 45 and an Exam 2 score of 85, you should expect to see an admission\n",
    "probability of 0.776. Another way to evaluate the quality of the parameters we have found is to see how well the learned model predicts on our training set. In this part, your task is to complete the code in function `predict`. The predict function will produce “1” or “0” predictions given a dataset and a learned parameter vector $\\theta$. \n",
    "<a id=\"predict\"></a>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 186,
   "metadata": {},
   "outputs": [],
   "source": [
    "def predict(theta, X):\n",
    "    \"\"\"\n",
    "    Predict whether the label is 0 or 1 using learned logistic regression.\n",
    "    Computes the predictions for X using a threshold at 0.5 \n",
    "    (i.e., if sigmoid(theta.T*x) >= 0.5, predict 1)\n",
    "    \n",
    "    Parameters\n",
    "    ----------\n",
    "    theta : array_like\n",
    "        Parameters for logistic regression. A vecotor of shape (n+1, ).\n",
    "    \n",
    "    X : array_like\n",
    "        The data to use for computing predictions. The rows is the number \n",
    "        of points to compute predictions, and columns is the number of\n",
    "        features.\n",
    "\n",
    "    Returns\n",
    "    -------\n",
    "    p : array_like\n",
    "        Predictions and 0 or 1 for each row in X. \n",
    "    \n",
    "    Instructions\n",
    "    ------------\n",
    "    Complete the following code to make predictions using your learned \n",
    "    logistic regression parameters.You should set p to a vector of 0's and 1's    \n",
    "    \"\"\"\n",
    "    m = X.shape[0] # Number of training examples\n",
    "\n",
    "    # You need to return the following variables correctly\n",
    "    p = np.zeros(m)\n",
    "\n",
    "    # ====================== YOUR CODE HERE ======================\n",
    "    p = X.dot(theta)\n",
    "    for i in range(m):\n",
    "        if p[i] >= 0.5:\n",
    "            p[i] = 1\n",
    "        else:\n",
    "            p[i] = 0\n",
    "        \n",
    "    # ============================================================\n",
    "    return p"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "After you have completed the code in `predict`, we proceed to report the training accuracy of your classifier by computing the percentage of examples it got correct."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 187,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "For a student with scores 45 and 85,we predict an admission probability of 0.776\n",
      "Expected value: 0.775 +/- 0.002\n",
      "\n",
      "Train Accuracy: 89.00 %\n",
      "Expected accuracy (approx): 89.00 %\n"
     ]
    }
   ],
   "source": [
    "#  Predict probability for a student with score 45 on exam 1 \n",
    "#  and score 85 on exam 2 \n",
    "prob = sigmoid(np.dot([1, 45, 85], theta))\n",
    "print('For a student with scores 45 and 85,'\n",
    "      'we predict an admission probability of {:.3f}'.format(prob))\n",
    "print('Expected value: 0.775 +/- 0.002\\n')\n",
    "\n",
    "# Compute accuracy on our training set\n",
    "p = predict(theta, X)\n",
    "print('Train Accuracy: {:.2f} %'.format(np.mean(p == y) * 100))\n",
    "print('Expected accuracy (approx): 89.00 %')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 2 Regularized logistic regression\n",
    "\n",
    "In this part of the exercise, you will implement regularized logistic regression to predict whether microchips from a fabrication plant passes quality assurance (QA). During QA, each microchip goes through various tests to ensure it is functioning correctly.\n",
    "Suppose you are the product manager of the factory and you have the test results for some microchips on two different tests. From these two tests, you would like to determine whether the microchips should be accepted or rejected. To help you make the decision, you have a dataset of test results on past microchips, from which you can build a logistic regression model.\n",
    "\n",
    "First, we load the data from a CSV file:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 188,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Load Data\n",
    "# The first two columns contains the X values and the third column\n",
    "# contains the label (y).\n",
    "data = np.loadtxt(os.path.join('Data', 'ex2data2.txt'), delimiter=',')\n",
    "X = data[:, :2]\n",
    "y = data[:, 2]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 2.1 Visualize the data\n",
    "\n",
    "Similar to the previous parts of this exercise, `plotData` is used to generate a figure, where the axes are the two test scores, and the positive (y = 1, accepted) and negative (y = 0, rejected) examples are shown with\n",
    "different markers."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 189,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAZQAAAEKCAYAAAA1qaOTAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDMuMC4zLCBodHRwOi8vbWF0cGxvdGxpYi5vcmcvnQurowAAIABJREFUeJztnXuYFOWV8H+nB2fGCToiTOJlxkCCGyNJACGa7G6EAVSSZQXzRQNZE0l0ze3b6JJ4yUIggLtRVCTJGrNgFCQbYCGJAn4mgDOgiTHrGMXrY0BICNFERIcMkgEGzvdHVUNP05fq7qququ7ze5736a6qt6pOV3fXqfOe854jqophGIZhlEoibAEMwzCMysAUimEYhuELplAMwzAMXzCFYhiGYfiCKRTDMAzDF0yhGIZhGL5gCsUwDMPwBVMohmEYhi+YQjEMwzB8oU/YApSTAQMG6MCBA8MWwzAMI1Y8+eSTr6tqU75+VaVQBg4cSEdHR9hiGIZhxAoR+b2XfjbkZRiGYfiCKRTDMAzDF0yhGIZhGL5QVT4UwzAMLxw8eJCdO3fS3d0dtihlpb6+nubmZo477rii9jeFYlQte/fuZf78W1m06Hu88spuTjutP//8z19i2rTr6Nu3b9jiGSGyc+dOTjjhBAYOHIiIhC1OWVBVdu/ezc6dOxk0aFBRxzCFYlQle/fuZfToD9HY+DKzZnUzaBBs3/46y5bNY/XqH7Nx4+OmVKqY7u7uqlImACJC//792bVrV9HHMB+KUZXMn38rjY0vM2NGN4MHQ00NDB4MM2Z009j4MvPn3xq2iEbIVJMySVLqZzaFYlQlixZ9jylTukn//4jA5Mnd3H33XeEIFhB79+5lzpxZtLQ0UVOToKWliTlzZrF3796wRasY9uzZwyWXXMKePXvCFiU0TKEYVckrr+wm2zDxoEHO9kohOby3adM8Zs16nXXrlFmzXmfTpnmMHv0hUyo+sXr1au6//37WrFkTtigZeeSRRzjnnHPo06cPq1atCuQcplCMquS00/qzfXvmbdu3O9srBRveKw/33HNPr9eoccYZZ7B48WI+9alPBXYOUyhGVfLP//wlli2rR7X3elVYvryeq676YjiCBUC1De+Vi3HjxiEiR9pjjz0GwC9/+cte68eNG1fwsb/xjW/w7W9/+8jy9OnT+c53vlOSvAMHDuQDH/gAiURwt31TKEZVMm3adezZ825uuqmeLVugpwe2bIGbbqpnz553M23adWGL6BvVNLxXTqZPn05DQ8OR5QMHDvR6BWhoaGDGjBkFH/vKK69kyZIlABw+fJjly5fzT//0T8f0+8hHPsKwYcOOaRs2bCj4nH5gYcNGVdK3b182bnyc+fNvZe7cu47MQ7nqqi9W3DwUZ3jvdQYPPnZbpQ3vlZPW1lbWrl3LhAkT2Ldv3zHbGxoaePDBBxk9enTBxx44cCD9+/fnqaee4s9//jPDhw+nf/9jv6dHH320GNEDwxSKUbX07duXmTNnM3Pm7LBFCRRneG8eM2b0HvaqxOG9ctPa2sqKFSu49NJLe82qr6+vZ8WKFUUpkyRXXXUVixcv5k9/+hOf+9znMvb5yEc+QldX1zHrb7vttqKG2krFFIphVDjTpl3H6tU/5qabXmby5OQkTkeZVNrwXhh0dnbSp08fEokEdXV17N+/nz59+tDZ2VnScS+55BJmzpzJwYMH+dGPfpSxT9QsFPOhGEaFkxzeGzXqeubObWL8+ARz5zYxatT1lhHAB37wgx+wb98+hg4dygMPPMDQoUPZt29fydFetbW1tLa2ctlll1FTU1OynE888QTNzc2sXLmSz3/+8wwZMqTkY6YTqkIRkXtE5DUReS7LdhGR74jIVhF5RkTOSdl2hYhscdsV5ZO6MrCJboUT52uWHN7bseM1enoOsWPHa8ycOduUiQ80NjZy66230tHRwQUXXMATTzzBvHnzOPHEE0s67uHDh3n88ce58sorfZHzgx/8IDt37uStt95i9+7dPP/8874ctxeqGloDzgfOAZ7Lsv1jwEOAAB8Cfu2uPxnY5r72c9/3y3e+ESNGqKHa1dWlI0YM0TFj6nXRInTDBnTRInTMmHodMWKIdnV1hS1iIHR1dens2TO1uXmAJhKizc0DdPbsmZ4+b7Ves2rlhRdeCPX8zz//vA4aNEinTZtW9nNn+uxAh3q4p4dqoajqI8AbObpMBO5zP9PjwEkicipwEbBeVd9Q1TeB9cD44CWuDKpxolups8Wr8ZoZ4XH22Wezbds2br/99rBFKYio+1BOB/6QsrzTXZdtveGBqE50CzIXUqkKIarXzDCiRNQVSqbUl5pj/bEHELlaRDpEpKOUtMyVRFQnugWZC6lUhRDVa2YYUSLqCmUn0JKy3Ay8kmP9MajqQlUdqaojm5qaAhM0TkQ1j1WQuZBKVQhRvWaGESWirlBWA59xo70+BOxR1VeBnwMXikg/EekHXOiuMzwQlTxWQeZCSqdUhRCVa2YYUSbssOFlwK+A94jIThG5UkS+ICJfcLv8P5wIrq3AIuBLAKr6BjAXeMJtc9x1hgeikscqyFxI6ZSqEMK8ZnEOV64G4vL97N+/n09+8pMMHjyY8847j9/97nf+n8RLKFilNAsbPkoyhLalpUlrahLa0tLkOYQ2/RjFhOEmaWtr04aGBsXxgfVqDQ0N2t7eXsSnyyxrMux34UJ0/Xp04cLCwn69XjM/rksmuS1cuXx4DRuO0/dz55136uc//3lVVV22bJledtllGfuVEjYc+k2+nM0Uin/4+Udas2aN1tfX91Im9fX1umbNGt9lLlWJejmHnzeY2bNn6pgx9drWhra3H21tbc4xZ8+e6ZvsxlG8KpSgvp8ZM2boggULjiz/27/9m377298u6lhJLrzwQn3sscdUVfXgwYPav39/PXz48DH9YjsPxSgvfprmfs7LSM2FdPzxx5NIJHzJhZROOWaL+z1fxcKVo01Q308Q6ev/+Mc/0tLixDL16dOHxsZGdu/2NzrRFEqV4HcZWD//SEHlQgoDv28wFq7sjbD8GEF9P6np69etW5czff3TTz99TMsUyOIYGr2R9B9qiZhCqRL8fnL2848UVC6kMPD7BmPhyvnx+2GpEIL8fpLp6++9996c6eu9WijNzc384Q/OfPCenh727NnDySefXLR8mTCFUiX4/eTs5x/p/vvvZ9q0aUdKk9bU1PDVr36V+++/vyCZooDfNxgLV85PmGlxgvx+LrnkEn72s5/xxBNPcNFFF2XsU4iFcvHFFx8ZRlu1ahVjxowxC8UoDr+fnO1Glxm/r0tUQryjTJh+piC/H7/T11955ZXs3r2bwYMHM3/+fG6++eaSj5mOZBpXq1RGjhypHR0dYYsRCi0tTcyalbkM7JYtMHduEzt2vOb5eMlhhsbGzEWbqrXORhDXZe/evcyffyt3313ZpYqLpaYmwbp1SqZ7bk8PjB+foKfnUEHHfPHFF3nve9/rqW9Q38/hw4c555xzWLlyJWeeeWbRxymUTJ9dRJ5U1ZH59jULpUrw+8nZijZlJojrYrVMchO2nymI7+eFF15g8ODBjB07tqzKpFTMQqkSzKIwKpU5c2axadM8ZszoPeyl6gw9jRp1PTNnzi7omIVYKJWGWShGXsyiKIwgU+nHlaimGAnKj1FND9tJSv3MZqEYRgaWLl3KZz7zGZYuXcrll18etjihk2rhTply1MJdtiwaFq7ffozt27dzwgkn0L9/f98joaKKqrJ79266uroYlBbB49VCMYViVBR79uxh6tSpLF68mMbGxqKP09raysaNG2ltbaWtrc1HCeNJEMNKUebgwYPs3LmT7u7usEUpK/X19TQ3N3Pcccf1Wm8KJQOmUCqfYi2LcePG8fDDDx9Zrq2t5cCBA0dek4wdOzbjpLFKx+8oQSNemA/FiDxB+CmKLdJVzlT6ccRSwBheMIVihIYfJX/9KtLV2trK2rVreymVVBoaGnjwwQcZPXp00bKC/47tcjnKww7NNeKBKRQjNPwo+eunZdHa2sqKFSuor6/vtb6+vp4VK1b4okz8zDlVzhxWlhnB8IIpFKNsBFHy12/LIshU+n7nnCpnDis/Q3OjGn5s+ICXoilBNWA88BJOid8bM2y/A3jabb8FOlO2HUrZttrL+azAVrjkqs5IiVUa/SrSNXr0aE0kEjp8+HBdt26dDh8+XBOJhLa2thYsUzrNzQN00aLehZiSbeFCtKWlKdTj5cOvKp9xqXBoHIWoF9gSkRrgTuCjwNnAFBE5O7WPqv6rqg5T1WHAd4GfpGz+a3Kbql5cNsGNognST+GXZRFkKn2/HdvldpT7kWIkzMzARvCEOeR1LrBVVbep6gFgOTAxR/8pwLKySGYERlB+Cr+KdAWZSt9vx3YcHeV+Zga2obPoEaZCOR34Q8ryTnfdMYjIO4FBQOoMs3oR6RCRx0VkUnBiGn4ThJ8iDkW6/HZsx9FR7pdVFWZRLSM7YSqUTPkMss2ynAysUtXUHNRnqDPR5lPAAhF5d8aTiFztKp6OXbt2lSax4QtBlPxdsmQJjz76KF1dXUD4RboyzbHxO+dUHGul+GVV2dBZNAlToewEWlKWm4FXsvSdTNpwl6q+4r5uAzYCwzPtqKoLVXWkqo5samoqVebIE+QwgF/HLsWayDYZ0o85LX6SSR6/E3T6ebxyJcP0y6oKs6iWkQMvnvsgGtAH2IYzlFULbAaGZOj3HuB3uGli3HX9gDr3/QBgC3B2vnNWepRXkBE0UYnOue+++xTQpUuX9lo/evRoBQqKxurs7NRJkyZpZ2en32IWJU+YZLuufpP6O1q4EF2/3olIK/R3lEiIbtiQOcJt/Xq0piYR6OeoNoh6lJeq9gD/F/g58CLwP6r6vIjMEZHUqK0pwHL3QyV5L9AhIpuBduBmVX2hXLKXQpAWRJDDAFEZYkgOi33lK18peU6Ln1ZNEHNsyokfk0yT5LJ2/LKq4hiQUBV40TqV0sK2UIJ+yg9yXkK55zwkGTt2bK+5JbW1tQponz59cs5nwcOcFj+tiCDn2ARBtuuafE22sWPHFnzsclg7s2fP1DFj6rWtrfdvsa3N+T/Nnj0zsHNXI0TdQqlGgn7KD3JeQljJAbOlVunp6cm5X6Y5LUFaEeXKBeYXQSbD9NPayUZUAhIsdLk3plDKSNCOxCCHAcIaYsh3o66rq6O2trbXumxzWoLOKBx0LjA/8VMBhjHcF4UKpBa6fCymUMpI0E/5xUbQeInwCXPOQ64b9Ze//GVqa2uPVNUTkaxzWsphRQSZC8xv/FKAYaX+9zJzP64+y7hiCqWMBP2UX+wwgBfndNhDDNlu1A899BD79u3jbW97GwBve9vbcs5pCdqKCGKOTZD4oQCjOtwXtAVhocvHYgqljAT9lF/sMICXMe+whxjSb9QNDQ3s3buXF198kcOHD/d6Kj58+DDt7e1Zh1mCtCLiMGM/Fb8UYBSH++Lss4wtXjz3ldKiFOVVSgx+qQQZ4RMUEydO1Ntvv10PHTqkqqrr16/X4447rqioqiAzCkedZMbg5uYBmkiInnhirY4ff4Hu2bNHVVV7enr0tttu04kTJxZ87KVLl2rfvn01kUjo8ccfr4lEQvv27Rv43JZsBB2ZGFbkYxjgMcor9Jt8OVvYCkXVnxTgpU7Ii1uIazZyfY5c8qcrp1JuonEi6LD1qCnqoCc/VlPosimUiCoUP/Ajzr/Ym3HU8KsOSjUQ9A2wXIo63cpqbh6Q8aEsaAsiKiMO5cCrQjEfSgzxI84/imPexRCnqCovBJlTK58Tef78m0s6b5Cp/5MU4miPqs+ykjGFEgOCivOvhJtx3KKq8hFkkst8TuS//OVAZJJrZqMQR3s5IhP9KDpWSZhCiQFBxflXws04blFV+Qhylnm+sPW6umBnt/tBIaG6ZkGEgJdxsUppcfahBOHzqAbndK4AhiCzDXulnBF3uXwoH/4wmkhEO9JP1bIMhwXmQ6ksgvB5lGPMO2xyDSFFoYaKF+vz+OOPp7u7u2S/SrYhoOnT4amn4PDh4Ge3l4plGY42plDKgF/pHyrB51Fucg0hlSOJYT68zDK/9tpr+eUvf1my4ksfArroIuGaa+DXv4bu7mPPG6VklkniWPa4qvBixlRKC2PIy8/Y/6jF+UcRr0NIubaFMcyTK/zZS5r9Yofv4hZ2XU2hulECG/KKBn6mf6g0B3QQeBlCyrUtrGGeVOszOQTZ3d3NP/7jP3qK6it2+C5uVq852iOOF61TKS0MC6Va0jNEwcGdJFcAQ11dndbV1UVuQmeq9Tlv3jwVkYIyGRRbLMysXsMLlGqhiMgQEfmFiGwXke+JSGPKtl8FoNsqkmpJIBcFB3eSXAEMq1atYtWqVZGb0JlqfV533XWsW7eO4447LmPfhoYGzjrrLFpbW0uem2RWb3aseFbh5Bry+j5wM/BBYAfwCxFJ3hrrs+5VACIyXkReEpGtInJjhu1TRWSXiDzttqtStl0hIlvcdoUf8gRBEFEpUfyhR8HBnUquoZwoDvOkR9yNGzeOn/zkJ1kV32233ebL3KQoRvoFmS3AK1Y8qzhyKZQTVHWtqr6uqjcD/wqsE5EP4pjdJSEiNcCdwEeBs4EpInJ2hq4rVHWY2+529z0ZmAWcB5wLzBKRfqXKFAR+R6VE5Yfu5+z9IG4guSZtxmVCZy7FF9UaJH4QBWvXimcVRy6FkhCRI3avqm4ALgV+BJzhw7nPBbaq6jZVPQAsByZ63PciYL2qvqGqbwLrgfE+yOQ7fqd/KPWH7tfN28/Z+0HcQHIN5cRlmCef4quUfGzpRMHateJZRZLNuQJ8GvhwhvUDgXu9OGhyNeATwN1p5/vPtD5TgVeBZ4BVQIu7/mvAjJR+3wC+luU8VwMdQMcZZ5zhj4eqQPxIWZ+kVCe/H5mKk/g1e79Yh3Kl4yWTQdRqkBRDFOvz2Iz83hD19PU41k66QvluWp/+QJ37/gtAm/v+ugwK5av5zhnn1CtJSv2h+33zLmYeQxRvIHGlEqK0olCfJz1KsVqiM73iVaGEOQ9lJ9CSstwMvJLaQVV3q+p+d3ERMMLrvpVKoU7+oDIVJynGwR1UsstqJC7Dd7mIgj8ofdjVZuQXiRetE0QD+gDbgEFALbAZGJLW59SU95cAj7vvTwa2A/3cth04Od85K8FCKbRIUtBPf8U+IVdKgS/DP8KctZ9uuduM/N7g15AX8CEv64ppwMeA3wIvA9PddXOAi9333wKed5VNO3BWyr6fA7a67bNezlcJCqWYH3qQN+9SMhbHLe2HESzl9Ad5HXZ997sH+eL7jDt+KpTfZFj3pJeDR61VgkJRLc7JH8WbdyU4lA3/KKc/KAp+mzjhVaHkmil/rohcAzSJyFdS2gwg8xReoywUUyUuipP54jIfJJ0oTLyrRMrpD4qC36YSyeWUfxswAMfX0ZTSDuBEaBkxIoo377g6lKMw8a4SKfes/UqdxxMmfbJtUNV2oF1E7lXVbQAiIkCDqr5VLgENf0jevK+99loSiQRjxoxhwYIFPProo6HJlH6jSN5AvvrVr4YkkTdSJ95dfvnlIUtjlEKq5V5XV8f+/ftDt9xjTb4xMeA+4ESgAXgBeA2Y5mU8LWqtUnwoRnmxeTOVSyXM4ykH+DgP5f2q+hdgErAOZ87HVF+1mmEUQLl9GDZvpnKJ67BrZMmncXDCdvsAK4DR7rqnvWirqDWzUCoDP9PHeMXmzRhBkIzYbG4eoImEaHPzgEiGJuOjhXI3Tvr6fsAmETkDsNzNRmiEkTzQHLiG30Qlc7if5FUoqnqHqp6mqhe6mmonMCZ40Ywk1R6mGnT6GK9EMfTaiC+VmCI/r0IRkSYR+S8RWeuuOgv4VLBiGalUe5hqVHwYUQy9NuJLJabI9zLktRjYxNFkjFuAaMd1VhhRqA/hlSCsqahMQjMHruEnlVge3ItCebuq/gg4DKCqB4FDgUoVEcIqtRuVIZ5iCMqaioIPI4rlco34EkR58LDxolDeckvuKoBbArgrUKkiQJgOs6gM8RRDkNaU+TCMSqISU+R7UShfA9YA7xKRTcAy4F8ClSoCFOMw88uiicoQjxfKaU2ZD8OoJPwuDx4JssUTk5KiHqdeyVBgGFDrJR45iq2QeSiFVmxLTSu/aBG6YQO6aFFp9ROimCE4nXJmbS0lVb5hRBE/y4MHCT7MQ/leitI5oKqbVfVpVT2QY5+KoVCHWRAhgHEY4imnNWU+jOolqqHzpY5KFJM5PMqEWQI40hTqMAsiBDAuQzxRcJgblU0UQ+crcWJiqeRSKO8SkdXZWtkkDIlCHWZBhADGKUw1DtaUEV+iGDpfiRMTS0U0/Y6Z3CCyBbgq246quqnkk4uMB74N1AB3q+rNadunuTL0ALuAz6nq791th4Bn3a47VPXifOcbOXKkdnR0eJIt+fTR2Pgykyd3M2iQY5ksX+44zDZufLyXWdrS0sSsWa8zePCxx9qyBebObWLHjtc8nTuOtLa28sgjjzB06FBuueUWbrjhBjZv3syoUaNoa2sLWzwjZowbN46HH374yHJtbS0HDhw48ppk7NixbNiwIQwRq+o/LyJPqurIfP1yWShdqropW/NBwBrgTuCjwNnAFBE5O63bU8BIVf0AsAqYl7Ltr6o6zG15lUmh9O3bl40bH2fUqOuZO7eJ8eMTzJ3bxKhR1x+jTKAyQwALIU7WlBF94hA6X4kTE0sll4XyE1X9eGAnFvkw8E1Vvchd/jqAqn4rS//hwH+q6t+5y3tVtSDPVSEWSqEUatHEhT179jB16lQWL15MY2Nj2OIYVUR7ezsTJkxg3759x2yLQui8WSjHktVCCVKZuJwO/CFleae7LhtXAg+lLNeLSIeIPC4ik4IQsBAKtWjKTbFRMlF0hhrVQdSDPap9VCITYUZ5SYZ1Gc0lEbkcGAmkernOcDXmp4AFIvLuLPte7Sqejl27dpUqc06iHAJYrGKIojPUqB6iHOxRkRMTSyRMhbKTowknwakE+Up6JxEZB0wHLlbV/cn1qvqK+7oN2AgMz3QSVV2oqiNVdWRTU5N/0scMr4ohznnEjMojyqHzUR+VCAUvsx+BjwPzgduBS7zs4+GYfYBtwCCcmfibgSFpfYYDLwNnpq3vB9S57wfgZEA+O985q6liY7F10Ms5890w8mHZEaIBHmfKe7nxfw+nlvxn3fYz4E4vB/dw7I8Bv3WVxnR33RwcawRgA/Bn4Gm3rXbX/y1OyPBm9/VKL+erJoVSimKIernbzs5OnTRpknZ2doYqh2FUC34qlOdxo8Hc5QTwvJeDR61Vk0JRLU0xRDmPWBg15Y1oYw8ZweJVoXjxobwEnJGy3AI842E/I2RKiZKJsjPUAgWMdCwaMRp4USj9gRdFZKOIbAReAJqqJQVL3ClWMUTJGWqBAkY+7CEjGnhRKDNxZrPPctvHgLk4DvrbgxPN8INiFUOUZr7HYda0UV7sISOaZJ0pX4kEOVM+qkyaNInzzz+fa6+9lkQiwaFDh1iwYAGPPvporNK+R33WtFFecv0ektjvwj+8zpTPlXrlF6r69yLSRe8JhwKoqsYuSVM1KpRKYu3atVx66aV0d3cfWVdfX8/KlSuZMGFCiJIZYWAPGeXDj9Qrf+++nqCqJ6a0E+KoTIz4E+VAAaP8RD01SzXiaaa8iNSIyGkickayBS2YYaQTpUABIxrYQ0Z2Sq0mWQx5FYqI/AvO5ML1wINuWxuYRIaRhSgFChjRwB4yMhNWNUkvFso1wHtUdYiqvt9tHwhEGsPIgdWUN9Kp1IeMUq2LsKpJ5o3yEpF24AJV7QlEgjJiTnnDMKJOam2lKVOO1lZatsx7bSW/a7WU7JQXkWluCd5twEYR+XpynbveMAzD8Bk/rIuwqknmGvI6wW07cPwntSnrTghEGsMwjCpn0aLvMWVKN5JWMUoEJk/u5u6778p7jNNO68/27Zm3bd/ubA+CPtk2qOrsQM5oVARWGtgwgsEP68KpJjmPGTN6KyYNuJqklyiv9SJyUspyPxH5eSDSVAFhhPIFQanJ+IotSWwYlY4f1kVY1SS9RHk1qeqRoG5VfRN4eyDSVDhhhfIFQanJ+Cw7rGFkxo9a9WFVk/SiUA6lTmQUkXeSpfa7kRu/Q/nK+ZTvdzI+yw5bHZglWjh+WRd9+/Zl5szZ7NjxGj09h9ix4zVmzpwdaGliLwplOvALEVkqIkuBR4CvByZRBeOHsy2Vcj7ll5rx17LDVidmiXojdSi8sfFE/vSnPwHnMnv2gFjVqs+rUFT1Z8A5wAq3jVBVX3woIjJeRF4Ska0icmOG7XUissLd/msRGZiy7evu+pdE5CI/5Akav0P5yvmU39raytq1a3splVTyJeOzFPTViVmi+ck0FP7Nb+4G/pdTTnkHnZ17ymJd+IGnXF44NdxHu+1DfpxYRGqAO3FqrZwNTBGRs9O6XQm8qaqDgTuAW9x9zwYmA0OA8cD33ONFmlKdbWE/5ZeSjK9UhQQ2fBIHwv6NxpGwZrUHgZcor5tx0q+84LZrRORbPpz7XGCrqm5T1QPAcmBiWp+JwBL3/SpgrIiIu365qu5X1e3AVvd4kaZUZ1sUnvJLScZXanZYGz6JPlH4jcYNv4fCw8SLhfIxnNQr96jqPTgWwT/4cO7TgT+kLO9012Xs46Z+2YNTktjLvpGjVGebH0/5pVJqMr5SFJINn0SfMH6jcQ/FD2tWexB4HfI6KeW9X7PYJMO69OixbH287OscQORqEekQkY5du3YVKKK/+BHKF3YNiFKT8RWikGz4JJ6U8zdaCaH4Yc1qDwIvCuVbwFMislhElgBPAv/hw7l3Ai0py83AK9n6iEgfHGX2hsd9AVDVhao6UlVHNjU1+SB2afgRyhdmDYhSM/4WopBs+CS+lOs3Wgn+Bz/mnUQGVc3acCyBFuBU4GIc38Upufbx2nDSvmwDBuHkCdsMDEnr82Xg++77ycD/uO+HuP3r3P23ATX5zjlixAitBEaPHq2JREKHDx+u69at0+HDh2sikdDW1tawRfNMV1eXzp49U5ubB2giIdrcPEBnz56pXV1dvfq1tbVpQ0OD4ligvVpDQ4Mq8r3pAAAbeUlEQVS2t7eH8wGMnJTrN9rcPEAXLULb249tCxeiLS1Nvp4vCLq6unTEiCE6Zky9LlyIrl/vyD5mTL2OGDHkmP9EGAAd6uW+nrcDPOnlQMU0HP/Mb4GXgenuujnAxe77emAljtP9f4F3pew73d3vJeCjXs4XZ4WSegMWQfv3f5t+85vf0K6uLu3p6dHbbrtNJ06cGLaYnkj9Ay1ahG7YgC5alP0PtGbNGq2vr++lTOrr63XNmjUhfQIjHxMnTtTbb79dDx06pKoa2G80kRDdsCGzQlm/Hq2pSfh6vqBI/r9bWpq0piahLS1NGR+wwsKrQvFSD+VOYLGqPlGI5RNF4loPxY/6CFFizpxZbNqUOXHdTTfVM2rU9cyceTQ36Q9/+EO++MUvsm/fPurq6ti/fz8NDQ3cddddXH755SF8AiMq+F33w8hMyfVQUmgFfiUiL4vIMyLyrIg8U7qI1YEfESiVME6cSqFhklbm1chGVP0PcY88KxYvFso7M61X1d8HIlGAlNtC8cuyqLSnsJqaBOvWKTUZpqL29MD48Ql6eg4dWTdp0iTOP/98rr32WhKJBIcOHWLBggU8+uijVv63ykn9j02efPQ/tnx5eNZ7pY0ogL8WyqnAG6r6e1eJvAGcUqqA1YBflkUlxalD4WGSVkveyEZYWXVzUWkjCoXgRaHcBaTaaW+564w8+DUDtpLi1CG6wxRGPAkjq24uKmnme6F4USiiKeNiqnqYHJUejaP4ZVlU2g04rOI/hlEOKm1EoRC8KJRtIvIVETnObdfgzPsw8uCXZRH0DbjcDsQoDlMYlUPYSUQrbUShELwolC/gZBv+I84M9fOAq4MUqlLwy7II8gYcVuqKqA1TGJVD2ElEK21EoRDyRnlVEmFGeUUlAiWdQueEGIWxZ88epk6dyuLFi2ls9CsNnpGL1tZWNm7cSGtrK21tbWU/fxz+94VScpSXiFzvvn5XRL6T3vwUtlKJw9BONTsQy0HYT8vVQNSSiMbhfx8UWS0UEflHVV0jIldk2q6qSzKtjzJxnSkfJIXOCal0/LYown5ajhJBWWvt7e1MmDCBffv2Ze3jNW2+WZSZKdlCUdU17uuSTM1PYY3wCMOBGLbTNBelWhRRe1qOEkFZa37WYDGLsjRyDXmtztXKKaQRHGE4EKP8py21iJel3M9OkAXS/KrBYkXcSiRb1khgF/Ab4DrgfGBUavOSeTJqLc7ZhoMijNTZo0ePVsBTKvPOzk6dNGmSdnZ2+i6HqurYsWN7ZTGura3t9ZpsY8eO9XxMS7nvEMS1zcXSpUu1b9++mkgk9Pjjj9dEIqF9+/bVpUuXRkbGuEKp6euBGpxyv0uAp4CbSKtXErcWZYXitT5IkOcOKnV2KX/a++67T4GcN4VSyHXzL0UJWMr94K5tNoqpwVJuGcP8n5dCyQqlVyenkNVU12r5Fy/7RLFFVaEUWh8kbpTypy3EmglCvmJvJsU8LZeLoK2+VMpprRVbg6VcMsb5f+6LQnEVycdxilw9AXwDON3LgaPYoqpQZs+eqWPG1GtbW+8CQW1tzo9t9uyZYYtYMl7/tGENQfhtUUS5qmbQVl86cbDWyiFjnP/nXhVKLqf8EuAx4Bxgtqp+UFXnquofs+1jFEc1zAXx6jQNy6ntdw30xsZGbr31Vjo6Orjgggt44oknmDdvHieeeKKvchdDuR3P5aovD8VHEJZDxmr4n+dKvfJp4G+Aa4DHROQvbusSkb+UR7zqoFqSyXn50/oZAloIfhfxilLK/bBDmctZIK3YCMJyyFgN//Nc81ASqnqC205MaSeoakmPWSJysoisF5Et7mu/DH2GicivROR5t1LkJ1O2LRaR7SLytNuGlSKP3xSabDFuyeSKTSbp9U/rVwhoIUTZoiiVsEOZy3lti7W+yiFj3P7nReFlXMzvBswDbnTf3wjckqHP3wBnuu9PA14FTnKXFwOfKPS85fChFON4i8vYamdnp06YMEGHD39vUY7FQpymfjm1y+mAjjKVGsocp7DfuPzPM4GfUV5+N+Al4FT3/anASx722ZyiYCKrUIr50YQxF6QY7rvvPk0k0FGjjgv8T+GXU7vcDugoEwfneKGUO+y3FOLyP8+EV4XiJX19ELxDVV8FcF/fnquziJwL1AIvp6z+d3co7A4Rqcux79Ui0iEiHbt27fJD9pwU43iLSzK5e+65h9pauPzyg4E7Fv0agrCZz0cpp3O8XITlcyuGuPzPSyGw9PUisoHMteenA0tU9aSUvm+q6jF+FHfbqcBG4ApVfTxl3Z9wlMxC4GVVnZNPpnIkh6ykZIvjxo3j4YcfPrJcW1vLwYMHWL+eyH6+TDIfOHDgyGuSsWPHsmHDhjBEDI3W1lYeeeQRhg4dyi233MINN9zA5s2bGTVqVOwTV65du5ZLL72U7u7uI+vq6+tZuXIlEyZMCFGyyqDk5JCloqrjVPV9GdoDwJ9dpZBUDq9lOoaInAg8CMxIKhP32K+6lth+4F7g3KA+R6HEwfHm1ameyZlbV0ekP1/YDugoU8mBB5VofcWRsIa8VgNXuO+vAB5I7yAitcBPgftUdWXatqQyEmAS8Fyg0hZA1Ku1FVKhMdNwwoEDcM89RPbzxWkIpNxEKZTZb8oZmmxkJyyFcjNwgYhsAS5wlxGRkSJyt9vnMpyklFMzhAf/t4g8CzwLDMDJMxYJgq7/Xirz599KY+PLzJjRzeDBztDV4MEwY0Y3jY0vM3/+rb36p4fwHj4MTz0F06cTyc8H4YQdG+FSydZXrPDiua+UVq7UK0EnWyyF5uYBumhR7witZFu4EG1paTpmn/QQXhHR+vrj9O1vPyFyny9JlHNpGUbcIOJRXhVN3759mTlzNjt2vEZPzyF27HiNmTNnRyKKo5jZuunDCcOGDePAgUMMGTIycp8viQ2BGEb5MYVSZRQTNBDH4YQ4ymwYcSewsOEoYjXlYc6cWWzaNI8ZM3rPlVF1/CCjRl3PzJmzwxPQMIzIEXrYsBFNoh40UCrF5hkzDD+o9t+fWShVyN69e5k//1buvvsuXnllN6ed1p+rrvoi06ZdFyk/SKEkQ6IbG19mypRuBg1yhvGWLXOUZaXMRjaiSSX//sxCMbIS5aCBUsgXEv0f/3FTUbUy8lFsDQ6jsig0JL8SMYViVAz586h9r6haGfkotgaH35hiC5dqKKCVD1MohifiMDacLyT69de7AP8TRUYlAWVUFFu1Ug0FtPJhCiVmhHFjLyRdS5jkC4muc3NSl1qpMOwKiNmIimJLEoeHED+JQx6/oDGFEiPCurHHZWw4Vx61e+918pBB6Ykio5KAMqqKDeLzEOInUc/jVw5MocSIsG7scRkbzhYSPX26k3/s8OHe/YtNFBmVBJRRUWyZiMtDiJ9Ueki+FyxsOEa0tDQxa9brDB587LYtW2Du3CZ27MhYCaAk4lTjpXdI9OucdNLxHDjQQ1fXAerrHSvl8GF/amVEoQZHe3s7EyZMYN++fcdsCzOzcli/1bCp1JB8CxuuQMJy+sVpbDgZEv3CC9sYNuxshg49zPz5B9iwAb77XTjvPKivd1K3l1orIwo1OKKaWblaHdSVGpLvFVMoMSKsG3scx4azDbn8+7/DOecI3d1vley8jkoCyigotnTi9BBi+IcplBgR1o09jmPDufw+U6cq/fq9reREkVFJQBkVxZZKHB9CjNIxH0qMSE3tMHny0dQOy5cHn9ohbmPDcfL7lMqkSZM4//zzufbaa0kkEhw6dIgFCxbw6KOPhlaNMczfquE/Xn0oplBiRtxu7GFRrU7hKGG/1coh0gpFRE4GVgADgd8Bl6nqmxn6HcIp8wuwQ1UvdtcPApYDJwO/AT6tqgfS90+nEhSK4Y04punfs2cPU6dOZfHixTQ2NoYtjmEcIepRXjcCD6vqmcDD7nIm/qqqw9x2ccr6W4A73P3fBK4MVlwjbsTR71PtqVMsF1n8CUuhTASWuO+XAJO87igiAowBVhWzv1Ed9O3bl40bH2fUqOuZO7eJ8eMTzJ3bxKhR10d2/D5qqVP8wquiCFKhBqmsqi3FTE68FJ73uwGdactvZunXA3QAjwOT3HUDgK0pfVqA57ycd8SIEWoYUWHs2LEKHGm1tbW9XpNt7NixYYtaEvfdd58CunTp0pz9Ro8erYC2traGJkOhdHV16YgRQ3TMmHpdtAjdsAFdtAgdM6ZeR4wYol1dXb6eLyyADvVwjw3MQhGRDSLyXIY2sYDDnKHOuN2ngAUi8m5AMvTL6ggSkatFpENEOnbt2lXgpzCM4Ihy6hQ/yWZ5lTMXWVDWXzWmmMmJF63jdwNeAk51358KvORhn8XAJ3AUyutAH3f9h4GfezmvWShG1Ghra9OGhoZeFkmyNTQ0aHt7e9gi9qKzs1MnTZqknZ2dWft4tbzOOeecrJ+91GtQLuuvuXmALlqEtrcf2xYuRFtamko6flQgbAslD6uBK9z3VwAPpHcQkX4iUue+HwD8HfCC++HacZRL1v0NIw5ENXVKNrz4ObxaXrfffntgSTaDsP4y+UpeffV1Tjklc/9KTjGTjbAUys3ABSKyBbjAXUZERorI3W6f9wIdIrIZR4HcrKovuNtuAKaJyFagP/CDskpvGD4SxdQp2fAydFRINuagFKrfGaGzpeM/7zy45hr461+P3acaU8yEolBUdbeqjlXVM93XN9z1Hap6lfv+MVV9v6oOdV9/kLL/NlU9V1UHq+qlqro/jM9hVB5hROykpk5Zvnw5p5zydnp69vKZz3y67BFD6Z//xBNrqakp3M9RiKIISqH6qayy+UpuuglOPRVWruzdv1pTzFguL8NwCasoVDIn2MaNG5kz598466xOvvtdWL+erOcPIgw20+efP//gkQzNUNjQUT5FkVReX/rS53jrrb00NAiXXvpx3ve+9/mWi8wvZZUrN9wVV8CPf0xs5jsFiSkUw3AJK2Ln/vvvZ9q0aSxYcLvn8wcxZyNXhubhwyGR4W6Ra+goV9LKVOU1f/5B1q+HO+44xM6dP+a44w4xd+5cX5Js+pU4M186/r17JTbznYLEFIphuIRdmbKQ8wcRBpvr/J/9LNTV9V6fb+goVzbmfMq7p2e/L4kt/coInS8d/+mnD6jaGiipWHJIw3AJO0NxvvNfeCFH0sHX1tZy4MCBI69Jxo4dy4YNGwI7v0iCuro69u/fT0NDA3fddReXX355weeKW/LOOOaG85Oo5/IyjMgRdlGofOdP9S0HMQky3/nr6vCt5krcKjrGMTdcGJhCMSJJGNFWYReFynf+yZM/HcicDS/nX7IkwejRF/hWTCxs5V0occwNFwY25GVEjtTiTFOmHC3OtGxZsMWZwi4K5eX8Gzdu5NJLL6W7u/vIfvX19axcuZIJEyYEfn6/Pn+1DyHFDRvyMmJLWNFWYT+Fejl/kJMgy/n5bQipMjELxYgccXPYlpPW1lYeeeQRhg4dyi233MINN9zA5s2bGTVqFG1tbWGLVxBW0TE+RLpiY1iYQokHYUdbRZko1o83Kh9TKBkwhRIPzEIxjGhhPhQjtoQdbWUYRnGYQjEihzlsDSOemEIxIkfY0VaGYRSH+VAMwzCMnJgPxTAMwygrplAMw4gFYaTjMQojFIUiIieLyHoR2eK+9svQp1VEnk5p3SIyyd22WES2p2wbVv5PYRjesZthaYRV/MwojLAslBuBh1X1TOBhd7kXqtquqsNUdRgwBtgHrEvpcl1yu6o+XRapDaMI7GZYOmGl4zEKIyyFMhFY4r5fAkzK0/8TwEOqui9QqQwjAKJwM4y7hRR28TPDG6FEeYlIp6qelLL8pqoeM+yVsr0NmK+qa93lxcCHgf24Fo6q7s93XovyMsIg7Jn/YWVv9hNLxxMuoUd5icgGEXkuQ5tY4HFOBd4P/Dxl9deBs4APAicDN+TY/2oR6RCRjl27dhXxSQyjNMIuJhUFC6lU4lY/pVoJTKGo6jhVfV+G9gDwZ1dRJBVGrsezy4CfqurBlGO/qg77gXuBc3PIsVBVR6rqyKamJn8+nGEUQNg3w0oYLrJ0PPEgLB/KauAK9/0VwAM5+k4BlqWuSFFGguN/eS4AGQ3DF8K+GYZtIfmBpeOJB2EplJuBC0RkC3CBu4yIjBSRu5OdRGQg0AJsStv/v0XkWeBZYABwUxlkNoyiCPtmGLaF5AeWjiceWOoVwygDYRaTsnK7RqlYPZQMmEIxqpFy1oo3KpPQo7wMw4gGNlxklAuzUAzDMIycmIViGIZhlBVTKIZhGIYvmEIxDMMwfMEUimEYhuELVeWUF5FdwO/LeMoBwOtlPF+hmHylYfKVhslXGuWU752qmjd3VVUplHIjIh1eIiPCwuQrDZOvNEy+0oiifDbkZRiGYfiCKRTDMAzDF0yhBMvCsAXIg8lXGiZfaZh8pRE5+cyHYhiGYfiCWSiGYRiGL5hCKREROVlE1ovIFve1X4Y+rSLydErrFpFJ7rbFIrI9Zduwcsvn9juUIsPqlPWDROTX7v4rRKS23PKJyDAR+ZWIPC8iz4jIJ1O2BXL9RGS8iLwkIltF5MYM2+vc67HVvT4DU7Z93V3/kohc5Ic8Bco2TURecK/VwyLyzpRtGb/nEGScKiK7UmS5KmXbFe7vYYuIXJG+b5nkuyNFtt+KSGfKtkCvoYjcIyKviUjGwoHi8B1X9mdE5JyUbYFfu5yoqrUSGjAPuNF9fyNwS57+JwNvAA3u8mLgE2HLB+zNsv5/gMnu++8DXyy3fMDfAGe6708DXgVOCur6ATXAy8C7gFpgM3B2Wp8vAd93308GVrjvz3b71wGD3OPUlFm21pTf1xeTsuX6nkO4flOB/8yw78nANve1n/u+X7nlS+v/L8A95bqGwPnAOcBzWbZ/DHgIEOBDwK/Lde3yNbNQSmcisMR9vwSnJHEuPgE8pKr7ApXqKIXKdwQREWAMsKqY/T2SVz5V/a2qbnHfvwK8BuSdZFUC5wJbVXWbqh4AlrtyppIq9ypgrHu9JgLLVXW/qm4HtrrHK5tsqtqe8vt6HGj28fy+yJiDi4D1qvqGqr4JrAfGhyzfMWXIg0RVH8F56MzGROA+dXgcOEmcsujluHY5MYVSOu9Q1VcB3Ne35+k/mWN/nP/umq53iEhdSPLVi0iHiDyeHI4D+gOdqtrjLu8ETg9JPgBE5Fycp8qXU1b7ff1OB/6Qspzpcx/p416fPTjXy8u+QcuWypU4T7NJMn3PfuNVxv/jfm+rRKSlwH3LIR/ucOEgoC1ldTmuYS6yyV+Oa5eTPuU8WVwRkQ3AKRk2TS/wOKcC7wd+nrL668CfcG6SC4EbgDkhyHeGqr4iIu8C2kTkWeAvGfoVHBbo8/VbClyhqofd1SVfv0ynyrAu/XNn6+Nl31LwfHwRuRwYCYxKWX3M96yqL2faP2AZ1wDLVHW/iHwBx9ob43HfcsiXZDKwSlUPpawrxzXMRVi/vbyYQvGAqo7Ltk1E/iwip6rqq+4N77Uch7oM+KmqHkw59qvu2/0ici/wtTDkc4eSUNVtIrIRGA78GMec7uM+hTcDr4Qhn4icCDwIzHDN/OSxS75+GdgJtKQsZ/rcyT47RaQP0IgzTOFl36BlQ0TG4SjsUaq6P7k+y/fs980wr4yqujtlcRFwS8q+o9P23Vhu+VKYDHw5dUWZrmEusslfjmuXExvyKp3VQDKa4grggRx9jxmLdW+iSX/FJCBjZEeQ8olIv+RQkYgMAP4OeEEdT187jt8n6/5lkK8W+CnOuPHKtG1BXL8ngDPFiXCrxbmppEfzpMr9CaDNvV6rgcniRIENAs4E/tcHmTzLJiLDgf8CLlbV11LWZ/yefZStEBlPTVm8GHjRff9z4EJX1n7AhfS26Msinyvje3Cc279KWVeua5iL1cBn3GivDwF73Aercly73JQzAqASG864+cPAFvf1ZHf9SODulH4DgT8CibT924BncW6EPwT6lls+4G9dGTa7r1em7P8unBviVmAlUBeCfJcDB4GnU9qwIK8fTiTNb3GePKe76+bg3KQB6t3rsdW9Pu9K2Xe6u99LwEcD+M3lk20D8OeUa7U63/ccgozfAp53ZWkHzkrZ93Pudd0KfDYM+dzlbwI3p+0X+DXEeeh81f3N78Txg30B+IK7XYA7XdmfBUaW89rlajZT3jAMw/AFG/IyDMMwfMEUimEYhuELplAMwzAMXzCFYhiGYfiCKRTDMAzDF0yhGFWBiKiILE1Z7iNOttu17vLFkiHrrI/n/6aIZJx0KSKPFXCcn7pZbreKyB45mvX2bwuUZ4w7hyHTtiHiZHfeLyLXFnJco7qxmfJGtfAW8D4ROV5V/wpcgDMvCABVXU2GyW2ZcCdRih5N/1ISqupZGajqJa4Mo4GvqeqEIk87BngdJ3lkOq/jZNj9RIZthpEVs1CMauIh4B/c972yFohTn+M/3ffvcC2BzW77WxEZKCIvisj3gN8ALSIyRUSeFZHnROSWlGONF5HfuPs+nHL+s0Vko4hsE5GvpPTf676OFpFH3HO/ICLfFxHP/1ER+aCIbBKRJ0XkIRF5h7v+X93jbRaRH4rIu4GrgOsyWTeq+mdV7QB6MpzGMLJiFopRTSwHZrrDXB8A7gE+kqHfd4BNqnqJiNQAfXFScLwHZ/bxl0TkNJz8UyOAN4F14mSe/SVObqrzVXW7iJycctyzcGqVnAC8JCJ3aUpeN5dzcWqq/B74GfBxjpYPyIqbDuTbODO9XxeRfwLmAlcD1wPvVNUDInKSqnaKyN3A66q6IN+xDcMrplCMqkFVnxGnsuIU4P/l6DoG+Iy7zyFgj5sb6fd6NDHlB4GNqroLQET+G6cw0iHgEXVqoaCqqXUtHlQnUeN+EXkNeAdOao1U/ldVt7nHXAb8PR4UCvBeYAiwwRmRoybl2M8DPxSRB4D7PRzLMIrCFIpRbawGbsPJytq/wH3fSnmfKVV4cn22fEb7U94fIvP/L31fr7mRBHhGVTNZXBfhpLCfCMwQkfd5PKZhFIT5UIxq4x5gjqo+m6PPwzilcxGRGnFS56fza2CUiAxwh8WmAJtwMtOOcjMNkzbk5YVz3Sy4CeCTwC887vcCcLo4BcgQkVo3WqsGaFbVNuA6nEqXDUAXztCbYfiGKRSjqlDVnar67TzdrgFaxSky9iTOUFL6cV7FKe7VjpN59jeq+oA7BHY18BMR2QysKFDEXwE342RP3o6Ttj8v7lDaJ4D57nmfAs7DsYJ+JCLP4AQT3KKqXThlAi4TkafSnfIi0iwiO4GvAN8UkZ0i0lDg5zCqEMs2bBgRwYdQYMMIFbNQDMMwDF8wC8UwDMPwBbNQDMMwDF8whWIYhmH4gikUwzAMwxdMoRiGYRi+YArFMAzD8AVTKIZhGIYv/H+uqUZQ02YfngAAAABJRU5ErkJggg==\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "plotData(X, y)\n",
    "# Labels and Legend\n",
    "pyplot.xlabel('Microchip Test 1')\n",
    "pyplot.ylabel('Microchip Test 2')\n",
    "\n",
    "# Specified in plot order\n",
    "pyplot.legend(['y = 1', 'y = 0'], loc='upper right')\n",
    "pass"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The above figure shows that our dataset cannot be separated into positive and negative examples by a straight-line through the plot. Therefore, a straight-forward application of logistic regression will not perform well on this dataset since logistic regression will only be able to find a linear decision boundary.\n",
    "\n",
    "### 2.2 Feature mapping\n",
    "\n",
    "One way to fit the data better is to create more features from each data point. In the function `mapFeature` defined in the file `utils.py`, we will map the features into all polynomial terms of $x_1$ and $x_2$ up to the sixth power.\n",
    "\n",
    "$$ \\text{mapFeature}(x) = \\begin{bmatrix} 1 & x_1 & x_2 & x_1^2 & x_1 x_2 & x_2^2 & x_1^3 & \\dots & x_1 x_2^5 & x_2^6 \\end{bmatrix}^T $$\n",
    "\n",
    "As a result of this mapping, our vector of two features (the scores on two QA tests) has been transformed into a 28-dimensional vector. A logistic regression classifier trained on this higher-dimension feature vector will have a more complex decision boundary and will appear nonlinear when drawn in our 2-dimensional plot.\n",
    "While the feature mapping allows us to build a more expressive classifier, it also more susceptible to overfitting. In the next parts of the exercise, you will implement regularized logistic regression to fit the data and also see for yourself how regularization can help combat the overfitting problem.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 190,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Note that mapFeature also adds a column of ones for us, so the intercept\n",
    "# term is handled\n",
    "X = utils.mapFeature(X[:, 0], X[:, 1])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id=\"section5\"></a>\n",
    "### 2.3 Cost function and gradient\n",
    "\n",
    "Now you will implement code to compute the cost function and gradient for regularized logistic regression. Complete the code for the function `costFunctionReg` below to return the cost and gradient.\n",
    "\n",
    "Recall that the regularized cost function in logistic regression is\n",
    "\n",
    "$$ J(\\theta) = \\frac{1}{m} \\sum_{i=1}^m \\left[ -y^{(i)}\\log \\left( h_\\theta \\left(x^{(i)} \\right) \\right) - \\left( 1 - y^{(i)} \\right) \\log \\left( 1 - h_\\theta \\left( x^{(i)} \\right) \\right) \\right] + \\frac{\\lambda}{2m} \\sum_{j=1}^n \\theta_j^2 $$\n",
    "\n",
    "Note that you should not regularize the parameters $\\theta_0$. The gradient of the cost function is a vector where the $j^{th}$ element is defined as follows:\n",
    "\n",
    "$$ \\frac{\\partial J(\\theta)}{\\partial \\theta_0} = \\frac{1}{m} \\sum_{i=1}^m \\left( h_\\theta \\left(x^{(i)}\\right) - y^{(i)} \\right) x_j^{(i)} \\qquad \\text{for } j =0 $$\n",
    "\n",
    "$$ \\frac{\\partial J(\\theta)}{\\partial \\theta_j} = \\left( \\frac{1}{m} \\sum_{i=1}^m \\left( h_\\theta \\left(x^{(i)}\\right) - y^{(i)} \\right) x_j^{(i)} \\right) + \\frac{\\lambda}{m}\\theta_j \\qquad \\text{for } j \\ge 1 $$\n",
    "<a id=\"costFunctionReg\"></a>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 191,
   "metadata": {},
   "outputs": [],
   "source": [
    "def costFunctionReg(theta, X, y, lambda_):\n",
    "    \"\"\"\n",
    "    Compute cost and gradient for logistic regression with regularization.\n",
    "    \n",
    "    Parameters\n",
    "    ----------\n",
    "    theta : array_like\n",
    "        Logistic regression parameters. A vector with shape (n, ). n is \n",
    "        the number of features including any intercept. If we have mapped\n",
    "        our initial features into polynomial features, then n is the total \n",
    "        number of polynomial features. \n",
    "    \n",
    "    X : array_like\n",
    "        The data set with shape (m x n). m is the number of examples, and\n",
    "        n is the number of features (after feature mapping).\n",
    "    \n",
    "    y : array_like\n",
    "        The data labels. A vector with shape (m, ).\n",
    "    \n",
    "    lambda_ : float\n",
    "        The regularization parameter. \n",
    "    \n",
    "    Returns\n",
    "    -------\n",
    "    J : float\n",
    "        The computed value for the regularized cost function. \n",
    "    \n",
    "    grad : array_like\n",
    "        A vector of shape (n, ) which is the gradient of the cost\n",
    "        function with respect to theta, at the current values of theta.\n",
    "    \n",
    "    Instructions\n",
    "    ------------\n",
    "    Compute the cost `J` of a particular choice of theta.\n",
    "    Compute the partial derivatives and set `grad` to the partial\n",
    "    derivatives of the cost w.r.t. each parameter in theta.\n",
    "    \"\"\"\n",
    "    # Initialize some useful values\n",
    "    m = y.size  # number of training examples\n",
    "\n",
    "    # You need to return the following variables correctly \n",
    "    J = 0\n",
    "    grad = np.zeros(theta.shape)\n",
    "\n",
    "    # ===================== YOUR CODE HERE ======================\n",
    "    hypothesis_function = sigmoid(np.dot(X,theta))      \n",
    "    cost_function_proto = (-y*np.log(hypothesis_function))-((1-y)*np.log(1-hypothesis_function))\n",
    "    non_reg_cost = sum(cost_function_proto)/m\n",
    "    J = non_reg_cost + lambda_/(2*m) * sum(theta**2)\n",
    "\n",
    "    grad_0 = 1/m * np.dot(X.transpose(),(hypothesis_function-y))\n",
    "    \n",
    "    grad_1 = (1/m * np.dot(X.transpose(),(hypothesis_function-y))) + ((lambda_/m)*theta)\n",
    "    n = X.shape[1]  \n",
    "\n",
    "    for i in range(n):\n",
    "        if i == 0 :\n",
    "            grad[i] = grad_0[i]\n",
    "        else:\n",
    "            grad[i] = grad_1[i]\n",
    "    # =============================================================\n",
    "    return J, grad"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Once you are done with the `costFunctionReg`, we call it below using the initial value of $\\theta$ (initialized to all zeros), and also another test case where $\\theta$ is all ones."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 192,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Cost at initial theta (zeros): 0.693\n",
      "Expected cost (approx)       : 0.693\n",
      "\n",
      "Gradient at initial theta (zeros) - first five values only:\n",
      "\t[0.0085, 0.0188, 0.0001, 0.0503, 0.0115]\n",
      "Expected gradients (approx) - first five values only:\n",
      "\t[0.0085, 0.0188, 0.0001, 0.0503, 0.0115]\n",
      "\n",
      "------------------------------\n",
      "\n",
      "Cost at test theta    : 3.21\n",
      "Expected cost (approx): 3.16\n",
      "\n",
      "Gradient at initial theta (zeros) - first five values only:\n",
      "\t[0.3460, 0.1614, 0.1948, 0.2269, 0.0922]\n",
      "Expected gradients (approx) - first five values only:\n",
      "\t[0.3460, 0.1614, 0.1948, 0.2269, 0.0922]\n"
     ]
    }
   ],
   "source": [
    "# Initialize fitting parameters\n",
    "initial_theta = np.zeros(X.shape[1])\n",
    "\n",
    "# Set regularization parameter lambda to 1\n",
    "# DO NOT use `lambda` as a variable name in python\n",
    "# because it is a python keyword\n",
    "lambda_ = 1\n",
    "\n",
    "# Compute and display initial cost and gradient for regularized logistic\n",
    "# regression\n",
    "cost, grad = costFunctionReg(initial_theta, X, y, lambda_)\n",
    "print('Cost at initial theta (zeros): {:.3f}'.format(cost))\n",
    "print('Expected cost (approx)       : 0.693\\n')\n",
    "print('Gradient at initial theta (zeros) - first five values only:')\n",
    "print('\\t[{:.4f}, {:.4f}, {:.4f}, {:.4f}, {:.4f}]'.format(*grad[:5]))\n",
    "print('Expected gradients (approx) - first five values only:')\n",
    "print('\\t[0.0085, 0.0188, 0.0001, 0.0503, 0.0115]\\n')\n",
    "\n",
    "\n",
    "# Compute and display cost and gradient\n",
    "# with all-ones theta and lambda = 10\n",
    "test_theta = np.ones(X.shape[1])\n",
    "cost, grad = costFunctionReg(test_theta, X, y, 10)\n",
    "\n",
    "print('------------------------------\\n')\n",
    "print('Cost at test theta    : {:.2f}'.format(cost))\n",
    "print('Expected cost (approx): 3.16\\n')\n",
    "print('Gradient at initial theta (zeros) - first five values only:')\n",
    "print('\\t[{:.4f}, {:.4f}, {:.4f}, {:.4f}, {:.4f}]'.format(*grad[:5]))\n",
    "print('Expected gradients (approx) - first five values only:')\n",
    "print('\\t[0.3460, 0.1614, 0.1948, 0.2269, 0.0922]')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### 2.3.1 Learning parameters using `scipy.optimize.minimize`\n",
    "\n",
    "Similar to the previous parts, you will use `optimize.minimize` to learn the optimal parameters $\\theta$. If you have completed the cost and gradient for regularized logistic regression (`costFunctionReg`) correctly, you should be able to step through the next part of to learn the parameters $\\theta$ using `optimize.minimize`."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 2.4 Plotting the decision boundary\n",
    "\n",
    "To help you visualize the model learned by this classifier, we have provided the function `plotDecisionBoundary` which plots the (non-linear) decision boundary that separates the positive and negative examples. In `plotDecisionBoundary`, we plot the non-linear decision boundary by computing the classifier’s predictions on an evenly spaced grid and then and draw a contour plot where the predictions change from y = 0 to y = 1. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 2.5 Optional (ungraded) exercises\n",
    "\n",
    "In this part of the exercise, you will get to try out different regularization parameters for the dataset to understand how regularization prevents overfitting.\n",
    "\n",
    "Notice the changes in the decision boundary as you vary $\\lambda$. With a small\n",
    "$\\lambda$, you should find that the classifier gets almost every training example correct, but draws a very complicated boundary, thus overfitting the data. See the following figures for the decision boundaries you should get for different values of $\\lambda$. \n",
    "\n",
    "<table>\n",
    "    <tr>\n",
    "        <td style=\"text-align:center\">\n",
    "            No regularization (overfitting)<img src=\"Figures/decision_boundary3.png\">\n",
    "        </td>        \n",
    "        <td style=\"text-align:center\">\n",
    "            Decision boundary with regularization\n",
    "            <img src=\"Figures/decision_boundary2.png\">\n",
    "        </td>\n",
    "        <td style=\"text-align:center\">\n",
    "            Decision boundary with too much regularization\n",
    "            <img src=\"Figures/decision_boundary4.png\">\n",
    "        </td>        \n",
    "    <tr>\n",
    "</table>\n",
    "\n",
    "This is not a good decision boundary: for example, it predicts that a point at $x = (−0.25, 1.5)$ is accepted $(y = 1)$, which seems to be an incorrect decision given the training set.\n",
    "With a larger $\\lambda$, you should see a plot that shows an simpler decision boundary which still separates the positives and negatives fairly well. However, if $\\lambda$ is set to too high a value, you will not get a good fit and the decision boundary will not follow the data so well, thus underfitting the data."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 193,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Train Accuracy: 78.8 %\n",
      "Expected accuracy (with lambda = 1): 83.1 % (approx)\n",
      "\n"
     ]
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Initialize fitting parameters\n",
    "initial_theta = np.zeros(X.shape[1])\n",
    "\n",
    "# Set regularization parameter lambda to 1 (you should vary this)\n",
    "lambda_ = 1\n",
    "\n",
    "# set options for optimize.minimize\n",
    "options= {'maxiter': 100}\n",
    "\n",
    "res = optimize.minimize(costFunctionReg,\n",
    "                        initial_theta,\n",
    "                        (X, y, lambda_),\n",
    "                        jac=True,\n",
    "                        method='TNC',\n",
    "                        options=options)\n",
    "\n",
    "# the fun property of OptimizeResult object returns\n",
    "# the value of costFunction at optimized theta\n",
    "cost = res.fun\n",
    "\n",
    "# the optimized theta is in the x property of the result\n",
    "theta = res.x\n",
    "\n",
    "utils.plotDecisionBoundary(plotData, theta, X, y)\n",
    "pyplot.xlabel('Microchip Test 1')\n",
    "pyplot.ylabel('Microchip Test 2')\n",
    "pyplot.legend(['y = 1', 'y = 0'])\n",
    "pyplot.grid(False)\n",
    "pyplot.title('lambda = %0.2f' % lambda_)\n",
    "\n",
    "# Compute accuracy on our training set\n",
    "p = predict(theta, X)\n",
    "\n",
    "print('Train Accuracy: %.1f %%' % (np.mean(p == y) * 100))\n",
    "print('Expected accuracy (with lambda = 1): 83.1 % (approx)\\n')\n"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.7.3"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}