LogisticRegression.ipynb

{
 "metadata": {
  "name": "",
  "signature": "sha256:ae9c4cddd2f1b4f015288aef414fd3b0a385c979070d46a955df481ef74855b0"
 },
 "nbformat": 3,
 "nbformat_minor": 0,
 "worksheets": [
  {
   "cells": [
    {
     "cell_type": "heading",
     "level": 1,
     "metadata": {},
     "source": [
      "Classification I: Logistic Regression"
     ]
    },
    {
     "cell_type": "heading",
     "level": 1,
     "metadata": {},
     "source": [
      "Predicting student admission"
     ]
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "Suppose we have a csv file containing historical data set for 100 student admissions at a given university. \n",
      "\n",
      "Let's load this data into a Pandas `DataFrame`, using the `read_csv` global function that returns a `DataFrame` from a csv file.\n",
      "\n",
      "\n",
      "So we first import Pandas:"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "import pandas as pd"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 1
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "Then we load the data, and show the first entries using the `head` method:"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "student_data = pd.read_csv('data/log_reg1.csv', names=['exam1', 'exam2', 'admitted'])\n",
      "student_data.head()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "html": [
        "<div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
        "<table border=\"1\" class=\"dataframe\">\n",
        "  <thead>\n",
        "    <tr style=\"text-align: right;\">\n",
        "      <th></th>\n",
        "      <th>exam1</th>\n",
        "      <th>exam2</th>\n",
        "      <th>admitted</th>\n",
        "    </tr>\n",
        "  </thead>\n",
        "  <tbody>\n",
        "    <tr>\n",
        "      <th>0</th>\n",
        "      <td> 34.623660</td>\n",
        "      <td> 78.024693</td>\n",
        "      <td> 0</td>\n",
        "    </tr>\n",
        "    <tr>\n",
        "      <th>1</th>\n",
        "      <td> 30.286711</td>\n",
        "      <td> 43.894998</td>\n",
        "      <td> 0</td>\n",
        "    </tr>\n",
        "    <tr>\n",
        "      <th>2</th>\n",
        "      <td> 35.847409</td>\n",
        "      <td> 72.902198</td>\n",
        "      <td> 0</td>\n",
        "    </tr>\n",
        "    <tr>\n",
        "      <th>3</th>\n",
        "      <td> 60.182599</td>\n",
        "      <td> 86.308552</td>\n",
        "      <td> 1</td>\n",
        "    </tr>\n",
        "    <tr>\n",
        "      <th>4</th>\n",
        "      <td> 79.032736</td>\n",
        "      <td> 75.344376</td>\n",
        "      <td> 1</td>\n",
        "    </tr>\n",
        "  </tbody>\n",
        "</table>\n",
        "</div>"
       ],
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 2,
       "text": [
        "       exam1      exam2  admitted\n",
        "0  34.623660  78.024693         0\n",
        "1  30.286711  43.894998         0\n",
        "2  35.847409  72.902198         0\n",
        "3  60.182599  86.308552         1\n",
        "4  79.032736  75.344376         1"
       ]
      }
     ],
     "prompt_number": 2
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "The first two columns hold the scores for each students at two exams, while the last column indicates whether that student was admitted at the university (`admitted=1`) or not (`admitted=0`).\n",
      "\n",
      "\n",
      "**Problem:** As an university administrator, you may be interested in predicting the probability of future prospective student to be admitted at that university, given their scores on those two exams.\n",
      "\n",
      "To see the kind the kind of relationship between the scores and university admission, we can draw a scatter plot of student scores, using a color scheme to indicate whether that a student, represented by a the coordinates of her two scores, was admitted (`green`) or not (`red`).\n",
      "\n",
      "To do that we use the Python package `matplotlib`. To allow `matplotlib` plots to be embedded into the notebook, we should first invoke the following magic command:"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "%matplotlib inline"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 3
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "import matplotlib.pyplot as plt"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 4
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "Then, using the function `subplots` module, one creates a **figure object** representing a canva on which to draw, along with a `AxesSubplot` object, that represents a set of xy-axes. The `AxesSubplot` object has a method `scatter` for scatter plots, along with various other methods to add stuff to the drawing:"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "admitted = student_data[student_data.admitted == 1][[0,1]]\n",
      "rejected = student_data[student_data.admitted == 0][[0,1]]"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 5
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "figure1, figure1_axes = plt.subplots()\n",
      "figure1_axes.plot(admitted[[0]], admitted[[1]] , 'go', \n",
      "                  rejected[[0]], rejected[[1]], 'ro')\n",
      "figure1_axes.set_xlim([20,110])\n",
      "figure1_axes.set_ylim([20,110])\n",
      "figure1_axes.set_xlabel('Score at Exam 1')\n",
      "figure1_axes.set_ylabel('Score at Exam 2')\n",
      "figure1_axes.legend(['admitted', 'rejected'])\n",
      "figure1_axes.set_title('Admission Scatter Plot');"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "display_data",
       "png": "iVBORw0KGgoAAAANSUhEUgAAAYoAAAEZCAYAAACJjGL9AAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\nAAALEgAACxIB0t1+/AAAIABJREFUeJzt3XlYlOX+P/D34AIqqLiwJEyjg4G4AEMsLsDIUYfcc8lU\n3KD6Rilk+qtzDI+YHT1qJ1OvRC0xjdRscWNUFm0AMwFlEksMRcilTAmSRVCB+/cHMTEywzLbM8vn\ndV1cwjPL/ZkZ5/489/rwGGMMhBBCiBpWXAdACCHEuFGiIIQQ0iJKFIQQQlpEiYIQQkiLKFEQQghp\nESUKQgghLaJEQQxq4cKFWLlypUaPXbduHV5++WWNy/78888hkUg0frwlEggEOHXqFNdhEI5RoiA6\nIRaL0atXLzx69KjF+/F4PPB4PI3K+Ne//oWPP/5Yo8cCwNy5c5GcnKzx41uya9cuPPfcc+jZsydc\nXV3x4osvav2cYrEYu3btUjpmZWWF69eva/3cTz6nra0tunfvjuDgYGzcuFFxW1s/L5lMBldXV53G\nRYwHJQqiteLiYmRnZ8PBwQFHjx5t9f7mtsbz4sWLiI2NxZo1a1BaWorz589jzJgxWj+vugpa0/ev\ntrZW7W15eXkoLy/Hf//7X6xevRrnzp3TqAxinihREK3t3bsXY8aMwbx587Bnzx6l23755Re88sor\ncHJywssvv6xUWclkMri4uGD79u3o378/PD09cfr0aWRkZMDPzw+DBg3Cvn37FPePi4vDvHnzADRU\nlm+++SY8PDxgb28Pf39/3L17FwBw5MgRjB49Gj179sSAAQMUz/Hpp58iKChI8XwFBQWIjo4Gn89H\nTEwMrl69qrhNLBbjv//9LyQSCZydnfHmm2/izz//VPn6v/jiCzz33HN49tlnYWVlBUdHR7z00kuK\n2ysrK7Fz504EBgaiV69eeP755wEAZWVlmDhxIhwcHDBw4ED8+9//VryGd955B5mZmVi8eDHs7Oyw\nZMkShISEAAC8vLxgZ2eHL7/8EkBDJf/qq6+Cz+dj2bJluHHjhqJsgUCAbdu2YcSIEejZsyfq6+tb\n/CxHjBiBUaNGQSqVNruttrYWiYmJCAwMxPDhw/H555+jtrYWVVVVeO655/Drr7/Czs4O3bt3x507\nd1osh5gYRoiWhEIhS0xMZAUFBaxTp07s999/V9zm6+vLli1bxu7du8c2btzIOnfuzFauXMkYY+zb\nb79lnTp1YkuWLGElJSVszZo1zMnJiU2bNo1du3aNnT59mnXr1o09evSIMcZYXFwcmzdvHmOMsaSk\nJCYWi1lJSQmrr69nubm5rLy8nD169Ig9/fTT7Ny5c4wxxu7cucN++uknxhhju3fvZqNGjVLE9vTT\nT7P33nuPlZSUsHXr1jGBQKC4LSQkhLm6urK0tDR269Yt5ufnxz755BOVrz89PZ316NGDrVq1iuXk\n5LD6+nql26Ojo1lYWBiTy+WstraWZWRkMMYY++OPP9g333zDqqur2bVr15hEImHvvPOO4nFisZjt\n2rVL6bl4PB4rLCxU/F1SUsLs7e3Z4cOH2f3799natWvZiBEjFLcLBALm6enJMjIyWE1Njcr4eTwe\nu3btGqurq2OZmZmsa9eu7MKFC4rHnzp1ijHGWEJCAhs2bBjLyclhFy5cYN7e3mz37t2MMcZkMhlz\ncXFR+fzE9FGiIFrJzMxkNjY2rLy8nDHGmJeXF9u0aRNjrKGStrGxYdXV1Yr7u7q6KiWKDh06sJKS\nEsYYY7du3WI8Ho8dPXpUcf+BAwcymUzGGGNs1apVLDw8nDHG2NGjR5lIJGI5OTlK8Tx+/Jg5Ozuz\nxMREVlVVpXRb00SRm5vLnJ2dlW7v168fy83NZYw1VNJLlixR3LZu3To2a9Yste9DWloamzp1KuvW\nrRvz8PBQVKB1dXXsqaeeYnK5XO1jG6WmprIhQ4Yo/haLxc2S05OJYufOnezll19W/F1bW8scHBwU\nyVogELB33323xXJ5PB7r3r076927Nxs3bhz76KOPFLc1TRSTJ09mO3bsUNz28ccfs8mTJzPGGj5L\nShTmi7qeiFb27NmDcePGwc7ODgAwc+ZMRfdTdnY23NzcYGNjo7i/SCRSeryzszN69+4NAHB0dATQ\n0LXSyNHREbdv325W7vjx4xEREYFFixZhwIAB2LhxI+rr69GxY0d8/fXX+Oqrr+Di4oLIyEgUFRU1\ne/x3333XLJZnn30WZ86cUfzt7e2t+N3JyUllHI3+8Y9/4NChQygtLcWbb76JyMhIFBYW4sqVK7h/\n/77SczVijGHFihUICgpCz549MX36dFy+fFlpDKK1geS0tDR8/vnnsLe3h729Pfr06YOqqipkZGQo\n7hMQENDicwCAXC5HSUkJkpOT8dprr6m8z9mzZ+Hr66v429fXF5mZma0+NzF9lCiIxqqrq3Hw4EGc\nPn0azs7OcHZ2xv/+9z9cvHgReXl58PPzw7Vr11BdXa14TG5urk7K7tChA15//XVcunQJUqkU8fHx\nOHHiBABg+PDhOHToEIqLi9GpUye89dZbzR4/cuTIZrFcuHBBaQxDE507d8bLL7+MAQMGID09HYMG\nDUKPHj0gl8ub3ffgwYOQSqXYvXs3SkpK8PXXX4M1tPIVr/HJMQUrKyulRBIaGor58+ejrKxM8VNZ\nWYkZM2Yo7tOxY0etXlOjkSNH4vz584q/z58/j+DgYEWszMwmKZC/UaIgGjt8+DA6duyI/Px8XLx4\nERcvXkR+fj6CgoKwd+9eODk5YfDgwVi1ahXu3buHDz74AL///rtOypbJZLh06RLq6upga2sLKysr\n2NnZ4e7duzhy5AiqqqrQoUMH2NjYKFo7Tfn4+KBz585Yt24dSkpKsGHDBnTs2FHpzL+tFd+ePXtw\n/PhxVFRUoKKiAnv27MHvv/+O6dOng8fjYebMmYiNjcUPP/yAx48fK87Cf/31V/Ts2RN9+vRBQUEB\n1q9fr/S8vr6+kMvlSnH4+voqVdazZs3CN998g8OHD6OqqgpVVVWQSqWorKxs1/vZFlOmTMH27dtx\n4cIFyOVybN++HVOnTgXQ0AosKSnBb7/9pvNyCfcoURCN7d27FxEREXBxcYGDgwMcHBzg6OiIxYsX\nY9++faivr8eXX36J0tJSDBkyBFeuXMGsWbOUnuPJrpWWulqazum/c+cOZs6ciZ49e2LKlClYuHAh\ngoODUV9fj02bNqFfv37w8PBAaWkpVq9e3ezxAHDy5Encvn0bPj4+uHnzJk6ePKk2lpbWE3Tv3h1r\n167F008/DQ8PDyQnJyMxMRE9evQAALz33nuYNGkSIiMj4ejoiM2bNwMAIiIi0K9fPzzzzDOYN28e\nIiIilMoIDw/HtWvX0LdvX7zxxhsAgOXLl+P999+Hvb09vvrqK/Ts2RPJycn49ttv8cwzz2DgwIHY\nu3dvu9aqtPW+4eHhWLp0KV577TVERUXhjTfewNy5cxXvwVtvvYXg4GD06tWLZj2ZGR7TU3sxIiIC\nUqkUDg4OuHTpEgDgyy+/RFxcHK5cuYKcnBylPuItW7Zg69at6NSpE3bu3IlRo0bpIyxCCCHtpLcW\nxaJFi5qdoQ0dOhSHDh1S9Gs2unv3LrZt24ZTp04hPj4e0dHR+gqLEEJIO+lmlEuFoKAgFBcXKx3z\n8PBQed+srCyEhYWBz+eDz+eDMYaKigqVfcuEEEIMyyjGKLKzszFo0CDF3+7u7sjOzuYwIkIIIY2M\nIlGoGibRdOM4QgghuqW3rqf2CAgIQFpamuLvK1euwM/Pr9n93NzcUFhYaMjQCCHE5AmFQly7dk3j\nx3PWomjaivD390dycjJu3LgBmUymmBP/pMLCQsWCJGP6WbVqFecxUEwUkyXGRTG17UfbE2y9tShm\nz56N9PR0lJSUwNXVFatXr0avXr2wZMkSlJSUYMKECfDx8cGJEyfg6OiIqKgohIaGonPnztixY4e+\nwiKEENJOeksU+/fvV3m8cSXnk2JiYhATE6OvcAghhGjIKAazTZ1YLOY6hGYoprahmNrOGOOimAxD\nbyuz9YHH48GEwiWEEKOgbd1pFLOeCCHmoVevXigrK+M6DItlb2+P0tJSnT8vtSgIITpD31FuqXv/\ntf1caIyCEEJIiyhREEIIaRElCkIIIS2iREEIIU8oLi6GlZVVs0vRtpWdnV2z3bN1KS4uDvPmzdPb\n8z+JEgUhhOhYRUUFBAIBAGDhwoVYuXKl0u0CgQCnT5/W+PkNvWkqTY8lhBiENFWKLfu24CF7CGue\nNaLnRGPC2AkGe7wxMbXZYdSiIITonTRVipiPYpAiSEF6/3SkCFIQ81EMpKlSgzy+0X//+1+4ubmh\nd+/emDt3LjIzMwE0bFK6b98+eHp6wtvbGxkZGUqPE4vFWLduHcaOHYu+fftiwYIFePz4MV599VU8\n9dRTWLRoEX777TfF/a2srFBYWIidO3di37592LBhA+zs7DB58mTMnz8fN27cwKRJk2BnZ4f3338f\nQMOmp2+99RaefvppvPzyy7h8+bLi+e7du4e33noLTk5OmD59OiorK9v1urVFiYIQondb9m1BoY/y\nDqaFPoXYun+rQR7fyM3NDWfOnMGtW7fw7LPPYs6cOQAAqVSKlStXYufOndi7dy+2bdvWrHtnx44d\niI2NRVZWFjIzM+Hj44MRI0bg0qVLKC0txSeffKJ0fx6Ph1deeQVz587F22+/jYqKChw9ehR79+4F\nn89HUlISKioqsHz5ctTV1WHEiBHw9PTEjz/+iKCgIEgkEsVzRUVF4bfffsMPP/yAyZMnIz4+3qDd\nT5QoCCF695A9VHm8pr7GII9vNGPGDDg5OaFLly544403wOPxcOHCBRw/fhxz587FqFGjMGzYMLzy\nyitKXUM8Hg9TpkxBSEgIBgwYgDFjxsDa2hrz589H7969MWvWLJw6dUptua11M50+fRpeXl5YuHAh\n7OzsMH/+fPTp0wc5OTmora1FWloaVq9eDScnJyxYsAAikahdr1tblCgIIXpnzbNWedzGysYgj290\n9OhRTJs2DU899RR69eqF3377DRcvXkR2dja8vb0V9/Px8Wn2WC8vL8Xvjo6OGDZsmOJvBwcH3L59\nW225rZ39p6WlITMzE/b29oqfa9euISMjA/n5+aivr8eAAQMU9xeJRAYd46BEQQjRu+g50RDKhUrH\nhLlCLJm9xCCPB4Cqqiq8/PLLWLBgAa5cuYLS0lL069cPjDH4+/tDLpcr7pubm9vm521Nhw4dmk2z\n7dChg1JFHxoaCrFYjLKyMsVPRUUFli1bBg8PD8WYR6MLFy5Q1xMhxLxMGDsBm1/fDMkvEoQUhUDy\niwSbF29u86wlbR8PNExZrayshLOzM+rr67Fu3Tr8+uuv4PF4GD9+PPbv34/vvvsOeXl52LVrV7PH\nN63Y23M27+vri7y8PNTW1iodu3DhguLvMWPG4NKlS9i7dy/KyspQU1MDmUyG27dvo1OnThgzZgxW\nr16NO3fuIDExET/88EOby9cFvSWKiIgIODo6YujQoYpjFRUVmDJlCvh8PqZOnao0cr9lyxYMHDgQ\nnp6eOHPmjL7CIoRwZMLYCTiZcBKyT2U4mXCy3VNbtX28k5MT1q1bh3nz5sHLywuPHj3CqFGjAADj\nx49HXFwcXn75ZcyfPx9RUVHNztib/s3j8Vq9vdHkyZNhZWWFfv36Ydq0aQCAV199FUlJSejVqxc+\n+OADdOjQATKZDD///DN8fX3B5/Pxv//9T9ES2bZtGxwcHODt7Y1Dhw4hKiqqXa9dW3rbPTYzMxO2\ntraYP38+Ll26BADYsGEDbt68iffffx/Lli2DQCDA8uXLcffuXQQHByMlJQVFRUVYunSpyqafqc09\nJsTS0HeUWya3e2xQUBDs7e2VjmVnZyMyMhLW1taIiIhAVlYWACArKwthYWHg8/kICQkBYwwVFRX6\nCo0QQkg7GHSMIicnBx4eHgAADw8PZGdnA2hIFIMGDVLcz93dXXEbIYQQbhl0C4/2NH3UjejHxcUp\nfheLxSZ5fdoMqRQpW7ag48OHqLW2xrjoaARPMM2tCAghxkcmk0Emk+ns+QyaKPz8/JCfnw8fHx/k\n5+fDz88PABAQEIC0tDTF/a5cuaK47UlNE4UpypBKkRwTg/80mer2zl+/U7IghOjCkyfRq1ev1ur5\nDNr1FBAQgISEBFRXVyMhIQGBgYEAAH9/fyQnJ+PGjRuQyWSwsrKCnZ2dIUMzmJQtW5SSBAD8p7AQ\nqVvbtxUBIYQYit5aFLNnz0Z6ejr++OMPuLq64t1330VUVBTCw8Ph7u4OkUiE9evXA2hY5RgVFYXQ\n0FB07twZO3bs0FdYnOv4UPVWBB1q2rcVATEf5rQrKjFPeksU+/fvV3n8yJEjKo/HxMQgJiZGX+EY\njVpr1VsR1Nm0byuC1lDlYxoad0VtuuFd4UcNv9PnRYwFXY/CwMZFR+OdwkKl7qcVQiHClrR9K4LW\nUOWjPUMl2pZ2RaXPihgLShQG1jhgvXLrVnSoqUGdjQ3ClizR6UA2VT7t1zQxlN8rx2+Pf8OdkXcU\nt+sr0epqV1RdoZZog/Hjx2P27NkGvdzok4qLizFgwADU1tbCyorb3ZYoUXAgeMIEvc5wMrbKx9g1\na4FdB/AP5fvoK9G2d1dUfVbk1BL92/Hjx7V+jri4OBQWFuKzzz7TQUTcokShZ1ysmdDVlsyWolkL\nTM3Jmz4SbfScaBR+VKhUvjBXiCWLm3dF6rsi13dLVNvvgi6/S7W1tejYkaq/tqJ3So+4WjPRnsqH\nqGiB1au+nz4SbWMFvHX/VtTU18DGygZLFi9RWTHruyLXZ0tU2++CLr5LAoEAb731FhITE5GXl4fc\n3Fx88skn+OKLLzBu3DgsXboUnp6eABrWIcybNw+RkZEAgDNnziA+Ph5nz57FwoUL8frrr6NPnz4A\ngJs3byIhIQGfffYZKisrERMTA5FIhHXr1oExhsOHD8PNzQ1yuRwPHjzA/v37sWPHDnTu3BkxMTGY\nMWOGYi+m/fv347333kPnzp3x5ptvtul1GQQzISYWLntn3DjGgGY/sRKJ3stOSklikkUSFrIghEkW\nSVhSSpLeyzRV4xaOY4jD3z8LwRAEpWPCyULO38OQBSHKcf71E7IgRCfP3+x9+OtHsqjt/1/VfUe1\n/S7o4rskEAiYp6cny8jIYFVVVczBwYHt3r2blZeXsz179jAXFxfFfcViMdu1axdjjLGLFy8yFxcX\nlpqaykpLS9mSJUvYnDlzFPcdNmwYe/PNN9nt27dZRUUFy8rKYowxFhcXx+bNm6cUw9KlS9mLL77I\nioqK2A8//MCGDBnCUlJSGGOMHTt2jA0YMIBlZmayixcvsoCAAGZlZcXq6ura/BrVvf/a1p3UotAj\nLtdMTBg7weL6lTXVrAUmAJwKnfBU7lOws7dr8SzfkPTdpajPlqi23wVdfZdefPFFBAUFITU1VXHp\nUQCYP38+Nm3ahJycnGa7QnzxxReIiorCmDFjAACrVq2Ch4cH6urqUFBQgFu3bmHjxo2KAWd/f38A\nDVsWsSeuYXHo0CFkZGTA1dUVABAZGYnDhw9j7NixSpdjBYBXXnnFaPa8o0ShR4ZaM0G0o7L7ZyX3\nieFJ+u5SbE83WHtp+13Q1XcpICAAgPKlRxVl1NYiIyOjWaJIS0vD5cuXsXHjRsWxR48e4cKFCzh/\n/jwCAgLaNCvpypUruHHjhtIlVOvr69G/f38ADbtrr1ixQnGbqsuxcoUShR4ZYs0E0Q1TaIHpsyJv\nWoY+3gdtvwu6+i41DmCHhoYiLy8PJ06caPUxoaGhmDZtGt5+++1mt3Xv3h3//ve/UVdXhw4dOjQr\nq2mLwt3dHS4uLjh37hycnZ2bPVfj5VgbL26ky8uxak2rjisDM7FwGWOMpSclsViJhK0KCWGxEglL\nT6KxAmK+WvqOavtd0PbxAoGAnTp1ijHGWG1tLevXrx/bs2cPKy0tZdXV1ezbb79lt27dYowpj1H8\n9NNPrH///iw5OZk9fPiQ/fnnn+zgwYOK5/Xy8mLLly9nt2/fZuXl5YoxiuPHjzMfHx9WU1OjuO//\n+3//j82bN49dvnyZ1dXVsWvXrrH09HTGWMMYhVAoZGfOnGEXL15kw4cPZzwezyjGKEyq5jXFREGI\nJpJSkti4heNYyIIQNm7hOM4H0tvKmL+jTRMFY4xdvXqVrVixgvXv35/17duXTZw4kd28eZMxppwo\nGGMsIyODRUZGsr59+zJXV1cWGRmpuO3GjRts5cqV7Omnn2ZOTk5s/fr1jDHGqqqq2KxZs5izszPz\n9fVVHEtISGAhISGsR48ezMfHh33xxReMMcbq6urYZ599xgYNGsS8vLzY3r17jWYwW2+XQtUHuswi\nsQSq1ksI5UJsfn2z0XePmct3dOTIkYiJicELL7zAdSjtoq9LoVKiIMTISBZJkCJIaX78FwlOJpzk\nIKK2rwg3h+9oSUkJPDw8cPHiRfTr14/rcNpFX4mCBrMJMTLGtgWLJW3tcffuXfj4+CAqKsrkkoQ+\nUaIgxMgY2xYslrTJpIODA27fvs11GEaH2y0JCSHNRM+JhlAuVDomzBViyWxuplU/ZA+BYgCnAHz7\n17/FtMmkJeGkRbFv3z7s2LEDJSUlWLp0KV566SVUVFQgPDwccrkcIpEIiYmJsLW15SI8Qjily/US\nuthttvxeOVAB5R11TwHlduXtjoeYJoMPZt+/fx/+/v44d+4cOnXqhNDQUKSmpmLHjh24efMm3n//\nfSxbtgwCgQDLly9XDtYMBsoIMRRdzZ4STRZB7itvfjxXhAtHLigdo+8ot/Q1mG3wrqezZ89CJBLB\n3t4etra2GD16NL7//ntkZ2cjMjIS1tbWiIiIQFZWlqFDI8QsSFOlkCySIHxlOApLCxu6jf7SOLbQ\nHt17dVd53M7ertkxe3t78Hg8+uHop+mWJLpk8K6n4OBgLF68GEVFRbCxscHx48dhbW2NnJwceHh4\nAAA8PDyMZjMswi264lr7KLUiBH8dPPXXv3/93d6xhfYMrpeWlrbruYlpMHii6NatGz788EO8/vrr\nuH//PoYOHQpra+s2N4vi4uIUv4vFYojFYv0ESjhnSdMydUXVDCX8A8BpKBJFe2dPmdL1TejEooFM\nJoNMJtPZ83EymD1p0iRMmjQJQMO2v2FhYcjNzUV+fj58fHyQn5/fbAfHRk0TBeGWvr+UljQtU1fU\nrcEAr+EfTSp4Q2xGqAt0YvG3J0+iV69erdXzcZIo7t69CwcHB6SlpeHHH3+ESCRCQEAAEhISsGHD\nBiQkJCAwMJCL0EgbGeJLaWwLz0yBum4i+yp7+P/ir3EFbwq769KJhf5wkihmzJiBu3fvws7ODgkJ\nCeDxeIiKikJ4eDjc3d0hEomwfv16LkIjbWSIL6WxLTwzBeq6iTavNf59ojTRtFWb91New0GB8n3o\nxEJ7nCSKjIyMZsfs7Oxw5MgRDqKxLLrqLjLE2b4p9Y0bC3XdREDDHlLm1HffrFXbH80G7gE6sdAF\n2sLDguiyu8gQZ/um0jdubJ7sJjLXvvu2DNzr8sTCkgfKKVFYEF12FxnqbF+ffeOW8sU31757da1a\n+4f2GFY0TKcnFuaabNuKEoUF0WV3kamf7VvSF99cJwWoa9X6e/rrfDt2c022bUWJwoLourvIFGbC\nqMP1F99QrRlpqhQ//vRjw+rsegBCaLyewtgYcgzLXJNtW1GisCA0OPw3Lr/4hmrNNJbzx8Q//j74\n12CvsNT0P3dDtmotfQYeJQoLYurdRbrE5Rdfn62Zpi2VH3/6EX8M+UP5Dv8Aekt7Y/N/zGO6rKFa\ntZZ+kkWJwsKYcneRLnH5xddXa6at00WHeA6h/wPtZOknWZQoiEXi8ouvr9ZMW6aL6qIcS2XJJ1mU\nKIjF4uqLr6/WTGv7POmqHGJ5KFEQYmD6as2oa6n0ftAbQ4qGWFx3CdEdg1/hTht09SxC1FN5Rbtc\nITYvNo+Ba6I5betOShSEmBFpqlS5pTKbWhCEEgUhhJBWmNw1swkhhJgWShSEEEJaRLOeCNGApew8\nSwjAUaL4+OOPsXv3bjx8+BBBQUH48MMPUVFRgfDwcMjlcohEIiQmJsLW1paL8AhpkSXtPEsIwEHX\nU2lpKdauXYvU1FTk5OSgoKAAycnJiI+PB5/Px9WrV+Hi4oLt27cbOjRC2qSlvZoIMUctJoqKigp8\n++23qKqqUjp+8qTme7136dIFjDHcv38f1dXVePDgAXr27Ins7GxERkbC2toaERERyMrK0rgMQvTJ\n0recJpZHbaLYt28fvLy88MEHH2Do0KFK17P+17/+pXGBXbp0QXx8PAQCAZycnDBy5EgEBAQgJycH\nHh4eAAAPDw9kZ2drXAYh+mTpW04Ty6N2jGLnzp3Izs5Gnz59cO3aNcyaNQtFRUV44403tCrw3r17\niIqKwuXLl2Fvb4+ZM2ciKSmpzXN84+LiFL+LxWKIxWKt4rE0GVIpUrZsQceHD1FrbY1x0dEInkD9\n6u1h6VtOE+Mnk8kgk8l09nxqE8W9e/fQp08fAICbmxtkMhmmT5+OGzduaLVwIzs7G4GBgXBzcwMA\nzJw5E5mZmfDz80N+fj58fHyQn58PPz8/lY9vmihI+2RIpUiOicF/Cv+u4N7563dKFm3Hxc6zNMuK\ntMeTJ9GrV6/W6vnUdj05ODjghx9+UPxtZ2cHqVSKkpIS5OXlaVxgUFAQzp8/j9LSUjx8+BAnTpzA\nuHHjEBAQgISEBFRXVyMhIQGBgYEal2FKMqRSxEokiBOLESuRIEMq1VtZKVu2KCUJAPhPYSFSt9Ig\nbHs0Vto19TWw5lnrfZuMxllWKYIUpPdPR4ogBTEfxUCaqr//K4Q0pbZFsXfvXnTq1EnpWKdOnbBn\nzx688sorGhfYvXt3xMbG4vnnn8eDBw8QFhaG0aNHw9/fH+Hh4XB3d4dIJML69es1LsNUGPoMv+ND\n1YOwHWpoELatuJgay/X1vQlRmyhcXV1VHufxeBg1apRWhS5cuBALFy5UOmZnZ6c0YG4J1J3hr9y6\nVS+JotYDjij8AAAgAElEQVRa9SBsnQ0NwrYVF5U2zbLSLerGaz9amc0hQ5/hj4uOxjuFhUrJaYVQ\niLAlNAjbVlxU2jTLSndosaRmKFFwyNBn+I2tlJVbt6JDTQ3qbGwQtmQJDWS3AxeVtrHPsjKlM3Tq\nxtNMmxNFVVUVHjY5A+7Vq5deArIkujzDb+u01+AJEzhLDFxWKLoqm4tKm8vre7fG1M7QqRtPM60m\nim+++QarVq1CWVmZYnCbx+Ph+vXreg/O3OnqDN8Upr1yWaHosmyuKm2uru/dGlM7Q6duPM20euGi\nYcOG4dixY3j66acNFZNa5nThIl0ufIuVSPBeSkqz4yslEqzRYrsVXZIskiBF0DxGyS8SnEzQb4xc\nlm2K2tP6Ei8UI71/erPjIUUhkH0q03Ok7Wepl4vVtu5stUXx1FNPoUuXLhoXQJrTdQvAFKa9ctnk\np+6Gtmtv68vUztCNuRvPmLWaKOLj4zFy5EgMHz4cPXr0ANCQnbZs2aL34MyVrqfFmsK0Vy4rFFOr\nzLjUrCupGCgsLcS8lfPgt8+vWevC2AfaVTHWbjxj1mqiWLRoEYKCgjB8+HB07twZjDHweDxDxGa2\ndN0CMIVpr1xWKKZYmXFFqfVVDKAQwD+AMpQhBSnNWhd0hm4ZWk0U9+7d0+nmUkT3LQBTmPbKZYVC\nlVnbKbW+/koSTakaqKYzdPPX6mD2mjVrAABz585Fz549Fce5mB5rLoPZqsYoVgiFCNu82agqd0tg\nSmsADEFpjOJbAKOb38dYB6qJetrWna0mCoFAoLKrqaioSONCNWUuiQJoSBapTVoAY/9qAdA24Iaj\nauC2y8kuGGA/AP0c+1ls0pCmSrF1/1ZkX8pG2cSyZrfTbDHTo/dEYUzMKVGoonI2lFAICbU09ELd\ntFmcBhAKCOVCbH7dvKdNtsRSp5JqwthbpnqfHgs0rMo+ffo0ysr+PruYP3++xoUS1Qy9SaClUzdt\nFn81oI154Zgh0NhO25ja6nRNtJooPv74Y+zatQvXr1/HyJEjcerUKUyaNIkShR6YwnoIc6Ju2iya\nnHhZ+loLGqhunamtTteE2gsXNdq9ezcyMjLQt29fHDp0COfPn8e9e/cMEZvF0dVsKENeDMmURc+J\nhlAuVD6YBmDA33/SWgvSGktY0Nlqi+Lx48fo3LkzBAIBbt++DaFQiJs3b2pc4M8//4wXX3xR8ff1\n69exZs0aREREYO7cuZDL5RCJREhMTIStra3G5ZgiXayHMIV9n4xF066V2yW3UXizENXe1YCg4XZa\na0HawhIWdLaaKJ599lmUlZVhwYIFCAoKQqdOnTB9+nSNC3R3d4dcLgcA1NfXo1+/fnj++eexbds2\n8Pl8HDx4EMuWLcP27duxfPlyjcsxRbpYD0HjHO3TtGulcbZPTZH598cb++CrKbGEBZ1t2sIDAF54\n4QU899xzKCsrA5/P10nhaWlpcHNzg6urK7KzsxEbGwtra2tERERg3bp1OinD1Gi7DTiNc2juyf54\naaoUkkUSk6lM21r5m+LgqzEnNksY9G81UezatQuRkZEAGi5X2qVLF6xevRqrVq3SuvADBw5g9uzZ\nAICcnBx4eHgAADw8PJCdna3181siU9j36UnGWAmYWmXannhNbfDVFD4Lcx/0b3UwOy0tDePHj8ev\nv/6KH3/8EcOHD0d5ebnWBT969AjHjh3DzJkzAcCs10cY0rjoaLwjVB6gXSEUYqwR7fvUVGMlkCJI\nQXr/dKQIUhDzUQykqdwOwLdUmRqj9sSrbvD13OVzkCyScP7eP8nUPgtz1GqLYv/+/Thw4ACGDRuG\nbt264fPPP8eoUaO0LvjEiRPw9fVF3759AQB+fn7Iz8+Hj48P8vPz4efnp/JxcXFxit/FYjHEYrHW\nsZgTU9j3qSljPbs1tZks7YlX3eDrfev7SBE03/iPa8bwWbTU6jXGFrFMJtPpHn2tJoqCggJs2bIF\n06ZNQ35+PhITE+Hj44Nu3bppVfD+/fsV3U4AEBAQgISEBGzYsAEJCQkIDAxU+bimiYKoxuXlTtvL\nGCoBVUxtJkt74lU1+Io0AG4NvxpDom6K68+ipa4vAEbZLfbkSfTq1au1er5Wu54mT56Md999Fzt3\n7kR6ejoGDhyo9my/raqqqpCWloZp06YpjkVFReHGjRtwd3fH7du38eqrr2pVBjENXFcC6qhaYyHM\nFWLJbOPswmtPvBPGTsDm1zdD8osEPU70aNiyxA2KacEA94m6Ka4/i5ZavZbSLdZqiyIrK0txwSIr\nKyssW7YMkyZN0qrQbt26oaSkROmYnZ0djhw5otXzEtNjrFMLTW0mS3vjbRx8VbffFdeJuimuPwtN\nWr3GlGh1QW2i2LBhA9566y306NEDX375pWLQGQA+/fRTrF271iABEvPGdSXQElObyaJJvMaaqJ/E\n5WfRUqtX3SQcY0q0uqB291gfHx/Fwrimv6v621DMffdYYp6McbCzKcVCw8ZEPds4ErWxaGkXXaD5\nGIUx7rBrkN1jiWWha2LoDq0BMH1tafUaY4tYlyhRECW0V5RuGev0X1PGRQutpWRqCYlWbaLIy8uD\nnZ0dAKC6ulrxe+PfxDzRXlG6ZazTf02Vrlpoxt4daGzUJoq6ujpDxkE0oI8uIlPYK8qUvuTGOv3X\nVOmihWYK3YHGhrqeTJS+uoiMfa8oU/uSm8qsIlOhixYadQe2X6sL7ohxUtdFlLpVu4U+xr5XlKkt\ncGq6uC2kKASSXyRGNyPGlOiihUbdge1HLQoTpa8uImPfK8oUv+SWMNhpKLpooVF3YPu1mijefvtt\nrF+/vtVjxLD02UVkzHtF0ZfcsuligSZ1B7af2gV3jVQtrhOJRMjNzdVrYKrQgru/qRqjWCEUImzz\nZqOt5NVpz6B8S4uf6KydtJWlLTLU24K7+Ph4bNu2DYWFhRg6dKjieHl5OWbNmqVxgUQ3jL2LqK3a\nOyhvzFt+ENNB3YHto7ZFcf/+fZSVleGf//wn1q9fr8hGjo6O6NKli0GDbEQtCvMTK5HgvZTmm9Kt\nlEiw5uRJDiIixPzorUXRo0cP9OjRAwcOHADQkDju37+Pe/fuAYDOrptNLJsprNsgxNK1Oj02PT0d\no0ePRr9+/SASiSAQCDB+/HhDxEYsgLGv2yCEtCFRrF+/Hnv27IFQKMTdu3eRmJiI4OBgQ8RGLICx\nr9vQhjRVCskiCcQLxUZ5LWqiPUv5jFudHnvnzh3w+Xx069YNVVVVmDNnDtasWaNVoVVVVXjttdfw\n/fffo2PHjti9ezc8PT0RHh4OuVwOkUiExMRE2NraalUOMX6NA9YvrVyJyuJiWAPo1r07t0HpgKmt\nICftZ0mfcastil69eqGiogLjx4/HjBkzEBERgUGDBmlV6KpVq8Dn85GXl4e8vDx4eHggPj4efD4f\nV69ehYuLC7Zv365VGaYgQypFrESCOLEYsRIJMqTmeTbSFo7l5ThQVoY9ZWXYJpcjOSbGpN8PU1tB\nTtrPkj7jVlsUR44cgY2NDWJjYyGTyXD79m1MnTpVq0LT0tLw/fffw+avfugePXogOzsbsbGxsLa2\nRkREBNatW6dVGcbOUrbzbssaCXPcsdYUV5CT9rGkz7jVRNGtWzfF72KxWOsCb926hZqaGkRFRSE/\nPx/Tpk1DdHQ0cnJy4OHhAQDw8PBAdna21mUZM3OsHJ/U1mSoy5lPxrKzLK0gN3+W9BkbfFPAmpoa\nFBQUYPr06ZDJZPjpp59w8OBBi1sfYQnTQtu6caGuZj419hmnCFKQ3j8dKYIUxHwUw8kAY/ScaAjl\nyoP0wlwhlsw2/UF60sCSPmODbwro5uYGd3d3TJo0CQAwe/Zs7N27F35+fsjPz4ePjw/y8/Ph5+en\n8vFxcXGK38VisU5aOVywhGmhbU2G46Kj8U5hYfPtSNo588mYto+mFeTmz5g/Y5lMBplMprPna3Oi\nKCoqQv/+/XVS6MCBA5GVlQU/Pz9IpVKMGTMGf/zxBxISErBhwwYkJCQgMDBQ5WObJgpTpqvK0Zi1\nNRnqajsSY+szpm0izJ+xfsZPnkSvXr1aq+drNVHIZDK8/fbb+P3331FcXAy5XI5Vq1bh6NGjGhf6\n/vvvY/78+aipqcGYMWPw4osvor6+HuHh4XB3d4dIJDL73WnNZa+mlrQnGepix1pL6jMmxJBa3T12\nwoQJSEhIQFhYmGIX2SFDhuDHH380SIBN0V5PpidDKkVqk2Q4Vo/JkHaWJUQ1ve311KiyshKOjo6K\nvysqKtDdDBZEEcMw5LUtjLnPmPzNWGamkbZrNVFMmTIFW7ZsQW1tLTIyMrBjxw7aZpwYLWPtMyYN\nLGk1szlpteuppqYGBw4cwNdff436+nrMmTMHM2bMgLWagUp9oq4nw2rPBYUIeZKqlsOWfVuQImi+\nrbzkFwlOJtC28vqi166n2tpaTJgwAadOncLChQs1LoSYHktZOU70Q13LweaRDSBofn9zXM1sTlpc\ncNexY0fweDwUFxcbKBxiLNq6WI4QVdStablTckfl/WlmmnFrdYzC3t4eIpEIoaGhcHZ2BtDQjNmy\nZYvegyPcsYSV40R/1K1pcXZyRk95z2Yz05YsNp/1Q+ao1UQxYcIETPirq6Gxn4vH4+k9MMItS1g5\nTvRH3ZqWfn36YcnsJTQzzcS0Opjd6M6dO2CMKVoVXKDBbMNRNUaxQihE2ObNNEZBWkVrWoyLtnVn\nq4lCLpcjKioKVVVVAABbW1vEx8fD29tb40I1RYnCsAy5WI6YH2mqVLnlMJtaDlzRe6J44YUXEBMT\ng5EjRwIAzp49iw8//BAHDx7UuFBNUaIghJD207bubHWb8evXr8PX11fxt0gkwvXr1zUukBBCiGlp\ndTB71qxZmDt3LubOnQvGGA4cOEArswnREdrOgpiCVrueHj9+jBMnTkD61/WLJ06cCIlEgs6dOxsk\nwKao68lycbFKXN9lqhzwlQux+XUa8CW6pfcxiqqqKtjY2KBDhw4AgLq6Ojx8+BBdu3bVuFBNUaIw\nHbqsZFWuEhcKIdHjDCxDlClZJKHtLIhB6H2MIjQ0FNXV1Yq/Hzx4gDFjxmhcIDF/jZXseykpiEtP\nx3spKUiOiUGGVLNLknKxStwQZRrbhZYIUafVRFFTUwNbW1vF33Z2dqioqNBrUMS06bqS5WKVuCHK\npAstEVPRaqIICAhAUlKS4u9jx44hICBAq0IFAgGGDRsGHx8f+Pv7A2i4zsWUKVPA5/MxdepUVFZW\nalUG4Y6uK1kuVokboszoOdEQyoVKx4S5QiyZTdtZEOPSaqJ444038P7778PT0xODBg3C+++/j2XL\nlmlVKI/Hg0wmg1wuR3Z2NgAgPj4efD4fV69ehYuLC7Zv365VGYQ7uq5kx0VH4x2hcoW6QijEWD1d\nXzxDKsWde/cQ9US8ui5zwtgJ2Pz6Zkh+kSCkKASSXyS0cpkYpXZt4cHj8ZSudqep/v374/z58+jd\nu7fi2IwZMxAbGwtvb2/k5uZi3bp1+PLLL5WDNbLBbLpeg2qqBoKXOjmhwtkZLt27a/ReGWqVeNPY\nMwCkAvjFxgZ2np6Y9e679PkSk6R13cnUyMrKYr/++qvib6lUysLDw9m2bdtYVVWVuoe1Sf/+/dmw\nYcPYlClT2JEjRxhjjPH5fFZdXc0YY6yqqorx+fxmj2shXINLT0piK4RCxgDFzwqhkKUnJXEdmlFI\nT0pisRIJWxUSwl4TiViEk5NJvFfvjBunFGfjT6xEwnVohGhM27pT7YK7//u//8OpU6cAANeuXcOi\nRYuwfv16nDt3DitWrMCHH36ocXL67rvv4OzsjPz8fEyaNAn+/v5tznZxcXGK38ViMcRiscZxaEPd\ngO3KrVvprBPK18qOlUjwXm6u0u3/KSzE6//+t9G9V7S9OjEHMpkMMplMZ8+nNlHU1dWhV69eAIAt\nW7Zg4cKFWLhwIcLDwxX7PmmqcQfaQYMGYfLkyTh27Bj8/PyQn58PHx8f5Ofnw8/PT+VjmyYKLlGF\n0nbq3quKy5eRIZUaVbKg7dV1g1acc+vJk+jVq1dr9XxqB7Pt7e3x4MEDAMCRI0cwY8YMAA1XvdNm\nRtKDBw8U02vv3buH5ORkhIWFISAgAAkJCaiurkZCQgICAwM1LsMQqEJpO3Xv1dM1NUZ3xTxDD5yb\no8YV5ymCFKT3T0eKIAUxH8VAmqrZOhrCPbUtivDwcAQGBsLBwQFCoVBxhn/16lX07NlT4wJ///13\nPP/88wCA3r17Y9myZXB1dUVUVBTCw8Ph7u4OkUiE9evXa1yGIYyLjsY7hYXNr9dAFUoz46KjEZWR\ngfgmra0VAMIAnDayFlhj62Zlk4HzMDPbXl3fZ/vqLoO6df9WalWYqBZnPf36668oKChASEiI4qp2\nBQUFqKyshEgkMliQjYxx1hNdr6FtXhKJ4CyXowOAOgBjAQQDWCmRYM1J2q7CUAyxv5R4oRjp/dOb\nHQ8pCoHsU5lOyiDto/e9noyJsSUKXTL3qbaqpsxGODnBxtkZDhpOmSXtZ4j9pWgPK+Ojbd3Z6jbj\nRP9UbkD31+/mUnE+2aVzq7wcPX/7DR/I5Yr7mNtrVsVQJwTqupcMsb9U9JxoFH5U2OwyqEsWU7es\nqaJEYQQsZaptsymzTZIEYJ6vuSlDnRCo6l4q/Kjhd0PsL9XYhaV0GdTFdBlUU0aJwghY2lTbDKkU\n13JyEAegFsA4NIxXAOb7mgHDnRC0NJhsqLP9CWMnmERioGm8bUOJwghY0lTbxrPqA2VlimPv/PVv\nMMzzNTcy1AlBS91L5nC2r6vKvaWWlym9H4ZAicIIWNJUW5Vn1QBWAjhppq+5kaFOCFrrXmrv2b4x\nnXXrsnKnabxtR4nCCFjC3P1G6s6qb9jbI1KPV6wzBoY6IdBl95KxnXXrsnKnC0e1HSUKjqia/WIJ\n6wnUnVXz/f3NOkkAhjsh0GX3krGddeuycqcLR7UdJQotaTLd0RKmw6pjSd1sqjSd+aVPuhpM1kXF\nrMuuK11W7jSNt+0oUWihrRX+k8nkzr17+MQCpsOqYkndbOZA24pZ111Xqir3Lie74Jb9LUgWSdqV\nhMxhYN9QaGW2FmIlEryX0nwFatNtKVQlkygbG8yuqVFMCW0UFxKCOB1uDUyMh6muvFe55UeuUOlK\nfC29Nn2s0pamSrF1/1bcLrmNwpuFqPauBgR/xabj7UjMBa3M5lBbpjuqmuUTX1ODlUCzRGHOU0ON\nlSEqcFPuamztrLu116aPAePGbjXJIgl+9P1R6TaataQflCi00JbpjuqSyS82NkDT3VQtqJ/eWBiq\nAjf1lfctjXe09tr0OWBMs5YMhxKFFtoyMKsumdh5emJl377UT88hQ1Xghl55b8hurtZemz4HjGnW\nkuFQotBCWwZm1SWTWe++S4mBY/quwBsr7JsXLyIWyluVAPrpajR0N1drrWp9DhjTrCUD0uqK2wZm\nYuEqpCclsViJhK0KCWGxEglLT0riOiTCGHtn3DjGgGY/sRKJ1s+dnpTEVgiFSs+7AmDpf/3+L6FQ\nL/8P9PmaVFH1OvX12lRJSklikkUSFrIghEkWSVhSCn23VNG27uSs5q2trWXe3t5s4sSJjDHGysvL\n2eTJk5mrqyubMmUKq6ioaPYYU00UxDjps5JTV2G/aG+v15OFVSEhKstdFRKil/IYY+yjVavYC717\nswU9erAXevdmH61apbeyiGa0rTs563ravHkzPD09FdfPjo+PB5/Px8GDB7Fs2TJs374dy5cv5yo8\nYgH0uaZDXbeW+7BhiNPjCnxDbzCZIZXidmIivvjjD8WxdxITkeHnR12rZsSKi0Jv3bqF48eP46WX\nXlLM7c3OzkZkZCSsra0RERGBrKwsLkIjFiZ4wgSsOXkScTIZ1pw8qbPKjasdgcdFR+MdoVDp2Aqh\nEGP1NKNO3YSA1K1b9VIe4QYnLYqlS5di48aNKC8vVxzLycmBh4cHAMDDwwPZ2dlchEZMjLEuZONq\nqxJDr3y3tGupWCqDJ4qkpCQ4ODjAx8cHsiarkBtbFq2Ji4tT/C4WiyEWi3UbIDEZxryQjcutSgy1\nnxRgGtdSMdaTCX2SyWRK9avWdDJS0g7/+te/mIuLCxMIBMzJyYl17dqVhYeHs2nTprHc3FzGGGPn\nz59n06dPb/ZYDsIlRszQM3xIc1zPemqNytlnRhSfoWhbdxp8jGLt2rW4efMmioqKcODAAYSGhuKz\nzz5DQEAAEhISUF1djYSEBAQGBho6NGJiqNuDe8ETJkCyeTNWSiSICwnBSokEYUZ0XZH2jqFkSKWI\nlUgQJxYjViJBhlRqiDCNHucL7ng8HgAgKioK4eHhcHd3h0gkwvr16zmOjBg7U+j2sASG7Opqr/ac\nTBhzVybXOJn11CgkJARHjx4FANjZ2eHIkSO4ceMGDh8+DFtbWy5DIybA0DN8iOlpz8kEzeBSj/MW\nBSGaomtbkNa0Z/YZdWWqR4mCmDRj7vYg3GvPyQR1ZapHFy4ihBCoHqNYIRQa1eC8prStOylREJNj\nifPiiWFkSKVIbdL6GGsmXZmUKIhFUTkzRSiExAzO+gjRF23rTk5nPRHSXjQzhRDDo0RBTArNTCHE\n8ChREJNCM1MIMTxKFMSk0CI7QgyPBrOJyTHXmSmE6AvNeiKEENIimvVECCFEryhREEIIaRElCkII\nIS2iREEIIaRFlCgIIYS0yOCJoqamBgEBAfD29kZgYCA2bdoEAKioqMCUKVPA5/MxdepUVFZWGjo0\nQswGXdKT6JLBr0dhY2ODb7/9Fl27dsXDhw/h6+uLiRMn4tChQ+Dz+Th48CCWLVuG7du3Y/ny5YYO\njxCTR5f0JLrGSddT165dAQCVlZWora2FtbU1srOzERkZCWtra0RERCArK4uL0AgxebRxItE1ThJF\nfX09vLy84OjoiMWLF4PP5yMnJwceHh4AAA8PD2RnZ3MRGiEmjzZOJLrGyaVQrayscPHiRRQXF2P8\n+PEYOXJkm1cNxsXFKX4Xi8UQi8X6CZIQE0UbJxKZTAaZTKaz5+N8C4/ly5fDzc0NqampiI2NhY+P\nDy5cuIB169bhq6++UrovbeFBSOvM+ZKeRDPa1p0Gb1GUlJSgY8eO6NmzJ/744w+kpKRg2bJlKC8v\nR0JCAjZs2ICEhAQEBgYaOjRCzEJjMljZZOPEMNo4kWjB4C2KS5cuYcGCBairq4OTkxPmzp2L+fPn\no6KiAuHh4ZDL5RCJREhMTIStra1ysNSiIISQdqPdYwkhhLSIdo8lhBCiV5QoCCGEtIgSBSGEkBZR\noiCEENIiShSEEEJaRImCEEJIiyhREEIIaRElCkIIIS2iREEIIaRFlCgIIYS0iBIFIYSQFlGiIIQQ\n0iJKFIQQQlpEiYIQQkiLKFEQQghpkcETxc2bNzF69GgMHjwYYrEY+/btAwBUVFRgypQp4PP5mDp1\nKiorKw0dGiGEEBUMnig6deqETZs24aeffsJXX32F2NhYVFRUID4+Hnw+H1evXoWLiwu2b99u6NA0\npsuLmOsKxdQ2FFPbGWNcFJNhGDxRODk5wdvbGwDQp08fDB48GDk5OcjOzkZkZCSsra0RERGBrKws\nQ4emMWP8j0ExtQ3F1HbGGBfFZBicjlFcu3YNP/30E/z9/ZGTkwMPDw8AgIeHB7Kzs7kMjRBCyF84\nSxQVFRWYNWsWNm3aBFtbW7oWNiGEGCvGgUePHrGxY8eyTZs2KY5NmzaN5ebmMsYYO3/+PJs+fXqz\nxwmFQgaAfuiHfuiHftrxIxQKtaqzO8LAGGOIjIzEkCFD8MYbbyiOBwQEICEhARs2bEBCQgICAwOb\nPfbatWuGDJUQQggAHmOG7fM5c+YMgoODMWzYMPB4PADAunXrMHLkSISHh0Mul0MkEiExMRG2traG\nDI0QQogKBk8UhBBCTIvRrsw2xoV5NTU1CAgIgLe3NwIDA7Fp0ybOY2pUV1cHHx8fTJo0yShiEggE\nGDZsGHx8fODv728UMQFAVVUVFixYgGeeeQaenp7IysriNK6ff/4ZPj4+ip8ePXpgy5YtqKys5PS9\n+vjjjzFixAj4+voquoi5/vz27duHkJAQDB48GJ988gknMUVERMDR0RFDhw5VHGsphi1btmDgwIHw\n9PTEmTNnDBrXl19+icGDB6NDhw7Izc1Vun974zLaRGGMC/NsbGzw7bff4ocffkB6ejp27dqFq1ev\nGsViwc2bN8PT01PRncd1TDweDzKZDHK5XDHVmeuYAGDVqlXg8/nIy8tDXl4ePDw8OI3L3d0dcrkc\ncrkcFy5cQNeuXfH8889j27ZtnMVUWlqKtWvXIjU1FTk5OSgoKEBycjKn79P9+/exevVqHD58GFlZ\nWdi5cyfu379v8JgWLVqEkydPKh1TF8Pdu3exbds2nDp1CvHx8YiOjjZoXEOHDsWhQ4cQHBysdFyT\nuIw2URjrwryuXbsCACorK1FbWwtra2vOY7p16xaOHz+Ol156STHNmOuYADSb8mwMMaWlpWHFihWw\nsbFBx44d0aNHD6OIqzE2Nzc3uLq6chpTly5dwBjD/fv3UV1djQcPHqBnz56cxnT27FmIRCLY29vD\n1tYWo0ePxvfff2/wmIKCgmBvb690TF0MWVlZCAsLA5/PR0hICBhjqKioMFhcHh4eeOaZZ5rdV5O4\njDZRNGVMC/Pq6+vh5eUFR0dHLF68GHw+n/OYli5dio0bN8LK6u+Pk+uYeDweQkNDMXXqVBw9etQo\nYrp16xZqamoQFRWFgIAArF+/HtXV1ZzH1ejAgQOYPXs2AG7fqy5duiA+Ph4CgQBOTk4YOXIkAgIC\nOI0pODgY2dnZKCoqwm+//Ybjx4/j7NmzRvHZqYshKysLgwYNUtzP3d3dKBYSZ2dntzsuo08UxrYw\nz8rKChcvXsS1a9ewbds2yOVyTmNKSkqCg4MDfHx8lOLg+n367rvvcPHiRaxbtw5vvvkm7ty5w3lM\nNasLXJkAAAgESURBVDU1KCgowPTp0yGTyfDTTz/h4MGDnMcFAI8ePcKxY8cwc+ZMANx+fvfu3UNU\nVBQuX76M4uJifP/990hKSuI0pm7duuHDDz/E66+/jhkzZmDo0KGwtrY2is+uPTE0dg1zSVW8rcVl\n1Ini8ePHmD59OubNm4cpU6YAAPz8/JCfnw8AyM/Ph5+fHyexCQQCjB8/HllZWZzGdPbsWRw9ehT9\n+/fH7Nmzcfr0acybN4/z98nZ2RkAMGjQIEyePBnHjh3jPCY3Nze4u7tj0qRJ6NKlC2bPno2TJ09y\nHhcAnDhxAr6+vujbty8Abv+fZ2dnIzAwEG5ubujduzdmzpyJzMxMzt+nSZMm4fjx4/juu+9QX1+P\nsLAwzmMC1H9WAQEBuHz5suJ+V65c4ay+akqTuIw2UbS2MK+6ulrtwjx9KSkpwZ9//gkA+OOPP5CS\nkoIpU6ZwGtPatWtx8+ZNFBUV4cCBAwgNDcVnn33GaUwPHjxQ9Hneu3cPycnJCAsL4zSmRgMHDkRW\nVhbq6+shlUoxZswYo4hr//79im4ngNv/50FBQTh//jxKS0vx8OFDnDhxAuPGjeP8fbp79y6AhrGc\nH3/8ESKRiPOYAPWflb+/P5KTk3Hjxg3IZDJYWVnBzs7O4PEByq0IjeLSal23HmVmZjIej8e8vLyY\nt7c38/b2ZidOnGDl5eVs8uTJzNXVlU2ZMoVVVFQYLKa8vDzm4+PDhg0bxsaNG8f27NnDGGOcxtSU\nTCZjkyZN4jym69evMy8vL+bl5cVCQ0PZrl27OI+p0c8//8wCAgKYl5cXW7ZsGausrOQ8rsrKSta7\nd29WXl6uOMZ1TLt372bBwcHs2WefZbGxsayuro7zmIKCgpi7uzt79tlnWVZWFmPM8O/Tiy++yJyd\nnVnnzp2Zi4sLS0hIaDGGDz/8kAmFQjZo0CCWkZGh97g6derEXFxc2K5du9ihQ4eYi4sLs7GxYY6O\njiwsLEzjuGjBHSGEkBYZbdcTIYQQ40CJghBCSIsoURBCCGkRJQpCCCEtokRBCCGkRZQoCCGEtIgS\nBTEpH3/8MUJCQhRbmHO9d07jDqbqdOjQQWkb8Q0bNhgsNlVbTxOiCVpHQUzGr7/+irCwMJw7dw5d\nu3ZVrBxu3C5EE7W1tejYUfMrAhcXF2PSpEm4dOmSytvt7Oz0tmNoazIzM2Fra4v58+erjY+QtqAW\nBTEZBQUFcHBwUGz13qtXL0WSuHz5Ml555RV4eXkhICAAVVVVePz4MTZu3Ihnn30WL7zwAuRyOQDg\n008/xcyZMzFmzBhIJBLU1NTggw8+QEhICCZMmACZTNas7KqqKowZMwYikQjjx49Heno6AOCf//wn\nCgsL4ePjg7fffrtNr+P+/fvw8PBAQUEBAGD27NnYtWsXACAqKgp+fn4YMWIEPv74Y8VjBAIB1qxZ\no7iQV1FREcLCwjBs2DB88803KstRtfU0IRrR15JyQnStvr6ejR49mvH5fLZkyRJ29epVxW0hISHs\n2LFjjDHGKioqWG1tLTty5AibNm0aq66uZmfOnGEBAQGMsYbtKezt7VlRUZHi782bNzPGGLtz5w7z\n9/dvVnZtba1ii41ffvmFicVixhhjxcXFbMiQIWpj7tChg2ILGm9vb3bw4EHGGGOpqals+PDhbP/+\n/ey5555T3L+0tJQxxtjDhw9ZQEAAq6ysZIwxJhAI2LvvvssYY2zRokXMzc2N/f77762WX1RU1OLt\nhLSF5m1uQgyMx+Ph9OnTyMnJwVdffYWRI0di9+7dEIlEuHv3LiZOnAgAsLW1BQBIpVLMnTsXNjY2\nGDlyJKqqqnDnzh0AQGhoKAQCAQDg66+/RnFxMXbv3g0AKCsrQ1FREfr3768ou0OHDti8eTOOHz+O\nqqoqFBYW4v79+61uMd2lSxdFS6apMWPG4ODBg1i8eDHy8vIUx1NTU7Fnzx4UFxfj3r17OH36tOLy\ntnPnzgUADB8+HLW1tXBwcFDEW1VVhW7durX7PSWkLShREJPj5+cHPz8/DBo0CPv374evr6/aCvvJ\n44wx8Hg8pXGN+vp6fPTRR80uGdmUTCZDZmYmkpOT0a1bNzg4OOD+/fsav4b6+nrk5+ejW7duKC0t\nxVNPPYWKigr885//RGZmJvr164fnn38eZWVlisf07NkTANC5c2f06NFDcbxTp054+PAhJQqiNzRG\nQUxGQUEBrl69CqBhEPrcuXMYMWIEHB0d4eDggGPHjgFouNhVXV0dJk6ciAMHDqCmpgZnz56Fra0t\nnJ2dmyWPOXPmYMeOHYpBZ1UtgNu3b6Nfv36ws7PDgQMHUFpaCgBwdHREeXl5u1/Lpk2bMHjwYHz+\n+edYtGgRamtrUVZWhk6dOsHJyQkFBQU4deqUyse21oohRNcoURCTUVlZiYULF2Lw4MEYOXIkbGxs\nsGDBAgDA9u3bceTIEQwdOhQSiQQPHz6ERCKBv78/Ro0ahQ8//FAxjZXH4yld0WvGjBnw9/eHRCLB\nkCFDsGrVqmZlT506FX/++ScGDRqEM2fOwNPTE0BD19KsWbMgEolUDmZXV1crTY9dsWIFCgoKsGvX\nLvzvf//DqFGjEBwcjP/85z/g8/mYPn06hgwZgsWLFyu6nJ70ZPzqrk42e/ZsjBgxAgUFBXB1dVV0\nrRHSXjQ9lhBCSIuoRUEIIaRFlCgIIYS0iBIFIYSQFlGiIIQQ0iJKFIQQQlpEiYIQQkiLKFEQQghp\nESUKQgghLfr/w53Wnz9WeV4AAAAASUVORK5CYII=\n",
       "text": [
        "<matplotlib.figure.Figure at 0x10c781910>"
       ]
      }
     ],
     "prompt_number": 6
    },
    {
     "cell_type": "heading",
     "level": 1,
     "metadata": {},
     "source": [
      "Conditional probability and sigmoid function"
     ]
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "From that scatter plot above, we see that the admitted student seems to be separated from the rejected students by a line, the **separation boundary**, whose equation should thus be of the form:\n",
      "\n",
      "$$\\theta_0 + \\theta_1x_1 + \\theta_2 x_2= 0$$\n",
      "\n",
      "where $x_1$ is the score at the first exam, $x_2$ is the score at the second exam, and the $\\theta$'s are **unknown parameters**. \n",
      "\n",
      "**Logistic regression** provides a method (which we will outline later on) to estimate these parameters. That is, one of the output of logistic resgression is a vector of estimated parameters:\n",
      "\n",
      "$$\\hat\\theta = (\\hat\\theta_0, \\hat\\theta_1, \\hat\\theta_2)$$\n",
      "\n",
      "A second output of logistic regression is a prediction of the admission probability for a prospective student (i.e. not necessarily in our initial data set) given the student scores $x_1$ and $x_2$ at the two exams. If we denote by $Y$ the binary variable that takes $0$ if a student is rejected and $1$ in case of admission, the logistic regression predicts the following **conditional probability** of admission, given the two scores:\n",
      "\n",
      "$$P(Y=1 \\,|\\, X_1=x_1,\\, X_2=x_2\\,;\\;\\hat\\theta) = \\frac{1}{1+\\exp(-(\\hat\\theta_0 + \\hat\\theta_1x_1 + \\hat\\theta_2 x_2))}$$\n",
      "\n",
      "where $X_1$ and $X_2$ are the two random variables modelling the student scores at each of the two exams.\n",
      "\n",
      "\n",
      "The conditional probability above is modelled using the **sigmoid** function (also called **logistic function**):\n",
      "\n",
      "$$s(z) = \\frac1{1 + e^{-z}}$$\n",
      "\n",
      "This function always gives back as output a number between $0$ and $1$ for any real input. Hence, this output can be interpreted as a probability.\n",
      "\n",
      "To code the sigmoid function, we want to take advantage from `numpy` vectorized arrays, which will allow us to apply numerical functions not only to scalar but to the entries of any multidimentional arrays with the exact same code:"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "import numpy as np"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 7
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "Of course, for the vectorization to work, one needs to use exclusively the math function defined in the `numpy` package: `np.cos`, `np.sin`, `np.exp`, etc."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "sigmoid = lambda z: 1/(1 + np.exp(-z))"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 8
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "We see that the sigmoid coded above can handle any multidimensional numpy arrays (including the object of the `matrix` class), by applying the function above to each entries of the array:"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "domain = np.linspace(-10, 10, 100)\n",
      "image  = sigmoid(domain)\n",
      "image[47:53]"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 9,
       "text": [
        "array([ 0.37635452,  0.42481687,  0.47476892,  0.52523108,  0.57518313,\n",
        "        0.62364548])"
       ]
      }
     ],
     "prompt_number": 9
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "Let's plot now the sigmoid function:"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "figure2, figure2_axes = plt.subplots()\n",
      "figure2_axes.plot(domain, image);"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "display_data",
       "png": "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\nhbqIiIP8P78o4yg7IyRiAAAAAElFTkSuQmCC\n",
       "text": [
        "<matplotlib.figure.Figure at 0x10c77d810>"
       ]
      }
     ],
     "prompt_number": 10
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "By eye-balling the admission scatter plot above, we can guess that the speration line between positive ($Y=1$) and negative examples ($Y=0$) approximately has roughly a slope of $\\alpha = -1$ and an intercept of roughly $\\beta = 125$, giving us the line equation:\n",
      "\n",
      "$$x_2 = -x_1 + 125$$\n",
      "\n",
      "We show this guessed separating boundary on the scatter plot below:"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "figure3, figure3_axes = plt.subplots()\n",
      "domain = np.linspace(20, 110, 100)\n",
      "figure3_axes.plot(admitted[[0]], admitted[[1]] , 'go', \n",
      "                  rejected[[0]], rejected[[1]], 'ro',\n",
      "                  domain, -domain + 125, '-')\n",
      "figure3_axes.set_xlabel('Score at Exam 1')\n",
      "figure3_axes.set_ylabel('Score at Exam 2')\n",
      "figure3_axes.set_title('Admission Scatter Plot')\n",
      "figure3_axes.set_xlim([20,110])\n",
      "figure3_axes.set_ylim([20,110])\n",
      "figure3_axes.legend(['admited students','rejected students','separation line'])"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 11,
       "text": [
        "<matplotlib.legend.Legend at 0x10d118c10>"
       ]
      },
      {
       "metadata": {},
       "output_type": "display_data",
       "png": "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\n",
       "text": [
        "<matplotlib.figure.Figure at 0x10c9d5150>"
       ]
      }
     ],
     "prompt_number": 11
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "Observe that the line itself, which is fully determined by its slope $\\alpha$ and its intercept $\\beta$ is not enough information to determin the model parameters uniquely. Namely, rescalling the $\\theta$'s by any number $\\lambda$, will give us the equation\n",
      "\n",
      "$$\\lambda(\\theta_0 + \\theta_1x_1 + \\theta_2x_2) = 0$$ \n",
      "\n",
      "which describes the same line in the plane. In terms of the line slope and intercept $\\alpha$ and $\\beta$, we have that\n",
      "\n",
      "$$\\theta_1 = -\\alpha \\theta_2\\quad \\textrm{and} \\quad\n",
      "  \\theta_0 = -\\beta \\theta_2$$\n",
      "\n",
      "leaving us free to choose the value for $\\theta_2$. Any choice of $\\theta_2$ will different parameter values, all of which describing the same geometric line. \n",
      "\n",
      "The bottom line is thus that finding the geometric line separating the best the **positive examples** (admitted students) and **negative examples** (rejected students) is not enough information to evaluate the admission probability for a new prospective students that has passed the two exams. Namely, the conditional probability above needs a fixed and unique value for each of the $\\theta$ parameters. \n",
      "\n",
      "The Maximum Likelihood method described in the next section will give us a reasonable way to uniquely determine these parameters."
     ]
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "Once these parameter uniquely determined, Logistic regression will predict an admission probability\n",
      "\n",
      "* equal to $1/2$ for students lying on the separating line: $z = 0$\n",
      "* below $1/2$ for students below the separating line: $z < 0$\n",
      "* above $1/2$ for students above the separating line: $z > 0$\n",
      "\n",
      "where $z = \\hat\\theta_0 + \\hat\\theta_1 x_1 + \\hat\\theta_2 x_2$. The more positive $z$ is the highest the admission probability will be, and the more negative $z$ is, the lowest the admission probability will be. \n",
      "\n",
      "The decision of classifying an student as positive (admitted) or negative (rejected) will then be made on the basis of the admission probability being above (or equal) to $1/2$ or below that threshold. \n",
      "\n",
      "Hence, logistic regression (as SVM, or the perceptron) can be cast into the form of a **linear classifier**, i.e. the learned **decision function**  \n",
      "\n",
      "$$\\delta: \\mathbb R^2 \\rightarrow \\{0,1\\}$$\n",
      "\n",
      "that classifies a student as admitted or rejected on the basis of the two exam scores, is of the form \n",
      "\n",
      "$$\\delta(x_1, x_2) = g(\\hat\\theta_0 + \\hat\\theta_1x_1 + \\hat\\theta_2x_2)$$\n",
      "\n",
      "where\n",
      "$$\n",
      "\\begin{eqnarray}\n",
      "g(z) & = & \\bigg\\{\n",
      "    \\begin{array}{lr}\n",
      "    0 & \\textrm{if }\\quad z < 0  \\\\\n",
      "    1 & \\textrm{if }\\quad z > 0\n",
      "    \\end{array}\n",
      "\\end{eqnarray}\n",
      "$$\n",
      "\n",
      "Many classifiers are of this form. Logistic regression has the advantage to also output a classification probability giving a kind of confidence, along with a a classification decision."
     ]
    },
    {
     "cell_type": "heading",
     "level": 1,
     "metadata": {},
     "source": [
      "Probabilistic Model"
     ]
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "We now establish now the probability model underlying logistic regression. This model will give us a way to estimate uniquely the parameters $\\theta$.\n",
      "\n",
      "Suppose we have a data set reccording $m$ **observations** $\\omega_1,\\dots,\\omega_m$ for $n$ **features** variables $X_1, \\dots, X_n$ along with the value of a **binary classification** target variable $Y$ for each observation. Our data set can be described as a list\n",
      "\n",
      "$$\\mathcal D = \\{(\\omega_i, y_i):\\: i=1,\\dots, m\\}$$\n",
      "\n",
      "where the $i^{th}$ observation $\\omega_i = (x_{i1}, \\dots, x_{in})$ is a $n$-dimensional row vector, $x_ij$ is the value of feature $j$ for observation $i$ and $y_i$ is the class or label of that example ($y_i$ is either $0$ or $1$). \n",
      "\n",
      "The first assumption of the model is that each of values $x_{1j},\\dots, x_{mj}$ are $m$ **Independent** and **Identically Distributed** (IID) realizations of a random variable $X_j$ modelling the $j^{th}$ feature. Similarly, $y_1, \\dots, y_m$ are regarded as IID realization of a **binary random variable** Y. \n",
      "\n",
      "Hence each row $(\\omega_i, y_i)$ of our data table is governed by a **joint probability distribution**\n",
      "\n",
      "$$P(X=\\omega_i,\\, Y=y_i) = P(X_1 = x_{i1},\\,\\dots,\\,X_n=x_{in},\\, Y=y_i)$$\n",
      "\n",
      "The logistic regression model does not make any assumption on the form of this joint probability. The model only cares about modelling the conditional probability of $Y$ given $X$, which is a much less restrictive assumption, since many different joint distribution can yield the very same conditional probability. \n",
      "Since $Y$ is a binary discrete random variable, we have essentially one choice for a probilitic model: The Bernouili model!\n",
      "\n",
      "$$P(Y=y\\,| X=x) = (p(x))^{y}(1-p(x))^{(1-y)}$$\n",
      "\n",
      "where $p(x)$ is the probability of class $Y=0$ given $X=x$ and $1 - p(x)$ is the probability of class $Y=1$ given $X=x$.\n",
      "\n",
      "Now the overall conditional probability of the seeing in our data set $\\mathcal D $ the values $\\mathcal D_Y$ we see for $Y$ given the values $\\mathcal D_X$ we see for $X = (X_1, \\dots, X_m)$ can expressed as a product of the conditional probability for each of the examples (i.e. each row of our data table), because of our IID assumption:\n",
      "\n",
      "$$\n",
      "\\begin{eqnarray}\n",
      "P(\\mathcal D_Y | \\mathcal D_X) & = & P(Y=y_1 | X=\\omega_1)\\dots P(Y=y_m | X=\\omega_m)\\\\\n",
      "                               & = & \\prod_{i=1}^m (p(\\omega_i))^{y_i}(1-p(\\omega_i))^{(1-y_i)}\n",
      "\\end{eqnarray}\n",
      "$$\n",
      "\n",
      "The idea is now to look for the \"best\" approximation of the target function $p:\\mathbb R^n\\rightarrow [0,1]$ on a space $\\mathcal H$ of **hypothesis**, which is a special subspace of all the functions from the feature space $\\mathbb R^n$ to $[0,1]$.\n",
      "The algorithm that will search this space for the \"best\" approximation to $p$ according to a certain criterium is the **learning algorithm**.\n",
      "\n",
      "The hypothesis space for logistic regression is the space of linearly parametrized sigmoid functions:\n",
      "\n",
      "$$\\mathcal H = \\left\\{h_\\theta(x)=\\frac1{1 + \\exp(\\theta^T x)}:\\: \\theta=(\\theta_0,\\dots,\\theta_n)\\in\\mathbb R^{n+1}\\right\\}$$\n",
      "\n",
      "\n",
      "In the notation above, we added a component $x_0$ to our feature vectors. We will always set up this first component to $1$, $x = (1, x_1, \\dots, x_n)$ in order to use the compact vector notation:\n",
      "\n",
      "$$\\theta^T x = \\theta_0 + \\theta_1 x_1 + \\cdots + \\theta_n x_n$$\n",
      "\n",
      "From now on, we will add $1$ to the feature vectors of each of our examples and denote the resulting vector by \n",
      "$$x^{(i)} = (1, x_{i1},\\dots, x_{in})$$\n",
      "\n",
      "The question is now how to find $\\theta$ in our hypotesis space $\\mathcal H$ so that $h_\\theta$ is the \"best\" approximation we can get to the target function $p$ that we want to learn from our data set."
     ]
    },
    {
     "cell_type": "heading",
     "level": 1,
     "metadata": {},
     "source": [
      "Maximal Likelihood"
     ]
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "If we knew the true target function $p$, we could compute the conditional probabliliy $P(\\mathcal D_Y | \\mathcal D_X)$ as seen above. Now if we chose a hypotesis $h_\\theta$ in the logistic regresssion hypothesis space $\\mathcal H$, we obtain the conditional probability of seing the values $\\mathcal D_Y$ we see in our data set for $Y$ given the values $\\mathcal D_X$ we see for $X$ *according to that hypothesis*:\n",
      "\n",
      "$$\n",
      "\\begin{eqnarray}\n",
      "P(\\mathcal D_Y | \\mathcal D_X;\\; \\theta) & = & \\prod_{i=1}^m (h_\\theta(\\omega_i))^{y_i}(1-h_\\theta(\\omega_i))^{(1-y_i)}\n",
      "\\end{eqnarray}\n",
      "$$\n",
      "\n",
      "The $\\theta$ appearing in the notation emphasis that that conditional probability is \"according to the hypothesis\" $h_\\theta$ that we are making on the form of the true target function $p$. \n",
      "\n",
      "The **Method of Maximum Likelihood** prescribes to search our hypothesis space $\\mathcal H$ for that hypothesis $h_{\\hat\\theta}$ that maximizes the probability of seeing the values we are seing for $Y$ given the one we are seeing for $X$. In other words, the maximum likelihood estimate for $\\theta$ is given by\n",
      "\n",
      "$$\\hat\\theta_{MLE} = \\operatorname{argmax}_{\\theta \\in \\mathbb R^{n+1}} P(\\mathcal D_Y | \\mathcal D_X;\\; \\theta)$$\n",
      "\n",
      "Given the data $\\mathcal D$, the conditinal probability above can be seen as a function of the parameter vector $\\theta$ only. It is called the **likelihood function** and denoted by \n",
      "\n",
      "$$L_{\\mathcal D}(\\theta):= P(\\mathcal D_Y | \\mathcal D_X;\\; \\theta)$$\n",
      "\n",
      "It is usually hard to find a maximum for the likelihood function directly. Taking advantage of the independence assumption that turns the likelihood function into a product of similar terms, we may apply the logarithm function, which turn products (harder to diferentiate) to sums (easier to differenciate) to obtain the **log-likelihood** function:\n",
      "\n",
      "$$\n",
      "\\begin{eqnarray}\n",
      "l_{\\mathcal D}(\\theta)  & = & \\log L_{\\mathcal D}(\\theta)\\\\\n",
      "                        & = & \\sum_{i=1}^m y^{(i)}\\log h_{\\theta}(x^{(i)})  + (1-y^{(i)})\\log(1-h_{\\theta}(x^{(i)}))\n",
      "\\end{eqnarray}\n",
      "$$\n",
      "\n",
      "Since the logarithm is an increasing monotone function, the log-likelihood achieves its maximum at the exact same value $\\hat\\theta$ as the likelihood function does. Hence, maximizing $l_{\\mathcal D}(\\theta)$ will deliver the MLE estimate for the parameter vector. The advantage is that $l_{\\mathcal D}(\\theta)$ is more amenable to traditional optimization methods such as gradient ascent or the Newton method."
     ]
    },
    {
     "cell_type": "heading",
     "level": 1,
     "metadata": {},
     "source": [
      "Log-likelihood Gradient and Hessian"
     ]
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "We are now going to code the log-likelihood for logistic regression, in a vectorized way, using `numpy` matrices. \n",
      "\n",
      "First of all, let's gather the features observations into a single matrix called the **design matrix**:\n",
      "\n",
      "$$\n",
      "X := \\left(\n",
      "\\begin{array}{ccccc}\n",
      "1 & x_{11} & x_{12} & \\cdots & x_{1n} \\\\\n",
      "1 & x_{21} & x_{22} & \\cdots & x_{2n} \\\\\n",
      "\\vdots & \\vdots & \\vdots & \\vdots & \\vdots \\\\\n",
      "1 & x_{m1} & x_{m2} & \\cdots & x_{mn} \\\\\n",
      "\\end{array}\n",
      "\\right)\n",
      "$$"
     ]
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "In our student admission example, we obtain:"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "X = np.matrix(student_data[['exam1', 'exam2']])\n",
      "ones = np.matrix(np.ones(X.shape[0])).T\n",
      "X = np.hstack([ones, X])\n",
      "X[:4]"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 34,
       "text": [
        "matrix([[  1.        ,  34.62365962,  78.02469282],\n",
        "        [  1.        ,  30.28671077,  43.89499752],\n",
        "        [  1.        ,  35.84740877,  72.90219803],\n",
        "        [  1.        ,  60.18259939,  86.3085521 ]])"
       ]
      }
     ],
     "prompt_number": 34
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "While we will colect the admission status into the column vector $y$:"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "y = np.matrix(student_data.admitted).T\n",
      "y[:4]"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 35,
       "text": [
        "matrix([[0],\n",
        "        [0],\n",
        "        [0],\n",
        "        [1]])"
       ]
      }
     ],
     "prompt_number": 35
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "In vectorized computation, the sigmoid function `sigmoid`, we defined earlier can take any `numpy` array and apply the sigmoid transformation to each of the array elements, returning hence an array of the same dimension. The numpy logarithm `np.log` has the same property. Thus, if $\\theta$ is a column vector, the `numpy` code corresponding to \n",
      "\n",
      "$$ \\log (\\operatorname{sigmoid}(X\\theta)) = \\left(\\log \\frac1{1 + \\exp(x^{(1)}\\theta)}, \\dots, \\log \\frac1{1+\\exp(x^{(m)}\\theta)}\\right)^T$$\n",
      "\n",
      "whose inner product with the vector $y = (y_1, \\dots, y_m)^T$ yields the first term of $l_{\\mathcal D}(\\theta)$. \n",
      "\n",
      "The second term is obtained in a similar way by vectorized operations, yielding:\n",
      "\n",
      "$$\n",
      "l_{\\mathcal D}(\\theta) = y^T\\log(\\operatorname{sigmoid}(X\\theta)) + (1-y)^T\\log(1 - \\operatorname{sigmoid}(X\\theta))\n",
      "$$\n",
      "\n",
      "Since log-likelihood depends on the data, it is better to implement this function as a callable class:"
     ]
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "Using the fact that the sigmoid function $s$ has the property that\n",
      "$$s'(z) = s(z)(1-s(z)$$\n",
      "one computes the gradient of the log-likelihood, whose components are called the **score functions**:\n",
      "\n",
      "$$\\frac{\\partial l_{\\mathcal D}(\\theta)}{\\partial \\theta_k} = \\langle y - s(X\\theta),\\, \\vec x_k\\rangle$$\n",
      "\n",
      "In vectorized notation, a straightforward computation yields:\n",
      "\n",
      "$$\\nabla l_{\\mathcal D}(\\theta) = X^T(\\vec y - \\operatorname{sigmoid}(X\\theta))$$\n",
      "\n",
      "where $\\vec x_k$ is the sample vector of all observations for feature $X_k$ and the deference \n",
      "\n",
      "$$\\hat \\epsilon = \\vec y - s(X\\theta)$$\n",
      "\n",
      "is the vector of **residual** between the predictions $s(X\\theta)$ and the response vector $\\vec y$.\n",
      "\n",
      "With that gradient, one can find the maximum of the log-likelihood by following a curves of steepest ascent in the space of parameters. The resulting algorithm is called **gradient ascent**:\n",
      "\n",
      "$$\\theta^{(n+1)} := \\theta^{(n)} + \\alpha X^T(y - \\operatorname{sigmoid}(X\\theta^{(n)}))$$\n",
      "\n",
      "where $\\alpha$ is a the step size, called the **learning rate**. \n",
      "\n",
      "Although the log-likehood function is concave, and, hence, has a single global maximum, which guarantees gradient ascent to converge, the convergence rate is slow and requires many iterations. A better method in this case is Newton alogorithm to find the zero of a function, that we apply to the gradient of the log-likelihood. \n",
      "This requires us to compute the derivative of the scores, that is, the matrix of second derivatives, called **Hessian** of the log-likelihood. Let us compute the Hessian of the log-likelihood:\n",
      "\n",
      "Using again that $s'(z) = s(z)(1-s(z))$, we obtain that\n",
      "\n",
      "$$\n",
      "\\begin{eqnarray}\n",
      "\\frac{\\partial^2 l_{\\mathcal D}(\\theta)}{\\partial \\theta_k \\partial \\theta_l} \n",
      "& = & - \\sum_{i=1}^m s(\\theta^T x^{(i)})(1 - s(\\theta^T x^{(i)})) x_k^{(i)} x_l^{(i)}\\\\\n",
      "& = & - \\sum_{i=1}^m w_i x_k^{(i)} x_l^{(i)}\\\\\n",
      "& = & - \\vec x_k^T \\Sigma_\\theta \\vec x_l\n",
      "\\end{eqnarray}\n",
      "$$\n",
      "\n",
      "where $\\Sigma_\\theta = \\operatorname{Diag}\\big(\\sigma_1^2(\\theta), \\dots, \\sigma_m^2(\\theta)\\big)$ is a diagonal matrix of weights:\n",
      "\n",
      "$$\n",
      "\\begin{eqnarray}\n",
      "\\sigma_i^2(\\theta)& = & s(\\theta^T x^{(i)})(1 - s(\\theta^T x^{(i)})) \\\\\n",
      "             & = & \\operatorname{var}_\\theta (Y\\,|\\, X=x^{(i)})\n",
      "\\end{eqnarray}\n",
      "$$\n",
      "\n",
      "which is the predicted variance of $Y | X=x^{(i)}; \\theta$ given the hipothesis $\\theta$ on the conditional probability \n",
      "\n",
      "$$ P(Y=y\\,|\\,X=x^{(i)}; \\;\\theta) = (\\operatorname{sigmoid}(\\theta^T x^{(i)}))^y (1- \\operatorname{sigmoid}(\\theta^T x^{(i)}))^y$$\n",
      "\n",
      "Therefore, in vector notation, we obtain the grandient and Hessian matrix of the log-likelihood for logistic regression:\n",
      "\n",
      "$$\n",
      "\\nabla l_{\\mathcal D}(\\theta) = X^T(\\vec y - \\operatorname{sigmoid}(X\\theta))$$\n",
      "\n",
      "\n",
      "Optimization packages will often require us to give, along with the function to optimize, both the gradient and the Hessian of the objective; doing so decresase the burden of the optimization algorithm that have thus not to approximate both derivatives of the objective. This reduces the number of function calls to the objective.\n",
      "\n",
      "\n"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "class LogisticRegresssion(object):\n",
      "    \n",
      "    def __init__(self, X, y):\n",
      "        self.y = y\n",
      "        self.X = X\n",
      "        self.theta = np.matrix(np.zeros(X.shape[1])).T\n",
      "        \n",
      "    def sigmoid(self, z):\n",
      "        return 1.0/(1 + np.exp(-z)) \n",
      "               \n",
      "    def log_likelihood(self, theta):\n",
      "        prob = self.sigmoid(self.X * theta)\n",
      "        ll = self.y.T * np.log(prob) + (1 - self.y).T * np.log(1 - prob)     \n",
      "        return float(ll)\n",
      "    \n",
      "    def gradient(self, theta):\n",
      "        return self.X.T * (self.y - self.sigmoid(self.X * theta))\n",
      "    \n",
      "    def hessian(self, theta):\n",
      "        pass\n",
      "    \n",
      "    def error(self, theta):\n",
      "        pass\n",
      "    \n",
      "    def train(self, alpha=0.001, n=1000):\n",
      "        for i in range(n):\n",
      "            self.theta = self.theta + alpha * self.gradient(self.theta)\n",
      "        return self.theta\n",
      "    \n",
      "    def summary(self):\n",
      "        pass\n",
      "    \n",
      "    def classify(self, x):\n",
      "        pass\n",
      "    \n",
      "    def positive_prob(self, x):\n",
      "        pass"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [],
     "prompt_number": 16
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "lreg = LogisticRegresssion(X, y)\n",
      "theta_learned = lreg.train(alpha=0.01,n=500000)\n",
      "print 'Learned parameters:'\n",
      "print theta_learned"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "Learned parameters:\n",
        "[[-5373.24906527]\n",
        " [   45.92968145]\n",
        " [   45.66893581]]\n"
       ]
      }
     ],
     "prompt_number": 32
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "t0, t1, t2 = float(theta_learned[0]), float(theta_learned[1]), float(theta_learned[2])\n",
      "alpha = -t1/t2; beta  = -t0/t2\n",
      "print 'Learned slope: ', alpha\n",
      "print 'Learned intercept: ', beta"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "output_type": "stream",
       "stream": "stdout",
       "text": [
        "Learned slope:  -1.00570947465\n",
        "Learned intercept:  117.656542011\n"
       ]
      }
     ],
     "prompt_number": 38
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "fig, axes = plt.subplots()\n",
      "domain = np.linspace(15, 105, 100)\n",
      "\n",
      "axes.plot(admitted[[0]], admitted[[1]] , 'go', \n",
      "          rejected[[0]], rejected[[1]], 'ro',\n",
      "          domain, alpha * domain + beta, '-')"
     ],
     "language": "python",
     "metadata": {},
     "outputs": [
      {
       "metadata": {},
       "output_type": "pyout",
       "prompt_number": 62,
       "text": [
        "[<matplotlib.lines.Line2D at 0x1109a28d0>,\n",
        " <matplotlib.lines.Line2D at 0x1109a2ad0>,\n",
        " <matplotlib.lines.Line2D at 0x1109a7190>]"
       ]
      },
      {
       "metadata": {},
       "output_type": "display_data",
       "png": "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\nAAAASUVORK5CYII=\n",
       "text": [
        "<matplotlib.figure.Figure at 0x10fac2f90>"
       ]
      }
     ],
     "prompt_number": 62
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [],
     "language": "python",
     "metadata": {},
     "outputs": []
    }
   ],
   "metadata": {}
  }
 ]
}